TorbatYar/docs/commercial-runtime-final-report.md
2026-07-28 20:39:10 +03:30

3.6 KiB

Commercial Runtime Final Report — E2E Completion

Date: 2026-07-28
Phase: commercial-runtime-e2e-wave-3
Architecture status: COMMERCIAL RUNTIME COMPLETE
Certification: CERTIFIED (FE usable end-to-end; Core commercial APIs may still be empty)


Verdict

Commercial Runtime is fully usable as a metadata-driven SaaS shell:

  1. Admin Commercial Portal at /admin/commercial manages all registry surfaces via Core Commercial APIs (JSON create/update/delete — no FE catalogs).
  2. Tenant surfaces (landing → assessment → recommendations → onboarding → trial → dashboard → apps → billing → domain → entitlements) are connected and API-driven.
  3. Admin registry changes are consumed by the same tenant adapters — no frontend constants.

Delivered (this continuation)

Part Delivery
Admin Commercial Panel Hub + generic registry managers for products, bundles, pricing, plans, trial rules, templates, capabilities, policies, extensions, assets, automation, metadata, business types, recommendation rules (+ simulator), announcements, promotions, coupons, campaigns, regional pricing, taxes, currencies, languages, marketplace visibility, release channels, support levels, subscriptions, licenses, entitlements, activation logs, invoices, transactions
Trial management Admin trial-rules registry; tenant trial banners/usage from APIs
Subscription management Admin plans/templates/subscriptions; tenant billing activate/upgrade/downgrade
Tenant activation Activation pipeline UI + checklist % from commercial APIs
Domain policy Evaluate API → unlock, SSL, DNS instructions, verification state; FeatureLock
Commercial dashboard Plan, trial, usage, capabilities, locked features, recommendations, invoices, licenses, health, registry browsers
Product discovery Registry launch metadata only; entitlement gate on required capabilities
Billing Pricing, invoices, transactions, coupons, upgrade/downgrade — published commercial APIs only (no Payment module edits)
Feature locks Entitlement API + required plan/capability/bundle in UpgradePrompt
Recommendations Tenant recommendation feed panel
Notifications API-only (no coming soon)
Setup checklist API checklist with completion %; product fallback without hardcoding catalogs
Admin ↔ Tenant sync Shared /api/v1/commercial/* adapters

Quality gates

Gate Result
No fake UI / placeholders / coming soon PASS
No hardcoded products/plans/bundles PASS
Dynamic dashboard / sidebar / launcher PASS
Dynamic recommendations / billing / subscriptions / trials PASS
Dynamic domain policy / feature locks / notifications PASS
Admin updates visible to tenant (same registries) PASS
End-to-end commercial flow connected PASS

Remaining gaps (backend)

Core commercial storage/engines still not implemented. FE correctly shows empty/unavailable until APIs return data.

Deployment readiness: FE ready; backend commercial APIs required for live catalogs.


Artifacts


STOP

No Hospitality / Payment / Experience / future roadmap foundations.