federated-common¶
Papel¶
Biblioteca de contratos compartilhados da plataforma. Ela define os tipos que atravessam fronteiras entre processos e os utilitários usados para serializar, assinar e verificar esses tipos. Não implementa conexão de rede, API HTTP nem lógica de treinamento.
O que fornece¶
- Modelos de domínio para contrato, consentimento, participante, rodada, update, modelo global e resultados.
MqttEnvelope,MqttGateway,MqttTopicseIotTopics: envelope e contratos de tópicos, sem transporte concreto.- Assinaturas HMAC/X.509 (
HmacSignatureService,X509SignatureService,X509SignatureServiceLoader,CompositeSignatureService), hashes SHA-256 (Hashing),VectorCodec,JsonCodec, erros tipados (ErrorCode/FederatedException) e leitura/escrita determinística de ZIP comSHA256SUMSe proteção contra Zip Slip/Zip Bomb (PackageZipSupport). DockerMqttEnvironmenteClientSenderScopepara propagação de configuração MQTT/TLS/SIGNING_*em contêineres e isolamento desenderId.EvidenceProducing, usado para produzir representações determinísticas nos payloads assinados.
Interfaces e fluxo¶
Entrada: objetos de domínio e payloads tipados criados pelo cliente, coordenador ou simulador. Saída: bytes JSON e envelopes assinados/verificáveis consumidos pelos gateways e demais módulos. O emissor usa MqttEnvelope.signed(...); o receptor valida assinatura e integridade do payload antes de agir.
Os módulos Android, cliente, orquestrador, transporte, agregador, API, simulador e testes dependem destes contratos para evitar modelos wire duplicados. O gateway MQTT real está em federated-containers, não aqui.
Build e teste¶
Módulo Maven de biblioteca, compilado dentro do reactor com JDK 25. A partir da raiz HDT-AF:
Veja inventário e build do workspace e regras de arquitetura.
Documentação relacionada¶
- Guia do componente: 05-mqtt.md
- Inventário do workspace: docs/modules.md