dekun
196 lines
6.2 KiB
Markdown
196 lines
6.2 KiB
Markdown
# 加密货币大盘-周期-阶段-强弱-方向-账户-策略前置匹配系统
|
||
|
||
纯本地部署的前置策略匹配工具。前后端分离，SQLite 持久化，黑色极简主题，无登录。
|
||
|
||
> **代码仓库**：[https://git.bz121.com/dekun/crypto-pre-trade-system.git](https://git.bz121.com/dekun/crypto-pre-trade-system.git)
|
||
> **生产部署**：见 [DEPLOY.md](./DEPLOY.md)（Ubuntu + PM2 一键部署）
|
||
|
||
> **本系统仅做前置策略匹配**，不处理币种、K线识别、箱体判断、点位计算、突破校验、自动下单或交易所对接。
|
||
> 所有箱体细节、触碰次数、突破确认条件、顺势/逆势箱体，全部由人工手动筛选输入。
|
||
|
||
---
|
||
|
||
## 技术栈
|
||
|
||
| 层级 | 技术 |
|
||
|------|------|
|
||
| 后端 | Python 3.10+ / FastAPI / SQLAlchemy / SQLite |
|
||
| 前端 | Vue 3 / Vite / TailwindCSS / Axios |
|
||
| 数据库 | SQLite（`backend/data/pretrade.db`） |
|
||
|
||
---
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
crypto-pre-trade-system/
|
||
├── backend/
|
||
│ ├── app/
|
||
│ │ ├── main.py # FastAPI 入口
|
||
│ │ ├── database.py # 数据库连接 + 默认数据初始化
|
||
│ │ ├── models.py # ORM 模型
|
||
│ │ ├── schemas.py # Pydantic 模型
|
||
│ │ ├── crud.py # CRUD 操作
|
||
│ │ ├── matcher.py # 前置匹配核心逻辑
|
||
│ │ └── routes/ # API 路由
|
||
│ ├── init_db.sql # 建表 SQL（参考）
|
||
│ ├── requirements.txt
|
||
│ └── data/ # SQLite 数据库（自动创建）
|
||
├── frontend/
|
||
│ ├── src/
|
||
│ │ ├── views/
|
||
│ │ │ ├── DailyMatch.vue # 日常使用页（核心）
|
||
│ │ │ └── ConfigCenter.vue # 系统配置中心
|
||
│ │ ├── api/index.js # API 封装
|
||
│ │ └── ...
|
||
│ └── package.json
|
||
├── deploy/
|
||
│ └── install.sh # Ubuntu 一键部署脚本
|
||
├── ecosystem.config.cjs # PM2 进程配置
|
||
├── DEPLOY.md # 部署文档
|
||
└── README.md
|
||
```
|
||
|
||
---
|
||
|
||
## 快速启动
|
||
|
||
### 1. 启动后端
|
||
|
||
```bash
|
||
cd backend
|
||
|
||
# 创建虚拟环境（推荐）
|
||
python -m venv venv
|
||
# Windows:
|
||
venv\Scripts\activate
|
||
# macOS/Linux:
|
||
# source venv/bin/activate
|
||
|
||
pip install -r requirements.txt
|
||
|
||
# 启动 API 服务（首次启动自动建表 + 写入默认数据）
|
||
uvicorn app.main:app --reload --host 127.0.0.1 --port 8000
|
||
```
|
||
|
||
后端启动后访问：
|
||
- API 文档：http://127.0.0.1:8000/docs
|
||
- 健康检查：http://127.0.0.1:8000/api/health
|
||
|
||
### 2. 启动前端
|
||
|
||
```bash
|
||
cd frontend
|
||
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
前端访问：http://localhost:1125
|
||
|
||
---
|
||
|
||
## 使用流程
|
||
|
||
### 日常使用（核心页面）
|
||
|
||
1. **人工选择**大盘周期（日线 / 4H / 1H）
|
||
2. **人工选择**大盘阶段（8 个固定阶段）
|
||
3. **人工选择**趋势强弱（强 / 弱 / 震荡）
|
||
4. 点击「执行前置匹配」
|
||
5. 系统自动输出：
|
||
- 交易类型（顺势 / 反转 / 观望）
|
||
- 允许开仓方向
|
||
- 可用账户列表
|
||
- 可用策略列表（含规则文本，仅展示）
|
||
|
||
### 系统配置中心
|
||
|
||
- **大盘管理**：增删改 8 个大盘阶段及交易方向
|
||
- **账户管理**：动态管理账户（本金、周期、风险比）
|
||
- **策略管理**：增删改策略及规则文本
|
||
- **匹配配置**：绑定「大盘周期 + 阶段 + 强弱」→ 账户 + 策略 + 方向
|
||
|
||
---
|
||
|
||
## 匹配逻辑（默认规则）
|
||
|
||
| 大盘阶段 | 趋势强弱 | 匹配策略 | 方向 |
|
||
|---------|---------|---------|------|
|
||
| 上涨初期/中期 | 强 | 箱体顺势突破 | 做多 |
|
||
| 上涨初期/中期 | 弱 | 斐波回调 | 做多 |
|
||
| 上涨末期 | 强/弱 | 手工主观 | 做空 |
|
||
| 下跌初期/中期 | 强 | 箱体顺势突破 | 做空 |
|
||
| 下跌初期/中期 | 弱 | 斐波回调 | 做空 |
|
||
| 下跌末期 | 强/弱 | 手工主观 | 做多 |
|
||
| 宽幅震荡末期 | 强/弱 | 收敛结构突破 | 多空均可 |
|
||
| 宽幅震荡 | 任意 | **全部禁用** | 禁止 |
|
||
| 任意阶段 | 震荡 | **全部禁用** | 观望 |
|
||
|
||
---
|
||
|
||
## API 接口
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| GET | `/api/regimes` | 获取大盘阶段列表 |
|
||
| POST/PUT/DELETE | `/api/regimes` | 增删改大盘阶段 |
|
||
| GET | `/api/accounts` | 获取账户列表 |
|
||
| POST/PUT/DELETE | `/api/accounts` | 增删改账户 |
|
||
| GET | `/api/strategies` | 获取策略列表 |
|
||
| POST/PUT/DELETE | `/api/strategies` | 增删改策略 |
|
||
| GET | `/api/matches` | 获取匹配配置 |
|
||
| POST/PUT/DELETE | `/api/matches` | 增删改匹配配置 |
|
||
| GET | `/api/match` | **前置匹配**（核心接口） |
|
||
|
||
匹配接口参数：
|
||
```
|
||
GET /api/match?market_cycle=日线&market_regime_id=1&trend_strength=强
|
||
```
|
||
|
||
---
|
||
|
||
## 数据库表
|
||
|
||
| 表名 | 说明 |
|
||
|------|------|
|
||
| `market_regime` | 大盘阶段（名称、交易类型、允许方向） |
|
||
| `account` | 账户（名称、本金、周期、风险比、启用状态） |
|
||
| `strategy` | 策略（名称、适用周期/强弱、规则文本） |
|
||
| `regime_match` | 匹配绑定（阶段+周期+强弱 → 账户+策略+方向） |
|
||
|
||
建表 SQL 见 `backend/init_db.sql`，也可通过后端启动自动创建。
|
||
|
||
---
|
||
|
||
## 约束说明
|
||
|
||
1. **黑色极简** UI，左右分栏布局
|
||
2. **SQLite 持久化**，重启不丢数据
|
||
3. **无登录**，纯本地部署
|
||
4. **账户/策略/匹配规则** 全部可动态增删改
|
||
5. **严格禁止**：自动 K 线识别、自动箱体判断、自动下单、交易所对接、币种输入、点位计算、突破条件校验
|
||
6. 策略规则文本**仅作展示**，系统不做任何自动校验
|
||
|
||
---
|
||
|
||
## 重置数据库
|
||
|
||
删除 `backend/data/pretrade.db` 后重启后端，系统将自动重建并写入默认数据。
|
||
|
||
---
|
||
|
||
## 生产部署
|
||
|
||
服务器部署（Ubuntu + PM2 + root + `/opt`）详见 **[DEPLOY.md](./DEPLOY.md)**。
|
||
|
||
一键部署：
|
||
|
||
```bash
|
||
git clone https://git.bz121.com/dekun/crypto-pre-trade-system.git /opt/crypto-pre-trade-system
|
||
cd /opt/crypto-pre-trade-system
|
||
bash deploy/install.sh
|
||
```
|
||
|
||
部署完成后访问：**http://\<服务器IP\>:1125**
|