Skip to content

Requisitos de Qualidade

jota edited this page Aug 25, 2026 · 1 revision

Requisitos de Qualidade

⬅ Voltar para Documentação de Arquitetura


Requisitos de qualidade

Árvore de qualidade

QuaLeiDer - Qualidade
├── Segurança (P1)
│   ├── Autenticação
│   ├── Autorização
│   └── Proteção de Dados
├── Manutenibilidade (P2)
│   ├── Modularidade
│   ├── Testabilidade
│   │   ├── Cobertura de Código (96.25%)
│   │   ├── Testes Unitários (459 testes)
│   │   ├── Testes E2E (110 testes)
│   │   ├── Test Factories
│   │   └── Testes Arquiteturais
│   └── Documentação
├── Escalabilidade (P3)
│   ├── Capacidade
│   ├── Performance
│   └── Elasticidade
├── Confiabilidade (P4)
│   ├── Disponibilidade
│   ├── Recuperação de Falhas
│   └── Monitoramento
└── Usabilidade (P5)
    ├── Eficiência do Usuário Final
    ├── Experiência do Desenvolvedor
    └── Acessibilidade

Cenários de Qualidade {#_cen_rios_de_qualidade}

Cenário 1: Registro Rápido de Coleta (Usabilidade)

  • Fonte: Produtor de leite com baixa experiência técnica
  • Estímulo: Necessita registrar a coleta diária de leite pelo smartphone
  • Artefato: Interface web responsiva de registro de coletas
  • Ambiente: Hora do pico (07:00-09:00), rede 3G/4G instável
  • Resposta: Sistema apresenta formulário pré-preenchido com dados do último registro
  • Medida: Produtor completa o registro em < 45 segundos, com taxa de sucesso de 95%

Cenário 2: Aceitação de Convite sem Ajuda (Usabilidade)

  • Fonte: Novo produtor recebendo convite de associação pela primeira vez
  • Estímulo: Clica no link do email de convite
  • Artefato: Fluxo de aceitação de convite
  • Ambiente: Dispositivo móvel, primeira interação com o sistema
  • Resposta: Interface guiada com passos numerados (1/3, 2/3, 3/3) e confirmação visual
  • Medida: 95% dos usuários completam o fluxo sem pedir ajuda ou abandonar

Cenário 3: Carga de Produtores Simultâneos (Escalabilidade)

  • Fonte: 2.000 produtores de 50 associações diferentes
  • Estímulo: Todos registram coletas simultaneamente no horário de pico (07:00-09:00)
  • Artefato: API de registro de coletas (POST /daily-collections)
  • Ambiente: Sistema em produção com database PostgreSQL (connection pool: 20)
  • Resposta: Sistema processa todas as requisições sem perda de dados
  • Medida: Tempo de resposta < 300ms para 95% das requisições; 500 req/min sustentáveis

Cenário 4: Recuperação de Falha no Envio de Email (Confiabilidade)

  • Fonte: Serviço de email externo (ex: SendGrid) fora do ar por 30 minutos
  • Estímulo: Sistema tenta enviar email de reset de senha durante a indisponibilidade
  • Artefato: Módulo de envio de emails com sistema de eventos
  • Ambiente: Ambiente de produção, serviço externo com SLA de 99.9%
  • Resposta: Sistema registra o evento em fila e tenta reenvio automático (5, 15, 30 min)
  • Medida: 99% dos emails são entregues dentro de 1 hora; falhas permanentes são logadas

Cenário 5: Falha no CRON Job de Limpeza (Confiabilidade)

  • Fonte: CRON job de limpeza de convites expirados
  • Estímulo: Job falha por 3 dias consecutivos (ex: erro de database)
  • Artefato: Serviço InvitesCleanupService com monitoramento
  • Ambiente: Sistema em produção, database temporariamente indisponível
  • Resposta: Sistema registra falha em log estruturado para análise posterior
  • Medida: Falha registrada em < 5 minutos após 3ª tentativa consecutiva; convites não são deletados incorretamente

Cenário 6: Ataque de SQL Injection (Segurança)

  • Fonte: Atacante mal-intencionado
  • Estímulo: Tenta injetar SQL via campo de email: user@test.com' OR '1'='1
  • Artefato: Endpoint de login (POST /auth/login)
  • Ambiente: Sistema em produção exposto na internet
  • Resposta: Prisma ORM sanitiza a entrada; validação do DTO rejeita formato inválido
  • Medida: Tentativa de injeção é bloqueada; log de segurança registra a tentativa; 0 vulnerabilidades detectadas

Cenário 7: Token de Reset de Senha Expirado (Segurança)

  • Fonte: Usuário recebe email de reset de senha
  • Estímulo: Tenta usar o token após 20 minutos (limite: 15 minutos)
  • Artefato: Endpoint de reset de senha (POST /auth/reset-password)
  • Ambiente: Sistema em produção
  • Resposta: Sistema rejeita o token expirado com mensagem clara
  • Medida: Usuário recebe erro HTTP 400 com mensagem "Token expirado. Solicite um novo reset de senha."; novo token pode ser gerado

Cenário 8: Visualização de Dados Agregados (Funcionalidade)

  • Fonte: Associação com 150 produtores ativos
  • Estímulo: Solicita relatório de produção mensal
  • Artefato: Endpoint de relatórios (GET /reports/monthly-production)
  • Ambiente: Sistema em produção com 6 meses de histórico
  • Resposta: Sistema retorna dados agregados (total de leite, média por produtor, ranking)
  • Medida: Resposta gerada em < 2 segundos; dados consistentes com registros individuais; formato exportável (JSON/CSV)

Cenário 9: Alerta de Medicação Repetida (Funcionalidade)

  • Fonte: Produtor registra medicação para um animal
  • Estímulo: É a 3ª vez que o mesmo tipo de medicação é aplicado em 30 dias
  • Artefato: Módulo de análise de animais (futuro)
  • Ambiente: Sistema em produção com histórico de tratamentos
  • Resposta: Sistema gera alerta visual no dashboard e notificação por email
  • Medida: Alerta gerado em tempo real (< 5 segundos); taxa de falsos positivos < 5%; produtor pode marcar alerta como "revisado"

Cenário 10: Adição de Nova Funcionalidade sem Quebrar Testes (Testabilidade)

  • Fonte: Desenvolvedor precisa adicionar validação de CNPJ em associações
  • Estímulo: Requisito novo de validar formato e dígitos verificadores do CNPJ
  • Artefato: Service AssociationsService e DTO CreateAssociationDto
  • Ambiente: Ambiente de desenvolvimento com suite de testes completa (582 testes)
  • Resposta: Desenvolvedor adiciona validação em DTO; testes existentes continuam passando; novos testes são adicionados
  • Medida: Testes executados em < 60s; cobertura mantida > 95%; zero regressões; implementação completa em < 2 horas

Cenário 11: Substituição de Serviço de Email por Mock em Testes (Testabilidade)

  • Fonte: Desenvolvedor executando testes E2E localmente
  • Estímulo: Necessita testar fluxo de reset de senha sem enviar emails reais
  • Artefato: Módulo MailService e testes E2E de autenticação
  • Ambiente: Ambiente de desenvolvimento local sem acesso a serviço de email externo
  • Resposta: Sistema utiliza mock de MailService via Dependency Injection; emails são "enviados" para array em memória
  • Medida: Testes executam sem dependências externas; verificação de conteúdo de email via mock; 100% de isolamento

Cenário 12: Debugging de Falha em Produção via Testes Reproduzíveis (Testabilidade)

  • Fonte: Bug reportado em produção: convite duplicado não retorna erro 409
  • Estímulo: Desenvolvedor precisa reproduzir o bug localmente
  • Artefato: Teste E2E invites-crud.e2e-spec.ts
  • Ambiente: Ambiente de desenvolvimento com database PostgreSQL local
  • Resposta: Desenvolvedor adiciona teste que reproduz cenário exato do bug; teste falha conforme esperado; correção implementada; teste passa
  • Medida: Bug reproduzido em < 10 minutos; correção validada por teste automatizado; deploy com confiança (100% dos testes passando)

Clone this wiki locally