greeneclipse
8580c996c3
Drop one-shot tmp/axe scripts and agent i18n scratch so the Gitea tree is deployable.
46 lines
2.1 KiB
Markdown
46 lines
2.1 KiB
Markdown
# 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
|
|
```
|