Compare commits
2 Commits
ed43ecae39
...
22ec732607
| Author | SHA1 | Date | |
|---|---|---|---|
 kyugao
|
22ec732607 | ||
|
kyugao
|
51c70c48fb |
@@ -0,0 +1,27 @@
|
||||
# 计划：委托归属候选纳入近期清仓持仓（阶段航点）
|
||||
|
||||
> 编号：PLAN-016 ｜ 粒度：阶段航点 ｜ 创建：2026-09-07 ｜ 状态：**已实施（待验收）**
|
||||
> 派生自终极目标：目标-008（真实交易系统接入）
|
||||
> 依据需求：**R-017（已定稿，2026-09-07，老师指令确认方向）** —— 符合入范围门槛
|
||||
> 设计约束：技术约束-013 语义延伸（候选窗口 + holdingId 键控）；不新增约束条目
|
||||
|
||||
## 目标
|
||||
|
||||
清仓后当日委托可补关联：归属候选 = 该 code 当前持仓 + 近 7 天清仓持仓（closed 标记），下拉锚点改 holdingId 键控。
|
||||
|
||||
## 范围
|
||||
|
||||
**做**：getAttributionCandidates 扩展（closed_at IS NULL OR ≥ 7 天前；closed/closedAt 字段；当前在前/清仓 closed_at DESC）+ AttributionSelect holdingId 键控 + 「（已清仓 MM-DD）」后缀 + 「当前归属」占位选项 + 回归 test-r017-candidates.mjs。
|
||||
**不做**：候选窗口可配置；自动归属；其他候选消费方调整；历史数据修复工具（一次性修复走 set-attribution）。
|
||||
|
||||
## 涉及文件
|
||||
|
||||
src/storage/SqliteStore.js（getAttributionCandidates）、src/client/views/TradeRecordsTab.jsx（AttributionSelect）、scripts/test-r017-candidates.mjs（新增）。
|
||||
|
||||
## 实现步骤
|
||||
|
||||
1. R-017 + 本计划 + 三件套；2. 存储扩展；3. UI 重构；4. 回归 + typecheck + build + 存量回归；5. 复盘。
|
||||
|
||||
## 验收要点
|
||||
|
||||
见 `docs/04-迭代记录/15-归属候选纳入清仓持仓/验收标准.md`。
|
||||
@@ -0,0 +1,49 @@
|
||||
# 计划：策略 tab 历史持仓展示（显示/隐藏已清仓持仓 + 清仓时间范围筛选）（阶段航点）
|
||||
|
||||
> 编号：PLAN-015 ｜ 粒度：阶段航点 ｜ 创建：2026-09-07 ｜ 状态：**已实施（待验收）**
|
||||
> 派生自终极目标：目标-003（按策略监控市场）、目标-008（真实交易系统接入）
|
||||
> 依据需求：**R-016（已定稿，2026-09-07，Q1-Q7 老师拍板）** —— 符合入范围门槛
|
||||
> 设计约束：新增 技术约束-019（历史持仓查询走本地库，当前持仓快照语义不掺历史）
|
||||
|
||||
## 目标
|
||||
|
||||
两个策略 tab（做T / 网格超市）title 旁提供「历史持仓」开关 + 清仓时间范围筛选（默认近一周，另有近 1 个月 / 近 3 个月 / 近半年 / 近 1 年）；历史持仓行可展开查看关联交易记录（复用 R-010），补上「清仓即失联」的操作追溯缺口。
|
||||
|
||||
## 范围
|
||||
|
||||
**做**：
|
||||
1. **存储层**（SqliteStore）：新增 getHoldingsHistory(strategyId, { sinceMs }) —— closed_at 非空 + closed_at ≥ sinceMs 过滤 + 按 closed_at DESC 排序（读只读，零写路径变更，不改 closeHolding 语义）；
|
||||
2. **门面层**（DataStore）：getHoldingsHistory 透传（await _ensure 后委托）；
|
||||
3. **API**：新增 strategy-holdings/history 端点（args: strategyId 必填 + range ∈ week|month|quarter|halfYear|year，服务端换算 sinceMs；缺失/非法参数报参数错误）；strategy-positions 等现有端点零改动；
|
||||
4. **前端 StrategyTab**：
|
||||
- 头部按钮区（+ 添加持仓 / 列设置 旁）新增「历史持仓」开关按钮 + 范围下拉（仅开关开启时显示；默认 week）；
|
||||
- 开启时懒加载历史数据（切换范围重新拉取；关闭即隐藏不销毁缓存）；进 tab 默认关（会话级，不持久化）；
|
||||
- 历史行渲染在当前持仓行之后：代码 / 名称（关联委托 name 兜底，无则 —）/ 份额（显示 DB 原值 0，Q2）/ 清仓时间 / 持有天数；实时行情列（现价/涨幅/涨停跌停/今开/最高）显示 —；
|
||||
- 历史行灰显 + 「已清仓」徽标（含清仓日期）；标题计数（N 只）只数当前持仓；
|
||||
- 历史行行展开复用 R-010（trades/by-holding，按 holdingId 懒加载）；
|
||||
- 自定义字段列历史行只读展示（values 随行返回，无编辑入口）；
|
||||
5. **回归脚本** scripts/test-r016-history.mjs（独立临时数据目录，技术约束-011）。
|
||||
|
||||
**不做**：全部持仓 tab；盈亏统计；清仓方式标记；历史行实时行情；成本价/收益推导；closeHolding 语义与任何存储写入路径变更；范围偏好持久化；「全部历史」档位。
|
||||
|
||||
## 涉及文件
|
||||
|
||||
- 修改：src/storage/SqliteStore.js、src/storage/DataStore.js、src/api/strategies.js、src/client/views/StrategyTab.jsx
|
||||
- 新增：scripts/test-r016-history.mjs
|
||||
|
||||
## 实现步骤
|
||||
|
||||
1. 本文档链（PLAN + 迭代三件套 + 技术约束-019）；2. SqliteStore.getHoldingsHistory + DataStore 门面；3. API 端点；4. StrategyTab 开关/范围/历史行渲染/展开复用；5. 回归脚本 + typecheck + build + 存量回归（test-position-sync / test-r013 / test-quote-sync）；6. 复盘。
|
||||
|
||||
## 验收要点
|
||||
|
||||
见 `docs/04-迭代记录/14-策略tab历史持仓展示/验收标准.md`。
|
||||
|
||||
## 二轮补充（2026-09-07 Q8-Q9 老师拍板：今日已清仓默认层）
|
||||
|
||||
- **补充范围**：已清仓行分两层——L1「今日已清仓」（range='today'，本地自然日 00:00 起）默认恒显示、不受「历史持仓」开关控制；L2「历史范围层」（今天之前的 week/month/quarter/halfYear/year）仍由开关控制（默认关）。前端按 holdingId 去重两层（开启范围不重复出两行）；标题计数不含已清仓行维持；零写路径变更维持。
|
||||
- **不做（维持首轮）**：不做统计 / 不改 closeHolding / 范围偏好不持久化 / 全部持仓 tab 不加 / 不新增「全部历史」档。
|
||||
|
||||
## 验收要点（二轮）
|
||||
|
||||
见验收标准「二轮补充验收线 7-10」；自动化已复跑：test-r016 24/24 + 存量回归全绿。
|
||||
@@ -28,6 +28,8 @@
|
||||
| 技术约束-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 初版建缓存表方案经老师质疑反转为内存方案（落库三问：不可再生？重启首屏依赖？读放大/复杂查询？全否 → 内存） |
|
||||
| 技术约束-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）：历史行=追溯操作锚点，不动存储写路径 |
|
||||
<!-- 示例条目（确认格式后删除）：
|
||||
| 技术约束-001 | 示例：技术栈以 Node.js / TypeScript 为准，不引入未讨论的新框架 | 2026-08-26 | 生效 | - | 讨论确认：优先复用 DSH 既有能力，新框架需论证 |
|
||||
-->
|
||||
@@ -0,0 +1,79 @@
|
||||
# 技术实现方案：14-策略tab历史持仓展示
|
||||
|
||||
> 迭代编号：14 ｜ 依据：PLAN-015 + R-016（老师拍板：Q2 显示 0 / 其余按建议）
|
||||
|
||||
## 1. 存储层（SqliteStore.getHoldingsHistory）
|
||||
|
||||
```js
|
||||
/** 某策略已清仓持仓（closed_at 非空），closed_at ≥ sinceMs，按 closed_at DESC */
|
||||
getHoldingsHistory(strategyId, { sinceMs } = {}) {
|
||||
// SELECT holding_id, strategy_id, code, shares, created_at, closed_at, "values"
|
||||
// FROM strategy_holdings
|
||||
// WHERE strategy_id=? AND closed_at IS NOT NULL [AND closed_at >= ?]
|
||||
// ORDER BY closed_at DESC
|
||||
// 返回 _mapHolding 同构（holdingId/strategyId/code/shares/createdAt/closedAt/values）
|
||||
}
|
||||
```
|
||||
|
||||
- 只读新增；**零写路径变更**（closeHolding 维持 shares=0 + closed_at，Q2 定稿）；
|
||||
- sinceMs 缺省 = 不过滤（内部能力预留；API 层始终传值）；
|
||||
- 与 getHoldingHistory(code) 并存：后者是全表按 code 查（R-008 遗留），不满足本需求维度，不复用不改动。
|
||||
|
||||
## 2. 门面层（DataStore）
|
||||
|
||||
```js
|
||||
async getHoldingsHistory(strategyId, opts) { await this._ensure(); return this.sqlite.getHoldingsHistory(strategyId, opts); }
|
||||
```
|
||||
|
||||
## 3. API（src/api/strategies.js 新 method）
|
||||
|
||||
- method：`strategy-holdings/history`；
|
||||
- args：`{ strategyId: string, range: 'week'|'month'|'quarter'|'halfYear'|'year' }`；
|
||||
- range → sinceMs 换算（服务端）：week=7d / month=30d / quarter=90d / halfYear=182d / year=365d（自然日近似，回溯窗口展示用途足够，精确日历边界无业务含义）；
|
||||
- 缺 strategyId 或 range 非法 → 参数错误（code: 'bad-request'）；
|
||||
- 返回行附加 name 兜底：按 holdingId 查 trade_orders 取最新一笔的 name（SQL 单查，无则 null）——前端直接展示，免二次请求。
|
||||
|
||||
## 4. 前端（StrategyTab.jsx）
|
||||
|
||||
- 状态：`showHistory`（默认 false）、`historyRange`（默认 'week'）、`historyRows`、`historyLoading`；
|
||||
- 头部按钮区：「历史持仓」toggle 按钮 + 开启时显示范围下拉（近一周/近1个月/近3个月/近半年/近1年）；
|
||||
- 数据流：开启或切范围 → call('one-divine-lot/strategy-holdings/history', { strategyId, range })；缓存按 range 键保留，关闭仅隐藏；
|
||||
- 渲染：rowsForRender = 当前持仓行 +（showHistory ? 历史行 : []）；历史行标识 `isHistory: true`；
|
||||
- 行样式：opacity/灰色调（--dsw-alias-label-tertiary）+ 徽标「已清仓 YYYY-MM-DD」；
|
||||
- 单元格：代码/名称/清仓时间（YYYY-MM-DD HH:mm）/持有天数（ceil((closedAt-createdAt)/86400000)，同日=1）；shares 列显示 DB 原值（=0，Q2）；行情类列（lastPrice/pctChange/lastClose/avgPrice/lastTradePrice/upStop/downStop/open/high）一律 —（不注册行情、不取价）；自定义字段列：p.values 只读展示，禁点击编辑（isHistory 不进入 FieldCellEditor 分支）；
|
||||
- 展开：复用 toggleExpand(code, holdingId) → trades/by-holding（历史行同样有效）；
|
||||
- 排序：当前行维持现状（涨幅排序仅作用于当前行集合）；历史行固定清仓时间 DESC 追加在后；
|
||||
- 计数：标题（N 只）= 当前持仓数，不含历史行。
|
||||
|
||||
## 5. 回归脚本（scripts/test-r016-history.mjs）
|
||||
|
||||
- ODL_TEST_DATA_DIR 临时目录（技术约束-011，不碰真实数据）；
|
||||
- 覆盖：建仓→清仓→history 可查 / 范围过滤边界（7d/30d…）/ 排序 / 策略隔离 / 未清仓行不出现 / API 参数校验 / name 兜底。
|
||||
|
||||
## 6. 验证链
|
||||
|
||||
typecheck → build → test-r016 → 存量回归（test-position-sync 34 / test-r013 21 / test-quote-sync）→ 人工验收清单。
|
||||
|
||||
## 7. 二轮补充实现：今日已清仓默认层（2026-09-07 老师拍板 Q8-Q9）
|
||||
|
||||
> 在首轮（§1-6）基础上追加；首轮实现保持可追溯，新增改动如下。
|
||||
|
||||
### 7.1 服务端（src/api/strategies.js）
|
||||
|
||||
- range 新增 today：**特判本地自然日零点**（localDayStartMs，setHours(0,0,0,0)），sinceMs = 本地今天 00:00；不落入 HISTORY_RANGE_MS 回溯毫秒档（那 5 档语义 = now − 范围，today 语义 = 自然日边界，两类不可混）；
|
||||
- 参数校验错误信息扩为 today|week|month|quarter|halfYear|year；其余逻辑（strategy_id 过滤 + name 兜底 + DESC 排序）与 5 档完全复用——**SqliteStore/DataStore 零改动**（sinceMs 本就通用）。
|
||||
|
||||
### 7.2 前端（src/client/views/StrategyTab.jsx）
|
||||
|
||||
- 状态：historyRows 缓存键新增 today（与 5 档并存互不干扰）；
|
||||
- **数据流**：loadHistory 定义提前到 load 之前；load() 的 finally 里调 loadHistory('today')——进 tab 即拉 + 每次持仓重载（移出/加仓/编辑后 load()）都刷新今日已清仓层，当天清仓转历史后 tab 内不因此少行；
|
||||
- **渲染合成（rowsToRender）**分两层：
|
||||
- L1 = histRowsFor('today') —— **恒显示**（showHistory 关也显示）；当前持仓行后追加，清仓时间 DESC；
|
||||
- L2 = showHistory 开时追加 histRowsFor(historyRange)，**按 holdingId 去重**（剔除已含于 L1 的行，避免今天清仓 + 开启近一周出现两行）；
|
||||
- 交互文案：开关 title 更新为「显示/隐藏今天之前已清仓的历史持仓（当天已清仓的持仓始终显示）」；文件头注释同步；
|
||||
- 标题计数（N 只）仍只算当前持仓，两层已清仓行不计入。
|
||||
|
||||
### 7.3 回归（scripts/test-r016-history.mjs）
|
||||
|
||||
- 新增 [4b] range=today：昨天 23:59:59 清仓不出现 / 今天 00:00:01 清仓出现 / 不含 40 天前行 / today 行 name 兜底同样生效 / range 非法校验不受 today 引入影响；
|
||||
- 验证链复跑：test-r016 24/24 + 存量回归全绿（见迭代复盘）。
|
||||
@@ -0,0 +1,38 @@
|
||||
# 迭代复盘：14-策略tab历史持仓展示
|
||||
|
||||
> 复盘日期：2026-09-07 ｜ 迭代状态：**已实施，待老师人工验收**
|
||||
> 关联需求：R-016 ｜ 关联计划：PLAN-015
|
||||
|
||||
## 结果
|
||||
|
||||
迭代 14 达成：两个策略 tab（做T / 网格超市）title 旁新增「历史持仓」开关 + 清仓时间范围筛选（近一周默认 / 近 1 个月 / 近 3 个月 / 近半年 / 近 1 年）；已清仓持仓行灰显 + 「已清仓」徽标（含清仓日期）追加在当前持仓行后（closed_at DESC），展开复用 R-010 查看关联交易——补上「清仓即失联」的操作追溯缺口。当前持仓快照路径（R-014 语义）与所有写路径（closeHolding 置 shares=0，Q2 拍板）零改动。
|
||||
|
||||
## 过程事实
|
||||
|
||||
1. **讨论驱动定稿**（2026-09-07，Q1-Q7 老师逐项拍板）：Q2 为本轮唯一改判——AI 建议改 closeHolding 保留清仓时份额，老师否决：「显示 0 就好了，即使显示了清仓时的 shares 也没多少意义，主要目标是追溯这次持仓相关的历史操作」——需求核心从「数据完整性」校正为「操作追溯锚点」，方案随之收敛为零写路径变更；其余六问均按 AI 建议定稿；
|
||||
2. **实现**（严格按 PLAN-015 步骤）：SqliteStore.getHoldingsHistory（strategy_id + closed_at IS NOT NULL + sinceMs 过滤 + DESC，只读新增）→ DataStore 门面透传 → strategy-holdings/history 端点（range 五档服务端换算自然日近似 + name 关联委托兜底 + 参数校验 bad-request）→ StrategyTab 开关/范围下拉/历史行渲染；
|
||||
3. **实现中发现并修复一个真实隐患**：R-010 展开状态与交易缓存原以 code 为键——同码「当前行 + 历史行」并存（清仓后重新买入）时两行会同时展开、缓存串行；本轮把展开状态/缓存/行键统一收敛为唯一 rowKey（当前行 = code，历史行 = 'h-' + holdingId），toggleExpand 签名同步变更（当前调用方仅 tbody 一处）；
|
||||
4. **验证**：test-r016-history.mjs 19/19（清仓转历史可查 / 5 档范围边界 / 排序 / 策略隔离 / 未清仓不出现 / 参数校验 / name 兜底 / 端点分发零破坏）；typecheck 通过；存量回归 test-position-sync 35/35、test-r013 21/21、test-quote-sync 27/27；build 通过（client bundle 164KB wrapped）；
|
||||
5. **文档链**：R-016 定稿 + PLAN-015 + 迭代三件套 + 技术约束-019 + 需求池索引（R-016 登记；顺带补登遗漏的 R-015 行）；
|
||||
6. **部署态排查（老师首验无数据，2026-09-07）**：实锤定位 = **运行中的 DSH 服务端进程仍是旧代码**——同进程 /odl/api/summary 正常应答、新端点返回 unknown method（curl 实测）；客户端 bundle 因插件 symlink 直连源码 lib/ 而被刷新（按钮已出现），服务端模块注册表却停留在进程启动时；处置 = ① loadHistory 失败从静默吞空改为 Toast 可见化（静默兜底=排障盲区，本轮教训）并重新构建（test-r016 19/19 复跑通过）；② 服务端生效依赖 DSH web 进程重启（插件 symlink 方式安装，无需重装，重启即取新 lib）。
|
||||
|
||||
## 经验教训（复盘沉淀）
|
||||
|
||||
### 1. 需求的「核心目标」要听老师的定调，不要替老师拔高
|
||||
- AI 在 Q2 提议改 closeHolding 语义以「保留清仓时份额」，出发点是账本完整性；老师一句话把需求核心定调为「追溯历史操作」——份额数字本身没有追溯价值，holding_id 锚点 + 关联委托才有；
|
||||
- 沉淀：讨论中 AI 的方案建议要标明「我认定的价值假设」，让老师有机会否定假设本身，而不只是选项。
|
||||
|
||||
### 2. 复用既有交互时，键的唯一性要先审后用
|
||||
- 展开状态按 code 键控在「一码一行」时代是隐含正确的；历史行引入打破了「一码一行」不变量——同类隐含假设（缓存 Map、React key、loading 标记）都要在数据形态变化时重新过一遍；
|
||||
- 沉淀：向既有列表引入第二类行时，先列出所有「按 X 键控」的状态，逐个判断是否需要升级为行唯一键。
|
||||
|
||||
### 3. 只读需求的实现应当「零写路径」可断言
|
||||
- 本轮全程未触碰任何 INSERT/UPDATE 语句与语义（closeHolding 分毫未动），回归脚本专门加了「strategy-positions 分发不变」断言——历史查询与当前查询的隔离在端点层就已成立（独立 method），不需要靠约定；
|
||||
- 沉淀：「只读功能」的范围声明落成验收断言（分发不变 + 写路径 diff 为空），比口头承诺可靠。
|
||||
|
||||
## 遗留/后续
|
||||
|
||||
1. **归属候选不纳入清仓持仓**（R-016 关联观察，2026-09-07 大连热电实际遇到）：清仓后当日委托无法再通过下拉关联到对应 holding——是否立独立需求（候选纳入近期清仓持仓）待老师定；
|
||||
2. **历史行成本价/收益推导**：本期不做（边界定稿）；若后续要做，数据源 = 关联委托成交记录，属展示层推导，不动存储；
|
||||
3. **清仓方式标记**（手动 vs 幽灵自动）：数据未区分，本期不做；若要做需 closeHolding 增加来源标记（涉及写路径，另立需求）；
|
||||
4. **R-015 / 迭代 13 人工验收**仍待老师确认（与本迭代无依赖）。
|
||||
@@ -0,0 +1,29 @@
|
||||
# 迭代目标：14-策略tab历史持仓展示
|
||||
|
||||
> 迭代编号：14 ｜ 创建：2026-09-07 ｜ 状态：已实施，待验收
|
||||
> 依据计划：PLAN-015 ｜ 需求：R-016（已定稿，2026-09-07，Q1-Q7 老师拍板）
|
||||
|
||||
## 目标描述
|
||||
|
||||
两个策略 tab（做T / 网格超市）title 旁添加「历史持仓」功能：① 显示/隐藏已清仓历史持仓的开关；② 显示历史时默认展示近一周清仓的持仓，并提供 近 1 个月 / 近 3 个月 / 近半年 / 近 1 年 范围选项。历史持仓行复用 R-010 行展开查看关联交易记录——补上「清仓即失联」的操作追溯缺口（核心目标：追溯该持仓相关的历史操作，老师 2026-09-07 定调）。
|
||||
|
||||
## 目标分解
|
||||
|
||||
1. **存储查询**（SqliteStore.getHoldingsHistory）：closed_at 非空 + closed_at ≥ sinceMs + strategy_id 过滤，按 closed_at DESC；只读新增，不动任何写路径（closeHolding 置 shares=0 语义维持，Q2 老师拍板「显示 0 就好」）；
|
||||
2. **门面透传**（DataStore.getHoldingsHistory）；
|
||||
3. **API 端点**（strategy-holdings/history）：strategyId 必填 + range ∈ week|month|quarter|halfYear|year（服务端换算 sinceMs；week 为前端默认但服务端不设隐式默认，参数缺失报错）；
|
||||
4. **前端**（StrategyTab）：头部按钮区加「历史持仓」开关 + 范围下拉（开启时显示，默认 week）；懒加载 + 范围切换重拉 + 关闭隐藏（缓存保留）；历史行追加在当前持仓行后（清仓时间降序）、灰显 + 「已清仓」徽标、标题计数不含历史行；历史行字段 = 代码/名称（关联委托 name 兜底）/份额(0)/清仓时间/持有天数，行情列 —，自定义字段列只读；行展开复用 R-010；
|
||||
5. **回归**：scripts/test-r016-history.mjs（ODL_TEST_DATA_DIR 临时目录）+ typecheck + build + 存量回归三脚本。
|
||||
|
||||
## 二轮补充（2026-09-07 验收前追加：今日已清仓默认层，Q8-Q9 老师拍板）
|
||||
|
||||
- **补充诉求**：当天（本地自然日 00:00 起）已清仓的持仓**默认显示**；「历史持仓」开关只控制**今天之前**的历史——历史持仓关 ≠ 当天已清仓也被藏起（首轮「进 tab 默认只看当前」使当天清仓行当场不可见，补上该缺口）；
|
||||
- **实现增量**：① 服务端 range='today' 特判本地自然日零点（不落回溯毫秒档）；② 前端 rowsToRender 分两层——L1 今日已清仓恒显示（缓存键 'today'，随每次持仓重载刷新）+ L2 历史范围层受开关控制，层间按 holdingId 去重；③ 视觉/计数维持首轮（灰显+徽标、计数不含已清仓行）；
|
||||
- 影响面：只动只读查询 + 前端渲染合成；**零写路径变更**（closeHolding 语义仍不动）；
|
||||
- 回归：test-r016 追加 range=today 自然日边界用例（24/24）。
|
||||
|
||||
## 对老师/主理人的配合需求
|
||||
|
||||
- 实现完成后需老师真实环境人工验收（开关/范围切换/历史行展示/展开复盘/与真实清仓数据对照）；
|
||||
- 二轮补充后重点验收：**「历史持仓」关时当天清仓的持仓仍显示**、「历史持仓」开时今天之前的行按范围显示、层间无重复行；
|
||||
- 验收通过后本迭代标记「验收通过」，R-016 进入归档流程。
|
||||
@@ -0,0 +1,38 @@
|
||||
# 验收标准：14-策略tab历史持仓展示
|
||||
|
||||
> 迭代编号：14 ｜ 依据：PLAN-015 验收要点 + R-016
|
||||
|
||||
## 验收标准线
|
||||
|
||||
1. **自动化**：typecheck + build 通过；test-r016-history.mjs 全绿（清仓转历史可查 / 5 档范围过滤与边界 / closed_at DESC 排序 / 策略隔离 / 未清仓行不出现 / 参数校验 / name 兜底）；存量回归 test-position-sync、test-r013、test-quote-sync 全绿；
|
||||
2. **入口与默认态**：做T / 网格超市两个 tab title 旁出现「历史持仓」开关；默认关闭 = 与现状完全一致（进 tab 无历史行）；开启后默认范围 = 近一周；**全部持仓 tab 无此功能**；
|
||||
3. **范围筛选**：5 档（近一周/近1个月/近3个月/近半年/近1年）切换即重拉；用 2026-09-07 大连热电真实数据验证——holding_id=15（做T，当日 09:32:35 幽灵清仓）在近一周内可见、切近 1 个月仍可见；
|
||||
4. **历史行展示**：灰显 + 「已清仓 YYYY-MM-DD」徽标；清仓时间/持有天数正确；份额显示 0（Q2）；行情列（现价/涨幅/涨停跌停/今开/最高/成本/最后成交价）显示 —；名称有则显示、无则 —；标题计数（N 只）不含历史行；当前持仓在前、历史行按清仓时间降序在后；
|
||||
5. **展开复盘**：历史行展开可见该 holding 关联委托（大连热电 09:31:26 卖出 1000 股 @7.42 应出现）；自定义字段历史行只读（无编辑入口）；
|
||||
6. **零破坏**：strategy-positions / unallocated / summary 等现有端点行为不变；当前持仓行展示与现状一致；无任何写路径变更（closeHolding 语义不变）。
|
||||
|
||||
## 验收方法
|
||||
|
||||
- 自动化项 AI 执行出具结果；
|
||||
- 2~5 老师真实环境人工验收：重载插件 → 两个策略 tab 开关历史持仓 → 切换范围 → 对照大连热电当日清仓数据 → 展开历史行核对关联委托；
|
||||
- 全部通过后：迭代 14 标记「验收通过」，R-016 归档 已完成/。
|
||||
|
||||
## 验收目标
|
||||
|
||||
- 6 条验收线通过，迭代 14 标记「验收通过」，R-016 更新实现状态（已实现）并归档。
|
||||
|
||||
## 二轮补充验收线（2026-09-07 Q8-Q9 追加：今日已清仓默认层）
|
||||
|
||||
7. **今日已清仓默认显示（核心）**：「历史持仓」**关**时，策略 tab 仍显示 当前持仓 + 今天（本地自然日 00:00 起）已清仓的持仓行；当天卖出/幽灵清仓的持仓行不因开关关闭而消失；
|
||||
8. **开关只控更早历史**：「历史持仓」开时，追加显示今天之前各范围（近一周/近1个月/近3个月/近半年/近1年）已清仓行——近一周范围**不含**今天已显示的行（层间按 holdingId 去重，无重复行）；
|
||||
9. **边界与展示**：昨天 23:59:59 清仓的行在开关关时不可见（属更早历史）；今日行沿用灰显 + 已清仓徽标；标题计数（N 只）仍不含已清仓行；行情列 — / 份额 0 / 只读字段 / 行展开复用 R-010 均维持首轮；
|
||||
10. **自动化**：test-r016 新增 range=today 用例全绿（24/24）；typecheck + build + 存量回归（test-position-sync / test-r013 / test-quote-sync）全绿。
|
||||
|
||||
## 验收方法（二轮补充）
|
||||
|
||||
- 自动化项 AI 执行出具结果（已执行：test-r016 24/24、position-sync 35、r013 21、quote-sync 27、typecheck 0、r017 12）；
|
||||
- 老师真实环境人工验收：刷新页面 → 在不开启「历史持仓」的情况下核对当天已清仓持仓仍显示 → 开启开关核对今天之前的行按范围出现且与今日行无重复 → 对照大连热电当日清仓数据。
|
||||
|
||||
## 验收目标
|
||||
|
||||
- 首轮 6 条 + 二轮 4 条验收线通过后，迭代 14 标记「验收通过」，R-016 归档 已完成/。
|
||||
@@ -0,0 +1,29 @@
|
||||
# 技术实现方案：15-归属候选纳入清仓持仓
|
||||
|
||||
> 迭代编号：15 ｜ 依据：PLAN-016 + R-017
|
||||
|
||||
## 1. 存储层（getAttributionCandidates 扩展，门面透传不变）
|
||||
|
||||
```sql
|
||||
SELECT holding_id, strategy_id, shares, closed_at FROM strategy_holdings
|
||||
WHERE code=? AND (closed_at IS NULL OR closed_at >= ?) -- ? = Date.now() - 7d
|
||||
ORDER BY (closed_at IS NULL) DESC, shares DESC, closed_at DESC
|
||||
```
|
||||
|
||||
- 返回行新增 closed: boolean / closedAt: number|null（消费方：api strategies.js 同方法直接受益——注意 attribution-candidates 端点在 trades.js，调 DataStore.getTradeAttributionCandidates 透传，零改动）；
|
||||
- 窗口常量 7 * 86400000（与 R-016 默认范围一致）。
|
||||
|
||||
## 2. UI（TradeRecordsTab.jsx AttributionSelect 重构）
|
||||
|
||||
- 锚点键：currentKey = order.holdingId != null ? String(order.holdingId) : ''（holdingId 是 R-009 定稿的归属锚点；strategyId 在同策略多轮持仓时会撞值）；
|
||||
- handleSelect：按 String(holdingId) 找候选 → setAttribution(orderId, code, cand.strategyId, cand.holdingId)；__unassigned__ → 双 null；
|
||||
- 占位选项：已归属但候选缺失（清仓超 7 天）→ 「当前归属（{strategyId}）」，value=currentKey，防 select 悬空显示第一项误导；
|
||||
- 清仓候选文本后缀「（已清仓 MM-DD）」（fmtClosed 本地 helper）；select maxWidth 120→150。
|
||||
|
||||
## 3. 数据修复记录（一次性，非功能）
|
||||
|
||||
2026-09-07 大连热电卖出委托 645001623 经 live set-attribution 通道回填 strategy_id=manual-t / holding_id=15（curl 实测 ok:true，orders/by-holding 回读确认）。当日归属曾被清为未关联的原因：候选下拉无做T项时老师误触「未关联」入口——本迭代修复后此路径消除。
|
||||
|
||||
## 4. 验证链
|
||||
|
||||
test-r017-candidates.mjs 12 断言 + typecheck + build + 存量回归（r016 19 / position-sync 35 / r013 21 / quote-sync 27）。
|
||||
@@ -0,0 +1,34 @@
|
||||
# 迭代复盘：15-归属候选纳入清仓持仓
|
||||
|
||||
> 复盘日期：2026-09-07 ｜ 迭代状态：**已实施，待老师人工验收**
|
||||
> 关联需求：R-017 ｜ 关联计划：PLAN-016
|
||||
|
||||
## 结果
|
||||
|
||||
迭代 15 达成：归属候选 = 当前持仓 + 近 7 天清仓持仓（closed 标记 + 「已清仓 MM-DD」后缀），下拉锚点改 holdingId 键控（同策略多轮持仓不撞值）+ 「当前归属」占位防悬空；清仓后当日委托可补关联。另：当日大连热电卖出委托（645001623）的归属已经 set-attribution 通道修复回 manual-t/holding 15（一次性数据修复，非功能）。
|
||||
|
||||
## 过程事实
|
||||
|
||||
1. **数据取证先行**：老师报告「无法关联」时，DB 真相 = 委托归属已被清为 null/null（非从未设置）+ 候选接口只剩网格超市——「归属丢失」与「候选缺失」两个问题一次取证分清；
|
||||
2. **当日修复走既有通道**：set-attribution 本就无候选限制（Q4 可随时改语义），curl 修复 + 回读验证，不新造工具；
|
||||
3. **实现**：SqliteStore.getAttributionCandidates WHERE/ORDER 扩展 + closed/closedAt 字段（门面/api 零改动透传）；AttributionSelect 从 strategyId 键控重构为 holdingId 键控 + 占位 + 后缀；
|
||||
4. **验证**：test-r017 12/12；typecheck 通过；存量回归 r016 19/19、position-sync 35/35、r013 21/21、quote-sync 27/27；build 通过。
|
||||
|
||||
## 经验教训（复盘沉淀）
|
||||
|
||||
### 1. 「关联」的锚点键要在多轮持仓出现时重新审视
|
||||
- R-009 时代下拉 value 用 strategyId（一码一策略一行时无碍）；R-016 历史行引入后同码可同时存在「当前行 + 历史行」、同策略可有多轮清仓——strategyId 键撞值成为真实 bug 面，holdingId 才是归属锚点（R-009 表结构早已如此，UI 层滞后）；
|
||||
- 沉淀：外键语义（表里存什么）和 UI 键（下拉传什么）要对齐审查，表结构升级时 UI 不自动跟上。
|
||||
|
||||
### 2. 「数据问题」与「能力缺失」要分层处置
|
||||
- 老师当下要的是「这笔委托关联回去」（数据问题）——走既有 API 通道立即修复，不等迭代；「以后不再发生」（能力缺失）——立项 R-017 走流程。两层都做但互不阻塞。
|
||||
|
||||
### 3. 候选缺失时的 UI 应该显示「当前归属」而不是悬空
|
||||
- select value 不在任何 option 里时浏览器表现不可控（显示空白或第一项），第一项恰是「未关联」时极易诱导误操作（本次归属被清的可能路径）；
|
||||
- 沉淀：受控 select 的 value 必须保证总有对应 option——数据缺口用占位 option 补，不让浏览器自作主张。
|
||||
|
||||
## 遗留/后续
|
||||
|
||||
1. **候选窗口（7 天）与 R-016 范围档是两套口径**：当前均满足场景；若老师后续要统一（候选也用 5 档范围），另议小改；
|
||||
2. **自动归属推导**（_resolveStrategyAttribution 时间窗）仍在（技术约束-013），但 Q3 全手动原则下仅为内部能力，未暴露 UI；维持现状；
|
||||
3. R-015 / 迭代 13、R-016 / 迭代 14 的人工验收仍待老师确认。
|
||||
@@ -0,0 +1,19 @@
|
||||
# 迭代目标：15-归属候选纳入清仓持仓
|
||||
|
||||
> 迭代编号：15 ｜ 创建：2026-09-07 ｜ 状态：已实施，待验收
|
||||
> 依据计划：PLAN-016 ｜ 需求：R-017（已定稿，2026-09-07）
|
||||
|
||||
## 目标描述
|
||||
|
||||
交易记录 tab 的归属候选（orders/attribution-candidates）纳入近 7 天清仓的持仓（closed 标记），下拉锚点改 holdingId 键控——修复「清仓后当日委托无法补关联」（2026-09-07 大连热电做T实际发生：盘中归属被清后下拉已无手动做T候选）。
|
||||
|
||||
## 目标分解
|
||||
|
||||
1. **存储**（SqliteStore.getAttributionCandidates）：WHERE 扩展为 closed_at IS NULL OR closed_at ≥ 7 天前；返回行附 closed/closedAt；排序 当前持仓(shares DESC) 在前 → 清仓行 closed_at DESC；
|
||||
2. **UI**（AttributionSelect）：value 改 String(holdingId)；点选按 holdingId 找候选取 strategyId+holdingId 写入；清仓选项加「（已清仓 MM-DD）」后缀；已归属但候选缺失时显示「当前归属」占位（防 select 值悬空）；title 提示更新；
|
||||
3. **回归**：scripts/test-r017-candidates.mjs（12 断言：候选构成/标记/窗口边界/排序/隔离/端点透传）。
|
||||
|
||||
## 对老师/主理人的配合需求
|
||||
|
||||
- 重启 DSH web 进程（服务端代码更新）+ 刷新页面后人工验收；
|
||||
- 验收通过后迭代 15 标记「验收通过」，R-017 归档。
|
||||
@@ -0,0 +1,20 @@
|
||||
# 验收标准：15-归属候选纳入清仓持仓
|
||||
|
||||
> 迭代编号：15 ｜ 依据：PLAN-016 验收要点 + R-017
|
||||
|
||||
## 验收标准线
|
||||
|
||||
1. **自动化**：typecheck + build 通过；test-r017-candidates.mjs 12/12；存量回归 r016 / position-sync / r013 / quote-sync 全绿；
|
||||
2. **候选构成**（真实环境）：交易记录 tab 大连热电今日卖出委托的归属下拉 = 网格超市（当前持仓）+ 手动做T（已清仓 09-07）两项；
|
||||
3. **补关联**：点选「手动做T（已清仓 09-07）」→ 保存成功提示 → 行内归属显示手动做T且下拉保持选中；做T策略 tab 历史持仓行展开可见该笔卖出（holding 15 关联）；
|
||||
4. **可逆**：切回「未关联」→ 双 null 持久化；再切回做T → 恢复；
|
||||
5. **占位**：归属存在但候选缺失的场景显示「当前归属（…）」占位（可用超 7 天清仓行验证，或观察现有数据）。
|
||||
|
||||
## 验收方法
|
||||
|
||||
- 自动化项 AI 执行出具结果；2~5 老师重启 DSH web + 刷新页面人工验收；
|
||||
- 全部通过后迭代 15 标记「验收通过」，R-017 归档 已完成/。
|
||||
|
||||
## 验收目标
|
||||
|
||||
- 5 条验收线通过，迭代 15 标记「验收通过」，R-017 更新实现状态并归档。
|
||||
@@ -0,0 +1,63 @@
|
||||
# 需求：R-016 策略 tab 历史持仓展示（显示/隐藏已清仓持仓 + 清仓时间范围筛选）
|
||||
|
||||
> 登记：2026-09-07 ｜ 来源：老师指令（优化功能需求讨论）｜ 状态：**已定稿（2026-09-07，Q1-Q7 老师拍板）**
|
||||
> 归属：迭代 14 ｜ 计划：PLAN-015 ｜ 实现状态：**已实现（2026-09-07，待老师人工验收）**
|
||||
|
||||
## 需求描述（老师原始诉求）
|
||||
|
||||
**两个策略 tab**（做T / 网格超市）**title 旁边**添加以下功能：
|
||||
|
||||
1. **显示/隐藏已清仓的历史持仓**（开关）；
|
||||
2. 显示历史持仓时，**默认显示近一周清仓的持仓**，同时提供 **近 1 个月 / 近 3 个月 / 近半年 / 近 1 年** 几个范围选项。
|
||||
|
||||
## 背景
|
||||
|
||||
- 策略持仓行 = QMT 快照驱动（R-014），卖出清仓后 QMT 无该持仓 → 幽灵清仓把 strategy_holdings 行转历史（closed_at 非空）→ 策略 tab 当场少一行；
|
||||
- 典型场景（2026-09-07 实际发生）：早盘卖出大连热电 1000 股（做T），约 70 秒后该持仓行从做T tab 消失——当日交易记录还在（R-009 已入库、归属 holding_id=15 正确），但 tab 上锚点不可见；
|
||||
- 历史数据一直在库（strategy_holdings 全量保留），只是**没有展示入口**；
|
||||
- R-010 持仓行展开（关联委托汇总）以 holding_id 为锚，历史持仓行天然可复用——历史行展开 = 该轮做T/清仓的完整交易复盘（**本需求的核心目标：追溯该持仓相关的历史操作**，老师 2026-09-07 定调）。
|
||||
|
||||
## 讨论记录（2026-09-07，Q1-Q7 老师拍板）
|
||||
|
||||
| # | 问题 | 结论（老师拍板） |
|
||||
|---|---|---|
|
||||
| Q1 | 历史行展示哪些字段？ | **按建议**：代码 / 名称（取该 holding 最近关联委托的 name 兜底，无则 —）/ 清仓时间 / 持有天数；实时行情列（现价/涨幅/涨停等）历史行显示 **—**（不参与行情订阅）；行展开沿用 R-010 看关联委托；成本价从委托推导本期不做 |
|
||||
| Q2 | 清仓时份额怎么显示？（closeHolding 现把 shares 置 0） | **显示 0 就好了**（老师改判，否决 AI 的「保留 shares」方案）：即使显示清仓时的份额也没多少意义，主要目标是追溯该持仓相关的历史操作；**不改 closeHolding 语义**，历史行份额直接显示 DB 原值（0） |
|
||||
| Q3 | 排序与视觉区分？ | **按建议**：当前持仓在前（维持现状排序），历史行追加在后按清仓时间降序；历史行灰显 + 「已清仓」徽标（含清仓日期）；标题计数（N 只）只数当前持仓 |
|
||||
| Q4 | 开关与范围选择要不要记住偏好？ | **按建议**：会话级即可（默认关，进 tab 重置为「只看当前」）——查看历史是临时行为，「策略 tab = 当前持仓」是主语义 |
|
||||
| Q5 | 范围选项集合？ | **按建议**：近一周（默认）/ 近 1 个月 / 近 3 个月 / 近半年 / 近 1 年，共 5 档；语义 = closed_at ∈ [now − 范围, now]；不加「全部历史」 |
|
||||
| Q6 | 自定义字段值（R-013 values）在历史行怎么处理？ | **按建议**：values 数据随行保留，历史行**只读展示**（无编辑入口；服务端本就拒绝已清仓行写入） |
|
||||
| Q7 | 接口形态？ | **按建议**：新增独立只读端点（strategy-holdings/history，args: strategyId + range），当前持仓路径（strategy-positions / R-014 快照语义）零改动；前端两份结果合并渲染 |
|
||||
|
||||
## 边界（定稿）
|
||||
|
||||
**做**：两个策略 tab 的历史持仓开关 + 范围筛选（title 旁按钮区）；历史行展示（Q1 字段集 + Q2 份额显示 0）+ 行展开复用 R-010；配套后端历史查询端点（SqliteStore 范围查询 + DataStore 门面 + API）。
|
||||
|
||||
**不做**：全部持仓 tab 不加此功能（老师点名两个策略 tab）；历史行盈亏统计（R-002 Q4 不做统计原则）；清仓方式标记（手动清仓 vs 幽灵自动清仓，数据未区分）；历史行实时行情；成本价/收益推导；**不改 closeHolding 存储语义**（shares 置 0 维持，Q2）；范围记忆/偏好持久化（Q4 会话级）；「全部历史」档位。
|
||||
|
||||
## 关联观察（上一轮会话遗留，不在本需求范围）
|
||||
|
||||
- 交易记录 tab 的归属候选（orders/attribution-candidates）只回**当前持仓**——清仓后当日委托无法再通过下拉关联到对应 holding（2026-09-07 大连热电实际遇到）；是否立独立需求（如候选纳入近期清仓持仓）待老师定。
|
||||
|
||||
## 二轮补充（2026-09-07，Q8-Q9 老师拍板：今日已清仓默认层）
|
||||
|
||||
> 追加定稿记录（不改写 Q1-Q7 首轮定稿；本轮在首轮验收前补充，老师 2026-09-07 人工验收前的诉求收窄「历史持仓关 = 当天已清仓也看不见」的体验缺口）。
|
||||
|
||||
**老师原始补充诉求**：两个策略 tab 显示历史持仓的交互需要小的逻辑调整——**当前已清仓的持仓默认也显示**；「历史持仓」开关**不控制当天已清仓的持仓**（历史持仓关 ≠ 当天已清仓也被藏起）。
|
||||
|
||||
| # | 问题 | 结论（老师拍板 2026-09-07） |
|
||||
|---|---|---|
|
||||
| Q8 | 「当天」的边界口径？ | **本地自然日 00:00 起**（今天清仓的始终显示；跨零点后自动归入更早历史，由「历史持仓」开关控制） |
|
||||
| Q9 | 今日已清仓行的视觉与计数？ | **沿用历史行灰显 + 「已清仓」徽标**；标题计数（N 只）仍只算当前持仓，不含已清仓行 |
|
||||
|
||||
**定稿语义（相对首轮 Q4「默认关 = 只看当前」的修订）**：
|
||||
- 已清仓行分两层：**L1 今日已清仓**（range='today'，closed_at ≥ 本地自然日 00:00）**默认恒显示**，进 tab 即出现、随持仓重载刷新；**L2 历史范围层**（week/month/quarter/halfYear/year，仅今天之前）仍由「历史持仓」开关控制（默认关）；
|
||||
- 交互文案同步收窄：「历史持仓」开关 = 显示/隐藏**今天之前**已清仓的历史持仓（title/提示更新）；当天清仓的持仓始终显示；
|
||||
- 展示（灰显/徽标/行情列 —/份额 0/只读字段/行展开）与计数（不含已清仓行）维持 Q1/Q2/Q3/Q6 不变，两层视觉无差异；
|
||||
- 实现：range='today' 特判本地自然日零点（不走回溯毫秒档）；前端 rowsToRender 在开关关时也追加 L1（按 holdingId 去重 L1∩L2，开启历史范围不重复出两行）；零写路径变更维持。
|
||||
|
||||
**边界修订**：Q5 档位集语义微调为「**今天之前的**回溯范围」；「开关默认关 = 只看当前」修订为「开关默认关 = 当前持仓 + 今日已清仓」；其余边界（不做全部持仓 tab / 不做统计 / 不改 closeHolding / 会话级不持久化等）不变。
|
||||
|
||||
## 验收
|
||||
|
||||
见 `docs/04-迭代记录/14-策略tab历史持仓展示/验收标准.md`。
|
||||
@@ -0,0 +1,30 @@
|
||||
# 需求：R-017 委托归属候选纳入近期清仓持仓
|
||||
|
||||
> 登记：2026-09-07 ｜ 来源：老师指令（2026-09-07「处理一下，今天大连热电的交易记录，我没办法关联到手动做T持仓的大连热电上」）｜ 状态：**已定稿**
|
||||
> 归属：迭代 15 ｜ 计划：PLAN-016 ｜ 实现状态：**已实现（2026-09-07，待老师人工验收）**
|
||||
> 前置：R-016「关联观察」所列问题的正式立项（清仓后当日委托无法通过下拉关联到对应 holding，2026-09-07 大连热电实际发生——盘中手动归属后又被清为未关联，下拉已无手动做T候选）。
|
||||
|
||||
## 需求描述
|
||||
|
||||
交易记录 tab 的归属候选（orders/attribution-candidates）只回**当前持仓**——清仓后（幽灵清仓最快约 30s 转历史）当日委托在下拉中失去对应策略/持仓锚点，无法补关联。本轮：**候选 = 该 code 的当前持仓 + 近 7 天清仓的持仓**，清仓行带标记供 UI 区分展示。
|
||||
|
||||
## 讨论记录（2026-09-07）
|
||||
|
||||
| # | 决策点 | 结论 |
|
||||
|---|---|---|
|
||||
| 1 | 立项与方向 | 老师指令确认（对 R-016 关联观察修复方案的采纳） |
|
||||
| 2 | 候选窗口 | 近 7 天清仓（与 R-016 默认范围一致，AI 定；覆盖「当日做T当日盘后补关联」场景足够） |
|
||||
| 3 | 锚点键 | 下拉 value 改用 **holdingId**（同策略可有多轮持仓行，strategyId 会撞值；holding_id 本就是归属锚点，R-009 定稿语义） |
|
||||
| 4 | 标记展示 | 清仓候选在选项文本加「（已清仓 MM-DD）」后缀；已归属但候选列表缺失的委托显示「当前归属」占位选项（避免 select 空白） |
|
||||
| 5 | 排序 | 当前持仓在前，清仓行按 closed_at DESC 追加 |
|
||||
| 6 | 归属写入 | 不变：orders/set-attribution 无候选限制（本次数据修复即经此通道完成） |
|
||||
|
||||
## 边界
|
||||
|
||||
**做**：getAttributionCandidates 纳入近 7 天清仓行（附 closed/closedAt）；AttributionSelect 改 holdingId 键控 + 已清仓后缀 + 当前归属占位；回归脚本。
|
||||
|
||||
**不做**：候选窗口可配置；自动归属（Q3 手动原则不变）；交易记录 tab 之外的候选消费方调整；历史数据修复工具（本次一次性修复经 set-attribution 完成，不固化成功能）。
|
||||
|
||||
## 验收
|
||||
|
||||
见 `docs/04-迭代记录/15-归属候选纳入清仓持仓/验收标准.md`。
|
||||
@@ -26,6 +26,9 @@
|
||||
| R-012 | UI 适配 DSH 主题（浅色 / 深色 / 跟随系统） | 神之一手 UI 适配 DSH 浅色/深色/跟随系统主题：141 处硬编码色值替换为宿主 `--dsw-*` token，随主题自动切换；不自行维护主题偏好（**暂定跟随系统**）；涨跌红涨绿跌 → 宿主 state-error/success；仅色值 token 化不动布局。**2026-09-02 定稿（暂定跟随系统）并完成（迭代 10），已归档至 已完成/R-012.md** | 老师指令（2026-09-02） | P1 | 已定稿 | 2026-09-02 | 10-UI主题适配 | **已实现（已归档）** |
|
||||
| R-013 | 策略自定义字段配置（定义随策略，值落库） | 策略可自定义、可扩展：每个策略在设置页「策略分组」子 tab 配置自定义字段（字段名/类型文本·数字·布尔·枚举/枚举项/单位 unit/默认值，configSchema 随策略定义存 settings）；每个持仓行按所属策略的定义存一份键值对值（strategy_holdings 新增 values TEXT(JSON) 列）；自定义字段作为持仓表列展示，列显隐/排序每策略独立配置（strategyColumns），单元格点击内联编辑。**2026-09-02 定稿（Q1-Q4 + D6）并完成（迭代 11 验收通过），已归档至 已完成/R-013.md** | 老师指令（2026-09-02） | P1 | 已定稿 | 2026-09-02 | 11-策略自定义字段配置 | **已实现（已归档）** |
|
||||
| R-014 | 持仓内存快照（服务端 10s 定时同步，请求不再穿透 QMT） | 服务端建全量持仓**内存快照**（不落库）：PositionSync 启动预热 + 每 10s 全量拉 QMT → 校验 → 整体替换；同步失败保留上次快照（QMT 抖动不再白屏）；空快照双重确认（/health + getAsset 账户身份）才接受为真清仓；快照为空读穿透兜底（当场拉一次并回填）；**幽灵持仓自动清仓**：QMT 连续 3 轮（约 30s）消失的 code，本地全部策略当前持仓自动转历史（账户身份守卫：accountId 未知跳过、切换重置跳过；部分减持不触发）；strategy-positions / unallocated / summary 三个接口改读快照，前端零改动。**2026-09-02 定稿（内存不落库 / 读穿透兜底 / 幽灵自动清仓 / 同步时间不显示，老师逐项拍板），2026-09-02 完成（回归 34/34 + r013 回归 21/21 + typecheck + build 通过），迭代 12 验收待老师人工确认** | 架构梳理讨论引出 + 老师指令（2026-09-02） | P1 | 已定稿 | 2026-09-02 | 12-持仓内存快照 | 已实现（待验收） |
|
||||
| R-015 | 盘口数据内存化（QuoteSync/QuoteHub 统一管理）+ 数据同步指示灯 | QuoteSync（取数：prime + 5s REST 刷新 + 涨停跌停按交易日缓存）/ QuoteHub（存查：内存快照 + watch 集合 + 读穿透 + 价格单一入口）替换 MarketFeed/MarketDataHub（方案 A 替换不包壳）；WS 通路移除；market_quotes_cache 表退役 DROP；涨停价/跌停价字段（/data/instrument 按交易日缓存不落库）；会话头部新增持仓/盘口同步指示灯（绿/黄/灰 + 悬停详情 + 点击即 syncNow）+ sync-status 端点（吸收临时诊断 market-stats）；策略持仓表行情列扩展（涨停/跌停/今开/最高 4 列，默认隐藏）。**2026-09-02 定稿（五项老师逐项拍板），2026-09-02 完成（test-quote-sync 全绿 + 存量回归 34/34、21/21 + typecheck + build），迭代 13 验收待老师人工确认** | 架构演进讨论引出 + 老师指令（2026-09-02） | P1 | 已定稿 | 2026-09-02 | 13-盘口内存快照 | 已实现（待验收） |
|
||||
| R-016 | 策略 tab 历史持仓展示（显示/隐藏已清仓持仓 + 清仓时间范围筛选） | 两个策略 tab（做T/网格超市）title 旁添加：① 显示/隐藏已清仓历史持仓的开关；② 显示历史时默认展示近一周清仓的持仓，并提供 近1个月/近3个月/近半年/近1年 范围选项。背景：卖出清仓后幽灵清仓（R-014）把持仓行转历史，策略 tab 当场少行（2026-09-07 大连热电做T卖出实际发生）；历史数据一直在库（strategy_holdings closed_at 非空），只缺展示入口；历史行可复用 R-010 行展开做交易复盘。**2026-09-07 定稿（Q1-Q7 老师拍板：Q2 改判「份额显示 0 就好，不改 closeHolding 语义」，其余按 AI 建议；核心目标=追溯该持仓相关的历史操作）**；历史行复用 R-010 展开做交易复盘；新增 strategy-holdings/history 端点，当前持仓路径零改动。**2026-09-07 二轮补充（Q8-Q9 老师拍板）：当天（本地自然日 00:00 起）已清仓的持仓默认显示（range='today' 恒显示层），「历史持仓」开关只控制今天之前的历史（历史持仓关≠当天清仓被藏起）；层间按 holdingId 去重，计数不含已清仓行维持；零写路径变更维持**。详见 R-016.md | 老师指令（2026-09-07 优化功能需求讨论） | P1 | 已定稿 | 2026-09-07 | 14-策略tab历史持仓展示 | 已实现（待验收） |
|
||||
| R-017 | 委托归属候选纳入近期清仓持仓 | 交易记录 tab 归属候选只回当前持仓——清仓后当日委托失去下拉锚点无法补关联（R-016 关联观察立项，2026-09-07 大连热电实际发生：盘中归属后被清为未关联，下拉已无做T候选）。**2026-09-07 定稿（老师指令确认方向）**：候选 = 当前持仓 + 近 7 天清仓持仓（closed 标记，选项文本「已清仓」后缀），下拉 value 改 holdingId 键控（同策略多轮不撞值），排序当前在前/清仓按 closed_at DESC；当日数据修复经 set-attribution 通道完成（非固化功能）。详见 R-017.md | 老师指令（2026-09-07） | P1 | 已定稿 | 2026-09-07 | 15-归属候选纳入清仓持仓 | 已实现（待验收） |
|
||||
|
||||
## 渐进明细规划素材
|
||||
|
||||
|
||||
@@ -0,0 +1,114 @@
|
||||
/**
|
||||
* R-016 / 迭代 14 回归：策略已清仓历史持仓查询 + API 端点
|
||||
* 独立临时数据目录（技术约束-011：不碰真实数据）。
|
||||
* 覆盖：清仓转历史可查 / 范围过滤边界（5 档 + range=today 自然日边界）/ closed_at DESC 排序 / 策略隔离 /
|
||||
* 未清仓行不出现 / API 参数校验 / name 兜底 / 只读端点默认范围。
|
||||
*/
|
||||
import { SqliteStore } from '../src/storage/SqliteStore.js';
|
||||
import { DataStore } from '../src/storage/DataStore.js';
|
||||
import { handleStrategy } from '../src/api/strategies.js';
|
||||
import { mkdtempSync, rmSync } from 'node:fs';
|
||||
import { tmpdir } from 'node:os';
|
||||
import { join } from 'node:path';
|
||||
|
||||
let pass = 0, fail = 0;
|
||||
function assert(cond, msg) {
|
||||
if (cond) { pass++; console.log(' ✅ ' + msg); }
|
||||
else { fail++; console.log(' ❌ ' + msg); }
|
||||
}
|
||||
|
||||
const DAY = 86400000;
|
||||
const tmp = mkdtempSync(join(tmpdir(), 'odl-r016-'));
|
||||
const storage = new DataStore({ dataDir: tmp });
|
||||
const runtime = { storage }; // handleStrategy 的 strategy-holdings/history 仅消费 storage
|
||||
|
||||
try {
|
||||
console.log('\n[1] 建仓 → 清仓 → 历史可查');
|
||||
await storage.openHolding('s1', '600719.SH', 1000);
|
||||
const h1 = await storage.getCurrentHoldings('s1');
|
||||
assert(h1.length === 1 && h1[0].shares === 1000, '建仓后当前持仓 1000');
|
||||
await storage.closeHolding('s1', '600719.SH');
|
||||
const cur = await storage.getCurrentHoldings('s1');
|
||||
assert(cur.length === 0, '清仓后当前持仓为空');
|
||||
const hist1 = await storage.getHoldingsHistory('s1', {});
|
||||
assert(hist1.length === 1, '历史查询可查到 1 行');
|
||||
assert(hist1[0].shares === 0 && hist1[0].closedAt > 0, 'shares=0（Q2：closeHolding 语义不变）且 closed_at 有值');
|
||||
assert(hist1[0].holdingId === h1[0].holdingId, 'holding_id 锚点保留');
|
||||
|
||||
console.log('\n[2] 多行 + 排序（closed_at DESC）+ 策略隔离 + 未清仓不出现');
|
||||
await storage.openHolding('s1', '000001.SZ', 500);
|
||||
await storage.closeHolding('s1', '000001.SZ');
|
||||
await storage.openHolding('s1', '600000.SH', 300); // 未清仓
|
||||
await storage.openHolding('s2', '600719.SH', 100);
|
||||
await storage.closeHolding('s2', '600719.SH');
|
||||
const all = await storage.getHoldingsHistory('s1', {});
|
||||
assert(all.length === 2, 's1 历史 2 行（不含未清仓 600000.SH、不含 s2）');
|
||||
assert(all[0].closedAt >= all[1].closedAt, '按 closed_at DESC 排序');
|
||||
const s2 = await storage.getHoldingsHistory('s2', {});
|
||||
assert(s2.length === 1 && s2[0].code === '600719.SH', '策略隔离：s2 只见自己');
|
||||
|
||||
console.log('\n[3] 范围过滤（sinceMs 边界）');
|
||||
// 人为回溯：000001.SZ 清仓时间改到 40 天前（临时测试库，允许直改）
|
||||
const db = storage.sqlite.db;
|
||||
const row40d = all.find((r) => r.code === '000001.SZ');
|
||||
db.prepare('UPDATE strategy_holdings SET closed_at=? WHERE holding_id=?').run(Date.now() - 40 * DAY, row40d.holdingId);
|
||||
const week = await storage.getHoldingsHistory('s1', { sinceMs: Date.now() - 7 * DAY });
|
||||
assert(week.length === 1 && week[0].code === '600719.SH', '近一周：只有 600719.SH');
|
||||
const month = await storage.getHoldingsHistory('s1', { sinceMs: Date.now() - 30 * DAY });
|
||||
assert(month.length === 1, '近 1 个月：仍只有 600719.SH（40 天前行被滤掉）');
|
||||
const quarter = await storage.getHoldingsHistory('s1', { sinceMs: Date.now() - 90 * DAY });
|
||||
assert(quarter.length === 2 && quarter[0].code === '600719.SH', '近 3 个月：2 行，40 天前行回归且 DESC 在前');
|
||||
const year = await storage.getHoldingsHistory('s1', { sinceMs: Date.now() - 365 * DAY });
|
||||
assert(year.length === 2, '近 1 年：2 行');
|
||||
|
||||
console.log('\n[4] API 端点（含 name 兜底 + 参数校验）');
|
||||
// 关联委托（含 name）
|
||||
db.prepare(
|
||||
"INSERT INTO trade_orders (order_id, trade_date, code, name, direction, insert_ts, fetched_at) VALUES (?,?,?,?,?,?,?)"
|
||||
).run('T-001', '20260907', '600719.SH', '大连热电', 'sell', Date.now(), Date.now());
|
||||
// 归属到 s1 的历史行
|
||||
db.prepare('UPDATE trade_orders SET holding_id=? WHERE order_id=?').run(week[0].holdingId, 'T-001');
|
||||
const apiWeek = await handleStrategy('strategy-holdings/history', { strategyId: 's1', range: 'week' }, runtime);
|
||||
assert(apiWeek.length === 1 && apiWeek[0].code === '600719.SH', '端点近一周返回 1 行');
|
||||
assert(apiWeek[0].name === '大连热电', 'name 兜底取关联委托 name');
|
||||
assert(apiWeek[0].values === null, 'values 未配置为 null');
|
||||
const apiDefault = await handleStrategy('strategy-holdings/history', { strategyId: 's1' }, runtime);
|
||||
assert(apiDefault.length === 1, '缺省 range = week');
|
||||
let threw = null;
|
||||
try { await handleStrategy('strategy-holdings/history', { range: 'week' }, runtime); } catch (e) { threw = e; }
|
||||
assert(threw && threw.code === 'bad-request', '缺 strategyId → bad-request');
|
||||
threw = null;
|
||||
try { await handleStrategy('strategy-holdings/history', { strategyId: 's1', range: 'all' }, runtime); } catch (e) { threw = e; }
|
||||
assert(threw && threw.code === 'bad-request', '非法 range → bad-request');
|
||||
|
||||
console.log('\n[4b] range=today（本地自然日 00:00 边界；R-016 二轮补充：今日已清仓默认层）');
|
||||
const rowToday = all.find((r) => r.code === '600719.SH');
|
||||
const todayStart = new Date(); todayStart.setHours(0, 0, 0, 0);
|
||||
// 清仓时间挪到「昨天 23:59:59」→ today 应滤掉（昨天归历史范围层，不属默认层）
|
||||
db.prepare('UPDATE strategy_holdings SET closed_at=? WHERE holding_id=?').run(todayStart.getTime() - 1000, rowToday.holdingId);
|
||||
const apiTodayMiss = await handleStrategy('strategy-holdings/history', { strategyId: 's1', range: 'today' }, runtime);
|
||||
assert(apiTodayMiss.length === 0, 'today：昨天 23:59:59 清仓 → 不出现（自然日边界下沿）');
|
||||
// 挪回「今天 00:00:01」→ today 可见（00:00:00 含，00:00:01 > 00:00:00）
|
||||
db.prepare('UPDATE strategy_holdings SET closed_at=? WHERE holding_id=?').run(todayStart.getTime() + 1000, rowToday.holdingId);
|
||||
const apiTodayHit = await handleStrategy('strategy-holdings/history', { strategyId: 's1', range: 'today' }, runtime);
|
||||
assert(apiTodayHit.length === 1 && apiTodayHit[0].code === '600719.SH', 'today：今天 00:00:01 清仓 → 出现');
|
||||
// 40 天前的 000001.SZ 不应出现在 today
|
||||
assert(!apiTodayHit.some((r) => r.code === '000001.SZ'), 'today：不含 40 天前清仓的 000001.SZ');
|
||||
// name 兜底对 today 同样生效
|
||||
assert(apiTodayHit[0].name === '大连热电', 'today 行 name 兜底同样生效');
|
||||
// 非法校验：today 之外仍拒绝未知档（回归：'all' 仍非法）
|
||||
threw = null;
|
||||
try { await handleStrategy('strategy-holdings/history', { strategyId: 's1', range: 'all' }, runtime); } catch (e) { threw = e; }
|
||||
assert(threw && threw.code === 'bad-request', 'range 非法（all）→ bad-request 不受 today 引入影响');
|
||||
|
||||
console.log('\n[5] 现有端点零破坏（strategy-positions 快照路径不受影响）');
|
||||
const rt2 = { manager: { async getStrategyPositions() { return [{ code: '600719.SH', shares: 100 }]; } }, settings: {} };
|
||||
const pos = await handleStrategy('strategy-positions', { strategyId: 's1' }, rt2);
|
||||
assert(pos.length === 1 && pos[0].shares === 100, 'strategy-positions 行为不变（mock 验证分发未变）');
|
||||
} finally {
|
||||
storage.close();
|
||||
try { rmSync(tmp, { recursive: true, force: true }); } catch { /* ignore */ }
|
||||
}
|
||||
|
||||
console.log('\n=== 结果: ' + pass + ' 通过 / ' + fail + ' 失败 ===');
|
||||
process.exitCode = fail > 0 ? 1 : 0;
|
||||
@@ -0,0 +1,72 @@
|
||||
/**
|
||||
* R-017 / 迭代 15 回归：归属候选纳入近期清仓持仓
|
||||
* 独立临时数据目录（技术约束-011）。覆盖：当前持仓在前 / 近 7 天清仓行入选（closed 标记）/
|
||||
* 超 7 天清仓行被滤 / 策略隔离（同 code 多轮多策略）/ 空 code / 端点透传。
|
||||
*/
|
||||
import { DataStore } from '../src/storage/DataStore.js';
|
||||
import { handleTrade } from '../src/api/trades.js';
|
||||
import { mkdtempSync, rmSync } from 'node:fs';
|
||||
import { tmpdir } from 'node:os';
|
||||
import { join } from 'node:path';
|
||||
|
||||
let pass = 0, fail = 0;
|
||||
function assert(cond, msg) {
|
||||
if (cond) { pass++; console.log(' ✅ ' + msg); }
|
||||
else { fail++; console.log(' ❌ ' + msg); }
|
||||
}
|
||||
|
||||
const DAY = 86400000;
|
||||
const tmp = mkdtempSync(join(tmpdir(), 'odl-r017-'));
|
||||
const storage = new DataStore({ dataDir: tmp });
|
||||
const runtime = { storage, settings: { get: () => ({}) } }; // 策略名缺省 → fallback strategyId
|
||||
|
||||
try {
|
||||
console.log('\n[1] 当前持仓候选（closed=false）');
|
||||
const h1 = await storage.openHolding('s-t', '600719.SH', 1000);
|
||||
await storage.openHolding('s-g', '600719.SH', 800); // 同码第二策略
|
||||
let cands = await storage.getTradeAttributionCandidates('600719.SH');
|
||||
assert(cands.length === 2, '同码两策略当前持仓都在候选');
|
||||
assert(cands.every((c) => c.closed === false && c.closedAt === null), '当前持仓 closed=false / closedAt=null');
|
||||
assert(cands[0].shares >= cands[1].shares, '当前持仓按 shares DESC');
|
||||
|
||||
console.log('\n[2] 近 7 天清仓行入选（closed=true），当前在前');
|
||||
await storage.openHolding('s-t', '000001.SZ', 500);
|
||||
await storage.closeHolding('s-t', '000001.SZ'); // 刚清仓（做T场景）
|
||||
cands = await storage.getTradeAttributionCandidates('000001.SZ');
|
||||
assert(cands.length === 1 && cands[0].closed === true, '刚清仓行进入候选');
|
||||
assert(cands[0].holdingId != null && cands[0].closedAt > 0, '清仓行带 holdingId + closedAt');
|
||||
assert(cands[0].strategyId === 's-t', '清仓行策略正确');
|
||||
|
||||
console.log('\n[3] 超 7 天清仓行被滤除');
|
||||
const hOld = await storage.openHolding('s-t', '600000.SH', 300);
|
||||
await storage.closeHolding('s-t', '600000.SH');
|
||||
storage.sqlite.db.prepare('UPDATE strategy_holdings SET closed_at=? WHERE holding_id=?')
|
||||
.run(Date.now() - 8 * DAY, hOld.holdingId);
|
||||
cands = await storage.getTradeAttributionCandidates('600000.SH');
|
||||
assert(cands.length === 0, '8 天前清仓行不在候选');
|
||||
|
||||
console.log('\n[4] 排序：当前持仓在前，清仓行 closed_at DESC');
|
||||
await storage.openHolding('s-g', '300750.SZ', 100);
|
||||
await storage.closeHolding('s-g', '300750.SZ');
|
||||
const hOlder = await storage.openHolding('s-g', '300750.SZ', 200); // 复用同码再建仓再清
|
||||
await storage.closeHolding('s-g', '300750.SZ');
|
||||
storage.sqlite.db.prepare('UPDATE strategy_holdings SET closed_at=? WHERE holding_id=?')
|
||||
.run(Date.now() - 3 * DAY, hOlder.holdingId);
|
||||
cands = await storage.getTradeAttributionCandidates('300750.SZ');
|
||||
assert(cands.length === 2 && cands.every((c) => c.closed), '同码两轮清仓都入选');
|
||||
assert(cands[0].closedAt >= cands[1].closedAt, '清仓行按 closed_at DESC');
|
||||
|
||||
console.log('\n[5] 空 code / 无持仓 code');
|
||||
assert((await storage.getTradeAttributionCandidates('')).length === 0, '空 code → []');
|
||||
assert((await storage.getTradeAttributionCandidates('999999.SH')).length === 0, '无持仓 code → []');
|
||||
|
||||
console.log('\n[6] API 端点透传（含 strategyName fallback）');
|
||||
const api = await handleTrade('orders/attribution-candidates', { code: '000001.SZ' }, runtime);
|
||||
assert(api.length === 1 && api[0].strategyName === 's-t', '端点返回候选且策略名 fallback 到 id');
|
||||
} finally {
|
||||
storage.close();
|
||||
try { rmSync(tmp, { recursive: true, force: true }); } catch { /* ignore */ }
|
||||
}
|
||||
|
||||
console.log('\n=== 结果: ' + pass + ' 通过 / ' + fail + ' 失败 ===');
|
||||
process.exitCode = fail > 0 ? 1 : 0;
|
||||
@@ -18,6 +18,7 @@
|
||||
* strategies/remove → 删除策略 { strategyId }，联动清份额
|
||||
* strategies/move → 排序 { strategyId, dir }
|
||||
* strategy-positions → 某策略持仓 { strategyId }
|
||||
* strategy-holdings/history → 某策略已清仓历史持仓 { strategyId, range }（R-016）
|
||||
* unallocated → 未分配持仓
|
||||
* summary → 分仓摘要
|
||||
* add-shares → 添加份额 { code, strategyId, shares }
|
||||
|
||||
+53
-2
@@ -4,6 +4,7 @@
|
||||
* 端点：
|
||||
* strategies / strategies/update / strategies/add / strategies/remove
|
||||
* strategy-positions / unallocated / summary
|
||||
* strategy-holdings/history（R-016 迭代 14：已清仓历史持仓，范围筛选）
|
||||
* add-shares / move-all-shares / remove-shares
|
||||
* tabs / tabs/update
|
||||
*/
|
||||
@@ -14,6 +15,24 @@ import {
|
||||
getStrategyColumns, updateStrategyColumns,
|
||||
} from '../settings.js';
|
||||
|
||||
/** R-016 范围档 → 回溯毫秒（自然日近似，展示用途足够；技术约束-019）。
|
||||
* range='today' 不走回溯毫秒——二轮补充（2026-09-07 老师定）：本地自然日 00:00 起清仓的持仓
|
||||
* 作为「今日已清仓」默认层（开关「历史持仓」不控制它，当天清仓默认显示），sinceMs 在 handler 内特判。 */
|
||||
const HISTORY_RANGE_MS = {
|
||||
week: 7 * 86400000,
|
||||
month: 30 * 86400000,
|
||||
quarter: 90 * 86400000,
|
||||
halfYear: 182 * 86400000,
|
||||
year: 365 * 86400000,
|
||||
};
|
||||
|
||||
/** 本地自然日零点毫秒（range='today' 用：今天 00:00 起 = 当日清仓的持仓） */
|
||||
function localDayStartMs() {
|
||||
const d = new Date();
|
||||
d.setHours(0, 0, 0, 0);
|
||||
return d.getTime();
|
||||
}
|
||||
|
||||
/** 策略/份额/tabs 端点方法表 */
|
||||
export const STRATEGY_METHODS = new Set([
|
||||
'strategies',
|
||||
@@ -31,15 +50,16 @@ export const STRATEGY_METHODS = new Set([
|
||||
'holdings/values-update', // R-013：写某持仓行的自定义字段值
|
||||
'strategy-columns', // 迭代11列显隐：读某策略列配置（归一化）
|
||||
'strategy-columns/update', // 迭代11列显隐：写某策略列配置
|
||||
'strategy-holdings/history', // R-016 迭代 14：某策略已清仓历史持仓（范围筛选，只读）
|
||||
]);
|
||||
|
||||
/**
|
||||
* 处理策略/份额/tabs 端点
|
||||
* @param {string} method
|
||||
* @param {object} args
|
||||
* @param {object} runtime { manager, settings }
|
||||
* @param {object} runtime { manager, settings, storage }
|
||||
*/
|
||||
export async function handleStrategy(method, args, { manager, settings }) {
|
||||
export async function handleStrategy(method, args, { manager, settings, storage }) {
|
||||
switch (method) {
|
||||
case 'strategies':
|
||||
return getStrategies(settings);
|
||||
@@ -78,6 +98,37 @@ export async function handleStrategy(method, args, { manager, settings }) {
|
||||
case 'strategy-columns/update':
|
||||
await updateStrategyColumns(settings, args.strategyId, args.columns);
|
||||
return getStrategyColumns(settings, args.strategyId);
|
||||
case 'strategy-holdings/history': {
|
||||
// R-016 迭代 14：某策略已清仓历史持仓（当前持仓快照路径零改动，技术约束-019）
|
||||
if (!args.strategyId) {
|
||||
throw Object.assign(new Error('缺少 strategyId 参数'), { code: 'bad-request' });
|
||||
}
|
||||
const range = args.range ?? 'week';
|
||||
// R-016 二轮补充（2026-09-07 老师定）：range='today' = 本地自然日 00:00 起清仓的持仓
|
||||
// （前端默认层——当天清仓默认显示，与「历史持仓」开关解耦）；其余 5 档维持回溯毫秒语义
|
||||
let sinceMs;
|
||||
if (range === 'today') {
|
||||
sinceMs = localDayStartMs();
|
||||
} else {
|
||||
const ms = HISTORY_RANGE_MS[range];
|
||||
if (!ms) {
|
||||
throw Object.assign(new Error('range 非法: ' + range + '（today|week|month|quarter|halfYear|year）'), { code: 'bad-request' });
|
||||
}
|
||||
sinceMs = Date.now() - ms;
|
||||
}
|
||||
const rows = await storage.getHoldingsHistory(args.strategyId, { sinceMs });
|
||||
// name 兜底：该 holding 最近一笔关联委托的 name（前端免二次请求）
|
||||
const ids = rows.map((r) => r.holdingId);
|
||||
const nameMap = new Map();
|
||||
if (ids.length > 0) {
|
||||
const ph = ids.map(() => '?').join(',');
|
||||
const orows = storage.sqlite.db.prepare(
|
||||
"SELECT holding_id, name FROM trade_orders WHERE holding_id IN (" + ph + ") AND name != '' ORDER BY insert_ts DESC"
|
||||
).all(...ids);
|
||||
for (const o of orows) if (!nameMap.has(o.holding_id)) nameMap.set(o.holding_id, o.name);
|
||||
}
|
||||
return rows.map((r) => ({ ...r, name: nameMap.get(r.holdingId) ?? null }));
|
||||
}
|
||||
default:
|
||||
throw Object.assign(new Error('unknown strategy method: ' + method), { code: 'not-found' });
|
||||
}
|
||||
|
||||
@@ -8,6 +8,10 @@
|
||||
* - 全部移入（O6：行内按钮，该票全部未分配份额移入当前策略）
|
||||
* - 操作反馈：Toast 轻提示
|
||||
* - 加载失败兜底：LoadState 三态
|
||||
* - 历史持仓展示（R-016 迭代 14）：title 旁开关 + 清仓时间范围筛选（近一周默认/1个月/3个月/半年/1年），
|
||||
* 历史行灰显 + 「已清仓」徽标，展开复用 R-010 看关联交易（追溯该持仓的历史操作）
|
||||
* - 今日已清仓默认层（R-016 二轮补充，2026-09-07 老师定）：当天（本地自然日 00:00 起）已清仓的持仓
|
||||
* **默认显示**、不受「历史持仓」开关控制——清仓转历史后 tab 不因此少行；开关只控制今天之前的历史
|
||||
*
|
||||
* 添加持仓区域为响应式布局（内联 <style> + 媒体查询）：
|
||||
* - 宽屏：三元素一行（选择标的 | 份额 | 确认按钮）
|
||||
@@ -185,10 +189,38 @@ function StrategyTabInner({ strategyId, strategyName }) {
|
||||
const [columnOpen, setColumnOpen] = useState(false);
|
||||
// 迭代11：正在单元格内编辑的自定义字段（{code, key} | null）
|
||||
const [editingCell, setEditingCell] = useState(null);
|
||||
// R-016 迭代 14：历史持仓展示（title 旁开关 + 清仓范围筛选；会话级，不持久化，Q4）
|
||||
// R-016 二轮补充（2026-09-07 老师定）：「今日已清仓」是**默认层**（range='today'，恒显示），
|
||||
// 开关只控制今天之前的历史范围层（week/month/quarter/halfYear/year）——开关关≠当天清仓也被藏起
|
||||
const [showHistory, setShowHistory] = useState(false);
|
||||
const [historyRange, setHistoryRange] = useState('week'); // week|month|quarter|halfYear|year
|
||||
const [historyRows, setHistoryRows] = useState({}); // range → [已清仓持仓行]（含 'today' 键）
|
||||
const [historyLoading, setHistoryLoading] = useState(false);
|
||||
const call = useRpc();
|
||||
const toast = useToast();
|
||||
const { getPrice, registerCodes } = useMarket();
|
||||
|
||||
/** R-016：拉某范围已清仓历史持仓（独立只读端点；当前持仓快照路径零改动）。
|
||||
* range='today' = 本地自然日 00:00 起清仓（R-016 二轮补充：今日已清仓默认层） */
|
||||
const loadHistory = useCallback(async (range) => {
|
||||
setHistoryLoading(true);
|
||||
try {
|
||||
const res = await call('one-divine-lot/strategy-holdings/history', { args: { strategyId, range } });
|
||||
if (res && res.ok && Array.isArray(res.value)) {
|
||||
setHistoryRows((prev) => ({ ...(prev ?? {}), [range]: res.value }));
|
||||
} else {
|
||||
// 失败可见化（迭代 14 复盘：静默兜底=排障盲区）
|
||||
toast.error('历史持仓加载失败: ' + ((res && res.error && res.error.message) || 'unknown'));
|
||||
setHistoryRows((prev) => ({ ...(prev ?? {}), [range]: [] }));
|
||||
}
|
||||
} catch (err) {
|
||||
toast.error('历史持仓加载失败: ' + (err?.message ?? String(err)));
|
||||
setHistoryRows((prev) => ({ ...(prev ?? {}), [range]: [] }));
|
||||
} finally {
|
||||
setHistoryLoading(false);
|
||||
}
|
||||
}, [call, strategyId, toast]);
|
||||
|
||||
const load = useCallback(async () => {
|
||||
setLoading(true);
|
||||
setError(null);
|
||||
@@ -220,14 +252,31 @@ function StrategyTabInner({ strategyId, strategyName }) {
|
||||
setError(e.message);
|
||||
} finally {
|
||||
setLoading(false);
|
||||
// R-016 二轮补充：今日已清仓层随每次持仓重载刷新（进 tab / 移出等操作后，
|
||||
// 当天清仓的行立即转入默认层，不依赖「历史持仓」开关；loadHistory 自容错不外抛）
|
||||
loadHistory('today');
|
||||
}
|
||||
}, [call, strategyId]);
|
||||
}, [call, strategyId, loadHistory, registerCodes]);
|
||||
|
||||
useEffect(() => {
|
||||
ensureAddFormCss();
|
||||
load();
|
||||
}, [load]);
|
||||
|
||||
/** 开关：开启即取最新（关闭仅隐藏，缓存保留；进 tab 默认关）。
|
||||
* R-016 二轮补充：开关只控制「今天之前的历史范围层」；range='today'（当日清仓）恒显示、不受本开关控制 */
|
||||
const toggleHistory = () => {
|
||||
const next = !showHistory;
|
||||
setShowHistory(next);
|
||||
if (next) loadHistory(historyRange);
|
||||
};
|
||||
|
||||
/** 切换范围：未缓存才拉取 */
|
||||
const changeHistoryRange = (r) => {
|
||||
setHistoryRange(r);
|
||||
if (!historyRows[r]) loadHistory(r);
|
||||
};
|
||||
|
||||
const handleAdd = async () => {
|
||||
if (!selectedCode || !addShares) return;
|
||||
const res = await call('one-divine-lot/add-shares', {
|
||||
@@ -271,30 +320,30 @@ function StrategyTabInner({ strategyId, strategyName }) {
|
||||
}
|
||||
};
|
||||
|
||||
/** R-010：展开某持仓行 → 懒加载该 holding 的委托汇总 */
|
||||
const toggleExpand = async (code, holdingId) => {
|
||||
if (expandedCode === code) {
|
||||
/** R-010：展开某持仓行 → 懒加载该 holding 的委托汇总（R-016：键改唯一 rowKey，同码多行不串） */
|
||||
const toggleExpand = async (rowKey, holdingId) => {
|
||||
if (expandedCode === rowKey) {
|
||||
// 折叠
|
||||
setExpandedCode(null);
|
||||
return;
|
||||
}
|
||||
setExpandedCode(code);
|
||||
setExpandedCode(rowKey);
|
||||
if (holdingId == null) {
|
||||
setHoldingTrades((prev) => ({ ...(prev ?? {}), [code]: [] }));
|
||||
setHoldingTrades((prev) => ({ ...(prev ?? {}), [rowKey]: [] }));
|
||||
return;
|
||||
}
|
||||
// 懒加载：有缓存直接用，否则请求
|
||||
if (holdingTrades && holdingTrades[code]) return;
|
||||
setHoldingTradesLoading(code);
|
||||
if (holdingTrades && holdingTrades[rowKey]) return;
|
||||
setHoldingTradesLoading(rowKey);
|
||||
try {
|
||||
const res = await call('one-divine-lot/trades/by-holding', { args: { holdingId } });
|
||||
if (res?.ok && Array.isArray(res.value)) {
|
||||
setHoldingTrades((prev) => ({ ...(prev ?? {}), [code]: res.value }));
|
||||
setHoldingTrades((prev) => ({ ...(prev ?? {}), [rowKey]: res.value }));
|
||||
} else {
|
||||
setHoldingTrades((prev) => ({ ...(prev ?? {}), [code]: [] }));
|
||||
setHoldingTrades((prev) => ({ ...(prev ?? {}), [rowKey]: [] }));
|
||||
}
|
||||
} catch {
|
||||
setHoldingTrades((prev) => ({ ...(prev ?? {}), [code]: [] }));
|
||||
setHoldingTrades((prev) => ({ ...(prev ?? {}), [rowKey]: [] }));
|
||||
} finally {
|
||||
setHoldingTradesLoading(null);
|
||||
}
|
||||
@@ -325,6 +374,7 @@ function StrategyTabInner({ strategyId, strategyName }) {
|
||||
}
|
||||
return rows;
|
||||
}, [positions, sortKey, sortDir, getPrice]);
|
||||
//（R-016：rowsToRender 在此下方合成，历史行固定追加、不参与涨幅排序）
|
||||
|
||||
// 迭代11列显隐：可见列（表头/行渲染依据；未加载配置时=null，回退旧固定列）
|
||||
const visibleColumns = useMemo(() => {
|
||||
@@ -332,8 +382,62 @@ function StrategyTabInner({ strategyId, strategyName }) {
|
||||
return columns.filter((c) => c.visible !== false);
|
||||
}, [columns]);
|
||||
|
||||
// R-016 迭代 14：渲染行 = 当前持仓行 + 已清仓行。
|
||||
// 二轮补充（2026-09-07 老师定）：已清仓行分两层——
|
||||
// L1「今日已清仓」（range='today'，本地自然日 00:00 起清仓）：**默认恒显示**，不受「历史持仓」开关控制
|
||||
// L2「历史范围层」（week/month/...）：仅开关开启时显示（用户主动查看更早的历史）
|
||||
// 层间按 holdingId 去重（'today' 含近 7 天清仓时，开启 week 不重复出两行）；标题计数 (N 只) 只算当前持仓
|
||||
const histRowsFor = (range) =>
|
||||
(historyRows[range] ?? []).map((h) => ({
|
||||
...h,
|
||||
isHistory: true, // 历史行标识：灰显/只读/行情列 —
|
||||
name: h.name ?? null, // name 兜底（接口已按关联委托补，无则 null → 显示 —）
|
||||
}));
|
||||
|
||||
const rowsToRender = useMemo(() => {
|
||||
const current = rowsForRender;
|
||||
const today = histRowsFor('today'); // L1：今天已清仓 —— 恒定显示
|
||||
if (!showHistory) return [...current, ...today];
|
||||
// L2：历史范围层（含 today 在内同一端点返回）——去重：today 已显示的不重复追加
|
||||
const todayIds = new Set(today.map((h) => h.holdingId));
|
||||
const rest = histRowsFor(historyRange).filter((h) => !todayIds.has(h.holdingId));
|
||||
return [...current, ...today, ...rest];
|
||||
}, [rowsForRender, showHistory, historyRows, historyRange]);
|
||||
|
||||
/** 历史行徽标/时间格式化（清仓时间 YYYY-MM-DD HH:mm） */
|
||||
const fmtClosedAt = (ts) => {
|
||||
if (!ts) return '—';
|
||||
const d = new Date(Number(ts));
|
||||
if (!isFinite(d.getTime())) return '—';
|
||||
const p2 = (n) => String(n).padStart(2, '0');
|
||||
return d.getFullYear() + '-' + p2(d.getMonth() + 1) + '-' + p2(d.getDate()) + ' ' + p2(d.getHours()) + ':' + p2(d.getMinutes());
|
||||
};
|
||||
/** 持有天数（同日 = 1，向上取整） */
|
||||
const heldDays = (created, closed) => {
|
||||
if (!created || !closed) return null;
|
||||
const ms = Number(closed) - Number(created);
|
||||
if (!isFinite(ms) || ms < 0) return null;
|
||||
return Math.max(1, Math.ceil(ms / 86400000));
|
||||
};
|
||||
|
||||
/** 渲染某数据列单元格内容（col: {key,label,kind}）—— 返回 React 节点 */
|
||||
const renderDataCell = (col, p) => {
|
||||
// R-016：历史行——行情类列一律 —（不订阅行情）；shares 显示 DB 原值（Q2：0 就好）；自定义字段只读
|
||||
if (p.isHistory) {
|
||||
if (col.kind === 'field') {
|
||||
const fieldDef0 = (strategySchema ?? []).find((f0) => f0.key === col.key);
|
||||
if (!fieldDef0) return null;
|
||||
const has0 = p.values && Object.prototype.hasOwnProperty.call(p.values, col.key);
|
||||
const v0 = has0 ? p.values[col.key] : fieldDef0.def;
|
||||
let shown0;
|
||||
if (fieldDef0.type === 'boolean') shown0 = v0 ? '开' : '关';
|
||||
else if (v0 === undefined || v0 === null || v0 === '') shown0 = '—';
|
||||
else shown0 = String(v0) + (fieldDef0.unit ? fieldDef0.unit : '');
|
||||
return <span style={{ color: 'var(--dsw-alias-label-tertiary, #999)' }}>{shown0}</span>;
|
||||
}
|
||||
if (col.key === 'shares') return <span style={{ color: 'var(--dsw-alias-label-tertiary, #999)' }}>{p.shares}</span>;
|
||||
return <span style={{ color: 'var(--dsw-alias-label-tertiary, #999)' }}>—</span>;
|
||||
}
|
||||
if (col.kind === 'field') {
|
||||
// 自定义字段列：p.values[key] ?? def；点击单元格进入内联编辑（老师选 A）
|
||||
const fieldDef = (strategySchema ?? []).find((f2) => f2.key === col.key);
|
||||
@@ -417,13 +521,44 @@ function StrategyTabInner({ strategyId, strategyName }) {
|
||||
<div className="odl-root" style={{ padding: 16, fontFamily: 'system-ui' }}>
|
||||
<div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 12, flexWrap: 'wrap', gap: 8 }}>
|
||||
<h3 style={{ margin: 0 }}>{name}（{(positions ?? []).length} 只）</h3>
|
||||
<div style={{ display: 'flex', gap: 8 }}>
|
||||
<div style={{ display: 'flex', gap: 8, alignItems: 'center' }}>
|
||||
<button
|
||||
onClick={() => setShowAdd(!showAdd)}
|
||||
style={{ padding: '6px 12px', cursor: 'pointer', border: '1px solid var(--dsw-alias-border-l2, #ccc)', borderRadius: 4, background: 'var(--dsw-alias-interactive-bg-hover, #f5f5f5)' }}
|
||||
>
|
||||
{showAdd ? '取消' : '+ 添加持仓'}
|
||||
</button>
|
||||
{/* R-016 迭代 14：历史持仓开关 + 范围筛选（title 旁）。
|
||||
R-016 二轮补充：今天已清仓的持仓默认显示（不受此开关控制），此开关只开关更早的历史（今天之前） */}
|
||||
<button
|
||||
onClick={toggleHistory}
|
||||
title="显示/隐藏今天之前已清仓的历史持仓（当天已清仓的持仓始终显示）"
|
||||
style={{
|
||||
padding: '6px 12px', cursor: 'pointer', borderRadius: 4, fontSize: 13,
|
||||
border: '1px solid ' + (showHistory ? 'var(--dsw-alias-state-business-primary, #1565c0)' : 'var(--dsw-alias-border-l2, #ccc)'),
|
||||
background: showHistory ? 'color-mix(in srgb, var(--dsw-alias-state-business-primary, #1565c0) 12%, var(--dsw-alias-bg-layer-1, #fff))' : 'var(--dsw-alias-bg-layer-1, #fff)',
|
||||
color: showHistory ? 'var(--dsw-alias-state-business-primary, #1565c0)' : 'var(--dsw-alias-label-primary, #333)',
|
||||
}}
|
||||
>
|
||||
{showHistory ? '历史持仓 开' : '历史持仓 关'}
|
||||
</button>
|
||||
{showHistory && (
|
||||
<select
|
||||
value={historyRange}
|
||||
onChange={(e2) => changeHistoryRange(e2.target.value)}
|
||||
title="已清仓时间范围（按清仓时间回溯）"
|
||||
style={{ padding: '5px 6px', fontSize: 13, border: '1px solid var(--dsw-alias-border-l2, #ccc)', borderRadius: 4, background: 'var(--dsw-alias-bg-layer-1, #fff)' }}
|
||||
>
|
||||
<option value="week">近一周</option>
|
||||
<option value="month">近 1 个月</option>
|
||||
<option value="quarter">近 3 个月</option>
|
||||
<option value="halfYear">近半年</option>
|
||||
<option value="year">近 1 年</option>
|
||||
</select>
|
||||
)}
|
||||
{showHistory && historyLoading && (
|
||||
<span style={{ fontSize: 12, color: 'var(--dsw-alias-label-tertiary, #999)' }}>历史加载中...</span>
|
||||
)}
|
||||
<div style={{ position: 'relative' }}>
|
||||
<button
|
||||
onClick={() => setColumnOpen(!columnOpen)}
|
||||
@@ -476,7 +611,7 @@ function StrategyTabInner({ strategyId, strategyName }) {
|
||||
</div>
|
||||
)}
|
||||
|
||||
{positions && positions.length === 0 ? (
|
||||
{rowsToRender.length === 0 ? (
|
||||
<div style={{ padding: 24, textAlign: 'center', color: 'var(--dsw-alias-label-tertiary, #999)' }}>
|
||||
暂无持仓，点击「+ 添加持仓」从全部持仓中添加
|
||||
</div>
|
||||
@@ -492,19 +627,24 @@ function StrategyTabInner({ strategyId, strategyName }) {
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{rowsForRender.map((p) => {
|
||||
const isExpanded = expandedCode === p.code;
|
||||
const trades = (holdingTrades ?? {})[p.code];
|
||||
const isLoading = holdingTradesLoading === p.code;
|
||||
{rowsToRender.map((p) => {
|
||||
const rowKey = p.isHistory ? 'h-' + p.holdingId : p.code; // 唯一行键：同码「当前行 + 历史行」不串展开与缓存
|
||||
const isExpanded = expandedCode === rowKey;
|
||||
const trades = (holdingTrades ?? {})[rowKey];
|
||||
const isLoading = holdingTradesLoading === rowKey;
|
||||
const hasHolding = p.holdingId != null;
|
||||
const histStyle = p.isHistory
|
||||
? { opacity: 0.72, color: 'var(--dsw-alias-label-tertiary, #999)' }
|
||||
: null;
|
||||
return (
|
||||
<React.Fragment key={p.code}>
|
||||
<React.Fragment key={rowKey}>
|
||||
<tr
|
||||
onClick={() => toggleExpand(p.code, p.holdingId)}
|
||||
onClick={() => toggleExpand(rowKey, p.holdingId)}
|
||||
style={{
|
||||
borderBottom: '1px solid var(--dsw-alias-border-l1, #eee)',
|
||||
cursor: hasHolding ? 'pointer' : 'default',
|
||||
background: isExpanded ? 'var(--dsw-alias-interactive-bg-hover, #f5f5f5)' : 'transparent',
|
||||
...(histStyle ?? {}),
|
||||
}}
|
||||
>
|
||||
<td style={{ padding: '8px 6px', textAlign: 'center', width: 28 }}>
|
||||
@@ -514,13 +654,30 @@ function StrategyTabInner({ strategyId, strategyName }) {
|
||||
<span style={{ color: 'var(--dsw-alias-border-l3, #ccc)', fontSize: 10 }}>·</span>
|
||||
)}
|
||||
</td>
|
||||
<td style={{ padding: '8px 6px' }}>{p.code}</td>
|
||||
<td style={{ padding: '8px 6px' }}>{p.name}</td>
|
||||
<td style={{ padding: '8px 6px', whiteSpace: 'nowrap' }}>
|
||||
{p.code}
|
||||
{p.isHistory && (
|
||||
<span
|
||||
title={'清仓时间 ' + fmtClosedAt(p.closedAt)}
|
||||
style={{
|
||||
marginLeft: 6, fontSize: 11, padding: '1px 6px', borderRadius: 3,
|
||||
border: '1px solid var(--dsw-alias-border-l2, #ccc)',
|
||||
color: 'var(--dsw-alias-label-tertiary, #999)',
|
||||
background: 'var(--dsw-alias-bg-layer-2, #f5f5f5)',
|
||||
}}
|
||||
>
|
||||
已清仓 {fmtClosedAt(p.closedAt).slice(0, 10)}
|
||||
</span>
|
||||
)}
|
||||
</td>
|
||||
<td style={{ padding: '8px 6px' }}>{p.isHistory ? (p.name ?? '—') : p.name}</td>
|
||||
{(visibleColumns ?? []).map((col) => (
|
||||
<td key={col.key} style={{ padding: '8px 6px', whiteSpace: 'nowrap' }}>{renderDataCell(col, p)}</td>
|
||||
))}
|
||||
<td style={{ padding: '8px 6px', whiteSpace: 'nowrap' }} onClick={(e) => e.stopPropagation()}>
|
||||
{removeTarget && removeTarget.code === p.code ? (
|
||||
{p.isHistory ? (
|
||||
<span style={{ color: 'var(--dsw-alias-border-l3, #ccc)' }}>—</span>
|
||||
) : removeTarget && removeTarget.code === p.code ? (
|
||||
<span>
|
||||
<input
|
||||
type="number"
|
||||
@@ -559,11 +716,18 @@ function StrategyTabInner({ strategyId, strategyName }) {
|
||||
{isExpanded && (
|
||||
<tr style={{ borderBottom: '1px solid var(--dsw-alias-border-l1, #eee)', background: 'var(--dsw-alias-bg-layer-2, #fafafa)' }}>
|
||||
<td colSpan={4 + (visibleColumns?.length ?? 6)} style={{ padding: '4px 8px 12px' }}>
|
||||
{p.isHistory && (
|
||||
<div style={{ padding: '4px 8px', fontSize: 12, color: 'var(--dsw-alias-label-secondary, #666)' }}>
|
||||
已清仓持仓 · 清仓时间 {fmtClosedAt(p.closedAt)} · 持有 {heldDays(p.createdAt, p.closedAt) ?? '—'} 天 · 份额（清仓后）{p.shares}
|
||||
</div>
|
||||
)}
|
||||
{isLoading ? (
|
||||
<div style={{ padding: 8, color: 'var(--dsw-alias-label-tertiary, #999)', fontSize: 12 }}>交易记录加载中...</div>
|
||||
) : !trades || trades.length === 0 ? (
|
||||
<div style={{ padding: 8, color: 'var(--dsw-alias-label-tertiary, #999)', fontSize: 12 }}>
|
||||
{hasHolding ? '该持仓暂无关联交易记录（可在「交易记录」tab 为委托设置归属）' : '该持仓无关联锚点（holding_id）'}
|
||||
{hasHolding
|
||||
? (p.isHistory ? '该历史持仓暂无关联交易记录（归属设置须在清仓当日完成）' : '该持仓暂无关联交易记录（可在「交易记录」tab 为委托设置归属）')
|
||||
: '该持仓无关联锚点（holding_id）'}
|
||||
</div>
|
||||
) : (
|
||||
<HoldingTradesTable trades={trades} />
|
||||
|
||||
@@ -473,47 +473,66 @@ function OrderRows({ order, expanded, onToggle, attributionCandidates, onLoadCan
|
||||
}
|
||||
|
||||
/** 委托归属选择下拉（R-009，Q3 全手动选；Q4 可随时改）
|
||||
* 候选 = 该 code 当前持仓策略（orders/attribution-candidates）；
|
||||
* 候选 = 该 code 当前持仓 + 近 7 天清仓持仓（R-017，orders/attribution-candidates）；
|
||||
* 锚点键 = holdingId（同策略可有多轮持仓行，strategyId 会撞值，R-017 定稿）；
|
||||
* 未设置显示「未关联」，用户点选后持久化（orders/set-attribution）。
|
||||
*/
|
||||
function AttributionSelect({ order, candidates, onLoadCandidates, setAttribution }) {
|
||||
const current = order.strategyId || '';
|
||||
const currentKey = order.holdingId != null ? String(order.holdingId) : '';
|
||||
|
||||
const handleSelect = (ev) => {
|
||||
const val = ev.target.value;
|
||||
if (val === current) return;
|
||||
if (val === currentKey) return;
|
||||
if (val === '__unassigned__') {
|
||||
setAttribution(order.orderId, order.code, null, null);
|
||||
return;
|
||||
}
|
||||
const cand = (candidates ?? []).find((c) => c.strategyId === val);
|
||||
setAttribution(order.orderId, order.code, val, cand ? cand.holdingId : null);
|
||||
const cand = (candidates ?? []).find((c) => String(c.holdingId) === val);
|
||||
setAttribution(order.orderId, order.code, cand ? cand.strategyId : null, cand ? cand.holdingId : null);
|
||||
};
|
||||
|
||||
// 已归属但候选列表缺失（如清仓超 7 天）：显示「当前归属」占位，避免 select 值悬空
|
||||
const candByKey = new Map((candidates ?? []).map((c) => [String(c.holdingId), c]));
|
||||
const hasCurrent = currentKey && candByKey.has(currentKey);
|
||||
const closedSuffix = (c) => (c.closed ? '（已清仓 ' + fmtClosed(c.closedAt) + '）' : '');
|
||||
|
||||
return (
|
||||
<select
|
||||
value={current || '__unassigned__'}
|
||||
value={hasCurrent || !currentKey ? (currentKey || '__unassigned__') : currentKey}
|
||||
onChange={handleSelect}
|
||||
style={{
|
||||
fontSize: 12,
|
||||
padding: '2px 4px',
|
||||
border: '1px solid ' + (current ? 'var(--dsw-alias-state-success-primary, #2e7d32)' : 'var(--dsw-alias-border-l2, #ccc)'),
|
||||
border: '1px solid ' + (currentKey ? 'var(--dsw-alias-state-success-primary, #2e7d32)' : 'var(--dsw-alias-border-l2, #ccc)'),
|
||||
borderRadius: 4,
|
||||
background: current ? 'color-mix(in srgb, var(--dsw-alias-state-success-primary, #2e7d32) 12%, var(--dsw-alias-bg-layer-1, #fff))' : 'var(--dsw-alias-bg-layer-1, #fff)',
|
||||
color: current ? 'var(--dsw-alias-state-success-primary, #1b5e20)' : 'var(--dsw-alias-label-tertiary, #999)',
|
||||
maxWidth: 120,
|
||||
background: currentKey ? 'color-mix(in srgb, var(--dsw-alias-state-success-primary, #2e7d32) 12%, var(--dsw-alias-bg-layer-1, #fff))' : 'var(--dsw-alias-bg-layer-1, #fff)',
|
||||
color: currentKey ? 'var(--dsw-alias-state-success-primary, #1b5e20)' : 'var(--dsw-alias-label-tertiary, #999)',
|
||||
maxWidth: 150,
|
||||
}}
|
||||
title="设置该委托的策略归属（可随时修改）"
|
||||
title="设置该委托的策略/持仓归属（可随时修改；清仓 7 天内可补关联）"
|
||||
>
|
||||
<option value="__unassigned__">未关联</option>
|
||||
{!hasCurrent && currentKey && (
|
||||
<option value={currentKey}>当前归属（{order.strategyId || '未知策略'}）</option>
|
||||
)}
|
||||
{(candidates ?? []).map((c) => (
|
||||
<option key={c.holdingId} value={c.strategyId}>{c.strategyName || c.strategyId}</option>
|
||||
<option key={c.holdingId} value={String(c.holdingId)}>
|
||||
{c.strategyName || c.strategyId}{closedSuffix(c)}
|
||||
</option>
|
||||
))}
|
||||
|
||||
</select>
|
||||
);
|
||||
}
|
||||
|
||||
/** 清仓日期短格式（MM-DD） */
|
||||
function fmtClosed(ts) {
|
||||
if (!ts) return '';
|
||||
const d = new Date(Number(ts));
|
||||
if (!isFinite(d.getTime())) return '';
|
||||
const p2 = (n) => String(n).padStart(2, '0');
|
||||
return (d.getMonth() + 1) + '-' + p2(d.getDate());
|
||||
}
|
||||
|
||||
const thStyle = { padding: '8px 6px', lineHeight: '24px', whiteSpace: 'nowrap' };
|
||||
const thClickStyle = { ...thStyle, cursor: 'pointer', userSelect: 'none' };
|
||||
const tdStyle = { padding: '8px 6px', lineHeight: '24px', whiteSpace: 'nowrap', fontVariantNumeric: 'tabular-nums' };
|
||||
@@ -73,12 +73,18 @@ export class DataStore {
|
||||
return this.sqlite.getCurrentHoldings(strategyId);
|
||||
}
|
||||
|
||||
/** 历史持仓 */
|
||||
/** 历史持仓（含当前 + 已清仓；全表按 code 查，R-008 遗留） */
|
||||
async getHoldingHistory(code) {
|
||||
await this._ensure();
|
||||
return this.sqlite.getHoldingHistory(code);
|
||||
}
|
||||
|
||||
/** 某策略已清仓持仓（closed_at 非空 + 可选 sinceMs 下限；R-016 迭代 14，只读） */
|
||||
async getHoldingsHistory(strategyId, opts) {
|
||||
await this._ensure();
|
||||
return this.sqlite.getHoldingsHistory(strategyId, opts);
|
||||
}
|
||||
|
||||
/** 读取持仓自定义字段值（R-013：委托 SqliteStore） */
|
||||
readValues(holdingId) {
|
||||
return this.sqlite.readValues(holdingId);
|
||||
|
||||
@@ -375,6 +375,25 @@ export class SqliteStore {
|
||||
).all().map(this._mapHolding);
|
||||
}
|
||||
|
||||
/**
|
||||
* 查询某策略已清仓持仓（closed_at 非空；R-016 迭代 14）
|
||||
* 只读新增，不动任何写路径（closeHolding 置 shares=0 语义维持——Q2 老师拍板：历史行份额显示 0）。
|
||||
* @param {string} strategyId 策略 ID
|
||||
* @param {{sinceMs?: number}} [opts] sinceMs：closed_at 下限（毫秒，含）；缺省不过滤
|
||||
* @returns {Array} 历史持仓行（_mapHolding 同构），按 closed_at DESC（最近清仓在前）
|
||||
*/
|
||||
getHoldingsHistory(strategyId, { sinceMs } = {}) {
|
||||
this.init();
|
||||
const params = [strategyId];
|
||||
let sql = 'SELECT holding_id, strategy_id, code, shares, created_at, closed_at, "values" FROM strategy_holdings WHERE strategy_id=? AND closed_at IS NOT NULL';
|
||||
if (sinceMs != null && Number.isFinite(Number(sinceMs))) {
|
||||
sql += ' AND closed_at >= ?';
|
||||
params.push(Number(sinceMs));
|
||||
}
|
||||
sql += ' ORDER BY closed_at DESC';
|
||||
return this.db.prepare(sql).all(...params).map(this._mapHolding);
|
||||
}
|
||||
|
||||
/** 查询历史（含当前 + 已清仓；可加 code 过滤） */
|
||||
getHoldingHistory(code) {
|
||||
this.init();
|
||||
@@ -667,19 +686,26 @@ export class SqliteStore {
|
||||
}
|
||||
|
||||
/**
|
||||
* 委托归属候选列表（用户手动设置用；候选 = 该 code 当前持仓的策略/持仓，Q3 全手动选）
|
||||
* 委托归属候选列表（用户手动设置用；Q3 全手动选）
|
||||
* R-017 迭代 15：候选 = 该 code 当前持仓 + 近 7 天清仓的持仓（closed 标记）——
|
||||
* 清仓后（幽灵清仓最快约 30s 转历史）当日委托仍可补关联到对应 holding。
|
||||
* @param {string} code 证券代码（含后缀）
|
||||
* @returns {Array<{strategyId: string, holdingId: number, shares: number}>} 候选列表（可空）
|
||||
* @returns {Array<{strategyId: string, holdingId: number, shares: number, closed: boolean, closedAt: number|null}>} 候选列表（可空）
|
||||
*/
|
||||
getAttributionCandidates(code) {
|
||||
this.init();
|
||||
if (!code) return [];
|
||||
const weekAgo = Date.now() - 7 * 86400000;
|
||||
return this.db.prepare(
|
||||
'SELECT holding_id, strategy_id, shares FROM strategy_holdings WHERE code=? AND closed_at IS NULL ORDER BY shares DESC'
|
||||
).all(code).map((h) => ({
|
||||
`SELECT holding_id, strategy_id, shares, closed_at FROM strategy_holdings
|
||||
WHERE code=? AND (closed_at IS NULL OR closed_at >= ?)
|
||||
ORDER BY (closed_at IS NULL) DESC, shares DESC, closed_at DESC`
|
||||
).all(code, weekAgo).map((h) => ({
|
||||
strategyId: h.strategy_id,
|
||||
holdingId: h.holding_id,
|
||||
shares: h.shares,
|
||||
closed: h.closed_at != null,
|
||||
closedAt: h.closed_at ?? null,
|
||||
}));
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user