主题
评价大屏与组件
评价大屏用于 现场投屏：排名、进度、打分动态、维度分析等实时更新。与普通大屏共用同一套 编辑器、预览、发布 能力，但从 评价活动 入口创建与管理。
属性面板逐项说明
十六类组件的 内容 / 样式 / 数据 / 行为 配置项见 课堂评价组件 · 配置说明。下文侧重 创建入口、数据源、遥控与联动。
创建与进入
一键创建
- 活动须 已发布（有 API Key）。
- 概览 → 创建大屏 → 确认。
- 系统在新标签页打开编辑器，并：
- 写入
config.evalActivityId - 按模板 screen_preset 放置组件（默认含排行榜、进度、动态等）
- 自动创建数据源：
活动名称-排行榜、活动名称-进度、活动名称-动态 - 组件 绑定 对应数据源
- 写入
每个活动 只能关联一个大屏；已有关联时按钮变为 修改大屏。
修改与预览
| 入口 | 说明 |
|---|---|
| 修改大屏 | 新标签页编辑器；进行中可改布局与样式 |
| 预览大屏 | 新标签页预览；与发布页一样 实时更新 |
| 活动 已结束 | 仅 预览，不可再修改 |
评价大屏 不在「我的大屏」列表出现，请从活动详情进入。
组件库位置
编辑器左栏 组件 → 分组 课堂评价（需有组件使用权限）。
拖入或点击添加时，若当前大屏已关联活动，组件 自动填写 activityId / apiKey，无需手填密钥。
属性 数据 分段 → 评价数据 下拉选择活动（一般保持默认关联活动即可）。
现场遥控
活动 详情 或列表操作列进入 遥控 页，用于现场控制投屏大屏（须已关联大屏）。
完整操作说明、SSE 事件、权限与常见问题见 大屏遥控。
| 区域 | 能力 |
|---|---|
| 切页 | 切换候场 / 进行中 / 揭晓等页面（SSE 同步预览与发布页；优先于自动切 live） |
| 定焦点 | 点选评分对象，联动聚光灯/雷达等 |
| 刷新排行榜 | 强制全量重排并推送 snapshot |
| 揭晓 Top3 | 选择目标页后揭晓前三名，触发颁奖台/聚光特效 |
| 扫码通道 | 切换 primary / backup / lan，扫码组件即时重绘 |
| 答辩倒计时 | 暂停、继续、重置、+30s / +1min |
| 对象与评委 / 活动设置 | 现场维护名单与规则（与详情 Tab 复用） |
| 生命周期 | 开始 / 暂停 / 恢复 / 结束 |
三页叙事 preset
一键建屏默认三页：
| 页面 | pageKey | 典型内容 |
|---|---|---|
| 候场 | eval_lobby | 头图、倒计时、扫码 |
| 进行中 | eval_live | 排行榜、动态、雷达 |
| 揭晓 | eval_finale | 颁奖台、聚光灯、Top3 |
答辩/路演/互评等模板可能使用不同 preset 名称，逻辑相同。
十六类评价组件说明
各组件 属性面板 完整字段见 课堂评价组件。以下为场景速览：
氛围与流程
| 组件 | 要点 |
|---|---|
| 活动头图 | 标题/状态/Logo；切页转场 |
| 答辩倒计时 | 与遥控倒计时同步 |
| 扫码打分 | 二维码入口；暂停/结束锁定 |
| 评委展示 | 评委头像与打分进度 |
1. 评分排行榜（evalLeaderboard）
| 配置项 | 说明 |
|---|---|
| 标题 / 颜色 | 样式分段 |
| 显示条数 | 默认 Top 10 |
| 头像 / 分数 / 趋势 | 是否展示 |
| 高亮前几名 | 前三名样式 |
| 联动 | 开启后点击行写入 evalTargetId |
| 排名动画 | 名次变化 ▲▼ 与过渡 |
| 刷新间隔 | 预览/发布下随活动进度自动更新；编辑器内不持续刷新 |
数据：绑定 …-排行榜 或 rankings 端点。
2. 评分进度（evalProgress）
| 配置项 | 说明 |
|---|---|
| 视图模式 | 总体 / 按角色 / 按对象 |
| 显示数量 | 是否展示已评人数 |
| 活动状态文案 | 暂停/结束等提示 |
数据：progress 端点。
3. 实时动态（evalFeed）
| 配置项 | 说明 |
|---|---|
| 样式 | 滚动列表等 |
| 显示评委 / 评语 | 匿名活动时显示「匿名评委」 |
| 最大条数 | 列表上限 |
| 自动滚动 | 新消息滚屏 |
数据：实时动态列表；网络短暂中断时会自动补拉最新记录。
4. 维度雷达图（evalRadar）
| 配置项 | 说明 |
|---|---|
| 模式 | 单对象 / 多对象对比 |
| 评分对象 | 下拉选择；留空取榜首或联动 |
| 维度映射 | 自定义轴名与满分 |
| 跟随联动 | 读取 evalTargetId 切换对象 |
| 样式 | 轴名/分数/图例字号；全场均线 |
数据：rankings 中对象的 dimensionScores。
8～16. 其它新增组件
| 组件 | 用途 |
|---|---|
| 颁奖台 | Top3 展示与揭晓特效 |
| 聚光灯 | 当前对象聚焦 |
| 打分弹条 | 实时打分提示条 |
| 进度环 | 环形完成度 |
| 评语墙 | 评语滚动墙 |
5. 维度对比柱图（evalDimensionBar）
| 配置项 | 说明 |
|---|---|
| 对比模式 | 多对象 / 按维度 |
| 布局 | 横向 / 纵向 |
| 平均线 | 可选 |
数据：rankings；可跟随联动高亮当前对象。
6. 评分热力图（evalHeatmap）
- 行：对象；列：维度；色深表示分数。
- 数据：rankings 矩阵。
7. 评语词云（evalCommentCloud）
- 展示评语高频词。
- 数据：tags 端点（词频）；绑定
…-动态不适用，需 tags 或单独 eval-api。
组件联动（手把手）
适用于 排行榜 + 雷达/柱图 同屏：
- 选中 排行榜 → 属性 内容 → 开启 联动。
- 选中 雷达图 → 开启 跟随联动。
- 预览/发布：点击排行榜某一行，雷达图切换为该对象的维度分。
联动变量为全局 evalTargetId（预览页 数据联动 机制）。
数据源
自动创建的三条
| 名称示例 | 端点 | 用途 |
|---|---|---|
| 答辩专场-排行榜 | rankings | 排行榜、雷达、柱图、热力图 |
| 答辩专场-进度 | progress | 进度组件 |
| 答辩专场-动态 | feed | 实时动态 |
手动添加
编辑器 → 数据源 → 课堂评价 API → 选活动 → 选端点（含 tags 词频）。
详见 数据源 · 课堂评价 API。
评价大屏 vs 普通大屏
- 评价大屏：数据源面板 只显示本活动 的 eval-api。
- 普通大屏：可看到您可编辑的全部大屏下的数据源，可复用同活动 rankings 绑到 标准柱状图 等（自动格式转换）。
画布上的数据源标签
工具栏 数据库图标（网格/吸附旁）可开关：组件右下角显示 已绑定数据源名称（随主题色）。
标准图表绑定评价数据
折线图、柱状图等 非 eval 专属组件 也可绑定课堂评价 API：
- 绑定 rankings / progress / tags 等数据源。
- 未填 dataPath 时按 消费端点 自动补全。
- 数据格式 自动转换 为图表所需结构。
绑定后 数据 分段隐藏静态 JSON 编辑，避免与接口数据混淆。
实时刷新
| 环境 | 行为 |
|---|---|
| 预览 / 发布页 | 打分、排名、进度变化时 自动刷新 组件 |
| 编辑器 | 进入时加载 一次 最新数据，便于排版（不持续刷新） |
| 活动结束 | 展示 最终结果，排名不再变化 |
发布对外展示
与普通大屏相同：
- 编辑器 → 发布 → 配置密码/过期/适配模式。
- 生成 公开链接 或二维码，用于现场投屏。
- 现场展示请优先使用 发布链接 或活动详情中的 预览大屏，以保证排行榜与动态及时更新。
若长时间不更新，请联系 系统管理员 排查（用户无需自行配置服务器）。
见 预览与发布。
装修建议
| 区域 | 建议 |
|---|---|
| 主视觉 | 排行榜居中放大，开启联动 |
| 副屏 | 雷达 + 进度左右分栏 |
| 底部 | 实时动态滚动 |
| 结束阶段 | 切到冻结排名页，隐藏动态或改文案 |