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:
Consulte cliente federado e inventário.
Documentação relacionada¶
- Guia do componente: 06-federated-client.md
- Inventário do workspace: docs/modules.md