C1 — Diagrama de Contexto¶
Visão de mais alto nível do Hub de Integração Sorocabana no seu ecossistema. Mostra quem usa, com quais sistemas externos conversa e qual o papel de cada um. Não expõe estrutura interna do hub — isso é o C2.
Diagrama¶
Atores¶
| Ator | Papel | Interação principal |
|---|---|---|
| ARTESP | Órgão regulador estadual | Autentica no Plug e consulta dados consolidados |
| DER | Departamento de Estradas de Rodagem | Autentica no Plug e consulta dados consolidados |
Outros atores (Operador CCO Motiva, Engenharia, Equipes de campo, Time TPF) ainda não foram priorizados na modelagem atual e serão incluídos quando relevantes.
Sistema central — o Hub¶
Caixa única no diagrama. O hub é um processo independente on-prem (Linux Oracle Motiva) com persistência canônica própria. Internamente, é organizado em duas camadas (Staging + Projetores) orquestradas por um SINCRONIZADOR. Detalhamento dos containers no C2.
Requisições inbound ao hub são bloqueadas pela equipe de Cyber da Motiva — toda a comunicação parte do hub para fora (Pull) ou cruza a fronteira CLOUD↔ON-PREMISE via DMZ ou VPN.
Sistemas externos integrados¶
Lista do que está modelado nesta versão. Outras fontes existem no inventário do projeto e serão adicionadas conforme entrarem em escopo.
| Sistema | Papel | Zona |
|---|---|---|
| Kartado | Fonte (Pull-SaaS) — API REST | CLOUD |
| KAPSCH | Fonte (Pull-On-Prem) — API | ON-PREMISE |
| Ícaro | Fonte (Pull-On-Prem, hosting a confirmar — D5 do blueprint) | a confirmar |
| Plug | Papel duplo: fonte (telas de entrada existem só no Plug) e consumidor (lê Read Models específicos do hub) | CLOUD |
| ArcGIS | Papel duplo: fonte (inputs do pessoal de campo) e consumidor (lê Read Model geo) | ON-PREMISE |
Relacionamentos-chave¶
| Origem → Destino | Tipo |
|---|---|
| ARTESP / DER → Plug | Autenticação + consulta a Read Models |
| Kartado → Container Kartado (Staging do hub) | API pull/read |
| KAPSCH → Container KAPSCH (Staging do hub) | API pull/read |
| Ícaro → Container Ícaro (Staging do hub) | API pull/read |
| Plug (como fonte) → Container Plug (Staging do hub) | API pull/read |
| ArcGIS (como fonte) → Container ArcGIS (Staging do hub) | API pull/read |
| Hub → Plug (como consumidor) | Read Model dedicado (Projetor Plug → BANCO ARTESP → Plug) |
| Hub → ArcGIS (como consumidor) | Read Model geo dedicado (Projetor ArcGIS → BANCO ARTESP → ArcGIS) |
O que NÃO aparece neste C1¶
- Estrutura interna do hub (Staging, Projetores, SINCRONIZADOR, bancos) — ver C2
- Componentes individuais (Container KAPSCH, Projetor SGP, etc.) — ver C3 por integração
- Sistemas ainda não modelados nesta versão (Power BI, AutoDesk, KCOR, SAT, MITS, Portal Faixa de Domínio, Construtivo, Esteio-ETT, Detran)
- Trilha de auditoria interna do hub
- Lake / Delta Lake — fora do escopo desta fase