CodeWolf ERP — Guia Completo

src/
├── app/
│   ├── (auth)/                   # Grupo de rotas públicas
│   │   ├── login/
│   │   └── register/
│   ├── (dashboard)/              # Grupo de rotas protegidas
│   │   ├── dashboard/            # Overview + estatísticas
│   │   ├── clientes/             # CRM de clientes
│   │   ├── agenda/               # Agendamentos
│   │   ├── profissionais/        # Gestão de equipe
│   │   ├── servicos/             # Catálogo de serviços
│   │   ├── financeiro/           # Transações e fluxo de caixa
│   │   ├── whatsapp/             # Integração WhatsApp
│   │   └── configuracoes/        # Configurações da empresa
│   ├── api/
│   │   ├── webhook/evolution/    # Webhook da Evolution API
│   │   └── cron/
│   │       ├── reminders/        # Lembretes de agendamento
│   │       └── payment-reminders/ # Lembretes de pagamento
│   └── docs/                     # Esta documentação
├── components/
│   ├── ui/                       # Shadcn UI components
│   └── layout/                   # Header, Sidebar
└── lib/
    ├── prisma.ts                 # Prisma client singleton
    ├── auth.ts                   # Better-Auth config
    ├── evolution-api.ts          # Evolution API client
    ├── session.ts                # Utilitários de sessão
    └── utils.ts                  # Helpers gerais

prisma/
├── schema.prisma                 # Schema do banco de dados
└── seed.ts                       # Dados iniciais

(dashboard)/[modulo]/
├── page.tsx                 # Server Component — busca dados e passa para o Client
├── _data-access/
│   └── get-[modulo].ts      # Funções de leitura do banco (server-only)
├── _actions/
│   └── [modulo]-actions.ts  # Server Actions — mutações com Zod + revalidatePath
└── _components/
    └── content.tsx          # Client Component — UI interativa

# Gerar tabelas (desenvolvimento — sem migration files)
npm run db:push

# Criar migration (produção)
npm run db:migrate

# Regenerar Prisma Client após mudança no schema
npm run db:generate

# Abrir Prisma Studio (GUI visual)
npm run db:studio

# Popular banco com dados iniciais
npm run db:seed

# ---- Banco de Dados (PostgreSQL) -------------------------
DATABASE_URL="postgresql://USER:PASSWORD@HOST:5432/codewolf_erp?schema=public"

# ---- Better-Auth ----------------------------------------
BETTER_AUTH_SECRET="string-aleatoria-minimo-32-caracteres"
BETTER_AUTH_URL="https://seu-dominio.com"

# ---- Next.js --------------------------------------------
NEXT_PUBLIC_APP_URL="https://seu-dominio.com"
NEXT_PUBLIC_APP_NAME="Nome do seu Sistema"

# ---- Evolution API (WhatsApp) ---------------------------
EVOLUTION_API_URL="https://sua-evolution-api.com"
EVOLUTION_API_KEY="sua-api-key-global"
EVOLUTION_WEBHOOK_SECRET="token-para-validar-webhook"  # Opcional

# ---- Cron Jobs ------------------------------------------
CRON_SECRET="token-para-autenticar-crons"

# ---- E-mail (Opcional) ----------------------------------
SMTP_HOST="smtp.seu-provedor.com"
SMTP_PORT="587"
SMTP_USER="email@empresa.com"
SMTP_PASS="sua-senha"
SMTP_FROM="noreply@empresa.com"

POST https://seu-dominio.com/api/webhook/evolution

Cliente: "oi"  →  Bot exibe menu principal
Cliente: "1"   →  Lista de serviços disponíveis
Cliente: "2"   →  Próximos agendamentos do cliente
Cliente: "3"   →  Instruções para cancelar
Cliente: "0"   →  Transfere para atendente humano

# Via API (após criar a instância)
curl -X POST https://sua-evo.api.com/webhook/set/NOME_INSTANCIA \
  -H "apikey: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://seu-dominio.com/api/webhook/evolution",
    "enabled": true,
    "events": ["MESSAGES_UPSERT", "CONNECTION_UPDATE", "QRCODE_UPDATED"]
  }'

# Testar manualmente
curl -H "Authorization: Bearer SEU_CRON_SECRET" \
  https://seu-dominio.com/api/cron/reminders

{
  "crons": [
    {
      "path": "/api/cron/reminders",
      "schedule": "0 * * * *"
    },
    {
      "path": "/api/cron/payment-reminders",
      "schedule": "0 9 * * *"
    }
  ]
}

// src/app/(dashboard)/clientes/_data-access/get-clients.ts
export async function getClients() {
  const tenantId = await getTenantId(); // ← pega da sessão autenticada

  return prisma.client.findMany({
    where: {
      tenantId,          // ← isolamento garantido
      active: true,
    },
    orderBy: { name: "asc" },
  });
}