Ir para o conteúdo

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, MqttTopics e IotTopics: 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 com SHA256SUMS e proteção contra Zip Slip/Zip Bomb (PackageZipSupport).
  • DockerMqttEnvironment e ClientSenderScope para propagação de configuração MQTT/TLS/SIGNING_* em contêineres e isolamento de senderId.
  • 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:

mvn -pl modules/federated-common -am test

Veja inventário e build do workspace e regras de arquitetura.

Documentação relacionada