Chronos Sync Local - Operação

Comandos

Carga completa inicial

APP_ENV=hml \
CHRONOS_ENABLED=true \
CHRONOS_CLIENT_ID=... \
CHRONOS_CLIENT_SECRET=... \
php scripts/chronos_sync_full.php

Carga incremental

APP_ENV=hml \
CHRONOS_ENABLED=true \
CHRONOS_CLIENT_ID=... \
CHRONOS_CLIENT_SECRET=... \
php scripts/chronos_sync_incremental.php

Runner operacional do incremental

APP_ENV=hml \
CHRONOS_ENABLED=true \
CHRONOS_CLIENT_ID=... \
CHRONOS_CLIENT_SECRET=... \
bash scripts/chronos_sync_incremental_runner.sh

Status operacional

APP_ENV=hml php scripts/chronos_sync_status.php

Healthcheck

APP_ENV=hml php scripts/chronos_sync_healthcheck.php --stale-minutes=1440

Endpoint interno

• GET /src/api/chronos_sync_status.php
• requer sessão autenticada
• parâmetros:
  • stale_minutes
  • recent_limit

Painel operacional

• acesso pela opção Sinc. no dropdown do usuário
• tela principal: /sinc.php
• recursos disponíveis no HML:
  • status da sync
  • histórico de execuções
  • logs
  • comparativo Base local x API
  • recheck manual
  • leitura e ajuste do cron operacional

Agendamento recomendado

• escopo:
  • somente homologação em /var/www/html/cobranca-hml
  • não configurar nem replicar para /var/www/html/cobranca sem autorização explícita
• carga completa diária:
  • 22:00, de segunda a domingo
• frequência base:
  • incremental a cada 2 horas no HML, de 07:00 até 19:00, segunda a sexta
• healthcheck:
  • 03:30, 1 vez por dia
• bloco de cron:
  • CHRONOS_SYNC_HML
• helper de cron:
  • scripts/chronos_cron_admin.php
• proteção contra concorrência:
  • usar scripts/chronos_sync_incremental_runner.sh, que aplica flock
• log operacional:
  • logs/chronos_sync_incremental.log
• exemplo de cron:
  • ver chronos-sync-local-cron.example

Leitura do status

• overall_status = ok
  • última sincronização concluída, base sem divergência crítica
• overall_status = warning
  • sincronização parcial, base stale ou divergência saneável
• overall_status = critical
  • falha operacional, sem carga válida ou armazenamento vazio

Sinais monitorados

• idade da última execução
• status do último full e do último incremental
• checkpoint incremental
• quantidade de créditos e parcelas locais
• parcelas sem CPF
• parcelas órfãs
• volumes OVERDUE e PAID

Situação homologada em 2026-04-11

• carga completa inicial finalizada com 2238 créditos e 296193 parcelas
• saneamento posterior deixou parcels_without_cpf = 0
• base local validada para continuar como fonte da dashboard no HML
• runner de agendamento incremental preparado com lock e healthcheck pós-execução
• produção segue bloqueada até autorização explícita

Atualização operacional em 2026-04-12

• proposal_display passou a ser persistida offline na base local do HML
• Renegociações e Recebimentos Advogado deixaram de depender de enriquecimento pesado em SQL Server durante o request
• foi iniciado backfill offline de em_advogado via SQL Server para completar a classificação local
• enquanto o backfill estiver em andamento, o status funcional da feature permanece ready-for-review
• o cron real do HML passou a incluir carga completa diária às 22:00
• o healthcheck diário permanece às 03:30

Atualização operacional em 2026-04-24

• o HML passou a ter o painel Sinc. como camada oficial de observabilidade da sync
• o cron operacional atual foi ajustado para:
  • full: 0 22 * * *
  • incremental: 0 7-19/2 * * 1,2,3,4,5
  • healthcheck: 30 3 * * *
• o recheck manual passou a registrar run antecipadamente e acompanhar progresso por run_id
• a leitura e gravação da agenda agora usam helper privilegiado para refletir o cron real do root