# vaibhav-nhayade/medinsight-ai architecture

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

## Overview

MedInsight AI accepts medical-report uploads, stores document metadata and files, parses report text into structured test results, classifies results against report-provided ranges, and returns findings and a summary. The backend API and document services connect upload and analysis to those AI stages. The README also describes RAG, historical comparison, patient questions, OCR, and safety/privacy capabilities, but the current tree does not show their implementations; the extraction pipeline shown supports PDF text extraction. Edges reflect sampled code, SOURCE INDEX references, or README statements; unsampled or planned features are not represented as implemented.

Main entry points: [`ai/analysis/orchestrator.py`](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/orchestrator.py) (Analysis orchestrator), [`backend/routes/reports.py`](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/routes/reports.py) (Report endpoints), [`backend/routes/analysis.py`](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/routes/analysis.py) (Analysis endpoint), [`backend/services/document_service.py`](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/services/document_service.py) (Document lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and workflow"]
  node_api["FastAPI application<br/>[main.py]"]
  node_report_routes["Report endpoints<br/>[reports.py]"]
  node_document_routes["Document endpoints<br/>[documents.py]"]
  node_analysis_routes["Analysis endpoint<br/>[analysis.py]"]
  node_report_schema["Report responses<br/>[report.py]"]
  node_report_service["Report analysis service<br/>[report_service.py]"]
end

subgraph group_documents["Document management"]
  node_file_storage["File storage<br/>[file_storage.py]"]
  node_document_service["Document lifecycle"]
  node_document_model["Document record<br/>[document.py]"]
  node_document_repository["Document repository"]
  node_sqlite[("SQLite database<br/>[connection.py]")]
end

subgraph group_extraction["Report extraction"]
  node_report_parser["Report parser<br/>[report_parser.py]"]
  node_document_pipeline["Document processing<br/>[pipeline.py]"]
  node_pdf_extractor["PDF text extraction<br/>[pdf.py]"]
  node_result_parser["Test result extraction<br/>[result_parser.py]"]
  node_parameter_extractor["Parameter extraction"]
  node_reference_extractor["Reference extraction"]
  node_extracted_schema["Extracted result model<br/>[schema.py]"]
end

subgraph group_analysis["Result analysis"]
  node_orchestrator["Analysis orchestrator<br/>[orchestrator.py]"]
  node_result_analysis["Range analysis<br/>[service.py]"]
  node_classification["Range classification<br/>[classification.py]"]
  node_analyzed_result["Analyzed result model<br/>[result.py]"]
  node_finding_service["Finding generation<br/>[finding_service.py]"]
  node_finding["Medical findings<br/>[finding.py]"]
  node_summary["Analysis summary<br/>[summary.py]"]
end

node_user(("Report user"))

node_user -->|"uploads report"| node_report_routes
node_api -->|"registers route"| node_report_routes
node_api -->|"registers route"| node_document_routes
node_api -->|"registers route"| node_analysis_routes
node_report_routes -->|"stores file"| node_file_storage
node_report_routes -->|"registers document"| node_document_service
node_report_routes -->|"returns response"| node_report_schema
node_document_routes -->|"manages document"| node_document_service
node_analysis_routes -->|"requests analysis"| node_report_service
node_analysis_routes -->|"checks document"| node_document_service
node_analysis_routes -->|"returns response"| node_report_schema
node_document_service -->|"persists metadata"| node_document_repository
node_document_repository -->|"reads and writes"| node_sqlite
node_document_repository -->|"maps records"| node_document_model
node_report_service -->|"runs analysis"| node_orchestrator
node_orchestrator -->|"parses report"| node_report_parser
node_orchestrator -->|"analyzes results"| node_result_analysis
node_orchestrator -->|"generates findings"| node_finding_service
node_orchestrator -->|"builds summary"| node_summary
node_report_parser -->|"processes document"| node_document_pipeline
node_report_parser -->|"parses results"| node_result_parser
node_document_pipeline -->|"extracts PDF text"| node_pdf_extractor
node_result_parser -->|"extracts parameters"| node_parameter_extractor
node_result_parser -->|"extracts ranges"| node_reference_extractor
node_parameter_extractor -->|"builds results"| node_extracted_schema
node_reference_extractor -->|"builds ranges"| node_extracted_schema
node_result_analysis -->|"classifies values"| node_classification
node_result_analysis -->|"builds results"| node_analyzed_result
node_finding_service -->|"creates findings"| node_finding

click node_api "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/main.py"
click node_report_routes "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/routes/reports.py"
click node_document_routes "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/routes/documents.py"
click node_analysis_routes "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/routes/analysis.py"
click node_report_schema "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/schemas/report.py"
click node_file_storage "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/services/file_storage.py"
click node_document_service "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/services/document_service.py"
click node_document_model "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/models/document.py"
click node_document_repository "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/repositories/document_repository.py"
click node_sqlite "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/database/connection.py"
click node_report_service "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/services/report_service.py"
click node_report_parser "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/report_parser.py"
click node_document_pipeline "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/pipeline.py"
click node_pdf_extractor "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/pdf.py"
click node_result_parser "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/result_parser.py"
click node_parameter_extractor "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/parameter_extractor.py"
click node_reference_extractor "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/reference_extractor.py"
click node_extracted_schema "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/schema.py"
click node_orchestrator "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/orchestrator.py"
click node_result_analysis "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/service.py"
click node_classification "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/classification.py"
click node_analyzed_result "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/result.py"
click node_finding_service "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/finding_service.py"
click node_finding "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/finding.py"
click node_summary "https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/summary.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_api,node_report_routes,node_document_routes,node_analysis_routes,node_report_schema,node_report_service,node_user toneBlue
class node_file_storage,node_document_service,node_document_model,node_document_repository,node_sqlite toneAmber
class node_report_parser,node_document_pipeline,node_pdf_extractor,node_result_parser,node_parameter_extractor,node_reference_extractor,node_extracted_schema toneMint
class node_orchestrator,node_result_analysis,node_classification,node_analyzed_result,node_finding_service,node_finding,node_summary toneRose
```

## Components

### API and workflow

- [FastAPI application](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/main.py): `backend/main.py`
- [Report endpoints](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/routes/reports.py): `backend/routes/reports.py`
- [Document endpoints](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/routes/documents.py): `backend/routes/documents.py`
- [Analysis endpoint](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/routes/analysis.py): `backend/routes/analysis.py`
- [Report responses](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/schemas/report.py): `backend/schemas/report.py`
- [Report analysis service](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/services/report_service.py): `backend/services/report_service.py`

### Document management

- [File storage](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/services/file_storage.py): `backend/services/file_storage.py`
- [Document lifecycle](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/services/document_service.py): `backend/services/document_service.py`
- [Document record](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/models/document.py): `backend/models/document.py`
- [Document repository](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/repositories/document_repository.py): `backend/repositories/document_repository.py`
- [SQLite database](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/backend/database/connection.py): `backend/database/connection.py`

### Report extraction

- [Report parser](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/report_parser.py): `ai/extraction/report_parser.py`
- [Document processing](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/pipeline.py): `ai/extraction/pipeline.py`
- [PDF text extraction](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/pdf.py): `ai/extraction/pdf.py`
- [Test result extraction](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/result_parser.py): `ai/extraction/result_parser.py`
- [Parameter extraction](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/parameter_extractor.py): `ai/extraction/parameter_extractor.py`
- [Reference extraction](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/reference_extractor.py): `ai/extraction/reference_extractor.py`
- [Extracted result model](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/extraction/schema.py): `ai/extraction/schema.py`

### Result analysis

- [Analysis orchestrator](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/orchestrator.py): `ai/analysis/orchestrator.py`
- [Range analysis](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/service.py): `ai/analysis/service.py`
- [Range classification](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/classification.py): `ai/analysis/classification.py`
- [Analyzed result model](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/result.py): `ai/analysis/result.py`
- [Finding generation](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/finding_service.py): `ai/analysis/finding_service.py`
- [Medical findings](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/finding.py): `ai/analysis/finding.py`
- [Analysis summary](https://github.com/vaibhav-nhayade/medinsight-ai/blob/main/ai/analysis/summary.py): `ai/analysis/summary.py`

### Other components

- **Report user**

## Connections

- Report user → Report endpoints: uploads report (evidence: `README.md`)
- FastAPI application → Report endpoints: registers route (evidence: `backend/main.py`)
- FastAPI application → Document endpoints: registers route (evidence: `backend/main.py`)
- FastAPI application → Analysis endpoint: registers route (evidence: `backend/main.py`)
- Report endpoints → File storage: stores file (evidence: `backend/routes/reports.py`)
- Report endpoints → Document lifecycle: registers document (evidence: `backend/routes/reports.py`)
- Report endpoints → Report responses: returns response (evidence: `backend/routes/reports.py`)
- Document endpoints → Document lifecycle: manages document (evidence: `backend/routes/documents.py`)
- Analysis endpoint → Report analysis service: requests analysis (evidence: `backend/routes/analysis.py`)
- Analysis endpoint → Document lifecycle: checks document (evidence: `backend/routes/analysis.py`)
- Analysis endpoint → Report responses: returns response (evidence: `backend/routes/analysis.py`)
- Document lifecycle → Document repository: persists metadata (evidence: `backend/services/document_service.py`)
- Document repository → SQLite database: reads and writes (evidence: `backend/repositories/document_repository.py`)
- Document repository → Document record: maps records (evidence: `backend/repositories/document_repository.py`)
- Report analysis service → Analysis orchestrator: runs analysis (evidence: `backend/services/report_service.py`)
- Analysis orchestrator → Report parser: parses report (evidence: `ai/analysis/orchestrator.py`)
- Analysis orchestrator → Range analysis: analyzes results (evidence: `ai/analysis/orchestrator.py`)
- Analysis orchestrator → Finding generation: generates findings (evidence: `ai/analysis/orchestrator.py`)
- Analysis orchestrator → Analysis summary: builds summary (evidence: `ai/analysis/orchestrator.py`)
- Report parser → Document processing: processes document (evidence: `ai/extraction/report_parser.py`)
- Report parser → Test result extraction: parses results (evidence: `ai/extraction/report_parser.py`)
- Document processing → PDF text extraction: extracts PDF text (evidence: `ai/extraction/pipeline.py`)
- Test result extraction → Parameter extraction: extracts parameters (evidence: `ai/extraction/result_parser.py`)
- Test result extraction → Reference extraction: extracts ranges (evidence: `ai/extraction/result_parser.py`)
- Parameter extraction → Extracted result model: builds results (evidence: `ai/extraction/parameter_extractor.py`)
- Reference extraction → Extracted result model: builds ranges (evidence: `ai/extraction/reference_extractor.py`)
- Range analysis → Range classification: classifies values (evidence: `ai/analysis/service.py`)
- Range analysis → Analyzed result model: builds results (evidence: `ai/analysis/service.py`)
- Finding generation → Medical findings: creates findings (evidence: `ai/analysis/finding_service.py`)
