Pular para conteúdo

As-Is

Documentos de arquitetura da situação atual — como o ADMS e seu ecossistema funcionam hoje. Diferente dos artefatos de síntese por sessão/Ata (que ficam em 030-artefatos/, um por domínio ou sessão), os documentos aqui são consolidações: cruzam múltiplos artefatos e as matrizes de riscos/achados num único desenho por domínio, sem duplicar diagrama já publicado. Ver o "Aviso metodológico" de cada documento para o grau de maturidade dos achados citados — nenhum destes documentos passou pela validação de Fase 3 do plano de trabalho.

Os arquivos vivem soltos nesta pasta (sem subpasta por tipo) — o tipo do documento é indicado pelo prefixo do nome do arquivo: hld-as-is-*, e futuramente lld-as-is-* e recomendacoes-as-is-*.

Diagrama 1 — Visão de contexto do ecossistema (Level 1)

Os dois HLDs abaixo já trazem, cada um, um diagrama C4 Container (Level 2) — mostra o que roda dentro do ADMS e do Barramento, incluindo donos organizacionais e pods/componentes. Faltava um nível acima: uma visão só com os sistemas do ecossistema e como eles se relacionam, sem nenhum detalhe interno, para quem precisa entender "o que fala com o quê" antes de entrar em qualquer HLD específico — o público da validação de Fase 3 (Norberto, Rômulo, rodada técnica com as áreas), não só arquitetos.

Como o assessment cobre dois sistemas centrais (ADMS e Barramento), não um só, este diagrama é tecnicamente um System Landscape — a variante do C4 para quando mais de um sistema está em escopo — e não um Context clássico de sistema único. Segue a mesma convenção do resto deste ciclo: nenhuma sessão nova, só síntese do que os dois HLDs já documentam separadamente (hld-as-is-adms.md Diagrama 1, hld-as-is-barramento.md Diagrama 1) — e por isso deliberadamente sem as fronteiras organizacionais (equipes, terceirizadas) e sem componentes de infraestrutura (F5, LDAP, observabilidade, DR) que já aparecem nos dois Container diagrams — isso é detalhe de Level 2, repeti-lo aqui só adicionaria ruído ao que este diagrama precisa responder.

Visão de contexto do ecossistema ADMS + Barramento

Duas leituras que este nível de visão deixa mais claras do que os dois Container diagrams isoladamente conseguem: primeiro, GIS é a única integração do ecossistema que não passa pelo Barramento — é SFTP direto ao GIS Adapter, um ponto fora da curva que só fica óbvio quando se olha o ecossistema inteiro de uma vez. Segundo, o caminho duplo ADMS/RabbitMQ-MSGOT (R43) já aparece neste nível — não é um detalhe interno do WSROT, é uma bifurcação que existe na fronteira entre "Canais" e o resto do ecossistema, visível mesmo sem entrar no HLD do ADMS.

HLDs (High-Level Design)

Domínio HLD Origem
Barramento HLD As-Is — Barramento Confluent Kafka Consolidado · 09/08 · 2 diagramas
ADMS HLD As-Is — ADMS (núcleo, adapters e integrações diretas) Consolidado · 08/08 · 3 diagramas

LLDs (Low-Level Design)

Nenhum ainda. Reservado para desenhos detalhados por componente (ex.: modelo de dados do ksqlDB, contrato de payload por tópico) quando esse nível de detalhe for necessário — hoje o detalhe técnico vive em prosa dentro dos próprios HLDs e nos artefatos de origem.

Recomendações

Nenhuma ainda. Reservado para recomendações específicas de um domínio/HLD (ex.: recomendacoes-as-is-barramento.md), vinculadas diretamente aos riscos e achados que aquele HLD referencia. Isto complementa, e não substitui, a síntese de recomendações preliminares, que é o consolidado geral do assessment — quando uma recomendação por domínio existir aqui, ela deve ser mais específica e acionável do que a entrada correspondente no preliminar, não uma repetição dele.

Ver também

  • Artefatos Técnicos — os artefatos de sessão/Ata de onde estes documentos derivam.
  • To-Be — arquitetura alvo, ainda não iniciada (gated pela Fase 3).
  • Diagnóstico — matrizes de riscos e achados usadas como fonte.