fix enrollment for the new school-year

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

@@ -0,0 +1,52 @@
+# Enrollment Phase 6 Release Checklist
+
+Use this checklist before opening re-enrollment for a target school year.
+
+## Automated Checks
+
+Run the release audit:
+
+```bash
+php spark registration:release-audit --school-year=2026-2027
+```
+
+For CI or exported review output:
+
+```bash
+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.

docs/enrollment-phase-7-post-launch-monitoring.md

@@ -0,0 +1,41 @@
+# Enrollment Phase 7 Post-Launch Monitoring
+
+Phase 7 begins after registration launch approval and the first registration-opening email send.
+
+## Daily Monitor
+
+Run:
+
+```bash
+php spark registration:monitor --school-year=2026-2027
+```
+
+Use JSON for dashboards or saved daily snapshots:
+
+```bash
+php spark registration:monitor --school-year=2026-2027 --days=7 --json
+```
+
+## Review Targets
+
+- Submitted registrations compared with expected returning students.
+- Students blocked by eligibility, adult-student, financial, date, or exception rules.
+- Open enrollment flags by type and priority.
+- Stale flags older than the selected `--days` window.
+- Failed or pending registration-opening emails.
+- Recent transition audit actions.
+
+## Daily Actions
+
+- Resolve high-priority open flags first.
+- Retry failed emails after correcting contact records.
+- Follow up with families that received email but have not submitted.
+- Confirm make-up exam and manual placement flags do not stay stale.
+- Review adult-student and exception-required cases with authorized administrators.
+
+## Weekly Actions
+
+- Compare submitted registration counts against the expected transition count.
+- Confirm unresolved warnings are still intentional.
+- Export or save the JSON monitor output for launch-week audit history.
+- Re-run `php spark registration:release-audit --school-year=2026-2027 --json` after major configuration or school-year changes.

docs/enrollment-phase-8-closeout-reconciliation.md

@@ -0,0 +1,53 @@
+# Enrollment Phase 8 Closeout and Reconciliation
+
+Phase 8 starts when the registration window is ending or after online registration closes.
+
+## Closeout Report
+
+Run:
+
+```bash
+php spark registration:closeout-report --school-year=2026-2027
+```
+
+Use JSON for saved archive output:
+
+```bash
+php spark registration:closeout-report --school-year=2026-2027 --json
+```
+
+Export exception rows for spreadsheet review:
+
+```bash
+php spark registration:closeout-report --school-year=2026-2027 --export=/tmp/registration-closeout-2026-2027.csv
+```
+
+## Closeout Gates
+
+- Every expected returning student is either submitted, intentionally not returning, withdrawn, expelled, or administratively resolved.
+- No admission-under-review registrations remain without an owner.
+- No open enrollment placement, make-up exam, age, date, or financial exception flags remain.
+- No failed registration-opening email records remain without retry notes or corrected contact data.
+- Final class placement counts match administrator-approved class rosters.
+- Registration audit history is retained before any school-year status is archived.
+
+## Exception Review
+
+The closeout report groups exceptions into:
+
+- `unsubmitted_returning_student`
+- `pending_enrollment`
+- `unresolved_flag`
+- `failed_email`
+
+Each row should be assigned to an administrator, resolved, and rechecked before the school year transition is considered complete.
+
+## Archive Package
+
+Save these artifacts for the school-year transition record:
+
+- Phase 6 release audit JSON.
+- Phase 7 daily or weekly monitor snapshots.
+- Phase 8 closeout report JSON.
+- Phase 8 closeout CSV export, if exceptions existed.
+- Final administrator approval note for closing registration.