From 96e83ade2f28520eb5ee702ee160b17a4099fcdf Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 10 Sep 2026 11:31:16 +0000 Subject: [PATCH] =?UTF-8?q?docs(comments):=20point=20at=20DESIGN.md=20?= =?UTF-8?q?=C2=A709=20instead=20of=20quoting=20its=20list?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The legal dashboard's header carried a copy of §09's six-brick list. That copy drifted three times in two days — two items rewritten by PR #40 (1127e52), the third by PR #70 (30fd863) — and by the end all three described bricks this file does not implement. Replace the copy with a pointer to §09, which cannot drift. The cycle-time dataset's stage-count paragraph contrasted its counts with "the status funnel on the legal workbench", a funnel that has not existed since PR #57 made that widget a bar chart. Keep the measurement and its reason (signed_at 72 exceeds submitted_at 60; backfilled in-force book, no intake) and drop the claim that a funnel exists to contrast with. Comments only: no metadata, no behaviour, no DESIGN.md change. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01R3n3GGzobdegM4HUzah1iR --- src/dashboards/legal.dashboard.ts | 10 ++++++++-- src/datasets/cycle-time.dataset.ts | 7 +++++-- 2 files changed, 13 insertions(+), 4 deletions(-) diff --git a/src/dashboards/legal.dashboard.ts b/src/dashboards/legal.dashboard.ts index 383dc1b..b3a3850 100644 --- a/src/dashboards/legal.dashboard.ts +++ b/src/dashboards/legal.dashboard.ts @@ -1,8 +1,14 @@ import type { Dashboard } from '@objectstack/spec/ui'; /** - * 法务工作台 — DESIGN.md §09's first dashboard: 待受理数 · 审查中 · 超 SLA · - * 谈判停滞 · 平均周转（本月 vs 上月）· 各阶段合同数漏斗. + * 法务工作台 — DESIGN.md §09's first dashboard. + * + * §09's brick list is deliberately NOT copied here. The copy that used to sit + * on these lines drifted three times in two days — two of its six items were + * rewritten by PR #40 (`1127e52`, 2026-09-09) and the third by PR #70 + * (`30fd863`, 2026-09-10) — and by the end all three described bricks this file + * does not implement. §09 is the source and a pointer to it cannot drift; the + * widgets below each carry their own comment for their own shape. * * ## What a dataset widget actually reads (measured, not inherited) * diff --git a/src/datasets/cycle-time.dataset.ts b/src/datasets/cycle-time.dataset.ts index c8042e6..55a5600 100644 --- a/src/datasets/cycle-time.dataset.ts +++ b/src/datasets/cycle-time.dataset.ts @@ -41,8 +41,11 @@ import { defineDataset } from '@objectstack/spec/ui'; * * Those five are deliberately NOT read as a monotone funnel: `signed_at` (72) * exceeds `submitted_at` (60) because the demo's in-force book was backfilled - * with signature dates and no intake. The status funnel on the legal workbench - * is the honest funnel; these are per-stage coverage counts. + * with signature dates and no intake. There is no funnel on the legal + * workbench to contrast them with either — that board's per-stage brick is a + * bar chart, and DESIGN.md §09 gives this same non-monotone book as the reason + * (#48 / PR #57). These five are per-stage coverage counts: stamps that were + * set at some point and never clear, not a conversion sequence. */ export const CycleTimeDataset = defineDataset({ name: 'contract_cycle_time',