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