[openaudit-search-api] Testes de integração com catálogo real mínimo (fixture sqlite + meta) e cenários de busca

[4lessandrodev]

Repo: openaudit-search-api

Tags: priority:high type:feature area:tests

Visão geral

Garantir que o /search funciona de ponta a ponta com um catálogo SQLite real (FTS5) e metadados.

Contexto

Sem testes de integração com o catálogo real, a API pode funcionar em mock e quebrar em produção. Precisamos de um fixture mínimo e sintético.

Descrição

Criar em tests/fixtures/:

• catalog.sqlite mínimo com 5–20 entidades sintéticas
• tabela entities e índice FTS5 conforme esperado
• catalog_meta.json sintético validável

Cenários de teste:

• busca por termo exato retorna candidato esperado
• busca por alias retorna candidato
• busca sem resultados retorna lista vazia
• paginação respeitada
• filtros contextuais (se aplicável)
• headers presentes (X-Request-Id, X-Catalog-Version, X-Cache)

Regra: fixtures devem ser sintéticas (não usar pessoas reais).

Impacto

Aumenta estabilidade e confiabilidade do MVP e facilita contribuição sem depender de dados reais.

Referências

• https://github.com/OpenAudit-Brasil/openaudit-search-api/blob/main/README.md
• https://github.com/OpenAudit-Brasil/About/blob/main/SECURITY.md
• https://github.com/OpenAudit-Brasil/About/blob/main/METHODOLOGY.md
• https://github.com/OpenAudit-Brasil/About/blob/main/RISK_POLICY.md

Definição de pronto

• Fixtures sqlite + meta adicionados
• Testes de integração passam localmente e em CI
• Nenhum dado real sensível presente
• Cobertura mínima dos cenários listados