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/	PNGs renderizados dos diagramas PlantUML. Gerados automaticamente a partir dos blocos plantuml de 030-artefatos/*.md, renderiza via _tools/plantuml.jar e grava o PNG no caminho indicado pela referência de imagem que vem logo depois do bloco no mesmo arquivo.
- 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 PNG 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 PNG 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.

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.