From 8e7838d1fb326ce4ea467012337e98fa28ac0db8 Mon Sep 17 00:00:00 2001 From: louispaulb Date: Tue, 14 Jul 2026 19:27:51 -0400 Subject: [PATCH] =?UTF-8?q?docs:=20prompt=20r=C3=A9utilisable=20de=20refac?= =?UTF-8?q?tor=20UX=20(UX=5FREFACTORING=5FPROMPT.md)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Réécriture vérifiée du brouillon initial — 43 corrections issues d'un review multi-agents contre le code réel @ 718698f : - 16 règles UX calibrées au repo (chrome-only, CTA desktop top-right, Function-props, fr-CA, raccourcis clavier, états async, LTE, 44px, tokens) - tableau des primitives canoniques (OverflowMenu, DisclosureSection, HelpHint…) - audit anti-patterns avec colonnes Status+Anchor (repérage par nom d'état, pas par ligne) ; lignes déjà résolues marquées (T2, TechTasks, PL4/PL7) - plan de décomposition PlanificationPage réaliste (décomposition #4 reconnue, vagues 1-2, règle script-mapping, pas de composable fourre-tout) - Definition of Done (lint/build/preview + invariants DnD/SSE/MapLibre/Publier) Co-Authored-By: Claude Fable 5 --- docs/UX_REFACTORING_PROMPT.md | 259 ++++++++++++++++++++++++++++++++++ 1 file changed, 259 insertions(+) create mode 100644 docs/UX_REFACTORING_PROMPT.md diff --git a/docs/UX_REFACTORING_PROMPT.md b/docs/UX_REFACTORING_PROMPT.md new file mode 100644 index 0000000..6469d13 --- /dev/null +++ b/docs/UX_REFACTORING_PROMPT.md @@ -0,0 +1,259 @@ +# UX Refactoring Prompt — Gigafibre FSM + +> **Audited: 2026-07-14 @ commit `718698f`.** Line numbers below are hints only — they drift with every commit. ALWAYS locate code by the **Anchor** string (state/component/label name); if the anchor isn't where the table says, search the file and update this doc before refactoring. + +## Project Context + +Gigafibre FSM is the operations platform for a fiber ISP in Quebec. Stack: Vue 3 / Quasar v2 / Pinia / Vite. The app has two audiences: + +- **Ops staff** (CSRs, dispatchers) on desktop/tablet → `apps/ops/src/pages/` — Quasar components, light theme, `--ops-*` tokens. +- **Field technicians** on mobile (often one-handed, gloves, spotty LTE) → `apps/ops/src/modules/tech/pages/` — **its own design system**: `tg-*` classes from `src/css/tech.scss`, native `