wecom_it_smart_desk/docs/08-历史归档/文档分类与清理报告.md

文档分类与清理报告

生成日期: 2026-07-04 | 维护人: 助理（小米） 执行状态: ✅ 已执行（2026-07-04 02:05）

---

一、文档统计

类别	数量	说明
当前有效文档	~40	正在使用的主文档
已归档文档	37	已移至 archive，需保留参考
原型文件	5 当前 + 17 归档	保留当前使用版本
证书文件	0	已删除（敏感）
总计	~95

---

二、文档分类结构

2.1 推荐的目录结构

docs/
├── 01-项目总览/           # 项目介绍、架构
│   ├── 01-项目总览与部署手册.md  (主文档)
│   ├── PRD.md                  (产品需求)
│   └── IT智能服务台-技术架构设计.md
│
├── 02-运维手册/           # 部署、运维、监控
│   ├── 智能IT服务系统运维手册.md  (主文档)
│   ├── deploy/                   (部署相关)
│   │   ├── 快速诊断-500-错误.md
│   │   ├── HOTFIX-ROLLBACK-PLAN.md
│   │   ├── 服务器端跑诊断.md
│   │   └── set-real-ip-patch.md
│   └── SOPs/                    (标准操作流程)
│       ├── SOP-001-Gitea部署.md
│       ├── SOP-002-Gitea备份恢复.md
│       ├── SOP-003-推送评审.md
│       └── SOP-004-应急响应.md
│
├── 03-产品设计/           # 产品方案、原型
│   ├── 邀请功能-技术方案.md
│   ├── 摇人-多坐席协作-技术方案.md
│   ├── 消息功能详细方案.md
│   ├── OTP二次验证实现.md
│   └── H5用户端右侧栏动态推送评估.md
│
├── 04-集成分析/           # 第三方系统集成
│   ├── 火绒终端安全系统集成分析.md
│   ├── 联软终端安全系统集成分析.md
│   ├── aTrust零信任系统集成分析.md
│   └── ExternalSystemAdapter设计文档.md
│
├── 05-项目管理/           # 任务、看板、评审
│   ├── 小组任务书/
│   │   ├── 任务执行状态看板.md
│   │   ├── 01-小组A-认证加固组-计划任务书.md
│   │   ├── 02-小组B-消息系统组-计划任务书.md
│   │   ├── 03-小组C-AI与数据组-计划任务书.md
│   │   ├── D-T19-知识图谱数据模型设计.md
│   │   ├── D-T20-Dify集成方案.md
│   │   └── A-T12-集成测试报告.md
│   ├── 评审报告/
│   ├── 路线图/
│   └── 项目任务状态报告_2026-06-13.md
│
├── 06-审计安全/           # 安全、审计
│   ├── 安全/
│   │   └── secret-管理.md
│   ├── 安全审计报告.md
│   ├── 前端审计报告.md
│   └── 审计报告/
│       ├── CORS-CSP-安全Header全套.md
│       ├── Dockerfile优化与镜像审计.md
│       ├── 依赖漏洞扫描与Lockfile审计.md
│       └── 健康检查+错误码+日志结构化.md
│
├── 07-团队与流程/         # 团队、流程文档
│   ├── ADRs/                      (架构决策记录)
│   │   ├── ADR-001-Gitea自托管-Funnel暴露.md
│   │   ├── ADR-002-WS-Token-Subprotocol鉴权.md
│   │   ├── ADR-003-nginx-access_log关闭.md
│   │   └── ADR-004-Token不入文件-走wincred.md
│   ├── 风险跟踪表.md
│   ├── 资源申请清单.md
│   ├── 项目开发任务调整建议-20260611.md
│   └── 并行开发启动通知.md
│
├── 08-发布记录/           # 版本、发布
│   ├── RELEASE_NOTES_v0.7.1.md
│   ├── RELEASE_NOTES_v0.5.0-beta.md
│   ├── 智能IT支持服务台-版本更新说明-20250614.md
│   └── 智能IT支持服务台-项目迁移文档.md
│
├── 09-参考模板/           # 参考文档、模板
│   ├── 调试验证指南_2026-06-13.md
│   ├── E2E-CHECKLIST-v0.7.0.md
│   ├── 数据库ER图与环境变量清点.md
│   ├── 域名申请邮件-itsupport-servyou-com-cn.md
│   ├── Gitea部署指南.md
│   └── 团队沟通文档-架构消息知识库.md
│
├── 10-图表/               # Mermaid 图表
│   └── diagrams/
│
├── 11-原型/               # HTML 原型
│   ├── prototypes/
│   │   ├── h5-user-wecom-style-v2-desktop.html  (当前H5桌面版)
│   │   ├── h5-user-wecom-style-v2-mobile.html   (当前H5移动版)
│   │   ├── agent-workspace-v5_4.html           (当前坐席版)
│   │   ├── admin-dashboard-v1.html              (当前管理后台)
│   │   ├── invite-flow-v1.html                  (邀请功能)
│   │   └── archive/                            (历史版本)
│   └── dashboard.html
│
├── archive/               # 已归档（历史版本）
│
└── 智能IT服务系统运维手册.md  (运维入口文档)

---

三、重复/冲突内容识别

3.1 功能重复

文档A	文档B	重复内容	建议
01-项目总览与部署手册.md	IT智能服务台-技术架构设计.md	部分架构描述重复	保留 01-项目总览，后者移至 archive
deploy/服务器端跑诊断.md	deploy/快速诊断-500-错误.md	部分诊断步骤重复	整合到运维手册
项目任务状态报告_2026-06-13.md	小组任务书/任务执行状态看板.md	任务状态内容重复	保留看板，报告移至 archive
路线图/阶段2-3-任务.md	路线图/阶段4-5-规划.md	路线图内容	合并到 路线图/ 统一管理
评审报告/workbuddy-2026-06-14-消息优化.md	评审报告/workbuddy-2026-06-14-消息优化-P1二次评审.md	同一主题评审	保留最新版本

3.2 版本重复

文档	说明	建议
RELEASE_NOTES_v0.7.1.md	v0.7.1 版本发布说明	保留
RELEASE_NOTES_v0.5.0-beta.md	v0.5.0 测试版说明	移至 archive
智能IT支持服务台-版本更新说明-20250614.md	2025年06月14日版本说明	移至 archive

3.3 过时内容

文档	问题	建议
IT服务台部署修复记录-2026-06-13.md	历史修复记录，已过时效	移至 archive
项目全面评估报告-2026-06-25.md	阶段性评估报告	移至 archive
aTrust零信任系统集成分析.md	分析报告，未实际实施	保留（供参考）
调试验证指南_2026-06-13.md	阶段性验证指南	移至 archive

3.4 原型版本过多

目录	数量	说明
prototypes/	17 个	包含多个版本号（v1_1, v1_2...）
prototypes/archive/	5 个	已有归档目录

建议: 保留当前使用的版本（v2, v5_4 等），其余移至 archive

---

四、待清理清单

4.1 立即可删除（过期/已废弃）

文件	原因
docs/IT服务台部署修复记录-2026-06-13.md	历史记录，已过时效
docs/项目全面评估报告-2026-06-25.md	阶段性报告
docs/调试验证指南_2026-06-13.md	阶段性验证指南
docs/RELEASE_NOTES_v0.5.0-beta.md	旧版本发布说明
docs/智能IT支持服务台-版本更新说明-20250614.md	旧版本说明
docs/项目任务状态报告_2026-06-13.md	已被看板替代
docs/智能IT支持服务台-项目迁移文档.md	历史迁移文档
docs/现有系统交接文档内容.txt	交接内容（检查是否需要）

4.2 移至 archive（保留参考）

文件	原因
docs/IT智能服务台-技术架构设计.md	与 01-项目总览 部分重复
docs/消息功能详细方案.md	功能方案文档，可归档
docs/摇人-多坐席协作-技术方案.md	已实现，可归档
docs/邀请功能-技术方案.md	已实现，可归档
docs/OTP二次验证实现.md	已实现，可归档
docs/H5用户端右侧栏动态推送评估.md	评估报告，可归档
docs/ExternalSystemAdapter设计文档.md	设计文档，可归档
docs/项目开发任务调整建议-20260611.md	历史任务调整
docs/风险跟踪表.md	历史风险表
docs/前端审计报告.md	历史审计
docs/安全审计报告.md	历史审计
docs/团队沟通文档-架构消息知识库.md	历史沟通文档
docs/需求-发布预演页面.md	历史需求

4.3 证书文件处理

文件	位置	建议
servyou.com.cn (1)/	docs/	移动到安全位置或删除，不应放在代码库

4.4 原型整理

操作	目标
保留	h5-user-wecom-style-v2-desktop.html, h5-user-wecom-style-v2-mobile.html, agent-workspace-v5_4.html, admin-dashboard-v1.html, invite-flow-v1.html
移至 archive	其余所有带版本号的原型文件

---

五、待确认事项

请确认以下处理方式：

1. 证书文件 (servyou.com.cn (1)/) - 是否删除？
2. 过时文档 - 是否按建议移至 archive？
3. 原型文件 - 是否按建议整理？
4. 目录结构调整 - 是否按新结构重组？

---

六、清理后的目标结构

docs/                          # 约 30-35 个核心文档
├── 01-项目总览/
├── 02-运维手册/
├── 03-产品设计/
├── 04-集成分析/
├── 05-项目管理/
├── 06-审计安全/
├── 07-团队与流程/
├── 08-发布记录/
├── 09-参考模板/
├── 10-图表/
├── 11-原型/
├── archive/                  # 约 40-50 个归档文档
└── 智能IT服务系统运维手册.md  (入口)

---

七、执行计划

确认后，我将按以下顺序执行：

1. 删除证书文件
2. 移动过时文档到 archive
3. 整理原型文件
4. 创建/更新分类目录说明文档
5. 更新 MEMO 文件

---

维护人: 助理（小米） 下次评审: 每次版本发布时