迭代16: 交易关联驱动持仓份额动态调整（R-018）
This commit is contained in:
@@ -20,7 +20,7 @@
|
||||
| 产品约束-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-02 R-013 定稿 Q1-Q4 + D6）：定义随策略走、值随持仓行，类型化（含枚举），旧策略兼容 |
|
||||
| 产品约束-009 | 会话 tab 统一由「Tab 设置」管理：设置页「Tab 设置」子 tab 是**所有会话 tab（系统内置 + 策略分组）的唯一顺序与显隐入口**，两类 tab 混排；每行 = 拖动排序 + 显示/隐藏开关；**任何 tab 均不支持重命名与删除**（内置 tab 名称只读，策略命名/删除仍在「策略分组」子 tab）；策略改名后 Tab 设置中的名称自动跟随（只存引用）；新增策略默认追加到列表末尾；删除策略联动删除 Tab 设置中对应条目；顺序与显隐唯一数据源 = settings.tabs 有序数组 | 2026-09-02 | 生效 | - | R-011 定稿（2026-09-02 Q1-Q5 确认）：Tab 设置 = 显示/隐藏 + 拖动排序（落点立即持久化），全 tab 禁重命名/删除 |
|
||||
| 产品约束-011 | 持仓页数据（策略持仓 / 全部持仓 / 未分配）以服务端 10s 内存快照为准，**接受最多 10s 滞后**（同步时间前端不显示，老师拍板）；QMT 抖动/掉线时持仓页面显示**最后一次快照**而非空白；QMT 已卖光的票（连续 3 轮同步确认消失）本地持仓自动转历史（幽灵清仓，不物理删除）；部分减持仅表现为「未分配为负」，不做自动修正 | 2026-09-02 | 生效 | - | 新增（2026-09-02 R-014 定稿）：老师四问拍板（内存不落库 / 读穿透兜底 / 幽灵自动清仓 / 不显示同步时间） |
|
||||
| 产品约束-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 灰点 |
|
||||
<!-- 示例条目（确认格式后删除）：
|
||||
| 产品约束-001 | 示例：求签功能必须保证抽取结果的不可预测性 | 2026-08-26 | 生效 | - | 讨论确认：为保证公平性，抽取必须不可预测 |
|
||||
|
||||
@@ -26,7 +26,7 @@
|
||||
| 技术约束-015 | 策略自定义字段存储（R-013，2026-09-02）：字段定义随策略定义存 settings.strategies 扩展 configSchema（[{key,label,type,enum?,def}]，type ∈ text|number|boolean|enum，旧项缺省空数组）；字段值落 strategy_holdings 新增 values TEXT（JSON 键值对，key 对齐 configSchema.key，允许额外键=可扩展，NULL=未配置）；补列用幂等 ALTER（沿用 _ensureTradeAttributionColumns 模式，只读连接容忍）；API：strategy-positions 每行附 values，新增 holdings/values-update {holdingId, values} 写回，服务端按 configSchema 校验（number=有限数、enum=在选项内、boolean=布尔），空值/缺省可写入；持仓生命周期操作（openHolding/addShares/reduceShares/closeHolding）不碰 values 列 | 2026-09-02 | 生效 | - | 新增（2026-09-02 R-013 定稿 + PLAN-012）：定义 settings + 值 SQLite 列 + 幂等补列 + 类型校验 |
|
||||
| 技术约束-014 | 会话 tab 注册与顺序显隐（R-011）：客户端注册统一读 **settings.tabs 有序数组**（唯一顺序与显隐来源，内置条目 refKey + 策略条目 refId），按 order 排序、过滤 visible 后注册（builtin 走内置 render、strategy 走 StrategyTab），移除硬编码 order 间隔（原内置 10/11/12、策略 13+）；settings.tabs 从布尔对象升级为有序数组，读取时对旧格式（布尔对象 + 策略自带 order/visible）静默归一化迁移（旧隐藏策略迁移后显示），写入即落库；策略定义表收窄为 {id,name}（去除 visible/order）；tabs/update 语义改为整表更新（顺序 + 显隐），strategies/add 联动追加 tab 条目（末尾），strategies/remove 联动删除对应 tab 条目，废弃 strategies/move | 2026-09-02 | 生效 | - | R-011 定稿（2026-09-02 Q1-Q5 确认）：统一 tabs 有序数组 + 自动迁移 + 联动增删 |
|
||||
| 技术约束-016 | src 目录按功能域归类（2026-09-02 结构优化）：服务端代码**禁止平铺**，按职责域分目录 —— src/data-source/（QmtBridgeRestDataSource + data-source-types + QmtHealthMonitor，数据源与连接健康）、src/storage/（SqliteStore + DataStore，存储层）、src/position/（PositionManager，分仓逻辑）、src/market/（MarketDataHub + MarketFeed，行情）、src/trades/（TradeSync，交易同步）；api/ 按领域拆分子文件（positions/strategies/qmt-connections/market/trades），client/ 仅放 UI（views/ 组件 + market/ provider）；文件命名 = 类名（PascalCase）+ .js/.jsx；新增服务端模块必须先落对应域目录，无合适域时先讨论补域，不得回退平铺 | 2026-09-02 | 生效 | - | 新增（2026-09-02 结构审查 + 优化落地）：component/ 平铺还原为语义分域，删除死代码 AllocationStorage、DataStore.setDataset/removeDataset |
|
||||
| 技术约束-017 | 持仓内存快照（R-014，2026-09-02）：全量实盘持仓由服务端 PositionSync **进程内内存快照**管理（启动预热 + 10s 定时全量拉 /trade/positions → 校验 → 整体替换），**不落库**（无缓存表、不复用 strategy_holdings——账本与对账单分离，holding_id 交易锚点不掺易变快照；判断标准：外部可一次调用重取全的实时投影不落库）；PositionManager.getAllPositions 以快照为准（strategy-positions / unallocated / summary 三接口不再请求时穿透 QMT），快照为空读穿透兜底（当场拉一次并回填）；同步失败保留上次快照（不清空不报错）；空快照双重确认（/health 可用 + getAsset 账户身份可识别）才接受为真清仓；幽灵清仓：快照连续 3 轮（约 30s）消失的 code 该码全部策略当前持仓自动 closeHolding 转历史（不物理删除），账户身份守卫防误清（accountId 未知当轮跳过、切换当轮重置跳过）；syncNow 允许手动调用（mounted 只管定时循环，不拦手动同步） | 2026-09-02 | 生效 | - | 新增（2026-09-02 R-014 定稿 + 迭代 12 实施）：AI 初版建缓存表方案经老师质疑反转为内存方案（落库三问：不可再生？重启首屏依赖？读放大/复杂查询？全否 → 内存） |
|
||||
| 技术约束-017 | 持仓内存快照（R-014，2026-09-02；**变更 1：2026-09-08 R-018 数据域分界**）：全量实盘持仓由服务端 PositionSync **进程内内存快照**管理（启动预热 + 10s 定时全量拉 /trade/positions → 校验 → 整体替换），**不落库**（账本与对账单分离，holding_id 交易锚点不掺易变快照）；PositionManager.getAllPositions 以快照为准（strategy-positions / unallocated / summary 三接口不再请求时穿透 QMT），快照为空读穿透兜底；同步失败保留上次快照；空快照双重确认（/health 可用 + getAsset 账户身份可识别）才接受为真清仓；syncNow 允许手动调用。**幽灵自动清仓**（R-014 原条款：快照连续 3 轮消失 → 本地全部策略当前持仓 closeHolding 转历史）**退役**——同步机制只作用于对账单域，不再写 strategy_holdings 账本（R-018 老师拍板：幽灵清仓本就是一个同步机制，不可以让幽灵把爪子伸太长）；账本行转历史唯一途径 = 卖出单关联减至 0 closeHolding（R-018）；对账单域「码消失」仅表现为快照无此行 + 漏关联软提示（positions/orphan-hints 只读提示） | 2026-09-02 | 生效 | - | 新增（2026-09-02 R-014 定稿 + 迭代 12 实施）；**变更 1（2026-09-08 R-018/迭代 16 拍板）**：幽灵自动清仓退役（不再 closeHolding 本地账本），PositionSync 只同步对账单快照；漏关联由只读软提示承担 |
|
||||
| 技术约束-018 | 盘口内存快照（R-015，2026-09-02）：行情数据由 QuoteSync（取数：启动 prime + 5s REST 定时刷 watch 集合 + 涨停跌停经 /data/instrument 按**交易日**内存缓存）与 QuoteHub（存查：内存快照 Map + watchCodes Set + 读穿透走 dataSource.getTicks + getQuote/getByCodes 对外）管理，**替换并删除 MarketFeed/MarketDataHub**（方案 A，不留兼容壳）；**WS 数据通路移除**（ingest 入口带 source 标签留回归口子）；**market_quotes_cache 表退役 DROP**（幂等），价格单一入口 = QuoteHub，DataStore 行情方法（loadMarket/getMarketQuote(s)/setMarketQuotes）删除；同步失败保留内存旧值；watchCodes 维持只进不出无上限；涨停/跌停/昨收不落库 | 2026-09-02 | 生效 | - | 新增（2026-09-02 R-015 定稿 + 迭代 13 实施）：老师五拍板（替换/WS 移除/纯内存 DROP/watch 现状/指示灯）；warmup bug 复现（loadMarket return this 残迹）为不落库关键证据 |
|
||||
|
||||
| 技术约束-019 | 历史持仓查询（R-016，2026-09-07）：策略 tab 历史持仓展示走**本地库只读查询**（SqliteStore.getHoldingsHistory：strategy_id + closed_at IS NOT NULL + closed_at ≥ sinceMs，closed_at DESC），经独立端点 strategy-holdings/history 暴露；**当前持仓路径（strategy-positions / PositionSync 快照语义）不掺历史数据**（两份结果前端合并渲染）；closeHolding 置 shares=0 语义维持不变（Q2 老师拍板：历史行份额显示 0，重点在追溯该持仓的历史操作而非清仓时份额）；范围换算服务端做（week=7d/month=30d/quarter=90d/halfYear=182d/year=365d 自然日近似）——**变更 1（2026-09-07 二轮补充 Q8-Q9 老师拍板）**：range 新增 'today' = **本地自然日 00:00 起**（特判零点，不落回溯毫秒档），供前端「今日已清仓默认层」（恒显示、不受历史持仓开关控制）；历史范围层语义收窄为**今天之前**；其余不变 | 2026-09-07 | 生效 | - | 变更 1（2026-09-07 R-016 二轮补充 Q8-Q9 老师拍板）：+range=today 自然日边界，历史开关只控今天之前；首轮新增（Q1-Q7）：历史行=追溯操作锚点，不动存储写路径 |
|
||||
|
||||
+66
-3
@@ -364,7 +364,7 @@ CREATE INDEX IF NOT EXISTS idx_trade_fills_date ON trade_fills (trade_date);
|
||||
| 失败策略 | 同步失败**保留上次快照**，不清空不报错 | 读方继续消费旧快照，QMT 抖动不再白屏（强于旧的穿透行为） |
|
||||
| 空快照 | 双重确认（/health 可用 + getAsset 账户身份可识别）才接受为「真清仓」，否则视为异常保留旧快照 | 防一次异常响应清空缓存 |
|
||||
| 读路径 | `getAllPositions()` 读内存快照；快照为空 → 读穿透当场拉一次并回填；QMT 也挂 → 抛错（前端 LoadState 重试） | 首启兜底；未注入 positionSync 时保持旧行为（兼容） |
|
||||
| 幽灵持仓自动清仓 | QMT 快照连续 3 轮（约 30s）消失的 code，本地全部策略当前持仓 closeHolding 转历史；**账户身份守卫**：accountId 未知当轮跳过、账户切换当轮重置跳过（防误清）；部分减持不触发（负数未分配由 UI 暴露） | 老师选定；清仓转历史不物理删除，历史保留语义不变 |
|
||||
| ~~幽灵持仓自动清仓~~（**退役，2026-09-08 R-018 数据域分界**） | ~~QMT 快照连续 3 轮消失 → 本地全部策略当前持仓 closeHolding 转历史~~ → **不再写 strategy_holdings**：同步机制只作用于对账单域（老师拍板：幽灵清仓本就是一个同步机制，不可以让幽灵把爪子伸太长）；账本转历史唯一途径 = 卖出单关联减至 0（R-018）；对账单码消失 → 快照无此行 + 漏关联软提示（positions/orphan-hints，只读） | R-014 选定时防本地账本残留；R-018 改由交易关联驱动账本生命周期，幽灵自动归档与「账本只由关联交易改」冲突 → 退役（迭代 16 实施，见 §12） |
|
||||
| 前端 | 零改动 | 三个接口数据源自动切换 |
|
||||
|
||||
### 11.2 数据流（持仓部分，替代原「读取时组装」描述）
|
||||
@@ -383,8 +383,71 @@ CREATE INDEX IF NOT EXISTS idx_trade_fills_date ON trade_fills (trade_date);
|
||||
| PositionManager | getAllPositions 改读快照 + 读穿透兜底（未注入 sync 时兼容旧穿透） | src/position/PositionManager.js |
|
||||
| 回归测试 | 纯内存 mock 34 项（同步/失败保留/空快照/幽灵防抖/账户守卫/读穿透/组装回归） | scripts/test-position-sync.mjs |
|
||||
|
||||
## 12. 约束条目（引用）
|
||||
## 12. 归属分段存储设计（R-018 落实，2026-09-08 迭代 16 实施）
|
||||
|
||||
- 技术约束-012：数据存储遵循本文件（SQLite 存储设计，含交易记录表 §10）；
|
||||
> **变更理由**（R-018 老师拍板）：交易归属从「纯标签」（trade_orders 单组 strategy_id/holding_id，不改数量）升级为**账本写操作**——关联即自动调整 strategy_holdings 份额；支持一笔委托拆多段分配多策略；撤段做逆操作。归属真相源从 trade_orders 两列迁移到**分段表**。
|
||||
|
||||
### 12.1 strategy_holdings 状态扩展（作废第三态 + 清仓份额快照）
|
||||
|
||||
```sql
|
||||
-- 幂等 ALTER（沿用 _ensureXxxColumn 模式）
|
||||
ALTER TABLE strategy_holdings ADD COLUMN void_at INTEGER; -- 作废时间（NULL=有效；非 NULL=建仓被撤=从未成立；不进历史层）
|
||||
ALTER TABLE strategy_holdings ADD COLUMN closed_shares REAL; -- 清仓前份额快照（closeHolding 写入，供撤卖出段恢复活动用）
|
||||
-- 活动唯一索引收窄（R-018：活动 = closed_at IS NULL AND void_at IS NULL）
|
||||
DROP INDEX IF EXISTS idx_active_holding;
|
||||
CREATE UNIQUE INDEX IF NOT EXISTS idx_active_holding
|
||||
ON strategy_holdings (strategy_id, code) WHERE closed_at IS NULL AND void_at IS NULL;
|
||||
```
|
||||
|
||||
- 生命周期操作语义：closeHolding = shares 置 0 + closed_at + **closed_shares=清仓前份额**（shares 展示仍 0，R-016 Q2 语义不变）；voidHolding（新增）= shares 置 0 + void_at（非清仓：建仓被撤 = 从未成立）；
|
||||
- 作废行不进 R-016 历史「已清仓」层（getHoldingsHistory 过滤 void_at IS NULL），保留数据可追溯。
|
||||
|
||||
### 12.2 归属分段表 trade_order_attributions
|
||||
|
||||
```sql
|
||||
CREATE TABLE IF NOT EXISTS trade_order_attributions (
|
||||
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||
order_id TEXT NOT NULL, -- → trade_orders.order_id
|
||||
strategy_id TEXT NOT NULL, -- 段归属策略
|
||||
holding_id INTEGER NOT NULL, -- 段锚点持仓（R-010 展开用）
|
||||
code TEXT NOT NULL, -- 冗余
|
||||
direction TEXT NOT NULL, -- buy/sell（冗余，撤段判向）
|
||||
volume REAL NOT NULL, -- 该段已成交量（>0；总额 ≤ order.traded_volume）
|
||||
created_at INTEGER NOT NULL
|
||||
);
|
||||
CREATE UNIQUE INDEX IF NOT EXISTS idx_attr_order_strategy ON trade_order_attributions (order_id, strategy_id);
|
||||
CREATE INDEX IF NOT EXISTS idx_attr_holding ON trade_order_attributions (holding_id);
|
||||
CREATE INDEX IF NOT EXISTS idx_attr_strategy ON trade_order_attributions (strategy_id);
|
||||
```
|
||||
|
||||
- **真相源 = 段表**；trade_orders.strategy_id/holding_id 退役为冗余（保留列不删，防外部脚本 break；不再作为查询/过滤源）；
|
||||
- 存量迁移：段表空且 trade_orders 有单组归属 → 迁为第一段（volume = 该单 traded_volume；幂等）；
|
||||
- 查询适配：orders 附加归属、by-holding（R-010）、历史策略过滤（R-009）全部改经段表。
|
||||
|
||||
### 12.3 关键设计决策（R-018 迭代 16）
|
||||
|
||||
| 决策 | 结论 | 理由 |
|
||||
|---|---|---|
|
||||
| 归属真相源 | **分段表 trade_order_attributions**（order → 多段 strategyId/holdingId/volume） | 一笔委托可拆 N 段关联不同策略（R2/R4）；单列两字段无法表达 |
|
||||
| 数据域分界 | PositionSync/幽灵清仓**只写对账单快照**，不写 strategy_holdings | R-018 老师拍板：同步机制不伸爪子到账本；账本只由交易关联 + 手动份额操作驱动 |
|
||||
| 关联驱动量 | 段 volume = 该段**已成交量** | Q4：撤单/废单不动账 |
|
||||
| 撤段逆操作 | 撤 buy 段 → 减回 / 归零作废（void）；撤 sell 段 → 加回 / 恢复活动仓（closed_shares） | R3/R6/R7：作废 ≠ 清仓（不产生假清仓历史）；恢复用 closed_shares 快照 |
|
||||
| 撤段约束 | 同 holding 内**逆序撤销**（乱序返回 segment-order-conflict）；跨 holding 段独立可任意撤 | 账本正确性 > 操作便利（宁可拒绝不写错账） |
|
||||
| 事务 | setSegments 全量替换在**单事务**内（撤旧段 + 加新段） | 改归属原子性（R3 边界） |
|
||||
|
||||
### 12.4 对应实现（追加）
|
||||
|
||||
| 模块 | 职责 | 文件 |
|
||||
|---|---|---|
|
||||
| AttributionService | 归属服务：apply/revoke/setSegments（动作表判定 + 逆操作 + 事务） | src/trades/AttributionService.js（新增） |
|
||||
| SqliteStore | 增列/索引重建/voidHolding/close 快照/段表 CRUD/runInTransaction/查询改段表/存量迁移 | src/storage/SqliteStore.js |
|
||||
| api/trades.js | attribution-targets / attribution-set / attribution-segments；orders 附加段 | src/api/trades.js |
|
||||
| PositionSync | 删除幽灵清仓逻辑（只同步对账单快照） | src/position/PositionSync.js |
|
||||
| 回归测试 | 分界/动作表/撤段/迁移/软提示 | scripts/test-r018-attribution.mjs（新增） |
|
||||
|
||||
## 13. 约束条目（引用）
|
||||
|
||||
- 技术约束-012：数据存储遵循本文件（SQLite 存储设计，含交易记录表 §10、归属分段存储 §12）；
|
||||
- 技术约束-011：测试/回归脚本禁止在真实数据上执行写操作（独立数据目录）；
|
||||
- 技术约束-017（变更 1，2026-09-08）：幽灵自动清仓退役，PositionSync 只同步对账单快照；
|
||||
- 本文件为新领域设计约束，后续数据存储变更以本文件为最终依据。
|
||||
Reference in New Issue
Block a user