one_divine_lot/docs/02-计划/计划-交易记录本地存储SQLite与策略关联.md

计划：交易记录本地存储（SQLite）+ 策略关联（阶段航点）

编号：PLAN-008 ｜ 粒度：阶段航点（大粒度） ｜ 创建：2026-09-01 ｜ 状态：已完成（2026-09-01 迭代 07 验收通过） 派生自终极目标：目标-006（交易复盘）、目标-003（按策略监控市场） 依据需求：R-009（已定稿，2026-09-01，Q1-Q8 全部确认） —— 符合入范围门槛 设计约束：技术约束-012（数据存储设计）、技术约束-001/003/004/010（沿用）、产品约束-007 方向语义

目标

在 SQLite 新增交易记录表（trade_orders 委托 + trade_fills 成交），将 QMT Bridge 当日交易数据本地持久化（跨日积累成本地历史库），并按外键链（成交→委托→策略→holding）建立与插件策略体系的关联，支持按策略过滤 / 复盘交易。

• 承接 R-007 的 Q5（本地持久化）与 Q10（按策略过滤）；
• 落实迭代 06 复盘遗留项 2（holding_id 关联锚点）；
• 解决 R-007 历史范围「接口开发中」占位（本地积累后历史可查）。

范围

做：

1. 两表落地：trade_orders（委托主行，order_id 主键，UPSERT 幂等）+ trade_fills（成交明细，trade_id 主键、order_id 外键关联委托）两表；两表均不冗余 strategy_id / holding_id（Q3 老师定稿：外键链推导）；trade_orders 加派生列 insert_ts（insert_date+insert_time 合成毫秒时间戳，join 持仓窗口用）；
2. 定时同步：服务端 TradeSync 模块 —— 定时（60s）拉当日 orders+trades → UPSERT 落库（幂等）；插件启动同步一次（预热今日数据）；前端今日轮询写穿（机会式）；
3. 策略关联（外键链推导）：策略/持仓归属不在写入期计算，查询期由委托时间（insert_ts）JOIN strategy_holdings 生命周期窗口（created_at ≤ t < closed_at，closed_at 为 NULL=当前持仓）推导；同码多策略取份额最大持仓；无命中视为未关联；
4. 本地历史查询端点：trades/history —— 按 { start, end, code, strategyId, direction } 查本地 SQLite，返回 { orders, fills }（策略过滤走 FK 链 join）；
5. 前端：TradeRecordsTab 加策略过滤下拉（全部/各策略/未关联）；历史范围从「占位」切换为查本地库；今日仍走 QMT 实时 + 写穿本地。

不做：

• 手动修正策略关联入口（后续迭代）；
• 导出/清理管理界面（后续迭代；复盘需要历史，不做自动清理）；
• QMT 历史接口接入（老师完善后再接）；
• 下单/撤单等交易操作（目标-007 另议）。

程序结构（改造后）

src/
├── component/
│   ├── SqliteStore.js        # 改：+trade_orders/trade_fills 建表 + 交易 UPSERT/查询 + 策略归属推导
│   ├── DataStore.js          # 改：委托交易记录方法
│   └── TradeSync.js          # 新增：服务端定时同步（60s + 启动预热 + UPSERT 幂等）
├── api/
│   └── trades.js             # 改：+trades/history 端点
└── index.js                  # 改：装配 TradeSync + storage 注入 api runtime
src/client/views/
└── TradeRecordsTab.jsx       # 改：策略过滤下拉 + 历史范围查本地库

实现步骤（建议顺序）

1. 文档骨架：PLAN-008 + 迭代 07 子目录（本步）；
2. 设计约束落地：数据存储设计.md §10 增补交易记录表设计 + 技术方案约束新增条目；
3. SqliteStore：建表（trade_orders/trade_fills）+ 交易 UPSERT（幂等）+ 本地历史查询 + 策略归属推导（insert_ts join 持仓窗口）；
4. DataStore：委托交易记录方法；
5. TradeSync：定时同步模块（60s + 启动预热 + 今日范围 UPSERT）；
6. api/trades.js：trades/history 端点（+ 现有 orders/trades 响应附加策略归属信息可选）；
7. index.js：装配 TradeSync（dispose 清理）+ storage 注入 api runtime；
8. 前端：TradeRecordsTab 策略过滤 + 历史范围本地展示；
9. 构建测试：pnpm run build + typecheck + 独立数据目录回归测试（技术约束-011）；
10. 验收：对照迭代 07 验收标准逐条核验，记录迭代复盘。

验收要点

• trade_orders + trade_fills 两表落地（零冗余 strategy_id/holding_id，insert_ts 派生列）；
• 同步：启动预热 + 60s 定时 UPSERT 幂等（重复同步不重复行、状态覆盖更新）；
• 历史查询：按时间段/code/策略/方向查本地库，策略过滤 = 委托时间 join 持仓生命周期窗口（一码多策略取份额最大）；
• 前端：策略过滤下拉 + 历史范围展示本地数据（不再占位）；今日实时 + 写穿；
• 现有功能不回归（持仓/策略/行情/连接配置/交易记录今日实时）；
• 技术约束-011：回归测试用独立数据目录。