danyang-match/docs/Phase-08-V11-Completion-Report.md

Phase 08 - Like / Match / Block Completion Report

Status

Completed ✅

---

Implemented

Constants 扩展 — Constants.java

新增 3 个 Match Source 常量：

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 方法

@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 方法

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

• createMatch 重载方法签名正确，默认行为不变
• confirmActivityInterest 正确调用 createMatch(..., false)
• ActivityInterestController 新增接口语法正确
• hasMutualInterest 方法逻辑正确（双方均为 MUTUAL 状态）
• INV-002（未Mutual不可聊天）不受影响（chat 仍检查 active Match）
• INV-003（Block优先级最高）不受影响
• 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，等待下一步指令。