HDT-AF — Documentação Oficial¶
Bem-vindo à documentação oficial da plataforma HDT-AF (Human Digital Twin — Autonomous Federated Learning Framework), uma plataforma Java 25 de Aprendizado Federado consciente de privacidade para Gêmeos Digitais Humanos e Industriais.
O HDT-AF integra contratos de experimento, acesso local controlado aos dados (DataComponent), treinamento federado em JVM/Docker e Android (MDPL/CDDL), barramento MQTT 5 com TLS/mTLS, agregação federada e auditoria/governança imutável em Hyperledger Fabric.
Pilares Arquiteturais¶
-
Privacidade & LGPD por Construção
Dados brutos permanecem no cliente por padrão via
DataComponente SQLite local. Envelopes assinados (X.509/HMAC), pseudonimização declientIdon-chain, termos de consentimento versionados e Privacidade Diferencial configurável. -
Comunicação MQTT 5 Ponta a Ponta
Ingestão IoT/CDDL (
iot/emhub/) e protocolo de rodadas federadas (fl/) trafegam sobrePahoMqttGatewaycom TLS 1.3/mTLS na porta8883e envelopesMqttEnvelope<T>verificados criptograficamente. -
Governança Hyperledger Fabric
Modo único
BLOCKCHAINcom Fabric Gateway SDK Java: contratos (DRAFT → PUBLISHED → ACTIVE → CLOSED), consentimentos auditáveis, hashes de modelos/relatórios e registros on-chain via chaincode Java. -
Execução Multi-Runtime
Suporte a participantes em containers Docker isolados (JVM), cliente móvel Android com MDPL/CDDL/LiteRT e execução compatível com Apple Silicon (DJL / Java puro).
Navegação Rápida¶
-
Guias Práticos & Implantação
Compilação do reator Maven, execução local, criação de experimentos do zero, empacotamento e implantação em VM remota com Docker Compose + Fabric.
-
Arquitetura & Diagramas
Diagramas C4 (Contexto e Contêineres), componentes UML 2.5, fluxo de simulação MQTT + Docker, topologia multihoming em VM e slides executivos.
-
API REST & OpenAPI 3.1
Referência completa dos endpoints administrativos do monitor (
:8088) e das rotas client-facing chamadas pelos participantes HDT Docker e Android. -
Componentes & Módulos
Documentação detalhada dos 20 componentes arquiteturais e dos repositórios independentes que compõem o workspace HDT-AF.
Fluxo Resumido de Execução Local¶
# 1. Compilar os módulos Maven (requer JDK 25)
sh scripts/compile.sh
# 2. Executar suíte rápida de testes
sh scripts/run-tests.sh --fast
# 3. Subir o Monitor Web e API REST na porta 8088
sh scripts/run-admin-web.sh
Para detalhes sobre o ambiente em nuvem/VM (192.168.10.198), consulte o Guia de Implantação em VM. Para consultar as decisões arquiteturais e o estado das entregas recentes, veja Regras Compartilhadas e o Resumo do Backlog.