dekun
86 lines
3.1 KiB
Markdown
86 lines
3.1 KiB
Markdown
# 开仓计划
|
||
|
||
中控顶栏 **开仓计划**（`/plan`）用于记录开仓前的计划、跟踪进行中条目，并在填写结果后归档；支持按币种、趋势周期、入场方案统计胜率。
|
||
|
||
## 入口
|
||
|
||
- 顶栏：**资金概况** 与 **监控区** 之间 → **开仓计划**
|
||
- 路由：`/plan`
|
||
|
||
## 页面结构
|
||
|
||
| 区域 | 功能 |
|
||
|------|------|
|
||
| 左侧 · 新建计划 | 填写计划字段，保存后进入「进行中」 |
|
||
| 左侧 · 进行中 | 修改、删除、填写结果并归档 |
|
||
| 右侧 · 计划历史 | 一行一条摘要，点击查看详情 |
|
||
| 右侧 · 数据统计 | 胜率表（可切换维度与时间范围） |
|
||
|
||
## 字段说明
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| 日期 | 计划日期（日期选择器，可手输 `YYYY-MM-DD`） |
|
||
| 交易所 | 四所：binance / okx / gate / gate_bot（来自 hub 已启用账户） |
|
||
| 币种 | 输入 `BTC` 或 `BTC/USDT`，自动规范为 `XXX/USDT` |
|
||
| 类型 | 趋势单 / 波段单 / 日内短线 |
|
||
| 趋势周期 | 5m / 15m / 30m / 1h / 4h / 1d |
|
||
| 入场周期 | 1m / 5m / 15m / 30m / 1h |
|
||
| 方向 | 多 / 空 |
|
||
| 目标位 | 文本 |
|
||
| 当前区间 | 文本 |
|
||
| 入场方案 | **仅进行中**填写：突破 / 假突破 / 箱体拐点（根据实际进场选择；归档前必选） |
|
||
| 结果 | **仅进行中**可填：盈 / 亏；**必选其一才归档** |
|
||
| 盈亏 | **可选**数字（U），不参与是否归档 |
|
||
| 备注 | 文本 |
|
||
|
||
## 业务流程
|
||
|
||
1. **新建** → 状态 `active`（进行中），**不含入场方案**
|
||
2. **进行中** → 选择/修改 **入场方案**（根据实际进场填写），可改备注、价位等
|
||
3. **删除** → 仅 **未填结果** 的进行中计划可删
|
||
4. **归档** → 在进行中选择 **盈/亏** 并点「填写结果并归档」→ 状态 `archived`，移入计划历史
|
||
|
||
## 数据统计
|
||
|
||
- **默认**：全部历史
|
||
- **时间**：全部 / 本周 / 本月 / 自选区间
|
||
- **维度 Tab**：币种 | 趋势周期 | 入场方案
|
||
- **胜率**：盈利 ÷ (盈利 + 亏损)，仅统计已归档且结果=盈/亏 的计划
|
||
|
||
## API
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| GET | `/api/entry-plans/meta` | 枚举项 + 交易所列表 |
|
||
| GET | `/api/entry-plans?status=active\|archived` | 列表 |
|
||
| GET | `/api/entry-plans/{id}` | 详情 |
|
||
| POST | `/api/entry-plans` | 新建 |
|
||
| PATCH | `/api/entry-plans/{id}` | 更新；写入 `result` 时自动归档 |
|
||
| DELETE | `/api/entry-plans/{id}` | 删除（仅 active） |
|
||
| GET | `/api/entry-plans/stats` | 统计；参数 `dimension`、`period`、`date_from`、`date_to` |
|
||
|
||
## 存储
|
||
|
||
- SQLite：`manual_trading_hub/data/hub_entry_plans.db`
|
||
- 环境变量：`HUB_ENTRY_PLAN_DB_PATH`（可选自定义路径）
|
||
|
||
## 部署
|
||
|
||
```bash
|
||
git pull
|
||
pm2 restart manual-trading-hub
|
||
```
|
||
|
||
浏览器访问 `/plan` 并 **Ctrl+F5** 强刷静态资源。
|
||
|
||
## 相关代码
|
||
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| `hub_entry_plan_lib.py` | 库表、CRUD、统计 |
|
||
| `manual_trading_hub/hub.py` | REST API |
|
||
| `manual_trading_hub/static/plan.js` | 前端逻辑 |
|
||
| `manual_trading_hub/static/index.html` | 页面 DOM |
|
||
| `tests/test_hub_entry_plan_lib.py` | 单元测试 |
|