64 lines
11 KiB
Markdown
64 lines
11 KiB
Markdown
# Test fixtures
|
||
|
||
Golden inputs frozen for the characterisation tests (plan Step 1). They describe
|
||
the Report v2 document as the current application produces it.
|
||
|
||
| File | Content |
|
||
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||
| `report-v2.full.json` | One report exercising every zone kind the editor can produce: plain hinge point, bilateral joint with both sides, spine zone with vertebrae, detail-popup zone, catalog findings (with and without vet referral and side), free text, severity, comment, conclusion, recommendations, dated next appointment. `boneId` values are the real `data-anno-id` of the legacy `Horse.svg` / `Horse_head.svg` now kept under `supabase/seed/anatomical-sheets/equine/legacy-sources/`; `zoneId`/`path` values exist in `pathologies.json`. |
|
||
| `report-v2.minimal.json` | Smallest valid v2 report (no observations). |
|
||
| `report-v2.full.pdf`, `report-v2.minimal.pdf` | The two reports exported by the v2 pipeline (commit 199e328, Step 5.0, rasteriser stubbed to a 1×1 PNG, no logos): the archive-like PDFs the v3 importer must read and migrate. Synthetic data only. |
|
||
|
||
Do not edit these files to make a test pass: they are the behavioural oracle for
|
||
the Report v2 → v3 adapter and for PDF regression. Add a new fixture instead.
|
||
|
||
## Step 6 freeze (Phase 0, 2026-10-11)
|
||
|
||
What the PDF pipeline produced right before the Step 6 refactor, recorded by
|
||
`tests/unit/pdf.goldens.test.ts` on the bundled draft sheet
|
||
(`docs/development/STEP6_PDF_ARCHIVE_ANALYSIS.md` §17).
|
||
|
||
| File | Content |
|
||
| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||
| `report-v3.demo.json` | Report v3 on the draft (ids from `draft/document.json`), 6 observations: main-view points, head-view points, spine zone with vertebrae, bilateral zone with both sides, a vet-referral leaf, a leaf whose label holds an en dash (U+2013), free-text findings, severities, comments, conclusion, recommendations, period next appointment; `sheet` = the draft ref at freeze time. |
|
||
| `report-v3.bare.pdf` | The demo report exported by the current code (rasteriser stubbed to a 1×1 PNG, no logos, FR): import fixture for the engine. |
|
||
| `goldens/step6/text.<report>.<locale>.<logos>.json` | Every `drawText` of the export, in drawing order: `{ page, text, x, y, size, font }`, numbers rounded to 2 decimals. |
|
||
| `goldens/step6/images.<report>.<locale>.<logos>.json` | Every `drawImage`: `{ page, x, y, width, height }`. Recorded per locale too: the footer centres the "powered by" block on the label width, so the ZenQuality logo shifts between FR and EN. |
|
||
| `goldens/step6/links.<report>.<locale>.<logos>.json` | Every `/Annot /Link` read back from the saved PDF: `{ page, rect, uri }`. Per locale for the same footer reason. |
|
||
| `goldens/step6/views.<report>.json` | Per `(observation, view)` of the report, the highlighted SVG parsed: `viewBox`, halo filter present, highlighted elements, visible non-highlighted markers, remaining `data-*` attributes, `<title>` count. |
|
||
|
||
Reports: `v2full` (`report-v2.full.json` migrated), `demo` (`report-v3.demo.json`),
|
||
`v2unresolved` (legacy `sphenoid` and `ssb` leaves plus one `frontal` leaf, migrated;
|
||
zone-less, so its `images` and `views` goldens are empty). Logo modes: `nologos`
|
||
(every branding slot empty, 1×1 rasteriser) and `logos` (the four logo files bundled
|
||
under `apps/app/src/assets/brand`, rasteriser stubbed to a 2×1 PNG).
|
||
|
||
Never regenerate these files without a user decision; the Step 6 engine must
|
||
reproduce them. Generation, once: `MAKE_GOLDEN=1 corepack pnpm vitest run
|
||
tests/unit/pdf.goldens.test.ts` from `apps/app`.
|
||
|
||
## R4 freeze (2026-10-18)
|
||
|
||
What the TypeScript PDF engine and reader produced right before the Rust port,
|
||
frozen on branch `feature/rust-r4-pdf-core` (`docs/development/RUST.md` §10.1
|
||
lists every oracle with its commit). The generators (the `r4.*-oracles` vitest
|
||
suites of `packages/pdf` and `apps/app`) ran behind `MAKE_R4_ORACLES=1` and were
|
||
deleted with the TypeScript engine at R4.8 (2026-10-19): the files below are
|
||
frozen for good and checked by the cargo suites (`crates/core/tests/pdf_*.rs`);
|
||
only `r4/reports` (O13, `r4.synthetic-reports.test.ts`) and the R4 digests
|
||
(`goldens/r4/pdf.*.sha256`, cargo) keep a generator.
|
||
|
||
| Path | Content |
|
||
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||
| `r4/reports/{L,CAP}.json` | Synthetic Report v3 on the draft: 60 observations / 120 views (L) and 500 / 1,000 (CAP), the export memory inputs of plan §B.4 (O13). |
|
||
| `goldens/r4/draw.*.json` | Every drawing call of the export (text, image, line, rectangle, link) at full precision, per page and in call order, for the 12 Step 6 report × locale × logo combinations (O1). |
|
||
| `pdf/r3/` | The 12 PDFs the R3-era engine produced for those combinations, the store-path export with its `report.json`, and `real/v2full-obs1.fr.logos.pdf` with its two browser PNGs and manifest: the byte references of the writer port (O2). |
|
||
| `goldens/r4/pdf.*.sha256` | Digests of the Rust writer's own output on the 14 O2 runs (not an oracle of the TypeScript: the proof that the wasm module and the application path write the native bytes). Frozen at R4.5; rewritten once at R4.6 when the writer became incremental (catalog and page tree written last, upper-case hex strings as pdf-lib), every O2 comparison and the poppler render unchanged. `MAKE_R4_ORACLES=1 cargo test --test pdf_serialize r4_output_digests_are_frozen` rewrites them, never to hide a difference with O2. |
|
||
| `pdf/step6/envelope.*.pdf` | Three envelope PDFs from before R2 (O3). |
|
||
| `pdf/r4/tolerance/` | 51 PDFs, valid and hostile, with today's import outcome and message in `crates/core/tests/oracles/r4/tolerance.json` (O8). |
|
||
| `pdf/r4/read/`, `pdf/r4/inflate/` | 155 reader inputs and 24 zlib framing inputs, the bytes behind `read.json` and `inflate.json`; a `<slug>.gen.json` describes a large input by concatenation (O7, O9). |
|
||
|
||
Synthetic data only, no real bilan. Never regenerate these files to make a
|
||
test pass: a difference between the Rust port and an oracle is reported and
|
||
decided (plan §A.3), or it is a bug in the port.
|