Phase Handover — XP-Reg Experience Platform Registration
Metadata
| Field |
Value |
| Phase ID |
experience-reg |
| Title |
Experience Platform Registration |
| Status |
Complete |
| Service(s) |
experience (registered; not yet implemented) |
| Version |
n/a (docs-only) |
| Date |
2026-07-25 |
| ADR(s) |
ADR-016 |
Reusable Components
| Component |
Location |
Reuse notes |
| Platform registration pattern |
Same as Delivery DP-Reg / Sports Center |
Docs + ADR + manifests before code |
| Service template |
service-template.md |
Use in Phase 11.0 |
| Phase template |
phase-template.md |
Use for 11.x phase docs |
Public APIs
| Method |
Path |
Auth / Permission |
Notes |
| — |
— |
— |
N/A — registration only; APIs begin in Phase 11.0 |
Planned surfaces (not implemented): /health, /capabilities, /metrics, /api/v1/* under experience.* permissions.
Events
| Event type |
Domain / Integration |
Payload summary |
Version |
experience.* (planned) |
Experience domain |
Publish-only; catalog grows per phase |
Planned |
Extension Points
| Extension point |
How to extend |
Forbidden uses |
| Theme packs |
Theme module + versioned assets refs |
Hardcoding brand tokens in code |
| Component marketplace |
Versioned component registry |
Binary media in Experience DB |
| Consumer connectors |
Versioned REST/events for verticals |
Shared DB with Hospitality/Marketplace |
| AI content hooks |
Optional contracts; core works offline |
Hard dependency on AI for publish |
| Bundle licensing |
Entitlement keys via Core |
Duplicating Core plan engine |
Known Limitations
- No
backend/services/experience code yet — Phase 11.0
- No Alembic migrations yet
- No compose wiring / runtime health yet
- Page Builder / public site UI deferred to frontend phases
- Vertical menu/product catalogs remain owned by Hospitality/Marketplace
- Historical
website_builder scaffold not removed; prefer experience for new work
Migration Notes
| Item |
Detail |
| Alembic revision(s) |
N/A (docs-only) |
| Upgrade steps |
N/A |
| Downgrade support |
N/A |
| Data backfill |
N/A |
| Breaking changes |
None |
Dependencies
| Dependency |
Type |
Required for |
| AI Framework |
Docs |
Development loop / gates |
| ADR-001 / 002 / 003 / 006 / 008 / 011 / 012 / 015 / 016 |
Architecture |
Boundaries |
| Core Platform |
Service |
Entitlement (from 11.0) |
| File Storage |
Service |
Media refs (from 11.5) |
| Communication |
Service |
Form/notify flows (later) |
Next Phase Entry
| Field |
Value |
| Recommended next phase |
experience-11.0 Foundation |
| Blockers for next phase |
None for scaffold; runtime compose optional until wired |
| Entry checklist |
Read this handover + experience-roadmap.md + ADR-016 + service-template.md; implement only foundation shells — no page/theme/template engines yet |
What the next phase must read and assume:
- This handover + experience-roadmap.md
- Updated module-registry.md / manifests
- Open limitations above become Phase 11.0 scope (scaffold only)
- Suggested next phase ID:
experience-11.0
Completion Sign-Off
Related Documents
203671a7bf