e41ecfad4c
Include Loyalty/Communication/Sports Center backends and registry updates alongside production nginx and compose wiring. Co-authored-by: Cursor <cursoragent@cursor.com>
4.0 KiB
4.0 KiB
Phase 9.1 — Sports Center Membership Catalog
| Field | Value |
|---|---|
| Status | Complete |
| Module | sports_center (Membership Catalog) |
| Version | 0.9.1.0 |
| Database | sports_center_db |
| API Port | 8006 |
| ADR | ADR-001, ADR-003, ADR-006, ADR-014 |
| Previous | Phase 9.0 · Handover 9.0 |
Goal
Deliver the Membership Catalog for the independent Sports Center Platform: commercial and policy definitions that membership assignments (Phase 9.2) will consume.
This phase does not implement member enrollment workflows, cards/QR issuance, coach engines, attendance, or booking.
Scope Completed
| Area | Deliverable |
|---|---|
| Membership Types | Extended with catalog links (package/plan/pricing/age/category/policies), transferability, sort order |
| Packages | membership_packages aggregate + APIs |
| Plans | membership_plans aggregate + APIs |
| Pricing Models | pricing_models (fixed/recurring/tiered/usage/custom) — amounts are catalog config, not Accounting journals |
| Age Groups | age_groups with min/max validation |
| Sport Categories | sport_categories catalog grouping |
| Membership Rules | Declarative membership_rules (eligibility/access/usage/transfer/custom) |
| Renewal Policies | renewal_policies |
| Freezing Rules | freezing_rules |
| Expiration Policies | expiration_policies |
| Validation | Age range, money amount, pricing/billing/rule enums, catalog ref integrity |
| Events | sports_center.{sport_category,age_group,pricing_model,membership_package,membership_plan,membership_rule,renewal_policy,freezing_rule,expiration_policy,membership_type}.* |
| APIs | Catalog routes under /api/v1/* + /capabilities |
| Docs | This file + handover + registries/manifests |
Out of Scope
- Member / family / medical / card / waiver management (Phase 9.2)
- Coach & staff engines (Phase 9.3)
- Scheduling & booking (Phase 9.4)
- Attendance engine (Phase 9.5)
- Accounting postings / payment capture (Phase 9.8)
- AI analytics (Phase 9.9)
Architecture Decisions
- Catalog entities are independent aggregates with UUID refs only (no ORM relationship graphs).
- Pricing amounts live in Sports Center as configuration; journals remain Accounting-only (ADR-010).
- MembershipType remains the primary commercial product SKU; packages/plans/policies attach via optional refs.
- Backward compatible: new MembershipType columns are nullable / defaulted; existing 9.0 APIs remain valid.
Public APIs (new / extended)
| Resource | Prefix |
|---|---|
| Sport categories | /api/v1/sport-categories |
| Age groups | /api/v1/age-groups |
| Pricing models | /api/v1/pricing-models |
| Membership packages | /api/v1/membership-packages |
| Membership plans | /api/v1/membership-plans |
| Membership rules | /api/v1/membership-rules |
| Renewal policies | /api/v1/renewal-policies |
| Freezing rules | /api/v1/freezing-rules |
| Expiration policies | /api/v1/expiration-policies |
| Membership types | /api/v1/membership-types (extended fields) |
| Capabilities | /capabilities |
Permissions
New trees: sports_center.sport_categories.*, age_groups.*, pricing_models.*, membership_packages.*, membership_plans.*, membership_rules.*, renewal_policies.*, freezing_rules.*, expiration_policies.*.
Migration
| Revision | Description |
|---|---|
0002_phase_91_membership_catalog |
Catalog tables + MembershipType additive columns |
Tests
Architecture, catalog API happy path, tenant isolation, age validation, capabilities, docs presence, permissions/events.