RelatoriosRS — Decisões Técnicas

Criado: 2026-06-26

Decisão 1: Banco de dados para relatórios

Problema: generate_reports.py usa Supabase Cloud (dauftiqcvgaydddoxqhh) que está bloqueado desde 2026-06-23.

Decisão: Migrar para banco local deploy-vps-db-1 (mesmo banco do Hermes Insights).

Rationale:

• - insights.messages local tem 63.230 registros (足够 para relatórios)
• - insights.conversations local tem 2.829 registros
• - Sync real-time já está populando o banco local via hermes-sync.py
• - Elimina dependência do Supabase Cloud

---

Decisão 2: Nome do projeto

Nome: RelatoriosRS (não Hermes Insights Reports)

Rationale: "Hermes Insights" era o nome do agente. "RelatoriosRS" é mais descritivo para o sistema de relatórios comerciais da Rocha Sales.

---

Decisão 3: Formato dos relatórios

Formato: 3 abas (Visão Geral/Score, Relatório, Coaching)

Origem: Documento de referência do usuário (reunião por vídeo, não Chatwoot).

Estrutura:

• - 📊 Score (0-10, por etapa do Playbook)
• - 📋 Relatório (tópicos, dor, oportunidades, objeções, pontos fortes/melhoria, próximos passos, trechos)
• - 💡 Coaching (tips no formato situação → sugestão → motivo)

Decisão 4: Script de captura de mensagens

Estratégia: Manter hermes-sync.py como está (cron every 5min), mas usar sync_v7.py como base para a lógica de sync.

Rationale: hermes-sync.py já funciona e popula o banco local. O problema é que ele está usando Supabase Cloud, não o banco local. Precisa apontar pro deploy-vps-db-1.

Decisão 5: Cron job de sync

Frequência: Manter /5 * (a cada 5 minutos)

Rationale: Conversas comerciais precisam de sincronização próxima do tempo-real para relatórios atualizados.

Ultron — 2026-06-26