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
parent 3d152fc8eb
commit bea288e414
928 changed files with 85169 additions and 54205 deletions
@@ -0,0 +1,265 @@
+# 企微IT智能服务台 — 项目管理主文档
+
+> **版本**: v2.4 | **日期**: 2026-07-10 | **维护人**: 助理
+
+---
+
+## 一、项目状态总览
+
+> **一句话总览**：v0.7.1 已上线运行，生产稳定。知识库迭代 v0.7.2 全链路交付完成。
+
+### 已完成 (v0.7.1)
+- ✅ 企微入口 SSO
+- ✅ 管理后台 RBAC（6处装饰器修复）
+- ✅ 敏感词检测（隐私正则修复）
+- ✅ 扫码登录优化
+- ✅ 文档优化专项
+
+### v0.7.2 知识库迭代（全部交付）
+- ✅ AI 辅助功能增强
+- ✅ 排查流程优化
+- ✅ 知识库迭代
+
+### 版本迭代
+
+| 版本 | 状态 | 主要内容 | 日期 |
+|------|------|----------|------|
+| v0.7.0 | ✅ 已上线 | 企微SSO、MFA、RBAC | 2026-06 |
+| v0.7.1 | ✅ 已上线 | 敏感词检测、token修复、扫码登录优化 | 2026-07-04 |
+| v0.7.2 | ✅ 已完成 | backlog候选（AI辅助、排查流程，知识库迭代） | 2026-07+ |
+
+---
+
+## 二、任务管理文档体系
+
+本项目采用四级任务管理文档体系：
+
+| 级别 | 文档 | 用途 |
+|------|------|------|
+| L1 | **项目状态看板** | 驾驶舱仪表盘，当前正在做+待办 |
+| L2 | **项目任务状态报告** | 历史全量任务清单 |
+| L3 | **需求候选池** | 未来版本候选功能 |
+| L4 | **PRD需求池** | 完整需求来源 |
+
+---
+
+## 三、快速导航
+
+### 🔴 现在做什么？
+查看 **项目状态看板** 的「正在做」和「P0必做」区
+
+### 📜 历史全部任务？
+查看 **项目任务状态报告**
+
+### 📋 未来计划？
+查看 **需求候选池** (v0.7.2+)
+
+### 📖 需求来源？
+查看 **PRD需求文档**
+
+### 📅 每日工作记录？
+查看 `.workbuddy/memory/` 目录
+
+---
+
+## 四、项目状态看板
+
+### 正在做 (in_progress)
+
+| # | 任务 | 说明 |
+|---|---|---|
+| #91 | 忘记密码-企微扫码重置 | 坐席忘记密码时通过企微扫码验证后重置 |
+| #107 | 后端部署卷挂载改造 | 方案C：镜像烘焙→代码卷挂载，消除两份代码不同步根因 |
+
+### ✅ 已完成
+
+| # | 任务 | 说明 | 完成日期 |
+|---|---|---|---|
+| #111 | 坐席端消息头像不显示Bug | 🐛 后端消息接口未返回sender_avatar → Schema添加字段 + API填充员工/AI头像 + 前端显示 | 2026-07-10 |
+| #112 | 坐席端消息布局调整 | ✨ 头像和名字位置互换（头像在前、名字在后） | 2026-07-10 |
+| #113 | 审批类型扩展与卡片URL直跳 | ✨ 审批类型 5→12种/18流程，后端静态模板+关键词扩展，前端卡片12类17选项URL直跳，Dify v2 System Prompt覆盖全部12类 | 2026-07-10 |
+| #114 | 审批卡片同窗口导航改造 | ✨ window.open(\_blank) → window.location.href，企微原生返回按钮，COEP/CSP安全头分析 | 2026-07-10 |
+| #115 | 企微跨应用免登录研究 | 📋 同corpid下IT服务台H5与运维平台各自独立OAuth2 snsapi_base静默授权，结论已归档 | 2026-07-10 |
+| #108 | H5消息重复Bug | 🐛 员工发送消息后自己看到两条 → sendNewMessage未更新lastMessageId导致轮询重复拉取 → 已修复并部署 | 2026-07-10 |
+| #109 | H5消息自动滚动 | ✨ 收到新消息时自动滚动到底部 → 已实现并部署 | 2026-07-10 |
+| #110 | WebSocket Token认证修复 | 🐛 QR码登录存储user:token:*但WS只查agent:token:* → 支持两种格式查询 | 2026-07-10 |
+| #105 | 摇人消息推送到通知栏Bug | 🐛 删除shake/call_agent函数中的企微消息推送调用，修复完成并已部署 | 2026-07-10 |
+
+### P0 必做 (下一个 sprint)
+
+| # | 任务 | 重要程度 | 说明 |
+|---|---|---|---|
+| #48 | v1.0 收窄 set_real_ip_from | 🔴 P0 | 现 allow 0.0.0.0/0 是临时方案，正式上线前必须改精确代理IP |
+| #81 | 敏感词检测 + 语气优化 | 🔴 P0 | v0.7.1 开发内容，文本安全过滤 |
+| #104 | 运行期结构化日志查看页（D） | 🔴 P0 | 决策4：落地筛选+下载页面 |
+
+### P1 重要
+
+| # | 任务 | 说明 |
+|---|---|---|
+| #105 | 摇人消息推送到通知栏Bug | 🐛 摇人/举手功能系统消息错误推送到企微应用通知，应只在H5页面内展示 |
+| #73 | 修后端文件未真正覆盖 | `yes | cp -f` 路径 |
+| #86 | 排查流程图零依赖部分 review | 把 Mermaid 流程图从代码里剥离 |
+| #88 | 管理后台 RBAC 角色权限 | 细粒度角色权限 |
+| #75 | 头像同步功能完善 | 登录强制同步 + 前端首字降级 |
+
+### P1/P2 功能开发任务
+
+#### 阶段2 - P1功能
+
+| # | 功能 | 状态 |
+|---|---|---|
+| P1-24 | 摇人按钮 | ✅已完成 |
+| P1-25 | 满意度评价 | ✅已完成 |
+| P1-26 | 排队系统 | ✅已完成 |
+| P1-27 | 快速回复 | ✅已完成 |
+| P1-28 | 知识库(基础) | ✅已完成 |
+
+#### 阶段3 - P2功能
+
+| # | 功能 | 状态 |
+|---|---|---|
+| P2-09 | AI Wingman | ✅已完成 |
+| P2-10 | 会话标注 | ✅已完成 |
+| P2-11 | 自动摘要 | ✅已完成 |
+| P2-07~11 | 审批流程系统 | ✅已完成（详见任务说明书-78） |
+
+#### 阶段4 - P2功能
+
+| # | 功能 | 状态 |
+|---|---|---|
+| P2-12 | 数据看板 | ✅已完成 |
+| P2-13 | 知识库自动迭代 | ✅已完成 |
+
+---
+
+## 五、最近搞定
+
+### 2026-07-10
+- ✅ 审批类型扩展 5→12种/18流程 + 卡片URL直跳 + Dify v2 发布（#113）
+- ✅ 审批卡片同窗口导航改造（#114）
+- ✅ 企微跨应用免登录可行性研究（#115）
+- ✅ 坐席端消息头像不显示Bug修复 + 部署（#111）
+- ✅ 坐席端消息布局调整（头像在名字前） + 部署（#112）
+- ✅ H5消息重复Bug修复 + 部署
+- ✅ H5消息自动滚动功能 + 部署
+- ✅ WebSocket Token认证修复 + 部署
+- ✅ 摇人消息推送Bug修复 + 部署
+
+### 2026-07-09
+- ✅ WS 子协议修复部署生产
+- ✅ 方案A E2E 通过
+
+### 2026-07-08
+- ✅ 消息发送延时 E2E 验证通过
+- ✅ 头像同步功能代码交付（12/12测试通过）
+
+### 2026-07-07
+- ✅ 管理后台登录修复
+- ✅ 故障排查文档整合
+
+### 2026-07-06
+- ✅ P1-25 满意度评价完成
+- ✅ #90 身份认证问题修复
+
+### 2026-07-05
+- ✅ 坐席端消息列表500错误修复
+- ✅ 消息发送失败修复
+- ✅ 文档补充
+
+---
+
+## 六、风险管理
+
+### 风险总览
+
+| 级别 | 数量 | 已处理 | 待处理 | 处理率 |
+|------|------|--------|--------|--------|
+| 🔴 严重 (Critical) | 4 | 4 | 0 | **100%** |
+| 🟠 高 (High) | 6 | 5 | 1 | **83%** |
+| 🟡 中 (Medium) | 7 | 4 | 3 | **57%** |
+| 🔵 低 (Low) | 5 | 3 | 2 | **60%** |
+| **合计** | **22** | **16** | **6** | **73%** |
+
+---
+
+## 七、怎么跑起来
+
+### 1. 后端 dev
+
+```powershell
+cd D:\资料\03-项目开发\wecom_it_smart_desk
+docker compose -f docker-compose.dev.yml --env-file .env.dev up -d
+curl http://localhost:8000/api/dev/health
+```
+
+### 2. 前端 dev
+
+```powershell
+# 一起起所有前端
+.\scripts\dev-frontend-start.ps1
+```
+
+### 3. 浏览器验证
+
+| 端 | 地址 |
+|---|------|
+| Portal | http://localhost:5176/itportal/select |
+| H5 | http://localhost:5174/itdesk/ |
+| 坐席 | http://localhost:5173/itagent/ |
+| 管理员 | http://localhost:5175/itadmin/ |
+
+---
+
+## 八、文档清单
+
+### 任务说明书/
+
+| 文档 | 说明 |
+|------|------|
+| IT智能服务台-项目管理主文档 | 本文档 |
+| 02-风险跟踪表.md | 风险登记册（22项） |
+| 任务说明书-01-新开发任务.md | v0.7.2 新功能开发任务 |
+| 任务说明书-02-卡点任务.md | 优先级最高卡点任务 |
+| 任务说明书-75-头像同步功能完善.md | 进行中的任务 |
+| 任务说明书-78-审批流程系统.md | 审批类型扩展+卡片URL直跳+同窗口导航+免登录研究 |
+
+### SOPs-标准流程/
+
+| 文档 | 说明 |
+|------|------|
+| SOP-01-Gitea部署.md | Gitea 部署 SOP |
+| SOP-02-Gitea备份恢复.md | Gitea 备份恢复 SOP |
+| SOP-03-推送评审.md | 推送评审 SOP |
+| SOP-04-应急响应.md | 应急响应 SOP |
+| SOP-05-项目管理文档管理规范.md | 文档管理规范 SOP |
+
+---
+
+## 九、相关文档
+
+| 类别 | 文档 | 位置 |
+|------|------|------|
+| 项目概览 | 项目总览与部署手册 | `01-项目总览/` |
+| 产品需求 | PRD需求文档 | `02-产品需求/` |
+| 技术架构 | 技术架构设计 | `03-技术架构/` |
+| 测试质量 | E2E验收清单 | `06-测试质量/` |
+| 部署运维 | 部署指南 | `09-部署运维/` |
+
+---
+
+## 十、版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| v2.4 | 2026-07-10 | 新增 #113-115 审批流程系统任务（类型扩展+卡片导航+免登录研究），P2功能表新增审批流程系统 |
+| v2.3 | 2026-07-10 | 新增 #111-112 头像显示与布局调整任务 |
+| v2.2 | 2026-07-10 | 新增 #108-110 Bug修复任务（消息重复、自动滚动、WS认证） |
+| v2.1 | 2026-07-10 | 看板新增 #107 后端部署卷挂载改造任务 |
+| v2.0 | 2026-07-10 | 整合任务总索引、项目状态看板、任务状态报告、风险跟踪表 |
+| v1.1 | 2026-07-04 | 新增产品需求变更、技术架构变更、文档管理变更 |
+| v1.0 | 2026-07-04 | 初始版本 |
+
+---
+
+> **本文档就是项目的"驾驶舱仪表盘"。任何时候新开 session，先读这个文件就懂上下文。