Assessment de Arquitetura de Integrações ADMS — Energisa (DSB26201)

Repositório de conteúdo do assessment. Tudo aqui é markdown (mais os ativos brutos que o markdown referencia: .vtt, .png, .puml, .pptx, .pdf). Este repositório é a fonte de conteúdo — apresentações e materiais de entrega ao cliente (pptx, docx, HTML consolidado) são responsabilidade do Vladimir e não vivem aqui; eles consomem o que está neste repositório.

Como navegar

Pasta	Conteúdo
010-evidencias/	As Atas de cada sessão de levantamento, uma por arquivo, convertidas do ODT consolidado para markdown. Numeração de 10 em 10 na ordem cronológica das sessões, com espaço para inserções (ex.: 105-sustentacao.md entre a sessão 100 e a 110).
020-transcricoes/	Transcrições brutas (.vtt, ou .pdf quando foi essa a fonte) de cada sessão, mesma numeração das evidências, para correlação direta.
030-artefatos/	Os documentos técnicos de arquitetura já produzidos — um por domínio/sessão — com diagramas embutidos e achados de fidelidade (comparação VTT × Ata). Inclui o glossário técnico consolidado.
040-diagramas/	SVGs renderizados dos diagramas PlantUML. Gerados automaticamente a partir dos blocos plantuml dos .md em CONTENT_DIRS (030-artefatos/, 095-as-is/, 100-to-be/ — lista no topo do script), renderiza via _tools/plantuml.jar e grava o SVG no caminho indicado pela referência de imagem que vem logo depois do bloco no mesmo arquivo. Um CONTENT_DIR novo precisa ser adicionado em dois lugares mantidos manualmente em sincronia: essa lista no script e os paths: de .github/workflows/render-diagrams.yml.
- Pareamento é posicional, não por proximidade. O N-ésimo bloco ```plantuml do arquivo casa com a N-ésima referência de imagem , na ordem em que aparecem — não necessariamente com a referência fisicamente mais próxima no texto. Ao criar ou editar um artefato com múltiplos diagramas, a contagem de blocos e de referências precisa bater no arquivo inteiro; um desalinhamento não gera erro visível, só grava o SVG errado no caminho errado.
- .github/workflows/render-diagrams.yml: em PR, roda em modo --check (falha o PR se algum diagrama não renderizar — não substitui a conferência visual humana de que o diagrama ficou correto, só garante que ele renderiza). Em push para main, renderiza de verdade e commita de volta qualquer SVG que mudou.
- Rodar localmente: python3 _tools/render_diagrams.py (ou --check para só validar), com PLANTUML_JAR=_tools/plantuml.jar no ambiente se necessário.

SVG em vez de PNG (2026-08-07): testamos renderizar inline no próprio build do MkDocs (via plugin plantuml_markdown), o que teria a vantagem de eliminar este pipeline inteiro. Descartado porque o Cloudflare Pages — quem builda e publica este site — só tem Java garantido no build image v1, que é desativado em 15/09/2026 (não aparece nas tabelas de v2 nem v3 da doc oficial). Por isso a renderização continua aqui, no GitHub Actions, que já tem Java configurado; o Cloudflare só serve os arquivos já prontos, como sempre fez.

Nota: os .puml avulsos que existiam em 040-diagramas/ foram removidos do controle de versão (só existiam como duplicata do bloco já embutido em cada artefato). Por uma limitação do ambiente em que este repositório foi criado, os arquivos físicos .puml não puderam ser apagados do disco — eles seguem no diretório, mas o .gitignore os ignora. Rode rm 040-diagramas/*.puml localmente quando puder para limpar o disco; isso não afeta o conteúdo do repositório.

Convenções

• Numeração de 10 em 10. Deixa espaço para inserir itens no meio sem renumerar tudo (ex.: a sessão de Sustentação, sem Ata formal, entrou como 105 entre as sessões 100 e 110).
• Sem número de versão no nome do arquivo. Versionamento é feito pelo histórico do git e por tags (ex. diagnostico-v0.1), registrado no CHANGELOG.md — não pelo nome do arquivo (o que existia nos HTMLs originais, com sufixos como v0.1 e V3).
• Duas sessões ainda sem Ata formal no Assessment Consolidado: Sustentação (24/07) e DR — ADMS e Sistemas Corporativos (03/08). Os arquivos correspondentes em 010-evidencias/ sinalizam isso explicitamente e apontam para o artefato técnico e a transcrição como fonte primária, em vez de simular uma Ata que não existe.
• Os dois HTMLs de diagnóstico e gestão de projeto foram descontinuados como fonte — o conteúdo agora vive em markdown puro em 080-diagnostico/ e 090-gestao-projeto/. Se for necessária uma versão navegável (abas, seções recolhíveis) para leitura no navegador, ela deve ser gerada a partir deste markdown, não mantida em paralelo.

Pendências conhecidas desta migração (03/08/2026)

• A matriz de achados/riscos em 080-diagnostico/ reflete a base de evidências de 28/07 (Atas 01–12). As sessões de Rede/Telecom (Ata 13), Engenharia de Dados (Ata 14) e DR ainda não foram incorporadas a essa síntese — sinalizado em nota dentro de cada arquivo.
• O plano de trabalho em 090-gestao-projeto/ reflete o planejamento de 25/07 (V3); os status de entrevistas foram atualizados pontualmente, mas fases 2–4 e cronograma não foram replanejados.
• Não foi verificado se as cobranças C2–C4 (acessos, centralização de artefatos, evidências técnicas mínimas) à Energisa foram efetivamente atendidas.
• Existem mais dois HTMLs na pasta raiz do projeto (Plano_Trabalho_Revisado_BottomUp_ADMS_DSB26201.html e Proposta_Macro_Acoes_3_Trilhas_ADMS.html) que não foram migrados nem avaliados — decisão pendente sobre se entram nesta estrutura.