| name | integration-tests-dotnet |
| description | Use esta skill para criar ou revisar testes de integracao .NET neste repositorio, incluindo WebApplicationFactory, fixtures, Testcontainers, isolamento e testes HTTP. Nao use para testes unitarios simples ou antes da base de integracao existir. |
Objetivo
Orientar testes de integracao da versao moderna do web-api-core-seed com foco em fidelidade, isolamento e custo de execucao.
No estado atual, o repositorio possui testes unitarios/leves em tests/WebApiCoreSeed.UnitTests e testes de integracao/container em tests/WebApiCoreSeed.IntegrationTests.
Quando usar
- Criar ou revisar testes HTTP com
WebApplicationFactory.
- Avaliar uso de Testcontainers para SQL Server, Redis ou outra dependencia real.
- Testar pipeline HTTP, DI, serializacao, filtros, autenticacao, migrations, constraints ou transacoes.
- Ajustar fixtures, seeds, limpeza de dados ou ciclo de vida de dependencias de teste.
Quando nao usar
- Testes unitarios puros de validators, services ou modelos.
- Validar build sem mudar estrategia de integracao.
- Criar dependencias externas caras sem decisao explicita.
- Executar testes sistemicos amplos sem infraestrutura versionada.
Processo
- Confirme se a base de integracao ja existe no repositorio.
- Identifique se o risco exige HTTP real, DI completo, provider de banco real ou isolamento simples.
- Use Testcontainers somente quando a dependencia real aumentar claramente a confianca.
- Evite portas fixas inventadas e dependencias externas nao controladas.
- Mantenha seeds e limpeza previsiveis.
- Documente impacto quando a estrategia oficial de testes mudar.
Validacao
Quando a infraestrutura existir, execute o projeto de teste afetado. Enquanto ela nao existir, registre a limitacao e nao crie comando ficticio.
Restricoes
- Nao alterar testes apenas para ocultar falha real.
- Nao tornar Testcontainers requisito amplo sem decisao registrada.
- Nao introduzir sleeps arbitrarios.
- Nao versionar segredos ou configuracao local sensivel.
