PRJ-CHECKPOINT·PRJ-3296

Checkpoint — Editar Previsão & Histórico

O Checkpoint — modal 'Editar Previsão' do Detalhe Processo — concentra as datas das etapas, vindas de tracking automático (robô Searates/CE Mercante) e de edição manual. Um dos primeiros projetos do Follow, com duas histórias: PRJ-3296 (refatoração do histórico de alterações) e PRJ-3722 (aba 'Ajuda' no modal).

ImportaçãoEm andamentoAlta10 de jul. de 2025
Em resumo
VD
Victor Dias
Design Lead
Área
Importação
Squad
Razac Team
Telas afetadas
1

Contexto

O Checkpoint — o modal "Editar Previsão" dentro do Detalhe Processo — concentra as datas das etapas do processo. Essas datas vêm de dois caminhos: tracking automático (robô Searates / CE Mercante) e edição manual do analista.

Esse foi um dos primeiros projetos trabalhados no Follow, e gerou duas histórias:

  • PRJ-3296 — Refatoração do histórico de alterações de tracking.
  • PRJ-3722 — Aba "Ajuda" dentro do modal de edição de datas.

Problema

  1. Dúvidas viravam chamado — pelos chamados (ver TEC-3975), muita gente não entendia como o tracking e o robô do CE Mercante funcionavam. Não havia nenhuma orientação dentro do próprio modal.
  2. Histórico com "ruído" — o robô Searates registrava atualizações mesmo quando a data não mudava, poluindo o histórico. E não ficava claro se cada alteração era de previsão ou de confirmação (realização).

Hipótese

Uma aba "Ajuda" consultiva no modal + um histórico que mostra só alterações efetivas e rotula o tipo de cada evento reduz chamados e dá clareza — sem perder rastreabilidade técnica no backend.

Solução

PRJ-3296 — Histórico

  • Exibe só alterações reais de data nas atualizações via Searates (dedup do robô); manuais mostram tudo.
  • Registros automáticos do robô continuam no backend (auditoria/rastreabilidade) — só não poluem a interface.
  • Cada evento deixa claro o tipo: Alteração de previsão × Confirmação de realização (+ Programação de faturamento).
  • Ocorrência destacada, e "Tracking Automático" sinalizado quando aplicável.
  • Ordem cronológica; dedup de duplo-clique em salvar (1 registro por alteração).
  • Aba renomeada para "Histórico".

PRJ-3722 — Aba "Ajuda"

  • Aba consultiva no modal com textos fixos por checkpoint (Data de Embarque, Data de Chegada e Desembarque no Porto de Destino): "Tracking automático ou digitação manual; para automático é necessário Nº Container preenchido."
  • Aviso de que as datas atualizam sozinhas via tracking e que alterações manuais saem pela aba "Editar Previsão".
  • Tagueamento das abas pra medir uso.

Outcomes

Histórico (PRJ-3296) refatorado e materializado no protótipo: diferenciação previsão × realização, ocorrência destacada, "Tracking Automático" e dedup — vivo no modal de detalhe-processo. Aba "Ajuda" (PRJ-3722) pendente. Métricas de redução de chamados a coletar pós-rollout.