# 后端未完成功能清单

## 1. 微信能力

### 1.1 微信订阅消息正式联调

当前状态：

1. 已完成通知服务基础接入
2. 已在审核通过/驳回、匹配成功时挂接异步通知逻辑
3. 已完成微信 `access_token` 的 Redis 缓存

未完成项：

1. 真实模板 ID 配置验证
2. 真机环境联调验证
3. 发送失败日志和重试策略

涉及文件：

1. `backend/app/services/notify_service.py`
2. `backend/app/routers/admin/users.py`
3. `backend/app/routers/matches.py`
4. `backend/.env.example`

## 2. Redis 缓存与频控

### 2.1 推荐列表缓存

当前状态：

1. 已完成 Redis 客户端封装
2. 已完成登录限流
3. 已完成 `like` 接口限流

未完成项：

1. `/matches/candidates` 今日推荐结果缓存
2. `/matches/ai-suggest` 推荐结果缓存
3. 每日推荐上限与已展示用户去重缓存

涉及文件：

1. `backend/app/utils/redis_client.py`
2. `backend/app/utils/rate_limit.py`
3. `backend/app/services/match_service.py`
4. `backend/app/routers/matches.py`

### 2.2 更完整频控策略

未完成项：

1. 后台关键管理接口限流策略
2. 上传接口限流策略
3. 频控命中后的统一监控/日志

## 3. 腾讯云 COS 真实上传

当前状态：

1. 头像上传流程已跑通
2. 图片压缩、模糊图生成已完成
3. 当前 `cos_service.py` 仍为占位实现

未完成项：

1. 使用腾讯云 COS SDK 真实上传文件
2. 上传失败异常处理
3. 头像上传成功后的 URL 真实落库验证
4. 活动封面上传接口 `POST /upload/activity-cover`

涉及文件：

1. `backend/app/services/cos_service.py`
2. `backend/app/services/upload_service.py`
3. `backend/app/routers/upload.py`

## 4. 匹配系统增强

### 4.1 不感兴趣持久化

未完成项：

1. 设计“不感兴趣/跳过”记录表或缓存结构
2. 提供后端接口记录跳过行为
3. 在候选列表中过滤已跳过用户

涉及文件：

1. `backend/app/services/match_service.py`
2. `backend/app/routers/matches.py`
3. 可能需要新增模型与迁移

### 4.2 公开资料交互支持增强

当前状态：

1. `GET /users/public/{user_id}` 已完成

未完成项：

1. 根据前端最终交互补充更细的字段控制
2. 与首页会员卡点击逻辑配套联调验证

## 5. 后台管理增强

### 5.1 后台用户管理增强

当前状态：

1. 用户列表、详情、封禁/解封已完成

未完成项：

1. 分页能力
2. 更丰富筛选项
3. 用户操作日志

涉及文件：

1. `backend/app/routers/admin/users.py`
2. `backend/app/services/admin_service.py`

### 5.2 后台匹配记录增强

当前状态：

1. `GET /admin/matches` 已完成基础版

未完成项：

1. 按用户 ID 过滤
2. 按日期过滤
3. 分页能力

涉及文件：

1. `backend/app/routers/admin/matches.py`
2. `backend/app/services/admin_service.py`

### 5.3 后台系统设置增强

当前状态：

1. `GET /admin/system/config`
2. `PUT /admin/system/config`

未完成项：

1. 更完整配置项
2. 配置项说明字段
3. 配置合法性校验

涉及文件：

1. `backend/app/models/system_config.py`
2. `backend/app/routers/admin/system.py`
3. `backend/app/services/admin_service.py`

## 6. 测试

未完成项：

1. 单元测试
   匹配分计算
   资料完整度计算
   审核状态流转
   活动报名校验
2. 接口测试
   `auth`
   `users`
   `activities`
   `matches`
   `admin`
3. 自动化回归测试

## 7. 部署与上线验证

未完成项：

1. 生产环境 `.env` 最终确认
2. MySQL / Redis / COS / HTTPS 域名联调
3. 微信小程序后台正式配置验证
4. 真机环境完整联调验证
5. 后端部署脚本或部署说明进一步细化

## 8. 当前优先级建议

### P0

1. COS 真上传
2. 推荐列表 Redis 缓存
3. 微信通知真机联调验证

### P1

1. 不感兴趣持久化
2. 后台匹配记录筛选分页
3. 后台用户管理分页与增强筛选

### P2

1. 自动化测试
2. 部署验证
3. 更完整后台配置项