How purohith08/ds-university-allotment works
This is a Flask-based university exam hall allotment application. Staff upload Excel rosters, select years, configure classrooms and exam slots, request allocations, review results, and download an Excel workbook. The sampled backend explicitly passes uploaded roster paths and allocation settings to the allocation engine; the engine reads workbook sheets and assigns students to rooms. The browser also exposes upload and clear actions. README content is absent and some source is unsampled, so unshown result-rendering and frontend request links are omitted.
Main entry points: main.py Flask API · main.js Browser interface · hall_allotment.py Allotment engine · index.html Application page
Components 10
Web interface
- Browser interface
static/js/main.js - Application page
templates/index.html
Flask service
- Flask API
main.py - Uploaded rosters
main.py - Allocation summary
main.py
Allocation engine
- Allotment engine
hall_allotment.py - Roster parsing
hall_allotment.py - Room assignment
hall_allotment.py
Reports
- Excel workbook export
main.py
Other components
- Exam staff
Connections 11
- Exam staff → Browser interface: uses
- Browser interface → Application page: interacts with
- Browser interface → Flask API: uploads files
static/js/main.js - Browser interface → Flask API: clears data
static/js/main.js - Flask API → Uploaded rosters: saves rosters
main.py - Flask API → Allotment engine: calls allotment
main.py - Allotment engine → Roster parsing: loads workbooks
hall_allotment.py - Allotment engine → Room assignment: dispatches groups
hall_allotment.py - Flask API → Allocation summary: calculates totals
main.py - Flask API → Excel workbook export: creates export
main.py - Allotment engine → Uploaded rosters: reads roster paths
main.py