Skip to content

Riscos e Debitos Tecnicos

jota edited this page Sep 23, 2026 · 3 revisions

Riscos e Débitos Técnicos

⬅ Voltar para Documentação de Arquitetura


Riscos e Débitos Técnicos

Riscos Relacionados à Testabilidade

RT-001: Degradação da Cobertura de Testes

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

RT-002: Testes E2E Flaky (Instáveis)

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

RT-003: Lentidão Progressiva dos Testes

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

Débitos Técnicos Relacionados à Testabilidade

DT-001: Ausência de Testes de Carga (Load Testing)

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)

DT-002: Cobertura de Testes de Segurança

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

Riscos e Débitos Relacionados à Governança do Repositório

RT-004: Branch main sem proteção — Resolvido

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/CD e Frontend CI/CD passem 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.

DT-003: npm test duplicava a execução de todos os testes (unit + integration + e2e)

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 test localmente 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'] ao jest.config.ts base, escopando npm test só para os testes que não dependem de infraestrutura externa. test:unit, test:integration e test:e2e continuam com seus próprios testMatch inalterados.

Clone this wiki locally