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
4.3 KiB
4.3 KiB
审批类型扩展、卡片直跳与同窗口导航改造 — 部署完成
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 种)
- 会议室故障报修
- 企业应用管理
- 资产变更确认
- 终端设备网络准入
- 活动与会议技术支持
- 员工IT支持与故障报修
- 公共邮箱账号申请
本次导航改造说明
用户提出审批页面应"内嵌打开带有返回和关闭"。经技术验证:
- 企微审批 URL 未设
X-Frame-Options,理论上可被 iframe 嵌入; - 但 H5 生产环境配置了
Cross-Origin-Embedder-Policy: require-corp+ CSPdefault-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_backendhealthy,wecom_it_nginxrunning
用户下一步建议
登录 Dify 后台粘贴 System Prompt→ 已完成- 在企微 H5 中输入类似"我要申请会议室维修"/"公共邮箱怎么开"/"资产变更"等触发审批卡片,确认点击卡片项后在当前 webview 内跳转到审批页面,并可用企微顶部返回按钮回到 IT 服务台。
- 如需真正的自定义返回/关闭覆盖层(方案 B),需评估是否放宽 H5 的 COEP/CSP 安全头;这会影响安全级别,需单独决策。
- 保留
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(已有,已发布) |