Mortezakoohjani 091b33a638 feat(platform): finalize commercial runtime, platform shell and hospitality production frontend

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-07-28 20:39:10 +03:30

4.0 KiB

Raw Blame History

Commercial Platform Foundation Report

Phase: commercial-foundation
Date: 2026-07-28
Type: Architecture + Contracts + Admin Integration (docs only)
ADR: ADR-023

Architecture Summary

Platform commercial layer owned by Core Platform:

Business Bundles package services/modules/features with visibility & lifecycle — not frontend-only, not Payment-only.
Pricing Catalog is independent; bundles only hold pricing references.
Subscriptions / Licenses / Entitlements form the commercial grant chain.
Business Types + rule-based recommendations suggest packages without activation.
Activation pipeline is event-contracted end-to-end.
Service L2 packs (Payment, Experience, verticals) remain service-owned and are referenced, never absorbed.

Primary architecture doc: commercial-platform-architecture.md

Contracts Summary

Contract	Path	Version
Business Bundle	business-bundle-contracts.md	`business-bundle.v1`
Bundle catalog	business-bundles.md + YAML	catalog SoT
Pricing Catalog	pricing-catalog.md	`pricing-catalog.v1`
Subscription	subscription-contracts.md	`subscription.v1`
License & Entitlement	license-entitlement-contracts.md	`license-entitlement.v1`
Business Type	business-type-catalog.md	`business-type.v1`
Recommendation	recommendation-contracts.md	`recommendation.v1`
Activation	activation-flow-contracts.md	`activation.v1`
Admin portal spec	commercial-admin-portal-spec.md	screens only
Compatibility	commercial-compatibility-matrix.md	validation

Business Bundle Matrix

See business-bundles.md §1 — 18 catalog entries from Restaurant Starter through Platform Trial; bundle.marketplace.seller is draft (marketplace product not in this wave).

Business Type Matrix

17 types (Restaurant → Custom) with recommended bundles/services — business-type-catalog.md.

Activation Flow

Business Created → Bundle Selected → Subscription Requested → License Requested
→ Accounting Contract Requested → Payment Activation Requested → Workspace Initialized
→ Tenant Configuration Applied → Dashboard Generated

Events only: activation-flow-contracts.md.

Remaining Future Work (NOT started)

Item	Notes
Core commercial storage + APIs	Registered future implementation phase required
Subscription / license engines
Entitlement projector + admin grants
Recommendation rule evaluator	Rules contracts exist; no engine
Admin portal React screens	Spec only
FE catalog codegen from YAML	Mirror still temporary
Payment 14.6+	Explicitly out of scope
Experience FE-11.6+	Out of scope
QR / Short Links / Booking / Marketplace / Torbat Credit	Out of scope

Quality Gates

Gate	Result
No backend / migrations / APIs / DB	Pass
No future product implementation	Pass
Pricing not inside bundles	Pass
No cross-service ownership violations	Pass
Frontend not SoT for bundles	Pass (docs/YAML SoT; FE marked generated-candidate)

STOP

Commercial Platform Foundation documentation wave complete. No further product implementation under this phase.

4.0 KiB Raw Blame History