feat: 2026-07-11 全量更新 - 代办集成+会议室预定+知识迭代修复+UI统一+Bug修复

== 已部署上线 (9项) ==
- 代办事项真实数据源集成 (企微审批API 8bug修复链)
- H5/坐席端 Logo样式统一+绿色背景
- 视频引导页修复 (localStorage key v2)
- 坐席端 v9 Vue版本修复 (ElMessage._context)
- 截图按钮 v10 修复 (getDisplayMedia user gesture)
- 扫码样式恢复+H5扫码登录跳转修复
- H5截图快捷键提示

== 代码完成待部署 (3项) ==
- 知识迭代3Bug修复 (#8 POST端点/#7 MERGE幂等/#6 过期检查)
- 会议室预定-小鱼易联终端 (40文件, 40/40测试通过)
- IT资产升级审批推送 (asset_service.py)

== 需求文档 (2项) ==
- 坐席端AI辅助消息框-PRD (4项新功能确认)
- 坐席端布局优化建议 v2.0 (7天计划)

== 新增文档 ==
- 日报-2026-07-11.md
- 知识迭代Bug修复报告-20260711.md
- 会议室预定-部署指南.md
- CHANGELOG.md 更新

== 测试 ==
- test_todo_integration.py: 40/40
- test_meetingroom.py: 40/40
- test_bugfix_ki_suggestions.py: 21/21
This commit is contained in:
Simon
2026-07-11 23:13:10 +08:00
parent 3d152fc8eb
commit bea288e414
928 changed files with 85169 additions and 54205 deletions
@@ -1,31 +0,0 @@
# 用户手册索引
> **版本**: v1.0 | **日期**: 2026-07-04
---
## 手册清单
| 手册 | 文件 | 说明 |
|------|------|------|
| 员工使用指南 | `01-员工使用指南.md` | 普通员工使用IT智能服务台的操作指南 |
| 坐席操作手册 | `02-坐席操作手册.md` | IT运维人员处理会话的操作指南 |
| 管理员手册 | `03-管理员手册.md` | 系统管理员配置管理的操作指南 |
---
## 快速导航
### 员工 → 查看 `01-员工使用指南.md`
### 坐席 → 查看 `02-坐席操作手册.md`
### 管理员 → 查看 `03-管理员手册.md`
---
## 更新日志
| 版本 | 日期 | 变更 |
|------|------|------|
| v1.0 | 2026-07-04 | 初始版本 |
@@ -1,109 +0,0 @@
# IT智能服务台 — 员工使用指南
> **版本**: v1.0 | **日期**: 2026-07-04 | **维护人**: 助理
---
## 目录
1. [系统简介](#1-系统简介)
2. [访问入口](#2-访问入口)
3. [发起咨询](#3-发起咨询)
4. [转人工服务](#4-转人工服务)
5. [查看历史记录](#5-查看历史记录)
6. [满意度评价](#6-满意度评价)
7. [常见问题](#7-常见问题)
---
## 1. 系统简介
IT智能服务台是公司为员工提供的IT问题一站式解决平台,具备以下能力:
| 功能 | 说明 |
|------|------|
| **智能问答** | AI自动回答常见IT问题 |
| **转人工服务** | 一键呼叫IT坐席获得人工帮助 |
| **问题跟踪** | 实时查看处理进度 |
| **满意度评价** | 服务结束后评价服务质量 |
---
## 2. 访问入口
### 2.1 企业微信入口
1. 打开企业微信
2. 点击底部「工作台」
3. 找到「IT智能服务台」应用
4. 点击进入
### 2.2 直接访问
如已获得授权,也可直接访问:https://itsupport.servyou.com.cn/itdesk/
---
## 3. 发起咨询
### 3.1 发送消息
1. 在对话框中输入您的问题
2. 点击发送按钮
3. AI将自动回答您的问题
### 3.2 上传文件
支持上传以下格式(2026-07-05起不再支持图片上传):
- 文件:doc、docx、pdf、xls、xlsx(单个文件≤10MB
---
## 4. 转人工服务
当AI无法解决您的问题时,您可以:
### 4.1 摇人按钮
- 点击输入框左侧的「摇人」按钮
- 系统将为您转接IT坐席
### 4.2 多次对话后自动转接
- 当与AI对话超过3轮仍未解决问题时
- 系统会自动提示是否需要转人工
---
## 5. 查看历史记录
- 在会话列表中查看历史咨询记录
- 点击任意历史会话可查看详情
---
## 6. 满意度评价
- 每次会话结束后
- 系统会弹出评分窗口
- 请根据实际体验给予1-5星评价
---
## 7. 常见问题
### Q1: 为什么会提示"转人工"
A: 当AI连续回复3次仍未能解决您的问题时,系统会自动提示转人工。您也可以随时点击"摇人"按钮主动转接人工服务。
### Q2: 上班时间没有坐席响应怎么办?
A: 请耐心等待,当前没有空闲坐席时,系统会为您排队。一旦有坐席接单,您将收到通知。
### Q3: 如何查看我的IT问题处理进度?
A: 在IT智能服务台首页,点击「我的工单」即可查看当前处理中的问题和历史记录。
---
*如有其他问题,请联系IT部门。*
@@ -1,169 +0,0 @@
# IT智能服务台 — 坐席操作手册
> **版本**: v1.0 | **日期**: 2026-07-04 | **维护人**: 助理
---
## 目录
1. [系统简介](#1-系统简介)
2. [访问入口](#2-访问入口)
3. [会话管理](#3-会话管理)
4. [回复用户](#4-回复用户)
5. [快速回复](#5-快速回复)
6. [转接与协作](#6-转接与协作)
7. [会话标记](#7-会话标记)
8. [结单处理](#8-结单处理)
9. [常见问题](#9-常见问题)
---
## 1. 系统简介
IT智能服务台坐席端是IT运维人员处理员工IT问题的工作台,具备以下能力:
| 功能 | 说明 |
|------|------|
| **会话列表** | 按紧急度排序的待处理会话 |
| **AI辅助** | AI推荐回复内容供参考 |
| **快速回复** | 常用语一键发送 |
| **摇人协作** | 邀请其他坐席协助处理 |
---
## 2. 访问入口
### 2.1 企业微信入口
1. 打开企业微信
2. 点击底部「工作台」
3. 找到「IT智能服务台」应用
4. 点击进入(系统自动识别坐席身份)
### 2.2 直接访问
如已获得授权,也可直接访问:https://itsupport.servyou.com.cn/itagent/
---
## 3. 会话管理
### 3.1 会话列表
会话列表按以下优先级排序:
| 优先级 | 说明 |
|--------|------|
| 🔴 紧急 | 需要立即处理 |
| 🟠 举手 | 用户主动呼叫坐席 |
| 🟡 需介入 | AI无法处理,等待人工 |
| 🟢 活跃 | 正在对话中 |
| 🔵 AI处理中 | AI正在回答 |
| ⚪ 已结单 | 已完成处理 |
### 3.2 接单
- 点击会话列表中的任意会话
- 即可开始处理
---
## 4. 回复用户
### 4.1 手动输入
1. 在底部输入框输入回复内容
2. 点击发送按钮
### 4.2 使用AI建议
- 右侧面板显示AI推荐回复
- 点击「采纳」直接使用
- 点击「编辑」修改后使用
- 点击「忽略」不使用
---
## 5. 快速回复
### 5.1 使用快速回复
1. 点击输入框上方的「快捷回复」按钮
2. 在弹出的列表中选择常用语
3. 点击后自动填充到输入框
### 5.2 管理快速回复
- 点击「管理」可添加/编辑/删除常用语
- 快速回复支持分类管理
---
## 6. 转接与协作
### 6.1 摇人(邀请协作)
当需要其他坐席协助时:
1. 点击会话详情中的「摇人」按钮
2. 选择要邀请的坐席
3. 发送邀请请求
### 6.2 接受邀请
- 收到邀请后,会话列表会显示提醒
- 点击即可加入协作会话
---
## 7. 会话标记
### 7.1 添加标签
- 在会话详情中点击「添加标签」
- 选择预设标签或自定义标签
### 7.2 预设标签
| 标签 | 说明 |
|------|------|
| 网络问题 | 网络连接相关 |
| 软件问题 | 软件使用相关 |
| 硬件问题 | 设备故障相关 |
| 账号问题 | 账号权限相关 |
| 其他 | 其他问题类型 |
---
## 8. 结单处理
### 8.1 结单
- 确认用户问题已解决后
- 点击「结单」按钮
- 系统将发送满意度评价邀请
### 8.2 结单注意事项
- 结单前确保用户问题已完全解决
- 如需后续跟进,可创建工单
---
## 9. 常见问题
### Q1: 会话列表不显示新会话?
A: 请检查网络连接,或点击刷新按钮手动刷新。
### Q2: AI建议不准确怎么办?
A: 可以点击「忽略」不使用AI建议,手动输入回复。您的反馈将帮助AI学习改进。
### Q3: 如何查看历史会话统计?
A: 在管理后台的「数据看板」中查看会话量、响应时间等统计信息。
---
*如有其他问题,请联系系统管理员。*
-215
View File
@@ -1,215 +0,0 @@
# IT智能服务台 — 管理员手册
> **版本**: v1.0 | **日期**: 2026-07-04 | **维护人**: 助理
---
## 目录
1. [系统简介](#1-系统简介)
2. [访问入口](#2-访问入口)
3. [坐席管理](#3-坐席管理)
4. [角色权限](#4-角色权限)
5. [系统配置](#5-系统配置)
6. [功能开关](#6-功能开关)
7. [数据看板](#7-数据看板)
8. [集成管理](#8-集成管理)
9. [安全设置](#9-安全设置)
10. [运维监控](#10-运维监控)
---
## 1. 系统简介
IT智能服务台管理后台是系统管理员的配置管理中心,主要功能包括:
| 功能 | 说明 |
|------|------|
| **坐席管理** | 添加、编辑、删除坐席账户 |
| **角色权限** | 配置RBAC细粒度权限 |
| **系统配置** | 业务参数设置 |
| **功能开关** | 控制功能上线/下线 |
| **数据看板** | 查看运营数据统计 |
| **集成管理** | 第三方系统对接配置 |
| **安全设置** | 认证、授权、审计配置 |
---
## 2. 访问入口
### 2.1 访问地址
管理后台访问地址:https://itsupport.servyou.com.cn/itadmin/
### 2.2 登录要求
- 仅限管理员角色访问
- 需要OTP二次验证(已绑定OTP的管理员)
---
## 3. 坐席管理
### 3.1 查看坐席列表
在「坐席管理」页面查看所有坐席账户:
| 列 | 说明 |
|----|------|
| 姓名 | 坐席显示名称 |
| 用户ID | 企业微信用户ID |
| 状态 | 在线/离线/忙碌 |
| OTP | 是否已绑定二次验证 |
| 添加时间 | 账户创建时间 |
### 3.2 添加坐席
1. 点击「添加坐席」按钮
2. 输入坐席信息(姓名、用户ID等)
3. 设置角色权限
4. 点击保存
### 3.3 编辑/删除坐席
- 点击坐席行的「编辑」可修改信息
- 点击「删除」可移除坐席(需确认)
---
## 4. 角色权限
### 4.1 角色类型
| 角色 | 说明 | 数据范围 |
|------|------|---------|
| 超级管理员 | 拥有全部权限 | 全部 |
| 坐席组长 | 管理本组坐席 | 本组数据 |
| 普通坐席 | 处理会话 | 负责的会话 |
| 审计员 | 仅查看数据 | 全部(只读) |
| 用户 | 普通员工 | 自己的会话 |
### 4.2 权限配置
每个角色可配置以下资源权限:
| 资源 | 操作 |
|------|------|
| 会话 | 查看、回复、结单、转接 |
| 用户 | 查看、编辑 |
| 坐席 | 查看、添加、编辑、删除 |
| 配置 | 查看、修改 |
| 数据 | 导出、统计 |
---
## 5. 系统配置
### 5.1 业务参数
| 参数 | 说明 | 默认值 |
|------|------|-------|
| AI转人工轮数 | AI回复多少轮后允许转人工 | 3轮 |
| 响应超时 | 坐席未响应超时时间 | 5分钟 |
| 会话保持时间 | 会话未活动自动结单时间 | 24小时 |
| 满意度评分 | 是否开启评分功能 | 开启 |
---
## 6. 功能开关
### 6.1 可控制的功能
| 功能组 | 功能 | 说明 |
|--------|------|------|
| queue_ | 排队系统 | 启用/禁用排队机制 |
| satisfaction_ | 满意度评价 | 启用/禁用评分功能 |
| invite_ | 邀请协作 | 启用/禁用摇人功能 |
| notification_ | 消息通知 | 启用/禁用企微推送 |
| security_ | 安全验证 | 启用/禁用OTP验证 |
### 6.2 操作
- 点击开关即可启用/禁用对应功能
- 状态变更即时生效
---
## 7. 数据看板
### 7.1 核心指标
| 指标 | 说明 |
|------|------|
| 会话总量 | 统计周期内的总会话数 |
| AI解决率 | AI直接解决问题的比例 |
| 平均响应时间 | 从会话创建到首次响应的平均时间 |
| 满意度评分 | 用户评价的平均分 |
### 7.2 趋势图
- 支持按日/周/月查看数据趋势
- 支持导出为Excel
---
## 8. 集成管理
### 8.1 已集成系统
| 系统 | 集成方式 | 状态 |
|------|---------|------|
| RAGFlow | API Key | 已配置 |
| Dify | API Key | 已配置 |
| 火绒安全 | AccessKey | 已配置 |
| 联软 | 账号密码 | 已配置 |
| aTrust | 待配置 | 待配置 |
### 8.2 配置集成
1. 选择要配置的系统
2. 输入对应的凭据信息
3. 点击「测试连接」验证
4. 保存配置
---
## 9. 安全设置
### 9.1 OTP管理
- 查看坐席OTP绑定状态
- 强制解绑OTP(管理员操作)
- 设置强制OTP策略
### 9.2 IP白名单
- 配置管理后台访问IP白名单
- 支持CIDR格式
### 9.3 操作审计
- 查看所有管理操作日志
- 支持按时间、操作类型筛选
---
## 10. 运维监控
### 10.1 系统健康
| 指标 | 状态 |
|------|------|
| 后端服务 | 正常/异常 |
| 数据库 | 正常/异常 |
| Redis | 正常/异常 |
| WebSocket | 正常/异常 |
### 10.2 日志查看
- 访问「日志查看」页面
- 按时间、级别筛选日志
- 支持下载日志文件
---
*如有其他问题,请联系系统开发团队。*