Taxa de atendimento de 0% com mil chamadas: a métrica procurava um status que os dados não usam
[!NOTE] Resumo Executivo (DEV-2026-115): O painel mostrava 0% de atendimento e nenhuma chamada ativa, enquanto a lista exibia chamadas atendidas. Cada tela tinha a própria definição de atendida e de em andamento, e nenhuma foi conferida contra os dados.
🚨 O Desafio Técnico / Contexto
O painel contava só o status completed, mas os dados tinham apenas answered e abandoned. Outra tela procurava in_progress, que a validação nem aceita. E um indicador novo contava answered como em andamento sem olhar se a chamada já tinha terminado.
💡 Principais Lições Aprendidas & Descobertas
- 💡 Antes de escrever uma métrica, agrupe os dados reais por status. A consulta de um minuto teria mostrado o problema.
- 💡 Regra de negócio repetida em cada consulta acaba divergindo. Definir atendida e em andamento em um só lugar, com scopes no model, faz as telas concordarem.
- 💡 Em andamento depende de dois campos: o status e a data de encerramento vazia.
- 💡 Confira o número novo contra outro independente. Atendidas de 73,54% e abandono de 26,18% somam cerca de 100%, o que dá mais confiança do que o teste passar.
- 💡 O dado de demonstração revelou o erro, mas também pode confundir: uma pausa aberta há 8.504 horas é conta certa sobre um dado antigo, e não um defeito.
🛠️ Especificação Técnica & Código-Chave
public function scopeAttended($query)
{
return $query->whereIn('status', ['answered', 'completed']);
}
public function scopeOngoing($query)
{
return $query->whereIn('status', ['ringing', 'answered'])->whereNull('ended_at');
}
📈 Impacto no Ecossistema & Valor Prático
Painel, monitoramento e tela inicial passaram a usar a mesma definição e a mostrar números que fecham entre si.
- Projetos Relacionados:
sistema-de-atendimento - Registro de Origem:
_data/daily.dev-19.yml
Publicado originalmente como parte do Diário de Desenvolvimento 2026 do ecossistema Artes do Sul & Araguaci.