Ir para o conteúdo

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.md com 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.md conté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.md e docs/analysis/auditoria-estrutura-engenharia-software-2026-10-23.md mantê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.md para 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.