Homologation Report: chronos-titulos

Date: 2026-04-12
Environment: cobranca-hml
URL: https://cobranca-hml.bralar.com.br

Current Status

• Epic 1: implementado
• Epic 2: implementado e homologado no HML
• Epic 3: implementado e validado com caso real T em 30 dias
• Epic 4: implementado e validado com casos reais T em Renegociacoes e Advogado
• Epic 5: implementado no nivel de flags, trilha de auditoria e relatorio de homologacao

Validated Flows

Quebras

• consolidacao Bralar + Travessia validada
• badge B/T validado
• proposta_exibicao, cliente e residencial da Travessia padronizados
• filtros de periodo ate 90 dias estabilizados
• performance e timeout ajustados no HML
• regra homologada de substituicao por renegociacao:
  • quando existir parcela original e parcela renegociada correspondente para o mesmo contrato/sufixo, a antiga deve ser desprezada
  • a linha valida para exibicao passa a ser a parcela RP
  • caso real validado no HML:
  • CPF 12036710670
  • cliente MARCOS VINICIOS FERREIRA
  • SQL Server contem 0003063-PI-08 e 0003063-RP-8
  • a exibicao correta no grid e 0003063-RP-8

Historico do cliente

• badge de origem B/T validado
• badge SUSPENSO omitido para origem=chronos
• contexto de historico preservado com fallback para Travessia

Triagem juridica

• proxy backend elimina CORS do api.sj
• uso de contract_external_id explicito preservado

30 dias

• registro Bralar + Travessia implementado
• flags de ja registrado revisadas
• reconhecimento de pagamento Chronos implementado
• grid Recebimentos 30 Dias consolidado
• reclassificacao historica aplicada em cobranca_30dias_registros para registros que eram Bralar e hoje pertencem a Travessia
• badge B/T validado visualmente no grid Recebimentos 30 Dias

Renegociacoes e Advogado

• endpoints migrados para camada consolidada comum
• precedencia 30 dias > advogado > renegociacoes aplicada no backend
• badge B/T implementado nos dois grids
• casos reais T validados visualmente em Renegociações Recebidas
• casos reais T validados visualmente em Recebimentos Advogado
• regra de proposta vigente estendida aos fluxos pagos:
  • Recebimentos 30 Dias, Renegociações Recebidas e Recebimentos Advogado agora tambem desprezam parcelas antigas substituidas por renegociacao
  • em ambiguidades por contrato+sufixo, a proposta RP vigente passa a ter prioridade sobre PI/PA

Cards

• Recebimentos por tipo, Total Recebimentos e Comissão leem totais consolidados coerentes com os grids

Dashboard Digital

• Total a Vencer consolidado com Travessia mantendo o periodo atual hoje -> ultimo dia do mes
• Total Vencidos consolidado com Travessia mantendo o periodo primeiro dia do mes -> ontem
• Total Vencidos passou a respeitar pro.SuspenderFaturamento = 0 na parte Bralar
• Inadimplência consolidada com Travessia e com pro.SuspenderFaturamento = 0 na parte Bralar
• Carteira Total continua sendo derivado no frontend pela soma:
  • Total Vencidos
  • Total Recebido
  • Total a Vencer
• Total Recebido continua vindo da prévia mensal de gratificação, já consolidada no HML
• Top Cobrador foi alinhado para usar a mesma base consolidada da prévia/fechamento

Evidencias operacionais recentes no HML:

• Total a Vencer passou a incluir 1150 parcelas Travessia no periodo atual, totalizando R$ 324.604,58 na origem local Chronos
• endpoint consolidado de Total a Vencer respondeu R$ 398.114,87 no HML apos o ajuste
• endpoint consolidado de Total Vencidos respondeu R$ 279.007,21 no HML apos o ajuste
• endpoint consolidado de Inadimplência respondeu R$ 825.145,26 com percentual 1,2 % no HML apos o ajuste

Fechamento de gratificacao

• a prévia mensal de gratificação foi revisada para usar a mesma classificação consolidada da feature
• Renegociação e Advogado deixam de depender apenas do SQL Server e passam a considerar também linhas Travessia já consolidadas
• 30 Dias passa a somar COALESCE(valor_pago, valor) para refletir o valor efetivamente pago
• simulação validada para 04/2026 no HML:
  • prévia antiga: R$ 169.941,03
  • prévia corrigida: R$ 170.200,21
  • diferença real identificada: + R$ 259,18
• não havia fechamento persistido para 04/2026 no HML no momento da correção, portanto o ajuste entrou antes da gravação definitiva

Operational Controls

Feature Flags

• CHRONOS_ENABLED
• CHRONOS_FLOW_QUEBRAS_ENABLED
• CHRONOS_FLOW_30DIAS_ENABLED
• CHRONOS_FLOW_RENEGOCIACOES_ENABLED
• CHRONOS_FLOW_ADVOGADO_ENABLED
• CHRONOS_TRACE_ENABLED

Trace / Audit

• prefixo funcional: classificacao_titulos
• eventos principais:
  • titulo_classificado
  • titulo_omitido
  • chronos_flow_disabled
  • chronos_fetch_failed

Sync Operation State

Estado operacional validado em 2026-04-12 no HML:

• full concluido com sucesso:
  • inicio 2026-04-11 23:18:45
  • fim 2026-04-11 23:39:57
  • 2238 creditos inseridos
  • 296193 parcelas inseridas
• incremental concluido com sucesso:
  • inicio 2026-04-12 00:27:53
  • fim 2026-04-12 01:29:08
  • 2238 creditos atualizados
  • 296193 parcelas atualizadas
• base local consolidada:
  • 2238 creditos
  • 296193 parcelas
  • 0 parcelas sem CPF
  • 0 parcelas orfas

Agendamento efetivamente configurado no servidor HML:

• carga completa diaria:
  • 06:00
  • segunda a domingo
• incremental:
  • 07:00 ate 19:00
  • somente segunda a sexta
• healthcheck:
  • 03:30
  • segunda a domingo
  • --stale-minutes=1440

Observacao operacional importante:

• em domingo, a carga full e o healthcheck continuam rodando
• em domingo, o incremental horario nao roda
• essa diferenca foi confirmada no crontab do servidor e deve ser preservada no futuro rollout

Known Remaining Functional Evidence Gaps

• nao ha gap funcional critico aberto nos grids principais homologados nesta fase
• ainda e desejavel registrar, em janela futura, um caso ponta a ponta inteiramente observado em operacao:
  • quebras
  • marcar 30 dias
  • pagamento reconhecido automaticamente
  • aparicao em Recebimentos 30 Dias
• essa evidencia adicional e recomendada para conforto operacional, nao bloqueio tecnico do HML

Release Guidance

• o codigo esta apto no HML
• antes de qualquer movimento para producao, a recomendacao e observar estabilidade dos jobs de sincronizacao e confirmar ausencia de regressao por alguns ciclos
• nao mover para producao sem autorizacao explicita
• rollback continua sendo por configuracao, sem cirurgia manual
• quando houver autorizacao para producao, a configuracao operacional deve reproduzir explicitamente:
  • carga completa diaria as 06:00
  • incremental horario 07:00-19:00 apenas em dias uteis
  • healthcheck diario as 03:30
  • ativacao de flags e cron apenas no ambiente de producao, nunca antecipadamente

Final Checklist

• checklist operacional preparado em:
  • /var/www/html/cobranca-hml/_evo-output/planning-artifacts/chronos-titulos/final-homologation-checklist.md
• esse checklist e a referencia para encerrar a feature com evidencia funcional real no HML