推荐操作路径
先检查服务，再处理链路，最后发布与审计。
- 健康检查：确认 BFF / 信令 / 数据库状态正常。
- 链路排查：先看会话，再看小程序扫码与授权状态。
- 内容发布：主题、广告、页面编辑完成后统一发布。
- 安全复盘：账号权限与审计日志回溯变更。
系统概览
按“连通检查 → 扫码链路 → 内容发布 → 审计复盘”完成全链路运维。
发布预检
发布前自动检查服务健康、控制台配置、目标资源可解析性。
数据库看板
返回最近会话、最近审计日志和 24h 汇总。
数据大屏
客户端实时数据总览与设备列表。
设备型号分布
区域分布
客户端列表
支持全量筛选与分页浏览。
| 用户 | 设备标识 | 设备 / 系统 | 网络信息 | 状态 / 活跃 | 启动 / 首次记录 |
|---|
第 1 页
区域看板
中国设备覆盖、省份分布、城市热度与运营建议。
总设备数
--
覆盖待统计
在线设备
--
--
离线设备
--
在线率 --
未知地区
--
占比 --
运行状态：加载中
中国设备分布
标准 ECharts 省级地图，按当前口径着色，点击省份可快速筛到设备列表。
打开区域看板后每 30 秒自动刷新
设备总量
暂无地图数据
区域分布排行
按当前口径排序，点击可联动到设备列表。
城市热度 Top10
按地区上报汇总城市热度。
区域运营建议
基于分布、活跃率和未知地区占比自动生成。
投屏会话
签发与解析两步完成。
签发会话
解析投屏码
会话列表查询
| 会话 ID | 房间 | 投屏码 | 状态 | 发送端设备 | 接收端设备 | 签发时间 | 更新时间 | 操作 |
|---|
第 1 页
小程序扫码登录
TV 端投屏前可选「扫码登录」鉴权，与微信小程序配合使用。
概览
电视端 App 已支持：
- 首页预登录：未登录时首页可展示小程序登录二维码，用户扫码后会话生效。
- 投屏前校验：开启鉴权后，用户点击「一键接收」时若未登录会先弹出登录二维码，扫码成功后自动开始投屏。
本页已收口扫码登录开关、小程序配置与 AppSecret，适合作为小程序登录工作台统一操作。
扫码登录开关
未开启
唯一编辑入口
这里是“小程序扫码登录 / 投屏前扫码鉴权”的统一开关入口。系统设置页仅保留状态展示，避免双入口混淆。
相关配置
控制台：GET/POST /api/console/system-settings 读取/保存投屏前扫码鉴权开关 authRequiredForCasting 与小程序配置 miniProgram；管理员可通过 POST /api/console/system-settings/miniprogram/secret 单独更新应用密钥 AppSecret。
小程序配置
应用密钥（AppSecret，仅管理员）
后端接口约定
需实现以下接口，TV 端才会拉取并展示登录二维码、轮询结果。
- POST /api/tv/auth/challenge
- 请求体：
deviceId、scene（home / cast）、ttlSec或ttlSeconds。响应：challengeId、pollToken、expiresAt、qrContent（挑战内容，仅作内部兼容字段）、qrImageBase64（优先直出图片）或qrImageUrl（小程序码图片 URL 兜底）。 - GET /api/tv/auth/challenge/{challengeId}/status
- Header 或 query 带
pollToken。响应：status（pending / confirmed / expired / cancelled）；confirmed 时返回authSessionToken、expiresAt。 - POST /api/mini/auth/token
- 小程序扫码页换取短期 broker token。请求体：
challengeId、pollToken。响应：token、expiresAt。 - POST /api/mini/auth/confirm
- 小程序侧确认登录回调。请求体：
challengeId、pollToken、userId（或 openId/unionId）；鉴权支持 broker token（兼容旧 mobile token）。响应：status=confirmed、authSessionToken。
小程序端在用户确认登录后需回调后端「确认该 challenge」，后端将 status 置为 confirmed 并返回会话信息，TV 轮询到后即视为登录成功。
主题配置
选择主题或自定义配色，一键应用。
启动广告
App 启动时的图片或视频广告，支持手机端与电视端分别配置。
广告配置
编辑广告素材与展示参数，保存后需发布才会生效。
发布运行态
将已保存配置发布到运行端，支持按酒店/设备灰度。
APK 热更新
版本发布、更新查询与操作步骤，一页完成。
发布热更新版本
--
数据库最近发布
正在读取数据库最近发布...
默认展示数据库最近发布；如果你已经开始编辑，系统不会自动覆盖当前输入。
查询最新版本
版本列表
| 版本 | 版本号 | 通道 | 目标 | 时间 | 操作 |
|---|
点击“回填”把历史版本填入发布表单，确认后再发布即完成回滚。
操作指南
1. 先上传 APK 到 HTTPS 地址（建议 CDN）；2. 在“发布热更新版本”填写版本信息并发布；3. 用“查询最新版本”核对返回数据；4. 客户端启动后会按 target/channel 自动检查更新。
账号管理
管理员维护账号、角色与状态。
新建账号
重置密码
账号列表
| 用户名 | 角色 | 状态 | 需改密 | 最近登录 | 创建时间 | 操作 |
|---|
审计日志
关键操作全量记录。
筛选
| 时间 | 操作人 | 动作 | 对象 | 结果 | IP |
|---|
第 1 页
系统设置
集中配置与账号信息。
移动端令牌
控制台登录
投屏登录开关
状态展示
扫码登录开关已移动到「小程序登录」页统一维护，这里仅展示当前状态，避免重复入口。
当前状态
--
操作入口
前往小程序登录
如需开启/关闭投屏前扫码登录，请到「小程序登录」页顶部操作。
高级设置（账号状态）
小程序配置摘要
小程序参数、应用密钥（AppSecret）与扫码登录开关已统一收口到「小程序登录」页维护。
账号信息
登录状态
--
账号
--
角色
--
认证来源
--
权限分级：管理员 / 运营 / 只读。角色由数据库字段 role 决定。
设置建议
- 先保存
MOBILE_API_TOKEN，再测试会话接口。 - 开启「投屏前扫码登录」时，必须保证小程序 AppID 与 AppSecret 可用。
- 建议高峰期前先做健康巡检，再执行发布操作。
健康监控
服务状态与运行指标。
健康详情
页面编辑
设计 TV 端首页布局，保存后可发布到运行态。