chore: docs 结构整改 + compose 双目录对齐（合并重建提交）

本提交为 .git 对象库损坏后的重建提交，内容等价于原先三个本地提交（5e2fd4c2 / 57a53c98 / 5d7e1873）的累积结果，未做任何额外改动。一、docs 结构整改（整改 #14）根因：重构时新结构为 untracked 文件，执行 git stash（未带 -u）未纳入，随后 git reset 拉回 HEAD 旧 tracked 树，导致旧树复活、新旧两棵目录树并存于 docs/，共 791 文件、双分类体系冲突。修复动作： - b2 同名异主题文件改名迁移保全 9 个 - C 类 39 个孤立文件按主题正确归类 - A/B1 类 222 个重复文件删除（新结构已有内容副本） - 9 个旧独有空目录删除 - 270 处内部引用按 verified 映射改写 - 整改记录 #14 登记于 04-运维文档/部署运维结果：docs 791 → 569 文件，顶层仅规范 8 类 + 治理文件，单树恢复。残留：约 20 处指向从未存在文件的陈旧死链，归入独立文档卫生任务。二、compose 双目录对齐（消除踩坑 A） - docker-compose.yml：nginx 前端挂载全部由根目录 frontend-*/dist 改为 src/frontend-*/dist（h5 / agent / admin / terminal） - docker-compose.dev.yml：dev 服务 build context 与卷同步改 src/ - 效果：本地 docker compose up 不再把根目录 stale dist 挂回，与线上一致，分叉隐患消除（已 docker compose config 校验通过）防复发铁律： - 重构须提交；仓库修复须 git stash -u 或先 commit - 新结构须 git add 并提交，避免再次 untracked 复活 - H5 改动只动 src/frontend-h5/，禁改根目录遗留 frontend-*/
2026-08-07 22:31:32 +08:00
parent 5a77a89ab1
commit facc04aa65
573 changed files with 129347 additions and 909 deletions
@@ -0,0 +1,111 @@
+# 测试质量文档分类索引
+
+> 本目录包含 IT 智能服务台项目的所有测试相关文档。按类型分类，便于查阅和维护。
+
+---
+
+## 📁 文档分类结构
+
+```
+docs/03-测试文档/
+├── 00-测试规范/              # 测试方法论、流程、规范
+│   └── 测试方法论指南.md
+│
+├── 01-综合报告/              # 合并汇总类报告
+│   └── QA_COMPREHENSIVE_REPORT.md
+│
+├── 02-E2E测试/               # 端到端测试
+│   ├── E2E-CHECKLIST-v0.7.0.md           # v0.7.0 验收清单（扫码登录+MFA）
+│   ├── 方案A-消息发送延时-E2E验证报告-20260708.md
+│   └── e2e-screenshots/                  # 截图证据
+│       ├── 01-login.png
+│       ├── 02-chat-after-login.png
+│       ├── 03-after-send-instant.png
+│       ├── 04-typewriter-mid.png
+│       ├── 05-final.png
+│       ├── 99-error.png
+│       ├── diag.txt
+│       └── e2e_result.json
+│
+├── 03-功能测试用例/          # 具体功能测试用例
+│   ├── TESTING_CALL_AGENT.md              # 呼叫坐席功能验证
+│   └── TC-REQ-认证-统一认证与登录-v1.0.md
+│
+├── 04-版本测试报告/          # 按日期/版本分类
+│   ├── OTP绑定-测试报告-20260708.md       # OTP 首次绑定测试
+│   ├── P0串联+P2可视化-测试报告-20260708.md
+│   ├── RBAC-BugFix-测试报告-20260707.md
+│   ├── Tier0-测试报告-20260708.md
+│   ├── Tier1-测试报告-20260708.md
+│   ├── 看板验真-测试报告-20260707.md
+│   └── 知识迭代Bug修复报告-20260711.md
+│
+└── README.md                   # 本文件
+```
+
+---
+
+## 📋 文档清单总览
+
+| 分类 | 文档名称 | 测试范围 | 状态 |
+|------|---------|---------|------|
+| **测试规范** | 测试方法论指南.md | 测试策略、方法、流程、数据管理、环境配置、CI/CD规范 | ✅ 生效中 |
+| **综合报告** | QA_COMPREHENSIVE_REPORT.md | P2/P3单元测试 + WebSocket + 坐席v5.3 | ✅ 通过 |
+| **E2E测试** | E2E-CHECKLIST-v0.7.0.md | 扫码登录 + MFA + P0/P1合规验证 | ✅ 通过 |
+| **E2E测试** | 方案A-消息发送延时-E2E验证报告 | WS打字机 + 发送即时性 | ✅ 通过 |
+| **功能测试** | TESTING_CALL_AGENT.md | 呼叫坐席功能（3次AI回复后出现按钮） | ✅ 通过 |
+| **功能测试** | TC-REQ-认证-统一认证与登录-v1.0.md | 企微免密 + 账号密码 + MFA | 📋 待执行 |
+| **版本报告** | OTP绑定-测试报告-20260708.md | 首次绑定 + 重置流程 | ✅ 通过 |
+| **版本报告** | Tier0-测试报告-20260708.md | 知识库迭代基础设施 | ✅ 通过 |
+| **版本报告** | Tier1-测试报告-20260708.md | API层 + 前端组件 | ✅ 通过 |
+| **版本报告** | P0串联+P2可视化-测试报告 | 会话关闭建议 + 知识图谱 | ✅ 通过 |
+| **版本报告** | RBAC-BugFix-测试报告 | admin_users装饰器修复 | ✅ 通过 |
+| **版本报告** | 看板验真-测试报告 | 5项存量功能验证 | ⚠️ 3/5通过 |
+| **版本报告** | 知识迭代Bug修复报告 | POST /suggestions + Neo4j MERGE | ✅ 通过 |
+
+---
+
+## 🏷️ 按标签分类
+
+### 身份认证 & 安全
+- `E2E-CHECKLIST-v0.7.0.md` — 扫码登录、MFA绑定与验证
+- `TC-REQ-认证-统一认证与登录-v1.0.md` — 企微免密、账号密码、OTP
+- `OTP绑定-测试报告-20260708.md` — 首次绑定、管理员重置
+- `RBAC-BugFix-测试报告-20260707.md` — 权限装饰器修复
+
+### 消息 & WebSocket
+- `方案A-消息发送延时-E2E验证报告-20260708.md` — 发送即时返回 + WS流式
+- `QA_COMPREHENSIVE_REPORT.md` — WebSocket 实时推送功能
+
+### 知识库 & AI
+- `Tier0-测试报告-20260708.md` — Neo4j、审批状态机、置信门控
+- `Tier1-测试报告-20260708.md` — Vision、RAGFlow、审批队列、知识迭代
+- `知识迭代Bug修复报告-20260711.md` — POST端点、Neo4j MERGE、过期检查
+
+### 业务功能
+- `TESTING_CALL_AGENT.md` — 呼叫坐席功能
+- `P0串联+P2可视化-测试报告-20260708.md` — 会话关闭建议、知识图谱可视化
+- `看板验真-测试报告-20260707.md` — 排队、AI Wingman、知识库、RBAC、敏感词
+
+---
+
+## 📊 测试统计汇总
+
+| 指标 | 数值 |
+|------|------|
+| 测试文档总数 | 12 |
+| 单元测试用例 | 200+ |
+| E2E 测试用例 | 50+ |
+| 总通过率 | ~95% |
+
+---
+
+## 🔗 关联文档
+
+- 技术架构：`../03-技术架构/`
+- 产品需求：`../02-产品需求/`
+- 项目管理：`../07-项目管理/看板/项目状态看板.md`
+
+---
+
+> 最后更新：2026-07-14 | 整理人：Duckula