thatguygriff
8fb5ff8270
CI / Tests (PHP 8.1) (pull_request) Successful in 43s
CI / Coding Standards (pull_request) Successful in 56s
CI / PHPStan (pull_request) Successful in 57s
CI / No Debug Code (pull_request) Successful in 2s
CI / Tests (PHP 8.2) (pull_request) Successful in 44s
CI / Tests (PHP 8.3) (pull_request) Successful in 48s
CI / Build Plugin Zip (pull_request) Has been skipped
Implements #22: a read-only Students area for studio admins. - StudentController (manage_students): a list of us_student users with upcoming-lesson and active-enrolment counts, each linking to a detail page showing account info, upcoming/past lessons (offering, instructor, status), and group-class enrolments. - StudentSchedule::partition() — pure, unit-tested upcoming/past split. - Repo counts: BookingRepository::countUpcomingForStudent and EnrollmentRepository::countActiveForStudent (single-query, tested). - Templates: templates/admin/students.php, student-detail.php. - Students admin menu wired in AdminMenu (no Plugin change — the repos were already available there). - Docs: README status flipped to implemented; feature spec updated. Payment history slots into the detail when Payments (#7) lands. Tests: StudentScheduleTest + the two repo count tests. composer test (127), cs, and PHPStan level 6 all pass. Refs #22 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.2 KiB
2.2 KiB
Feature: Student Administration
Overview
A read-only studio-admin area to browse students and drill into one student's history and upcoming activity — lessons and group-class enrolments — without digging through individual records.
Data Model
No new tables. The views are composed from existing data:
- Students are WordPress users with the
us_studentrole (get_users,get_userdata). - Lessons come from
{prefix}us_lessons(with{prefix}us_availabilityfor slot times). - Group-class enrolments come from
{prefix}us_group_enrollments.
Admin Interface
Students in wp-admin (manage_students, studio admin only):
- List — every
us_studentuser: display name, email, registered date, and quick counts (upcoming lessons, active group enrolments). Each row links to the detail view. - Detail (
?student_id=):- Account — display name, email, registered date.
- Upcoming lessons and Past lessons — split by the linked availability
slot's
start_dt; each shows date/time, offering, instructor, and status. - Group-class enrolments — active/past, with offering title and status.
- (Later) policy-acceptance history, intake answers, and payment history once Payments lands.
Read-only in this iteration; cancel/edit actions are a possible follow-up.
Capabilities
manage_students— studio admin (administrators inherit it via theuser_has_capfilter). No new capabilities or tables.
Implementation
- Admin controller:
Unsupervised\Schedular\Auth\StudentController(list + detail) - Templates:
templates/admin/students.php,templates/admin/student-detail.php - Reuses
Booking\BookingRepository::findByStudent+countUpcomingForStudent,Availability\AvailabilityRepository::findById,Offering\OfferingRepository::findById,GroupClass\EnrollmentRepository::findByStudent+countActiveForStudent - Upcoming/past split:
Auth\StudentSchedule::partition()(pure, unit-tested) - The upcoming/past split is extracted into a small pure helper so it is unit-testable (the controller itself follows the repo convention of not being unit-tested).
Tests
tests/Unit/Auth/StudentScheduleTest.php(the pure upcoming/past split helper)