# Docker Web 版本部署需求

## 1. 需求概述

将 VeighNa 4.4.0 量化交易平台部署到 NAS 的 Docker 容器中，通过 Web 浏览器远程访问所有功能。

## 2. 业务背景

### 2.1 场景描述
- 用户需要在 NAS 上部署量化交易平台
- 通过 Web 浏览器远程访问和管理
- 支持 24 小时运行策略交易

### 2.2 目标用户
- 量化交易员
- 策略开发者
- 系统管理员

## 3. 功能需求

### 3.1 核心功能
| 功能 | 描述 | 优先级 |
|-----|------|-------|
| Web UI | 完整的 VeighNa Trader 界面 | P0 |
| 策略管理 | CTA策略配置和运行 | P0 |
| 行情显示 | K线图和实时行情 | P0 |
| 交易功能 | 下单、撤单、查询 | P0 |
| 账户管理 | 多账户支持 | P1 |
| 数据管理 | 历史数据查询和管理 | P1 |
| 回测功能 | 策略回测 | P2 |
| RPC 服务 | 远程调用接口 | P1 |

### 3.2 Web 访问
- HTTPS 支持
- 基本认证（用户名/密码）
- 会话管理
- 响应式设计（支持移动端）

### 3.3 部署要求
- Docker 容器化部署
- 支持常见 NAS（Synology/QNAP/群晖）
- 数据持久化
- 配置外部化
- 日志可访问

## 4. 非功能需求

### 4.1 性能
| 指标 | 要求 |
|-----|------|
| Web 响应时间 | <2 秒 |
| 行情延迟 | <500ms |
| 并发用户 | ≥5 |
| 内存占用 | <2GB |

### 4.2 可靠性
- 容器自动重启
- 数据定期备份
- 异常日志记录
- 崩溃恢复

### 4.3 安全性
- 访问认证
- 数据加密（HTTPS）
- API 密钥管理
- 网络隔离

### 4.4 可维护性
- 一键部署
- 配置简单
- 日志集中
- 监控接口

## 5. 技术约束

### 5.1 环境约束
- NAS 系统：Synology DSM / QNAP QTS
- Docker 版本：≥20.10
- 架构：x86_64 / ARM64

### 5.2 技术栈
- 基础镜像：Python 3.11+
- Web 框架：FastAPI + Vue.js
- 数据库：SQLite（可选升级到 PostgreSQL）
- 反向代理：Nginx / Traefik

## 6. 验收标准

### 6.1 功能验收
- [ ] Docker 镜像可成功构建
- [ ] 容器可正常启动
- [ ] Web 界面可访问
- [ ] 用户登录认证正常
- [ ] 策略可加载和运行
- [ ] 行情数据正常显示
- [ ] 交易功能正常工作

### 6.2 部署验收
- [ ] 在 NAS Docker 上成功部署
- [ ] 重启后自动恢复
- [ ] 数据持久化正常
- [ ] 日志可查看

## 7. 相关链接

- Issue: TBD
- 设计文档: ../design/deployment/docker-web-deployment.md
- 原始需求: 用户提出

## 8. 优先级说明

**P0** - 必须实现，否则无法使用
**P1** - 重要功能，第一迭代完成
**P2** - 增强功能，后续迭代优化