From f26c34a340f1f7c30255debc6858aa6df716f172 Mon Sep 17 00:00:00 2001 From: sinohqb Date: Thu, 6 Aug 2026 02:01:36 +0800 Subject: [PATCH] docs(ui-consistency): archive completed refactor, record drawer evolution in ADR-0005 --- .scratch/ui-consistency/spec.md | 23 +++++++++++++++++++++-- docs/adr/0005-ui-consistency-baseline.md | 2 +- 2 files changed, 22 insertions(+), 3 deletions(-) diff --git a/.scratch/ui-consistency/spec.md b/.scratch/ui-consistency/spec.md index 8f0db22..c495c93 100644 --- a/.scratch/ui-consistency/spec.md +++ b/.scratch/ui-consistency/spec.md @@ -1,6 +1,6 @@ # UI 一致性重构 — Spec（grill 共识沉淀） -日期：2026-08-05 ｜ 状态：已确认，开始实施 +日期：2026-08-05 ｜ 状态：已完结（2026-08-06 归档） ## 背景 @@ -27,7 +27,7 @@ | 列表 | Table + `rowKey="id"`；空态用 `Empty`（带文案）；加载用 Table 自带 loading | | 分页 | 超过 20 行才分页，否则 `pagination={false}` | | 表单 | Drawer 宽 640、`layout="vertical"`、底部 footer（取消/主按钮）、`destroyOnClose`、提交前本地校验 | -| 详情 | 页面内部视图切换（不加新路由），顶部「返回 + 标题 + 状态 Tag + 动作按钮」 | +| 详情 | 页内视图切换或右侧 Drawer 弹出（不加新路由，列表常驻）；顶栏左「标题 + 状态 Tag」、右动作按钮；Drawer 内容自滚动（body padding 0 + 根容器 16px 内边距） | | 危险操作 | 统一 `Popconfirm`（含删除、取消等不可逆动作），禁用 `window.confirm` 和无确认删除 | | 反馈 | 错误统一由 axios 拦截器弹 `message.error`；成功由动作函数显式 `message.success` | | 轮询 | 活跃态（外部会变化的状态）5 秒静默轮询 | @@ -43,3 +43,22 @@ ## 票据规划 见 `.scratch/ui-consistency/issues/`。依赖链：01 → 02/03（检查点）→ 04–08 → 09。 + +## 归档收口（2026-08-06） + +**交付**：9 张票据全部完成并验收勾选（issues/01–09），t480 全页走查通过（golden path + keep-alive 切 tab）。 + +**实施提交**： +- `d4c254e` 票据 01：FormDrawer/usePolling 基准件 + IntelligentEvals dogfood +- `15d0d12` / `2e78c4b` / `f131657` / `1588972` / `b9011aa` / `5077f08` / `11b1590`：票据 02–08 逐页迁移 +- `0832445`：票据 09，交互标准写入 AGENTS.md +- `9f25728` / `1fbd2bc`：标准补充与验收归档 + +**基准后的智能评估演进**（反哺标准，已同步 ADR-0005 与 AGENTS.md）： +- `935f0a1` 列表打开方式对齐操作列按钮 +- `1d2c372` 详情/报告改右侧 Drawer（列表常驻） +- `22cc437` 抽屉顶栏：返回按钮移除、动作右对齐 +- `01f451c` 详情两列布局 + 报告统计行与维度得分图 +- `804880f` 抽屉顶部内边距修复 + +**验证**：pytest 674 全绿、`tsc --noEmit` 通过；全部变更已部署 t480。 diff --git a/docs/adr/0005-ui-consistency-baseline.md b/docs/adr/0005-ui-consistency-baseline.md index 820f3ca..9d43271 100644 --- a/docs/adr/0005-ui-consistency-baseline.md +++ b/docs/adr/0005-ui-consistency-baseline.md @@ -12,7 +12,7 @@ - 以智能评估页模式为唯一基准，逐页迁移对齐（先沉淀共享件 FormDrawer/usePolling，再按 IntelligentEvals → Targets → Files → ModelConfigs → Scenarios → Runs → Reports → Campaigns 顺序）。 - 重构边界：只统一交互层，不增删业务功能、不动 API、不动信息架构与 keep-alive 路由。 -- 交互标准：PageWrapper 骨架、Table+Empty、20 行分页阈值、Drawer 640 表单、内部视图切换详情、Popconfirm 危险操作、message 反馈、活跃态 5s 轮询。 +- 交互标准：PageWrapper 骨架、Table+Empty、20 行分页阈值、Drawer 640 表单、详情用页内视图切换或右侧 Drawer 弹出（列表常驻）、Popconfirm 危险操作、message 反馈、活跃态 5s 轮询。 ## 后果