# akshayts968/federated-backend architecture

> Architecture diagram of the GitHub repository akshayts968/federated-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/akshayts968/federated-backend
- Repository: https://github.com/akshayts968/federated-backend

## Overview

This repository implements a federated brain-tumor image-classification system: hospital nodes train locally on private image data, while a central service coordinates model updates. The graph preserves the principal client/server training path and the distinct client and server implementations present in the repository. It also shows model definition, authentication and node authorization, and the audit-ledger capability visible in the excerpts. There is no README, and several server excerpts are incomplete, so relationships not directly supported by shown calls or imports are omitted.

Main entry points: [`server.py`](https://github.com/akshayts968/federated-backend/blob/main/server.py) (Federation server), [`model.py`](https://github.com/akshayts968/federated-backend/blob/main/model.py) (Brain tumor CNN), [`client.py`](https://github.com/akshayts968/federated-backend/blob/main/client.py) (Hospital client), [`clientt.py`](https://github.com/akshayts968/federated-backend/blob/main/clientt.py) (Training listener)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_central["Federation services"]
  node_central_server["Federation server<br/>[server.py]"]
  node_secure_server["Audited server<br/>[sd.py]"]
  node_prototype_server["Prototype server<br/>[s.py]"]
  node_audit_chain[("Audit ledger<br/>[sd.py]")]
  node_database_setup[("Cloud database setup<br/>[init_cloud_db.py]")]
  node_tamper_tool["Tamper utility<br/>[tamper.py]"]
end

subgraph group_hospital["Hospital clients"]
  node_client_main["Hospital client<br/>[client.py]"]
  node_client_fedprox["FedProx client<br/>[c2.py]"]
  node_client_flask["Training listener<br/>[clientt.py]"]
  node_client_listener_alt["Listener variant<br/>[clienttt.py]"]
  node_client_paillier["Encrypted client<br/>[c.py]"]
  node_hospital_a["Hospital A node<br/>[HosA.py]"]
  node_hospital_b["Hospital B node<br/>[HosB.py]"]
end

subgraph group_modeling["Model runtime"]
  node_brain_model["Brain tumor CNN<br/>[model.py]"]
end

node_admin(("Admin"))
node_hospital_actor(("Hospital operator"))

node_hospital_actor -.->|"registers and logs in"| node_central_server
node_admin -.->|"manages federation"| node_central_server
node_client_main -->|"checks in and fetches model"| node_central_server
node_client_main -->|"submits updates"| node_central_server
node_client_main -->|"instantiates"| node_brain_model
node_client_fedprox -->|"instantiates"| node_brain_model
node_client_flask -->|"instantiates"| node_brain_model
node_client_listener_alt -->|"instantiates"| node_brain_model
node_client_paillier -->|"instantiates"| node_brain_model
node_hospital_a -->|"instantiates"| node_brain_model
node_hospital_b -->|"instantiates"| node_brain_model
node_client_fedprox -->|"checks in"| node_central_server
node_client_flask -->|"checks in"| node_central_server
node_client_listener_alt -->|"checks in"| node_central_server
node_hospital_a -->|"verifies node"| node_central_server
node_hospital_b -->|"verifies node"| node_central_server
node_prototype_server -->|"dispatches training"| node_client_flask
node_prototype_server -->|"uses model"| node_brain_model
node_secure_server -->|"loads and validates"| node_audit_chain
node_secure_server -->|"uses model"| node_brain_model
node_central_server -.->|"uses model"| node_brain_model
node_database_setup -.->|"configures database"| node_central_server
node_tamper_tool -.->|"alters ledger"| node_audit_chain

click node_central_server "https://github.com/akshayts968/federated-backend/blob/main/server.py"
click node_secure_server "https://github.com/akshayts968/federated-backend/blob/main/sd.py"
click node_prototype_server "https://github.com/akshayts968/federated-backend/blob/main/s.py"
click node_audit_chain "https://github.com/akshayts968/federated-backend/blob/main/sd.py"
click node_client_main "https://github.com/akshayts968/federated-backend/blob/main/client.py"
click node_client_fedprox "https://github.com/akshayts968/federated-backend/blob/main/c2.py"
click node_client_flask "https://github.com/akshayts968/federated-backend/blob/main/clientt.py"
click node_client_listener_alt "https://github.com/akshayts968/federated-backend/blob/main/clienttt.py"
click node_client_paillier "https://github.com/akshayts968/federated-backend/blob/main/c.py"
click node_hospital_a "https://github.com/akshayts968/federated-backend/blob/main/HosA.py"
click node_hospital_b "https://github.com/akshayts968/federated-backend/blob/main/HosB.py"
click node_brain_model "https://github.com/akshayts968/federated-backend/blob/main/model.py"
click node_database_setup "https://github.com/akshayts968/federated-backend/blob/main/init_cloud_db.py"
click node_tamper_tool "https://github.com/akshayts968/federated-backend/blob/main/tamper.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_central_server,node_secure_server,node_prototype_server,node_audit_chain,node_database_setup,node_tamper_tool toneBlue
class node_client_main,node_client_fedprox,node_client_flask,node_client_listener_alt,node_client_paillier,node_hospital_a,node_hospital_b toneAmber
class node_brain_model toneMint
class node_admin,node_hospital_actor toneIndigo
```

## Components

### Federation services

- [Federation server](https://github.com/akshayts968/federated-backend/blob/main/server.py): `server.py`
- [Audited server](https://github.com/akshayts968/federated-backend/blob/main/sd.py): `sd.py`
- [Prototype server](https://github.com/akshayts968/federated-backend/blob/main/s.py): `s.py`
- [Audit ledger](https://github.com/akshayts968/federated-backend/blob/main/sd.py): `sd.py`
- [Cloud database setup](https://github.com/akshayts968/federated-backend/blob/main/init_cloud_db.py): `init_cloud_db.py`
- [Tamper utility](https://github.com/akshayts968/federated-backend/blob/main/tamper.py): `tamper.py`

### Hospital clients

- [Hospital client](https://github.com/akshayts968/federated-backend/blob/main/client.py): `client.py`
- [FedProx client](https://github.com/akshayts968/federated-backend/blob/main/c2.py): `c2.py`
- [Training listener](https://github.com/akshayts968/federated-backend/blob/main/clientt.py): `clientt.py`
- [Listener variant](https://github.com/akshayts968/federated-backend/blob/main/clienttt.py): `clienttt.py`
- [Encrypted client](https://github.com/akshayts968/federated-backend/blob/main/c.py): `c.py`
- [Hospital A node](https://github.com/akshayts968/federated-backend/blob/main/HosA.py): `HosA.py`
- [Hospital B node](https://github.com/akshayts968/federated-backend/blob/main/HosB.py): `HosB.py`

### Model runtime

- [Brain tumor CNN](https://github.com/akshayts968/federated-backend/blob/main/model.py): `model.py`

### Other components

- **Admin**
- **Hospital operator**

## Connections

- Hospital operator → Federation server: registers and logs in
- Admin → Federation server: manages federation
- Hospital client → Federation server: checks in and fetches model (evidence: `client.py`)
- Hospital client → Federation server: submits updates (evidence: `client.py`)
- Hospital client → Brain tumor CNN: instantiates (evidence: `client.py`)
- FedProx client → Brain tumor CNN: instantiates (evidence: `c2.py`)
- Training listener → Brain tumor CNN: instantiates (evidence: `clientt.py`)
- Listener variant → Brain tumor CNN: instantiates (evidence: `clienttt.py`)
- Encrypted client → Brain tumor CNN: instantiates (evidence: `c.py`)
- Hospital A node → Brain tumor CNN: instantiates (evidence: `HosA.py`)
- Hospital B node → Brain tumor CNN: instantiates (evidence: `HosB.py`)
- FedProx client → Federation server: checks in (evidence: `c2.py`)
- Training listener → Federation server: checks in (evidence: `clientt.py`)
- Listener variant → Federation server: checks in (evidence: `clienttt.py`)
- Hospital A node → Federation server: verifies node (evidence: `HosA.py`)
- Hospital B node → Federation server: verifies node (evidence: `HosB.py`)
- Prototype server → Training listener: dispatches training (evidence: `s.py`)
- Prototype server → Brain tumor CNN: uses model (evidence: `s.py`)
- Audited server → Audit ledger: loads and validates (evidence: `sd.py`)
- Audited server → Brain tumor CNN: uses model (evidence: `sd.py`)
- Federation server → Brain tumor CNN: uses model (evidence: `server.py`)
- Cloud database setup → Federation server: configures database
- Tamper utility → Audit ledger: alters ledger
