How authorsauravkushwaha/feefix-india works
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: routes.py REST API · matching.py Match orchestration · reminder_scheduler.py Reminder scheduler · app.js Web experience
Components 24
Student clients
- Web experience
web/frontend/app.js - Android client
mobile/android/ui/HomeScreen.kt
Discovery and matching
- REST API
backend/api/routes.py - Student profile
backend/models/student.py - Scheme catalogue
backend/services/dataset.py - Scheme model
backend/models/scheme.py - Eligibility engine
backend/matching_engine/engine.py - Eligibility rules
backend/matching_engine/rules.py - Match orchestration
backend/services/matching.py - V1 ranking
backend/matching_engine/ranker.py - Gap coaching
backend/services/coach.py - Multilingual chat
backend/services/chat.py
Accounts and follow-up
- Accounts and sessions
backend/services/auth.py - Rate limiting
backend/services/ratelimit.py - SQLite store
backend/services/sqlite_store.py - Application tracker
backend/services/tracker.py - Reminder service
backend/services/reminders.py - Reminder scheduler
agents/reminder_scheduler.py - Notifications
backend/notifications/notifier.py
AI and learning
- Grounded AI Q&A
ai/qa.py - Semantic search
ai/search.py - Outcome ranking
ml/ranking/service.py - Outcome events
backend/services/events.py
Other components
- Student
Connections 25
- 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
backend/api/routes.py - REST API → Scheme catalogue: reads schemes
backend/api/routes.py - Scheme catalogue → Scheme model: validates records
backend/services/dataset.py - REST API → Match orchestration: requests matches
backend/api/routes.py - Match orchestration → Eligibility engine: evaluates profile
backend/services/matching.py - Eligibility engine → Eligibility rules: evaluates rules
backend/matching_engine/engine.py - Match orchestration → V1 ranking: ranks matches
backend/services/matching.py - Match orchestration → Gap coaching: gets gap advice
backend/services/matching.py - REST API → Multilingual chat: routes chat
backend/api/routes.py - Multilingual chat → Match orchestration: requests matches
backend/services/chat.py - REST API → Accounts and sessions: handles accounts
backend/api/routes.py - REST API → Rate limiting: checks attempts
backend/api/routes.py - Accounts and sessions → SQLite store: reads and writes
backend/services/auth.py - REST API → Application tracker: updates status
backend/api/routes.py - Reminder scheduler → Reminder service: dispatches due
agents/reminder_scheduler.py - Reminder scheduler → Notifications: sends notices
agents/reminder_scheduler.py - REST API → Grounded AI Q&A: serves Q&A
backend/main.py - Grounded AI Q&A → Semantic search: uses retrieval
ai/qa.py - REST API → Outcome ranking: requests preview
backend/api/routes.py - Outcome ranking → Outcome events: reads outcomes
ml/ranking/service.py - Outcome events → SQLite store: persists events
backend/services/events.py