PRJ-4561

Parametrização de Modelos de Checkpoint

O time de sustentação precisava cadastrar regras que controlam quais Checkpoints aparecem no formulário de criação de processo, baseadas na combinação de Modal × Regime × Remoção. Inexistia tela administrativa para essa parametrização — toda alteração exigia ticket técnico.

AdministrativoEntregueAlta15 de abr. de 2026 → 02 de mai. de 2026
Em resumo
VD
Victor Dias
Design Lead
Área
Administrativo
Squad
Razac Team
Telas afetadas
2
Componentes
5

Contexto

O time de sustentação da Razac precisava cadastrar regras que controlam quais Checkpoints aparecem no formulário de criação de processo. Essas regras dependem da combinação de Modal × Regime × Remoção, e a cada novo cenário operacional surgia uma combinação nova que o sistema não suportava.

Antes deste projeto, qualquer ajuste exigia ticket técnico para o time de TI: dev, deploy e validação podiam levar de 2 a 5 dias. O resultado era uma fila crescente de tickets pequenos e operadores expostos a checkpoints irrelevantes para o tipo de processo.

Problema

A ausência de uma interface administrativa de auto-atendimento gerava três problemas simultâneos:

  1. Lead time alto entre detectar a necessidade de uma regra e ela entrar em produção
  2. Dependência rígida do time de TI para mudanças de baixa complexidade
  3. Risco operacional quando combinações novas não tinham regra cadastrada — operadores marcavam checkpoints incorretos

Hipótese

Uma tela CRUD administrativa com listagem + drawer de edição multi-select reduz drasticamente o tempo de configuração e permite que sustentação resolva 100% dos casos de configuração sem intervenção de devs. As três decisões-chave que precisariam ser validadas:

  • V1 — Expor o ID das parametrizações (PRM-001, PRM-002...) para facilitar referência em conversas e tickets
  • V2 — Multi-select em todos os 3 campos (Modal, Regime, Remoção) para que uma única parametrização cubra múltiplas combinações sem duplicar registros
  • V3 — Filtros por coluna na listagem para permitir busca rápida em bases grandes

Solução

A solução foi entregue em duas telas complementares:

Tela 01 — Listagem

Tabela completa das parametrizações com filtros por coluna (ID, Modelo, Modal, Regime, Remoção). Cada linha mostra os chips das combinações associadas e ações de editar/remover. Inclui empty state quando filtros não retornam resultados, e contador "X de Y" para feedback de filtragem.

Tela 02 — Drawer de Edição (PRM-002)

Drawer lateral direito que abre sobre a listagem, permitindo edição sem perder contexto. Campos:

  • Nome do modelo — texto livre
  • Modal — multi-select chip (Marítimo, Aéreo, Rodoviário)
  • Regime — multi-select chip (Comum, Drawback, Admissão Temporária, RECOF)
  • Remoção — multi-select chip (DTA, Desembaraço imediato, Trânsito interno)

Footer fixo com botões Cancelar (ghost) e Salvar parametrização (primary). Toast de feedback após salvar.

Seção de Dúvidas

Para tracking durante validação com PO e analistas, criamos uma seção colapsável com 7 dúvidas (Q1-Q7) marcadas em três estados:

  • 🟢 Verde — validada com Rayanne
  • 🟡 Âmbar — pendente de revisão
  • 🔴 Vermelho — bloqueador, depende da Tayane

Esse tracking visual virou um padrão local para futuras parametrizações.

Outcomes

  • Sustentação ganhou autonomia para criar e editar parametrizações sem dependência de TI
  • Tela validada com a Tayane (PO) e Rayanne em sessão 1:1
  • 3 hipóteses de design (V1, V2, V3) confirmadas
  • 7 dúvidas (Q1-Q7) ainda abertas e em handoff para a Tayane

TODO após rollout: medir os campos current das métricas business (m1, m2, m3) e UX (m4, m5, m7) para ver se o ganho real de tempo bate com a meta projetada de "menos de 5 minutos para criar parametrização".