Ir para o conteúdo

federated-client

Papel

Biblioteca Java com o ciclo local de participação federada. Valida contrato, consentimento e runtime, obtém dados autorizados, executa o modelo no participante e prepara/publica resultados conforme o composition root.

Componentes

FederatedClientService executa a rodada e controla preflight/modelo/DP; ClientMlRuntimeSupport valida algoritmo/runtime; FederatedDockerClientExecutor orquestra contêineres Docker efêmeros com SQLite filtrado; FederatedMqttClientOrchestrator integra ingestão MQTT e gatilhos event-driven; os tipos em fedandroid.core (src/main/java) implementam consentimento, armazenamento de observações, RoundLifecycle e treinamento MDPL portável, enquanto src/android/java (br.ufma.lsdi.fedandroid.net) contém os adaptadores Android MDPL/DEX consumidos pelo :app.

ClientArtifactChannel abstrai artefatos: TwinArtifactChannel encaminha bytes pelo microbroker local do gêmeo digital; LocalDiskArtifactChannel usa armazenamento local no caminho Docker efêmero. Estes canais são caminhos diferentes e o README não deve tratá-los como um endpoint único.

Fluxo e fronteiras

Entrada: contrato ativo e consentido, configuração/finalização de rodada, runtime selecionado e visão de dados fornecida por DataComponent. Saída: ClientUpdateMessage assinado e artefatos/modelos pelos canais configurados. O cliente publica no tópico client-facing MQTT; o ClientUpdateRelay de federated-orchestrator encaminha ao agregador. Dados brutos ficam no lado participante.

O módulo é dependência da API e do app Android; o Gradle :core do Android compila fontes selecionados daqui. Não inclui APIs Android em seu build Maven.

Build e teste

Maven/JDK 25:

mvn -pl modules/federated-client -am test

Consulte cliente federado e inventário.

Documentação relacionada