bchanot c21995b3fb feat(editor): collapsible reference tiles in the Références tab
Board 23 / 24 / 27 tiles: closed (citation on two lines, type, « Citée
{n} fois » / « Non citée »), open (Type, DOI, URL as safe links, the
citers with « famille » badge and « Aller à »), edit (« Terminer » with a
leave guard re-committing every changed field; a refusal keeps edit
and focuses the field). A cited reference shows the deletion hint, an
uncited one keeps « Supprimer ». Read-only keeps DOI, URL, « Aller à ».
« Terminer » keeps focus in the field on press, so a refusal message
can no longer move the button under the pointer.

Gates: typecheck, lint, test:run (app 1419), build, e2e:ui 251;
e2e:shell 16 specs on db:sandbox (editor-equine never listed): 111
passed / 99 skipped / 3 failed in the new editor-references.spec (two
test bugs, one app bug), fixed and rerun: 5 passed / 4 skipped; full-row
guard: no pre-existing row changed in any table.

## R-24 (removed or rewritten assertions)
| file | old | new |
|---|---|---|
| editor-citations.test.ts | `citationCounts` counts 2/1/0, memoised, empty | `citersOf`: ordered citers (Cat, Node), family flag, trail from zone, key, memoised, empty |
| editor-references-tab.test.tsx | cards say « citée N fois » (ref-a 1, ref-c 0) | « Citée 2 fois » (fixture gains a node citing ref-a), « Citée 1 fois », « Non citée » |
| same | ids `#tab-reference-ref-a-citation` exist when closed | header id `#tab-reference-0-ref-a-header`; field ids only inside an open edit tile |
| same | ↑/↓ on every card | in open tiles only, absent under a search |
| same | Ctrl+Z on an always-visible field | open tile, Modifier, then same assertion on `#tab-reference-0-ref-a-citation` |
| same | « Aller à » focuses the card (`listitem` count 3, focus key) | tile opened (aria-expanded true), header focused, 3 tiles |
| same | add: `getByText('Nouvelle source')` | tile header named « Nouvelle source » |
| same | read-only: no Supprimer / add | same after opening every tile |
| editor-tabs-lists.test.tsx | edit on blur and arrows on always-open cards | open tile, Modifier, blur applies, Terminer, Monter on opened tile |
| same | cited reference deletion refused in a dialog listing citers | REMOVED: no Supprimer on a cited tile (hint asserted, citer listed); uncited delete kept. The dialog's blocked path stays covered by `DeleteDialog`'s own tests |
| same | read-only: no button at all | read-only: facts shown, no Modifier / Supprimer / Citation textbox (header buttons exist now) |
| editor-keep-alive.test.tsx:~330 | tab-click commit of `#tab-reference-ref-1-citation` | opens tile + Modifier first, id `#tab-reference-0-ref-1-citation` |
| editor-keep-alive.test.tsx:~350,367 | `#panel-reference-ref-1-citation` | `#panel-reference-0-ref-1-citation` |
| editor-references-panel.test.tsx | « citée 2 fois / 1 fois » | « Citée 2 fois / 1 fois » |
| same | `#panel-reference-ref-a-citation`; no `#tab-reference-ref-a-citation` | `#panel-reference-0-ref-a-citation`; no `[id^="tab-reference-"]` while the tab tiles are closed |
| same | ids unique, tab and panel field ids present | tab tile opened in edit first; `tab-reference-0-ref-a-citation` and `panel-reference-0-ref-a-citation` unique |
| e2e editor-structures.spec.ts:~88-110 | citation inputs count 3/1/2, « citée 0 fois » x2, « citée 1 fois », move via row buttons | tile headers count, « Non citée » x2, « Citée 1 fois », tile opened before Monter/Supprimer, `tiles.nth(1)` contains the moved text (saved-list assertion unchanged) |

## i18n (fr / en)
Changed (in place, P18): `editor.references.cited_one|other`: « citée {count} fois » -> « Citée {count} fois »; « cited {count} time(s) » -> « Cited {count} time(s) ».
Added: `editor.references.uncited` Non citée / Not cited; `citers_one|other` « Citée {count} fois, par : » / « Cited {count} time(s), by: »; `no_citers` « Aucun constat ni aucune famille ne cite cette référence. » / « No finding or family cites this reference. »; `family` famille / family; `go_to` Aller à / Go to; `edit` Modifier / Edit; `done` Terminer / Done; `edit_title` Modifier la référence / Edit the reference; `url_label` URL / URL; `none_doi` Aucun / None; `none_url` Aucune / None; `new_tab` (nouvel onglet) / (new tab) (sr-only); `delete_hint` (REVUE wording, fr and en).
Removed: none. R10 grep (src, tests, e2e incl. editor-equine) found no reader of the old lowercase wording left.
2026-11-12 20:50:25 +01:00

Faunosteo

Web app for veterinary osteopaths to write session bilans on animal anatomy SVGs — click zones, build observations, export a self-contained PDF with the full report JSON embedded as a native PDF attachment. Re-importing that PDF restores the state for a follow-up.

Multi-species by design. The MVP ships the horse sheet: a canonical anatomical sheet document (drawing + annotations + findings catalog, crates/core/src/domain/sheet) generated and curated under supabase/seed/anatomical-sheets/equine/. Another species is another sheet document, no code change. See docs/development/ANATOMICAL_SHEET_MODEL.md §6 for how a sheet is produced.


Versions: what is public, what is in development

Where What it is
Public, on faunosteo.com: 0.1.0 (2026-05-21) The local tool alone, open to every praticien: a static application with no account, no backend and no central server. The exported PDF is the long-term record.
develop (not released, not deployed) The local tool on the canonical anatomical sheet and Report v3, the PDF archive envelope, the Rust migration R0 to R5 (domain rules, SVG reader, PDF reader and writer, curation pipeline and files worker in crates/), and the SaaS foundations: Supabase schema under RLS, accounts, the /app space, the profile photo.
release/0.2.0 Cut on 2026-10-11 from plan Steps 3 to 6, never finished or deployed; its fate is TODO RR-9.

Available only in a development environment (they need the local Supabase stack, pnpm db:start, and for the photo the worker container; no production Supabase exists and hosting is undecided, docs/development/OPEN_QUESTIONS.md Q2):

  • sign-up with email confirmation, sign-in, password recovery, OAuth buttons behind configuration;
  • the /app space: dashboard and Mon compte (personal, professional, preferences, security sections);
  • the profile photo, processed by the Rust worker;
  • the curated equine sheet DRAFT in the editor, bundled only with SHEET_BUNDLE=draft (pnpm dev, pnpm build:preview): not medically validated, not published; a default build carries no sheet;
  • the anatomical pipeline and archive tools (pnpm import:equine, pnpm assets:upload, pnpm report:compare).

Planned, not implemented (roadmap in docs/development/IMPLEMENTATION_PLAN.md §0): V1-1 clients and animals (its business decisions ratified, technical design awaiting validation), V1-2 sheets served from Supabase, V1-3 bilans stored in the cloud with history, V1-4 stored PDFs and authorised sharing, V1-5 mobile and accessibility pass; then professional verification, cabinets, entitlements, agenda, public site and the rest of the plan. Nothing on develop authorises a release: the release readiness track (TODO RR-1 to RR-10) comes first.


Features

The local tool as it stands on develop. The public 0.1.0 has the canvas, the detail view, the vertebra picker, the findings tree, PDF export and re-import (report v2), the bilingual UI, the configurable identity and the practitioner cache; laterality, the footer branding, Report v3 with the v2 migration, the sheet document and the rescue copy came after it (CHANGELOG Unreleased).

  • Anatomy canvas — inline SVG drawing with markers rendered from the sheet document (hitbox + visible twin, delegated click listener)
  • Observation builder — group zones into clinical observations with severity and free-text notes
  • Hierarchical findings tree — per-zone picker with breadcrumb drill-down through the expert-authored catalog (26 zones for the horse), vet-referral badges on sensitive leaves, scope-disclaimer modal once per session
  • Vertebra picker — region tabs (C/T/L/S/Cd) with multi-select chip grid for precise vertebral notation
  • Detail views — click the head trigger to open the head view (a crop of the same drawing, or a view's own asset)
  • PDF export — A4 portrait with rasterized views, structured observations, and the full Report v3 JSON as a native PDF attachment; older v2 PDFs import through a generated migration map
  • PDF re-import — open a previously exported PDF to restore the session for a follow-up
  • Rescue copy (JSON): when the tab cannot save the report (storage full) or the computation engine stops, "Télécharger une copie" saves the report in progress as a .json file. To restore it, open the home page, "Choisir un fichier", and pick that file: the report reopens in the editor. The copy holds the report only. It does not replace the original PDF, which stays the archive of record for past reports (the frozen sheet snapshot, logos and labels it was produced with).
  • Bilingual UI — full FR/EN interface with a one-click language switcher; default locale auto-detected from the browser, then persisted
  • Configurable identity — site name, brand, footer, tagline all come from env vars; nothing hardcoded
  • Practitioner cache — last-used practitioner block prefilled via localStorage
  • Laterality — left/right side selection on bilateral zones, reflected in badges and the PDF
  • Footer branding — global footer (copyright, "Powered by ZenQuality", partner logo), on site + PDF

Stack

  • Node.js 24 LTS + pnpm 10.13 (corepack)
  • React 19 + TypeScript 5 (strict)
  • Vite 7 + @vitejs/plugin-react-swc
  • Tailwind CSS v4 (CSS-first, no postcss config)
  • Zustand 5 (state)
  • Zod 3 (schema + runtime validation)
  • PDF reader and writer in the Rust core (crates/core/src/pdf, WebAssembly in the app; no pdf-lib since R4.8)
  • motion 11 (animations)
  • vitest 3 + happy-dom + @testing-library/react
  • Supabase (PostgreSQL 17, Auth, RLS) via the pinned CLI; @supabase/supabase-js 2; PGlite for Dockerless SQL tests

Quick start (dev)

Single process, no Docker:

# Node 24 (see .nvmrc) + pnpm 10.13.1 via corepack, no global install:
corepack enable

pnpm install
cp .env.example .env   # edit APP_* vars if desired
pnpm dev               # http://<FAUNOSTEO_DEV_HOST>:5173 (the DEV origin, never localhost)

Development server on the private network (the DEV origin is the machine's LAN address, scripts/dev-env.sh): pnpm db:start, then pnpm dev and open http://<lan-address>:5173 from any device of the network; Mailpit for the sign-up mails through the DEV gateway on :54325 behind basic auth, pnpm dev:gateway (docs/development/ENVIRONMENTS.md).

Rust (core, browser module, worker): a user-level rustup installs the pinned toolchain from rust-toolchain.toml on first use; see docs/development/RUST.md §1 for the three cargo install / rustup target add lines and the Docker alternative. The files worker (profile photos, Step 8) runs as a container beside the local Supabase stack: pnpm worker:image, then pnpm e2e:avatar (= pnpm db:sandbox avatar-e2e) for the real-stack end-to-end run on the throwaway stack, or docker compose --profile worker up worker with a .env.worker (docs/development/STORAGE.md).

Docker Compose (matches production topology):

cp .env.example .env   # set APP_* identity vars
docker compose up --build
# app at http://localhost:8080

Verifying a change

pnpm typecheck    # TypeScript strict, no emit
pnpm lint         # ESLint 9 flat config, 0 warnings
pnpm test:run     # vitest run (core-wasm, supabase/PGlite, app)
pnpm build        # tsc + vite build → apps/app/dist/
pnpm report:compare <pdf|dir>...   # archive PDF vs its v3 reading, unresolved items flagged (the core's binary; first run compiles)
pnpm rust:check   # native: fmt, clippy -D warnings, cargo test, ts-rs export, cargo deny
pnpm wasm:build   # native: browser module → packages/core-wasm/pkg (the core-wasm proofs run on it)
pnpm check:all    # everything a branch must pass before a merge, in one command (needs Docker for the image stages)

No CI/CD runs on the forge yet: the workflow files under .gitea/workflows/ are prepared for a future runner and call these same scripts.


Build & deploy

pnpm build                  # production build → apps/app/dist/
docker build -t faunosteo .   # multi-stage Docker image
docker compose up --build   # run with env_file: .env

For production deployment (VPS provisioning, firewall, TLS, nginx reverse proxy, backups, hardening) — see DEPLOY.md. It describes the static 0.1.0 deployment; read its status notice before deploying anything built from develop.


Documentation


Project layout

faunosteo/                  pnpm workspace (see docs/development/WORKSPACE.md)
├─ apps/app/                the private application (@faunosteo/app):
├─ vite/sheet-bundle.ts     Vite plugin bundling the reference sheet (SHEET_BUNDLE=draft|none)
├─ src/app/                 routes + ConfigProvider
├─ src/config/              runtime env config resolution
├─ src/sheets/              SheetProvider (bundled implementation) + useSheet hook
├─ src/services/            sheet index (lookups by id) + zone interaction service (pure)
├─ src/i18n/                translation dicts (fr/en) + useT() hook
├─ src/state/               Zustand store (Report v3) + persistence adapter + locale store
├─ src/anatomy/             drawing: sanitised asset + annotation layer → inline SVG per view
├─ src/components/          UI primitives, canvas, observation, report
├─ src/pdf/                 app side of the PDF: snapshot + branding + labels + browser rasterizer → the core's export session
├─ src/lib/                 id, dates, assert utilities
├─ src/styles/              Tailwind v4 CSS + design tokens
├─ tests/unit/              vitest tests on the bundled sheet (+ frozen v2 fixtures)
├─ packages/core-wasm/      @faunosteo/core-wasm: the Rust core in the browser (runtime, generated types, frozen N-1 reader)
├─ crates/                  Rust: core (contracts, rules, SVG, PDF, anatomical pipeline), wasm facade, worker
├─ packages/supabase/       @faunosteo/supabase: typed client, generated types, PGlite SQL test harness
├─ supabase/                CLI config, SQL migrations, local seed (incl. the equine sheet), pgTAP tests
├─ docker/                  entrypoint.sh + nginx.conf
├─ docs/                    conventions, sheet model, PDF spec, development plan
└─ index.html               SPA entry point

Status

Public: 0.1.0 (2026-05-21), the local tool with no backend. develop: plan Steps 0 to 8 and the Rust migration R0 to R5, merged, not released. The merge gate is pnpm check:all (see "Verifying a change"); no CI runs on the forge.

The first species ships as the equine anatomical sheet: the historical Horse.svg, Horse_head.svg and findings catalog (26 zones, 792 nodes) imported, then audited and curated (supabase/seed/anatomical-sheets/equine/, 45 traced changes, 48 references). The application bundles that curated draft in development (SHEET_BUNDLE=draft); it is not medically validated and a production build carries no sheet unless asked. Another species is another sheet document produced the same way.

Manual QA checklist: .claude/audits/MVP-QA.md — walk it through pnpm dev before delivery.

License: MIT.

S
Languages
TypeScript 78.6%
HTML 14.6%
CSS 3.7%
JavaScript 2.2%
Shell 0.7%
Other 0.2%