实施基线 / 后台流程与状态
STORM POKER / IB-1.1

本文为IB-1.1完整摘录/规范化收录。与本包统一基线和冲突裁定配套执行;旧来源状态不代表软件完成。

关键业务流程与状态验收

V2.1-review。箭头说明业务顺序,不代表后台可以跳过业务服务直接修改状态。枚举未在主PRD明确的页面展示值仅是建议映射,不作为已批准API枚举。

查看12张业务流程图:端间职责泳道+本页F01~F11;图是概览,下方状态表保留完整规则。图中线交叉处若无节点,不代表路径合并,以箭头起止和条件标签为准。

F01 后台人员开通、恢复与撤权

超管确认人员身份和最小范围 → 参数确认+TOTP → 建INVITED账号 → 显示一次24h凭据 → 当事人设置密码/绑定认证器/验证 → ACTIVE → 密码+TOTP登录。

状态/事件 可执行 不可执行及异常
INVITED 有效凭据激活 不能查业务;过期/重发废旧凭据
ACTIVE 当前范围业务 仍需动作/范围/状态授权,不能凭角色名越权
5次登录失败 等15分钟后重试 不泄露账号是否存在;IP每分钟30次
受限恢复会话 正确密码+单次恢复码,15分钟内重绑 不加款、不看私牌、不改权
RESET_PENDING 单次24h重置邀请 验证新认证器前无业务会话;禁止自审人工重置
改密/停用/重置/角色范围变更 记录原因及版本 全部旧会话和未执行授权失效,不等缓存过期

首超管通过一次性本地受控命令初始化;唯一超管失联使用记录人员/工单的本地恢复,不设计公开绕过网页。

角色与范围授予、撤销由数据库受限函数执行:同一对象的有效区间不得重叠;管理操作必须复合绑定120秒参数授权和operation;变更、authorization_version递增、旧会话及未消费授权失效在同一事务完成。除版本化BOOTSTRAP种子外,应用账号不得直接写授权表。

F02 业务邀请签发与审核

有权限人员选择ROOM/CLUB与目标 → 选择24h免审/永久审核 → 服务端验目标与范围 → 签发普通 HTTPS 链接 → 玩家完成首期 Web 认证后打开 → 免审继续准入或创建申请 → 后台审核复核 → 明确访问权/归属结果 → 玩家查询本人状态。未来 TG 深链复用相同业务邀请 token,不改变审核、归属或资金语义。

目标×策略 正常路径 额外限制
ROOM×24h免审 签发起24h内目标房间准入 不改俱乐部/代理;房间关闭立即不可用
ROOM×永久审核 逐申请审核后访问目标房间 永久不等于房间永不关闭;计划桌未开放不买入
CLUB×24h免审 免人工审核的俱乐部准入 现有正式归属仍不能被链接静默覆盖,须显式迁移
CLUB×永久审核 逐申请审核后按归属流程 审核通过与迁移生效分开

批准瞬间校验邀请、目标、玩家和权限;撤销/冻结/关闭后不可批准。撤销不撤回已完成合法结算;已入桌继续按状态清算。申请提交与审核使用不同request_id和operation;重复申请只幂等,不新建多个待审;同号异参数拒绝。审核、撤回、撤销联动、冻结、失效和生效均追加状态事件,不覆盖申请操作。拒绝后必须使用新邀请重新申请,不提供解除拒绝动作。

签发、撤销和审核是独立能力;“允许收到/分享链接”不等于可生成新邀请,更不传播签发人的后台权限。

F03 显式归属迁移

范围内玩家详情 → 选源/目标俱乐部与目标直接代理 → 展示当前手、旧会话及归因影响 → 双侧权限/ACTIVE目标校验 → 同request_id提交 → 无在手立即生效,或有在手等待 → 手结算/作废后、下一手名单前复核 → 生效或取消保留旧归属。

情形 预期
只有源或目标单侧范围 拒绝,无归属变更
已有另一待迁移 MEMBERSHIP_CONFLICT,不覆盖原迁移
同ID同参数 返回原迁移;异参数拒绝
等待中撤权/目标冻结 生效复核取消,保留旧归属和取消原因
生效后仍有旧桌资金会话 仅旧桌该会话临时权,允许受约束参局/补码/恢复;旧目录立即失权
退出旧会话后再入 不延续临时权,重新验资格
当前手与下一手佣金 当前手沿旧协议;下一手按新归属快照,不改历史

后台把“已审核”“待归属生效”“已生效/已取消”分列,不在受理时告诉玩家已加入。

归属迁移的一次operation只允许生成一条目标归属记录;直接代理变更使用不重叠有效区间和唯一当前关系,历史、当前字段及审计在同一数据库事务更新。

F04 俱乐部冻结、解冻与归档

确认俱乐部及影响 → 校验非默认俱乐部/动作范围 → 冻结事务封新准入与开房/买入/补码 → 撤有效邀请、未决申请CANCELLED → 逐桌清算 → 状态持续可查。

冻结前房间 冻结后
SCHEDULED 取消计划,CLOSED,不再到时开放
WAITING 取消倒计时、返托管/冻结,清算后CLOSED
RUNNING有在手 DRAINING,本手完成后免离座费清算
RUNNING无在手 停下一手,清算后CLOSED
DRAINING/PAUSED_RECOVERY 保存关闭意图;不确定资金保持核查,不强行CLOSED
CLOSED 历史保留,不重开

解冻仅FROZEN→ACTIVE,不复活邀请/申请/房间/排期。归档前校验FROZEN、全部CLOSED、无未清算/待迁移、全部成员0;不达标展示阻断项,不批量静默迁出。默认俱乐部禁止冻结/归档;保底对象故障保留本人账单和旧桌恢复入口,停新入桌,不自动造俱乐部/余额。

F05 模板发布、开房与单次排期

填写完整草稿 → 字段/费用/授权校验 → 有权限者发布不可变版本 → 超管配置俱乐部开房权及模板白名单 → 运营或授权玩家选版本 → 只改允许字段 → 确认完整费用 → 提交 → 成功才显示room_id和邀请。

状态 规则
草稿 缺盲注/必需字段不能发布,不出现在玩家选项
已发布 版本不可覆盖;新房间引用独立冻结快照;相同摘要不代表同一房间
退役 不供新开房,不影响已存在房间快照
创建SUBMITTING/UNKNOWN 禁重复提交;UNKNOWN只查原号,不提前开邀请
创建FAILED 无房间/规则冻结/费用,保留合法草稿;修正后新号
创建SUCCEEDED 同号返回同一room_id、版本、结果
SCHEDULED 未来最多7天;不可买入,永久审核邀请可提前申请
到计划时间 再验人/范围/模板/俱乐部;成功转WAITING并启动默认24h邀请有效期;失效取消留因

运营关桌或房间到期进入DRAINING,停新买入/补码/下一手;当前手正常结算、未生效补码解冻、免离座费清算。发布新模板不能改WAITING桌旧版本,错桌须受控关闭后重建。

F06 超管调整、UNKNOWN与纠错

查用户及原单 → 确认玩家/币种/金额/方向/原因/来源 → TOTP产生绑定参数的单次120秒授权 → 业务方再次校验超管/限额/余额 → 追加分录与操作结果 → 返回POSTED → 玩家账单/后台审计可查。

请求/领域状态 页面含义 允许动作
SUBMITTING 本次尚无确认 禁重复;保留原操作号
已受理/处理中 业务方接收,未证明完成 查原号,展示等待原因
UNKNOWN 网络断开/超时,不能确定 查原号;不退款、不扣第二次、不换新号
FAILED 权威终态失败 原失败及资金结果可查;修正后另起新号
SUCCEEDED 权威确认完成 展示原业务号、金额、前后余额及生效时间
Ledger PENDING/POSTED/REVERSED/FAILED 账本展示状态 与请求状态分列;数据库仅存PENDING/POSTED/FAILED,REVERSED由有效完整冲正交易派生并展示冲正交易ID/时间

改金额/对象/范围须重新授权。同号异参数拒绝;重复同号只查原结果。扣减只动可用且不负。纠错先确定原单状态及有效性,追加引用原单的新分录,重复原事件冲正拒绝。无法确认COMMIT时不能通过“超时新补偿单”试探执行。

F07 代理计提、迟到与TEST标记

开手冻结玩家代理/协议 → 正常结算形成逐池抽水归因 → 事件按首次settled_at归业务日 → 日汇总高精度 → 00:10生成前日账并补脏日 → 目标应计减已记净额形成新版本调整 → 查询本人/范围日账。

场景 预期
GENERAL有效协议0% 明确0%,不当配置缺失
旧协议缺失/损坏 CONFIG_ERROR保留基数;不阻断玩家合法结算,不默用0
23:59开手、00:20首次结算 归次日,不按开手日期
原结算通知重放 原settled_at不改、同事件只计一次
首结0.019,再迟到0.009 首记0.01,后只补0.01
撤迟到/重复撤 首次冲−0.01,重复不再冲
日结漏跑 恢复补跑,不跳日,不按新日期挪旧业务
应计0.01,TEST标记0.02 差额−0.01待人工核对,不扣玩家钱、不称真实追回

只做单层分成,离座费不入分成;TEST标记是记录能力,不是实际付款。V1不提供人工“立即补结”入口,业务服务继续按日自动扫描并补结脏日;后台查账权不等同执行日结权。

日账当前版本不保存可写 is_current,按代理+资产+业务日的最高 version_no 查询;TEST标记的operation唯一,重复原号只返回首次标记结果。

F08 举报、巡检与私牌专项

玩家举报 → 同人同对象24h合并/不同人分开记录 → 后台授权受理/分配 → 查询公开证据、巡检或处罚 → 如必要申请结束手私牌专项 → 独立审批 → 限定访问并审计 → 记录实际处置 → 填内部记录+公开结论 → RESOLVED/REJECTED → 玩家本人收到状态和结论。

OPEN→IN_REVIEW→RESOLVED/REJECTED;已结案本人补充说明后重回IN_REVIEW。公开结论必填1–500字,不能包含私牌、IP或其他举报人。禁言不停止举报;设备/IP线索不自动等于作弊证据。

专项授权申请至少指定ticket_id、hand_id、player集合、用途;客服或运营仅能按有效工单范围申请,申请人与审批人必须不同,由具备专项审批权的超管审批,普通超管身份不自动获得该权。审批决定本身复合绑定120秒参数授权和独立operation并单次消费;批准后30分钟有效。每次访问还须取得另一份绑定本次读取参数的120秒TOTP单次授权,并验证已结束手、工单、范围、会话及操作者权限。会话失效、撤权或工单失效时立即失效,每次审批和实际访问均写不可变审计。

F09 故障与资金恢复

发现故障 → 停新准入/暂停全桌计时 → 核对持久结算事实 → 选可信恢复路径 → 保留原hand_id/settlement_id → 对账 → 恢复或手后清算。

可证明的事实 唯一允许的业务路径
结算已提交 原结果/原settlement_id,只补通知,不再派奖
未提交、日志可信可续 同牌序同手继续,不重新洗牌
未提交、不能续但手前快照可信 VOID,去重退实付贡献/撤本手费用和计提,保留前手与独立补码
不能判断提交或缺可信依据 RECOVERY_REQUIRED,冻结核查,不按超时自动退款

自然到期与故障相遇不再开下一手,恢复后免离座费清算。测试/受邀试用运维目标沿产品20.2:可运行后60秒恢复否则升级;告警5分钟确认、30分钟给处置及更新时间。没有真实值班人员不标有人值守,不把目标当正式SLA。

恢复案件不保存无资产的权威冻结总额;每个受影响玩家、资产、账户/原交易/资金会话分别形成资金明细,冲正、释放或继续核查逐项留痕,页面合计始终按资产分组。

F10 导出与撤权

授权查询 → 确认原筛选/列/币种/区间≤31天 → 建任务 → 生成中持续范围校验 → 文件可下载 → 原账号/原会话且当前权限通过 → 15分钟内下载 → 过期拒绝并保留审计。

生成中撤权任务失败;退出/过期/权限变化即使URL未满15分钟也拒绝。重生成按当前权限重新请求,不沿旧宽范围。导出内容不含无权字段/原始token,文本列防公式注入;下载不自动外发。

F11 玩家认证身份与本地密码重置

范围内玩家详情 → 读取脱敏认证摘要 → 具备独立 BP-32 的超管选择 LOCAL 身份、填写原因 → 参数绑定 TOTP → 权威认证服务复核玩家/身份/状态 → 撤销全部玩家操控会话并生成一次性短时重置凭据 → 通过已批准的身份核实和交付渠道送达 → 玩家设置新密码 → 原凭据失效并记录结果。

状态/条件 页面行为 安全边界
LOCAL 正常 显示来源、凭据状态和最近认证时间 不显示登录名、provider subject、密码哈希或摘要原值
连续5次失败锁定 显示锁定中及截止时间 不能显示错误密码内容,不允许后台直接清零绕过;重置走独立操作
仅 TELEGRAM 或 TG 未接入 不显示可执行 LOCAL 重置 不静默创建 LOCAL 身份,不把 TG 绑定改成第二个玩家
已有未过期重置 同号同参返回原结果;新建前使旧凭据失效 一名玩家最多一个活动重置凭据
身份核实/交付渠道未批准 入口关闭并说明发布前置条件 不在普通日志、工单正文或聊天中发送重置秘密
玩家完成重置 新口令生效、失败计数和锁定状态按认证规则收口 撤销旧会话;不改 player_id/game_id、钱包、归属、战绩或 TG 绑定

BP-32 与后台人员恢复 BP-02、玩家禁用 BP-06、查看登录 IP BP-05 分开。后台操作者不能代设新密码、读取旧密码或导出口令资料;操作只保存重置对象、原因、操作者、参数摘要、凭据有效期、会话撤销数和结果。重置凭据默认30分钟、单次使用;该默认在认证服务实现前须与身份核实/交付渠道一并确认,未确认时保持 fail-closed。

IB-1.1接缝约束

后台唯一认证与权限事实为 Node/poker.admin_*,若依原生 sys_* 登录在生产禁用;采用架构6.6及数据字典12.10的统一判定。买入必须携带有效reservation_id,过期返回RESERVATION_EXPIRED;重试先返回同request_id原结果,不从VACANT直接买入。WSS代际来自player_session及app_user持久字段,每次动作在事务中复查。TOTP使用严格递增高水位的条件更新,与授权签发同事务。手间处理按架构9.3.1,不凭SETTLED直接启动下一手。

风暴扑克 · 统一实施基线 IB-1.1文档已发布 · 软件开发与验收按门禁推进

本地全文索引 · 无在线服务依赖