模块与页面规格
版本V2.1-review。下列16个模块为导航组织建议;BKR目录是可追溯的功能粒度,不按页面数量计算实现完成率。逐页面的列表列、详情项、确认字段、数据来源、权限裁剪与导出边界见展示字段契约和字段矩阵。
0. 通用页面契约
列表默认近7天、20条/页、最大100,支持清空筛选,查询、合计、明细、导出保持同范围及币种。时间按Asia/Shanghai显示,区间[start,end)。主键用稳定ID,不用昵称/房间展示手号代替。未知字段显示“未知”,零值正常显示0。
详情统一展示来源、最后更新时间、数据截止/完整性、对象状态及关联记录。写动作先展示对象/范围/影响/原因,再确认;提交中禁重复,超时显示结果确认中并查询原号。业务受理、实际生效及清算完成分别反馈。弹窗关闭、刷新、重新登录后仍可在有权限时查原操作。
拒绝原因须可理解且不泄露范围外对象是否存在。无数据、筛选无结果、权限不足、服务失败与记录过期分别设计。危险动作不放在行内一键执行;私牌授权不是普通详情开关。
M01 运营总览与待办
- 页面:总览、待办列表、操作结果详情。BKR-047/048/051。
- 筛选:业务日期、资产、授权俱乐部/代理、玩法;资产必须分组。
- 指标:有效用户/手数、抽水、离座费、代理净应计、数据截止时间、待重算数量、未知操作、未清算资金异常、邀请待审及待处理工单。无权项不显示不返回;金额异常与客服待办不能混成一个“业务失败数”。
- 动作:下钻保持同筛选;按原操作号查询结果;进入有权限的处理页。总览不能直接加款或确认退款。
- 数据口径:有效用户按至少完成一手去重,手数去重hand_id;应计按业务日,调整保留实际记账日。跨币用户数不相加生成全局去重值。
- 转化:邀请/列表两条入口分别显示合格旅程、买入成功、转化、初始拒绝和后续失败原因;30分钟窗口尚未结束标暂计。
- 异常:未知结果进入待确认,不因等待时间自动失败;积压和差额仅触发核查,不能自动扣款。告警阈值待容量评估。
M02 玩家管理与登录记录
- 页面:玩家列表、玩家详情(资料/归属历史/资产/会话/战绩/登录/处置)。BKR-006~010、056。
- 列:game_id、展示名、正常/禁用、俱乐部、直接代理、分币可用/冻结/托管、注册时间、最近登录。LOCAL登录名、TELEGRAM subject/username 和所有身份摘要均不进入普通列表、成员目录、导出或代理自助页。
- 筛选:精确game_id、展示名、俱乐部、代理、状态、注册/登录区间;登录日志按时间、结果、玩家查询;敏感IP检索另验权限。
- 认证摘要:显示身份来源
LOCAL/TELEGRAM、活动/解绑状态、本地凭据状态、锁定截止及最近认证时间;默认不显示provider_subject、登录名、TG ID/username 或任何摘要原值。TG 接入前只显示“未接入”,不得伪装未绑定异常。 - 登录详情:每次登录的时间、认证来源、方法、设备摘要、IP、结果及安全可见失败原因。支持
LOCAL_REGISTER/LOCAL_PASSWORD/SESSION_RESUME/DEVICE_TAKEOVER,后续再启用TG_AUTH/TG_BIND;缺注册时间不以最早日志或updated_at替代,客服默认无IP权限。 - 动作:查询、禁用/解禁、显式归属迁移;具备独立 BP-32 的超管可发起玩家本地密码重置。超管资金调整仅跳专用确认页,不开放余额编辑。不能编辑上级后台人员,这里管理的是统一玩家账号而非后台人员。
- 禁用:选择对象、原因、确认受影响房间;先封全部认证身份的新准入,再显示当前手托管/清算中,保留全下权益;结束后免离座费清算。禁用不解绑身份,解禁不恢复旧邀请、旧桌或旧会话。
- 玩家密码重置:只允许独立 BP-32;复核玩家、原因、当前凭据/锁定状态和会话影响,参数绑定TOTP后由权威认证服务生成一次性短时凭据并撤销全部玩家会话。后台不读取或代填新密码,不更改
player_id/game_id、钱包、归属、战绩或 TG 绑定;身份核实和凭据交付渠道未批准时入口保持关闭。 - 迁移:源/目标、目标代理、当前手、预计生效时点、旧桌临时权说明、原因;源目标双侧权限不足拒绝,不提供静默改club_id/agent_id。
- 玩家端:禁用后明确限制;本人账单/资金查询与合法清算不被没收。迁移后目录切换,原会话临时访问仅持续至退出。
M03 俱乐部与归属
- 页面:俱乐部列表/详情、创建、授权、迁移记录。BKR-010~014。
- 列/筛选:ID、名称、默认标识、直接代理、正常/全部成员数、活动房间数、状态ACTIVE/FROZEN/ARCHIVED;按ID/名称/代理/状态过滤。
- 创建:仅超管,填写名称、头像/简介、一个直接代理或明确无代理、运营范围;不生成独立俱乐部余额。默认俱乐部是初始化对象,不由普通用户创建。
- 编辑:授权运营编辑名称/头像/简介;直接代理与运营范围变更走显式授权动作并保留历史,不能因可改名称推导出可改权限。
- 玩家开房授权:超管设置allow_player_create及可用已发布模板白名单;无权玩家入口隐藏且服务端拒绝。代理身份也不自动继承开房权。
- 冻结:确认影响的房间、邀请、申请、清算与待迁移;立即封新准入/补码/开房,当前手后关桌;待恢复桌保留关闭意图。列表分列俱乐部状态与关联清算进度。
- 解冻:仅恢复ACTIVE;不恢复旧邀请、申请、排期或关闭房间。需新签发/新开房。
- 归档:FROZEN、全部房间CLOSED、无未清算/待迁移、全部成员数0(含禁用);阻断项逐项列出并可下钻。默认俱乐部禁止冻结/归档。
- 玩家端:只读俱乐部资料、本人钱包可用视图;冻结不能以空列表掩盖服务状态。
M04 邀请与加入申请
- 页面:邀请列表/签发/详情、待审队列、申请详情。BKR-015~018。
- 邀请字段:invite_id、目标ROOM/CLUB与ID、策略、签发人、签发/到期/撤销时间、使用数、派生有效状态、相关申请数。token不进入日志/导出;短码及深链只向有签发/分享权限的人展示。
- 筛选:目标类型及ID、策略、签发人、有效/过期/撤销/目标不可用、时间;有效性由服务端判断。
- 签发:目标与策略独立组成四种组合。默认ROOM=24h免审、CLUB=永久审核。永久ROOM仍受房间关闭约束,不产生俱乐部归属。
- 撤销:超管可撤销任意业务邀请;运营只能撤销本人签发且目标仍在授权范围内的邀请,不因可查就可撤。撤销阻止新进入和未决批准,已在手正常清算。
- 申请详情:申请人、当前归属、目标、邀请码状态、账号状态、申请/审核时间、审核人、理由、审核结果、归属/房间访问实际生效状态及原操作号。
- 审核:批准瞬间复核目标、码、玩家和权限;已有正式归属必须显式迁移,不能批准即覆盖。审核通过与有在手待生效分列;拒绝后必须使用新邀请重新申请,不提供“解除拒绝”动作。
- 防并发:同申请多审核人竞争只形成一个终态,重复原号返回原结果;撤销/冻结先成功后批准应拒绝。
- 玩家端:展示本人待审/拒绝/失效/撤销/冻结与手后待生效,不暴露审核后台、其他申请人或内部备注。这里只负责业务邀请,不建设玩家注册码体系。
M05 规则与费用模板
- 页面:模板列表、草稿编辑、版本对比、发布确认、版本详情。BKR-019~021、055。
- 列/筛选:模板ID/名称、版本、状态(草稿/已发布/退役)、玩法、币种、盲注、买入、费用版本、适用俱乐部/授权、发布时间和使用房间数。
- 编辑组:玩法/席数/时长;资产及SB/BB;买入min/max;Ante/抓头;自动开始人数;观战;延迟;VPIP;超时模式/时限;抽水与cap;离座费与豁免;玩家可编辑字段和范围。系统固定字段显示依据而非自由文本编辑器。
- 固定校验:长52张8席2/3h,短36张6席1h,均NLH;短牌Ante/抓头OFF;SB=BB/2、BB为0.02整数倍;金额两位精度;最低买入覆盖最大强制款。
- 七档候选保持原值;V1仅发布TEST资产、100–300、SB/BB=1/2、长牌8席2小时、Ante/抓头关闭的完整种子。其余六档保持DRAFT,不推断盲注、资产或授权范围,不阻塞V1。
- 权限:超管发布规则及费用版本;运营可按明确草稿权准备非费用配置、选择已发布费用;不得默许费用发布或调高比例。默认最小授权,未明确授予的动作保持拒绝。
- 发布:展示完整差异、适用资产/范围、生效只针对新房间;确认后不可覆盖。退役不强关既有桌;计划开放遇退役须取消。
- 费用预览:列CSV算例及离座例,显示rate/cap独立值、整数取分及全手封顶。预览不是已执行结算证明。
- 玩家端:只能从返回的已发布且已授权模板选择,规则、费用说明和账单共享同快照;不把61项配置全做可调开关。
M06 房间、排期与异常恢复
- 页面:房间列表/详情、即时开房、单次排期、关闭确认、恢复事件。BKR-022~026。
- 列:room_id、俱乐部、玩法、资产、模板/费用版本、参局/占座数、计划/首手/截止时间、状态、累计有效手数、当前手、数据时点。
- 筛选:房间/俱乐部/代理、状态、玩法、时间、币种;详情关联公开桌面、规则快照、资金会话、手牌、费用、邀请和操作轨迹。
- 开房:仅范围内,以已发布版本+允许编辑值确认;提交未知不提前给房间号或签发入口;成功返回唯一room_id,不要求创建者买入。
- 单次排期:现在至未来7天,SCHEDULED仅预告、不可买入;开放时复核操作者/模板/俱乐部,转WAITING并开始默认24h邀请有效期;永久审核邀请可提前申请。无循环排班。
- 排期取消:仅未开放状态,重复幂等;与开放任务竞争由业务服务确认结果,不靠页面本地时间判断取消成功。
- 关闭:显示影响、当前手及资金会话,提交DRAINING,停新买入/补码/新手,当前手后免离座费清算;未生效补码退一次,不删除房间或清空座位绕账。
- 恢复:列最后提交hand_id/动作版本、结算提交是否可证、当前恢复路径、冻结金额、负责人、处置和更新时间。运营可登记/暂停/发起受控恢复请求,不能任意选择退款、改牌或置SETTLED。
- 处置规则:已提交只补通知;可信日志续原手;可信手前快照且确认未提交才VOID冲回;不确定则RECOVERY_REQUIRED冻结核查。
- 玩家端:恢复原手/原会话;停新入桌时说明,未完成清算不展示余额已返还。游戏故障暂停与单次操作UNKNOWN为不同事件。
M07 战绩、会话与牌谱
- 页面:手牌查询、会话查询、玩家统计、事件回放。BKR-027/028/052/056。
- 筛选:玩家、room_id、hand_id、seat_session_id、玩法、资产、代理/俱乐部、手牌结算/会话结束区间、正常/作废/恢复中。
- 会话字段:买入、生效补码、本金、起止、有效手数、返还、离座费、最终/暂计净收益;手牌字段:贡献、未匹配返还、获池、抽水归因、单手净收益、规则版本。
- 统计:VPIP/PFR/W$SD分子分母、样本和bb/100,玩法/资产分开;不生成“综合实力分”,分母0为—。
- 回放:结构化事件播放/暂停、前后动作、分街、1×/2×;初始公开筹码、强制款、下注目标及增量、公共牌、主边池、费用及赢家一致。
- 隐私:默认仅公开范围;操作者本人作为玩家的私牌权不自动变成后台全牌权。Muck和未公开对手牌不能通过时间轴或接口泄露。
- 历史:LEGACY_SUMMARY标不可回放;未存动作不生成“录像”。保留期内新记录超过3000手仍可分页查询。
- 联动:牌谱→原结算→费用→协议快照→资金,不由回放重新执行结算。
M08 资产、流水与充值来源
- 页面:资产视图、流水列表/详情、真实充值来源说明。BKR-029/030/033/056。
- 字段:玩家、资产、可用/冻结/托管/总额、transaction_id/business_id、类型/状态、整数金额、前后余额、原因、当时玩家与代理快照、操作者、业务/记账时间、关联手/会话/原单。
- 筛选:稳定ID、时间、币种、用户、代理/俱乐部范围、类型、状态;同筛选合计只按币种。
- 流水详情:借贷分录、请求/操作、规则与协议版本、原单/冲正链、冻结去向和业务终态。只读,不提供编辑余额/删除分录按钮。
- 充值:真实通道未接入,说明未接入并无真实订单;手工额度、补偿、输赢和买入各自分类,不把所有流入当充值/盈利。
- 异常:显示资金在途及来源,不把失败和未知混合,也不把账本对账差额当“应退款金额”。定位原单后进入超管纠错。
- 玩家端:与本人钱包/账单一致;底池不重复计资产,补偿不可直接加当前手。
M09 超管调款与纠错
- 页面:调整申请、确认/二次授权、执行结果、原单纠错。BKR-031~033。
- 表单:玩家ID及确认身份、资产、类型TEST_GRANT/MANUAL_ADJUSTMENT/COMPENSATION、加/减、精确金额、原因、来源资格、原单(纠错必填)。用户改名不替换稳定ID。
- 确认:显示当前可用/冻结/托管、预期变化、额度上限、不可兑换/默认不可提、单号;再TOTP得到120秒单次参数绑定授权。
- 执行:服务端重验超管、最新权限、授权摘要、限额与可用余额,追加守恒分录;扣减不足拒绝,不取在手钱补足。
- 重试:同号同参数查原结果;同号异参数拒绝;超时保留UNKNOWN,刷新仍恢复原单。明确失败修正后才允许新号。
- 纠错:引用有效原单新增冲正/补偿;不重复冲同一已冲正事件,不删除历史或强行把差额置0。不能回滚已记账资金配合旧代码。
- 权限:运营、客服、代理一律禁止,包括“测试调整”;本期不新增财务角色或双人资金审批权。
M10 收入与费用明细
- 页面:收入汇总、手牌抽水、会话离座费、备注历史。BKR-034/035。
- 字段/筛选:业务时间、币种、俱乐部/代理、room_id、hand_id/seat_session_id、费率/上限、计费基数、抽水、离座费、规则版本、豁免原因、备注及追加人。
- 抽水和离座费分别下钻,累计/所选期间明确区分;不把买入、补偿或代理应计当额外营业收入。
- 动作:查询、同范围导出、附加备注;备注只追加审计,不修改历史金额、归因或费率。
- 验算:BB2、5%、cap3、池40费2;池400费3;未翻牌0。提前盈利离座按已接受版本算,到期/运营处置免。历史费用始终引用当桌快照。
M11 代理与等级协议
- 页面:代理列表/新增/详情、成员汇总、等级及协议版本。BKR-036~039。
- 字段:agent_id、名称、状态、注册时间、管理关系、所管俱乐部、授权用户数、等级/比例/版本/生效期、所选期间与累计基数/应计、测试支付标记和差额;充值统计标未接入,补偿另列。
- 动作:超管全局;运营在自己范围内新增代理、编辑名称/状态、创建本人等级版本、设0%–100%且不超授权上限。不能修改别的运营共享等级或增大自己上限。
- 关系:每俱乐部一个直接代理、一个代理可管多个俱乐部;管理层级不自动计佣。不把邀请签发者自动写成归属代理。
- 版本:手开始冻结协议;修改下一手生效、不回改历史。GENERAL明确0%;旧协议缺失CONFIG_ERROR,保留基数供修复而非默用0%。
- 停用:历史不删,未来归因平台直到显式有效绑定;不能删代理后导致历史账失去对象。
M12 分成日账
- 页面:日账列表/详情、重算轨迹、TEST支付标记。BKR-039~041。
- 字段:代理、资产、业务日、数据截止、协议引用、贡献抽水基数、目标应计、已记净应计、版本调整、测试已标记金额、待处理差额、PENDING_RECALC/CONFIG_ERROR。
- 日账:按首次settled_at归日;每天00:10首结前日及脏日,漏跑恢复补跑;调整=新目标−已记净应计,历史版本保留。重放不改变原settled_at,不重复计事件。
- 算例:高精度0.019→应计0.01;迟到+0.009→目标0.02,补0.01;撤迟到→冲−0.01;再次撤不再冲。
- 测试标记:仅超管,仅TEST,仅写测试标记轨迹;不产生真实付款。应计冲至0.01、测试标记0.02时差额−0.01待核对,不自动追回玩家余额。
- 运营/代理只读;V1不建设人工佣金补结入口,继续由业务服务自动扫描并补结脏日,不因旧V1有“补结”按钮获得手动执行权限。
M13 代理本人工作台
- 页面:我的协议、授权用户统计、我的佣金账。BKR-042。
- 认证:显式绑定后台账号并完成独立认证,身份标签不授予管理权。
- 字段:本人等级/比例、协议版本与生效期、授权俱乐部/用户汇总、日期/币种基数、应计、调整、测试标记/差额;期间与累计分开。
- 不可见:名下玩家完整钱包流水、IP、LOCAL/TELEGRAM身份标识、他人协议/佣金、未公开牌。不能改URL或导出获取扩大范围。
- 权限种子采用最小只读:仅本人协议、授权汇总和本人佣金;代理身份不自动获得运营角色,也不以“暂未配好”开放全局。
M14 客服巡检、举报与专项审计
- 页面:巡检桌面、工单队列/详情、私牌申请/审批/访问轨迹。BKR-043~046。
- 工单字段:公开编号、内部案件号、本人提交记录关联、对象消息/手号、原因、状态OPEN/IN_REVIEW/RESOLVED/REJECTED、负责人、证据、内部轨迹、公开结论、最后更新时间。
- 受理:同举报人同对象24h合并追加;不同举报人保留各自私有记录,可关联内部案件,不能相互公开。客服仅分配或授权范围可读。
- 巡检:公开桌面、客服身份提示、不占座、不计人数、不发手牌、不代打。线索只建工单,不自动判作弊或扣钱。
- 禁言:10分钟/24h;永久仅运营/超管。禁言不妨碍举报,不冻结钱、不改变牌局结果。解除禁言如建设需动作权限及审计,不能隐式扩大处罚权。
- 结案:公开结论1–500字必填,内部处置另存;结论不得含私牌、IP、他人身份或资金详情。处置实际结果单列,禁用已提交不等于已清算。
- 玩家反馈:结案公开状态与结论、未读标记;补充说明使已结案重新IN_REVIEW;每账号每分钟3次提交/追加合计。首期通过站内查询/刷新获取,不依赖TG主动推送。
- 私牌专项:已结束手+有效工单+用途+指定玩家/手牌+专项角色权;客服或运营仅能在工单范围内申请,申请人与审批人不同,由具备专项审批权的超管审批。批准后30分钟有效;每次实际访问另需120秒参数绑定TOTP单次授权,并复核会话、权限、工单和对象范围。会话失效、撤权或工单失效时授权立即失效;记录每次申请、审批和访问,未授权请求不返回密文或隐藏JSON。
M15 后台账号、安全与授权
- 页面:账号列表/创建、激活、角色范围、本人安全、恢复/重置记录。BKR-001~006。
- 账号字段:后台ID、展示名、状态INVITED/ACTIVE/DISABLED/RESET_PENDING、角色/动作、俱乐部/代理范围、佣金上限、认证器绑定状态、最后完整认证、授权版本;不显示密码、密钥、恢复码摘要。
- 创建:超管二次授权,24h单次激活凭据仅显示一次;绑定人员核实渠道交付,不依赖玩家 LOCAL 或 TELEGRAM 身份。首超管本地受控初始化,禁止公开注册提权。
- 激活:设12–128字符密码、绑定6位30秒TOTP(前后1步)、首码验证、10个恢复码仅显示一次;未完成无业务会话。
- 会话:密码+TOTP完整认证;连续5次失败锁15分钟,IP30次/分钟;空闲15分钟/绝对8小时,后台轮询不续期。退出当前会话;改密、停用、重置、角色/范围变更撤销全部会话与待执行授权。
- 改密:旧密码+独立验证;5次错误锁改密15分钟,成功强制重登;后台人员密码与玩家
local_credential完全隔离。 - 恢复:正确密码+一次恢复码进入15分钟只重绑会话;人工重置须另一超管身份核实,唯一超管走受控本地恢复。全部留审计,不公开绕过接口。
- 授权:超管明确动作/资源/上限,不能给自己提权或将平台代理身份等同超管。敏感授权操作号与参数绑定120秒单次,失败计数与登录/改密分别管理。
M16 审计与导出
- 页面:审计查询、原操作详情、导出任务/下载。BKR-049~054。
- 审计字段:operator_id、角色/范围快照、对象、动作、脱敏前后值、原因、请求/操作/原业务号、提交/生效时间、结果/错误;敏感访问也记录。普通操作者至少能查本人仍在范围的操作,不默认获得全局日志。
- 只读:不提供删除、修改或掩盖历史记录能力;安全拒绝也记录必要事件,不收集密码/TOTP/token全文。
- 导出:按同查询范围/字段/资产和时间区间生成;最大31天。页面显示生成中、可下载、失败、过期、因撤权失效。建议任务式导出,下载入口不是静态公开URL。
- 安全:生成中撤权任务失败;下载须原账号/会话且当前权限通过;15分钟到期、退出即拒绝。导出审计保留条件、行数/数据时点和结果,不向外自动发送。
- 数据格式:文本列做CSV公式注入防护,金额保留精确值/币种/精度,不把ID转科学计数法。没有导出列权就不在文件内生成隐藏列。
- 交付证据:关联BKR/BKA、版本/环境/数据来源、实际结果;模拟显著标识,真实服务不可用不转为真实空集,更不能记验收通过。