AlphaFuturesProMax/DEPLOY.md

# 智能期货期权分析系统 - 部署指南

## 系统架构

```
┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
│     Nginx       │──────▶   前端 (React)  │      │   后端 (NestJS) │
│   (反向代理)    │      │    Port: 80     │      │   Port: 3000    │
└─────────────────┘      └─────────────────┘      └────────┬────────┘
                                                          │
                              ┌─────────────────┐        │
                              │   PostgreSQL    │◀───────┤
                              │   Port: 5432    │        │
                              └─────────────────┘        │
                              ┌─────────────────┐        │
                              │     Redis       │◀───────┘
                              │   Port: 6379    │
                              └─────────────────┘
```

## 快速开始

### 方式一：Docker Compose (推荐)

```bash
# 1. 克隆代码
git clone <repository-url>
cd AlphaFuturesProMax

# 2. 设置环境变量
cp app/server/.env.example app/server/.env
# 编辑 .env 文件，设置必要的配置

# 3. 启动服务
docker-compose up -d

# 4. 查看日志
docker-compose logs -f backend

# 5. 停止服务
docker-compose down
```

### 方式二：手动部署

#### 1. 环境要求

- Node.js 20+
- PostgreSQL 15+
- Redis 7+

#### 2. 后端部署

```bash
# 进入后端目录
cd app/server

# 安装依赖
npm install

# 设置环境变量
cp .env.example .env
# 编辑 .env 配置数据库连接等信息

# 执行数据库迁移
npx prisma migrate deploy

# 生成Prisma客户端
npx prisma generate

# 导入种子数据
npx prisma db seed

# 启动服务
npm run start:prod
```

#### 3. 前端部署

```bash
# 进入前端目录
cd app

# 安装依赖
npm install

# 设置API地址
# 编辑 .env.production 文件
VITE_API_BASE_URL=http://your-api-server:3000/api/v1
VITE_WS_URL=http://your-api-server:3000/market

# 构建
npm run build

# 部署到Nginx
# 将 dist 目录复制到Nginx的web目录
```

## 环境变量配置

### 后端环境变量 (.env)

```bash
# 应用配置
NODE_ENV=production
PORT=3000

# 数据库
DATABASE_URL=postgresql://user:password@localhost:5432/futures_analysis

# Redis
REDIS_URL=redis://localhost:6379

# JWT密钥 (生产环境必须修改!)
JWT_SECRET=your-super-secret-key-change-this

# OpenAI (可选，用于AI分析)
OPENAI_API_KEY=your-openai-key
```

### 前端环境变量 (.env.production)

```bash
VITE_API_BASE_URL=http://api.yourdomain.com/api/v1
VITE_WS_URL=http://api.yourdomain.com/market
```

## API文档

启动后端服务后，访问以下地址查看API文档：

```
http://localhost:3000/docs
```

## 功能清单

### ✅ 已实现功能

#### 后端功能
- [x] 用户认证系统 (JWT)
- [x] 行情数据服务 (REST + WebSocket)
- [x] 技术指标计算 (MACD, RSI, KDJ, BOLL, SAR, OBV, DMI, CCI, WR)
- [x] 期权分析模块 (Black-Scholes定价、希腊值、波动率曲面)
- [x] AI智能分析 (支持OpenAI API)
- [x] 热点事件管理
- [x] 自选股功能
- [x] 价格预警系统

#### 前端功能
- [x] 市场概览仪表盘
- [x] 品种筛选和搜索
- [x] K线图展示 (含MACD、成交量)
- [x] 热点事件分析
- [x] 风险提醒

### 🚧 待实现功能

- [ ] 交易信号系统
- [ ] 量化策略回测
- [ ] 移动端APP
- [ ] 管理后台

## 监控和维护

### 查看服务状态

```bash
# Docker方式
docker-compose ps

# 查看日志
docker-compose logs -f [service-name]
```

### 数据库备份

```bash
# Docker方式
docker-compose exec postgres pg_dump -U futures_user futures_analysis > backup.sql

# 恢复
docker-compose exec -T postgres psql -U futures_user futures_analysis < backup.sql
```

## 常见问题

### 1. 端口冲突

编辑 `docker-compose.yml` 修改端口映射：

```yaml
services:
  backend:
    ports:
      - "3001:3000"  # 修改为3001
```

### 2. 数据库连接失败

检查 `DATABASE_URL` 是否正确，确保PostgreSQL服务已启动。

### 3. 前端无法访问API

检查前端环境变量 `VITE_API_BASE_URL` 是否正确配置。

## 生产环境建议

1. **安全**
   - 修改默认的JWT密钥
   - 启用HTTPS
   - 配置防火墙规则

2. **性能**
   - 启用Redis缓存
   - 配置CDN加速静态资源
   - 数据库索引优化

3. **监控**
   - 配置日志收集 (ELK/Loki)
   - 设置告警规则
   - 监控API响应时间

## 技术栈

- **前端**: React 18 + TypeScript + Vite + Tailwind CSS + shadcn/ui
- **后端**: NestJS + TypeScript
- **数据库**: PostgreSQL 15
- **缓存**: Redis 7
- **部署**: Docker + Docker Compose