# 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](../architecture/adr/ADR-016.md) |

## 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](../ai-framework/service-template.md) | Use in Phase 11.0 |
| Phase template | [phase-template.md](../ai-framework/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](../experience-roadmap.md) + [ADR-016](../architecture/adr/ADR-016.md) + [service-template.md](../ai-framework/service-template.md); implement only foundation shells — no page/theme/template engines yet |

What the next phase must read and assume:

1. This handover + [experience-roadmap.md](../experience-roadmap.md)
2. Updated [module-registry.md](../module-registry.md#experience) / manifests
3. Open limitations above become Phase 11.0 scope (scaffold only)
4. Suggested next phase ID: `experience-11.0`

## Completion Sign-Off

- [x] Quality gates passed (documentation / architecture / manifest / cross-reference / links)
- [x] Tests green (N/A service pytest — docs-only; validation checks)
- [x] Documentation updated
- [x] Progress / next-steps / registries updated
- [x] No unfinished claimed deliverables
- [x] Self audit completed

## Related Documents

- [Experience Roadmap](../experience-roadmap.md)
- [Phase XP-Reg](../experience-phase-xp-reg.md)
- [Phase Area](../phases/Experience/README.md)
- [ADR-016](../architecture/adr/ADR-016.md)
- [Phase Manifest](../ai-framework/phase-manifest.yaml)
- [Service Manifest](../ai-framework/service-manifest.yaml)
- [Quality Gates](../ai-framework/quality-gates.md)