Ir para o conteúdo

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:

mvn -pl modules/federated-aggregator -am test

Veja agregador e orquestrador.

Documentação relacionada