# ratloopz/sahidawa-india architecture

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

- Interactive diagram: https://gitdiagram.com/ratloopz/sahidawa-india
- Repository: https://github.com/ratloopz/sahidawa-india

## Overview

SahiDawa is a citizen-facing medicine safety platform: users scan or submit medicine details, receive verification and safety guidance, and can report suspicious products; reports support district monitoring and alerts. Its web PWA, Node API, Python ML service, and ETL cover the documented scan/verify, voice triage, geospatial, regulatory-monitoring, and offline capabilities. Several API and ML feature routes are known from the tree and README, but their implementation was not sampled, so those links are shown as unverified rather than asserted calls.

Main entry points: [`apps/api/src/db/client.ts`](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/db/client.ts) (Supabase data), [`apps/api/src/app.ts`](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/app.ts) (API application), [`apps/web/app/[locale]/scan/page.tsx`](https://github.com/ratloopz/sahidawa-india/blob/main/apps/web/app/%5Blocale%5D/scan/page.tsx) (Web PWA), [`apps/api/src/routes/scan.ts`](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/routes/scan.ts) (Scan and verify)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Citizen PWA"]
  node_web["Web PWA<br/>[page.tsx]"]
  node_offline[("Offline support<br/>[offlineStorage.ts]")]
end

subgraph group_api["API Services"]
  node_scanapi["Scan and verify<br/>[scan.ts]"]
  node_apiapp["API application<br/>[app.ts]"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_admin["Admin operations"]
  node_reports["Incident reports<br/>[reports.ts]"]
  node_pharmacies["Pharmacy mapping<br/>[pharmacies.ts]"]
  node_voice["Voice workflows<br/>[page.tsx]"]
  node_alerts["Safety alerts<br/>[notifications.ts]"]
  node_district["District analytics<br/>[analytics.ts]"]
end

subgraph group_intelligence["ML Intelligence"]
  node_ml["ML service<br/>[main.py]"]
  node_triage["Medical triage<br/>[triage_graph.py]"]
  node_ocr["Image analysis<br/>[ocr_pipeline.py]"]
  node_rag["Medicine RAG"]
  node_llm["Safety profiles<br/>[llm.service.ts]"]
  node_agent["Recall agent"]
end

subgraph group_data["Data Network"]
  node_etl["Regulatory ingestion<br/>[run_all.py]"]
  node_cdsco["CDSCO registry<br/>[cdsco.py]"]
  node_loader["Data loader<br/>[supabase_loader.py]"]
  node_db[("Supabase data<br/>[client.ts]")]
  node_redis[("Redis cache<br/>[redis.ts]")]
end

node_citizen(("Patient"))

node_citizen -->|"uses"| node_web
node_web -.->|"submits scans"| node_scanapi
node_web -.->|"stores offline"| node_offline
node_apiapp -.->|"routes requests"| node_scanapi
node_scanapi -.->|"checks registry"| node_db
node_scanapi -.->|"requests analysis"| node_ml
node_web -->|"starts voice triage"| node_voice
node_voice -.->|"sends media"| node_ml
node_ml -->|"uses graph"| node_triage
node_ml -.->|"analyzes images"| node_ocr
node_apiapp -.->|"applies auth"| node_auth
node_apiapp -.->|"routes admin"| node_admin
node_reports -.->|"records reports"| node_db
node_admin -->|"updates records"| node_db
node_admin -->|"triggers recalls"| node_alerts
node_pharmacies -.->|"queries locations"| node_db
node_district -.->|"aggregates incidents"| node_db
node_etl -->|"scrapes notices"| node_cdsco
node_etl -->|"loads datasets"| node_loader
node_loader -.->|"writes records"| node_db
node_agent -.->|"monitors recalls"| node_cdsco
node_agent -.->|"dispatches notices"| node_alerts
node_apiapp -.->|"serves medicine RAG"| node_rag
node_rag -->|"reads medicine data"| node_db
node_rag -.->|"generates profile"| node_llm
node_apiapp -->|"uses cache"| node_redis
node_auth -->|"validates identity"| node_db
node_auth -->|"caches identity"| node_redis

click node_web "https://github.com/ratloopz/sahidawa-india/blob/main/apps/web/app/%5Blocale%5D/scan/page.tsx"
click node_offline "https://github.com/ratloopz/sahidawa-india/blob/main/apps/web/lib/offlineStorage.ts"
click node_scanapi "https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/routes/scan.ts"
click node_apiapp "https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/app.ts"
click node_auth "https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/middleware/auth.ts"
click node_admin "https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/controllers/admin.controller.ts"
click node_reports "https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/routes/reports.ts"
click node_pharmacies "https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/routes/pharmacies.ts"
click node_voice "https://github.com/ratloopz/sahidawa-india/blob/main/apps/web/app/%5Blocale%5D/voice/page.tsx"
click node_ml "https://github.com/ratloopz/sahidawa-india/blob/main/apps/ml/main.py"
click node_triage "https://github.com/ratloopz/sahidawa-india/blob/main/apps/ml/services/triage_graph.py"
click node_ocr "https://github.com/ratloopz/sahidawa-india/blob/main/apps/ml/services/ocr_pipeline.py"
click node_rag "https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/services/medicineRag.service.ts"
click node_llm "https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/services/llm.service.ts"
click node_etl "https://github.com/ratloopz/sahidawa-india/blob/main/apps/etl/run_all.py"
click node_cdsco "https://github.com/ratloopz/sahidawa-india/blob/main/apps/etl/src/scrapers/cdsco.py"
click node_loader "https://github.com/ratloopz/sahidawa-india/blob/main/apps/etl/src/loaders/supabase_loader.py"
click node_db "https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/db/client.ts"
click node_redis "https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/utils/redis.ts"
click node_alerts "https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/services/notifications.ts"
click node_district "https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/routes/analytics.ts"
click node_agent "https://github.com/ratloopz/sahidawa-india/blob/main/apps/ml/agent/cdsco_alert_agent.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_web,node_offline toneBlue
class node_scanapi,node_apiapp,node_auth,node_admin,node_reports,node_pharmacies,node_voice,node_alerts,node_district toneAmber
class node_ml,node_triage,node_ocr,node_rag,node_llm,node_agent toneMint
class node_etl,node_cdsco,node_loader,node_db,node_redis toneRose
class node_citizen toneIndigo
```

## Components

### Citizen PWA

- [Web PWA](https://github.com/ratloopz/sahidawa-india/blob/main/apps/web/app/%5Blocale%5D/scan/page.tsx): `apps/web/app/[locale]/scan/page.tsx`
- [Offline support](https://github.com/ratloopz/sahidawa-india/blob/main/apps/web/lib/offlineStorage.ts): `apps/web/lib/offlineStorage.ts`

### API Services

- [Scan and verify](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/routes/scan.ts): `apps/api/src/routes/scan.ts`
- [API application](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/app.ts): `apps/api/src/app.ts`
- [Authentication](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/middleware/auth.ts): `apps/api/src/middleware/auth.ts`
- [Admin operations](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/controllers/admin.controller.ts): `apps/api/src/controllers/admin.controller.ts`
- [Incident reports](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/routes/reports.ts): `apps/api/src/routes/reports.ts`
- [Pharmacy mapping](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/routes/pharmacies.ts): `apps/api/src/routes/pharmacies.ts`
- [Voice workflows](https://github.com/ratloopz/sahidawa-india/blob/main/apps/web/app/%5Blocale%5D/voice/page.tsx): `apps/web/app/[locale]/voice/page.tsx`
- [Safety alerts](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/services/notifications.ts): `apps/api/src/services/notifications.ts`
- [District analytics](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/routes/analytics.ts): `apps/api/src/routes/analytics.ts`

### ML Intelligence

- [ML service](https://github.com/ratloopz/sahidawa-india/blob/main/apps/ml/main.py): `apps/ml/main.py`
- [Medical triage](https://github.com/ratloopz/sahidawa-india/blob/main/apps/ml/services/triage_graph.py): `apps/ml/services/triage_graph.py`
- [Image analysis](https://github.com/ratloopz/sahidawa-india/blob/main/apps/ml/services/ocr_pipeline.py): `apps/ml/services/ocr_pipeline.py`
- [Medicine RAG](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/services/medicineRag.service.ts): `apps/api/src/services/medicineRag.service.ts`
- [Safety profiles](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/services/llm.service.ts): `apps/api/src/services/llm.service.ts`
- [Recall agent](https://github.com/ratloopz/sahidawa-india/blob/main/apps/ml/agent/cdsco_alert_agent.py): `apps/ml/agent/cdsco_alert_agent.py`

### Data Network

- [Regulatory ingestion](https://github.com/ratloopz/sahidawa-india/blob/main/apps/etl/run_all.py): `apps/etl/run_all.py`
- [CDSCO registry](https://github.com/ratloopz/sahidawa-india/blob/main/apps/etl/src/scrapers/cdsco.py): `apps/etl/src/scrapers/cdsco.py`
- [Data loader](https://github.com/ratloopz/sahidawa-india/blob/main/apps/etl/src/loaders/supabase_loader.py): `apps/etl/src/loaders/supabase_loader.py`
- [Supabase data](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/db/client.ts): `apps/api/src/db/client.ts`
- [Redis cache](https://github.com/ratloopz/sahidawa-india/blob/main/apps/api/src/utils/redis.ts): `apps/api/src/utils/redis.ts`

### Other components

- **Patient**

## Connections

- Patient → Web PWA: uses (evidence: `README.md`)
- Web PWA → Scan and verify: submits scans
- Web PWA → Offline support: stores offline
- API application → Scan and verify: routes requests (evidence: `apps/api/src/app.ts`)
- Scan and verify → Supabase data: checks registry (evidence: `README.md`)
- Scan and verify → ML service: requests analysis (evidence: `README.md`)
- Web PWA → Voice workflows: starts voice triage (evidence: `README.md`)
- Voice workflows → ML service: sends media (evidence: `README.md`)
- ML service → Medical triage: uses graph (evidence: `apps/ml/main.py`)
- ML service → Image analysis: analyzes images (evidence: `README.md`)
- API application → Authentication: applies auth (evidence: `apps/api/src/app.ts`)
- API application → Admin operations: routes admin (evidence: `apps/api/src/app.ts`)
- Incident reports → Supabase data: records reports (evidence: `README.md`)
- Admin operations → Supabase data: updates records (evidence: `apps/api/src/controllers/admin.controller.ts`)
- Admin operations → Safety alerts: triggers recalls (evidence: `apps/api/src/controllers/admin.controller.ts`)
- Pharmacy mapping → Supabase data: queries locations (evidence: `README.md`)
- District analytics → Supabase data: aggregates incidents (evidence: `apps/api/src/routes/analytics.ts`)
- Regulatory ingestion → CDSCO registry: scrapes notices (evidence: `apps/etl/run_all.py`)
- Regulatory ingestion → Data loader: loads datasets (evidence: `apps/etl/run_all.py`)
- Data loader → Supabase data: writes records
- Recall agent → CDSCO registry: monitors recalls (evidence: `README.md`)
- Recall agent → Safety alerts: dispatches notices (evidence: `README.md`)
- API application → Medicine RAG: serves medicine RAG (evidence: `README.md`)
- Medicine RAG → Supabase data: reads medicine data (evidence: `apps/api/src/services/medicineRag.service.ts`)
- Medicine RAG → Safety profiles: generates profile
- API application → Redis cache: uses cache (evidence: `apps/api/src/app.ts`)
- Authentication → Supabase data: validates identity (evidence: `apps/api/src/middleware/auth.ts`)
- Authentication → Redis cache: caches identity (evidence: `apps/api/src/middleware/auth.ts`)
