173 lines
6.3 KiB
Markdown
173 lines
6.3 KiB
Markdown
|
# 文档索引
|
|||
|
|
|
|||
|
|
> **版本**: v2.0 | **日期**: 2026-07-04 | **维护人**: 助理
|
|||
|
|
> **说明**: 本索引提供 docs/ 目录下所有文档的快速导航
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📚 文档目录结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
docs/
|
|||
|
|
├── 01-项目总览/ ← 核心文档（必读）
|
|||
|
|
├── 02-产品需求/ ← PRD、功能需求
|
|||
|
|
├── 03-技术架构/ ← 架构设计、ADR、图表
|
|||
|
|
├── 04-原型设计/ ← UI/UX原型
|
|||
|
|
├── 05-用户手册/ ← 用户指南
|
|||
|
|
├── 06-测试质量/ ← 测试文档
|
|||
|
|
├── 07-代码评审/ ← Code Review
|
|||
|
|
├── 08-安全审计/ ← 安全、集成分析
|
|||
|
|
├── 09-部署运维/ ← 部署、运维、故障排查
|
|||
|
|
├── 10-项目管理/ ← SOP、项目管理
|
|||
|
|
└── 11-历史归档/ ← 历史归档
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📋 核心文档（必读）
|
|||
|
|
|
|||
|
|
| 文档 | 路径 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| 项目总览与部署手册 | `01-项目总览/01-项目总览与部署手册-20260704.md` | 项目背景、架构、三阶段演进 |
|
|||
|
|
| 智能IT服务系统运维手册 | `01-项目总览/01-智能IT服务系统运维手册-20260704.md` | 部署、运维、故障处理 |
|
|||
|
|
| 项目知识库 | `01-项目总览/01-项目知识库-20260704.md` | 全量知识库汇总 |
|
|||
|
|
| 资源申请清单 | `01-项目总览/01-资源申请清单-20260704.md` | IT 资源申请记录 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📂 各目录文档清单
|
|||
|
|
|
|||
|
|
### 01-项目总览/
|
|||
|
|
|
|||
|
|
| 文档 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| `00-索引-20260704.md` | 本索引文档 |
|
|||
|
|
| `01-项目总览与部署手册-20260704.md` | v2.2，项目完整概览 |
|
|||
|
|
| `01-智能IT服务系统运维手册-20260704.md` | v1.0，统一运维手册 |
|
|||
|
|
| `01-资源申请清单-20260704.md` | IT 资源申请记录 |
|
|||
|
|
| `01-项目知识库-20260704.md` | 项目全量知识库 |
|
|||
|
|
| `01-IT智能服务台_项目汇报-20260704.html` | 项目汇报演示 |
|
|||
|
|
| `02-项目迁移文档-20260606.md` | 项目迁移文档 |
|
|||
|
|
| `03-项目全面评估报告-20260625.md` | 项目全面评估报告 |
|
|||
|
|
|
|||
|
|
### 02-产品需求/
|
|||
|
|
|
|||
|
|
| 文档 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| `02-产品需求文档PRD-v1.2-20260704.md` | 主 PRD 文档（v1.2，2026-07-04更新） |
|
|||
|
|
| `product-产品/v0.7.2-backlog-candidate-2026-06-24.md` | 需求候选池 |
|
|||
|
|
|
|||
|
|
### 03-技术架构/
|
|||
|
|
|
|||
|
|
| 目录/文档 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| `00-系统架构设计文档-v1.0.md` | 系统架构设计（v1.0） |
|
|||
|
|
| `01-ADRs-架构决策/` | 4 | 架构决策记录 |
|
|||
|
|
| `02-技术方案/` | 5 | 技术方案文档 |
|
|||
|
|
| `03-技术分析/` | 3 | 技术分析报告 |
|
|||
|
|
| `04-数据库设计/` | 1 | 数据库设计 |
|
|||
|
|
| `05-架构图/` | 9 | Mermaid 图表 |
|
|||
|
|
|
|||
|
|
### 04-原型设计/
|
|||
|
|
|
|||
|
|
| 子目录 | 文档数 | 说明 |
|
|||
|
|
|--------|--------|------|
|
|||
|
|
| `prototypes-原型图/` | 12 | 活跃原型图 |
|
|||
|
|
| `prototypes-原型图/archive/` | 17 | 历史版本 |
|
|||
|
|
|
|||
|
|
### 05-用户手册/
|
|||
|
|
|
|||
|
|
> 待添加用户手册
|
|||
|
|
|
|||
|
|
### 06-测试质量/
|
|||
|
|
|
|||
|
|
| 文档 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| `03-调试验证指南-20260613.md` | 调试验证指南 |
|
|||
|
|
| `testing-测试/E2E-CHECKLIST-v0.7.0.md` | E2E 验收清单 |
|
|||
|
|
| `testing-测试/TESTING_CALL_AGENT.md` | 呼叫坐席测试 |
|
|||
|
|
| `testing-测试/QA_COMPREHENSIVE_REPORT.md` | QA 综合报告 |
|
|||
|
|
|
|||
|
|
### 07-代码评审/
|
|||
|
|
|
|||
|
|
| 文档 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| `评审报告-代码评审/workbuddy-2026-06-14-P0安全.md` | P0 安全评审 |
|
|||
|
|
| `评审报告-代码评审/workbuddy-2026-06-14-消息优化.md` | 消息优化评审 |
|
|||
|
|
| `评审报告-代码评审/workbuddy-2026-06-14-消息优化-P1二次评审.md` | 消息优化二次评审 |
|
|||
|
|
| `评审报告-代码评审/workbuddy-2026-06-14-Gitea重建.md` | Gitea 重建评审 |
|
|||
|
|
| `评审报告-代码评审/workbuddy-2026-06-14-预检验证.md` | 预检验证评审 |
|
|||
|
|
| `评审报告-代码评审/workbuddy-2026-06-15-T组A组.md` | T组A组评审 |
|
|||
|
|
| `评审报告-代码评审/REVIEW_B_T10-消息可靠性增强.md` | B-T10 消息可靠性评审 |
|
|||
|
|
|
|||
|
|
### 08-安全审计/
|
|||
|
|
|
|||
|
|
| 子目录 | 文档数 | 说明 |
|
|||
|
|
|--------|--------|------|
|
|||
|
|
| `审计报告-安全审计/` | 3 | 安全审计报告 |
|
|||
|
|
| `集成分析-外部系统/` | 3 | 外部系统集成分析 |
|
|||
|
|
|
|||
|
|
### 09-部署运维/
|
|||
|
|
|
|||
|
|
| 文档 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| `deploy/03-RELEASE-NOTES-v0.7.1-20260623.md` | v0.7.1 发布说明 |
|
|||
|
|
| `deploy/04-部署修复记录-20260613.md` | 部署修复记录 |
|
|||
|
|
| `deploy/05-版本更新说明-v1.1.0-20260614.md` | 版本更新说明 v1.1.0 |
|
|||
|
|
| `deploy/06-OTP二次验证实现.md` | OTP 二次验证实现 |
|
|||
|
|
| `deploy/07-扫码登录OTP部署指南-v0.7.0.md` | 扫码登录OTP部署指南 |
|
|||
|
|
| `deploy/08-NAS部署指南-预生产.md` | NAS部署指南(预生产) |
|
|||
|
|
| `deploy/09-NAS部署指南-群晖Cloudflare.md` | NAS部署指南(群晖) |
|
|||
|
|
| `deploy/10-一键部署操作包-v0.7.0.md` | 一键部署操作包 |
|
|||
|
|
| `deploy/` | 7 | 部署文档 |
|
|||
|
|
| `troubleshooting-故障排查/` | 1 | 故障排查 |
|
|||
|
|
| `guides-用户指南/` | 1 | 用户指南 |
|
|||
|
|
|
|||
|
|
### 10-项目管理/
|
|||
|
|
|
|||
|
|
| 编号 | 文档 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| 01 | `01-任务总索引.md` | 任务管理文档体系总览 |
|
|||
|
|
| 02 | `02-风险跟踪表.md` | 风险登记册（22项） |
|
|||
|
|
| 03 | `03-项目任务状态报告.md` | 历史全量任务（152个） |
|
|||
|
|
| 04 | `04-项目开发任务调整建议.md` | 任务调整建议 |
|
|||
|
|
| 05 | `05-项目状态看板/01-项目状态看板.md` | 驾驶舱仪表盘 |
|
|||
|
|
| SOPs | `SOPs-标准流程/` | 4项标准操作流程 |
|
|||
|
|
|
|||
|
|
### 11-历史归档/
|
|||
|
|
|
|||
|
|
> 历史归档文档，包含 `-archived-日期` 后缀
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔗 快速链接
|
|||
|
|
|
|||
|
|
| 场景 | 推荐文档 |
|
|||
|
|
|------|---------|
|
|||
|
|
| 新人入职 | `01-项目总览/01-项目总览与部署手册-20260704.md` |
|
|||
|
|
| 部署上线 | `01-项目总览/01-智能IT服务系统运维手册-20260704.md` |
|
|||
|
|
| 故障排查 | `09-部署运维/troubleshooting-故障排查/` |
|
|||
|
|
| 代码评审 | `07-代码评审/评审报告-代码评审/` |
|
|||
|
|
| 安全合规 | `08-安全审计/` |
|
|||
|
|
| 运维操作 | `10-项目管理/SOPs-标准流程/` |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📝 文档更新规则
|
|||
|
|
|
|||
|
|
| 更新类型 | 同步要求 |
|
|||
|
|
|---------|---------|
|
|||
|
|
| 新增文档 | 添加到对应目录 + 本索引 |
|
|||
|
|
| 删除文档 | 从本索引移除 |
|
|||
|
|
| 移动文档 | 更新本索引路径 |
|
|||
|
|
| 重大变更 | 同步更新 `CHANGELOG.md` |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📅 版本历史
|
|||
|
|
|
|||
|
|
| 版本 | 日期 | 变更 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| v2.0 | 2026-07-04 | 目录结构重组，完成重命名 |
|
|||
|
|
| v1.0 | 2026-07-04 | 初始版本，索引创建 |
|