# 自研游戏一期 - 产品需求文档 (PRD) > 来源: Figma PRD / Figma 设计稿 > 更新日期: 2026-03-12 ## 1. 项目概述 ### 1.1 目标 开发自研游戏模块，第一期接入 xxx 游戏（后续扩展 xxx、xxx 等）。 采用通用可插拔架构，游戏之间仅游戏渲染区域和玩法逻辑不同， 其余金额控制、设置、记录、公平性验证等模块均通用复用。 ### 1.2 设计原则 - **可插拔**: 每个游戏只需实现游戏渲染区 + 玩法配置，通用框架自动集成 - **低耦合**: 自研游戏模块独立于主项目，可直接复制到其他项目集成 - **统一目录**: 所有自研游戏放在统一目录下 - **移动端优先**: 当前只做 H5，但底层设计预留 PC 端适配方案 - **多语言支持**: 所有文案支持 en-US / pt-BR / es-MX ## 2. 游戏玩法 - xxx ### 2.1 核心规则 点击"play"后，小球从顶部落下，经过多行钉子碰撞，最终落入底部的赔率位置。 - **RTP**: 95.90% - **行数**: 8 / 12 / 16 行可选 - **模式**: Regular / High / Nightmare (影响赔率分布) ### 2.2 赔率系统 - 底部赔率槽位数 = 行数 + 1（8行→9个槽位，12行→13个，16行→17个） - 赔率对称分布，两端最高，中间最低 - 不同模式对应不同赔率配置表（由后端 config 接口下发） ### 2.3 小球落点生成 (Provably Fair) hash = HMAC_SHA512(clientSeed:nonce, serverSeed) 将 hash 分为 16 组，每组转换为 [0, 1) 范围的数值 ## 3. 功能模块详细需求 ### 3.1 主页面 - 游戏区（Topbar / 赔率条 / 游戏渲染区） ### 3.2 下注控制（金额输入 / 快选 / 行数切换 / 模式切换） ### 3.3 自动下注系统（轮数 / 止盈止损 / 赢后输后策略） ### 3.4 下注记录（My Bets / All Bets / Big Wins） ### 3.5 种子与公平性验证（Client Seed / Server Seed / Nonce） ### 3.6 帮助系统（What Game / How To Play / Fairness） ...（完整文档共 200+ 行）

# 自研游戏一期 - 设计文档 > 设计基准: 375px 宽度 (iPhone X), 移动端优先 ## 1. Figma 页面索引 ### xxx 页面 (Section: 31-5191) | Node ID | 名称 | 说明 | |----------|------------------|-------------------------------| | 2:5 | xxx-主页面 | 主游戏界面（16行，完整滚动页） | | 56:9689 | xxx-碰撞 | 小球碰撞钉子状态 | | 56:11526 | xxx-中奖 | 小球落入赔率槽中奖状态 | | 56:12453 | xxx-多球 | 多个小球同时下落 | | 61:13472 | 自动play弹窗 | Auto Setting 弹窗（初始状态） | | 61:17548 | 快速金额 | 金额快选浮层 | | 80:14241 | 中奖播报 | 获胜消息条 | | 81:15170 | 设置 | 设置下拉菜单 | | 84:16452 | 设置-seed | Seed 设置页面 | ... ## 2. 设计 Tokens ### 2.1 颜色体系 | Token | 色值 | 用途 | |------------|----------|-----------| | bg-page | #1A1B1D | 页面背景 | | bg-card | #26282C | 卡片背景 | | bg-input | #1E1F22 | 输入框背景 | | text-primary | #FFFFFF | 主要文字 | | text-secondary | #8E9093 | 次要文字 | | accent-green | #00D26A | 盈利/成功 | | accent-red | #FF4D4D | 亏损/错误 | ### 2.2 字体规范 ### 2.3 间距系统 ### 2.4 圆角规范 ### 2.5 组件规范（按钮、输入框、弹窗、Tab...） ...（完整文档共 150+ 行）

# 自研游戏一期 - Feature Plan > 版本: v1.0 | 日期: 2026-03-12 > 入口: mint (H5) > 影响范围: 新增模块，不改动现有代码（仅新增路由和 i18n） ## 1. 需求摘要 开发自研游戏通用框架 + 第一个游戏 xxx 框架需支持后续快速接入 xxx 等游戏。 ### 验收标准 - [ ] xxx 游戏完整可玩（手动下注 + 自动下注） - [ ] 8/12/16 行 + Regular/High/Nightmare 模式全覆盖 - [ ] 小球物理碰撞动画流畅，支持多球同时下落 - [ ] 超速模式（跳过动画）正常工作 - [ ] 自动下注全部策略逻辑正确（止盈/止损/赢后/输后） - [ ] Seed 设置 + 公平性验证完整流程 - [ ] 下注记录三个 Tab 数据正确 - [ ] 多语言 en-US / pt-BR / es-MX 完整覆盖 - [ ] 框架可插拔：新增一个游戏仅需添加游戏目录 + 注册配置 - [ ] 像素级还原设计稿 ## 2. 架构设计 ### 2.1 目录结构 src/pages/mint/app/MiniGame/ ├── index.jsx # 游戏入口路由分发 ├── constants/ # 通用常量（游戏列表注册表） ├── context/ │ ├── GameProvider.jsx # 游戏 Context Provider │ └── gameReducer.js # 通用 state + reducer ├── apis/ # 自研游戏 API 层 ├── hooks/ # 业务 hooks（下注/自动/记录/种子） ├── components/ # 通用组件（下注面板/记录/帮助...） └── games/xxx/ # xxx 游戏专属（渲染区+玩法配置） ...（完整文档共 180+ 行）

# 协议页面多语言适配（Terms & Conditions + KYC Policy） ## 日期 2026-02-10 ## 分支 feat/terms-i18n ## 背景 移动端协议页面语言目前为硬编码英语，需要适配多语言。 网站当前支持：英语 (en-US)、葡语 (pt-BR)、西语 (es-MX)。 涉及页面： - termsConditions.jsx — 服务条款 - kycPolicy.jsx — KYC 政策 ## 方案 - 由于协议页面文案较多，不放在多语言 JSON 文件中，每个语言使用一个独立组件 - 英语和葡语复用同一个 EN 组件 - 西语使用新 ES 组件，内容为当前英语严谨翻译 - 入口组件根据 i18n.language 判断当前语言，动态切换展示对应语言组件 - 语言常量从 src/config/constants/langCode.js 引入，不使用硬编码字符串 ## 修改文件 ### Terms & Conditions | 文件 | 操作 | 说明 | |------------------------|--------------|------------------------------------------| | TermsConditionsEN.jsx | 新增 (857 行) | 英语/葡语服务条款内容 | | TermsConditionsES.jsx | 新增 (191 行) | 西班牙语严谨翻译版本 | | termsConditions.jsx | 修改 (39 行) | 重构为入口组件，动态渲染对应语言组件 | ### KYC Policy | 文件 | 操作 | 说明 | |------------------|--------------|------------------------------------------| | KycPolicyEN.jsx | 新增 (113 行) | 英语/葡语 KYC 政策内容 | | KycPolicyES.jsx | 新增 (124 行) | 西班牙语严谨翻译版本 | | kycPolicy.jsx | 修改 (40 行) | 重构为入口组件，动态渲染对应语言组件 | ### 影响范围 - 仅影响移动端 Terms & Conditions 和 KYC Policy 页面 - PC 端未做任何修改 - 未修改路由、样式、接口逻辑