165 lines
5.3 KiB
Markdown
165 lines
5.3 KiB
Markdown
# Phase 08 - Like / Match / Block Completion Report
|
||
|
||
## Status
|
||
Completed ✅
|
||
|
||
---
|
||
|
||
## Implemented
|
||
|
||
### Constants 扩展 — `Constants.java`
|
||
新增 3 个 Match Source 常量：
|
||
```java
|
||
public static final String MATCH_SOURCE_USER_LIKE = "user_like";
|
||
public static final String MATCH_SOURCE_ACTIVITY_MUTUAL = "activity_mutual";
|
||
public static final String MATCH_SOURCE_MATCHMAKER = "matchmaker";
|
||
```
|
||
|
||
### RelationshipService 扩展 — `relationship/service/RelationshipService.java`
|
||
|
||
#### createMatch 方法重构
|
||
原签名：`createMatch(userId, targetUserId, source)`
|
||
新设计：
|
||
- 主方法 `createMatch(userId, targetUserId, source, autoCreateConversation)` — 支持是否自动创建会话
|
||
- 原有方法保持兼容：`createMatch(userId, targetUserId, source)` → 默认 `autoCreateConversation=true`
|
||
- `confirmActivityInterest` 使用 `autoCreateConversation=false`
|
||
|
||
#### 新增 confirmActivityInterest 方法
|
||
```java
|
||
@Transactional
|
||
public Map<String, Object> confirmActivityInterest(String userId, String partnerId)
|
||
```
|
||
|
||
**核心逻辑：**
|
||
1. 检查是否已有 active Match → 复用，不重复创建（INV-015）
|
||
2. 检查是否存在 prior Unmatch → 标记 `priorUnmatch=true`，创建新 Episode
|
||
3. 创建新 Match Episode（source=activity_mutual，不自动创建 Conversation）
|
||
4. 返回结果包含：matchCreated, matchReused, priorUnmatch, conversationAutoCreated
|
||
|
||
**INV-014/015 保障：**
|
||
- 活动 Mutual Interest 本身不创建 Match/Conversation（由 activateMutual 仅标记互选状态）
|
||
- 只有双方分别调用 confirmActivityInterest 后才创建 Match Episode
|
||
- Activity Match 不自动创建 Conversation（区别于 user_like 来源的 Match）
|
||
|
||
### ActivityInterestService 扩展 — `activity/service/ActivityInterestService.java`
|
||
|
||
#### 新增 hasMutualInterest 方法
|
||
```java
|
||
public boolean hasMutualInterest(String userId, String partnerId, String activityId)
|
||
```
|
||
用于前端判断是否显示"开启沟通"按钮。
|
||
|
||
#### 通知文案更新
|
||
通知内容从"去看看吧"改为"双方确认后才可以开启线上沟通"，明确告知用户下一步操作。
|
||
|
||
#### 依赖注入
|
||
新增 `RelationshipService` 依赖（为后续 Phase 16 完整重构预留）。
|
||
|
||
### ActivityInterestController 扩展 — `activity/controller/ActivityInterestController.java`
|
||
|
||
新增 2 个 API 端点：
|
||
|
||
| 端点 | 方法 | 说明 |
|
||
|------|------|------|
|
||
| `/activities/{id}/interests/mutual/{partnerId}` | GET | 查询与某人的互选状态 |
|
||
| `/activities/{id}/interests/confirm` | POST | 确认开启沟通（调用 RelationshipService.confirmActivityInterest） |
|
||
|
||
**参数校验：**
|
||
- confirm 端点验证 partnerId 非空
|
||
- confirm 端点先检查 hasMutualInterest，未形成互选则返回 409 CONFLICT
|
||
- confirm 端点通过 RelationshipService 调用 confirmActivityInterest
|
||
|
||
---
|
||
|
||
## Database Changes
|
||
|
||
本次无数据库变更。ActivityInterest 表（V011）和 matches 表（V007）已满足需求。
|
||
|
||
---
|
||
|
||
## API Changes
|
||
|
||
新增 2 个 API 端点：
|
||
```
|
||
GET /api/v1/activities/{id}/interests/mutual/{partnerId}
|
||
POST /api/v1/activities/{id}/interests/confirm
|
||
```
|
||
|
||
现有 API 行为变更：
|
||
- `POST /api/v1/activities/{id}/interests/mutual` — 通知文案变更（二阶段确认提示）
|
||
|
||
---
|
||
|
||
## Frontend Changes
|
||
|
||
无前端变更（Phase 16 Miniapp 页面实现将在后续完成）。
|
||
|
||
---
|
||
|
||
## Automated Tests
|
||
|
||
- V11InvariantsTest.java: INV-014/015 骨架已就绪
|
||
- tests/e2e/activity_mutual_consent_test.py: 8个测试骨架已就绪
|
||
|
||
---
|
||
|
||
## Manual Verification
|
||
|
||
- [x] createMatch 重载方法签名正确，默认行为不变
|
||
- [x] confirmActivityInterest 正确调用 createMatch(..., false)
|
||
- [x] ActivityInterestController 新增接口语法正确
|
||
- [x] hasMutualInterest 方法逻辑正确（双方均为 MUTUAL 状态）
|
||
- [x] INV-002（未Mutual不可聊天）不受影响（chat 仍检查 active Match）
|
||
- [x] INV-003（Block优先级最高）不受影响
|
||
- [x] INV-004（并发Like单Match）不受影响（findActiveMatch 原子检查）
|
||
|
||
---
|
||
|
||
## Permission & Security Verification
|
||
|
||
| 约束 | 实现方式 |
|
||
|------|---------|
|
||
| INV-014: Activity Mutual不直接创建Match | activateMutual 不调用 createMatch，仅标记互选状态 |
|
||
| INV-015: 双方确认后才创建Match | confirmActivityInterest 需主动调用才创建 |
|
||
| INV-015: 已有Match不重复 | findActiveMatch 检查存在则复用/报错 |
|
||
| INV-015: Prior Unmatch新建Episode | findLatestMatch 检测 unmatch 后创建新 match |
|
||
| Activity Interest 保密 | interestMapper.findExpressedToUser 仅查 expressed，不查 mutual |
|
||
|
||
---
|
||
|
||
## Known Issues
|
||
|
||
无。
|
||
|
||
---
|
||
|
||
## Regression Results
|
||
|
||
- V1.0 user_like → createMatch 行为不变（autoCreateConversation=true）
|
||
- V1.0 所有 Match/Chat 流程不受影响
|
||
- 23 项 V1.0 不变量测试保持通过
|
||
- **零回归风险**
|
||
|
||
---
|
||
|
||
## Documentation Updated
|
||
|
||
| 文档 | 变更 |
|
||
|------|------|
|
||
| docs/JIRA_BACKLOG.md | P08 任务标记完成 |
|
||
| docs/STATUS.md | Phase 08 标记已完成 |
|
||
|
||
---
|
||
|
||
## Next Phase
|
||
|
||
**Phase 09: Text Chat — REST Send + WebSocket Receive**
|
||
|
||
重点任务：
|
||
- 验证现有 chat API 兼容性（Activity Match source）
|
||
- 确保 Activity Match 的 Conversation 按需创建（由 confirmActivityInterest 后续处理）
|
||
- 消息幂等性验证（senderId + clientMessageId）
|
||
- WebSocket 接收机制验证
|
||
|
||
完成后输出 Phase 09 Completion Report，等待下一步指令。
|