docs(docs): realign active docs on develop for P0
Roadmap section and step statuses in the plan, D-R9 Rust services in place of Edge Functions and a Node worker, platform roles per BDR-026, equine sheet draft-only, curation-only authoring until Step 17, OPEN_QUESTIONS statuses and conflict resolutions, dated snapshot notices on the Step 0 documents.
This commit is contained in:
1 parent
c71fafa3c5
commit
ac60b24267
12 files changed
+260
-92
No files matched your search
@@ -6,6 +6,66 @@ ambiguities or technically risky points found when confronting
|
||||
questions for the developer that change architecture or development order.
|
||||
Items that are merely interesting are left out.
|
||||
|
||||
## Status (revised 2026-10-25, P0)
|
||||
|
||||
The analysis below is the 2026-10-08 text, kept as written; this table says
|
||||
what has been settled since and by which record (BDR = `.claude/memory/decisions.md`,
|
||||
D-R = `RUST_ARCHITECTURE_REVIEW.md` Annex A). Paths it cites under
|
||||
`public/species/` and `public/pathology-editor.html` no longer exist (deleted at
|
||||
Step 5).
|
||||
|
||||
| Item | Status | Settled by / where it stands |
|
||||
|---|---|---|
|
||||
| C1 vertebral formula | settled | ordered `vertebral_config.regions`, free codes (BDR-031) |
|
||||
| C2 report-only points | open | `localAnnotations` reserved empty in Report v3 (BDR-038); promotion semantics undecided (Q6a); defining it later is a report version bump |
|
||||
| C3 worker on day one | settled | Rust worker built at Step 8 / R1 (BDR-044, BDR-048) |
|
||||
| C4 global client record | owner orientation, awaiting ratification | records belong to a workspace (one personal workspace per practitioner in V1-1, cabinets later); no global directory shared between practitioners (owner, 2026-10-25); contract `V1-1_OWNERS_ANIMALS.md` §3, D2 |
|
||||
| C5 animal update rights | owner orientation, awaiting ratification | writes reserved to workspace members with a write right, in V1-1 the practitioner in their personal workspace; no retroactive silent change of a finished bilan (owner, 2026-10-25); V1-1 contract §5.1, §5.3 |
|
||||
| C6 unverified accounts | owner orientation, awaiting ratification | email confirmation ≠ professional verification; private use for confirmed-email accounts, verification (Step 9) required for public features presenting a verified professional; statuses are not platform roles (BDR-026) (owner, 2026-10-25); V1-1 contract §5.2. Replaces the 2026-10-08 assumption below (no clients or reports before verification) once ratified |
|
||||
| C7 « Observation » vocabulary | settled | finding category kind `observation` renamed `consultation_reason` (BDR-033 point 5); *Observation* stays the report block |
|
||||
| C8 drafts per sheet | settled | one draft per sheet, partial unique index (BDR-032) |
|
||||
| C9 detail view asset | settled | nullable `svg_asset_id`, crop by `view_box`; the equine head is a crop of one cleaned drawing (BDR-031, BDR-036, BDR-037) |
|
||||
| C10 Edge Functions on a small VPS | Edge part settled, hosting open | Edge Functions retired, Rust services instead (D-R9, BDR-045); VPS sizing and hosting = Q2 |
|
||||
| C11 restore after the free window | open | Step 11 / 14 with the quota decision |
|
||||
| C12 SVG sanitisation vs direct upload | settled (mechanism) | quarantine key, status column, closed policies, sandboxed Rust decoder (BDR-048, `STORAGE.md`); user SVG upload arrives with Step 13 through the core's SVG reader |
|
||||
| C13 CLAUDE.md rules broken | settled | references registry replaces "≥ 1 source" (BDR-036); contracts are Rust (R2) |
|
||||
| C14 locale of stored PDFs | open | artifact column at Step 15; the archive envelope already records the locale (`PDF-FORMAT.md`) |
|
||||
| Q1 v2 PDFs in use | partly settled | v2 import is production code (BDR-038, BDR-039); whether real v2 files exist is unanswered |
|
||||
| Q2 hosting | open | blocks any production backend (TODO RR-5); BDR-049 fixes only the DEV / STAGING / PROD split |
|
||||
| Q3 non-mammal layouts | settled | free region codes (BDR-031) |
|
||||
| Q4 external use of the pathology editor | moot | the tool was deleted at Step 5 (BDR-038); content changes go through `curation/changes.json` until the Step 17 editor (owner confirmed 2026-10-25) |
|
||||
| Q5 one or two equine assets | settled | one cleaned drawing, head as crop (BDR-036, BDR-037) |
|
||||
| Q6 manual points, shared client records | open (a); (b) reframed by C4 | (a) as C2; (b) no shared record if C4 is confirmed, so the edit-rights question moves inside a data space (V1-1 contract §5) |
|
||||
| Q7 phone and email providers | open | Step 7 shipped email only; needed before production SMTP and phone verification |
|
||||
| Q8 public site framework | settled | Astro (D-R8, validated with BDR-045), Rust exception recorded |
|
||||
| Q9 catalog anomalies | settled, against the 2026-10-08 recommendation | no medical correction at import, anomalies reported, degraded slugs normalised (BDR-034); later corrections through curation changes (BDR-036, BDR-037) |
|
||||
|
||||
### Conflicts raised by P0 and their resolution (2026-10-25)
|
||||
|
||||
1. Step 17 keeps the plan's merged-editor scope, but the legacy editors were
|
||||
deleted at Step 5 (BDR-038): until Step 17, no screen edits sheet content.
|
||||
Resolved (owner, 2026-10-25): no graphic editor that changes or publishes
|
||||
anatomical content until Step 17; reference changes go through the curation
|
||||
sources and the Rust pipeline, reviewed, tested and versioned. Annotating a
|
||||
bilan is distinct from changing the anatomical reference and never touches
|
||||
`curation/changes.json`.
|
||||
2. Publication of the official equine sheet: the plan's Step 13 used to expect
|
||||
"v1 published"; BDR-034 and BDR-037 keep it a draft until a platform admin
|
||||
publishes after business review. Confirmed (owner, 2026-10-25): the equine
|
||||
sheet stays a draft until business validation, and nothing publishes it
|
||||
automatically. Still open for V1-2: who triggers the review, and whether
|
||||
V1-2 may serve the unpublished draft to signed-in practitioners.
|
||||
3. Recorded decision BDR-041 calls professional verification "Step 11"; the
|
||||
plan numbers it Step 9. Resolved: the plan's numbering is kept and the
|
||||
correction is the new entry BDR-072 (the registry is append-only, BDR-041
|
||||
is not edited).
|
||||
4. README, DEPLOY and CHANGELOG mixed the live 0.1.0 (local tool, no backend)
|
||||
with the unreleased `develop` (Supabase, worker, Rust core). Resolved in P0:
|
||||
README separates the public 0.1.0, `develop`, DEV-only features and planned
|
||||
work; CHANGELOG keeps every unreleased change under `Unreleased`; DEPLOY
|
||||
marks its historical, unverified and unsafe parts, and the CSP example as
|
||||
not production-ready. The fixes themselves stay with TODO RR-5.
|
||||
|
||||
## A. Contradictions, ambiguities, risky decisions
|
||||
|
||||
### C1. Vertebral formula shape (architecture §7.2 vs §23.2)
|
||||
|
||||
Reference in new issue
Block a user