federated-rest-api¶
Papel¶
Aplicação Java do lado servidor para administração e monitoramento. Também compõe Fabric, MQTT, sessões de experimentos, deploy de pacotes e execução de participantes.
Endpoints e serviços¶
AdminWebApp inicia AdminWebServer na porta 8088. O servidor oferece UI Java HTML, REST/JSON e OpenAPI; cobre contratos, consentimentos, rodadas, modelos, datasets, pacotes de experimento/cliente, simulações e estado do Fabric. O backend também inclui modo opcional de arquivo de mensagens MQTT no MongoDB quando configurado.
O frontend React de federated-admin-web é um workspace à parte: desenvolvimento usa Vite com proxy; o backend ainda renderiza o monitor padrão em Java HTML. O dist/ React pode ser servido como arquivo estático pelo fallback, mas a SPA não está ativa como roteamento principal no checkout atual.
Integração e fronteiras¶
Este é o composition root servidor: constrói Fabric Gateway/LedgerPort, clientes MQTT e os serviços client/orchestrator/aggregator/simulator. As mensagens de rodada seguem MQTT. Upload de pacote de experimento é executado em processo separado pelo runner; isso não garante isolamento de recursos nem autenticação no endpoint de upload.
Entrada: comandos REST e arquivos ZIP, eventos MQTT e configuração/credenciais Fabric. Saída: estado/telemetria JSON ou HTML, transações Fabric e eventos MQTT. Dados locais de treino permanecem no cliente por padrão.
Executar¶
A inicialização exige JDK 25 e configuração/credenciais Fabric válidas; o único modo de ledger suportado é BLOCKCHAIN. A especificação OpenAPI 3.1 está em src/main/resources/openapi-admin-monitor.yaml e é servida em /openapi.yaml e /swagger-ui/. Consulte também monitor e API, API client-facing e módulos.
Documentação relacionada¶
- Guia do componente: 01-admin-api-monitor-web.md
- Inventário do workspace: docs/modules.md