@maestro-ai/mcp-server 1.2.0 → 2.1.0

package/dist/content/skills/specialist-modelagem-dominio/resources/checklists/domain-validation.md

@@ -0,0 +1,341 @@
+# Checklist de Validação de Modelo de Domínio
+
+## Sumário
+Checklist para validação completa de modelos de domínio, garantindo qualidade e consistência.
+
+---
+
+## 1. Validação de Entidades
+
+### 1.1 Identificação de Entidades
+- [ ] **Entidade tem identidade única?**
+  - [ ] Possui ID ou identificador natural
+  - [ ] ID é imutável
+  - [ ] ID é único no contexto
+
+- [ ] **Entidade tem ciclo de vida bem definido?**
+  - [ ] Estados claros (criado, ativo, inativo, etc.)
+  - [ ] Transições de estado definidas
+  - [ ] Regras de mudança de estado
+
+- [ ] **Entidade tem comportamentos próprios?**
+  - [ ] Métodos que modificam estado
+  - [ ] Métodos de consulta
+  - [ ] Validações internas
+
+### 1.2 Atributos das Entidades
+- [ ] **Atributos têm tipos definidos?**
+  - [ ] Tipos primitivos (string, number, boolean)
+  - [ ] Value Objects para conceitos complexos
+  - [ ] Coleções tipadas
+
+- [ ] **Atributos obrigatórios identificados?**
+  - [ ] Marcação clara de campos obrigatórios
+  - [ ] Validação de campos obrigatórios
+  - [ ] Valores padrão definidos
+
+- [ ] **Atributos têm validações?**
+  - [ ] Formato (email, CPF, etc.)
+  - [ ] Tamanho mínimo/máximo
+  - [ ] Valores permitidos
+
+### 1.3 Relacionamentos
+- [ ] **Cardinalidade definida?**
+  - [ ] 1:1, 1:N, N:N claramente definidos
+  - [ ] Multiplicidade mínima e máxima
+  - [ ] Relacionamentos opcionais vs obrigatórios
+
+- [ ] **Direção do relacionamento?**
+  - [ ] Unidirecional vs bidirecional
+  - [ ] Justificativa para direção
+  - [ ] Impacto na performance
+
+- [ ] **Comportamento em cascata?**
+  - [ ] Delete cascade definido
+  - [ ] Update cascade definido
+  - [ ] Restrições de integridade
+
+---
+
+## 2. Validação de Value Objects
+
+### 2.1 Imutabilidade
+- [ ] **Value Object é imutável?**
+  - [ ] Propriedades readonly
+  - [ ] Métodos retornam novas instâncias
+  - [ ] Sem setters públicos
+
+- [ ] **Validação no construtor?**
+  - [ ] Validação de dados obrigatórios
+  - [ ] Validação de formato
+  - [ ] Lançamento de exceções para dados inválidos
+
+### 2.2 Comportamento
+- [ ] **Métodos de negócio implementados?**
+  - [ ] Comparações (equals, hashCode)
+  - [ ] Operações aritméticas (Money)
+  - [ ] Formatação e exibição
+
+- [ ] **Sem identidade própria?**
+  - [ ] Igualdade baseada em valores
+  - [ ] Não tem ID próprio
+  - [ ] Foco em conceitos do domínio
+
+---
+
+## 3. Validação de Agregados
+
+### 3.1 Raiz do Agregado
+- [ ] **Raiz claramente identificada?**
+  - [ ] Entidade principal definida
+  - [ ] Controle sobre outras entidades
+  - [ ] Ponto de acesso externo
+
+- [ ] **Invariantes mantidos?**
+  - [ ] Regras de consistência internas
+  - [ ] Validação de estado
+  - [ ] Transações atômicas
+
+### 3.2 Fronteiras do Agregado
+- [ ] **Limites bem definidos?**
+  - [ ] Entidades dentro do agregado
+  - [ ] Referências externas por ID
+  - [ ] Sem acesso direto a entidades internas
+
+- [ ] **Comunicação entre agregados?**
+  - [ ] Eventos de domínio
+  - [ ] Services para coordenação
+  - [ ] Mínimo acoplamento
+
+---
+
+## 4. Validação de Regras de Negócio
+
+### 4.1 Regras por Entidade
+- [ ] **Regras documentadas?**
+  - [ ] Descrição clara da regra
+  - [ ] Condições de aplicação
+  - [ ] Exceções e tratamentos
+
+- [ ] **Regras implementadas?**
+  - [ ] Validação no método ou construtor
+  - [ ] Lançamento de exceções específicas
+  - [ ] Mensagens de erro claras
+
+### 4.2 Invariantes
+- [ ] **Invariantes identificados?**
+  - [ ] Condições sempre verdadeiras
+  - [ ] Verificação após mudanças
+  - [ ] Documentação de invariantes
+
+- [ ] **Validação de invariantes?**
+  - [ ] Verificação em métodos críticos
+  - [ ] Testes de invariantes
+  - [ ] Logging de violações
+
+---
+
+## 5. Validação de Casos de Uso
+
+### 5.1 Completude
+- [ ] **Todos os requisitos mapeados?**
+  - [ ] RFs → Casos de uso
+  - [ ] RNFs → Restrições técnicas
+  - [ ] Casos de borda cobertos
+
+- [ ] **Fluxos principais definidos?**
+  - [ ] Happy path completo
+  - [ ] Passos claros e sequenciais
+  - [ ] Resultados esperados
+
+### 5.2 Fluxos Alternativos
+- [ ] **Exceções mapeadas?**
+  - [ ] Casos de erro
+  - [ ] Tratamento de exceções
+  - [ ] Recuperação de falhas
+
+- [ ] **Validações de entrada?**
+  - [ ] Pré-condições verificadas
+  - [ ] Validação de parâmetros
+  - [ ] Permissões e autorizações
+
+---
+
+## 6. Validação de Linguagem Ubíqua
+
+### 6.1 Consistência
+- [ ] **Termos consistentes?**
+  - [ ] Mesmo termo em todo modelo
+  - [ ] Sinônimos documentados
+  - [ ] Glossário atualizado
+
+- [ ] **Conceitos do negócio?**
+  - [ ] Termos do domínio real
+  - [ ] Sem jargões técnicos
+  - [ ] Clareza para stakeholders
+
+### 6.2 Comunicação
+- [ ] **Comunicação clara?**
+  - [ ] Descrições autoexplicativas
+  - [ ] Exemplos práticos
+  - [ ] Diagramas complementares
+
+---
+
+## 7. Validação de Arquitetura
+
+### 7.1 Bounded Contexts
+- [ ] **Contextos definidos?**
+  - [ ] Fronteiras claras
+  - [ ] Responsabilidades delimitadas
+  - [ ] Comunicação entre contexts
+
+- [ ] **Mapeamento de conceitos?**
+  - [ ] Tradução entre contexts
+  - [ ] Conceitos compartilhados
+  - [ ] Anti-corruption layers
+
+### 7.2 Arquitetura C4
+- [ ] **Nível 1: Contexto claro?**
+  - [ ] Sistema e limites
+  - [ ] Atores e interações
+  - [ ] Sistemas externos
+
+- [ ] **Nível 2: Containers definidos?**
+  - [ ] Frontend, backend, banco
+  - [ ] Tecnologias apropriadas
+  - [ ] Comunicação entre containers
+
+- [ ] **Nível 3: Componentes mapeados?**
+  - [ ] Serviços e módulos
+  - [ ] Responsabilidades claras
+  - [ ] Dependências controladas
+
+---
+
+## 8. Validação de Performance
+
+### 8.1 Complexidade
+- [ ] **Modelo simples o suficiente?**
+  - [ ] Sem over-engineering
+  - [ ] Entidades necessárias apenas
+  - [ ] Relacionamentos justificados
+
+- [ ] **Performance considerada?**
+  - [ ] Consultas otimizadas
+  - [ ] Índices necessários
+  - [ ] Cache estratégico
+
+### 8.2 Escalabilidade
+- [ ] **Crescimento previsto?**
+  - [ ] Volume de dados
+  - [ ] Número de usuários
+  - [ ] Complexidade futura
+
+---
+
+## 9. Validação de Testabilidade
+
+### 9.1 Testes Unitários
+- [ ] **Entidades testáveis?**
+  - [ ] Construtores simples
+  - [ ] Dependências injetadas
+  - [ ] Métodos testáveis
+
+- [ ] **Value Objects testáveis?**
+  - [ ] Casos de borda
+  - [ ] Validações
+  - [ ] Comparações
+
+### 9.2 Testes de Integração
+- [ ] **Relacionamentos testados?**
+  - [ ] Persistência
+  - [ ] Consultas complexas
+  - [ ] Transações
+
+---
+
+## 10. Validação de Documentação
+
+### 10.1 Completude
+- [ ] **Documentação completa?**
+  - [ ] Todas as entidades documentadas
+  - [ ] Relacionamentos explicados
+  - [ ] Regras de negócio descritas
+
+- [ ] **Exemplos práticos?**
+  - [ ] Casos de uso reais
+  - [ ] Diagramas claros
+  - [ ] Código de exemplo
+
+### 10.2 Manutenibilidade
+- [ ] **Documentação atualizada?**
+  - [ ] Versão atual do modelo
+  - [ ] Mudanças documentadas
+  - [ ] Histórico de alterações
+
+---
+
+## 11. Checklist Final de Qualidade
+
+### 11.1 Score de Qualidade
+- [ ] **Entidades (20 pontos):** [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ]
+- [ ] **Relacionamentos (15 pontos):** [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ]
+- [ ] **Regras de Negócio (20 pontos):** [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ]
+- [ ] **Casos de Uso (15 pontos):** [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ]
+- [ ] **Linguagem Ubíqua (10 pontos):** [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ]
+- [ ] **Arquitetura (10 pontos):** [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ]
+- [ ] **Documentação (10 pontos):** [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ]
+
+**Total:** [ ] / 100 pontos
+
+### 11.2 Status de Validação
+- [ ] **Aprovado (≥ 75 pontos):** Modelo pronto para implementação
+- [ ] **Parcial (60-74 pontos):** Revisões necessárias
+- [ ] **Reprovado (< 60 pontos):** Refatoração obrigatória
+
+### 11.3 Próximos Passos
+- [ ] **Correções pendentes:** [Lista de itens a corrigir]
+- [ ] **Melhorias sugeridas:** [Lista de melhorias]
+- [ ] **Riscos identificados:** [Lista de riscos]
+- [ ] **Decisões pendentes:** [Lista de decisões]
+
+---
+
+## 12. Referências de Validação
+
+### 12.1 Padrões DDD
+- [ ] **Domain-Driven Design:** Eric Evans
+- [ ] **Implementing DDD:** Vaughn Vernon
+- [ ] **DDD Distilled:** Vaughn Vernon
+
+### 12.2 Arquitetura
+- [ ] **C4 Model:** Simon Brown
+- [ ] **Clean Architecture:** Robert C. Martin
+- [ ] **12-Factor App:** Heroku
+
+### 12.3 Qualidade
+- [ ] **Clean Code:** Robert C. Martin
+- [ ] **Refactoring:** Martin Fowler
+- [ ] **Design Patterns:** Gang of Four
+
+---
+
+## 13. Ferramentas de Validação
+
+### 13.1 Automatização
+- [ ] **Linters:** Para código e documentação
+- [ ] **Testes automatizados:** Para validação
+- [ ] **CI/CD:** Para validação contínua
+
+### 13.2 Análise Estática
+- [ ] **Analisadores de código:** Para detectar problemas
+- [ ] **Métricas de complexidade:** Para avaliar qualidade
+- [ ] **Diagramas automáticos:** Para visualização
+
+---
+
+**Status:** [Em andamento/Concluído]  
+**Validador:** [Nome]  
+**Data:** [Data]  
+**Versão:** [Versão do checklist]