74 lines
2.4 KiB
Markdown
74 lines
2.4 KiB
Markdown
|
# P1-04: 排查流程图文档化
|
|||
|
|
|
|||
|
|
## 任务概述
|
|||
|
|
|
|||
|
|
| 项目 | 内容 |
|
|||
|
|
|------|------|
|
|||
|
|
| 需求ID | #86 |
|
|||
|
|
| 优先级 | P1 |
|
|||
|
|
| 状态 | ✅ 已完成 |
|
|||
|
|
| 预估工时 | 3h |
|
|||
|
|
| 完成时间 | 2026-07-06 |
|
|||
|
|
|
|||
|
|
## 背景
|
|||
|
|
|
|||
|
|
排查流程图目前存储在数据库中（JSON 格式），通过管理后台的流程图编辑器进行维护。需要创建文档说明其数据结构和使用方式。
|
|||
|
|
|
|||
|
|
## 实施方案
|
|||
|
|
|
|||
|
|
创建综合故障排查指南文档，涵盖常见问题的排查步骤。
|
|||
|
|
|
|||
|
|
## 已创建文档
|
|||
|
|
|
|||
|
|
### [标准故障排查手册](../09-部署运维/00-标准故障排查手册.md)（原 13-故障排查指南已并入）
|
|||
|
|
|
|||
|
|
包含以下章节：
|
|||
|
|
|
|||
|
|
1. **服务访问问题**
|
|||
|
|
- 页面 500 错误排查
|
|||
|
|
- 502 Bad Gateway 排查
|
|||
|
|
|
|||
|
|
2. **登录认证问题**
|
|||
|
|
- 企微 OAuth 登录失败
|
|||
|
|
- Token 过期
|
|||
|
|
- 坐席 OTP 验证失败
|
|||
|
|
|
|||
|
|
3. **消息通信问题**
|
|||
|
|
- 消息发送失败
|
|||
|
|
- WebSocket 断连
|
|||
|
|
|
|||
|
|
4. **后端服务问题**
|
|||
|
|
- 后端启动失败
|
|||
|
|
- 数据库连接失败
|
|||
|
|
|
|||
|
|
5. **数据库问题**
|
|||
|
|
- 数据库迁移失败
|
|||
|
|
- 数据查询慢
|
|||
|
|
|
|||
|
|
6. **前端显示问题**
|
|||
|
|
- 静态资源 404
|
|||
|
|
- 头像不显示
|
|||
|
|
|
|||
|
|
## 验收标准
|
|||
|
|
|
|||
|
|
- [x] 明确任务范围
|
|||
|
|
- [x] 创建相应文档
|
|||
|
|
|
|||
|
|
## 实施步骤
|
|||
|
|
|
|||
|
|
1. ✅ 调研现有流程图存储方式
|
|||
|
|
2. ✅ 确认任务范围（选项 A：创建故障排查指南）
|
|||
|
|
3. ✅ 创建文档（已并入 [标准故障排查手册](../09-部署运维/00-标准故障排查手册.md)）
|
|||
|
|
|
|||
|
|
## 2026-07-07 整合增强 (v1.0)
|
|||
|
|
|
|||
|
|
原 9 份故障排查散落文档（快速诊断-500 / 服务器端跑诊断 / 13-故障排查指南 / 04+12 修复记录 / 502-BadGateway / 通讯链路诊断方案 / deploy/02-故障排查 / 03-调试验证指南）已合并为 **`09-部署运维/00-标准故障排查手册.md`(v1.0)** 作为唯一入口，9 份源文档删除、13 处断链修复、mkdocs.yml 新增「故障排查」导航分区。
|
|||
|
|
|
|||
|
|
手册新增内容（相对初版）：
|
|||
|
|
- §0 文档说明 + **验证完成硬规则**（宣布修复前必须提供真实浏览器截图/端到端证据）
|
|||
|
|
- §1 三步隔离决策树（nginx 可达性 → 后端直连 → Redis PING）
|
|||
|
|
- §4 案例库新增 **CASE-20260707-01**（管理后台登录"网络连接失败" = Redis 密码 URL 解析挂起）
|
|||
|
|
- §5 端到端验证标准（并入调试验证指南）
|
|||
|
|
|
|||
|
|
> 经验固化：项目 MEMORY.md「⚠️ 生产环境地雷」+「故障排查文档（单一入口）」；用户级 Skill `deploy-troubleshoot`；用户级 MEMORY.md「验证完成硬规则」。
|