Initial commit of Descrybe v2 without local scratch artifacts.

Drop one-shot tmp/axe scripts and agent i18n scratch so the Gitea tree is deployable.
2026-08-09 22:47:43 +02:00
commit 8580c996c3
1285 changed files with 325780 additions and 0 deletions
@@ -0,0 +1,45 @@
+# Tutorial live test (forced tour on :5174)
+
+Date: 2026-08-04  
+App: `http://127.0.0.1:5174` (Descrybe v2 web)  
+Account: `demo@descrybe.local` (see [demo-user.md](./demo-user.md))  
+Tooling: codehelper `browser` + session jar  
+
+Related design doc: [tutorial.md](./tutorial.md)
+
+## Checklist results
+
+| Check | Result | Notes |
+|-------|--------|-------|
+| Start / Resume tutorial | PASS | Header + dashboard `data-tour` buttons open overlay |
+| Continue absent on action steps | PASS | Step 2 (`standard-fields-nav`) shows Skip / Back / Pause only; hint "Click the highlighted control" |
+| Nav click advances | PASS | Click `a[aria-label="Standard Fields"]` (`data-tour="nav-standard-fields"`) advanced to `enable-recommended` |
+| Skip works | PASS | Skip -> `localStorage` `status: skipped`, header shows **Restart tutorial** |
+| Restart works | PASS | Restart -> welcome step + **Let's go** |
+| `npm run check` (apps/web) | PASS | 0 errors, 0 warnings |
+
+## Sidebar redesign notes
+
+Primary nav after redesign: Dashboard, Products, Feeds, Export, Stores, Billing, **More** (collapsed).
+
+Tour targets under More (`nav-standard-fields`, `nav-campaigns`, ...) rely on `tutorialNeedsMore` in `Nav.svelte` to keep the More panel open while those steps are active. Live run confirmed More expands and Standard Fields is spotlighted.
+
+Tour steps already point Stores via `data-tour="nav-stores"` and `store-connect-feed-url` (matches `store-connect-{card.id}` for `feed-url`).
+
+## Known flakes / env
+
+- Full page reload (`browser` `url=`) dismisses the in-memory overlay (`active=false`) while keeping `in_progress` → use **Resume**, not a mid-tour reload.
+- Occasional CDP `context deadline exceeded` on a second nav click after Restart when Vite HMR is hot (not a product regression).
+- During one advance, `/api/field-groups` and `/api/standard-fields` returned **502** (API proxy). Overlay still advanced to the enable-recommended step; action completion would need a healthy API.
+
+## Storage
+
+Key: `descrybe.tutorial.v2`  
+Example after Skip: `{"version":2,"status":"skipped","stepId":"enable-recommended",...}`
+
+## Commands
+
+```bash
+cd apps/web
+npm run check
+```