Pular para conteúdo

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.py define todas as variáveis QV_* antes de qualquer import de quantix (as fábricas usam lru_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