quality-assurance

🧪 Regras de Testes e Qualidade

🎯 Cobertura Minima

• Todo novo artefato exige teste correspondente.
• bug e implementacao exigem testes unitarios.
• Em bug, o teste deve reproduzir o problema e impedir recorrencia.
• Foco principal: testes unitarios. Integracao entra em pontos criticos quando necessario.
• Testes de API: usar mocks para HTTP/DB quando o contexto pedir isolamento.

🚀 Fluxo Obrigatorio

Estas regras se aplicam quando a demanda envolve implementacao: bug ou implementacao. Para analise, nao ha obrigacao de rodar testes antes ou depois, porque nao ha mudanca de implementacao.

Antes de implementar

• Execute a suite de testes relevante.
• Defina e reporte o escopo minimo da baseline (modulo afetado + regressao relacionada).
• Se a suite falhar antes da mudanca, interrompa o trabalho.
• Analise a falha e discuta com o usuario antes de seguir.

Durante a implementacao

• Nao trate teste como acessorio decorativo.
• Nao remova teste so para fazer a suite passar.
• Se um teste precisar ser removido por mudanca real de comportamento, registre a justificativa explicitamente.

Ao final da implementacao

• Execute os testes relevantes e reporte PASS ou FAIL.
• Avalie a qualidade dos testes criados ou alterados.
• Verifique se os testes cobrem o comportamento pedido, nao apenas a linha feliz cosmetica.

🔍 Criterios de qualidade dos testes

• O teste falha sem a implementacao correta.
• O teste protege regra de negocio ou comportamento observavel.
• O teste tem nome claro e intencao legivel.
• O teste nao depende de excesso de mocks sem necessidade.
• O teste nao foi afrouxado artificialmente para aceitar comportamento incorreto.

🚫 Antipadroes proibidos

• Remover teste para maquiar suite verde.
• Alterar assercoes para algo vago so porque a implementacao nao sustentou o contrato.
• Declarar "nao aplicavel" para testes. Nesta base, teste sempre e aplicavel.

✅ Definition of Done (Geral)

1. Código limpo e testado.
2. Sem nomes genéricos.
3. Logs estruturados em inglês via logAdapter.
4. Testes executados antes e depois da implementacao.
5. Qualidade dos testes analisada e reportada.
6. Documentação sugerida/atualizada.

Saida estruturada obrigatoria

Ao concluir a revisao, responda com:

• status: PASS ou FAIL
• baseline_pre: comando(s) e resultado antes da implementacao
• validacao_pos: comando(s) e resultado apos a implementacao
• achados: riscos de teste e cobertura
• acoes: correcoes obrigatorias antes de concluir