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
This commit is contained in:
@@ -0,0 +1,72 @@
|
||||
# 审批类型扩展、卡片直跳与同窗口导航改造 — 部署完成
|
||||
|
||||
## 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(已有,已发布) |
|
||||
Reference in New Issue
Block a user