TorbatYar/docs/phase-handover/phase-workspace-reg.md
Mortezakoohjani a483b47369 feat(workspace): complete production workspace and content operations
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-12 11:54:17 +03:30

6.2 KiB
Raw Blame History

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:

  1. workspace-roadmap.md Phase 15.0 section
  2. ADR-024
  3. Updated module-registry.md / manifests / snapshot
  4. Implement foundation shells only — no projects, tasks, content, files, integrations, or AI

Completion Sign-Off

  • Quality gates passed (documentation / architecture / manifest / cross-reference)
  • Tests green (N/A — docs-only)
  • Documentation updated
  • Registries / project-status / next-steps / project index updated
  • Service snapshot generated (registration baseline)
  • No existing business services modified
  • Phase 15.0 NOT implemented (by design)