AgentEvalTool/docs/adr/0005-ui-consistency-baseline.md
2026-08-06 02:01:36 +08:00

24 lines
1.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ADR-0005: 管理后台 UI 一致性重构以智能评估页为基准
## 状态
已接受2026-08-05
## 背景
管理后台 9 个业务页面交互模式不一致(表单容器 Drawer/Modal 混用、空态/加载态/删除确认各页不同、Runs/Reports 绕过 PageWrapper。智能评估 v1.0 的页面模式是最新打磨并被用户验证过的。
## 决策
- 以智能评估页模式为唯一基准,逐页迁移对齐(先沉淀共享件 FormDrawer/usePolling再按 IntelligentEvals → Targets → Files → ModelConfigs → Scenarios → Runs → Reports → Campaigns 顺序)。
- 重构边界:只统一交互层,不增删业务功能、不动 API、不动信息架构与 keep-alive 路由。
- 交互标准PageWrapper 骨架、Table+Empty、20 行分页阈值、Drawer 640 表单、详情用页内视图切换或右侧 Drawer 弹出列表常驻、Popconfirm 危险操作、message 反馈、活跃态 5s 轮询。
## 后果
- 正面:用户操作肌肉记忆可跨页面复用;新页面有明确模式可循;共享件减少重复代码。
- 负面迁移期间每页需人工走查验收Runs/Reports 的特殊 hack 需小心保留。
- 不做:视觉设计系统重做、导航重构、自动化视觉回归。
详细 spec 见 `.scratch/ui-consistency/spec.md`