# sidsahoo1203/bharatassist architecture

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

## Overview

BharatAssist helps citizens explore schemes, assess eligibility, ask questions by voice, visualize comparisons, and prepare application forms. The main user journey runs from onboarding/profile input through scheme matching to results and follow-on scheme, voice, visual, or PDF-form tools. The backend also moderates voice responses with trained safety and language models. The repository includes a separate ML development package for preparing data, training and evaluating classifiers. Frontend route-to-engine and frontend-to-backend wiring is not established by the excerpts, so those links are omitted.

Main entry points: [`ml/src/bharatassist/config.py`](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/config.py) (ML configuration), [`ml/src/bharatassist/exceptions.py`](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/exceptions.py) (ML exceptions), [`ml/src/bharatassist/models.py`](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/models.py) (Text classifiers), [`ml/src/bharatassist/scraper.py`](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/scraper.py) (Scheme scraper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_citizen_ui["Citizen experience"]
  node_onboard["Profile onboarding<br/>[page.tsx]"]
  node_eligibility_ui["Eligibility dashboard<br/>[page.tsx]"]
  node_scheme_browser["Scheme browser<br/>[page.tsx]"]
  node_voice_ui["Voice assistant<br/>[page.tsx]"]
  node_visual_ui["Visual comparisons<br/>[page.tsx]"]
  node_form_ui["Form preparation<br/>[page.tsx]"]
  node_demo_compare["Demo comparisons<br/>[page.tsx]"]
end

subgraph group_scheme_api["Scheme services"]
  node_elig_engine["Eligibility engine"]
  node_scheme_catalog["Scheme catalogue<br/>[schemes.ts]"]
  node_api["FastAPI services<br/>[main.py]"]
  node_scheme_data[("Scheme records<br/>[schemes.json]")]
end

subgraph group_voice_safety["Voice and safety"]
  node_guard["Safety guard<br/>[safety_guard.py]"]
end

subgraph group_ml_work["ML development"]
  node_model["Text classifiers<br/>[models.py]"]
  node_cleaner["Text preprocessing<br/>[preprocessing.py]"]
  node_domain_data["Scheme safety examples<br/>[domain_data.py]"]
  node_deep_models["Deep models<br/>[deep.py]"]
  node_evaluation["Model evaluation<br/>[evaluation.py]"]
  node_data_loader["Dataset loading<br/>[data_loader.py]"]
  node_ml_config["ML configuration<br/>[config.py]"]
  node_ml_errors["ML exceptions<br/>[exceptions.py]"]
  node_ml_logger["ML logging<br/>[logger.py]"]
  node_scraper["Scheme scraper<br/>[scraper.py]"]
end

node_citizen(("Citizen"))

node_citizen -->|"provides profile"| node_onboard
node_citizen -->|"asks by voice"| node_voice_ui
node_citizen -->|"browses schemes"| node_scheme_browser
node_citizen -->|"views charts"| node_visual_ui
node_citizen -->|"prepares form"| node_form_ui
node_elig_engine -->|"reads catalogue"| node_scheme_catalog
node_api -->|"checks messages"| node_guard
node_guard -->|"loads and scores"| node_model
node_guard -->|"cleans text"| node_cleaner
node_ml_config -->|"referenced by"| node_ml_errors
node_data_loader -->|"uses paths"| node_ml_config
node_data_loader -->|"raises errors"| node_ml_errors
node_cleaner -->|"uses mappings"| node_ml_config
node_cleaner -->|"raises errors"| node_ml_errors
node_model -->|"uses settings"| node_ml_config
node_model -->|"uses exceptions"| node_ml_errors
node_deep_models -->|"extends classifiers"| node_model
node_domain_data -->|"uses paths"| node_ml_config
node_scraper -->|"uses paths"| node_ml_config
node_scraper -->|"uses exceptions"| node_ml_errors
node_scraper -->|"uses logging"| node_ml_logger

click node_onboard "https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/onboard/page.tsx"
click node_eligibility_ui "https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/dashboard/page.tsx"
click node_scheme_browser "https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/schemes/page.tsx"
click node_voice_ui "https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/voice/page.tsx"
click node_visual_ui "https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/visual/page.tsx"
click node_form_ui "https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/form/page.tsx"
click node_demo_compare "https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/demo-comparisons/page.tsx"
click node_elig_engine "https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/lib/eligibilityEngine.ts"
click node_scheme_catalog "https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/lib/schemes.ts"
click node_api "https://github.com/sidsahoo1203/bharatassist/blob/main/backend/main.py"
click node_scheme_data "https://github.com/sidsahoo1203/bharatassist/blob/main/backend/data/schemes.json"
click node_guard "https://github.com/sidsahoo1203/bharatassist/blob/main/backend/safety_guard.py"
click node_model "https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/models.py"
click node_cleaner "https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/preprocessing.py"
click node_domain_data "https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/domain_data.py"
click node_deep_models "https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/deep.py"
click node_evaluation "https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/evaluation.py"
click node_data_loader "https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/data_loader.py"
click node_ml_config "https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/config.py"
click node_ml_errors "https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/exceptions.py"
click node_ml_logger "https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/logger.py"
click node_scraper "https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/scraper.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_onboard,node_eligibility_ui,node_scheme_browser,node_voice_ui,node_visual_ui,node_form_ui,node_demo_compare toneBlue
class node_elig_engine,node_scheme_catalog,node_api,node_scheme_data toneAmber
class node_guard toneMint
class node_model,node_cleaner,node_domain_data,node_deep_models,node_evaluation,node_data_loader,node_ml_config,node_ml_errors,node_ml_logger,node_scraper toneRose
class node_citizen toneIndigo
```

## Components

### Citizen experience

- [Profile onboarding](https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/onboard/page.tsx): `frontend/src/app/onboard/page.tsx`
- [Eligibility dashboard](https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/dashboard/page.tsx): `frontend/src/app/dashboard/page.tsx`
- [Scheme browser](https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/schemes/page.tsx): `frontend/src/app/schemes/page.tsx`
- [Voice assistant](https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/voice/page.tsx): `frontend/src/app/voice/page.tsx`
- [Visual comparisons](https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/visual/page.tsx): `frontend/src/app/visual/page.tsx`
- [Form preparation](https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/form/page.tsx): `frontend/src/app/form/page.tsx`
- [Demo comparisons](https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/app/demo-comparisons/page.tsx): `frontend/src/app/demo-comparisons/page.tsx`

### Scheme services

- [Eligibility engine](https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/lib/eligibilityEngine.ts): `frontend/src/lib/eligibilityEngine.ts`
- [Scheme catalogue](https://github.com/sidsahoo1203/bharatassist/blob/main/frontend/src/lib/schemes.ts): `frontend/src/lib/schemes.ts`
- [FastAPI services](https://github.com/sidsahoo1203/bharatassist/blob/main/backend/main.py): `backend/main.py`
- [Scheme records](https://github.com/sidsahoo1203/bharatassist/blob/main/backend/data/schemes.json): `backend/data/schemes.json`

### Voice and safety

- [Safety guard](https://github.com/sidsahoo1203/bharatassist/blob/main/backend/safety_guard.py): `backend/safety_guard.py`

### ML development

- [Text classifiers](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/models.py): `ml/src/bharatassist/models.py`
- [Text preprocessing](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/preprocessing.py): `ml/src/bharatassist/preprocessing.py`
- [Scheme safety examples](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/domain_data.py): `ml/src/bharatassist/domain_data.py`
- [Deep models](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/deep.py): `ml/src/bharatassist/deep.py`
- [Model evaluation](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/evaluation.py): `ml/src/bharatassist/evaluation.py`
- [Dataset loading](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/data_loader.py): `ml/src/bharatassist/data_loader.py`
- [ML configuration](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/config.py): `ml/src/bharatassist/config.py`
- [ML exceptions](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/exceptions.py): `ml/src/bharatassist/exceptions.py`
- [ML logging](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/logger.py): `ml/src/bharatassist/logger.py`
- [Scheme scraper](https://github.com/sidsahoo1203/bharatassist/blob/main/ml/src/bharatassist/scraper.py): `ml/src/bharatassist/scraper.py`

### Other components

- **Citizen**

## Connections

- Citizen → Profile onboarding: provides profile (evidence: `README.md`)
- Citizen → Voice assistant: asks by voice (evidence: `README.md`)
- Citizen → Scheme browser: browses schemes (evidence: `README.md`)
- Citizen → Visual comparisons: views charts (evidence: `README.md`)
- Citizen → Form preparation: prepares form (evidence: `README.md`)
- Eligibility engine → Scheme catalogue: reads catalogue (evidence: `frontend/src/lib/eligibilityEngine.ts`)
- FastAPI services → Safety guard: checks messages (evidence: `backend/main.py`)
- Safety guard → Text classifiers: loads and scores (evidence: `backend/safety_guard.py`)
- Safety guard → Text preprocessing: cleans text (evidence: `backend/safety_guard.py`)
- ML configuration → ML exceptions: referenced by (evidence: `ml/src/bharatassist/data_loader.py`)
- Dataset loading → ML configuration: uses paths (evidence: `ml/src/bharatassist/data_loader.py`)
- Dataset loading → ML exceptions: raises errors (evidence: `ml/src/bharatassist/data_loader.py`)
- Text preprocessing → ML configuration: uses mappings (evidence: `ml/src/bharatassist/preprocessing.py`)
- Text preprocessing → ML exceptions: raises errors (evidence: `ml/src/bharatassist/preprocessing.py`)
- Text classifiers → ML configuration: uses settings (evidence: `ml/src/bharatassist/models.py`)
- Text classifiers → ML exceptions: uses exceptions (evidence: `ml/src/bharatassist/models.py`)
- Deep models → Text classifiers: extends classifiers (evidence: `ml/src/bharatassist/deep.py`)
- Scheme safety examples → ML configuration: uses paths (evidence: `ml/src/bharatassist/domain_data.py`)
- Scheme scraper → ML configuration: uses paths (evidence: `ml/src/bharatassist/scraper.py`)
- Scheme scraper → ML exceptions: uses exceptions (evidence: `ml/src/bharatassist/scraper.py`)
- Scheme scraper → ML logging: uses logging (evidence: `ml/src/bharatassist/scraper.py`)
