# 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.
