Files
alrahma_sunday_school/docs/enrollment-phase-6-release-checklist.md
root 1ef2800f12
Tests / PHPUnit (push) Successful in 1m26s
fix enrollment for the new school-year
2026-08-07 23:43:31 -04:00

53 lines
2.6 KiB
Markdown

# 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.