Files
Simon bea288e414 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
2026-07-11 23:13:10 +08:00

4.3 KiB
Raw Permalink Blame History

审批类型扩展、卡片直跳与同窗口导航改造 — 部署完成

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.vuehandleSelect 中, 两处的 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(已有,已发布)