Orbit Edu Campus Supervision Duty Rosters & Examination Invigilation Neutrality Policy

1. Governance Architecture & Duty Topology

The Orbit Edu Duties subsystem is maintained within apps/api/src/modules/edu/services/duties.service.ts and managed through the administrative dashboard at apps/edu/src/app/admin/duties/page.tsx. It provides an automated, equitable scheduling engine designed to protect student transit safety while guaranteeing examination security.

+----------------------------------------------------------------------------------------------------+
|                                    CAMPUS SUPERVISION CONTROL PLANE                                |
|                                                                                                    |
|   +-----------------------+     +-----------------------+     +--------------------------------+   |
|   |  DUTY CLASSIFICATIONS |     |  EXAM NEUTRALITY GATE |     |   FACULTY WORKLOAD ENGINE      |   |
|   |  - Morning Gate       |     |  - Timetable Cross-Ref|     |   - Duty Count Aggregators     |   |
|   |  - Recess Ground      |     |  - Subject Mismatch   |     |   - Equitable Distribution     |   |
|   |  - Dismissal Bus Line |     |  - Prohibit Own Exam  |     |   - Peer Swap Approval Chain   |   |
|   |  - Exam Invigilation  |     |  - Invigilator Lock   |     |   - Administrative Audits      |   |
|   +-----------+-----------+     +-----------+-----------+     +---------------+----------------+   |
|               |                             |                                 |                    |
|               +----------------------+      |      +--------------------------+                    |
|                                      |      |      |                                               |
|                                      v      v      v                                               |
|                      +-----------------------------------------------+                             |
|                      |             CAMPUS DUTY COORDINATOR           |                             |
|                      |  apps/api/src/modules/edu/services/           |                             |
|                      |               duties.service.ts               |                             |
|                      +-----------------------+-----------------------+                             |
|                                              |                                                     |
|                      +-----------------------+-----------------------+                             |
|                      |                                               |                             |
|                      v                                               v                             |
|   +------------------------------------+   +---------------------------------------------------+   |
|   |    FACULTY PAYROLL RECONCILIATION  |   |             AUDIT TRAIL & LOGISTICS HUB           |   |
|   |   - Special Duty Allowances        |   |   - Attendance Biometric Verification             |   |
|   |   - Overtime Proctoring Credits    |   |   - Replacement Proxy Incident Logs               |   |
|   |   - Automatic Payroll Line Ingress |   |   - Campus Safety Incident Traceability           |   |
|   +------------------------------------+   +---------------------------------------------------+   |
+----------------------------------------------------------------------------------------------------+

1.1 Relational Schema Definitions

The duty assignment system models rosters, assignments, and peer swap workflows within the relational persistence kernel:

export interface DutyRosterRecord {
  id: string;
  name: string;
  dutyType: 'MORNING_GATE' | 'RECESS_GROUND' | 'DISMISSAL_BUS' | 'EXAM_INVIGILATION';
  term: string;
  startDate: string;
  endDate: string;
  location: string;
  requiredStaffPerSlot: number;
  status: 'ACTIVE' | 'ARCHIVED' | 'DRAFT';
}

export interface FacultyDutyAssignmentRecord {
  id: string;
  rosterId: string;
  facultyId: string;
  facultyName: string;
  department: string;
  dutyDate: string;
  dayOfWeek: string;
  dutyType: 'MORNING_GATE' | 'RECESS_GROUND' | 'DISMISSAL_BUS' | 'EXAM_INVIGILATION';
  location: string;
  startTime: string;
  endTime: string;
  status: 'SCHEDULED' | 'COMPLETED' | 'SWAPPED' | 'MISSED';
  notes?: string | null;
}

export interface DutySwapRequestRecord {
  id: string;
  dutyAssignmentId: string;
  requestingFacultyId: string;
  requestingFacultyName: string;
  targetFacultyId: string;
  targetFacultyName: string;
  dutyDate: string;
  dutyType: 'MORNING_GATE' | 'RECESS_GROUND' | 'DISMISSAL_BUS' | 'EXAM_INVIGILATION';
  reason: string;
  status: 'PENDING' | 'APPROVED' | 'REJECTED';
  approvedBy?: string | null;
  remarks?: string | null;
  createdAt: string;
  updatedAt: string;
}

2. Interactive Operator Interface

The Campus Duty Roster Console gives administrators live visibility into daily posts, upcoming exam invigilation allocations, and pending peer swap authorizations:

3. Examination Invigilation Neutrality Policy & Enforcement

Academic assessment credibility requires absolute invigilator impartiality. The Orbit Edu Duties engine enforces strict algorithmic constraints during exam schedule compilation:

3.1 Statutory Neutrality Rules

1. Direct Academic Subject Exclusion:
   • Instructors who teach a subject in a given academic session are barred from proctoring examinations for that subject across all sections of that class level.
   • For example: A Physics instructor teaching Class 10-A cannot proctor Class 10-A, 10-B, or 10-C Physics examinations.
2. Cross-Departmental Invigilation:
   • Science faculty are assigned to Humanities and Languages examinations.
   • Mathematics faculty are assigned to Social Studies and Literature assessments.
3. Emergency Proxy Re-verification:
   • In the event of a peer duty swap, the replacement proctor is re-evaluated by the neutrality engine before the swap can be approved.

4. Duty Swap Workflows & Workload Balancing

Faculty members can initiate peer duty swaps when emergency conflicts arise, subject to departmental administrative approval:

4.1 Workload Distribution Analysis

To prevent faculty burnout and guarantee equitable administrative participation, DutiesService.getWorkloadDistribution() aggregates term duty counts across all instructors:

export interface WorkloadDistributionItem {
  facultyId: string;
  facultyName: string;
  department: string;
  totalDuties: number;
  morningGateDuties: number;
  recessGroundDuties: number;
  dismissalBusDuties: number;
  examDuties: number;
}

The mathematical workload balance formula ensures standard deviation remains within tolerance limits:

WorkloadVariance = Abs(FacultyDuties - MeanCampusDuties)

If WorkloadVariance > 2, the scheduling engine alerts the Vice Principal to adjust subsequent roster allocations.

4.2 Formal Swap Request Lifecycle

1. Initiate Request:
   • The assigned faculty member navigates to apps/edu/src/app/admin/duties and clicks Request Swap.
   • Selects the target duty assignment (e.g., Morning Gate on 12-Oct-2026).
   • Chooses the proposed replacement faculty member and provides a formal operational reason.
2. Neutrality & Collision Validation:
   • If the assignment is EXAM_INVIGILATION, the system verifies that the replacement faculty member does not teach the exam subject.
   • Verifies the replacement faculty member does not have an active teaching collision.
3. Administrative Approval:
   • The Vice Principal reviews the request in DutiesService.listPendingSwaps().
   • Upon clicking Approve Swap, the system translocates the assignment, updates the audit log, and notifies both faculty members.

5. Architectural Verification & Throughput Telemetry

The campus supervision scheduling engine is evaluated across multi-roster generation scenarios:

6. Failure Modes & Recovery SOP

The following operational contingency protocols resolve duty and invigilation exceptions:

7. Cross-Vertical Internal Linkages

The campus supervision subsystem coordinates with other core institutional modules:

• BISE Tabulation Gazette & Examination Broadsheets — Coordinates invigilation rosters directly with official term examination timetables.
• Faculty Monthly Payroll & Currency-in-Words Payslips — Compensates faculty for weekend or evening examination proctoring via Special Duty Allowances.
• RFID Turnstile Gate Kiosk & Tardiness Escalation — Staff on Morning Gate duty monitor student RFID turnstile throughput and manage tardy entries.
• Pastoral Conduct Scoring & Detention Proctoring — Shares faculty availability metrics to ensure detention supervision does not collide with campus posts.
• School Transport Fleet Telemetry & Route Stoppages — Deploys Dismissal Bus line duty officers to ensure orderly student vehicle boarding.