Appearance
第十章 时间字段定义
10.1 三类时间字段
冠军赛事模块涉及以下时间字段,语义必须清晰区分:
| 字段 | 来源 | 用途 | 业务规则是否依赖 |
|---|---|---|---|
| 锦标赛起始时间 | 数据源 | 展示字段(赛季 / 锦标赛开始日期) | ❌ 不依赖 |
| 锦标赛预计结束时间 | 数据源 | 展示字段(赛季 / 锦标赛预计结束日期) | ❌ 不依赖 |
| 盘口关盘时间 | 数据源同步或结算人员手动 | 盘口从开盘到关盘的时刻 | 用于结算日志 |
| 盘口结算时间 | 本地结算人员点击"结算"时刻 | 展示 + 该盘口 24h 二次结算窗口基准 | ✅ 依赖 |
| 最新盘口结算时间 | 该赛事下所有盘口结算时间的最新值 | 赛事信息头展示(活跃度指标) | ❌ 不依赖 |
10.2 字段详细定义
10.2.1 锦标赛起始时间
- 赛季或锦标赛的起始日期(通常是数据源提供的赛事创建日期)
- 格式:YYYY-MM-DD(通常精度到日)
- 仅作展示,业务规则不依赖
10.2.2 锦标赛预计结束时间
- 赛季或锦标赛的预计结束日期(数据源提供,可能随赛程调整)
- 格式:YYYY-MM-DD
- 仅作展示;实际结算时刻不由此决定(由各盘口独立结算)
10.2.3 盘口关盘时间
- 每个盘口从开盘态进入关盘态的时刻
- 来源:数据源 IM 推送投注截止信号(唯一来源,回退历史版本的手动关盘能力)
- 格式:YYYY-MM-DD HH:mm:ss
- 用于结算日志追溯;不作为驳回窗口基准
10.2.4 盘口结算时间
- 每个盘口被结算的时刻(结算人员点击「结算」按钮并成功执行的本地时间)
- 格式:YYYY-MM-DD HH:mm:ss
- 关键用途:该盘口 24h 二次结算窗口的起算基准
- 多次二次结算时,取最新一次结算时间
10.2.5 最新盘口结算时间
- 该赛事下所有盘口结算时间中的最新一个
- 格式:YYYY-MM-DD HH:mm:ss
- 展示在赛事信息头,作为"该赛事何时有最近结算活动"的指标
- 无盘口已结算时显示「—」
- 仅作展示,不作为任何业务规则的基准
10.3 与常规赛事时间字段的对照
| 维度 | 常规赛事 | 冠军赛事 |
|---|---|---|
| 开赛时间 | 比赛开始时间 | 锦标赛起始时间(粒度从时刻到日期) |
| 比赛结束时间 | 数据源返回的比赛实际结束时刻 | 锦标赛预计结束时间(粒度从时刻到日期,且为预计) |
| 赛事结算时间 | 有(结算人员点击"结算赛事"的时刻) | 无(冠军赛事无赛事级结算操作) |
| 盘口结算时间 | 有(每盘口独立) | 有(每盘口独立,且作为 24h 窗口基准) |
| 24h 驳回窗口基准 | 赛事结算时间(赛事级统一) | 盘口结算时间(每盘口独立) |
10.4 24h 驳回窗口的独立性
关键差异:常规赛事的 24h 窗口是赛事级统一的,冠军赛事的 24h 窗口是每个盘口独立的。
10.4.1 对比示例
常规赛事:
赛事结算时间:2026-05-20 14:30
赛事下所有盘口(BT1 / BT2 / BT3 ...)共享窗口
全部盘口的二次结算必须在 2026-05-21 14:30 前发起冠军赛事:
盘口 A(英超冠军)结算时间:2026-05-20 14:00
→ 窗口截止 2026-05-21 14:00
盘口 B(英超金靴)结算时间:2026-05-25 16:00
→ 窗口截止 2026-05-26 16:00
盘口 C(最佳球员)结算时间:2026-06-01 20:00
→ 窗口截止 2026-06-02 20:00
三个盘口窗口完全独立10.4.2 为什么这样设计
冠军赛事的盘口结算时间跨度很大(赛季内不同时间点逐个结算),赛事级统一窗口不合理:
- 如果用"最新盘口结算时间"作统一窗口,会导致早期结算的盘口其实远超 24h 仍可驳回(风控漏洞)
- 如果用"最早盘口结算时间"作统一窗口,会导致后期结算的盘口根本没有窗口机会(业务不合理)
每盘口独立 24h 窗口是最符合业务的设计。
10.5 时间字段在 UI 上的展示
10.5.1 赛事信息头
| 字段 | 展示位置 |
|---|---|
| 锦标赛名称 | 标题栏 |
| 锦标赛起始时间 | 左侧信息列 |
| 锦标赛预计结束时间 | 左侧信息列 |
| 最新盘口结算时间 | 中间信息列(活跃度指标) |
| 创建时间 | 下层信息 |
10.5.2 盘口卡片
| 字段 | 展示位置 |
|---|---|
| 盘口结算时间 | 已结算盘口卡片上,二次结算按钮旁显示剩余窗口倒计时(如「剩余 18:23:15」) |
| 盘口关盘时间 | 卡片内嵌日志中展示 |
10.5.3 日志面板
| 字段 | 展示位置 |
|---|---|
| 各类操作时间 | 每条日志的时间戳 |