Projeto agencia-kodama-admin

CRM interno da agência Kodama para controle de prospects, pipeline de vendas, reuniões e leads do Google Ads. Produção em crm.kodama.solutions.

Stack principal

• Next.js 16 (App Router, Turbopack, output standalone)
• React 19, TypeScript estrito
• Tailwind v4 com tokens OKLCH
• shadcn/ui (Radix UI) estilo new-york
• SQLite (better-sqlite3) + Drizzle ORM
• Better Auth para autenticação (email/senha)

Estrutura relevante

src/app/(logged)/ contém as rotas protegidas: dashboard, prospects (CRUD completo), reunioes, leads/google-ads, campanhas (gestão de campanhas Meta Ads + campanhas internas com checklist gerado por IA e fila de processamento). src/middleware.ts gerencia autenticação com exceções para rotas públicas.

Comandos comuns

npm run dev    # servidor de desenvolvimento
npm run build  # build de produção
npx shadcn@latest add <nome>    # adicionar componente shadcn

Agents/skills notáveis

• Regra de UI "shadcn-first": proíbe HTML primitivo solto (button, input, select, table) fora de src/components/ui/*. Uso obrigatório de componentes shadcn como Button, Input, Table, Card, AlertDialog.
• Checklist de compliance: grep automático pré-commit para detectar classes legadas e HTML primitivo onde deveria haver shadcn.