qa-arsenal

python-3.12+

Languages: English · Русский

Unified QA automation for five target platforms in one monorepo. API, UI, load, database and Kafka test suites, consolidated from five separate repositories so they share one pipeline, one set of standards and one place to review changes.

---

Why five repositories live here

This repo did not start as a monorepo. It is the result of consolidating five independent repositories that were maintained separately:

Former repository	Language	Moved to
hh-api-tests	Python	hh/api
hh-playwright	TypeScript	hh/ui
guap-tests-python	Python	guap/python
guap-tests-go	Go	guap/go
amocrm-tests	Python	amocrm

Each target still lives in its own self-contained directory (own dependencies, fixtures, Docker files), so it can be developed and run independently. The monorepo only adds shared value on top:

• One CI pipeline — every target is checked on each push/PR (.github/workflows/ci.yml).
• One review surface — cross-cutting changes land in a single pull request.
• One set of conventions — root Makefile, .gitignore, .gitattributes, license.
• One place to discover — the whole QA portfolio is visible from a single README.

---

What is inside

Target	Platform	Coverage	Stack
hh/api	hh.ru	REST API, contracts, security, performance	Python 3.12, pytest, Pydantic v2, requests
hh/ui	hh.ru	E2E UI	TypeScript, Playwright, Page Object Model
guap/python	guap.ru	API, UI, load, SQL	Python, pytest, Selenium, k6
guap/go	guap.ru	API, SQL tasks	Go 1.21
amocrm	amoCRM	API, DB, Kafka, load, UI, cross-browser	Python, pytest, Playwright, Locust, Selenium Grid

qa-arsenal/
├── hh/                      # hh.ru (headhunter)
│   ├── api/                 #   REST API tests   — Python/pytest (101: 74 unit + 27 integration)
│   └── ui/                  #   E2E UI tests     — TypeScript/Playwright + vitest unit (54)
├── guap/                    # guap.ru
│   ├── python/              #   API + UI + load + SQL — Python/pytest (69: 39 unit + 30 integration)
│   └── go/                  #   API tests + SQL tasks — Go (62: 22 unit + 40 integration)
└── amocrm/                  # amoCRM — API, DB, Kafka, load, UI, cross-browser (275: 59 unit + 216 integration)

Target status

Target	Tests	Hermetic in CI	Maturity
hh/api	101 (74 unit + 27 integration)	74 unit + contract	mature — layered architecture, mocks, validation
hh/ui	54 (48 unit + 6 E2E)	48 unit + typecheck + lint	growing — E2E runs against a live/mock app
guap/python	69 (39 unit + 30 integration)	39 unit	working
guap/go	62 (22 unit + 40 integration)	22 unit + build + vet	working
amocrm	275 (59 unit + 216 integration)	59 unit	mature — largest, multi-pipeline (API/DB/Kafka/UI/load)

Known limitations (honest)

• Integration tests need live APIs and credentials (.env). They are not run in CI — CI only checks hermetic unit tests and build health. A green pipeline does not prove the integration suites pass; run make test locally with a real .env for that.
• No coverage gate — some targets carry coverage config, but the monorepo does not enforce a coverage threshold on merges.
• hh/ui is the thinnest E2E target — 6 E2E specs only; it has a 29-test unit layer plus typecheck + lint in CI, but no automated browser run in the pipeline.
• Code style differs between targets — each was built independently with its own stack and conventions. The monorepo standardizes the interface (Makefile, CI, README), not the internals.
• amocrm is heavy — the biggest suite; a full local run needs PostgreSQL, Kafka, Selenium Grid and Elasticsearch (see its docker-compose).

---

Quick start

# run every target (needs .env files + live APIs)
make test

# hermetic checks without any external dependencies (same as CI)
make check

# individual targets
make test-hh-api      # hh.ru REST API
make test-hh-ui       # hh.ru E2E UI
make test-guap-py     # guap.ru Python
make test-guap-go     # guap.ru Go
make test-amocrm      # amoCRM

# install all dependencies
make deps

Without make:

# hh.ru API (Python)
cd hh/api && pip install -r requirements.txt && pytest

# hh.ru UI (Playwright)
cd hh/ui && npm ci && npx playwright install --with-deps chromium && npm test

# guap.ru (Go)
cd guap/go && go test ./...

# guap.ru (Python)
cd guap/python && pip install -r requirements.txt && pytest

# amoCRM
cd amocrm && pip install -r requirements.txt && pytest

All targets require their own .env (copy each directory's .env.example and fill in real values). Full run instructions live in each target's README.

---

CI

.github/workflows/ci.yml runs on every push/PR and is a hermetic health check — it never needs real credentials:

job	what runs
hh/api	74 unit + contract tests (coverage measured)
hh/ui	48 unit tests (vitest run) + typecheck + lint
guap/python	39 unit tests (coverage measured) + pytest --collect-only
guap/go	go build ./... + go vet ./... + go test ./unit/...
amocrm	59 unit tests (coverage measured) + pytest --collect-only

Live integration tests (real hh.ru / guap.ru / amoCRM APIs, Playwright against a running app) require .env credentials and are run locally (make test) or on a schedule with secrets. In CI without credentials they are excluded, so the pipeline stays green and signals real problems only.

---

Contributing

See CONTRIBUTING.md — how to add a target, run checks, and what a pull request must satisfy. Security reporting: see SECURITY.md.

History archive

The original commit history of the consolidated repositories is preserved in this repo, on dedicated history/* tags:

Tag	Former repository	Stack
history/hh-playwright	hh-playwright	TypeScript, Playwright
history/guap-tests-go	guap-tests-go	Go
history/amocrm-tests	amocrm-tests	Python, pytest

# browse the original history of a consolidated repo
git fetch origin --tags
git log history/hh-playwright --oneline
git checkout history/amocrm-tests

hh-api-tests and guap-tests-python were deleted before consolidation; their code is included in this repo, but their git history was lost.

License

MIT — see LICENSE.

Installation

git clone https://github.com/ssrjkk/qa-arsenal.git
cd qa-arsenal
pip install -r requirements.txt

Usage

python main.py

---

SSRJKK — GitHub · Telegram · Projects hub · Bot catalogue