Phase Handover — Workspace-Reg Workspace Platform Registration
Metadata
| Field |
Value |
| Phase ID |
workspace-reg |
| Title |
Workspace Platform Registration |
| Status |
Complete |
| Service(s) |
workspace / workspace-service (registered; not implemented) |
| Commercial Product |
Torbat Workspace |
| Version |
n/a (docs-only) |
| Date |
2026-09-12 |
| ADR(s) |
ADR-024 |
Enterprise Phase Discovery Summary
| Item |
Detail |
| Discovery Record location |
This handover |
| Gaps promoted & closed |
Independent work-management product, phases 15.0–15.11, commercial compatibility, naming collision with Core/Experience/Payment “workspace” |
| Exclusions (future / other service) |
All implementation; Commercial Runtime seed; CRM/Experience/File Storage/Accounting ownership |
| CRUD-only rejected |
Yes — registration is architecture, not CRUD |
Business Analysis Summary
| Item |
Detail |
| Capabilities delivered |
Architecture registration of Torbat Workspace + 20 capability keys (docs only) |
| Explicit non-goals honored |
No backend, frontend, database, migrations, APIs, models, repositories, services, tests, or runtime changes |
Reusable Components
| Component |
Location |
Reuse notes |
| Platform registration pattern |
Same as Payment Pay-Reg, Delivery DP-Reg, Experience XP-Reg |
Docs + ADR + manifests before code |
| Commercial future-product rule |
ADR-023 |
Registry rows later; no Core architecture change |
| Service template |
service-template.md |
Use in Phase 15.0 |
| Phase template |
phase-template.md |
Use for 15.x phase docs |
Public APIs
| Method |
Path |
Auth / Permission |
Notes |
| — |
— |
— |
N/A — registration only; APIs begin in workspace-15.0 |
Planned surfaces (not implemented): /health, /capabilities, /metrics, /api/v1/* under workspace.* permissions.
Events
| Event type |
Domain / Integration |
Payload summary |
Version |
workspace.* (planned) |
Torbat Workspace domain |
Publish-only; catalog grows per phase |
Planned |
Must not publish as experience.workspace.* or payment.workspace.*.
Permissions
| Permission |
Routes / actions |
workspace.* |
Reserved tree; detailed leaves at 15.0+ |
workspace.module.enabled |
Planned Core L1 entitlement |
Extension Points
| Extension point |
How to extend |
Forbidden uses |
| Capability flags |
Register workspace.<capability> |
Absorbing CRM/Experience/Storage domains |
| CRM refs |
Opaque crm_*_ref on 15.9 |
Importing CRM models |
| Accounting intents |
Events/API for cost/time intents |
JournalEntry creation inside Workspace |
| File refs |
file_ref to File Storage |
Storing blobs in workspace_db |
| AI hooks |
Optional AI Assistant contract (15.10) |
Hard dependency on AI for core PM |
| Commercial packaging |
PlatformProduct + capabilities + optional bundle |
Editing Commercial Runtime in this phase |
Known Limitations
- No
backend/services/workspace code
- No Alembic migrations
- No compose wiring / runtime health
- No Commercial Runtime product/capability seed
- No frontend
/workspace shell
- “Workspace” remains overloaded in everyday speech — docs must qualify Tenant / Experience / Payment / Torbat Workspace
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 — additive registration |
Dependencies
| Dependency |
Type |
Required for |
| AI Framework |
Docs |
Development loop / gates |
| ADR-001 / 002 / 003 / 006 / 010 / 012 / 016 / 022 / 023 / 024 |
Architecture |
Boundaries |
| Core Platform |
Service |
Entitlement (from 15.0) |
| Identity |
Service |
User refs (from 15.0) |
| CRM |
Service |
Optional refs (from 15.9) |
| Accounting |
Service |
Cost/time intents (from 15.9) |
| File Storage |
Service |
Binary refs (from 15.8) |
| AI Assistant |
Service |
Optional assistant (from 15.10) |
Discovery Record (Registration)
| Field |
Value |
| Discovery date |
2026-09-12 |
| Baseline |
No work-management platform; CRM has sales tasks/comments; Core “Workspace” is the Tenant |
| Gap |
Enterprise Work Management Platform missing as a registered product |
| Promoted scope |
Registration + full roadmap 15.0–15.11 + commercial compatibility declaration + ADR-024 |
| Excluded |
Implementation of 15.0+; modifications to existing runtime services |
Next Phase Entry
| Field |
Value |
| Recommended next phase |
workspace-15.0 Workspace Foundation |
| Blockers for next phase |
None for scaffold — do not start from this workstream unless execution_priority says so |
| Implementation Priority |
future (not on commercial-release critical path) |
What the next phase must read and assume:
- workspace-roadmap.md Phase 15.0 section
- ADR-024
- Updated module-registry.md / manifests / snapshot
- Implement foundation shells only — no projects, tasks, content, files, integrations, or AI
Completion Sign-Off
Related Documents