Todos os artigos
FT-MESSAGE-MAPPING-TRACE-V1· V3.0Monitor & Mensagens

Versão do mapping no detalhe da mensagem

Como ver qual mapping (e qual versão) produziu o mapped_data

Atualizado em 5/8/2026

Mapping usado na conversão



No detalhe de uma mensagem (Monitor → click numa linha → aba Convertidos), agora aparece um header acima do JSON convertido:

Mapping usado:  [Nome do mapping clicável]    [v1.3.0]


O que cada parte mostra

  • Nome clicável — link pra /edi-hub/<mapping_id> (detalhe do mapping)
  • Badge versão — semver atual armazenado no momento da conversão (ex: v1.3.0)


Por que isso importa

Mapping evolui ao longo do tempo. Quando uma mensagem foi convertida há 3 meses com a v1.0.0, e depois você publicou v1.3.0 com mudança no field X, sem essa info ficaria opaco "qual versão produziu este mapped_data".

A partir de 2026-05-08:
  • Tabela messages ganhou colunas mapping_id (FK pra mappings, ON DELETE SET NULL) e mapping_version (int).
  • Pipeline (process-message.ts) popula no momento do apply.
  • Mensagens convertidas antes desta data não têm a info — aparecem sem o header.


Caso edge: mapping excluído

Se o mapping foi excluído depois da conversão, FK fica null mas mapping_id continua referenciado. UI mostra "Mapping excluído (id ainda referenciado)" em italic — você não perdeu o tracking, só o nome humano.

Histórico de versões

  • V3.0

    Detalhe da mensagem ganha seção Output serializado mostrando string EDIFACT/X12/IDoc/JSON final enviada ao destino. Operator copia pra validador externo.

    5/21/2026 · updated

  • 1.1.0

    retry_pending visível como badge "Em retry" amarelo (antes caía em fallback "Recebido"), tooltip com retry_count + next_retry_at, prop tenants preparada pra view cross-tenant futura.

    5/15/2026 · updated

  • 1.0.0

    Traceability do mapping aplicado em cada mensagem. Nova migration adiciona messages.mapping_id (FK ON DELETE SET NULL) + mapping_version (int). Pipeline popula no momento do apply. API /monitor/message-detail faz JOIN com mappings. Modal de detalhe da mensagem na aba "Convertidos" mostra "Mapping usado: <nome clicável> v<version>" — útil pra audit ("essa mensagem foi convertida com a v1.3.0, antes da mudança X").

    5/8/2026 · new