# 国内期货 · 交易复盘系统 · 个人用户版

> **发行标识**：`v1.0.0-user`（分支 `release/v1.0-user`）  
> 基于 Flask 的国内期货 **CTP 下单 + 监控 + 复盘 + 统计** Web 应用。模拟盘连接 SimNow，实盘连接期货公司 CTP。

本分支为 **个人用户版**，与完整版 `main` 功能范围不同，详见 [发行说明](docs/RELEASE-v1.0.0-user.md)。

## 用户版功能范围

| 包含 | 不含 |
|------|------|
| 下单监控（报单、持仓、CTP） | 行情 K 线页面 |
| 关键位监控 | 可开仓品种筛选大表 |
| 交易记录与复盘（**手动截图**） | 复盘自动生成 K 线图 |
| 统计分析、系统设置、备份 | — |
| **小账户四品种限制**（≤20 万或未连 CTP：玉米、豆粕、甲醇、螺纹钢） | — |

## 文档

| 文档 | 说明 |
|------|------|
| **[发行说明 v1.0.0-user](docs/RELEASE-v1.0.0-user.md)** | 版本标识、与完整版差异、交付与升级 |
| **[功能说明](docs/FEATURES.md)** | 各模块功能、页面路径 |
| **[部署文档](docs/DEPLOY.md)** | 一键部署、PM2、故障排查 |
| **[SimNow 接入](docs/SIMNOW.md)** | 仿真账号注册与 CTP 前置 |
| **[交易与策略](docs/TRADING.md)** | 下单、小账户品种限制 |
| **[软件购买与使用协议](docs/软件购买与使用协议.md)** | 个人版授权模板 |

## 功能一览

| 模块 | 路径 | 说明 |
|------|------|------|
| **下单监控**（默认首页） | `/positions` | CTP 连接、期货下单、当前持仓 |
| 策略交易 | `/strategy` | 可导航开关 |
| 开单计划 | `/plans` | 可导航开关 |
| 关键位监控 | `/keys` | 箱体/阻力支撑突破提醒 |
| 交易记录与复盘 | `/records` | 资金曲线、CTP 成交同步、手动复盘 |
| 统计分析 | `/stats` | 汇总指标 + 分项统计 |
| 手续费配置 | `/fees` | 可导航开关 |
| 系统设置 | `/settings` | 交易模式、CTP、计仓、微信 |

## 快速开始

**你自己部署（完整版 · 用 `main` 分支）**

见 [docs/DEPLOY.md](docs/DEPLOY.md) → **A. 你自己部署（完整版 · main）**。

**客户交付 / 个人用户版（`v1.0.0-user`）**

见 [docs/DEPLOY.md](docs/DEPLOY.md) → **B. 客户交付（个人用户版 · v1.0.0-user）**。**本地开发（当前分支为用户版代码）**

```bashpython3 -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
python app.py
```

## 环境要求

- Python 3.10+（vnpy_ctp）
- PM2（生产部署）
- 网络：新浪现价（内部逻辑）、SimNow/CTP 前置

## 版权与授权

- 著作权人：**马建军**
- 许可说明：[LICENSE.zh-CN.txt](LICENSE.zh-CN.txt)
- 个人购买协议：[docs/软件购买与使用协议.md](docs/软件购买与使用协议.md)

本软件为 **专有软件**，仅供经授权的个人自用部署。

联系：手机 18364911125 · 微信 dekun03