Pular para conteúdo

C2 — Containers do Hub

Zoom dentro do Hub de Integração Sorocabana (caixa central do C1). Mostra os containers (processos) que compõem o hub on-prem (Linux Oracle), organizados em duas camadas — Staging (extractors por fornecedor) e Projetores (processadores por produto) — orquestradas pelo SINCRONIZADOR. Plug e ArcGIS aparecem nos dois lados (fontes e consumidores).

Diagrama

Containers do hub

# Container Localização Responsabilidade
1 Staging (container Container <Fornecedor> por fonte) On-prem Motiva (hub) Um por fornecedor: Kartado, KAPSCH, ArcGIS, Plug, Ícaro, ... (placeholder para demais). Extrai dado da fonte e grava as-is no schema correspondente de BANCO STAGE. Sem padrão de comunicação, sem padrão de formato, sem regra de negócio; compatível com LGPD.
2 BANCO STAGE On-prem Motiva (hub) Oracle. Schema-per-fornecedor. Verdade-do-fornecedor: persistência fiel ao original, auditável, reprocessável.
3 SINCRONIZADOR On-prem Motiva (hub) Container que orquestra os jobs das duas camadas (Staging e Projetores). Tecnologia exata pendente.
4 Projetores (container Projetor <Produto> por produto) On-prem Motiva (hub) Um por produto/consumidor: SGP, SISGIS, ArcGIS, Plug, .... Lê de um ou mais schemas em BANCO STAGE, transforma para visão útil ao produto (pode combinar fornecedores), persiste como Read Model no schema correspondente em BANCO ARTESP.
5 BANCO ARTESP On-prem Motiva (hub) Oracle. Read Models por produto/consumidor. Verdade-do-produto: o que os consumidores leem.

Projetor ArcGIS e Projetor Plug

Ponto importante: cada consumidor que também é fonte tem um projetor dedicado, que constrói o Read Model específico para ele:

  • Projetor ArcGIS → escreve SCHEMA ARCGIS em BANCO ARTESP → ArcGIS-consumidor lê dali.
  • Projetor Plug → escreve SCHEMA PLUG em BANCO ARTESP → Plug-consumidor lê dali.

Isso evita expor schemas crus aos consumidores e dá flexibilidade para evoluir o modelo de cada consumidor independentemente.

Padrões arquiteturais (de ingestão)

Todas as fontes terminam em um schema de BANCO STAGE via container Staging dedicado. A diferença entre os padrões está em onde a fonte mora e como a comunicação cruza fronteira de rede:

Padrão Aplicável a (nesta versão) Mecânica
Pull-SaaS Kartado Container Staging chama API REST do SaaS via internet, egress controlado (firewall, lista branca). Cruzamento CLOUD ↔ ON-PREMISE via DMZ ou VPN.
Pull-On-Prem KAPSCH, Plug (fonte), ArcGIS (fonte), Ícaro Container Staging chama API na intranet Motiva. Sem cruzar fronteira de rede externa.

Padrões Push-from-Source (Construtivo) e Bypass (Esteio-ETT) existem no escopo amplo do projeto mas ainda não estão modelados nesta versão. Quando essas fontes entrarem em escopo, atualizamos aqui.

Plug e ArcGIS — papel duplo

Ambos aparecem nos dois lados do hub:

  • Como fonte: plug -> Container Plug (Staging) -> BANCO STAGE (telas de entrada de dados do Plug); arcgis -> Container ArcGIS (Staging) -> BANCO STAGE (inputs do pessoal de campo).
  • Como consumidor: BANCO ARTESP -> plug (lendo SCHEMA PLUG); BANCO ARTESP -> arcgis (lendo SCHEMA ARCGIS).

Não é round-trip — o dado que entra (registros nascidos no Plug/ArcGIS) é distinto do dado que sai (Read Models projetados a partir de múltiplos fornecedores). O fluxo continua unidirecional para cada registro.

Bloqueio inbound (Cyber Motiva)

Requisições inbound ao hub são bloqueadas pela equipe de Cyber da Motiva. Isso reforça que toda integração tem o hub como ponto que inicia chamadas (Pull) ou recebe pushes autorizados — nunca o hub expõe API para clientes externos arbitrários.

O que NÃO aparece neste C2

  • Trilha de auditoria — ainda não modelada; quando virar requisito explícito, será adicionada.
  • Sistemas ainda não modelados nesta versão: Power BI, AutoDesk, KCOR, SAT, MITS, Portal Faixa de Domínio, Construtivo, Esteio-ETT.
  • Decomposição interna de cada Container Staging — ver C3 por integração.
  • Decomposição interna de cada Projetor — ver C3 por produto ARTESP (a fazer conforme Discovery).
  • Schema canônico de BANCO STAGE e modelo de cada Read Model em BANCO ARTESP — D3 do blueprint.
  • Tecnologia exata do SINCRONIZADOR — D12 do blueprint.
  • VPN, firewall, segmentação de rede — abstraídos para "DMZ ou VPN".