# swethau230-byte/multi-disease-prediction-system architecture

> Architecture diagram of the GitHub repository swethau230-byte/multi-disease-prediction-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/swethau230-byte/multi-disease-prediction-system
- Repository: https://github.com/swethau230-byte/multi-disease-prediction-system

## Overview

This Spring Boot application supports authenticated disease-risk screening, patient-linked prediction records, history, dashboard summaries, and PDF reports. Users register or log in to obtain a JWT, submit disease inputs, and receive a prediction saved for later review. The sampled implementation confirms external ML-service use for heart predictions and rule-based scoring for diabetes and liver; README-listed kidney and brain-tumor capabilities are not present in the sampled service excerpt. Other controller implementations and the static UI were not sampled, so only documented or evidenced relationships are shown.

Main entry points: [`src/main/java/com/miniproject/disease/service/CurrentUserService.java`](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/service/CurrentUserService.java) (Current user lookup), [`src/main/java/com/miniproject/disease/repository/PredictionRepository.java`](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/repository/PredictionRepository.java) (Prediction repository), [`src/main/java/com/miniproject/disease/service/PredictionService.java`](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/service/PredictionService.java) (Prediction scoring), [`src/main/java/com/miniproject/disease/controller/AuthController.java`](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/controller/AuthController.java) (Authentication API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Identity and access"]
  node_auth_api["Authentication API"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_jwt_filter["JWT filter"]
  node_security["Security config"]
  node_current_user["Current user lookup"]
  node_user_repo["User repository"]
  node_user_store[("User records<br/>[User.java]")]
end

subgraph group_screen["Risk screening"]
  node_prediction_api["Prediction API"]
  node_prediction_service["Prediction scoring"]
  node_ml_service["Python ML API"]
  node_kidney["Kidney screening"]
  node_brain["Brain tumor screening"]
end

subgraph group_records["Patient records"]
  node_patient_repo["Patient repository"]
  node_patient_store[("Patient records<br/>[Patient.java]")]
  node_prediction_repo["Prediction repository"]
  node_prediction_store[("Prediction records<br/>[Prediction.java]")]
  node_history_api["History API"]
end

subgraph group_insights["Insights and reports"]
  node_dashboard_api["Dashboard API"]
  node_dashboard_service["Dashboard summary"]
  node_report_api["Report API"]
  node_pdf_service["PDF generation"]
end

node_user(("Web user"))
node_database[("MySQL database")]

node_user -->|"registers or logs in"| node_auth_api
node_auth_api -->|"checks and saves"| node_user_repo
node_auth_api -->|"issues token"| node_jwt
node_security -->|"registers filter"| node_jwt_filter
node_jwt_filter -->|"validates token"| node_jwt
node_current_user -->|"looks up user"| node_user_repo
node_user_repo -->|"maps entity"| node_user_store
node_user_store -.->|"persists users"| node_database
node_user -->|"submits inputs"| node_prediction_api
node_prediction_api -->|"resolves identity"| node_current_user
node_prediction_api -->|"requests scoring"| node_prediction_service
node_prediction_service -->|"calls heart API"| node_ml_service
node_prediction_service -->|"saves patient"| node_patient_repo
node_prediction_service -->|"saves result"| node_prediction_repo
node_patient_repo -->|"maps entity"| node_patient_store
node_prediction_repo -->|"maps entity"| node_prediction_store
node_patient_store -.->|"persists patients"| node_database
node_prediction_store -.->|"persists predictions"| node_database
node_user -->|"views or deletes history"| node_history_api
node_history_api -->|"resolves identity"| node_current_user
node_history_api -->|"queries records"| node_prediction_repo
node_user -->|"requests summary"| node_dashboard_api
node_dashboard_api -->|"resolves identity"| node_current_user
node_dashboard_api -->|"requests summary"| node_dashboard_service
node_dashboard_service -->|"counts predictions"| node_prediction_repo
node_user -->|"requests PDF"| node_report_api
node_report_api -->|"resolves identity"| node_current_user
node_report_api -->|"requests report"| node_pdf_service
node_pdf_service -->|"loads user records"| node_prediction_repo
node_pdf_service -->|"formats fields"| node_prediction_store
node_user -.->|"screening capability"| node_kidney
node_user -.->|"screening capability"| node_brain

click node_auth_api "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/controller/AuthController.java"
click node_jwt "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/security/JwtService.java"
click node_jwt_filter "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/security/JwtAuthenticationFilter.java"
click node_security "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/config/SecurityConfig.java"
click node_current_user "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/service/CurrentUserService.java"
click node_user_repo "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/repository/UserRepository.java"
click node_user_store "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/entity/User.java"
click node_prediction_api "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/controller/PredictionController.java"
click node_prediction_service "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/service/PredictionService.java"
click node_patient_repo "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/repository/PatientRepository.java"
click node_patient_store "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/entity/Patient.java"
click node_prediction_repo "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/repository/PredictionRepository.java"
click node_prediction_store "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/entity/Prediction.java"
click node_history_api "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/controller/HistoryController.java"
click node_dashboard_api "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/controller/DashboardController.java"
click node_dashboard_service "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/service/DashboardService.java"
click node_report_api "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/controller/ReportController.java"
click node_pdf_service "https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/service/PdfReportService.java"
click node_kidney "https://github.com/swethau230-byte/multi-disease-prediction-system/tree/master/src/main/java/com/miniproject/disease/service"
click node_brain "https://github.com/swethau230-byte/multi-disease-prediction-system/tree/master/src/main/java/com/miniproject/disease/service"

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_auth_api,node_jwt,node_jwt_filter,node_security,node_current_user,node_user_repo,node_user_store,node_user toneBlue
class node_prediction_api,node_prediction_service,node_ml_service,node_kidney,node_brain,node_database toneAmber
class node_patient_repo,node_patient_store,node_prediction_repo,node_prediction_store,node_history_api toneMint
class node_dashboard_api,node_dashboard_service,node_report_api,node_pdf_service toneRose
```

## Components

### Identity and access

- [Authentication API](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/controller/AuthController.java): `src/main/java/com/miniproject/disease/controller/AuthController.java`
- [JWT service](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/security/JwtService.java): `src/main/java/com/miniproject/disease/security/JwtService.java`
- [JWT filter](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/security/JwtAuthenticationFilter.java): `src/main/java/com/miniproject/disease/security/JwtAuthenticationFilter.java`
- [Security config](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/config/SecurityConfig.java): `src/main/java/com/miniproject/disease/config/SecurityConfig.java`
- [Current user lookup](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/service/CurrentUserService.java): `src/main/java/com/miniproject/disease/service/CurrentUserService.java`
- [User repository](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/repository/UserRepository.java): `src/main/java/com/miniproject/disease/repository/UserRepository.java`
- [User records](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/entity/User.java): `src/main/java/com/miniproject/disease/entity/User.java`

### Risk screening

- [Prediction API](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/controller/PredictionController.java): `src/main/java/com/miniproject/disease/controller/PredictionController.java`
- [Prediction scoring](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/service/PredictionService.java): `src/main/java/com/miniproject/disease/service/PredictionService.java`
- **Python ML API**
- [Kidney screening](https://github.com/swethau230-byte/multi-disease-prediction-system/tree/master/src/main/java/com/miniproject/disease/service): `src/main/java/com/miniproject/disease/service`
- [Brain tumor screening](https://github.com/swethau230-byte/multi-disease-prediction-system/tree/master/src/main/java/com/miniproject/disease/service): `src/main/java/com/miniproject/disease/service`

### Patient records

- [Patient repository](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/repository/PatientRepository.java): `src/main/java/com/miniproject/disease/repository/PatientRepository.java`
- [Patient records](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/entity/Patient.java): `src/main/java/com/miniproject/disease/entity/Patient.java`
- [Prediction repository](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/repository/PredictionRepository.java): `src/main/java/com/miniproject/disease/repository/PredictionRepository.java`
- [Prediction records](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/entity/Prediction.java): `src/main/java/com/miniproject/disease/entity/Prediction.java`
- [History API](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/controller/HistoryController.java): `src/main/java/com/miniproject/disease/controller/HistoryController.java`

### Insights and reports

- [Dashboard API](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/controller/DashboardController.java): `src/main/java/com/miniproject/disease/controller/DashboardController.java`
- [Dashboard summary](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/service/DashboardService.java): `src/main/java/com/miniproject/disease/service/DashboardService.java`
- [Report API](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/controller/ReportController.java): `src/main/java/com/miniproject/disease/controller/ReportController.java`
- [PDF generation](https://github.com/swethau230-byte/multi-disease-prediction-system/blob/master/src/main/java/com/miniproject/disease/service/PdfReportService.java): `src/main/java/com/miniproject/disease/service/PdfReportService.java`

### Other components

- **Web user**
- **MySQL database**

## Connections

- Web user → Authentication API: registers or logs in (evidence: `README.md`)
- Authentication API → User repository: checks and saves (evidence: `src/main/java/com/miniproject/disease/controller/AuthController.java`)
- Authentication API → JWT service: issues token (evidence: `src/main/java/com/miniproject/disease/controller/AuthController.java`)
- Security config → JWT filter: registers filter (evidence: `src/main/java/com/miniproject/disease/config/SecurityConfig.java`)
- JWT filter → JWT service: validates token (evidence: `src/main/java/com/miniproject/disease/security/JwtAuthenticationFilter.java`)
- Current user lookup → User repository: looks up user (evidence: `src/main/java/com/miniproject/disease/service/CurrentUserService.java`)
- User repository → User records: maps entity (evidence: `src/main/java/com/miniproject/disease/repository/UserRepository.java`)
- User records → MySQL database: persists users (evidence: `README.md`)
- Web user → Prediction API: submits inputs (evidence: `README.md`)
- Prediction API → Current user lookup: resolves identity (evidence: `src/main/java/com/miniproject/disease/controller/PredictionController.java`)
- Prediction API → Prediction scoring: requests scoring (evidence: `src/main/java/com/miniproject/disease/controller/PredictionController.java`)
- Prediction scoring → Python ML API: calls heart API (evidence: `src/main/java/com/miniproject/disease/service/PredictionService.java`)
- Prediction scoring → Patient repository: saves patient (evidence: `src/main/java/com/miniproject/disease/service/PredictionService.java`)
- Prediction scoring → Prediction repository: saves result (evidence: `src/main/java/com/miniproject/disease/service/PredictionService.java`)
- Patient repository → Patient records: maps entity (evidence: `src/main/java/com/miniproject/disease/repository/PatientRepository.java`)
- Prediction repository → Prediction records: maps entity (evidence: `src/main/java/com/miniproject/disease/repository/PredictionRepository.java`)
- Patient records → MySQL database: persists patients (evidence: `README.md`)
- Prediction records → MySQL database: persists predictions (evidence: `README.md`)
- Web user → History API: views or deletes history (evidence: `README.md`)
- History API → Current user lookup: resolves identity (evidence: `src/main/java/com/miniproject/disease/controller/HistoryController.java`)
- History API → Prediction repository: queries records (evidence: `src/main/java/com/miniproject/disease/controller/HistoryController.java`)
- Web user → Dashboard API: requests summary (evidence: `README.md`)
- Dashboard API → Current user lookup: resolves identity (evidence: `src/main/java/com/miniproject/disease/controller/DashboardController.java`)
- Dashboard API → Dashboard summary: requests summary (evidence: `src/main/java/com/miniproject/disease/controller/DashboardController.java`)
- Dashboard summary → Prediction repository: counts predictions (evidence: `src/main/java/com/miniproject/disease/service/DashboardService.java`)
- Web user → Report API: requests PDF (evidence: `README.md`)
- Report API → Current user lookup: resolves identity (evidence: `src/main/java/com/miniproject/disease/controller/ReportController.java`)
- Report API → PDF generation: requests report (evidence: `src/main/java/com/miniproject/disease/controller/ReportController.java`)
- PDF generation → Prediction repository: loads user records (evidence: `src/main/java/com/miniproject/disease/service/PdfReportService.java`)
- PDF generation → Prediction records: formats fields (evidence: `src/main/java/com/miniproject/disease/service/PdfReportService.java`)
- Web user → Kidney screening: screening capability (evidence: `README.md`)
- Web user → Brain tumor screening: screening capability (evidence: `README.md`)
