# nithin2006-l/ai_pneumonia_detection architecture

> Architecture diagram of the GitHub repository nithin2006-l/ai_pneumonia_detection, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nithin2006-l/ai_pneumonia_detection
- Repository: https://github.com/nithin2006-l/ai_pneumonia_detection

## Overview

This is a Flask clinical-portal prototype for chest X-ray classification and report management. Users access role-specific portal views, submit scans for preprocessing and model inference, and receive a prediction with a Grad-CAM visualization; the application records reports and audit history in SQLite and flags repeat uploads. Separate capabilities include account and doctor administration, a clinical-assistant integration, and an optional training workflow. The main workflow is visible in the app and model excerpts; some portal and integration details are documented but not fully sampled.

Main entry points: [`app.py`](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py) (Portal routes), [`train.py`](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/train.py) (Training pipeline), [`model.py`](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/model.py) (Hybrid classifier), [`templates`](https://github.com/nithin2006-l/ai_pneumonia_detection/tree/main/templates) (Portal views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Clinical portal"]
  node_portal_app["Portal routes<br/>[app.py]"]
  node_portal_views["Portal views"]
  node_accounts["Accounts and roles<br/>[app.py]"]
  node_assistant["Clinical assistant<br/>[app.py]"]
end

subgraph group_analysis["Image analysis"]
  node_upload["Scan upload<br/>[app.py]"]
  node_duplicate_check["Repeat detection<br/>[app.py]"]
  node_preprocessing["CLAHE preprocessing<br/>[model.py]"]
  node_classifier["Hybrid classifier<br/>[model.py]"]
  node_explainability["Grad-CAM overlays<br/>[model.py]"]
end

subgraph group_records["Reports and records"]
  node_reports["Report management<br/>[app.py]"]
  node_sqlite[("Portal database")]
  node_audit["Audit history<br/>[app.py]"]
end

subgraph group_learning["Model training"]
  node_training["Training pipeline<br/>[train.py]"]
  node_training_data["Image dataset"]
  node_checkpoint["Model checkpoint"]
end

node_patient(("Patient"))
node_doctor(("Doctor"))
node_admin(("Administrator"))
node_gemini{{"Gemini service"}}

node_patient -->|"uses portal"| node_portal_app
node_doctor -->|"uses portal"| node_portal_app
node_admin -->|"uses portal"| node_portal_app
node_portal_app -->|"renders views"| node_portal_views
node_portal_app -->|"handles accounts"| node_accounts
node_portal_app -->|"accepts scans"| node_upload
node_upload -->|"checks hashes"| node_duplicate_check
node_upload -->|"enhances image"| node_preprocessing
node_upload -->|"runs inference"| node_classifier
node_upload -->|"generates overlay"| node_explainability
node_portal_app -->|"manages reports"| node_reports
node_reports -->|"stores reports"| node_sqlite
node_accounts -->|"stores profiles"| node_sqlite
node_audit -->|"stores history"| node_sqlite
node_portal_app -->|"records actions"| node_audit
node_portal_app -->|"serves assistant"| node_assistant
node_assistant -.->|"requests responses"| node_gemini
node_training -->|"loads images"| node_training_data
node_training -->|"trains model"| node_classifier
node_training -->|"saves weights"| node_checkpoint
node_portal_app -->|"loads weights"| node_checkpoint

click node_portal_app "https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py"
click node_portal_views "https://github.com/nithin2006-l/ai_pneumonia_detection/tree/main/templates"
click node_accounts "https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py"
click node_assistant "https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py"
click node_upload "https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py"
click node_duplicate_check "https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py"
click node_preprocessing "https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/model.py"
click node_classifier "https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/model.py"
click node_explainability "https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/model.py"
click node_reports "https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py"
click node_audit "https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py"
click node_training "https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/train.py"
click node_training_data "https://github.com/nithin2006-l/ai_pneumonia_detection/tree/main/sample%20data%20set"

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_portal_app,node_portal_views,node_accounts,node_assistant toneBlue
class node_upload,node_duplicate_check,node_preprocessing,node_classifier,node_explainability toneAmber
class node_reports,node_sqlite,node_audit toneMint
class node_training,node_training_data,node_checkpoint toneRose
class node_patient,node_doctor,node_admin,node_gemini toneIndigo
```

## Components

### Clinical portal

- [Portal routes](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py): `app.py`
- [Portal views](https://github.com/nithin2006-l/ai_pneumonia_detection/tree/main/templates): `templates`
- [Accounts and roles](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py): `app.py`
- [Clinical assistant](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py): `app.py`

### Image analysis

- [Scan upload](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py): `app.py`
- [Repeat detection](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py): `app.py`
- [CLAHE preprocessing](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/model.py): `model.py`
- [Hybrid classifier](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/model.py): `model.py`
- [Grad-CAM overlays](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/model.py): `model.py`

### Reports and records

- [Report management](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py): `app.py`
- **Portal database**
- [Audit history](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/app.py): `app.py`

### Model training

- [Training pipeline](https://github.com/nithin2006-l/ai_pneumonia_detection/blob/main/train.py): `train.py`
- [Image dataset](https://github.com/nithin2006-l/ai_pneumonia_detection/tree/main/sample%20data%20set): `sample data set`
- **Model checkpoint**

### Other components

- **Patient**
- **Doctor**
- **Administrator**
- **Gemini service**

## Connections

- Patient → Portal routes: uses portal (evidence: `README.md`)
- Doctor → Portal routes: uses portal (evidence: `README.md`)
- Administrator → Portal routes: uses portal (evidence: `README.md`)
- Portal routes → Portal views: renders views (evidence: `app.py`)
- Portal routes → Accounts and roles: handles accounts (evidence: `app.py`)
- Portal routes → Scan upload: accepts scans (evidence: `app.py`)
- Scan upload → Repeat detection: checks hashes (evidence: `README.md`)
- Scan upload → CLAHE preprocessing: enhances image (evidence: `app.py`)
- Scan upload → Hybrid classifier: runs inference (evidence: `app.py`)
- Scan upload → Grad-CAM overlays: generates overlay (evidence: `README.md`)
- Portal routes → Report management: manages reports (evidence: `app.py`)
- Report management → Portal database: stores reports (evidence: `app.py`)
- Accounts and roles → Portal database: stores profiles (evidence: `app.py`)
- Audit history → Portal database: stores history (evidence: `app.py`)
- Portal routes → Audit history: records actions (evidence: `README.md`)
- Portal routes → Clinical assistant: serves assistant (evidence: `app.py`)
- Clinical assistant → Gemini service: requests responses
- Training pipeline → Image dataset: loads images (evidence: `train.py`)
- Training pipeline → Hybrid classifier: trains model (evidence: `train.py`)
- Training pipeline → Model checkpoint: saves weights (evidence: `train.py`)
- Portal routes → Model checkpoint: loads weights (evidence: `README.md`)
