JD Business Academy · Janguiê Diniz · fundador do grupo Ser Educacional

Copiloto WhatsApp do fundador, leitura sobre 165+ tabelas em produção.

Agente LLM que responde sobre receita, MQLs, criativos Meta/Google, eventos, inadimplência e folha — em linguagem executiva, com guardrail de leitura provado em CI.

Cliente
JD Business Academy
Ano
2026
Papel
Solo · arquitetura, código, infra, runbook
Status
Em produção

Problema

O fundador precisava de copiloto conversacional sobre Supabase compartilhado entre P360 e sistema-jdba (165+ tabelas), sem direito a mutação e com kill-switch de custo OpenAI/WhatsApp por dia.

Solução

FastAPI + GPT-4o + Pydantic v2 + 26 tools tipadas com scope enforcement. 3 camadas de defesa read-only (regex de prefixo, allowlist hard-coded, role Postgres planejada), CitationValidator anti-alucinação, PII redactor com 3 estratégias por campo, BudgetGuard fail-closed.

Resultado

Sistema com SERVICE_ROLE_KEY que poderia destruir produção foi forçado a não errar via 3 camadas + testes de contrato. 14 bug fixes em produção documentados (humanizer spam, voice-note decrypt, path-secret leak, inadimplência underreport ~70%).

Decisões técnicas

Idempotency de alertas via partial unique index UTC-anchored — date_trunc('hour', created_at AT TIME ZONE 'UTC') é IMMUTABLE; o cast pra UTC é o que torna a expressão indexável.
Filtros idênticos entre numerador e denominador em qualquer ratio (CPL, CPMQL, taxa MQL). Princípio extraído de bug real do P360 (pattern-ratio-base-alignment) e codificado como regra não-negociável.
uvicorn --no-access-log no Procfile — webhook MegaAPI usa segredo no path; access logs vazariam o segredo nos logs do Railway.
Decrypt local de voice notes WhatsApp (Baileys-style AES-256-CBC) com magic-bytes validator + min-size + endpoint fallback (4 endpoints MegaAPI tentados em ordem).

Métricas

165+
tabelas read-only orquestradas
26
tools function-calling tipadas
14
fixes de produção em commits
8
KPIs canônicos com z-score
517
linhas no prompt principal versionado
13
tabelas hermes_* com RLS própria

Stack

Python 3.12
FastAPI
Pydantic v2
OpenAI GPT-4o
Whisper-1
Supabase Postgres
pgvector
pg_cron
MegaAPI WhatsApp
HubSpot
Meta Ads
Railway
mypy strict + ruff

Pronto pra parar de fazer slide?