Class Types — Behavior

State

Class types do not have a status machine. They have a single boolean is_active:

DELETE /class-types/:id performs update set is_active=false, never DELETE FROM. The row stays so historical sessions, bookings, and analytics keep their referential integrity.

Invariants

• Program must belong to the same org as the caller’s membership. Create + update both verify program.organizationId === orgId before mutating (class-types.service.ts:33-42, :115-121).
• Class type cannot be reassigned to another program — there is no programId field on UpdateClassTypeDto.
• No hard delete — deactivation only. This is load-bearing for the schedule history.
• Org isolation via the program — class types have no direct organization_id column. findAll joins class_types to programs and filters programs.organization_id = orgId in SQL — it used to fetch every active class type across every tenant and filter in JS, which meant any consumer holding the (unfiltered) intermediate result could see another org’s rows before the org check ran.
• findAll accepts an optional programId filter, pushed into the same SQL WHERE clause — GET /class-types?programId= returns only that program’s class types, never another program’s (in-org or not).
• Default space must belong to the org — defaultLocationId on create/update must be a location of the same org; otherwise BadRequestException('Location not found in this organization'). null clears it. The FK is ON DELETE SET NULL, so a hard delete of the location (DB only; the API only deactivates) clears it.
• Default space pre-fills, it does not bind — on POST /sessions with locationId omitted (undefined), the session gets defaultLocationId if that space is active. An explicit locationId (including null) wins. Space checks then apply to the result.
• Open classes don’t use a plan — countsTowardQuota=false makes every session of the type an open class: any active member books it with or without a plan, the booking carries no subscription (no credit, cap or quota use, no refund), and only the debt block of the billing gate still applies. Default true. Changing it only affects new bookings; existing ones keep their subscription. Full rules: scheduling-bookings › Open classes.

Golden paths

Owner: add a new class

1. With workout-text-first-authoring on: go to /dashboard/schedule and open Settings (the cog beside the greeting, schedule-settings-trigger). The sheet holds three views, Class types first, Timetable templates, and Booking Policies (owners and admins; a coach sees the first two). ?settings=class-types opens it on class types; the Workouts page’s empty Plan grid links there. Off: the schedule toolbar’s “This week” menu has a Class types item (schedule-setup-class-types) that opens the same class-types sheet.
2. Click “Add class type” (the program is the schedule program the sheet was opened for), name it, set defaults (60 min, capacity 20, default space, color), and toggle hasWorkout if it’s a no-program class. “Deducts an entry from the member’s plan” (ct-counts-toward-quota) sits under Advanced (ct-advanced), open by default only for a class type that is already open; switch it off for an open class. The class-types table badges such a type classTypes.noQuotaBadge (“No entry deducted”).
3. POST /organizations/:orgId/class-types returns the new row + program metadata.
4. The class type appears in the create-session form.

Owner: deactivate

1. Open class type; click “Delete”.
2. DELETE /organizations/:orgId/class-types/:id.
3. The class type disappears from findAll. Historical sessions still resolve classType (relational query returns the row regardless of is_active).

Edge cases & error states

Side effects

None outside the row mutation itself. No events emitted, no notifications, no cascades.

Permissions

All endpoints require an active membership in the org; cross-org access fails at requireMembership (403) or the program.organizationId post-check (404).