How unseenap/auto-exam-main works
GBU Examination Operations Platform is a role-governed web application for university exam administration. Staff manage academic records and import master data, configure exam cycles and calendars, validate and generate date sheets, then review, approve, and publish them. Published schedules support room-aware seating, attendance, invigilation, replacements, and operational reports. The graph highlights the documented workflow and major capabilities; some operational subsystems are documented in the README but their implementation details were not sampled.
Main entry points: Application.php Request routing · Auth.php Authentication · StudentImportService.php Validated imports · SchedulingValidator.php Schedule validation
Components 27
Access & Core
- Request routing
app/Foundation/Application.php - Authentication
app/Auth/Auth.php - Role permissions
app/Auth/RolePolicy.php - MariaDB / MySQL
app/Foundation/Database.php
Academic Records
- Academic masters
app/Foundation/Application.php - Student records
app/Academic/StudentRepository.php - Roll parsing
app/Academic/RollNumberParser.php - Batch progression
app/Academic/BatchProgression.php - Validated imports
app/Import/StudentImportService.php - CSV / XLSX reader
app/Import/TabularReader.php - Course imports
app/Import/CourseImportService.php
Exam Scheduling
- Cycles & calendars
app/Exams/ExamService.php - Manual date sheets
app/Exams/ExamService.php - Date-sheet imports
app/Import/DateSheetImportService.php - Automatic scheduler
app/Exams/AutomaticScheduler.php - Schedule validation
app/Exams/SchedulingValidator.php - Written-paper rules
app/Exams/WrittenPaperPolicy.php - Draft review
app/Exams/ScheduleReviewService.php - Approval & publication
app/Exams/SchedulePublicationService.php
Exam Operations
- Room layouts
app/Rooms/RoomSeatGenerator.php - Seating allocation
app/Seating/SeatingAllocator.php - Attendance
resources/views/attendance/index.php - Invigilation duties
resources/views/invigilation/index.php - Duty replacements
resources/views/invigilation/replacements.php
Exports & Reports
- Operational reports
resources/views/reports/index.php - Branded XLSX export
app/Export/XlsxExporter.php
Other components
- University staff
Connections 29
- University staff → Request routing: uses
- Request routing → Authentication: authenticates
app/Foundation/Application.php - Authentication → Role permissions: checks permissions
app/Auth/Auth.php - Authentication → MariaDB / MySQL: reads user records
app/Auth/Auth.php - Request routing → Academic masters: manages
app/Foundation/Application.php - Request routing → Student records: uses
app/Foundation/Application.php - Request routing → Validated imports: routes imports
app/Foundation/Application.php - Validated imports → CSV / XLSX reader: reads files
app/Import/StudentImportService.php - Validated imports → Roll parsing: parses roll numbers
app/Import/StudentImportService.php - Course imports → CSV / XLSX reader: reads files
app/Import/CourseImportService.php - Request routing → Course imports: stages and commits
app/Foundation/Application.php - Request routing → Cycles & calendars: configures cycles
app/Foundation/Application.php - Request routing → Manual date sheets: manages papers
app/Foundation/Application.php - Request routing → Date-sheet imports: imports date sheets
app/Foundation/Application.php - Request routing → Schedule validation: validates scope
app/Foundation/Application.php - Schedule validation → Batch progression: derives semesters
app/Exams/SchedulingValidator.php - Schedule validation → Written-paper rules: applies paper rules
app/Exams/SchedulingValidator.php - Automatic scheduler → Written-paper rules: filters written papers
app/Exams/AutomaticScheduler.php - Request routing → Automatic scheduler: generates schedules
app/Foundation/Application.php - Request routing → Draft review: locks and moves papers
app/Foundation/Application.php - Request routing → Approval & publication: approves and publishes
app/Foundation/Application.php - Approval & publication → Branded XLSX export: exports date sheets
- Request routing → Room layouts: manages room layouts
app/Foundation/Application.php - Request routing → Seating allocation: generates seating
app/Foundation/Application.php - Request routing → Attendance: supports attendance
- Request routing → Invigilation duties: allocates duties
- Request routing → Duty replacements: tracks replacements
- Request routing → Operational reports: provides reports
- Request routing → Branded XLSX export: exports workbooks
app/Foundation/Application.php