Repository navigation
Requisitos de Qualidade
jota edited this page Aug 25, 2026
·
1 revision
⬅ Voltar para Documentação de Arquitetura
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
- 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%
- 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
- 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
- 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
- Fonte: CRON job de limpeza de convites expirados
- Estímulo: Job falha por 3 dias consecutivos (ex: erro de database)
-
Artefato: Serviço
InvitesCleanupServicecom 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
- 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
- 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
- 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)
- 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"
- 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
AssociationsServicee DTOCreateAssociationDto - 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
- Fonte: Desenvolvedor executando testes E2E localmente
- Estímulo: Necessita testar fluxo de reset de senha sem enviar emails reais
-
Artefato: Módulo
MailServicee testes E2E de autenticação - Ambiente: Ambiente de desenvolvimento local sem acesso a serviço de email externo
-
Resposta: Sistema utiliza mock de
MailServicevia 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
- 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)