203671a7bf
Add the experience service with sites through analytics/AI hooks, migrations through 0011, and phase docs/manifests marking the track complete. Co-authored-by: Cursor <cursoragent@cursor.com>
133 lines
4.0 KiB
Markdown
133 lines
4.0 KiB
Markdown
# Phase: Experience Platform Registration (XP-Reg)
|
||
|
||
| Field | Value |
|
||
| --- | --- |
|
||
| Identifier | `experience-reg` |
|
||
| Status | Complete |
|
||
| Owner | Platform |
|
||
| Module(s) | Experience Platform (registration only) |
|
||
| Service(s) | `experience` (registered; not yet implemented) |
|
||
| Depends On | `onboarding-4`, `ai-framework` |
|
||
| ADR(s) | [ADR-016](architecture/adr/ADR-016.md) |
|
||
| Manifest | [phase-manifest.yaml](ai-framework/phase-manifest.yaml) |
|
||
|
||
## Objective
|
||
|
||
Register the independent Enterprise Experience Platform (commercial product **Torbat Pages**) in architecture, manifests, registries, glossary, and roadmap — with zero business code — so Phase 11.0 can scaffold the service safely.
|
||
|
||
## Scope
|
||
|
||
### In Scope
|
||
|
||
- ADR-016 Accepted — independent `experience` service + `experience_db`
|
||
- Service registration in [service-manifest.yaml](ai-framework/service-manifest.yaml)
|
||
- Phase registration XP-Reg + 11.0–11.10 in [phase-manifest.yaml](ai-framework/phase-manifest.yaml)
|
||
- Module registry entry + planned module inventory
|
||
- Glossary terms for Experience / Torbat Pages
|
||
- Module boundaries + database architecture + schema notes
|
||
- Roadmap and phase area README
|
||
- Progress / next-steps / roadmap updates
|
||
- Phase handover
|
||
|
||
### Modules
|
||
|
||
| Module | Change type | Notes |
|
||
| --- | --- | --- |
|
||
| Experience Platform | register | Docs/manifests only |
|
||
|
||
### Models
|
||
|
||
N/A — documentation-only registration. No ORM models.
|
||
|
||
### Repositories
|
||
|
||
N/A
|
||
|
||
### Services
|
||
|
||
N/A
|
||
|
||
### Validators
|
||
|
||
N/A
|
||
|
||
### Permissions
|
||
|
||
| Permission | Description |
|
||
| --- | --- |
|
||
| `experience.*` | Planned tree; concrete resources from Phase 11.0 |
|
||
|
||
### Events
|
||
|
||
| Event | When |
|
||
| --- | --- |
|
||
| `experience.*` (planned) | Publish-only catalog grows per phase |
|
||
|
||
### APIs
|
||
|
||
| Method | Path | Permission |
|
||
| --- | --- | --- |
|
||
| — | — | N/A until Phase 11.0 (`/health`, `/capabilities`, `/metrics`, `/api/v1/*`) |
|
||
|
||
### Tests
|
||
|
||
- [x] Unit — N/A (docs-only)
|
||
- [x] Repository — N/A
|
||
- [x] Service — N/A
|
||
- [x] Integration / API — N/A
|
||
- [x] Migration — N/A
|
||
- [x] Permission — documented planned prefix only
|
||
- [x] Security — N/A runtime
|
||
- [x] Performance — N/A
|
||
- [x] Tenant Isolation — architecture declared; enforced from 11.0
|
||
- [x] Documentation Validation — manifests parse; links resolve; registries aligned
|
||
|
||
### Documentation
|
||
|
||
- [x] Phase doc (this file)
|
||
- [x] Progress / Next Steps / Roadmap
|
||
- [x] Module Registry / glossary / boundaries
|
||
- [x] Reference schema note for `experience_db`
|
||
- [x] ADR-016
|
||
- [x] Manifests updated
|
||
- [x] Handover completed
|
||
|
||
## Out of Scope
|
||
|
||
- Any `backend/services/experience` code, models, APIs, migrations, compose wiring
|
||
- Page builder UI / public render UI
|
||
- Implementing Sites, Components, Themes, Templates, Forms, SEO, Bundles
|
||
- Migrating or deleting historical `website_builder` scaffold (prefer Experience for new work per ADR-016)
|
||
|
||
## Dependencies
|
||
|
||
| Dependency | Type | Notes |
|
||
| --- | --- | --- |
|
||
| AI Framework | Docs | Loop / gates |
|
||
| ADR-001 / 002 / 003 / 006 / 008 / 011 / 012 / 015 | Architecture | Boundaries |
|
||
| Core Platform | Service | Entitlement from 11.0 |
|
||
|
||
## Risks
|
||
|
||
| Risk | Mitigation |
|
||
| --- | --- |
|
||
| Confusion with `website_builder` scaffold | ADR-016 + glossary + registry notes prefer `experience` |
|
||
| Scope creep into page engines in Reg | Explicit docs-only completion criteria |
|
||
|
||
## Completion Criteria
|
||
|
||
- [x] Service registered with `experience_db` and `experience.*`
|
||
- [x] Phases 11.0–11.10 registered
|
||
- [x] Module registry, glossary, module-boundaries, ADR-016 updated
|
||
- [x] Progress and next-steps updated; handover complete
|
||
- [x] No business code in this phase
|
||
- [x] Quality gates for documentation/architecture/manifest validation passed
|
||
|
||
## Related Documents
|
||
|
||
- [Experience Roadmap](experience-roadmap.md)
|
||
- [Handover](phase-handover/phase-xp-reg.md)
|
||
- [ADR-016](architecture/adr/ADR-016.md)
|
||
- [Phases / Experience](phases/Experience/README.md)
|
||
- [AI Framework](ai-framework/README.md)
|