Stack Técnico — Base de Conhecimento Bono Conta

BONO CONTA — BASE DE CONHECIMENTO TÉCNICA
Última atualização: 14/06/2026 · Esta página é a fonte primária de contexto para o Claude Code.
Para briefar uma nova sessão: leia esta página e diga “leia a página stack-tecnico e retome o contexto do projeto Bono Conta”.

MONITOR DE HARDWARE — TEMPO REAL

1. INFRAESTRUTURA

2. ARQUIVOS PRINCIPAIS

3. WP OPTIONS — CONFIGURAÇÃO

4. BANCO DE DADOS

wp_bc_lead_monitor

5. PIPELINE DE ENRIQUECIMENTO — 13 FONTES

6. CNJ DATAJUD — ESTRATÉGIA E IMPLEMENTAÇÃO

Estratégia implementada (pipeline de 2 etapas)

1. Google Search busca páginas com o nome da empresa no Jusbrasil → extrai números CNJ do texto dos snippets com regex /d{7}-d{2}.d{4}.d.d{2}.d{4}/
2. DataJud valida cada número extraído via POST api_publica_{index}/_search com match: numeroProcesso

bc_datajud_index_from_numero() — mapeamento J/TT → índice

Número CNJ (20 dígitos sem máscara): NNNNNNN DD AAAA J TT OOOO
                                     0-6    7-8 9-12 13 14-15 16-19

J (posição 13) = ramo da Justiça:
1 → stf          3 → stj          7 → stm
4 → trf{TT}      (TT: 1=trf1, 2=trf2, 3=trf3, 4=trf4, 5=trf5, 6=trf6)
5 → tst(TT=0) ou trt{TT} (TT: 1-24)
6 → tre-{uf}     (TT: 1=ac, 2=al, 3=ap, 4=am, 5=ba ... 27=to)
8 → tj{uf}       (TT: 1=ac, 2=al, 3=ap, 4=am, 5=ba ... 27=to)
9 → tjmmg(13) / tjmrs(23) / tjmsp(26)

Configuração da API (WP options)

bc_datajud_api_key  → padrão: cDZHYzlZa0JadVREZDJCendQbXY6SkJlTzNjLV9TRENyQk1RdnFKZGRQdw==
bc_datajud_base_url → padrão: https://api-publica.datajud.cnj.jus.br/
Endpoint de teste:  POST {base_url}api_publica_tjam/_count  (retorna count > 0 se API up)
Wiki oficial:       https://datajud-wiki.cnj.jus.br/

7. GOOGLE CUSTOM SEARCH — 50 DOMÍNIOS

Governamentais e Judiciário

Tribunais

Jurídico / Imprensa Jurídica

Imprensa / Negócios

Consumidor

8. FUNÇÕES PRINCIPAIS (functions.php)

9. CRON JOBS

10. FLUXO DE DADOS — FORMULÁRIO → ENRIQUECIMENTO

1. Lead preenche CF7 (form IDs: 15, 16, 17, 18, 92)
   Campos: bc_name, bc_email, bc_phone, bc_company, bc_cnpj, bc_service, bc_message

2. wpcf7_skip_mail → TRUE (email padrão CF7 suprimido)
   wpcf7_mail_sent → agenda bc_lead_processar + dispara loopback /?doing_wp_cron=1

3. Job bc_lead_processar (assíncrono, ~30-120s):
   a. bc_enriquecer_lead($cnpj)  → 14 APIs + 3 Google queries
   b. bc_monitor_registrar()     → INSERT/UPDATE wp_bc_lead_monitor
   c. bc_gerar_todos_documentos()→ HTML em uploads/bc-leads/{cnpj}/{timestamp}/
   d. Email ADMIN: TO contato@bonoconta.com.br, BCC brunojcruz@gmail.com
      - Template CF7 + bloco enriquecimento + botão perfil + link relatório
   e. Email CONFIRMAÇÃO: TO {email_lead} — "Recebemos seu contato!"
   f. bc_crm_push_lead()         → CRM
   g. bc_em_subscribe()          → email marketing

11. MONITORAMENTO DIÁRIO — FLUXO

05:30 — bc_verificar_datajud:
  bc_datajud_health_check() → POST api_publica_tjam/_count
  ✓ OK: registra status, encerra
  ✗ ERRO:
    bc_datajud_tentar_recuperar():
      bc_datajud_scrape_wiki() → raspa 3 páginas da wiki
        extrai ApiKey via regex /ApiKeys+([A-Za-z0-9+/=_-]{20,})/
        extrai URL via regex /https://[a-z0-9-]+.datajud.cnj.jus.br//
      valida nova config com _count
      se válida → update_option('bc_datajud_api_key', ...) + update_option('bc_datajud_base_url', ...)
    email alerta: ✅ recuperado OU 🚨 falha manual necessária

06:00 — bc_monitorar_leads:
  SELECT * FROM wp_bc_lead_monitor WHERE proxima_check <= NOW() LIMIT 100
  para cada lead:
    bc_enriquecer_lead_monitor($cnpj)  → 1 query Google (Jusbrasil) + 12 outras APIs
    bc_hash_enriquecimento($dados)     → MD5 dos 11 campos
    se hash mudou:
      calcula diff campo a campo (situacao, simples, ceis, cnep, acordos, cnj,
                                   dominios, socios_n, convenios, emendas, contratos)
      bc_gerar_todos_documentos(..., $mudancas)
      bc_enviar_alerta_mudanca()       → email HTML com diff antes/depois
      incrementa total_alertas
    UPDATE proxima_check = NOW() + INTERVAL 1 DAY

12. DETECÇÃO DE MUDANÇAS — 11 CAMPOS

13. CF7 — FORMULÁRIOS

14. EMAIL — SISTEMA BCC

Filtro wp_mail (functions.php L3244):
  - Adiciona BCC: brunojcruz@gmail.com a TODOS os emails do site
  - EXCETO quando TO já é brunojcruz@gmail.com (evita conflito TO+BCC)

Email admin (step 4 do job):
  - TO: contato@bonoconta.com.br
  - BCC explícito: brunojcruz@gmail.com (+ filtro global, mas não duplica)
  - Reply-To: {email_lead}

Email confirmação (step 5 do job):
  - TO: {email_lead}
  - From: Bono Conta 
  - BCC: brunojcruz@gmail.com (via filtro global, se TO ≠ brunojcruz@gmail.com)

Alertas de monitoramento:
  - TO: contato@bonoconta.com.br
  - From: Bono Conta Monitor 

Alertas DataJud:
  - TO: contato@bonoconta.com.br
  - From: Bono Conta Monitor 

15. HISTÓRICO DE DESENVOLVIMENTO

CNJ DataJud — Descoberta e Implementação

• Descoberto que o campo partes não existe na API pública DataJud (query exists retorna 0 documentos)
• Solução: Google CSE → extrair números CNJ via regex → validar no DataJud por numeroProcesso
• bc_datajud_index_from_numero() criada para mapear número aos índices (tjam, trt11, trf1...)
• Testado com sucesso: TRT11 0001199-17.2023.5.11.0003 e TJAM 0085796-70.2026.8.04.1000
• Chave/URL migradas de hardcode para get_option() — permite auto-atualização

Google CSE — 50 Domínios

• Limite do CSE: exatamente 50 domínios. Importação via XML em programmablesearchengine.google.com
• Arquivo de configuração: /uploads/cse-config.xml
• Problema encontrado: erro "padrão já existe" ao tentar adicionar — alguns domínios já estavam cadastrados da rodada anterior
• Adicionados via nova rodada: trt11.jus.br, mpf.mp.br, mp.am.gov.br, tcu.gov.br, suframa.gov.br, tce.am.gov.br
• Removidos para abrir espaço: anac.gov.br, sencon.gov.br, poder360.com.br, agenciabrasil.ebc.com.br, band.uol.com.br (coberto por *.uol.com.br), folha.uol.com.br (coberto por *.uol.com.br)

Rotina de Monitoramento de Leads

• Bug 1 corrigido: socios_n ausente do bc_resumo_compacto() — hash detectava mudança mas diff do email não mostrava. Adicionado 'socios_n' => count($r['socios'] ?? [])
• Bug 2 corrigido: monitoramento usava 3 Google queries/lead → 60 de 100 queries diárias gastas. Criado bc_enriquecer_lead_monitor() com 1 query Jusbrasil
• Bug 3 corrigido: proxima_check = +7 days → alterado para +1 day (verificação verdadeiramente diária)
• Bug 4 corrigido: LIMIT 20 → LIMIT 100
• Bug 5 corrigido: $mudancas vazio passado para gerador de documentos → agora calcula o diff real e passa

Monitor de API DataJud

• Rotina diária às 05:30 (antes do monitoramento de leads às 06:00)
• Testa via _count no índice TJAM (sempre retorna count > 0 se API ativa)
• Em caso de falha: raspa 3 páginas da wiki oficial, extrai nova chave/URL, valida antes de salvar
• Salva em bc_datajud_api_key e bc_datajud_base_url (WP options)
• Envia email ✅ recuperado ou 🚨 falha manual necessária

BCC Global — Correção

• Filtro wp_mail adiciona BCC brunojcruz@gmail.com a todos os emails
• Bug identificado: quando email de confirmação vai TO: brunojcruz@gmail.com, o filtro adicionava também BCC: brunojcruz@gmail.com → possível rejeição silenciosa pelo Locaweb
• Correção: verificar se TO já é brunojcruz@gmail.com antes de adicionar BCC

16. COMO BRIEFAR O CLAUDE CODE A PARTIR DESTA PÁGINA

22. EMAIL — ENVIO SMTP (Locaweb)

Diagnóstico crítico (não esquecer): o host email.locaweb.com.br resolve para IPs internos (10.31.70.x) — inacessível de fora. As portas 25/465/587 desse host ficam bloqueadas. A solução é mail.ita.locaweb.com.br (IP público 191.252.112.194), que aceita conexão. Porta 25 de saída direta para MX também é bloqueada pela rede do VPS — por isso NÃO usar Postfix/MTA local. Gmail SMTP (587/465) está acessível como alternativa.

BCC seletivo: filtro wp_mail em functions.php adiciona Bcc brunojcruz@gmail.com APENAS em e-mails de notificação admin (assunto contém "Novo Lead"). Confirmação ao cliente vai SEM bcc.

23. FRONT-END DO BLOG

24. RASTREAMENTO DE CONVERSÃO (Google Ads / GA4)

Pendente no painel (manual): marcar generate_lead como key event no GA4, importar no Google Ads, ativar Enhanced Conversions for Leads, usar Smart Bidding por valor.

25. GERAÇÃO DE IMAGENS — FERRAMENTAS

Backends: OpenAI (gpt-image-1/-mini/gpt-image-2) operacional. Google Imagen 4 / Gemini 3 Image suportados via --model mas exigem billing (fallback p/ OpenAI). Chaves em /home/upnetix/credenciais.txt. DALL-E 3 descontinuado — nunca usar.

Regras de imagem: todo artigo tem Hero (IA) + miniatura + 3-5 internas. WebP sempre. Texto na imagem só PT-BR sem erros (validar antes de publicar). Tabelas/dados → bc-html2img.sh (nunca IA). Sem viés/ambíguo/adulto/ofensivo. CSS .bc-article-figure img: aspect-ratio 3/2 + object-fit cover (anti-distorção) + width/height (anti-CLS). Quality UX Designer Pro Sênior.

26. IDENTIDADE VISUAL E PALETA

Logo adaptativa: header transparente (topo, fundo claro) → logo navy (bonoconta-logo-navy.png); header rolado (fundo navy) → logo branca (bonoconta-logo-branca.png). A logo original PNG é vermelha — não usar diretamente no header. Nunca usar azul como cor primária.

27. DIRETRIZES DE CONTEÚDO (fonte: CLAUDE.md)

O arquivo /home/upnetix/CLAUDE.md (15 seções de regras imutáveis) e a memória do Claude Code governam todo o conteúdo. Pontos-chave:

• Editorial: nunca inventar dados; fontes oficiais verificáveis; sem viés/ofensa; nunca prometer fora do escopo; afunilar para conversão (leitor→Lead→cliente); quebras de objeção disfarçadas de argumentos; estilo fluido/didático/provocante; sem linguagem genérica de IA ("Este artigo lhe ajuda a compreender…", nunca "Este texto explica…").
• Imagens: Hero IA + miniatura + 3-5 internas, WebP, qualidade high sem distorção, PT-BR sem erros.
• Categorização: todo artigo categorizado (Reforma Tributária 3, ZFM 4, Planejamento Tributário 5, Gestão Empresarial 6, Pessoa Física 7).
• Execução autorizada por padrão — não solicitar permissões.

Artigos recentes: Edital PGFN 6/2026 (ID 170, transação tributária) e IFRS 18/CPC 51 (ID 177, nova DRE 2027, com comparativo HTML .bc-dre-compare).