kyugao
ec02a791ee
- R-027 静态化：策略恒为内置两项（不可增删改名，保留显隐/排序）；设置页移除「策略分组」； 字段配置入口迁到策略 tab 内「列设置」旁（FieldConfigDialog + schema-update 单策略写入） - R-026 计算字段：自写公式引擎（中文变量、四则/括号/round·abs·min·max、缺值短路→—）+ 变量目录（行情/合约/持仓/自定义字段）+ strategy-positions 逐行现算（只读内存缓存，不落库、列只读） - R-028 判定型：比较运算 + and/or + inferResultKind + 结果类型一致性校验 + 判定列 ✓/— 渲染； 网格超市落地 可下空单=涨停价>基准值+网格大小、可下多单=跌停价<基准值-网格大小 - 变量选择改标签平铺（老师反馈）；公式手册 docs/99-其他材料/计算字段公式说明.md - 约束同步：产品约束-002/003/004/009/013/014、技术约束-014/015/022/023/024、UI约束-002/003/005/008 - 回归：新增 test-r026/test-r027，更新 r011/r013/r017，17 个脚本全绿；typecheck/build 通过
30 lines
11 KiB
Markdown
30 lines
11 KiB
Markdown
# 产品功能约束（Product Constraints）
|
||
|
||
> 产品功能层面的约束：功能边界、行为定义、不可违背的产品规则。后续迭代实现产品功能时以此为依据。
|
||
>
|
||
> 记录格式：每条约束包含「编号 / 约束说明 / 添加日期 / 生效状态 / 失效日期 / 最后一次变更描述」。新增追加、变更更新、失效标记状态（不删除记录）。引用用编号，如 `产品约束-001`。
|
||
> **最后一次变更描述**：概括该约束最近一次变更（新增 / 变更 / 失效）讨论的最后一层结论；新增时写新增结论，变更/失效时更新为当次结论。
|
||
|
||
## 约束列表
|
||
|
||
| 编号 | 约束说明 | 添加日期 | 生效状态 | 失效日期 | 最后一次变更描述 |
|
||
|---|---|---|---|---|---|
|
||
| 产品约束-001 | 分仓管理以「全量持仓」为数据基础：系统必须完整展示账户全部持仓信息（代码/名称/数量/可用/均价/现价/市值/盈亏），不遗漏、不裁剪 | 2026-08-27 | 生效 | - | 讨论确认（R-002）：老师要求「首先肯定支持全部持仓信息」 |
|
||
| 产品约束-002 | 分仓通过「持仓标签」体系实现：在全量持仓之上，用不同标签对持仓进行逻辑分组，每个标签展示其下的仓位汇总（数量/市值/盈亏/占比） | 2026-08-27 | 生效 | - | 讨论确认（R-002）：老师要求「分不同的持仓标签，各自有多少仓位」 |
|
||
| 产品约束-004 | 删除持仓策略时，该策略下已分配的份额自动回到「未分配」，数据不丢失（删除前需弹窗确认） | 2026-08-28 | **失效** | 2026-09-10 | **失效（2026-09-10 R-027 策略静态化）**：策略不可删除，本条款无适用场景，随之退役（原定稿：删除策略 = 份额回未分配 + 弹窗确认） |
|
||
| 产品约束-003 | 持仓标签（策略）**集合与名称固定**为插件内置两项（网格超市 / 手动做T）：不可新增、不可删除、不可重命名（R-027 策略静态化）；「可自定义」收窄为**标签下的字段定义可自定义**（见 产品约束-010 / 产品约束-014）；策略 tab 仍支持显隐与拖拽排序（见 产品约束-009） | 2026-08-27 | 生效 | - | **变更（2026-09-10 R-027）**：原「标签可自定义、可增删改」（维度候选策略/用途/风险等级）收窄为「固定两标签 + 字段自定义」；老师重构指令「策略 tab 做成静态的，和全部持仓、交易记录一样是插件内置 tab」 |
|
||
| 产品约束-005 | QMT 连接配置多配置管理：设置页「QMT 连接配置」子 tab 维护多个连接配置（名称 + HTTP 地址，增/删/改/查）；一次只能激活一个，激活配置为当前生效连接；默认 = 插件启动时自动激活的配置（运行中手动激活其他配置立即生效，重启回到默认）；测试连接为手动操作（请求 /health 返回可达性与延迟，激活不强制先测）；删除边界：删除激活配置自动切换到默认，删除默认配置则默认标记转移到列表第一条并激活之，禁止删除最后一条 | 2026-08-29 | 生效 | - | R-004 定稿（2026-08-29）：Q1-Q6/Q8 逐条确认（不迁移宿主配置、超时不纳入表单） |
|
||
| 产品约束-007 | 3 个监控表格（全部持仓 / 手动做T / 网格超市）展示**盘中现价**：现价列显示 lastPrice，红涨绿跌着色（对比昨收），价格变化轻微高亮；本期仅现价一项实时数据 | 2026-08-31 | 生效 | - | R-005 定稿（2026-08-31）：老师确认现价列 + 涨跌色 + 变化高亮 |
|
||
| 产品约束-006 | QMT 连接会话头部快捷切换：会话窗口顶栏（PTC 模式标签旁）常驻下拉控件（chip 显示 `QMT: <激活配置名>`），点开列出全部配置（激活项勾选），点选即激活并轻提示反馈；头部控件仅做切换，配置管理（增删改/测试连接/默认标记）仍在设置页子 tab | 2026-08-29 | 生效 | - | R-004 定稿（2026-08-29）：Q9/Q10 确认（入口=会话头部 PTC 旁，菜单仅切换激活） |
|
||
|
||
| 产品约束-008 | 交易记录支持**按策略过滤**：交易记录 tab 提供策略过滤下拉（全部 / 各策略 / 未关联），对今日（QMT 实时）与历史（本地 SQLite）均生效；策略归属 = 委托时间 join 持仓生命周期窗口推导（一码多策略取份额最大，未命中=未关联）；历史范围展示本地积累数据（不再「接口开发中」占位） | 2026-09-01 | 生效 | - | 新增（2026-09-01 R-009 定稿 + 迭代 07 实施）：策略过滤 + 历史本地展示 |
|
||
| 产品约束-010 | 策略自定义字段配置：每个策略在**策略 tab 顶部「列设置」旁的「字段配置」按钮（独立弹层）**中配置本策略的字段定义（字段名 / 类型文本·数字·布尔·枚举·**计算** / 枚举选项 / 默认值 / 单位 / 计算字段的公式与小数位），定义存 settings（不落库）；该策略下每个持仓（strategy_holdings 行）按所属策略的定义存取一份字段值（values JSON 列，持仓级键值对，key 对齐定义、允许扩展额外键）；旧策略无定义时行为与现状一致（不渲染字段区、不迁移历史值） | 2026-09-02 | 生效 | - | **变更（2026-09-10 R-027/R-026）**：入口由设置页「策略分组」迁到策略 tab 内「字段配置」弹层；类型新增「计算」（见 产品约束-014）；定义真相源迁 settings.strategyFields（原定稿：设置页策略分组配置、四类型、定义随策略存 settings） |
|
||
| 产品约束-009 | 会话 tab 统一由「Tab 设置」管理：设置页「Tab 设置」子 tab 是**所有会话 tab（系统内置 + 策略）的唯一顺序与显隐入口**，两类 tab 同权混排；每行 = 拖动排序（间隙高亮线）+ 显示/隐藏开关；**任何 tab 均不支持重命名与删除**；R-027 静态化后策略 tab 恒存在（不随任何 CRUD 增删），故「策略改名跟随 / 新增追加末尾 / 删除联动」等条款失效；顺序与显隐唯一数据源 = settings.tabs（由内置常量序列 + 存量偏好归一化得出） | 2026-09-02 | 生效 | - | **变更（2026-09-10 R-027 策略静态化）**：策略 tab 与内置 tab 完全同权且恒存在；原「策略命名/删除在策略分组子 tab」及联动增删条款失效（设置页「策略分组」子 tab 已移除） |
|
||
| 产品约束-011 | 持仓页数据（策略持仓 / 全部持仓 / 未分配）以服务端 10s 内存快照为准，**接受最多 10s 滞后**（同步时间前端不显示，老师拍板）；QMT 抖动/掉线时持仓页面显示**最后一次快照**而非空白；**幽灵自动清仓退役（变更 1，2026-09-08 R-018 数据域分界）**：同步机制不再把本地策略持仓自动转历史——策略持仓份额只由「交易关联（归属=账本写操作）」与「手动份额操作」驱动，账本转历史唯一途径 = 卖出单关联份额减至 0；对账单码消失仅表现为快照无此行 + **漏关联软提示**（只读提示去关联/移出，不自动写账本）；部分减持仅表现为「未分配为负」，不做自动修正 | 2026-09-02 | 生效 | - | 新增（2026-09-02 R-014 定稿）；**变更 1（2026-09-08 R-018/迭代 16 拍板）**：幽灵自动清仓退役（同步机制不写账本），策略持仓由交易关联 + 手动份额操作驱动；漏关联软提示替代自动归档 |
|
||
| 产品约束-012 | 行情数据服务形态（R-015）：现价/昨收/涨停/跌停统一由盘口内存快照提供（≤5s 更新），价格单一入口；QMT 抖动时页面价格保持旧值不空白；会话头部（QMT 健康灯旁）提供**持仓/盘口同步指示灯**——绿=同步正常（持仓 30s/盘口 15s 内）、黄=同步失败中快照陈旧、灰=从未同步；悬停显示同步时间/快照量/失败数/错误摘要；点击灯 = 立即触发该域同步；不做个股停牌标识（另议） | 2026-09-02 | 生效 | - | 新增（2026-09-02 R-015 定稿）：老师提出指示灯，采纳 AI 推荐三态/点击即同步/取消 PriceCell 灰点 |
|
||
| 产品约束-013 | 策略 tab 静态化（R-027）：会话 tab 中的策略 tab 恒为**插件内置两项**（网格超市 / 手动做T），与「全部持仓 / 交易记录」同类的内置 tab —— **不可新增、不可删除、不可重命名**；仍支持 Tab 设置中的显隐与拖拽排序；设置页不再有「策略分组」子 tab（设置页 = Tab 设置 / QMT 连接配置）；策略字段配置入口 = 策略 tab 顶部「列设置」**旁**的「字段配置」按钮（独立弹层），每个策略 tab 各管本策略字段 | 2026-09-10 | 生效 | - | 新增（2026-09-10 R-027 定稿 Q1-Q4/Q6 老师拍板）：静态化程度=固定不可增删改名但保留显隐/排序；入口形态=列设置旁独立按钮；范围=每策略管自己的字段 |
|
||
| 产品约束-014 | 策略计算字段（R-026）：字段类型新增「计算（formula）」——用户在字段配置中写**公式**（**中文变量名**，如 `(现价 - 成本价) × 份额`），公式引用**服务端缓存数据集**（行情盘口 / 合约信息（涨停跌停）/ 持仓账本（份额·成本价·最后成交价）/ 本行手填字段值），由服务端按**持仓行实时计算**得出列值；计算字段**不落库**（不写 values 列）、在持仓表中**只读**（不可内联编辑）；变量**只能引用非计算字段**（零循环依赖）；缺数据 / 除零 / 无法计算 → 该格显示 `—`（不显示 NaN、不报错、不炸表）；历史持仓行显示 `—`（不做历史时点计算）；**结果类型两种（R-028 扩展）**：`resultKind = number | boolean` —— **数字**（默认，按小数位+单位格式化）与**判定**（比较运算结果：满足显示 `✓ <字段名>`（success 绿）、不满足或数据缺失显示 `—`），结果类型在字段表单**显式声明**且必须与公式形态一致（服务端校验）；公式能力边界 = 四则运算 + 括号 + 比较（`> < >= <= == !=`）+ 逻辑组合（`and / or`，含 `&& ||` 与全角 `≥ ≤ ≠`）+ round/abs/min/max，禁止任意代码执行 | 2026-09-10 | 生效 | - | 新增（2026-09-10 R-026 定稿 Q1-Q3 + Q4-Q10 + D-1~D-7 老师拍板）：数据集首批三组、中文变量名、仅行级、服务端现算、只读列、缺值 —；**变更（2026-09-10 R-028）**：原「首批结果只做数字」扩展为「数字 / 判定」双类型 + 逻辑组合，首个落地用例 = 网格超市「可下空单 / 可下多单」 |
|
||
|
||
<!-- 示例条目（确认格式后删除）：
|
||
| 产品约束-001 | 示例：求签功能必须保证抽取结果的不可预测性 | 2026-08-26 | 生效 | - | 讨论确认：为保证公平性，抽取必须不可预测 |
|
||
--> |