RA1000

ENTRADA: Cliente abre reclamação no Reclame Aqui
   ↓
RA dispara EMAIL → ra1000@zzyon.com  +  fica no painel "Não Respondidas"
   ↓
   ├─ SKILL inbox-watch (cron */5min, OAuth Gmail)
   └─ SKILL ra1000-watcher (cron */15min, Chrome MCP painel RA)
   ↓
SCRAPE detalhe: CPF, telefone, email, pedido, embarcador, motivo
   ↓
UPSERT cs_ra_reclamacoes (Trigger auto-atribui filial via cs_ra_find_lider)
log_event(reclamacao_aberta, dados_extraidos)
   ↓
TENTATIVA LOOKUP ESL Cloud GraphQL (token Vault)
log_event(tentativa_lookup_esl, resultado)
   ↓
CLASSIFICAÇÃO: Fluxo A (no prazo) / B (intercorrência) / C (falha) / D (faltam dados)
   ↓
GERAÇÃO DRAFT via LLM Sonnet 4.6 (assinatura "Cláudio · Atendimento Ícaro Express")
   ↓
   ├─ Fluxo A* (promete data) → AGUARDA OK GESTOR via WA, 1h30 timeout → escala Rubens
   └─ Fluxo B/C/D (sem promessa de data) → AUTO-POSTA
   ↓
POSTAGEM no painel RA via Chrome MCP (24/7)
log_event(resposta_postada_no_ra)
   ↓
NOTIFICAÇÃO multi-canal cumulativa (sempre histórico append-only):
   • EMAIL: TO base filial · CC Jimmy · BCC Rubens
   • WHATSAPP: líder filial + Kevin + Rubens + (Jimmy se TI)
   • Subject canônico: CPF | Nome | Embarcador | NF | RA #ID
   ↓
CLIENTE RESPONDE NO RA
   ↓
SKILL ra1000-replier */15min:
   • Se passou NF → query freight{invoiceKey} no ESL → status real
   • Gera follow-up Fluxo A/B/C apropriado
   • Se promete data: aciona gestor pra confirmar
   • Posta + email cumulativo (todos eventos anteriores + novos)
   ↓
CASO RESOLVIDO → RA pede 3 campos nativos: resolvido / nota 0-10 / voltaria
   ↓
SKILL ra1000-avaliador */30min:
   • Captura avaliação
   • Se nota baixa → ALERTA + tréplica pública (botão tréplica RA, 30d janela)

CPF NNN.NNN.NNN-NN | Nome Completo | Embarcador | NF NNNNNN | RA #ID

{
  "ts": "2026-05-04 11:36:42 BRT",
  "actor": "sistema:claudio_ai",
  "event": "resposta_postada_no_ra",
  "source": "painel_ra_business",
  "details": {
    "via": "chrome_mcp",
    "painel_url": "https://www.reclameaqui.com.br/area-da-empresa/...",
    "confirmacao": "Resposta enviada com sucesso"
  }
}

reclamacao_aberta            cliente abre no RA
detectada_no_painel_ra       SKILL watcher captura
detectada_no_email           SKILL inbox-watch captura
dados_extraidos              CPF, telefone, NF, embarcador via scrape
tentativa_lookup_esl         queries GraphQL + resultado
fluxo_detectado              A/B/C/D + severidade C1-C5
draft_gerado                 LLM Sonnet 4.6 + custo_usd
draft_aprovado               humano: rubens / gestor
data_proposta_gestor         quando Fluxo A pede data ao gestor
data_confirmada_gestor       gestor responde via WA
escalacao_rubens             timeout 1h30 sem resposta gestor
resposta_postada_no_ra       Chrome MCP via painel
gestor_alertado              WA pra líder filial
email_base_filial            email cumulativo TO+CC+BCC
kevin_acionado               WA pra Kevin com link
jimmy_acionado_ti            escalation TI se RA não sync
rubens_copia                 cópia executiva
cliente_respondeu            mensagem nova no thread RA
followup_postado             nova resposta nossa após dado novo
avaliacao_recebida           cliente fechou: nota+resolvido+voltaria
treplica_postada             nota baixa → resposta pública

fn_validar_cpf(text) → bool                         -- algoritmo módulo-11
cs_ra_find_lider(uf, cidade) → record               -- prioridade cidade > UF > FALLBACK
cs_ra_atribuir_filial_auto()                        -- TRIGGER BEFORE INSERT/UPDATE
cs_ra_log_event(ra_id, actor, event, details, source) → jsonb
cs_ra_lider_precisa_atualizar(lider, max_dias=30) → bool

Acesso →  https://ra.zzyon.com/m/<token-32chars>
   ↓
Verifica cs_ra_magic_sessions (token + expira_em > now)
   → renova expira_em +7d a cada acesso
   ↓
cs_ra_lider_precisa_atualizar(lider, 30d) ?
   ├─ TRUE: form obrigatório (CPF módulo-11 + RG + endereço + CNH...)
   │        persiste em cs_ra_lider_perfil + ultima_atualizacao=now()
   │        a cada 30d revalida
   └─ FALSE: dashboard direto
   ↓
Dashboard mostra reclamações da filial do líder + ações

NUNCA usar:
- "Conforme nosso sistema..."
- "Aguardamos sua compreensão"
- "Sua reclamação é importante para nós"
- "Pedimos a gentileza de aguardar"
- "Em breve" / "Logo" / "Brevemente"
- "Prezado(a) cliente"  → usar primeiro nome
- "Conforme procedimento"
- Qualquer emoji

-- 1) Legacy (alimenta painel ra.zzyon.com)
INSERT INTO reclamacoes_ra (numero_ra, data, cliente, ...)

-- 2) Canonical (alimenta vw_cs_ra_pulso_hoje + futuro UI v2)
INSERT INTO cs_ra_reclamacoes (ra_id, cliente_nome, ..., historico_log)

cs_ra_evento_tipos (10 eventos canônicos)
cs_ra_notification_rules (regras selecionáveis por filial+evento+canal)
cs_ra_emails_extras (emails/whatsapps adicionais por filial+evento)

SELECT * FROM cs_ra_resolver_destinatarios('reclamacao_nova', 'SAO');
-- retorna: lider_filial + jimmy_cc + rubens_bcc + extras configurados

reclamacao_nova           Nova reclamação detectada
resposta_postada          Resposta postada no RA
cliente_respondeu         Cliente respondeu na reclamação
aguardando_data_gestor    Aguardando confirmação de data (Fluxo A)
escalacao_rubens          Timeout 1h30 sem resposta gestor
avaliacao_alta            Cliente avaliou nota >= 8 + Voltaria=Sim
avaliacao_baixa           Cliente avaliou nota < 5 OU Voltaria=Não
treplica_disparada        Resposta nossa em avaliação negativa
reincidencia_cliente      Cliente já tinha reclamação anterior sem resposta
falha_tecnica             Erro de scraping/API/OAuth

GET /api/ra/eventos                       → lista eventos canônicos
GET /api/ra/notification-rules            → lista regras configuradas
POST /api/ra/notification-rules           → criar regra
PUT /api/ra/notification-rules/:id        → editar
DELETE /api/ra/notification-rules/:id     → desativar (soft delete: ativo=false)

GET /api/ra/emails-extras                 → lista emails extras
POST /api/ra/emails-extras                → adicionar
PUT /api/ra/emails-extras/:id             → editar
DELETE /api/ra/emails-extras/:id          → desativar

GET /api/ra/resolver?evento=X&filial=Y    → preview destinatários