Vision to Production — Commerce¶
Generated from the architecture model
This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.
This page applies the Vision-to-Production workflow to Headless commerce (example page). The steps are the Factory's reference run flow; the right-hand columns say what is specific to this vertical.
| # | Step | Platform | Specific to Commerce |
|---|---|---|---|
| 1 | Run submitted with the prompt and constraints | Control plane | residency tenant-region; edition Managed |
| 2 | Policy and snapshot resolved; budget reserved | Control plane, Governance | — |
| 3 | Vision Blueprint produced and validated | Agent Mesh, Template & Library | A retailer's storefront, catalog and order systems cannot be changed independently; promotions take weeks. |
| 4 | Product plan and personas | Agent Mesh | Catalog, pricing and promotions, cart and checkout, orders and fulfilment as separate contexts behind one API, with the storefront as a separate frontend. |
| 5 | Service Blueprint: contexts, aggregates, events | Agent Mesh, Template & Library | Catalog, Pricing, Checkout, Fulfilment |
| 6 | Context map and domain models derived | Template & Library (BC-02) | 4 contexts |
| 7 | Security, database, integration blueprints | Agent Mesh | api-gateway, database |
| 8 | UX and frontend blueprints | Agent Mesh, UX track | frontend |
| 9 | Recipe proposed from the context map | Template & Library (BC-15) | Microservice ×4, Pricing library, API gateway, Storefront MFEs |
| 10 | Recipe validated against manifests and the compatibility matrix | Template & Library (BC-14) | templates: connectsoft-microservice, connectsoft-library, connectsoft-apigateway, connectsoft-blazor-mfe |
| 11 | Recipe approved | Control plane (approval) | Requester or Reviewer per policy |
| 12 | Generation run: scaffold in the sandbox | Agent Mesh, Tools & MCP | Product Manager Agent, Enterprise Architect Agent, Backend Developer Agent, Frontend Developer Agent, Database Engineer Agent, QA Agent |
| 13 | Tests and validators | Tools & MCP, Knowledge (artifacts) | test blueprint thresholds |
| 14 | Change proposal (branch, pull request) | DevOps / GitOps (BC-23) | shared-write class |
| 15 | Review and merge in the system of record | DevOps / GitOps | human review |
| 16 | Pipeline run with typed results | DevOps / GitOps | build, tests, scan, SBOM, images |
| 17 | Release assembled with evidence | DevOps / GitOps (BC-24) | immutable release |
| 18 | Evaluation of agent-generated assets | Observability (BC-22) | regression gates (D32) |
| 19 | Promotion to staging; verification | DevOps / GitOps, Runtime Cloud | — |
| 20 | Production promotion with approval | DevOps / GitOps (production class) | separation of duties |
| 21 | Provisioning applied; descriptor published | Runtime Cloud (BC-25), the product | Pulumi stacks; GW-07 |
| 22 | Managed-operations handover acknowledged | the product owner | Managed |
| 23 | Fleet onboarding; objectives; probes | Product Fleet Operations (BC-35) | Managed; payment provider through a certified connector; PCI scope kept in the provider. |
| 24 | Feedback, learning proposals, re-scaffold on template releases | Observability (BC-22), Fleet (BC-36) | continuous |