Appearance
第一章 产品概述
关盘口径（2026-04-21 生效）：关盘来源统一为数据源推送（唯一来源）；关盘 = 绝对终态，操盘页与结算详情页均不提供人工开盘入口。
一期调整（2026-04-23 生效）：第 1.5 节"结算自动化 4 层模型"中"已结算盘口赛果变化 → 自动重新结算"一期不实装；"赛果变化触发注单自动重算"从"系统自动"项移至"人工触发"项。系统仅在受影响的已结算盘口上标记提示"⚠️ 结算比分已发生变化，请检查盘口赛果"，由结算人员主动发起「盘口二次结算」处理；标记仅在执行完盘口二次结算后自动清除（不支持手动关闭）。正文规则保留作为二期设计参考。
1.1 产品定位
结算详情页是单场赛事的结算操作页面，负责赛果录入、盘口级结算执行、驳回与二次结算、赛事异常处理和赛事级确认结算。
| 定位项 | 说明 |
|---|---|
| 所属系统 | P1 体育操盘系统 |
| 适用赛事类型 | 仅常规单场赛事（EventTypeId = 2） |
| 核心目标 | 完成单场赛事的全部盘口结算，确保赛果准确、派彩正确 |
| 上游 | 结算列表 · 常规赛事 Tab（点击赛事行进入） |
| 下游 | 财务系统（派彩发放 / 差额回收） |
| 数据源口径 | 仅 IM（Inplay Matrix）为唯一数据源 |
| 姐妹模块 | 冠军赛事 / 长期盘口（EventTypeId = 1）见 冠军赛事结算详情 |
| 盘口级结算前置 | 盘口已关盘 + 该盘口所需赛果已确定（可以来自数据源同步或人工录入） |
| 赛事级结算前置 | 该赛事下所有盘口均已结算或已取消 |
关于数据源对比赛结束的输出：
- 数据源不单独提供独立的"赛事状态枚举字段"（类似"比赛已结束"这种赛事级状态标志）
- 数据源确实提供"比赛结束时间"时间戳字段：在完整赛果数据中返回
- 数据源还通过增量推送返回"赛事移除"信号，表示赛事从活跃列表中移除
- 本地结合"比赛结束时间字段"+"赛事从活跃列表移除"共同感知比赛是否结束
各盘口按自身时段独立结算——半场盘口可在半场结束后结算，15 分钟段盘口可在该段结束后结算，不必等全场终场。赛事级确认结算仅要求所有盘口完成结算。
1.2 与结算列表的分工
| 维度 | 结算列表 | 结算详情页 |
|---|---|---|
| 定位 | 多场赛事/多笔注单的浏览与快捷操作入口 | 单场赛事的完整结算工作台 |
| 结算方式 | 注单视图：直接为注单选择结算结果（快捷通道，结果应用到对应盘口） | 录入赛果 → 系统计算结果 → 逐盘口确认（完整操作） |
| 本质区别 | 是入口/快捷方式，不是独立结算机制 | 是结算的主工作台，支持全部操作 |
| 赛事级操作 | 无（只展示和导航） | 确认结算、赛事驳回、赛事异常处理（4 选 1：取消 / 延期 / 腰斩 / 数据错误） |
| 赛果录入 | 无 | 完整的赛果数据录入弹窗（比分/进球/角球/红黄牌） |
| 适用场景 | 快速为单笔注单选择结算结果（任何 L 级） | 完整处理一场赛事的全部盘口 |
| 优先级 | — | 详情页优先。若两边同时操作同一盘口，以详情页为准 |
| 驳回 | 不提供驳回入口 | 赛事驳回 + 盘口二次结算入口统一在详情页执行 |
1.3 目标用户
| 角色 | 核心操作 |
|---|---|
| 结算人员 | 录入赛果、确认 / 修改盘口结算结果、赛事驳回、盘口二次结算、确认结算赛事、处理赛事异常 |
| 风控人员 | 查看结算详情（只读） |
| 财务人员 | 查看派彩数据（只读） |
| 系统 | L1 自动结算、BT6 比分变动触发结算、串关母单自动结算、赛果变化触发注单自动重算 |
1.4 两条结算路径
同一赛事中，不同盘口可能走不同路径：
路径 A：数据源结算（IM 自动）
适用条件：操盘时数据源开关 = 开启
IM 推送比分 + 盘口状态数据 → 本地系统自动按规则判定结算结果
├── L1：数据源盘口 → 本地依 IM 状态字段直接执行派彩（全自动）
└── L2：可操盘盘口 → 本地按 BT 级判定规则预填 → 结算人员确认或修改后执行核心概念澄清：IM 只推送比分/进球/角球/红黄牌等原始数据 + 盘口状态字段（开盘/关盘/已结算标记），不直接推送"赢/输/走水"等结算结果。所有结算结果均由本地系统基于 IM 推送数据 + BT 级判定规则自动计算得出。L1 与 L2-L4 的核心区别是盘口来源（数据源盘口 vs 可操盘盘口），不是"IM 有没有给结果"。
路径 B：本地结算（人工）
适用条件：盘口已关盘，且数据源未推送该盘口的终态（比分/状态字段），或该 BT 为数据源无法覆盖类型
数据源或结算人员提供该盘口所需赛果（全场比分、半场比分、某段比分、进球详情等）
→ 结算人员在「赛果录入」弹窗补录 / 修正数据（或系统从数据源自动同步）
→ 系统根据录入数据计算对应盘口的结算结果
→ 结算人员逐盘口确认 → 执行结算
（允许分阶段：半场结束后可录入半场比分并结算半场盘口，不必等全场终场）同一赛事两条路径并存
| 场景 | 路径 A 的盘口 | 路径 B 的盘口 |
|---|---|---|
| IM 全量推送比分及盘口终态 | 全部 | 无 |
| IM 部分推送比分/盘口终态 | IM 已推送终态的盘口 | IM 未推送终态的盘口 |
| IM 无法覆盖的 BT | IM 能覆盖的 | IM 无法覆盖的（40 种） |
1.5 结算自动化 4 层模型
本期范围（2026-04-21）：
- 本期实装：
- 数据源自动拉取比分数据（基础数据能力，供赛果录入弹窗预填 / 核对）
- L3 / L4 手动结算路径（结算人员录入或核对比分 → 系统按规则预填盘口结果 → 结算人员手动确认首次结算）
- 已结算盘口赛果变化→自动重新结算（赛事 = 待结算时；详见 第 11.7 节）
- 串关母单自动重算与差额处理
- 本期不实装：L1（数据源盘口首次自动派彩）和 L2（可操盘盘口首次自动结算）——即"关盘+赛果到位时系统直接派彩"的首次自动路径
- 详见第 11.0.1 节 本期范围声明
一期实际路径：数据源仍自动拉取比分 / 进球 / 盘口状态等基础数据供本地系统参考和结算弹窗预填；首次"应用赛果"、"盘口首次结算"由结算人员手动触发；已结算盘口赛果变化后的重算由系统自动执行（无需人工再次确认），按差额矩阵自动处理补发/扣回。
| 层级 | 条件 | 结算方式 | 详情页中的表现 | 结算列表注单视图 | 本期是否实装 |
|---|---|---|---|---|---|
| L1 | 数据源盘口 + 数据源推送比分/盘口状态已到位 | 本地系统依数据源状态字段直接确认并派彩（首次全自动） | 盘口卡片直接显示「已结算」，灰显不可操作 | 注单显示「已结算」 | 本期不实装（首次派彩仍需人工）；赛果变化后的重算实装 |
| L2 | 可操盘盘口关盘 + 数据源推送该盘口所需比分/进球明细等数据 | 自动结算开关 = 开 → 本地按 BT 级判定规则自动计算并自动确认执行（无须人工）；自动结算开关 = 关 → 本地计算后预填，结算人员确认 | 预填或已结算标签；开关开时直接变「已结算」，开关关时显示「确认结算」按钮 | 注单显示「确认结算」按钮（开关关时）或「已结算」（开关开时） | 本期不实装（首次自动派彩）；赛果变化后的重算实装 |
| L3 | 可操盘盘口 + 数据源未推送该盘口所需比分数据（或推送延迟） | 结算人员补录比分/进球等数据 → 本地按 BT 级判定规则自动计算 → 结算人员确认 | 结算人员在赛果录入弹窗补录 / 修正比分等数据 → 系统计算结果 → 确认 | 注单显示「人工结算」按钮（快捷选结果） | 是（一期实装） |
| L4 | 数据源无法覆盖 BT（40 种）+ 已拉到比分 | 结算人员逐盘口手动选择结算结果（无法由规则自动推导） | 结算人员在盘口卡片直接选择赢 / 输 / 走水等 → 确认 | 注单显示「人工结算」按钮（快捷选结果） | 是（一期实装） |
L2 的两种子路径：由赛事的「自动结算开关」决定是完全自动执行（开）还是需人工确认（关）。数据源盘口不受此开关影响，数据源盘口走 L1 全自动路径。
L2 和 L3 的核心区别：比分数据来源不同（IM 推送 vs 人工录入），本地结算计算方式相同（系统按 BT 级判定规则自动计算）。
L3 和 L4 的核心区别：L3 通过赛果录入 → 系统批量自动计算所有关联盘口；L4 无法结构化录入赛果，只能逐盘口手动选择结果。
两个入口：L2 / L3 / L4 的注单既可在结算列表注单视图快捷选择结算结果，也可在结算详情页完整操作。两个入口产出相同结果，详情页优先。
数据源盘口 与 可操盘盘口 的自动结算差异
系统按盘口来源区分自动结算路径：
| 盘口来源 | 自动结算条件 | 比分/状态未送达时 |
|---|---|---|
| 数据源盘口 | 本地系统接收 IM 推送的比分数据 + 盘口状态字段，按 IM 状态直接触发派彩（L1） | 超过配置时长（默认 30 分钟）未收到 IM 终态推送，触发人工介入，进入本地锁定态 |
| 可操盘盘口 | 收到 IM 推送的比分数据后，若赛事开启「自动结算开关」则本地按 BT 级判定规则自动计算并执行（L2 预填 + L2 自动确认）；否则预填给结算人员确认（L2 人工确认） | 由结算人员打开赛果录入弹窗人工补录比分（L3），或在无法结构化录入时由结算人员逐盘口手动选择结果（L4） |
赛果变化自动触发重算（核心规则）
系统以盘口赛果的实质变化作为注单结算级联的唯一触发条件：
| 情形 | 系统行为 |
|---|---|
| 盘口首次确定赛果 | 触发注单首次结算（派彩 / 退款） |
| 盘口赛果发生改变（从 X 变为 Y，Y ≠ X） | 对该盘口所有单关注单 + 所有引用该盘口的串关子单，按新赛果重新计算派彩，按 15.4 差额矩阵处理差额（补发 / 扣回 / 不动） |
| 盘口状态变化但赛果未变（关盘 / 数据源推送开盘 / 二次结算后重选相同结果） | 不触发注单级联，注单保持原状 |
上述规则对可操盘盘口和数据源盘口（处于数据源接管态）一致；数据源盘口一旦进入本地锁定态，后续 IM 推送的新比分/状态变化不再覆盖本地结果。详见第 8 章 8.3 和 第 11 章 11.7。
1.6 核心术语（三级层次）
与操盘列表 核心规则对齐的三级术语层次：
| 术语 | 英文 | 行业术语 | 含义 | 示例 |
|---|---|---|---|---|
| 玩法 | Bet Type | Bet Type / Market Type | 抽象的投注类型，由 IM BetTypeId 标识 | "全场让球"（BetTypeId = BT1） |
| 盘口 | Market | Market / Line | 具体市场实例，一个玩法可对应多个盘口（按盘口线区分） | "BT1 全场让球 -0.5"、"BT1 全场让球 -1.0" |
| 选项 | Selection | Selection / Outcome | 具体可下注的选择 | "主队 -0.5"、"客队 +0.5" |
约定：本文档及 settlement 模块全文遵循此三级术语。
- BT（Bet Type）：玩法类型的行业缩写，由 IM 数据源的
BetTypeId字段定义（如 BT1 = 全场让球、BT6 = 全场波胆） - 当语境指代"某个玩法下的具体盘口线"时，用"盘口"；指代玩法类型时，用"玩法"
1.7 继承全局规则
| 继承项 | 来源 |
|---|---|
| 渲染器 4 种映射 | 全局第 6.3 节 |
| 控制层级 4 级 | 全局第 6.1 节 |
| 赔率制式（HK/Decimal） | 全局第 6.4 节 |
| 赔率精度 | 全局第 7.2 节 |
| 可操盘玩法 17 种 BT | 全局第 8.8 节 |
| 限额玩法 208 种 | 全局第 7.4 节 |
| 6 组玩法分组 | 全局第 6.5 节 |
| 派彩舍入合规说明 | 第 13 章 13.3.2 |