kyugao
2aacd8a25d
- PLAN-008/PLAN-009 计划（已完成） - 迭代 07/08 四件套（目标/技术方案/验收标准/复盘） - 设计约束：数据存储设计 §10/§10.1、技术约束-012/013、产品约束-008 - R-009/R-010 需求归档（含二次定稿：手动归属、Q4 成本价/成交价） - 需求池索引同步
66 lines
4.9 KiB
Markdown
66 lines
4.9 KiB
Markdown
# 计划：交易记录本地存储（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：回归测试用独立数据目录。 |