Files

T

claude_dev 4ebbd434a6 docs(archive): 过期文档归档波——14 件墓碑+台账补全+两轮审计报告入库 [nas]

- 归档 12 件(git mv 保历史,audit/20261001_docs_audit/ §2.1 判定):
  deployment/{vps-native-brain,windows-bridge-setup,d-phase-windows-deploy,README}
  (miniQMT/FastAPI-bridge 退役架构,09-08)+vps-deploy-pending(一次性任务使命
  终结)+specs/phase3b-vue(里程碑已兑现)+plans/{phase3c-paper-trading,
  backtest-result-page,strategy-management-backend,factor-batch1}(已完成/被
  实态推翻)+design/provider-mcp-expose(未实施行号全失效)+research/README
  (死模板)
- 原位墓碑 2 件: sanguo_qmt_bridge/README(包内保留,运维语义退役)+
  CHANGELOG(冻结,变更历史以 git log 为准)
- 台账: audit/README 补 5 波次表+状态列+固定安全清单约定(每波必查凭据/
  鉴权面/CI 门禁 diff——历轮审计系统性盲区,docs_audit §5.2);docs/README
  索引对齐归档后实态(+design/audit 行)
- 审计报告入库: 20260927_commit_docs_consistency+20261001_architecture_
  code_audit+20261001_docs_audit 三目录

Co-Authored-By: Claude Code <notify@anthropic.com>

2026-10-01 09:08:29 +08:00

3.7 KiB

Raw Blame History

⚠️ 已归档（2026-10-01，audit/20261001_docs_audit/ §2.1 归档波）

归档原因：死索引：只收录 2 篇漏 9 篇+三处链接指向不存在目录；权威索引已被 docs/README.md（09-27 重写）取代。

现行权威：docs/README.md（文档中心索引）。

处置：已移入 docs/archive/；原文全文见 git 历史（归档 commit 前一版）。

部署文档

本目录包含 Sanguo VeighNa 平台的部署相关文档。

文档列表

Docker 部署

docker-deployment.md - Docker 容器部署指南
- 前置要求和安装
- 快速开始步骤
- 配置说明
- 生产部署建议

Synology NAS 部署

synology-nas.md - Synology NAS 专用部署指南
- NAS 环境配置
- 数据持久化设置
- 自动备份配置
- 故障排除

快速链接

部署方式对比

方式	适用场景	难度	推荐度
Docker Compose	开发/测试/小规模部署	简单	⭐⭐⭐⭐⭐
Synology NAS	家庭 NAS 部署	中等	⭐⭐⭐⭐
Kubernetes	大规模/高可用部署	复杂	⭐⭐⭐

部署检查清单

硬件要求满足（内存、存储）
Docker/Docker Compose 已安装
网络端口已开放
数据目录已创建
环境变量已配置
SSL 证书已准备（生产环境）
备份策略已制定

配置文件

环境变量示例

# 数据目录
DATA_DIR=/volume1/docker/stock/sanguo_vnpy

# 端口配置
HTTP_PORT=8000
WS_PORT=8080

# 时区
TZ=Asia/Shanghai

# 日志级别
VNPY_LOG_LEVEL=INFO

# 安全配置
JWT_SECRET_KEY=your-secure-secret-key

目录结构

{DATA_DIR}/
├── data/           # 数据库和数据文件
├── logs/           # 运行日志
├── config/         # 配置文件
├── temp/           # 临时文件
├── redis/          # Redis 持久化
└── nginx/          # Nginx 相关

数据备份

重要提示

所有重要数据都存储在配置的 DATA_DIR 中，请确保：

备份命令

# 创建备份
tar czf vnpy_backup_$(date +%Y%m%d).tar.gz {DATA_DIR}

# 恢复备份
tar xzf vnpy_backup_YYYYMMDD.tar.gz -C /

故障排除

常见问题

容器无法启动
- 检查端口占用: netstat -tulpn | grep :8000
- 查看日志: docker-compose logs vnpy
数据丢失
- 确保使用绑定挂载
- 检查 DATA_DIR 配置
性能问题
- 调整资源限制
- 增加 Worker 数量

部署历史

Phase 1 后端部署 (2026-07-04)

部署内容：

✅ 修复 VeighNa 模块加载问题
✅ 修复循环导入问题
✅ 成交监控 API (4 个端点)
✅ 资金监控 API (3 个端点)
✅ 全局配置 API (2 个端点)

部署文件：

sanguo_web/api/__init__.py - 注册新路由
sanguo_web/api/deps.py - 修复循环导入
sanguo_web/services/main_service.py - 添加 offset 和 gateway_name 字段
sanguo_web/api/routes/trades.py - 成交监控路由
sanguo_web/api/routes/accounts.py - 资金监控路由
sanguo_web/api/routes/settings.py - 全局配置路由
run_web.py - 添加 vnpy_v4.4.0 路径

备份位置： ~/.sanguo_projects/sanguo_vnpy_v2/backup_20260704_170319/

验证结果：

总路由数：52
Trades 路由：4 个
Accounts 路由：3 个
Settings 路由：2 个

最后更新: 2026-07-04

3.7 KiB Raw Blame History Unescape Escape