📄 hermes-insights-arquitetura-completa-2026-07-06.md

← Vault

HERMES INSIGHTS — Arquitetura Completa (2026-07-06)

Salvo em: 2026-07-06

Origem: Documento compartilhado pelo usuário para diagnóstico do sistema


O QUE É

Plataforma de inteligência operacional para análise de atendimentos comerciais da Rocha Sales. Consome dados do Chatwoot, analisa com IA (Groq/Llama), pontua performance com motor de score próprio, e gera relatórios automáticos em interface premium.


URLs E STATUS

ATENÇÃO: hermes. e insights. servem o MESMO conteúdo (/var/www/hermes-insights).

Devem ser unificados para insights.rochasalesseguros.com.br apenas.


STACK

Fórmula: overall = Σ(score × peso) / 100

Faixas: 9–10 verde, 8–8.9 verde claro, 6–7.9 amarelo, 4–5.9 laranja, <4 vermelho

Aba 2: 📋 Relatório (Texto)

Seções: Principais Tópicos, Dor do Cliente, Oportunidades, Objeções Levantadas, Pontos Fortes, Pontos de Melhoria, Próximos Passos, Trechos Importantes

Aba 3: 💡 Coaching

Tips no formato: {situação → sugestão → motivo}


PIPELINE DE DADOS

`

Chatwoot (VPS)

↓ (hermes-sync.py a cada 5 min)

Supabase self-hosted (schema insights)

↓ (score_engine_v3.py sob demanda)

Tabela scores (7 etapas + breakdown JSONB)

↓ (generate_commercial_report_v2.py sob demanda)

HTMLs em /var/www/hermes-insights/

`

Scripts principais:


BANCO DE DADOS (Supabase self-hosted)

Container: deploy-vps-db-1

Schema: insights

Banco: postgres

Tabelas:

RPCs principais:

  • - get_agents_ranking() — ranking de agentes
  • - get_conversations_audit() — lista de conversas
  • - get_dashboard_stats() — KPIs (bloqueado por RLS)

  • PROBLEMAS CRÍTICOS IDENTIFICADOS

    🔴 Problemas de Dados

    🔴 Problemas de Deploy

    🟡 Problemas de Arquitetura

    URLDescriçãoStatus
    ------------------------
    https://insights.rochasalesseguros.com.brDashboard principal (HTML estático)✅ Produção
    https://hermes.rochasalesseguros.com.brAlias antigo (mesmo conteúdo)⚠️ Redundante
    api.rochasalesseguros.com.brSupabase self-hosted (backend)✅ Produção
    EtapaPesoDescrição
    ------------------------
    1. Conexão10%Rapport inicial
    2. Diagnóstico20%Qualificação BANT
    3. Dor e Impacto20%Entender a dor
    4. Combinado da Reunião5%Alinhamento
    5. Apresentação da Solução20%Pitch
    6. Tratamento de Objeções15%Negociação
    7. Fechamento / Próximo Passo10%Close
    ScriptFunçãoLocal
    -----------------------
    hermes-sync.pySync Chatwoot → Supabase/usr/local/bin/
    score_engine_v3.pyCalcula scores AI (7 etapas)/root/hermes-insights/
    generate_commercial_report_v2.pyGera relatórios HTML via Groq/tmp/
    TabelaConteúdo
    ------------------
    agentsCorretores (chatwoot_id, name, role, team)
    conversationsConversas (status, assignee_id, inbox_id)
    messagesMensagens (content, sender_type, timestamp)
    scoresScores AI (7 etapas + breakdown JSONB, ai_analysis VAZIO)
    daily_reportsRelatórios diários agregados
    ProblemaCausaStatus
    -------------------------
    Score médio = 0Motor de score AI nunca rodou em produção
    Tempo médio = 0Campo não populado na sync
    Taxa resolução = 0%conversations.status não sincronizado corretamente
    ~560 conversas sem agenteInboxes de agentes não-cadastrados
    ai_analysis vazioscore_engine_v3 não popula esse campo
    ProblemaCausaStatus
    -------------------------
    Painel Audit v2 não deployadoCódigo pronto mas nunca copiado
    Exportar não funcionaPlaceholder sem implementação
    Botões "Sincronizar" placeholdersConfigurações não funcional
    Pesos do score hardcodedNão salva no banco
    ProblemaCausaStatus
    -------------------------
    Múltiplos sync scripts (v1-v4)Versões duplicadas sem clear⚠️
    hermes. + insights. duplicadosDuas URLs mesmo conteúdo⚠️
    scripts em /tmp/ e /var/www/ dispersosFalta organização⚠️


    PROMPT ORIGINAL (Jun 2026)

    "Preciso de um dashboard de relatórios comerciais para minha equipe de vendas de seguros. Cada conversa deve ter 3 abas: (1) Score por Etapa do Playbook, (2) Relatório Texto com Dor/Oportunidades/Objeções, (3) Coaching Tips. O score deve seguir 7 etapas com pesos específicos."

    Stack pedida: React + Vite + TanStack Start + Supabase + TanStack Query + Recharts + Lucide icons


    ORDEM DE PRIORIDADE

    1. Score Engine v3 em produção — score AI com 7 etapas (ai_analysis vazio)

    2. Groq reports em produção — relatório texto + coaching

    3. Fixar sync Chatwoot — 560 conversas sem agente

    4. Dashboard KPIs reais — Score médio, Tempo médio, Taxa resolução

    5. Configurações funcionais — sincronizar + salvar pesos

    6. Exportar funcional — CSV/PDF dos relatórios

    7. Centralizar URLs — remover hermes. redundante


    FALHAS CONHECIDAS (não tentar resolver agora)

  • - SSH pro VPS 45.33.95.78 dá timeout (hostname Chatwoot não resolve)
  • - Supabase Cloud excedida (migrou pra self-hosted)
  • - Gemini API free tier excedida (migrou pra Groq)
  • - rochasales-db-1 restartando (banco antigo, IGNORAR)