Revisão do inventário de módulos e documentação¶
Data: 2026-10-28
Escopo: estrutura de build do checkout, módulos ativos e coerência da documentação técnica.
Método e limite¶
O inventário foi comparado com pom.xml, diretórios com POM próprio, manifestos Gradle/npm, scripts e código de inicialização/configuração. A revisão foi documental e estática; não executou suíte de testes nem build do reator.
Inventário confirmado¶
O reator Maven da raiz exige Java 25 e declara 22 entradas: 15 módulos da plataforma, cinco experimentos e dois benchmarks. O experimento HAR é incorporado pelo build-helper e não possui POM independente. Além do reator, há um cliente Android Gradle (modules/federated-android-client), um frontend npm/Vite (modules/federated-admin-web) e o repositório independente de scripts (modules/scripts, exposto na raiz por symlink scripts).
Os diretórios de modules/ são repositórios Git separados, ignorados pelo Git raiz, e não submódulos registrados. Consequentemente, um clone somente do repositório raiz não recompõe o reator; falta um manifesto reproduzível de checkout dos módulos. Esse é o principal risco estrutural encontrado.
As responsabilidades anteriormente atribuídas a federated-client-packager, federated-simulation-packager e hdt-federated-interface-rest-client foram consolidadas em outros módulos. Esses nomes não correspondem a módulos ativos no reator atual.
Correções documentais realizadas¶
- Criado
docs/modules.mdcom módulos ativos, projetos de build separados, experimentos, diretórios residuais e caveat de clonagem. - Alinhados contexto e regras em
.agents/com Java 25, SQLite,federated-rest-api, transporte MQTT, TLS/mTLS e comportamento obrigatório do Fabric. - Corrigidos links para a pasta canônica
.agents/, privacidade e guias existentes. - Corrigidas orientações de execução/empacotamento, nomes de módulos, modo de ledger e documentação de Fabric, MQTT e
DataComponent. - Marcada a pasta de diagramas para conferir notas de atualidade; corrigidas referências Java 17 que indicavam versão atual.
- Reescritos chunks 001/002 do RAG para refletir o inventário e as regras atuais.
Pontos ainda pendentes ou históricos¶
docs/diagrams/02-sequence-diagrams.mdcontém fluxos históricos de CSV e descrições antigas de ledger; o próprio arquivo identifica partes desatualizadas. Recomenda-se redesenhar/remover esses diagramas em trabalho dedicado, sem tratá-los como comportamento vigente.docs/components/18-rest-sse-gateway.mdedocs/analysis/auditoria-estrutura-engenharia-software-2026-10-23.mdmantêm registro histórico de decisões e achados; não foram reescritos como documentação de estado atual.- Há referências quebradas legadas em
docs/hdt_persistencia/TESTES_PSICOLOGICOS.mdpara arquivos de uma árvore de aplicação ausente neste checkout. O conteúdo não foi inferido nem alterado. - A separação em muitos repositórios locais sob
modules/não é reproduzível por clone raiz. Recomenda-se criar um manifesto/automação de checkout ou avaliar submódulos, sem alterar a configuração Git solicitada.
Verificação¶
A inspeção confirmou Java local 17.0.19, enquanto o reator requer Java 25; o comando mvn não está disponível no PATH. Por isso não foi possível validar build, geração de diagramas ou testes automatizados. Foram feitas verificações textuais e revisão de links Markdown, descritas na conclusão da tarefa. Nenhum código de produção foi alterado.