Design de Banco de Dados

Aprenda a PENSAR, não a copiar padrões SQL.

🎯 Regra de Leitura Seletiva

Leia APENAS arquivos relevantes para a solicitação! Verifique o mapa de conteúdo, encontre o que você precisa.

⚠️ Princípio Central

• PERGUNTE ao usuário sobre as preferências de banco de dados quando não estiver claro
• Escolha o banco de dados/ORM com base no CONTEXTO
• Não use PostgreSQL como padrão para tudo

Checklist de Decisão

Antes de projetar o esquema:

• Perguntou ao usuário sobre a preferência de banco de dados?
• Escolheu o banco de dados para ESTE contexto?
• Considerou o ambiente de implantação?
• Planejou a estratégia de indexação?
• Definiu os tipos de relacionamento?

Antí-Padrões

❌ Usar PostgreSQL como padrão para aplicativos simples (SQLite pode ser suficiente) ❌ Ignorar a indexação ❌ Usar SELECT * em produção ❌ Armazenar JSON quando dados estruturados são melhores ❌ Ignorar consultas N+1

Quando Usar

Use ao selecionar um modelo de banco de dados, revisar relacionamentos e índices de esquema, ou avaliar um esquema proposto com as ferramentas de consultoria incluídas.

Auxiliar de Esquema

scripts/schema_validator.py é um inventário heurístico somente leitura, não um analisador Prisma ou Drizzle. Esquemas ausentes, formatos não suportados e resultados somente heurísticos retornam um valor diferente de zero com passed: false e analysis_complete: false. Use o validador ORM local do projeto para verificações de sintaxe e tipo; revise a semântica de migração e restrição separadamente.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs, permissões, limites de segurança ou critérios de sucesso necessários estiverem ausentes.