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
This commit is contained in:
@@ -52,6 +52,10 @@ model Tenant {
|
||||
suppressionEntries SuppressionEntry[]
|
||||
callAttempts CallAttempt[]
|
||||
campaignStats CampaignStats[]
|
||||
dispositions Disposition[]
|
||||
calls Call[]
|
||||
callLegs CallLeg[]
|
||||
callEvents CallEvent[]
|
||||
|
||||
@@map("tenants")
|
||||
}
|
||||
@@ -265,6 +269,7 @@ model Extension {
|
||||
|
||||
tenant Tenant @relation(fields: [tenantId], references: [id])
|
||||
agents Agent[]
|
||||
calls Call[]
|
||||
|
||||
@@unique([tenantId, number])
|
||||
@@index([tenantId])
|
||||
@@ -359,6 +364,7 @@ model Trunk {
|
||||
|
||||
tenant Tenant @relation(fields: [tenantId], references: [id])
|
||||
campaigns Campaign[]
|
||||
calls Call[]
|
||||
|
||||
@@unique([tenantId, name])
|
||||
@@index([tenantId])
|
||||
@@ -485,6 +491,7 @@ model Queue {
|
||||
tenant Tenant @relation(fields: [tenantId], references: [id])
|
||||
tiers Tier[]
|
||||
campaigns Campaign[]
|
||||
calls Call[]
|
||||
|
||||
@@unique([tenantId, name])
|
||||
@@index([tenantId])
|
||||
@@ -542,6 +549,7 @@ model Agent {
|
||||
stateEvents AgentStateEvent[]
|
||||
pauseEvents AgentPauseEvent[]
|
||||
callAttempts CallAttempt[]
|
||||
calls Call[]
|
||||
|
||||
@@unique([tenantId, userId])
|
||||
@@index([tenantId])
|
||||
@@ -720,6 +728,7 @@ model Campaign {
|
||||
leads Lead[]
|
||||
callAttempts CallAttempt[]
|
||||
campaignStats CampaignStats[]
|
||||
calls Call[]
|
||||
|
||||
@@unique([tenantId, name])
|
||||
@@index([tenantId])
|
||||
@@ -784,6 +793,7 @@ model Lead {
|
||||
tenant Tenant @relation(fields: [tenantId], references: [id])
|
||||
campaign Campaign @relation(fields: [campaignId], references: [id])
|
||||
callAttempts CallAttempt[]
|
||||
calls Call[]
|
||||
|
||||
@@unique([campaignId, phoneNormalized])
|
||||
@@index([tenantId])
|
||||
@@ -865,6 +875,7 @@ model CallAttempt {
|
||||
campaign Campaign @relation(fields: [campaignId], references: [id])
|
||||
lead Lead @relation(fields: [leadId], references: [id])
|
||||
agent Agent? @relation(fields: [agentId], references: [id])
|
||||
calls Call[]
|
||||
|
||||
@@index([tenantId])
|
||||
@@index([campaignId, status])
|
||||
@@ -899,3 +910,153 @@ model CampaignStats {
|
||||
@@index([tenantId])
|
||||
@@map("campaign_stats")
|
||||
}
|
||||
|
||||
enum CallDirection {
|
||||
INBOUND
|
||||
OUTBOUND
|
||||
INTERNAL
|
||||
|
||||
@@map("call_direction")
|
||||
}
|
||||
|
||||
// Disposição escolhida pelo agente ao fim de uma chamada (agente.md secao
|
||||
// 89: "Call Center -> Disposições", personalizável por tenant — mesmo
|
||||
// padrão de PauseReason, não uma lista fixa hardcoded).
|
||||
model Disposition {
|
||||
id String @id @default(uuid()) @db.Uuid
|
||||
tenantId String @map("tenant_id") @db.Uuid
|
||||
|
||||
name String
|
||||
code String
|
||||
|
||||
enabled Boolean @default(true)
|
||||
|
||||
createdAt DateTime @default(now()) @map("created_at")
|
||||
updatedAt DateTime @updatedAt @map("updated_at")
|
||||
|
||||
tenant Tenant @relation(fields: [tenantId], references: [id])
|
||||
calls Call[]
|
||||
|
||||
@@unique([tenantId, code])
|
||||
@@index([tenantId])
|
||||
@@map("dispositions")
|
||||
}
|
||||
|
||||
// "calls" (agente.md secao 153-154) — um registro por chamada lógica
|
||||
// (`id` = freeswitch_uuid da perna principal; sem suporte a transferência
|
||||
// entre uuids nesta fase, então `call_id`/`freeswitch_uuid` coincidem por
|
||||
// enquanto, mantidos como campos separados pra já bater com o schema da
|
||||
// especificação quando isso mudar). Alimentado por
|
||||
// apps/freeswitch-events (nunca escrito manualmente pela API) — ver
|
||||
// docs/CDR.md.
|
||||
model Call {
|
||||
id String @id @db.Uuid
|
||||
tenantId String @map("tenant_id") @db.Uuid
|
||||
|
||||
// agente.md secao 154: attempt_id só existe pra chamadas originadas pelo
|
||||
// PredictiveDialerEngine — CallAttempt já cobre o conceito de
|
||||
// "dial_attempts" da secao 153, sem tabela duplicada.
|
||||
attemptId String? @map("attempt_id") @db.Uuid
|
||||
|
||||
freeswitchUuid String @map("freeswitch_uuid") @db.Uuid
|
||||
sipCallId String? @map("sip_call_id")
|
||||
|
||||
direction CallDirection @default(INTERNAL)
|
||||
|
||||
campaignId String? @map("campaign_id") @db.Uuid
|
||||
leadId String? @map("lead_id") @db.Uuid
|
||||
queueId String? @map("queue_id") @db.Uuid
|
||||
agentId String? @map("agent_id") @db.Uuid
|
||||
extensionId String? @map("extension_id") @db.Uuid
|
||||
trunkId String? @map("trunk_id") @db.Uuid
|
||||
|
||||
callerNumber String? @map("caller_number")
|
||||
calledNumber String? @map("called_number")
|
||||
|
||||
createdAt DateTime @default(now()) @map("created_at")
|
||||
progressAt DateTime? @map("progress_at")
|
||||
answerAt DateTime? @map("answer_at")
|
||||
queueEnterAt DateTime? @map("queue_enter_at")
|
||||
agentAnswerAt DateTime? @map("agent_answer_at")
|
||||
bridgeAt DateTime? @map("bridge_at")
|
||||
endAt DateTime? @map("end_at")
|
||||
|
||||
// Segundos, calculados quando a chamada termina (secao 155-156):
|
||||
// ringTime = answerAt-createdAt, waitTime = agentAnswerAt-queueEnterAt
|
||||
// (TME de uma chamada individual), talkTime = endAt-bridgeAt,
|
||||
// durationSeconds = endAt-createdAt, billableSeconds = talkTime por
|
||||
// enquanto (sem regra de arredondamento/tarifação ainda, fase Billing).
|
||||
ringTime Int? @map("ring_time")
|
||||
waitTime Int? @map("wait_time")
|
||||
talkTime Int? @map("talk_time")
|
||||
durationSeconds Int? @map("duration_seconds")
|
||||
billableSeconds Int? @map("billable_seconds")
|
||||
|
||||
hangupCause String? @map("hangup_cause")
|
||||
|
||||
dispositionId String? @map("disposition_id") @db.Uuid
|
||||
|
||||
tenant Tenant @relation(fields: [tenantId], references: [id])
|
||||
attempt CallAttempt? @relation(fields: [attemptId], references: [id])
|
||||
campaign Campaign? @relation(fields: [campaignId], references: [id])
|
||||
lead Lead? @relation(fields: [leadId], references: [id])
|
||||
queue Queue? @relation(fields: [queueId], references: [id])
|
||||
agent Agent? @relation(fields: [agentId], references: [id])
|
||||
extension Extension? @relation(fields: [extensionId], references: [id])
|
||||
trunk Trunk? @relation(fields: [trunkId], references: [id])
|
||||
disposition Disposition? @relation(fields: [dispositionId], references: [id])
|
||||
legs CallLeg[]
|
||||
events CallEvent[]
|
||||
|
||||
@@index([tenantId, createdAt])
|
||||
@@index([tenantId, queueId])
|
||||
@@index([tenantId, agentId])
|
||||
@@index([tenantId, campaignId])
|
||||
@@map("calls")
|
||||
}
|
||||
|
||||
// "call_legs" (secao 153) — um por channel/uuid FreeSWITCH envolvido na
|
||||
// chamada (hoje sempre 1, a própria perna principal; ganha sentido quando
|
||||
// existir bridge de 2+ pernas rastreadas separadamente, ex.: transferência).
|
||||
model CallLeg {
|
||||
id String @id @default(uuid()) @db.Uuid
|
||||
tenantId String @map("tenant_id") @db.Uuid
|
||||
callId String @map("call_id") @db.Uuid
|
||||
freeswitchUuid String @map("freeswitch_uuid") @db.Uuid
|
||||
|
||||
role String // "caller" | "callee" | "agent" — livre, sem enum fechado ainda
|
||||
|
||||
createdAt DateTime @default(now()) @map("created_at")
|
||||
answeredAt DateTime? @map("answered_at")
|
||||
endedAt DateTime? @map("ended_at")
|
||||
|
||||
hangupCause String? @map("hangup_cause")
|
||||
|
||||
tenant Tenant @relation(fields: [tenantId], references: [id])
|
||||
call Call @relation(fields: [callId], references: [id])
|
||||
|
||||
@@unique([freeswitchUuid])
|
||||
@@index([tenantId, callId])
|
||||
@@map("call_legs")
|
||||
}
|
||||
|
||||
// "call_events" (secao 153) — trilha bruta dos NormalizedEvent que
|
||||
// alimentaram a chamada, persistida (o canal Redis b2bcall:events é
|
||||
// efêmero, pub/sub sem histórico). Nunca deletado — é o material bruto por
|
||||
// trás de qualquer relatório futuro mais granular que os campos agregados
|
||||
// de `Call` não cobrirem.
|
||||
model CallEvent {
|
||||
id String @id @default(uuid()) @db.Uuid
|
||||
tenantId String @map("tenant_id") @db.Uuid
|
||||
callId String @map("call_id") @db.Uuid
|
||||
|
||||
type String
|
||||
occurredAt DateTime @map("occurred_at")
|
||||
data Json @default("{}")
|
||||
|
||||
tenant Tenant @relation(fields: [tenantId], references: [id])
|
||||
call Call @relation(fields: [callId], references: [id])
|
||||
|
||||
@@index([tenantId, callId, occurredAt])
|
||||
@@map("call_events")
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user