# Framework / Workstream Snapshot — Commercial Platform Foundation

schema_version: 1
snapshot_version: 3
workstream: commercial-foundation
layer: platform-commercial
current_phase: commercial-foundation-v1.2
last_completed_phase: commercial-foundation-v1.2
base_phase: commercial-foundation
next_phase: null
contract_family: commercial.v1.2
architecture_status: ARCHITECTURE_COMPLETE
project_status: docs/project-status.yaml
architecture: docs/architecture/commercial-platform-architecture.md
adr: docs/architecture/adr/ADR-023.md
report_v1: docs/commercial-platform-foundation-report.md
report_v1_1: docs/commercial-platform-foundation-v1.1-report.md
report_v1_2: docs/commercial-platform-foundation-v1.2-report.md
last_handover_reference: docs/phase-handover/phase-commercial-foundation-v1.2.md
last_updated: "2026-07-28"

capabilities_documented:
  - business_bundle_architecture
  - pricing_catalog_contracts
  - subscription_contracts
  - license_entitlement_contracts
  - business_type_catalog
  - recommendation_rule_contracts
  - activation_flow_events
  - commercial_admin_portal_spec
  - cross_service_compatibility_validation
  - platform_product_catalog
  - dynamic_product_registry
  - marketplace_compatibility_declarations
  - capability_registry
  - automation_catalog
  - extension_registry
  - commercial_dependency_graph
  - future_product_rules
  - asset_registry
  - asset_lifecycle
  - asset_marketplace_contracts
  - metadata_registry
  - policy_engine_contracts
  - policy_targets
  - registry_versioning
  - universal_reference_contracts

canonical_sources:
  - docs/reference/business-bundles.md
  - docs/reference/business-bundles.catalog.yaml
  - docs/reference/business-bundle-contracts.md
  - docs/reference/pricing-catalog.md
  - docs/reference/subscription-contracts.md
  - docs/reference/license-entitlement-contracts.md
  - docs/reference/business-type-catalog.md
  - docs/reference/recommendation-contracts.md
  - docs/reference/activation-flow-contracts.md
  - docs/reference/commercial-admin-portal-spec.md
  - docs/reference/commercial-compatibility-matrix.md
  - docs/reference/product-catalog.md
  - docs/reference/product-registry.md
  - docs/reference/capability-registry.md
  - docs/reference/automation-catalog.md
  - docs/reference/extension-registry.md
  - docs/reference/dependency-graph.md
  - docs/reference/asset-registry.md
  - docs/reference/asset-lifecycle.md
  - docs/reference/asset-marketplace-contracts.md
  - docs/reference/metadata-registry.md
  - docs/reference/policy-engine-contracts.md
  - docs/reference/policy-targets.md
  - docs/reference/registry-versioning.md
  - docs/reference/universal-reference-contracts.md

explicitly_not_implemented:
  - fe_catalog_codegen
  - marketplace_commerce
  - payment-14.6+
  - experience-fe-11.6+
  - qr_short_link_booking_marketplace_credit_engines

open_todos:
  - Codegen frontend/lib from business-bundles.catalog.yaml (optional)

known_limitations:
  - ARCHITECTURE COMPLETE documents contracts; runtime storage lives in commercial-runtime-backend
  - frontend/lib/business-bundles.ts remains a temporary Wave-1 mirror until codegen
  - Backend SoT: docs/service-snapshots/commercial-runtime-backend.yaml
