2 Commits

Author	SHA1	Message	Date
Matheus	56499f4b99	feat(cdr): call detail records, relatorios e disposicoes ... Fecha agente.md secao 152-160. Registro duravel de chamadas — ate aqui o estado de uma chamada so' vivia transitoriamente no canal Redis b2bcall:events (pub/sub sem historico). ## Modelo calls/call_legs/call_events (secao 153, tenant-scoped, RLS) + dispositions (secao 89, "Call Center -> Disposicoes", personalizavel por tenant, mesmo padrao de PauseReason). dial_attempts da especificacao nao virou tabela nova — CallAttempt (fase Predictive Engine) ja cobre esse conceito; Call.attemptId liga um Call a' sua tentativa de discagem. Call.id = o proprio freeswitch_uuid da perna principal (sem suporte a transferencia entre uuids nesta fase). ## apps/freeswitch-events/src/cdr.ts Cada NormalizedEvent relevante faz upsert em Call + insere em call_events (a trilha bruta). CALL_ENDED calcula os agregados em segundos (secao 155-156): ringTime/waitTime/talkTime/durationSeconds/billableSeconds. ## Dois bugs reais achados e corrigidos testando esta fase - AGENT_OFFERED_CALL/AGENT_BRIDGE_FAILED disparam de uma thread interna do mod_callcenter (outbound_agent_thread_run), sem contexto de channel — nao tem header Unique-ID, entao callUuid ficava undefined e os dois eram descartados silenciosamente (Call.queueId/agentId nunca preenchidos mesmo com bridge/falha de bridge reais). Corrigido com fallback pro CC-Member-Session-UUID (data.memberSessionUuid), mesmo identificador ja usado pra correlacao equivalente no predictive-dialer. - Corrida entre CALL_CREATED/CALL_ANSWERED (persistCallEvent roda sem await, cada evento abre sua propria transacao) podia fazer answerAt aparecer antes de createdAt quando o upsert que criava a linha usava now() do momento errado (nao do occurredAt do evento real). Corrigido setando createdAt explicito a partir de normalized.occurredAt. ## Relatorios (apps/api/src/reports) GET /reports/queues (secao 159): recebidas/atendidas/abandonadas/TME/TMA/ Service Level/Abandon Rate por fila. GET /reports/agents (secao 158): tempo logado/pausado/por estado (AgentStateEvent pareado) + chamadas atendidas/TMA. GET /reports/campaigns (secao 160): leads/attempts/ answered/agent connected/busy/no answer/failed/callbacks/rates/TME/TMA — "Valor Telefonia"/"Valor IA" ficam null (dependem de Billing, fase propria). ## GET /calls e disposicao Secao 157: filtros por data/ramal/agente/fila/campanha/trunk/telefone/ hangup cause/disposicao, sempre escopado ao tenant do JWT. PATCH /calls/:id/disposition (secao 89): o proprio agente que atendeu marca (compara Call.agentId contra o Agent do usuario autenticado, nunca um agentId vindo do client), supervisor (agents.manage) pode marcar em nome de outro agente. Verificado ponta a ponta: campanha com 5 leads, 3 ANSWERED simulados entrando na fila real, Call.queueId/agentId/hangupCause corretos (confirmando a correcao da correlacao), createdAt<=answerAt em todos, durationSeconds batendo com discard_abandoned_after; os 3 relatorios com numeros internamente consistentes entre si e com os logs do discador (received:3/abandoned:3/abandonRate:1, leads:5/attempts:5/answered:3/ answerRate:0.6); disposicao gravada com ownership check correto; queue list do FreeSWITCH confirmou calls_abandoned=4 real ao final. typecheck do workspace inteiro limpo. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01X1HxY46WGU4G1zmVDNKcWw	2026-08-28 14:10:16 -03:00
Matheus	cb6d343b2e	feat(dialer): CPS Limiter + Predictive Dialer Engine ... Fecha agente.md secao 72-86 (motor preditivo) e 77-79 (CPS distribuido, reserva de leads, lock de campanha). Uma campanha RUNNING agora origina chamadas sozinha, respeitando capacidade de agentes, CPS hierarquico e taxa de abandono — sem intervencao manual. Deliberadamente fora do escopo (agente.md secao 72: "nao e' so' `for lead -> originate`"): mod_avmd (opcional), callbacks agendados, disposicoes de agente — ficam pra fase CDR. ## Novo servico apps/predictive-dialer Mesmo padrao arquitetural de fs-events/fs-config: Node standalone em Docker, ESL propria, tick a cada 2s sobre tenants ativos x campanhas RUNNING/WAITING_SCHEDULE. - Lock de campanha (dialer:campaign:{id}, secao 79): TTL/ownership/ renewal/safe-release via Lua compare-and-delete. - CPS distribuido (secao 77, 62): token bucket janela 1s, hierarquia GLOBAL/TENANT/TRUNK/CAMPAIGN numa unica chamada Lua atomica — nivel esgotado bloqueia todos SEM incremento parcial dos que passariam. - Reserva atomica de leads (secao 78): FOR UPDATE SKIP LOCKED dentro da mesma transacao withTenantContext. - CallAttempt/CampaignStats (schema novo): state machine da chamada (secao 82) + EWMA (secao 75) de answer_probability/average_answer_delay/ average_talk_time/abandon_rate por campanha. - Capacidade em tempo real + pacing (secao 73-76, 84-85): conta agentes por estado via Tier->Agent.state, previsao de liberacao (horizonte unico de 15s, simplificacao documentada dos 4 buckets da especificacao), controle de abandono reduz pacing progressivamente, nunca origina sem capacidade prevista. ## Modo simulacao (secao 185-186) DIALER_SIMULATION=true (default, ja estava no .env desde o inicio da sessao) sorteia ANSWER/BUSY/NO_ANSWER/FAILED em software, sem PSTN real. So' quando ANSWERED e' que uma chamada sintetica (null/dummy, sem PSTN) entra na fila real via mod_callcenter de verdade — escolha deliberada pra maximizar codigo real exercitado em vez de simular tudo em memoria. Os identificadores da secao 81 (b2bcall_tenant_id/call_id/attempt_id/ campaign_id/lead_id) vao como channel variables nessa perna, entregando tenantId real no WebSocket sem fan-out. Real Outbound Safety (secao 186): as duas flags checadas no boot, nunca ativadas automaticamente — caminho PSTN real implementado mas nunca exercitado (sem trunk/operadora real neste laboratorio). ## Dois bugs reais achados e corrigidos testando esta fase - Perna sintetica (null/dummy) nao tem midia do outro lado — nunca desligava sozinha depois de bridgear com um agente. Corrigido com hangup agendado via uuid_kill no talk_time simulado. - Corrida entre queue:sync e tier:sync (dois canais Redis independentes, sem ordem garantida): atribuir tier logo depois de criar a fila podia rodar tier add antes do queue reload terminar ("-ERR Queue not found!", erro real, diferente do ja conhecido "already exist"). Corrigido com retry curto (ate 3 tentativas) em agent-sync.ts::addTierWithRetry. ## GET /campaigns/:id/stats Secao 227.7 "visualizar pacing" — CampaignStats + agentes por estado + calls em andamento, sem esperar a fase Frontend. Verificado ponta a ponta: campanha RUNNING originando 3 tentativas por tick, outcomes simulados corretos com retry agendado (BUSY 15min/ NO_ANSWER 60min/FAILED 30min), uma tentativa ANSWERED completando o ciclo real inteiro (fila -> agente -> bridge -> hangup -> EWMA atualizada), stop nao derruba chamada ativa (secao 66), calls_answered=3 confirmado no `queue list` do FreeSWITCH. CPS limiter e lock de campanha testados isoladamente (hierarquia sem incremento parcial, ownership nunca roubado). typecheck do workspace inteiro limpo. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01X1HxY46WGU4G1zmVDNKcWw	2026-08-28 13:31:31 -03:00