|
|
|
|
|
# Alpha Futures Pro 系统启动指南
|
|
|
|
|
|
|
|
|
|
|
|
本文档详细介绍了 Alpha Futures Pro 系统的启动方法、流程顺序和注意事项，帮助您快速部署和使用系统。
|
|
|
|
|
|
|
|
|
|
|
|
## 系统架构
|
|
|
|
|
|
|
|
|
|
|
|
- **前端**：React 19.x + Ant Design 6.x + Vite
|
|
|
|
|
|
- **后端**：Node.js 18.x + Express 4.x + TypeScript 5.x
|
|
|
|
|
|
- **数据源**：TQSDK、测试数据
|
|
|
|
|
|
- **API 接口**：后端运行在 `http://localhost:3007`
|
|
|
|
|
|
- **前端应用**：前端运行在 `http://localhost:5173`（或类似端口）
|
|
|
|
|
|
|
|
|
|
|
|
## 启动顺序
|
|
|
|
|
|
|
|
|
|
|
|
**必须按照以下顺序启动系统组件：**
|
|
|
|
|
|
|
|
|
|
|
|
1. **后端服务**（优先启动）
|
|
|
|
|
|
2. **前端服务**（后端启动后再启动）
|
|
|
|
|
|
|
|
|
|
|
|
## 详细启动流程
|
|
|
|
|
|
|
|
|
|
|
|
### 1. 启动后端服务
|
|
|
|
|
|
|
|
|
|
|
|
**步骤 1：进入后端目录**
|
|
|
|
|
|
```powershell
|
|
|
|
|
|
cd d:\workspace\AlphaFuturesPro\backend
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
**步骤 2：安装依赖**（首次启动时需要）
|
|
|
|
|
|
```powershell
|
|
|
|
|
|
npm install
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
**步骤 3：启动后端服务**
|
|
|
|
|
|
```powershell
|
|
|
|
|
|
npm run dev
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
**验证后端服务启动成功**：
|
|
|
|
|
|
- 终端显示 "服务器运行在 http://localhost:3007"
|
|
|
|
|
|
- 可以通过浏览器访问 `http://localhost:3007/api/config/get` 测试 API 是否正常响应
|
|
|
|
|
|
- 正常响应会返回系统配置的 JSON 数据
|
|
|
|
|
|
|
|
|
|
|
|
### 2. 启动前端服务
|
|
|
|
|
|
|
|
|
|
|
|
**步骤 1：进入前端目录**
|
|
|
|
|
|
```powershell
|
|
|
|
|
|
cd d:\workspace\AlphaFuturesPro
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
**步骤 2：安装依赖**（首次启动时需要）
|
|
|
|
|
|
```powershell
|
|
|
|
|
|
npm install
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
**步骤 3：启动前端服务**
|
|
|
|
|
|
```powershell
|
|
|
|
|
|
npm run dev
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
**验证前端服务启动成功**：
|
|
|
|
|
|
- 终端显示 Vite 服务器启动信息，通常运行在 `http://localhost:5173` 或类似端口
|
|
|
|
|
|
- 可以通过浏览器访问显示的 URL 进入系统
|
|
|
|
|
|
|
|
|
|
|
|
## 系统访问
|
|
|
|
|
|
|
|
|
|
|
|
- **主页**：`http://localhost:5173/`（市场概览）
|
|
|
|
|
|
- **管理配置**：`http://localhost:5173/admin`（系统配置界面）
|
|
|
|
|
|
- **自选合约**：`http://localhost:5173/watchlist`（自选合约列表）
|
|
|
|
|
|
- **详细分析**：`http://localhost:5173/detail/:code`（单个合约详细分析）
|
|
|
|
|
|
- **风险控制**：`http://localhost:5173/risk-control`（风险控制界面）
|
|
|
|
|
|
|
|
|
|
|
|
## 注意事项
|
|
|
|
|
|
|
|
|
|
|
|
1. **端口占用**：
|
|
|
|
|
|
- 后端默认使用端口 3007，如果被占用需要停止占用该端口的进程后重新启动
|
|
|
|
|
|
- 前端默认使用端口 5173，如果被占用会自动尝试其他端口
|
|
|
|
|
|
|
|
|
|
|
|
2. **依赖安装**：
|
|
|
|
|
|
- 首次启动或代码更新后，可能需要重新安装依赖
|
|
|
|
|
|
- 后端和前端的依赖需要分别安装
|
|
|
|
|
|
|
|
|
|
|
|
3. **配置文件**：
|
|
|
|
|
|
- 系统配置会保存在后端的配置文件中，修改配置后会自动生效
|
|
|
|
|
|
- 数据源配置（如 TQSDK 的用户名和密码）需要在管理配置界面中设置
|
|
|
|
|
|
|
|
|
|
|
|
4. **数据源连接**：
|
|
|
|
|
|
- TQSDK 需要正确配置用户名和密码才能获取数据
|
|
|
|
|
|
- 如果 TQSDK 连接失败，系统会自动使用测试数据（如果启用了测试数据源）
|
|
|
|
|
|
|
|
|
|
|
|
5. **网络连接**：
|
|
|
|
|
|
- 系统需要网络连接来获取外部数据（如 TQSDK 数据）
|
|
|
|
|
|
- 确保防火墙没有阻止系统的网络请求
|
|
|
|
|
|
|
|
|
|
|
|
## 常见问题排查
|
|
|
|
|
|
|
|
|
|
|
|
### 1. 后端服务启动失败
|
|
|
|
|
|
|
|
|
|
|
|
**症状**：终端显示错误信息，如 "Error: listen EADDRINUSE: address already in use"
|
|
|
|
|
|
|
|
|
|
|
|
**解决方案**：
|
|
|
|
|
|
- 检查端口 3007 是否被占用
|
|
|
|
|
|
- 停止占用该端口的进程
|
|
|
|
|
|
- 重新启动后端服务
|
|
|
|
|
|
|
|
|
|
|
|
### 2. 前端访问不通
|
|
|
|
|
|
|
|
|
|
|
|
**症状**：浏览器显示 "无法访问此网站" 或类似错误
|
|
|
|
|
|
|
|
|
|
|
|
**解决方案**：
|
|
|
|
|
|
- 检查后端服务是否正常运行
|
|
|
|
|
|
- 检查前端服务是否启动成功
|
|
|
|
|
|
- 确认访问的 URL 是否正确
|
|
|
|
|
|
|
|
|
|
|
|
### 3. 数据获取失败
|
|
|
|
|
|
|
|
|
|
|
|
**症状**：前端显示 "获取配置失败" 或 "数据加载失败" 等错误
|
|
|
|
|
|
|
|
|
|
|
|
**解决方案**：
|
|
|
|
|
|
- 检查后端服务是否正常运行
|
|
|
|
|
|
- 检查数据源配置是否正确
|
|
|
|
|
|
- 检查网络连接是否正常
|
|
|
|
|
|
- 尝试重启后端服务
|
|
|
|
|
|
|
|
|
|
|
|
### 4. 管理配置界面无法保存配置
|
|
|
|
|
|
|
|
|
|
|
|
**症状**：点击 "保存配置" 按钮后显示错误信息
|
|
|
|
|
|
|
|
|
|
|
|
**解决方案**：
|
|
|
|
|
|
- 检查后端服务是否正常运行
|
|
|
|
|
|
- 检查配置数据是否格式正确
|
|
|
|
|
|
- 尝试刷新页面后重新保存
|
|
|
|
|
|
|
|
|
|
|
|
## 技术支持
|
|
|
|
|
|
|
|
|
|
|
|
如果您在启动或使用系统过程中遇到问题，请检查上述文档内容。如果问题仍然存在，请联系技术支持团队获取帮助。
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
**文档版本**：v1.0
|
|
|
|
|
|
**最后更新**：2026-02-20
|
