Ir para o conteúdo

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

sh scripts/run-admin-web.sh
mvn -pl modules/federated-rest-api -am test

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