Pré-Safra Tracker

App web interno da ControlSoft que acompanha, por safra, a revisão e a configuração do sistema de cada cliente (substitui a planilha "Pré-Safra 2026"). Next.js 16 (App Router) + Prisma 7 + PostgreSQL (Neon).

O que tem

• Clientes (/): lista com filtros (incluindo motivo de pendência), agendamento por cliente (responsável, data, horário, Online/Presencial), finalizar e reabrir em lote. Cliente A Fazer ou Atrasado recebe um motivo de pendência.
• Registro do cliente (/registro/[id]): observações, histórico de finalizações, data de finalização editável e avisos ao cliente por WhatsApp (link wa.me ou API) e e-mail.
• Painel (/painel): metas, ritmo e gargalos da safra (somente leitura).
• Relatórios (/relatorios): situação da safra, por pessoa (responsável, região ou consultor), conferência dos itens de finalização e evolução dia a dia, com filtros e Salvar em PDF (impressão do navegador). A evolução usa uma foto diária do estado dos clientes (ver "Fotos diárias" abaixo).
• Calendário (/calendario): atividades da equipe e agendamentos dos clientes.
• Novo cliente (/novo): cadastro avulso e importação de planilha (admin).
• Admin (/admin): clientes, safras, usuários e sugestões, com Backup em Excel de todas as tabelas e exportação dos clientes.
• Telão de ideias (/telao, /sugestao): QR code para o público sugerir temas de FAQ ou melhorias para o sistema (com anexos e ditado por voz), com meta de FAQ, ranking e comemoração; fica desligado até o admin ativar.

Cada usuário tem um papel (comum, personalizado, admin ou somente Painel). No papel Personalizado o admin libera permissões uma a uma (clientes, safras, sugestões, backup, telão, alterar clientes de qualquer responsável, trocar responsável, cadastrar, editar atividades de outros). Quem não é admin tem uma ligação com um responsável e só altera os clientes dele.

Rodando localmente

npm install                  # também gera o client do Prisma
cp .env.example .env         # preencha DATABASE_URL e AUTH_SECRET
npm run db:push              # cria/atualiza as tabelas (não há migrations)
npm run criar-usuario -- "Seu Nome" [email protected] SENHA_COM_10_OU_MAIS --admin
npm run dev                  # http://localhost:3000

Depois, em Admin → Safras, crie a safra e importe os clientes em /novo.

Os avisos ao cliente são opcionais: sem configuração, só o link wa.me do registro funciona. Para enviar pela API, preencha no .env as variáveis de NOTIFICACAO_* (webhook de WhatsApp), RESEND_API_KEY e EMAIL_REMETENTE (e-mail); veja .env.example.

Comandos

Comando	Faz
npm run dev / build / start	servidor Next
npm test	Vitest (o teste de acoesPreSafra usa o banco real de DATABASE_URL)
npm run lint	ESLint
npm run db:push	aplica o schema.prisma no banco
npm run importar, importar:gifnoc, importar:cidades	importação de clientes (use --simular antes)
npm run padronizar:nomes	coloca o nome dos clientes em maiúsculas (--simular antes)
npm run criar-usuario	cria ou redefine um usuário
npm run foto:diaria	tira agora a foto diária do estado dos Pré-Safras (alimenta Relatórios → Evolução); repetir no mesmo dia só refaz a foto
npm run gerar-faq	gera src/data/faq.json a partir do backup da Base de Conhecimento
npx tsx scripts/restaurar-backup.ts <backup.xlsx> [--limpar]	restaura num banco local o backup em Excel (recusa qualquer banco fora de localhost)

Os scripts rodam contra o banco de DATABASE_URL: confira o alvo antes. Depois de atualizar o código, rode npm run db:push em cada banco (dev e produção) para criar as colunas e tabelas novas.

Publicando (Vercel)

Variáveis de ambiente do projeto na Vercel (veja .env.example): DATABASE_URL, AUTH_SECRET e APP_URL.

• APP_URL: endereço público do sistema, com https:// (ex.: https://presafra.seudominio.com.br). Obrigatória para gerar o link de redefinição de senha: sem ela o botão avisa e não gera nada. Em produção um endereço http:// é recusado.
• RESEND_API_KEY e EMAIL_REMETENTE (opcionais): servem só para os avisos por e-mail ao cliente e para o aviso "sua senha foi alterada" ao usuário. O remetente tem o formato Pré-Safra <[email protected]>, de um domínio verificado no Resend. Não existe recuperação de senha por e-mail.

Fotos diárias (Relatórios → Evolução)

O sistema guarda só a situação de agora; para saber como a safra estava em um dia passado, o cron da Vercel (vercel.json, todo dia às 23h UTC, 19h em Mato Grosso) chama /api/cron/foto-diaria, que grava a situação de cada Pré-Safra das safras ativas na tabela FotoPreSafra. A história começa na primeira foto: nada antes dela pode ser recuperado.

• Defina CRON_SECRET (texto aleatório longo) nas variáveis da Vercel: ela o envia como Authorization: Bearer. Sem a variável a rota recusa tudo e nenhuma foto é tirada.
• Rode npm run db:push no banco de produção antes de publicar (cria a tabela FotoPreSafra).
• Depois de publicar, abra Relatórios → Evolução e use "Tirar a foto de hoje agora" (exige a permissão Safras) para já ter o primeiro ponto.
• As fotos não entram no Backup em Excel.

Esqueci a senha

Não há recuperação por e-mail: quem esqueceu a senha pede ao administrador. Em Administração > Usuários, o administrador clica em "Gerar link de redefinição", copia o link e o envia à pessoa (por WhatsApp ou Teams). O link vale por 24 horas e só pode ser usado uma vez; gerar outro cancela o anterior. A pessoa abre o link, escolhe a própria senha e entra normalmente. O link só aparece na janela em que foi gerado: se for perdido, basta gerar outro.

Antes de publicar esta versão, rode npm run db:push contra o banco de produção. O login passou a gravar as tentativas na tabela TentativaAcesso (e a redefinição de senha usa a TokenRecuperacao). Se o código novo subir antes das tabelas existirem, ninguém consegue entrar: o login falha de propósito (não libera o acesso quando não consegue contar as tentativas). Ordem: db:push primeiro, publicação depois. O db:push só cria tabelas e índices novos, então o código antigo continua funcionando enquanto isso.

Documentação

Fica fora do git (pastas locais): Vault/ (notas técnicas em Obsidian; comece por Vault/000_Index.md) e docs/ (manuais em PDF, capturas de tela e o script que os gera).

• pre-safra-app-spec.md — especificação original (parte já obsoleta).
• AGENTS.md — aviso para agentes: esta versão do Next.js tem mudanças; leia node_modules/next/dist/docs/ antes de codar.