From 53fb4f5f76369901cbb4eaec8e9336865c8b1d26 Mon Sep 17 00:00:00 2001 From: Ilia Denisov Date: Fri, 22 May 2026 16:06:27 +0200 Subject: [PATCH] =?UTF-8?q?docs(ui):=20finalize=20docs=20sync=20=E2=80=94?= =?UTF-8?q?=20README=20finalized-web=20summary=20+=20topic=20links=20(F7)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The de-archaeology and the ui/docs index landed in the earlier reorg (0 "Phase N" refs in ui/docs/; 24 topic docs linked). This finishes the sync: ui/README.md gains a finalized-web-target summary and links the new topic docs (design-system, a11y, error-state-ux, pwa-strategy). docs/ARCHITECTURE.md and docs/FUNCTIONAL.md need no change — they cover the backend/gateway/cross-service contracts with no stale UI statements; the finalized UI is client-local UX documented under ui/docs/. Marks F7 done. Co-Authored-By: Claude Opus 4.7 (1M context) --- ui/PLAN-finalize.md | 13 ++++++++++++- ui/README.md | 14 ++++++++++++++ 2 files changed, 26 insertions(+), 1 deletion(-) diff --git a/ui/PLAN-finalize.md b/ui/PLAN-finalize.md index 0b1a5d0..8da20f1 100644 --- a/ui/PLAN-finalize.md +++ b/ui/PLAN-finalize.md @@ -176,7 +176,18 @@ bitten us.) Goal: stop shipping the binary in git. Acceptance: CI builds the wasm and Vitest/Playwright pass against the freshly built artefact; the binaries are no longer tracked. -## F7 — Documentation finalization +## F7 — Documentation finalization — done + +The de-archaeology + the `ui/docs/README.md` index landed in the earlier +docs reorganization (PR #25): `ui/docs/` has **0** stray "Phase N" +references and the index links all 24 topic docs (each F1–F6 stage also +added/updated its own topic doc). This stage finished the sync: +`ui/README.md` gains a finalized-web-target summary and links the new +topic docs (design-system, a11y, error-state-ux, pwa-strategy). +`docs/ARCHITECTURE.md` and `docs/FUNCTIONAL.md` need no change — they +cover the backend / gateway / cross-service contracts and carry no stale +UI statements; the finalized UI is client-local UX documented under +`ui/docs/`. Goal: living docs read as current state, not build archaeology. diff --git a/ui/README.md b/ui/README.md index 31277ca..fcaf609 100644 --- a/ui/README.md +++ b/ui/README.md @@ -11,6 +11,11 @@ directly in Wails on desktop. All network I/O lives on the TypeScript side via ConnectRPC, so the Go module is a pure compute boundary on every platform. +The web target is a finalized, installable PWA: a shared design-token +system with light/dark themes, WCAG 2.2 AA accessibility, en/ru +localisation with a persisted choice, a central error surface, and +offline tolerance — see the topic docs below. + The legacy Fyne client under `client/` is reference-only. Nothing in `ui/` imports from it. @@ -98,6 +103,15 @@ Linked topic docs: order draft store, persistence, history-mode wiring. - [`docs/wasm-toolchain.md`](docs/wasm-toolchain.md) — TinyGo build, loading recipe, bundle size budget. +- [`docs/design-system.md`](docs/design-system.md) — design tokens, + light/dark theming, component conventions. +- [`docs/a11y.md`](docs/a11y.md) — WCAG 2.2 AA approach, axe + keyboard + gates, shared a11y primitives. +- [`docs/error-state-ux.md`](docs/error-state-ux.md) — central error + surface, shared loading/empty/error states, selection marker, sheet + dismissal. +- [`docs/pwa-strategy.md`](docs/pwa-strategy.md) — installable, offline + PWA: service worker, manifest, icons. - [`docs/testing.md`](docs/testing.md) — Tier 1 per-PR + Tier 2 release test tiers. -- 2.52.0