xiangqinxiaochengxu/后端未完成功能清单.md

后端未完成功能清单

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. 更完整后台配置项