Group class term dates, single-class embed mode, and offering editing

Group class offerings now carry real dates: the add/edit form takes a
start date plus a sessions control (one-off, or weekly for N sessions;
the end date is computed as start + (N-1) weeks via
Offering::weeklyTermEnd). Dates are validated strictly (Y-m-d) and shown
in the offerings list and on the student-facing class card, including
the weekly session count.

[us_group_classes offering="<id>"] (block attribute offeringId, chosen
from a dropdown of active classes fetched from the public offerings
endpoint) restricts the page to a single class so the enrolment flow can
be embedded on a page dedicated to that class; a pinned class that is no
longer offered reports itself closed instead of falling back to the
catalog.

Offerings are now editable from the admin screen: an Edit button
prefills the shared add/edit form and saving posts usc_action=update.
Updates always preserve the original owner and currency, and non-admin
instructors can only load and update their own offerings. The form also
gains the previously missing description field and an Active toggle (the
admin-UI counterpart of the REST is_active flag) so an edit cannot wipe
data the form never collected.

Closes #59

Co-Authored-By: Claude Fable 5 <[email protected]>

docs/features/editor-blocks.md

@@ -21,8 +21,7 @@ transform.
 
 ## Block options
 
-Two blocks have sidebar (inspector) options controlling where their
-logged-in/logged-out link sends the visitor:
+Three blocks have sidebar (inspector) options:
 
 | Block | Attribute | Default | Effect |
 |---|---|---|---|
@@ -30,9 +29,14 @@ logged-in/logged-out link sends the visitor:
 | `us-scheduler/booking` | `autoRedirect` (boolean) | `false` | Send logged-out visitors straight to the login page instead of showing the link. |
 | `us-scheduler/student-login` | `bookingPageId` (number) | `0` | Page the "View available lessons" link points to for logged-in visitors, and the post-login redirect target. `0` = the current page. |
 | `us-scheduler/student-login` | `autoRedirect` (boolean) | `false` | Send logged-in visitors straight to the booking page instead of showing the link. Does nothing until a booking page is chosen. |
+| `us-scheduler/group-classes` | `offeringId` (number) | `0` | Restrict the page to a single group class, for embedding on a page dedicated to that class. `0` = browse all classes. Shortcode equivalent: `[us_group_classes offering="…"]`. |
 
 The page selects list all published pages; if a chosen page is later deleted,
-the blocks fall back to their defaults. The link targets are also available
+the blocks fall back to their defaults. The group-classes block's class
+select is a dropdown of active group classes fetched from
+`GET /us-scheduler/v1/offerings?kind=group_class`; a stored class that is no
+longer offered shows as "Unavailable class #N" rather than silently falling
+back to all classes. The link targets are also available
 to the shortcodes as `[us_booking login_page_id="…"]` and
 `[us_student_login booking_page_id="…"]`; auto-redirect is block-only.
 

docs/features/group-classes.md

@@ -15,6 +15,12 @@ Students enrol in a group class — an offering of kind `group_class` — as a c
 | `payment_id`   | BIGINT UNSIGNED  | Nullable FK → `us_payments.id`                             |
 | `enrolled_at`  | DATETIME         | Insertion time                                             |
 
+## Class Dates
+A group class offering carries `term_start`/`term_end` (see `offerings.md`):
+one-off classes end the day they start; weekly classes run a set number of
+sessions. The class card on the enrolment page shows the date or date range
+with the session count.
+
 ## Enrolment Flow
 1. Student opens a group class from the offering catalog.
 2. Student answers the offering's questions (`GET /offerings/{id}/questions`).
@@ -50,7 +56,7 @@ instructor's group classes if the caller has `view_own_lessons` on those offerin
 - Model: `Unsupervised\Schedular\GroupClass\Enrollment`
 - Admin controller: `Unsupervised\Schedular\GroupClass\GroupClassController` (gated on `view_all_lessons`)
 - REST endpoint: `Unsupervised\Schedular\GroupClass\EnrollmentEndpoint`
-- Frontend: `Unsupervised\Schedular\GroupClass\GroupClassPage` (`[us_group_classes]` shortcode)
+- Frontend: `Unsupervised\Schedular\GroupClass\GroupClassPage` (`[us_group_classes]` shortcode; `offering="…"` restricts it to a single class for embedding on a dedicated page — the block equivalent is the `offeringId` attribute)
 - Reuses `Registration\RegistrationGate` (intake answers + booking-scoped policy acceptance, type `enrollment`)
 
 > **Payment seam:** payment is deferred to #7. An enrolment is created with
@@ -62,3 +68,4 @@ instructor's group classes if the caller has `view_own_lessons` on those offerin
 ## Tests
 - `tests/Unit/GroupClass/EnrollmentTest.php`
 - `tests/Unit/GroupClass/EnrollmentRepositoryTest.php`
+- `tests/Unit/GroupClass/GroupClassPageTest.php`

docs/features/offerings.md

@@ -28,11 +28,24 @@ An offering is anything a student can register for: a private-lesson type (30 or
 - `one_time` — charged once at booking (a single private lesson).
 - `full_term` — charged in full upfront at registration (a weekly private reservation or a year-long group class). See `payments.md`.
 
+## Term Dates
+Group classes carry a term: `term_start` is the date of the first class and
+`term_end` the last. The add-offering form takes a start date plus a sessions
+control — **one-off** (the term ends the day it starts) or **weekly for N
+sessions** (`term_end = term_start + (N−1) weeks`, computed by
+`Offering::weeklyTermEnd()`). Dates are validated by `Offering::normalizeDate()`
+(strict `Y-m-d`); an invalid start date leaves both term columns NULL. The
+student-facing class card shows the date (one-off) or the date range with the
+weekly session count.
+
 ## Admin Interface
 Studio admin and instructors manage offerings under **Offerings** in wp-admin.
 - Studio admin (`manage_offerings`) manages offerings for any instructor.
 - Instructor (`manage_offerings`) manages only their own.
 - Each offering's intake questions are edited from the offering screen (see `registration-questions.md`).
+- The offerings list shows each offering's ID (needed for `[us_group_classes offering="…"]`) and its term dates.
+- **Edit** on a row reloads the page (`?usc_edit=<id>`) with the form prefilled; saving posts `usc_action=update`. Owner and currency are always preserved on update, so a form submission can never reassign an offering. Non-admin instructors can only load and update their own offerings.
+- The form includes a **description** textarea and an **Active — open for registration** checkbox (unchecking hides the offering from students without deleting it — the admin-UI counterpart of the REST `is_active` flag).
 
 ## REST API
 | Method   | Endpoint                                    | Permission                       |
@@ -51,5 +64,6 @@ Studio admin and instructors manage offerings under **Offerings** in wp-admin.
 - REST endpoint: `Unsupervised\Schedular\Offering\OfferingEndpoint`
 
 ## Tests
+- `tests/Unit/Offering/OfferingControllerTest.php`
 - `tests/Unit/Offering/OfferingRepositoryTest.php`
 - `tests/Unit/Offering/OfferingTest.php`