Arquitetura — Hub de Integração Sorocabana (C4 Model)¶

Documentação da arquitetura do Hub de Integração Sorocabana (projeto Plug × Motiva, concessão Artesp), modelada em C4 Model. Audiência: time TPF.

Visão de 30 segundos¶

O hub é um processo independente on-prem (Linux Oracle Motiva) que serve como fonte da verdade integrada entre fontes operacionais e consumidores. Tem duas camadas internas — Staging (extractors por fornecedor, gravam dados as-is em BANCO STAGE) e Projetores (constroem Read Models por produto/consumidor em BANCO ARTESP) — orquestradas por um SINCRONIZADOR.

Plug e ArcGIS aparecem nos dois lados do hub (fontes e consumidores). ARTESP e DER são atores externos que acessam o Plug via autenticação.

Páginas¶

Nível	Página	O que mostra
C1 — Contexto	c1-contexto.md	Atores (ARTESP, DER), sistemas externos (Kartado, KAPSCH, Ícaro, Plug, ArcGIS) e o hub como caixa preta
C2 — Containers	c2-containers.md	Interior do hub: Staging, BANCO STAGE, SINCRONIZADOR, Projetores, BANCO ARTESP
C3 — Ícaro / SGP	c3-icaro-sgp.md	Container Staging Ícaro + Projetor SGP
C3 — ArcGIS (fluxo dual)	c3-arcgis.md	Fluxo dual do ArcGIS — fonte (inputs de campo) e consumidor (Read Model dedicado)
C3 — KAPSCH / SISFREFLOW	c3-kapsch-sisfreflow.md	Texto técnico; diagrama do Projetor SISFREFLOW pendente

Referências¶

Blueprint da solução (contexto, NFRs, decisões pendentes): produto/blueprint-solucao.md
Premissas históricas do kickoff: kickoff/CLAUDE.md e kickoff/resumo-premissas.md (algumas evoluíram — ver notas no topo desses arquivos)

O que ainda não está modelado¶

Sistemas e atores abaixo aparecem no projeto mas não estão na arquitetura desta versão — entram quando virarem prioridade:

Sistemas externos: Power BI, AutoDesk, KCOR, SAT, MITS, Portal Faixa de Domínio, Construtivo, Esteio-ETT, Detran
Atores internos Motiva: Operador CCO, Engenharia, Equipes de campo, Time TPF
Trilha de auditoria interna do hub
Projetor SISFREFLOW (consumiria SCHEMA KAPSCH em BANCO STAGE)