Repository navigation
Riscos e Debitos Tecnicos
⬅ Voltar para Documentação de Arquitetura
Probabilidade: Média | Impacto: Alto | Prioridade: Alta
Descrição: Desenvolvedores podem adicionar novas funcionalidades sem criar testes correspondentes, reduzindo a cobertura ao longo do tempo.
Mitigação:
- CI/CD bloqueia merge se cobertura cair abaixo de 80%
- Code reviews obrigatórios verificam presença de testes
- Dashboard de cobertura visível para toda equipe
- Meta de 90%+ para camadas críticas (Application, Domain)
Plano de Contingência:
- Revisão de processo de code review
- Treinamento da equipe em boas práticas de teste
Probabilidade: Baixa | Impacto: Médio | Prioridade: Média
Descrição: Testes E2E podem falhar intermitentemente devido a dependências de tempo, concorrência ou estado compartilhado.
Mitigação Atual:
- Setup/teardown limpa database entre testes
- Uso de database isolado para testes E2E
- Sem dependências de sleep/timeout fixos
- Factories garantem dados determinísticos
Monitoramento:
- Taxa de sucesso dos testes E2E: 100%
- Reexecução automática de testes falhados (max 1x)
- Log detalhado de falhas intermitentes
Plano de Contingência:
- Identificar testes flaky via histórico de CI/CD
- Desabilitar temporariamente
- Refatorar para remover não-determinismo
Probabilidade: Média | Impacto: Médio | Prioridade: Média
Descrição: À medida que o sistema cresce, tempo de execução de testes pode aumentar, reduzindo velocidade de feedback.
Métricas Atuais:
- Testes Unitários: 50s (459 testes)
- Testes E2E: 90s (110 testes)
- Total: 140s
Limites Estabelecidos:
- Testes Unitários: < 60s
- Testes E2E: < 120s
- Total: < 180s
Mitigação:
- Execução paralela de testes (Jest workers)
- Otimização de queries em testes E2E
- Test filtering (rodar apenas testes afetados)
- Cache de módulos compilados
Plano de Contingência:
- Revisar testes lentos (> 5s unitários, > 10s E2E)
- Considerar splitting de suítes de teste
- Avaliar migração para Vitest se necessário
Prioridade: Alta | Esforço Estimado: 2 semanas
Descrição: Sistema não possui testes automatizados de carga para validar cenário de 2.000 produtores simultâneos.
Impacto:
- Impossível validar meta de escalabilidade (< 300ms com 500 req/min)
- Risco de degradação de performance em produção
Proposta de Resolução:
- Implementar testes com k6 ou Artillery
- Simular carga realista (pico 07:00-09:00)
- Incluir em pipeline de CI/CD (execução semanal)
- Monitorar métricas (latência p95, p99, taxa de erro)
Prioridade: Média | Esforço Estimado: 1 semana
Descrição: Não há testes automatizados específicos para validar vulnerabilidades de segurança (OWASP Top 10).
Impacto:
- Risco de regressões de segurança passarem despercebidas
- Validação manual é propensa a erros
Proposta de Resolução:
- Adicionar testes de SQL Injection (já mitigado por Prisma)
- Testes de XSS em endpoints que retornam HTML
- Validação de autenticação/autorização em todos endpoints
- Integrar SAST tool (ex: SonarQube) no pipeline
Probabilidade: Alta (já era a situação atual) | Impacto: Alto | Prioridade: Alta
Descrição:
A branch main não possui nenhuma regra de proteção configurada (confirmado via GET /repos/jardimdesoftware/qualeider/branches/main/protection → 404 "Branch not protected"). Qualquer colaborador com acesso de escrita pode dar push direto, force-push ou apagar a branch, contornando totalmente a exigência de "merge apenas por pull request" já adotada como convenção do time.
Impacto:
- Push direto ou force-push pode sobrescrever histórico sem revisão
- Pipeline de CI (lint, testes, Trivy) pode ser contornado simplesmente não abrindo PR
- Não há exigência de aprovação antes do merge
Proposta de Resolução:
- Habilitar branch protection na
main:- exigir Pull Request antes do merge (mínimo 1 aprovação)
- exigir que os status checks do
Backend CI/CDeFrontend CI/CDpassem antes do merge - bloquear force-push e deleção da branch
- Pode ser feito em Settings → Branches → Add branch protection rule, ou via
gh api repos/jardimdesoftware/qualeider/branches/main/protection(PUT)
Status: Resolvido em 23/09/2026 — branch main agora exige PR + 1 aprovação + os checks 🔍 Lint, 🧪 Unit Tests, 🔗 Integration Tests, 🌐 E2E Tests, 🛡️ Security Scan e CodeQL passando (branch atualizada antes do merge), além de bloquear force-push e deleção.
Prioridade: Média | Esforço Estimado: 5 minutos — Resolvido
Descrição:
O jest.config.ts base (usado pelo script npm test) não definia testMatch próprio, então herdava o padrão default do Jest e casava com todos os arquivos *.spec.ts dentro de tests/ — unit, integration, e2e e arch juntos. Isso duplicava exatamente o que test:unit, test:integration e test:e2e já rodam de forma isolada e corretamente configurada no CI, e fazia os testes de e2e falharem quando executados por esse caminho, pois só jest.e2e.config.ts carrega o .env.test com DATABASE_URL/JWT_SECRET.
Impacto:
- Desenvolvedor rodando
npm testlocalmente via de regra encontrava falhas nos e2e por falta de banco/variáveis de ambiente, mesmo com o código correto - Tempo de execução desnecessariamente maior (rodava tudo de novo)
Resolução aplicada:
- Adicionado
testMatch: ['<rootDir>/tests/unit/**/*.spec.ts']aojest.config.tsbase, escopandonpm testsó para os testes que não dependem de infraestrutura externa.test:unit,test:integrationetest:e2econtinuam com seus própriostestMatchinalterados.