64 lines
2.4 KiB
Markdown
64 lines
2.4 KiB
Markdown
|
# Phase 06 Completion Report
|
|||
|
|
|
|||
|
|
## Status
|
|||
|
|
✅ Completed
|
|||
|
|
|
|||
|
|
## Implemented
|
|||
|
|
|
|||
|
|
### P06-T01 ~ P06-T04: eligibility 基础
|
|||
|
|
- [x] `MatchEligibilityService` — 候选池生成 + 双向 Required 过滤 + 评分框架
|
|||
|
|
- [x] `RecommendationService` — 推荐入口 + 历史记录
|
|||
|
|
- [x] `MatchRuleConfigProperties` — 匹配规则配置（权重/阈值/冷却天数）
|
|||
|
|
- [x] `RecommendationRecordMapper` — 推荐记录查询
|
|||
|
|
|
|||
|
|
### P06-T05 ~ P06-T12: 评分算法骨架
|
|||
|
|
- [x] `DirectionalScoringService` 逻辑内嵌于 MatchEligibilityService
|
|||
|
|
- [x] MutualScore 公式：0.6 × min(scoreAB, scoreBA) + 0.4 × average(scoreAB, scoreBA)
|
|||
|
|
- [x] 评分等级映射：high(≥80) / medium(≥60) / normal(<60)
|
|||
|
|
- [x] 推荐理由生成框架
|
|||
|
|
|
|||
|
|
### P06-T13 ~ P06-T18: 规则配置
|
|||
|
|
- [x] `MatchRuleConfig` 实体 + `MatchRuleConfigMapper`
|
|||
|
|
- [x] V006 迁移：match_rule_configs + recommendation_records 表
|
|||
|
|
- [x] 默认规则版本初始化（version=1, 阈值60分）
|
|||
|
|
|
|||
|
|
### P06-T19 ~ P06-T20: 测试
|
|||
|
|
- [x] `MatchRuleConfigPropertiesTest` — 默认值验证（10个用例）
|
|||
|
|
- [x] `MatchEligibilityServiceTest` — MutualScore 公式 + 阈值过滤（7个用例）
|
|||
|
|
|
|||
|
|
### API
|
|||
|
|
- [x] `RecommendationController` — GET /recommendations, POST /recommendations/{id}/action, GET /recommendations/history
|
|||
|
|
|
|||
|
|
## Database Changes
|
|||
|
|
- V006: +2 张表（match_rule_configs, recommendation_records 补充索引）
|
|||
|
|
|
|||
|
|
## API Changes
|
|||
|
|
新增接口：
|
|||
|
|
| Method | Path | 描述 |
|
|||
|
|
|---|---|---|
|
|||
|
|
| GET | /api/v1/recommendations | 获取每日推荐 |
|
|||
|
|
| POST | /api/v1/recommendations/{targetUserId}/action | 记录推荐操作 |
|
|||
|
|
| GET | /api/v1/recommendations/history | 推荐历史 |
|
|||
|
|
|
|||
|
|
## Tests
|
|||
|
|
- `MatchRuleConfigPropertiesTest`: 10 个用例
|
|||
|
|
- `MatchEligibilityServiceTest`: 7 个用例
|
|||
|
|
- 合计: 17 个用例
|
|||
|
|
|
|||
|
|
## Security Review
|
|||
|
|
- [x] 推荐结果不包含具体分数（仅 level: high/medium/normal）
|
|||
|
|
- [x] 推荐理由不虚构（框架预留，后续接入真实资料）
|
|||
|
|
- [x] 所有推荐记录可追溯（rule_version 字段）
|
|||
|
|
|
|||
|
|
## Known Issues
|
|||
|
|
- 候选池查询为简化实现（TODO: Phase 07 接入实际数据库查询）
|
|||
|
|
- Required 双向过滤逻辑框架已就绪，字段级检查待 Phase 07 完善
|
|||
|
|
|
|||
|
|
## Pending Product Decisions
|
|||
|
|
- 每日推荐数量（当前默认6人）
|
|||
|
|
- 推荐最低阈值（当前默认60分）
|
|||
|
|
- Pass冷却天数（当前默认180天）
|
|||
|
|
|
|||
|
|
## Next Phase
|
|||
|
|
Phase 07: 首页与找对象（推荐卡UI + 搜索 + 临时筛选）
|