How syedsalmanshareef1-bot/neet-rank-predictor-backend works
This is a FastAPI-backed NEET-PG rank predictor and cutoff-data service, with a browser frontend and admin workflows for maintaining counselling data. Students choose filters and submit a rank; the API applies seat eligibility and cutoff matching, then returns ranked college/course results. Admins authenticate, upload cutoff files, review import history and conflicts, and resolve disagreements. The graph reflects documented capabilities and sampled call ownership; some router and frontend implementation details were not included in the excerpts, so uncertain internal links are omitted.
Main entry points: database.py Database sessions · main.py FastAPI app · admin.py Admin endpoints · api.js API client
Components 21
Browser experience
- Predictor UI
frontend_dist/js/app.js - API client
frontend_dist/js/api.js - Admin dashboard
frontend_dist/admin.html - Auth helper
frontend_dist/js/auth.js
Public API
- FastAPI app
app/main.py - Prediction endpoint
app/routers/predict.py - Reference and college API
app/routers/meta.py - Health endpoint
app/routers/health.py - User authentication
app/routers/auth.py
Prediction logic
- Rank prediction
app/services/predictor_service.py - Seat eligibility rules
app/services/seat_rules.py
Admin data management
- Admin endpoints
app/routers/admin.py - Upload parsers
app/services/file_parsers.py - Import and merge
app/services/import_service.py - Data normalization
app/services/normalize.py - Reference lookups
app/services/lookups.py
Persistence
- Database sessions
app/database.py - Domain records
app/models.py - PostgreSQL
Other components
- Student
- Administrator
Connections 26
- Student → Predictor UI: uses
- Predictor UI → API client: requests data
- API client → Prediction endpoint: submits prediction
- API client → Reference and college API: loads choices
- API client → FastAPI app: calls API
- FastAPI app → Prediction endpoint: dispatches
- FastAPI app → Reference and college API: dispatches
- FastAPI app → Health endpoint: dispatches
- FastAPI app → User authentication: dispatches
- FastAPI app → Admin endpoints: dispatches
- Prediction endpoint → Rank prediction: runs prediction
- Rank prediction → Seat eligibility rules: checks eligibility
- Rank prediction → Database sessions: loads records
- Reference and college API → Database sessions: queries metadata
- Database sessions → Domain records: maps records
- Database sessions → PostgreSQL: reads and writes
- Administrator → Admin dashboard: uses
- Admin dashboard → Auth helper: checks session
- Admin dashboard → Admin endpoints: uploads and reviews
- Admin endpoints → Upload parsers: parses upload
- Admin endpoints → Import and merge: imports rows
- Import and merge → Data normalization: normalizes keys
- Import and merge → Reference lookups: resolves references
- Import and merge → Database sessions: merges records
- Admin endpoints → Database sessions: reads audit and conflicts
- User authentication → Database sessions: checks accounts