Central de AjudaVoltar ao app →
Todos os artigos
FT-INTEGRATION-MODE· 1.0.0Integrações

Modo de integração — observability vs orchestration

Toggle por integração que define se o Lefia só observa o tráfego (modo seguro pra rollout) ou orquestra de fato o envio ao destino. Default novo tenant: observability.

Atualizado em 8/6/2026

Modo de integração



Atualizado 2026-05-06. Default seguro pra rollout enterprise.

2 modos



ModoComportamento
observability (default)Lefia recebe, mapeia, mas não envia ao destino. Logs completos, fingerprinting, audit. Pra ver fluxo real sem efeito colateral
orchestrationPipeline completo: recebe → mapeia → envia ao destino, com retry/DLQ


Quando usar cada um



observability — primeiros 30/60/90 dias do cliente



  • Conecta source SAP, mas destino fica desligado
  • Cliente vê todo o tráfego no /monitor
  • Audit confirma "nada saiu de produção"
  • Sem risco de duplicar pedido / nota / payload em sistema externo


orchestration — produção real



  • Toggle ligado deliberadamente após validação
  • Pipeline completo: source → mapping → destino
  • Retry automático ou manual conforme retry_auto_enabled


Como mudar



/admin/empresa/[id] → editar integração → toggle mode. Mudança é audit-logged.

Default em tenants novos: observability. Migration retro-compat aplicou orchestration em integrações pré-existentes (preserva comportamento histórico).

Efeito no pipeline



  • processMessage(): chega em mapped, depois chama skipSend em vez de sendToDestination quando mode=observability
  • retry-orchestrator: no-op em observability (não enfileira retry sem destino)
  • UI: card da integração mostra badge READ-ONLY; retry policy oculta


Logs



Mensagens em modo observability têm dest_status_text="skipped (observability)" e pipeline_status="sent" (semanticamente: "Lefia terminou seu trabalho"). Aparece no monitor com indicador visual.

Roadmap relacionado



  • #63 Read-only por integração: feature original (delivered)
  • #52 Retry worker: respeita observability (não cria jobs)


Default seguro força operador a opt-in deliberado pra produção crítica.

Histórico de versões

  • 1.0.0

    Flag mode em integrations (observability|orchestration). Hook skipSend bloqueia envio ao destino quando observability; retry-orchestrator no-op no mesmo modo. Default observability pra novos tenants. UI: toggle no execution config, badge READ-ONLY no card, retry policy escondida quando observability.

    5/6/2026 · new