v3.1 + 批次0: 智能回复重构基线 - ApprovalMatcher + 关键词降级 + 文档速修 + v4.0任务书面化
This commit is contained in:
Simon
@@ -117,6 +117,8 @@
|
||||
|
||||
同一 corpid 下所有自建应用各自独立鉴权，用户在企微内打开任意应用 H5 页面时通过 OAuth2 `snsapi_base` 静默授权自动完成登录。从 IT 服务台 H5 点击运维平台审批链接时，运维平台走自己的 OAuth2 流程拿到 `userid` 并自动登录。前提：运维平台已配置可信域名和 OAuth2 回调。
|
||||
|
||||
> **⚠️ 限制补充（2026-07-17）**：上述"免登录"结论**不适用于 Web ITSM 工单深链**。`devops.dc.servyou-it.com/ITSM/...` 是独立 Web 应用，不满足 `snsapi_base` 静默授权前提，冷访问必弹扫码。详见下方 §v2.3 增量需求与技术架构文档 §15.4.9。
|
||||
|
||||
#### 关联文档
|
||||
|
||||
| 文档 | 位置 |
|
||||
@@ -129,6 +131,52 @@
|
||||
|
||||
---
|
||||
|
||||
### v2.3 增量需求（2026-07-17）— ITSM 工单跳转交互优化
|
||||
|
||||
#### 背景
|
||||
|
||||
v2.2 将 8 个运维平台（ITSM）审批卡片改为 Web 工单深链 `http://devops.dc.servyou-it.com/ITSM/workflow/service/createTicket?name=XXX` 一步直达。企微内实测发现 Web ITSM 深链**不支持静默企微 OAuth**，冷访问会被重定向到扫码登录页。
|
||||
|
||||
#### 根因分析
|
||||
|
||||
- 移动端首页 `itsm.servyou.com.cn/itsm-miniapp-mobile/` 在企微 webview 内会静默完成企微 OAuth，把 ITSM 后端会话"预热"出来（即使过期也静默重登）。
|
||||
- Web 版 `devops.dc.servyou-it.com/ITSM/...` 只认已温热的会话：会话在→免登录；会话不在（冷 hit）→ 跳扫码页。
|
||||
- 原两步流（首页→点 Web 深链）免登录，是因为**首页那一步已把会话预热**，并非 Web 深链自身能续登。
|
||||
- 尝试用桥接页（我方域名 `itsm-bridge.html` 隐式加载首页预热 + 自动跳深链）补回预热步骤，实测**仍弹扫码**：ITSM 在跨域 iframe 场景下拒绝静默 OAuth 预热，桥接 trick 失效。
|
||||
|
||||
#### 产品决策
|
||||
|
||||
在现有 ITSM 鉴权模型下，「一步直达」与「免登录」不可兼得。产品侧决策**保持现状**——卡片点击经桥接页跳转 Web 工单表单，首次访问 / 会话过期时出现的扫码登录**作为人机校验（Human-Machine Verification）环节保留**，是企业安全合规可接受的二次身份确认，不视为功能缺陷。
|
||||
|
||||
#### 交互逻辑（8 个运维平台模板）
|
||||
|
||||
```
|
||||
H5 审批卡片点击
|
||||
└─> 桥接页 itsm-bridge.html?name=<URL编码服务名>（我方 https 域名）
|
||||
├─ 隐藏 iframe 加载移动端首页（尝试静默预热 ITSM 会话）
|
||||
└─ 2.5s 后 top-level 跳转 Web 工单深链 createTicket?name=<服务名>
|
||||
├─ 会话已预热 → 直接打开工单表单（免登录）
|
||||
└─ 会话未预热 → ITSM 扫码登录页（作为人机校验，扫码后进入表单）
|
||||
```
|
||||
|
||||
#### 技术限制（摘要，详见技术架构文档 §15.4.9）
|
||||
|
||||
1. Web ITSM (`devops.dc.servyou-it.com`) 深链不支持静默企微 OAuth，冷访问必弹扫码。
|
||||
2. 移动端首页 (`itsm.servyou.com.cn/itsm-miniapp-mobile/`) 在企微 webview 内可静默 OAuth 预热会话，但作为独立 SPA 无 SPA fallback，深链子路由 404，只能落到首页。
|
||||
3. 桥接页 iframe 预热在跨域场景下被 ITSM 拒绝，无法复用首页会话。
|
||||
4. 深链为 `http://` 明文，个别企微版本对 HTTPS 页内嵌 HTTP 混合内容有限制。
|
||||
|
||||
#### 受影响范围
|
||||
|
||||
| 类别 | 模板 | 跳转目标 |
|
||||
|------|------|---------|
|
||||
| 运维平台（8 个，走桥接页） | IT设备升级与硬件维修、IT资产升级、员工零信任（原VPN）账号申请、商业软件服务申请、终端设备网络准入申请、活动与会议技术支持、员工IT支持与故障报修、公共邮箱账号申请 | 桥接页 → Web 工单深链 |
|
||||
| 企微审批（2 个，不在本改造范围） | IT资产领用 (asset_receive)、IT资产借用 (asset_borrow) | 企微审批流程（非 ITSM） |
|
||||
|
||||
> 注：IT资产领用 / IT资产借用 属企微审批流程，非 ITSM，本次未改动；其跳转逻辑以 `approval_templates.json` 数据源定义为准。
|
||||
|
||||
---
|
||||
|
||||
## 四、知识库迭代补充需求
|
||||
|
||||
### 4.1 背景
|
||||
@@ -169,6 +217,7 @@
|
||||
| v1.1 | ✅ 已上线 | 敏感词检测、token修复、扫码登录优化 |
|
||||
| v1.2 | ✅ 已上线 | 知识库迭代修复、生产痛点缓解 |
|
||||
| v2.2 | ✅ 已上线 | 审批卡片改造：12种/18流程、URL直跳、同窗口导航、Dify v2 |
|
||||
| v2.3 | ✅ 已上线 | ITSM 工单跳转交互优化：桥接页一步直达 + 扫码登录定为人机校验 |
|
||||
|
||||
---
|
||||
|
||||
@@ -183,4 +232,4 @@
|
||||
|
||||
---
|
||||
|
||||
> **最后更新**: 2026-07-10 - 整合PRD主文档与增量需求
|
||||
> **最后更新**: 2026-07-17 - 新增 §v2.3 ITSM 工单跳转交互优化（桥接页 + 扫码登录定为人机校验）
|
||||
|
||||
Reference in New Issue
Block a user