PLAYER EXPERIENCE · IMPLEMENTATION SPEC
球员每日表现 · 产品需求文档 | 范围:Daily Player Feed、比赛证据与 Action map
文档口径 本文只描述页面实际存在的元素与状态。未列出的标题、图标、辅助文案和控件均不进入页面;数据缺失或条件不满足时,按“边界处理”中的明确状态执行。
Top Performers
优秀球员入口、比赛筛选与当前球员池
展示位置
- 入口位于首页顶部横向 Tab,Match day 固定在 TODAY 左侧,并与 TODAY 同级。
- 进入后页面标题为 Top Performers,下方依次为日期栏、比赛列表、优秀球员条和当前球员主卡。
展示内容
- 日期栏默认展示最近 7 个有比赛的历史比赛日和最近 3 个有比赛日期。
- 日期项显示相对标签(Yesterday / Today / Tomorrow 或星期)和“日 + 月份”;当前日期使用红色下划线与红色日期。
- 日期栏下方显示横向比赛列表;有多场比赛时,最左侧显示 All。
- All 用于取消单场筛选,恢复当日全部优秀球员;当日只有一场比赛时隐藏 All,默认选中该场比赛。
- 选中比赛后,比赛列表自动横向滚动,将该比赛定位到可视区域约左侧 38% 的位置,同时保持右侧后续比赛可见;比赛列表与优秀球员条通过共享红色背景和选中态体现筛选联动。
- 比赛项显示双方队徽和比分;FT 状态显示 FT,进行中显示比赛分钟(如 72′),未赛显示 VS 和开赛时间(如 20:00)。
- 比赛项排序固定为:最近已结束 → 进行中(接近结束优先)→ 未开始(接近开赛优先)。
- 排序示例:18:55 已结束 → 81′ 进行中 → 20:00 未开始;已结束按结束时间倒序,进行中按比赛分钟倒序,未开始按开赛时间正序。
- 优秀球员条优先展示系统评分不低于 7.5的球员,并限定在当前比赛筛选范围内;若某场比赛已结束且无人达到 7.5 分,则展示该场双方球员中系统评分最高的 3 位。包含头像、队徽、短名、位置和系统评分;当前球员用红色描边选中。
取数
- 读取赛程、比赛状态、联赛、开赛时间、比赛日期、主客队、比分和球员表现页可用性。
- 日期比赛集 = 优先级前二的比赛和优先级前三球队参与的当日比赛,按比赛去重。
- 读取本场双方全部已出场球员的有效系统评分,用于筛选与排序。
计算
- 从当前日期向前回溯,只保留有比赛且有可用球员表现的日期;最多取 7 个,早于当前日的按时间升序展示。
- 向未来扫描,只保留有赛程的日期,取最近 3 个并按时间升序展示。
- 首次进入时,从当天开始向前查找,默认定位到最近一个已有已结束比赛且有球员表现数据的日期;未来赛程日期不参与默认回退。
- All 显示当日全部优秀球员,单场选项显示归属该场比赛且当前已有数据的球员。
- 逐场筛选系统评分 ≥ 7.5 的球员;已结束且无人达标的比赛取本场评分前三。All 合并各场候选后按系统评分降序最多展示 8 名;单场正常最多 5 名,兜底最多 3 名。
交互
- 点击 Match day 进入每日表现页。
- 点击日期刷新优秀球员、主卡、比赛证据、Match stats、Action map 和 Team of the day,并回到页首。
- 点击比赛列表中的 All 或已结束比赛后立即刷新优秀球员条和当前球员。
- 进行中比赛逐场判断球员数据可用性:已有数据的进行中比赛可直接筛选球员;暂无数据的进行中比赛与未赛比赛在点击时于屏幕中央显示短提示(No eligible players to display / Match not started),并保持当前球员和比赛上下文不变。
边界处理
- 历史比赛日不足 7 个时继续向更早日期查找,查到数据源尽头即停止。
- 切换日期后,多场默认选中 All,单场默认选中该场比赛。

单场比赛:隐藏 All,默认选中该场比赛,展示本场球员条与当前球员主卡。 - 评分恰好 7.5 视为达标;进行中比赛不启用前三兜底。已结束比赛有效评分不足 3 人时按实际人数展示,同分按球员姓名排序。
- 若历史日期和未来日期均无法获取数据,Match day 入口不显示。
Player Spotlight
当前球员身份、比赛数据与评分层级
展示位置
- 位于优秀球员条之后、Period Highlights 之前。
- 主卡展示当前球员的姓名、球队、位置、本场统计,以及用户评分和系统评分。
展示内容
- 显示球员头像、全名、所属球队、队徽、位置、出场分钟、进球、助攻和 xG。
- 出场分钟前展示计时器图标,助攻前展示足球鞋图标;0 次助攻同样展示图标和数值 0。
- 并列展示 User rating 与 System rating,各保留一位小数;用户评分附有效评分数量,系统评分标注 Match model。
取数
- 球员主数据:姓名、头像、球队、队徽和位置。
- 本场统计:出场分钟、进球、助攻和 xG。
- 评分数据:本场用户评分均值、有效评分数量和系统模型评分。
- User rating 使用本场用户评分均值;System rating 使用同一比赛、同一球员的系统评分;两者不可互相回填。
计算
- 评分范围 0–10,显示一位小数;xG 显示两位小数;分钟使用整数并追加
′。 - 0 进球和 0 助攻是有效值,显示对应图标和数值 0。
交互
- 点击优秀球员条切换当前球员;主卡、评论、指标、Action map 与 Team of the day 同步刷新。
边界处理
- 出场分钟、进球、助攻和 xG 获取不到时,显示 -;有效数值 0 正常显示为 0。

分钟、进球、助攻和 xG 缺失时,各字段显示 -。 - 球员头像或球队队徽获取不到时,分别显示默认头像 icon 或默认队徽 icon。
- 没有用户评分或有效评分人数为 0 时,隐藏整个 User rating 区块(标题、分数和人数);System rating 正常展示。
- 比赛进行中,主卡的比分、比赛分钟及球员本场数据随数据源实时更新,无需手动刷新;比赛结束后更新为最终数据。

无用户评分:隐藏整个 User rating 区块,System rating 正常展示。
Period Highlights
与本场比赛及当前球员关联的 GIF 回放
展示位置
- 位于 Player Spotlight 之后、User Ratings & Reviews 之前。
展示内容
- 展示与本场比赛及当前球员同时关联的全部 GIF 回放卡。
- 每张回放卡展示 GIF、动作类型和事件时间,例如 43′。
取数
- 读取当前球员和比赛的事件 ID、动作类型、事件时间、媒体 URL、封面和可用状态。
计算
- 事件时间统一使用比赛分钟与补时格式,例如
43′、45+3′、90+4′。 - 回放卡按事件时间倒序排列,最新事件在前。
交互
- 支持左右横向滑动浏览全部回放卡。
边界处理
- 本场比赛及当前球员没有匹配的 GIF 时,Period Highlights 模块不显示。
User Ratings & Reviews
当前球员的用户评分与高赞评论
展示位置
- 位于 Period Highlights 之后、Match stats 之前。
展示内容
- 展示用户综合评分,以及点赞数最高的最多 3 条评论。
- 每条评论包含作者头像、用户名、星级、点赞数和评论正文。
- 底部展示 View all reviews。
取数
- 读取当前球员在本场比赛中的有效用户评分均值、评分数量,以及审核通过的评论数据。
计算
- 评论按点赞数降序排列;不足 3 条时展示全部,超过 3 条时取前 3 条。同赞数按发布时间降序。
交互
- 点击 View all reviews 进入本场比赛该球员的评分详情页。
边界处理
- 评论列表和数量只统计审核通过且仍有效的评论。
- 有效评论少于 3 条时按实际数量展示。
- 当前球员在本场比赛中没有有效评论时,User Ratings & Reviews 模块不显示。
Match Stats
当日前十表现的默认视图、分类指标与排名下钻


展示位置
- 位于 User Ratings & Reviews 之后、Action map 之前。
- 标题区显示 Match stats 主标题,作为“本场数据”的英文文案。
展示内容
- 默认展示 Standout data;另一项为 All dimensions。
- Standout data 从当日有效指标中,取排名 #1–#10 且数值大于 0 的指标,按名次、再按下列分类顺序最多显示 4 项。没有符合项时隐藏此 Tab,默认展示 All dimensions。
- Attack(进攻):Shots、Shots on target、Expected goals (xG)、Shots inside box、Shots outside box、Big chances missed、Dribbles、Successful dribbles、Dispossessed、Was fouled。
- Playmaking(组织):Passes、Passing accuracy、Key passes、Big chances created、Long balls、Accurate long balls、Crosses、Accurate crosses。
- Defence(防守):Tackles、Clearances、Interceptions、Duels、Duels won、Aerials won、Aerials lost、Fouls。
取数
- 按比赛日期、比赛 ID、球员 ID 读取本场统计;Big chances created、Big chances missed 读取数据源对应字段,未提供时不展示。
- Shots (on Target) 拆成 Shots 与 Shots on target;Dribbles (succ.) 拆成 Dribbles 与 Successful dribbles;Shots outside box 使用总射门减禁区内射门;其余指标对应数据源同名字段。
- Passing Accuracy 的示例原值为 4,当前保留原值、不追加 %;接口单位确认前不换算、不参与排名或亮点。
- Demo 使用完整演示数据展示全部指标,包括 Big chances created 和 Big chances missed;演示值不代表真实比赛数据。实际取数缺失时按边界规则隐藏。
计算
- Shots outside box = Shots − Shots inside box;两项均为有效非负整数且总射门不小于禁区内射门时才计算,否则隐藏。xG 保留两位小数,计数项显示整数。
- 各指标独立按数值降序排名。
- Big chances missed、Aerials lost、Dispossessed、Fouls 仅展示原值,不参与排名和 Standout data。Passing accuracy 待单位确认后另行确定排名规则。
交互
- 切换 Standout data / All dimensions 时保持当前球员和日期;切到 All dimensions 后使用当前分类最后一次选择。
- 点击指标行或排名标签打开 Bottom sheet,展示名次、球员头像与姓名、比赛双方、比分及指标值;头像左侧显示所属球队队徽,右侧以 ST、CM、LW 等字母显示位置。
- 点击排名中的整行球员区域,进入该球员的资料页;关闭弹层后恢复原日期、分类、指标和滚动位置。
边界处理
- 获取不到的字段整项隐藏(含名称、数值和排名);有效的 0 正常显示为 0,不作为 Standout data。当前分类无有效字段时不展示指标列表。
- 不参与排名的指标不显示排名标签,点击不打开排名弹层。
- 不同位置统一使用 Attack、Playmaking、Defence 三个分类。
Action Map
Shot、Pass、Defence、Save 四种动作证据
展示位置
- 位于 Match stats 之后、Team of the day 之前。
- 该模块直接沿用球员比赛卡内 Action map 的展示图示、Tab、统计和交互,不另做一套视觉。
展示内容
- 保留 Shot、Pass、Defence、Save 四种动作视图;每类视图中的图示、统计口径、筛选入口和时间详情均与比赛卡内的 Action map 一致。
取数
- 读取当前球员、比赛和时段的动作事件,并复用比赛卡 Action map 的字段与数据源。
计算
- 统计和筛选计算直接复用比赛卡 Action map,不在此模块重复定义另一套口径。
交互
- 切换 Tab、类型筛选、点位和时间详情时,保持与比赛卡 Action map 相同的交互结果。
- 切换模块时保留当前球员、日期和比赛上下文。
边界处理
- 无动作数据时沿用比赛卡 Action map 的空状态处理。
Team of the Day
当日合格球员的 4–3–3 阵容
展示位置
- 位于 Action map 之后,是每日表现页的最后一个内容模块。
- 使用单张 4–3–3 球场呈现 11 个位置;头部当前选中的球员以金色描边和姓名高亮标记。
展示内容
- 每个入选位置显示球员头像、所属队徽、位置、评分和短名;队徽位于头像左下角,位置位于头像右下角。
取数
- 读取当前日期全部已结束比赛中的合格球员、位置、评分、球队、头像和队徽。
- 候选必须出场至少 60 分钟且有有效比赛评分。
计算
- 按固定 4–3–3 位置展示:LW、ST、RW、CM、CM、CM、LB、CB、CB、RB、GK;三名中场从 CM/DM 候选球员中选择。
- 每个槽位取符合角色的最高评分球员,候选评分必须不低于 7.0;同分按出场分钟降序。
- Team of the Day 在合格球员可组成完整 4–3–3 且人数达到 11 人时显示。
交互
- 点击场上球员进入球员资料页。
- 头部当前选中的球员在阵容中保持高亮:头像使用金色描边,姓名使用高亮底色。
- 球员按钮提供完整可读名称,键盘可聚焦;触控区域不小于 44px。
边界处理
- 可组成完整 4–3–3 的合格球员不足 11 人时,Team of the Day 模块不显示。
Upcoming Matches
未开始与进行中的比赛样式
展示位置
- 用户选择未来比赛日后,作为页面的主要内容显示在日期栏下方。
- 今日有比赛,且还没有符合条件的球员可供展示时,展示赛程卡片,并更新比赛状态与比分。
展示内容
- 未开始比赛显示联赛徽标、联赛名称、当地开赛时间、双方真实队徽、球队名称和 VS;按开赛时间升序排列。
- 比赛进行中,且没有符合条件的球员可供展示时,右上角显示红色圆点与比赛分钟(如 72′),双方球队中间显示实时比分(如 2–0);下方保留 Players to watch。
- 每场比赛卡片内部、比赛双方下方显示独立的 Players to watch。
- 球员卡片采用紧凑横滑布局,显示头像和居中姓名;队徽位于头像左下角,位置字母位于头像右下角。
取数
- 读取赛程、联赛及联赛徽标、球队及队徽、开赛时间、时区、比赛状态、比赛分钟、实时比分和比赛 ID;Players to watch 另取球员评分及能力值。
计算
- 只展示有赛程的日期;未来从当前日期向后取最早的 3 个有效比赛日。
- 比赛按当地开赛时间升序排序;跨时区比赛按联赛所在地时间显示,并明确日期归属。
- 每场比赛的 Players to watch 从双方球队可用球员中选取:有评分时使用评分,没有评分时使用能力值,按对应数值降序取前 5 名。
交互
- 点击日期切换赛程;当前日期保持在日期栏可见区域。
- 点击 Players to watch 中的球员卡片,进入球员资料页。
边界处理
- Today 边界示例:今日有比赛,且还没有符合条件的球员可供展示;图中包含一场进行中比赛和一场未开始比赛。

Today:暂无符合条件球员时,展示一场进行中和一场未开始比赛,保留 Players to watch。 - 延期、取消和中止比赛展示对应状态标签。