Appearance
第八章 数据源盘口
关盘口径(2026-04-21 生效):关盘来源统一为数据源推送(唯一来源);关盘 = 绝对终态,操盘页与结算详情页均不提供人工开盘入口。
本期范围(2026-04-21):
- 本期实装:数据源自动拉取盘口的比分 / 状态字段 / 结算结果标记等基础数据;"数据源接管态 / 本地锁定态单向流转 / 超时解锁待手动结算"状态机本期生效
- 本期不实装:"数据源盘口按 IM 推送状态字段自动派彩(L1)"——一期数据源盘口在数据源接管态下仍展示 IM 推送数据作为参考,但不自动派彩;结算人员需手动确认结算(与可操盘盘口一致)
- 详见第 1.5 节 结算自动化 4 层模型 · 本期范围与第 11.0.1 节
8.1 定位
数据源盘口 Tab 展示结算完全依赖 IM 驱动的盘口(不包含可操盘盘口)。数据源盘口默认为只读——本地系统依据 IM 推送的比分数据 + 盘口状态字段自动完成结算,结算人员不介入。仅在以下场景开放本地结算能力:
| 触发条件 | 开放能力 |
|---|---|
| 盘口已关盘 + 该盘口所需比分数据已可得 + 数据源在配置时长内未推送该盘口的终态 | 该盘口自动解锁为「待手动结算」,结算人员可补录并本地结算 |
关于"结算结果"来源:IM 本身不直接推送结算结果(赢/输/走水),但会推送比分数据 + 盘口状态字段(如关盘/已结算标记)。本地系统按 IM 状态字段变化驱动数据源盘口派彩(L1),或按比分 + BT 级判定规则计算可操盘盘口结算结果(L2-L4)。
8.2 展示内容
| 字段 | 数据源接管态 | 本地接管态(待手动结算 / 本地锁定) |
|---|---|---|
| 盘口名称 | 如「角球大小」「红牌大小」 | 同左 |
| 盘口线 | 如 9.5 | 同左 |
| 结算依据 | 如「角球总数」「红牌总数 = 1」 | 同左 |
| 结算结果 | 本地系统按 IM 推送的比分数据 + 盘口状态字段直接展示(只读,下拉框禁用) | 结算人员可选择(下拉框启用) |
| 结算状态 | 待结算(IM 推送比分/状态同步中)/ 已结算(IM 已推送终态) | 待手动结算 / 本地锁定·已结算 |
| 结算时间 | IM 推送盘口终态的时刻(本地同步时间) | 结算人员确认时间 |
| 赛果同步开关 | 开 → 本地跟随 IM 推送数据;关 → 不跟随 | 不适用(已脱离数据源管控) |
8.3 数据源盘口的生命周期子态(单向流转)
数据源盘口主状态仍遵循盘口 4 种枚举(开盘 / 关盘 / 已结算 / 已取消,见 第 18 章 18.1);在生命周期内按结算来源区分 3 个业务子态,子态之间单向流转,不可逆:
| 子态 | 触发条件 | 特性 |
|---|---|---|
| 数据源接管态 | 盘口创建后的默认态 | 比分数据和盘口状态均由数据源推送同步;本地系统按数据源状态字段直接触发派彩;卡片只读;结算人员不可介入 |
| 待手动结算 | 盘口已关盘 + 数据源超时未推送终态 + 该盘口所需比分数据已可得 | 系统自动解锁,结算人员可在该盘口发起人工结算 |
| 本地锁定态 | 结算人员完成本地人工结算后自动进入 | 数据源后续推送的任何比分、状态变化均不再覆盖本地结果,仅作告警记录 |
单向性(不可逆):一旦进入本地锁定态,即使数据源后续恢复并推送该盘口的新比分或状态变化,均不回切到数据源接管态。其逻辑原因是本地结算已生效,若允许 IM 数据覆盖会导致派彩反复,影响用户体验和对账。
判定超时的条件(按盘口独立累计):
| 条件 | 说明 |
|---|---|
| 盘口已关盘 | 前置条件(关盘来源可以是 IM 推送关盘状态或结算人员手动) |
| 该盘口所需比分数据已可得 | 前置条件(比分可来自 IM 推送或结算人员录入) |
| 该盘口数据源未推送盘口终态超过配置时长(默认值为 30 分钟,系统级写死,见第 20 章配置项汇总) | 触发解锁 |
| 数据源断连期间各盘口独立累计超时 | 每个盘口独立计时,不共享阈值;不依赖赛事级状态 |
8.4 串关关联盘口
数据源盘口 Tab 底部展示「串关关联盘口」区域,展示因串关子单关联而需要展示的数据源盘口。
8.4.1 触发逻辑与去重规则
| 维度 | 规则 |
|---|---|
| 触发条件 | 当前赛事存在至少一笔串关注单(母单未结算或部分已结算)且该母单包含一个或多个数据源盘口子单时,底部"串关关联盘口"区域出现 |
| 反查映射 | 按盘口 ID 精确匹配反查(不用 BT + 盘口线模糊匹配):从串关子单引用的盘口 ID → 查找对应数据源盘口记录 |
| 去重规则 | 同一数据源盘口被多笔串关共用时合并为一行展示;"关联串关"字段汇总 N 单 / 总投注额 |
| 与上半部 Tab 的关系 | 上半部 Tab 展示该赛事全部数据源盘口(无论是否被串关引用);底部"串关关联盘口"是上半部的子集高亮(被串关引用的数据源盘口会同时出现在两处) |
| 排序 | 按串关关联金额倒序;同金额按盘口 ID 升序 |
8.4.2 字段
| 字段 | 说明 |
|---|---|
| 盘口名称 | — |
| 关联串关 | N 单 / ¥X,XXX(去重后合计) |
| 结算状态 | 待结算 / 数据源已结算 / 本地已结算 |
| 无赛果原因 | 玩法不支持 / 数据源超时 |
| 操作 | 待结算:该盘口所需赛果已可得后显示「根据数据计算结果」+「确认结算」;已结算:只读 |
串关结算规则(对齐新版 第 14.2b 节 本地/数据源/混合三分支):可操盘盘口子单走本地引擎;数据源盘口子单 IM 有数据时走 L1,IM 超时时走本地兜底。
8.5 数据源盘口不支持人工开盘
| 规则 | 说明 |
|---|---|
| 人工开盘 | 不支持。无论盘口处于数据源接管态还是本地锁定态,任何角色均不可通过界面触发开盘 |
| 生命周期 | 由数据源完全驱动。盘口的开 / 关 / 结算由数据源自身节奏推进;本地仅作同步 |
| 本地锁定后的投注窗口 | 不再接受新投注。如需重新接受投注须由数据源重新下发盘口(作为新盘口处理) |