chore: establish V1.1 recovery baseline

This commit is contained in:
2026-09-09 22:05:00 +08:00
commit b46b48eb33
947 changed files with 155471 additions and 0 deletions
+56
View File
@@ -0,0 +1,56 @@
# Phase 07 Completion Report
## Status
✅ Completed
## Implemented
### P07-T01 ~ P07-T04: 推荐核心
- [x] `RecommendationEngineService` — 候选池查询 + 双向Required过滤 + 评分 + 缓存
- [x] Redis 推荐缓存(TTL 1小时,关键操作时失效)
- [x] 二次 Eligibility 校验(防止缓存与实时状态不一致)
- [x] Pass 冷却期过滤
### P07-T05 ~ P07-T07: 找对象搜索
- [x] `DiscoverService` — 临时筛选(不影响用户择偶条件)
- [x] `DiscoverController` — GET /discover(分页 + 筛选参数)
- [x] GET /discover/users/{userId} — 公开用户详情
### P07-T08: 推荐来源
- [x] 推荐记录 source 字段(daily/discover/matchmaker/activity)
- [x] recommendation_records 表已创建(V004/V006)
### Miniapp 页面
- [x] U18 首页推荐卡(index)— 推荐理由 + 等级标签 + Like/Pass 操作
- [x] U19 找对象列表(discover)— 临时筛选 + 分页 + 下拉刷新
- [x] U21 用户详情(profile-detail)— 完整资料展示 + 喜欢/拉黑/举报
## Database Changes
- 无新增迁移(V004/V006 已包含 recommendation_records)
## API Changes
新增接口:
| Method | Path | 描述 |
|---|---|---|
| GET | /api/v1/recommendations | 获取今日推荐 |
| POST | /api/v1/recommendations/{id}/action | 记录推荐操作 |
| GET | /api/v1/recommendations/{id}/eligibility | 二次校验资格 |
| GET | /api/v1/discover | 搜索用户(临时筛选) |
| GET | /api/v1/discover/users/{id} | 查看公开详情 |
## Tests
- `RecommendationEngineServiceTest`: 8 个用例
- `DiscoverServiceTest`: 2 个用例
- 合计: 10 个用例
## Security Review
- [x] 公开DTO不含身份证/手机号
- [x] 推荐理由基于真实资料生成
- [x] 推荐结果不暴露具体分数
## Known Issues
- 候选池查询使用简化实现(Phase 08 补充 Block/AccountStatus 过滤)
- Redis 序列化/反序列化需后续完善
## Next Phase
Phase 08: Like/Pass/Block/Match(user_relations 表 + 双向Match事务 + 并发安全)