联赛页 原型＋PRD
足球联赛页依联赛类型区分两套页签结构。欧战类联赛页为 `动态 / 概览 / 比赛 / 球队榜 / 球员榜 / 历史` 共 6 个 TAB；非欧战联赛页为 `动态 / 概览 / 积分 / 比赛 / 转会 / 数据 / 球队榜 / 球员榜 / 历史` 共 9 个 TAB。默认首开固定为 `比赛 TAB`。
6 TAB
欧冠 / 欧国联 / 欧联 / 欧协联
9 TAB
中超等常规联赛
默认页
联赛页默认进入比赛 TAB
当前素材
已落 8 张足球原型图，球员榜待补图
足球联赛页所有 TAB 共用顶部联赛头卡；年份切换、轮次切换与赛事子筛选按各自 TAB 保留状态。
本页同时使用中超与欧冠截图说明不同联赛类型下的结构差异，重点先把页签数量、默认页与字段逻辑定清楚。
足球联赛页总览
联赛页需先分清联赛类型：欧战没有 `积分 / 转会 / 数据` 三个 TAB，但会保留 `历史 TAB`；常规联赛则保留 9 个 TAB 完整结构。当前预览已补 `动态 / 概览 / 积分 / 比赛 / 转会 / 数据 / 球队榜 / 历史`，并保留 `球员榜` 占位说明。
欧战：动态 / 概览 / 比赛 / 球队榜 / 球员榜 / 历史
非欧战：动态 / 概览 / 积分 / 比赛 / 转会 / 数据 / 球队榜 / 球员榜 / 历史
默认首开：比赛 TAB
足球动态 TAB
动态页与队伍页、国家页资讯流结构一致，分为 `列表 / 详情 / 评论列表` 三个画面。列表页顶部新增 `近期赛事区`，文章列表按发布时间新到旧，详情页点击评论数进入评论列表。
1
2
3
4
5
6
列表、详情、评论流程
动态列表进入文章详情，详情页评论数再进入评论列表。评论列表支持 `最新 / 最早` 排序切换，点赞为单次动作。
| 位置编号 | 字段名称 | 交互 | 字段定义 | 字段逻辑 |
|---|---|---|---|---|
| 1 | 联赛头卡 | 无交互，静态展示 | 展示联赛背卡色、联赛 Logo、联赛中文名、联赛英文名、阶段进度、赛季起止日期与右上功能按钮。 | 背卡色优先取联赛官方视觉主色；若无品牌色，则取联赛 Logo 主色；两者都无法判定时，足球联赛页统一使用说球帝默认蓝色系。阶段进度如 `16/30轮` 取当前赛季已完成轮次/总轮次；起止日期取该赛季最早与最晚比赛日；头卡在联赛全部 TAB 固定复用。 |
| 2 | 近期赛事区 | 点击单场赛事卡进入赛事实页 | 展示该年自当日起最近 `3` 则未开赛赛事资讯，字段含联赛名称、主队、客队、赛事时间；最近一则额外展示距今倒数计时。若当前仅有 `1` 则近期赛事，该卡需左右拉宽并自适应装置宽度展示。 | 仅抓取 `当前联赛 + 当前年份` 下、开赛时间晚于当前时刻的未开赛赛事。按开赛时间由近到远排序，最多展示 3 场。第 1 场为最近赛事，需显示 `距今倒数`，格式可为 `01天 05:00:42`；第 2、3 场仅显示赛事时间。若当前仅抓到 1 场未开赛赛事，则该单卡不保留多卡并列留白，需直接横向拉宽至可用内容宽度，自适应当前装置宽度。点击任一赛事卡按 `match_id` 进入赛事实页；若当前年份完全没有未开赛赛事，则整块 `近期赛事区` 隐藏不展示。 |
| 3 | 资讯标题与缩略图 | 点击整张资讯卡进入文章详情 | 列表卡主字段含标题、右侧缩略图、文章类型角标。 | 列表按发布时间新到旧排序；最多拉取近 30 天且归属当前联赛 `league_id` 的文章。无图文章保留纯文卡高度，有图文章显示右侧缩略图；视频内容额外叠加视频时长或播放角标。 |
| 4 | 发布时间与列表摘要 | 无独立交互，随卡片点击 | 列表卡次字段含发布时间、来源标签、赛事关联摘要。 | 发布时间取文章发布时间并按 `x分钟前 / 昨天 / 日期` 规则格式化；若文章挂载赛事，则展示赛事简称或关联标签；该字段不单独点击，跟随整卡进入详情。 |
| 5 | 详情标题与正文 | 上下滚动阅读 | 详情主字段含标题、来源、发布时间、主图、正文段落、正文插图。 | 标题、来源、发布时间、正文均取文章详情接口；正文图文保持原顺序，不做重排；长图按原比例展示；正文内若挂赛事或球星锚点，点击分别进入赛事实页或球星页。 |
| 6 | 评论入口与评论排序 | 点击评论数进入评论列表；点击 `最新 / 最早` 切换 | 评论区入口字段含评论数、排序按钮、评论输入条。 | 评论数取当前文章评论总数；评论列表默认按最新评论倒序，切到 `最早` 后按发布时间升序。评论与回复均限定已安装 App 且账号等级 `Lv2` 以上才可操作，此限制为全平台动态 TAB 通用规则。 |
| 7 | 单条评论 / 回复 / 点赞 | 点击用户名、回复按钮、点赞按钮 | 单条评论字段含头像、昵称、评论内容、发布时间、楼层回复、点赞数。 | 评论成功后固定插入当前排序维度中的最新一则；回复同样需满足 `App + Lv2以上`；点赞为单次动作，每位用户对每则评论仅可点赞一次，成功后前端立即 +1，且不可取消。若未满足条件，点击评论或回复入口弹登录 / 下载 App / 等级不足提示。 |
足球概览 TAB
概览页用于输出联赛基础信息、最佳阵容、升班马与低级别联赛入口。支持切换轮次，并从最佳阵容与联赛关系区继续跳转。
1
2
3
4
5
6
7
8
联赛基础信息与关系跳转
概览页更像联赛资料总览，包含冠军 / 降级、基础资料、最佳阵容、升班马与低级别联赛入口。最佳阵容区支持按轮次切换。
| 位置编号 | 字段名称 | 交互 | 字段定义 | 字段逻辑 |
|---|---|---|---|---|
| 1 | 概览头卡 | 无交互，静态展示 | 字段含联赛背卡色、Logo、中英名、赛季起止日期、已完成轮次。 | 背卡色优先取联赛官方视觉主色；无法识别时回退说球帝默认蓝色。赛季日期取当前年份最早开赛日与最晚比赛日；已完成轮次按已赛轮次/总轮次计算。 |
| 2 | 冠军 / 降级球队卡 | 点击球队进入队伍页 | 展示本赛季冠军队、降级队队徽、中文名与名次。 | 冠军队取当前赛季最终排名第 1 名；降级队取降级名额球队；如赛季未结束则显示当前暂列或隐藏该模块；点击按 `team_id` 进入队伍页。 |
| 3 | 联赛基础资料 | 无交互，静态展示 | 字段含联赛等级、常规轮数、参赛队数、球员总数、非本土球员数、球员总身价。 | `联赛等级` 取联赛层级定义；`常规轮数` 取赛制总轮次；`参赛队数` 取当前年份报名球队数；`球员总数` 为联赛注册球员数；`非本土球员数` 为国籍不等于联赛所属国家的球员数；`球员总身价` 为全部注册球员身价求和，单位按接口保留到 `亿欧`。 |
| 4 | 最佳阵容模块标题与轮次选择 | 点击轮次打开弹层并确认 | 最佳阵容区标题、当前轮次文案与轮次选择器。 | 默认加载最新已产生最佳阵容的轮次；弹层轮次按当前赛季实际有阵容数据的轮次生成；确认后刷新球场阵型、球员、评分与日期。 |
| 5 | 最佳阵容球场与球员点位 | 点击球员进入球员页 | 字段含球员头像、姓名、站位、评分、阵型、比赛日期。 | 球员按官方最佳阵容站位摆放；评分直接取该轮最佳阵容评分字段并保留 1 位小数；阵型如 `3-5-2` 直接取阵型字段；点击按 `player_id` 进入球员页。 |
| 6 | 升班马列表 | 点击球队进入队伍页 | 展示升入当前联赛球队的队徽、中文名、右箭头。 | 基于上一赛季升降级结果输出当前赛季升班马；若同赛季有附加赛升级，则以最终升级结果为准；点击根据 `team_id` 进入队伍页。 |
| 7 | 低级别联赛入口 | 点击进入联赛页 | 展示与当前联赛存在层级关系的次级联赛名称与入口。 | 按联赛层级关系表输出下一级联赛；点击根据 `league_id` 进入对应联赛页；若当前联赛无下级联赛则隐藏整块。 |
| 8 | 队伍 / 球员 / 联赛跳转规则 | 点击对应对象跳转 | 概览页内所有对象型字段的跳转说明。 | 冠军队、降级队、升班马走队伍页；最佳阵容球员走球员页；低级别联赛走联赛页。若对象已删除或缺失 ID，则仅保留文案不响应点击。 |
足球积分 TAB
积分页仅存在于常规联赛。页面输出总榜 / 主场 / 客场榜单，并带年份切换与赛制说明。
1
2
3
4
5
榜单与规则说明
积分页用来沉淀联赛排行榜与规则说明。当前联赛高亮，点击球队行进入队伍页；切换年份后榜单与赛制文案同步刷新。
| 位置编号 | 字段名称 | 交互 | 字段定义 | 字段逻辑 |
|---|---|---|---|---|
| 1 | 榜单口径切换 | 点击 `总榜 / 主场 / 客场` | 积分榜统计口径切换器。 | `总榜` 使用全部比赛；`主场` 仅统计球队主场比赛；`客场` 仅统计球队客场比赛。切换后刷新榜单行字段值、排序与相关色带区间。 |
| 2 | 年份选择器 | 点击年份打开弹层并确认 | 积分榜所属赛季选择器。 | 默认加载有数据最新年份；确认后同步刷新榜单、红区说明、赛制说明与升降级备注。 |
| 3 | 积分榜表头与行字段 | 点击球队进入队伍页 | 字段含排名、球队、赛、胜/平/负、进/失、积分、红区标签。 | `赛`=已赛场次；`胜/平/负` 为对应结果场次；`进/失`=总进球/总失球；`积分` 按胜3分平1分负0分计算，若赛事规则不同则按官方赛制覆盖；点击球队按 `team_id` 进入队伍页。 |
| 4 | 红区 / 附加赛区说明 | 无交互，静态展示 | 榜单行内粉红或红色高亮区块的含义说明。 | 所有色带都必须在 PRD 明写含义，不可只靠底色判断。例如：红区代表亚冠精英赛资格区、浅红区代表亚冠二级联赛附加赛区、灰区代表降级区。具体文案随联赛赛制和年份变化。 |
| 5 | 赛制说明与注册规则 | 无交互，静态展示 | 展示积分排序规则、亚战名额、降级名额、注册规则等整段文案。 | 文案随年份切换同步变化；排序规则至少包含同分比较顺序、净胜球、进球数、相互战绩等；注册规则为联赛固定文案，若赛季有特殊政策则取该赛季版本。 |
足球比赛 TAB
比赛页为足球联赛页默认首开页，区分 `球迷版` 与 `专业版`，并支持轮次选择、年份切换、当前定位与赛事实页/球员页跳转。
1
2
3
4
5
6
7
8
9
10
11
联赛赛程默认页
比赛页默认固定首开。球迷版侧重比分、球员评分与进球事件；专业版侧重盘口、进球、角球与当前定位。
| 位置编号 | 字段名称 | 交互 | 字段定义 | 字段逻辑 |
|---|---|---|---|---|
| 1 | 比赛头卡与背卡色 | 无交互，静态展示 | 字段含联赛背卡色、Logo、中英名、赛季起止日期、阶段进度。 | 背卡色优先取联赛官方视觉主色；无法识别时回退说球帝默认蓝色。进度优先显示当前轮次/总轮次，欧战则显示当前阶段加轮次。 |
| 2 | 球迷版 / 专业版切换器 | 点击版本按钮切换 | 赛程展示版本切换器。 | 球迷版展示比分、评分球员、事件；专业版展示让球、大小球、角球与走势。切换版本不改变年份、轮次、主客筛选与当前定位。 |
| 3 | 轮次 / 阶段选择器 | 点击轮次文案打开弹层并确认 | 当前赛程轮次或淘汰赛阶段筛选器。 | 默认加载最近有数据轮次；常规联赛显示 `第N轮`；欧战显示 `小组赛 / 1/8决赛 / 1/4决赛 / 半决赛 / 决赛`。确认后刷新列表并重置当前定位目标。 |
| 4 | 年份选择器 | 点击年份打开弹层并确认 | 赛程所属赛季选择器。 | 默认加载有数据最新年份；确认后刷新轮次范围、列表与默认轮次；若目标赛季无数据则显示空列表。 |
| 5 | 当前定位按钮 | 点击 `当前` | 将赛程列表滚动到当前轮次或最近比赛。 | 优先定位进行中比赛；若无则定位最近未来比赛；若未来也无则定位最近已完赛。定位完成后不改变版本与年份状态。 |
| 6 | 主客筛选 / 上下轮切换 | 点击 `主场 / 客场 / 上一轮 / 下一轮` | 列表附加筛选与快捷导航。 | 主客筛选仅保留当前联赛球队对应主场或客场场次；上一轮 / 下一轮为相邻轮次快捷跳转，切换后同步刷新列表与顶部轮次文案。 |
| 7 | 球迷版列表基础字段 | 点击整行进入赛事实页；点击球队进入队伍页 | 字段含比赛日期、开球时间、主队、客队、比分、赛事阶段。 | 整行根据 `match_id` 进入赛事实页；主客队名及队徽根据 `team_id` 进入队伍页；已完赛显示最终比分，未开赛显示 `-`，进行中显示实时比分。 |
| 8 | 球迷版事件与最佳球员 | 点击球员进入球员页 | 字段含最佳球员头像、姓名、评分、进球/红黄牌/换人/出场状态。 | 最佳球员根据 `player_id` 跳球员页；评分保留 1 位小数。出场状态明确展示 `首发 / 替补 / 未出场 / 缺阵`；事件图标按进球、点球、乌龙、红牌、黄牌、换人顺序输出。 |
| 9 | 专业版盘口 / 进球 / 角球字段 | 点击整行进入赛事实页 | 字段含让球盘口、大小球盘口、全场角球数、比分、走势。 | `让球`=盘口值 + 赛果，赢盘绿色、输盘红色、走盘灰色；`大小球`=总分盘口 + 赛果，大红小绿走灰；`角球` 显示主队角球-客队角球；`进球` 显示总进球数；`走势` 显示近盘路方向，按站内字段回传。 |
| 10 | 底部汇总栏 | 无交互，静态展示 | 字段含近况、进失球、胜率、赢率、大率。 | `近况`=近 N 场战绩摘要，如 `近26场`；`进失球`=近 N 场总进球 / 总失球；`胜率`=胜场 ÷ 已赛场次；`赢率`=赢盘场次 ÷ 有让球赛果场次；`大率`=大球场次 ÷ 有大小球赛果场次。 |
| 11 | 最佳球员字段本体 | 点击球员进入球员页 | 球迷版右侧评分球员卡，包括头像、姓名、评分色块。 | 该球员为单场站内评分最高或系统指定最佳球员；评分色块沿用站内色阶：`9.0+` 粉红、`8.0-8.9` 橙色、`7.0-7.9` 黄橙、`6.0-6.9` 绿色、`6.0以下` 灰绿。 |
足球转会 TAB
转会页仅存在于常规联赛。支持 `全部 / 已签约 / 转会 / 租借` 等筛选，输出联赛内外转会流向。
1
2
3
联赛转会流向
转会页以联赛维度汇总球员流入流出，允许从联赛页直接看球员与俱乐部动向。
| 位置编号 | 字段名称 | 交互 | 字段定义 | 字段逻辑 |
|---|---|---|---|---|
| 1 | 转会 TAB 入口与头卡 | 点击顶部 `转会` tab | 联赛转会列表主入口，沿用联赛头卡。 | 仅常规联赛展示；欧战联赛不显示本 TAB；头卡背卡色沿用联赛主视觉色。 |
| 2 | 转会筛选栏 | 点击筛选 chip 切换 | 筛选项含 `全部 / 已签约 / 转会 / 租借` 等状态。 | 默认展示全部；点击后仅保留对应状态记录；列表按官宣时间或生效时间倒序输出。 |
| 3 | 转会记录主体 | 点击球员进入球员页；点击俱乐部进入队伍页 | 字段含日期、球员头像、姓名、国籍、年龄、位置、来源俱乐部、去向俱乐部、转会状态、转会费。 | 球员根据 `player_id` 进入球员页；来源 / 去向俱乐部根据 `team_id` 进入队伍页；转会费优先取官方金额，无金额则显示 `免签 / 租借 / 已签约` 等状态文案。 |
足球数据 TAB
数据页仅存在于常规联赛。当前截图是一整组数据模块拼图，说明联赛数据会拆成多张子视图，包含胜平负、进球数、角球、时间段分析等统计。
1
2
3
4
5
6
7
8
9
10
联赛聚合数据矩阵
该截图代表联赛数据 TAB 会拆成多组榜单与图表组合输出，因此 PRD 重点要写清楚“每个子模块都是联赛级聚合统计，而非单队数据”。
| 位置编号 | 字段名称 | 交互 | 字段定义 | 字段逻辑 |
|---|---|---|---|---|
| 1 | 数据 TAB 入口与年份选择 | 点击顶部 `数据` tab；点击年份打开弹层 | 联赛聚合统计入口与所属赛季选择器。 | 仅常规联赛展示；欧战联赛不显示本 TAB。默认加载有数据最新年份；切换年份后重算全部子模块。 |
| 2 | 积分排名表 | 无交互，列表可滚动 | 字段含总/主/客/近战等分维度的赛、胜/平/负、进/失、积分、排名。 | 所有行均为当前联赛聚合口径；`总` 取全部比赛，`主/客` 取对应主客场，`近` 取近 N 场。表内排名按当前积分规则降序。 |
| 3 | 让球指数 | 无交互，列表可滚动 | 字段含赛、赢、输、赢率、输率、近6场(由远及近)。 | `赛`=有让球结果场次；`赢`=赢盘场次；`输`=输盘场次；`赢率`=赢 ÷ 赛；`输率`=输 ÷ 赛；近6场按时间由远到近输出 `赢 / 输 / 走` 结果串。 |
| 4 | 总进球指数 | 无交互，列表可滚动 | 字段含赛、大、小、大率、小率、近6场(由远及近)。 | `大`=总进球大于大小球盘口的场次；`小`=总进球小于盘口的场次；`大率`=大 ÷ 赛；`小率`=小 ÷ 赛；近6场输出 `大 / 小 / 走` 结果串。 |
| 5 | 进球分布 | 无交互，静态展示 | 字段含 1球、2球、3球、4球、5球、6球、7+球 分布。 | 按单场总进球数落入对应区间计数；主、客、总分别统计；例如某场总进球=4，则 `4球` +1。 |
| 6 | 单双统计 | 无交互，列表可滚动 | 字段含赛、单、双、单率、双率、近6场(由远及近)。 | `单`=总进球为奇数场次；`双`=总进球为偶数场次；`单率`=单 ÷ 赛；`双率`=双 ÷ 赛；近6场结果串输出 `单 / 双`。 |
| 7 | 角球分布 | 无交互，静态展示 | 字段含 `0-7 / 8 / 9 / 10 / 11 / 12 / 13+` 等角球区间分布。 | 按单场总角球数落入对应区间计数；主、客、总分别统计；例如总角球=13，则 `13+` +1。 |
| 8 | 时间段分析模块 | 点击 `场次 / 个数`、`主场 / 客场` 切换 | 统计 `0'-15' / 15'-30' / 30'-45' / 45'-60' / 60'-75' / 75'-90+'` 区间的进失球分布。 | `场次` 口径：统计在该时间段内至少发生过 1 次进球/失球事件的比赛场次；`个数` 口径：统计该时间段内发生的进球/失球事件总次数。主场 / 客场切换仅保留对应主客身份比赛。 |
| 9 | 半全场胜负 | 无交互，静态展示 | 字段含全场、主、客、总维度下的 `胜胜 / 胜平 / 胜负 / 平胜 / 平平 / 平负 / 负胜 / 负平 / 负负`。 | 按半场赛果 + 全场赛果组合计数；例如半场领先且全场赢球计入 `胜胜`。主 / 客分别以联赛球队主客身份拆分，总为全部。 |
| 10 | 子模块公共排序与着色规则 | 无交互，静态展示 | 定义所有数据表的默认排序、结果串颜色与数值展示格式。 | 默认按当前核心指标降序，如赢率、大率、单率。结果串颜色固定：`赢/大/单` 用红或粉红，`输/小/双` 用绿，`走` 用灰；百分比统一乘 100 后加 `%`，无数据显示 `-`。 |
足球球队榜 TAB
球队榜页在欧战与常规联赛都存在。左侧为榜单类型导航，中间为球队排行，右上为年份选择器。
1
2
3
4
球队榜结构
球队榜为联赛二级排行页，支持切换进球、失球、射门等不同联赛统计字段。点击球队进入队伍页。
| 位置编号 | 字段名称 | 交互 | 字段定义 | 字段逻辑 |
|---|---|---|---|---|
| 1 | 球队榜 TAB 入口与头卡 | 点击顶部 `球队榜` tab | 联赛球队排行页入口，沿用联赛头卡与赛季上下文。 | 欧战与常规联赛均展示；切换后沿用当前联赛与年份，不重置到默认年。 |
| 2 | 年份选择器 | 点击年份打开弹层并确认 | 球队榜所属赛季选择器。 | 默认加载有数据最新年份；确认后刷新榜单导航与球队排行。 |
| 3 | 榜单类型导航 | 点击左侧榜单切换 | 榜单项如进球、失球、射门、射正、关键传球、抢断、解围、红黄牌等。 | 左侧榜单名称按站内固定顺序输出；点击后刷新右侧球队排行与数据列名；当前选中榜单高亮。 |
| 4 | 球队排行列表 | 点击球队进入队伍页 | 字段含排名、球队名、场均、数据值。 | 按当前榜单字段降序排序；`场均`=球队该指标总值 ÷ 已赛场次；`数据值`=指标总值或官方口径值；点击球队根据 `team_id` 进入队伍页。 |
足球球员榜 TAB
球员榜在欧战与常规联赛都存在，但这轮未收到对应原型截图。先保留字段级 PRD；待你补图后再补原型座标。
当前先按球队榜同版型占位，字段逻辑先定义如下：
1. 左侧榜单类型：进球、助攻、射门、关键传球、抢断、扑救等。
2. 右侧排行字段：排名、球员、球队、场均、数据。
3. 点击球员进入球员页；点击球队进入队伍页；年份切换后榜单同步刷新。
1. 左侧榜单类型：进球、助攻、射门、关键传球、抢断、扑救等。
2. 右侧排行字段：排名、球员、球队、场均、数据。
3. 点击球员进入球员页；点击球队进入队伍页；年份切换后榜单同步刷新。
| 字段名称 | 交互 | 字段定义 | 字段逻辑 |
|---|---|---|---|
| 球员榜 TAB 入口 | 点击顶部 `球员榜` tab | 联赛球员排行页入口。 | 欧战与常规联赛均展示；切换后沿用当前联赛与年份上下文。 |
| 年份选择器 | 点击年份打开弹层并确认 | 球员榜所属赛季选择器。 | 默认加载有数据最新年份；确认后刷新榜单导航与球员排行。 |
| 榜单类型导航 | 点击左侧榜单切换 | 榜单项如进球、助攻、射门、射正、关键传球、过人、抢断、扑救等。 | 左侧榜单名称按站内固定顺序输出；点击后刷新右侧球员排行与数据列名。 |
| 球员排行列表 | 点击球员进入球员页；点击球队进入队伍页 | 字段含排名、球员头像、球员名、所属球队、场均、数据值。 | 按当前榜单字段降序排序；`场均`=球员该指标总值 ÷ 出场场次；`数据值`=总值或官方口径值；球员按 `player_id` 跳球员页，球队按 `team_id` 跳队伍页。 |
| 数据为空状态 | 无交互，静态展示 | 当前年份该榜单无数据时的空态占位。 | 若所选年份无任何球员榜数据，则显示空状态，不展示错误提示；切换年份后重新拉取。 |
足球历史 TAB
历史页为足球联赛新增 TAB，欧战与常规联赛都可展示。页面左侧为历史榜单切换，右侧为对应榜单列表。你给的原型已覆盖 `历届冠军 / 历届最佳 / 历届金靴 / 最佳门将 / 历史射手王 / 历史助攻王 / 历史出场 / 最年长进球 / 最年轻进球` 九种视图。
1
2
3
4
5
6
7
8
9
10
历史榜单切换结构
历史页核心是“左侧榜单切换 + 右侧历史排行”。季节型榜单按赛季输出单届结果，累积型榜单按联赛历史总量排行输出。切换左侧榜单后，仅刷新当前榜单数据，不重置联赛与年份上下文。
| 位置编号 | 字段名称 | 交互 | 字段定义 | 字段逻辑 |
|---|---|---|---|---|
| 1 | 历史 TAB 入口与头卡 | 点击顶部 `历史` tab | 联赛历史榜单主入口，沿用联赛头卡、联赛背卡色、联赛中英文名与当前年份选择器。 | 欧战与常规联赛均展示本 TAB。切入历史页后沿用当前联赛上下文；背卡色继续优先取联赛官方视觉主色，识别失败则回退联赛 Logo 主色，再回退说球帝默认蓝色。若有年份选择器，则默认加载有数据最新年份，但历史累计榜单可不受单一赛季限制，按资料库原口径展示。 |
| 2 | 左侧榜单：历届冠军 | 点击左侧 `历届冠军` 榜单 | 字段含 `赛季`、`冠军球队`。赛季如 `25-26`，冠军球队含队徽与队名。 | 每一行代表该联赛某一赛季最终冠军。冠军队取该赛季官方最终排名第 1 名或官方冠军归属字段；若赛季中断或无冠军，则该赛季不写入或按资料库原状态显示。点击冠军球队按 `team_id` 进入队伍页。 |
| 3 | 左侧榜单：历届最佳 | 点击左侧 `历届最佳` 榜单 | 字段含 `赛季`、`最佳球员`、`所属球队`。球员列含头像与姓名，球队列含队徽。 | 每一行代表该赛季官方最佳球员、MVP 或资料库定义的赛季最佳。若同赛季存在多个奖项，仅抓该联赛历史页所选主奖项。点击球员按 `player_id` 进入球员页；点击球队按 `team_id` 进入队伍页。 |
| 4 | 左侧榜单：历届金靴 | 点击左侧 `历届金靴` 榜单 | 字段含 `赛季`、`球员`、`所属球队`、`进球数`。右侧数据列为该赛季金靴最终进球。 | 金靴按该赛季联赛进球最多球员输出；若同进球并列金靴，按资料库原并列规则展示多名或展示官方第一顺位。`进球数` 仅统计该联赛该赛季正式比赛进球，不含友谊赛、其它赛事数据。 |
| 5 | 左侧榜单：最佳门将 | 点击左侧 `最佳门将` 榜单 | 字段含 `赛季`、`球员`、`所属球队`；若资料库带数值，则补充 `零封数` 或官方门将奖指标。 | 每一行代表该赛季官方最佳门将、赛季最佳守门员或资料库主门将奖项。若资料库只给获奖球员与球队，则前端仅展示对象字段；若同步回传零封场次或门将评分，则该数值作为右侧统计列展示，不自行推算其它指标。 |
| 6 | 左侧榜单：历史射手王 | 点击左侧 `历史射手王` 榜单 | 字段含 `排名`、`球员`、`所属球队/历史主队`、`历史总进球`。 | 按球员在该联赛历史正式比赛中的累计进球总数降序排行。`历史总进球` 仅统计该联赛赛事进球，跨赛季累加；不含其它联赛、杯赛或国家队进球。若同进球数并列，按资料库原排序输出。 |
| 7 | 左侧榜单：历史助攻王 | 点击左侧 `历史助攻王` 榜单 | 字段含 `排名`、`球员`、`所属球队/历史主队`、`历史总助攻`。 | 按球员在该联赛历史正式比赛中的累计助攻总数降序排行。`历史总助攻` 直接抓资料库累积助攻字段，不允许以前端事件回推补算；若站内早年赛季无助攻统计，则以资料库可追溯范围为准。 |
| 8 | 左侧榜单：历史出场 | 点击左侧 `历史出场` 榜单 | 字段含 `排名`、`球员`、`所属球队/历史主队`、`历史总出场`。 | 按球员在该联赛正式比赛的累计出场次数降序排行。`历史总出场` 统计登场即计 1 场，首发与替补都算出场；未出场替补、名单入选但未登场不计入。若同值并列，沿用资料库原排序。 |
| 9 | 左侧榜单：最年长进球 | 点击左侧 `最年长进球` 榜单 | 字段含 `排名`、`球员`、`所属球队`、`进球年龄`。年龄字段按 `xx岁xx天` 或 `xx岁xx月` 形式输出。 | 按球员在该联赛进球时的年龄由大到小排行。`进球年龄` 以 `进球比赛日期 - 出生日期` 计算，直接沿用资料库原结果。若同一球员多次上榜，仅保留其最高龄进球纪录，除非资料库明确返回多笔纪录。 |
| 10 | 左侧榜单：最年轻进球 | 点击左侧 `最年轻进球` 榜单 | 字段含 `排名`、`球员`、`所属球队`、`进球年龄`。年龄字段表示进球当下年龄。 | 按球员在该联赛进球时的年龄由小到大排行。`进球年龄` 同样以 `进球比赛日期 - 出生日期` 计算，优先展示年龄最小纪录。若存在并列最年轻纪录，按资料库原排序展示；球员与球队均保留跳转能力。 |
联赛页 原型＋PRD
篮球联赛页按当前截图拆为 `动态 / 排名 / 比赛 / 数据` 4 个 TAB，默认首开固定为 `比赛 TAB`。原型优先使用你提供的 4 张截图，字段说明补齐空状态、有数据状态、版本切换、颜色与计算逻辑。
4 TAB
动态 / 排名 / 比赛 / 数据
默认页
联赛页默认进入比赛 TAB
原型＋PRD
同页输出预览与字段表
颜色规则
评分、盘口、单双需固定口径
篮球联赛页所有 TAB 共用顶部联赛头卡；默认首开固定为 比赛 TAB。
排名、比赛、数据都会带年份上下文；切换年份后榜单、赛程、统计数据同步刷新。
篮球联赛页总览
篮球联赛页当前只有 4 个 TAB。结构上比足球联赛页更轻，重点是 `比赛默认首开`、`排名空态与有数据态`、以及 `数据四类榜单`。
动态 TAB：列表 / 详情 / 评论列表
排名 TAB：空状态 / 季后赛 / 常规赛
比赛 TAB：球迷版 / 专业版 / 当前定位
数据 TAB：让分 / 胜负 / 总分 / 单双
篮球动态 TAB
动态页分为 `列表 / 详情 / 评论列表` 三个画面。与篮球队伍页动态结构一致，但资讯主体由联赛上下文驱动，列表页顶部同样新增 `近期赛事区`。
1
2
3
4
5
| 位置编号 | 字段名称 | 交互 | 字段定义 | 字段逻辑 |
|---|---|---|---|---|
| 1 | 联赛头卡与背卡色 | 无交互，静态展示 | 字段含联赛背卡色、Logo、中英名、年份与右上功能按钮。 | 背卡色优先取联赛官方视觉主色；若无法识别则取联赛 Logo 主色；仍无法判断时用篮球联赛页默认浅蓝色方案。 |
| 2 | 近期赛事区 | 点击单场赛事卡进入赛事实页 | 展示该年自当日起最近 `3` 则未开赛赛事资讯，字段含联赛名称、主队、客队、赛事时间；最近一则额外展示距今倒数计时。若当前仅有 `1` 则近期赛事，该卡需左右拉宽并自适应装置宽度展示。 | 仅抓取 `当前联赛 + 当前年份` 下、开赛时间晚于当前时刻的未开赛赛事。按开赛时间由近到远排序，最多展示 3 场。第 1 场为最近赛事，需显示 `距今倒数`，格式可为 `00天 00:14:42`；第 2、3 场仅显示赛事时间。若当前仅抓到 1 场未开赛赛事，则该单卡不保留多卡并列留白，需直接横向拉宽至可用内容宽度，自适应当前装置宽度。点击任一赛事卡按 `match_id` 进入赛事实页；若当前年份完全没有未开赛赛事，则整块 `近期赛事区` 隐藏不展示。 |
| 3 | 资讯列表卡 | 点击文章进入详情 | 字段含标题、发布时间、缩略图、资讯角标。 | 按发布时间新到旧排序；最多拉取近 30 天且归属当前联赛 `league_id` 的文章。无图文章展示纯文卡，有图文章展示右侧缩略图。 |
| 4 | 文章详情主体 | 上下滚动；点击评论数进入评论列表 | 字段含标题、来源、发布时间、主图、正文。 | 标题、来源、发布时间、正文取文章详情接口；正文保持原始图文顺序；点击评论数进入评论列表。 |
| 5 | 评论入口与排序 | 点击 `最新 / 最早` 切换 | 评论区入口、评论数与排序按钮。 | 默认按最新评论倒序；切到 `最早` 后按发布时间升序；评论和回复均限定已安装 App 且账号等级 `Lv2` 以上才可操作。 |
| 6 | 单条评论 / 点赞 | 点击点赞、回复 | 字段含头像、昵称、评论内容、发布时间、点赞数、回复入口。 | 点赞为单次动作，每位用户对每则评论仅可点赞一次，成功后前端即时 +1 且不可取消；评论成功后插入当前排序维度最新一则。 |
篮球排名 TAB
排名页同时涵盖 `空状态 / 季后赛对阵 / 常规赛分区榜单` 三种场景。是否展示季后赛图、联盟 / 赛区切换与赛制说明，取决于当前联赛赛季是否存在对应数据。
1
2
3
4
5
6
7
| 位置编号 | 字段名称 | 交互 | 字段定义 | 字段逻辑 |
|---|---|---|---|---|
| 1 | 排名 TAB 入口与头卡 | 点击顶部 `排名` tab | 联赛排名页主入口，沿用联赛头卡。 | 进入当前联赛排名视图，沿用当前联赛与年份上下文；背卡色取联赛主视觉色。 |
| 2 | 空状态 | 无交互，静态展示 | 当前赛季无排名数据时的空态占位。 | 若当前年份没有常规赛或季后赛排名数据，则显示空状态图和空文案，不展示报错提示。 |
| 3 | 季后赛对阵图 | 点击球队进入队伍页 | 季后赛轮次对阵树，含球队名、比分、晋级线。 | 当该赛季存在季后赛数据时优先展示；点击球队按 `team_id` 进入队伍页；晋级线按实际对阵结果连线。 |
| 4 | 常规赛 / 季后赛切换 | 点击切换榜单类型 | 排名口径切换器。 | 若当前联赛同时存在常规赛与季后赛榜单，则显示切换；否则仅展示已有类型。 |
| 5 | 年份选择器 | 点击年份打开弹层并确认 | 排名所属赛季选择器。 | 默认加载有数据最新年份；切换年份后刷新空态 / 对阵图 / 榜单与赛制说明。 |
| 6 | 常规赛榜单与联盟 / 赛区切换 | 点击 `联盟 / 赛区` 切换；点击球队进入队伍页 | 该榜单每列字段都需独立定义：1. `排名`=当前榜单名次。2. `球队`=队徽 + 队名。3. `胜/负`=胜场 / 负场。4. `胜率`=球队取胜比例。5. `胜差`=与榜首或官方基准队的场差。6. `近况`=最近一段比赛战绩摘要。不可只写成整段概述，开发需能直接对应每一列。 | `联盟` 模式展示全联盟总榜，`赛区` 模式展示东/西或南/北分区榜。各字段规则如下：1. `排名`：按当前榜单排序结果自上而下编号，名次从 1 开始。2. `球队`：抓取该赛季球队资料库中的 `team_id`、队徽、中文名；点击后进入队伍页。3. `胜/负`：仅统计当前年份、当前榜单范围内已完赛比赛，胜场记入前值、负场记入后值，未开赛、取消、延期不计。4. `胜率`=`胜场 ÷ (胜场 + 负场)`；若总场次为 0，则显示 `0.0%` 或 `-`，依资料库原口径输出。5. `胜差`：直接抓取资料库 standings 原字段，不允许前端自行换算另一套公式；若资料库返回的是对榜首场差，就原样展示该口径。6. `近况`：抓取资料库最近 N 场摘要字段，常见为近 10 场，按时间由近到远统计，可展示为 `胜x负y`、`3连胜`、`2连败` 等原口径结果。默认排序以资料库返回为准；若需前端补排序，则先按 `胜率` 降序，再按 `胜差` 升序，再按 `胜场` 多者优先。 |
| 7 | 赛制说明 | 无交互，静态展示 | 展示当前年份该联赛对应的完整赛制说明区，内容来源必须是该年资料库赛制字段，不可写死统一文案。说明内容需覆盖：`常规赛规则`、`季后赛规则`、`附加赛规则`、`同战绩排名比较顺序`、`分区/联盟名额规则`。 | 字段逻辑如下：1. 赛制说明抓取 `当前联赛 + 当前年份` 对应的资料库赛制说明。2. 若 2026 与 2025 赛制不同，则切年份后需同步切换为该年的说明内容。3. 若该联赛仅有常规赛，则只展示常规赛说明；若存在附加赛、季后赛、分区淘汰赛，则需把该年份所有规则完整列出。4. 文案需明确写出排名比较顺序、晋级名额、淘汰轮次、主客场规则与特殊并列处理，不能只剩一句概述。5. 若资料库该年无赛制说明，则显示空态，不以前端补写猜测内容。 |
篮球比赛 TAB
比赛页为篮球联赛页默认首开页，区分 `球迷版` 与 `专业版`，并支持当前定位、赛事实页与球员页跳转。
1
2
3
4
5
6
7
8
| 位置编号 | 字段名称 | 交互 | 字段定义 | 字段逻辑 |
|---|---|---|---|---|
| 1 | 比赛头卡与背卡色 | 无交互，静态展示 | 字段含联赛背卡色、Logo、中英名、年份。 | 背卡色优先取联赛官方视觉主色；若无法识别则取联赛 Logo 主色；仍无法判断时用篮球联赛页默认浅蓝色方案。 |
| 2 | 球迷版 / 专业版切换 | 点击版本按钮切换 | 赛程展示版本切换器。 | 球迷版展示比分、最佳球员、媒体评分；专业版展示让分、总分、单双。切换版本不重置年份和主客筛选。 |
| 3 | 年份选择器 | 点击年份打开弹层并确认 | 赛程所属赛季选择器。 | 默认加载有数据最新年份；确认后刷新赛程列表与默认定位位置。 |
| 4 | 当前定位按钮 | 点击 `当前` | 将列表滚动到当前比赛附近。 | 优先定位进行中比赛；若无则定位最近未来比赛；若未来也无则定位最近已完赛。 |
| 5 | 主场 / 客场筛选 | 点击 `主场 / 客场` 切换 | 仅保留联盟中目标球队主场或客场场次。 | 切到 `主场` 仅展示主队为目标球队的比赛；切到 `客场` 仅展示客队为目标球队的比赛；默认展示全部。 |
| 6 | 球迷版比赛记录行 | 点击整行进入赛事实页；点击球员进入球员页 | 字段含日期、时间、主客队、比分、最佳球员、媒体评分、胜负标记。 | 整行根据 `match_id` 跳赛事实页；最佳球员根据 `player_id` 跳球员页；媒体评分保留 1 位小数；胜负标记按球队比赛结果显示 `W/L`。 |
| 7 | 专业版盘口字段 | 点击整行进入赛事实页；点击球队进入队伍页 | 专业版列表不可只写成“盘口字段”。需逐项定义：1. `日期/时间`。2. `主队`。3. `客队`。4. `赛果状态`。5. `让分`。6. `总分`。7. `单双`。8. `主客队名颜色`。其中 `让分 / 总分 / 单双` 都是比赛盘口结果列，`主客队名颜色` 是配合盘口结果的方向提示字段。 | 字段规则分述如下：1. `日期/时间`：抓取比赛开赛时间，按站内固定格式显示。2. `主队`：抓取主队队徽、队名，点击进入队伍页。3. `客队`：抓取客队队徽、队名，点击进入队伍页。4. `赛果状态`：显示 `完 / vs / 延 / 取消` 等原始状态，完赛才展示完整盘口结果。5. `让分`：显示让分盘口值，如 `-4.5`、`+5.5`；结果文案依赢盘/输盘/走盘判定，赢盘为绿色、输盘为红色、走盘为灰色。6. `总分`：显示总分盘口值，如 `176.5`；若赛果为 `大` 则用红色，`小` 用绿色，`走` 用灰色。7. `单双`：显示 `单 / 双 / 走`，该字段本身只表达全场总分奇偶结果，若站内无额外颜色则维持默认字色。8. `主客队名颜色`：用于提示哪一侧是当前盘口结果的受益方，不是单纯品牌色；常见规则为目标结果有利一侧高亮绿色，不利一侧高亮红色，若无方向则保持默认色，必须完全沿用资料库或站内既有结果映射。9. 整行点击按 `match_id` 进入赛事实页。 |
| 8 | 底部汇总栏 | 无交互，静态展示 | 底部汇总栏需逐项定义：1. `近况`。2. `胜率`。3. `赢率`。4. `大率`。5. `单率`。五个字段都基于当前年份、当前筛选条件、当前版本口径聚合而成，不是固定写死数值。 | 详细规则如下：1. `近况`：展示最近 N 场已完赛比赛的战绩摘要，通常写成 `近2场`、`2胜0负`、`1胜1负` 等；N 依站内当前模块口径。2. `胜率`：`胜场 ÷ 已赛场次`，仅统计当前筛选范围内已完赛比赛。3. `赢率`：`赢盘场次 ÷ 有让分赛果场次`，若资料库将走盘排除在分母外，则前端直接沿用该口径。4. `大率`：`大分场次 ÷ 有总分赛果场次`，分母只统计存在大小分赛果的比赛。5. `单率`：`单数赛果场次 ÷ 有单双赛果场次`。6. 百分比统一显示为 `%`，保留位数依设计稿或资料库原值格式。7. 若当前筛选条件下样本不足或无赛果，则对应字段显示 `-` 或 `0`，以前端透传资料库原口径为准。 |
篮球数据 TAB
数据页当前拆成 `让分 / 胜负 / 总分 / 单双` 四个子视图，均为联赛球队聚合排行，而非单场数据。
1
2
3
4
5
| 位置编号 | 字段名称 | 交互 | 字段定义 | 字段逻辑 |
|---|---|---|---|---|
| 1 | 让分榜 | 点击子页签切换 | 让分榜每个字段都需定义：1. `球队`=队徽 + 队名。2. `赛`=有让分赛果的比赛场次。3. `赢`=赢盘场次。4. `输`=输盘场次。5. `赢率`=赢盘比例。6. `输率`=输盘比例。 | 字段计算如下：1. `球队` 抓取当前年份球队资料。2. `赛`=当前年份、当前联赛下所有存在让分盘赛果的已完赛比赛场次。3. `赢`=按让分盘口判定该队赢盘的场次。4. `输`=按让分盘口判定该队输盘的场次。5. `赢率`=`赢 ÷ 赛`。6. `输率`=`输 ÷ 赛`。若有 `走盘`，是否计入 `赛` 分母须沿用资料库既有口径。默认按 `赢率` 降序，若同值则比 `赛` 多者优先。 |
| 2 | 胜负榜 | 点击子页签切换 | 胜负榜每个字段都需定义：1. `球队`=队徽 + 队名。2. `赛`=已赛场次。3. `胜/负`=胜场 / 负场。4. `胜率`=胜场占比。5. `胜差`=与榜首或官方基准队的场差。 | 字段计算如下：1. `赛`=当前年份所有已完赛比赛场次。2. `胜`=获胜场次。3. `负`=落败场次。4. `胜率`=`胜 ÷ 赛`。5. `胜差` 直接抓资料库 standings 原字段；若资料库未给公式说明，前端不得自行换算。默认按 `胜率` 降序、`胜差` 升序排序。 |
| 3 | 总分榜 | 点击子页签切换 | 总分榜每个字段都需定义：1. `球队`=队徽 + 队名。2. `赛`=有总分赛果的比赛场次。3. `大`=打出大分场次。4. `小`=打出小分场次。5. `大率`=大分比例。6. `小率`=小分比例。 | 字段计算如下：1. `赛`=当前年份存在大小分盘口赛果的已完赛比赛场次。2. `大`=比赛总得分高于总分盘口的场次。3. `小`=比赛总得分低于总分盘口的场次。4. `大率`=`大 ÷ 赛`。5. `小率`=`小 ÷ 赛`。若存在 `走`，是否纳入分母依资料库原口径。默认按当前主排序字段降序，常见为 `大率` 或 `小率`。 |
| 4 | 单双榜 | 点击子页签切换 | 单双榜每个字段都需定义：1. `球队`=队徽 + 队名。2. `赛`=有单双赛果的比赛场次。3. `单`=总分为奇数场次。4. `双`=总分为偶数场次。5. `单率`=单数比例。6. `双率`=双数比例。 | 字段计算如下：1. `赛`=当前年份存在单双赛果的已完赛比赛场次。2. `单`=全场总分为奇数的场次。3. `双`=全场总分为偶数的场次。4. `单率`=`单 ÷ 赛`。5. `双率`=`双 ÷ 赛`。单双结果只表达奇偶，不额外附加盘口方向解释；默认按当前核心比率字段降序输出。 |
| 5 | 数据颜色与排序规则 | 无交互，静态展示 | 定义四个子榜单的共用展示规则，需包含：`页签高亮规则`、`数值格式`、`空值格式`、`颜色规则`、`默认排序规则`。 | 共用规则如下：1. 当前选中的子页签标题高亮，其余维持默认态。2. `赛 / 赢 / 输 / 胜 / 负 / 大 / 小 / 单 / 双 / 胜差` 等基础数值默认使用普通文字颜色，不额外做红绿。3. `赢率 / 输率 / 胜率 / 大率 / 小率 / 单率 / 双率` 统一转百分比显示，并带 `%`。4. 无资料时显示 `-` 或 `0`，以资料库原始值与站内现有口径为准。5. 所有榜单默认按当前主排序比率字段降序；若相同，则 `赛` 多者优先；若资料库已直接返回排序结果，则前端不再重排。6. 颜色不承担输赢语义，篮球数据 TAB 以可读性为主，不使用比赛 TAB 那套红绿盘口结果色。 |