claude_dev
918bbed0fc
- 修复 deps.py 中 get_vn_service 的引用错误 (vn_service.vn_service -> vn_service) - 移除登录页面上的明文密码提示 - 改进前端错误处理，避免数据加载失败导致登录显示错误
115 lines
2.5 KiB
Markdown
115 lines
2.5 KiB
Markdown
# 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** - 增强功能，后续迭代优化
|