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-*/

docs/04-运维文档/部署运维/deploy/01-部署指南.md

@@ -0,0 +1,182 @@
+# 智能IT服务台 - 部署指南
+
+> **最后更新**：2026-07-05
+> **目标服务器**：`10.90.5.110`
+> **域名**：`itsupport.servyou.com.cn`
+
+---
+
+## 目录
+
+1. [部署流程](#一部署流程)
+2. [蓝绿部署](#二蓝绿部署)
+3. [故障排查](#三故障排查)
+4. [回滚方案](#四回滚方案)
+
+---
+
+## 一、部署流程
+
+### 1.1 前置条件
+
+| 条件 | 状态 | 验证命令 |
+|------|------|---------|
+| Linux 服务器 10.90.5.110 | ✅ 已确认 | - |
+| Docker 已安装 | ✅ 已确认 | `docker --version` |
+| 域名解析 | ✅ 已配置 | `nslookup itsupport.servyou.com.cn` |
+| 堡垒机可访问 | ✅ 已配置 | `ssh -p 2222 user@10.212.189.210` |
+
+### 1.2 快速部署命令
+
+```bash
+# 1. 进入部署目录
+cd /opt/wecom-it-desk
+
+# 2. 拉取最新代码（可选）
+git pull origin main
+
+# 3. 构建并启动
+docker compose up -d --build
+
+# 4. 检查状态
+docker ps
+```
+
+### 1.3 一键部署（生产环境）
+
+详见 [10-一键部署操作包-v0.7.0.md](./10-一键部署操作包-v0.7.0.md)
+
+### 1.4 部署后验证
+
+```bash
+# 检查容器状态
+docker ps
+
+# 检查 API 健康
+curl https://itsupport.servyou.com.cn/api/health
+
+# 检查日志
+docker logs wecom_it_backend --tail 50
+```
+
+---
+
+## 二、蓝绿部署
+
+### 2.1 什么是蓝绿部署
+
+蓝绿部署通过维护两套环境（Blue/Green）实现零停机部署和快速回滚。
+
+### 2.2 部署 Green 环境
+
+```bash
+cd /opt/wecom-it-desk
+
+# 构建并启动 Green 环境
+docker-compose -f docker-compose-green.yml up -d
+
+# 验证 Green 环境
+curl http://localhost:5002/health
+```
+
+### 2.3 切换流量
+
+```bash
+# 切换到 Green
+sed -i 's/wecom_it_backend:8000/wecom_it_backend_green:8000/' /opt/wecom-it-desk/nginx/nginx.conf
+docker restart wecom_it_nginx
+
+# 切换回 Blue（回滚）
+sed -i 's/wecom_it_backend_green:8000/wecom_it_backend:8000/' /opt/wecom-it-desk/nginx/nginx.conf
+docker restart wecom_it_nginx
+```
+
+### 2.4 端口说明
+
+| 端口 | 服务 |
+|------|------|
+| 80/443 | Nginx (生产入口) |
+| 5002 | Backend (Green) |
+| 5080 | Nginx (Green 测试) |
+
+---
+
+## 三、故障排查
+
+### 3.1 常见问题
+
+#### 502 Bad Gateway
+
+1. 检查后端容器是否运行
+   ```bash
+   docker ps | grep backend
+   ```
+
+2. 检查后端日志
+   ```bash
+   docker logs wecom_it_backend --tail 100
+   ```
+
+3. 重启后端
+   ```bash
+   docker restart wecom_it_backend
+   ```
+
+#### 500 错误
+
+详见 [标准故障排查手册](../00-标准故障排查手册.md)
+
+#### 通讯链路问题
+
+详见 [标准故障排查手册](../00-标准故障排查手册.md)
+
+### 3.2 健康检查
+
+```bash
+# 后端
+curl http://localhost:8000/health
+
+# Nginx
+curl http://localhost/api/health
+```
+
+---
+
+## 四、回滚方案
+
+### 4.1 紧急回滚
+
+如果部署后出现严重问题，立即执行：
+
+```bash
+# 1. 停止新版本容器
+docker stop wecom_it_backend_green
+
+# 2. 切换回原环境
+sed -i 's/wecom_it_backend_green:8000/wecom_it_backend:8000/' /opt/wecom-it-desk/nginx/nginx.conf
+docker restart wecom_it_nginx
+```
+
+### 4.2 版本回滚
+
+如需回滚到之前版本：
+
+```bash
+# 1. 停止当前版本
+docker stop wecom_it_backend
+
+# 2. 重新构建指定版本
+git checkout <版本标签>
+docker build -t wecom-it-desk-backend:<版本> ./backend
+
+# 3. 启动
+docker run -d --name wecom_it_backend wecom-it-desk-backend:<版本>
+```
+
+---
+
+## 相关文档
+
+- [10-一键部署操作包-v0.7.0.md](./10-一键部署操作包-v0.7.0.md)
+- [蓝绿部署指南.md](./蓝绿部署指南.md)
+- [标准故障排查手册](../00-标准故障排查手册.md)