6bcdf26fca
- 后端实现最小正式版过水不胡规则：玩家在响应窗口选择PASS后，直到下次摸牌前不能响应胡 - 完善GameSeat状态管理，新增passedHuBlocked字段及相关方法 - 在ResponseActionWindowBuilder和GameActionProcessor中增加过水不胡校验 - 前端重构动作面板，区分回合动作和响应动作，支持多用户视角切换 - 优化公共事件处理逻辑，自动清理失效的私有动作面板 - 更新相关文档说明当前实现的规则范围和工程取舍 - 补充测试用例验证过水不胡规则的正确性
9.9 KiB
9.9 KiB
XueZhanMaster 阶段任务看板
本文档把主计划拆成可以直接推进的阶段任务卡。
当前状态快照日期：2026-03-20
1. 使用说明
1.1 本文档解决什么问题
- 当前项目整体还有哪些阶段没有完成
- 每个阶段到底要交付什么
- 什么算开始、什么算完成
- 当前应该先推哪个阶段
1.2 看板状态定义
待做：已确认进入路线图，但尚未实质启动进行中：已有代码、文档或设计工作在推进已完成：阶段目标的最小闭环已经形成
1.3 卡片字段说明
每个任务卡尽量包含：
- 编号
- 所属阶段
- 目标
- 核心任务
- 产出物
- 前置依赖
- 验收标准
- 风险提示
2. 待做
P2-02 响应窗口与优先级裁决
- 所属阶段：
M2 动作系统扩展 - 目标：在出牌后正确生成候选响应，并按血战到底规则裁决动作优先级
- 核心任务：
- 设计响应窗口模型
- 识别
HU / GANG / PENG / PASS候选 - 统一裁决优先级
- 处理多人同时可响应的场景
- 产出物：
- 后端优先级裁决逻辑
- WebSocket 私有候选动作消息
- 规则说明文档补充
- 前置依赖：
P2-01基础动作枚举与统一入口扩展
- 验收标准：
- 对任一弃牌都可给出正确响应候选
- 多人竞争时能按约定优先级决议
- 未行动玩家不会被错误推进回合
- 风险提示：
- 容易绕开统一动作入口
- 容易混淆公共事件与私有候选动作
P3-01 血战到底规则闭环与结算
- 所属阶段：
M3 规则与结算 - 目标：完成基础胡牌判定、杠分与局终处理
- 核心任务：
- 胡牌判定
- 基础番型与分数策略
- 杠分处理
- 单局结束条件
- 血战到底继续流程
- 产出物：
- 规则判定服务
- 结算结果模型
- 结算事件与状态落地
- 前置依赖：
P2-01P2-02
- 验收标准：
- 能从开局走到完整结算
- 胡牌与流转状态一致
- 结算结果可被前端展示
- 风险提示：
- 规则理解偏差会导致后续复盘失真
P4-02 正式 H5 对局页面
- 所属阶段：
M4 H5 正式对局体验 - 目标：把当前原型操作台升级为真正可玩的 H5 对局页
- 核心任务：
- 页面拆分为房间页 / 对局页 / 复盘页
- 手牌区、弃牌区、信息区、动作区布局
- 私有教学卡片和展开逻辑
- 弱网下状态提示和重连提示
- 产出物：
- 页面组件结构
- H5 样式方案
- 手工验收记录
- 前置依赖：
- 当前
App.vue原型 - 基础动作消息和教学消息保持稳定
- 当前
- 验收标准：
360px到430px宽度可完整操作- 不依赖开发辅助信息也能完成主流程
- 公共区域与私有教学区域清晰
- 风险提示：
- 页面过度堆信息会造成遮挡和误触
P5-01 真人邀请与 AI 强度配置
- 所属阶段：
M4 H5 正式对局体验+M5 教学系统扩展 - 目标：支持房间邀请、AI 补位强度选择和真实多人协作体验
- 核心任务：
- 房间邀请码或链接
- AI 补位强度选择
- 房主视角的房间管理区
- 未满 4 人时自动补位策略
- 产出物：
- 房间配置接口
- 前端房间配置 UI
- 强度枚举说明
- 前置依赖：
- 房间流稳定
- 验收标准：
- 能邀请真人加入
- 缺人时 AI 自动补位
- 补位 AI 强度对外可配
P5-02 玩家独立 AI 教学开关
- 所属阶段：
M5 教学系统扩展 - 目标：允许每位真人玩家独立开关自己的 AI 教学，不影响其他人
- 核心任务：
- 教学开关接口
- 玩家偏好模型
- 私有消息按玩家开关发送
- 前端局内教学开关控件
- 产出物：
- 开关接口
- 前端开关交互
- 教学开关状态同步策略
- 前置依赖：
- 私有教学消息通道稳定
- 验收标准：
- 任一真人关闭教学后，不再收到自己的教学消息
- 其他玩家不受影响
- 开关状态在当前局中持续有效
P6-01 房间与对局持久化
- 所属阶段：
M6 持久化与稳定性 - 目标：将关键房间与对局状态从内存态过渡到数据库
- 核心任务：
room / room_seat / game_session落库- 状态恢复策略
- 查询接口切换
- 基础迁移脚本
- 产出物：
- 数据表
- Repository / Mapper
- 持久化后的服务层改造
- 前置依赖：
- 房间与对局主干稳定
- 验收标准：
- 服务重启后关键状态可恢复或可追踪
- 房间和对局查询不依赖纯内存态
P6-02 WebSocket 鉴权与重连恢复
- 所属阶段：
M6 持久化与稳定性 - 目标：补足实时系统的身份边界和弱网恢复能力
- 核心任务：
- 连接鉴权
- 私有主题与用户绑定
- 前端重连策略
- 重连后状态重拉
- 产出物：
- 鉴权方案
- 前端重连流程
- 异常提示规则
- 前置依赖：
- 基础持久化能力
- 验收标准：
- 私有消息不能被其他玩家订阅
- 弱网重连后可恢复当前视角状态
P7-01 局后复盘与错题本
- 所属阶段：
M7 复盘与成长闭环 - 目标：构建“对局结束后还能继续学”的成长系统
- 核心任务：
- 决策日志沉淀
- 局后个人复盘生成
- 关键错误点提取
- 错题本模型
- 产出物：
- 复盘接口
- 复盘页
- 错题本结构
- 前置依赖：
- 规则与结算稳定
- 教学解释链路稳定
- 验收标准：
- 每局结束后可获得个人复盘
- 可沉淀到错题本并二次查看
3. 进行中
P2-01 动作系统扩展主干
- 所属阶段：
M2 动作系统扩展 - 目标：把当前仅支持
SELECT_LACK_SUIT / DISCARD的动作系统扩成麻将主干动作系统 - 当前状态：
- 已有统一动作入口
- 已有
GameActionProcessor骨架 - 已有事件流与私有动作消息通道
- 核心任务：
- 扩展动作枚举
- 定义
PENG / GANG / HU / PASS请求模型 - 统一动作校验
- 动作执行后产生标准事件
- 当前卡点：
- 需要明确响应候选模型与优先级裁决机制
- 产出物：
- 扩展后的动作处理器
- 新动作测试
- 前端动作按钮映射
- 验收标准：
- 所有新增动作仍通过同一入口提交
- 执行后状态与事件同步一致
P4-01 H5 体验重构设计
- 所属阶段：
M4 H5 正式对局体验 - 目标：在不打断当前可运行原型的前提下，拆出正式 H5 页面结构
- 当前状态：
App.vue已覆盖房间流和局内主操作- WebSocket 已可接公共事件、私有动作、私有教学
- 核心任务：
- 梳理房间页、对局页、复盘页的信息架构
- 定义移动端布局分区
- 明确教学面板和动作面板的层级
- 当前卡点：
- 动作系统仍在扩展，最终动作面板尚未稳定
- 产出物：
- 页面拆分方案
- 状态模型拆分方案
- H5 交互清单
- 验收标准：
- 页面拆分方案可直接指导下一轮前端编码
4. 已完成
DOC-01 文档体系升级
- 所属阶段：跨阶段支撑任务
- 目标：把原先偏概述的计划文档升级成“主计划 + 阶段任务 + 周计划 + Issue 模板”体系
- 已完成内容：
- 扩写主计划
- 新增阶段任务看板
- 新增周计划看板
- 新增 Issue 模板看板
- 更新 README 索引
- 验收结果：
- 新对话仅通过阅读文档就能接着推进
P0-01 项目骨架初始化
- 所属阶段：
M1 房间流与单局主干 - 目标：建立前后端可运行的最小工程骨架
- 已完成内容：
- Spring Boot 后端初始化
- Vue 3 + Vite 前端初始化
- 基础目录结构建立
- 验收结果：
- 后端可启动
- 前端可启动和构建
P1-01 房间流闭环
- 所属阶段：
M1 房间流与单局主干 - 目标：完成建房、入房、准备、开局的基本流程
- 已完成内容：
- 创建房间
- 查询房间
- 加入房间
- 准备 / 取消准备
- 房主开局
- 验收结果：
- 真人房间流已可操作
P1-02 不满 4 人自动补 AI
- 所属阶段：
M1 房间流与单局主干 - 目标：开局时自动补齐 AI，形成最小对局环境
- 已完成内容：
- 未满 4 人自动补 AI
- AI 强度枚举骨架
- 验收结果：
- 可在真人人数不足时启动单局
P1-03 对局主干与定缺
- 所属阶段：
M1 房间流与单局主干 - 目标：建立从开局到定缺再到正式出牌的最小对局阶段流转
- 已完成内容：
- 生成
GameSession - 真人定缺
- 全员定缺后进入
PLAYING
- 生成
- 验收结果：
- 单局进入可出牌状态
P1-04 统一动作入口初版
- 所属阶段：
M1 房间流与单局主干 - 目标：避免为不同动作堆散乱接口
- 已完成内容：
POST /api/games/{gameId}/actions- 当前支持
SELECT_LACK_SUIT与DISCARD - 保留兼容接口
- 验收结果：
- 当前动作已统一进入动作处理链
P1-05 AI 自动推进与事件骨架
- 所属阶段：
M1 房间流与单局主干 - 目标：在真人出牌后推动 AI 行动，直到回到真人回合
- 已完成内容：
- 真人出牌
- AI 自动推进回合
- 事件列表与事件类型骨架
- 验收结果：
- 单局能持续推进，不停在第一步
P1-06 WebSocket 公私消息骨架
- 所属阶段：
M1 房间流与单局主干 - 目标：建立公共事件和私有消息分离的实时链路
- 已完成内容：
- STOMP 配置
- 公共事件主题
- 私有动作主题
- 私有教学主题
- 验收结果：
- 前端已可订阅三类主题
P1-07 H5 原型操作台
- 所属阶段：
M1 房间流与单局主干 - 目标：让移动端先具备完整主流程操作能力
- 已完成内容：
App.vue支持建房、入房、准备、开局、定缺、出牌- 已接入 STOMP 订阅
vite.config.ts已代理/api和/ws
- 验收结果：
- H5 原型页面可走通当前最小链路