feat: 实现响应候选模型与私有动作消息结构化

新增响应候选领域模型和结构化私有动作消息,支持响应窗口和候选动作下发。主要变更包括:

- 新增 ResponseActionOption、ResponseActionSeatCandidate 和 ResponseActionWindow 模型
- 扩展 PrivateActionMessage 支持响应候选上下文
- 实现 ResponseActionWindowBuilder 构建弃牌响应候选
- 拆分 GameMessagePublisher 支持回合动作和响应动作消息
- 更新前端原型页展示结构化候选动作
- 新增响应优先级规则文档 RESPONSE_RESOLUTION_RULES.md
This commit is contained in:
hujun
2026-03-20 13:04:59 +08:00
parent 24fce055fd
commit 48da7d4990
20 changed files with 1151 additions and 208 deletions

View File

@@ -1,10 +1,15 @@
# 当前执行入口
- 当前 Sprint 文档:`docs/SPRINT_01_ISSUES_BOARD.md`
- Sprint 1 当前进度:`S1-01``S1-02``S1-03` 已完成,推荐的下一个编码任务是 `S1-04`
- `S1-03` 已完成内容:
- `GameEventType` 已补齐未来响应窗口和响应动作事件类型
- `GameEvent` 已新增统一工厂方法,统一现有公共事件和未来响应事件的载荷格式
- `GameSessionService``GameActionProcessor` 的现有公共事件已改为复用统一工厂方法
-新增 `GameEventTest`,验证新增动作事件与标准公共事件的载荷结构
- 当前推荐的后续依赖主线:`S1-04 -> S1-05 -> S1-07`
- 注意:目前新增事件类型仍主要是模型与约定层准备,真实响应窗口和响应动作事件还没有开始实际发出,下一步要用 `S1-04` 补候选动作模型。
- Sprint 1 当前进度:`S1-01``S1-02``S1-03``S1-04``S1-05``S1-06``S1-07` 已完成
- `S1-06` 已完成内容:
- 已新增 `docs/RESPONSE_RESOLUTION_RULES.md`
- 已明确项目 V1 响应优先级:`HU > GANG > PENG > PASS`
- 已明确同优先级裁决按出牌者之后最近顺位优先
-明确当前 V1 不实现完整 `过水不胡``一炮多响`
- 已明确公共消息与私有消息边界,以及后续裁决器接入顺序
- 当前推荐的下一步有两条:
- 文档主线:`S1-08` 对局页信息架构与页面拆分方案。
- 代码主线:开始下一轮“真实响应窗口停顿 + 候选下发 + 裁决器”实现,不再停留在模型和消息层。
- 重要现状说明:
- 后端和前端已经具备结构化响应候选模型与私有消息结构。
- 当前仍未在弃牌后真正暂停主流程等待响应,这是下一轮核心开发点。