alrahma_sunday_school/docs/enrollment-phase-6-release-checklist.md

Enrollment Phase 6 Release Checklist

Use this checklist before opening re-enrollment for a target school year.

Automated Checks

Run the release audit:

php spark registration:release-audit --school-year=2026-2027

For CI or exported review output:

php spark registration:release-audit --school-year=2026-2027 --json

The release audit must show ready: true before launch approval. Blocking items must be resolved before registration is opened or registration-opening emails are sent.

Required Test Coverage

• Deliberation decisions: expelled, withdrawn, deferred, passed, repeat class, make-up exam, and historical spelling variants.
• Age rules: parent block at 18 on September 1, allowed under-18 registrations, and adult-student exception paths.
• Placement rules: one-grade promotion, repeat same class, repeat class unavailable flag, make-up provisional placement, and final-grade handling.
• Registration dates: before opening, valid window, after deadline, and logged exceptions.
• Policy and financial presentation: required acknowledgement, policy version retention, family balance once, and child-level balance per child.
• Email communication: consolidated family email, child sections, adult-student instructions, registration dates, delivery failures, and retained sent content.
• Audit records: automatic placements, manual changes, administrative overrides, before-and-after values, and reason fields.

Non-Production Validation

• Configure a non-production school year with registration dates, tuition, policies, class sections, and email template.
• Run historical decision normalization against copied data.
• Run the transition evaluation for the non-production year.
• Preview emails for at least these family cases: passed child, repeat child, make-up exam child, blocked child, adult student, family balance, and multiple children.
• Confirm the administrator dashboard shows open flags, blocked students, failed emails, and launch approval status.

Launch Approval

• A school administrator reviews the release audit output.
• All blocking checks are cleared.
• Any remaining warnings are accepted intentionally.
• Registration launch approval is recorded in the administrator enrollment dashboard.
• Registration-opening emails are sent only after approval.

Post-Launch Monitoring

• Monitor enrollment blocks daily during the first registration week.
• Resolve placement flags and make-up exam flags from the administrator dashboard.
• Review failed registration emails and retry after correcting contact data.
• Compare submitted registrations against expected transition counts.