Tibé (AgroGestão)

SaaS multi-tenant de gestão agropecuária: rebanho, lavoura, prestação de serviço e financeiro, com agente de IA no WhatsApp como canal primário. Desenvolvido pela Pleno Digital; cliente/financiador do MVP: Da Mata Sementes LTDA.

Produto: docs/tibe-prd.md · Specs por módulo: docs/specs/ · Documentação técnica navegável (arquitetura, schema, todos os endpoints, agente WhatsApp, guias): /docs no app.

Trabalhando no código? O contexto operacional completo está em CLAUDE.md: invariantes, status dos módulos, armadilhas do ambiente e o mapa de onde cada coisa mora. Este README é só a porta de entrada.

Stack

Next.js 14 (App Router) · TypeScript · Tailwind CSS · Prisma 7 (@prisma/adapter-pg) · PostgreSQL 17 (Neon) · NextAuth v5 beta · Zod · Recharts · Redis Cloud + BullMQ · N8N (orquestração do agente WhatsApp) · Evolution API / WhatsApp Cloud API · Asaas (cobrança recorrente).

Estrutura de pastas

src/app/(public)/     páginas sem autenticação: home, planos, faq, políticas, docs, login, criar-conta
src/app/(dashboard)/  painel autenticado, uma pasta por módulo
src/app/plataforma/   painel interno da Pleno Digital: auth separada da de tenant
src/app/api/v1/       API de negócio (sessão obrigatória via guard())
src/app/api/platform/ API do painel da plataforma (guardPlatform())
src/app/api/internal/ rotas chamadas pelo N8N e pela Vercel Cron (secret no header)
src/app/api/webhooks/ rotas chamadas por serviços externos (Asaas: token no header)
src/lib/actions/      lógica de negócio pura (funções que recebem o client Prisma escopado)
src/lib/prisma.ts     client Prisma + extension de isolamento multi-tenant
src/components/       componentes React, organizados por módulo
prisma/schema.prisma  modelos em PascalCase, campos em snake_case
scripts/              testes de isolamento e regressão (via tsx, sem servidor)
.claude/rules/        regras por área, carregadas sob demanda pelo agente

Pré-requisitos

• Node.js 20+ (testado em Node 24)
• PostgreSQL 17 (Neon em produção; Docker local em desenvolvimento)
• Redis (Redis Cloud ou local): job de alertas e lock de idempotência diário

Setup local

npm install               # roda "prisma generate" via postinstall
cp .env.example .env      # preencha ao menos DATABASE_URL e NEXTAUTH_SECRET
npm run db:deploy         # aplica as migrações
npm run db:seed           # tenant Da Mata + owner + catálogo de vacinas
npm run dev               # http://localhost:3000

Postgres local via Docker

docker run -d --name tibe-pg \
  -e POSTGRES_PASSWORD=tibe -e POSTGRES_USER=tibe -e POSTGRES_DB=tibe_dev \
  -p 55432:5432 postgres:17

⚠️ O .env deste projeto aponta para o Neon de produção; o .env.local, quando existe, para o Docker, e o Next e as suítes o leem primeiro (ver o CLAUDE.md). O Prisma CLI só lê o .env. Para rodar teste ou migração localmente, passe a URL do Docker inline, com 127.0.0.1 (e não localhost, que não resolve neste ambiente):

DATABASE_URL="postgresql://tibe:[email protected]:55432/tibe_dev?schema=public" npm run test:m1

Credenciais do seed (dev): [email protected] / tibe123. O tenant do seed nasce sem TenantProfile, então o primeiro login cai no onboarding.

Verificação

npm run check          # conferência estática do repositório, sem banco
npm run build          # build de produção (roda lint + tsc)
npm run test:isolation # isolamento multi-tenant (Módulo 0)

A lista completa de suítes está no package.json, e é ela que vale: npm run check reprova qualquer comando citado na documentação que não exista lá, além de caminho e rota que não existem mais.

Isolamento multi-tenant

tenant_id nunca vem do client: é sempre resolvido da sessão no servidor, e o isolamento é implementado por uma Prisma Client Extension em src/lib/prisma.ts, fonte única de verdade, validada por testes automatizados.

A regra completa, com a lista justificada de cada exceção legítima, está em .claude/rules/isolamento.md e em /docs/arquitetura no app.

Deploy

Passo a passo inicial (GitHub + Vercel + Neon) em docs/deploy.md. A configuração de produção de hoje, com todas as variáveis de ambiente e o cron de alertas, está em /docs/deploy no app, mantido junto com o código.

Merge na main dispara deploy de produção: não há staging além dos previews de PR, e a migração precisa ser aplicada antes do push.