kyugao
a4902bb730
需求与文档: - R-013 策略自定义字段配置（定义随策略 configSchema 存 settings、值落 strategy_holdings.values JSON、类型化文本/数字/布尔/枚举）定稿并进入 PLAN-012 / 迭代 11（含目标数据模型 + 端到端示例 + 技术方案 + 验收标准） - R-011（Tab设置）/ R-012（UI主题适配）归档至 已完成/，索引标记已归档 - 沉淀约束: 产品约束-010 / 技术约束-015 / 技术约束-016 / UI约束-005 结构重构（技术约束-016）: - src/component/ 平铺还原为语义分域目录: data-source/ storage/ position/ market/ trades/（git rename 保留历史） - 清理死代码: 删除 AllocationStorage.js（0 引用）、DataStore setDataset/removeDataset（无调用方） - 同步更新 src/index.js / scripts/*.mjs / tsdown.config.ts 引用 - typecheck + build + test-r009 回归 14/14 通过
4.7 KiB
UI交互约束（UI & Interaction Constraints）
UI 与交互层面的约束：视觉风格、组件、交互行为。后续迭代进行界面与交互实现时以此为依据。
记录格式：每条约束包含「编号 / 约束说明 / 添加日期 / 生效状态 / 失效日期 / 最后一次变更描述」。新增追加、变更更新、失效标记状态（不删除记录）。引用用编号，如
UI约束-001。 最后一次变更描述：概括该约束最近一次变更（新增 / 变更 / 失效）讨论的最后一层结论；新增时写新增结论，变更/失效时更新为当次结论。
约束列表
| 编号 | 约束说明 | 添加日期 | 生效状态 | 失效日期 | 最后一次变更描述 |
|---|---|---|---|---|---|
| UI约束-001 | 会话头部 QMT 连接切换 chip：紧凑形态 QMT: <激活配置名> ▾，与 PTC 模式标签并排；下拉菜单列出全部配置（当前激活项勾选标记），点选即激活；操作结果用顶部轻提示反馈（成功绿/失败红，约 3s 消失，沿用现有 Toast 体系） |
2026-08-29 | 生效 | - | R-004 定稿（2026-08-29）：Q9/Q10 确认的头部控件形态 |
| UI约束-002 | 设置页「QMT 连接配置」子 tab：与「Tab 设置 / 策略分组」并列的第三个子 tab；配置以卡片形式展示（自适应网格 minmax(260px,1fr)，激活卡片绿色描边）：卡片含名称 + 激活/默认徽标 + HTTP 地址 + 行内操作（激活 / 设为默认 / 编辑 / 测试连接 / 删除）+ 新增/编辑表单（纵排两字段）；删除沿用现有确认弹窗模式，删除最后一条时给出禁止提示；超时不设输入框（Q5）；长文本（地址/错误信息）单行省略 + 悬停看全文，组件设 minWidth:0 防撑行 | 2026-08-29 | 生效 | - | 变更（2026-08-29 老师反馈）：列表形式改卡片形式，约束组件宽度、长文本省略不换行；原定稿：设置页子 tab 形态沿用现有设置交互体系；变更（2026-09-02 R-011 定稿）：「通用设置」更名为「Tab 设置」 |
| UI约束-003 | 设置页「Tab 设置」子 tab：表格列出全部会话 tab（系统内置 + 策略分组）混排，内置行带「内置」徽标、策略行带「策略」徽标；每行 = 拖动手柄（原生 HTML5 Drag & Drop）+ 名称 + 显示/隐藏开关；任何行均无重命名/删除按钮；拖动落点确认后立即持久化（每次 drop 提交整表，沿用「刷新页面后生效」提示机制）；「策略分组」子 tab 只保留 新增/重命名/删除，移除排序箭头与显隐开关，并提示「顺序与显示请在「Tab 设置」中调整」 | 2026-09-02 | 生效 | - | R-011 定稿（2026-09-02 Q1/Q4/Q5 确认）：拖动排序 + 显隐开关，禁重命名/删除 |
| UI约束-005 | 策略自定义字段配置 UI（R-013，2026-09-02）：设置页「策略分组」子 tab 策略行可展开 → 展开区 = 字段列表（label/key/type/enum/默认值）+ 添加/编辑/删除字段表单（名称/类型/枚举选项/默认值）+ 保存（走 strategies/update 整表）；策略持仓 tab 持仓行展开区（R-010 基础上）增加「自定义字段」区块：按该策略 configSchema 渲染输入控件（文本=输入框、数字=数字输入、布尔=开关、枚举=下拉），值来自该行 values，编辑即保存调 holdings/values-update，Toast 反馈；未配置字段定义的策略持仓行不渲染字段区 | 2026-09-02 | 生效 | - | 新增（2026-09-02 R-013 定稿 D6 老师确认：值编辑入口 = 持仓行展开区） |
| UI约束-004 | 神之一手 UI 适配 DSH 主题：所有颜色引用宿主 --dsw-* token（带 fallback var(--dsw-alias-xxx, #原色)），随 DSH 浅色 / 深色 / 跟随系统自动切换，不自行维护主题偏好（跟随宿主）；语义映射：表面底→bg-layer-1、次级面→bg-layer-2、hover→interactive-bg-hover、主/次/弱文字→label-primary/secondary/tertiary、边框→border-l1..l4、红（涨/删/错）→state-error-primary、绿（跌/成/激活）→state-success-primary、蓝（信息/业务）→state-business-primary、实心按钮字→button-contrast-fill、遮罩→bg-mask-1、阴影→shadow-lv3；淡底用 color-mix(in srgb, var(--语义色) 10-12%, transparent)；禁止硬编码色值（#hex/rgb）进运行代码 | 2026-09-02 | 生效 | - | R-012 定稿（2026-09-02，暂定跟随系统）+ 迭代 10 实施：141 处硬编码色 token 化，宿主机制实证（body[data-ds-dark-theme] + alias token 双值定义） |