How rohith-kanna-jr-2006/nec_timetable_web_app works
NEC’s web application supports faculty, coordinators, and HODs managing academic context, faculty workload and inputs, course allocations, timetable generation, review, and approval. The principal workflow is coordinator/HOD setup and allocation, timetable solving and review, then approval and faculty/class timetable access. The graph includes documented domain capabilities; unsampled subsystem links are omitted rather than inferred.
Main entry points: models Academic records · app.js Express API · timetableController.js Timetable API · api.js API client
Components 24
Role-based web app
- Web app
web/src/App.js - Role routes
web/src/routes/AppRoutes.js - Faculty portal
web/src/pages/faculty - Coordinator workflow
web/src/pages/coordinator - HOD workflow
web/src/pages/hod - API client
web/src/services/api.js - Academic context client
web/src/services/academicContextService.js - Timetable client
web/src/services/timetableService.js
API and access
- Express API
backend/src/app.js - Authentication and roles
backend/src/middleware/authMiddleware.js
Academic operations
- Faculty management
backend/src/controllers/facultyController.js - HOD faculty allocation
backend/src/controllers/hodAllocationController.js - Allocation policy
backend/src/services/allocationPolicyService.js - Workload management
backend/src/services/workloadService.js - Absence and availability
backend/src/controllers/absenceController.js - Curriculum and courses
backend/src/data/r22CurriculumMaster.js - Context readiness
backend/src/services/contextStatusService.js
Timetable lifecycle
- Timetable API
backend/src/controllers/timetableController.js - Timetable solver
backend/src/services/timetable/timetableSolver.js - Timetable lifecycle
backend/src/services/timetableService.js - Notifications
backend/src/services/notificationService.js
Persistence
- MongoDB
backend/src/config/db.js - Academic records
backend/src/models
Other components
- Faculty, coordinator, HOD
Connections 29
- Faculty, coordinator, HOD → Web app: use
README.md - Web app → Role routes: renders
web/src/App.js - Role routes → Faculty portal: routes faculty
web/src/routes/AppRoutes.js - Role routes → Coordinator workflow: routes coordinator
web/src/routes/AppRoutes.js - Role routes → HOD workflow: routes HOD
web/src/routes/AppRoutes.js - Faculty portal → API client: uses API
- Coordinator workflow → API client: uses API
- HOD workflow → Academic context client: loads contexts
web/src/pages/hod/TimetableReviewPage.js - HOD workflow → Timetable client: loads schedules
web/src/pages/hod/TimetableReviewPage.js - Academic context client → API client: sends requests
web/src/services/academicContextService.js - Timetable client → API client: sends requests
- API client → Express API: calls API
README.md - Express API → Authentication and roles: secures routes
- Express API → Faculty management: routes requests
- Express API → HOD faculty allocation: routes requests
- Express API → Timetable API: routes requests
- HOD faculty allocation → Allocation policy: applies policy
backend/src/controllers/hodAllocationController.js - HOD faculty allocation → Curriculum and courses: reads curriculum
backend/src/controllers/hodAllocationController.js - Faculty management → Workload management: calculates workload
backend/src/controllers/facultyController.js - Timetable API → Timetable solver: generates schedule
- Timetable API → Context readiness: checks readiness
backend/src/controllers/timetableController.js - Context readiness → Curriculum and courses: validates courses
backend/src/services/contextStatusService.js - Timetable API → Timetable lifecycle: manages lifecycle
backend/src/controllers/timetableController.js - Timetable API → Academic records: reads and writes
backend/src/controllers/timetableController.js - HOD faculty allocation → Academic records: reads and writes
backend/src/controllers/hodAllocationController.js - Faculty management → Academic records: reads and writes
backend/src/controllers/facultyController.js - MongoDB → Academic records: connects store
- Absence and availability → Academic records: persists inputs
- Notifications → Academic records: persists notices