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:
2026-07-01 21:13:44 +08:00
parent 8dd1cf326d
commit a37c43f691
7 changed files with 1127 additions and 0 deletions
+99
View File
@@ -0,0 +1,99 @@
# 需求文档目录
本目录用于存放项目各阶段的需求文档。
## 目录结构
```
requirements/
├── business/ # 业务需求
│ ├── brd-001.md # 业务需求文档
│ └── market-*.md # 市场调研文档
├── functional/ # 功能需求
│ ├── epic-*.md # 史诗级需求
│ ├── feature-*.md # 功能需求
│ └── story-*.md # 用户故事
└── non_functional/ # 非功能需求
├── performance.md # 性能需求
├── security.md # 安全需求
└── reliability.md # 可靠性需求
```
## 文档命名规范
| 类型 | 命名格式 | 示例 |
|-----|---------|------|
| 业务需求 | `brd-XXX.md` | `brd-001-平台概述.md` |
| 功能史诗 | `epic-XXX.md` | `epic-001-交易模块.md` |
| 功能需求 | `feature-XXX-模块-功能.md` | `feature-001-gateway-ctp.md` |
| 用户故事 | `story-XXX.md` | `story-001-订单撤单.md` |
| 接口需求 | `api-XXX.md` | `api-001-行情接口.md` |
## 文档模板
### 业务需求文档 (BRD) 模板
创建 `business/brd-template.md`
```markdown
# [项目名称] 业务需求文档
## 1. 项目背景
<!-- 项目背景和市场环境 -->
## 2. 业务目标
<!-- 量化的业务目标 -->
## 3. 目标用户
<!-- 用户画像和需求分析 -->
## 4. 业务范围
<!-- 在范围内/外 -->
## 5. 竞争分析
<!-- 竞品分析 -->
## 6. 成功指标
<!-- KPI定义 -->
```
### 功能需求文档模板
创建 `functional/feature-template.md`
```markdown
# [功能名称] 需求文档
## 需求概述
<!-- 一句话描述 -->
## 用户角色
<!-- 谁会使用这个功能 -->
## 功能描述
<!-- 详细功能说明 -->
## 验收标准
- [ ] 标准1
- [ ] 标准2
## 优先级
P0 / P1 / P2 / P3
## 依赖关系
<!-- 依赖的其他需求 -->
## 相关链接
- Issue: #xxx
- 设计文档: ../design/xxx.md
```
## 工作流程
```mermaid
graph LR
A[业务需求] --> B[功能分解]
B --> C[技术评审]
C --> D[排期开发]
D --> E[验收测试]
```