服务总览
先看这张索引，再决定取哪一块
六行对应六个模块。字段规模、更新节奏和交付形式都写在表里，媒体、俱乐部分析岗、院校研究团队和球迷社区可以直接对照自己的使用场景判断。
| 服务模块 | 主要字段 | 更新节奏 | 取用形式 |
|---|---|---|---|
| 签表与对阵次序 MOD-01 | 轮次编号、对阵双方、主客场次序、当轮序号、晋级指向、历史回链 | 每轮抽签完成后同步；赛后更新晋级指向 | 页面嵌入 / 接口 |
| 赛前档与实时档赔率 MOD-02 | 轮次编号、赛前档标注、实时档标注、变化留痕、上下浮动幅度 | 实时档自开球前两小时起同步；按轮次留痕 | 页面嵌入 / 接口 |
| 伤停与赛后复盘 MOD-03 | 伤停名单、停赛场次、伤情描述、预计缺阵轮次、更新时间戳、复盘摘要、关键节点 | 名单锁定至开球前两小时；复盘摘要赛后当日发布 | 页面嵌入 / 接口 |
| U19 输送链条 MOD-04 | 梯队出场记录、输送条目、输送路径节点、时间节点 | 近三个赛季滚动补充，累计 240 余条输送条目 | 页面嵌入 / 接口 |
| 球队资料与净胜球走势 MOD-05 | 球队档案、赛季排名、升降级形势、净胜球走势、主客场拆分 | 每轮比赛结束后更新 | 接口为主 |
| 接入支持 MOD-06 | 字段文档、枚举值说明、配色参数、沙箱环境、版本记录 | 随版本发布同步更新 | 嵌入组件 / 接口 |
杯赛签表与对阵次序
奇博体育杯赛签表按轮次生成树状路径，每一场都标出对阵双方与主客场次序，胜者沿着晋级指向向下延伸。路径可以一路回溯到 2014 赛季首轮，媒体写赛前稿、社区做晋级路线图都用同一套结构。
输出字段
- 轮次编号
- 从资格赛到决赛逐轮编号，与赛季绑定，可直接作为检索键。
- 对阵双方
- 两队名称与所属级别，低级别球队的参赛轮次单独标出。
- 主客场次序
- 两回合赛制下标明谁先主后客，避免稿件里把顺序写反。
- 当轮序号
- 该场在本轮中的位置，方便和官方赛程表逐条对齐。
- 晋级指向
- 胜者进入下一轮的节点位置，比赛结束后同步更新。
- 历史回链
- 同一条路径可向上追溯到 2014 赛季首轮。
看一条路径是怎么长出来的
以某一轮次为起点，签表先给出这一轮的全部对阵；比赛结束后，晋级指向把胜者接到下一轮的空位上，整棵树随之向下生长。你取到的不是一张静态图片，而是一份可以按轮次、按球队反复查询的结构，适合放进需要每周更新的栏目里。
两档赔率的读取方式
同一轮次下，赔率有两条并行的标注线：赛前档在开赛前定格，实时档自开球前两小时起持续同步。两条线放在一起，就能看出这一轮里档位从哪里开始移动、移动了几次。
输出字段
- 轮次编号
- 赔率按轮次归组，可单独取某一轮，也可一次拉整个赛季。
- 赛前档
- 该轮开赛前定格的标注值，用于回看赛季初的判断基准。
- 实时档
- 自开球前两小时开始同步的动态标注，随伤停名单一起看更完整。
- 变化留痕
- 同一轮次内档位变化的先后顺序全部保留，不覆盖前一次。
- 上下浮动
- 相对上一轮次的幅度标注，方便做纵向对比图。
两档标注并排看会得到什么
赛前档适合做赛季面板的基线，实时档适合配合伤停名单判断临场变化。两者都按轮次留痕，所以你能回答“这一轮的档位是在名单公布前动的，还是名单公布后动的”这类问题，而不只是拿到一个当前值。
开球前两小时的伤停与复盘
伤停名单、停赛场次与伤情描述锁定至每场开球前两小时，之后不再改动；比赛结束后，同一场次会挂上一份 200–400 字的复盘摘要和一条关键节点时间轴。
输出字段
- 伤停名单
- 本轮缺阵球员的位置与球衣号，按俱乐部公开信息整理。
- 停赛场次
- 累积黄牌与红牌停赛对应的场次范围，标明哪一轮可以复出。
- 伤情描述
- 伤情类型与预计缺阵轮次，表述保持事实口径，不写推测。
- 更新时间戳
- 精确到开球前两小时的锁定节点，便于判断手上这份名单有多新。
- 复盘摘要
- 200–400 字，覆盖比分变化、战术调整与转折点。
- 关键节点时间轴
- 进球、红黄牌、换人的时间位置，可单独取用做图。
U19 输送链条
从梯队出场到一线队报名，再到联赛首秀与稳定出场，每一段都记成一个节点。近三个赛季累计 240 余条输送条目，链条图可以直接嵌进青训专题或俱乐部资料页。
输出字段
- 梯队出场记录
- 近三个赛季的 U19 联赛与杯赛出场场次、出场位置。
- 输送条目
- 球员从梯队进入一线队体系的记录，累计 240 余条。
- 输送路径
- 梯队出场 → 一线队报名 → 联赛首秀 → 稳定出场，逐节点标注。
- 时间节点
- 每个节点对应的赛季与轮次，便于按时间轴排列。
球队资料与净胜球走势
2600 余条球队与梯队档案，配合逐轮的排名变化、升降级形势和净胜球走势。查询维度可以任意组合：赛季、级别、轮次、球队，四个键选几个都行。
输出字段
- 球队档案
- 球队与梯队共 2600 余条，含所属级别与参赛层级。
- 赛季排名
- 逐轮排名变化，可以看到一支球队从第几轮开始稳住位置。
- 升降级形势
- 按级别给出距升级区或降级区的分差，随轮次刷新。
- 净胜球走势
- 逐轮累计净胜球的折线数据，可直接画图。
- 主客场拆分
- 客场战绩单独成表，其中海拔 1500 米以上的 5 座主场另有一张对照表。
- 组合查询
- 赛季、级别、轮次、球队四个维度自由组合，结果可直接导出。
交付方式与接入流程
两种交付形式：可以直接嵌进现有页面的展示组件，也可以走接口按需取数。组件自带深浅两套配色，宽度自适应，页面不需要为它单独改版。
交付构成
- 页面嵌入组件
- 提供深浅两套配色，容器宽度自适应；组件本身不引入外部样式依赖。
- 数据接口
- 按赛季、级别、轮次、球队四个维度取数，返回结构固定。
- 字段文档
- 34 项字段的名称、类型、枚举值与返回示例，逐条列出。
- 版本记录
- 字段增删与命名调整跟随版本号发布，旧版本保留一段时间便于迁移。
需要自己出图的话，字段够用吗
够。净胜球、排名、比分、射门、控球、定位球、红黄牌、换人都以独立字段返回，画折线、做堆叠、拼对照表都不需要再做一次数据清洗。如果你们的表格结构有固定列名，也可以在联调阶段把字段名对齐过去。
-
01
说明场景
讲清面向的联赛级别、需要的模块，以及是嵌入还是取数。
-
02
拿到字段清单
我们会回一份对照你场景的字段清单与交付方案。
-
03
沙箱联调
在测试环境里对齐字段命名与取数节奏，确认无误再切换。
-
04
上线与跟进
上线后按版本记录跟进字段调整，联赛日保持值守。
