federated-digital-twin-broker¶
Papel¶
Executa, dentro do participante, a fronteira entre o broker federado externo e os componentes do gêmeo digital local. O runtime mantém o broker embutido em loopback e encaminha apenas mensagens validadas.
Componentes e protocolos¶
EmbeddedTwinBroker/EmbeddedTwinBrokerConfigdelegam paraEmbeddedRestSseBrokeriniciando o broker HTTP+SSE interno limitado ao loopback (127.0.0.1).DigitalTwinBridgetransfere envelopes entre o gateway externo e o broker interno.EnvelopeBoundaryGuardverifica assinatura e integridade do payload na fronteira.DigitalTwinClientCommandAdapterconduz RoundConfig/finalização aoFederatedClientService.DigitalTwinValidatorAdaptervalida publicação do modelo candidato e emite decisão.RestSseGateway/EmbeddedRestSseBrokerservem apenas ao salto HTTP+SSE interno deste microbroker.
O protocolo federado cliente-servidor continua MQTT 5; REST+SSE interno não é o transporte de rodada. O ReferenceMetricHoldoutEvaluator é um avaliador placeholder que devolve métrica pré-calculada, não executa inferência real.
Interfaces e fluxo¶
Entrada: envelopes federados recebidos pelo gateway externo. Saída: comandos para o cliente local, artefatos/dados do gêmeo e TwinValidationDecisionMessage encaminhada para fora. Modelos globais são candidatos; promoção depende da validação local.
O composition root LocalDigitalTwinRuntime compõe este módulo com federated-client, federated-containers, federated-common e serviço de artefatos.
Build e teste¶
Maven/JDK 25:
Veja broker do gêmeo local e histórico REST+SSE.
Documentação relacionada¶
- Guia do componente: 17-local-digital-twin-broker.md
- Inventário do workspace: docs/modules.md