代理管理 · 直播管理 · 权限补齐 · PRD
代理直播权限在 PC 端判断逻辑补齐
1需求性质
本次不是新增「直播关闭」能力，也不是为 PC 单独做一套开关。后台「直播管理」早已存在，弹窗已写明隐藏该代理 PC / WAP / APP 所有直播功能。缺口是：PC 客户端当初未接入同一套代理直播权限判断。
| 是 | 不是 |
|---|---|
| 在 PC 补齐对现有代理直播权限的读取与执行，使关闭态下该代理线下用户全端不可见直播。 | 不上新配置项、不拆「仅关 PC / 仅关 H5」开关、不改后台「执行全部下级」算法。 |
| 代理直播权限作为统一业务权限，PC、H5、WAP、APP 遵循同一权限结果。 | 不为某一端单独解释「能不能看直播」。 |
2背景与问题
运营在代理后台关闭某代理线下直播后：
| 端 | 关闭后会员能否看到官方直播赛事视频 | 说明 |
|---|---|---|
| H5 / WAP | 不能 | 已按代理直播权限执行 |
| APP | 不能 | 已按代理直播权限执行 |
| PC | 仍能看到并播放 | 最早历史需求未给出规范，未走同一权限判断 |
结果：同一代理、同一会员，H5/APP 看不到直播，PC 登录后仍能绕过。产品要求补上 PC 条件，关闭状态下该代理线下用户全端均不可见直播。
3目标
- 代理关闭直播后，已登录 PC 页面的直播入口与直播模块隐藏，与 H5 / WAP / APP 同一权限结果。
- 未登录 PC 维持现状：直播本就不可见，本次不改未登录逻辑与展示。
- 权限来源仍是现有「代理直播管理」；PC 只补判断与执行，不新增关闭功能。
4统一权限原则
| 原则 | 口径 |
|---|---|
| 单一权限源 | 以会员所属代理的「直播管理」状态为准（含「执行全部下级」写入的下级树）。PC 不得另建缓存开关或本地白名单覆盖。 |
| 四端同一结果 | 同一会员、同一时刻，PC / H5 / WAP / APP 对「能否看官方直播」的结论必须一致。 |
| 先权限后内容 | 无权限则不渲染入口、不拉直播列表、不请求播放地址。只藏 UI、接口仍吐流视为未完成。 |
| 不伤投注主路径 | 无直播权限 ≠ 关盘。足球/篮球等赛事列表、赔率、投注保留。 |
权限值仅两种：启用（有直播权限） / 禁用（无直播权限）。PC 已登录时按该值决定是否展示直播入口模块；未登录不走本次改造。
5登录态规则
| PC 状态 | 代理直播权限 | 直播入口 / 模块 | 本次动作 |
|---|---|---|---|
| 已登录 | 禁用 | 不展示 | 补齐判断，必须执行 |
| 已登录 | 启用 | 展示（与现网启用态一致） | 不改启用体验 |
| 未登录 | —（游客无代理身份或现网本就不可见） | 维持现状：直播不可见 | 不改代码路径、不验收新表现 |
未登录：产品明确「维持现状不变（直播不可见）」。禁止借本次把游客首页做成可看直播，也禁止改游客空态文案、引导登录看直播等。退出登录后应回到现网未登录表现（无直播），不得残留已登录时的直播模块。
登录 / 退出切换：
- 未登录 → 登录：立刻按该会员代理直播权限刷新首页；无权限则不出现直播入口。
- 已登录（无权限）→ 退出：回到未登录现状（直播不可见），与改需求前游客页一致。
- 已登录（有权限）→ 退出：直播入口随登录态消失，回到未登录现状，不单独为游客开直播。
6PC 已登录：隐藏范围（截图红框）
页面：PC 首页。账号已登录。以下为现网直播入口模块截图，无权限时整块不展示（含顶栏「直播」及下方横滑内容），不能只藏卡片、Tab 还在。
红框 1：直播入口
| 项 | 口径 |
|---|---|
| 是什么 | 该模块顶栏左侧橙色选中的 直播 Tab（与足球、篮球并列）。 |
| 无权限时 | 不渲染。不置灰、不点了再提示「暂无直播」。 |
| 排版 | 随整块模块一起拿掉，不留空位。 |
红框 2：直播模块整块
| 元素（见上图） | 无权限时 |
|---|---|
| 顶栏 直播 / 足球 / 篮球 切换，及右侧「更多比赛」、左右箭头 | 不展示 |
| 下方正在直播横滑卡片（含官方直播赛事卡、官方内容卡） | 不展示、不拉流 |
无权限进入首页时：该模块整块不出现。页面其余足球/篮球赛事列表与投注保留。表现应像「本站没有这块直播入口」，不要「暂无信号 / 加载失败」。
有权限时：该模块与现网截图一致，本次不改卡片与播放体验。
隐藏的是上图这一整块直播入口模块。站点其它足球、篮球盘口、左侧菜单、账号/余额/充值均保留。
7权限判定矩阵
| # | 条件 | PC 已登录直播模块 | H5 / WAP / APP |
|---|---|---|---|
| 1 | 本级代理直播 = 禁用 | 不展示 | 同一结果（现网已不可见） |
| 2 | 上级禁用且勾选「执行全部下级」，会员在被执行树上 | 不展示 | 同一棵树、同一结果 |
| 3 | 上级禁用但未勾选下级，本级仍启用 | 展示 | 展示 |
| 4 | 本级启用 | 展示 | 展示 |
| 5 | 其他代理未关直播的会员 | 展示 | 展示 |
| 6 | PC 未登录 | 现状：不可见（不改） | 现网不变 |
8后台与数据
路径：代理管理 → 代理详情 → 概要消息 → 直播管理。弹窗文案、提交、「执行全部下级」不改交互。
- PC 登录后拉取与 H5/APP 同一权限字段 / 同一接口语义，禁止 PC 专用「是否开直播」配置。
- 无权限时：首页直播列表、拉流/播放地址接口返回空或无权限；不能只靠前端藏 Tab。
- 不要求会员为本次重新登录；权限变更后以刷新或下一次接口为准，且不得慢于 H5 同一时效。
9异常场景
| 编号 | 异常 / 边界 | 期望 |
|---|---|---|
| E01 | 已登录、停在直播模块播放中，运营改为禁用 | 尽快去掉入口与模块，停画面和声音，落到足球；不弹「代理已关闭直播」；不要求重启浏览器。 |
| E02 | 无权限时用带直播频道参数的 URL / 收藏夹 / 分享链接进首页 | 不打开直播模块，按足球落地；改 URL 无法绕过权限。 |
| E03 | 无权限时刷新、多标签、后退再进首页 | 始终无直播 Tab、无模块；本地缓存不得把「曾经有直播」写回页面。 |
| E04 | 接口超时 / 权限字段缺失 | 按无直播权限处理（不展示入口与模块），避免失败时默认放出直播；可走站点统一错误提示，但不得露出播放器。 |
| E05 | 前端藏了 Tab，播放接口仍返回流地址 | 不通过。服务端必须按代理直播权限拒绝或空数据。 |
| E06 | 登录瞬间：先闪出直播 Tab 再消失 | 不允许明显闪动。先拿到权限再渲染频道栏；权限未返回前不展示直播入口。 |
| E07 | 退出登录 | 回到未登录现状（直播不可见），与需求前游客页一致；不得把已登录的直播模块留给游客。 |
| E08 | 同一浏览器先登无权限账号，再登有权限账号（或相反） | 以当前登录会员的代理权限为准，互不污染。 |
| E09 | 上级禁用 + 未勾选「执行全部下级」 | 本级启用的下级会员 PC 登录后仍可见直播，与 H5 一致，不能误伤。 |
| E10 | 禁用后运营改回启用 | 已登录 PC 刷新或再进首页后恢复直播入口与模块；不强制重新登录。未登录仍维持现状不可见。 |
| E11 | 小窗 / 贴边仍在播（若产品有） | 随权限关闭销毁，禁止只停画面不停声音。 |
| E12 | 未登录用户清缓存、换浏览器、直接打开首页 | 与现网未登录一致，直播不可见；本次无新交互。 |
| E13 | H5 有权限、PC 无权限（或相反）同账号同时在线 | 不允许。四端必须同一权限结果；出现则判权限接口或端上判断错误。 |
| E14 | 会员转代后新代理直播权限不同 | 以转代后所属代理的权限为准（规则与 H5 现网一致）；PC 下次请求后生效。 |
10验收标准
10.1 需求性质验收
- 后台无新增「PC 直播开关」或按端拆分配置；仍用原「直播管理」。
- 同一会员在 PC / H5 / WAP / APP 对「能否看官方直播」结论一致。
- 代码与方案表述均为「补齐 PC 对代理直播权限的判断」，而不是新做关闭直播功能。
10.2 已登录 + 代理直播 = 禁用
- PC 首页顶栏无「直播」Tab，其余 Tab 无空位。
- 无横滑直播卡片、无官方播放器、无直播旁聊天/押注/赛况。
- 默认足球（或第一项体育 Tab），赛事与投注可用。
- 带直播参数的链接、刷新、多标签均无法打开直播模块。
- 播放中被关掉：模块消失、声画停止。
- 直播列表 / 拉流接口无可用数据或明确无权限。
- 权限未返回前不闪出直播入口。
10.3 未登录
- PC 未登录首页直播仍不可见，与改需求前现状一致。
- 未登录无新提示、无新入口、无「登录后可看直播」的本次新引导（除非现网本来就有且未改）。
- 从已登录退出后，表现回到未登录现状，无直播模块残留。
10.4 启用与隔离
- 代理直播 = 启用时，已登录 PC 直播入口与模块与现网一致。
- 改回启用后，已登录刷新即可恢复，不强制重新登录。
- 勾选全部下级：下级已登录 PC 同步禁用；未勾选不误伤。
- 未关直播的其他代理会员，已登录 PC 不受影响。
- H5 / WAP / APP 关闭态与启用态均无回归。
11不在本次范围
- 新增或拆分直播关闭功能、按端独立开关。
- 修改未登录现状（含把游客做成可看直播，或改游客直播相关文案）。
- 改后台「直播管理」弹窗主流程与「执行全部下级」规则。
- 足球 / 篮球等非直播 Tab 的改版；启用态播放器体验改版。
- 赛事详情、独立直播中心若另有入口：以「与首页同一权限结果」为准——无权限则同样不可播；若现网详情另有漏点，可随本次权限判断一并拦住，但不另开交互需求。未登录详情维持现状。