Ir para o conteúdo

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 / EmbeddedTwinBrokerConfig delegam para EmbeddedRestSseBroker iniciando o broker HTTP+SSE interno limitado ao loopback (127.0.0.1).
  • DigitalTwinBridge transfere envelopes entre o gateway externo e o broker interno.
  • EnvelopeBoundaryGuard verifica assinatura e integridade do payload na fronteira.
  • DigitalTwinClientCommandAdapter conduz RoundConfig/finalização ao FederatedClientService.
  • DigitalTwinValidatorAdapter valida publicação do modelo candidato e emite decisão.
  • RestSseGateway/EmbeddedRestSseBroker servem 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:

mvn -pl modules/federated-digital-twin-broker -am test

Veja broker do gêmeo local e histórico REST+SSE.

Documentação relacionada