RelatoriosRS — Sistema de Relatórios de Conversas

Criado: 2026-06-26

Status: Em desenvolvimento

Visão Geral

Sistema de geração de relatórios comerciais por agente + cliente a partir das conversas do Chatwoot.

Stack:

• - Chatwoot (CRM de conversas — VPS)
• - Supabase self-hosted (Docker no VPS) — banco insights
• - Hermes/Ultron (agente de IA — este aqui)

---

Arquitetura

`

Chatwoot (VPS)

↓ sync_v7.py (conversas)

↓ [novo] sync_messages_vX.py (mensagens)

Supabase insights schema (VPS Docker)

↓ query

Relatórios HTML/Markdown por agente + cliente

`

---

Módulos

1. Captação de Dados

• - [x] sync_v7.py — conversas Chatwoot → insights.conversations ✅
• - [ ] sync_messages_relatorios.py — mensagens → insights.messages (em progresso)
• - [ ] Limpeza: atualizar conversation_id das mensagens para bater com conversas

2. Geração de Relatórios

• - [ ] gerar_relatorios_v2.py — modelo Roberto Teixeira/ROMALU
• - [ ] Formato: HTML por agente + cliente (últimos 10 clientes)
• - [ ] Seções: 📋 Principais Tópicos, 😣 Dor do Cliente, 💡 Oportunidades, etc.

3. Dashboard

• - [ ] Hermes Insights v2 — Score do Dia, Audit v2
• - [ ] Integração com RelatoriosRS

---

Estrutura de Pastas

`

/var/www/obsidian-vault/04-PROJECTS/RELATORIOS-RS/

├── 00-INDEX.md ← Este arquivo

├── 01-DADOS/

│ ├── 01-CONVERSAS/ ← Notas sobre conversas captadas

│ └── 02-MENSAGENS/ ← Notas sobre mensagens

├── 02-SCRIPTS/

│ ├── sync_v7.py ← Já no VPS: /root/hermes-insights/sync_v7.py

│ └── sync_messages_relatorios.py ← A criar

├── 03-RELATORIOS/

│ └── 2026-06/ ← Relatórios gerados por mês

├── 04-MODELO/

│ └── MODELO-RELATORIO.md ← Formato padrão Roberto Teixeira/ROMALU

└── 05-DOCS/

├── ARQUITETURA.md

└── FAQ.md

`

---

Modelo de Relatório

Formato: Roberto Teixeira / ROMALU

`

📋 Principais Tópicos

😣 Dor do Cliente

💡 Oportunidades

🛡️ Objeções

✅ Pontos Fortes

⚠️ Pontos de Melhoria

📌 Próximos Passos

💬 Trechos Importantes

`

---

Progresso

• - [x] sync_v7.py — conversas funcionando (2042 syncadas, 0 erros)
• - [ ] sync_messages — mensagens não estão linkadas às conversas corretas
• - [ ] generate_reports — a desenvolver
• - [ ] dashboard — a desenvolver

Última atualização: 2026-06-26