Prompt file imported from luisfprj/chatbot (
.github/prompts/revisar-codigo.prompt.md). Copyright stays with the author.
Revisão de Código
Revise o código atual (ou os arquivos alterados recentemente) contra as regras do projeto.
O que verificar
Arquitetura
- Cada arquivo está no diretório correto conforme a estrutura definida (
handlers/,services/,validators/,types/,utils/)? - Handlers delegam para services sem lógica de negócio?
- Services contêm a lógica de negócio e acessam dados via Prisma Client?
- Validators são schemas Zod puros, sem dependência de banco?
- Tipos estão definidos em
types/e são importados onde necessário?
Segurança
- Alguma operação de banco usa concatenação de string em vez de Prisma Client?
- Tokens/secrets estão hardcoded ou sendo logados?
- Webhook verifica
X-Hub-Signature-256em todo POST recebido? - Apenas números com
active = trueemauthorized_numberspodem interagir? - Comando
/exportaré restrito à roleADMIN? - Dados de entrada são validados com Zod antes de processar?
Nomenclatura e Convenções
- Funções e variáveis usam
camelCase? - Tipos e interfaces usam
PascalCase? - Arquivos usam
kebab-case.ts? - Modelos Prisma usam
PascalCasecom@@mappara snake_case? - E-mail normalizado para lowercase antes de persistir?
Temporal
- Colunas de data no Prisma usam
DateTime(mapeia paraTIMESTAMPTZ)? - Timezone operacional
America/Sao_Paulorespeitado? - Nenhuma dependência do timezone do sistema operacional?
Máquina de Estados
- Transições de estado seguem o fluxo documentado em
arquitetura.md? - Entradas inválidas resultam em mensagem amigável, não em erro silencioso?
- Estado da conversa é persistido corretamente em
conversations?
Formato da Revisão
Para cada violação encontrada, reporte:
- Arquivo e linha onde a violação ocorre
- Regra violada (referência à regra específica)
- Impacto (segurança, consistência, manutenibilidade)
- Correção sugerida com exemplo de código quando aplicável
Se nenhuma violação for encontrada, confirme que o código está em conformidade.