# 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