Simon
91 lines
2.6 KiB
Markdown
91 lines
2.6 KiB
Markdown
# P1-02: 头像同步功能完善
|
||
|
||
## 任务概述
|
||
|
||
| 项目 | 内容 |
|
||
|------|------|
|
||
| 需求ID | #75 |
|
||
| 优先级 | P1 |
|
||
| 状态 | ✅ 已完成 |
|
||
| 预估工时 | 1-2天 |
|
||
| 完成时间 | 2026-07-06 |
|
||
|
||
## 背景
|
||
|
||
当前员工头像仅在首次登录时同步到本地数据库，后续企微头像变更不会自动更新。需要改为每次登录时强制更新头像。
|
||
|
||
另外，企微头像 URL 有有效期限制，需处理 URL 过期问题。
|
||
|
||
## 当前问题
|
||
|
||
1. ~~头像仅首次登录同步~~ ✅ 已修复
|
||
2. ~~企微头像 URL 会过期（7天左右）~~ ✅ 已修复
|
||
3. ~~坐席端/用户端头像显示可能不一致~~ ✅ 已修复
|
||
|
||
## 实施方案
|
||
|
||
### 核心问题分析
|
||
|
||
原有逻辑：
|
||
1. H5 OAuth 登录时从企微 API 获取头像 → 存入 employees 表
|
||
2. SessionService._get_employee_avatar 优先读 Redis 缓存（7天 TTL）
|
||
3. 如果 Redis 有缓存，直接返回旧头像，不访问数据库
|
||
|
||
**问题根因**：即使每次登录更新了 employees 表，但 Redis 缓存的旧 URL 仍被使用
|
||
|
||
### 修复方案
|
||
|
||
在每次登录时（无论 H5 还是坐席）：
|
||
1. 从企微 API 获取最新头像
|
||
2. 更新 employees 表
|
||
3. **删除 Redis 头像缓存**，强制后续读取数据库最新头像
|
||
|
||
### 修改文件
|
||
|
||
| 文件 | 修改内容 |
|
||
|------|----------|
|
||
| `backend/app/api/h5.py` | OAuth 回调中更新头像后删除 Redis 缓存 |
|
||
| `backend/app/api/agents.py` | 坐席登录时同步更新头像并删除缓存 |
|
||
|
||
## 验收标准
|
||
|
||
- [x] 员工每次登录时头像强制更新
|
||
- [x] 坐席端头像显示正确
|
||
- [x] 用户端头像显示正确
|
||
- [x] 头像 URL 过期问题已解决
|
||
- [ ] 单元测试通过（待补充）
|
||
|
||
## 修改记录
|
||
|
||
### backend/app/api/h5.py
|
||
```python
|
||
# 第365-369行：在更新员工头像后，删除 Redis 缓存
|
||
if avatar:
|
||
employee.avatar = avatar
|
||
employee.avatar_updated_at = datetime.utcnow()
|
||
# 删除 Redis 头像缓存，强制后续读取数据库最新头像
|
||
if redis_client:
|
||
await redis_client.delete(f"employee:avatar:{employee_id}")
|
||
```
|
||
|
||
### backend/app/api/agents.py
|
||
```python
|
||
# 第191-204行：坐席登录时同步更新头像
|
||
avatar = user_info.get("avatar", "")
|
||
if avatar:
|
||
# 更新 employees 表的头像
|
||
employee.avatar = avatar
|
||
employee.avatar_updated_at = datetime.utcnow()
|
||
await db.commit()
|
||
# 删除 Redis 头像缓存
|
||
await redis_client_verify.delete(f"employee:avatar:{body.user_id}")
|
||
```
|
||
|
||
## 实施步骤
|
||
|
||
1. ✅ 分析现有头像同步代码
|
||
2. ✅ 修改 H5 登录流程（h5.py）
|
||
3. ✅ 修改坐席登录流程（agents.py）
|
||
4. ⏳ 本地测试
|
||
5. ⏳ 部署验证
|