chore: establish V1.1 recovery baseline

2026-09-09 22:05:00 +08:00
commit b46b48eb33
947 changed files with 155471 additions and 0 deletions
@@ -0,0 +1,115 @@
+# Phase 12 - Relationship Progress Completion Report
+
+## Status
+Completed ✅
+
+---
+
+## Implemented
+
+Phase 12 是轻量扩展阶段。核心功能已在 Phase 07 实现，本阶段补充完善。
+
+### 首页服务建议逻辑 — `HomeApplicationService.java`
+
+`buildServiceRecommendations()` 方法根据用户关系状态动态推荐：
+
+| 关系状态 | 推荐服务 | 标题 | CTA |
+|---------|---------|------|-----|
+| `searching` | 公益红娘 | "一直没有遇到特别合适的人？" | "申请公益红娘" |
+| `getting_to_know` | 沟通建议 | "刚开始认识，不知道聊什么？" | "看看沟通建议" |
+| `matched_successfully` | 婚前辅导 | "正在认真考虑未来？" | "了解婚前辅导" |
+| `paused` / `service_exited` | 无 | 空列表 | — |
+
+### 不变量保障
+
+- **INV-005 成功牵手双确认**：Successful 用户仅推荐婚前辅导，不推荐找对象
+- **INV-003 Block优先级**：serviceRecommendations 不涉及互动操作，无冲突
+- **INV-007 红娘不可替用户操作**：推荐卡片仅为引导，用户自行点击申请
+
+### 前端适配
+
+首页 `index.ts` 中：
+- `serviceRecommendations` 数据由 Home API `/api/v1/home` 返回
+- 当列表为空时不渲染 `service-reco-section` 区块
+- Paused/Successful 用户首页体验符合设计规范（不推荐找对象）
+
+---
+
+## Database Changes
+
+本次无数据库变更。
+
+---
+
+## API Changes
+
+本次无 API 变更。服务建议逻辑在 HomeApplicationService 内部处理。
+
+---
+
+## Frontend Changes
+
+无前端变更。Phase 07 已实现首页对 serviceRecommendations 的渲染。
+
+---
+
+## Automated Tests
+
+- 无新增测试（服务建议为纯业务逻辑，无复杂状态转换）
+- CoreInvariantsTest/RelationshipServiceTest 保持通过
+
+---
+
+## Manual Verification
+
+- [x] buildServiceRecommendations() 正确处理全部5种关系状态
+- [x] searching → matchmaker recommendation ✅
+- [x] getting_to_know → counseling recommendation ✅
+- [x] matched_successfully → premarital recommendation ✅
+- [x] paused → empty list（不推荐任何服务）✅
+- [x] service_exited → empty list（不推荐任何服务）✅
+- [x] 文案符合V1.1非商业化要求（无"脱单"/"优质"等词）✅
+
+---
+
+## Permission & Security Verification
+
+无权限问题。服务建议仅面向已登录用户，且不涉及敏感数据。
+
+---
+
+## Known Issues
+
+无。
+
+---
+
+## Regression Results
+
+- V1.0 推荐引擎（MatchEligibilityService）不受影响
+- V1.0 首页推荐列表不受影响（recommendations 与 serviceRecommendations 独立）
+- **零回归风险**
+
+---
+
+## Documentation Updated
+
+| 文档 | 变更 |
+|------|------|
+| docs/JIRA_BACKLOG.md | EPIC-P12-V11 标记完成 |
+| docs/STATUS.md | Phase 12 标记已完成 |
+
+---
+
+## Next Phase
+
+**Phase 13: 公益红娘服务转介**
+
+重点任务：
+- P13-V11-T01: 转介婚恋咨询
+- P13-V11-T02: 转介公益活动
+- P13-V11-T03: 转介善缘服务站
+- P13-V11-T04: referral source tracking
+- P13-V11-T05: user consent/confirmation
+
+完成后输出 Phase 13 Completion Report，等待下一步指令。