Ir para o conteúdo

federated-orchestrator

Papel

Coordena rodadas no lado servidor. Define participantes e prazos, conduz o fluxo MQTT, encaminha updates e publica resultados após a agregação.

Operações

  • RoundCoordinator, estratégias (AllAcceptedClientsStrategy, RandomSampledClientsStrategy, RoundRobinStrategy), SelectionStrategyCatalog e RoundClientSelector montam o plano de participação.
  • ExternalParticipantRoundTrigger dispara rodadas assíncronas para participantes Docker externos.
  • ClientUpdateRelay é o único caminho entre tópicos client-facing e aggregator-facing e repassa o envelope assinado sem re-assiná-lo.
  • ClientArtifactIngestor recebe e grava bytes de artefatos enviados pelos clientes via MQTT.
  • MqttClientUpdateCollector.awaitUpdates(...) aguarda entregas até quórum/deadline; ClientUpdateResolver verifica e resolve os artefatos referenciados.
  • AggregationResultPublisher persiste artefatos do resultado, registra evidências e publica GlobalModelPublication + GlobalModelPayload.
  • RemoteAggregatorClient invoca agregadores externos via HTTP (POST /aggregate) e TwinValidationDecisionIngestor recebe decisões do gêmeo digital.
  • Nota: RoundFlowPublisher existe no módulo como helper, mas a publicação atual continua diretamente via MqttGateway dentro do coordenador/publisher.

Fluxo e interfaces

Entrada: contrato/estado dos clientes, mensagens de participação e updates recebidos no tópico client-facing. Saída: configurações de rodada, updates encaminhados, chamada Java ao federated-aggregator com ClientUpdate resolvidos e publicação de resultado/modelo. O módulo depende de common, chaincode, serviço de artefatos e agregador.

O federated-rest-api monta e inicia a composição. O orquestrador não deve permitir que o cliente publique diretamente no tópico do agregador.

Build e teste

Maven/JDK 25:

mvn -pl modules/federated-orchestrator -am test

Ver orquestrador e regras compartilhadas.

Documentação relacionada