← 返回首页
项目文档

业务需求文档

角色、功能地图、游戏目录与核心业务流程

小游戏乐园(gamehub)业务需求文档

文档版本:v1.0(2026-11-19)|对应产品状态:gamehub 2026-11-19 代码(体验版发布通道已就绪)

本文档的目的:让接手的开发者(或其 AI Agent)在不读源码的情况下,准确知道每款游戏「应该是什么样」, 以便判断现有实现是否达标、新需求应该落在哪个模块、改动后用什么标准验收。

主读者画像:接手迭代的工程师 / AI Agent;使用环节是「接需求 → 定位模块 → 实现 → 按验收标准自测」; 既有知识假设:会用微信小程序框架与 Node,但不熟悉本项目的游戏规则细节与历史决策; 任务目标:快速定位功能归属并完成迭代;预期阅读时长 15 分钟(先读第 1、2 章,按需查第 3 章); 成功标准:不问原作者即可回答「某款游戏规则是什么、改哪、怎么验收」。

范围:全部 7 款已上线游戏的功能需求、全局通用需求、非功能需求。 本文档不覆盖:技术实现方案与部署步骤(见《小游戏乐园-架构与部署手册.md》); 协作守则与页面进度台账(见《小程序项目档案.md》);尚未立项的新游戏需求(新增时在 §5 追加变更记录)。


1. 产品概述

项 内容
产品定位 微信小游戏聚合平台:按分类 / 标签浏览游戏,一键邀请微信好友同玩,记录战绩
目标用户 想和朋友快速开一局轻量游戏的微信用户,无需注册、无需下载
核心价值 打开即玩(静默登录)+ 好友邀请即达(分享卡片直达房间)+ 多种玩法聚合
游戏数量 7 款,全部已上线可玩(2026-11-19 删除了 5 款「即将上线」占位游戏)

游戏按同步方式分两类,这决定了需求能否作弊、延迟要求、以及代码落点:

类型 游戏 特征
联机游戏(服务端权威) 同词相遇、你画我猜、棋类对战(好友局)、斗地主、记忆翻牌(联机局) 两台设备共享房间状态,结果由云端决定,客户端只发指令
单机游戏(本地计算) 反应大挑战、骰子与硬币、记忆翻牌(单人/同屏双人)、棋类对战(人机局) 不联网、无 RPC 延迟;结果可被改客户端伪造,但无对手无奖励,可接受

2. 全局业务需求

以下需求适用于所有游戏,验收时逐条过。

G-01 静默登录

G-02 游戏目录浏览

G-03 游戏详情与评论

G-04 游玩记录

G-05 分享邀请与房间通用规则

规则 要求
房间号 同词相遇 / 你画我猜 / 棋类 / 联机翻牌 4 位数字;斗地主 6 位数字;唯一索引保证不重复
分享卡片 onShareAppMessage 的 path 携带房间参数,好友点击直达加入界面
加入原子性 同一房间只能被一人抢入;房主重复加入返回原座位(幂等)
恢复 大厅列出「我进行中的房间」,可恢复;掉线重进不丢局(棋类靠 moves 重放)
并发 所有写操作带乐观锁(轮次 / turn / epoch_serial / serial),过期提交被服务端拒绝并提示刷新

3. 各游戏业务需求

3.1 同词相遇 💞(wordmeet,联机)

3.2 记忆翻牌 🃏(memory,单机 + 联机三形态)

3.3 反应大挑战 ⚡(reaction,单机)

3.4 骰子与硬币 🎲(dice-coin,单机)

3.5 你画我猜 🎨(draw-guess,联机)

3.6 棋类对战 ♟️(board-games,人机 + 联机)

3.7 斗地主 🃏(dou-de-zhu,联机)

4. 非功能需求

编号 需求 标准
N-01 发布包体积 主包 ≤ 2MB;当前实测 761 KB;每次改动后跑 node tests/ddz-pkgsize.js
N-02 帧流畅度 手势进行中禁止整表 setData;轮询不得打断进行中的手势或乐观 UI
N-03 隐私合规 .wbapp_*.privacy.json 与微信后台「用户隐私保护指引」内容一致;仅收集昵称与对局输入内容
N-04 异常兜底 云能力不可用时不得白屏:AI 复盘回落本地简析、登录失败落到手动兜底、轮询失败静默重试;房间拉取失败必须重试 + 会话自愈(连续 3 次才判死),不得一次失败就踢回大厅(utils/roomguard,错误屏带「重试」按钮)
N-05 兼容 窄屏(iPhone SE 320pt)不裁内容:骰子页必须可滚动;联机翻牌 / 斗地主布局以 375px 为基准
N-06 支付红线 本项目不得接入任何虚拟支付(个人主体小程序 + iOS IAP 限制),后续如需道具须先过资质评估

5. 需求变更记录

日期 变更 原因 影响
2026-11-04 初版范围:同词相遇、你画我猜、记忆翻牌(单机)、反应大挑战、斗地主 — —
2026-11-05~10 新增:棋类对战(三棋种 + 双方视角)、斗地主仿真牌桌、记忆翻牌双人/联机、骰子与硬币、同词相遇 AI 复盘 用户迭代需求 手册 §3.11–§3.17 对应技术方案
2026-11-19 删除 5 款「即将上线」占位游戏(数字速算 24 / 拼图大师 / 节奏点击 / 消除乐无穷 / 成语接龙) 用户要求清理占位 目录剩 7 款全可玩;后续新增游戏走 data/games.js + §2.3 说明

新增 / 修改需求时:先在本表追加一行,再改对应需求卡;技术方案变化同步《架构与部署手册》对应小节。