下面这份清单覆盖 v4.0 已实现的全部能力。所有数值变动只由后端产生，任何端都不得本地计算后写入 —— 这是整个系统的第一条铁律。
| 业务规则 | 默认口径 | 说明 |
|---|---|---|
| 基础星 / 段位差折算 | 2 星 / 1 段 = 3 小级 | 段位相当赢 +2、输 -2；先把 21 级归成 7 个大段档位再比较，避免抖动 |
| 胜利保底 / 负方下限 | 至少 +1 星 / 扣到 0 为止 | 赢至少 +1 星；负方允许结算为 0，不强制扣星，也不会出现负星 |
| 新手保护段位 | 青铜 / 白银 | 这两个大段输局不掉星，门店也可以按需要调整保护范围 |
| 段位保护卡 | 每赛季 2 张 | 仅排位赛、仅降段时消耗；挑战赛与休闲赛不消耗 |
| 挑战赛加成 | +1 星 | 战胜榜单高手额外加星，失败不额外扣星 |
| 最短有效时长 | 中式 180s / 斯诺克 1200s | 低于阈值标记可疑；可选择「标记后正常结算」或「直接拒绝上报」 |
| 同对手周上限 | 7 天 3 场 | 超限后不计段位星（积分照给），可选星减半或仅告警 |
| 连胜衰减 | 3 局减半 / 5 局归零 | 同一对手连续同一人获胜时逐级衰减星收益 |
| 活跃度衰减 | 7 天 / 每日 1 星 | 仅排位赛重置计时；青铜免衰减；只扣星不扣积分 |
| 赛季周期 / 预热期 | 60–90 天 / 7 天 | 预热期内可打球、得积分，但不计段位星 |
| 段位继承 | 降 1 个大段 | 可选不降 / 降小段 / 按比例保留 |
| 积分口径 | 10 / 30 / 50 … | 参与 +10，排位胜 +30，挑战胜 +50，闲时额外 +20，破百 +100 |
| 闲时时段 | 周一至周五 10:00–18:00 | 全局默认值，单个任务可覆盖 |
| 核销码 | 6 位数字 | 兑换后到店吧台核销；驳回自动退还积分并回滚库存 |
技术选型的原则只有一个：门店环境不可控，所以能少一个依赖就少一个依赖；规则必须可解释，所以一切数值都有配置来源与审计痕迹。
| 服务端 | Node.js + TypeScript，云端统一托管与监控 |
| 数据存储 | 云端版：PostgreSQL 托管数据库，门店独立空间 本地版：数据存放在门店自己的电脑 |
| 账号与权限 | 会员与员工分账号体系；后台按角色分权，会话自动过期 |
| 会员端 | 微信小程序 + 网页版（H5），同一套数据 |
| 大屏 / 服务员端 / 桌屏 | 纯静态页面，零安装、零依赖，老旧电视与盒子也能跑 |
| 数据刷新 | 大屏每秒刷新；新对局确认后 1 秒内上屏 |
| 部署与升级 | 云端版免安装、由我们统一升级；本地版支持单机部署 |
| 浏览器要求 | 现代 Chrome / Edge / Safari；大屏兼容老旧浏览器 |
我们为你开通独立空间、子域名与套餐额度
球类模式、赛季、段位、倍率、任务与商城
大屏上墙、台边二维码、员工工号与角色
一起跑完第一个赛季的开启与结算
可以。会员端同时提供微信小程序与同构 H5 版本，浏览器打开即可走通注册、上报、确认、查看榜单、兑换积分的完整流程，适合先用 H5 试跑、后补小程序的节奏。
可以。后台分超级管理员、管理员、运营、大屏四类角色，按权限矩阵分权：例如运营可以配置任务与商城但不能撤销对局，大屏角色只能配置大屏。所有敏感操作都会写入审计日志。
不会。配置变更只对新发生的对局生效，历史对局保留当时的结算结果与快照。这样既保证规则可以随时调优，也不会让已经拿到奖励的会员感到被追溯修改。
不需要高性能设备。任何能打开网页的电视、机顶盒或旧电脑都可以，因为它只是一个静态页面 + 每秒一次的数据请求。断网后会自动重试，网络恢复即自动继续展示。
可以。商城有总开关，关闭后会员端不展示兑换入口，但积分照常发放与统计，方便门店先积累积分池、之后再上架商品。