Skip to content

第十六章 配置项归属与附录

本章汇总操盘详情页涉及的所有配置项(分为风控管理、联赛管理、系统管理三类归属)、默认值定义、术语表和字段索引,作为PRD的统一参考附录。

16.0 与其他章节的关系说明(SSOT声明)

本章遵循「单一真源(Single Source of Truth)」原则,枚举定义、权限定义、联动规则均引用操盘列表文档,不重复定义。

内容单一真源位置本章职责
角色枚举操盘列表第12章12.1节仅引用
隐藏来源枚举操盘列表第16章16.1.4节仅引用
操作来源枚举操盘列表第18章18.3.2节仅引用
盘口状态枚举操盘列表第10章10.3.1节仅引用
数据联动规则操盘列表第16章仅引用
审计日志字段操盘列表第12章12.6.2节仅引用
日志保留天数操盘列表第12章12.6.1节(180天)仅引用
限额体系(联赛分组/用户/玩法/串关)风控管理第2-5章仅引用(赛事级覆盖入口见第13章13.12节
配置项归属与默认值本章(操盘页第16章)定义
术语表本章(操盘页第16章)定义
字段索引本章(操盘页第16章)定义

16.1 配置项归属总表

16.1前置:配置分类定义(写死)

配置分类定义特征修改流程示例
系统级写死(System Hardcode)代码级写死常量,在源代码中定义,无任何配置界面入口1. 不在任何后台界面提供编辑入口;2. 修改需修改代码+编译+发版;3. 变更影响全系统;4. 一期不支持变更走技术发版流程(修改代码→编译→灰度测试→全量发布)HK赔率精度3位、最大HK赔率50.00、RTP范围85%-99%、风险注单超时30秒、数据源同步间隔500ms
配置界面不可编辑(配置界面存在但禁用)后台配置界面存在该配置项(便于查看默认值),但「编辑」按钮被禁用或灰显,无法手动修改1. 在后台配置界面中可见;2. 无编辑/删除操作按钮;3. 仅可查看当前默认值;4. 特定场景下(如版本过渡期)临时禁用等待功能升级后再开放编辑界面(或直接升级为可编辑配置)二期计划:目标RTP、偏离阈值等(一期先禁用,二期开放可编辑)
风控管理配置风控后台运营配置,支持界面配置与修改,立即生效1. 风控管理界面有编辑入口;2. 修改立即生效,无需发版;3. 配置优先级:赛事级 > 联赛级 > 默认值风控管理后台界面配置(无需发版,立即生效)告警阈值、货量接近上限阈值、风险敞口告警阈值
联赛管理配置联赛级运营配置,支持界面配置与修改,新赛事生效或立即生效1. 联赛管理界面有编辑入口;2. 变更生效时机按配置类型区分:跟随类配置立即生效,其他配置仅对新上架赛事生效;3. 不影响已上架赛事联赛管理后台界面配置(按生效规则)是否跟随数据源、默认操盘手、玩法启用列表
系统管理配置通用技术参数,支持界面配置但通常不需频繁变更1. 系统管理界面有编辑入口;2. 修改需谨慎(影响系统性能/行为);3. 通常为一次性配置系统管理后台界面配置(需管理员确认,避免误操作)日志保留天数、WebSocket超时时间

配置归属说明(简化版):

  • 系统级写死:HK精度、RTP范围、赔率边界、超时时间、同步间隔(不可在界面修改,改需发版)
  • 风控管理:告警阈值、风险敞口阈值、货量接近上限阈值(风控后台配置,立即生效)
  • 联赛管理:跟随配置、操盘手分配、玩法启用、主力线规则(联赛后台配置,新赛事或立即生效)
  • 系统管理:日志保留、超时等通用参数(系统后台配置,需谨慎修改)

16.1.0 系统写死常量(修改需发版)

以下赔率边界参数为系统硬编码常量,不在风控管理界面中提供配置入口,修改需走代码发版流程。

常量项写死值数据类型说明引用章节
最大HK赔率默认值为 50.00(系统级写死,修改需发版)数值单选项赔率上限第7章7.2.3
最小HK赔率默认值为 0.01(系统级写死,修改需发版)数值单选项赔率下限第7章7.2.3
RTP下限默认值为 85%(系统级写死,修改需发版)百分比返奖率下限第7章7.2.3
RTP上限默认值为 99%(系统级写死,修改需发版)百分比返奖率上限第7章7.2.3
默认目标RTP默认值为 95.0%(风控管理配置)百分比默认返奖率目标第7章7.13.3
单次调幅限制默认值为 0.20(系统级写死,修改需发版)数值单次赔率调整的最大绝对值第7章7.2.3第14章14.2.4

16.1.1 风控管理配置

配置项默认值数据类型说明引用章节
偏离IM告警阈值默认值为 0.10(风控管理配置)数值本地赔率与IM偏离超过此值触发告警第7章7.2.3第14章14.2.4
单边比例告警阈值默认值为 70%(风控管理配置)百分比单边投注比例超过此值触发告警第11章11.3
大额单笔告警阈值默认值为 50,000(风控管理配置)金额单笔投注超过此值触发审核告警第11章11.3
风险敞口告警阈值默认值为 1,000,000(风控管理配置)金额超过此值触发告警第12章第10章
货量接近上限告警阈值默认值为 80%(风控管理配置)百分比货量占限额比例达到此值触发告警,分两个维度检测:1)整场货量 除以 整场最大货量;2)分组货量 除以 分组限额(6组独立检测)。告警信息显示:触发维度(整场/分组名)、当前货量、对应限额、占比百分比风控管理第7章7.1风控管理第2章

货量告警触发示例

  • 分组维度:等级1联赛 让球组限额 等于 300,000,当前让球组已接受 等于 250,000,占比 等于 250,000 除以 300,000 等于 83.3%,83.3% 大于等于 80% → 触发告警,提示「让球组货量接近上限:250,000 / 300,000(83.3%)」
  • 整场维度:等级1联赛 整场限额 等于 1,000,000,当前整场已接受 等于 820,000,占比 等于 820,000 除以 1,000,000 等于 82%,82% 大于等于 80% → 触发告警,提示「整场货量接近上限:820,000 / 1,000,000(82%)」

限额配置说明:限额体系(联赛分组、用户限额、玩法限额、串关限额)的完整定义详见风控管理第2-5章,包含11档联赛等级 乘以 6组的完整配置矩阵。操盘页通过第13章13.12节「风控设置弹窗」提供赛事级覆盖入口,限额字段的默认值继承自该赛事所属联赛等级的风控管理配置。

16.1.2 联赛管理配置

配置项默认值数据类型说明引用章节
是否跟随数据源盘口状态默认值为是(联赛管理配置)布尔联赛级跟随配置第9章9.3
默认操盘手默认值为空(联赛管理配置)用户ID该联赛新赛事的默认操盘手第14章14.1
操盘手分配模式默认值为统一分配(联赛管理配置)枚举统一分配/按玩法分配第14章14.1
玩法启用列表默认值为全部启用(联赛管理配置)数组该联赛启用的玩法类型第6章6.2
主力线显示规则默认值为仅显示主力(联赛管理配置)枚举主力线/全部线/自定义第6章6.4

16.1.3 系统管理配置

配置项默认值数据类型说明引用章节
数据源同步最小间隔默认值为 500ms(系统级写死,修改需发版)毫秒IM推送合并最小间隔第7章7.6.1
HK赔率落库精度默认值为 3位小数(系统级写死,修改需发版)整数赔率存储精度第7章7.16
HK赔率显示精度默认值为 2位小数(系统级写死,修改需发版)整数赔率显示精度第7章7.16
金额显示精度默认值为 2位小数(系统级写死,修改需发版)整数金额显示精度第12章12.11.2
操盘日志保留天数默认值为 180(系统级写死,修改需发版)操盘列表第12章12.6.1节一致第14章14.6.5
风险注单超时默认值为 30秒(系统级写死,修改需发版)待审核注单超时自动拒绝第15章15.5.4

16.2 阈值生效规则

16.2.1 配置变更生效时机

配置类型配置项生效时机影响范围说明
联赛配置-跟随类是否跟随数据源盘口状态立即生效已上架赛事变更后该联赛下已上架赛事立即按新跟随配置与数据源同步
联赛配置-非跟随类默认操盘手、玩法启用列表、主力线显示规则、操盘手分配模式新上架生效未上架赛事仅新上架赛事使用新配置;已上架赛事保持原配置不回刷
联赛配置-等级变更联赛等级变更(默认↔等级1-10)新上架生效未上架赛事已上架赛事保持原等级限额;新上架时使用新等级限额
风控配置-告警阈值偏离IM告警、单边比例告警、大额单笔告警、风险敞口告警、货量接近上限告警立即生效已上架赛事变更后触发全量重算告警状态
赛事级覆盖配置跟随数据源开关、指定操盘手立即生效当前赛事针对单个已上架赛事,立即生效

不在本表范围的写死项

  • 赔率边界6项(最大/最小HK赔率、RTP范围、目标RTP、单次调幅):一期默认值写死,无配置变更场景,不存在"生效时机"问题
  • 系统管理配置5项(精度规则、同步间隔、超时、日志保留):一期默认值写死,同上

以上写死项如需修改,必须走代码发版流程,不在运营配置范畴内。详见16.1.0节。

16.2.2 配置优先级(从高到低)

优先级配置层级说明
1赛事级配置针对单个赛事的独立配置
2联赛级配置联赛管理中的配置
3风控默认配置风控管理模块的默认值
4全局默认配置系统管理模块的系统默认值

继承规则:下级未配置时继承上级配置,下级已配置时覆盖上级配置。


16.3 枚举定义引用

SSOT原则:本节仅列出枚举引用位置,不重复定义枚举值。查看枚举详情请跳转至对应章节。

16.3.1 盘口状态枚举

单一真源操盘列表第10章10.3.1节

状态值中文名称说明
1开盘可接受投注(初始状态)
2隐藏停止接受投注,可恢复(叠加状态)
3锁定锁定状态,仅主管/风控可解锁(叠加状态)
4关盘终态,不可逆

术语说明:系统统一使用「开盘/隐藏/锁定/关盘」术语。开盘为初始状态(仅展示),隐藏和锁定为叠加状态(可操作),关盘为终态。

16.3.2 隐藏来源枚举

单一真源操盘列表第16章16.1.4节

此枚举用于记录盘口为什么进入隐藏状态,仅当盘口状态=隐藏时使用。

来源标识名称触发场景恢复方式
manual人工隐藏操盘手手动隐藏人工取消隐藏
data_source数据源状态标记IM推送状态(不再作为隐藏来源)数据源恢复或人工处理
league_pause联赛暂停联赛状态变更为暂停联赛恢复后自动取消隐藏
league_close联赛关盘联赛状态变更为关盘联赛恢复后人工评估
risk_control风控隐藏风控规则触发自动隐藏人工确认后取消隐藏
system系统隐藏系统异常触发人工取消隐藏
inherit继承隐藏上级隐藏导致下级隐藏上级取消隐藏后自动恢复
maintenance数据源维护IM推送维护标记/维护态维护结束后自动恢复(仍需满足上级状态上限)
event_incident赛事事件进球/红牌/VAR 等事件触发默认10秒发起一次恢复尝试;若数据源仍暂停则继续跟随

16.3.3 操作来源枚举

单一真源操盘列表第18章18.3.2节

此枚举用于记录操作是由谁/什么触发的,所有操作日志都需记录。

来源标识显示名称标签颜色触发场景说明
manual人工蓝色操盘手单次手动操作最常见的操作来源
batch批量蓝色前端批量选择后执行日志通过batch_id关联汇总与明细
ao数据源自动绿色自动跟盘机制触发仅用于赔率调整操作
data_source数据源橙色IM数据源推送触发的状态变更被动响应数据源
risk_control风控红色风控规则触发的操作如单边超限自动隐藏
system系统灰色系统自动处理如风险注单超时自动接受
inherit上级联动紫色上级状态继承触发如联赛暂停导致盘口隐藏
maintenance数据源维护紫色IM推送维护标记触发的状态变更维护期间的状态变更
event_incident赛事事件黄色进球/红牌/VAR等事件触发比赛事件导致的状态变更

隐藏来源 vs 操作来源:这是两个完全不同的枚举。隐藏来源记录「盘口为何隐藏」,操作来源记录「操作由谁发起」。

16.3.4 角色枚举

单一真源操盘列表第12章12.1节

角色代码中文名称说明
TRADER普通操盘手负责具体赛事操盘
SUPERVISOR主管团队管理,高权限
RISK_CONTROL风控风险控制,最高权限

16.3.5 操作类型枚举

单一真源操盘列表第18章

详见操盘列表第18章18.3节「操作类型枚举」定义。


16.4 术语表

16.4.1 赔率相关术语

术语英文定义
HK赔率Hong Kong Odds香港赔率,净赔率,不含本金
Decimal赔率Decimal Odds欧洲赔率,含本金,等于HK赔率加1
RTPReturn To Player返奖率,所有选项隐含概率之和的倒数
隐含概率Implied Probability赔率隐含的概率,等于1÷Decimal赔率
配对计算Paired Calculation调整一方赔率时自动计算配对方赔率以维持RTP
主力线Main Line投注量最大或数据源标记的主要盘口线

16.4.2 盘口相关术语

术语英文定义
玩法Market / Bet Type投注类型,如让球盘、大小球
盘口线Handicap Line同一玩法下的不同盘口值,如-0.5、-1、-1.5
选项Selection / Option盘口线下的投注项,如主胜、客胜
盘口卡片Market Card操盘页中展示单个玩法的UI组件

16.4.3 操作相关术语

术语英文定义
上架List将赛事发布到客户端,开始接受投注
下架Delist将赛事从客户端撤回,停止接受投注
隐藏Hidden临时停止接受投注,可恢复
锁定Lock强制停止接受投注,仅高权限可解锁
数据源开关Data Source Switch数据源跟随开关,开启时赔率、盘口状态、结算跟随IM数据源

16.4.4 数据源相关术语

术语英文定义
IMInplay Matrix数据源提供商名称
Delta推送Delta Push增量数据推送,仅推送变更部分
Full PullFull Pull全量数据拉取
跟随配置Follow Source是否跟随数据源状态变更

16.5 字段索引

16.5.1 赛事级字段

字段名数据类型来源说明定义章节
EventId字符串IM赛事唯一标识第12章12.1
HomeTeamName字符串IM主队名称第12章12.1
AwayTeamName字符串IM客队名称第12章12.1
LeagueId字符串IM联赛ID第12章12.1
LeagueName字符串IM联赛名称第12章12.1
MatchTime时间戳IM开赛时间第12章12.1
EventStatusId枚举IM赛事状态第12章12.1
SettlementId枚举IM结算状态第12章12.1
ListStatus枚举本地上架状态第12章12.2
AssignedTrader用户ID本地负责操盘手第12章12.2

16.5.2 盘口级字段

字段名数据类型来源说明定义章节
BetTypeId整数IM玩法类型ID第12章12.3
BetTypeName字符串IM玩法名称第12章12.3
MarketId字符串IM盘口唯一标识第12章12.3
Handicap数值IM盘口值(让球/大小)第12章12.3
IsMainLine布尔IM/本地是否主力线第12章12.3
MarketStatus枚举本地盘口状态第12章12.3
HiddenSource(隐藏来源标识)枚举本地隐藏来源(仅隐藏时有值)第12章12.3

16.5.3 选项级字段

字段名数据类型来源说明定义章节
SelectionId字符串IM选项唯一标识第12章12.4
SelectionName字符串IM选项名称第12章12.4
OddsHK数值本地本地HK赔率(3位小数)第12章12.4
OddsHK_IM数值IMIM源HK赔率第12章12.4
OddsDeviation数值计算本地与IM偏离值第12章12.4
BetAmount数值本地投注金额第12章12.4
BetRatio百分比计算投注比例第12章12.4
OptionStatus枚举本地选项状态第12章12.4
DataSourceEnabled布尔本地数据源开关是否开启第12章12.4

16.6 配置项归属关系图

配置项按三级层级关系,优先级从高到低:赛事级覆盖 > 联赛级 > 风控/系统级默认值。

配置层级说明

层级名称配置位置作用范围优先级
第1层系统管理配置系统后台全系统通用最低
第2层风控管理配置风控后台全联赛
第3层联赛管理配置联赛后台单个联赛较高
第4层赛事级配置操盘页单个赛事最高

已移除的写死项(一期无配置入口,详见16.1.0):

  • 赔率边界6项(最大/最小HK、RTP范围、目标RTP、单次调幅)— 系统写死常量
  • 系统管理5项(精度规则、同步间隔、超时、日志保留)— 系统管理默认值写死

16.7 数据联动规则引用

单一真源:数据联动规则详见操盘列表第16章。本节仅列出核心规则引用。

16.7.1 联动设计原则(引用操盘列表第16章16.1.2节

原则说明
安全优先上游状态变更导致风险时,优先隐藏
人工意图优先人工操作的状态不被系统自动覆盖
配置不穿透配置变更不直接触发已上架实体的终态变更
可追溯所有联动操作记录日志

16.7.2 状态覆盖优先级

两种优先级说明

  • 状态优先级(本节,4级):定义盘口状态之间的覆盖关系(关盘 > 锁定 > 隐藏 > 开盘)
  • 触发源优先级操盘列表第16章16.3.11节,6级):定义不同触发源同时作用时的优先顺序(数据源关盘 > 人工锁定 > 风控隐藏 > 联赛暂停 > 数据源恢复 > 人工隐藏)
优先级状态说明
1(最高)关盘数据源关盘最高优先级,不可逆
2锁定人工锁定,仅主管/风控可解锁
3隐藏可被锁定覆盖,可取消隐藏为开盘
4(最低)开盘初始状态,可被任何状态覆盖

16.7.3 跟随配置生效规则(引用操盘列表第16章16.8.7节

变更类型生效时机说明
联赛级跟随配置变更立即生效已上架赛事立即与数据源同步
联赛级其他配置变更仅对新上架赛事生效已上架赛事保持原配置
赛事级配置变更立即生效针对单个已上架赛事

16.8 一期支持的BetTypeId清单

一期系统仅支持以下BetTypeId的展示与操盘操作,其他BetTypeId暂不在范围内:

16.8.1 支持清单

SSOT声明:渲染器映射的单一真源为操盘页第6章6.3.1节「渲染器映射表」

BetTypeId玩法名称选项数渲染器玩法分组
BT1让球2MultiLineTable让球组
BT2大小2MultiLineTable大小组
BT3独赢1X23SingleLineTable进球组
BT5单双2SingleLineTable进球组
BT6波胆27+Matrix特殊组
BT7总进球7+LongList进球组
BT8双重机会3SingleLineTable进球组
BT9半全场9Matrix特殊组
BT158反波胆27+Matrix特殊组
BT159第X粒入球球队3SingleLineTable进球组
BT160主队大小2MultiLineTable大小组
BT161客队大小2MultiLineTable大小组

16.8.2 范围说明

分类BetTypeId展示可操盘说明
标准可操盘玩法BT1/BT2/BT3/BT5/BT6/BT7/BT8/BT9/BT158/BT159/BT160/BT161(共12个)支持赔率编辑、状态控制、数据源开关等全部操盘功能
纯透传玩法其他所有BetTypeId展示数据源推送内容(只读),不支持操盘操作
  • 标准可操盘玩法(12种):BT1让球、BT2大小、BT3独赢1X2、BT5单双、BT6波胆、BT7总进球、BT8双重机会、BT9半全场、BT158反波胆、BT159第X粒入球球队、BT160主队大小、BT161客队大小
  • 纯透传玩法:数据源推送的所有其他BetTypeId均展示,但仅支持查看,不支持赔率编辑、状态控制等操盘操作;数据源开关强制开启且不可关盘
  • 以上标准可操盘玩法合计12种,为一期操盘页支持的完整可操盘玩法范围

修订记录

版本日期修订内容
v1.02026-01-22初稿
v1.12026-01-22SSOT裁决修正:1) 枚举定义改为引用单一真源,删除重复定义;2) 明确区分「暂停来源」和「操作来源」两个不同枚举;3) 日志保留天数统一为180天(与第12章12.6.1节一致);4) 新增16.0节SSOT声明表
v1.22026-01-28【跨文档一致性修复】1) 16.3.2节暂停来源补齐为9种;2) 16.3.3节操作来源补齐为9种;3) 16.8.1节BetTypeId映射表修正玩法名称和渲染器(按第6章6.3.1节宪法口径);4) 新增SSOT声明
v1.32026-01-2816.7.2节格式修复:删除不规范的自引用注释(>>>>)
v1.42026-01-281) 删除技术配置(WebSocket/轮询/会话超时);2) 16.7.2节补充状态优先级(4级)与触发源优先级(6级)的区分说明;3) 16.8.2节修正:透传玩法展示但不可操盘
v1.52026-01-28【跨文档一致性对齐】1) 16.3.3节操作来源表格补齐"标签颜色"和"触发场景"字段(与真源18.3.2对齐);2) 16.1.1节风险敞口阈值从50万修正为100万(符合核心摘要定义);3) 16.3.2节暂停来源表格字段对齐真源(优先级→触发场景)
v1.62026-01-28【配置表完整性补充】16.1.1节补充第7章跳水相关配置项:联赛默认目标RTP(95.0%)、数据源同步最小间隔(500ms)、单边比例严重超限阈值(85%)、大额单笔跳水阈值(50,000)、累计投注额跳水阈值(500,000)、净风险敞口跳水阈值(1,000,000)、基础跳幅(0.02)、单次跳幅上限(0.05)、累计跳幅上限(0.30)、偏离值编辑范围(-1.00至+1.00)
v1.72026-01-29【宪法v1.6术语对齐】16.3.2节"暂停来源"→"隐藏来源",术语"人工暂停/风控暂停"→"人工隐藏/风控隐藏";16.3.3节示例"盘口暂停"→"盘口隐藏";16.7.2节状态优先级"暂停"→"隐藏"
v1.82026-01-29【术语一致性修复】16.0节SSOT声明表"暂停来源枚举"→"隐藏来源枚举";16.3节术语说明"暂停"→"隐藏";16.5.2节字段名SuspendSource→HiddenSource
v1.92026-02-11【A1架构修正】IM暂停不再作为隐藏来源:1)16.3.2节隐藏来源枚举中data_source改为"数据源状态标记",明确"不再作为隐藏来源";2)maintenance改为"数据源维护",event_incident改为"赛事事件"
v2.02026-02-12【16.1.1风控配置精简】删除11项不存在的配置项(偏离值编辑范围、单边严重超限、跳水阈值3项、大额累计告警、跳幅3项、数据延迟告警、风险注单超时),仅保留4项告警阈值(风控管理配置);同步更新16.2.1生效时机表、16.6归属关系图
v2.12026-02-12【货量告警补回】16.1.1节新增「货量接近上限告警阈值」(默认80%),详细说明两个检测维度(整场货量÷整场限额、分组货量÷分组限额)及告警提示内容;16.2.1节同步补充;风控管理HTML原型同步新增
v2.22026-02-12【6组架构对齐】1)16.0 SSOT表:赛事限额→联赛分组;2)16.1.1货量告警说明:A-E→6组、÷→除以、A组示例→让球组示例(300,000)、整场默认值对齐02章(1,000,000);3)16.8.1 BetTypeId映射表风控分组列:A-E→让球/大小/角球/进球/半场/特殊

文档结束

体育操盘系统产品文档