Appearance
第二十一章 结算日志
关盘口径（2026-04-21 生效）：关盘来源统一为数据源推送（唯一来源）；关盘 = 绝对终态，操盘页与结算详情页均不提供人工开盘入口。
一期调整（2026-04-23 生效）：第 21.2.6 节 F4 "赛果变化触发自动重算"日志一期不产生（对应的"已结算盘口赛果变化 → 自动重新结算"功能一期不实装）。改为在 B 类"人工二次结算"日志上追加"触发原因 = 赛果变化标记"字段记录：当结算人员应 UI 标记提示而主动发起二次结算时，日志触发原因记为"赛果变化标记"，其他字段沿用 B1 盘口二次结算规范。正文 F4 条目保留作为二期设计参考。
规则声明：本章为结算模块结算日志的核心规则。结算列表（settlement 第 18 章）遵循本章定义的字段结构与操作类型命名，仅记录其自身入口触发的操作（如人员分配等），核心结算日志格式与本章完全一致。
21.1 日志字段结构（核心规则，两端共用）
所有结算日志使用统一字段结构，结算列表和结算详情页共享：
| 字段 | 格式 | 说明 |
|---|---|---|
| 操作时间 | YYYY-MM-DD HH:mm:ss（UTC 时间戳记录，展示按用户本地时区转换） | 精确到秒 |
| 操作人 | 结算人员姓名 / 结算主管姓名 / 「系统」 | 见 21.3 操作人标注规则 |
| 操作人 IP | xxx.xxx.xxx.xxx | 系统自动操作为空 |
| 操作类型 | 见 21.2 操作类型清单 | 枚举写死 |
| 操作对象 | 盘口 ID / 赛事 ID / 母单 ID / 注单 ID | 按操作类型决定 |
| 操作内容 | 变更前 → 变更后 | 自由文本 |
| 操作结果 | 成功 / 失败（含失败原因） | — |
| 关联信息 | 受影响的注单数 / 母单数 / 差额金额 / 累计次数等（若涉及） | 按操作类型决定 |
| 来源页面 | 结算详情页 / 结算列表-注单视图 / 结算列表-赛事视图 / 系统 | 用于跨模块审计 |
21.2 日志记录范围（核心规则 操作类型清单）
完整场景分为 8 大类 / 36 条，按左边框色划分（边框色映射见 第 10 章 10.4 节）：
| 分类 | 边框色 | 小节 | 条数 |
|---|---|---|---|
| A 盘口结算操作（人工） | 🟠 橙 | 21.2.1 | 5 |
| B 回退类 | 🔴 红 | 21.2.2 | 3 |
| D 赛事异常处理 | 🟠 橙 | 21.2.3 | 4 |
| E 赛果录入 | 🟠 橙 | 21.2.4 | 5 |
| F 系统自动 | 🟢 绿 / 🔴 红（F12） | 21.2.5 | 12（含 F9 / F10 / F11 / F12 数据源开盘信号自动回滚与超窗拒收日志） |
| G 冲突 / 警告 | 🟠 橙（⚠️） | 21.2.6 | 3 |
| H 数据源异常 | 🔴 红（❌） | 21.2.7 | 2 |
| I 管理级（人员分配） | 🟠 橙 | 21.2.8 | 2 |
21.2.1 A 盘口结算操作（人工，橙色）
| # | 操作类型 | 关联信息字段 | 触发来源 |
|---|---|---|---|
| A1 | 盘口结算（L3 人工选结果） | 盘口 ID + 盘口名 + 结算结果 + 影响注单数 + 总派彩；多组基准分场景追加：基准分组标识（下注时比分）+ 组内注单数 + 组派彩（每组独立一条日志，按提交时序先后记录） | 结算详情页 / 结算列表-注单视图 |
| A2 | 盘口结算（L4 人工逐盘口选） | 盘口 ID + 盘口名 + 结算结果 + 影响注单数 + 总派彩；多组基准分场景追加：基准分组标识（下注时比分）+ 组内注单数 + 组派彩 + L4 手动选择结果快照（对齐 第 7.3.6.3a 节，每组独立一条日志） | 结算详情页 / 结算列表-注单视图 |
| A3 | 盘口结算（L2 原样确认） | 盘口 ID + 盘口名 + 采用系统预填结果 + 影响注单数 + 总派彩 | 结算详情页 / 结算列表-注单视图 |
| A4 | 盘口结算（L2 修改后确认） | 盘口 ID + 盘口名 + 原预填结果 + 修改后结果 + 影响注单数 + 总派彩 | 结算详情页 / 结算列表-注单视图 |
| A5 | 赛事级确认结算 | 赛事 ID + 赛事名 + 总盘口数 + 总投注额 + 总派彩 | 仅结算详情页 |
21.2.2 B 回退类（红色）
| # | 操作类型 | 关联信息字段 | 触发来源 |
|---|---|---|---|
| B1 | 盘口二次结算 | 盘口 ID + 盘口名 + 原结算结果 + 新结算结果（如已重选）+ 影响注单数 + 已派彩金额 + 差额金额 + 关联串关母单数；多组基准分场景追加：基准分组标识（下注时比分）+ 组内注单数 + 组原派彩总额 + 组新派彩总额 + 组差额（每组独立一条日志，详见 第 15.4.4.7 节） | 仅结算详情页 |
| B2 | 赛事驳回 | 赛事 ID + 赛事名 + 原状态（已结算 / 已取消 / 异常态）→ 待结算 + 距最新结算时间剩余窗口（小时） | 仅结算详情页 |
| B3 | 取消后二次结算 | 盘口 ID + 盘口名 + 原取消原因 + 新结算结果 + 退款撤销金额 + 影响注单数 | 仅结算详情页 |
21.2.3 D 赛事异常处理（橙色）
| # | 操作类型 | 关联信息字段 | 触发来源 |
|---|---|---|---|
| D1 | 赛事异常处理 · 取消 | 赛事 ID + 赛事名 + 涉及注单数 + 退款金额 + 赛事状态变化 | 仅结算详情页 |
| D2 | 赛事异常处理 · 延期 | 赛事 ID + 赛事名 + 子方案（暂缓 / 超时退款）+ 涉及注单数 | 仅结算详情页 |
| D3 | 赛事异常处理 · 腰斩 | 赛事 ID + 赛事名 + 腰斩时刻（如 78'）+ 子方案（按比分 / 全额退款 / 暂缓）+ 涉及注单数 | 仅结算详情页 |
| D4 | 赛事异常处理 · 数据错误 | 赛事 ID + 赛事名 + 错误描述 + 处理方式 | 仅结算详情页 |
21.2.4 E 赛果录入（橙色，仅结算详情页）
| # | 操作类型 | 关联信息字段 |
|---|---|---|
| E1 | 上半场赛果录入 | 录入模式（数据源 / 人工 / 混合）+ 半场主客比分 + 半场进球明细 + 半场扩展（角球 / 牌） |
| E2 | 下半场赛果录入 | 录入模式 + 下半场主客比分 + 下半场进球明细 + 下半场扩展（角球 / 牌）+ 预填与实际录入差异（若有） |
| E3 | 15 分钟段赛果录入 | 录入模式 + 段号（0-15' / 15-30' / 31-45' / 46-60' / 61-75' / 76-90'）+ 段内比分 + 段内进球 |
| E4 | 全场赛果与扩展应用 | 按分区记录：分区 A（全场合计展示 + 射门 / 射正 / 越位 / 犯规）/ 分区 B（加时上 / 加时下比分 + 加时进球 + 加时角球 / 牌）/ 分区 C（点球大战比分 + 晋级方） |
| E5 | 赛果字段修改（任一弹窗内字段变更） | 所在弹窗 / 分区 + 字段名 + 变更前后值 |
21.2.5 F 系统自动（绿色，操作人 = 「系统」）
本期范围（2026-04-21）：本小节定义的 F 类系统自动日志（F1 L1 自动结算 / F2 L2 自动结算 / F3 BT6 比分变动 / F4 赛果变化自动重算 / F5 串关母单自动结算 / F6 数据源本地接管 / F7 数据源本地锁定 / F8 赛事状态自动变更）大部分本期不产生（对应的自动结算、自动重算、数据源接管等功能本期不实装，见第 1.5 节 结算自动化 4 层模型 · 本期范围与第 11.0.1 节）。一期本小节只会产生 F8（赛事状态自动变更，例如 24h 驳回窗口关闭）和 F9 / F10 / F11 / F12（IM 推送开盘信号的自动回滚与超窗拒收）等跟关盘/开盘硬约束相关的系统日志；其他条目作为后续迭代设计参考保留，本期不产生此类日志。
| # | 操作类型 | 关联信息字段 |
|---|---|---|
| F1 | IM 推送盘口终态 · 数据源盘口自动结算（L1） | 盘口 ID + 盘口名 + IM 推送状态 + 本地派彩金额 |
| F2 | IM 推送比分 · 可操盘盘口自动结算（L2 auto=on） | 盘口 ID + 盘口名 + 比分 + 本地判定结果 + 派彩 |
| F3 | BT6 比分变动触发结算（只判输） | 盘口 ID + 选项 ID + 比分快照 + 判定结果 = 输 |
| F4 | 赛果变化触发自动重算 | 盘口 ID + 盘口名 + 原结算结果 + 新结算结果 + 差额金额 + 影响单关数 + 影响母单数 + 该盘口累计赛果变更次数 N；多组基准分场景追加：基准分组标识 + 组内累计变更次数（计数按组独立维护，详见 第 15.4.4.4 节） |
| F5 | 串关母单自动结算 | 母单 ID + 子单系数列表 + 派彩金额 + 触发原因（首次结算 / 赛果变更） |
| F6 | 数据源盘口本地接管 | 盘口 ID + 盘口名 + 数据源未推送盘口终态时长 + 接管时间 |
| F7 | 数据源盘口本地锁定 · 拒收 IM 后续推送 | 盘口 ID + 盘口名 + IM 推送的比分/状态数据 + 本地锁定态结果 + 拒收时间 |
| F8 | 赛事状态自动变更 | 赛事 ID + 变更前后状态 + 触发原因（如 24h 驳回窗口关闭） |
| F9 | IM 推送开盘 · 关盘态恢复 | 盘口 ID + 盘口名 + 关盘 → 开盘 + IM 推送时间戳 |
| F10 | IM 推送开盘 · 已结算自动回滚（核心） | 盘口 ID + 盘口名 + 已结算 → 开盘 + 影响子注单数 + 影响串关母单数 + 影响短路结算母单数 + 原派彩总额（作为差额基数，具体差额 = 新派彩 − 原派彩，延迟到再次关盘结算后计算） + 赛事级是否联动驳回（24h 窗口内）+ IM 推送时间戳；多组基准分场景追加：基准分组列表 + 每组原派彩总额 + 每组影响注单数（各组独立记录作为后续差额基线，对齐 第 15.4.4.2 节 和 第 15.6d.5 多组盘口回滚规则） |
| F11 | IM 推送开盘 · 已取消撤销退款 | 盘口 ID + 盘口名 + 已取消 → 开盘 + 影响注单数 + 撤销退款金额 + 余额不足记坏账金额 + IM 推送时间戳 |
| F12 | IM 推送开盘被 24h 超窗拒收（红色警告级） | 盘口 ID + 盘口名 + 本地当前状态（已结算 / 已取消）+ 赛事 ID + 赛事状态（已结算 / 已取消 / 异常态）+ 距最新结算时间（小时）+ 拒收原因（24h 超窗 - 超窗拒收保护）+ IM 推送时间戳 + 本次本轮累计拒收次数 |
F9 / F10 / F11 / F12 说明：
- F9 / F10 / F11 = IM 推送触发的自动响应（24h 窗口内），绿色系统级日志
- F12 = IM 推送被 24h 超窗规则拒收（超窗拒收保护），红色警告级日志，供合规审计
- 关盘 = 绝对终态，人工无开盘入口；数据源推送开盘信号作为硬约束须自动响应，但受 24h 窗口约束：超窗即使数据源再推送也不执行，记 F12 拒收日志
- 完整处理流程见 第 15.6d 节
21.2.6 G 冲突 / 警告（橙色，⚠️ 图标，操作人 = 「系统」）
| # | 操作类型 | 关联信息字段 |
|---|---|---|
| G1 | IM 推送比分与本地录入冲突（已拦截） | 盘口 ID + 结算人员 + IM 推送比分 + 本地录入值 + 覆盖规则 |
| G2 | 并发结算冲突（版本号不匹配） | 盘口 ID + 先提交人 + 后提交人 + 拒绝原因 |
| G3 | 聚合窗口汇总结算 | 盘口 ID + 盘口名 + 窗口期起止 + 累计变更次数 + 最终比分 + 说明（中间状态不发日志，只记最终态） |
21.2.7 H 数据源异常（红色，❌ 图标，操作人 = 「系统」）
| # | 操作类型 | 关联信息字段 |
|---|---|---|
| H1 | 数据源离线（IM 心跳超时 > 30s） | 心跳超时时长 + 暂停的自动结算范围（L1/L2）+ 提示条激活状态 |
| H2 | 数据源恢复在线 | 累计离线时长 + 自动重新拉取累积数据条数 |
21.2.8 I 管理级操作（橙色，仅结算列表触发，汇入同一日志库）
| # | 操作类型 | 关联信息字段 | 触发来源 |
|---|---|---|---|
| I1 | 结算人员分配（单赛事） | 赛事 ID + 赛事名 + 阶段（赛前 / 滚球）+ 变更前后结算人员 | 结算列表-赛事视图 |
| I2 | 批量分配结算人员 | 赛事 ID 列表 + 阶段 + 分配结算人员 | 结算列表-赛事视图 |
I1 / I2 虽从结算列表触发，但日志同步到所涉及赛事的结算详情页时间线，以「来源：结算列表」标识区分。
21.3 操作人标注规则
| 规则 | 说明 |
|---|---|
| 人工操作 | 记录结算人员 / 结算主管的姓名 |
| 系统自动触发 | 记录「系统」 |
| 以下操作一律系统触发 | 赛果变化触发重算、串关母单自动结算、BT6 比分变动触发结算、数据源本地接管、数据源本地锁定、数据源拒收、赛事状态自动变更 |
21.4 日志展示入口
| 入口 | 所属页面 | 展示范围 |
|---|---|---|
| 右侧日志面板 | 结算详情页 | 当前赛事全部结算日志时间线 |
| 盘口卡片内嵌日志 | 结算详情页 | 该盘口的结算日志（可展开最近 20 条） |
| 赛事视图内嵌日志 | 结算列表 | 该赛事行展开最近 20 条 |
21.5 日志保留
| 规则 | 说明 |
|---|---|
| 保留期限 | 默认 365 天（系统级写死，修改需发版） |
| 清理方式 | 清理前自动归档，归档保留时长由系统管理员配置 |
| 清理时机 | 每天凌晨自动执行 |
21.6 与结算列表日志的一致性
结算列表（settlement 第 18 章）的日志完全遵循本章定义：
- 字段结构：完全一致（21.1 为 核心规则）
- 操作类型命名：完全一致（21.2 为 核心规则）
- 操作人标注规则：完全一致（21.3 为 核心规则）
- 日志保留策略：完全一致（21.5 为 核心规则）
结算列表仅记录其自身入口触发的操作（如人工结算的快捷通道、人员分配）；所有操作统一汇入同一日志库，按"来源页面"字段区分触发入口。