Files
wecom_it_smart_desk/docs/01-产品文档/06-审批与待办/进度-REQ-004-ITSM工单跳转-v1.0.md
T

81 lines
2.3 KiB
Markdown
Raw Normal View History

# IT智能服务台 - ITSM工单跳转项目进度追踪
> **项目**: ITSM 工单跳转交互优化
> **子系统**: 06-审批与待办
> **模块**: 工单跳转
> **REQ编号**: REQ-审批-004
> **项目名**: itsm_jump_optimization
> **更新日期**: 2026-07-19
> **项目负责人**: 待填写
---
## 一、整体进度
| 状态 | 数量 | 说明 |
|------|------|------|
| ✅ 已完成 | 1 | P0: 1项 |
---
## 二、需求完成状态
### P0 — Must Have
| ID | 需求 | 状态 | 备注 |
|----|------|------|------|
| REQ-004 | ITSM 工单跳转交互优化 | ✅ 已完成 | 桥接页 + 扫码登录 |
---
## 三、根因分析记录
1. 移动端首页在企微 webview 内会静默完成企微 OAuth,把 ITSM 后端会话"预热"出来
2. Web 版只认已温热的会话:会话在→免登录;会话不在(冷 hit)→ 跳扫码页
3. 原两步流(首页→点 Web 深链)免登录,是因为首页那一步已把会话预热
4. 桥接页 trick 在跨域场景下被 ITSM 拒绝,无法复用首页会话
---
## 四、产品决策
在现有 ITSM 鉴权模型下,「一步直达」与「免登录」不可兼得。产品侧决策**保持现状**——卡片点击经桥接页跳转 Web 工单表单,首次访问 / 会话过期时出现的扫码登录**作为人机校验(Human-Machine Verification)环节保留**。
---
## 五、技术实现
### 交互流程
```
H5 审批卡片点击
└─> 桥接页 itsm-bridge.html?name=<URL编码服务名>
├─ 隐藏 iframe 加载移动端首页(尝试静默预热 ITSM 会话)
└─ 2.5s 后 top-level 跳转 Web 工单深链
├─ 会话已预热 → 直接打开工单表单(免登录)
└─ 会话未预热 → 扫码登录页(作为人机校验)
```
### 受影响范围
| 类别 | 模板数 | 跳转目标 |
|------|--------|---------|
| 运维平台(8个) | 8 | 桥接页 → Web 工单深链 |
| 企微审批(2个) | 2 | 企微审批流程 |
---
## 六、验收标准
- [x] 8 个运维平台卡片点击后经桥接页跳转 Web 工单
- [x] 首次访问/会话过期时出现扫码登录页
- [x] 企微审批卡片点击跳转企微审批流程
- [x] 桥接页加载时间 ≤ 3s
---
## 七、关联文档
- PRD: `PRD-REQ-审批-004-ITSM工单跳转-v1.0.md`
- 技术架构文档 §15.4.9