木鸡 SteadyGame Alpha 七天冲刺总结
木鸡 SteadyGame Alpha 七天冲刺总结
目录
- 木鸡 SteadyGame Alpha 七天冲刺总结
- 作业信息
- 冲刺结论
- 计划与实际进度
- 这次冲刺完成了什么
- 八位成员的分工与收获
- 团队工作量比例
- 团队协作与 AI 技术员复盘
- 下一阶段安排
- 项目运行与答辩材料
- 项目演示视频
- 证据图片的使用范围
- 冲刺博客与计划来源
作业信息
| 项目 | 内容 |
|---|---|
| 课程 | 202601 福大·软件工程实践 W 班 |
| 作业要求 | 团队第四次作业:站立式会议 + α 冲刺 |
| 团队 | 木鸡 SteadyGame |
| 冲刺周期 | 2026 年 10 月 23 日至 10 月 29 日 |
| 候选版本 | 0.1.0-alpha.6(已有部署地址;线上构建版本与候选版本的对应关系、回滚结果待核验) |
| 答辩 PPT | 木鸡SteadyGame_Alpha阶段答辩(WPS 云文档) |
| 代码仓库 | SteadyGame CodeArts 仓库 |
冲刺结论
这七天里,我们从统一代码约定和任务边界开始,逐步把摄像头姿态输入、三种玩法、训练轮次、结果提交、保存与数据导出接入同一套工程。按 Day7 当前工作树的可追溯复测记录,前端 35 个测试文件、377 项通过,后端 mvn test 为 73/73;前端构建成功。另有其他工作树的测试数字,本文不与当前复测合并统计。自动化结果说明代码规则、接口契约和测试数据库中的部分持久化路径经过回归;它不等于真实手机摄像头、完整 MySQL 业务链路和部署环境均已验收。Day7 仍把 8 SP 留给真实设备训练、真实 MySQL 端到端与非空 CSV/PDF 导出验证,以及部署版本核对和回滚演练。
自动化结果说明代码层面的规则、接口契约和测试数据库中的部分持久化路径经过了回归;它不等于真实手机摄像头、完整 MySQL 业务链路和部署环境均已验收。Day7 仍把 8 SP 留给真实设备训练、真实 MySQL 端到端与非空 CSV/PDF 导出验证,以及部署版本核对和回滚演练。现已提供网站部署地址,但仅凭地址可访问不能确认线上构建与候选版本一致,也不能代替上述验收。因此,本次交付应称为 Alpha 候选版本,不写成所有真实环境链路均已验收。
计划与实际进度
七天计划把工作分成两段:前六天实现和集成,第七天集中测试。目标链路是“摄像头与姿态输入—玩法运行—服务端轮次—结果提交—用户明确同意保存—历史和统计—公开榜单—导出文件”。计划也要求固定样例、自动化测试、真实设备验证分别记录,不能互相替代。
| 日期 | 计划重点 | 日报记录的实际进展与边界 |
|---|---|---|
| Day1 · 10/23 | 统一工程协作规则、职责、接口与状态约定。 | 当天主要制定代码规范、回应上次答辩中系统设计图和模块职责表达的问题,并排定后续任务;正式功能开发从 Day2 开始。 |
| Day2 · 10/24 | 建立轮次、摄像头/姿态输入和玩法规则的并行开发基础。 | 形成服务端轮次和同意流程、摄像头与姿态输入、三种玩法骨架等模块进展。固定输入用于玩法规则开发;代码骨架或模拟输入不作为真实体感验收。 |
| Day3 · 10/25 | 将真实倾斜接入小球,推进共用碰撞和三种结果入口。 | 小球校准、倾斜映射和结果校验路径继续推进;切水果和八段锦主要用固定轨迹或特征样例验证规则。真实摄像头稳定性、结果入库和完整页面链路仍须分项验证。 |
| Day4 · 10/26 | 串起三种玩法最短闭环,统一轮次、结果与保存边界。 | 玩法生命周期、临时结果、明确保存和身份归属等工作继续集成。八段锦样例通过不代表真实识别通过;保存、历史与统计也不能只凭接口存在判为端到端完成。 |
| Day5 · 10/27 | 对齐玩法规则,打通历史、统计、公开选择和导出下载。 | 规则回放、页面状态和异步导出任务取得进展;导出可创建、查询并下载,但当时下载文件只有 CSV 表头,不能据此宣称真实训练记录已成功导出。 |
| Day6 · 10/28 | 收口主流程、修正幂等键、整理候选配置与部署/回滚说明。 | 候选版本统一为 0.1.0-alpha.6;训练页接入协调器,导出请求改用合法 UUID 幂等键,补充生产配置和 runbook。日报记录 22 个路由、11 张表及部分真实 MySQL/HTTP 检查,但路由覆盖不等于 22 个业务链路都已完成,候选版也未部署。 |
| Day7 · 10/29 | 不扩展业务,集中回归、修复和验收。 | 当前工作树复测为前端 377/377(35 个测试文件)、后端 73/73,前端构建成功;仍有真实设备、摄像头、完整 MySQL 轮次链路、非空 CSV/PDF 和部署/回滚等未验证项。 |
这次冲刺完成了什么
协作和契约方面,Day1 将命名、共享类型、接口字段、异常处理、隐私、分支提交与评审方式写成共同约定;随后以 Apifox 契约和系统设计作为接口实现依据。开发中逐步明确了前端状态与服务端轮次状态、结果提交与保存、浏览器摄像头权限与服务端同意记录之间的区别。
训练主流程方面,协调器承担准备、运行、暂停、恢复、结束、提交和结果展示等生命周期转换。摄像头与姿态资源在离开流程时释放;恢复前重新检查本地输入准备状态和服务端轮次状态;提交失败时保留冻结结果以供重试。Day6 的页面流程复用准备阶段创建的轮次,避免再次创建。
玩法规则方面,小球、切水果和八段锦逐渐采用统一生命周期和结果入口。固定 seed、轨迹或特征样例让计时、碰撞、阶段转换、暂停恢复和结果字段可以重复验证。它们能证明对应规则在给定输入下的行为,不能代替真实摄像头输入或真人体验。八段锦不采用分数时保留 score: null,避免把“没有分数”误记成零分。
数据和导出方面,团队持续补充服务端身份归属、结果校验、保存同意、重复提交、数据库约束、导出任务状态和文件下载检查。导出任务采用异步流程和 Idempotency-Key;Day6 修复了前端使用的 key 必须符合 UUID 契约的问题。导出队列有自动化集成测试验证任务进入 succeeded 并生成 CSV 文件。不过,团队 Day7 汇总仍将非空 CSV/PDF 与真实记录端到端核验列为剩余工作,所以自动化生成能力不能被写成完整业务导出已验收。
另有一份旧 review 工作树归档了独立 HTTP + H2 集成流程:测试客户端创建游客轮次、登录并启动轮次、提交小球结果、显式保存,再设置榜单同意并查询榜单。该记录不计入上面的当前工作树 377/73 项测试统计,也不代表真实摄像头识别、真实 MySQL 端到端或真人完成的游戏。
测试和移动适配方面,Day7 当前工作树记录前端 377 项、后端 73 项通过;移动页面按 390×844 检查布局和页面状态。团队还补充了接口路由与 OpenAPI 的契约核对、数据库迁移/约束测试、规则回放和生命周期回归。页面四态和自动化测试通过不等于手机摄像头、光照遮挡、真实帧率或公网部署通过。
当前 npm audit 全量审计发现 2 项高危开发依赖问题;npm audit --omit=dev 的生产依赖审计为 0 项。Maven 测试以 BUILD SUCCESS 结束,但日志有 JaCoCo 0.8.12 无法插桩 Java 26 class file major version 70 的兼容告警;该告警不改变本次测试通过结果,但这次运行的覆盖率插桩不能据此视为可靠覆盖率数据。
八位成员的分工与收获
以下分工按七天计划和日报整理;心得根据各模块的实际记录归纳,发布前请成员本人确认措辞。
| 成员 | 主要工作 | 本次冲刺的收获 |
|---|---|---|
| 林晨 | 项目架构与集成;GameCoordinator、轮次生命周期、CSRF/退出、统一结果网关和导出任务。 | 接口返回成功只是链路中的一个节点;还要检查任务状态、实际文件、数据内容和失败重试,不能把路由存在写成业务完成。 |
| 郑雯心 | 摄像头授权与资源管理、姿态模型生命周期、姿态快照生产和错误恢复。 | 用户授予权限不代表视频持续可用;异步回调还要防止旧模型或旧页面生命周期污染新会话。 |
| 王婉怡 | CV 字典、姿态质量门控、坐标转换、校准、MotionMapper 和输入特征。 | 输入无效时保留明确的无效状态比填入 0 更可靠;固定姿态样例可以验证映射逻辑,却不能证明真人识别精度。 |
| 林宇扬 | 小球玩法规则、生命周期、Canvas 表现和结果验证。 | 固定 seed 与输入轨迹让结果能够重复复现;这比只看到一次“跑通”更便于定位计时、碰撞和计分差异。 |
| 林凯 | 切水果玩法、共用扫掠碰撞检测、结果链路和相关数据库/导出回归。 | 玩法应复用几何事实但保留自己的计分规则;数据归属由服务端判断,幂等比较要基于规范化结果。 |
| 李想 | 八段锦阶段机、动作尝试记录和结果字段。 | 固定脚本可以把阶段顺序、保持计时和恢复行为从现场光线等变量中分离;无评分玩法不应伪造数值分数。 |
| 孙田田 | 页面与 Canvas 展示,以及目录、历史、统计、报告和排行榜页面。 | 页面应清楚区分样例与真实数据;页面状态完整、布局通过检查,并不自动证明后端数据链路已经打通。 |
| 刘婷婷 | 账号与身份、共享 Repository、结果校验、保存事务、数据访问和下载安全。 | 契约覆盖测试证明路由没有遗漏,不能证明业务都完成;归属、同意、事务和异常路径需要分别验证。 |
团队工作量比例
| 成员 | 本次贡献度 |
|---|---|
| 林晨(组长) | 12% |
| 郑雯心 | 12% |
| 王婉怡 | 12.5% |
| 林宇扬 | 12.5% |
| 林凯 | 13% |
| 孙田田 | 13% |
| 李想 | 12.5% |
| 刘婷婷 | 12.5% |
| 合计 | 100% |
团队协作与 AI 技术员复盘
我们采用按模块负责、共享契约、逐步集成的方式推进。摄像头与 CV 提供统一输入,玩法模块消费输入并冻结结果,协调器管理生命周期,服务端负责轮次、身份、校验与保存,页面负责呈现。固定输入让规则开发可以并行;集成时再把模拟输入替换为真实输入,并单独留下现场验收证据。冲刺中暴露出的教训是:共同依赖如果没有清楚的输入输出和失败边界,会把“各自有代码”误当成“链路已完成”。
AI 技术员按 AI 设计师、AI 程序员、AI 测试员等角色参与了资料整理、代码规范与答辩问题归纳、接口/规则核对、代码和测试辅助、缺陷定位及文档整理。团队成员仍需审核 AI 输出、按项目契约修正,并用实际构建、测试或运行结果确认。AI 生成的代码或说明本身不是验收证据;未运行的测试、未使用真实设备的场景、没有实际数据的导出都不能因此改写为已通过。
下一阶段准备把 AI 用在边界明确且容易核验的任务上:提供相关文件、接口契约、错误现象和期望行为;要求输出可审查的最小改动及对应验证步骤;由模块负责人检查权限、数据归属、状态转换和失败路径;运行真实测试后再记录结果。遇到冲突时以仓库代码、接口契约和团队确认的验收标准为准,不把未经核验的建议直接写入交付材料。
下一阶段安排
下一阶段先围绕 Day7 留下的 8 SP 清单完成真实环境验收,再决定是否进入 Alpha 发布:
- 在目标华为手机和浏览器上验证摄像头授权、模型加载、训练输入、暂停/恢复、退出释放和异常恢复,记录机型、浏览器、光照与结果。
- 用真实数据库轮次完成三种玩法的结果提交、明确保存、历史/统计查询;检查账号归属和游客转存边界。
- 用有真实已保存记录的数据生成 CSV 和 PDF,检查任务状态、文件内容、下载响应及过期/失败行为。
- 核对当前部署站点对应的构建号和配置,完成回滚演练并记录结果;在确认前不将部署站点等同于候选版本验收通过。
- 由非修复人交叉复核验收用例,补齐 Issue 状态、提交关联和证据链接;只对已执行场景给出“通过”。
项目运行与答辩材料
- 代码仓库: SteadyGame CodeArts 仓库(需登录华为云 CodeArts 并有项目权限)。这是源码入口;在线站点见下方部署地址。
- 部署地址: SteadyGame 在线站点(访问检查返回 HTTP 200;线上构建与
0.1.0-alpha.6的对应关系尚未核验)。 - 测试记录: Day7 CSDN 测试记录。
- 现有网页运行画面:证据包有玩法选择、摄像头同意、模拟训练、暂停和模拟结果页面;训练画面是本地模拟,准备截图没有获取摄像头或采集真人姿态,不能当作真实体感演示。
- 答辩 PPT:《木鸡SteadyGame_Alpha阶段答辩》。
项目演示视频
证据图片的使用范围
以下 19 张证据图片已上传至 CSDN 图床,点击图片名称可查看原图。
- 网页运行(本地模拟):玩法选择页、训练中(模拟)、暂停(模拟)、结果页(模拟)。
- HTTP 接口响应(旧 review 工作树的内嵌 Tomcat + H2 记录):创建轮次、启动轮次、提交结果、保存记录、榜单同意、查询榜单。这些图片不作为当前工作树 377/73 复测的截图。
- 自动化验证截图(旧 review 工作树归档结果,不是当前工作树复测):前端测试结果、前端构建结果、后端测试结果、npm audit 结果。当前工作树的测试摘要见 Day7 测试记录;全量
npm audit有 2 项高危开发依赖问题,生产依赖审计为 0 项。终端 PNG 是原始日志排版摘录;原始文本也在本地证据目录。 - Issue 图片:Day6 工作项 #71208915、Day7 工作项 #71210913。两张分别标注 Day6、Day7,不要互相替代。
- 代码证据:轮次创建与状态切换、结果提交校验、榜单同意审计。代码图按仓库源码生成,非 IDE 原屏截图。
冲刺博客与计划来源
相关推荐
产业园区如何高效对接企业技术需求与高校科研成果?.docx
科易网基于AI模型+行业大数据,在技术转移、成果转化、技术经纪、知识产权、产业创新、科技招商等垂直领域的多样化应用场景,推出科技创新领域的AI+工具与数智化解决方案,推动科技创新与产业创新智能化发展。
国央企创新负责人如何快速掌握本地科技资源分布与匹配情况?.docx
科易网基于AI模型+行业大数据,在技术转移、成果转化、技术经纪、知识产权、产业创新、科技招商等垂直领域的多样化应用场景,推出科技创新领域的AI+工具与数智化解决方案,推动科技创新与产业创新智能化发展。
国央企创新负责人如何实现科技成果的精准识别与高效筛选?.docx
科易网基于AI模型+行业大数据,在技术转移、成果转化、技术经纪、知识产权、产业创新、科技招商等垂直领域的多样化应用场景,推出科技创新领域的AI+工具与数智化解决方案,推动科技创新与产业创新智能化发展。
数据挖掘实战:决策树 + 聚类 + 关联规则,零 Key 离线可跑(Python 源码)
数据挖掘实战包。用 Python 标准库实现 CART 风格决策树、K-Means 聚类与 Apriori 关联规则,在虚构「星河便利店」会员表和购物篮上跑通分类、分群与购物篮分析,并给出准确率、轮廓系数、支持度/置信度/提升度。零第三方依赖、零 API Key 即可离线跑通。含 4 个样例、离线冒烟、中文 README(含「使用方法」)。均为作者原创可运行源码。MIT。作者 blog.csdn.net/mtl1994
高校技术转移办公室人员如何系统化管理科技成果信息?.docx
科易网基于AI模型+行业大数据,在技术转移、成果转化、技术经纪、知识产权、产业创新、科技招商等垂直领域的多样化应用场景,推出科技创新领域的AI+工具与数智化解决方案,推动科技创新与产业创新智能化发展。


