SD-0001: Solution Design — MVP sign up and create a single storefront (Feature #1) #2

Merged
ben.stull merged 12 commits from claude/optimistic-lumiere-ef8b1e into main 2026-06-10 14:12:57 +00:00
Showing only changes of commit 45f6ef8b58 - Show all commits
@@ -5,8 +5,8 @@
| **Anchor** | [wiggleverse/wiggleverse-ecomm#1](https://git.wiggleverse.org/wiggleverse/wiggleverse-ecomm/issues/1) (`type/feature`, `priority/P1`) | | **Anchor** | [wiggleverse/wiggleverse-ecomm#1](https://git.wiggleverse.org/wiggleverse/wiggleverse-ecomm/issues/1) (`type/feature`, `priority/P1`) |
| **Author(s)** | Claude (session ecomm-0020), for Ben Stull | | **Author(s)** | Claude (session ecomm-0020), for Ben Stull |
| **Reviewers / approvers** | Ben Stull | | **Reviewers / approvers** | Ben Stull |
| **Status** | `draft` | | **Status** | `approved` |
| **Version** | v0.1.0 | | **Version** | v0.2.0 |
| **Source artifacts** | BDD corpus: [research/shopify](https://git.wiggleverse.org/wiggleverse/wiggleverse-ecomm-prototype-content/src/branch/main/research/shopify) (esp. [flows/first-run-experience.md](https://git.wiggleverse.org/wiggleverse/wiggleverse-ecomm-prototype-content/src/branch/main/research/shopify/flows/first-run-experience.md)) · Prototype: [wiggleverse-ecomm-prototype](https://git.wiggleverse.org/wiggleverse/wiggleverse-ecomm-prototype) (R01R07) · Reference: Shopify first-run experience · Supersedes: — | | **Source artifacts** | BDD corpus: [research/shopify](https://git.wiggleverse.org/wiggleverse/wiggleverse-ecomm-prototype-content/src/branch/main/research/shopify) (esp. [flows/first-run-experience.md](https://git.wiggleverse.org/wiggleverse/wiggleverse-ecomm-prototype-content/src/branch/main/research/shopify/flows/first-run-experience.md)) · Prototype: [wiggleverse-ecomm-prototype](https://git.wiggleverse.org/wiggleverse/wiggleverse-ecomm-prototype) (R01R07) · Reference: Shopify first-run experience · Supersedes: — |
**Change log** **Change log**
@@ -14,6 +14,7 @@
| Date | Version | Change | By | | Date | Version | Change | By |
| --- | --- | --- | --- | | --- | --- | --- | --- |
| 2026-06-10 | v0.1.0 | Initial draft (session ecomm-0020) | Claude | | 2026-06-10 | v0.1.0 | Initial draft (session ecomm-0020) | Claude |
| 2026-06-10 | v0.2.0 | Self-review fixes; status → `approved` under the session's autonomous posture (handbook §6.5) — operator amendments welcome as v0.2.x | Claude |
--- ---
@@ -118,7 +119,7 @@ nothing built on top can ever actually launch.
- One storefront per merchant is the right *experience* bar for the MVP; - One storefront per merchant is the right *experience* bar for the MVP;
multiple-storefront merchants are a future need, not a current one. Risk multiple-storefront merchants are a future need, not a current one. Risk
if wrong: an early merchant genuinely needs a second storefront — accepted; if wrong: an early merchant genuinely needs a second storefront — accepted;
the door is designed to stay open (§1.7, #1 acceptance). the data is designed to keep that door open (Feature #1 constraint; INV-4).
- Merchants are reachable by email and will complete an email-based step to - Merchants are reachable by email and will complete an email-based step to
join. Risk if wrong: an entry channel rethink — accepted at MVP scale. join. Risk if wrong: an entry channel rethink — accepted at MVP scale.
- **Constraints:** - **Constraints:**
@@ -706,6 +707,7 @@ sequenceDiagram
participant SPA as Admin SPA participant SPA as Admin SPA
participant BFF as REST BFF participant BFF as REST BFF
participant ACC as accounts participant ACC as accounts
participant SF as storefronts
participant M as mailer (port) participant M as mailer (port)
participant DB as SQLite participant DB as SQLite