# Practical examinations: separate stage entry

## Installation
For an existing installation with Practical Examinations, import database/migrations/20261017_exam_stages.sql through phpMyAdmin. If Practical Examinations has not yet been installed, first import database/migrations/20261016_practical_examinations.sql, then the new stage migration. Apply the application files while preserving local configuration and uploads, then refresh Ctrl+F5. Existing examination marks are retained.

## Permissions
HODs enter Level 1 and Level 2 independently in their assigned department/campus. Staff enter any of the three stages across all campuses/departments. Only staff enter Final Exam marks and publish combined results. Administrators can view examination sheets and create rosters, but cannot enter stage marks or publish final combined results. Students see only their own published combined result.

Each examination opens with Level 1, Level 2, Final Exam and Combined Results tabs. A stage sheet shows Student, that stage's mark, stage feedback and the marker/time. Only one mark is submitted in each save request; other stages are preserved. Read-only stages display saved marks without input controls. Stage timestamps are recorded from this update onward; existing marks without stage metadata are labelled Previously saved mark.

Staff use Combined Results to review the three stages and publish. All three marks must be complete. Any later stage edit returns the result to Awaiting staff publication, keeping the marks but withholding the result until staff publish again. Publication sends a student notification. Per-result revision checks prevent stale concurrent edits from overwriting each other. Each stage save records marker identity and feedback separately.

Level 1 is /25, Level 2 is /25 and Final Exam is /50, making 100%. Zero is valid; blank marks remain incomplete. Grade boundaries are <=50 D, >50–60 B, >60–70 B+, >70–80 A, >80–100 A+. Integer grades match the requested 51–60, 61–70, 71–80 and 81–100 ranges. Decimal marks up to two places use these continuous boundaries. Existing student-project grading is unchanged.

The fixed roster captures active students in the selected course department, campus and optional study year at creation. It does not infer individual course registration. Draft marks are private to management, while students access only published results. Print the current stage or combined results using the sheet's Print results button.

Automated tests cover grade boundaries, validation, HOD/staff/admin stage permissions, preserved marks in other stages, separate entry payloads, staff publication controls and student read-only views. Live XAMPP/MySQL and visual browser verification remain necessary.
