Exam scheduling workflow

Scheduling starts with an ExamSession linked to an academic year. On /exam-schedule, each paper is associated with a class and subject and receives a scheduled start, end and duration. The schedule validator checks the session date range, academic-year bounds, holiday clashes, class overlaps, venue availability and the configured minimum working-day gap between papers for the same class. A date clash should be confirmed deliberately or corrected in the academic calendar; it should not be hidden by treating a holiday as an ordinary working day.

Venues are exam-venue records, not classroom records. Coordinators can auto-place papers and optionally auto-allocate active venues, then assign invigilators and review the session conflicts before releasing the schedule. Seating is generated for the whole session from active students in the classes represented by non-cancelled papers and the supplied room capacities. Persisting a new plan replaces that session’s saved seat assignments; individual seats can then be manually overridden.

Setup workflow

1. Open /exam-schedule → select session.
2. Add paper per class-subject with date, time, and duration.
3. Assign an active exam venue; generate and persist seating from room capacity when the paper set is ready.
4. Assign invigilators per venue/paper and resolve assignment clashes.
5. Run conflict checks on session detail (venue, class, student overlaps, holidays).
6. Set schedule publishDate when the timetable is firm - families see papers only after that datetime.

Day-of and family usage

• Students download the session hall ticket PDF at /my-exams after publishDate; there is no QR code on it, and the download is rate-limited per signed-in account.
• Parents open /parent-dashboard/exams?childId= for the selected child (schedule, tickets, grade cards tabs).
• Class teachers review class roster and progress at /my-class/exams.
• Invigilators run /exam-day and /exam-day/[paperId] on the paper date.
• Coordinator adjusts saved seating for late joiners before the paper starts; accommodation flags do not change automatic seat allocation.