# authorsauravkushwaha/feefix-india architecture

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

- Interactive diagram: https://gitdiagram.com/authorsauravkushwaha/feefix-india
- Repository: https://github.com/authorsauravkushwaha/feefix-india

## Overview

FeeFix India is a scholarship and fee-waiver decision platform. A student uses the web or Android client to submit a profile; the API coordinates eligibility evaluation, explainable ranking, and near-miss guidance, then returns actionable results for tracking and reminders. Separate capabilities include multilingual conversational matching, grounded AI search and Q&A, account security, and outcome-based ML ranking. The README documents several product flows; sampled source and the SOURCE INDEX support the implementation links shown. Some wiring is unsampled, so uncertain relationships are omitted.

Main entry points: [`backend/api/routes.py`](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/api/routes.py) (REST API), [`backend/services/matching.py`](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/matching.py) (Match orchestration), [`agents/reminder_scheduler.py`](https://github.com/authorsauravkushwaha/feefix-india/blob/main/agents/reminder_scheduler.py) (Reminder scheduler), [`web/frontend/app.js`](https://github.com/authorsauravkushwaha/feefix-india/blob/main/web/frontend/app.js) (Web experience)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Student clients"]
  node_web["Web experience<br/>[app.js]"]
  node_android["Android client<br/>[HomeScreen.kt]"]
end

subgraph group_matching["Discovery and matching"]
  node_api["REST API<br/>[routes.py]"]
  node_profile["Student profile<br/>[student.py]"]
  node_catalog["Scheme catalogue<br/>[dataset.py]"]
  node_scheme["Scheme model<br/>[scheme.py]"]
  node_eligibility["Eligibility engine<br/>[engine.py]"]
  node_rules["Eligibility rules<br/>[rules.py]"]
  node_matching_service["Match orchestration<br/>[matching.py]"]
  node_ranking["V1 ranking<br/>[ranker.py]"]
  node_coach["Gap coaching<br/>[coach.py]"]
  node_chat["Multilingual chat<br/>[chat.py]"]
end

subgraph group_engagement["Accounts and follow-up"]
  node_auth["Accounts and sessions<br/>[auth.py]"]
  node_rate_limit["Rate limiting<br/>[ratelimit.py]"]
  node_store[("SQLite store<br/>[sqlite_store.py]")]
  node_tracker["Application tracker<br/>[tracker.py]"]
  node_reminders["Reminder service<br/>[reminders.py]"]
  node_scheduler["Reminder scheduler"]
  node_notifications["Notifications<br/>[notifier.py]"]
end

subgraph group_intelligence["AI and learning"]
  node_qa["Grounded AI Q&amp;A<br/>[qa.py]"]
  node_search["Semantic search<br/>[search.py]"]
  node_ml["Outcome ranking<br/>[service.py]"]
  node_events["Outcome events<br/>[events.py]"]
end

node_student(("Student"))

node_student -->|"uses"| node_web
node_student -->|"uses"| node_android
node_web -->|"calls API"| node_api
node_android -->|"calls API"| node_api
node_api -->|"validates profile"| node_profile
node_api -->|"reads schemes"| node_catalog
node_catalog -->|"validates records"| node_scheme
node_api -->|"requests matches"| node_matching_service
node_matching_service -->|"evaluates profile"| node_eligibility
node_eligibility -->|"evaluates rules"| node_rules
node_matching_service -->|"ranks matches"| node_ranking
node_matching_service -->|"gets gap advice"| node_coach
node_api -->|"routes chat"| node_chat
node_chat -->|"requests matches"| node_matching_service
node_api -->|"handles accounts"| node_auth
node_api -->|"checks attempts"| node_rate_limit
node_auth -->|"reads and writes"| node_store
node_api -->|"updates status"| node_tracker
node_scheduler -->|"dispatches due"| node_reminders
node_scheduler -->|"sends notices"| node_notifications
node_api -->|"serves Q&amp;A"| node_qa
node_qa -->|"uses retrieval"| node_search
node_api -->|"requests preview"| node_ml
node_ml -->|"reads outcomes"| node_events
node_events -->|"persists events"| node_store

click node_web "https://github.com/authorsauravkushwaha/feefix-india/blob/main/web/frontend/app.js"
click node_android "https://github.com/authorsauravkushwaha/feefix-india/blob/main/mobile/android/ui/HomeScreen.kt"
click node_api "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/api/routes.py"
click node_profile "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/models/student.py"
click node_catalog "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/dataset.py"
click node_scheme "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/models/scheme.py"
click node_eligibility "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/matching_engine/engine.py"
click node_rules "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/matching_engine/rules.py"
click node_matching_service "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/matching.py"
click node_ranking "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/matching_engine/ranker.py"
click node_coach "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/coach.py"
click node_chat "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/chat.py"
click node_auth "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/auth.py"
click node_rate_limit "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/ratelimit.py"
click node_store "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/sqlite_store.py"
click node_tracker "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/tracker.py"
click node_reminders "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/reminders.py"
click node_scheduler "https://github.com/authorsauravkushwaha/feefix-india/blob/main/agents/reminder_scheduler.py"
click node_notifications "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/notifications/notifier.py"
click node_qa "https://github.com/authorsauravkushwaha/feefix-india/blob/main/ai/qa.py"
click node_search "https://github.com/authorsauravkushwaha/feefix-india/blob/main/ai/search.py"
click node_ml "https://github.com/authorsauravkushwaha/feefix-india/blob/main/ml/ranking/service.py"
click node_events "https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/events.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_android toneBlue
class node_api,node_profile,node_catalog,node_scheme,node_eligibility,node_rules,node_matching_service,node_ranking,node_coach,node_chat toneAmber
class node_auth,node_rate_limit,node_store,node_tracker,node_reminders,node_scheduler,node_notifications toneMint
class node_qa,node_search,node_ml,node_events toneRose
class node_student toneIndigo
```

## Components

### Student clients

- [Web experience](https://github.com/authorsauravkushwaha/feefix-india/blob/main/web/frontend/app.js): `web/frontend/app.js`
- [Android client](https://github.com/authorsauravkushwaha/feefix-india/blob/main/mobile/android/ui/HomeScreen.kt): `mobile/android/ui/HomeScreen.kt`

### Discovery and matching

- [REST API](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/api/routes.py): `backend/api/routes.py`
- [Student profile](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/models/student.py): `backend/models/student.py`
- [Scheme catalogue](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/dataset.py): `backend/services/dataset.py`
- [Scheme model](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/models/scheme.py): `backend/models/scheme.py`
- [Eligibility engine](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/matching_engine/engine.py): `backend/matching_engine/engine.py`
- [Eligibility rules](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/matching_engine/rules.py): `backend/matching_engine/rules.py`
- [Match orchestration](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/matching.py): `backend/services/matching.py`
- [V1 ranking](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/matching_engine/ranker.py): `backend/matching_engine/ranker.py`
- [Gap coaching](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/coach.py): `backend/services/coach.py`
- [Multilingual chat](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/chat.py): `backend/services/chat.py`

### Accounts and follow-up

- [Accounts and sessions](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/auth.py): `backend/services/auth.py`
- [Rate limiting](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/ratelimit.py): `backend/services/ratelimit.py`
- [SQLite store](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/sqlite_store.py): `backend/services/sqlite_store.py`
- [Application tracker](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/tracker.py): `backend/services/tracker.py`
- [Reminder service](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/reminders.py): `backend/services/reminders.py`
- [Reminder scheduler](https://github.com/authorsauravkushwaha/feefix-india/blob/main/agents/reminder_scheduler.py): `agents/reminder_scheduler.py`
- [Notifications](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/notifications/notifier.py): `backend/notifications/notifier.py`

### AI and learning

- [Grounded AI Q&A](https://github.com/authorsauravkushwaha/feefix-india/blob/main/ai/qa.py): `ai/qa.py`
- [Semantic search](https://github.com/authorsauravkushwaha/feefix-india/blob/main/ai/search.py): `ai/search.py`
- [Outcome ranking](https://github.com/authorsauravkushwaha/feefix-india/blob/main/ml/ranking/service.py): `ml/ranking/service.py`
- [Outcome events](https://github.com/authorsauravkushwaha/feefix-india/blob/main/backend/services/events.py): `backend/services/events.py`

### Other components

- **Student**

## Connections

- Student → Web experience: uses
- Student → Android client: uses
- Web experience → REST API: calls API
- Android client → REST API: calls API
- REST API → Student profile: validates profile (evidence: `backend/api/routes.py`)
- REST API → Scheme catalogue: reads schemes (evidence: `backend/api/routes.py`)
- Scheme catalogue → Scheme model: validates records (evidence: `backend/services/dataset.py`)
- REST API → Match orchestration: requests matches (evidence: `backend/api/routes.py`)
- Match orchestration → Eligibility engine: evaluates profile (evidence: `backend/services/matching.py`)
- Eligibility engine → Eligibility rules: evaluates rules (evidence: `backend/matching_engine/engine.py`)
- Match orchestration → V1 ranking: ranks matches (evidence: `backend/services/matching.py`)
- Match orchestration → Gap coaching: gets gap advice (evidence: `backend/services/matching.py`)
- REST API → Multilingual chat: routes chat (evidence: `backend/api/routes.py`)
- Multilingual chat → Match orchestration: requests matches (evidence: `backend/services/chat.py`)
- REST API → Accounts and sessions: handles accounts (evidence: `backend/api/routes.py`)
- REST API → Rate limiting: checks attempts (evidence: `backend/api/routes.py`)
- Accounts and sessions → SQLite store: reads and writes (evidence: `backend/services/auth.py`)
- REST API → Application tracker: updates status (evidence: `backend/api/routes.py`)
- Reminder scheduler → Reminder service: dispatches due (evidence: `agents/reminder_scheduler.py`)
- Reminder scheduler → Notifications: sends notices (evidence: `agents/reminder_scheduler.py`)
- REST API → Grounded AI Q&A: serves Q&A (evidence: `backend/main.py`)
- Grounded AI Q&A → Semantic search: uses retrieval (evidence: `ai/qa.py`)
- REST API → Outcome ranking: requests preview (evidence: `backend/api/routes.py`)
- Outcome ranking → Outcome events: reads outcomes (evidence: `ml/ranking/service.py`)
- Outcome events → SQLite store: persists events (evidence: `backend/services/events.py`)
