simon/wecom_it_smart_desk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
ad8fd18d850eb8cb23988254510ab7cdfcd6edfa
wecom_it_smart_desk/docs/10-项目管理/任务说明书/任务说明书-01-新开发任务.md
T
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

8.3 KiB
Raw Blame History

新开发任务说明书 (v0.7.2+)

版本: v1.2 | 日期: 2026-07-04 | 状态: 🔴 进行中

📋 基本信息

项目 内容
任务名称 v0.7.2+ 新功能开发
任务ID #90 等
优先级 🔴P0 > 🟠P1
类型 功能开发 / Bug修复 / 安全加固 / 文档完善
状态 进行中 / 延后
负责人 宋献 + Claude
创建日期 2026-07-04

📥 输入项来源

产品需求

来源文档 相关章节 说明
02-产品需求/02-产品需求文档PRD-v1.2-20260704.md §4.5 坐席/管理员登录流程 登录逻辑调整
02-产品需求/02-产品需求文档PRD-v1.2-20260704.md §9 术语与图标规范 统一术语
02-产品需求/product-产品/v0.7.2-backlog-candidate-2026-06-24.md backlog项 未来功能候选

技术架构

来源文档 相关章节 说明
03-技术架构/02-技术方案/技术方案-消息功能详细设计.md - 消息功能设计
03-技术架构/02-技术方案/技术方案-摇人协作.md - 摇人功能设计
03-技术架构/02-技术方案/技术方案-邀请功能.md - 邀请功能设计
03-技术架构/01-ADRs-架构决策/ADR-XXX.md - 架构决策记录

原型设计

来源文档 页面 说明
04-原型设计/prototypes-原型图/agent-workspace-v5_4.html 坐席工作台 v5.4 UI
04-原型设计/prototypes-原型图/h5-user-wecom-style-v2-desktop.html H5用户端 v2 桌面版
04-原型设计/prototypes-原型图/admin-dashboard-v1.html 管理后台 v1 UI

项目看板

来源 任务名 说明
05-项目状态看板/01-项目状态看板.md P0任务 当前进行中任务

📢 需求变更说明（2026-07-04）

根据 PRD v1.5 更新：

  • 用户端：强制企微内嵌打开，OAuth2 静默授权
  • 坐席/管理端：浏览器直接打开，无需经过企微工作台，支持账号密码+OTP认证

核心变更：坐席/管理员可直接在浏览器打开登录页面，不再需要经过 Portal

🎯 当前优先级（用户确认）

用户确认优先级：坐席/管理直接登录 > 用户端企微内嵌 > 其他任务

🆕 新功能开发任务

任务 1: 坐席/管理端直接登录（🔴 最优先）

项目 内容
ID #90
优先级 🔴 P0
类型 功能开发 / 登录流程
描述 坐席/管理端浏览器直接打开登录页，智能检测企微登录状态，提供三种登录方式
状态 开发中（v1.8完成）
估时 4小时（开发+测试）

输入项来源

  • 产品需求: PRD v1.5 §4.5 登录流程调整
  • 原型设计: admin-dashboard-v1.html 登录页面
  • 项目看板: P0任务

输出成果要求

# 交付物 类型
1 后端登录API (/api/agents/login) 代码
2 坐席端登录页面 (v1.8) 代码
3 管理端登录页面 代码
4 OTP验证逻辑 代码
5 企微客户端检测 (JS-SDK/wecom://) 代码
6 更新API文档 文档

验证方式

验证项 验证方法 预期结果
坐席登录 手动测试 账号密码+OTP登录成功
管理登录 手动测试 账号密码+OTP登录成功
权限控制 越权测试 坐席无法访问管理端
错误处理 异常输入 正确提示

完成标准

  • 后端登录API开发完成
  • 坐席端登录页面开发完成
  • 管理端登录页面开发完成
  • OTP验证正常工作
  • 企微客户端检测功能 (v1.8)
  • 部署测试
  • 代码通过 Code Review

任务 2: 收窄 IP 白名单安全加固（⏸️ 延后）

项目 内容
ID #48
优先级 P1 → ⏸️ 延后
类型 安全加固
描述 当前 /api/admin/ + /itadmin/ 使用 allow 0.0.0.0/0 临时全开，需收窄到精确代理 IP
阻塞原因 需网络组确认真实代理 IP 段（WAF/堡垒机/CDN 出口 IP）
估时 1小时（改 nginx + reload + 验证）

输入项来源

  • 产品需求: 安全合规要求
  • 技术架构: nginx 配置
  • 项目看板: 安全加固任务

输出成果要求

# 交付物 类型
1 nginx IP白名单配置 配置
2 安全验证报告 文档

验证方式

  • 内部IP可访问
  • 外部IP被拦截

完成标准

  • nginx 配置已更新
  • 已验证内网访问正常
  • 已验证外网无法访问管理端

任务 3: 修复部署脚本文件覆盖问题

项目 内容
ID #73
优先级 P1
类型 部署优化
描述 `yes
根因 deploy-staging/ bind mount + RO 双重坑
估时 2小时（改 deploy 脚本用 rsync --checksum）

输入项来源

  • 技术架构: 部署流程文档
  • 项目看板: 部署优化任务

输出成果要求

# 交付物 类型
1 优化后的部署脚本 脚本
2 部署验证测试 测试

验证方式

  • 增量部署测试通过
  • 文件覆盖生效

完成标准

  • 部署脚本已优化
  • 验证测试通过

任务 4: 排查流程图文档化

项目 内容
ID #86
优先级 P1
类型 文档完善
描述 把 Mermaid 流程图从代码里剥离成可读文档
估时 3小时

输入项来源

  • 原型设计: 排查流程原型
  • 技术架构: 代码中的 Mermaid 图表
  • 项目看板: 文档完善任务

输出成果要求

# 交付物 类型
1 排查流程图文档 文档
2 更新架构图索引 文档

验证方式

  • 文档可读性检查

完成标准

  • 流程图文档完整
  • 索引已更新

任务 5: pytest 测试失败修复

项目 内容
ID #92
优先级 P1
类型 测试修复
描述 修复 v0.7.1-dev 引入的 pytest 失败（当前 64 个 pre-existing 失败）
根因 conftest.py SQLite StaticPool 性能 + Windows + utf-8 + asyncio loop 顺序问题
估时 4小时

输入项来源

  • 项目看板: 测试修复任务

输出成果要求

# 交付物 类型
1 修复后的 conftest.py 代码
2 测试通过报告 文档

验证方式

  • pytest 运行通过

完成标准

  • 所有测试通过

任务 6: 敏感词检测 + 语气优化（⏸️ 延后）

项目 内容
ID #81
优先级 P0 → ⏸️ 延后
类型 功能开发
描述 v0.7.1 开发内容，文本安全过滤
阻塞原因 需确认企业敏感词库来源
估时 待评估

输入项来源

  • 产品需求: PRD 安全要求

输出成果要求

# 交付物 类型
1 敏感词过滤服务 代码
2 敏感词库配置 配置

验证方式

  • 敏感词拦截测试

完成标准

  • 敏感词库已配置
  • 过滤功能正常

📊 任务统计

优先级 数量 估时
P0 2 待评估
P1 5 ~10小时

✅ 完成标准总览

代码规范

  • 遵循项目代码规范
  • 通过 ESLint / Pylint 检查

测试要求

  • 单元测试覆盖率 ≥ 80%
  • 功能测试通过
  • 安全测试通过

文档要求

  • 相关技术文档已更新
  • API 接口文档已更新

交付要求

  • 代码合入主干分支
  • 通过 Code Review
  • 任务看板已更新

📈 变更记录

日期 变更内容 变更人
2026-07-04 创建任务说明书 Claude
2026-07-04 更新登录逻辑说明 Claude
2026-07-04 添加模板化字段 Claude
Reference in New Issue View Git Blame Copy Permalink