95 lines
4.0 KiB
Markdown
95 lines
4.0 KiB
Markdown
# Commercial Platform Foundation Report
|
|
|
|
**Phase:** `commercial-foundation`
|
|
**Date:** 2026-07-28
|
|
**Type:** Architecture + Contracts + Admin Integration (docs only)
|
|
**ADR:** [ADR-023](architecture/adr/ADR-023.md)
|
|
|
|
---
|
|
|
|
## 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](architecture/commercial-platform-architecture.md)
|
|
|
|
---
|
|
|
|
## Contracts Summary
|
|
|
|
| Contract | Path | Version |
|
|
| --- | --- | --- |
|
|
| Business Bundle | [business-bundle-contracts.md](reference/business-bundle-contracts.md) | `business-bundle.v1` |
|
|
| Bundle catalog | [business-bundles.md](reference/business-bundles.md) + [YAML](reference/business-bundles.catalog.yaml) | catalog SoT |
|
|
| Pricing Catalog | [pricing-catalog.md](reference/pricing-catalog.md) | `pricing-catalog.v1` |
|
|
| Subscription | [subscription-contracts.md](reference/subscription-contracts.md) | `subscription.v1` |
|
|
| License & Entitlement | [license-entitlement-contracts.md](reference/license-entitlement-contracts.md) | `license-entitlement.v1` |
|
|
| Business Type | [business-type-catalog.md](reference/business-type-catalog.md) | `business-type.v1` |
|
|
| Recommendation | [recommendation-contracts.md](reference/recommendation-contracts.md) | `recommendation.v1` |
|
|
| Activation | [activation-flow-contracts.md](reference/activation-flow-contracts.md) | `activation.v1` |
|
|
| Admin portal spec | [commercial-admin-portal-spec.md](reference/commercial-admin-portal-spec.md) | screens only |
|
|
| Compatibility | [commercial-compatibility-matrix.md](reference/commercial-compatibility-matrix.md) | validation |
|
|
|
|
---
|
|
|
|
## Business Bundle Matrix
|
|
|
|
See [business-bundles.md](reference/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](reference/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](reference/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.
|