[T.13] 团队项目：Alpha 阶段项目展示

类目	详情内容
所属课程	2026年春季软件工程
作业要求	[T.13] 团队项目：Alpha 阶段项目展示
课程目标	团队合作经过两轮迭代完成软件开发实践
作业价值	完成alpha阶段开发展示

项目与团队亮点

团队成员与分工简介

成员	角色	开发中负责的内容	alpha阶段分数
王天一	PM、前端负责人	设计、美化页面，审阅 PR，绘制部分美术素材	52
熊熙恺	副 PM、后端负责人	后端开发，辅助前端部分动画素材制作与 bug 修复	54
高藩	前端开发	人物、动作的渲染，事件特效渲染	49
蔡世源	前端开发	各项 UI 美工制作，界面美化	50
林子淇	策划、部署	boss 战策划与制作，游戏部署，辅助前端 boss 战部分开发	47
刘逸夫	小游戏开发	负责小游戏的规划以及前后端全流程制作	48

项目管理

• 利用 GitHub 进行项目代码管理。
  
  

• 利用飞书进行进度和分工管理，同时存放共享的文档资料。
  

典型用户场景

4个好朋友聚在一起吃饭，酒足饭饱之后想来一把紧张刺激的小游戏，于是打开了paradice。

输入完昵称之后，wty创建了房间并选择了白虎作为自己的角色

所有人选择完角色并进入房间后，wty开始了游戏

游戏的每一轮都以一个随机的小游戏开始

每轮玩家获得的骰子种类由小游戏排名决定

玩家通过投骰子决定移动的步数，移动完成后会触发随机事件

当玩家经过检查点时可以抽取道具

每3回合，对于选择了有技能角色的玩家，可以使用一次角色技能

当玩家到达了boss格，需要通过投骰子来对boss进行攻击

如果玩家死亡了，会在自己身后离自己最近的检查点复活

wty将boss打死了，获得了游戏的胜利

游戏特色

小游戏

1. 数秒：点击开始后在心中默数5秒，点击停止时，时间最接近5秒的玩家获胜
   
   
   

2. 算数
   
   

3. 彩虹记忆：记住所有颜色的位置，并根据要求进行点击，点击位置正确且最快的人获胜

4. 游标卡尺：玩家按下stop按钮时，滑块中心线举例屏幕中心最近的玩家获胜

buff

目前有8种随机buff，4种角色buff和1种boss专有buff

道具

目前包含3种道具：

• 反方向的种：让目标玩家下一回合反向移动
• 任意门：瞬移到指定玩家身边（20格以内）
• 骰子升级卡：升级骰子种类

项目发布时的团队努力

通过github release与网页链接进行发布。

下载地址：https://github.com/b1tAction/paraweb/releases

在线游玩地址：https://bitaction.cn/game/paradice

创建测试群并在水群中进行宣传

软件工程质量

Git 协作规范

• 为 master 和 dev 分支设置 ruleset 进行保护。
• 前后端代码分开管理，成员提交 PR 后需经由前后端管理者审阅代码修改，并进行合并。
  

开发文档

开发过程中对重要内容形成文档，方便留档与协作。

文档目录示例

doc/
├── internal/
│   ├── core.md
│   ├── event_bus_system.md
│   ├── gamemap.md
│   ├── hsm_design.md
│   ├── metadata.md
│   ├── nakama.md
│   ├── net_protocol.md
│   ├── rng_engine.md
│   └── yaml_definitions.md
├── metadata/
│   ├── action_context.md
│   ├── buff.md
│   ├── event_context.md
│   ├── hsm_context.md
│   ├── logentry.md
│   ├── player.md
│   ├── README.md
│   └── round_data.md
├── background.md
├── cli_interaction.md
├── cli_testing_plan.md
├── client_server_interaction.md
├── error_handling_design.md
├── frontend_backend_protocol.md
├── protocol_hsm_interaction.md
├── server_startup.md
└── technical_plan.md

环境部署

项目在生产部署方面做了以下努力：

• 后端使用 Docker 运行开发和生产环境，并通过 Makefile 封装了常用开发命令。
• 生产环境使用 Nginx 统一承接对外资源。前端构建后的静态文件由 Nginx 提供，后端实时通信则由 Nginx 转发到 Nakama，前后端部署路径在服务器上保持一致。
• 后端、前端和官网首页的源代码仓库分别配置 GitHub Actions，构建出产物后传输到服务器进行部署。后端发布前会执行 Go 依赖校验、测试和构建检查，再把源码归档传输到服务器上用部署脚本激活；前端和官网先构建 dist/，再上传到服务器 release 目录并切换线上版本。
• 游戏 网页版 设置了素材预加载以优化网络性能，桌面版设置了更新提示，提醒用户更新。部署流程会生成版本清单，并结合 Service Worker、资源清单、预压缩和缓存策略，缓解版本更新后缓存未同步的问题，同时优化首次加载时的游戏体验。

测试

核心状态机、引擎、Nakama 适配、网络协议、工具包均有对应测试；CI 方面已配置 GitHub Actions，至少包含 go test、开发构建、CLI 构建 3 类自动任务，代码提交后具备基础自动校验能力。