Files
Bastien ChanotandClaude Opus 4.7 0aa8f46f5c 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>
2026-05-18 22:01:02 +02:00

155 lines
5.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.