RelatoriosRS — Arquitetura (2026-06-26)

Mapa do Sistema

`

Chatwoot (PostgreSQL)

└─ root-postgres-1 / chatwoot_production

├─ conversations

├─ contacts

├─ messages

└─ users (agents)

┌──────────────────────────────┐

│ hermes-sync.py │ cron: */5 min

│ /usr/local/bin/ │ Destino: SUPABASE CLOUD ⚠️

│ Status: RODANDO │ (bloqueado desde ~jun/23)

└──────────────┬───────────────┘

│ ↓ (não chega no local)

│ 2000 convs/cycle

│ 60 msgs/cycle (muito pouco)

▼

┌──────────────────────────────┐

│ Supabase Cloud │

│ project: dauftiqcvgaydddoxqhh│ BLOQUEADO

└──────────────────────────────┘

┌──────────────────────────────┐

│ sync_v7.py │ Execução: MANUAL

│ /root/hermes-insights/ │ Destino: deploy-vps-db-1 ✅

└──────────────┬───────────────┘

│ 1x sync (1676 convs Maria Giulha)

▼

┌──────────────────────────────┐

│ deploy-vps-db-1 / postgres │

│ schema: insights │

│ ├─ conversations: 2829 │

│ ├─ messages: 63.230 │

│ ├─ agents: 8 │

│ ├─ scores: 216 │

│ ├─ playbooks: 15 │

│ └─ daily_reports: 8 │

└──────────────────────────────┘

▲

│ LER

┌──────────────┴───────────────┐

│ generate_reports.py │ Usa Supabase Cloud ❌

│ score_engine_v3.py │ (não funciona)

│ /root/hermes-insights/ │

└──────────────────────────────┘

┌──────────────────────────────┐

│ Hermes Insights Frontend │

│ /var/www/chatwoot-kanban/ │ TanStack Start

│ Deployado no VPS ✅ │ Lê do Supabase Cloud ❌

└──────────────────────────────┘

`

Problema Central

generate_reports.py e o frontend do Hermes Insights estão configurados para ler do Supabase Cloud (bloqueado desde ~jun/23 por exced_egress_quota).

O banco local (deploy-vps-db-1) tem dados suficientes para rodar relatórios:

• - 63.230 mensagens
• - 2.829 conversas
• - 8 agentes

Tabelas insights (banco local)

conversations

`

id (uuid PK), chatwoot_id (int), assignee_id (uuid), assignee_chatwoot_id (int),

contact_name, contact_phone, contact_email,

status (open/resolved), message_count, labels (jsonb),

first_response_at, last_activity_at, resolved_at, created_at,

sync_status, inbox_name

`

messages

`

id (uuid PK), chatwoot_id (int), chatwoot_conversation_id (int),

conversation_id (uuid FK), sender_type (agent/contact/bot),

sender_id, content (text), message_type (incoming/outgoing/activity),

attachments (jsonb), content_attributes (jsonb),

sentiment (jsonb), created_at

`

agents

`

id (uuid PK), chatwoot_id (int), name, email, role

`

scores

• - 216 registros

playbooks

• - 15 registros

daily_reports

• - 8 registros

Fluxo desejado

`

Chatwoot (root-postgres-1)

│

▼ [cron: */5 min]

hermes-sync-local.py ← NOVO (baseado em sync_v7)

│

▼ INSERT/UPDATE

deploy-vps-db-1 / insights

│

├──► Hermes Insights Frontend ✅

│ (renomear → RelatoriosRS)

│

└──► generate_reports_local.py ← NOVO

(baseado em generate_reports.py, lê do banco local)

│

▼ HTML

/root/hermes-insights/relatorios/

`

Sync de mensagens — o que melhorar

O hermes-sync.py atual insere pouquíssimas mensagens (60/ciclo).

Problema: só processa 30 conversas por ciclo, 100 msgs cada.

Novo sync_v8: baseado no sync_v7.py que funcionou:

• - INSERT batch de 50 msgs por vez
• - stdin pipe para evitar problemas de quoting
• - processar TODAS as conversas com mensagens pendentes
• - usar ON CONFLICT (chatwoot_id) DO UPDATE para evitar duplicatas

Status

• - [x] Mapa do sistema documentado
• - [x] Banco local verificado (63k mensagens, 2.8k conversas)
• - [x] Script sync_v7.py validado (1676 convs de uma tacada)
• - [ ] Criar sync_v8.py (mensagens → banco local)
• - [ ] Criar generate_reports_local.py (lê do banco local)
• - [ ] Testar geração de relatório com 1 conversa
• - [ ] Frontend RelatoriosRS: apontar pro banco local

Ultron — 2026-06-26