test(qa): document MVP manual QA checklist outcome
Capture the plan §23.2 walkthrough as an unticked checklist with deliberate TODO markers. Automated browser QA was out of scope for the /init-project session; this file is the handoff for a manual pnpm dev verification before delivery. Includes the matching automated coverage table so reviewers know what is already enforced by CI. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
1 parent
a33693580f
commit
0aa8f46f5c
1 file changed
+154
@@ -0,0 +1,154 @@
|
||||
# MVP — Manual QA Log
|
||||
|
||||
**Date:** 2026-05-18
|
||||
**Phase:** 23.2 — Final manual QA pass before delivery
|
||||
**Status:** NOT EXECUTED THIS SESSION
|
||||
|
||||
## Context
|
||||
|
||||
Automated browser walkthrough (`pnpm dev` + click-through) was **deliberately
|
||||
skipped** in the `/init-project` session that produced the MVP. The session
|
||||
spawned a non-interactive implementation agent, so a live browser dogfood was
|
||||
out of scope.
|
||||
|
||||
Everything below is the **expected behaviour checklist** distilled from the
|
||||
plan (phase 23.2, steps 1.x). Each item is `[ ]` (untested) and must be
|
||||
verified manually before declaring the MVP shippable.
|
||||
|
||||
To run the walkthrough:
|
||||
|
||||
```bash
|
||||
pnpm dev
|
||||
# open http://localhost:5173
|
||||
```
|
||||
|
||||
Then tick each box, annotate with PASS / WARN / FAIL, and capture screenshots
|
||||
into `.claude/audits/screenshots/` if anything is off.
|
||||
|
||||
---
|
||||
|
||||
## Checklist
|
||||
|
||||
### Home screen
|
||||
|
||||
- [ ] Home shows brand name, tagline, and both CTAs ("Nouveau bilan",
|
||||
"Importer un PDF").
|
||||
- [ ] Brand text matches `VITE_APP_BRAND_NAME` / `window.__APP_CONFIG__.brandName`
|
||||
when set, otherwise defaults to "Osteo Report".
|
||||
- [ ] Tagline matches `VITE_APP_TAGLINE` / runtime config or default.
|
||||
|
||||
### New-report flow
|
||||
|
||||
- [ ] Click "Nouveau bilan" → navigates to `/new`.
|
||||
- [ ] Practitioner section is **prefilled** if a previous report was cached
|
||||
(localStorage `osteo:practitioner:v1`).
|
||||
- [ ] Animal section is empty.
|
||||
- [ ] Submit → navigates to `/editor`.
|
||||
|
||||
### Editor — anatomy canvas
|
||||
|
||||
- [ ] Editor loads the Horse main SVG without console errors.
|
||||
- [ ] Zones are clickable (cursor change on hover).
|
||||
- [ ] Clicking a non-spine zone toggles its visible state to `current`
|
||||
(bright color).
|
||||
- [ ] Clicking a spine zone (e.g. cervical / thoracic / lumbar / sacral) ALSO
|
||||
opens the `VertebraPicker`; "Valider" stores the precise vertebra list.
|
||||
- [ ] Clicking the head zone opens the `DetailModal` with the head detail SVG.
|
||||
- [ ] Clicking inside the DetailModal adds detail zones to the current
|
||||
observation.
|
||||
|
||||
### Multi-observation behaviour
|
||||
|
||||
- [ ] Add a second observation via "+ Nouvelle observation".
|
||||
- [ ] Zones from the first observation now show the `linked` (muted) state
|
||||
on the main canvas while the new observation is empty.
|
||||
|
||||
### Pathology + free text
|
||||
|
||||
- [ ] `PathologyPicker` shows only entries whose `appliesToZones` matches the
|
||||
current observation's zones (or is empty/wildcard).
|
||||
- [ ] `FreeTextPathologyInput` adds free-text chips.
|
||||
- [ ] Removing a chip removes the pathology from the observation.
|
||||
|
||||
### Severity + comment
|
||||
|
||||
- [ ] Severity slider (0–10) is editable and the value is reflected in state.
|
||||
- [ ] Comment textarea is editable and persists across observation switches.
|
||||
|
||||
### Conclusion + recommendations + next RDV
|
||||
|
||||
- [ ] Conclusion textarea editable.
|
||||
- [ ] Recommendations textarea editable.
|
||||
- [ ] "Prochain RDV" date picker editable, accepts ISO date.
|
||||
|
||||
### PDF export
|
||||
|
||||
- [ ] Click "Exporter en PDF" → file `bilan-<animal-name>-<YYYY-MM-DD>.pdf`
|
||||
downloads.
|
||||
- [ ] Open the PDF in a viewer:
|
||||
- [ ] Cover page shows brand header, tagline, practitioner block, animal
|
||||
block, report date, conclusion.
|
||||
- [ ] One observation page per observation, each with rasterized colorized
|
||||
SVG + summary text.
|
||||
- [ ] Footer on every page shows brand name + page X / Y.
|
||||
|
||||
### PDF import (roundtrip)
|
||||
|
||||
- [ ] On Home, click "Importer un PDF" → file picker.
|
||||
- [ ] Pick the PDF just exported → editor reopens with full report state
|
||||
restored (zones, pathologies, severity, conclusion, etc.).
|
||||
- [ ] Now pick a random non-Osteo PDF → French ImportError shown
|
||||
(no crash, no partial state).
|
||||
|
||||
---
|
||||
|
||||
## Findings
|
||||
|
||||
> Per-row: PASS / WARN / FAIL + note.
|
||||
> **Currently all rows: NOT TESTED — automated browser QA out of scope for
|
||||
> /init-project session. Verify manually via `pnpm dev` before delivery.**
|
||||
|
||||
| # | Section | Result | Note |
|
||||
|---|--------------------|--------|------|
|
||||
| 1 | Home | TODO | Run `pnpm dev`, take screenshot. |
|
||||
| 2 | New-report flow | TODO | Verify localStorage prefill path. |
|
||||
| 3 | Canvas (zones) | TODO | Confirm DetailModal + VertebraPicker. |
|
||||
| 4 | Multi-obs states | TODO | Confirm `linked` colour. |
|
||||
| 5 | Pathology + free | TODO | Confirm zone filter. |
|
||||
| 6 | Severity + comment | TODO | Confirm persistence across switches. |
|
||||
| 7 | Conclusion + RDV | TODO | Confirm date picker. |
|
||||
| 8 | PDF export | TODO | Open downloaded PDF in viewer. |
|
||||
| 9 | PDF import | TODO | Roundtrip + non-osteo rejection. |
|
||||
|
||||
---
|
||||
|
||||
## Automated coverage already in place
|
||||
|
||||
| Surface | Where |
|
||||
|------------------------------|------------------------------------------------|
|
||||
| Schemas (Zod parse + reject) | `tests/unit/schema.*.test.ts` |
|
||||
| Anatomy parser (real + fake) | `tests/unit/anatomy.*.test.ts` |
|
||||
| Report store CRUD/mirror | `tests/unit/state.reportStore.test.ts` |
|
||||
| Practitioner cache | `tests/unit/state.practitionerCache.test.ts` |
|
||||
| Draft mirror | `tests/unit/state.draftMirror.test.ts` |
|
||||
| VertebraPicker UI | `tests/unit/components.VertebraPicker.test.tsx`|
|
||||
| PathologyPicker UI | `tests/unit/components.PathologyPicker.test.tsx`|
|
||||
| AnatomyCanvas | `tests/unit/components.AnatomyCanvas.test.tsx` |
|
||||
| PDF attachment + roundtrip | `tests/unit/pdf.*.test.ts` |
|
||||
|
||||
Total: **88 / 88 passing** as of 2026-05-18.
|
||||
|
||||
## CI gate
|
||||
|
||||
```
|
||||
pnpm lint ✅
|
||||
pnpm typecheck ✅
|
||||
pnpm test:run ✅ (88 tests)
|
||||
pnpm build ✅
|
||||
```
|
||||
|
||||
Docker image build (`docker build -t osteo-report:dev .`) was **skipped**
|
||||
because the Docker daemon is not available in this session. The
|
||||
`docker/entrypoint.sh` script was reviewed and `index.html` was patched to
|
||||
load `/env.js` before the Vite bundle, with a stub `public/env.js` so local
|
||||
dev does not 404 — runtime container writes the real `env.js` at start.
|
||||
Reference in new issue
Block a user