@maestro-ai/mcp-server 1.2.0 → 2.1.0

package/dist/content/skills/specialist-banco-dados/resources/checklists/database-validation.md

@@ -0,0 +1,434 @@
+# Checklist de Validação de Banco de Dados
+
+## Sumário
+Checklist para validação completa de design de banco de dados, garantindo qualidade e consistência.
+
+---
+
+## 1. Validação de Schema
+
+### 1.1 Estrutura de Tabelas
+- [ ] **Tabelas criadas:** Todas as tabelas necessárias foram criadas
+- [ ] **Colunas definidas:** Todas as colunas têm tipos apropriados
+- [ ] **Primary Keys:** PKs definidas para todas as tabelas
+- [ ] **Foreign Keys:** FKs definidas para relacionamentos
+- [ ] **Constraints:** Constraints de integridade implementadas
+
+### 1.2 Tipos de Dados
+- [ ] **IDs:** UUID para novas tabelas
+- [ ] **Timestamps:** TIMESTAMP WITH TIME ZONE para datas
+- [ ] **Money:** DECIMAL(15,2) para valores monetários
+- [ ] **JSON:** JSONB para dados estruturados
+- [ ] **Strings:** VARCHAR com tamanho apropriado
+- [ ] **Numbers:** Tipos numéricos corretos (INTEGER, DECIMAL)
+
+### 1.3 Índices
+- [ ] **Índices PK:** Criados automaticamente
+- [ ] **Índices FK:** Índices em colunas de FK
+- [ ] **Índices únicos:** Para constraints UNIQUE
+- [ ] **Índices de performance:** Para queries principais
+- [ ] **Índices compostos:** Para queries com múltiplas colunas
+- [ ] **Índices parciais:** Para subsets de dados
+
+### 1.4 Constraints
+- [ ] **NOT NULL:** Campos obrigatórios marcados
+- [ ] **UNIQUE:** Unicidade de dados críticos
+- [ ] **CHECK:** Validação de regras de negócio
+- [ ] **DEFAULT:** Valores padrão definidos
+- [ ] **FK Actions:** Comportamento em DELETE/UPDATE definido
+
+---
+
+## 2. Validação de Performance
+
+### 2.1 Queries Principais
+- [ ] **EXPLAIN ANALYZE:** Planos de execução analisados
+- [ ] **Tempo de resposta:** Queries < 100ms para 95% dos casos
+- [ ] **Índices utilizados:** Queries usando índices apropriados
+- [ ] **Seq Scans:** Evitar full table scans
+- [ ] **Joins eficientes:** Joins usando índices
+
+### 2.2 Índices Efetivos
+- [ ] **Cardinalidade:** Índices em colunas seletivas
+- [ ] **Covering indexes:** Índices cobrindo queries
+- [ ] **Tamanho:** Índices não excessivamente grandes
+- [ ] **Manutenção:** Índices sendo utilizados
+- [ ] **Fragmentação:** Baixa fragmentação de índices
+
+### 2.3 Conexões e Pooling
+- [ ] **Pool Size:** Tamanho do pool configurado
+- [ ] **Max Connections:** Limite de conexões definido
+- [ ] **Timeout:** Timeout de conexão configurado
+- [ ] **Idle Timeout:** Timeout de ociosidade
+- [ ] **Connection Reuse:** Reuso de conexões
+
+### 2.4 Cache Strategy
+- [ ] **Application Cache:** Cache de consultas frequentes
+- [ ] **Database Cache:** Cache de resultados
+- [ ] **Redis:** Cache distribuído se aplicável
+- [ ] **TTL:** Time-to-life configurado
+- [ ] **Cache Invalidation:** Estratégia de invalidação
+
+---
+
+## 3. Validação de Segurança
+
+### 3.1 Autenticação e Autorização
+- [ ] **Users Table:** Tabela de usuários implementada
+- [ ] **Password Hash:** Senhas hasheadas (bcrypt/argon2)
+- [ ] **Roles Table:** Tabela de papéis definida
+- [ ] **Permissions:** Sistema de permissões implementado
+- [ ] **JWT Tokens:** Tokens com expiração
+
+### 3.2 Proteção de Dados
+- [ ] **PII Protection:** Dados pessoais protegidos
+- [ ] **Encryption:** Dados sensíveis criptografados
+- [ ] **Data Masking:** Mascaramento em logs
+- [ ] **Access Control:** RBAC implementado
+- [ **Audit Trail:** Logs de auditoria
+
+### 3.3 SQL Injection
+- [ ] **Parameterized Queries:** Queries parametrizadas
+- [ ] **ORM Protection:** ORM protegendo contra SQLi
+- [ ] **Input Validation:** Validação de entrada
+- [ ] **Least Privilege:** Princípio do menor privilégio
+- [ ] **Security Testing:** Testes de segurança
+
+### 3.4 Backup e Recuperação
+- [ ] **Backup Strategy:** Estratégia de backup definida
+- [ ] **Backup Frequency:** Frequência de backup configurada
+- [ ] **Backup Storage:** Armazenamento seguro
+- [ ] **Recovery Testing:** Testes de recuperação
+- [ **Retention Policy:** Política de retenção
+
+---
+
+## 4. Validação de Integridade
+
+### 4.1 Integridade Referencial
+- [ ] **FK Constraints:** Todas as FKs implementadas
+- [ ] **Cascade Actions:** Ações em cascade definidas
+- [ ] **Orphan Records:** Verificação de registros órfãos
+- [ ] **Circular References:** Sem referências circulares
+- [ ] **Data Consistency:** Consistência entre tabelas
+
+### 4.2 Validação de Dados
+- [ ] **Email Format:** Formato de email validado
+- [ ] **Phone Format:** Formato de telefone validado
+- [ ] **Date Ranges:** Datas em intervalos válidos
+- [ ] **Positive Numbers:** Valores positivos onde necessário
+- [ ] **Enum Values:** Valores em lista permitida
+
+### 4.3 Constraints de Negócio
+- [ ] **Business Rules:** Regras de negócio implementadas
+- [ ] **Data Validation:** Validação de dados de negócio
+- [ ] **Range Validation:** Validação de intervalos
+- [ ] **Format Validation:** Validação de formatos
+- [ ] **Cross-table Validation:** Validação entre tabelas
+
+---
+
+## 5. Validação de Escalabilidade
+
+### 5.1 Volume de Dados
+- [ ] **Storage Estimado:** Estimativa de armazenamento
+- [ ] **Growth Rate:** Taxa de crescimento projetada
+- [ ] **Partitioning:** Estratégia de particionamento
+- [ ] **Archiving:** Estratégia de arquivamento
+- [ ] **Purging:** Estratégia de limpeza
+
+### 5.2 Performance Escalável
+- [ ] **Read Replicas:** Réplicas de leitura configuradas
+- [ ] **Sharding:** Estratégia de sharding se necessário
+- [ ] **Load Balancing:** Balanceamento de carga
+- [ **Connection Pooling:** Pool de conexões otimizado
+- [ **Query Optimization:** Queries otimizadas
+
+### 5.3 Concorrência
+- [ ] **Lock Strategy:** Estratégia de bloqueio
+- [ ] **Deadlock Prevention:** Prevenção de deadlocks
+- [ ] **Transaction Isolation:** Nível de isolamento
+- [ **Optimistic Locking:** Versionamento otimista
+- [ **Pessimistic Locking:** Bloqueio pessimista
+
+---
+
+## 6. Validação de Backup
+
+### 6.1 Backup Strategy
+- [ ] **Full Backups:** Backups completos configurados
+- [ ] **Incremental Backups:** Backups incrementais
+- [ ] **Differential Backups:** Backups diferenciais
+- [ ] **Backup Schedule:** Cronograma de backup
+- [ ] **Backup Verification:** Verificação de backups
+
+### 6.2 Backup Storage
+- [ ] **Local Storage:** Armazenamento local
+- [ ] **Cloud Storage:** Armazenamento na nuvem
+- [ ] **Encryption:** Backup criptografado
+- [ ] **Redundancy:** Redundância geográfica
+- [ **Access Control:** Controle de acesso
+
+### 6.3 Recovery Testing
+- [ ] **Restore Testing:** Testes de restauração
+- [ **Point-in-Time Recovery:** Recuperação point-in-time
+- [ **Recovery Time Objective:** RTO definido
+- [ ] **Recovery Point Objective:** RPO definido
+- [ **Disaster Recovery:** Plano de recuperação
+
+---
+
+## 7. Validação de Monitoramento
+
+### 7.1 Métricas Essenciais
+- [ ] **Connection Count:** Número de conexões
+- [ ] **Query Performance:** Tempo médio de queries
+- [ ] **Lock Wait Time:** Tempo de espera por locks
+- [ **Cache Hit Rate:** Taxa de acerto do cache
+- [ ] **Disk Usage:** Uso de disco
+
+### 7.2 Alertas Configuradas
+- [ ] **High CPU:** Alerta de CPU alta
+- [ ] **High Memory:** Alerta de memória alta
+- [ ] **Low Disk:** Alerta de disco baixo
+- [ ] **Connection Pool:** Alerta de pool esgotado
+- [ ] **Slow Queries:** Alerta de queries lentas
+
+### 7.3 Dashboards
+- [ ] **Performance Dashboard:** Dashboard de performance
+- [ ] **Availability Dashboard:** Dashboard de disponibilidade
+- [ ] **Security Dashboard:** Dashboard de segurança
+- [ ] **Business Metrics:** Métricas de negócio
+- [ **Error Tracking:** Rastreamento de erros
+
+---
+
+## 8. Validação de Migrações
+
+### 8.1 Migration Strategy
+- [ ] **Zero-Downtime:** Migrações sem parada
+- [ ] **Backward Compatibility:** Compatibilidade com versões antigas
+- [ ] **Rollback Plan:** Plano de rollback
+- [ ] **Testing Environment:** Ambiente de teste
+- [ ] **Migration Scripts:** Scripts de migração
+
+### 8.2 Migration Testing
+- [ ] **Staging Testing:** Testes em ambiente staging
+- [ ] **Data Validation:** Validação de dados migrados
+- [ ] **Performance Testing:** Testes de performance
+- [ ] **Rollback Testing:** Testes de rollback
+- [ ] **User Acceptance:** Aceitação do usuário
+
+### 8.3 Migration Execution
+- [ ] **Pre-Migration Checklist:** Checklist pré-migração
+- [ ] **Migration Execution:** Execução da migração
+- [ ] **Post-Migration Validation:** Validação pós-migração
+- [ ] **Performance Monitoring:** Monitoramento de performance
+- [ ] **Rollback if Necessary:** Rollback se necessário
+
+---
+
+## 9. Validação de Documentação
+
+### 9.1 Schema Documentation
+- [ ] **ER Diagram:** Diagrama de entidades-relacionamentos
+- [ ] **Data Dictionary:** Dicionário de dados
+- [ ] **API Documentation:** Documentação de API
+- [ ] **Migration Guide:** Guia de migração
+- [ ] **Troubleshooting Guide:** Guia de troubleshooting
+
+### 9.2 Operational Documentation
+- [ ] **Backup Procedures:** Procedimentos de backup
+- [ ] **Recovery Procedures:** Procedimentos de recuperação
+- [ ] **Monitoring Setup:** Configuração de monitoramento
+- [ ] **Security Procedures:** Procedimentos de segurança
+- [ ] **Performance Tuning:** Ajuste de performance
+
+### 9.3 Development Documentation
+- [ ] **Database Design:** Design do banco
+- [ **Naming Conventions:** Convenções de nomenclatura
+- [ ] **Coding Standards:** Padrões de código
+- [ ] **Testing Guidelines:** Diretrizes de teste
+- [ ] **Deployment Guide:** Guia de deploy
+
+---
+
+## 10. Validação de Compliance
+
+### 10.1 Regulatory Compliance
+- [ ] **GDPR:** Conformidade com GDPR
+- [ ] **PCI DSS:** Conformidade com PCI DSS
+- [ ] **HIPAA:** Conformidade com HIPAA
+- [ ] **SOX:** Conformidade com SOX
+- [ **Local Laws:** Leis locais aplicáveis
+
+### 10.2 Data Privacy
+- [ ] **Data Minimization:** Minimização de dados
+- [ ] **Consent Management:** Gestão de consentimento
+- [ ] **Data Retention:** Política de retenção
+- [ ] **Right to Erasure:** Direito ao esquecimento
+- [ **Data Portability:** Portabilidade de dados
+
+### 10.3 Security Standards
+- [ ] **OWASP Top 10:** Conformidade OWASP
+- [ ] **ISO 27001:** Certificação ISO
+- [ ] **SOC 2:** Relatório SOC 2
+- [ ] **Penetration Testing:** Testes de penetração
+- [ ] **Security Audit:** Auditoria de segurança
+
+---
+
+## 11. Validação de Testes
+
+### 11.1 Unit Tests
+- [ ] **Schema Tests:** Testes de schema
+- [ ] **Constraint Tests:** Testes de constraints
+- [ ] **Index Tests:** Testes de índices
+- [ ] **Trigger Tests:** Testes de triggers
+- [ ] **Function Tests:** Testes de funções
+
+### 11.2 Integration Tests
+- [ ] **Application Tests:** Testes de aplicação
+- [ ] **ORM Tests:** Testes de ORM
+- [ ] **API Tests:** Testes de API
+- [ ] **Migration Tests:** Testes de migração
+- [ ] **Performance Tests:** Testes de performance
+
+### 11.3 End-to-End Tests
+- [ ] **User Workflows:** Fluxos de usuário
+- [ ] **Business Processes:** Processos de negócio
+- [ ] **Data Integrity:** Integridade de dados
+- [ ] **Security Tests:** Testes de segurança
+- [ ] **Load Tests:** Testes de carga
+
+---
+
+## 12. Validação de Ambiente
+
+### 12.1 Development Environment
+- [ ] **Database Instance:** Instância de banco configurada
+- [ ] **Schema Created:** Schema criado
+- [ ] **Seed Data:** Dados iniciais inseridos
+- [ ] **Indexes Created:** Índices criados
+- [ ] **Constraints Applied:** Constraints aplicadas
+
+### 12.2 Staging Environment
+- [ ] **Production Clone:** Clone da produção
+- [ ] **Data Masked:** Dados mascarados
+- [ ] **Performance Tested:** Performance testada
+- [ ] **Security Tested:** Segurança testada
+- [ ] **User Acceptance:** Aceitação do usuário
+
+### 12.3 Production Environment
+- [ ] **High Availability:** Alta disponibilidade
+- [ ] **Backup Configured:** Backup configurado
+- [ ] **Monitoring Active:** Monitoramento ativo
+- [ ] **Alerts Configured:** Alertas configurados
+- [ ] **Security Hardened:** Segurança reforçada
+
+---
+
+## 13. Score de Qualidade
+
+### 13.1 Cálculo de Score
+- **Schema Design:** 20 pontos
+- **Performance:** 20 pontos
+- **Security:** 20 pontos
+- **Scalability:** 15 pontos
+- **Documentation:** 10 pontos
+- **Testing:** 10 pontos
+- **Compliance:** 5 pontos
+
+### 13.2 Avaliação
+- **Excelente:** 90-100 pontos
+- **Bom:** 80-89 pontos
+- **Regular:** 70-79 pontos
+- **Precisa Melhorar:** 60-69 pontos
+- **Inadequado:** < 60 pontos
+
+### 13.3 Recomendações
+- **Score ≥ 90:** Pronto para produção
+- **Score 80-89:** Pequenos ajustes necessários
+- **Score 70-79:** Ajustes significativos necessários
+- **Score < 70:** Revisão completa necessária
+
+---
+
+## 14. Checklist Final
+
+### 14.1 Pré-Deploy
+- [ ] **All Tests Passing:** Todos os testes passando
+- [ ] **Performance Benchmarks:** Benchmarks de performance
+- [ ] **Security Scan:** Scan de segurança
+- [ ] **Backup Verified:** Backup verificado
+- [ ] **Documentation Updated:** Documentação atualizada
+
+### 14.2 Deploy
+- [ ] **Migration Scripts:** Scripts de migração
+- [ **Rollback Scripts:** Scripts de rollback
+- [ ] **Monitoring Setup:** Monitoramento configurado
+- [ ] **Alerts Active:** Alertas ativos
+- [ ] **Team Notified:** Time notificado
+
+### 14.3 Pós-Deploy
+- [ ] **Health Check:** Verificação de saúde
+- [ ] **Performance Check:** Verificação de performance
+- [ ] **Security Check:** Verificação de segurança
+- [ ] **User Testing:** Testes com usuários
+- [ ] **Documentation Update:** Atualização de documentação
+
+---
+
+## 15. Ferramentas de Validação
+
+### 15.1 Ferramentas Automáticas
+- **Schema Validation:** Validação de schema
+- **Performance Profiling:** Profile de performance
+- **Security Scanning:** Scan de segurança
+- **Data Quality:** Qualidade de dados
+- **Compliance Checking:** Verificação de compliance
+
+### 15.2 Scripts de Validação
+- **Check Scripts:** Scripts de verificação
+- **Test Scripts:** Scripts de teste
+- **Migration Scripts:** Scripts de migração
+- **Backup Scripts:** Scripts de backup
+- **Monitoring Scripts:** Scripts de monitoramento
+
+### 15.3 Dashboards
+- **Validation Dashboard:** Dashboard de validação
+- **Quality Metrics:** Métricas de qualidade
+- **Compliance Metrics:** Métricas de compliance
+- **Performance Metrics:** Métricas de performance
+- **Security Metrics:** Métricas de segurança
+
+---
+
+## 16. Apêndice
+
+### 16.1 Glossário
+- **PK:** Primary Key
+- **FK:** Foreign Key
+- **DDL:** Data Definition Language
+- **DML:** Data Manipulation Language
+- **ACID:** Atomicity, Consistency, Isolation, Durability
+
+### 16.2 Referências
+- **PostgreSQL Docs:** [postgresql.org/docs](https://postgresql.org/docs/)
+- **MySQL Docs:** [dev.mysql.com/doc](https://dev.mysql.com/doc/)
+- **Database Best Practices:** [Link para guia]
+- **Security Guidelines:** [Link para guia]
+
+### 16.3 Templates
+- **Checklist Template:** Template de checklist
+- **Validation Report:** Relatório de validação
+- **Score Calculation:** Cálculo de score
+- **Action Items:** Itens de ação
+
+---
+
+**Status:** [Em progresso/Concluído]  
+**Validado por:** [Nome]  
+**Data:** [Data]  
+**Score:** [Pontuação]  
+**Próxima Revisão:** [Data]