wecom_it_smart_desk/docs/02-产品需求/v0.7.2-backlog-candidate-2026-06-24.md

---
name: v0.7.2-backlog-candidate-2026-07-05
description: v0.7.1 已发布，蓝绿部署已完成，最新状态更新
metadata:
  type: project
  last_updated: 2026-07-05
---

# v0.7.2 backlog 候选(2026-07-05 更新)

> **更新说明 (2026-07-05)**:
> - v0.7.1 已发布 ✅（企微SSO、RBAC权限、消息互通）
> - 蓝绿部署已完成（Blue/Green 环境切换）
> - Gitea 服务已恢复 (v1.26.2)
> - 完成文档优化专项（用户手册创建、KPI指标补充、技术约束更新）
> - 补充阶段四/五的KPI指标定义
> - 新增需求：待办事项集成企微审批工单（#74）
> - 新增需求：头像同步功能完善（#75）

## 来源
扫描 CURRENT-FOCUS.md(P0/P1/P2)+ phase1-progress.md 痛点 + 3 个 v1.0 必做 memory。

## 🟡 候选清单

### P1(可放 v0.7.2)

1. **#48 [P0→P1] 收窄 /api/admin/ + /itadmin/ IP 白名单**
   - 当前 `allow 0.0.0.0/0` 临时全开
   - 阻塞:**需网络组确认真实代理 IP 段**(WAF/堡垒机/CDN 出口 IP)
   - 不能 Claude 单方面定,需用户提交工单
   - 估时:1h(改 nginx + reload + 验证)
   - 状态:待网络组确认
   - **任务说明书**: `docs/10-任务说明/P1-01-IP白名单收窄.md`

2. **#74 [P1] 待办事项集成企微审批工单**
   - 将企微审批工单同步到坐席待办事项
   - 需企微审批应用 API 权限
   - 估时:2-3天
   - 状态:需企微API权限
   - **任务说明书**: `docs/10-任务说明/P1-06-待办集成企微审批.md`

3. **#75 [P1] 头像同步功能完善**
   - 员工端/坐席端头像显示优化
   - 当前仅首次登录同步，需改为每次登录强制更新
   - 需处理头像URL过期问题
   - 估时:1-2天
   - 状态:待开发
   - **任务说明书**: `docs/10-任务说明/P1-02-头像同步功能完善.md`

4. **#73 [P1] 修后端文件未真正覆盖**
   - `yes | cp -f` 路径,部署时偶尔没生效
   - 根因:`deploy-staging/` bind mount + RO 双重坑(见 [[bind-mount-deleted-inode-pitfall]])
   - 估时:2h(改 deploy 脚本用 rsync --checksum)
   - 状态:待开发
   - **任务说明书**: `docs/10-任务说明/P1-03-修后端文件覆盖.md`

5. **#86 [P1] 排查流程图零依赖部分 review + 文档化**
   - 把 Mermaid 流程图从代码里剥离成可读文档
   - 不阻塞生产,可顺手做
   - 估时:3h
   - 状态:待开发
   - **任务说明书**: `docs/10-任务说明/P1-04-排查流程图文档化.md`

6. **#92 [P1] 修 v0.7.1-dev 引入的 pytest 失败(0 引入,33 pre-existing)**
   - 实际还有 64 个 pre-existing 失败(conftest 卡死环境问题)
   - v0.7.1-dev 引入 0 个
   - 估时:4h(可能是 conftest.py SQLite StaticPool 性能 + Windows + utf-8 + asyncio loop 顺序问题)
   - 状态:待开发
   - **任务说明书**: `docs/10-任务说明/P1-05-pytest失败修复.md`

### P2(可放 v0.7.3+ 或 v1.0)

5. **#31 docker 镜像推生产 registry**(等用户决策 Harbor/阿里云/其他)
6. **#43 HTTPS 证书**(等域名备案完成)
7. **#108 Gitea push v0.7.1-dev**(等 token 重授权)
8. **#53 企微 App 实扫码验证**(等用户手动)

## 🔧 内部清理(Claude 可独立做)

9. **pytest conftest 性能优化**
   - 当前每个测试文件都要跑整套 alembic migration(从 0001 到 027)
   - 优化:用 `alembic upgrade head` 缓存 db 到 tmpfs,或 sqlite-in-memory 复用
   - 估时:2h

10. **CURRENT-FOCUS.md 刷新到 v0.7.1 release 完成态**
    - 当前停在 2026-06-22 19:55,看板过期 36 小时
    - 更新 in_progress / P0 / 最近搞定段

11. **pytest conftest 卡死问题根因分析**
    - 跑单个 test_high_risk_guard.py 都 hang
    - 怀疑 alembic migration 在 Windows + StaticPool 下死锁
    - 估时:1h(可加 print + trace)

## 📚 文档优化专项(已完成 v0.7.2)

12. **✅ 05-用户手册目录创建**
    - 已创建 3 本手册框架：员工使用指南、坐席操作手册、管理员手册
    - 状态:已完成

13. **✅ PRD KPI 指标体系补充**
    - 新增 §4.5 指标体系详细设计
    - 包含北极星/驱动/健康指标框架、测量方法、行业基准对比
    - 状态:已完成

14. **✅ PRD 章节编号说明**
    - 添加版本号 v1.3 更新说明
    - 添加章节编号解释
    - 状态:已完成

15. **✅ 技术约束状态更新**
    - 更新约束项当前状态
    - 补充企微设备管理付费状态
    - 状态:已完成

## 推荐 v0.7.2 范围

**必含(用户能直接拍板的)**:
- #48 IP 白名单收窄(前提:网络组确认)
- #73 修后端文件覆盖
- #92/9 pytest 性能 + 33 失败修复
- 头像同步功能完善(#75)

**可选(顺手)**:
- #86 排查流程图文档化
- #10 看板刷新
- 待办事项集成企微审批工单(#74)

**暂缓(等用户/外部)**:
- #31 docker registry
- #43 HTTPS 证书
- #53 企微验证

> **已完成**:
> - ✅ #108 Gitea push - 已恢复服务 (v1.7.2)
> - ✅ 蓝绿部署架构 - 已实施完成

## Why
v0.7.1 已 release ✅,P0 全清;剩余都是 P1/P2,用户应有选择权决定下一版本范围。

## 🔄 已完成工作 (2026-07-05)

### v0.7.1 Release
- ✅ 企微 SSO 登录
- ✅ RBAC 权限体系
- ✅ 用户/坐席消息互通
- ✅ 管理后台功能完善

### 部署架构
- ✅ 蓝绿部署架构（Blue/Green 环境切换）
- ✅ Nginx upstream 动态切换
- ✅ 部署脚本 `switch-blue-green.sh`

### 基础设施
- ✅ Gitea 服务恢复 (v1.26.2)
- ✅ PostgreSQL/Redis 正常运行

### 文档整理
- ✅ 部署运维文档合并（01-部署指南、02-故障排查、03-版本记录）
- ✅ 蓝绿部署指南

## How to apply
下次用户问"接下来做什么"或"v0.7.2 规划",直接给这份清单让用户选。