TorbatYar/docs/phase-handover/phase-commercial-runtime-backend.md
Mortezakoohjani 0d424c500a feat(platform): complete commercial runtime consolidation
Unify commercial runtime ownership across backend and frontend so platform, experience, and hospitality modules use the shared commercial source of truth.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-29 11:11:53 +03:30

45 lines
1.8 KiB
Markdown

# Phase Handover — Commercial Runtime Backend
**Workstream:** Commercial Runtime Backend
**Phase ID:** `commercial-runtime-backend`
**Date:** 2026-07-28
**Status:** Complete
**Architecture status:** **COMMERCIAL_RUNTIME_BACKEND_COMPLETE**
**Service:** Core Platform (`backend/core-service`)
## Objective
Implement the complete Commercial Runtime Backend as the single SoT for commercial metadata — unlimited registries, discovery, engines, resolvers, events, OpenAPI, docs, green tests.
## Delivered
- Universal `CommercialRegistryObject` + `CommercialRegistryKind` meta-registry
- Built-in registry CRUD + `/registries/{kind}` + `GET /catalog`
- Recommendation / assessment / bundle / plan / license / policy engines
- Notification templates registry
- Subscription + license + activation tables (commercial lifecycle, not Payment ledger)
- Outbox events; Alembic `0007_commercial_runtime`; seed script
- Tests: `app/tests/test_commercial_runtime.py`**9 passed**
- Docs: final report, architecture report, snapshot, project-status
## Explicitly unchanged
- No edits to CRM, Payment, Delivery, Experience, Hospitality, Healthcare, Beauty, Accounting, Communication, Identity business modules
- No Marketplace / QR / Booking / Payment 14.6+ product engines
## Deploy notes
1. Migrate Core: Alembic upgrade including `0007_commercial_runtime`
2. Run `scripts/seed_commercial_runtime.py` (idempotent)
3. Verify `GET /api/v1/commercial/health` and `/catalog`
4. FE commercial adapters light up against live registries
## Next
Follow `docs/project-status.yaml` `execution_priority` / `critical_path` (Payment 14.6+, Hospitality 12.9+, …).
Future products: insert registry rows only.
## STOP
Do not start Marketplace, QR, Booking, Payment 14.6+, or CRM from this handover.