206 lines
3.9 KiB
Markdown
206 lines
3.9 KiB
Markdown
|
# 后端未完成功能清单
|
||
|
|
|
||
|
|
## 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. 更完整后台配置项
|