215 lines
5.3 KiB
Markdown
215 lines
5.3 KiB
Markdown
# XueZhanMaster 周计划看板
|
||
|
||
本文档用于把阶段目标转成连续数周内可执行的工作安排。
|
||
当前状态快照日期：`2026-03-20`
|
||
|
||
---
|
||
|
||
## 1. 使用说明
|
||
|
||
### 1.1 这份文档解决什么问题
|
||
|
||
- 接下来 1 到 8 周应该先做什么
|
||
- 每周的重点输出是什么
|
||
- 每周结束怎么判断是否过关
|
||
- 如果周目标未完成，怎么顺延
|
||
|
||
### 1.2 计划原则
|
||
|
||
- 以“相对周次”而不是绝对日期表达，便于后续新对话滚动接续
|
||
- 每周只放 1 到 2 个主目标，避免过载
|
||
- 每周必须带可验证产出
|
||
- H5、动作系统、教学边界三者持续联动，不单独割裂推进
|
||
|
||
### 1.3 看板状态定义
|
||
|
||
- `待做`：已排入未来周计划，但尚未开始
|
||
- `进行中`：当前周期重点事项
|
||
- `已完成`：已经形成结果，可进入下一周
|
||
|
||
---
|
||
|
||
## 2. 待做
|
||
|
||
### Week 3 规则闭环与结算骨架
|
||
|
||
- 周目标：
|
||
- 完成胡牌判定主干
|
||
- 明确基础杠分和局终处理
|
||
- 关键任务：
|
||
- 设计结算结果模型
|
||
- 接入基础结算事件
|
||
- 前端增加结算结果展示占位
|
||
- 周产出：
|
||
- 后端规则判定骨架
|
||
- 结算事件定义
|
||
- 结算页面数据结构
|
||
- 周验收：
|
||
- 可从开局走到一轮基础结算
|
||
|
||
### Week 4 H5 正式对局页第一版
|
||
|
||
- 周目标：
|
||
- 完成 H5 对局页结构化改造
|
||
- 关键任务：
|
||
- 拆分 `App.vue`
|
||
- 完成房间页 / 对局页基础路由或页面切换结构
|
||
- 完成手牌区、动作区、事件区布局
|
||
- 周产出：
|
||
- 页面拆分代码
|
||
- H5 布局初版
|
||
- 周验收：
|
||
- `360px` 到 `430px` 宽度可完成当前主流程
|
||
|
||
### Week 5 教学开关与私有教学体验
|
||
|
||
- 周目标：
|
||
- 实现真人玩家独立 AI 教学开关
|
||
- 关键任务：
|
||
- 后端开关接口
|
||
- 前端局内开关组件
|
||
- 私有教学消息按开关发送
|
||
- 周产出：
|
||
- 教学开关完整链路
|
||
- 开关状态说明文档
|
||
- 周验收：
|
||
- A 玩家关闭教学不影响 B 玩家
|
||
|
||
### Week 6 真人邀请与 AI 强度配置
|
||
|
||
- 周目标：
|
||
- 完成房间邀请和补位 AI 强度选择
|
||
- 关键任务：
|
||
- 房间邀请码或邀请链接
|
||
- 房主配置区
|
||
- AI 强度前后端联动
|
||
- 周产出：
|
||
- 房间配置 UI
|
||
- AI 强度配置接口
|
||
- 周验收：
|
||
- 真实房间中可邀请真人，不足 4 人自动补 AI
|
||
|
||
### Week 7 持久化第一阶段
|
||
|
||
- 周目标：
|
||
- 房间与对局会话落库
|
||
- 关键任务：
|
||
- 设计表结构
|
||
- 改造房间和会话查询
|
||
- 增加迁移脚本
|
||
- 周产出：
|
||
- 数据库表
|
||
- 基础持久化服务
|
||
- 周验收：
|
||
- 不再完全依赖内存态
|
||
|
||
### Week 8 复盘与错题本第一版
|
||
|
||
- 周目标：
|
||
- 完成局后复盘最小闭环
|
||
- 关键任务：
|
||
- 决策日志沉淀
|
||
- 复盘结果接口
|
||
- 复盘页和错题本占位
|
||
- 周产出：
|
||
- 复盘接口
|
||
- 复盘页初版
|
||
- 周验收：
|
||
- 每局结束后至少有一个可查看的个人复盘结果
|
||
|
||
---
|
||
|
||
## 3. 进行中
|
||
|
||
### Week 1 动作系统扩展主干
|
||
|
||
- 周目标：
|
||
- 完成 `PENG / GANG / HU / PASS` 的动作模型与统一入口接入
|
||
- 当前背景：
|
||
- 目前统一动作入口已存在，但仅支持 `SELECT_LACK_SUIT / DISCARD`
|
||
- 关键任务：
|
||
- 扩展动作枚举与请求体
|
||
- 扩展动作校验逻辑
|
||
- 扩展事件模型
|
||
- 补动作系统测试
|
||
- 周产出：
|
||
- 后端动作系统主干扩展
|
||
- 前端动作按钮占位
|
||
- 接口说明更新
|
||
- 周验收：
|
||
- 新动作不走专用接口
|
||
- 测试覆盖基本主流程
|
||
- 依赖提醒：
|
||
- 后续 Week 2 的优先级裁决依赖本周结果
|
||
|
||
### Week 2 响应候选与 H5 页面拆解准备
|
||
|
||
- 周目标：
|
||
- 完成响应候选模型，并同步为 H5 正式页面拆分做准备
|
||
- 当前背景：
|
||
- 动作面板最终形态取决于响应候选模型
|
||
- 关键任务：
|
||
- 定义弃牌后的可响应动作候选结构
|
||
- 设计私有动作消息体
|
||
- 梳理 H5 对局页的信息区块
|
||
- 输出页面拆分草图或结构说明
|
||
- 周产出：
|
||
- 响应候选模型说明
|
||
- H5 页面拆分说明
|
||
- 周验收：
|
||
- 下一轮可以直接开始 H5 页面重构
|
||
|
||
---
|
||
|
||
## 4. 已完成
|
||
|
||
### Week 0 工程骨架与最小链路打通
|
||
|
||
- 周目标：
|
||
- 打通前后端最小可运行链路
|
||
- 已完成内容：
|
||
- Spring Boot 与 Vue 3 工程建立
|
||
- 房间流跑通
|
||
- 开局与 AI 补位
|
||
- 定缺与出牌
|
||
- WebSocket 公私消息骨架
|
||
- H5 原型页面
|
||
- 验收结果：
|
||
- `mvn test` 通过
|
||
- `npm run build` 通过
|
||
|
||
### Week 0.5 文档体系升级
|
||
|
||
- 周目标：
|
||
- 从单一主计划升级为可持续接手的文档体系
|
||
- 已完成内容：
|
||
- 重写 `README`
|
||
- 扩写主计划
|
||
- 新增阶段任务看板
|
||
- 新增周计划看板
|
||
- 新增 Issue 模板看板
|
||
- 验收结果：
|
||
- 新对话可按文档直接继续推进
|
||
|
||
---
|
||
|
||
## 5. 周计划滚动规则
|
||
|
||
### 5.1 每周开始前
|
||
|
||
- 从阶段看板选择 1 到 2 个最高优先级任务
|
||
- 确认前置依赖是否已经满足
|
||
- 明确本周“必须完成”和“可延期”边界
|
||
|
||
### 5.2 每周结束后
|
||
|
||
- 未完成但仍是最高优先级的任务，顺延到下周 `进行中`
|
||
- 已完成的任务，回写到阶段看板的 `已完成`
|
||
- 新暴露出的跨模块风险，补充到主计划风险章节
|
||
|
||
### 5.3 不要这样排周计划
|
||
|
||
- 同一周同时推进规则、H5、持久化、复盘四大块核心开发
|
||
- 只写“优化体验”“完善功能”这种无法验收的目标
|
||
- 不写依赖关系，导致周目标互相卡死
|