体育操盘系统 PRD

Appearance

第九章 数据字段定义 ​

本章定义操盘列表涉及的所有数据字段，包括字段名称、数据类型、取值范围、来源及业务含义。

9.0 核心术语定义 ​

本节定义操盘系统中的核心术语，全文统一使用以下口径：

术语英文定义层级示例
玩法BetTypeIM数据源定义的投注类型第二级让球(BT1)、大小(BT2)、独赢(BT3)
盘口线Marketline / Handicap同一玩法下的不同数值线第三级（仅部分玩法有）让球-0.5、让球-1、大小2.5
选项Selection / Outcome可投注的具体结果第四级主队、客队、大、小、1:0、2:1
盘口Market本文档中"盘口"统一指代"玩法"层级，历史文档存在混用——

控制层级：赛事 → 玩法 → 盘口线（若有） → 选项。详见第16章16.1.5节。

9.0.1 术语使用规范 ​

场景正确用法错误用法
描述投注类型"让球玩法"、"独赢玩法""让球盘口"（历史遗留可接受）
描述数值线"让球-0.5盘口线""让球-0.5盘口"
描述投注选项"主队选项"、"大选项""主队盘口"
统计开盘数量"开盘玩法数"或"盘口数"（沿用习惯）—

9.0.2 IM字段与本地字段映射说明 ​

本章定义的字段分为两类：IM数据源原始字段和本地系统派生字段。两类字段的命名和取值必须严格区分，禁止混用。

9.0.3 字段分类原则 ​

分类定义命名规范示例
IM原始字段由IM数据源API直接推送的字段保持IM原始字段名EventStatusId, MarketlineStatusId, RBTimeStatus
本地派生字段由本地系统根据业务规则计算或定义的字段使用业务语义命名MatchPhase（比赛进程）, ListingStatus（上架状态）, SettlementStatus（结算状态）

9.0.4 IM关键字段速查表 ​

IM字段名数据类型取值范围业务含义刷新方式
EventStatusIdInt1=开盘, 2=关盘赛事级盘口开关状态Delta推送
MarketlineStatusIdInt1=开盘, 2=关盘单个盘口开关状态Delta推送
IsMaintenanceBooltrue/false赛事是否维护中Delta推送
MarketInt1=早盘, 2=今日, 3=滚球盘口时间分类Full Pull
EventPeriodIdInt10/20/25/30/40/45/50/60/100比赛阶段Delta推送
RBTimeString如"45:00"滚球比赛时间Delta推送
RBTimeStatusInt0=不适用, 1=开始, 2=进行中, 3=暂停滚球时间状态Delta推送
LiveStatusIdInt1=未开始, 2=滚球中, 3=完场, 4=延期, 5=取消等赛事生命周期状态（与EventStatusId不同，本字段表示赛事进行状态，而非盘口开关状态）Delta推送

9.0.5 IM三层状态字段关系说明 ​

IM数据源推送三类独立的状态字段，各自控制不同层面，不可混淆：

字段控制层面取值含义本地对应
EventStatusId盘口开关（市场状态）1=开盘，2=关盘盘口状态计算输入
LiveStatusId赛事生命周期（进行状态）1=未开始，2=滚球中，3=完场，4=延期，5=取消等比赛进程派生输入
SettlementStatus结算状态（本地派生）normal_end/cancelled/interrupted/abandoned/walkover/withdrawal结算管理流转依据

三层字段的独立性：

  1. EventStatusId=2（关盘） 不等于赛事结束，只表示该盘口市场关盘（包括玩法结算、提前关盘等）
  2. LiveStatusId=3（完场） 表示赛事生命周期结束，此时系统会同步触发盘口关盘
  3. SettlementStatus 是本地派生字段，由结算接口或人工标记确定，与IM字段独立

易混淆场景澄清：

场景EventStatusIdLiveStatusId系统行为
玩法提前结算2（关盘）2（滚球中）该玩法关盘，赛事继续
比赛正常结束2（关盘）3（完场）全部盘口关盘，流转结算
比赛延期1或24（延期）盘口隐藏，保留在操盘列表
数据源维护1（开盘）2（滚球中）IsMaintenance=true时强制隐藏

9.1 赛事基础信息 ​

字段名数据类型来源IM 对应字段说明
赛事编号字符串本地生成—本地唯一标识，格式如 IM20250119001
数据源赛事编号字符串数据源EventId数据源原始编号
联赛编号字符串数据源CompetitionId所属联赛唯一标识
联赛名称字符串数据源CompetitionName联赛中文名称
联赛英文名称字符串数据源CompetitionNameEn联赛英文名称
联赛等级枚举本地配置—S、A、B、C
国家编号字符串数据源LocationId联赛所属国家
国家名称字符串数据源LocationName国家中文名称
主队编号字符串数据源HomeTeamId主队唯一标识
主队名称字符串数据源HomeTeam主队中文名称
客队编号字符串数据源AwayTeamId客队唯一标识
客队名称字符串数据源AwayTeam客队中文名称
开赛时间时间戳数据源EventDate计划开赛时间，UTC 时区
实际开赛时间时间戳数据源—实际开球时间，滚球后有值
体育类型枚举数据源SportId支持 IM 所有运动类型，1=足球
中立场标识布尔值数据源GroundTypeId0=中立场, 1=主场
热门标识布尔值本地配置或数据源IsPopular是否为热门赛事
直播标识布尔值数据源LiveStreaming是否有视频直播

9.1.1 赛事编号生成规则 ​

本地赛事编号采用以下格式：IM{YYYYMMDD}{序号}

部分说明示例
IM固定前缀，标识数据源为 Inplay MatrixIM
YYYYMMDD赛事创建日期（北京时间）20250119
序号当日流水号，6 位数字，不足补零000001

完整示例：IM20250119000001

9.1.2 联赛等级定义 ​

联赛等级在联赛管理中配置（默认+等级1-10共11档），用于区分联赛重要程度和风控策略。等级与风控管理「联赛分组」的等级对应。

等级说明典型联赛风控策略
等级1顶级联赛英超、西甲、德甲、意甲、法甲、欧冠、世界杯最宽松，高限额
等级2重要联赛荷甲、葡超、巴甲、中超、欧联杯较宽松
等级3次要联赛各国次级联赛标准偏宽
等级4-7普通联赛各国杯赛、中游联赛标准策略
等级8-9低级联赛低级别联赛较严格
等级10最低联赛极低级别联赛、友谊赛最严格，低限额
默认未分配未配置等级的联赛使用默认档限额配置

9.2 比赛进程信息 ​

术语区分：比赛进程 vs 比赛阶段

术语英文来源用途取值示例
比赛进程MatchPhase本地派生字段本地Tab筛选、状态显示赛前、即将、滚球、中场、完场（共5种）
比赛阶段EventPeriodIM原始字段标识具体比赛阶段足球：上半场/下半场；电竞：第一局/第二局等

设计说明：比赛进程是本地统一的进程分类，用于操盘列表Tab筛选和状态展示；比赛阶段是IM数据源推送的原始字段，不同体育类型有不同取值（足球有上半场/下半场，电竞有第一局/第二局等）。两者不可混用。

字段名数据类型来源IM 对应字段说明
比赛进程枚举计算—赛前、即将、滚球、中场、完场（共5种，见9.2.3节）
比赛阶段枚举数据源EventPeriodId上半场、中场休息、下半场、加时上半场、加时中场、加时下半场、点球（足球）；第一局、第二局等（电竞）
比赛分钟字符串数据源RBTime当前比赛时间，如"45:00"
补时分钟整数数据源—伤停补时分钟数（从RBTime解析）
时间状态枚举数据源RBTimeStatus运行中、暂停、比赛暂停
主队比分整数数据源HomeScore主队当前得分
客队比分整数数据源AwayScore客队当前得分
主队红牌整数数据源HomeRedCard主队红牌数
客队红牌整数数据源AwayRedCard客队红牌数
盘口时间分类枚举数据源Market1=早盘, 2=今日, 3=滚球
最后更新时间时间戳数据源—数据最后更新时间

9.2.1 比赛阶段枚举（EventPeriodId） ​

EventPeriodId英文名称中文名称对应比赛进程
10Not Started未开始赛前/即将
20First Half上半场滚球
25Half Time中场休息中场
30Second Half下半场滚球
40Extra Time First Half加时上半场滚球
45Extra Time Half Time加时中场中场
50Extra Time Second Half加时下半场滚球
60Penalty Shootout点球大战滚球
100Ended完场完场

9.2.2 时间状态枚举（RBTimeStatus） ​

RBTimeStatus英文名称中文名称说明
0Not Applicable不适用非滚球状态
1Started开始比赛刚开始
2Running进行中比赛时间正常流逝
3Stopped暂停比赛时间暂停（如犯规、换人、VAR）

9.2.3 比赛进程计算规则 ​

比赛进程（MatchPhase）是本地派生字段，根据IM多个字段计算得出：

条件比赛进程值说明
Market ∈ (1, 2) 且 EventPeriodId = 10 且 距开赛 > 30 分钟赛前距离开赛较远
Market ∈ (1, 2) 且 EventPeriodId = 10 且 距开赛≤ 30 分钟即将即将开赛
Market = 3 且 EventPeriodId ∈ (20, 30, 40, 50, 60)滚球比赛进行中
Market = 3 且 EventPeriodId ∈ (25, 45)中场中场休息
EventPeriodId = 100完场比赛已结束

说明：「距开赛」= 开赛时间 - 服务器当前时间（北京时间）。

完场与盘口关盘的联动：当IM推送EventPeriodId=100（完场）时，系统自动将本地盘口状态流转为「关盘」，赛事从操盘列表移除并流转至结算管理模块。此规则与EventStatusId=2（数据源关盘）具有相同优先级，均为终态不可逆。详见第10章10.1.2节。

9.3 数据源盘口状态 ​

SSOT声明：本节定义数据源状态的字段映射规则，完整的联动处理规则见第16章16.3节「数据源盘口状态联动」。

数据源盘口状态表示IM数据源推送的赛事/盘口开关状态，由IM多个字段组合判断。

9.3.1 IM字段组合与本地状态映射 ​

本地状态值IM字段组合条件业务含义
开盘EventStatusId=1 且 MarketlineStatusId=1 且 IsMaintenance=false数据源正常开盘，可接受投注
暂停MarketlineStatusId≠1 或 进球/红牌事件触发数据源临时暂停推送
维护IsMaintenance=true数据源维护中
关盘EventStatusId=2 或 Delta Action=4/13数据源关盘该赛事/玩法

一期依赖范围：系统仅对以下状态值做业务分支判断：OPEN（开盘1/4） / SUSPENDED（暂停） / LOCKED（锁定） / CLOSED（关盘2）。IM返回未识别取值时，前端展示原始值并打点告警；后端按"更保守"处理（不自动开盘）。

"更保守处理"定义：当IM返回未识别的状态值时，系统按以下规则处理：

场景更保守处理方式原因
未识别的EventStatusId视为关盘，阻止开盘操作防止在异常状态下接受投注
未识别的MarketlineStatusId视为暂停，不自动开盘等待人工确认后再处理
未识别的IsMaintenance视为维护中，强制暂停宁可误暂停，不可误开盘

SSOT：数据源状态的完整联动规则见第16章16.3节。

9.3.2 结算状态定义 ​

结算状态（SettlementStatus）是本地派生字段，独立于数据源盘口状态，由结算接口或内部系统判定。

状态值含义触发来源结算规则
normal_end正常完场结算接口（EventPeriodId=100触发查询）按结果结算
cancelled取消结算接口或人工标记全额退款
interrupted中断结算接口或人工标记待人工决策
abandoned腰斩结算接口或人工标记部分结算+部分退款
walkover弃权人工标记按弃权规则结算
withdrawal退赛人工标记按退赛规则结算

9.3.3 数据源状态变更场景 ​

变更典型场景持续时间
开盘 → 暂停进球、红牌、VAR、比分变更5-30 秒
暂停 → 开盘事件处理完成，赔率更新后—
开盘 → 维护数据源系统维护、数据修正分钟级
维护 → 开盘维护完成—
任意 → 关盘玩法结算、赛事结束、提前关盘永久

9.4 上架状态 ​

上架状态表示赛事在本地系统的上架情况，由本地操作决定。

状态值含义客户端可见接受投注操盘列表筛选
待上架数据源已下发，等待审核上架否否「待上架」Tab
已上架已对外展示是由盘口状态决定「全部」「滚球」「赛前」Tab
已下架人工隐藏否否「全部」Tab

9.4.1 上架状态与客户端可见性 ​

上架状态盘口状态客户端是否可见是否接受投注
待上架—否否
已上架开盘是是
已上架隐藏是否
已上架锁定是否
已上架关盘否否
已下架—否否

设计说明：已上架+关盘时客户端不可见。关盘表示玩法已结算或赛事已结束，此时即使赛事仍为"已上架"状态，客户端也不再展示该盘口/赛事。

9.5 盘口状态 ​

盘口状态表示赛事下盘口的投注开关状态，由数据源状态和人工控制状态叠加计算。操盘列表显示的是该赛事所有盘口的汇总状态。

状态值含义触发方式接受投注客户端可见
开盘可接受投注人工取消隐藏或数据源恢复（需跟随配置为是）是是
隐藏临时隐藏投注数据源推送（需跟随配置为是）、风控触发或人工隐藏，可自动恢复否是
锁定人工锁定仅人工操作，必须人工解锁否是
关盘已关盘玩法结算完成或赛事结束（数据源关盘强制执行）否否

9.5.1 隐藏与锁定的区别 ​

维度隐藏锁定
触发方式系统/数据源/风控/人工人工操作
恢复方式可自动恢复（受跟随配置影响）必须人工解锁
典型场景进球、红牌、数据延迟、下架联动风险控制
数据源恢复时可自动恢复（若跟随配置为是）保持锁定，需人工解锁

SSOT：隐藏来源枚举定义（manual/data_source/league_pause/risk_control等9种来源）见第16章16.1.4节。

9.5.2 盘口状态汇总规则 ​

单个赛事包含多个盘口（让球、大小球、独赢等），操盘列表显示汇总状态的规则：

优先级条件显示状态说明
1存在任一盘口为锁定锁定锁定优先级最高
2不存在锁定，存在隐藏隐藏部分盘口隐藏
3全部盘口为开盘开盘全部可投注
4全部盘口为关盘关盘全部已关盘
—待上架或已下架横杠（不显示）未上架赛事无盘口状态

设计说明：汇总状态只有四种（开盘/隐藏/锁定/关盘），不显示"部分关盘"。如需查看各盘口详细状态，可悬停查看分布或进入详情页。

9.5.3 数据源状态对盘口状态的影响 ​

数据源（IM）会推送盘口状态，本地是否跟随由联赛管理中的「是否跟随数据源盘口状态」（默认值为「是」，联赛管理配置）决定。

数据源状态跟随配置=是跟随配置=否备注
开盘盘口可开盘盘口可开盘两种配置均可开盘
暂停C端显示暂停投注（本地状态不变）本地保持当前状态，告警列显示「数据源暂停」不改变本地状态
恢复C端恢复投注（本地状态不变）本地保持当前状态，需人工取消隐藏恢复不自动显示
维护本地强制隐藏本地强制隐藏不受配置影响
关盘本地强制关盘本地强制关盘不受配置影响，优先级最高

9.5.4 盘口最终状态计算规则 ​

SSOT：状态覆盖优先级的完整定义见第16章16.3.11节。本节仅作简要说明。

盘口最终状态由多个触发源按优先级叠加计算（数字越小优先级越高）：

优先级触发源说明
1数据源关盘终态，不可逆
2人工锁定必须人工解锁
3风控自动隐藏触发条件解除后可自动恢复
4联赛暂停/关盘联赛级控制
5数据源暂停/恢复受跟随配置控制
6人工隐藏/取消隐藏最低优先级

状态计算结果速查表：

人工控制状态数据源状态最终盘口状态接受投注
锁定任意锁定否
隐藏任意（非关盘）隐藏否
无维护隐藏（强制）否
无暂停开盘（C端暂停投注）否
无关盘关盘否
无开盘开盘是

9.6 跟随数据源配置 ​

「是否跟随数据源盘口状态」是联赛级别的配置项，控制上架后盘口是否自动跟随 IM 开盘/暂停状态。

字段名数据类型配置位置默认值说明
是否跟随数据源盘口状态布尔值联赛管理页面是控制数据源暂停/恢复时本地是否跟随

9.6.1 配置影响范围 ​

配置粒度为联赛级别，同一联赛下所有赛事共享此配置。配置变更后对该联赛下所有已上架赛事立即生效。数据源维护和关盘状态不受此配置影响，始终强制执行。

口径补充：

  • 本节"立即生效"仅指【是否跟随数据源盘口状态】这一个跟随类配置。
  • 其他配置项（例如默认操盘手、玩法启用列表等联赛管理配置，以及RTP范围等风控管理配置）在赛事【上架时固化为赛事快照】；配置变更仅对【新上架赛事】生效，已上架赛事不回刷。
  • 统一规则详见：第16章16.8.7节「配置变更生效时机」。

9.6.2 跟随配置使用场景 ​

配置值适用场景说明
是（默认）常规联赛、信任数据源的联赛盘口状态完全跟随数据源，减少人工干预
否低级别联赛、数据源不稳定的联赛盘口状态由人工控制，数据源暂停时仅告警不自动隐藏

9.7 盘口数 ​

盘口数展示当前赛事的盘口开盘情况。

显示格式说明示例
X 开 / Y 总X 为开盘数，Y 为总盘口数13 开 / 15 总

9.7.1 盘口数计算规则 ​

字段计算方式说明
开盘盘口数COUNT(盘口状态 = 开盘)当前可投注的盘口数量
非开盘盘口数COUNT(盘口状态 IN (隐藏, 锁定, 关盘))当前不可投注的盘口数量
总盘口数COUNT(所有盘口)该赛事所有盘口总数

9.7.2 盘口数显示格式 ​

显示位置显示格式示例
操盘列表第五列「盘口数」X开/Y总15开/18总
赛事操盘详情页X开/Y总 或 分类型详情同上

格式说明：与07章7.2.5节保持一致，显示「开盘数/总数」而非「开盘数/关盘数」。

9.8 赔率类型 ​

赔率类型展示当前赛事使用的赔率格式。

赔率类型代码显示颜色说明主要市场
马来盘MY绿色亚洲主流马来西亚、新加坡
欧洲盘EU蓝色欧洲标准欧洲、美国
香港盘HK橙色港澳常用香港、澳门
印尼盘ID紫色东南亚常用印尼、越南

赔率类型在联赛管理中配置，操盘列表仅展示。

9.8.1 赔率类型转换关系 ​

原始类型马来盘香港盘印尼盘欧洲盘
马来盘正数 +0.5+0.50.5+0.51.5
马来盘负数 -0.5-0.52.0-2.03.0

说明：赔率转换公式详见数据接口文档。

9.9 投注统计字段 ​

字段名数据类型计算公式说明
投注总额金额SUM(注单.投注金额)该赛事所有注单的投注金额合计
预计赔付金额SUM(注单.投注金额 × 注单.赔率)按当前比分计算的预计赔付金额
预估盈亏金额投注总额 - 预计赔付正数为盈利，负数为亏损
最高单边比例百分比MAX(各玩法单边比例)所有玩法中单边比例最高的值
最高单边方向字符串—最高单边比例对应的投注方向
最高单边玩法字符串—最高单边比例对应的玩法名称
开盘玩法数整数COUNT(玩法状态 = 开盘)当前开盘的玩法数量

9.9.1 单边比例计算规则 ​

单边比例用于衡量某个玩法的投注分布是否失衡。

字段计算公式示例
单边比例MAX(某方向投注额 / 该玩法总投注额) × 100%让主投注 82 万，让客投注 18 万，单边比例 = 82%
单边方向投注额最高的方向让主

9.9.2 投注统计字段更新频率 ​

字段更新频率说明
投注总额实时每笔注单确认后立即更新
预计赔付实时每笔注单确认后立即更新
预估盈亏实时每笔注单确认后立即更新
最高单边比例实时每笔注单确认后立即更新
开盘玩法数实时盘口状态变更后立即更新

9.10 操盘手分配 ​

字段名数据类型说明是否必填
主操盘手编号字符串主要负责的操盘手上架时必填
主操盘手姓名字符串主要负责的操盘手姓名—
协助操盘手列表数组协助操盘的其他操盘手选填
分配时间时间戳最后一次分配时间自动记录
分配人字符串执行分配操作的主管自动记录

9.10.1 操盘手分配规则 ​

场景分配方式说明
上架时必须分配上架确认弹窗中选择操盘手
批量上架可选择统一分配或按联赛默认批量操作时提供选项
已上架赛事主管可更换点击操盘手列更换

9.10.2 联赛默认操盘手 ​

联赛管理中定义联赛默认操盘手（默认值为空，联赛管理配置），批量上架时选择「按联赛默认」自动分配。

字段名数据类型配置位置说明
联赛默认操盘手字符串联赛管理页面该联赛赛事上架时的默认操盘手

9.11 告警类型枚举 ​

告警类型用于标识赛事当前存在的异常或需关注的情况，在操盘列表的告警列中显示。

9.11.1 告警类型定义 ​

告警代码标签文案样式触发条件优先级
MOST_URGENT最紧急红色闪烁上架状态=待上架 且 比赛进程=滚球1
URGENT紧急红色上架状态=待上架 且 比赛进程=即将 且 距开赛≤10分钟2
ONE_SIDE_EXCEED单边超限红色最高单边比例超过告警阈值3
LARGE_BET大额橙色单笔或单场合计投注超过大额阈值4
POSTPONE_TIMEOUT延期超时橙色/红色结算状态=延期 且 延期时长超过阈值（80%橙色/100%红色/150%红色+置顶）5
MATCH_PAUSED比赛暂停橙色比赛进程=滚球 且 RBTimeStatus=3（暂停）6
SOURCE_PAUSED数据源暂停橙色数据源状态=暂停 且 跟随配置=否7
SOURCE_MAINT维护中紫色IsMaintenance=true8
DATA_DELAY数据延迟蓝色数据源最后推送时间距当前超过阈值（仅滚球赛事，默认5秒）9
UNASSIGNED未分配橙色上架状态=已上架 且 操盘手未分配 且 比赛进程 IN (滚球, 即将)10
NEUTRAL_GROUND中立场蓝色GroundTypeId=0 且 比赛进程 IN (滚球, 即将)11

9.11.2 告警级别分类 ​

级别包含告警类型显示特征处理要求
严重最紧急、紧急、单边超限、延期超时(100%+)红色/闪烁需立即处理
警告大额投注、延期超时(80%)、比赛暂停、数据源暂停橙色需尽快关注
提示数据源维护、数据延迟、未分配、中立场紫色/蓝色/橙色需知晓

9.11.3 告警阈值配置 ​

SSOT：告警阈值的完整定义见第16章16.5.0节「风控告警阈值定义」。

告警触发的具体阈值配置位置：

告警类型阈值参数字段标识配置位置
单边超限one_side_limit风控管理
大额投注（单笔）large_bet_single风控管理
大额投注（累计）large_bet_total风控管理
延期超时postpone_timeout联赛管理
数据延迟data_delay（固定值5秒）系统固定
即将开赛告警upcoming_alert联赛管理

各阈值的默认值与允许范围详见第16章16.5.0节。

9.11.4 告警显示规则 ​

规则项说明
多告警显示垂直排列显示，最多显示3个，超出显示 +N
显示优先级按9.11.1表中优先级排序，优先级数值越小越优先显示
无告警显示 —
悬停交互悬停告警标签显示详细信息（如大额投注显示具体金额和时间）

9.11.5 告警与行置顶联动 ​

特定告警类型触发行置顶，详见第7章7.3节「行样式规则」：

告警类型是否触发置顶置顶优先级
最紧急是1
紧急是2
单边超限、大额投注是3
延期超时(150%+)是4
其他告警否—

9.11.6 延迟概念区分 ​

系统中涉及多种"延迟"概念，需明确区分：

延迟类型定义检测方式处理机制相关章节
数据源推送延迟IM数据源最后一次推送赛事数据到当前的时间间隔比较最后更新时间与服务器时间触发DATA_DELAY告警9.11、16.5
WebSocket连接延迟WebSocket心跳响应超时心跳机制（30秒间隔）触发断线重连13.1
投注统计延迟投注统计数据的更新滞后实时推送机制无告警，仅影响显示13.4

说明：

  • DATA_DELAY告警仅针对数据源推送延迟，阈值默认5秒（固定值），仅对滚球赛事生效
  • WebSocket连接延迟是通信层面的健康检查，不产生告警，触发断线重连机制（详见数据通信机制相关文档）
  • 投注统计延迟是正常的数据传输时差，通过WebSocket实时推送保证最小延迟

9.11.7 全局阈值速查表 ​

系统中涉及多种阈值，本节汇总说明以避免混淆：

阈值名称数值用途定义位置
数据源推送延迟告警5秒（固定值）DATA_DELAY告警触发9.11.3/16.5.0
WebSocket心跳间隔30秒心跳检测周期13.1节
WebSocket断线阈值60秒显示断线提示13.6节
即将开赛（比赛进程）≤30分钟Tab筛选分类，本地派生字段9.2.3
紧急（置顶/告警/一键锁盘）≤10分钟（固定值）置顶条件、一键锁盘范围、紧急告警7.3.1/4.2.4
单边超限阈值风控管理定义ONE_SIDE_EXCEED告警16.5.0
大额投注阈值风控管理定义LARGE_BET告警16.5.0
延期超时阈值24小时（默认）POSTPONE_TIMEOUT告警16.5.0
即将开赛告警阈值10分钟（默认）URGENT告警16.5.0

阈值区分说明：

  • 即将开赛（比赛进程）：≤30分钟，用于Tab筛选分类，区分"赛前"和"即将"
  • 紧急（一键锁盘/置顶）：≤10分钟，用于置顶条件、一键锁盘范围、紧急告警触发
  • 两者是不同概念，10分钟为固定值
  • 延迟相关阈值见上方9.11.6节详细说明

9.12 状态组合约束 ​

以下状态组合在业务上不应出现，系统需要进行校验：

状态组合是否允许说明系统行为
已上架且未分配操盘手允许但告警滚球或即将状态触发未分配告警告警列显示「未分配」
待上架且盘口开盘不允许待上架赛事盘口不应开盘系统阻止，提示错误
已下架且盘口开盘不允许已下架赛事盘口不应开盘下架时自动隐藏所有盘口
完场且盘口开盘不允许完场赛事盘口不应开盘系统自动关闭

9.13 从操盘列表流转到结算管理的触发条件 ​

触发条件数据来源系统行为
EventPeriodId=100IM Delta推送关盘所有盘口，创建结算记录，等待结算接口返回具体结算状态
结算接口返回cancelled/interrupted/abandoned结算系统更新结算状态，执行对应结算规则，从操盘列表移除
人工标记walkover/withdrawal操盘手操作更新结算状态，执行对应结算规则，从操盘列表移除

修订记录 ​

版本日期修订内容
v1.02026-01-19初稿
v2.02026-01-20重构状态模型：区分IM数据源字段与本地派生字段；修正EventStatusId映射；新增9.0字段映射说明、9.3.2结算状态定义
v2.12026-01-20【审计修正】1) 9.4.1节修正关盘时客户端不可见；2) 9.5节增加客户端可见列；3) 9.5.2节移除"部分关盘"状态
v2.22026-01-21【字段覆盖检查】新增9.11告警类型枚举节（10种告警类型、级别分类、阈值配置、显示规则、置顶联动）；原9.11-9.12改为9.12-9.13
v2.32026-01-21【告警一致性修正】9.11.1节新增POSTPONE_TIMEOUT（延期超时）告警，告警类型从10种增至11种；更新9.11.2级别分类、9.11.3阈值配置、9.11.5置顶联动
v2.42026-01-27【逻辑一致性修复】1) 9.2节比赛进程增加"中场"；2) 9.2.1节EventPeriodId 25/45映射改为"中场"；3) 9.11.1节DATA_DELAY改为"数据延迟"并明确阈值；4) 新增9.11.6节"延迟概念区分"
v2.52026-01-28【全局审计修正】1) 新增9.0节核心术语定义（玩法/盘口线/选项/盘口）；2) 9.5.4节状态覆盖优先级改为引用16.3.11 SSOT；3) 9.2.3节补充EventPeriodId=100关盘联动说明；4) 9.6.1节修正跨章节引用；5) 9.11.3节告警阈值改为引用16.5.0 SSOT；6) 全文"开盘"改为"开盘"
v2.62026-01-28【术语一致性修复】1) 9.2节补充比赛进程/比赛阶段术语区分说明；2) 9.2.1节"已结束"统一为"完场"；3) 9.3节补充SSOT声明引用16.3节；4) 9.3.1节补充"更保守处理"具体定义；5) 9.7.1节"关盘盘口数"改为"非开盘盘口数"；6) 9.5.1节补充暂停来源SSOT引用；7) 9.0.4节LiveStatusId字段说明补充完整
v2.72026-01-28【审计修正】新增9.0.5节「IM三层状态字段关系说明」，澄清EventStatusId/LiveStatusId/SettlementStatus三层独立性
v2.82026-01-28【术语澄清】明确区分"即将开赛（比赛进程≤30分钟）"与"紧急（一键锁盘/置顶≤10分钟）"两个不同概念，补充阈值表区分说明
v2.92026-01-29【术语一致性】本地盘口状态"暂停"统一更名为"隐藏"，与宪法v1.6保持一致；人工操作从"暂停/恢复"改为"隐藏/取消隐藏"；9.0.4节延期/维护时"盘口暂停"→"盘口隐藏"；数据源状态术语（IM暂停）保持不变
v3.02026-02-11【A1架构修正】IM暂停不再改变本地状态，仅影响C端展示：1）9.5.3节数据源状态行为修正：暂停改为"C端显示暂停投注（本地状态不变）"；2）9.5.4节状态计算结果表暂停项改为"开盘（C端暂停投注）"，明确本地保持当前状态

体育操盘系统产品文档

Copyright © 2025