Student roster

A student record is a user account of type student carrying a registration number, a roll number, and grade, section and stream, joined to a class through a dated membership row for one academic year. Nearly every other module reads it. Attendance, fees, grades, exams, transport, the library and both family portals all hang off that one row, which is why a roster mistake usually surfaces somewhere else a week later.

Lifecycle

What the record feeds

• Class membership drives the attendance register, the gradebook, and every class-scoped list. A student with no active membership disappears from those lists without being deactivated.
• Fee instances are generated per student per academic year, so a missing membership also means missing fee lines.
• Transport assignments, library loans and exam accommodations attach to the student rather than the class, and survive a change of section.
• Guardian records hang off the student, one row per child. Siblings are inferred from shared guardian email or phone at /students/[id].
• Promotion and leaving paperwork are covered under Promotions and certificates.

Leaving and coming back

Deactivation is the exit route, and it is refused outright while the student holds an open library loan or an active transport assignment. Once those are cleared it deactivates the account, drops the class membership with an exit date, writes off whatever is unpaid on open instalments, pauses any autopay mandate and cancels pending leave requests. Re-enrol from the profile puts the learner back into a chosen class and reports what it found on the fee ledger, but it does not restore written-off instalments — reissue the fee structure if billing should resume.