# praveen0815/ai-based-government-scheme-eligibility-predictor architecture

> Architecture diagram of the GitHub repository praveen0815/ai-based-government-scheme-eligibility-predictor, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/praveen0815/ai-based-government-scheme-eligibility-predictor
- Repository: https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor

## Overview

Scheme Predictor is a citizen and administrator portal for maintaining a socio-economic wallet, exploring schemes, and preparing for applications. The main path is profile data into the hybrid documented-rule/Decision Tree evaluation, then explanations and recommendations; citizens can compare results and track readiness, documents, history, and application progress. FastAPI routes and services implement these capabilities over authenticated records, while a React client calls the API. README describes additional scanner, knowledge, assistant, reporting, and evaluation features; their exact call paths are not established by the excerpts, so those links are omitted.

Main entry points: [`backend/app/main.py`](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/main.py) (FastAPI app), [`frontend/src/App.tsx`](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/frontend/src/App.tsx) (Portal routes), [`backend/app/services/application_service.py`](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/application_service.py) (Application tracking), [`backend/app/services/notification_service.py`](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/notification_service.py) (Notifications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Citizen portal"]
  node_webapp["Portal routes<br/>[App.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_profile["Profile wallet<br/>[AccountPage.tsx]"]
  node_results["Eligibility results<br/>[ResultsPage.tsx]"]
  node_catalog_ui["Scheme discovery<br/>[SchemesPage.tsx]"]
  node_admin_ui["Admin portal"]
end

subgraph group_api["Backend API"]
  node_main["FastAPI app<br/>[main.py]"]
  node_auth["Authentication<br/>[auth_service.py]"]
  node_eval_route["Evaluation routes<br/>[evaluation.py]"]
  node_wallet_service["Wallet services<br/>[wallet_service.py]"]
end

subgraph group_eligibility["Eligibility and discovery"]
  node_rule_engine["Rule evaluation"]
  node_ml_rules["Documented conditions"]
  node_scheme_service["Scheme catalog<br/>[scheme_service.py]"]
  node_prediction["Hybrid prediction"]
  node_recommendations["Recommendations"]
  node_explanations["Result explanations"]
  node_comparison["Scheme comparison<br/>[compare_service.py]"]
end

subgraph group_preparation["Preparation tracking"]
  node_scanner["Document scanner"]
  node_knowledge["Scheme knowledge"]
  node_assistant["Scheme assistant"]
  node_history["Recommendation history<br/>[history_service.py]"]
  node_documents["Document checklist"]
  node_applications["Application tracking"]
  node_notifications["Notifications"]
  node_reports["PDF reports<br/>[report_service.py]"]
  node_readiness["Profile readiness"]
end

subgraph group_data["Persistence"]
  node_db_session["Database sessions<br/>[session.py]"]
  node_models["User data models<br/>[applications.py]"]
  node_database[("Application database")]
end

node_citizen(("Citizen"))

node_citizen -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_profile
node_webapp -->|"routes to"| node_results
node_webapp -->|"routes to"| node_catalog_ui
node_webapp -->|"routes to"| node_admin_ui
node_profile -.->|"requests"| node_api_client
node_results -.->|"requests"| node_api_client
node_catalog_ui -.->|"requests"| node_api_client
node_api_client -.->|"calls API"| node_main
node_main -->|"registers"| node_eval_route
node_main -->|"imports"| node_auth
node_eval_route -.->|"evaluates"| node_prediction
node_eval_route -.->|"reads profile"| node_wallet_service
node_rule_engine -->|"loads schemes"| node_scheme_service
node_rule_engine -->|"calls rules"| node_ml_rules
node_prediction -.->|"uses rules"| node_rule_engine
node_prediction -.->|"explains result"| node_explanations
node_recommendations -.->|"uses prediction"| node_prediction
node_main -->|"imports errors"| node_scanner
node_main -->|"imports errors"| node_knowledge
node_main -->|"imports errors"| node_history
node_main -->|"imports errors"| node_applications
node_main -->|"imports errors"| node_notifications
node_main -->|"registers"| node_reports
node_main -->|"registers"| node_comparison
node_applications -->|"resolves scheme"| node_scheme_service
node_applications -->|"persists rows"| node_models
node_applications -->|"uses session"| node_db_session
node_db_session -->|"connects"| node_database
node_models -.->|"maps records"| node_database
node_notifications -->|"reads history"| node_history
node_notifications -->|"reads readiness"| node_readiness
node_notifications -->|"reads checklist"| node_documents
node_assistant -.->|"fetches catalog"| node_scheme_service

click node_webapp "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/frontend/src/App.tsx"
click node_api_client "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/frontend/src/services/api.ts"
click node_profile "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/frontend/src/pages/AccountPage.tsx"
click node_results "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/frontend/src/pages/ResultsPage.tsx"
click node_catalog_ui "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/frontend/src/pages/SchemesPage.tsx"
click node_admin_ui "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/frontend/src/pages/AdminDashboardPage.tsx"
click node_main "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/main.py"
click node_auth "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/auth_service.py"
click node_eval_route "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/routes/evaluation.py"
click node_wallet_service "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/wallet_service.py"
click node_rule_engine "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/rule_engine_service.py"
click node_ml_rules "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/ml/src/eligibility_rules.py"
click node_scheme_service "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/scheme_service.py"
click node_prediction "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/hybrid_prediction_service.py"
click node_recommendations "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/recommendation_service.py"
click node_explanations "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/explanation_service.py"
click node_scanner "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/document_scanner_service.py"
click node_knowledge "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/scheme_knowledge_service.py"
click node_assistant "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/scheme_assistant_service.py"
click node_history "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/history_service.py"
click node_documents "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/document_checklist_service.py"
click node_applications "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/application_service.py"
click node_notifications "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/notification_service.py"
click node_reports "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/report_service.py"
click node_comparison "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/compare_service.py"
click node_readiness "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/readiness_service.py"
click node_db_session "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/db/session.py"
click node_models "https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/models/applications.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_webapp,node_api_client,node_profile,node_results,node_catalog_ui,node_admin_ui toneBlue
class node_main,node_auth,node_eval_route,node_wallet_service toneAmber
class node_rule_engine,node_ml_rules,node_scheme_service,node_prediction,node_recommendations,node_explanations,node_comparison toneMint
class node_scanner,node_knowledge,node_assistant,node_history,node_documents,node_applications,node_notifications,node_reports,node_readiness toneRose
class node_db_session,node_models,node_database,node_citizen toneIndigo
```

## Components

### Citizen portal

- [Portal routes](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API client](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Profile wallet](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/frontend/src/pages/AccountPage.tsx): `frontend/src/pages/AccountPage.tsx`
- [Eligibility results](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/frontend/src/pages/ResultsPage.tsx): `frontend/src/pages/ResultsPage.tsx`
- [Scheme discovery](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/frontend/src/pages/SchemesPage.tsx): `frontend/src/pages/SchemesPage.tsx`
- [Admin portal](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/frontend/src/pages/AdminDashboardPage.tsx): `frontend/src/pages/AdminDashboardPage.tsx`

### Backend API

- [FastAPI app](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/auth_service.py): `backend/app/services/auth_service.py`
- [Evaluation routes](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/routes/evaluation.py): `backend/app/routes/evaluation.py`
- [Wallet services](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/wallet_service.py): `backend/app/services/wallet_service.py`

### Eligibility and discovery

- [Rule evaluation](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/rule_engine_service.py): `backend/app/services/rule_engine_service.py`
- [Documented conditions](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/ml/src/eligibility_rules.py): `ml/src/eligibility_rules.py`
- [Scheme catalog](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/scheme_service.py): `backend/app/services/scheme_service.py`
- [Hybrid prediction](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/hybrid_prediction_service.py): `backend/app/services/hybrid_prediction_service.py`
- [Recommendations](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/recommendation_service.py): `backend/app/services/recommendation_service.py`
- [Result explanations](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/explanation_service.py): `backend/app/services/explanation_service.py`
- [Scheme comparison](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/compare_service.py): `backend/app/services/compare_service.py`

### Preparation tracking

- [Document scanner](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/document_scanner_service.py): `backend/app/services/document_scanner_service.py`
- [Scheme knowledge](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/scheme_knowledge_service.py): `backend/app/services/scheme_knowledge_service.py`
- [Scheme assistant](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/scheme_assistant_service.py): `backend/app/services/scheme_assistant_service.py`
- [Recommendation history](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/history_service.py): `backend/app/services/history_service.py`
- [Document checklist](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/document_checklist_service.py): `backend/app/services/document_checklist_service.py`
- [Application tracking](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/application_service.py): `backend/app/services/application_service.py`
- [Notifications](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/notification_service.py): `backend/app/services/notification_service.py`
- [PDF reports](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/report_service.py): `backend/app/services/report_service.py`
- [Profile readiness](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/services/readiness_service.py): `backend/app/services/readiness_service.py`

### Persistence

- [Database sessions](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/db/session.py): `backend/app/db/session.py`
- [User data models](https://github.com/praveen0815/ai-based-government-scheme-eligibility-predictor/blob/main/backend/app/models/applications.py): `backend/app/models/applications.py`
- **Application database**

### Other components

- **Citizen**

## Connections

- Citizen → Portal routes: uses (evidence: `frontend/src/App.tsx`)
- Portal routes → Profile wallet: routes to (evidence: `frontend/src/App.tsx`)
- Portal routes → Eligibility results: routes to (evidence: `frontend/src/App.tsx`)
- Portal routes → Scheme discovery: routes to (evidence: `frontend/src/App.tsx`)
- Portal routes → Admin portal: routes to (evidence: `frontend/src/App.tsx`)
- Profile wallet → API client: requests
- Eligibility results → API client: requests
- Scheme discovery → API client: requests
- API client → FastAPI app: calls API
- FastAPI app → Evaluation routes: registers (evidence: `backend/app/main.py`)
- FastAPI app → Authentication: imports (evidence: `backend/app/main.py`)
- Evaluation routes → Hybrid prediction: evaluates
- Evaluation routes → Wallet services: reads profile
- Rule evaluation → Scheme catalog: loads schemes (evidence: `backend/app/services/rule_engine_service.py`)
- Rule evaluation → Documented conditions: calls rules (evidence: `backend/app/services/rule_engine_service.py`)
- Hybrid prediction → Rule evaluation: uses rules
- Hybrid prediction → Result explanations: explains result
- Recommendations → Hybrid prediction: uses prediction
- FastAPI app → Document scanner: imports errors (evidence: `backend/app/main.py`)
- FastAPI app → Scheme knowledge: imports errors (evidence: `backend/app/main.py`)
- FastAPI app → Recommendation history: imports errors (evidence: `backend/app/main.py`)
- FastAPI app → Application tracking: imports errors (evidence: `backend/app/main.py`)
- FastAPI app → Notifications: imports errors (evidence: `backend/app/main.py`)
- FastAPI app → PDF reports: registers (evidence: `backend/app/main.py`)
- FastAPI app → Scheme comparison: registers (evidence: `backend/app/main.py`)
- Application tracking → Scheme catalog: resolves scheme (evidence: `backend/app/services/application_service.py`)
- Application tracking → User data models: persists rows (evidence: `backend/app/services/application_service.py`)
- Application tracking → Database sessions: uses session (evidence: `backend/app/services/application_service.py`)
- Database sessions → Application database: connects (evidence: `backend/app/db/session.py`)
- User data models → Application database: maps records
- Notifications → Recommendation history: reads history (evidence: `backend/app/services/notification_service.py`)
- Notifications → Profile readiness: reads readiness (evidence: `backend/app/services/notification_service.py`)
- Notifications → Document checklist: reads checklist (evidence: `backend/app/services/notification_service.py`)
- Scheme assistant → Scheme catalog: fetches catalog
