# arad108/diagnosense-ai architecture

> Architecture diagram of the GitHub repository arad108/diagnosense-ai, 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/arad108/diagnosense-ai
- Repository: https://github.com/arad108/diagnosense-ai

## Overview

Diagnosense AI is a Streamlit/FastAPI medical-report diagnosis application. Patients sign up or log in, upload reports for indexing, then ask questions about a report; doctors look up a patient’s stored diagnosis history. The graph preserves the upload/indexing, retrieval and generation, access-control, and history workflows, plus the documented patient/doctor dashboards. Relationships are limited to calls and data access visible in excerpts or README; the PDF loader is used in the upload implementation, while frontend-to-backend calls are explicit in the client.

Main entry points: [`client/app.py`](https://github.com/arad108/diagnosense-ai/blob/main/client/app.py) (Role dashboards), [`server/diagnosis/route.py`](https://github.com/arad108/diagnosense-ai/blob/main/server/diagnosis/route.py) (Diagnosis endpoints), [`server/auth/route.py`](https://github.com/arad108/diagnosense-ai/blob/main/server/auth/route.py) (Authentication routes), [`server/main.py`](https://github.com/arad108/diagnosense-ai/blob/main/server/main.py) (FastAPI application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_user_ui["User interface"]
  node_streamlit["Role dashboards<br/>[app.py]"]
  node_api["FastAPI application<br/>[main.py]"]
end

subgraph group_access["Identity and access"]
  node_auth_routes["Authentication routes<br/>[route.py]"]
  node_signup_model["Signup request<br/>[models.py]"]
  node_password_hash["Password hashing<br/>[hash_utils.py]"]
end

subgraph group_reports["Report ingestion"]
  node_upload_routes["Report upload<br/>[route.py]"]
  node_document_indexing["Document processing<br/>[vectorstore.py]"]
  node_pdf_files["Uploaded reports"]
  node_pinecone_index[("Vector index")]
end

subgraph group_diagnosis["Diagnosis and history"]
  node_diagnosis_routes["Diagnosis endpoints<br/>[route.py]"]
  node_retrieval_generation["Report retrieval and generation<br/>[query.py]"]
  node_history["Diagnosis history<br/>[route.py]"]
end

subgraph group_persistence["Persistence"]
  node_mongo[("MongoDB collections<br/>[db.py]")]
  node_db_models["Database models<br/>[db_models.py]"]
end

node_patient(("Patient"))
node_doctor(("Doctor"))

node_patient -->|"uses"| node_streamlit
node_doctor -->|"uses"| node_streamlit
node_streamlit -->|"calls API"| node_api
node_api -->|"registers"| node_auth_routes
node_api -->|"registers"| node_upload_routes
node_api -->|"registers"| node_diagnosis_routes
node_streamlit -->|"signs up, logs in"| node_auth_routes
node_auth_routes -->|"validates"| node_signup_model
node_auth_routes -->|"hashes passwords"| node_password_hash
node_auth_routes -->|"reads and writes"| node_mongo
node_streamlit -->|"uploads reports"| node_upload_routes
node_upload_routes -->|"processes files"| node_document_indexing
node_document_indexing -->|"saves files"| node_pdf_files
node_document_indexing -->|"embeds and upserts"| node_pinecone_index
node_document_indexing -->|"stores metadata"| node_mongo
node_streamlit -->|"asks diagnosis"| node_diagnosis_routes
node_diagnosis_routes -->|"authenticates"| node_auth_routes
node_diagnosis_routes -->|"checks report"| node_mongo
node_diagnosis_routes -->|"requests answer"| node_retrieval_generation
node_retrieval_generation -->|"searches chunks"| node_pinecone_index
node_diagnosis_routes -->|"persists answers"| node_history
node_history -->|"writes and queries"| node_mongo
node_streamlit -->|"requests history"| node_history
node_diagnosis_routes -.->|"model relationship unclear"| node_db_models

click node_streamlit "https://github.com/arad108/diagnosense-ai/blob/main/client/app.py"
click node_api "https://github.com/arad108/diagnosense-ai/blob/main/server/main.py"
click node_auth_routes "https://github.com/arad108/diagnosense-ai/blob/main/server/auth/route.py"
click node_signup_model "https://github.com/arad108/diagnosense-ai/blob/main/server/auth/models.py"
click node_password_hash "https://github.com/arad108/diagnosense-ai/blob/main/server/auth/hash_utils.py"
click node_upload_routes "https://github.com/arad108/diagnosense-ai/blob/main/server/reports/route.py"
click node_document_indexing "https://github.com/arad108/diagnosense-ai/blob/main/server/reports/vectorstore.py"
click node_pdf_files "https://github.com/arad108/diagnosense-ai/tree/main/uploaded_dir"
click node_diagnosis_routes "https://github.com/arad108/diagnosense-ai/blob/main/server/diagnosis/route.py"
click node_retrieval_generation "https://github.com/arad108/diagnosense-ai/blob/main/server/diagnosis/query.py"
click node_history "https://github.com/arad108/diagnosense-ai/blob/main/server/diagnosis/route.py"
click node_mongo "https://github.com/arad108/diagnosense-ai/blob/main/server/config/db.py"
click node_db_models "https://github.com/arad108/diagnosense-ai/blob/main/server/models/db_models.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_streamlit,node_api toneBlue
class node_auth_routes,node_signup_model,node_password_hash toneAmber
class node_upload_routes,node_document_indexing,node_pdf_files,node_pinecone_index toneMint
class node_diagnosis_routes,node_retrieval_generation,node_history toneRose
class node_mongo,node_db_models,node_patient,node_doctor toneIndigo
```

## Components

### User interface

- [Role dashboards](https://github.com/arad108/diagnosense-ai/blob/main/client/app.py): `client/app.py`
- [FastAPI application](https://github.com/arad108/diagnosense-ai/blob/main/server/main.py): `server/main.py`

### Identity and access

- [Authentication routes](https://github.com/arad108/diagnosense-ai/blob/main/server/auth/route.py): `server/auth/route.py`
- [Signup request](https://github.com/arad108/diagnosense-ai/blob/main/server/auth/models.py): `server/auth/models.py`
- [Password hashing](https://github.com/arad108/diagnosense-ai/blob/main/server/auth/hash_utils.py): `server/auth/hash_utils.py`

### Report ingestion

- [Report upload](https://github.com/arad108/diagnosense-ai/blob/main/server/reports/route.py): `server/reports/route.py`
- [Document processing](https://github.com/arad108/diagnosense-ai/blob/main/server/reports/vectorstore.py): `server/reports/vectorstore.py`
- [Uploaded reports](https://github.com/arad108/diagnosense-ai/tree/main/uploaded_dir): `uploaded_dir`
- **Vector index**

### Diagnosis and history

- [Diagnosis endpoints](https://github.com/arad108/diagnosense-ai/blob/main/server/diagnosis/route.py): `server/diagnosis/route.py`
- [Report retrieval and generation](https://github.com/arad108/diagnosense-ai/blob/main/server/diagnosis/query.py): `server/diagnosis/query.py`
- [Diagnosis history](https://github.com/arad108/diagnosense-ai/blob/main/server/diagnosis/route.py): `server/diagnosis/route.py`

### Persistence

- [MongoDB collections](https://github.com/arad108/diagnosense-ai/blob/main/server/config/db.py): `server/config/db.py`
- [Database models](https://github.com/arad108/diagnosense-ai/blob/main/server/models/db_models.py): `server/models/db_models.py`

### Other components

- **Patient**
- **Doctor**

## Connections

- Patient → Role dashboards: uses (evidence: `README.md`)
- Doctor → Role dashboards: uses (evidence: `README.md`)
- Role dashboards → FastAPI application: calls API (evidence: `client/app.py`)
- FastAPI application → Authentication routes: registers (evidence: `server/main.py`)
- FastAPI application → Report upload: registers (evidence: `server/main.py`)
- FastAPI application → Diagnosis endpoints: registers (evidence: `server/main.py`)
- Role dashboards → Authentication routes: signs up, logs in (evidence: `client/app.py`)
- Authentication routes → Signup request: validates (evidence: `server/auth/route.py`)
- Authentication routes → Password hashing: hashes passwords (evidence: `server/auth/route.py`)
- Authentication routes → MongoDB collections: reads and writes (evidence: `server/auth/route.py`)
- Role dashboards → Report upload: uploads reports (evidence: `client/app.py`)
- Report upload → Document processing: processes files (evidence: `server/reports/route.py`)
- Document processing → Uploaded reports: saves files (evidence: `server/reports/vectorstore.py`)
- Document processing → Vector index: embeds and upserts (evidence: `server/reports/vectorstore.py`)
- Document processing → MongoDB collections: stores metadata (evidence: `server/reports/vectorstore.py`)
- Role dashboards → Diagnosis endpoints: asks diagnosis (evidence: `client/app.py`)
- Diagnosis endpoints → Authentication routes: authenticates (evidence: `server/diagnosis/route.py`)
- Diagnosis endpoints → MongoDB collections: checks report (evidence: `server/diagnosis/route.py`)
- Diagnosis endpoints → Report retrieval and generation: requests answer (evidence: `server/diagnosis/route.py`)
- Report retrieval and generation → Vector index: searches chunks (evidence: `server/diagnosis/query.py`)
- Diagnosis endpoints → Diagnosis history: persists answers (evidence: `server/diagnosis/route.py`)
- Diagnosis history → MongoDB collections: writes and queries (evidence: `server/diagnosis/route.py`)
- Role dashboards → Diagnosis history: requests history (evidence: `client/app.py`)
- Diagnosis endpoints → Database models: model relationship unclear
