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_mappingsemappings.version. - A cada Save com mudança detectada (JSON.stringify diff), a versão antiga é snapshot em
mapping_versionsemappings.versionincrementa. - 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
changeSummaryna 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