feat(juridico): notificação extrajudicial — geração de texto + envio via SendGrid

[Warleypablo]

Resumo

Adiciona botão Gerar Notificação nos cards da coluna notificacao do kanban de negativação (/negativacao). Ao clicar, abre modal com o template da notificação extrajudicial de cobrança pré-preenchido com dados do cliente (email, endereço, CNPJ, parcelas em atraso) e permite enviar via email com auditoria completa.

Implementado em duas fases:

• Fase 1 — Geração do texto com substituição de variáveis, preview editável, ação de copiar texto.
• Fase 2 — Envio server-side via SendGrid, auditoria em tabela dedicada, BCC automático, confirmação obrigatória, detecção de duplicata.

Mudanças principais

Backend

• Novo endpoint GET /api/negativacao/cliente/:clienteId/notificacao-data — busca cliente (caz_clientes) + parcelas em atraso
• Novo endpoint GET /api/negativacao/cliente/:clienteId/notificacoes-enviadas — histórico para detectar duplicata
• Novo endpoint POST /api/negativacao/notificacoes/enviar — envia + grava auditoria (status otimista + update com message_id)
• Novo service server/services/sendgrid-notification.ts — wrapper puro do @sendgrid/mail
• Nova tabela cortex_core.notificacoes_extrajudiciais_enviadas (schema Drizzle + migration SQL)
• Dependência @sendgrid/mail@^8.1.6

Frontend

• Novo componente NotificacaoExtrajudicialModal — form (email, endereço, nº contrato, data, serviço) + preview editável
• Novo componente ConfirmacaoEnvioDialog — AlertDialog com aviso de duplicata quando aplicável
• Nova lib client/src/lib/notificacao-extrajudicial.ts — funções puras: formatarMesesEmAtraso, formatarValoresDescricao, anoPorExtenso, renderizarNotificacao, renderizarNotificacaoHtml
• Botão condicional no kanban (Negativacao.tsx) — só aparece em cards da coluna notificacao

Testes

• 39 testes unitários passando (34 da lib de renderização + 5 do service SendGrid)
• TDD em todas as funções puras

Requisitos pré-merge

• Configurar env vars no ambiente de produção (.env):
  • SENDGRID_API_KEY
  • SENDGRID_FROM_EMAIL=juridico@turbopartners.com.br
  • SENDGRID_FROM_NAME=Departamento Jurídico - Turbo Partners
  • SENDGRID_BCC_EMAIL=juridico@turbopartners.com.br
• Aplicar migration em produção:

  psql "\$DATABASE_URL_PROD" -f migrations/2026-04-23-create-notificacoes-enviadas.sql

• Confirmar que domínio turbopartners.com.br está autenticado no SendGrid (SPF/DKIM) — necessário para emails não caírem em spam

Test plan

• Fase 1 — modal abre, variáveis substituídas corretamente, preview editável, copiar texto funciona
• Fase 2 — envio real validado em local: email entregue, BCC recebido, registro gravado em cortex_core.notificacoes_extrajudiciais_enviadas com status='enviado' e sendgrid_message_id
• Duplicata — clicar "Notificar" na segunda vez para mesmo cliente: dialog mostra aviso amarelo "já foi notificado em ..."
• Erro SendGrid — com API key inválida: toast vermelho com detalhe, registro gravado com status='erro'
• Dark mode + light mode OK
• Responsive mobile OK

Arquivos (resumo)

Backend:
  server/services/sendgrid-notification.ts        +82
  server/services/sendgrid-notification.test.ts   +123
  server/routes/negativacao.ts                    +189 (2 endpoints novos + 1 da fase 1)
  server/routes/juridico.ts                       +15
  server/storage.ts                               +12
  shared/schema.ts                                +19
  migrations/2026-04-23-create-notificacoes-enviadas.sql +22

Frontend:
  client/src/components/juridico/NotificacaoExtrajudicialModal.tsx +238
  client/src/components/juridico/ConfirmacaoEnvioDialog.tsx        +110
  client/src/lib/notificacao-extrajudicial.ts                      +237
  client/src/lib/notificacao-extrajudicial.test.ts                 +217
  client/src/pages/Negativacao.tsx                                 +94

Docs:
  docs/superpowers/specs/2026-04-23-notificacao-extrajudicial-juridico-design.md
  docs/superpowers/specs/2026-04-23-notificacao-extrajudicial-envio-fase2-design.md
  docs/superpowers/plans/2026-04-23-notificacao-extrajudicial-juridico.md
  docs/superpowers/plans/2026-04-23-notificacao-extrajudicial-envio-fase2.md

Config:
  package.json                                    +@sendgrid/mail
  .env.example                                    +6 linhas (documentação)

Roadmap futuro (fora desse PR)

• Fase 3 (opcional) — UI de histórico no drawer de detalhes do kanban, webhook SendGrid para status bounced/delivered, geração de PDF anexado

🤖 Generated with Claude Code