# sricharansairi/project-samanvaya architecture

> Architecture diagram of the GitHub repository sricharansairi/project-samanvaya, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sricharansairi/project-samanvaya
- Repository: https://github.com/sricharansairi/project-samanvaya

## Overview

Project Samanvaya is a healthcare access and clinical-support platform, with patient and hospital-facing workflows spanning intake, clinical assessment, document processing, decision support, and care-program tools. The README is empty, and most source excerpts are partial, so the graph includes major capabilities indicated by the tree while limiting internal call edges to wiring visible in sampled source.

Main entry points: [`backend/app/main.py`](https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/main.py) (Backend API), [`frontend/app/api/vision/ocr/route.ts`](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/vision/ocr/route.ts) (Prescription OCR), [`frontend/app/api/nlp/translate-clinical/route.ts`](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/nlp/translate-clinical/route.ts) (Clinical Translation), [`backend/app/services/rag_router.py`](https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/services/rag_router.py) (Guideline Search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Patient Access"]
  node_patient_portal["Patient Portal<br/>[page.tsx]"]
  node_his_portal["Hospital Portal<br/>[page.tsx]"]
end

subgraph group_encounter["Clinical Encounter"]
  node_registration["Registration Flow<br/>[Step2_Identify.tsx]"]
  node_consent["Consent Flow<br/>[Step3_Consent.tsx]"]
  node_triage["Symptom Triage<br/>[triage_service.py]"]
  node_voice_api["Voice Services<br/>[audio_service.py]"]
  node_document_ingest["Document Ingestion<br/>[route.ts]"]
  node_prescription_ocr["Prescription OCR<br/>[route.ts]"]
end

subgraph group_intelligence["Clinical Intelligence"]
  node_clinical_translation["Clinical Translation<br/>[route.ts]"]
  node_clinical_nlp["Clinical NLP<br/>[clinical_nlp.ts]"]
  node_clinical_rag["Medical RAG<br/>[medical_rag.ts]"]
  node_guideline_search["Guideline Search<br/>[rag_router.py]"]
  node_visual_rag["Visual RAG"]
  node_longitudinal["Longitudinal Analytics"]
  node_pharmacovigilance["Drug Safety Audit"]
end

subgraph group_programs["Care Programs"]
  node_antimicrobial["Antimicrobial Audit<br/>[route.ts]"]
  node_schemes["Scheme Eligibility<br/>[route.ts]"]
  node_ayush["AYUSH Assessment<br/>[ayush_engine.ts]"]
  node_mental_wellness["Tele-MANAS<br/>[route.ts]"]
  node_generic_medicines["Generic Savings"]
end

subgraph group_platform["Service Platform"]
  node_backend_api["Backend API<br/>[main.py]"]
  node_data_service[("Database Service<br/>[db.py]")]
end

node_patient(("Patient"))
node_staff(("Hospital Staff"))
node_supabase[("Supabase")]
node_ai_services{{"AI Providers"}}

node_patient -->|"uses"| node_patient_portal
node_staff -->|"uses"| node_his_portal
node_patient_portal -->|"starts intake"| node_registration
node_registration -->|"collects consent"| node_consent
node_backend_api -->|"calls"| node_triage
node_backend_api -->|"calls"| node_voice_api
node_backend_api -->|"supports ingestion"| node_document_ingest
node_clinical_translation -->|"translates with"| node_clinical_nlp
node_clinical_translation -.->|"requests inference"| node_ai_services
node_prescription_ocr -->|"queries"| node_clinical_rag
node_prescription_ocr -->|"analyzes savings"| node_generic_medicines
node_guideline_search -->|"queries"| node_data_service
node_data_service -->|"reads"| node_supabase
node_guideline_search -->|"embeds query"| node_ai_services
node_visual_rag -.->|"requests inference"| node_ai_services
node_antimicrobial -.->|"audits with"| node_ai_services
node_mental_wellness -.->|"evaluates with"| node_ai_services

click node_patient_portal "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/patient/page.tsx"
click node_his_portal "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/his/page.tsx"
click node_registration "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/components/Step2_Identify.tsx"
click node_consent "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/components/Step3_Consent.tsx"
click node_clinical_translation "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/nlp/translate-clinical/route.ts"
click node_clinical_nlp "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/services/clinical_nlp.ts"
click node_triage "https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/services/triage_service.py"
click node_voice_api "https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/services/audio_service.py"
click node_document_ingest "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/patient/ingest-document/route.ts"
click node_prescription_ocr "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/vision/ocr/route.ts"
click node_clinical_rag "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/services/medical_rag.ts"
click node_guideline_search "https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/services/rag_router.py"
click node_visual_rag "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/services/visual_rag_engine.ts"
click node_longitudinal "https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/services/longitudinal_clinical_engine.py"
click node_pharmacovigilance "https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/services/longitudinal_clinical_engine.py"
click node_antimicrobial "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/antimicrobial/audit/route.ts"
click node_schemes "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/schemes/evaluate/route.ts"
click node_ayush "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/services/ayush_engine.ts"
click node_mental_wellness "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/tele-manas/evaluate/route.ts"
click node_generic_medicines "https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/services/janaushadhi_engine.ts"
click node_backend_api "https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/main.py"
click node_data_service "https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/services/db.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_patient_portal,node_his_portal toneBlue
class node_registration,node_consent,node_triage,node_voice_api,node_document_ingest,node_prescription_ocr,node_supabase toneAmber
class node_clinical_translation,node_clinical_nlp,node_clinical_rag,node_guideline_search,node_visual_rag,node_longitudinal,node_pharmacovigilance toneMint
class node_antimicrobial,node_schemes,node_ayush,node_mental_wellness,node_generic_medicines toneRose
class node_backend_api,node_data_service,node_patient,node_staff,node_ai_services toneIndigo
```

## Components

### Patient Access

- [Patient Portal](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/patient/page.tsx): `frontend/app/patient/page.tsx`
- [Hospital Portal](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/his/page.tsx): `frontend/app/his/page.tsx`

### Clinical Encounter

- [Registration Flow](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/components/Step2_Identify.tsx): `frontend/components/Step2_Identify.tsx`
- [Consent Flow](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/components/Step3_Consent.tsx): `frontend/components/Step3_Consent.tsx`
- [Symptom Triage](https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/services/triage_service.py): `backend/app/services/triage_service.py`
- [Voice Services](https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/services/audio_service.py): `backend/app/services/audio_service.py`
- [Document Ingestion](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/patient/ingest-document/route.ts): `frontend/app/api/patient/ingest-document/route.ts`
- [Prescription OCR](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/vision/ocr/route.ts): `frontend/app/api/vision/ocr/route.ts`

### Clinical Intelligence

- [Clinical Translation](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/nlp/translate-clinical/route.ts): `frontend/app/api/nlp/translate-clinical/route.ts`
- [Clinical NLP](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/services/clinical_nlp.ts): `frontend/services/clinical_nlp.ts`
- [Medical RAG](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/services/medical_rag.ts): `frontend/services/medical_rag.ts`
- [Guideline Search](https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/services/rag_router.py): `backend/app/services/rag_router.py`
- [Visual RAG](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/services/visual_rag_engine.ts): `frontend/services/visual_rag_engine.ts`
- [Longitudinal Analytics](https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/services/longitudinal_clinical_engine.py): `backend/app/services/longitudinal_clinical_engine.py`
- [Drug Safety Audit](https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/services/longitudinal_clinical_engine.py): `backend/app/services/longitudinal_clinical_engine.py`

### Care Programs

- [Antimicrobial Audit](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/antimicrobial/audit/route.ts): `frontend/app/api/antimicrobial/audit/route.ts`
- [Scheme Eligibility](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/schemes/evaluate/route.ts): `frontend/app/api/schemes/evaluate/route.ts`
- [AYUSH Assessment](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/services/ayush_engine.ts): `frontend/services/ayush_engine.ts`
- [Tele-MANAS](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/app/api/tele-manas/evaluate/route.ts): `frontend/app/api/tele-manas/evaluate/route.ts`
- [Generic Savings](https://github.com/sricharansairi/project-samanvaya/blob/main/frontend/services/janaushadhi_engine.ts): `frontend/services/janaushadhi_engine.ts`

### Service Platform

- [Backend API](https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/main.py): `backend/app/main.py`
- [Database Service](https://github.com/sricharansairi/project-samanvaya/blob/main/backend/app/services/db.py): `backend/app/services/db.py`

### Other components

- **Patient**
- **Hospital Staff**
- **Supabase**
- **AI Providers**

## Connections

- Patient → Patient Portal: uses
- Hospital Staff → Hospital Portal: uses
- Patient Portal → Registration Flow: starts intake
- Registration Flow → Consent Flow: collects consent
- Backend API → Symptom Triage: calls
- Backend API → Voice Services: calls
- Backend API → Document Ingestion: supports ingestion
- Clinical Translation → Clinical NLP: translates with
- Clinical Translation → AI Providers: requests inference
- Prescription OCR → Medical RAG: queries
- Prescription OCR → Generic Savings: analyzes savings
- Guideline Search → Database Service: queries
- Database Service → Supabase: reads
- Guideline Search → AI Providers: embeds query
- Visual RAG → AI Providers: requests inference
- Antimicrobial Audit → AI Providers: audits with
- Tele-MANAS → AI Providers: evaluates with