风暴扑克实施基线
版本:IB-1.1 · 2026-10-21
状态:统一文档基线已发布;业务软件尚未完成开发、运行验证和上线验收。
如何使用这份基线
本包是产品、设计、前端、服务端、数据库、运营后台及测试的统一开发依据。旧文档站点可以回收;本包的阅读、原型、图片、流程图、CSV、数据库脚本和编辑源稿不依赖旧域名。新变更必须更新本包版本,不能以旧链接、旧截图或旧代码默默覆盖本基线。
先阅读本页与冲突裁定,再按职责阅读前端需求、服务端需求、UI 设计、架构及完整数据字典。需求追踪保留产品、后台、设计和测试的稳定编号。
权威顺序
- 后续由用户明确确认且记录入变更日志的决定。
- IB-1.1 的本页、冲突裁定和范围表。
- 本包产品需求与配置:产品 V1.2 的完整摘录,不删减本期 P1。
- 本包后台规格、前后端责任、UI 字段与状态契约。
- 本包架构、数据字典、迁移及工程验收约束。
- 原型、上游截图与关键帧仅用于视觉和行为参考。演示数据不是规则或种子,旧源码不是最终规则依据。
如产品目标与技术实现仍有不一致,登记变更或工程缺口;不能通过放宽权限或修改金额口径消除差异。数据库字典控制表结构,产品规格控制业务行为,两个层面必须共同满足。
采用的文档版本
| 内容 | 收录依据 | IB-1.1 处理 |
|---|---|---|
| 产品及前端业务 | 综合需求 V1.2 | 完整正文、108 项需求、配置、验收与流程图本地化 |
| 运营后台 | V2.1-review | 完整模块、59 项 BKR、字段、权限、流程、验收;收口默认权限 |
| 玩家 UI | design-next V4 / D2.2 | 本地原型、规范、状态与字段矩阵;修正 TG 首期和越权旧文案,补 Web 认证画板 |
| 运营 UI | 后台 V2.1 页面与字段规格 | 新增本地规格驱动的交互样稿;演示数据,页面验收尚未执行 |
| 技术架构 | V1.1-review | 采用模块化单体、单桌单写、Node 权威写入、REST/WSS、Outbox |
| 数据字典 | V1.5-review | 92 表、1001 个显式业务字段;保留 V001~V014,新增 V015,运行验证仍待完成 |
| 任务 | 任务清单 V1.3 | 提取台账,纠正旧计数及待决状态;不凭文档发布推定代码验收完成 |
“收录”和“发布”只说明文档成为开发依据,不代表被收录软件已经实现。来源版本中的 review、未执行状态在本包中保留,不把计划包装成测试证据。
交付范围
| 范围 | 本期要求 | 开放条件 |
|---|---|---|
| Web 身份 | 登录名、密码、展示昵称、服务器会话与单操控接管 | 完成受限写入口、认证及会话测试 |
| 房间与俱乐部 | 单一归属、ROOM/CLUB 邀请、成员目录、授权模板开房 | 对象范围和并发校验通过 |
| 对局 | 长牌 8 席、短牌 6 席;合法行动、边池、超时及恢复 | 先打通长牌,再完成全部本期玩法;不可省略短牌作为最终交付 |
| 资产 | TEST 测试资产、复式账本、买入补码、返还与费用 | 真实 PG16、幂等、并发和守恒验证通过 |
| 后台 | 独立认证、TOTP、授权范围、业务管理、审计及工单 | 若依通过管理 API 发起核心业务写入 |
| 其他本期 | 代理应计、牌谱、战绩、统计、文字/语音转文字、举报与导出 | 按需求优先级和对应资源门禁实施 |
| Telegram | 身份绑定、宿主适配、深链转换 | M6 后续独立阶段;不阻塞首期 Web |
| 保险、真实充提、真实佣金支付、链上核验、锦标赛 | 后续专项 | 本期不开放;保留需求追溯,不伪造订单或成功状态 |
TEST 交付不等于真实经营上线;本期模型保留正式资产的扩展能力,不把产品永久限定为测试币。
固定业务裁定
- 登录名 4~32 位 ASCII 字母、数字或下划线,小写规范化唯一;昵称 2~20 个可见 Unicode 字符,允许重复。
- 玩家密码 8~72 字符,禁止空密码;首次注册只建普通玩家,不授管理员、不由客户端设余额。
- 账号连续 5 次认证失败锁定 15 分钟;认证入口每 IP 每分钟最多 30 次;操控会话最长 24 小时。
- 只发布一套初始模板:TEST、长牌 8 席、2 小时、SB/BB=1/2、买入 100–300、Ante/抓头关闭;其他候选模板保持 DRAFT。
- 服务费模板 CSV_STANDARD_V2:5%,默认全手封顶 1.5BB,逐池分配按产品算法执行;提前盈利离座费默认 30%,豁免按离座原因与时点判定。
- 默认俱乐部存在,但玩家开房默认关闭。仅超管创建俱乐部、发布规则与费用、执行资金调整;运营只处理已授权对象及动作。
- 普通角色不默认获得 IP、未公开私牌、全局审计或导出权限;服务端必须裁剪字段。
- 账务使用整数最小单位,数据库存 UTC,业务日与产品展示使用 Asia/Shanghai。文档发布日期使用项目当前日期,不改变产品业务时区。
- 牌谱 180 天;账本、审计、举报工单 365 天;聊天 30 天;证据至少保留至结案;ASR 成功即删原音频、失败最长 24 小时。
工程边界
前端使用 Vue 3、TypeScript、Vite、Pinia;Node 采用 22 系列兼容基线并在建项时锁定补丁版本;数据库 PostgreSQL 16+、Flyway。若依选择现有 Vue 3 目录;当前源码内部版本 4.8.2、Java 8 / Spring Boot 2.7.18,仅为隔离迁移起点;目标 Java 21 LTS + 仍获安全维护的 Spring Boot(建项锁定补丁与支持证据),完成安全适配和回归后才可发布。后台唯一认证事实在 Node/poker.admin_*,原生 sys_* 登录与旧令牌在生产禁用,见架构 ADR-010。
Node 游戏业务服务拥有核心玩家、俱乐部、牌桌、钱包和结算写入权;若依是运营工作台。应用身份、迁移身份、后台身份和玩家身份分离。受限数据库写函数未实现时保持拒绝,禁止临时开放表写权限绕过。
第一个可验收成果
- 隔离 PostgreSQL 16 执行 V001~V015、五组 SQL 测试与并发用例,保存日志。
- 建立可重复构建的 Node / Web / 若依工程、环境模板与 CI。
- 完成 LOCAL 身份、服务器会话、复式账本和 Outbox。
- 两个真实浏览器玩家:注册登录 → 授权房间 → 买入 → 完成一手 → 费用结算 → 离桌返还 → 查账 → 进程重启恢复。
该闭环是 M2 的阶段成果;完整本期需求与 M5 发布门槛仍须继续完成。
仍待落实的实施门禁
门禁登记逐项记录真实 PG16 执行、受限函数、接口契约、密码重置渠道、ASR 接入、生产资源、容量与发布证据。已明确的保留期、首期身份与权限规则不再作为待决问题反复询问。未决事项只阻断对应入口,不阻断无依赖的基础开发。
IB-1.1 设计修订
修复 A1~A5/B1~B5:Outbox及每消费者租约、持久化会话代际、物理表名对齐、单 poker Schema/角色隔离、若依单一认证、Node/PG职责、手间事务重入、RBAC组合、TOTP单调消费、强制有效预约。详见修复核对报告。既定牌局与费用算法不变;新增迁移及规格不等于业务代码已完成。