How adi02surana/elective-allocation-system works
ECAS collects ranked elective preferences, validates student/course eligibility, runs a deterministic capacity-constrained allocation, and exposes outcomes and institutional reports through role-specific screens. The browser communicates with a local REST API and SQLite backend; frontend storage also maintains seed-backed state. The graph preserves the documented faculty, allocation-administration, reporting, audit, and reset capabilities. Some page and service implementations were not excerpted, so their relationships are included only where the source index or README documents them.
Main entry points: App.jsx App navigation · apiRouter.js REST API router · electiveService.js Client elective service · storageService.js Client state storage
Components 30
Role-based web app
- App navigation
src/App.jsx - Login screen
src/pages/LoginPage.jsx - Student dashboard
src/pages/StudentDashboard.jsx - Elective catalogue
src/pages/ElectivesCatalogue.jsx - Preference builder
src/pages/PreferenceBuilder.jsx - Course management
src/pages/FacultyCourseManagement.jsx - Allocation console
src/pages/AllocationAdmin.jsx - Student result
src/pages/StudentResultView.jsx - Analytics and CSV
src/pages/ReportsPage.jsx - System administration
src/pages/SysAdminPage.jsx
Client services
- Client authentication
src/services/authService.js - Client elective service
src/services/electiveService.js - Client preference service
src/services/preferenceService.js - Client allocation service
src/services/allocationService.js - Allocation engine
src/services/allocationEngine.js - Preference validation
src/services/validationService.js - Client report service
src/services/reportService.js - Client state storage
src/services/storageService.js - Canonical seed data
src/data/seedData.js - HTTP API client
src/services/apiClient.js
API and domain services
- REST API router
server/routes/apiRouter.js - Authentication service
server/services/authService.js - Elective service
server/services/electiveService.js - Preference service
server/services/preferenceService.js - Allocation service
server/services/allocationService.js - Report service
server/services/reportService.js - Audit service
server/services/auditService.js
Persistence and seed
- SQLite database
server/db/database.js - Database seed and reset
server/db/seed.js
Other components
- Institutional user
Connections 48
- Institutional user → App navigation: uses
README.md - App navigation → Login screen: renders
src/App.jsx - App navigation → Student dashboard: routes to
src/App.jsx - App navigation → Elective catalogue: routes to
src/App.jsx - App navigation → Preference builder: routes to
src/App.jsx - App navigation → Course management: routes to
src/App.jsx - App navigation → Allocation console: routes to
src/App.jsx - App navigation → Student result: routes to
src/App.jsx - App navigation → Analytics and CSV: routes to
src/App.jsx - App navigation → System administration: routes to
src/App.jsx - Login screen → Client authentication: authenticates with
src/pages/LoginPage.jsx - Student dashboard → Client preference service: reads preferences
src/pages/StudentDashboard.jsx - Student dashboard → Client elective service: reads electives
src/pages/StudentDashboard.jsx - Elective catalogue → Client elective service: loads catalogue
src/pages/ElectivesCatalogue.jsx - Preference builder → Client preference service: submits choices
src/pages/PreferenceBuilder.jsx - Preference builder → Client elective service: loads electives
src/pages/PreferenceBuilder.jsx - Course management → Client elective service: manages courses
src/pages/FacultyCourseManagement.jsx - Allocation console → Client allocation service: runs allocation
src/pages/AllocationAdmin.jsx - Student result → Client allocation service: loads outcome
src/pages/StudentResultView.jsx - Analytics and CSV → Client report service: requests reports
src/pages/ReportsPage.jsx - System administration → Client state storage: resets state
src/pages/SysAdminPage.jsx - Client authentication → Client state storage: reads user data
src/services/authService.js - Client authentication → HTTP API client: creates session
src/services/authService.js - Client elective service → Client state storage: reads state
src/services/electiveService.js - Client elective service → Preference validation: validates courses
src/services/electiveService.js - Client elective service → HTTP API client: persists courses
src/services/electiveService.js - Client preference service → Preference validation: validates choices
src/services/preferenceService.js - Client preference service → Client state storage: reads state
src/services/preferenceService.js - Client allocation service → Allocation engine: runs matcher
src/services/allocationService.js - Client allocation service → Preference validation: checks readiness
src/services/allocationService.js - Client allocation service → HTTP API client: calls API
src/services/allocationService.js - Client report service → Client state storage: reads state
src/services/reportService.js - Client state storage → Canonical seed data: initializes from
src/services/storageService.js - Client state storage → HTTP API client: syncs backend
src/services/storageService.js - HTTP API client → REST API router: sends HTTP requests
README.md - REST API router → Authentication service: dispatches auth
server/routes/apiRouter.js - REST API router → Elective service: dispatches courses
server/routes/apiRouter.js - REST API router → Preference service: dispatches preferences
server/routes/apiRouter.js - REST API router → Allocation service: dispatches allocation
server/routes/apiRouter.js - REST API router → Report service: dispatches reports
server/routes/apiRouter.js - REST API router → Audit service: dispatches audit
server/routes/apiRouter.js - Allocation service → Allocation engine: runs matcher
server/services/allocationService.js - Allocation service → Elective service: loads electives
server/services/allocationService.js - Allocation service → Authentication service: loads profiles
server/services/allocationService.js - Authentication service → SQLite database: reads and writes
server/services/authService.js - Elective service → SQLite database: reads and writes
server/services/electiveService.js - Preference service → SQLite database: reads and writes
server/services/preferenceService.js - Allocation service → SQLite database: stores outcomes
server/services/allocationService.js