Simon
bea288e414
== 已部署上线 (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
73 lines
4.3 KiB
Markdown
73 lines
4.3 KiB
Markdown
# 审批类型扩展、卡片直跳与同窗口导航改造 — 部署完成
|
||
|
||
## TL;DR
|
||
审批流程系统已从 5 种扩展到 **12 种审批类型 / 18 个审批流程**，H5 卡片点击可直接跳转对应审批 URL；为进一步贴合企微 H5 体验，已将跳转方式从 `window.open`（新标签页）改为 `window.location.href`（同窗口导航），由企微原生提供返回按钮。后端与前端代码修改均已部署到生产环境并通过验证。
|
||
|
||
## 交付概览
|
||
|
||
| 项目 | 状态 |
|
||
|------|------|
|
||
| 后端 `approval.py` 18 个模板 + 12 类关键词 | 已部署，API 验证通过 |
|
||
| 前端 H5 17 个审批卡片 + URL 直跳 | 已构建部署，页面可正常访问 |
|
||
| 审批卡片同窗口导航改造 | 已部署：两处 `window.open` 改为 `window.location.href` |
|
||
| 生产容器状态 | backend / nginx 均健康运行 |
|
||
| 浏览器端验证 | H5 登录页渲染正常，无 JS 报错 |
|
||
| 已知问题 / 遗留 | 无 |
|
||
| Dify System Prompt v2 | 已由用户在 Dify 后台发布 |
|
||
| 功能文档归档 | PRD v2.2 + 架构文档 v2.2 已更新 |
|
||
|
||
## 新增审批类型（7 种）
|
||
1. 会议室故障报修
|
||
2. 企业应用管理
|
||
3. 资产变更确认
|
||
4. 终端设备网络准入
|
||
5. 活动与会议技术支持
|
||
6. 员工IT支持与故障报修
|
||
7. 公共邮箱账号申请
|
||
|
||
## 本次导航改造说明
|
||
|
||
用户提出审批页面应"内嵌打开带有返回和关闭"。经技术验证：
|
||
- 企微审批 URL 未设 `X-Frame-Options`，理论上可被 iframe 嵌入；
|
||
- 但 H5 生产环境配置了 `Cross-Origin-Embedder-Policy: require-corp` + CSP `default-src 'self'`，跨域 iframe 会被安全头拦截；
|
||
- 在不修改 nginx 安全头的前提下，**方案 A（同窗口导航）**为可行方案。
|
||
|
||
改造点：
|
||
- `frontend-h5/src/components/chat/ApprovalCardModal.vue` 的 `handleSelect` 中，
|
||
两处的 `window.open(url, '_blank')` 全部改为 `window.location.href = url`；
|
||
- 移除跳转后的 `showToast` 提示（页面立即导航离开，toast 不可见）。
|
||
|
||
效果：在企微 H5 webview 中点击审批卡片项，会在当前 webview 内打开审批页面，企微原生顶部返回按钮负责返回 IT 服务台。
|
||
|
||
## 关键文件清单
|
||
|
||
### 新建文档
|
||
- `docs/02-产品需求/approval_templates.json` — 结构化审批模板数据
|
||
- `docs/02-产品需求/dify_approval_system_prompt_v2.md` — Dify System Prompt 更新文本
|
||
|
||
### 代码修改（已部署）
|
||
- `backend/app/api/approval.py` — 18 个模板、12 类关键词
|
||
- `frontend-h5/src/components/chat/ApprovalCardModal.vue` — 12 类卡片 + URL 直跳 + 同窗口导航
|
||
|
||
## 验证结果
|
||
- 容器内 `/approval/templates` 返回 **18 个模板**
|
||
- 容器内 `/approval/keywords` 返回关键词映射正确
|
||
- `agent-browser` 打开 `https://itsupport.servyou.com.cn/h5/` 正常渲染登录页
|
||
- nginx 容器内 `/h5/` 返回 301，前端文件已正确部署到 `/opt/wecom-it-desk/frontend-h5/dist/`
|
||
- 生产容器：`wecom_it_backend` healthy, `wecom_it_nginx` running
|
||
|
||
## 用户下一步建议
|
||
1. ~~登录 Dify 后台粘贴 System Prompt~~ → 已完成
|
||
2. 在企微 H5 中输入类似"我要申请会议室维修"/"公共邮箱怎么开"/"资产变更"等触发审批卡片，确认点击卡片项后**在当前 webview 内跳转**到审批页面，并可用企微顶部返回按钮回到 IT 服务台。
|
||
3. 如需真正的自定义返回/关闭覆盖层（方案 B），需评估是否放宽 H5 的 COEP/CSP 安全头；这会影响安全级别，需单独决策。
|
||
4. 保留 `docs/02-产品需求/approval_templates.json` 作为后续审批流程变更的数据源。
|
||
|
||
## 文档归档
|
||
|
||
| 文档 | 更新内容 |
|
||
|------|---------|
|
||
| `docs/02-产品需求/IT智能服务台-产品需求文档PRD-v2.md` | 新增 v2.2 增量需求（P2-07~P2-11），含 12种/18流程完整表格、企微免登录结论、关联文档索引 |
|
||
| `docs/03-技术架构/IT智能服务台-系统架构设计文档v2.md` | 15.4 节从 6 模板扩展到 12种/18流程；新增 15.4.4~15.4.8 共 5 个子节（意图识别架构、前端卡片架构、导航方案选型、跨应用免登录、API端点）；9.1 外部集成表新增运维平台条目；版本 +v2.2 |
|
||
| `docs/02-产品需求/approval_templates.json` | 18 个模板结构化数据（已有，无需修改） |
|
||
| `docs/02-产品需求/dify_approval_system_prompt_v2.md` | Dify System Prompt v2（已有，已发布） |
|