Todos os artigos
FT-MAPPING-VERSIONING-V1.5· 1.0.0help.categories.mapping

Histórico de versões do mapping

Cada save com mudança em field_mappings snapshota a versão antiga. Inspecione versões anteriores no botão v{N} do mapping detail.

Atualizado em 5/7/2026

Histórico de versões do mapping



Onde: botão "v{N}" no header da página de detalhe de mapping (top direita, ao lado do toggle de status).

Como funciona:

  • A versão atual fica em mappings.field_mappings e mappings.version.
  • A cada Save com mudança detectada (JSON.stringify diff), a versão antiga é snapshot em mapping_versions e mappings.version incrementa.
  • O modal mostra: versão atual no topo + lista descendente das versões antigas.


Cada item do histórico tem:

  • Número da versão.
  • Data e hora do save.
  • Email de quem salvou.
  • Resumo da mudança (se você forneceu via campo changeSummary na request — futuro UX vai expor isso na hora de salvar).
  • Snapshot completo de field_mappings + source_format + destination_format + status.


Quando usar:

  • "Ontem o mapping funcionava, hoje não" → abrir histórico, ver o que mudou e quando.
  • Auditoria pré-cutover → confirmar que a versão atual de prod bate com a aprovada.
  • Conferir contribuições da equipe ao longo do tempo.


Não tem ainda (V2, item #73 do roadmap):

  • Diff visual destacando campos adicionados/alterados/removidos.
  • Botão "Restaurar esta versão" (rollback não-destrutivo).

Histórico de versões

  • 1.0.0

    Histórico de versões de mapping. Migration mapping_versions com RLS por tenant. save-mapping snapshota versão atual quando field_mappings muda. Endpoint GET histórico/snapshot. Modal MappingVersionHistory mostra lista + preview JSON. V2 (diff visual + rollback) fica como #73 pending.

    5/7/2026 · new