# nada-ben-ali/covid19-detection-using-federated-learning architecture

> Architecture diagram of the GitHub repository nada-ben-ali/covid19-detection-using-federated-learning, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nada-ben-ali/covid19-detection-using-federated-learning
- Repository: https://github.com/nada-ben-ali/covid19-detection-using-federated-learning

## Overview

This repository combines a federated-learning COVID image classifier with a web interface for clients and training operators. The client workflow is: submit an image for prediction or respond to a training invitation; accepting an invitation starts client training. The operator workflow launches a federated session, whose server aggregates participant updates and evaluates the global model. The graph includes the sampled client API, model preparation and server strategy, plus major frontend and preprocessing modules indicated by the source index. Some backend and UI implementation details were not sampled, so uncertain links are omitted.

Main entry points: [`front_v2/src/App.js`](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/App.js) (Route application), [`client/main.py`](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/client/main.py) (Client API), [`server/server.py`](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/server/server.py) (Session orchestrator), [`server/FLstrategies.py`](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/server/FLstrategies.py) (Aggregation strategy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_app["Route application<br/>[App.js]"]
  node_signin["Sign in<br/>[Signin.js]"]
  node_signup["Sign up<br/>[Signup.js]"]
  node_navigation["Navigation<br/>[Navbar.js]"]
  node_clientui["Client workspace<br/>[Client.js]"]
  node_serverui["Server workspace<br/>[Server.js]"]
  node_notifications["Notification widget<br/>[notif.js]"]
end

subgraph group_client["Client services"]
  node_clientapi["Client API<br/>[main.py]"]
  node_clienttraining["Training participant<br/>[client.py]"]
end

subgraph group_federation["Federated training"]
  node_serverapi["Server API<br/>[server_api.py]"]
  node_serverrun["Session orchestrator<br/>[server.py]"]
  node_strategy["Aggregation strategy<br/>[FLstrategies.py]"]
end

subgraph group_data["Data and models"]
  node_clientmodel["Client model utilities"]
  node_servermodel["Server model utilities"]
  node_sessionweights[("Session weights")]
  node_trainingconfig["Training configuration"]
  node_datasetprep["Client data partitioning"]
end

node_user(("User"))
node_database[("MySQL database")]
node_flower["Flower runtime"]

node_user -->|"opens interface"| node_app
node_app -->|"routes to"| node_signin
node_app -->|"routes to"| node_signup
node_app -->|"routes to"| node_clientui
node_app -->|"routes to"| node_serverui
node_app -->|"renders"| node_navigation
node_clientui -->|"sends requests"| node_clientapi
node_clientapi -->|"loads model"| node_clientmodel
node_clientapi -->|"queries and updates"| node_database
node_clientapi -->|"starts on acceptance"| node_clienttraining
node_clienttraining -->|"imports utilities"| node_clientmodel
node_serverui -->|"requests session data"| node_serverapi
node_serverapi -->|"imports server"| node_serverrun
node_serverrun -->|"creates strategy"| node_strategy
node_serverrun -->|"starts server"| node_flower
node_strategy -->|"builds model"| node_servermodel
node_strategy -->|"saves aggregated weights"| node_sessionweights
node_serverrun -->|"reads session settings"| node_trainingconfig

click node_app "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/App.js"
click node_signin "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/pages/Signin.js"
click node_signup "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/pages/Signup.js"
click node_navigation "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/components/Navbar.js"
click node_clientui "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/pages/client/Client.js"
click node_serverui "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/pages/server/Server.js"
click node_notifications "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/components/notif.js"
click node_clientapi "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/client/main.py"
click node_clienttraining "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/client/client.py"
click node_clientmodel "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/client/preprocess_model.py"
click node_serverapi "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/server/server_api.py"
click node_serverrun "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/server/server.py"
click node_strategy "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/server/FLstrategies.py"
click node_servermodel "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/server/preprocess_model.py"
click node_sessionweights "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/tree/main/fl_sessions"
click node_trainingconfig "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/config_training.json"
click node_datasetprep "https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/Preprocess/split_data_clients.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_signin,node_signup,node_navigation,node_clientui,node_serverui,node_notifications,node_user toneBlue
class node_clientapi,node_clienttraining,node_database toneAmber
class node_serverapi,node_serverrun,node_strategy toneMint
class node_clientmodel,node_servermodel,node_sessionweights,node_trainingconfig,node_datasetprep toneRose
class node_flower toneIndigo
```

## Components

### Web interface

- [Route application](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/App.js): `front_v2/src/App.js`
- [Sign in](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/pages/Signin.js): `front_v2/src/pages/Signin.js`
- [Sign up](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/pages/Signup.js): `front_v2/src/pages/Signup.js`
- [Navigation](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/components/Navbar.js): `front_v2/src/components/Navbar.js`
- [Client workspace](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/pages/client/Client.js): `front_v2/src/pages/client/Client.js`
- [Server workspace](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/pages/server/Server.js): `front_v2/src/pages/server/Server.js`
- [Notification widget](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/front_v2/src/components/notif.js): `front_v2/src/components/notif.js`

### Client services

- [Client API](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/client/main.py): `client/main.py`
- [Training participant](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/client/client.py): `client/client.py`

### Federated training

- [Server API](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/server/server_api.py): `server/server_api.py`
- [Session orchestrator](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/server/server.py): `server/server.py`
- [Aggregation strategy](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/server/FLstrategies.py): `server/FLstrategies.py`

### Data and models

- [Client model utilities](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/client/preprocess_model.py): `client/preprocess_model.py`
- [Server model utilities](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/server/preprocess_model.py): `server/preprocess_model.py`
- [Session weights](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/tree/main/fl_sessions): `fl_sessions`
- [Training configuration](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/config_training.json): `config_training.json`
- [Client data partitioning](https://github.com/nada-ben-ali/covid19-detection-using-federated-learning/blob/main/Preprocess/split_data_clients.py): `Preprocess/split_data_clients.py`

### Other components

- **User**
- **MySQL database**
- **Flower runtime**

## Connections

- User → Route application: opens interface (evidence: `front_v2/src/App.js`)
- Route application → Sign in: routes to (evidence: `front_v2/src/App.js`)
- Route application → Sign up: routes to (evidence: `front_v2/src/App.js`)
- Route application → Client workspace: routes to (evidence: `front_v2/src/App.js`)
- Route application → Server workspace: routes to (evidence: `front_v2/src/App.js`)
- Route application → Navigation: renders (evidence: `front_v2/src/App.js`)
- Client workspace → Client API: sends requests (evidence: `front_v2/src/pages/client/Client.js`)
- Client API → Client model utilities: loads model (evidence: `client/main.py`)
- Client API → MySQL database: queries and updates (evidence: `client/main.py`)
- Client API → Training participant: starts on acceptance (evidence: `client/main.py`)
- Training participant → Client model utilities: imports utilities (evidence: `client/client.py`)
- Server workspace → Server API: requests session data (evidence: `front_v2/src/pages/server/Server.js`)
- Server API → Session orchestrator: imports server (evidence: `server/server_api.py`)
- Session orchestrator → Aggregation strategy: creates strategy (evidence: `server/server.py`)
- Session orchestrator → Flower runtime: starts server (evidence: `server/server.py`)
- Aggregation strategy → Server model utilities: builds model (evidence: `server/FLstrategies.py`)
- Aggregation strategy → Session weights: saves aggregated weights (evidence: `server/FLstrategies.py`)
- Session orchestrator → Training configuration: reads session settings (evidence: `server/server.py`)
