federated-aggregator¶
Papel¶
Calcula um modelo global e um AggregationReport a partir de updates locais já resolvidos. O fluxo arquitetural atual entrega esta operação ao orquestrador por chamada Java síncrona.
Estratégias e validações¶
O código contém FedAvg, mediana coordenada, trimmed mean, Krum/Multi-Krum e FedAdam/FedYogi. O serviço valida elegibilidade, assinatura quando configurada, duplicatas, dimensão, valores finitos, norma, limites de peso e quórum; falha de quórum é representada por AggregationQuorumException. Estratégias adaptativas podem receber o vetor global anterior.
Entrada preferida: lista de ClientUpdate com vetores já carregados, contrato, RoundConfig e opcionalmente modelo global anterior. Saída: vetor candidato e relatório com pesos, métricas e hashes para o chamador. A promoção final não cabe ao agregador.
Atenção: coexistem caminhos no código¶
A API com AggregationStrategy oferece cálculo sem I/O. Porém este checkout ainda mantém construtores/overloads legados de FedAvgAggregationService que recebem chaincode, serviço de artefatos e gateway MQTT, além de aggregateFromMessages(...) e uma classe MqttClientUpdateCollector no próprio módulo. Esses caminhos ainda leem/gravam artefatos, ledger ou MQTT. A arquitetura documentada após BL-244 atribui coleta, resolução e publicação ao federated-orchestrator; use o caminho puro para novas composições e trate a API com infraestrutura como compatibilidade legada até sua remoção.
Build e teste¶
Maven/JDK 25:
Veja agregador e orquestrador.
Documentação relacionada¶
- Guia do componente: 11-aggregator.md
- Inventário do workspace: docs/modules.md