Acompanhamento da Feature

Chronos Títulos - BMAC Method

Painel de leitura da documentação, planejamento e implementação por feature, com seleção centralizada antes da navegação.

Progresso Total da Feature
Feature `chronos-titulos`
18 concluídas, 0 em review, 0 prontas para dev, 0 ainda não iniciadas.
Andamento estimado
100%
Próximos Passos
BMAC Nenhum próximo passo automático identificado com o estado atual dos artefatos.
Filtros de Stories
Epics e Stories
Epic 4: Renegociacoes e Recebimentos Consolidados
Progresso estimado 100%
3 concluídas, 0 em review, 0 prontas para dev
4.1
Renegociacoes recebidas com Travessia
complete
4.2
Cards `Recebimentos por tipo` e `Total Recebimentos`
complete
4.3
Recebimentos advogado com Travessia
complete
Epic 5: Homologacao, Observabilidade e Rollout
Progresso estimado 100%
3 concluídas, 0 em review, 0 prontas para dev
5.1
Logs e rastreabilidade de classificacao
complete
5.2
Feature flags e degradacao segura
complete
5.3
Homologacao funcional em `cobranca-hml`
complete
Biblioteca de Documentos
docs/manual-dashboard-cobrador.md

Manual de uso: Dashboard do Cobrador

DOCS MD

Manual de uso: Dashboard do Cobrador

O que esta tela faz

O dashboard_cobrador.php é a tela operacional principal do cobrador.

Ela concentra, em uma única rotina:

  • visão executiva do mês
  • fila operacional de Quebras
  • consultas de recebimentos por tipo
  • ações rápidas de histórico, 30 dias e triagem jurídica
  • lembretes operacionais do usuário logado

O objetivo é permitir que o cobrador acompanhe sua carteira, priorize pendências e execute a rotina diária sem trocar de contexto.

Quem vê esta tela

Esta tela é carregada para o usuário autenticado como cobrador.

Todos os dados exibidos respeitam:

  • o usuário logado
  • a carteira atribuída ao usuário
  • as regras de origem entre Bralar e Travessia
  • as regras de classificação dos fluxos de cobrança

Visão geral atual da tela

O dashboard está organizado em quatro áreas principais:

  1. Topo da rotina
  2. Resumo financeiro
  3. Fila operacional
  4. Consultas e recebimentos

Topo da rotina

O topo mostra o nome do painel e deixa claro que Quebras é a fila principal da rotina diária.

As ações rápidas disponíveis são:

  • Guia da rotina: abre este manual.
  • Ir para Quebras: leva diretamente para a fila operacional.
  • Consultas: abre a área de consultas e recebimentos.

O topo foi mantido compacto para não competir com os indicadores e com a fila principal.

Resumo financeiro

Logo abaixo do topo existe uma faixa única de indicadores, com leitura rápida para operação e gestão.

Os indicadores exibidos são:

  • Meta do mês
  • Total recebimentos
  • Comissão
  • Renegociados
  • 30 dias
  • Advogados

Essa faixa serve para análise rápida do mês corrente. Os valores são exibidos com destaque para facilitar comparação e acompanhamento.

Origem dos registros: Bralar e Travessia

O dashboard consolida títulos de duas origens:

  • Bralar
  • Travessia / Chronos

Como a origem aparece

As linhas dos grids podem exibir badge de origem:

  • B em azul para Bralar
  • T em verde para Travessia

Esse badge indica a origem do título sem mudar o modo de operação do cobrador.

Fila operacional

O que é

A seção Fila operacional contém o grid de Quebras da carteira no período selecionado.

Esse é o principal ponto de trabalho diário do cobrador.

Filtros disponíveis

Na parte superior da fila, o usuário pode usar:

  • busca por cliente ou residencial
  • data inicial
  • data final
  • botão Buscar
  • atalhos de período:
    • 1 dia
    • 7 dias
    • 15 dias
    • 30 dias
    • 60 dias
    • 90 dias

Visões rápidas

A fila também possui atalhos de análise:

  • Todos
  • Mais urgentes
  • Maior valor
  • Sem contato
  • Pendentes

Essas opções ajudam a priorizar o trabalho sem alterar a carteira do cobrador.

Resumo da fila

Antes da tabela, a tela mostra indicadores operacionais:

  • registros
  • total em aberto
  • sem contato
  • pendentes
  • trabalhados
  • maior atraso

Também existem chaves para exibir ou ocultar grupos de status:

  • Sem contato
  • Pendentes
  • Trabalhados

Colunas da tabela

A tabela de Quebras apresenta:

  • origem / situação
  • proposta
  • residencial
  • cliente
  • CPF/CNPJ
  • vencimento
  • dias
  • total
  • ações

Ações da linha

As ações variam conforme a elegibilidade do título, mas a fila suporta:

  • abrir histórico do cliente
  • registrar no fluxo de 30 dias
  • enviar para triagem jurídica

Ação: Abrir histórico do cliente

Abre a ficha operacional do cliente em tela própria.

Quando necessário, o link leva contexto adicional:

  • CPF
  • origem
  • proposta
  • contract_external_id

Esse contexto permite que o histórico funcione de forma coerente para Bralar e Travessia.

Ação: Registrar 30 dias

Marca a linha de Quebras como registrada no fluxo de 30 dias.

Quando acionado:

  1. a tela abre um modal de confirmação
  2. o sistema registra o evento na base operacional
  3. a linha passa a refletir visualmente o registro
  4. a proposta pode receber o indicador 30d

Nem toda linha é elegível para 30 dias. Quando a regra de negócio bloquear o registro, a ação aparece indisponível.

Ação: Triagem jurídica

Permite sinalizar o cliente ou título para análise jurídica.

Ao acionar a triagem:

  1. o usuário informa o motivo
  2. o sistema envia o caso para o fluxo jurídico
  3. o dashboard atualiza o estado visual
  4. pode haver registro complementar no histórico

Para funcionar corretamente, a linha precisa ter os identificadores mínimos exigidos pelo fluxo, como CPF e dados de contrato.

Consultas e recebimentos

As consultas ficam em blocos recolhidos para manter o foco na fila operacional.

Os blocos disponíveis são:

  • Renegociações Recebidas
  • Recebimentos 30 Dias
  • Recebimentos Advogado

Cada bloco é carregado sob demanda. Ou seja, a consulta só busca e monta os dados quando o usuário abre o bloco.

Renegociações Recebidas

Lista os recebimentos classificados como renegociação dentro do período escolhido.

O grid mostra:

  • origem
  • proposta
  • residencial
  • cliente
  • CPF/CNPJ
  • data
  • total
  • ação de histórico

Recebimentos 30 Dias

Lista títulos pagos vinculados ao fluxo de 30 dias.

Para aparecer nesse grid, a linha normalmente precisa:

  • ter sido registrada no fluxo de 30 dias
  • ter sido reconhecida como paga
  • continuar pertencendo à carteira válida do usuário

Recebimentos Advogado

Lista os recebimentos classificados como advogado.

Esse bloco separa recebimentos jurídicos dos demais recebimentos para preservar a leitura correta dos indicadores.

Lembretes do usuário

A dashboard também trabalha com lembretes operacionais.

Eles servem para:

  • lembrar contatos do dia
  • acompanhar pendências futuras
  • facilitar abertura rápida da ficha do cliente

Regras gerais da tela

Regra 1. Tudo é filtrado pelo usuário logado

Os dados devem refletir somente a carteira do cobrador autenticado.

Regra 2. A experiência é única

Mesmo com múltiplas origens de dados, o usuário deve trabalhar em uma única operação.

Regra 3. Origem não muda a ação

Se o título for Bralar ou Travessia, o fluxo operacional deve continuar consistente.

Regra 4. Os grids não podem duplicar o mesmo título indevidamente

A consolidação precisa preservar:

  • coerência de totais
  • coerência de indicadores
  • coerência de comissão
  • coerência de fechamento

Dúvidas comuns

1. Por que uma linha aparece com B ou T?

Porque o dashboard consolida títulos de duas origens:

  • B = Bralar
  • T = Travessia

2. Posso trabalhar um título da Travessia igual ao da Bralar?

Sim. A operação é a mesma; o badge apenas informa a origem.

3. O botão de histórico funciona para Travessia?

Sim. O fluxo leva contexto adicional quando necessário.

4. O botão de triagem jurídica funciona para ambas as origens?

Esse é o objetivo do fluxo consolidado, desde que a linha tenha os dados obrigatórios.

5. O que significa 30d na proposta?

Significa que a linha já foi registrada no fluxo de 30 dias.

6. Por que as consultas ficam recolhidas?

Para a dashboard abrir mais leve e manter o foco na fila principal. Cada consulta é carregada apenas quando aberta.

Boas práticas operacionais

  • começar pela Fila operacional
  • usar filtros de período antes de concluir análise
  • usar as visões rápidas para priorizar urgência ou maior valor
  • abrir o histórico antes de ações sensíveis
  • evitar retrabalho em linhas já marcadas ou classificadas
  • usar triagem jurídica com motivo claro
  • abrir consultas de recebimentos apenas quando precisar conferir valores

Resumo rápido

  • Topo: identificação da rotina e atalhos principais
  • Resumo financeiro: meta, recebimentos, comissão e composição por tipo
  • Fila operacional: principal área de trabalho com Quebras
  • Consultas e recebimentos: grids recolhidos e carregados sob demanda
  • Badge B/T: origem Bralar ou Travessia
  • Histórico: abre a ficha operacional do cliente
  • Registrar 30 dias: marca a linha para o fluxo específico
  • Triagem jurídica: envia o caso ao fluxo jurídico