connfit — contexto — Kodama Vault

Projeto Kodama1/Connfit

O que faz: Plataforma SaaS completa para gestão de personal trainers e alunos. Oferece cadastro de alunos, montagem de fichas de treino, acompanhamento de progresso, agendamento, notificações e relatórios. Possui pipeline de background jobs para processamento assíncrono (envio de e-mails, geração de PDFs, limpeza de dados).

Stack principal: Next.js 16 (App Router), React 19, TypeScript, Tailwind CSS, shadcn/ui, Jotai (state global), Trigger.dev v4 (background jobs), Supabase (autenticação, banco PostgreSQL), Server Actions, Zod (validação), Jest + Playwright (testes).

Estrutura relevante:

src/actions/ — Server Actions (retornam { success, message, data? })
src/jotai/atoms/ — Atoms de estado global
src/components/ui/ — Componentes shadcn/ui (nunca duplicar)
trigger/ — Tasks do Trigger.dev (SDK v4, task e schemaTask)
prisma/ — Schema do banco de dados

Comandos comuns:

npm run dev — Sobe Next.js + Trigger.dev simultaneamente
npm run trigger:deploy — Deploy das background tasks
npm test — Suite completa de testes
npm run test:e2e — Testes end-to-end com Playwright
npm run build — Build de produção (com flags de memória)

Agentes/Skills notáveis:

Agente Guardian — Obrigatório antes de qualquer implementação. Analisa a task, aponta componentes reutilizáveis, padrões do projeto, alertas de best practices (Next.js 16/React 19) e recomenda arquitetura server vs client. Dispensado apenas para tarefas triviais (typo, ajuste de string, pesquisa).
Tasks Trigger.dev — Background jobs com retry automático (10 tentativas, exponential backoff), debounce (leading/trailing), waits (checkpoint automático após 5s) e schema validation via Zod. Usam SDK v4 (task, schemaTask) — proibido usar client.defineJob (v2).