Testes¶
A suíte do backend tem 214 testes (contagem do pytest --collect-only na v1.0.0) em três grupos
(backend/tests/README.md):
| Pasta | Conteúdo | Serviços |
|---|---|---|
tests/unit/ |
catálogo, IDs, cripto, consultas, settings, modelos de capacidade, Theil-Sen, ratings, prioridade de achados, coletor, IA (provedores simulados, anonimização) | nenhum |
tests/plugins/ |
um arquivo por plugin, com respostas gravadas (respx, FakeSSH, stubs de pyVmomi) e o registro de plugins |
nenhum |
tests/integration/ (marcador integration) |
API (bootstrap, login/lockout, troca de senha, refresh, tokens, RBAC, tenant, settings, credenciais, dispositivos, coletor, dashboards, aplicações, thresholds, achados, auditoria), pipeline (laboratório simulado de 8 dias no chdb + PostgreSQL: correlação, regras, ratings, balanceamento, previsão, change detection, resolução automática, overrides, rollups, QueryEngine, topologia), barramento (NatsPublisher → loops do ingestor), alertas (webhook real local, deduplicação, escalonamento) e automação (aprovação e ansible-runner) |
PostgreSQL 16, chdb, nats-server, Ansible |
Como rodar¶
cd backend
pip install -e '.[dev,automation]'
python -m pytest -q # tudo (~35 s)
python -m pytest -q -m "not integration" # unitários + plugins (~3 s, sem serviços)
python -m pytest -q -m integration
python -m pytest -q tests/integration/test_pipeline.py -k forecast
Pré-requisitos da integração: binários do PostgreSQL 16 em /usr/lib/postgresql/16/bin (ou
QV_TEST_PG_BIN), nats-server (pacote nats-server-bin), chdb, ansible-core e
ansible-runner. Sem PostgreSQL ou NATS, os testes que dependem deles são ignorados (skip).
Isolamento e fixtures¶
tests/conftest.pydefine todas as variáveisQV_*antes de qualquer import dequantix(as fábricas usamlru_cache), com portas livres e diretórios temporários próprios. A suíte nunca usa o ambiente de desenvolvimento.- Serviços reais sobem uma vez por sessão, só quando um teste de integração os pede
(
pg_server,nats_server), e são destruídos no fim. - Um único event loop por sessão (
asyncio_default_fixture_loop_scope = "session"). - Plugins:
make_ctx,assert_catalog,metrics_of,FakeSSH(ver Criando um plugin).
Outros testes¶
| Teste | Comando |
|---|---|
| Fumaça da API com payloads da GUI (~210 chamadas) | QV_API_URL=http://127.0.0.1:8000 QV_USER=admin QV_PASS='…' node frontend/scripts/smoke.mjs (QV_STRICT=1 reprova falhas conhecidas) |
| Tipos e lint do frontend | npm run typecheck && npm run lint |
| Implantação | make lint (compose em todas as variantes, Ansible syntax-check/ansible-lint, Helm lint/template, hadolint) |
| Escala | python backend/tools/benchmark/scale_benchmark.py --rows N --pg-dsn … (resultados) |
| Documentação | cd docs && mkdocs build --strict |