docs: 建立完整的项目文档体系
- 创建6大文档分类:需求/设计/API/用户指南/运维/研究 - 添加各目录的 README 和模板说明 - 定义文档命名规范和编写规范 - 建立文档与代码的对应关系 文档目录结构: ├── requirements/ - 业务需求、功能需求、非功能需求 ├── design/ - 架构设计、数据库设计、UI设计、集成设计 ├── api/ - REST API、事件定义、内部接口 ├── user_guide/ - 快速开始、教程、FAQ ├── operations/ - 部署、监控、故障排查 └── research/ - 因子研究、策略研究、回测报告 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
+109
@@ -0,0 +1,109 @@
|
||||
# Sanguo VeighNa 文档中心
|
||||
|
||||
本目录包含项目的完整文档体系。
|
||||
|
||||
## 📚 文档目录
|
||||
|
||||
### 1. 需求文档 (`requirements/`)
|
||||
业务需求、功能需求和非功能需求的存放位置。
|
||||
|
||||
- **business/** - 业务需求文档 (BRD)
|
||||
- **functional/** - 功能需求文档和用户故事
|
||||
- **non_functional/** - 非功能需求(性能、安全等)
|
||||
|
||||
**查看详情**: [requirements/README.md](requirements/README.md)
|
||||
|
||||
---
|
||||
|
||||
### 2. 设计文档 (`design/`)
|
||||
技术架构和详细设计文档。
|
||||
|
||||
- **architecture/** - 系统架构设计
|
||||
- **database/** - 数据库设计
|
||||
- **ui/** - 界面设计和原型
|
||||
- **integration/** - 接口和集成设计
|
||||
|
||||
**查看详情**: [design/README.md](design/README.md)
|
||||
|
||||
---
|
||||
|
||||
### 3. API 文档 (`api/`)
|
||||
接口定义和 API 规范。
|
||||
|
||||
- **rest/** - REST API 文档
|
||||
- **event/** - 事件定义和说明
|
||||
- **internal/** - 内部接口定义
|
||||
|
||||
**查看详情**: [api/README.md](api/README.md)
|
||||
|
||||
---
|
||||
|
||||
### 4. 用户指南 (`user_guide/`)
|
||||
面向终端用户的使用文档。
|
||||
|
||||
- **quick_start/** - 快速开始指南
|
||||
- **tutorials/** - 详细教程
|
||||
- **faq/** - 常见问题
|
||||
|
||||
**查看详情**: [user_guide/README.md](user_guide/README.md)
|
||||
|
||||
---
|
||||
|
||||
### 5. 运维文档 (`operations/`)
|
||||
系统部署、监控和故障排查。
|
||||
|
||||
- **deployment/** - 部署文档
|
||||
- **monitoring/** - 监控指标和告警
|
||||
- **troubleshooting/** - 故障排查手册
|
||||
|
||||
**查看详情**: [operations/README.md](operations/README.md)
|
||||
|
||||
---
|
||||
|
||||
### 6. 量化研究 (`research/`)
|
||||
因子、策略和回测报告。
|
||||
|
||||
- **factors/** - 因子研究文档
|
||||
- **strategies/** - 策略说明文档
|
||||
- **backtests/** - 回测报告
|
||||
|
||||
**查看详情**: [research/README.md](research/README.md)
|
||||
|
||||
---
|
||||
|
||||
## 📝 文档规范
|
||||
|
||||
### 命名规范
|
||||
|
||||
| 类型 | 格式 | 示例 |
|
||||
|-----|------|------|
|
||||
| 业务需求 | `brd-XXX.md` | `brd-001-平台概述.md` |
|
||||
| 功能需求 | `feature-XXX-模块-功能.md` | `feature-001-gateway-ctp.md` |
|
||||
| 设计文档 | `system-名称.md` | `system-交易核心.md` |
|
||||
| API 文档 | `gateway-接口名.md` | `gateway-ctp-api.md` |
|
||||
| 用户文档 | `主题.md` | `installation.md` |
|
||||
|
||||
### 编写规范
|
||||
|
||||
1. 使用 Markdown 格式
|
||||
2. 代码块指定语言
|
||||
3. 添加必要的图表和示例
|
||||
4. 保持与代码同步更新
|
||||
5. 使用中文编写,技术术语保留英文
|
||||
|
||||
---
|
||||
|
||||
## 🔗 快速链接
|
||||
|
||||
- [开发指南](development.md)
|
||||
- [项目 README](../README.md)
|
||||
- [变更日志](../CHANGELOG.md)
|
||||
- [Gitea 仓库](http://192.168.2.154:3000/sanguo/sanguo_vnpy_v2)
|
||||
|
||||
---
|
||||
|
||||
## 📋 文档更新记录
|
||||
|
||||
| 日期 | 文档 | 变更说明 |
|
||||
|-----|------|---------|
|
||||
| 2025-07-01 | 全部 | 初始化文档体系 |
|
||||
Reference in New Issue
Block a user