simon/wecom_it_smart_desk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
7864ab404bcedfa95e86e9becebbec85311d6afa
wecom_it_smart_desk/docs/05-运营文档/02-用户手册/会话存档功能-操作手册.md
T
Simon 44e77dcb0e chore(docs): docs/ 目录全面重新编号 + 重组 
**重构前**（旧编号 02-11）：
- docs/02-产品需求/      → 00 产品规划/PRD
- docs/03-技术架构/      → 01-05 子目录散落
- docs/04-原型设计/      → 01-02 产品设计（HTML 原型）
- docs/05-原型设计/      → screens/
- docs/06-测试素材/      → 02-E2E / 03-功能 / 04-版本测试
- docs/07-项目管理/      → 任务说明书/日报/计划
- docs/08-安全审计/      → 审计报告
- docs/09-堡垒运维/      → toolbox / deploy
- docs/10-项目管理/      → 任务说明书（重复）
- docs/11-历史归档/      → deploy-nas-archived

**重构后**（新编号 00-07，语义化）：
- docs/00-产品开发流程与文档管理规范.md
- docs/00-版本迭代总览.md
- docs/01-产品文档/      （PRD/原型/认证/会话/AI 服务/坐席/集成）
- docs/02-技术文档/      （技术方案/架构图/重构记录/前端改造/实现配置）
- docs/03-测试文档/      （E2E/功能用例/版本报告/缺陷单）
- docs/04-运维文档/      （部署运维/运维指南）
- docs/05-运营文档/      （品牌推广/用户手册）
- docs/06-安全审计/      （审计报告）
- docs/07-项目管理/      （任务说明书/日报/计划/看板）

**净收益**：
- 目录编号与产品文档管理规范对齐（按文档阶段 01-07 编号）
- 消除 02-产品需求 与 10-项目管理 的编号重叠
- 子目录按文档类型分组（如 01-产品文档/00-产品规划、01-产品文档/01-认证与登录）
- 把运维/安全/项目管理从 0X 散落改为 04/06/07

合计 494 文件 + 78495 行 / - 14076 行
2026-08-03 18:46:55 +08:00

3.4 KiB
Raw Blame History

会话存档功能 - 操作手册

版本: v1.0 | 日期: 2026-07-15 | 状态: 已完成

1. 功能概述

会话存档功能用于管理 IT 智能服务台的会话历史数据，通过自动归档策略优化系统性能，同时满足合规审计需求。

1.1 核心特性

  • 自动归档：已结单会话超过 90 天自动标记为已归档
  • 分级存储：热数据（90天内）/ 冷数据（90天外）
  • 审计支持：管理后台可查看完整会话历史

2. 坐席端操作指南

2.1 历史会话显示规则

坐席端历史会话按以下规则显示：

层级 显示内容 位置
当前会话 活跃会话（排队/服务中/待关闭） 顶部"我的会话"
历史会话 ≤90天已结单会话 "历史会话"标签
更久历史 不显示 —

2.2 查看更早会话

问题：坐席端看不到 90 天前的历史会话

解决方案：

  1. 访问管理后台
  2. 进入「会话审计」页面
  3. 使用筛选功能查找历史会话

3. 管理后台操作指南

3.1 访问会话审计

URL: https://itsupport.servyou.com.cn/itadmin/
路径: 会话管理 → 会话审计

3.2 按归档状态筛选

  1. 进入会话审计页面
  2. 找到「归档」筛选下拉框
  3. 选择筛选条件：
    • 全部
    • 未归档
    • 已归档

3.3 查看归档会话详情

  1. 在会话列表中找到已归档的会话（显示「已归档」标签）
  2. 点击会话行查看详情
  3. 可查看完整的会话消息历史

3.4 筛选条件组合

场景 状态 归档 日期范围
查看所有历史会话 resolved 全部 —
查看近期会话 resolved 未归档 近90天
查看归档会话 resolved 已归档 90天前

4. 运维操作指南

4.1 定时任务配置

归档脚本通过 crontab 定时执行：

# 编辑 crontab
crontab -e

# 添加以下行（每天凌晨3点执行）
0 3 * * * cd /opt/wecom-it-desk/backend && python scripts/archive_sessions.py >> /var/log/itdesk-archive.log 2>&1

4.2 手动执行归档

# SSH 到服务器
ssh sxn@10.212.189.210

# 进入后端目录
cd /opt/wecom-it-desk/backend

# 执行归档脚本
python scripts/archive_sessions.py

4.3 查看归档日志

# 查看归档日志
tail -f /var/log/itdesk-archive.log

# 查看历史归档记录
cat /var/log/itdesk-archive.log | grep归档

4.4 日志示例

[2026-07-15 03:00:00] 开始执行会话归档任务...
[2026-07-15 03:00:00] 归档阈值: 90 天
[2026-07-15 03:00:00] 找到 15 个需要归档的会话
[2026-07-15 03:00:01] 成功归档 15 个会话
[2026-07-15 03:00:01] 归档时间: 2026-07-15T03:00:01+00:00

5. 常见问题

5.1 坐席端看不到历史会话

原因：会话已超过 90 天，已自动归档

解决：到管理后台查看

5.2 归档状态筛选不生效

检查：

  1. 确认筛选条件填写正确
  2. 尝试清除筛选条件查看全部

5.3 归档脚本执行失败

常见原因：

  1. 数据库连接失败
  2. Python 依赖缺失

解决：

  1. 检查数据库配置
  2. 确认已安装依赖：pip install -r requirements.txt

6. 版本历史

版本 日期 变更
v1.0 2026-07-15 初始版本
Reference in New Issue View Git Blame Copy Permalink