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),SelectionStrategyCatalogeRoundClientSelectormontam o plano de participação.ExternalParticipantRoundTriggerdispara 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.ClientArtifactIngestorrecebe e grava bytes de artefatos enviados pelos clientes via MQTT.MqttClientUpdateCollector.awaitUpdates(...)aguarda entregas até quórum/deadline;ClientUpdateResolververifica e resolve os artefatos referenciados.AggregationResultPublisherpersiste artefatos do resultado, registra evidências e publicaGlobalModelPublication+GlobalModelPayload.RemoteAggregatorClientinvoca agregadores externos via HTTP (POST /aggregate) eTwinValidationDecisionIngestorrecebe decisões do gêmeo digital.- Nota:
RoundFlowPublisherexiste no módulo como helper, mas a publicação atual continua diretamente viaMqttGatewaydentro 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:
Ver orquestrador e regras compartilhadas.
Documentação relacionada¶
- Guia do componente: 04-orchestrator.md
- Inventário do workspace: docs/modules.md