_evo-output/planning-artifacts/chronos-rollout-operacional/feature-overview.md
Chronos Rollout Operacional
PLANNING
MD
Chronos Rollout Operacional
Objetivo
Registrar, em uma feature BMAC separada, toda a trilha operacional necessária para promover com segurança para produção tudo o que já foi implementado e homologado no HML em torno de:
chronos-titulos
chronos-sync-local
- ajustes correlatos em dashboards, páginas auxiliares, fechamento, jurídico, histórico, jobs e observabilidade
Esta feature não cria nova regra de negócio para o usuário final. Ela existe para impedir perda de contexto na promoção para produção.
Recorte adicional consolidado em 24/04/2026
Além do pacote já documentado de chronos-titulos e chronos-sync-local, o HML passou a ter um módulo operacional próprio de sincronização:
- tela
Sinc. acessível no dropdown do usuário
- painel de operação com status, histórico, alertas e falhas
- comparativo
Base local x API online por data
- logs operacionais acessíveis sem terminal
recheck manual com acompanhamento de progresso
- configuração de cron no próprio painel, refletindo o cron operacional real
Esse módulo precisa entrar no rollout como parte explícita do pacote, porque ele fecha a governança da sync local e reduz risco operacional no pós-go-live.
Problema Real
Ao longo da homologação, a entrega deixou de ser apenas "adicionar títulos Travessia nos grids". O pacote real passou a incluir:
- consolidação funcional em múltiplos grids
- sincronização local da Chronos
- ajustes de performance e timeout
- ajustes em páginas auxiliares
- correções em KPIs e fechamento
- trilha operacional com
cron, healthcheck e auditoria
- reclassificações históricas em base MySQL
- reforço de regras de ambiente, para não tocar produção antes de autorização
Se essa trilha ficar espalhada somente em commits, conversas e memória operacional, o risco é alto:
- esquecer parte dos arquivos dependentes
- subir apenas o "core" e deixar fora ajustes de suporte
- reproduzir o código sem reproduzir o desenho operacional
- ativar produção sem paridade de ambiente
Resultado Esperado
Ao final desta feature operacional, deve existir um pacote documental completo, auditável e executável, suficiente para:
- listar tudo o que foi alterado no HML
- separar o que é funcional, o que é técnico e o que é operacional
- descrever como isso precisa ser replicado em produção
- definir a ordem correta de promoção e validação
- impedir rollout parcial ou com lacunas invisíveis
integracao-api-titulos
Serve como contexto histórico da ideia original de integração via API.
chronos-titulos
Concentra a feature funcional principal:
- badges
B/T
- ownership
- classificação entre grids
30 dias
advogado
renegociações
- homologação funcional
chronos-sync-local
Concentra a evolução técnica que substituiu leitura online por base local sincronizada, reduzindo timeout e dependência da API externa.
chronos-rollout-operacional
Consolida o pacote de promoção HML -> produção. Não substitui as anteriores; amarra todas em um plano único de produção.
Escopo desta feature
- inventário completo dos ajustes realizados no HML
- mapeamento de arquivos, endpoints, scripts, jobs e dependências
- desenho operacional a ser replicado em produção
- checklist de promoção
- checklist de validação pós-ativação
- estratégia de rollback por flags e por cron
- critérios explícitos do que não pode ser presumido
- documentação específica do módulo
Sinc. com epics, fases e pontos de validação
Fora de escopo
- ativar produção sem autorização explícita do usuário
- criar novas regras de classificação para títulos
- alterar UX principal dos grids
- substituir novamente o desenho da sync local
Status inicial
- feature criada no BMAC
- contexto ativo apontado para esta trilha
- artefatos operacionais detalhados iniciados
- módulo
Sinc. implementado no HML e ainda pendente de consolidação documental completa para promoção