fix bugs
Some checks failed
continuous-integration/drone/push Build is failing

This commit is contained in:
2025-12-11 16:56:19 +08:00
parent ab69968bda
commit 5b806e29b7
45 changed files with 13744 additions and 6364 deletions

127
doc/README.md Normal file
View File

@@ -0,0 +1,127 @@
# 武术赛事管理系统 - 文档中心
> 本目录包含项目的所有技术文档,按模块和版本组织
## 📁 文档目录结构
```
doc/
├── README.md # 文档中心首页(本文件)
├── schedule/ # 编排模块文档
│ ├── README.md # 编排模块文档索引
│ ├── schedule-complete-guide.md # 编排系统完整指南(最新版本)
│ ├── versions/ # 历史版本
│ │ ├── v1.0/
│ │ │ └── schedule-complete-guide-v1.0.md
│ │ ├── v1.1/
│ │ │ └── schedule-complete-guide-v1.1.md
│ │ └── CHANGELOG.md # 版本更新日志
│ └── archive/ # 已废弃的旧文档
│ ├── schedule-system-analysis.md
│ ├── schedule-system-design.md
│ └── ...
├── registration/ # 报名模块文档
│ ├── README.md
│ └── registration-performance-optimization.md
├── image/ # 文档图片资源
│ └── ...
└── templates/ # 文档模板
└── feature-doc-template.md
```
## 📚 主要文档
### 编排模块
| 文档名称 | 版本 | 更新日期 | 说明 |
|---------|------|----------|------|
| [编排系统完整指南](./schedule/schedule-complete-guide.md) | v1.0 | 2025-12-10 | **主文档** - 编排系统的完整技术方案 |
| [编排模块索引](./schedule/README.md) | - | 2025-12-10 | 编排模块所有文档的导航 |
### 报名模块
| 文档名称 | 版本 | 更新日期 | 说明 |
|---------|------|----------|------|
| [报名性能优化](./registration/registration-performance-optimization.md) | v1.0 | 2025-12-10 | 报名功能的性能优化方案 |
## 🔄 文档版本管理规范
### 版本号规则
- **主版本号 (Major)**: 重大功能变更或架构调整,如 v1.0 → v2.0
- **次版本号 (Minor)**: 功能新增或优化,如 v1.0 → v1.1
- **修订号 (Patch)**: 文档修正、补充说明,如 v1.0.1 → v1.0.2
### 版本更新流程
1. **修改文档内容**
- 直接在主文档中修改(如 `schedule-complete-guide.md`
- 更新文档头部的版本信息和更新日志
2. **发布新版本**
- 将当前主文档复制到 `versions/vX.X/` 目录
- 更新 `versions/CHANGELOG.md` 记录变更
- 更新模块的 `README.md` 索引
3. **归档废弃文档**
- 将不再维护的旧文档移到 `archive/` 目录
- 在文档顶部添加 **已废弃** 标记
### 示例
```bash
# 当前版本: v1.0
doc/schedule/schedule-complete-guide.md
# 发布 v1.1 版本
1. 复制 schedule-complete-guide.md → versions/v1.0/schedule-complete-guide-v1.0.md
2. 修改 schedule-complete-guide.md 内容(版本号改为 v1.1
3. 更新 versions/CHANGELOG.md
4. 更新 schedule/README.md
```
## 📝 文档编写规范
### 文档命名
- 使用小写字母和连字符
- 格式: `{模块名}-{文档类型}.md`
- 例如: `schedule-complete-guide.md`, `registration-api-spec.md`
### 文档头部信息
每个文档都应包含以下头部信息:
```markdown
# 文档标题
> **版本**: vX.X.X
> **创建日期**: YYYY-MM-DD
> **最后更新**: YYYY-MM-DD
> **文档作者**: 作者名
> **状态**: 草稿 / 审核中 / 已发布 / 已废弃
```
### 文档目录
- 使用 `## 目录` 章节
- 每个一级标题对应一个锚点
- 保持目录结构清晰
## 🔗 相关资源
- [项目Git仓库](https://github.com/your-org/martial-system)
- [API接口文档](http://localhost:8123/doc.html)
- [数据库文档](./database/schema.md)
- [开发规范](./development-standards.md)
## 📧 文档反馈
如发现文档问题或有改进建议,请:
1. 提交 Issue: [GitHub Issues](https://github.com/your-org/martial-system/issues)
2. 联系开发团队: dev@example.com
---
**文档中心最后更新**: 2025-12-10