From 7d851b39e8e9bd3053c74fc4721e960e6742137c Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Sun, 17 May 2026 22:38:05 +0800
Subject: [PATCH 01/17] feat(production): add big screen overview API

---
 .../synapse-production-big-screen-tasks.md    |  414 +++++++
 docs/designs/synapse-production-big-screen.md | 1024 +++++++++++++++++
 internal/api/handlers/production_dashboard.go |  610 +++++++++-
 .../api/handlers/production_dashboard_test.go |   70 +-
 4 files changed, 2115 insertions(+), 3 deletions(-)
 create mode 100644 docs/designs/synapse-production-big-screen-tasks.md
 create mode 100644 docs/designs/synapse-production-big-screen.md

diff --git a/docs/designs/synapse-production-big-screen-tasks.md b/docs/designs/synapse-production-big-screen-tasks.md
new file mode 100644
index 0000000..fa6d33d
--- /dev/null
+++ b/docs/designs/synapse-production-big-screen-tasks.md
@@ -0,0 +1,414 @@
+<!--
+SPDX-FileCopyrightText: 2026 ArcheBase
+
+SPDX-License-Identifier: MulanPSL-2.0
+-->
+
+# Synapse 生产大屏任务拆解
+
+**Scope:** Keystone `worktree2` 与 Synapse `worktree2` 后续开发任务
+
+## 1. 目的
+
+本文档把 `synapse-production-big-screen.md` 中的设计和技术方案拆成可执行开发任务。它不重复设计愿景，只定义开发顺序、依赖关系、修改范围、验收标准和推荐 PR 切分。
+
+后续开发应同时参考：
+
+- `docs/designs/synapse-production-big-screen.md`
+- 本任务拆解文档
+
+## 2. 拆分原则
+
+- 先数据契约，再前端数据层，再页面布局，最后动画和验收。
+- 每个任务尽量能独立验证，避免一个 PR 同时大改后端、数据层、布局和动画。
+- 第一版以 MVP 为目标，不新增告警表，不做独立告警栏，不做视频转码服务，不引入 WebSocket 和重型动画库。
+- 前端优先消费聚合 API；只有 API 不可用或字段暂缺时使用集中 fallback。
+- 改动优先复用现有文件和模式，避免新建过多平行体系。
+
+## 3. 推荐 PR 切分
+
+| PR | 任务 | 仓库 | 是否阻塞后续 | 目标 |
+|---|---|---|---|---|
+| PR-1 | 后端 overview 聚合 API | `keystone-worktree2` | 是 | 建立大屏数据契约 |
+| PR-2 | 前端 overview 数据层 | `synapse-worktree2` | 是 | 建立 API client、adapter、fallback |
+| PR-3 | 大屏响应式基础布局 | `synapse-worktree2` | 是 | 页面能展示完整数据区域 |
+| PR-4 | Video Flight Stage MVP | `synapse-worktree2` | 否 | 实现预览轮播状态机和 fallback |
+| PR-5 | 图表、设备、任务流打磨 | `synapse-worktree2` | 否 | 补齐生产指挥中心信息密度 |
+| PR-6 | 电视视口和稳定性验收 | `synapse-worktree2`，必要时 `keystone-worktree2` | 否 | 修正响应式、性能和边界问题 |
+
+如果需要更快出第一版展示，PR-3 可以先接 mock/fallback 数据并与 PR-2 并行，但最终必须回到 overview API 契约。
+
+## 4. 任务清单
+
+### T1. 后端 overview API 契约与基础响应
+
+**仓库:** `keystone-worktree2`
+
+**目标:** 在现有 `ProductionDashboardHandler` 中新增面向大屏的 `GET /api/v1/production/dashboard/overview`。
+
+**依赖:** 无。
+
+**建议修改范围:**
+
+- `internal/api/handlers/production_dashboard.go`
+- `internal/api/handlers/production_dashboard_test.go`
+- `docs/docs.go`、`docs/swagger.*`，如果项目要求同步 Swagger
+
+**实现要点:**
+
+- 复用现有 `resolveProductionDashboardScope()`、查询参数解析、只读事务和 scope 过滤。
+- 新增 overview response structs。
+- 第一版返回完整结构，即使部分数组为空。
+- `summary`、`trend`、`task_status_distribution`、`devices`、`recent_tasks` 优先实现。
+- 第一版不返回独立 `alerts` 字段，不建设告警栏；设备离线、任务失败、接口降级等异常内联展示在顶部状态、设备状态和任务流中。
+- `previews.video_url` 可以为空，但如果非空必须是真实可播放视频 URL；为空时返回 episode/task 元信息和可解析的 `preview_url`，保证前端可复用数据预览页播放 MCAP 图像帧。
+
+**验收标准:**
+
+- `GET /api/v1/production/dashboard/overview` 需要 JWT，允许 `admin` 和 `data_collector`。
+- `data_collector` 自动限定到绑定工位。
+- 空数据返回 200，数值为 0，数组为空。
+- 参数错误返回 400，未认证返回 401。
+- 响应包含 `generated_at`、`scope`、`summary`、`trend`、`task_status_distribution`、`quality`、`devices`、`recent_tasks`、`previews`。
+- `previews.video_url` 为空时仍有 `title`、`task_name`、`robot_name`、`station_name`、`status`、`created_at`；有 MCAP 时返回 `preview_url`；`video_url` 非空时必须是真实可播放视频。
+
+**验证命令:**
+
+```bash
+go test ./internal/api/handlers/... -run ProductionDashboard -v
+gofmt -w internal/api/handlers/production_dashboard.go internal/api/handlers/production_dashboard_test.go
+```
+
+**风险:**
+
+- 今日任务和全量任务口径容易混淆；接口字段名必须明确。
+- 设备在线率需要确认规则，第一版可以沿用 workstation status。
+
+### T2. 后端 overview 查询补齐
+
+**仓库:** `keystone-worktree2`
+
+**目标:** 在 T1 基础上补齐更有展示价值的字段，不引入新表。
+
+**依赖:** T1。
+
+**建议修改范围:**
+
+- `internal/api/handlers/production_dashboard.go`
+- `internal/api/handlers/production_dashboard_test.go`
+
+**实现要点:**
+
+- `trend` 增加 `failed`。
+- `devices.items` 增加 `current_task`、`station_name`、`last_seen_at`，字段缺失时返回空字符串。
+- `recent_tasks` 覆盖最近完成、失败、进行中的任务。
+- `quality.recent_failures` 如果查询成本可控则实现，否则保留空数组。
+
+**验收标准:**
+
+- overview 中 `trend` 每个点包含 `completed`、`in_progress`、`pending`、`failed`。
+- `recent_tasks` 按最近更新时间倒序，受 `recent_limit` 限制。
+- 所有 limit 参数有上限，避免大屏接口返回过大。
+
+**验证命令:**
+
+```bash
+go test ./internal/api/handlers/... -run ProductionDashboard -v
+go test ./... ./cmd/keystone-edge/...
+```
+
+**风险:**
+
+- `sync_logs` 或 episode join 较复杂时，异常状态可以先只通过任务流和设备状态表达，避免阻塞前端。
+
+### T3. 前端 overview API client 与数据 adapter
+
+**仓库:** `synapse-worktree2`
+
+**目标:** 增加前端大屏数据入口，优先消费 overview API。
+
+**依赖:** T1，或临时使用 mock 契约并在 T1 合入后对齐。
+
+**建议修改范围:**
+
+- `src/api/productionDashboard.js`
+- `src/features/production/useProductionBigScreenData.js`
+- 可选：`src/features/production/productionBigScreenMock.js`
+
+**实现要点:**
+
+- `useProductionDashboardApi()` 增加 `overview(params)`。
+- 新增 composable 管理 `loading`、`error`、`lastUpdatedAt`、`usingFallback`、`overview`。
+- adapter 统一补默认值，避免模板写大量空值判断。
+- API 失败时保留上一份成功数据；无历史数据时使用集中 mock fallback。
+- 定时刷新默认 15s 或 30s，后续可配置。
+
+**验收标准:**
+
+- API 成功、失败、空数据均返回稳定的数据结构。
+- fallback 数据集中定义，不散落在 Vue 模板。
+- composable `onUnmounted` 时清理 polling timer。
+- 不打断 Video Flight Stage 当前播放状态，数据层只更新队列数据。
+
+**验证命令:**
+
+```bash
+npm run build
+```
+
+**风险:**
+
+- 真实 API 字段和 mock 字段不一致会造成返工；adapter 必须成为唯一入口。
+
+### T4. 大屏响应式基础布局
+
+**仓库:** `synapse-worktree2`
+
+**目标:** 改造 `/admin/dashboard` 对应页面，建立生产指挥中心基础布局。此阶段先不追求复杂视频动画。
+
+**依赖:** T3。
+
+**建议修改范围:**
+
+- `src/views/FullscreenDashboard.vue`
+- 可选：`src/components/production/BigScreenKpiStrip.vue`
+- 可选：`src/components/production/BigScreenStatusRail.vue`
+- 可选：`src/components/production/BigScreenTaskFeed.vue`
+- 可选：`src/components/production/BigScreenTrendPanel.vue`
+- `src/styles/dashboard-light.css` 或新建大屏专用 CSS 文件
+
+**实现要点:**
+
+- 保留 `/admin/dashboard` 路由。
+- 建立顶部状态栏、KPI、中央舞台占位、趋势、设备状态和任务流；不设置独立告警栏。
+- 使用 CSS Grid、Flexbox、`clamp()`、`minmax()`、`aspect-ratio`。
+- 核心 KPI 和视频舞台在所有断点优先展示。
+- `1366x768` 下可减少列表条数，但不能横向滚动或文字重叠。
+
+**验收标准:**
+
+- `1920x1080` 下首屏能看到 KPI、中央舞台、设备健康和异常状态。
+- `3840x2160` 下内容不显得过小或过空。
+- `1366x768` 下不横向滚动，不出现明显文字重叠。
+- 没有视频数据时中央舞台显示稳定占位。
+
+**验证命令:**
+
+```bash
+npm run build
+```
+
+**手动检查视口:**
+
+- `3840x2160`
+- `2560x1440`
+- `1920x1080`
+- `1600x900`
+- `1366x768`
+
+**风险:**
+
+- 如果一次拆太多组件，会增加 PR 审查成本；优先按职责拆少量组件。
+
+### T5. Video Flight Stage MVP
+
+**仓库:** `synapse-worktree2`
+
+**目标:** 实现视频/预览轮播舞台状态机和克制飞行动效。
+
+**依赖:** T3、T4。
+
+**建议修改范围:**
+
+- `src/components/production/VideoFlightStage.vue`
+- `src/views/FullscreenDashboard.vue`
+- 大屏相关 CSS
+
+**实现要点:**
+
+- 状态机：`loading`、`entering`、`playing`、`leaving`、`error`。
+- 只播放当前条目；带真实 `video_url` 时使用 `<video>`，无 `video_url` 但有 `preview_url` 时复用数据预览页 MCAP reader 播放图像帧。
+- 轮播按媒体槽位实现：`preview item` 只代表业务数据，`media slot` 才持有 `<video>`、MCAP reader、object URL 和播放时间轴。
+- 当前条进入播放后，只准备队列中的下一条，不做多条前瞻预载，也不维护播放器池。
+- MCAP 正常切换时，旧 current 如果仍在轮播队列中，可以进入有上限的 warm handoff cache；下一次成为 next 时按稳定 `media_identity` 直接复用，避免短队列反复重新 presign、读取 metadata 和起播帧。
+- next slot 生命周期为 `idle -> preparing -> armed -> activating -> current`；`activating` 只能交换槽位所有权，不能重新设置 `src`、不能 `load()`、不能 seek 到 0。
+- next 的 armed 条件必须明确：真实视频完成 metadata 和首帧准备，并具备可平滑起播的缓冲或触发 `canplaythrough`；MCAP 完成 presign、metadata、图像 topic 选择和有上限的起播帧窗口准备；poster 图片完成 `load`。
+- 使用稳定 `media_identity` 判断资源是否变化；不能把带签名、过期时间、token 或随机数的完整访问 URL 当作媒体身份。
+- overview 刷新时，current `media_identity` 未变化不得重置当前播放；next `media_identity` 未变化继续保留准备状态，变化时取消旧 next 并准备新 next。
+- 当前条播放结束后先检查 next ready 状态；若未 ready，current 停在最后一帧或最后一张 MCAP 帧，不清空舞台。
+- 从 current 结束起最多等待 next 10 秒；10 秒内 next ready 则切换，10 秒后仍未 ready 则从头重播 current，并继续准备同一个 next。
+- 真实视频 next 只能静默预载，不能调用 `play()`，不能产生声音；切换后直接激活已准备好的 media slot 播放。
+- `replay current` 是唯一允许 seek 到 0 的路径，只能用于 next 等待 10 秒仍未 armed 后的当前条重播。
+- MCAP next 准备阶段只读取 metadata 和有上限的起播帧窗口，armed 后可后台补齐剩余有限帧；warm handoff cache 也必须有数量上限，不得无上限缓存大量帧。
+- MCAP 播放不得用取模循环反复播放开头帧；到达当前已准备帧序列末尾时，如果补齐仍在进行则停最后一帧等待，补齐失败或等待超时后进入 next 检查。
+- `video_url` 缺失且 MCAP 不可用时才使用 `poster_url` 或轻量等待状态，主舞台不显示大段任务文字。
+- `video_url` 非空时必须是真实可播放视频 URL，不能使用 MCAP presigned URL、poster、内部对象路径或 mock URL 冒充。
+- 动画使用 `transform`、`opacity`、低强度 `filter` 和 `perspective`。
+- 支持 `prefers-reduced-motion`，小屏或 reduced motion 下使用淡入淡出。
+- 舞台固定 `aspect-ratio`，动画不改变周边布局。
+
+**验收标准:**
+
+- 有真实 `video_url` 时可以飞入、播放、结束后飞出并切换下一条。
+- 无 `video_url` 但有 `preview_url` 时可以自动播放 MCAP 图像帧；不渲染 `<video>`，但舞台必须有真实视觉内容。
+- 从第二条开始，当前条播放期间应已经开始准备 next media slot；网络正常时不应出现明显黑屏、长时间加载或大段文字占位。
+- 下一条未 ready 时不应强切空白舞台，应保留当前最后画面最多 10 秒；仍未 ready 时重播当前条。
+- 已 armed 的真实视频 next 激活时不应重复播放开头帧；激活过程不得重建播放器、重设 `src` 或主动 seek 到 0。
+- 预载失败不影响当前播放；轮到该条时进入正常播放/降级链路。
+- 视频错误进入 `error` fallback，并继续后续轮播。
+- 数据刷新不重置当前播放状态。
+- 组件卸载时清理 timer、current/next video listeners、hidden next video、current/next/warm cache MCAP reader 相关消息状态和 object URL。
+
+**验证命令:**
+
+```bash
+npm run build
+```
+
+**风险:**
+
+- 电视浏览器自动播放限制；第一版只对真实视频默认 muted autoplay，失败时优先降级到 MCAP 图像帧，再退回 poster / 轻量等待状态。
+
+### T6. 图表、设备、任务流打磨
+
+**仓库:** `synapse-worktree2`
+
+**目标:** 将大屏从“可展示布局”打磨为有信息密度的生产指挥中心。
+
+**依赖:** T3、T4，可与 T5 部分并行。
+
+**建议修改范围:**
+
+- `src/components/production/BigScreenTrendPanel.vue`
+- `src/components/production/BigScreenStatusRail.vue`
+- `src/components/production/BigScreenTaskFeed.vue`
+- `src/features/production/chartTheme.js`
+- 大屏相关 CSS
+
+**实现要点:**
+
+- 趋势图复用 ECharts，更新时复用实例。
+- 设备状态清楚区分 online、idle、busy、offline、abnormal。
+- 任务流显示最近任务，不做后台表格。
+- 异常状态内联展示在顶部状态、设备状态和任务流中，不新增告警栏。
+- 图表和列表不抢中央舞台视觉中心。
+
+**验收标准:**
+
+- `trend`、`devices`、`recent_tasks` 和质量/异常状态均能正常展示。
+- 图表 resize 正常，组件卸载时 dispose。
+- 任务流和设备列表数量受限，不造成小屏溢出。
+- API 失败时有可见降级提示。
+
+**验证命令:**
+
+```bash
+npm run build
+```
+
+**风险:**
+
+- ECharts 在容器尺寸变化时可能计算错误；需要在 mounted、nextTick、resize 后统一 resize。
+
+### T7. 电视视口与性能验收
+
+**仓库:** `synapse-worktree2`，必要时 `keystone-worktree2`
+
+**目标:** 对大屏在目标视口和长时间运行场景下做收尾修正。
+
+**依赖:** T4、T5、T6。
+
+**建议修改范围:**
+
+- 大屏相关 Vue/CSS
+- `useProductionBigScreenData.js`
+- 后端 overview limit 或字段，如果发现接口返回过大
+
+**实现要点:**
+
+- 检查目标视口：`3840x2160`、`2560x1440`、`1920x1080`、`1600x900`、`1366x768`。
+- 检查横向滚动、文字重叠、视频舞台被挤压、图表空白。
+- 检查 timer、resize listener、fullscreen listener、chart instance、current/next video listeners、hidden next video、MCAP reader 和 object URL 的释放。
+- 检查轮播资源上限：连续运行时只保留 current + next，hidden video / MCAP reader / object URL 数量不随轮播无限增长。
+- 检查下一条未 ready 场景：不应黑屏离场，应冻结当前最后画面最多 10 秒；仍未 ready 时重播当前条。
+- 检查 API 失败、空数据、真实视频失败、无视频 URL。
+- 必要时减少小屏列表条数或降低动画强度。
+
+**验收标准:**
+
+- 所有目标视口无明显布局问题。
+- `npm run build` 通过。
+- 页面刷新和轮播不会造成明显闪烁。
+- 长时间运行没有明显内存泄漏风险点。
+
+**验证命令:**
+
+```bash
+npm run build
+```
+
+**风险:**
+
+- 不同电视浏览器对 CSS filter、autoplay、fullscreen 支持不同；需要保留降级路径。
+
+## 5. 跨任务依赖
+
+```text
+T1 -> T3 -> T4 -> T5 -> T7
+T1 -> T2 -> T3
+T4 -> T6 -> T7
+```
+
+说明：
+
+- T1 是前端稳定接入的基础。
+- T2 可以在 T3 后继续增强，只要 overview response 结构稳定。
+- T4 可以先用 T3 fallback 数据推进，但合入前应对齐真实 overview。
+- T5 和 T6 可以并行，但都依赖 T4 的基础布局区域。
+
+## 6. 第一版 MVP 定义
+
+第一版 MVP 至少完成：
+
+- T1：后端 overview API 基础响应
+- T3：前端 overview 数据层和 fallback
+- T4：大屏响应式基础布局
+- T5：Video Flight Stage MVP
+
+MVP 可以暂缓：
+
+- T2 中复杂 `quality.recent_failures` 查询
+- T6 中更细的图表和信息密度打磨
+- T7 中非基础视口的细节优化
+
+MVP 不应暂缓：
+
+- API 失败 fallback
+- 无真实视频时的 MCAP 图像帧播放与 poster fallback，且不能伪装成 `<video>` 播放
+- `1920x1080` 与 `1366x768` 的基本可读性
+- timer/listener/chart/video cleanup
+
+## 7. 后续开发提示词建议
+
+后续让编码助手开发时，建议按任务编号发起，例如：
+
+```text
+请根据 docs/designs/synapse-production-big-screen.md 和
+docs/designs/synapse-production-big-screen-tasks.md，先实现 T1。
+只修改 keystone-worktree2，新增 /production/dashboard/overview 聚合 API。
+不要实现前端，不要新增告警表，不要实现告警栏，不要做视频转码服务。
+完成后运行 gofmt 和受影响 handler 测试。
+```
+
+每次只实现 1 到 2 个任务，避免一个 PR 过大。
+
+## 8. 待确认后再开发的问题
+
+这些问题不阻塞 T1/T3/T4，但会影响后续打磨：
+
+- `video_url` 真实来源是否存在；若不存在，第一版必须使用 `preview_url` 的 MCAP 图像帧播放，不得伪造 `<video>` 播放。
+- 设备在线率以 workstation status、robot status、连接 hub，还是最后心跳为准。
+- 大屏是否允许 data_collector 访问，还是只给 admin/只读展示账号。
+- 生产现场默认刷新频率。
+- 异常状态在顶部状态、设备状态和任务流中的展示阈值。
+- 是否需要参观模式脱敏任务 ID、设备 ID 或客户信息。
diff --git a/docs/designs/synapse-production-big-screen.md b/docs/designs/synapse-production-big-screen.md
new file mode 100644
index 0000000..6585cf2
--- /dev/null
+++ b/docs/designs/synapse-production-big-screen.md
@@ -0,0 +1,1024 @@
+<!--
+SPDX-FileCopyrightText: 2026 ArcheBase
+
+SPDX-License-Identifier: MulanPSL-2.0
+-->
+
+# Synapse 生产大屏设计与技术方案
+
+**Scope:** Keystone production-dashboard 聚合 API 与 Synapse 生产大屏页面
+
+## 1. 背景与目标
+
+Synapse 生产大屏用于机器人数据生产现场的常驻展示，也用于客户参观和管理层查看生产状态。页面运行在电视或大屏显示器上，核心目标设备是 100 寸横屏电视，但不能只为单一尺寸写死布局；它还需要支持 55、65、75、85 寸电视以及常见桌面大屏。
+
+这不是营销页、静态海报、普通后台 dashboard，也不是对现有后台页面做简单换色。它应该是一个真实运行的生产指挥中心：
+
+- 一眼看到今日生产状态、任务进展、设备在线情况、质检结果和异常状态。
+- 远距离可以读清核心 KPI、状态和异常。
+- 有客户参观时的展示价值，但动效必须服务生产数据展示。
+- 页面可以长期运行，定时刷新稳定，不因为数据刷新或视频轮播造成抖动。
+- 前端优先消费后端聚合 API，避免分散调用多个 CRUD 接口后在页面里拼数据。
+
+当前代码现状：
+
+- Keystone 已有 `internal/api/handlers/production_dashboard.go`，注册在 `/api/v1/production/dashboard`，提供 `GET /snapshot` 和 `GET /batches/:id/task-summary`。
+- Synapse 已有 `src/api/productionDashboard.js`，封装 `/production/dashboard/snapshot` 和批次任务摘要。
+- Synapse 已有 `src/features/production/useDashboardData.js`，将 snapshot 映射为统计、趋势、质量、工位、活跃批次和活跃任务。
+- Synapse 管理端 `/admin/dashboard` 当前使用 `src/views/FullscreenDashboard.vue`，普通生产页使用 `src/views/ProductionDashboard.vue`。
+- 数据预览能力目前主要来自 `episodes` 相关 API 和 MCAP 预览页面，包括 `GET /api/v1/episodes/:id/presign`、`src/views/DataPreview.vue` 和 `src/features/inspector/useMcapReader.js`。当前没有面向大屏视频轮播的直接 `video_url` 契约。
+
+### 1.1 第一版落地边界
+
+第一版应先完成“可展示、可运行、可维护”的大屏，不追求一次性建设完整实时指挥系统。
+
+必须做：
+
+- 复用现有 dashboard、episode、task、station、sync 数据，提供一个面向大屏的聚合响应。
+- 改造现有 `/admin/dashboard` 对应的大屏页面，而不是另起一套和当前系统割裂的展示应用。
+- 实现响应式大屏布局，保证 `1920x1080` 是基础验收尺寸，并兼顾 4K 与较小横屏。
+- 实现 Video Flight Stage 的状态机和 fallback；优先播放真实可播放 `video_url`，缺失时复用数据预览页能力从 `preview_url` 读取 MCAP 图像帧并自动轮播，仍不得把 MCAP URL 冒充成 `<video>`。
+- 保留 API 失败、视频失败、空数据情况下的稳定展示。
+
+第一版不做：
+
+- 不新增告警表、告警确认流、复杂告警闭环或独立告警栏。
+- 不建设 MCAP 转 MP4、服务端抽帧、缩略图生成等视频加工服务；只预留 `video_url` / `poster_url` / `preview_url` 契约，并在前端复用现有数据预览读取能力。
+- 不使用 mock URL、MCAP URL、poster 或静态占位冒充 `video_url`；`video_url` 非空时必须是真实可播放的视频资源。
+- 不引入 WebSocket 实时推送，先使用定时刷新聚合 API。
+- 不引入 Three.js、复杂 3D 场景或重型动画库。
+- 不重做全站设计系统，只在大屏范围内定义必要的大屏样式。
+- 不把大屏做成可配置 BI 或报表搭建器。
+
+## 2. 用户与观看场景
+
+### 2.1 观看者
+
+| 观看者 | 关注点 | 大屏表达重点 |
+|---|---|---|
+| 管理者 | 今日产能、完成率、失败率、设备利用情况 | KPI、趋势、异常设备 |
+| 客户 | 生产过程是否专业可信，机器人数据生产是否可视化 | 中央视频舞台、生产流、整体视觉品质 |
+| 现场操作人员 | 当前任务、工位状态、设备异常 | 任务流、设备状态 |
+| 运维或生产负责人 | 系统是否稳定，失败是否需要处理 | 同步状态、失败任务、设备离线、刷新时间 |
+
+### 2.2 设备与观看距离
+
+目标视口必须覆盖：
+
+- `3840x2160`：4K 大屏，内容要自然扩展，不能显得太小或过空。
+- `2560x1440`：中高分辨率电视或显示器，保持完整大屏体验。
+- `1920x1080`：基础验收尺寸，页面必须完整、美观、无遮挡。
+- `1600x900`：紧凑横屏，信息密度降低但核心内容保留。
+- `1366x768`：小电视或窗口化调试场景，不重叠、不横向滚动、不丢核心 KPI 与视频舞台。
+
+观看距离越远，越要优先显示高对比、强层级、少文字的核心信息。小尺寸电视可以压缩次要列表数量，但不能移除核心 KPI、视频舞台、设备健康和异常状态。
+
+## 3. 页面信息架构
+
+建议页面围绕“顶部状态栏 + KPI + 中央 Video Flight Stage + 两侧/底部运营面板”组织。
+
+### 3.1 顶部状态栏
+
+职责：建立页面身份、系统状态和数据新鲜度。
+
+内容：
+
+- `Synapse 生产指挥中心`
+- 当前日期时间，秒级更新
+- 系统状态：运行中、数据同步中、接口异常、降级展示
+- 在线设备摘要：机器人在线数 / 总数，工位在线数 / 总数
+- 今日生产摘要：今日任务、完成、失败
+- 数据刷新时间：`generated_at` 或前端最后成功刷新时间
+
+### 3.2 核心 KPI
+
+职责：远距离快速读数。
+
+首屏必须展示：
+
+- 今日任务数
+- 已完成任务数
+- 进行中任务数
+- 待处理任务数
+- 失败任务数
+- 合格率
+- 机器人在线率
+- 活跃批次数或活跃工位数
+
+KPI 文案应短，数字应使用 tabular numbers。数字刷新可以轻微计数，但刷新不得导致卡片尺寸变化。
+
+### 3.3 中央 Video Flight Stage
+
+职责：成为页面视觉中心，展示生产数据预览。
+
+内容：
+
+- 视频/预览轮播舞台
+- 当前预览的任务名称、机器人、工位、状态、时间
+- episode/task 标识
+- 加载、真实视频播放、MCAP 图像帧预览、错误、空数据 fallback
+
+舞台不应只是普通视频播放器。它需要用克制的空间动效表达“生产数据流正在进入系统”。当没有真实 `video_url` 时，舞台优先读取 `preview_url` 对应的 MCAP 图像/压缩图像 topic，按帧自动播放；只有 MCAP 不可用时才退回 poster 或轻量空状态，避免在主舞台显示大段 episode/task 文本。
+
+### 3.4 生产趋势
+
+职责：展示产能或任务状态变化。
+
+可选图表：
+
+- 最近 7 天任务完成趋势
+- 最近 N 个时间窗口的 completed / in_progress / pending / failed
+- 质检通过率趋势
+- 生产数据量趋势
+
+当前项目已有 ECharts 使用方式，后续实现应复用现有 ECharts 初始化、更新、resize、dispose 模式。
+
+### 3.5 设备状态
+
+职责：快速发现设备在线、空闲、忙碌、离线、异常。
+
+内容：
+
+- 在线 / 空闲 / 忙碌 / 离线 / 异常汇总
+- 若干关键机器人或工位条目
+- 当前任务、绑定工位、最近心跳或最后活跃时间
+
+状态颜色应明确但不刺眼。异常要醒目，健康状态要稳定。
+
+### 3.6 最近任务流
+
+职责：呈现生产现场“正在发生什么”。
+
+内容：
+
+- 最近开始、完成、失败的任务
+- 当前批次任务
+- 任务状态、机器人、工位、批次、耗时
+
+任务流应避免普通后台表格感，建议使用紧凑事件流或生产流水线样式。
+
+### 3.7 异常与降级状态
+
+第一版不设置独立告警栏，也不新增告警表。异常状态应内联展示在已有区域中，避免额外占用大屏主布局：
+
+- 顶部状态栏：展示 API 正常、降级展示、数据同步失败等全局状态。
+- 设备状态区：直接标记离线、异常或长时间无心跳的工位/设备。
+- 最近任务流：直接突出失败、取消、质检不通过等任务状态。
+- 质量区域：展示合格率、待检和失败数量。
+
+没有异常时不额外展示“无告警”面板；相关区域保持正常生产数据展示。
+
+## 4. 视觉设计方向
+
+### 4.1 整体气质
+
+视觉方向：高级、克制、工业生产大屏。
+
+应该体现：
+
+- 机器人生产系统
+- 数据可信、可监控
+- 现场长期运行稳定
+- 客户参观时有吸引力
+
+避免：
+
+- 廉价科幻风
+- 过度霓虹
+- 紫色模板
+- 满屏发光卡片
+- 动画抢走数据注意力
+- 营销页式 hero 结构
+
+### 4.2 背景与层次
+
+建议背景为深色或沉稳冷灰基底，叠加非常轻的网格、扫描线或工业仪表纹理。背景不能影响文字可读性，不使用大面积发光团块。
+
+层次建议：
+
+- 背景层：低对比工业质感，保持暗部稳定。
+- 主舞台层：中央视频区域，拥有最强视觉权重。
+- 数据面板层：边栏和底部信息块，边界清晰但不厚重。
+- 状态层：异常、刷新、系统状态，用小面积高对比色。
+
+### 4.3 色彩与状态
+
+建议沿用现有品牌蓝和中性色变量，但为大屏定义清晰的状态语义：
+
+| 状态 | 建议语义 | 使用限制 |
+|---|---|---|
+| 成功 / 在线 / 已完成 | 低饱和绿色 | 只用于正向状态 |
+| 进行中 / 主品牌 / 当前焦点 | 品牌蓝 | 用于主舞台边框、当前任务、重要数字 |
+| 待处理 / 等待 / 警告 | 琥珀色 | 不要大面积铺满 |
+| 失败 / 离线 / 异常 | 红色 | 只用于失败、离线和异常 |
+| 中性 / 无数据 | 灰蓝 | 用于背景和非重点信息 |
+
+图表避免默认彩虹色，使用 3 到 5 个语义色即可。
+
+### 4.4 字体与数字
+
+- 标题：中等字重，清晰，不使用装饰字体。
+- KPI 数字：大字号、tabular numbers、强对比。
+- 辅助信息：短句，避免长段落。
+- 任务 ID、设备 ID：等宽字体，支持中间截断或换行。
+- 小屏下用 `clamp()` 限制字号范围，不用 `vw` 线性缩放所有文字。
+
+## 5. Video Flight Stage 动画方案
+
+### 5.1 状态机
+
+每个预览条目进入舞台时应经过明确生命周期：
+
+```text
+loading -> entering -> playing -> leaving -> loading(next)
+                      -> error
+```
+
+状态定义：
+
+| 状态 | 含义 | UI 表现 |
+|---|---|---|
+| `loading` | 当前预览正在准备 | 舞台显示骨架/海报，当前资源准备完成后进入 |
+| `entering` | 预览卡片飞入主舞台 | 使用 transform + opacity + perspective |
+| `playing` | 真实 `video_url` 视频或 MCAP 图像帧预览落位并播放 | 舞台稳定，元信息显示，周围面板不动；`video_url` 使用 `<video>`，`preview_url` 使用数据预览帧渲染 |
+| `leaving` | 当前预览飞出 | 仅在下一条已有可展示内容时离场，下一条接替 |
+| `error` | 视频加载或播放失败 | 显示 fallback 卡片、任务信息和错误状态 |
+
+### 5.1.1 Current + Next 轮播模型
+
+第一版不做复杂的多条前瞻预载，也不维护大型播放器池。轮播主路径只管理两个媒体槽位：当前正在展示的 `current slot` 和后台准备的 `next slot`。`preview item` 是业务数据，`media slot` 是真实持有 `<video>`、MCAP reader、object URL 和播放时间轴的资源；两者不能混为一谈。
+
+- 当前条目是唯一允许播放的资源；下一条只能静默准备，不能调用 `play()`，不能产生声音。
+- 当前条目进入 `playing` 后，立即开始准备队列中的下一条。
+- 对 MCAP 预览，正常切换时旧 current 不应立刻销毁；如果它仍在轮播队列中，可以按稳定 `media_identity` 放入一个很小的 warm handoff cache，下一次成为 next 时直接复用已解析 metadata、reader 和已加载帧。该 cache 只服务当前/下一条交接，不等同于多条前瞻预载，必须有数量上限。
+- next slot 生命周期是 `idle -> preparing -> armed -> activating -> current`。`activating` 只交换槽位所有权，不重新设置 `src`，不调用 `load()`，不把媒体时间轴 seek 到 0。
+- 真实 `video_url` 的 next：使用一个隐藏 next video，设置 `muted`、`playsinline`、`preload="auto"`；`loadedmetadata` 只能算 metadata ready，`loadeddata` / `canplay` 只能算可开始播放；进入 `armed` 还需要至少具备可平滑起播的缓冲，或浏览器触发 `canplaythrough`。
+- `preview_url` / MCAP 的 next：先解析 episode presign，加载 MCAP metadata，自动选择图像/压缩图像 topic，并准备一个有上限的起播帧窗口后进入 `armed`；禁止在 next 准备阶段读取整段 MCAP 或无上限缓存大量帧。
+- poster fallback 的 next：图片 `load` 后进入 `armed`。
+- next 准备失败只标记该条本轮不可切换，不影响 current 播放；current 重播或 overview 刷新后可以重新尝试。
+- overview 刷新时，如果 current 的稳定 `media_identity` 不变，不打断 current；如果 next 的稳定 `media_identity` 变化，取消旧 next 并准备新 next。
+- 离开队列、组件卸载或 URL 变化时，必须释放 next video、warm cache 中的 MCAP reader/消息状态、object URL 和 timer。
+
+`media_identity` 必须是稳定媒体身份，不应直接使用可能随签名变化的完整访问 URL。推荐优先级：
+
+1. 后端显式返回 `media_identity` 或对象存储 key。
+2. `episode_id + task_id + media_kind + object_key`。
+3. 当前端只能拿到 URL 时，使用 `origin + pathname + object/bucket/key` 等稳定参数，忽略签名、过期时间、token、随机数等访问参数。
+
+`video_url`、`preview_url`、`poster_url` 是访问地址，不是媒体身份。签名 URL 刷新不能导致当前视频重建播放器或回到开头。
+
+### 5.1.1.1 槽位激活与重播边界
+
+- `prepare next` 可以设置 next slot 的 `src`、预载 metadata、等待缓冲和首帧。
+- `activate next` 只能把已 armed 的 next slot 标记为 current，并开始播放这个已经准备好的媒体；不得重新设置 `src`、不得重新 `load()`、不得主动 `currentTime = 0`。
+- `replay current` 是唯一允许 seek 到 0 的路径；它只发生在 current 已经结束且 next 等待 10 秒仍未 armed 时。
+- current 正常切到 next 后，旧 current slot 才进入 idle；若它仍在轮播队列中且是 MCAP 资源，可先进入有上限的 warm handoff cache，否则释放资源。
+- 数据刷新只更新队列和元信息，不控制 current 的媒体时间轴。
+- MCAP 帧预览必须按有限帧序列播放；next armed 后可在后台继续补齐剩余有限帧。播放到当前已准备序列末尾但补齐仍在进行时停在最后一帧等待补齐，补齐失败或等待超时后再进入 next 检查；不允许用取模循环反复播放开头帧。
+
+### 5.1.2 不间断轮播边界
+
+“不间断”在浏览器和电视端应定义为网络正常、资源格式兼容时切换无明显黑屏和长时间等待，而不是承诺所有网络和浏览器策略下绝对无缝。第一版采用保守切换规则：
+
+- current 播放结束后，先检查 next 是否 ready。
+- 如果 next 已 `armed`，current 离场并激活 next slot。
+- 如果 next 尚未 ready，current 停在最后一帧或当前最后一张 MCAP 帧，不清空舞台、不显示大段等待文字。
+- 从 current 结束时开始等待 next，最多等待 10 秒。
+- 10 秒内 next armed，则切换到 next。
+- 10 秒后 next 仍未 ready，则从头重播 current，并在重播期间继续准备同一个 next。
+- MCAP current 到达末尾后同样停在最后一帧；10 秒后 next 未 ready 时，从第 0 帧重播 current。
+- 当队列很短且 MCAP 条目反复出现时，应优先复用上一轮已经 armed 的 MCAP warm cache，避免每轮重新 presign、读取 metadata 和首帧窗口导致 current 重播。
+- 数据刷新不得让 current 最后一帧或 current 播放状态失效；只有 current 资源 key 变化、条目离队或当前资源错误时才重置 current。
+
+### 5.2 动画叙事
+
+建议动线：
+
+1. 下一条预览从右侧远处或侧后方出现，初始为 `translate3d(24%, -4%, -120px) rotateY(-10deg) scale(0.86)`。
+2. 进入时逐渐清晰，`opacity` 从 0 到 1，`filter: blur()` 归零。
+3. 落位后保持稳定 16:9 舞台，不再移动；`video_url` 指向真实可播放视频时自动播放 `<video>`，否则用 `preview_url` 的 MCAP 图像帧自动播放。
+4. 播放结束或达到最大展示时长后，向左上或左侧轨道飞出，透明度降低。
+5. current 结束后只有 next 已 ready 才离场；next 未 ready 时停在 current 最后一帧，等待最多 10 秒，超时后重播 current。
+
+动画应该表达“数据片段进入生产系统”，不要像游戏抽卡或宣传片。
+
+### 5.3 技术建议
+
+实现时应优先使用：
+
+- `transform: translate3d(...) scale(...) rotateY(...)`
+- `opacity`
+- `filter` 的低强度 blur 或 brightness
+- `perspective` 容器
+- `overflow: hidden` 裁剪飞行动画
+- CSS transition / keyframes
+
+谨慎使用：
+
+- `will-change`：只在动画元素上使用，不长期挂在大量节点。
+- box-shadow：大面积阴影和发光会提高 GPU/合成成本。
+- filter：避免高强度、长时间全屏 blur。
+
+禁止：
+
+- 动画过程中改变 grid track、width、height、margin 导致布局重排。
+- 同时播放多个视频。
+- 为了预备 next 而解码/渲染多个全尺寸视频或大量 MCAP 帧。
+- next 未 ready 时强制清空当前舞台或离场。
+- 每次刷新数据都重置舞台状态。
+- 飞行动画造成横向滚动条。
+
+### 5.4 视频与 fallback
+
+当前系统的真实预览更接近 MCAP 数据预览，而不是现成 MP4 视频。第一版必须明确区分“真实视频播放”和“数据预览帧播放”：
+
+- `video_url`：真实可直接播放的视频 URL，第一优先；非空时必须能被 `<video>` 播放，不能返回 MCAP presigned URL、poster URL、内部对象路径或 mock URL。
+- `preview_url`：可预览的数据 URL，例如 episode presign API 或 MCAP storage proxy URL；不是 `<video>` 的 `src`，而是前端复用 `DataPreview.vue` / `useMcapReader.js` 读取图像或压缩图像 topic 后按帧渲染。
+- `poster_url`：静态封面或后端生成缩略图。
+
+fallback 策略：
+
+| 场景 | 显示策略 |
+|---|---|
+| `video_url` 存在且可播放 | 渲染 `<video>`，静音自动播放，只播放当前条目 |
+| `video_url` 不存在但有 `preview_url` | 解析 MCAP，自动选择图像/压缩图像 topic，按帧播放，不渲染 `<video>` |
+| `preview_url` 不可用但有 `poster_url` | 显示 poster + 小型任务元信息，不显示大段占位文字 |
+| `video_url` 加载失败 | 显示 poster 或工业占位画面 + 错误状态 |
+| `preview_url` / `poster_url` 都不存在 | 显示轻量等待状态和小型任务元信息，不伪装成视频 |
+| `previews` 为空 | 显示健康空状态：暂无可轮播预览，保留 KPI 和趋势 |
+| 自动播放被浏览器限制 | 对真实视频静音重试；若仍失败，优先降级到 MCAP 图像帧，再退回 poster / 轻量等待状态 |
+
+## 6. 响应式布局方案
+
+### 6.1 总原则
+
+页面是电视响应式大屏，不是固定 100 寸画布。
+
+必须使用：
+
+- CSS Grid / Flexbox
+- `clamp()`
+- `minmax()`
+- `aspect-ratio`
+- 稳定的 grid 区域
+- 固定格式组件的最小/最大尺寸约束
+
+避免：
+
+- 只适合 100 寸的固定 px 布局
+- 用 `vw` 线性缩放所有字体
+- 视频轮播改变舞台尺寸
+- 小屏隐藏全部次要信息，只剩视频
+
+优先级：
+
+1. 顶部状态栏
+2. 核心 KPI
+3. 中央 Video Flight Stage
+4. 设备健康 / 异常状态
+5. 趋势与任务流
+6. 细节列表
+
+### 6.2 断点策略
+
+#### >= 2400px：超宽/4K 大屏
+
+布局：
+
+- 顶部状态栏一行完整展示。
+- KPI 采用 8 列或 4x2，数字更大。
+- 中央视频舞台占中部 45% 到 55% 宽度。
+- 左侧放 KPI 补充和设备状态，右侧放任务流与质量/同步状态。
+- 底部放趋势图和状态分布。
+
+要求：
+
+- 内容不要太分散，主舞台仍然是视觉中心。
+- 图表和列表显示更多条目，但保持行高稳定。
+
+#### 1600px - 2399px：标准电视大屏
+
+布局：
+
+- 适合作为主验收布局。
+- 顶部状态栏保留标题、时间、同步状态和设备摘要。
+- KPI 4 列或 6 列自适应换行。
+- 中央舞台在上半屏中间，侧栏为设备和任务流。
+- 趋势和任务流在下半屏。
+
+要求：
+
+- `1920x1080` 下不需要滚动即可看到核心 KPI、视频、设备健康和异常状态。
+- 列表可以减少到 5 到 8 条。
+
+#### 1200px - 1599px：紧凑电视/桌面布局
+
+布局：
+
+- 顶部状态栏压缩：保留标题、时间、刷新状态，摘要合并为短标签。
+- KPI 改为 4 列或 2 行。
+- 视频舞台占据主要宽度，侧栏移动到视频下方或双列下方。
+- 趋势图高度降低，任务流和设备列表减少条数。
+
+要求：
+
+- 不能横向滚动。
+- 不能让侧栏挤压视频舞台到不可读。
+
+#### < 1200px：降级布局
+
+布局：
+
+- 单列或两列紧凑布局。
+- KPI 和视频舞台优先。
+- 异常状态内联保留在设备和任务区域，视频下方不设置独立告警栏。
+- 趋势、设备、任务流可以折叠为紧凑面板或减少展示条数。
+
+要求：
+
+- 不追求完整大屏氛围，但必须可读、可操作、无重叠。
+- Video Flight Stage 降级为淡入淡出或轻量滑入。
+
+### 6.3 视频舞台响应式
+
+- 始终设置 `aspect-ratio: 16 / 9` 或接近 16:9。
+- 舞台容器设置 `overflow: hidden`。
+- 元信息 overlay 使用底部或侧边半透明带，不覆盖视频主体超过 25%。
+- 飞入/飞出元素只在舞台容器内移动，不能影响页面滚动。
+- 1366x768 下舞台仍应完整可见，不能被任务流或侧栏挤没。
+
+## 7. 后端聚合 API 方案
+
+### 7.1 路由建议
+
+当前已有：
+
+```text
+GET /api/v1/production/dashboard/snapshot
+GET /api/v1/production/dashboard/batches/:id/task-summary
+```
+
+建议新增或演进为：
+
+```text
+GET /api/v1/production/dashboard/overview
+```
+
+`snapshot` 可以继续服务现有页面，`overview` 面向新版大屏契约。若希望减少路由数量，也可以让 `snapshot` 追加字段，但文档建议使用 `overview`，原因是：
+
+- 大屏需要 `previews`、更明确的 `summary`、设备聚合和最近任务流。
+- 新契约可以避免破坏当前 `useDashboardData()` 对 `snapshot` 的映射。
+- 后续可以为大屏单独设置 refresh、limit、preview 参数。
+
+第一版实现时不要另起独立业务模块。优先在现有 `ProductionDashboardHandler` 中增加 `overview` handler，复用已有 scope 解析、只读事务、任务统计、趋势、质量和工位查询。只有当 handler 明显膨胀到难以维护时，再拆 service/helper。
+
+### 7.2 查询参数
+
+建议参数：
+
+| 参数 | 默认 | 说明 |
+|---|---:|---|
+| `timezone_offset` | 当前前端时区 | 趋势聚合使用 |
+| `trend_days` | 7 | 趋势窗口，最大 31 |
+| `recent_limit` | 12 | 最近任务条数 |
+| `device_limit` | 16 | 设备状态条数 |
+| `preview_limit` | 8 | 轮播预览条数 |
+| `factory_id` | 空 | 管理端筛选 |
+| `organization_id` | 空 | 管理端筛选 |
+| `workstation_id` | 空 | 工位筛选；data_collector 角色自动限定 |
+
+权限策略沿用现有 dashboard：`admin` 与 `data_collector` 可访问；`data_collector` 自动限定到绑定工位。
+
+### 7.3 返回结构
+
+```json
+{
+  "generated_at": "2026-05-17T10:00:00Z",
+  "scope": {
+    "role": "admin",
+    "factory_id": "",
+    "organization_id": "",
+    "workstation_id": ""
+  },
+  "summary": {
+    "today_task_count": 128,
+    "completed_task_count": 92,
+    "in_progress_task_count": 8,
+    "pending_task_count": 24,
+    "failed_task_count": 4,
+    "pass_rate": 96.4,
+    "robot_online_rate": 87.5,
+    "active_batch_count": 6,
+    "active_station_count": 14,
+    "generated_at": "2026-05-17T10:00:00Z"
+  },
+  "trend": [
+    {
+      "time": "05-17",
+      "completed": 92,
+      "in_progress": 8,
+      "pending": 24,
+      "failed": 4
+    }
+  ],
+  "task_status_distribution": {
+    "completed": 92,
+    "in_progress": 8,
+    "pending": 18,
+    "ready": 6,
+    "failed": 4,
+    "cancelled": 0
+  },
+  "quality": {
+    "pass_count": 81,
+    "fail_count": 3,
+    "pass_rate": 96.4,
+    "inspection_count": 84,
+    "recent_failures": []
+  },
+  "devices": {
+    "online_count": 14,
+    "offline_count": 2,
+    "idle_count": 4,
+    "busy_count": 10,
+    "abnormal_count": 1,
+    "items": []
+  },
+  "recent_tasks": [],
+  "previews": []
+}
+```
+
+### 7.4 字段来源建议
+
+| 数据块 | 可能来源 | 当前状态 |
+|---|---|---|
+| `summary.today_task_count` | `tasks` 按今日时间窗口聚合 | 现有 `snapshot.tasks` 是全量 scope 计数，需要增加今日窗口 |
+| `summary.completed/in_progress/pending/failed` | `tasks.status` | 现有已支持基础状态 |
+| `summary.pass_rate` | `episodes.qa_status` 或现有 `dashboardQuality` | 现有 quality 可复用 |
+| `summary.robot_online_rate` | `workstations.status`、`robots.status`、连接快照 | 现有 stations 仅返回基础状态；在线率需要明确规则 |
+| `trend` | `tasks` 时间桶 | 现有 trend 缺少 failed |
+| `task_status_distribution` | `tasks.status` | 现有 tasks counts 可复用并扩展 |
+| `quality.recent_failures` | `episodes` + `tasks` + `inspectors` | 当前需新增查询 |
+| `devices.items` | `workstations` + `robots` + `data_collectors` + active task | 现有 stations 可扩展 current_task / last_seen_at |
+| `recent_tasks` | `tasks` + `batches` + `workstations` + `robots` | 现有 active_tasks 只覆盖进行中任务，需要最近完成/失败 |
+| `previews` | `episodes` + task/workstation metadata + presign/poster | 当前 episode API 可 presign MCAP，但没有视频 URL |
+
+第一版字段取舍：
+
+- `summary`、`trend`、`task_status_distribution`、`devices`、`recent_tasks` 是核心字段，应优先完成。
+- 第一版不返回独立 `alerts` 字段；任务失败、设备离线、同步降级等异常内联体现在顶部状态、设备状态和任务流中。
+- `previews.video_url` 可以为空；但如果非空，必须是真实可播放视频 URL。前端不能把 `preview_url` 当作 `<video>` 源，但应把它作为 MCAP 数据预览源读取图像帧。
+- `quality.recent_failures` 如果查询成本高，可以第一期返回空数组，但保留字段。
+
+### 7.5 异常状态表达建议
+
+第一期不需要建立新告警表，也不需要独立告警栏。异常应进入已有信息区域：
+
+- 最近任务流：直接展示失败、取消、质检未通过等任务状态。
+- 设备状态区：直接展示 offline、abnormal、心跳超时等设备状态。
+- 顶部状态栏：展示 overview 请求失败、保留旧数据、使用 fallback 等全局降级状态。
+- 质量区域：通过失败数、待检数和合格率表达质量异常。
+
+后续如需确认、闭环处理或审计记录，再设计独立 alerts 表和告警页面；它不属于生产大屏 MVP。
+
+### 7.6 预览数据契约
+
+第一期 `previews` 应允许没有真实视频，但必须遵守：`video_url` 为空表示没有可直接播放的视频；`video_url` 非空表示真实可播放视频。`preview_url` 表示数据预览源，前端可像数据预览页一样解析 MCAP 图像帧并在舞台播放。
+
+```json
+{
+  "id": "episode:42",
+  "title": "片段 EP-20260517-00042",
+  "task_name": "抓取-放置标准动作采集",
+  "robot_name": "RB-07",
+  "station_name": "A-03 工位",
+  "status": "approved",
+  "video_url": "",
+  "preview_url": "/api/v1/episodes/42/presign?kind=mcap",
+  "poster_url": "",
+  "duration_seconds": 38,
+  "created_at": "2026-05-17T09:52:10Z",
+  "episode_id": 42,
+  "task_id": 135
+}
+```
+
+注意：`preview_url` 不应直接返回需要额外鉴权但前端无法读取的内部对象路径，也不能作为 `<video>` 的 `src`。若返回 episode presign API，前端需要先解析成 `/api/v1/storage/object?...` 后交给 MCAP reader。若视频需要从 MCAP 抽帧或转码，应在后续任务中定义生成服务；在真实视频生成前，大屏只做前端数据预览帧播放，不新增服务端视频加工能力。
+
+### 7.7 空数据与错误
+
+- 空 scope 返回 200，数组为空，summary 数值为 0，并携带 `scope.warning`。
+- 查询失败返回 500，JSON 仍使用 `gin.H{"error": "failed to get production dashboard overview"}`。
+- 参数错误返回 400。
+- 未认证返回 401。
+- 无权限返回 403，由现有 middleware 控制。
+
+## 8. 前端数据流与组件拆分方案
+
+### 8.1 建议页面入口
+
+建议优先改造 `src/views/FullscreenDashboard.vue` 作为管理端大屏入口，因为当前 `/admin/dashboard` 已指向该页面，且它已经包含全屏按钮、ECharts 和大屏样式。
+
+`src/views/ProductionDashboard.vue` 可以继续作为普通运营 dashboard，或在后续统一为共享组件。
+
+### 8.2 建议组件
+
+| 组件 | 职责 | 资源持有 |
+|---|---|---|
+| `ProductionBigScreen.vue` 或 `FullscreenDashboard.vue` | 页面总装、布局、刷新状态、路由入口 | 刷新 timer、全局 resize |
+| `VideoFlightStage.vue` | 视频轮播状态机、current/next 媒体槽位、fallback | current/next video slot、current/next MCAP reader、stage timer、video event listeners |
+| `BigScreenKpiStrip.vue` | KPI 展示、数字格式化、轻量刷新动效 | 可选数字动画 timer |
+| `BigScreenStatusRail.vue` | 设备状态汇总和关键设备列表 | 无，纯展示 |
+| `BigScreenTaskFeed.vue` | 最近任务流 | 无，纯展示 |
+| `BigScreenTrendPanel.vue` | ECharts 趋势图 | chart instance、ResizeObserver |
+| `useProductionBigScreenData.js` | overview 请求、adapter、mock fallback、刷新调度 | polling timer |
+
+### 8.3 数据流
+
+```text
+page mounted
+  -> useProductionBigScreenData.init()
+  -> GET /production/dashboard/overview
+  -> adapter normalizes response
+  -> render KPI / stage / trend / devices / tasks
+  -> start polling every 15s or 30s
+  -> refresh data without resetting VideoFlightStage current item
+  -> VideoFlightStage prepares only the next media slot after current starts
+  -> component unmounted clears timers, listeners, charts, current/next resources
+```
+
+关键原则：
+
+- 数据刷新不得打断当前视频播放，也不得清空 `media_identity` 未变化的 current / next 槽位状态。
+- `previews` 更新时，VideoFlightStage 只更新队列，当前 `playing` 条目除非已不存在或出错，否则继续播放。
+- `previews` 更新时，如果 next 条目的稳定 `media_identity` 未变化，继续保留 next 的准备状态；如果媒体身份变化，取消旧 next 并准备新的 next。
+- API 失败时保留上一份成功数据，并显示降级状态；没有上一份数据时使用集中 mock fallback。
+- mock 数据集中放在 composable 或 dedicated mock 文件，不能散落在模板里。
+
+### 8.4 Props 与状态建议
+
+`VideoFlightStage.vue`：
+
+- Props: `items`, `maxPlayMs`, `reducedMotion`
+- Emits: `item-change`, `play-error`
+- Internal state: `currentIndex`, `stageState`, `currentItem`, `nextItem`, `currentSlot`, `nextSlot`, `nextArmed`, `nextStatus`, `nextError`, `errorMessage`
+- Cleanup: timers、current/next video `ended/error/canplay` listeners、单个 hidden next video、current/next MCAP reader、object URL
+
+`BigScreenTrendPanel.vue`：
+
+- Props: `trend`, `distribution`
+- Internal state: chart instance
+- Cleanup: `chart.dispose()`、ResizeObserver
+
+`useProductionBigScreenData.js`：
+
+- State: `loading`, `error`, `lastUpdatedAt`, `usingFallback`, `overview`
+- Methods: `init`, `refresh`, `startPolling`, `stopPolling`
+- Adapter: `normalizeOverviewResponse(raw)`
+
+## 9. 数据结构草案
+
+以下结构仅用于文档说明，不要求引入 TypeScript。
+
+```js
+/**
+ * @typedef {Object} OverviewResponse
+ * @property {string} generated_at
+ * @property {Object} scope
+ * @property {Summary} summary
+ * @property {TrendPoint[]} trend
+ * @property {Object<string, number>} task_status_distribution
+ * @property {QualitySummary} quality
+ * @property {DeviceSummary} devices
+ * @property {RecentTask[]} recent_tasks
+ * @property {PreviewItem[]} previews
+ */
+
+/**
+ * @typedef {Object} Summary
+ * @property {number} today_task_count
+ * @property {number} completed_task_count
+ * @property {number} in_progress_task_count
+ * @property {number} pending_task_count
+ * @property {number} failed_task_count
+ * @property {number} pass_rate
+ * @property {number} robot_online_rate
+ * @property {number} active_batch_count
+ * @property {number} active_station_count
+ * @property {string} generated_at
+ */
+
+/**
+ * @typedef {Object} TrendPoint
+ * @property {string} time
+ * @property {number} completed
+ * @property {number} in_progress
+ * @property {number} pending
+ * @property {number} failed
+ */
+
+/**
+ * @typedef {Object} DeviceStatus
+ * @property {string} id
+ * @property {string} name
+ * @property {'robot'|'station'} type
+ * @property {'online'|'offline'|'idle'|'busy'|'abnormal'} status
+ * @property {string} station_name
+ * @property {string} current_task
+ * @property {string} last_seen_at
+ */
+
+/**
+ * @typedef {Object} RecentTask
+ * @property {string|number} id
+ * @property {string} public_id
+ * @property {string} name
+ * @property {string} status
+ * @property {string} robot_name
+ * @property {string} station_name
+ * @property {string} batch_name
+ * @property {string} started_at
+ * @property {string} finished_at
+ * @property {number} duration_seconds
+ */
+
+/**
+ * @typedef {Object} PreviewItem
+ * @property {string} id
+ * @property {string} title
+ * @property {string} task_name
+ * @property {string} robot_name
+ * @property {string} station_name
+ * @property {string} status
+ * @property {string} video_url
+ * @property {string} preview_url
+ * @property {string} poster_url
+ * @property {number} duration_seconds
+ * @property {string} created_at
+ * @property {string|number} episode_id
+ * @property {string|number} task_id
+ */
+
+/**
+ * @typedef {'loading'|'entering'|'playing'|'leaving'|'error'} VideoStageState
+ */
+```
+
+## 10. 性能与稳定性方案
+
+页面会在电视浏览器长时间运行，优先稳定。
+
+建议：
+
+- overview API 刷新间隔默认 15s 或 30s；生产现场可配置。
+- 如果本轮刷新失败，保留上一轮成功数据，不清空页面。
+- 刷新时只更新数据，不重建整个组件树。
+- ECharts 实例复用 `setOption`，窗口变化时 resize，卸载时 dispose。
+- 舞台只播放当前条目；后台只准备队列中的下一条。带真实 `video_url` 时用单个 hidden next video 准备到 `loadeddata` / `canplay`，只有 `preview_url` 时准备 MCAP metadata 和首帧，不同时播放多个资源。
+- `previews` 队列最多保留 8 到 12 条，避免大量视频资源占用。
+- 不做 2 到 3 条前瞻预载；任意时刻只允许一个 current 播放资源和一个 next 准备资源，避免无上限创建 hidden video、MCAP reader 或 object URL。
+- 下一条未 ready 时不得清空当前舞台；current 停在最后一帧并最多等待 10 秒，超时后从头重播 current，同时继续准备同一个 next。
+- 动画元素数量固定，避免每次轮播创建大量 DOM。
+- timers、ResizeObserver、fullscreen listener、current/next video listener、hidden next video、MCAP reader 和 object URL 必须在 unmount 清理。
+- 长列表只展示有限条目，大屏不是审计表格。
+- `will-change` 只用于正在进入或离开的舞台元素，离场后移除。
+
+接口性能：
+
+- 后端 overview 应在一个只读事务中完成关键查询，沿用当前 dashboard handler 的做法。
+- 查询需要 limit，不能一次返回所有任务或设备。
+- 对近期任务、episodes、sync_logs 的查询应使用时间或 limit 限制。
+- 数据库字段不足时，第一期宁可返回空数组，也不要用昂贵临时查询阻塞大屏。
+
+## 11. 可访问性与降级策略
+
+### 11.1 减少动画
+
+支持 `prefers-reduced-motion`：
+
+- 关闭 3D 飞入/飞出。
+- 使用淡入淡出或轻微 crossfade。
+- KPI 计数动画改为直接更新。
+
+### 11.2 API 不可用
+
+优先级：
+
+1. 保留上一份成功 overview。
+2. 在顶部状态栏显示同步失败或降级状态。
+3. 若无历史数据，使用集中 mock fallback。
+4. 页面不得空白。
+
+### 11.3 视频不可用
+
+- 无 `video_url` 但有 `preview_url`：解析 MCAP 图像帧并自动播放，失败后再显示 poster 或轻量等待状态。
+- 视频加载错误：进入 `error` 状态，优先显示 poster 或 MCAP fallback；如果 next 已 ready 则切换 next，否则按 10 秒等待/重播 current 的规则继续。
+- 自动播放失败：对真实视频静音重试；仍失败则优先使用 MCAP 图像帧，再退回 poster / 轻量等待状态。
+
+### 11.4 小屏降级
+
+- 1200px 以下禁用复杂 3D 动效。
+- 任务流和设备列表减少条数。
+- 趋势图高度降低，但保留 summary。
+- 不允许横向滚动和文字重叠。
+
+## 12. 开发阶段规划
+
+### 阶段 1：文档和接口契约确认
+
+目标：确认本方案、字段命名、异常表达方式、真实视频来源。
+
+产出：
+
+- 本设计文档
+- overview API 契约确认
+- 待确认问题关闭或建任务
+
+验收：
+
+- 产品、前端、后端理解同一套页面结构和数据契约。
+
+风险：
+
+- 真实视频来源不明确时，Video Flight Stage 第一版只能展示元信息 / poster fallback，不能播放假视频。
+
+### 阶段 2：后端聚合 API
+
+目标：新增 `/production/dashboard/overview`。
+
+产出：
+
+- Handler response structs
+- summary/trend/devices/recent_tasks/previews 查询
+- 单元测试
+- Swagger 更新
+- 不新增表，不新增告警闭环，不新增视频加工服务
+
+验收：
+
+- `go test ./internal/api/handlers/...` 通过。
+- 空数据和 data_collector scope 正常。
+- `previews.video_url` 为空时仍返回可展示的 episode/task 元信息；`video_url` 非空时必须是真实可播放视频。
+
+风险：
+
+- 设备在线判定和异常展示规则需要统一。
+
+### 阶段 3：前端数据 adapter 和 mock fallback
+
+目标：建立大屏数据入口。
+
+产出：
+
+- `useProductionBigScreenData.js`
+- overview API client
+- 集中 mock fallback
+- 字段 normalize 和格式化
+
+验收：
+
+- API 成功、失败、空数据都能渲染稳定页面。
+
+风险：
+
+- fallback 与真实 API 字段不一致会带来后续返工。
+
+### 阶段 4：响应式大屏布局
+
+目标：建立多尺寸电视布局。
+
+产出：
+
+- 大屏页面结构
+- KPI、主舞台、侧栏、底部区域响应式 CSS
+- 关键断点适配
+
+验收：
+
+- 3840x2160、2560x1440、1920x1080、1600x900、1366x768 无重叠、无横向滚动。
+
+风险：
+
+- 信息过多导致 1366x768 下拥挤，需要减少列表条数。
+
+### 阶段 5：Video Flight Stage 动画
+
+目标：实现可运行的预览轮播舞台。
+
+产出：
+
+- `VideoFlightStage.vue`
+- 状态机和 fallback
+- reduced-motion 支持
+
+验收：
+
+- 视频/海报可进入、播放/展示、离场、下一条接替。
+- 数据刷新不打断当前播放。
+
+风险：
+
+- 浏览器自动播放限制、视频格式兼容性、电视性能差异。
+
+第一版到阶段 5 即可形成 MVP。阶段 6 和阶段 7 是增强与验收加固，不应阻塞第一版 PR 拆分。
+
+### 阶段 6：图表和实时刷新
+
+目标：完善趋势、设备、任务流和质量/异常状态。
+
+产出：
+
+- 趋势图组件
+- 设备状态组件
+- 任务流组件
+- 质量/异常状态组件或内联展示
+- 定时刷新策略
+
+验收：
+
+- 长时间运行稳定，刷新状态明确。
+
+风险：
+
+- 频繁 chart resize 或 setOption 造成性能波动。
+
+### 阶段 7：性能、电视视口验证和修正
+
+目标：验证真实展示效果。
+
+产出：
+
+- 视口截图或人工检查记录
+- 性能问题修正
+- 视频失败和 API 失败演练
+
+验收：
+
+- `npm run build` 通过。
+- 目标视口下无明显问题。
+- 页面长时间运行无明显内存增长。
+
+风险：
+
+- 电视浏览器版本较旧，需要 CSS/视频能力降级。
+
+## 13. 验收标准
+
+### 13.1 功能
+
+- 聚合 API 可返回生产大屏所需数据。
+- 前端优先使用聚合 API。
+- 视频舞台可自动轮播。
+- 当前条进入播放后，后台开始准备下一条；网络正常时，从第二条开始切换不应出现明显黑屏、空白或长时间加载。
+- 下一条未 ready 时，舞台保留当前最后画面最多 10 秒；仍未 ready 时从头重播当前条，不做空白离场。
+- 视频失败有 fallback。
+- 任务流、设备状态、趋势图、质量/异常状态可展示。
+- 数据刷新不打断当前视频播放。
+
+### 13.2 视觉
+
+- 第一眼像生产指挥中心。
+- 中央视频舞台是视觉中心。
+- KPI 远距离可读。
+- 动画高级但克制。
+- 不像营销页、静态海报或普通后台换皮。
+- 异常状态醒目但不污染整个画面。
+
+### 13.3 响应式
+
+- `3840x2160` 正常，内容不显小。
+- `2560x1440` 正常，布局自然。
+- `1920x1080` 正常，作为基础验收尺寸。
+- `1600x900` 正常，信息适度压缩。
+- `1366x768` 不重叠、不横向滚动、不丢核心内容。
+
+### 13.4 性能
+
+- 长时间运行稳定。
+- 定时刷新不造成闪烁或重排。
+- 动画不卡顿。
+- 无明显内存泄漏。
+- 不同时播放多个视频。
+- 轮播资源数量固定为 current + next，hidden video、MCAP reader 和 object URL 不随轮播无限增长。
+- 图表实例和事件监听正确释放。
+
+## 14. 待确认问题
+
+后续开发前需要确认：
+
+- 真实 `video_url` 从哪里来：直接上传视频、MCAP 转码，还是前端实时渲染后产出可播放视频流。未确认前不得伪造视频 URL。
+- `preview_url` 应来自 episode、task 还是 MinIO 对象。
+- 视频/预览 URL 是否需要鉴权，presigned URL 有效期多久。
+- 大屏是否必须登录，是否需要专用只读展示 token。
+- 大屏刷新频率是 15s、30s 还是可配置。
+- 异常展示规则：哪些任务/同步/设备状态需要在顶部状态、设备状态或任务流中突出。
+- 设备在线/离线判定规则：使用 workstation status、robot status、recorder/transfer hub 连接状态，还是最后心跳。
+- 质检通过率来源：`episodes.qa_status` 的哪些值算通过、失败、处理中。
+- 是否需要多组织、多工厂筛选；如果大屏部署在单工厂电视，是否应固定 scope。
+- 是否需要自动进入浏览器全屏，或者只保留手动全屏按钮。
+- 是否需要展示敏感任务 ID 或客户名称，参观模式是否要脱敏。
+
+## 15. 文档位置说明
+
+本文档放在 `keystone-worktree2/docs/designs/`，因为当前仓库已有跨前后端设计文档目录，并且本方案的核心前提是后端聚合 API 契约。虽然页面实现主要发生在 `synapse-worktree2`，但后续开发应同时以本文档指导 Keystone API 与 Synapse 大屏实现。
diff --git a/internal/api/handlers/production_dashboard.go b/internal/api/handlers/production_dashboard.go
index f887c28..8dbec62 100644
--- a/internal/api/handlers/production_dashboard.go
+++ b/internal/api/handlers/production_dashboard.go
@@ -9,6 +9,7 @@ import (
 	"fmt"
 	"math"
 	"net/http"
+	"net/url"
 	"strconv"
 	"strings"
 	"time"
@@ -28,6 +29,10 @@ const (
 	maxDashboardDistributionLimit     = 100
 	defaultDashboardActiveLimit       = 20
 	maxDashboardActiveLimit           = 100
+	defaultDashboardRecentLimit       = 12
+	maxDashboardRecentLimit           = 50
+	defaultDashboardPreviewLimit      = 8
+	maxDashboardPreviewLimit          = 20
 )
 
 // ProductionDashboardHandler serves aggregate data for production dashboard pages.
@@ -43,6 +48,7 @@ func NewProductionDashboardHandler(db *sqlx.DB) *ProductionDashboardHandler {
 // RegisterRoutes registers production dashboard aggregate routes.
 func (h *ProductionDashboardHandler) RegisterRoutes(apiV1 *gin.RouterGroup) {
 	apiV1.GET("/snapshot", h.GetSnapshot)
+	apiV1.GET("/overview", h.GetOverview)
 	apiV1.GET("/batches/:id/task-summary", h.GetBatchTaskSummary)
 }
 
@@ -53,6 +59,8 @@ type productionDashboardQuery struct {
 	TrendDays         int
 	DistributionLimit int
 	ActiveLimit       int
+	RecentLimit       int
+	PreviewLimit      int
 	TimezoneOffset    string
 }
 
@@ -79,6 +87,35 @@ type productionDashboardSnapshotResponse struct {
 	ActiveTasks   []dashboardActiveTaskItem  `json:"active_tasks"`
 }
 
+type productionDashboardOverviewResponse struct {
+	GeneratedAt            string                            `json:"generated_at"`
+	Scope                  productionDashboardScope          `json:"scope"`
+	Summary                dashboardOverviewSummary          `json:"summary"`
+	Trend                  []dashboardTrendItem              `json:"trend"`
+	TaskStatusDistribution []dashboardStatusDistributionItem `json:"task_status_distribution"`
+	Quality                dashboardOverviewQuality          `json:"quality"`
+	Devices                dashboardOverviewDevices          `json:"devices"`
+	RecentTasks            []dashboardRecentTaskItem         `json:"recent_tasks"`
+	Alerts                 []dashboardOverviewAlert          `json:"alerts"`
+	Previews               []dashboardPreviewItem            `json:"previews"`
+}
+
+type dashboardOverviewSummary struct {
+	TotalTasks           int64   `json:"total_tasks"`
+	TodayTasks           int64   `json:"today_tasks"`
+	CompletedTasks       int64   `json:"completed_tasks"`
+	InProgressTasks      int64   `json:"in_progress_tasks"`
+	PendingTasks         int64   `json:"pending_tasks"`
+	FailedTasks          int64   `json:"failed_tasks"`
+	CancelledTasks       int64   `json:"cancelled_tasks"`
+	ActiveBatches        int64   `json:"active_batches"`
+	ActiveStations       int64   `json:"active_stations"`
+	TotalStations        int64   `json:"total_stations"`
+	RobotOnlineRate      float64 `json:"robot_online_rate"`
+	QualityPassRate      float64 `json:"quality_pass_rate"`
+	TotalDataDurationSec float64 `json:"total_data_duration_sec"`
+}
+
 type dashboardTaskCounts struct {
 	Total      int64 `json:"total" db:"total"`
 	Completed  int64 `json:"completed" db:"completed"`
@@ -94,6 +131,13 @@ type dashboardTrendItem struct {
 	Completed  int64  `json:"completed" db:"completed"`
 	InProgress int64  `json:"in_progress" db:"in_progress"`
 	Pending    int64  `json:"pending" db:"pending"`
+	Failed     int64  `json:"failed" db:"failed"`
+}
+
+type dashboardStatusDistributionItem struct {
+	Status string `json:"status"`
+	Label  string `json:"label"`
+	Value  int64  `json:"value"`
 }
 
 type dashboardDistributionItem struct {
@@ -116,6 +160,31 @@ type dashboardQuality struct {
 	PendingQA      int64   `json:"pending_qa" db:"pending_qa"`
 }
 
+type dashboardOverviewQuality struct {
+	PassRate       float64                         `json:"pass_rate"`
+	TotalInspected int64                           `json:"total_inspected"`
+	Passed         int64                           `json:"passed"`
+	Failed         int64                           `json:"failed"`
+	Inspecting     int64                           `json:"inspecting"`
+	PendingQA      int64                           `json:"pending_qa"`
+	RecentFailures []dashboardQualityRecentFailure `json:"recent_failures"`
+}
+
+type dashboardOverviewAlert struct {
+	ID        string `json:"id"`
+	Level     string `json:"level"`
+	Title     string `json:"title"`
+	Message   string `json:"message"`
+	CreatedAt string `json:"created_at"`
+}
+
+type dashboardQualityRecentFailure struct {
+	ID        string `json:"id"`
+	Title     string `json:"title"`
+	Reason    string `json:"reason"`
+	CreatedAt string `json:"created_at"`
+}
+
 type dashboardQualityRow struct {
 	TotalInspected   sql.NullInt64   `db:"total_inspected"`
 	Passed           sql.NullInt64   `db:"passed"`
@@ -131,14 +200,43 @@ type dashboardSystemStatus struct {
 	OnlineStations       int64   `json:"online_stations"`
 }
 
+type dashboardOverviewDevices struct {
+	Summary dashboardDeviceSummary `json:"summary"`
+	Items   []dashboardDeviceItem  `json:"items"`
+}
+
+type dashboardDeviceSummary struct {
+	Total      int64   `json:"total"`
+	Online     int64   `json:"online"`
+	Idle       int64   `json:"idle"`
+	Busy       int64   `json:"busy"`
+	Offline    int64   `json:"offline"`
+	Abnormal   int64   `json:"abnormal"`
+	OnlineRate float64 `json:"online_rate"`
+}
+
+type dashboardDeviceItem struct {
+	ID                  string `json:"id"`
+	Name                string `json:"name"`
+	StationName         string `json:"station_name"`
+	Status              string `json:"status"`
+	StatusText          string `json:"status_text"`
+	RobotName           string `json:"robot_name"`
+	RobotID             string `json:"robot_id"`
+	CollectorOperatorID string `json:"collector_operator_id"`
+	CollectorName       string `json:"collector_name"`
+}
+
 type dashboardStationItem struct {
 	ID                  string `json:"id" db:"id"`
+	Name                string `json:"name" db:"name"`
 	Status              string `json:"status" db:"status"`
 	StatusText          string `json:"status_text"`
 	CollectorOperatorID string `json:"collector_operator_id" db:"collector_operator_id"`
 	CollectorName       string `json:"collector_name" db:"collector_name"`
 	DeviceID            string `json:"device_id" db:"device_id"`
 	DeviceModel         string `json:"device_model" db:"device_model"`
+	RobotName           string `json:"robot_name" db:"robot_name"`
 }
 
 type dashboardActiveBatchItem struct {
@@ -167,6 +265,67 @@ type dashboardActiveTaskItem struct {
 	CollectorName       string `json:"collector_name" db:"collector_name"`
 }
 
+type dashboardRecentTaskItem struct {
+	ID          string `json:"id"`
+	TaskID      string `json:"task_id"`
+	TaskName    string `json:"task_name"`
+	Status      string `json:"status"`
+	StatusText  string `json:"status_text"`
+	RobotName   string `json:"robot_name"`
+	StationName string `json:"station_name"`
+	BatchID     string `json:"batch_id"`
+	SceneName   string `json:"scene_name"`
+	SOPLabel    string `json:"sop_label"`
+	EpisodeID   string `json:"episode_id"`
+	CreatedAt   string `json:"created_at"`
+	UpdatedAt   string `json:"updated_at"`
+}
+
+type dashboardRecentTaskRow struct {
+	ID          string       `db:"id"`
+	TaskID      string       `db:"task_id"`
+	TaskName    string       `db:"task_name"`
+	Status      string       `db:"status"`
+	RobotName   string       `db:"robot_name"`
+	StationName string       `db:"station_name"`
+	BatchID     string       `db:"batch_id"`
+	SceneName   string       `db:"scene_name"`
+	SOPLabel    string       `db:"sop_label"`
+	EpisodeID   string       `db:"episode_id"`
+	CreatedAt   sql.NullTime `db:"created_at"`
+	UpdatedAt   sql.NullTime `db:"updated_at"`
+}
+
+type dashboardPreviewItem struct {
+	ID              string  `json:"id"`
+	Title           string  `json:"title"`
+	TaskName        string  `json:"task_name"`
+	RobotName       string  `json:"robot_name"`
+	StationName     string  `json:"station_name"`
+	Status          string  `json:"status"`
+	VideoURL        string  `json:"video_url"`
+	PreviewURL      string  `json:"preview_url"`
+	PosterURL       string  `json:"poster_url"`
+	DurationSeconds float64 `json:"duration_seconds"`
+	CreatedAt       string  `json:"created_at"`
+	EpisodeID       string  `json:"episode_id"`
+	TaskID          string  `json:"task_id"`
+}
+
+type dashboardPreviewRow struct {
+	ID              string          `db:"id"`
+	Title           string          `db:"title"`
+	TaskName        string          `db:"task_name"`
+	RobotName       string          `db:"robot_name"`
+	StationName     string          `db:"station_name"`
+	Status          string          `db:"status"`
+	McapPath        string          `db:"mcap_path"`
+	DurationSeconds sql.NullFloat64 `db:"duration_seconds"`
+	CreatedAt       sql.NullTime    `db:"created_at"`
+	EpisodeID       string          `db:"episode_id"`
+	TaskID          string          `db:"task_id"`
+}
+
 type dashboardBatchTaskSummaryResponse struct {
 	BatchID string                          `json:"batch_id"`
 	Items   []dashboardBatchTaskSummaryItem `json:"items"`
@@ -307,6 +466,136 @@ func (h *ProductionDashboardHandler) GetSnapshot(c *gin.Context) {
 	})
 }
 
+// GetOverview returns the production big-screen aggregate contract.
+//
+// @Summary      Get production dashboard overview
+// @Description  Returns one aggregate overview for the Synapse production big screen.
+// @Tags         production-dashboard
+// @Accept       json
+// @Produce      json
+// @Param        workstation_id query int false "Filter by workstation ID; ignored for data_collector"
+// @Param        factory_id query int false "Filter by factory ID; ignored for data_collector"
+// @Param        organization_id query int false "Filter by organization ID; ignored for data_collector"
+// @Param        timezone_offset query string false "Timezone offset such as +08:00"
+// @Param        trend_days query int false "Trend day count (default 7, max 31)"
+// @Param        active_limit query int false "Active batch limit (default 20, max 100)"
+// @Param        recent_limit query int false "Recent task limit (default 12, max 50)"
+// @Param        preview_limit query int false "Preview limit (default 8, max 20)"
+// @Success      200 {object} map[string]interface{} "generated_at, scope, summary, trend, task_status_distribution, quality, devices, recent_tasks, alerts, previews"
+// @Failure      400 {object} map[string]string
+// @Failure      401 {object} map[string]string
+// @Failure      500 {object} map[string]string
+// @Router       /production/dashboard/overview [get]
+func (h *ProductionDashboardHandler) GetOverview(c *gin.Context) {
+	claims := middleware.GetClaims(c)
+	if claims == nil {
+		c.JSON(http.StatusUnauthorized, gin.H{"error": "authentication required"})
+		return
+	}
+
+	q, err := parseProductionDashboardQuery(c)
+	if err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+		return
+	}
+
+	scope, err := h.resolveProductionDashboardScope(c, claims, q)
+	if err != nil {
+		logger.Printf("[DASHBOARD] overview scope query failed: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
+		return
+	}
+	if scope.empty {
+		c.JSON(http.StatusOK, emptyProductionDashboardOverview(scope))
+		return
+	}
+
+	tx, err := h.db.BeginTxx(c.Request.Context(), &sql.TxOptions{ReadOnly: true})
+	if err != nil {
+		logger.Printf("[DASHBOARD] overview begin read transaction failed: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
+		return
+	}
+	defer func() { _ = tx.Rollback() }()
+
+	tasks, err := h.dashboardTaskCounts(tx, scope)
+	if err != nil {
+		logger.Printf("[DASHBOARD] overview task count query failed: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
+		return
+	}
+	todayTasks, err := h.dashboardTodayTaskCount(tx, scope, q)
+	if err != nil {
+		logger.Printf("[DASHBOARD] overview today task query failed: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
+		return
+	}
+	trend, err := h.dashboardTaskTrend(tx, scope, q)
+	if err != nil {
+		logger.Printf("[DASHBOARD] overview task trend query failed: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
+		return
+	}
+	quality, totalDurationSec, err := h.dashboardQuality(tx, scope)
+	if err != nil {
+		logger.Printf("[DASHBOARD] overview quality query failed: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
+		return
+	}
+	stations, err := h.dashboardStations(tx, scope)
+	if err != nil {
+		logger.Printf("[DASHBOARD] overview station query failed: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
+		return
+	}
+	activeBatches, err := h.dashboardActiveBatches(tx, scope, q.ActiveLimit)
+	if err != nil {
+		logger.Printf("[DASHBOARD] overview active batch query failed: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
+		return
+	}
+	recentTasks, err := h.dashboardRecentTasks(tx, scope, q.RecentLimit)
+	if err != nil {
+		logger.Printf("[DASHBOARD] overview recent task query failed: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
+		return
+	}
+	previews, err := h.dashboardPreviews(tx, scope, q.PreviewLimit)
+	if err != nil {
+		logger.Printf("[DASHBOARD] overview preview query failed: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
+		return
+	}
+
+	if err := tx.Commit(); err != nil {
+		logger.Printf("[DASHBOARD] overview commit read transaction failed: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
+		return
+	}
+
+	devices := buildOverviewDevices(stations)
+	c.JSON(http.StatusOK, productionDashboardOverviewResponse{
+		GeneratedAt:            time.Now().UTC().Format(time.RFC3339),
+		Scope:                  scope,
+		Summary:                buildOverviewSummary(tasks, todayTasks, quality, totalDurationSec, devices, len(activeBatches)),
+		Trend:                  trend,
+		TaskStatusDistribution: buildTaskStatusDistribution(tasks),
+		Quality: dashboardOverviewQuality{
+			PassRate:       quality.PassRate,
+			TotalInspected: quality.TotalInspected,
+			Passed:         quality.Passed,
+			Failed:         quality.Failed,
+			Inspecting:     quality.Inspecting,
+			PendingQA:      quality.PendingQA,
+			RecentFailures: []dashboardQualityRecentFailure{},
+		},
+		Devices:     devices,
+		RecentTasks: recentTasks,
+		Alerts:      []dashboardOverviewAlert{},
+		Previews:    previews,
+	})
+}
+
 // GetBatchTaskSummary returns task status counts grouped by SOP/scene/subscene for one batch.
 func (h *ProductionDashboardHandler) GetBatchTaskSummary(c *gin.Context) {
 	claims := middleware.GetClaims(c)
@@ -420,6 +709,14 @@ func parseProductionDashboardQuery(c *gin.Context) (productionDashboardQuery, er
 	if err != nil {
 		return productionDashboardQuery{}, err
 	}
+	recentLimit, err := parseBoundedIntQuery(c, "recent_limit", defaultDashboardRecentLimit, 1, maxDashboardRecentLimit)
+	if err != nil {
+		return productionDashboardQuery{}, err
+	}
+	previewLimit, err := parseBoundedIntQuery(c, "preview_limit", defaultDashboardPreviewLimit, 1, maxDashboardPreviewLimit)
+	if err != nil {
+		return productionDashboardQuery{}, err
+	}
 	timezoneOffset, err := parseStatsTimezoneOffset(c.Query("timezone_offset"))
 	if err != nil {
 		return productionDashboardQuery{}, err
@@ -432,6 +729,8 @@ func parseProductionDashboardQuery(c *gin.Context) (productionDashboardQuery, er
 		TrendDays:         trendDays,
 		DistributionLimit: distributionLimit,
 		ActiveLimit:       activeLimit,
+		RecentLimit:       recentLimit,
+		PreviewLimit:      previewLimit,
 		TimezoneOffset:    timezoneOffset,
 	}, nil
 }
@@ -516,6 +815,24 @@ func emptyProductionDashboardSnapshot(scope productionDashboardScope) production
 	}
 }
 
+func emptyProductionDashboardOverview(scope productionDashboardScope) productionDashboardOverviewResponse {
+	return productionDashboardOverviewResponse{
+		GeneratedAt:            time.Now().UTC().Format(time.RFC3339),
+		Scope:                  scope,
+		Trend:                  []dashboardTrendItem{},
+		TaskStatusDistribution: []dashboardStatusDistributionItem{},
+		Quality: dashboardOverviewQuality{
+			RecentFailures: []dashboardQualityRecentFailure{},
+		},
+		Devices: dashboardOverviewDevices{
+			Items: []dashboardDeviceItem{},
+		},
+		RecentTasks: []dashboardRecentTaskItem{},
+		Alerts:      []dashboardOverviewAlert{},
+		Previews:    []dashboardPreviewItem{},
+	}
+}
+
 func (h *ProductionDashboardHandler) dashboardTaskCounts(db dashboardDB, scope productionDashboardScope) (dashboardTaskCounts, error) {
 	conditions := []string{"t.deleted_at IS NULL"}
 	args := []interface{}{}
@@ -536,6 +853,27 @@ func (h *ProductionDashboardHandler) dashboardTaskCounts(db dashboardDB, scope p
 	return row, db.Get(&row, query, args...)
 }
 
+func (h *ProductionDashboardHandler) dashboardTodayTaskCount(db dashboardDB, scope productionDashboardScope, q productionDashboardQuery) (int64, error) {
+	location := fixedZoneFromOffset(q.TimezoneOffset)
+	nowLocal := time.Now().In(location)
+	startLocal := time.Date(nowLocal.Year(), nowLocal.Month(), nowLocal.Day(), 0, 0, 0, 0, location)
+	endLocal := startLocal.AddDate(0, 0, 1)
+
+	conditions := []string{"t.deleted_at IS NULL", "t.created_at >= ?", "t.created_at < ?"}
+	args := []interface{}{startLocal.UTC(), endLocal.UTC()}
+	conditions, args = appendDashboardTaskScope(conditions, args, scope)
+	query := `
+		SELECT COUNT(1)
+		FROM tasks t
+		WHERE ` + strings.Join(conditions, " AND ")
+
+	var count sql.NullInt64
+	if err := db.Get(&count, query, args...); err != nil {
+		return 0, err
+	}
+	return nullInt64(count), nil
+}
+
 func (h *ProductionDashboardHandler) dashboardTaskTrend(db dashboardDB, scope productionDashboardScope, q productionDashboardQuery) ([]dashboardTrendItem, error) {
 	location := fixedZoneFromOffset(q.TimezoneOffset)
 	endLocal := time.Now().In(location).AddDate(0, 0, 1)
@@ -555,7 +893,8 @@ func (h *ProductionDashboardHandler) dashboardTaskTrend(db dashboardDB, scope pr
 			DATE_FORMAT(` + localEventExpr + `, '%m-%d') AS date,
 			COALESCE(SUM(CASE WHEN t.status = 'completed' THEN 1 ELSE 0 END), 0) AS completed,
 			COALESCE(SUM(CASE WHEN t.status = 'in_progress' THEN 1 ELSE 0 END), 0) AS in_progress,
-			COALESCE(SUM(CASE WHEN t.status IN ('pending', 'ready') THEN 1 ELSE 0 END), 0) AS pending
+			COALESCE(SUM(CASE WHEN t.status IN ('pending', 'ready') THEN 1 ELSE 0 END), 0) AS pending,
+			COALESCE(SUM(CASE WHEN t.status = 'failed' THEN 1 ELSE 0 END), 0) AS failed
 		FROM tasks t
 		WHERE ` + strings.Join(conditions, " AND ") + `
 		GROUP BY date
@@ -654,11 +993,13 @@ func (h *ProductionDashboardHandler) dashboardStations(db dashboardDB, scope pro
 	query := `
 		SELECT
 			CAST(ws.id AS CHAR) AS id,
+			COALESCE(ws.name, '') AS name,
 			COALESCE(ws.status, '') AS status,
 			COALESCE(ws.collector_operator_id, '') AS collector_operator_id,
 			COALESCE(ws.collector_name, '') AS collector_name,
 			COALESCE(ws.robot_serial, '') AS device_id,
-			COALESCE(ws.robot_name, '') AS device_model
+			COALESCE(ws.robot_name, '') AS device_model,
+			COALESCE(ws.robot_name, '') AS robot_name
 		FROM workstations ws
 		WHERE ` + strings.Join(conditions, " AND ") + `
 		ORDER BY
@@ -791,6 +1132,225 @@ func (h *ProductionDashboardHandler) dashboardActiveTasks(db dashboardDB, scope
 	return items, db.Select(&items, query, args...)
 }
 
+func (h *ProductionDashboardHandler) dashboardRecentTasks(db dashboardDB, scope productionDashboardScope, limit int) ([]dashboardRecentTaskItem, error) {
+	conditions := []string{"t.deleted_at IS NULL"}
+	args := []interface{}{}
+	conditions, args = appendDashboardTaskScope(conditions, args, scope)
+	taskNameExpr := dashboardTaskNameSQL("t.scene_name", "t.subscene_name", "t.sop_id", "s.slug", "s.version")
+	query := `
+		SELECT
+			CAST(t.id AS CHAR) AS id,
+			COALESCE(NULLIF(t.task_id, ''), CAST(t.id AS CHAR)) AS task_id,
+			` + taskNameExpr + ` AS task_name,
+			COALESCE(t.status, '') AS status,
+			COALESCE(ws.robot_name, ws.robot_serial, '') AS robot_name,
+			COALESCE(ws.name, CAST(ws.id AS CHAR), '') AS station_name,
+			COALESCE(b.batch_id, '') AS batch_id,
+			COALESCE(NULLIF(t.scene_name, ''), '') AS scene_name,
+			` + dashboardSOPLabelSQL("t.sop_id", "s.slug", "s.version") + ` AS sop_label,
+			COALESCE(e.episode_id, '') AS episode_id,
+			t.created_at AS created_at,
+			COALESCE(t.updated_at, t.completed_at, t.started_at, t.assigned_at, t.created_at) AS updated_at
+		FROM tasks t
+		LEFT JOIN sops s ON s.id = t.sop_id AND s.deleted_at IS NULL
+		LEFT JOIN batches b ON b.id = t.batch_id AND b.deleted_at IS NULL
+		LEFT JOIN workstations ws ON ws.id = t.workstation_id AND ws.deleted_at IS NULL
+		LEFT JOIN (
+			SELECT task_id, MAX(id) AS latest_id
+			FROM episodes
+			WHERE deleted_at IS NULL
+			GROUP BY task_id
+		) latest_episode ON latest_episode.task_id = t.id
+		LEFT JOIN episodes e ON e.id = latest_episode.latest_id AND e.deleted_at IS NULL
+		WHERE ` + strings.Join(conditions, " AND ") + `
+		ORDER BY COALESCE(t.updated_at, t.completed_at, t.started_at, t.assigned_at, t.created_at) DESC, t.id DESC
+		LIMIT ?
+	`
+	args = append(args, limit)
+	rows := []dashboardRecentTaskRow{}
+	if err := db.Select(&rows, query, args...); err != nil {
+		return nil, err
+	}
+
+	items := make([]dashboardRecentTaskItem, 0, len(rows))
+	for _, row := range rows {
+		items = append(items, dashboardRecentTaskItem{
+			ID:          row.ID,
+			TaskID:      row.TaskID,
+			TaskName:    row.TaskName,
+			Status:      row.Status,
+			StatusText:  dashboardTaskStatusText(row.Status),
+			RobotName:   row.RobotName,
+			StationName: row.StationName,
+			BatchID:     row.BatchID,
+			SceneName:   row.SceneName,
+			SOPLabel:    row.SOPLabel,
+			EpisodeID:   row.EpisodeID,
+			CreatedAt:   formatNullableTime(row.CreatedAt),
+			UpdatedAt:   formatNullableTime(row.UpdatedAt),
+		})
+	}
+	return items, nil
+}
+
+func (h *ProductionDashboardHandler) dashboardPreviews(db dashboardDB, scope productionDashboardScope, limit int) ([]dashboardPreviewItem, error) {
+	conditions := []string{"e.deleted_at IS NULL"}
+	args := []interface{}{}
+	conditions, args = appendDashboardEpisodeScope(conditions, args, scope)
+	taskNameExpr := dashboardTaskNameSQL("t.scene_name", "t.subscene_name", "t.sop_id", "s.slug", "s.version")
+	query := `
+		SELECT
+			CAST(e.id AS CHAR) AS id,
+			CONCAT('Episode ', COALESCE(NULLIF(e.episode_id, ''), CAST(e.id AS CHAR))) AS title,
+			` + taskNameExpr + ` AS task_name,
+			COALESCE(ws.robot_name, ws.robot_serial, '') AS robot_name,
+			COALESCE(ws.name, CAST(ws.id AS CHAR), '') AS station_name,
+			COALESCE(NULLIF(t.status, ''), e.qa_status, '') AS status,
+			COALESCE(e.mcap_path, '') AS mcap_path,
+			e.duration_sec AS duration_seconds,
+			e.created_at AS created_at,
+			COALESCE(e.episode_id, '') AS episode_id,
+			COALESCE(NULLIF(t.task_id, ''), CAST(t.id AS CHAR), '') AS task_id
+		FROM episodes e
+		LEFT JOIN tasks t ON t.id = e.task_id AND t.deleted_at IS NULL
+		LEFT JOIN sops s ON s.id = t.sop_id AND s.deleted_at IS NULL
+		LEFT JOIN workstations ws ON ws.id = e.workstation_id AND ws.deleted_at IS NULL
+		WHERE ` + strings.Join(conditions, " AND ") + `
+		ORDER BY e.created_at DESC, e.id DESC
+		LIMIT ?
+	`
+	args = append(args, limit)
+	rows := []dashboardPreviewRow{}
+	if err := db.Select(&rows, query, args...); err != nil {
+		return nil, err
+	}
+
+	items := make([]dashboardPreviewItem, 0, len(rows))
+	for _, row := range rows {
+		items = append(items, dashboardPreviewItem{
+			ID:              row.ID,
+			Title:           row.Title,
+			TaskName:        row.TaskName,
+			RobotName:       row.RobotName,
+			StationName:     row.StationName,
+			Status:          row.Status,
+			VideoURL:        "",
+			PreviewURL:      dashboardEpisodePreviewURL(row.ID, row.McapPath),
+			PosterURL:       "",
+			DurationSeconds: nullFloat64(row.DurationSeconds),
+			CreatedAt:       formatNullableTime(row.CreatedAt),
+			EpisodeID:       row.EpisodeID,
+			TaskID:          row.TaskID,
+		})
+	}
+	return items, nil
+}
+
+func dashboardEpisodePreviewURL(id string, mcapPath string) string {
+	episodeID := strings.TrimSpace(id)
+	if episodeID == "" || strings.TrimSpace(mcapPath) == "" {
+		return ""
+	}
+	return "/api/v1/episodes/" + url.PathEscape(episodeID) + "/presign?kind=mcap"
+}
+
+func buildOverviewSummary(
+	tasks dashboardTaskCounts,
+	todayTasks int64,
+	quality dashboardQuality,
+	totalDurationSec float64,
+	devices dashboardOverviewDevices,
+	activeBatchCount int,
+) dashboardOverviewSummary {
+	return dashboardOverviewSummary{
+		TotalTasks:           tasks.Total,
+		TodayTasks:           todayTasks,
+		CompletedTasks:       tasks.Completed,
+		InProgressTasks:      tasks.InProgress,
+		PendingTasks:         tasks.Pending + tasks.Ready,
+		FailedTasks:          tasks.Failed,
+		CancelledTasks:       tasks.Cancelled,
+		ActiveBatches:        int64(activeBatchCount),
+		ActiveStations:       devices.Summary.Online,
+		TotalStations:        devices.Summary.Total,
+		RobotOnlineRate:      devices.Summary.OnlineRate,
+		QualityPassRate:      quality.PassRate,
+		TotalDataDurationSec: totalDurationSec,
+	}
+}
+
+func buildTaskStatusDistribution(tasks dashboardTaskCounts) []dashboardStatusDistributionItem {
+	items := []dashboardStatusDistributionItem{
+		{Status: "pending", Label: dashboardTaskStatusText("pending"), Value: tasks.Pending},
+		{Status: "ready", Label: dashboardTaskStatusText("ready"), Value: tasks.Ready},
+		{Status: "in_progress", Label: dashboardTaskStatusText("in_progress"), Value: tasks.InProgress},
+		{Status: "completed", Label: dashboardTaskStatusText("completed"), Value: tasks.Completed},
+		{Status: "failed", Label: dashboardTaskStatusText("failed"), Value: tasks.Failed},
+		{Status: "cancelled", Label: dashboardTaskStatusText("cancelled"), Value: tasks.Cancelled},
+	}
+	filtered := make([]dashboardStatusDistributionItem, 0, len(items))
+	for _, item := range items {
+		if item.Value > 0 {
+			filtered = append(filtered, item)
+		}
+	}
+	return filtered
+}
+
+func buildOverviewDevices(stations []dashboardStationItem) dashboardOverviewDevices {
+	items := make([]dashboardDeviceItem, 0, len(stations))
+	var summary dashboardDeviceSummary
+	for _, station := range stations {
+		status, statusText := overviewDeviceStatus(station.Status)
+		switch status {
+		case "busy":
+			summary.Busy++
+			summary.Online++
+		case "idle":
+			summary.Idle++
+			summary.Online++
+		case "offline":
+			summary.Offline++
+		default:
+			summary.Abnormal++
+		}
+		items = append(items, dashboardDeviceItem{
+			ID:                  station.ID,
+			Name:                firstNonEmpty(station.Name, station.RobotName, station.DeviceID, station.ID),
+			StationName:         firstNonEmpty(station.Name, station.ID),
+			Status:              status,
+			StatusText:          statusText,
+			RobotName:           firstNonEmpty(station.RobotName, station.DeviceModel, station.DeviceID),
+			RobotID:             station.DeviceID,
+			CollectorOperatorID: station.CollectorOperatorID,
+			CollectorName:       station.CollectorName,
+		})
+	}
+	summary.Total = int64(len(stations))
+	if summary.Total > 0 {
+		summary.OnlineRate = math.Round((float64(summary.Online)/float64(summary.Total))*1000) / 10
+	}
+	return dashboardOverviewDevices{
+		Summary: summary,
+		Items:   items,
+	}
+}
+
+func overviewDeviceStatus(status string) (string, string) {
+	switch status {
+	case "active":
+		return "busy", "生产中"
+	case "inactive":
+		return "idle", "待命中"
+	case "break":
+		return "idle", "休息中"
+	case "offline":
+		return "offline", "离线"
+	default:
+		return "abnormal", firstNonEmpty(status, "异常")
+	}
+}
+
 func appendDashboardTaskScope(conditions []string, args []interface{}, scope productionDashboardScope) ([]string, []interface{}) {
 	if scope.Role == "data_collector" {
 		conditions = append(conditions, `EXISTS (
@@ -894,6 +1454,17 @@ func dashboardSOPLabelSQL(sopIDExpr string, slugExpr string, versionExpr string)
 	END`
 }
 
+func dashboardTaskNameSQL(sceneExpr string, subsceneExpr string, sopIDExpr string, slugExpr string, versionExpr string) string {
+	return `CASE
+		WHEN NULLIF(TRIM(COALESCE(` + sceneExpr + `, '')), '') IS NOT NULL
+			AND NULLIF(TRIM(COALESCE(` + subsceneExpr + `, '')), '') IS NOT NULL
+			THEN CONCAT(` + sceneExpr + `, ' / ', ` + subsceneExpr + `)
+		WHEN NULLIF(TRIM(COALESCE(` + sceneExpr + `, '')), '') IS NOT NULL THEN ` + sceneExpr + `
+		WHEN NULLIF(TRIM(COALESCE(` + subsceneExpr + `, '')), '') IS NOT NULL THEN ` + subsceneExpr + `
+		ELSE ` + dashboardSOPLabelSQL(sopIDExpr, slugExpr, versionExpr) + `
+	END`
+}
+
 func dashboardStationStatusText(status string) string {
 	switch status {
 	case "active":
@@ -909,6 +1480,25 @@ func dashboardStationStatusText(status string) string {
 	}
 }
 
+func dashboardTaskStatusText(status string) string {
+	switch status {
+	case "pending":
+		return "待开始"
+	case "ready":
+		return "就绪"
+	case "in_progress":
+		return "进行中"
+	case "completed":
+		return "已完成"
+	case "failed":
+		return "失败"
+	case "cancelled":
+		return "已取消"
+	default:
+		return firstNonEmpty(status, "未知")
+	}
+}
+
 func countOnlineDashboardStations(stations []dashboardStationItem) int64 {
 	var count int64
 	for _, station := range stations {
@@ -932,6 +1522,22 @@ func fixedZoneFromOffset(offset string) *time.Location {
 	return time.FixedZone(offset, sign*((hours*60+minutes)*60))
 }
 
+func formatNullableTime(value sql.NullTime) string {
+	if !value.Valid {
+		return ""
+	}
+	return value.Time.UTC().Format(time.RFC3339)
+}
+
+func firstNonEmpty(values ...string) string {
+	for _, value := range values {
+		if strings.TrimSpace(value) != "" {
+			return value
+		}
+	}
+	return ""
+}
+
 func nullFloat64(v sql.NullFloat64) float64 {
 	if !v.Valid {
 		return 0
diff --git a/internal/api/handlers/production_dashboard_test.go b/internal/api/handlers/production_dashboard_test.go
index 545794d..54d105b 100644
--- a/internal/api/handlers/production_dashboard_test.go
+++ b/internal/api/handlers/production_dashboard_test.go
@@ -16,7 +16,7 @@ import (
 func TestParseProductionDashboardQueryDefaultsAndBounds(t *testing.T) {
 	gin.SetMode(gin.TestMode)
 
-	req := httptest.NewRequest(http.MethodGet, "/dashboard/snapshot?workstation_id=12&factory_id=34&organization_id=56&trend_days=99&distribution_limit=999&active_limit=999&timezone_offset=%2B08:00", nil)
+	req := httptest.NewRequest(http.MethodGet, "/dashboard/snapshot?workstation_id=12&factory_id=34&organization_id=56&trend_days=99&distribution_limit=999&active_limit=999&recent_limit=999&preview_limit=999&timezone_offset=%2B08:00", nil)
 	c, _ := gin.CreateTestContext(httptest.NewRecorder())
 	c.Request = req
 
@@ -36,6 +36,12 @@ func TestParseProductionDashboardQueryDefaultsAndBounds(t *testing.T) {
 	if got.ActiveLimit != maxDashboardActiveLimit {
 		t.Fatalf("active limit = %d, want %d", got.ActiveLimit, maxDashboardActiveLimit)
 	}
+	if got.RecentLimit != maxDashboardRecentLimit {
+		t.Fatalf("recent limit = %d, want %d", got.RecentLimit, maxDashboardRecentLimit)
+	}
+	if got.PreviewLimit != maxDashboardPreviewLimit {
+		t.Fatalf("preview limit = %d, want %d", got.PreviewLimit, maxDashboardPreviewLimit)
+	}
 	if got.TimezoneOffset != "+08:00" {
 		t.Fatalf("timezone offset = %q, want +08:00", got.TimezoneOffset)
 	}
@@ -47,6 +53,8 @@ func TestParseProductionDashboardQueryValidation(t *testing.T) {
 	tests := []string{
 		"/dashboard/snapshot?workstation_id=0",
 		"/dashboard/snapshot?trend_days=0",
+		"/dashboard/snapshot?recent_limit=0",
+		"/dashboard/snapshot?preview_limit=0",
 		"/dashboard/snapshot?timezone_offset=08:00",
 	}
 
@@ -127,6 +135,66 @@ func TestDashboardActiveBatchesQueryLimitsBeforeTaskAggregation(t *testing.T) {
 	}
 }
 
+func TestProductionDashboardOverviewEmptyScopeKeepsContract(t *testing.T) {
+	scope := productionDashboardScope{
+		Role:    "data_collector",
+		Warning: "workstation not assigned",
+		empty:   true,
+	}
+
+	got := emptyProductionDashboardOverview(scope)
+	if got.Scope.Warning != "workstation not assigned" {
+		t.Fatalf("scope warning = %q", got.Scope.Warning)
+	}
+	if got.Summary.TotalTasks != 0 || got.Summary.TodayTasks != 0 {
+		t.Fatalf("summary should stay zero: %+v", got.Summary)
+	}
+	if len(got.Trend) != 0 ||
+		len(got.TaskStatusDistribution) != 0 ||
+		len(got.Devices.Items) != 0 ||
+		len(got.RecentTasks) != 0 ||
+		len(got.Previews) != 0 {
+		t.Fatalf("empty overview arrays should be empty: %+v", got)
+	}
+	if got.Quality.RecentFailures == nil {
+		t.Fatalf("quality recent_failures should be an empty array, not nil")
+	}
+}
+
+func TestProductionDashboardOverviewDistributionAndDevices(t *testing.T) {
+	distribution := buildTaskStatusDistribution(dashboardTaskCounts{
+		Completed:  3,
+		InProgress: 2,
+		Pending:    1,
+	})
+	if len(distribution) != 3 {
+		t.Fatalf("distribution len = %d, want 3: %+v", len(distribution), distribution)
+	}
+
+	devices := buildOverviewDevices([]dashboardStationItem{
+		{ID: "1", Name: "A", Status: "active"},
+		{ID: "2", Name: "B", Status: "inactive"},
+		{ID: "3", Name: "C", Status: "offline"},
+	})
+	if devices.Summary.Total != 3 || devices.Summary.Online != 2 || devices.Summary.Offline != 1 {
+		t.Fatalf("unexpected device summary: %+v", devices.Summary)
+	}
+	if devices.Summary.OnlineRate != 66.7 {
+		t.Fatalf("online rate = %.1f, want 66.7", devices.Summary.OnlineRate)
+	}
+}
+
+func TestProductionDashboardEpisodePreviewURL(t *testing.T) {
+	got := dashboardEpisodePreviewURL("42", "mcap/episode-42.mcap")
+	if got != "/api/v1/episodes/42/presign?kind=mcap" {
+		t.Fatalf("preview url = %q", got)
+	}
+
+	if got := dashboardEpisodePreviewURL("42", ""); got != "" {
+		t.Fatalf("preview url without mcap path = %q, want empty", got)
+	}
+}
+
 func TestProductionDashboardRoutesCanRegister(t *testing.T) {
 	gin.SetMode(gin.TestMode)
 

From a9c4f5613a590ec0192e78eddd3b02a46ffeb20b Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Sun, 17 May 2026 23:00:59 +0800
Subject: [PATCH 02/17] docs(production): document recorded-speed mcap playback

---
 docs/designs/synapse-production-big-screen-tasks.md |  3 +++
 docs/designs/synapse-production-big-screen.md       | 12 +++++++++++-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/docs/designs/synapse-production-big-screen-tasks.md b/docs/designs/synapse-production-big-screen-tasks.md
index fa6d33d..297a6a1 100644
--- a/docs/designs/synapse-production-big-screen-tasks.md
+++ b/docs/designs/synapse-production-big-screen-tasks.md
@@ -241,6 +241,8 @@ npm run build
 - `replay current` 是唯一允许 seek 到 0 的路径，只能用于 next 等待 10 秒仍未 armed 后的当前条重播。
 - MCAP next 准备阶段只读取 metadata 和有上限的起播帧窗口，armed 后可后台补齐剩余有限帧；warm handoff cache 也必须有数量上限，不得无上限缓存大量帧。
 - MCAP 播放不得用取模循环反复播放开头帧；到达当前已准备帧序列末尾时，如果补齐仍在进行则停最后一帧等待，补齐失败或等待超时后进入 next 检查。
+- MCAP 播放速度按 image message 的录制 timestamp 驱动，优先使用 `logTime` 计算相邻帧延迟；`duration_seconds / frame_count` 只能作为 timestamp 不可用时的 fallback。
+- MCAP timestamp 在前端必须以字符串或 `BigInt` 保存，避免 JavaScript `Number` 丢失纳秒级精度；timestamp 缺失、重复、倒退或异常 gap 需要有保守 fallback 和最小/最大延迟 clamp。
 - `video_url` 缺失且 MCAP 不可用时才使用 `poster_url` 或轻量等待状态，主舞台不显示大段任务文字。
 - `video_url` 非空时必须是真实可播放视频 URL，不能使用 MCAP presigned URL、poster、内部对象路径或 mock URL 冒充。
 - 动画使用 `transform`、`opacity`、低强度 `filter` 和 `perspective`。
@@ -251,6 +253,7 @@ npm run build
 
 - 有真实 `video_url` 时可以飞入、播放、结束后飞出并切换下一条。
 - 无 `video_url` 但有 `preview_url` 时可以自动播放 MCAP 图像帧；不渲染 `<video>`，但舞台必须有真实视觉内容。
+- MCAP 图像帧播放速度应接近录制速度；不能因为 episode `duration_seconds` 或固定 fps 让正常数据明显加速/减速。
 - 从第二条开始，当前条播放期间应已经开始准备 next media slot；网络正常时不应出现明显黑屏、长时间加载或大段文字占位。
 - 下一条未 ready 时不应强切空白舞台，应保留当前最后画面最多 10 秒；仍未 ready 时重播当前条。
 - 已 armed 的真实视频 next 激活时不应重复播放开头帧；激活过程不得重建播放器、重设 `src` 或主动 seek 到 0。
diff --git a/docs/designs/synapse-production-big-screen.md b/docs/designs/synapse-production-big-screen.md
index 6585cf2..2f39f6f 100644
--- a/docs/designs/synapse-production-big-screen.md
+++ b/docs/designs/synapse-production-big-screen.md
@@ -275,6 +275,7 @@ loading -> entering -> playing -> leaving -> loading(next)
 - current 正常切到 next 后，旧 current slot 才进入 idle；若它仍在轮播队列中且是 MCAP 资源，可先进入有上限的 warm handoff cache，否则释放资源。
 - 数据刷新只更新队列和元信息，不控制 current 的媒体时间轴。
 - MCAP 帧预览必须按有限帧序列播放；next armed 后可在后台继续补齐剩余有限帧。播放到当前已准备序列末尾但补齐仍在进行时停在最后一帧等待补齐，补齐失败或等待超时后再进入 next 检查；不允许用取模循环反复播放开头帧。
+- MCAP 播放速度应优先使用图像 message 的录制时间戳驱动。前端以相邻帧 `logTime` / timestamp 差值调度下一帧，不使用 `duration_seconds / frame_count` 推导平均帧率作为主路径；时间戳缺失、重复、倒退或异常时才退回保守 fallback 间隔。
 
 ### 5.1.2 不间断轮播边界
 
@@ -333,9 +334,17 @@ loading -> entering -> playing -> leaving -> loading(next)
 当前系统的真实预览更接近 MCAP 数据预览，而不是现成 MP4 视频。第一版必须明确区分“真实视频播放”和“数据预览帧播放”：
 
 - `video_url`：真实可直接播放的视频 URL，第一优先；非空时必须能被 `<video>` 播放，不能返回 MCAP presigned URL、poster URL、内部对象路径或 mock URL。
-- `preview_url`：可预览的数据 URL，例如 episode presign API 或 MCAP storage proxy URL；不是 `<video>` 的 `src`，而是前端复用 `DataPreview.vue` / `useMcapReader.js` 读取图像或压缩图像 topic 后按帧渲染。
+- `preview_url`：可预览的数据 URL，例如 episode presign API 或 MCAP storage proxy URL；不是 `<video>` 的 `src`，而是前端复用 `DataPreview.vue` / `useMcapReader.js` 读取图像或压缩图像 topic 后按帧渲染，并按 MCAP message 时间戳恢复录制节奏。
 - `poster_url`：静态封面或后端生成缩略图。
 
+MCAP 图像帧播放规则：
+
+- 优先读取每条 image message 的 `logTime` 作为录制时间轴；如果后续确认传感器 `publishTime` 更能代表业务时间线，可以改为优先 `publishTime`、缺失时退回 `logTime`。
+- 下一帧延迟等于 `next.timestamp - current.timestamp`，单位从纳秒转换为毫秒；timestamp 必须保持字符串或 `BigInt`，不能用 JavaScript `Number` 存储纳秒级大整数。
+- `duration_seconds` 只作为缺失时间戳时的 fallback 信息，不应作为正常播放速度来源。
+- 对异常 timestamp 做保护：缺失、重复、倒退时退回 fallback 帧间隔；超长 gap 可以设上限，避免大屏看起来卡死。
+- 预载窗口仍有帧数/资源上限；播放到已加载尾部但后续帧仍在补齐时，停在最后一帧等待补齐，不取模回放开头。
+
 fallback 策略：
 
 | 场景 | 显示策略 |
@@ -779,6 +788,7 @@ page mounted
 - `previews` 队列最多保留 8 到 12 条，避免大量视频资源占用。
 - 不做 2 到 3 条前瞻预载；任意时刻只允许一个 current 播放资源和一个 next 准备资源，避免无上限创建 hidden video、MCAP reader 或 object URL。
 - 下一条未 ready 时不得清空当前舞台；current 停在最后一帧并最多等待 10 秒，超时后从头重播 current，同时继续准备同一个 next。
+- MCAP 播放 timer 应按录制 timestamp 计算下一帧延迟；如果 timestamp 不可信，fallback 到固定保守帧间隔，并对最小/最大延迟做 clamp。
 - 动画元素数量固定，避免每次轮播创建大量 DOM。
 - timers、ResizeObserver、fullscreen listener、current/next video listener、hidden next video、MCAP reader 和 object URL 必须在 unmount 清理。
 - 长列表只展示有限条目，大屏不是审计表格。

From 91bed203d12d81def13d33ab7fb33d86f8bc3114 Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Sun, 17 May 2026 23:56:33 +0800
Subject: [PATCH 03/17] docs(production): document tv scaling dashboard layout

---
 docs/designs/synapse-production-big-screen-tasks.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/designs/synapse-production-big-screen-tasks.md b/docs/designs/synapse-production-big-screen-tasks.md
index 297a6a1..5d9a05b 100644
--- a/docs/designs/synapse-production-big-screen-tasks.md
+++ b/docs/designs/synapse-production-big-screen-tasks.md
@@ -295,6 +295,12 @@ npm run build
 - 任务流显示最近任务，不做后台表格。
 - 异常状态内联展示在顶部状态、设备状态和任务流中，不新增告警栏。
 - 图表和列表不抢中央舞台视觉中心。
+- 本轮一屏化改造将 `/admin/dashboard` 作为沉浸式大屏路由处理，隐藏常规后台侧栏，页面根容器使用 `100dvh` 锁高，并让外层内容区 `overflow: hidden`；不能通过页面纵向滚动或 `overflow-y: auto` 兜底。
+- 大屏主体采用三行布局：顶部状态栏、KPI 条、主驾驶舱 grid。主驾驶舱再分为设备状态、中央 Video Flight Stage + 趋势、最近任务流三列，所有列都使用 `minmax(0, 1fr)` 和 `min-height: 0` 允许内部压缩。
+- `1366x768` 与 `1600x900` 下优先保留顶部状态、8 个 KPI、Video Flight Stage、趋势、设备状态和最近任务流；设备/任务列表可减少条目，质量指标压缩为任务流内的窄条，不再占用独立面板。
+- 70 寸电视或浏览器页面缩放放大时，按 125% 到 165% 页面缩放后的等效视口兜底验证，例如 `1536x864`、`1280x720`、`1152x648`；这些尺寸仍应保持三列驾驶舱，不应触发普通后台或移动端纵向堆叠。
+- 趋势区域使用紧凑的语义色堆叠条表达 completed / in_progress / pending / failed，不在本轮引入 ECharts，避免为一屏高度和 resize 生命周期增加复杂度。
+- 空数据、API 失败和 fallback 数据仍复用 `useProductionBigScreenData.js` 的稳定结构；布局高度不因错误提示、空状态或刷新按钮出现而变化。
 
 **验收标准:**
 
@@ -302,6 +308,7 @@ npm run build
 - 图表 resize 正常，组件卸载时 dispose。
 - 任务流和设备列表数量受限，不造成小屏溢出。
 - API 失败时有可见降级提示。
+- `3840x2160`、`2560x1440`、`1920x1080`、`1600x900`、`1366x768` 横屏视口下，document/body 不出现纵向滚动，dashboard 根容器高度不超过 viewport，核心区域不重叠。
 
 **验证命令:**
 

From fc9d138358880c8fc4eb2fc37134694918defcc2 Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Mon, 18 May 2026 00:17:14 +0800
Subject: [PATCH 04/17] docs(production): define device health summary panel

---
 .../synapse-production-big-screen-tasks.md    |  6 +++
 docs/designs/synapse-production-big-screen.md | 39 ++++++++++++++++---
 2 files changed, 39 insertions(+), 6 deletions(-)

diff --git a/docs/designs/synapse-production-big-screen-tasks.md b/docs/designs/synapse-production-big-screen-tasks.md
index 5d9a05b..d95bcb7 100644
--- a/docs/designs/synapse-production-big-screen-tasks.md
+++ b/docs/designs/synapse-production-big-screen-tasks.md
@@ -292,6 +292,10 @@ npm run build
 
 - 趋势图复用 ECharts，更新时复用实例。
 - 设备状态清楚区分 online、idle、busy、offline、abnormal。
+- 设备状态区不再渲染具体设备、工位、机器人、操作员或当前任务明细；改为设备整体与工位整体的状态摘要、在线率、状态分布条和抽象状态矩阵。
+- 第一版可继续使用现有 `devices.summary` / `devices.items` 计算摘要和矩阵数量，但 UI 只表达状态，不显示具体名称；后续如需严格拆分，可再扩展 overview API 的 `robots.summary` 与 `stations.summary`。
+- 可以为设备/工位状态加入克制 CSS 动效：忙碌状态灯低幅度呼吸、状态分布条宽度过渡、6 到 8 秒一次的淡巡检扫描、刷新成功短脉冲；必须支持 `prefers-reduced-motion`。
+- 禁止大面积霓虹、持续快速闪烁、跑马灯、雷达式强动效，以及任何会改变 grid track、面板高度或造成滚动的动画。
 - 任务流显示最近任务，不做后台表格。
 - 异常状态内联展示在顶部状态、设备状态和任务流中，不新增告警栏。
 - 图表和列表不抢中央舞台视觉中心。
@@ -305,6 +309,8 @@ npm run build
 **验收标准:**
 
 - `trend`、`devices`、`recent_tasks` 和质量/异常状态均能正常展示。
+- 设备状态区只展示设备/工位聚合健康态，不出现具体设备名、工位名、机器人名、操作员或当前任务明细。
+- 设备/工位状态动画在默认模式下克制可见，在 `prefers-reduced-motion` 下静态或近似静态。
 - 图表 resize 正常，组件卸载时 dispose。
 - 任务流和设备列表数量受限，不造成小屏溢出。
 - API 失败时有可见降级提示。
diff --git a/docs/designs/synapse-production-big-screen.md b/docs/designs/synapse-production-big-screen.md
index 2f39f6f..52414d4 100644
--- a/docs/designs/synapse-production-big-screen.md
+++ b/docs/designs/synapse-production-big-screen.md
@@ -135,15 +135,21 @@ KPI 文案应短，数字应使用 tabular numbers。数字刷新可以轻微计
 
 ### 3.5 设备状态
 
-职责：快速发现设备在线、空闲、忙碌、离线、异常。
+职责：快速发现设备与工位整体是否健康、是否有可用产能、是否存在异常。
+
+大屏上不展示具体设备、工位、机器人或操作员条目。电视观看距离下，逐条列表的信息价值低，且会挤占中央舞台和趋势区域。设备状态区应从“明细列表”改为“设备与工位健康态摘要”。
 
 内容：
 
-- 在线 / 空闲 / 忙碌 / 离线 / 异常汇总
-- 若干关键机器人或工位条目
-- 当前任务、绑定工位、最近心跳或最后活跃时间
+- 设备整体：在线 / 生产中 / 待命 / 离线 / 异常汇总。
+- 工位整体：在线 / 占用 / 空闲 / 离线 / 异常汇总。
+- 设备在线率、工位在线率、生产中数量、可用数量和异常数量。
+- 设备状态分布条与工位状态分布条，使用语义色表达 busy / idle / offline / abnormal。
+- 抽象状态矩阵或状态灯阵：每个格子只表达一个设备或工位的状态，不显示名称、ID、机器人名、操作员或当前任务。
+
+状态颜色应明确但不刺眼。异常要醒目，健康状态要稳定。异常、离线或心跳超时信息仍在设备状态区内联表达，但不新增独立告警栏。
 
-状态颜色应明确但不刺眼。异常要醒目，健康状态要稳定。
+第一版如果 overview 仍只返回 `devices.summary` 和 `devices.items`，前端可以用 `summary` 直接构建设备/工位摘要，并将 `items` 仅作为计算状态矩阵数量的来源，不在 UI 中渲染具体名称。后续如需更严谨地区分机器人与工位，可在 overview 中补充 `robots.summary` 与 `stations.summary`，但这不是当前一屏布局优化的前置条件。
 
 ### 3.6 最近任务流
 
@@ -223,6 +229,27 @@ KPI 文案应短，数字应使用 tabular numbers。数字刷新可以轻微计
 - 任务 ID、设备 ID：等宽字体，支持中间截断或换行。
 - 小屏下用 `clamp()` 限制字号范围，不用 `vw` 线性缩放所有文字。
 
+### 4.5 非视频区域动效
+
+除 Video Flight Stage 外，其他区域可以使用克制、低频、生产语义明确的动效。动效必须帮助观看者理解系统状态，不能成为装饰噪音。
+
+设备与工位状态区允许：
+
+- 忙碌 / 生产中状态灯使用低幅度呼吸动画，表达资源正在工作。
+- 状态分布条在数据刷新时使用宽度过渡，表达状态占比变化。
+- 状态矩阵上使用很淡的巡检扫描线，周期建议 6 到 8 秒，不持续高亮。
+- overview 成功刷新时，在标题状态点或面板边缘做一次短促脉冲。
+- 异常数量从 0 变为大于 0 时做一次轻微强调；异常状态不持续快速闪烁。
+
+禁止：
+
+- 大面积霓虹发光、持续闪烁、跑马灯、雷达式强动效。
+- 每个状态格持续跳动或独立随机动画。
+- 动画改变 grid track、面板高度、列表高度或导致页面滚动。
+- 无数据或 API 失败时仍播放“生产中”动效。
+
+所有非视频动效必须支持 `prefers-reduced-motion`，降级为静态状态或一次性淡入。
+
 ## 5. Video Flight Stage 动画方案
 
 ### 5.1 状态机
@@ -638,7 +665,7 @@ GET /api/v1/production/dashboard/overview
 | `ProductionBigScreen.vue` 或 `FullscreenDashboard.vue` | 页面总装、布局、刷新状态、路由入口 | 刷新 timer、全局 resize |
 | `VideoFlightStage.vue` | 视频轮播状态机、current/next 媒体槽位、fallback | current/next video slot、current/next MCAP reader、stage timer、video event listeners |
 | `BigScreenKpiStrip.vue` | KPI 展示、数字格式化、轻量刷新动效 | 可选数字动画 timer |
-| `BigScreenStatusRail.vue` | 设备状态汇总和关键设备列表 | 无，纯展示 |
+| `BigScreenStatusRail.vue` | 设备与工位状态摘要、分布条、抽象状态矩阵，不展示具体设备列表 | 可选刷新脉冲 / 巡检扫描 CSS 动画 |
 | `BigScreenTaskFeed.vue` | 最近任务流 | 无，纯展示 |
 | `BigScreenTrendPanel.vue` | ECharts 趋势图 | chart instance、ResizeObserver |
 | `useProductionBigScreenData.js` | overview 请求、adapter、mock fallback、刷新调度 | polling timer |

From f6feca1d69fa75b544d60a892982ecdb54ec6e5b Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Mon, 18 May 2026 00:40:43 +0800
Subject: [PATCH 05/17] docs(production): document compact dashboard clock
 requirements

---
 docs/designs/synapse-production-big-screen-tasks.md | 3 +++
 docs/designs/synapse-production-big-screen.md       | 4 ++++
 2 files changed, 7 insertions(+)

diff --git a/docs/designs/synapse-production-big-screen-tasks.md b/docs/designs/synapse-production-big-screen-tasks.md
index d95bcb7..9f4f2fe 100644
--- a/docs/designs/synapse-production-big-screen-tasks.md
+++ b/docs/designs/synapse-production-big-screen-tasks.md
@@ -303,6 +303,7 @@ npm run build
 - 大屏主体采用三行布局：顶部状态栏、KPI 条、主驾驶舱 grid。主驾驶舱再分为设备状态、中央 Video Flight Stage + 趋势、最近任务流三列，所有列都使用 `minmax(0, 1fr)` 和 `min-height: 0` 允许内部压缩。
 - `1366x768` 与 `1600x900` 下优先保留顶部状态、8 个 KPI、Video Flight Stage、趋势、设备状态和最近任务流；设备/任务列表可减少条目，质量指标压缩为任务流内的窄条，不再占用独立面板。
 - 70 寸电视或浏览器页面缩放放大时，按 125% 到 165% 页面缩放后的等效视口兜底验证，例如 `1536x864`、`1280x720`、`1152x648`；这些尺寸仍应保持三列驾驶舱，不应触发普通后台或移动端纵向堆叠。
+- 顶部状态栏在紧凑和缩放等效视口下仍保留完整日期时间 `YYYY/MM/DD HH:mm:ss` 与全屏按钮；不得改成短时间、隐藏时间、隐藏按钮，或把按钮缩小到远距离不可用。
 - 趋势区域使用紧凑的语义色堆叠条表达 completed / in_progress / pending / failed，不在本轮引入 ECharts，避免为一屏高度和 resize 生命周期增加复杂度。
 - 空数据、API 失败和 fallback 数据仍复用 `useProductionBigScreenData.js` 的稳定结构；布局高度不因错误提示、空状态或刷新按钮出现而变化。
 
@@ -315,6 +316,7 @@ npm run build
 - 任务流和设备列表数量受限，不造成小屏溢出。
 - API 失败时有可见降级提示。
 - `3840x2160`、`2560x1440`、`1920x1080`、`1600x900`、`1366x768` 横屏视口下，document/body 不出现纵向滚动，dashboard 根容器高度不超过 viewport，核心区域不重叠。
+- `1366x768`、`1280x720`、`1152x648` 下顶部完整日期时间和全屏按钮均可见，且不触发横向滚动。
 
 **验证命令:**
 
@@ -343,6 +345,7 @@ npm run build
 **实现要点:**
 
 - 检查目标视口：`3840x2160`、`2560x1440`、`1920x1080`、`1600x900`、`1366x768`。
+- 额外检查页面缩放后的等效视口：`1280x720`、`1152x648`；完整日期时间和全屏按钮必须可见。
 - 检查横向滚动、文字重叠、视频舞台被挤压、图表空白。
 - 检查 timer、resize listener、fullscreen listener、chart instance、current/next video listeners、hidden next video、MCAP reader 和 object URL 的释放。
 - 检查轮播资源上限：连续运行时只保留 current + next，hidden video / MCAP reader / object URL 数量不随轮播无限增长。
diff --git a/docs/designs/synapse-production-big-screen.md b/docs/designs/synapse-production-big-screen.md
index 52414d4..180981e 100644
--- a/docs/designs/synapse-production-big-screen.md
+++ b/docs/designs/synapse-production-big-screen.md
@@ -90,6 +90,8 @@ Synapse 生产大屏用于机器人数据生产现场的常驻展示，也用于
 - 今日生产摘要：今日任务、完成、失败
 - 数据刷新时间：`generated_at` 或前端最后成功刷新时间
 
+顶部状态栏在紧凑电视和浏览器页面缩放后的等效视口中仍必须保留完整日期时间与全屏按钮。不能为了压缩布局改成只显示 `HH:mm`、隐藏时间、隐藏全屏按钮，或缩小到远距离不可读；应通过 grid 右侧 `auto` 列、压缩中间摘要、减少次要文案来保证可见性。
+
 ### 3.2 核心 KPI
 
 职责：远距离快速读数。
@@ -452,6 +454,7 @@ fallback 策略：
 布局：
 
 - 顶部状态栏压缩：保留标题、时间、刷新状态，摘要合并为短标签。
+- 当前日期时间保持完整 `YYYY/MM/DD HH:mm:ss`，全屏按钮保持基础触达尺寸，不在紧凑模式隐藏或降级为短时间。
 - KPI 改为 4 列或 2 行。
 - 视频舞台占据主要宽度，侧栏移动到视频下方或双列下方。
 - 趋势图高度降低，任务流和设备列表减少条数。
@@ -460,6 +463,7 @@ fallback 策略：
 
 - 不能横向滚动。
 - 不能让侧栏挤压视频舞台到不可读。
+- 浏览器页面缩放放大后的等效视口，例如 `1280x720`、`1152x648`，仍应显示完整日期时间和全屏按钮；优先压缩中间 telemetry、KPI 行高、列表条数和面板内边距。
 
 #### < 1200px：降级布局
 

From 2f67cc087d47078705b20e9d34991674afc02aa5 Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Mon, 18 May 2026 02:09:41 +0800
Subject: [PATCH 06/17] feat(production): align big screen trend contract

---
 .../synapse-production-big-screen-tasks.md    |  34 +--
 docs/designs/synapse-production-big-screen.md | 117 +++++----
 internal/api/handlers/production_dashboard.go | 248 ++++++++++++------
 .../api/handlers/production_dashboard_test.go |  26 +-
 internal/server/server.go                     |   2 +-
 5 files changed, 279 insertions(+), 148 deletions(-)

diff --git a/docs/designs/synapse-production-big-screen-tasks.md b/docs/designs/synapse-production-big-screen-tasks.md
index 9f4f2fe..1b11886 100644
--- a/docs/designs/synapse-production-big-screen-tasks.md
+++ b/docs/designs/synapse-production-big-screen-tasks.md
@@ -59,8 +59,8 @@ SPDX-License-Identifier: MulanPSL-2.0
 - 复用现有 `resolveProductionDashboardScope()`、查询参数解析、只读事务和 scope 过滤。
 - 新增 overview response structs。
 - 第一版返回完整结构，即使部分数组为空。
-- `summary`、`trend`、`task_status_distribution`、`devices`、`recent_tasks` 优先实现。
-- 第一版不返回独立 `alerts` 字段，不建设告警栏；设备离线、任务失败、接口降级等异常内联展示在顶部状态、设备状态和任务流中。
+- `summary`、`trend`、`task_status_distribution`、`devices`、`stations`、`recent_tasks` 优先实现。
+- 第一版不返回独立 `alerts` 字段，不建设告警栏；设备不在线、工位离线、任务失败、接口降级等异常内联展示在顶部状态、设备/工位状态和任务流中。
 - `previews.video_url` 可以为空，但如果非空必须是真实可播放视频 URL；为空时返回 episode/task 元信息和可解析的 `preview_url`，保证前端可复用数据预览页播放 MCAP 图像帧。
 
 **验收标准:**
@@ -69,7 +69,7 @@ SPDX-License-Identifier: MulanPSL-2.0
 - `data_collector` 自动限定到绑定工位。
 - 空数据返回 200，数值为 0，数组为空。
 - 参数错误返回 400，未认证返回 401。
-- 响应包含 `generated_at`、`scope`、`summary`、`trend`、`task_status_distribution`、`quality`、`devices`、`recent_tasks`、`previews`。
+- 响应包含 `generated_at`、`scope`、`summary`、`trend`、`task_status_distribution`、`quality`、`devices`、`stations`、`recent_tasks`、`previews`。
 - `previews.video_url` 为空时仍有 `title`、`task_name`、`robot_name`、`station_name`、`status`、`created_at`；有 MCAP 时返回 `preview_url`；`video_url` 非空时必须是真实可播放视频。
 
 **验证命令:**
@@ -99,14 +99,15 @@ gofmt -w internal/api/handlers/production_dashboard.go internal/api/handlers/pro
 
 **实现要点:**
 
-- `trend` 增加 `failed`。
-- `devices.items` 增加 `current_task`、`station_name`、`last_seen_at`，字段缺失时返回空字符串。
+- overview `trend` 改为数据生产数量趋势，按 `episodes` 数据生产记录聚合，不再使用任务状态桶作为趋势口径。
+- `devices` 只返回在线/不在线汇总，不返回 `items`；设备在线以 recorder hub 与 transfer hub 均联通为准。
+- `stations.summary` 返回工位管理状态汇总：`active` 执行中、`inactive` 待命中、`break` 休息中、`offline` 离线。
 - `recent_tasks` 覆盖最近完成、失败、进行中的任务。
 - `quality.recent_failures` 如果查询成本可控则实现，否则保留空数组。
 
 **验收标准:**
 
-- overview 中 `trend` 每个点包含 `completed`、`in_progress`、`pending`、`failed`。
+- overview 中 `trend` 每个点包含 `date`、`total`，`total` 表示当天数据生产记录数量。
 - `recent_tasks` 按最近更新时间倒序，受 `recent_limit` 限制。
 - 所有 limit 参数有上限，避免大屏接口返回过大。
 
@@ -290,11 +291,14 @@ npm run build
 
 **实现要点:**
 
-- 趋势图复用 ECharts，更新时复用实例。
-- 设备状态清楚区分 online、idle、busy、offline、abnormal。
-- 设备状态区不再渲染具体设备、工位、机器人、操作员或当前任务明细；改为设备整体与工位整体的状态摘要、在线率、状态分布条和抽象状态矩阵。
-- 第一版可继续使用现有 `devices.summary` / `devices.items` 计算摘要和矩阵数量，但 UI 只表达状态，不显示具体名称；后续如需严格拆分，可再扩展 overview API 的 `robots.summary` 与 `stations.summary`。
-- 可以为设备/工位状态加入克制 CSS 动效：忙碌状态灯低幅度呼吸、状态分布条宽度过渡、6 到 8 秒一次的淡巡检扫描、刷新成功短脉冲；必须支持 `prefers-reduced-motion`。
+- 趋势区域对齐后台“数据生产统计”页面的趋势分析：使用 ECharts，固定近 7 天，时间粒度为天，默认展示每日数据生产“总数量”柱状图。
+- 趋势数据需要补齐 7 个日期桶；API 缺失某一天时显示 0，避免布局和横轴随数据稀疏程度变化。
+- 设备状态只清楚区分在线、不在线；不再表达 busy、idle、abnormal 等生产状态。
+- 工位状态按后台工位管理状态表达：`active` 执行中、`inactive` 待命中、`break` 休息中、`offline` 离线。
+- 设备不在线和工位离线使用灰色，不使用红色；红色只保留给任务失败、质检失败等生产异常。
+- 设备状态区不再渲染具体设备、工位、机器人、操作员或当前任务明细；改为设备状态与工位状态摘要、在线率、状态分布条和抽象状态矩阵。
+- overview 不再返回 `devices.items` 或 `stations.items`；UI 使用 `devices.summary` 与 `stations.summary` 计算摘要和矩阵数量。
+- 可以为设备/工位状态加入克制 CSS 动效：执行中状态灯低幅度呼吸、状态分布条宽度过渡、6 到 8 秒一次的淡巡检扫描、刷新成功短脉冲；必须支持 `prefers-reduced-motion`。
 - 禁止大面积霓虹、持续快速闪烁、跑马灯、雷达式强动效，以及任何会改变 grid track、面板高度或造成滚动的动画。
 - 任务流显示最近任务，不做后台表格。
 - 异常状态内联展示在顶部状态、设备状态和任务流中，不新增告警栏。
@@ -304,13 +308,13 @@ npm run build
 - `1366x768` 与 `1600x900` 下优先保留顶部状态、8 个 KPI、Video Flight Stage、趋势、设备状态和最近任务流；设备/任务列表可减少条目，质量指标压缩为任务流内的窄条，不再占用独立面板。
 - 70 寸电视或浏览器页面缩放放大时，按 125% 到 165% 页面缩放后的等效视口兜底验证，例如 `1536x864`、`1280x720`、`1152x648`；这些尺寸仍应保持三列驾驶舱，不应触发普通后台或移动端纵向堆叠。
 - 顶部状态栏在紧凑和缩放等效视口下仍保留完整日期时间 `YYYY/MM/DD HH:mm:ss` 与全屏按钮；不得改成短时间、隐藏时间、隐藏按钮，或把按钮缩小到远距离不可用。
-- 趋势区域使用紧凑的语义色堆叠条表达 completed / in_progress / pending / failed，不在本轮引入 ECharts，避免为一屏高度和 resize 生命周期增加复杂度。
+- 趋势区域不再使用 completed / in_progress / pending / failed 堆叠条；本轮改为与数据生产统计一致的近七天按天 ECharts 数量趋势，但不带统计页的 tab、筛选器或 dataZoom。
 - 空数据、API 失败和 fallback 数据仍复用 `useProductionBigScreenData.js` 的稳定结构；布局高度不因错误提示、空状态或刷新按钮出现而变化。
 
 **验收标准:**
 
-- `trend`、`devices`、`recent_tasks` 和质量/异常状态均能正常展示。
-- 设备状态区只展示设备/工位聚合健康态，不出现具体设备名、工位名、机器人名、操作员或当前任务明细。
+- `trend`、`devices`、`stations`、`recent_tasks` 和质量/异常状态均能正常展示。
+- 设备/工位状态区只展示设备和工位聚合状态，不出现具体设备名、工位名、机器人名、操作员或当前任务明细。
 - 设备/工位状态动画在默认模式下克制可见，在 `prefers-reduced-motion` 下静态或近似静态。
 - 图表 resize 正常，组件卸载时 dispose。
 - 任务流和设备列表数量受限，不造成小屏溢出。
@@ -426,7 +430,7 @@ docs/designs/synapse-production-big-screen-tasks.md，先实现 T1。
 这些问题不阻塞 T1/T3/T4，但会影响后续打磨：
 
 - `video_url` 真实来源是否存在；若不存在，第一版必须使用 `preview_url` 的 MCAP 图像帧播放，不得伪造 `<video>` 播放。
-- 设备在线率以 workstation status、robot status、连接 hub，还是最后心跳为准。
+- 如果后续要细分“部分联通”，需确认 recorder-only、transfer-only 是否单独展示；当前大屏只展示两个 hub 均在线的设备在线率。
 - 大屏是否允许 data_collector 访问，还是只给 admin/只读展示账号。
 - 生产现场默认刷新频率。
 - 异常状态在顶部状态、设备状态和任务流中的展示阈值。
diff --git a/docs/designs/synapse-production-big-screen.md b/docs/designs/synapse-production-big-screen.md
index 180981e..4e6b30e 100644
--- a/docs/designs/synapse-production-big-screen.md
+++ b/docs/designs/synapse-production-big-screen.md
@@ -59,7 +59,7 @@ Synapse 生产大屏用于机器人数据生产现场的常驻展示，也用于
 | 管理者 | 今日产能、完成率、失败率、设备利用情况 | KPI、趋势、异常设备 |
 | 客户 | 生产过程是否专业可信，机器人数据生产是否可视化 | 中央视频舞台、生产流、整体视觉品质 |
 | 现场操作人员 | 当前任务、工位状态、设备异常 | 任务流、设备状态 |
-| 运维或生产负责人 | 系统是否稳定，失败是否需要处理 | 同步状态、失败任务、设备离线、刷新时间 |
+| 运维或生产负责人 | 系统是否稳定，失败是否需要处理 | 同步状态、失败任务、设备不在线、刷新时间 |
 
 ### 2.2 设备与观看距离
 
@@ -124,16 +124,16 @@ KPI 文案应短，数字应使用 tabular numbers。数字刷新可以轻微计
 
 ### 3.4 生产趋势
 
-职责：展示产能或任务状态变化。
+职责：展示数据生产产能变化。
 
-可选图表：
+大屏第一版趋势区域应对齐后台“数据生产统计”页面中的“趋势分析”视觉和口径：
 
-- 最近 7 天任务完成趋势
-- 最近 N 个时间窗口的 completed / in_progress / pending / failed
-- 质检通过率趋势
-- 生产数据量趋势
-
-当前项目已有 ECharts 使用方式，后续实现应复用现有 ECharts 初始化、更新、resize、dispose 模式。
+- 固定展示近 7 天数据。
+- 时间粒度固定为天。
+- 默认展示数量趋势，使用 `trend` 每日数据生产记录合计作为“总数量”；口径与后台数据生产统计一致，基于 `episodes`，不是任务数。
+- 每天的数据桶必须补齐；缺失日期显示 0，避免图表长度随 API 数据稀疏程度变化。
+- 使用 ECharts 柱状趋势图，复用后台统计页的初始化、`setOption`、resize 和 dispose 模式。
+- 大屏趋势区域空间有限，不显示趋势 tab、筛选器或 dataZoom；只保留清晰的日期横轴、数量纵轴、总数量柱状图和简短标题。
 
 ### 3.5 设备状态
 
@@ -143,15 +143,15 @@ KPI 文案应短，数字应使用 tabular numbers。数字刷新可以轻微计
 
 内容：
 
-- 设备整体：在线 / 生产中 / 待命 / 离线 / 异常汇总。
-- 工位整体：在线 / 占用 / 空闲 / 离线 / 异常汇总。
-- 设备在线率、工位在线率、生产中数量、可用数量和异常数量。
-- 设备状态分布条与工位状态分布条，使用语义色表达 busy / idle / offline / abnormal。
-- 抽象状态矩阵或状态灯阵：每个格子只表达一个设备或工位的状态，不显示名称、ID、机器人名、操作员或当前任务。
+- 设备整体只表达在线状态：在线 / 不在线，以及设备在线率。
+- 工位整体按后台工位管理状态表达：执行中 / 待命中 / 休息中 / 离线。
+- 设备在线率、工位在线率、执行中工位数量、待命/休息/离线工位数量。
+- 设备状态分布条只使用在线 / 不在线两段；工位状态分布条使用 active / inactive / break / offline 语义色。
+- 抽象状态矩阵或状态灯阵：每个格子只表达一个设备或工位状态，不显示名称、ID、机器人名、操作员或当前任务。
 
-状态颜色应明确但不刺眼。异常要醒目，健康状态要稳定。异常、离线或心跳超时信息仍在设备状态区内联表达，但不新增独立告警栏。
+状态颜色应明确但不刺眼。任务失败、质检失败等生产异常要醒目，健康状态要稳定。设备不在线与工位离线用灰色表达资源不可用，相关信息仍在设备/工位状态区内联表达，但不新增独立告警栏。
 
-第一版如果 overview 仍只返回 `devices.summary` 和 `devices.items`，前端可以用 `summary` 直接构建设备/工位摘要，并将 `items` 仅作为计算状态矩阵数量的来源，不在 UI 中渲染具体名称。后续如需更严谨地区分机器人与工位，可在 overview 中补充 `robots.summary` 与 `stations.summary`，但这不是当前一屏布局优化的前置条件。
+overview 不再返回设备或工位明细 `items`。前端只能使用 `devices.summary` 与 `stations.summary` 构建设备状态、工位状态摘要、分布条和抽象矩阵，避免大屏泄露或挤占空间展示具体设备、工位、机器人、操作员或当前任务明细。
 
 ### 3.6 最近任务流
 
@@ -170,7 +170,7 @@ KPI 文案应短，数字应使用 tabular numbers。数字刷新可以轻微计
 第一版不设置独立告警栏，也不新增告警表。异常状态应内联展示在已有区域中，避免额外占用大屏主布局：
 
 - 顶部状态栏：展示 API 正常、降级展示、数据同步失败等全局状态。
-- 设备状态区：直接标记离线、异常或长时间无心跳的工位/设备。
+- 设备/工位状态区：直接标记设备不在线、工位离线或其他资源不可用状态。
 - 最近任务流：直接突出失败、取消、质检不通过等任务状态。
 - 质量区域：展示合格率、待检和失败数量。
 
@@ -218,7 +218,8 @@ KPI 文案应短，数字应使用 tabular numbers。数字刷新可以轻微计
 | 成功 / 在线 / 已完成 | 低饱和绿色 | 只用于正向状态 |
 | 进行中 / 主品牌 / 当前焦点 | 品牌蓝 | 用于主舞台边框、当前任务、重要数字 |
 | 待处理 / 等待 / 警告 | 琥珀色 | 不要大面积铺满 |
-| 失败 / 离线 / 异常 | 红色 | 只用于失败、离线和异常 |
+| 失败 / 质量异常 | 红色 | 只用于任务失败、质检失败等生产异常 |
+| 设备不在线 / 工位离线 | 灰色 | 表达资源不可用，不使用红色抢占失败告警语义 |
 | 中性 / 无数据 | 灰蓝 | 用于背景和非重点信息 |
 
 图表避免默认彩虹色，使用 3 到 5 个语义色即可。
@@ -521,7 +522,6 @@ GET /api/v1/production/dashboard/overview
 | `timezone_offset` | 当前前端时区 | 趋势聚合使用 |
 | `trend_days` | 7 | 趋势窗口，最大 31 |
 | `recent_limit` | 12 | 最近任务条数 |
-| `device_limit` | 16 | 设备状态条数 |
 | `preview_limit` | 8 | 轮播预览条数 |
 | `factory_id` | 空 | 管理端筛选 |
 | `organization_id` | 空 | 管理端筛选 |
@@ -554,11 +554,8 @@ GET /api/v1/production/dashboard/overview
   },
   "trend": [
     {
-      "time": "05-17",
-      "completed": 92,
-      "in_progress": 8,
-      "pending": 24,
-      "failed": 4
+      "date": "05-17",
+      "total": 92
     }
   ],
   "task_status_distribution": {
@@ -577,12 +574,23 @@ GET /api/v1/production/dashboard/overview
     "recent_failures": []
   },
   "devices": {
-    "online_count": 14,
-    "offline_count": 2,
-    "idle_count": 4,
-    "busy_count": 10,
-    "abnormal_count": 1,
-    "items": []
+    "summary": {
+      "total": 16,
+      "online": 14,
+      "offline": 2,
+      "online_rate": 87.5
+    }
+  },
+  "stations": {
+    "summary": {
+      "total": 16,
+      "online": 14,
+      "active": 8,
+      "inactive": 4,
+      "break": 2,
+      "offline": 2,
+      "online_rate": 87.5
+    }
   },
   "recent_tasks": [],
   "previews": []
@@ -596,18 +604,19 @@ GET /api/v1/production/dashboard/overview
 | `summary.today_task_count` | `tasks` 按今日时间窗口聚合 | 现有 `snapshot.tasks` 是全量 scope 计数，需要增加今日窗口 |
 | `summary.completed/in_progress/pending/failed` | `tasks.status` | 现有已支持基础状态 |
 | `summary.pass_rate` | `episodes.qa_status` 或现有 `dashboardQuality` | 现有 quality 可复用 |
-| `summary.robot_online_rate` | `workstations.status`、`robots.status`、连接快照 | 现有 stations 仅返回基础状态；在线率需要明确规则 |
-| `trend` | `tasks` 时间桶 | 现有 trend 缺少 failed |
+| `summary.robot_online_rate` | `robots.device_id` 与 recorder/transfer hub 连接快照 | 设备在线率只表达联通状态：两个 hub 均在线才算在线 |
+| `trend` | `episodes` 数据生产记录时间桶 | 与数据生产统计页数量趋势一致，按天返回每日总数量 |
 | `task_status_distribution` | `tasks.status` | 现有 tasks counts 可复用并扩展 |
 | `quality.recent_failures` | `episodes` + `tasks` + `inspectors` | 当前需新增查询 |
-| `devices.items` | `workstations` + `robots` + `data_collectors` + active task | 现有 stations 可扩展 current_task / last_seen_at |
+| `devices.summary` | `robots` + recorder/transfer hub 连接快照 | 不返回 `items`，仅返回 total / online / offline / online_rate |
+| `stations.summary` | `workstations.status` | 使用后台工位管理状态 active / inactive / break / offline |
 | `recent_tasks` | `tasks` + `batches` + `workstations` + `robots` | 现有 active_tasks 只覆盖进行中任务，需要最近完成/失败 |
 | `previews` | `episodes` + task/workstation metadata + presign/poster | 当前 episode API 可 presign MCAP，但没有视频 URL |
 
 第一版字段取舍：
 
-- `summary`、`trend`、`task_status_distribution`、`devices`、`recent_tasks` 是核心字段，应优先完成。
-- 第一版不返回独立 `alerts` 字段；任务失败、设备离线、同步降级等异常内联体现在顶部状态、设备状态和任务流中。
+- `summary`、`trend`、`task_status_distribution`、`devices`、`stations`、`recent_tasks` 是核心字段，应优先完成。
+- 第一版不返回独立 `alerts` 字段；任务失败、设备不在线、工位离线、同步降级等异常内联体现在顶部状态、设备/工位状态和任务流中。
 - `previews.video_url` 可以为空；但如果非空，必须是真实可播放视频 URL。前端不能把 `preview_url` 当作 `<video>` 源，但应把它作为 MCAP 数据预览源读取图像帧。
 - `quality.recent_failures` 如果查询成本高，可以第一期返回空数组，但保留字段。
 
@@ -616,7 +625,7 @@ GET /api/v1/production/dashboard/overview
 第一期不需要建立新告警表，也不需要独立告警栏。异常应进入已有信息区域：
 
 - 最近任务流：直接展示失败、取消、质检未通过等任务状态。
-- 设备状态区：直接展示 offline、abnormal、心跳超时等设备状态。
+- 设备/工位状态区：直接展示设备不在线、工位离线和工位状态异常口径。
 - 顶部状态栏：展示 overview 请求失败、保留旧数据、使用 fallback 等全局降级状态。
 - 质量区域：通过失败数、待检数和合格率表达质量异常。
 
@@ -731,6 +740,7 @@ page mounted
  * @property {Object<string, number>} task_status_distribution
  * @property {QualitySummary} quality
  * @property {DeviceSummary} devices
+ * @property {StationSummary} stations
  * @property {RecentTask[]} recent_tasks
  * @property {PreviewItem[]} previews
  */
@@ -751,22 +761,29 @@ page mounted
 
 /**
  * @typedef {Object} TrendPoint
- * @property {string} time
- * @property {number} completed
- * @property {number} in_progress
- * @property {number} pending
- * @property {number} failed
+ * @property {string} date
+ * @property {number} total
  */
 
 /**
- * @typedef {Object} DeviceStatus
- * @property {string} id
- * @property {string} name
- * @property {'robot'|'station'} type
- * @property {'online'|'offline'|'idle'|'busy'|'abnormal'} status
- * @property {string} station_name
- * @property {string} current_task
- * @property {string} last_seen_at
+ * @typedef {Object} DeviceSummary
+ * @property {Object} summary
+ * @property {number} summary.total
+ * @property {number} summary.online
+ * @property {number} summary.offline
+ * @property {number} summary.online_rate
+ */
+
+/**
+ * @typedef {Object} StationSummary
+ * @property {Object} summary
+ * @property {number} summary.total
+ * @property {number} summary.online
+ * @property {number} summary.active
+ * @property {number} summary.inactive
+ * @property {number} summary.break
+ * @property {number} summary.offline
+ * @property {number} summary.online_rate
  */
 
 /**
@@ -1054,7 +1071,7 @@ page mounted
 - 大屏是否必须登录，是否需要专用只读展示 token。
 - 大屏刷新频率是 15s、30s 还是可配置。
 - 异常展示规则：哪些任务/同步/设备状态需要在顶部状态、设备状态或任务流中突出。
-- 设备在线/离线判定规则：使用 workstation status、robot status、recorder/transfer hub 连接状态，还是最后心跳。
+- 后续如需展示部分联通，应定义 recorder-only、transfer-only 与完全不在线的展示规则；当前设备在线只按 recorder/transfer hub 均联通计算。
 - 质检通过率来源：`episodes.qa_status` 的哪些值算通过、失败、处理中。
 - 是否需要多组织、多工厂筛选；如果大屏部署在单工厂电视，是否应固定 scope。
 - 是否需要自动进入浏览器全屏，或者只保留手动全屏按钮。
diff --git a/internal/api/handlers/production_dashboard.go b/internal/api/handlers/production_dashboard.go
index 8dbec62..6f58ed4 100644
--- a/internal/api/handlers/production_dashboard.go
+++ b/internal/api/handlers/production_dashboard.go
@@ -20,6 +20,7 @@ import (
 	"archebase.com/keystone-edge/internal/auth"
 	"archebase.com/keystone-edge/internal/logger"
 	"archebase.com/keystone-edge/internal/middleware"
+	"archebase.com/keystone-edge/internal/services"
 )
 
 const (
@@ -37,12 +38,18 @@ const (
 
 // ProductionDashboardHandler serves aggregate data for production dashboard pages.
 type ProductionDashboardHandler struct {
-	db *sqlx.DB
+	db          *sqlx.DB
+	recorderHub *services.RecorderHub
+	transferHub *services.TransferHub
 }
 
 // NewProductionDashboardHandler creates a production dashboard aggregate handler.
-func NewProductionDashboardHandler(db *sqlx.DB) *ProductionDashboardHandler {
-	return &ProductionDashboardHandler{db: db}
+func NewProductionDashboardHandler(db *sqlx.DB, recorderHub *services.RecorderHub, transferHub *services.TransferHub) *ProductionDashboardHandler {
+	return &ProductionDashboardHandler{
+		db:          db,
+		recorderHub: recorderHub,
+		transferHub: transferHub,
+	}
 }
 
 // RegisterRoutes registers production dashboard aggregate routes.
@@ -95,8 +102,8 @@ type productionDashboardOverviewResponse struct {
 	TaskStatusDistribution []dashboardStatusDistributionItem `json:"task_status_distribution"`
 	Quality                dashboardOverviewQuality          `json:"quality"`
 	Devices                dashboardOverviewDevices          `json:"devices"`
+	Stations               dashboardOverviewStations         `json:"stations"`
 	RecentTasks            []dashboardRecentTaskItem         `json:"recent_tasks"`
-	Alerts                 []dashboardOverviewAlert          `json:"alerts"`
 	Previews               []dashboardPreviewItem            `json:"previews"`
 }
 
@@ -128,6 +135,7 @@ type dashboardTaskCounts struct {
 
 type dashboardTrendItem struct {
 	Date       string `json:"date" db:"date"`
+	Total      int64  `json:"total" db:"total"`
 	Completed  int64  `json:"completed" db:"completed"`
 	InProgress int64  `json:"in_progress" db:"in_progress"`
 	Pending    int64  `json:"pending" db:"pending"`
@@ -170,14 +178,6 @@ type dashboardOverviewQuality struct {
 	RecentFailures []dashboardQualityRecentFailure `json:"recent_failures"`
 }
 
-type dashboardOverviewAlert struct {
-	ID        string `json:"id"`
-	Level     string `json:"level"`
-	Title     string `json:"title"`
-	Message   string `json:"message"`
-	CreatedAt string `json:"created_at"`
-}
-
 type dashboardQualityRecentFailure struct {
 	ID        string `json:"id"`
 	Title     string `json:"title"`
@@ -202,29 +202,31 @@ type dashboardSystemStatus struct {
 
 type dashboardOverviewDevices struct {
 	Summary dashboardDeviceSummary `json:"summary"`
-	Items   []dashboardDeviceItem  `json:"items"`
 }
 
 type dashboardDeviceSummary struct {
 	Total      int64   `json:"total"`
 	Online     int64   `json:"online"`
-	Idle       int64   `json:"idle"`
-	Busy       int64   `json:"busy"`
 	Offline    int64   `json:"offline"`
-	Abnormal   int64   `json:"abnormal"`
 	OnlineRate float64 `json:"online_rate"`
 }
 
-type dashboardDeviceItem struct {
-	ID                  string `json:"id"`
-	Name                string `json:"name"`
-	StationName         string `json:"station_name"`
-	Status              string `json:"status"`
-	StatusText          string `json:"status_text"`
-	RobotName           string `json:"robot_name"`
-	RobotID             string `json:"robot_id"`
-	CollectorOperatorID string `json:"collector_operator_id"`
-	CollectorName       string `json:"collector_name"`
+type dashboardOverviewStations struct {
+	Summary dashboardStationSummary `json:"summary"`
+}
+
+type dashboardStationSummary struct {
+	Total      int64   `json:"total"`
+	Online     int64   `json:"online"`
+	Active     int64   `json:"active"`
+	Inactive   int64   `json:"inactive"`
+	Break      int64   `json:"break"`
+	Offline    int64   `json:"offline"`
+	OnlineRate float64 `json:"online_rate"`
+}
+
+type dashboardDeviceConnectionRow struct {
+	DeviceID string `db:"device_id"`
 }
 
 type dashboardStationItem struct {
@@ -481,7 +483,7 @@ func (h *ProductionDashboardHandler) GetSnapshot(c *gin.Context) {
 // @Param        active_limit query int false "Active batch limit (default 20, max 100)"
 // @Param        recent_limit query int false "Recent task limit (default 12, max 50)"
 // @Param        preview_limit query int false "Preview limit (default 8, max 20)"
-// @Success      200 {object} map[string]interface{} "generated_at, scope, summary, trend, task_status_distribution, quality, devices, recent_tasks, alerts, previews"
+// @Success      200 {object} map[string]interface{} "generated_at, scope, summary, trend, task_status_distribution, quality, devices, stations, recent_tasks, previews"
 // @Failure      400 {object} map[string]string
 // @Failure      401 {object} map[string]string
 // @Failure      500 {object} map[string]string
@@ -530,9 +532,9 @@ func (h *ProductionDashboardHandler) GetOverview(c *gin.Context) {
 		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
 		return
 	}
-	trend, err := h.dashboardTaskTrend(tx, scope, q)
+	trend, err := h.dashboardDataProductionTrend(tx, scope, q)
 	if err != nil {
-		logger.Printf("[DASHBOARD] overview task trend query failed: %v", err)
+		logger.Printf("[DASHBOARD] overview data production trend query failed: %v", err)
 		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
 		return
 	}
@@ -548,6 +550,12 @@ func (h *ProductionDashboardHandler) GetOverview(c *gin.Context) {
 		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
 		return
 	}
+	deviceConnections, err := h.dashboardDeviceConnections(tx, scope)
+	if err != nil {
+		logger.Printf("[DASHBOARD] overview device connection query failed: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
+		return
+	}
 	activeBatches, err := h.dashboardActiveBatches(tx, scope, q.ActiveLimit)
 	if err != nil {
 		logger.Printf("[DASHBOARD] overview active batch query failed: %v", err)
@@ -573,11 +581,14 @@ func (h *ProductionDashboardHandler) GetOverview(c *gin.Context) {
 		return
 	}
 
-	devices := buildOverviewDevices(stations)
+	devices := buildOverviewDevices(deviceConnections, func(deviceID string) bool {
+		return services.IsRobotConnected(h.recorderHub, h.transferHub, deviceID)
+	})
+	stationsOverview := buildOverviewStations(stations)
 	c.JSON(http.StatusOK, productionDashboardOverviewResponse{
 		GeneratedAt:            time.Now().UTC().Format(time.RFC3339),
 		Scope:                  scope,
-		Summary:                buildOverviewSummary(tasks, todayTasks, quality, totalDurationSec, devices, len(activeBatches)),
+		Summary:                buildOverviewSummary(tasks, todayTasks, quality, totalDurationSec, devices, stationsOverview, len(activeBatches)),
 		Trend:                  trend,
 		TaskStatusDistribution: buildTaskStatusDistribution(tasks),
 		Quality: dashboardOverviewQuality{
@@ -590,8 +601,8 @@ func (h *ProductionDashboardHandler) GetOverview(c *gin.Context) {
 			RecentFailures: []dashboardQualityRecentFailure{},
 		},
 		Devices:     devices,
+		Stations:    stationsOverview,
 		RecentTasks: recentTasks,
-		Alerts:      []dashboardOverviewAlert{},
 		Previews:    previews,
 	})
 }
@@ -824,11 +835,9 @@ func emptyProductionDashboardOverview(scope productionDashboardScope) production
 		Quality: dashboardOverviewQuality{
 			RecentFailures: []dashboardQualityRecentFailure{},
 		},
-		Devices: dashboardOverviewDevices{
-			Items: []dashboardDeviceItem{},
-		},
+		Devices:     dashboardOverviewDevices{},
+		Stations:    dashboardOverviewStations{},
 		RecentTasks: []dashboardRecentTaskItem{},
-		Alerts:      []dashboardOverviewAlert{},
 		Previews:    []dashboardPreviewItem{},
 	}
 }
@@ -905,6 +914,52 @@ func (h *ProductionDashboardHandler) dashboardTaskTrend(db dashboardDB, scope pr
 		return nil, err
 	}
 
+	byDate := make(map[string]dashboardTrendItem, len(rows))
+	for _, row := range rows {
+		row.Total = row.Completed + row.InProgress + row.Pending + row.Failed
+		byDate[row.Date] = row
+	}
+	items := make([]dashboardTrendItem, 0, q.TrendDays)
+	for day := startLocal; day.Before(endLocal); day = day.AddDate(0, 0, 1) {
+		label := day.Format("01-02")
+		item, ok := byDate[label]
+		if !ok {
+			item = dashboardTrendItem{Date: label}
+		}
+		items = append(items, item)
+	}
+	return items, nil
+}
+
+func (h *ProductionDashboardHandler) dashboardDataProductionTrend(db dashboardDB, scope productionDashboardScope, q productionDashboardQuery) ([]dashboardTrendItem, error) {
+	location := fixedZoneFromOffset(q.TimezoneOffset)
+	endLocal := time.Now().In(location).AddDate(0, 0, 1)
+	endLocal = time.Date(endLocal.Year(), endLocal.Month(), endLocal.Day(), 0, 0, 0, 0, location)
+	startLocal := endLocal.AddDate(0, 0, -q.TrendDays)
+	startUTC := startLocal.UTC()
+	endUTC := endLocal.UTC()
+
+	eventTimeExpr := "COALESCE(t.completed_at, e.created_at)"
+	localEventExpr := "COALESCE(CONVERT_TZ(" + eventTimeExpr + ", @@session.time_zone, ?), " + eventTimeExpr + ")"
+	conditions := []string{"e.deleted_at IS NULL", eventTimeExpr + " >= ?", eventTimeExpr + " < ?"}
+	args := []interface{}{q.TimezoneOffset, startUTC, endUTC}
+	conditions, args = appendDashboardEpisodeScope(conditions, args, scope)
+
+	query := `
+		SELECT
+			DATE_FORMAT(` + localEventExpr + `, '%m-%d') AS date,
+			COUNT(e.id) AS total
+		FROM episodes e
+		LEFT JOIN tasks t ON t.id = e.task_id AND t.deleted_at IS NULL
+		WHERE ` + strings.Join(conditions, " AND ") + `
+		GROUP BY date
+		ORDER BY MIN(` + eventTimeExpr + `) ASC
+	`
+	rows := []dashboardTrendItem{}
+	if err := db.Select(&rows, query, args...); err != nil {
+		return nil, err
+	}
+
 	byDate := make(map[string]dashboardTrendItem, len(rows))
 	for _, row := range rows {
 		byDate[row.Date] = row
@@ -1022,6 +1077,20 @@ func (h *ProductionDashboardHandler) dashboardStations(db dashboardDB, scope pro
 	return items, nil
 }
 
+func (h *ProductionDashboardHandler) dashboardDeviceConnections(db dashboardDB, scope productionDashboardScope) ([]dashboardDeviceConnectionRow, error) {
+	conditions := []string{"r.deleted_at IS NULL"}
+	args := []interface{}{}
+	conditions, args = appendDashboardRobotScope(conditions, args, scope)
+	query := `
+		SELECT COALESCE(NULLIF(TRIM(r.device_id), ''), '') AS device_id
+		FROM robots r
+		WHERE ` + strings.Join(conditions, " AND ") + `
+		ORDER BY r.device_id ASC
+	`
+	items := []dashboardDeviceConnectionRow{}
+	return items, db.Select(&items, query, args...)
+}
+
 func (h *ProductionDashboardHandler) dashboardOperatingDays(db dashboardDB, scope productionDashboardScope) (int64, error) {
 	conditions := []string{"t.deleted_at IS NULL"}
 	args := []interface{}{}
@@ -1260,6 +1329,7 @@ func buildOverviewSummary(
 	quality dashboardQuality,
 	totalDurationSec float64,
 	devices dashboardOverviewDevices,
+	stations dashboardOverviewStations,
 	activeBatchCount int,
 ) dashboardOverviewSummary {
 	return dashboardOverviewSummary{
@@ -1271,8 +1341,8 @@ func buildOverviewSummary(
 		FailedTasks:          tasks.Failed,
 		CancelledTasks:       tasks.Cancelled,
 		ActiveBatches:        int64(activeBatchCount),
-		ActiveStations:       devices.Summary.Online,
-		TotalStations:        devices.Summary.Total,
+		ActiveStations:       stations.Summary.Active,
+		TotalStations:        stations.Summary.Total,
 		RobotOnlineRate:      devices.Summary.OnlineRate,
 		QualityPassRate:      quality.PassRate,
 		TotalDataDurationSec: totalDurationSec,
@@ -1297,58 +1367,46 @@ func buildTaskStatusDistribution(tasks dashboardTaskCounts) []dashboardStatusDis
 	return filtered
 }
 
-func buildOverviewDevices(stations []dashboardStationItem) dashboardOverviewDevices {
-	items := make([]dashboardDeviceItem, 0, len(stations))
+func buildOverviewDevices(devices []dashboardDeviceConnectionRow, connected func(string) bool) dashboardOverviewDevices {
 	var summary dashboardDeviceSummary
-	for _, station := range stations {
-		status, statusText := overviewDeviceStatus(station.Status)
-		switch status {
-		case "busy":
-			summary.Busy++
+	for _, device := range devices {
+		summary.Total++
+		if connected != nil && connected(device.DeviceID) {
 			summary.Online++
-		case "idle":
-			summary.Idle++
-			summary.Online++
-		case "offline":
-			summary.Offline++
-		default:
-			summary.Abnormal++
+			continue
 		}
-		items = append(items, dashboardDeviceItem{
-			ID:                  station.ID,
-			Name:                firstNonEmpty(station.Name, station.RobotName, station.DeviceID, station.ID),
-			StationName:         firstNonEmpty(station.Name, station.ID),
-			Status:              status,
-			StatusText:          statusText,
-			RobotName:           firstNonEmpty(station.RobotName, station.DeviceModel, station.DeviceID),
-			RobotID:             station.DeviceID,
-			CollectorOperatorID: station.CollectorOperatorID,
-			CollectorName:       station.CollectorName,
-		})
+		summary.Offline++
 	}
-	summary.Total = int64(len(stations))
 	if summary.Total > 0 {
 		summary.OnlineRate = math.Round((float64(summary.Online)/float64(summary.Total))*1000) / 10
 	}
 	return dashboardOverviewDevices{
 		Summary: summary,
-		Items:   items,
 	}
 }
 
-func overviewDeviceStatus(status string) (string, string) {
-	switch status {
-	case "active":
-		return "busy", "生产中"
-	case "inactive":
-		return "idle", "待命中"
-	case "break":
-		return "idle", "休息中"
-	case "offline":
-		return "offline", "离线"
-	default:
-		return "abnormal", firstNonEmpty(status, "异常")
+func buildOverviewStations(stations []dashboardStationItem) dashboardOverviewStations {
+	var summary dashboardStationSummary
+	for _, station := range stations {
+		summary.Total++
+		switch station.Status {
+		case "active":
+			summary.Active++
+			summary.Online++
+		case "inactive":
+			summary.Inactive++
+			summary.Online++
+		case "break":
+			summary.Break++
+			summary.Online++
+		default:
+			summary.Offline++
+		}
+	}
+	if summary.Total > 0 {
+		summary.OnlineRate = math.Round((float64(summary.Online)/float64(summary.Total))*1000) / 10
 	}
+	return dashboardOverviewStations{Summary: summary}
 }
 
 func appendDashboardTaskScope(conditions []string, args []interface{}, scope productionDashboardScope) ([]string, []interface{}) {
@@ -1424,6 +1482,42 @@ func appendDashboardStationScope(conditions []string, args []interface{}, scope
 	return conditions, args
 }
 
+func appendDashboardRobotScope(conditions []string, args []interface{}, scope productionDashboardScope) ([]string, []interface{}) {
+	if scope.Role == "data_collector" {
+		conditions = append(conditions, `EXISTS (
+			SELECT 1 FROM workstations ws_scope
+			WHERE ws_scope.robot_id = r.id
+				AND ws_scope.data_collector_id = ?
+				AND ws_scope.deleted_at IS NULL
+		)`)
+		args = append(args, scope.collectorID)
+		return conditions, args
+	}
+	if scope.WorkstationID != "" {
+		conditions = append(conditions, `EXISTS (
+			SELECT 1 FROM workstations ws_scope
+			WHERE ws_scope.robot_id = r.id
+				AND CAST(ws_scope.id AS CHAR) = ?
+				AND ws_scope.deleted_at IS NULL
+		)`)
+		args = append(args, scope.WorkstationID)
+	}
+	if scope.FactoryID != "" {
+		conditions = append(conditions, "CAST(r.factory_id AS CHAR) = ?")
+		args = append(args, scope.FactoryID)
+	}
+	if scope.OrganizationID != "" {
+		conditions = append(conditions, `EXISTS (
+			SELECT 1 FROM workstations ws_scope
+			WHERE ws_scope.robot_id = r.id
+				AND CAST(ws_scope.organization_id AS CHAR) = ?
+				AND ws_scope.deleted_at IS NULL
+		)`)
+		args = append(args, scope.OrganizationID)
+	}
+	return conditions, args
+}
+
 func appendDashboardBatchScope(conditions []string, args []interface{}, scope productionDashboardScope) ([]string, []interface{}) {
 	if scope.Role == "data_collector" {
 		conditions = append(conditions, "ws.data_collector_id = ?")
diff --git a/internal/api/handlers/production_dashboard_test.go b/internal/api/handlers/production_dashboard_test.go
index 54d105b..e7b8d1d 100644
--- a/internal/api/handlers/production_dashboard_test.go
+++ b/internal/api/handlers/production_dashboard_test.go
@@ -151,7 +151,6 @@ func TestProductionDashboardOverviewEmptyScopeKeepsContract(t *testing.T) {
 	}
 	if len(got.Trend) != 0 ||
 		len(got.TaskStatusDistribution) != 0 ||
-		len(got.Devices.Items) != 0 ||
 		len(got.RecentTasks) != 0 ||
 		len(got.Previews) != 0 {
 		t.Fatalf("empty overview arrays should be empty: %+v", got)
@@ -171,10 +170,12 @@ func TestProductionDashboardOverviewDistributionAndDevices(t *testing.T) {
 		t.Fatalf("distribution len = %d, want 3: %+v", len(distribution), distribution)
 	}
 
-	devices := buildOverviewDevices([]dashboardStationItem{
-		{ID: "1", Name: "A", Status: "active"},
-		{ID: "2", Name: "B", Status: "inactive"},
-		{ID: "3", Name: "C", Status: "offline"},
+	devices := buildOverviewDevices([]dashboardDeviceConnectionRow{
+		{DeviceID: "robot-a"},
+		{DeviceID: "robot-b"},
+		{DeviceID: "robot-c"},
+	}, func(deviceID string) bool {
+		return deviceID == "robot-a" || deviceID == "robot-b"
 	})
 	if devices.Summary.Total != 3 || devices.Summary.Online != 2 || devices.Summary.Offline != 1 {
 		t.Fatalf("unexpected device summary: %+v", devices.Summary)
@@ -182,6 +183,21 @@ func TestProductionDashboardOverviewDistributionAndDevices(t *testing.T) {
 	if devices.Summary.OnlineRate != 66.7 {
 		t.Fatalf("online rate = %.1f, want 66.7", devices.Summary.OnlineRate)
 	}
+
+	stations := buildOverviewStations([]dashboardStationItem{
+		{ID: "1", Name: "A", Status: "active"},
+		{ID: "2", Name: "B", Status: "inactive"},
+		{ID: "3", Name: "C", Status: "break"},
+		{ID: "4", Name: "D", Status: "offline"},
+	})
+	if stations.Summary.Total != 4 || stations.Summary.Active != 1 ||
+		stations.Summary.Inactive != 1 || stations.Summary.Break != 1 ||
+		stations.Summary.Online != 3 || stations.Summary.Offline != 1 {
+		t.Fatalf("unexpected station summary: %+v", stations.Summary)
+	}
+	if stations.Summary.OnlineRate != 75 {
+		t.Fatalf("station online rate = %.1f, want 75", stations.Summary.OnlineRate)
+	}
 }
 
 func TestProductionDashboardEpisodePreviewURL(t *testing.T) {
diff --git a/internal/server/server.go b/internal/server/server.go
index 59190a9..12dfbfa 100644
--- a/internal/server/server.go
+++ b/internal/server/server.go
@@ -136,7 +136,7 @@ func New(cfg *config.Config, db *sqlx.DB, s3Client *s3.Client, syncWorker *servi
 		subsceneHandler = handlers.NewSubsceneHandler(db)
 		orderHandler = handlers.NewOrderHandler(db, recorderHub, recorderRPCTimeout)
 		dataStatsHandler = handlers.NewDataProductionStatisticsHandler(db)
-		productionDashboardHandler = handlers.NewProductionDashboardHandler(db)
+		productionDashboardHandler = handlers.NewProductionDashboardHandler(db, recorderHub, transferHub)
 	}
 
 	// Create SyncHandler for cloud sync API

From fb998efa2dfc170c03f94bc5412cadff7abf34b3 Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Mon, 18 May 2026 03:16:33 +0800
Subject: [PATCH 07/17] feat(production): refine big screen task feed contract

---
 .../synapse-production-big-screen-tasks.md    | 10 ++++--
 docs/designs/synapse-production-big-screen.md | 31 +++++++++++++++++--
 internal/api/handlers/production_dashboard.go | 20 ++++++++++--
 .../api/handlers/production_dashboard_test.go | 16 ++++++++++
 4 files changed, 69 insertions(+), 8 deletions(-)

diff --git a/docs/designs/synapse-production-big-screen-tasks.md b/docs/designs/synapse-production-big-screen-tasks.md
index 1b11886..134a2f9 100644
--- a/docs/designs/synapse-production-big-screen-tasks.md
+++ b/docs/designs/synapse-production-big-screen-tasks.md
@@ -102,13 +102,13 @@ gofmt -w internal/api/handlers/production_dashboard.go internal/api/handlers/pro
 - overview `trend` 改为数据生产数量趋势，按 `episodes` 数据生产记录聚合，不再使用任务状态桶作为趋势口径。
 - `devices` 只返回在线/不在线汇总，不返回 `items`；设备在线以 recorder hub 与 transfer hub 均联通为准。
 - `stations.summary` 返回工位管理状态汇总：`active` 执行中、`inactive` 待命中、`break` 休息中、`offline` 离线。
-- `recent_tasks` 覆盖最近完成、失败、进行中的任务。
+- `recent_tasks` 覆盖最近完成、失败、进行中的任务，并由后端按大屏展示优先级排序后再截取：`in_progress`，`failed`/`cancelled`，`completed`，`ready`，`pending`，最后其他状态；同优先级按 `updated_at`、任务主键倒序。
 - `quality.recent_failures` 如果查询成本可控则实现，否则保留空数组。
 
 **验收标准:**
 
 - overview 中 `trend` 每个点包含 `date`、`total`，`total` 表示当天数据生产记录数量。
-- `recent_tasks` 按最近更新时间倒序，受 `recent_limit` 限制。
+- `recent_tasks` 按展示优先级和最近更新时间排序，受 `recent_limit` 限制；前端不得在已截断的小集合上重新定义业务排序。
 - 所有 limit 参数有上限，避免大屏接口返回过大。
 
 **验证命令:**
@@ -301,6 +301,11 @@ npm run build
 - 可以为设备/工位状态加入克制 CSS 动效：执行中状态灯低幅度呼吸、状态分布条宽度过渡、6 到 8 秒一次的淡巡检扫描、刷新成功短脉冲；必须支持 `prefers-reduced-motion`。
 - 禁止大面积霓虹、持续快速闪烁、跑马灯、雷达式强动效，以及任何会改变 grid track、面板高度或造成滚动的动画。
 - 任务流显示最近任务，不做后台表格。
+- 任务流动画与数据刷新绑定：新入列任务短暂滑入和扫描高光，状态变化任务短暂状态脉冲，`in_progress` 任务低频呼吸，失败/取消任务不持续闪烁。
+- 任务流使用 `TransitionGroup` 或等价 CSS transform/opacity 方案处理重排移动；动画不得改变卡片高度、grid track 或产生滚动，并支持 `prefers-reduced-motion`。
+- 任务流不使用贯穿列表的装饰性竖线或时间轴线；通过卡片边框、状态色和短时动画表达状态即可。
+- 前端应请求略大的 `recent_tasks` 候选集，例如 `recent_limit=10`，再基于 `.task-feed` 实际高度、单条任务卡高度和间距动态计算可见条数；计算结果建议限制在 3 到 10 条。
+- 前端只按可用高度裁剪 API 已排序结果，不在已截断的小集合上重新排序；不得通过任务流内部滚动、页面滚动或缩小到不可读来容纳更多任务。
 - 异常状态内联展示在顶部状态、设备状态和任务流中，不新增告警栏。
 - 图表和列表不抢中央舞台视觉中心。
 - 本轮一屏化改造将 `/admin/dashboard` 作为沉浸式大屏路由处理，隐藏常规后台侧栏，页面根容器使用 `100dvh` 锁高，并让外层内容区 `overflow: hidden`；不能通过页面纵向滚动或 `overflow-y: auto` 兜底。
@@ -318,6 +323,7 @@ npm run build
 - 设备/工位状态动画在默认模式下克制可见，在 `prefers-reduced-motion` 下静态或近似静态。
 - 图表 resize 正常，组件卸载时 dispose。
 - 任务流和设备列表数量受限，不造成小屏溢出。
+- 最近任务流没有装饰性竖线；可见任务条数会随 `1920x1080`、`1600x900`、`1366x768`、`1280x720`、`1152x648` 的真实可用高度自动增减，且不产生任务流内部滚动或页面滚动。
 - API 失败时有可见降级提示。
 - `3840x2160`、`2560x1440`、`1920x1080`、`1600x900`、`1366x768` 横屏视口下，document/body 不出现纵向滚动，dashboard 根容器高度不超过 viewport，核心区域不重叠。
 - `1366x768`、`1280x720`、`1152x648` 下顶部完整日期时间和全屏按钮均可见，且不触发横向滚动。
diff --git a/docs/designs/synapse-production-big-screen.md b/docs/designs/synapse-production-big-screen.md
index 4e6b30e..bd30764 100644
--- a/docs/designs/synapse-production-big-screen.md
+++ b/docs/designs/synapse-production-big-screen.md
@@ -163,7 +163,32 @@ overview 不再返回设备或工位明细 `items`。前端只能使用 `devices
 - 当前批次任务
 - 任务状态、机器人、工位、批次、耗时
 
-任务流应避免普通后台表格感，建议使用紧凑事件流或生产流水线样式。
+任务流应避免普通后台表格感，建议使用紧凑事件流或生产流水线样式，但不要使用贯穿列表的装饰性竖线或时间轴线。大屏可展示条数很少，筛选和排序必须由后端在完整任务集合上完成，前端只按 API 返回顺序展示和裁剪。
+
+候选集与裁剪策略：
+
+- 后端按展示优先级完成排序后，再按 `recent_limit` 返回候选任务；默认值可以保守，但大屏前端应主动请求略大的候选集，例如 `recent_limit=10`，上限仍受 API 保护。
+- 前端不得把接口返回的候选任务全部强行塞进卡片，也不得给任务流开启内部滚动；应根据 `.task-feed` 实际高度、单条任务卡高度和间距计算可见条数。
+- 可见条数建议在 3 到 10 条之间夹取；`1920x1080`、`1600x900`、`1366x768`、`1280x720`、`1152x648` 下都应按真实空间自动增减。
+- 任务流区域变化时使用 `ResizeObserver` 或等价机制重新计算可见条数，避免 70 寸电视、浏览器缩放或系统缩放后出现空白过大、溢出或遮挡。
+- 前端只做容量裁剪，不重新定义业务排序；如果空间只能显示 5 条，就展示 API 顺序中的前 5 条。
+
+展示优先级：
+
+- 正在执行：`in_progress` 优先，表示现场当前生产节拍。
+- 刚失败或取消：`failed`、`cancelled` 次之，表示需要关注的近期中断。
+- 刚完成：`completed` 再次，表示产线吞吐。
+- 等待执行：`ready`、`pending` 最后，小屏裁剪时优先被移出。
+- 同一优先级内按 `updated_at` 倒序，再按任务主键倒序，保证刷新前后顺序稳定。
+
+任务流动画应与数据刷新绑定，而不是持续装饰：
+
+- 新进入列表的任务可以有一次短暂入列动画和横向扫描高光。
+- 同一任务状态或更新时间变化时可以有一次状态色脉冲。
+- `in_progress` 卡片可以低频呼吸，表达正在执行。
+- `failed`、`cancelled` 只做一次短脉冲，不持续闪烁。
+- 列表重排使用 transform/opacity 平滑移动，不改变卡片高度，不造成页面滚动。
+- 必须支持 `prefers-reduced-motion`，减少或关闭入列、脉冲和移动动画。
 
 ### 3.7 异常与降级状态
 
@@ -521,7 +546,7 @@ GET /api/v1/production/dashboard/overview
 |---|---:|---|
 | `timezone_offset` | 当前前端时区 | 趋势聚合使用 |
 | `trend_days` | 7 | 趋势窗口，最大 31 |
-| `recent_limit` | 12 | 最近任务条数 |
+| `recent_limit` | 10 | 最近任务候选条数；大屏前端按可用高度裁剪 |
 | `preview_limit` | 8 | 轮播预览条数 |
 | `factory_id` | 空 | 管理端筛选 |
 | `organization_id` | 空 | 管理端筛选 |
@@ -679,7 +704,7 @@ GET /api/v1/production/dashboard/overview
 | `VideoFlightStage.vue` | 视频轮播状态机、current/next 媒体槽位、fallback | current/next video slot、current/next MCAP reader、stage timer、video event listeners |
 | `BigScreenKpiStrip.vue` | KPI 展示、数字格式化、轻量刷新动效 | 可选数字动画 timer |
 | `BigScreenStatusRail.vue` | 设备与工位状态摘要、分布条、抽象状态矩阵，不展示具体设备列表 | 可选刷新脉冲 / 巡检扫描 CSS 动画 |
-| `BigScreenTaskFeed.vue` | 最近任务流 | 无，纯展示 |
+| `BigScreenTaskFeed.vue` | 最近任务流、入列/更新/进行中动画 | 短时动画标记 timer |
 | `BigScreenTrendPanel.vue` | ECharts 趋势图 | chart instance、ResizeObserver |
 | `useProductionBigScreenData.js` | overview 请求、adapter、mock fallback、刷新调度 | polling timer |
 
diff --git a/internal/api/handlers/production_dashboard.go b/internal/api/handlers/production_dashboard.go
index 6f58ed4..13a46a1 100644
--- a/internal/api/handlers/production_dashboard.go
+++ b/internal/api/handlers/production_dashboard.go
@@ -30,7 +30,7 @@ const (
 	maxDashboardDistributionLimit     = 100
 	defaultDashboardActiveLimit       = 20
 	maxDashboardActiveLimit           = 100
-	defaultDashboardRecentLimit       = 12
+	defaultDashboardRecentLimit       = 10
 	maxDashboardRecentLimit           = 50
 	defaultDashboardPreviewLimit      = 8
 	maxDashboardPreviewLimit          = 20
@@ -481,7 +481,7 @@ func (h *ProductionDashboardHandler) GetSnapshot(c *gin.Context) {
 // @Param        timezone_offset query string false "Timezone offset such as +08:00"
 // @Param        trend_days query int false "Trend day count (default 7, max 31)"
 // @Param        active_limit query int false "Active batch limit (default 20, max 100)"
-// @Param        recent_limit query int false "Recent task limit (default 12, max 50)"
+// @Param        recent_limit query int false "Recent task limit (default 10, max 50)"
 // @Param        preview_limit query int false "Preview limit (default 8, max 20)"
 // @Success      200 {object} map[string]interface{} "generated_at, scope, summary, trend, task_status_distribution, quality, devices, stations, recent_tasks, previews"
 // @Failure      400 {object} map[string]string
@@ -1232,7 +1232,10 @@ func (h *ProductionDashboardHandler) dashboardRecentTasks(db dashboardDB, scope
 		) latest_episode ON latest_episode.task_id = t.id
 		LEFT JOIN episodes e ON e.id = latest_episode.latest_id AND e.deleted_at IS NULL
 		WHERE ` + strings.Join(conditions, " AND ") + `
-		ORDER BY COALESCE(t.updated_at, t.completed_at, t.started_at, t.assigned_at, t.created_at) DESC, t.id DESC
+		ORDER BY
+			` + dashboardRecentTaskPrioritySQL("t.status") + ` ASC,
+			COALESCE(t.updated_at, t.completed_at, t.started_at, t.assigned_at, t.created_at) DESC,
+			t.id DESC
 		LIMIT ?
 	`
 	args = append(args, limit)
@@ -1262,6 +1265,17 @@ func (h *ProductionDashboardHandler) dashboardRecentTasks(db dashboardDB, scope
 	return items, nil
 }
 
+func dashboardRecentTaskPrioritySQL(statusExpr string) string {
+	return `CASE
+		WHEN ` + statusExpr + ` = 'in_progress' THEN 1
+		WHEN ` + statusExpr + ` IN ('failed', 'cancelled') THEN 2
+		WHEN ` + statusExpr + ` = 'completed' THEN 3
+		WHEN ` + statusExpr + ` = 'ready' THEN 4
+		WHEN ` + statusExpr + ` = 'pending' THEN 5
+		ELSE 6
+	END`
+}
+
 func (h *ProductionDashboardHandler) dashboardPreviews(db dashboardDB, scope productionDashboardScope, limit int) ([]dashboardPreviewItem, error) {
 	conditions := []string{"e.deleted_at IS NULL"}
 	args := []interface{}{}
diff --git a/internal/api/handlers/production_dashboard_test.go b/internal/api/handlers/production_dashboard_test.go
index e7b8d1d..8cd9982 100644
--- a/internal/api/handlers/production_dashboard_test.go
+++ b/internal/api/handlers/production_dashboard_test.go
@@ -200,6 +200,22 @@ func TestProductionDashboardOverviewDistributionAndDevices(t *testing.T) {
 	}
 }
 
+func TestDashboardRecentTaskPrioritySQL(t *testing.T) {
+	expr := dashboardRecentTaskPrioritySQL("t.status")
+	for _, want := range []string{
+		"WHEN t.status = 'in_progress' THEN 1",
+		"WHEN t.status IN ('failed', 'cancelled') THEN 2",
+		"WHEN t.status = 'completed' THEN 3",
+		"WHEN t.status = 'ready' THEN 4",
+		"WHEN t.status = 'pending' THEN 5",
+		"ELSE 6",
+	} {
+		if !strings.Contains(expr, want) {
+			t.Fatalf("priority SQL should contain %q: %s", want, expr)
+		}
+	}
+}
+
 func TestProductionDashboardEpisodePreviewURL(t *testing.T) {
 	got := dashboardEpisodePreviewURL("42", "mcap/episode-42.mcap")
 	if got != "/api/v1/episodes/42/presign?kind=mcap" {

From 3fc0a6ac2bd04a16ed967e3759b14c2fc5836755 Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Mon, 18 May 2026 03:30:49 +0800
Subject: [PATCH 08/17] feat(production): include preview device metadata

---
 docs/designs/synapse-production-big-screen.md | 6 ++++++
 internal/api/handlers/production_dashboard.go | 8 ++++++++
 2 files changed, 14 insertions(+)

diff --git a/docs/designs/synapse-production-big-screen.md b/docs/designs/synapse-production-big-screen.md
index bd30764..3d599f6 100644
--- a/docs/designs/synapse-production-big-screen.md
+++ b/docs/designs/synapse-production-big-screen.md
@@ -412,6 +412,8 @@ fallback 策略：
 | `previews` 为空 | 显示健康空状态：暂无可轮播预览，保留 KPI 和趋势 |
 | 自动播放被浏览器限制 | 对真实视频静音重试；若仍失败，优先降级到 MCAP 图像帧，再退回 poster / 轻量等待状态 |
 
+舞台播放卡片的元信息应以任务名、SOP 名、机器人、设备 ID 和必要的播放进度为主；不要在卡片上展示 episode ID、工位名、MCAP topic 名或“数据预览”字样。
+
 ## 6. 响应式布局方案
 
 ### 6.1 总原则
@@ -665,6 +667,8 @@ GET /api/v1/production/dashboard/overview
   "id": "episode:42",
   "title": "片段 EP-20260517-00042",
   "task_name": "抓取-放置标准动作采集",
+  "sop_label": "pick-place@v3",
+  "device_id": "AB-F0001-T0003-000001",
   "robot_name": "RB-07",
   "station_name": "A-03 工位",
   "status": "approved",
@@ -830,6 +834,8 @@ page mounted
  * @property {string} id
  * @property {string} title
  * @property {string} task_name
+ * @property {string} sop_label
+ * @property {string} device_id
  * @property {string} robot_name
  * @property {string} station_name
  * @property {string} status
diff --git a/internal/api/handlers/production_dashboard.go b/internal/api/handlers/production_dashboard.go
index 13a46a1..6f7d020 100644
--- a/internal/api/handlers/production_dashboard.go
+++ b/internal/api/handlers/production_dashboard.go
@@ -302,6 +302,8 @@ type dashboardPreviewItem struct {
 	ID              string  `json:"id"`
 	Title           string  `json:"title"`
 	TaskName        string  `json:"task_name"`
+	SOPLabel        string  `json:"sop_label"`
+	DeviceID        string  `json:"device_id"`
 	RobotName       string  `json:"robot_name"`
 	StationName     string  `json:"station_name"`
 	Status          string  `json:"status"`
@@ -318,6 +320,8 @@ type dashboardPreviewRow struct {
 	ID              string          `db:"id"`
 	Title           string          `db:"title"`
 	TaskName        string          `db:"task_name"`
+	SOPLabel        string          `db:"sop_label"`
+	DeviceID        string          `db:"device_id"`
 	RobotName       string          `db:"robot_name"`
 	StationName     string          `db:"station_name"`
 	Status          string          `db:"status"`
@@ -1286,6 +1290,8 @@ func (h *ProductionDashboardHandler) dashboardPreviews(db dashboardDB, scope pro
 			CAST(e.id AS CHAR) AS id,
 			CONCAT('Episode ', COALESCE(NULLIF(e.episode_id, ''), CAST(e.id AS CHAR))) AS title,
 			` + taskNameExpr + ` AS task_name,
+			` + dashboardSOPLabelSQL("t.sop_id", "s.slug", "s.version") + ` AS sop_label,
+			COALESCE(ws.robot_serial, '') AS device_id,
 			COALESCE(ws.robot_name, ws.robot_serial, '') AS robot_name,
 			COALESCE(ws.name, CAST(ws.id AS CHAR), '') AS station_name,
 			COALESCE(NULLIF(t.status, ''), e.qa_status, '') AS status,
@@ -1314,6 +1320,8 @@ func (h *ProductionDashboardHandler) dashboardPreviews(db dashboardDB, scope pro
 			ID:              row.ID,
 			Title:           row.Title,
 			TaskName:        row.TaskName,
+			SOPLabel:        row.SOPLabel,
+			DeviceID:        row.DeviceID,
 			RobotName:       row.RobotName,
 			StationName:     row.StationName,
 			Status:          row.Status,

From eae57e04ca1369dfbaed914c0f315413f687aa51 Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Mon, 18 May 2026 03:58:40 +0800
Subject: [PATCH 09/17] fix(production): order big screen tasks by recency

---
 .../synapse-production-big-screen-tasks.md    | 10 ++++++---
 docs/designs/synapse-production-big-screen.md | 20 +++++++++---------
 internal/api/handlers/production_dashboard.go | 21 ++++++++-----------
 .../api/handlers/production_dashboard_test.go | 17 +++++++--------
 4 files changed, 34 insertions(+), 34 deletions(-)

diff --git a/docs/designs/synapse-production-big-screen-tasks.md b/docs/designs/synapse-production-big-screen-tasks.md
index 134a2f9..fd0cee2 100644
--- a/docs/designs/synapse-production-big-screen-tasks.md
+++ b/docs/designs/synapse-production-big-screen-tasks.md
@@ -102,13 +102,14 @@ gofmt -w internal/api/handlers/production_dashboard.go internal/api/handlers/pro
 - overview `trend` 改为数据生产数量趋势，按 `episodes` 数据生产记录聚合，不再使用任务状态桶作为趋势口径。
 - `devices` 只返回在线/不在线汇总，不返回 `items`；设备在线以 recorder hub 与 transfer hub 均联通为准。
 - `stations.summary` 返回工位管理状态汇总：`active` 执行中、`inactive` 待命中、`break` 休息中、`offline` 离线。
-- `recent_tasks` 覆盖最近完成、失败、进行中的任务，并由后端按大屏展示优先级排序后再截取：`in_progress`，`failed`/`cancelled`，`completed`，`ready`，`pending`，最后其他状态；同优先级按 `updated_at`、任务主键倒序。
+- `recent_tasks` 覆盖最近发生变化的任务，并由后端按最近更新时间排序后再截取：`updated_at` 倒序，再按任务主键倒序；`updated_at` 可继续使用 `COALESCE(t.updated_at, t.completed_at, t.started_at, t.assigned_at, t.created_at)` 兜底。
+- `recent_tasks` 不再按状态优先级置顶 `failed` 或 `cancelled`；失败和取消只作为最近变化的一种状态展示，避免旧异常占满任务流。
 - `quality.recent_failures` 如果查询成本可控则实现，否则保留空数组。
 
 **验收标准:**
 
 - overview 中 `trend` 每个点包含 `date`、`total`，`total` 表示当天数据生产记录数量。
-- `recent_tasks` 按展示优先级和最近更新时间排序，受 `recent_limit` 限制；前端不得在已截断的小集合上重新定义业务排序。
+- `recent_tasks` 按最近更新时间排序，受 `recent_limit` 限制；前端不得在已截断的小集合上重新定义业务排序。
 - 所有 limit 参数有上限，避免大屏接口返回过大。
 
 **验证命令:**
@@ -301,7 +302,8 @@ npm run build
 - 可以为设备/工位状态加入克制 CSS 动效：执行中状态灯低幅度呼吸、状态分布条宽度过渡、6 到 8 秒一次的淡巡检扫描、刷新成功短脉冲；必须支持 `prefers-reduced-motion`。
 - 禁止大面积霓虹、持续快速闪烁、跑马灯、雷达式强动效，以及任何会改变 grid track、面板高度或造成滚动的动画。
 - 任务流显示最近任务，不做后台表格。
-- 任务流动画与数据刷新绑定：新入列任务短暂滑入和扫描高光，状态变化任务短暂状态脉冲，`in_progress` 任务低频呼吸，失败/取消任务不持续闪烁。
+- 任务卡增加四节点生命周期轨，表达 `pending -> ready -> in_progress -> completed`；第一版由前端基于当前 `status` 推断节点，不要求后端返回状态历史。
+- 任务流动画与数据刷新绑定：新入列任务短暂滑入和扫描高光；状态变化任务让生命周期轨短暂扫光、当前节点脉冲；`in_progress` 当前节点低频呼吸；失败/取消任务不持续闪烁。
 - 任务流使用 `TransitionGroup` 或等价 CSS transform/opacity 方案处理重排移动；动画不得改变卡片高度、grid track 或产生滚动，并支持 `prefers-reduced-motion`。
 - 任务流不使用贯穿列表的装饰性竖线或时间轴线；通过卡片边框、状态色和短时动画表达状态即可。
 - 前端应请求略大的 `recent_tasks` 候选集，例如 `recent_limit=10`，再基于 `.task-feed` 实际高度、单条任务卡高度和间距动态计算可见条数；计算结果建议限制在 3 到 10 条。
@@ -322,6 +324,8 @@ npm run build
 - 设备/工位状态区只展示设备和工位聚合状态，不出现具体设备名、工位名、机器人名、操作员或当前任务明细。
 - 设备/工位状态动画在默认模式下克制可见，在 `prefers-reduced-motion` 下静态或近似静态。
 - 图表 resize 正常，组件卸载时 dispose。
+- 最近任务流按 `updated_at` 最近变化排序，不因 `failed` 或 `cancelled` 状态置顶而挤出正常生产任务。
+- 每张任务卡展示四节点生命周期轨；状态变化时有一次短时轨道扫光和当前节点脉冲，`prefers-reduced-motion` 下关闭这些动画。
 - 任务流和设备列表数量受限，不造成小屏溢出。
 - 最近任务流没有装饰性竖线；可见任务条数会随 `1920x1080`、`1600x900`、`1366x768`、`1280x720`、`1152x648` 的真实可用高度自动增减，且不产生任务流内部滚动或页面滚动。
 - API 失败时有可见降级提示。
diff --git a/docs/designs/synapse-production-big-screen.md b/docs/designs/synapse-production-big-screen.md
index 3d599f6..9a748c6 100644
--- a/docs/designs/synapse-production-big-screen.md
+++ b/docs/designs/synapse-production-big-screen.md
@@ -167,26 +167,26 @@ overview 不再返回设备或工位明细 `items`。前端只能使用 `devices
 
 候选集与裁剪策略：
 
-- 后端按展示优先级完成排序后，再按 `recent_limit` 返回候选任务；默认值可以保守，但大屏前端应主动请求略大的候选集，例如 `recent_limit=10`，上限仍受 API 保护。
+- 后端按最近更新时间返回候选任务：`updated_at` 倒序，再按任务主键倒序；`updated_at` 可继续使用 `COALESCE(t.updated_at, t.completed_at, t.started_at, t.assigned_at, t.created_at)` 兜底，保证状态变化后的任务会进入最近任务流。
+- 后端不再按状态优先级置顶 `failed` 或 `cancelled`；失败和取消只作为最近变化的一种状态展示，避免旧异常占满任务流。
 - 前端不得把接口返回的候选任务全部强行塞进卡片，也不得给任务流开启内部滚动；应根据 `.task-feed` 实际高度、单条任务卡高度和间距计算可见条数。
 - 可见条数建议在 3 到 10 条之间夹取；`1920x1080`、`1600x900`、`1366x768`、`1280x720`、`1152x648` 下都应按真实空间自动增减。
 - 任务流区域变化时使用 `ResizeObserver` 或等价机制重新计算可见条数，避免 70 寸电视、浏览器缩放或系统缩放后出现空白过大、溢出或遮挡。
 - 前端只做容量裁剪，不重新定义业务排序；如果空间只能显示 5 条，就展示 API 顺序中的前 5 条。
 
-展示优先级：
+任务生命周期轨：
 
-- 正在执行：`in_progress` 优先，表示现场当前生产节拍。
-- 刚失败或取消：`failed`、`cancelled` 次之，表示需要关注的近期中断。
-- 刚完成：`completed` 再次，表示产线吞吐。
-- 等待执行：`ready`、`pending` 最后，小屏裁剪时优先被移出。
-- 同一优先级内按 `updated_at` 倒序，再按任务主键倒序，保证刷新前后顺序稳定。
+- 每张任务卡应使用四节点生命周期轨表达 `pending -> ready -> in_progress -> completed`，用于体现任务从待处理到完成的过程。
+- `pending` 点亮第 1 节点，`ready` 点亮第 1、2 节点，`in_progress` 点亮第 1 到 3 节点且当前节点低频呼吸，`completed` 点亮全部 4 个节点。
+- `failed` 和 `cancelled` 不进入置顶排序；卡片状态文案仍显示失败/已取消，生命周期轨使用低饱和异常或取消态，并只做一次短时反馈，不持续闪烁。
+- 第一版不要求后端返回状态历史；前端基于当前 `status` 推断生命周期位置。若后续需要精确展示失败/取消发生在哪个阶段，再扩展 `previous_status` 或状态历史字段。
 
 任务流动画应与数据刷新绑定，而不是持续装饰：
 
 - 新进入列表的任务可以有一次短暂入列动画和横向扫描高光。
-- 同一任务状态或更新时间变化时可以有一次状态色脉冲。
-- `in_progress` 卡片可以低频呼吸，表达正在执行。
-- `failed`、`cancelled` 只做一次短脉冲，不持续闪烁。
+- 同一任务状态变化时，生命周期轨做一次短时扫光，当前节点做一次脉冲；如果只是 `updated_at` 变化但状态未变，只保留轻量卡片脉冲。
+- `in_progress` 生命周期当前节点可以低频呼吸，表达正在执行。
+- `completed` 状态变化时完成节点短暂亮起后保持静态；`failed`、`cancelled` 只做一次短脉冲，不持续闪烁。
 - 列表重排使用 transform/opacity 平滑移动，不改变卡片高度，不造成页面滚动。
 - 必须支持 `prefers-reduced-motion`，减少或关闭入列、脉冲和移动动画。
 
diff --git a/internal/api/handlers/production_dashboard.go b/internal/api/handlers/production_dashboard.go
index 6f7d020..d6f9575 100644
--- a/internal/api/handlers/production_dashboard.go
+++ b/internal/api/handlers/production_dashboard.go
@@ -1210,6 +1210,7 @@ func (h *ProductionDashboardHandler) dashboardRecentTasks(db dashboardDB, scope
 	args := []interface{}{}
 	conditions, args = appendDashboardTaskScope(conditions, args, scope)
 	taskNameExpr := dashboardTaskNameSQL("t.scene_name", "t.subscene_name", "t.sop_id", "s.slug", "s.version")
+	updatedAtExpr := dashboardRecentTaskUpdatedAtSQL("t")
 	query := `
 		SELECT
 			CAST(t.id AS CHAR) AS id,
@@ -1223,7 +1224,7 @@ func (h *ProductionDashboardHandler) dashboardRecentTasks(db dashboardDB, scope
 			` + dashboardSOPLabelSQL("t.sop_id", "s.slug", "s.version") + ` AS sop_label,
 			COALESCE(e.episode_id, '') AS episode_id,
 			t.created_at AS created_at,
-			COALESCE(t.updated_at, t.completed_at, t.started_at, t.assigned_at, t.created_at) AS updated_at
+			` + updatedAtExpr + ` AS updated_at
 		FROM tasks t
 		LEFT JOIN sops s ON s.id = t.sop_id AND s.deleted_at IS NULL
 		LEFT JOIN batches b ON b.id = t.batch_id AND b.deleted_at IS NULL
@@ -1237,8 +1238,7 @@ func (h *ProductionDashboardHandler) dashboardRecentTasks(db dashboardDB, scope
 		LEFT JOIN episodes e ON e.id = latest_episode.latest_id AND e.deleted_at IS NULL
 		WHERE ` + strings.Join(conditions, " AND ") + `
 		ORDER BY
-			` + dashboardRecentTaskPrioritySQL("t.status") + ` ASC,
-			COALESCE(t.updated_at, t.completed_at, t.started_at, t.assigned_at, t.created_at) DESC,
+			` + updatedAtExpr + ` DESC,
 			t.id DESC
 		LIMIT ?
 	`
@@ -1269,15 +1269,12 @@ func (h *ProductionDashboardHandler) dashboardRecentTasks(db dashboardDB, scope
 	return items, nil
 }
 
-func dashboardRecentTaskPrioritySQL(statusExpr string) string {
-	return `CASE
-		WHEN ` + statusExpr + ` = 'in_progress' THEN 1
-		WHEN ` + statusExpr + ` IN ('failed', 'cancelled') THEN 2
-		WHEN ` + statusExpr + ` = 'completed' THEN 3
-		WHEN ` + statusExpr + ` = 'ready' THEN 4
-		WHEN ` + statusExpr + ` = 'pending' THEN 5
-		ELSE 6
-	END`
+func dashboardRecentTaskUpdatedAtSQL(taskAlias string) string {
+	prefix := strings.TrimSpace(taskAlias)
+	if prefix != "" {
+		prefix += "."
+	}
+	return `COALESCE(` + prefix + `updated_at, ` + prefix + `completed_at, ` + prefix + `started_at, ` + prefix + `assigned_at, ` + prefix + `created_at)`
 }
 
 func (h *ProductionDashboardHandler) dashboardPreviews(db dashboardDB, scope productionDashboardScope, limit int) ([]dashboardPreviewItem, error) {
diff --git a/internal/api/handlers/production_dashboard_test.go b/internal/api/handlers/production_dashboard_test.go
index 8cd9982..0a58a3d 100644
--- a/internal/api/handlers/production_dashboard_test.go
+++ b/internal/api/handlers/production_dashboard_test.go
@@ -200,18 +200,17 @@ func TestProductionDashboardOverviewDistributionAndDevices(t *testing.T) {
 	}
 }
 
-func TestDashboardRecentTaskPrioritySQL(t *testing.T) {
-	expr := dashboardRecentTaskPrioritySQL("t.status")
+func TestDashboardRecentTaskUpdatedAtSQL(t *testing.T) {
+	expr := dashboardRecentTaskUpdatedAtSQL("t")
 	for _, want := range []string{
-		"WHEN t.status = 'in_progress' THEN 1",
-		"WHEN t.status IN ('failed', 'cancelled') THEN 2",
-		"WHEN t.status = 'completed' THEN 3",
-		"WHEN t.status = 'ready' THEN 4",
-		"WHEN t.status = 'pending' THEN 5",
-		"ELSE 6",
+		"t.updated_at",
+		"t.completed_at",
+		"t.started_at",
+		"t.assigned_at",
+		"t.created_at",
 	} {
 		if !strings.Contains(expr, want) {
-			t.Fatalf("priority SQL should contain %q: %s", want, expr)
+			t.Fatalf("recent task updated_at SQL should contain %q: %s", want, expr)
 		}
 	}
 }

From b6844bb567a14c26b1767de93c11777480258468 Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Mon, 18 May 2026 04:16:08 +0800
Subject: [PATCH 10/17] docs(production): define big screen brand palette

---
 .../synapse-production-big-screen-tasks.md    |  6 +++++
 docs/designs/synapse-production-big-screen.md | 27 ++++++++++++++++---
 2 files changed, 29 insertions(+), 4 deletions(-)

diff --git a/docs/designs/synapse-production-big-screen-tasks.md b/docs/designs/synapse-production-big-screen-tasks.md
index fd0cee2..b8273b0 100644
--- a/docs/designs/synapse-production-big-screen-tasks.md
+++ b/docs/designs/synapse-production-big-screen-tasks.md
@@ -310,6 +310,9 @@ npm run build
 - 前端只按可用高度裁剪 API 已排序结果，不在已截断的小集合上重新排序；不得通过任务流内部滚动、页面滚动或缩小到不可读来容纳更多任务。
 - 异常状态内联展示在顶部状态、设备状态和任务流中，不新增告警栏。
 - 图表和列表不抢中央舞台视觉中心。
+- 色系统一切换为“工业暗屏基底 + ArcheBase 品牌强调色”的方向；品牌色从现有 `--brand-blue`、`--brand-cyan`、`--brand-yellow` 派生为大屏 token，例如 `--screen-brand-primary`、`--screen-brand-strong`、`--screen-brand-soft`、`--screen-brand-line`，避免在大屏中到处硬编码亮色。
+- 品牌强调色只用于品牌标识、当前焦点、关键数字、Video Flight Stage 边框、趋势主系列和任务生命周期当前节点；不能大面积铺满背景、整卡发光或让非重点信息抢占视觉中心。
+- 生产状态色保持独立语义：在线/完成使用绿色，警告使用琥珀色，失败/质检异常使用红色，设备不在线和工位离线使用灰色；品牌色不能替代失败、离线或警告语义。
 - 本轮一屏化改造将 `/admin/dashboard` 作为沉浸式大屏路由处理，隐藏常规后台侧栏，页面根容器使用 `100dvh` 锁高，并让外层内容区 `overflow: hidden`；不能通过页面纵向滚动或 `overflow-y: auto` 兜底。
 - 大屏主体采用三行布局：顶部状态栏、KPI 条、主驾驶舱 grid。主驾驶舱再分为设备状态、中央 Video Flight Stage + 趋势、最近任务流三列，所有列都使用 `minmax(0, 1fr)` 和 `min-height: 0` 允许内部压缩。
 - `1366x768` 与 `1600x900` 下优先保留顶部状态、8 个 KPI、Video Flight Stage、趋势、设备状态和最近任务流；设备/任务列表可减少条目，质量指标压缩为任务流内的窄条，不再占用独立面板。
@@ -328,6 +331,9 @@ npm run build
 - 每张任务卡展示四节点生命周期轨；状态变化时有一次短时轨道扫光和当前节点脉冲，`prefers-reduced-motion` 下关闭这些动画。
 - 任务流和设备列表数量受限，不造成小屏溢出。
 - 最近任务流没有装饰性竖线；可见任务条数会随 `1920x1080`、`1600x900`、`1366x768`、`1280x720`、`1152x648` 的真实可用高度自动增减，且不产生任务流内部滚动或页面滚动。
+- ArcheBase 品牌色在主焦点和关键数字中可见，但不会主导整屏色相；页面整体仍保持克制、工业、远距离可读。
+- 失败、警告、离线、在线等状态不会被品牌色覆盖；设备不在线和工位离线仍为灰色。
+- `1152x648` 和 `1280x720` 下品牌色、状态色、文字对比度仍可读，不出现紫色霓虹、满屏发光卡片或营销页色彩漂移。
 - API 失败时有可见降级提示。
 - `3840x2160`、`2560x1440`、`1920x1080`、`1600x900`、`1366x768` 横屏视口下，document/body 不出现纵向滚动，dashboard 根容器高度不超过 viewport，核心区域不重叠。
 - `1366x768`、`1280x720`、`1152x648` 下顶部完整日期时间和全屏按钮均可见，且不触发横向滚动。
diff --git a/docs/designs/synapse-production-big-screen.md b/docs/designs/synapse-production-big-screen.md
index 9a748c6..902990a 100644
--- a/docs/designs/synapse-production-big-screen.md
+++ b/docs/designs/synapse-production-big-screen.md
@@ -236,18 +236,37 @@ overview 不再返回设备或工位明细 `items`。前端只能使用 `devices
 
 ### 4.3 色彩与状态
 
-建议沿用现有品牌蓝和中性色变量，但为大屏定义清晰的状态语义：
+建议引入 ArcheBase 品牌色作为生产大屏的主强调色，但不是把页面改成品牌营销页。大屏基底仍以工业深色、冷灰和低饱和中性色为主，品牌色只用于建立识别度和当前焦点。
+
+Synapse 现有全局变量中已经定义 ArcheBase 品牌色：
+
+- `--brand-blue: #07338c`
+- `--brand-cyan: #079dd9`
+- `--brand-yellow: #f1d86b`
+
+大屏不应直接把这些亮色大面积铺满，而应在 `/admin/dashboard` 内派生一组暗屏 token，例如：
+
+- `--screen-brand-primary`：用于品牌标识、当前焦点、主行动线，可从 `--brand-cyan` 或适合暗屏的品牌蓝/青混合值派生。
+- `--screen-brand-strong`：用于关键数字、Video Flight Stage 边框、生命周期当前节点。
+- `--screen-brand-soft`：用于轻量背景、hover、弱扫描线和刷新脉冲。
+- `--screen-brand-line`：用于面板边界、图表强调线和状态轨道。
+
+品牌强调色面积需要克制，建议只占屏幕可视面积的小比例，避免超过视觉重心。主舞台、KPI 数字、任务生命周期当前节点、趋势主数据系列可以使用品牌色；大面积背景、整卡发光、整列染色不使用品牌色。
+
+状态色必须保持生产语义独立，不能因为品牌化而混淆：
 
 | 状态 | 建议语义 | 使用限制 |
 |---|---|---|
 | 成功 / 在线 / 已完成 | 低饱和绿色 | 只用于正向状态 |
-| 进行中 / 主品牌 / 当前焦点 | 品牌蓝 | 用于主舞台边框、当前任务、重要数字 |
-| 待处理 / 等待 / 警告 | 琥珀色 | 不要大面积铺满 |
+| 进行中 / 主品牌 / 当前焦点 | ArcheBase 品牌蓝 / 品牌青的暗屏派生色 | 用于主舞台边框、当前任务、重要数字 |
+| 待处理 / 等待 / 警告 | 琥珀色，可参考品牌黄但需降饱和 | 不要大面积铺满，不替代警告语义 |
 | 失败 / 质量异常 | 红色 | 只用于任务失败、质检失败等生产异常 |
 | 设备不在线 / 工位离线 | 灰色 | 表达资源不可用，不使用红色抢占失败告警语义 |
 | 中性 / 无数据 | 灰蓝 | 用于背景和非重点信息 |
 
-图表避免默认彩虹色，使用 3 到 5 个语义色即可。
+图表避免默认彩虹色，使用 3 到 5 个语义色即可。近七日数据生产趋势的主系列优先使用品牌主强调色，但失败、警告、离线、空数据仍按上表语义色处理。
+
+禁止把大屏改成紫色霓虹、全卡发光或高饱和科技风。即使后续品牌资产中出现更鲜艳的颜色，也必须先转换成适合远距离观看、暗背景对比稳定的生产大屏 token。
 
 ### 4.4 字体与数字
 

From 1ca9aa6bb5561e50c8770c1127e1b49b074356dd Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Mon, 18 May 2026 04:30:21 +0800
Subject: [PATCH 11/17] docs(admin): define Synapse brand palette

---
 docs/designs/synapse-admin-brand-palette.md | 81 +++++++++++++++++++++
 1 file changed, 81 insertions(+)
 create mode 100644 docs/designs/synapse-admin-brand-palette.md

diff --git a/docs/designs/synapse-admin-brand-palette.md b/docs/designs/synapse-admin-brand-palette.md
new file mode 100644
index 0000000..b6001f5
--- /dev/null
+++ b/docs/designs/synapse-admin-brand-palette.md
@@ -0,0 +1,81 @@
+<!--
+SPDX-FileCopyrightText: 2026 ArcheBase
+
+SPDX-License-Identifier: MulanPSL-2.0
+-->
+
+# Synapse 管理后台品牌色系调整
+
+**Scope:** Synapse 非沉浸式管理后台页面，即 `/admin/*` 中除 `/admin/dashboard` 生产大屏外的普通管理页。
+
+## 1. 背景
+
+生产大屏已经采用“工业暗屏基底 + ArcheBase 品牌强调色”的视觉方向。普通管理后台也应与该方向保持品牌一致，但它的主要用途是高频操作、筛选、录入和表格扫描，因此不应直接套用生产大屏的暗色大屏布局。
+
+本调整的目标是统一色系，不重做全站设计系统、不改变信息架构、不修改 API。
+
+## 2. 设计方向
+
+普通管理后台采用“深色品牌导航 + 浅色操作台”的结构：
+
+- 左侧导航使用 ArcheBase 深蓝/青色暗屏基底，建立与生产大屏一致的品牌识别。
+- 主内容区保持浅色、低噪声、适合长时间操作和表格阅读。
+- 卡片、表格、筛选区使用冷灰蓝边界和轻量青色选中态。
+- 主要按钮、当前导航、排序/链接/进度等焦点元素使用 ArcheBase 品牌蓝/青色。
+- 状态色继续保持生产语义：成功/在线为绿色，进行中/当前焦点为品牌青，警告为琥珀色，失败为红色，离线/取消/不可用为灰色。
+
+## 3. Token 约束
+
+Synapse 已有品牌基础变量：
+
+- `--brand-blue: #07338c`
+- `--brand-cyan: #079dd9`
+- `--brand-yellow: #f1d86b`
+
+普通管理后台不应在各页面硬编码新色值，而应在 `AdminLayout.vue` 的非沉浸式 `.admin-layout` 范围内派生后台 token，并让子组件继承：
+
+- `--page-bg`：冷灰蓝页面基底。
+- `--surface-bg` / `--surface-subtle` / `--surface-muted` / `--surface-selected`：浅色操作台表面。
+- `--border-color` / `--border-subtle` / `--border-strong`：冷灰蓝边界。
+- `--admin-sidebar-bg` / `--admin-sidebar-text` / `--admin-sidebar-active-bg`：深色品牌导航。
+- `--admin-accent-line` / `--admin-accent-soft`：表格 hover、筛选区、卡片边界和焦点弱背景。
+
+生产大屏继续使用局部 `--screen-brand-*` token；普通后台不复用大屏的 `100dvh`、全屏 grid、视频舞台动效或大屏字号。
+
+## 4. 实现范围
+
+建议优先修改：
+
+- `src/components/layout/AdminLayout.vue`
+- `src/components/layout/AdminSidebar.vue`
+- `src/styles/admin-crud.css`
+- `src/components/crud/ListPageLayout.vue`
+- `src/components/crud/CrudFormLayout.vue`
+- `src/components/common/DataTable.vue`
+
+避免逐个重写所有管理页面。已有页面内使用 `var(--primary-*)`、`var(--secondary-*)`、`var(--surface-*)`、`var(--border-*)` 的样式应自然继承新色系。
+
+## 5. 验收标准
+
+- `/admin/dashboard` 生产大屏视觉不回退，仍保持沉浸式一屏布局。
+- `/admin/*` 普通管理页拥有一致的 ArcheBase 深蓝/青色品牌识别，但主内容区仍适合表格阅读和表单操作。
+- 管理后台不出现紫色霓虹、满屏发光卡片、营销页 hero 或大屏化排版。
+- 离线、取消、不可用仍为灰色；失败和错误仍为红色。
+- 侧边栏、表格、筛选区、表单页和通用按钮均能看到统一色系。
+- 桌面与移动宽度下导航和内容不重叠、不出现由色系调整引入的横向溢出。
+
+## 6. 验证
+
+前端至少运行：
+
+```bash
+npm run build
+```
+
+建议浏览检查：
+
+- `/admin/factories`
+- `/admin/workstations`
+- `/admin/tasks`
+- `/admin/statistics/data-production`
+- `/admin/dashboard`

From 05e8844c97afd2a6bb42d38f7eecef0e9c084c96 Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Mon, 18 May 2026 10:08:08 +0800
Subject: [PATCH 12/17] docs(admin): clarify dashboard entry behavior

---
 docs/designs/synapse-admin-brand-palette.md     | 17 +++++++++++++++--
 .../synapse-production-big-screen-tasks.md      |  4 ++++
 docs/designs/synapse-production-big-screen.md   |  9 ++++++---
 3 files changed, 25 insertions(+), 5 deletions(-)

diff --git a/docs/designs/synapse-admin-brand-palette.md b/docs/designs/synapse-admin-brand-palette.md
index b6001f5..6da91a6 100644
--- a/docs/designs/synapse-admin-brand-palette.md
+++ b/docs/designs/synapse-admin-brand-palette.md
@@ -55,16 +55,29 @@ Synapse 已有品牌基础变量：
 
 避免逐个重写所有管理页面。已有页面内使用 `var(--primary-*)`、`var(--secondary-*)`、`var(--surface-*)`、`var(--border-*)` 的样式应自然继承新色系。
 
-## 5. 验收标准
+## 5. 默认入口
+
+生产大屏是沉浸式展示入口，不是管理员日常操作首页。Admin 登录成功后应进入普通管理后台的工厂管理页面：
+
+- admin 登录成功默认跳转 `/admin/factories`。
+- 直接访问 `/admin` 默认重定向到 `/admin/factories`。
+- `/admin/dashboard` 仍作为显式生产大屏入口保留，可以从侧边栏“生产大屏”进入。
+- 旧 `/dashboard` legacy redirect 可以继续指向 `/admin/dashboard`，用于兼容已经配置好的电视或书签。
+
+这样可以避免管理员每次登录后误入全屏展示页面，同时不破坏生产大屏的独立访问路径。
+
+## 6. 验收标准
 
 - `/admin/dashboard` 生产大屏视觉不回退，仍保持沉浸式一屏布局。
 - `/admin/*` 普通管理页拥有一致的 ArcheBase 深蓝/青色品牌识别，但主内容区仍适合表格阅读和表单操作。
 - 管理后台不出现紫色霓虹、满屏发光卡片、营销页 hero 或大屏化排版。
 - 离线、取消、不可用仍为灰色；失败和错误仍为红色。
 - 侧边栏、表格、筛选区、表单页和通用按钮均能看到统一色系。
+- admin 登录成功和访问 `/admin` 都进入 `/admin/factories`，不会自动进入 `/admin/dashboard`。
+- `/admin/dashboard` 仍可直接访问，且侧边栏保留生产大屏入口。
 - 桌面与移动宽度下导航和内容不重叠、不出现由色系调整引入的横向溢出。
 
-## 6. 验证
+## 7. 验证
 
 前端至少运行：
 
diff --git a/docs/designs/synapse-production-big-screen-tasks.md b/docs/designs/synapse-production-big-screen-tasks.md
index b8273b0..90a5e51 100644
--- a/docs/designs/synapse-production-big-screen-tasks.md
+++ b/docs/designs/synapse-production-big-screen-tasks.md
@@ -313,6 +313,8 @@ npm run build
 - 色系统一切换为“工业暗屏基底 + ArcheBase 品牌强调色”的方向；品牌色从现有 `--brand-blue`、`--brand-cyan`、`--brand-yellow` 派生为大屏 token，例如 `--screen-brand-primary`、`--screen-brand-strong`、`--screen-brand-soft`、`--screen-brand-line`，避免在大屏中到处硬编码亮色。
 - 品牌强调色只用于品牌标识、当前焦点、关键数字、Video Flight Stage 边框、趋势主系列和任务生命周期当前节点；不能大面积铺满背景、整卡发光或让非重点信息抢占视觉中心。
 - 生产状态色保持独立语义：在线/完成使用绿色，警告使用琥珀色，失败/质检异常使用红色，设备不在线和工位离线使用灰色；品牌色不能替代失败、离线或警告语义。
+- 顶部品牌区显示真实 ArcheBase logo，并与 `SYNAPSE` 小标识、`生产指挥中心` 标题组合；logo 尺寸必须响应式压缩，不得影响完整日期时间和全屏按钮。
+- Video Flight Stage 的播放元信息以任务名称、SOP、机器人、设备 ID 和进度为主；MCAP 播放态不显示泛化的“播放中”文案，避免无效状态标签占用主舞台信息层。
 - 本轮一屏化改造将 `/admin/dashboard` 作为沉浸式大屏路由处理，隐藏常规后台侧栏，页面根容器使用 `100dvh` 锁高，并让外层内容区 `overflow: hidden`；不能通过页面纵向滚动或 `overflow-y: auto` 兜底。
 - 大屏主体采用三行布局：顶部状态栏、KPI 条、主驾驶舱 grid。主驾驶舱再分为设备状态、中央 Video Flight Stage + 趋势、最近任务流三列，所有列都使用 `minmax(0, 1fr)` 和 `min-height: 0` 允许内部压缩。
 - `1366x768` 与 `1600x900` 下优先保留顶部状态、8 个 KPI、Video Flight Stage、趋势、设备状态和最近任务流；设备/任务列表可减少条目，质量指标压缩为任务流内的窄条，不再占用独立面板。
@@ -333,6 +335,8 @@ npm run build
 - 最近任务流没有装饰性竖线；可见任务条数会随 `1920x1080`、`1600x900`、`1366x768`、`1280x720`、`1152x648` 的真实可用高度自动增减，且不产生任务流内部滚动或页面滚动。
 - ArcheBase 品牌色在主焦点和关键数字中可见，但不会主导整屏色相；页面整体仍保持克制、工业、远距离可读。
 - 失败、警告、离线、在线等状态不会被品牌色覆盖；设备不在线和工位离线仍为灰色。
+- 顶部 ArcheBase logo、`SYNAPSE`、`生产指挥中心`、完整日期时间和全屏按钮在 `1366x768`、`1280x720`、`1152x648` 下均可见。
+- Video Flight Stage 播放 MCAP 预览时不展示“播放中”文本，且任务名称、SOP、机器人、设备 ID 和进度仍可读。
 - `1152x648` 和 `1280x720` 下品牌色、状态色、文字对比度仍可读，不出现紫色霓虹、满屏发光卡片或营销页色彩漂移。
 - API 失败时有可见降级提示。
 - `3840x2160`、`2560x1440`、`1920x1080`、`1600x900`、`1366x768` 横屏视口下，document/body 不出现纵向滚动，dashboard 根容器高度不超过 viewport，核心区域不重叠。
diff --git a/docs/designs/synapse-production-big-screen.md b/docs/designs/synapse-production-big-screen.md
index 902990a..4b33c28 100644
--- a/docs/designs/synapse-production-big-screen.md
+++ b/docs/designs/synapse-production-big-screen.md
@@ -83,13 +83,15 @@ Synapse 生产大屏用于机器人数据生产现场的常驻展示，也用于
 
 内容：
 
-- `Synapse 生产指挥中心`
+- ArcheBase 品牌 logo、小型 `SYNAPSE` 标识和 `生产指挥中心` 标题
 - 当前日期时间，秒级更新
 - 系统状态：运行中、数据同步中、接口异常、降级展示
 - 在线设备摘要：机器人在线数 / 总数，工位在线数 / 总数
 - 今日生产摘要：今日任务、完成、失败
 - 数据刷新时间：`generated_at` 或前端最后成功刷新时间
 
+顶部品牌区应使用真实 ArcheBase logo 资产，而不是文字或临时图形替代。Logo 只作为左上角识别符号，尺寸应随视口压缩，不得挤占中间 telemetry、右侧完整日期时间或全屏按钮。
+
 顶部状态栏在紧凑电视和浏览器页面缩放后的等效视口中仍必须保留完整日期时间与全屏按钮。不能为了压缩布局改成只显示 `HH:mm`、隐藏时间、隐藏全屏按钮，或缩小到远距离不可读；应通过 grid 右侧 `auto` 列、压缩中间摘要、减少次要文案来保证可见性。
 
 ### 3.2 核心 KPI
@@ -116,12 +118,13 @@ KPI 文案应短，数字应使用 tabular numbers。数字刷新可以轻微计
 内容：
 
 - 视频/预览轮播舞台
-- 当前预览的任务名称、机器人、工位、状态、时间
-- episode/task 标识
+- 当前预览的任务名称、SOP、机器人、设备 ID 和进度
 - 加载、真实视频播放、MCAP 图像帧预览、错误、空数据 fallback
 
 舞台不应只是普通视频播放器。它需要用克制的空间动效表达“生产数据流正在进入系统”。当没有真实 `video_url` 时，舞台优先读取 `preview_url` 对应的 MCAP 图像/压缩图像 topic，按帧自动播放；只有 MCAP 不可用时才退回 poster 或轻量空状态，避免在主舞台显示大段 episode/task 文本。
 
+舞台元信息应避免无效标签堆叠。播放态下不显示泛化的“播放中”文案；MCAP 预览是否正在播放由画面、任务名称、SOP、机器人、设备 ID 和进度表达即可。真实视频可保留必要的播放类型提示，但不得压过业务元信息。
+
 ### 3.4 生产趋势
 
 职责：展示数据生产产能变化。

From 1bfc2887020d911a570b9f70edeeb1480314f238 Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Mon, 18 May 2026 18:25:11 +0800
Subject: [PATCH 13/17] feat(production): update dashboard preview metadata

---
 .../synapse-production-big-screen-tasks.md    | 12 ++++++---
 docs/designs/synapse-production-big-screen.md | 24 ++++++++---------
 internal/api/handlers/production_dashboard.go | 26 +++++++++----------
 3 files changed, 32 insertions(+), 30 deletions(-)

diff --git a/docs/designs/synapse-production-big-screen-tasks.md b/docs/designs/synapse-production-big-screen-tasks.md
index 90a5e51..8469f3a 100644
--- a/docs/designs/synapse-production-big-screen-tasks.md
+++ b/docs/designs/synapse-production-big-screen-tasks.md
@@ -61,7 +61,7 @@ SPDX-License-Identifier: MulanPSL-2.0
 - 第一版返回完整结构，即使部分数组为空。
 - `summary`、`trend`、`task_status_distribution`、`devices`、`stations`、`recent_tasks` 优先实现。
 - 第一版不返回独立 `alerts` 字段，不建设告警栏；设备不在线、工位离线、任务失败、接口降级等异常内联展示在顶部状态、设备/工位状态和任务流中。
-- `previews.video_url` 可以为空，但如果非空必须是真实可播放视频 URL；为空时返回 episode/task 元信息和可解析的 `preview_url`，保证前端可复用数据预览页播放 MCAP 图像帧。
+- `previews.video_url` 可以为空，但如果非空必须是真实可播放视频 URL；为空时返回 episode/task 元信息（SOP、场景、设备类型、设备 ID 等）和可解析的 `preview_url`，保证前端可复用数据预览页播放 MCAP 图像帧。原 `task_name` 字段改为 `scene_name`，大屏不再需要独立标题字段；原舞台上的“机器人”元信息改为 `device_type`。
 
 **验收标准:**
 
@@ -70,7 +70,7 @@ SPDX-License-Identifier: MulanPSL-2.0
 - 空数据返回 200，数值为 0，数组为空。
 - 参数错误返回 400，未认证返回 401。
 - 响应包含 `generated_at`、`scope`、`summary`、`trend`、`task_status_distribution`、`quality`、`devices`、`stations`、`recent_tasks`、`previews`。
-- `previews.video_url` 为空时仍有 `title`、`task_name`、`robot_name`、`station_name`、`status`、`created_at`；有 MCAP 时返回 `preview_url`；`video_url` 非空时必须是真实可播放视频。
+- `previews.video_url` 为空时仍有 `scene_name`、`sop_label`、`device_type`、`device_id`、`status`、`created_at`；有 MCAP 时返回 `preview_url`；`video_url` 非空时必须是真实可播放视频。
 
 **验证命令:**
 
@@ -298,6 +298,9 @@ npm run build
 - 工位状态按后台工位管理状态表达：`active` 执行中、`inactive` 待命中、`break` 休息中、`offline` 离线。
 - 设备不在线和工位离线使用灰色，不使用红色；红色只保留给任务失败、质检失败等生产异常。
 - 设备状态区不再渲染具体设备、工位、机器人、操作员或当前任务明细；改为设备状态与工位状态摘要、在线率、状态分布条和抽象状态矩阵。
+- 设备与工位面板标题不显示“需关注”聚合文案；设备“不在线”和工位“离线”已经在各自卡片内表达不可用资源。
+- 设备卡主数值不显示百分比，改为与工位状态卡一致的 `在线数 / 总数`；设备在线率只保留在 KPI 等摘要位置。
+- 设备卡和工位状态卡的状态计数只能显示一次，不能同时以卡片摘要和分布条图例两种形式重复显示同一组状态。
 - overview 不再返回 `devices.items` 或 `stations.items`；UI 使用 `devices.summary` 与 `stations.summary` 计算摘要和矩阵数量。
 - 可以为设备/工位状态加入克制 CSS 动效：执行中状态灯低幅度呼吸、状态分布条宽度过渡、6 到 8 秒一次的淡巡检扫描、刷新成功短脉冲；必须支持 `prefers-reduced-motion`。
 - 禁止大面积霓虹、持续快速闪烁、跑马灯、雷达式强动效，以及任何会改变 grid track、面板高度或造成滚动的动画。
@@ -314,7 +317,7 @@ npm run build
 - 品牌强调色只用于品牌标识、当前焦点、关键数字、Video Flight Stage 边框、趋势主系列和任务生命周期当前节点；不能大面积铺满背景、整卡发光或让非重点信息抢占视觉中心。
 - 生产状态色保持独立语义：在线/完成使用绿色，警告使用琥珀色，失败/质检异常使用红色，设备不在线和工位离线使用灰色；品牌色不能替代失败、离线或警告语义。
 - 顶部品牌区显示真实 ArcheBase logo，并与 `SYNAPSE` 小标识、`生产指挥中心` 标题组合；logo 尺寸必须响应式压缩，不得影响完整日期时间和全屏按钮。
-- Video Flight Stage 的播放元信息以任务名称、SOP、机器人、设备 ID 和进度为主；MCAP 播放态不显示泛化的“播放中”文案，避免无效状态标签占用主舞台信息层。
+- Video Flight Stage 不再显示独立标题或任务名称，播放元信息以 SOP、场景、设备类型、设备 ID 和进度为主；SOP/场景放在左侧，设备类型/设备 ID/进度放在右侧，但两侧都使用同一套“标签 + 值”小块样式、字号和信息层级；MCAP 播放态不显示泛化的“播放中”文案，避免无效状态标签占用主舞台信息层。
 - 本轮一屏化改造将 `/admin/dashboard` 作为沉浸式大屏路由处理，隐藏常规后台侧栏，页面根容器使用 `100dvh` 锁高，并让外层内容区 `overflow: hidden`；不能通过页面纵向滚动或 `overflow-y: auto` 兜底。
 - 大屏主体采用三行布局：顶部状态栏、KPI 条、主驾驶舱 grid。主驾驶舱再分为设备状态、中央 Video Flight Stage + 趋势、最近任务流三列，所有列都使用 `minmax(0, 1fr)` 和 `min-height: 0` 允许内部压缩。
 - `1366x768` 与 `1600x900` 下优先保留顶部状态、8 个 KPI、Video Flight Stage、趋势、设备状态和最近任务流；设备/任务列表可减少条目，质量指标压缩为任务流内的窄条，不再占用独立面板。
@@ -327,6 +330,7 @@ npm run build
 
 - `trend`、`devices`、`stations`、`recent_tasks` 和质量/异常状态均能正常展示。
 - 设备/工位状态区只展示设备和工位聚合状态，不出现具体设备名、工位名、机器人名、操作员或当前任务明细。
+- 设备与工位面板不出现“需关注”文案；设备卡主数值显示 `在线数 / 总数` 而不是百分比；设备在线/不在线和工位状态计数不重复展示。
 - 设备/工位状态动画在默认模式下克制可见，在 `prefers-reduced-motion` 下静态或近似静态。
 - 图表 resize 正常，组件卸载时 dispose。
 - 最近任务流按 `updated_at` 最近变化排序，不因 `failed` 或 `cancelled` 状态置顶而挤出正常生产任务。
@@ -336,7 +340,7 @@ npm run build
 - ArcheBase 品牌色在主焦点和关键数字中可见，但不会主导整屏色相；页面整体仍保持克制、工业、远距离可读。
 - 失败、警告、离线、在线等状态不会被品牌色覆盖；设备不在线和工位离线仍为灰色。
 - 顶部 ArcheBase logo、`SYNAPSE`、`生产指挥中心`、完整日期时间和全屏按钮在 `1366x768`、`1280x720`、`1152x648` 下均可见。
-- Video Flight Stage 播放 MCAP 预览时不展示“播放中”文本，且任务名称、SOP、机器人、设备 ID 和进度仍可读。
+- Video Flight Stage 播放 MCAP 预览时不展示“播放中”文本，且 SOP、场景、设备类型、设备 ID 和进度仍可读；左侧 SOP/场景与右侧设备类型/设备 ID/进度字号和样式一致。
 - `1152x648` 和 `1280x720` 下品牌色、状态色、文字对比度仍可读，不出现紫色霓虹、满屏发光卡片或营销页色彩漂移。
 - API 失败时有可见降级提示。
 - `3840x2160`、`2560x1440`、`1920x1080`、`1600x900`、`1366x768` 横屏视口下，document/body 不出现纵向滚动，dashboard 根容器高度不超过 viewport，核心区域不重叠。
diff --git a/docs/designs/synapse-production-big-screen.md b/docs/designs/synapse-production-big-screen.md
index 4b33c28..73d89cc 100644
--- a/docs/designs/synapse-production-big-screen.md
+++ b/docs/designs/synapse-production-big-screen.md
@@ -118,12 +118,12 @@ KPI 文案应短，数字应使用 tabular numbers。数字刷新可以轻微计
 内容：
 
 - 视频/预览轮播舞台
-- 当前预览的任务名称、SOP、机器人、设备 ID 和进度
+- 当前预览的 SOP、场景、设备类型、设备 ID 和进度
 - 加载、真实视频播放、MCAP 图像帧预览、错误、空数据 fallback
 
 舞台不应只是普通视频播放器。它需要用克制的空间动效表达“生产数据流正在进入系统”。当没有真实 `video_url` 时，舞台优先读取 `preview_url` 对应的 MCAP 图像/压缩图像 topic，按帧自动播放；只有 MCAP 不可用时才退回 poster 或轻量空状态，避免在主舞台显示大段 episode/task 文本。
 
-舞台元信息应避免无效标签堆叠。播放态下不显示泛化的“播放中”文案；MCAP 预览是否正在播放由画面、任务名称、SOP、机器人、设备 ID 和进度表达即可。真实视频可保留必要的播放类型提示，但不得压过业务元信息。
+舞台元信息应避免无效标签堆叠。播放态下不显示泛化的“播放中”文案；MCAP 预览是否正在播放由画面、SOP、场景、设备类型、设备 ID 和进度表达即可。SOP、场景、设备类型、设备 ID 和进度应使用统一的“标签 + 值”小块样式；SOP 与场景放在左侧并左对齐，设备类型、设备 ID 和进度放在右侧并右对齐。真实视频可保留必要的播放类型提示，但不得压过业务元信息。
 
 ### 3.4 生产趋势
 
@@ -146,12 +146,14 @@ KPI 文案应短，数字应使用 tabular numbers。数字刷新可以轻微计
 
 内容：
 
-- 设备整体只表达在线状态：在线 / 不在线，以及设备在线率。
+- 设备整体只表达在线状态：在线 / 不在线，以及在线设备数 / 设备总数。
 - 工位整体按后台工位管理状态表达：执行中 / 待命中 / 休息中 / 离线。
-- 设备在线率、工位在线率、执行中工位数量、待命/休息/离线工位数量。
+- 设备在线/不在线数量、执行中工位数量、待命/休息/离线工位数量。
 - 设备状态分布条只使用在线 / 不在线两段；工位状态分布条使用 active / inactive / break / offline 语义色。
 - 抽象状态矩阵或状态灯阵：每个格子只表达一个设备或工位状态，不显示名称、ID、机器人名、操作员或当前任务。
 
+设备与工位面板标题只承担分区命名，不显示“需关注”这类额外聚合文案。不可用资源已经由设备“不在线”和工位“离线”计数内联表达，避免把同一含义重复包装成第二个状态。设备卡和工位状态卡的主数值都使用“在线数 / 总数”风格，设备卡不在主数值位置显示百分比；设备在线率如需展示，应保留在 KPI 等更高层摘要中。每张资源卡的状态计数只出现一次，不能同时用摘要行和图例行重复显示“在线/不在线”或“执行中/待命中/休息中/离线”。
+
 状态颜色应明确但不刺眼。任务失败、质检失败等生产异常要醒目，健康状态要稳定。设备不在线与工位离线用灰色表达资源不可用，相关信息仍在设备/工位状态区内联表达，但不新增独立告警栏。
 
 overview 不再返回设备或工位明细 `items`。前端只能使用 `devices.summary` 与 `stations.summary` 构建设备状态、工位状态摘要、分布条和抽象矩阵，避免大屏泄露或挤占空间展示具体设备、工位、机器人、操作员或当前任务明细。
@@ -434,7 +436,7 @@ fallback 策略：
 | `previews` 为空 | 显示健康空状态：暂无可轮播预览，保留 KPI 和趋势 |
 | 自动播放被浏览器限制 | 对真实视频静音重试；若仍失败，优先降级到 MCAP 图像帧，再退回 poster / 轻量等待状态 |
 
-舞台播放卡片的元信息应以任务名、SOP 名、机器人、设备 ID 和必要的播放进度为主；不要在卡片上展示 episode ID、工位名、MCAP topic 名或“数据预览”字样。
+舞台播放卡片不再显示独立标题或任务名，元信息应以 SOP 名、场景名、设备类型、设备 ID 和必要的播放进度为主；左侧 SOP/场景与右侧设备类型/设备 ID/进度使用同一字号和信息层级。不要在卡片上展示 episode ID、工位名、MCAP topic 名或“数据预览”字样。
 
 ## 6. 响应式布局方案
 
@@ -687,11 +689,10 @@ GET /api/v1/production/dashboard/overview
 ```json
 {
   "id": "episode:42",
-  "title": "片段 EP-20260517-00042",
-  "task_name": "抓取-放置标准动作采集",
+  "scene_name": "厨房 / 备菜台",
   "sop_label": "pick-place@v3",
+  "device_type": "多指灵巧手",
   "device_id": "AB-F0001-T0003-000001",
-  "robot_name": "RB-07",
   "station_name": "A-03 工位",
   "status": "approved",
   "video_url": "",
@@ -854,11 +855,10 @@ page mounted
 /**
  * @typedef {Object} PreviewItem
  * @property {string} id
- * @property {string} title
- * @property {string} task_name
+ * @property {string} scene_name
  * @property {string} sop_label
+ * @property {string} device_type
  * @property {string} device_id
- * @property {string} robot_name
  * @property {string} station_name
  * @property {string} status
  * @property {string} video_url
@@ -970,7 +970,7 @@ page mounted
 
 - `go test ./internal/api/handlers/...` 通过。
 - 空数据和 data_collector scope 正常。
-- `previews.video_url` 为空时仍返回可展示的 episode/task 元信息；`video_url` 非空时必须是真实可播放视频。
+- `previews.video_url` 为空时仍返回可展示的 episode/task 元信息，包括 SOP、场景、设备类型和设备 ID；`video_url` 非空时必须是真实可播放视频。
 
 风险：
 
diff --git a/internal/api/handlers/production_dashboard.go b/internal/api/handlers/production_dashboard.go
index d6f9575..12e9e62 100644
--- a/internal/api/handlers/production_dashboard.go
+++ b/internal/api/handlers/production_dashboard.go
@@ -300,11 +300,10 @@ type dashboardRecentTaskRow struct {
 
 type dashboardPreviewItem struct {
 	ID              string  `json:"id"`
-	Title           string  `json:"title"`
-	TaskName        string  `json:"task_name"`
+	SceneName       string  `json:"scene_name"`
 	SOPLabel        string  `json:"sop_label"`
+	DeviceType      string  `json:"device_type"`
 	DeviceID        string  `json:"device_id"`
-	RobotName       string  `json:"robot_name"`
 	StationName     string  `json:"station_name"`
 	Status          string  `json:"status"`
 	VideoURL        string  `json:"video_url"`
@@ -318,11 +317,10 @@ type dashboardPreviewItem struct {
 
 type dashboardPreviewRow struct {
 	ID              string          `db:"id"`
-	Title           string          `db:"title"`
-	TaskName        string          `db:"task_name"`
+	SceneName       string          `db:"scene_name"`
 	SOPLabel        string          `db:"sop_label"`
+	DeviceType      string          `db:"device_type"`
 	DeviceID        string          `db:"device_id"`
-	RobotName       string          `db:"robot_name"`
 	StationName     string          `db:"station_name"`
 	Status          string          `db:"status"`
 	McapPath        string          `db:"mcap_path"`
@@ -1281,15 +1279,14 @@ func (h *ProductionDashboardHandler) dashboardPreviews(db dashboardDB, scope pro
 	conditions := []string{"e.deleted_at IS NULL"}
 	args := []interface{}{}
 	conditions, args = appendDashboardEpisodeScope(conditions, args, scope)
-	taskNameExpr := dashboardTaskNameSQL("t.scene_name", "t.subscene_name", "t.sop_id", "s.slug", "s.version")
+	sceneNameExpr := dashboardTaskNameSQL("t.scene_name", "t.subscene_name", "t.sop_id", "s.slug", "s.version")
 	query := `
 		SELECT
 			CAST(e.id AS CHAR) AS id,
-			CONCAT('Episode ', COALESCE(NULLIF(e.episode_id, ''), CAST(e.id AS CHAR))) AS title,
-			` + taskNameExpr + ` AS task_name,
+			` + sceneNameExpr + ` AS scene_name,
 			` + dashboardSOPLabelSQL("t.sop_id", "s.slug", "s.version") + ` AS sop_label,
-			COALESCE(ws.robot_serial, '') AS device_id,
-			COALESCE(ws.robot_name, ws.robot_serial, '') AS robot_name,
+			COALESCE(NULLIF(rt.name, ''), NULLIF(rt.model, ''), NULLIF(ws.robot_name, ''), '') AS device_type,
+			COALESCE(ws.robot_serial, r.device_id, '') AS device_id,
 			COALESCE(ws.name, CAST(ws.id AS CHAR), '') AS station_name,
 			COALESCE(NULLIF(t.status, ''), e.qa_status, '') AS status,
 			COALESCE(e.mcap_path, '') AS mcap_path,
@@ -1301,6 +1298,8 @@ func (h *ProductionDashboardHandler) dashboardPreviews(db dashboardDB, scope pro
 		LEFT JOIN tasks t ON t.id = e.task_id AND t.deleted_at IS NULL
 		LEFT JOIN sops s ON s.id = t.sop_id AND s.deleted_at IS NULL
 		LEFT JOIN workstations ws ON ws.id = e.workstation_id AND ws.deleted_at IS NULL
+		LEFT JOIN robots r ON r.id = ws.robot_id AND r.deleted_at IS NULL
+		LEFT JOIN robot_types rt ON rt.id = r.robot_type_id AND rt.deleted_at IS NULL
 		WHERE ` + strings.Join(conditions, " AND ") + `
 		ORDER BY e.created_at DESC, e.id DESC
 		LIMIT ?
@@ -1315,11 +1314,10 @@ func (h *ProductionDashboardHandler) dashboardPreviews(db dashboardDB, scope pro
 	for _, row := range rows {
 		items = append(items, dashboardPreviewItem{
 			ID:              row.ID,
-			Title:           row.Title,
-			TaskName:        row.TaskName,
+			SceneName:       row.SceneName,
 			SOPLabel:        row.SOPLabel,
+			DeviceType:      row.DeviceType,
 			DeviceID:        row.DeviceID,
-			RobotName:       row.RobotName,
 			StationName:     row.StationName,
 			Status:          row.Status,
 			VideoURL:        "",

From a5547852f2ceaf0bc70d29b0a9ada4c6f92f4ee4 Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Mon, 18 May 2026 19:37:11 +0800
Subject: [PATCH 14/17] docs(production): simplify dashboard brand header

---
 .../synapse-production-big-screen-tasks.md       |  4 ++--
 docs/designs/synapse-production-big-screen.md    | 16 +++++++++++-----
 2 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/docs/designs/synapse-production-big-screen-tasks.md b/docs/designs/synapse-production-big-screen-tasks.md
index 8469f3a..9ceaf68 100644
--- a/docs/designs/synapse-production-big-screen-tasks.md
+++ b/docs/designs/synapse-production-big-screen-tasks.md
@@ -316,7 +316,7 @@ npm run build
 - 色系统一切换为“工业暗屏基底 + ArcheBase 品牌强调色”的方向；品牌色从现有 `--brand-blue`、`--brand-cyan`、`--brand-yellow` 派生为大屏 token，例如 `--screen-brand-primary`、`--screen-brand-strong`、`--screen-brand-soft`、`--screen-brand-line`，避免在大屏中到处硬编码亮色。
 - 品牌强调色只用于品牌标识、当前焦点、关键数字、Video Flight Stage 边框、趋势主系列和任务生命周期当前节点；不能大面积铺满背景、整卡发光或让非重点信息抢占视觉中心。
 - 生产状态色保持独立语义：在线/完成使用绿色，警告使用琥珀色，失败/质检异常使用红色，设备不在线和工位离线使用灰色；品牌色不能替代失败、离线或警告语义。
-- 顶部品牌区显示真实 ArcheBase logo，并与 `SYNAPSE` 小标识、`生产指挥中心` 标题组合；logo 尺寸必须响应式压缩，不得影响完整日期时间和全屏按钮。
+- 顶部品牌区显示真实 ArcheBase 银白横向 logo，并只与 `生产指挥中心` 标题组合，不再显示 `SYNAPSE` 小标识；该银白横向 logo 只用于 `/admin/dashboard`，不替换普通后台或全局 `logo.png`；logo 尺寸必须响应式压缩，不得影响完整日期时间和全屏按钮。
 - Video Flight Stage 不再显示独立标题或任务名称，播放元信息以 SOP、场景、设备类型、设备 ID 和进度为主；SOP/场景放在左侧，设备类型/设备 ID/进度放在右侧，但两侧都使用同一套“标签 + 值”小块样式、字号和信息层级；MCAP 播放态不显示泛化的“播放中”文案，避免无效状态标签占用主舞台信息层。
 - 本轮一屏化改造将 `/admin/dashboard` 作为沉浸式大屏路由处理，隐藏常规后台侧栏，页面根容器使用 `100dvh` 锁高，并让外层内容区 `overflow: hidden`；不能通过页面纵向滚动或 `overflow-y: auto` 兜底。
 - 大屏主体采用三行布局：顶部状态栏、KPI 条、主驾驶舱 grid。主驾驶舱再分为设备状态、中央 Video Flight Stage + 趋势、最近任务流三列，所有列都使用 `minmax(0, 1fr)` 和 `min-height: 0` 允许内部压缩。
@@ -339,7 +339,7 @@ npm run build
 - 最近任务流没有装饰性竖线；可见任务条数会随 `1920x1080`、`1600x900`、`1366x768`、`1280x720`、`1152x648` 的真实可用高度自动增减，且不产生任务流内部滚动或页面滚动。
 - ArcheBase 品牌色在主焦点和关键数字中可见，但不会主导整屏色相；页面整体仍保持克制、工业、远距离可读。
 - 失败、警告、离线、在线等状态不会被品牌色覆盖；设备不在线和工位离线仍为灰色。
-- 顶部 ArcheBase logo、`SYNAPSE`、`生产指挥中心`、完整日期时间和全屏按钮在 `1366x768`、`1280x720`、`1152x648` 下均可见。
+- 顶部 ArcheBase 银白横向 logo、`生产指挥中心`、完整日期时间和全屏按钮在 `1366x768`、`1280x720`、`1152x648` 下均可见，且不再显示 `SYNAPSE` 小标识。
 - Video Flight Stage 播放 MCAP 预览时不展示“播放中”文本，且 SOP、场景、设备类型、设备 ID 和进度仍可读；左侧 SOP/场景与右侧设备类型/设备 ID/进度字号和样式一致。
 - `1152x648` 和 `1280x720` 下品牌色、状态色、文字对比度仍可读，不出现紫色霓虹、满屏发光卡片或营销页色彩漂移。
 - API 失败时有可见降级提示。
diff --git a/docs/designs/synapse-production-big-screen.md b/docs/designs/synapse-production-big-screen.md
index 73d89cc..d34a7b0 100644
--- a/docs/designs/synapse-production-big-screen.md
+++ b/docs/designs/synapse-production-big-screen.md
@@ -83,14 +83,14 @@ Synapse 生产大屏用于机器人数据生产现场的常驻展示，也用于
 
 内容：
 
-- ArcheBase 品牌 logo、小型 `SYNAPSE` 标识和 `生产指挥中心` 标题
+- ArcheBase 银白横向 logo 和 `生产指挥中心` 标题
 - 当前日期时间，秒级更新
 - 系统状态：运行中、数据同步中、接口异常、降级展示
 - 在线设备摘要：机器人在线数 / 总数，工位在线数 / 总数
 - 今日生产摘要：今日任务、完成、失败
 - 数据刷新时间：`generated_at` 或前端最后成功刷新时间
 
-顶部品牌区应使用真实 ArcheBase logo 资产，而不是文字或临时图形替代。Logo 只作为左上角识别符号，尺寸应随视口压缩，不得挤占中间 telemetry、右侧完整日期时间或全屏按钮。
+顶部品牌区应使用真实 ArcheBase logo 资产，而不是文字或临时图形替代。Logo 只作为左上角识别符号，与 `生产指挥中心` 标题构成简洁横向组合，不再额外显示 `SYNAPSE` 小标识；尺寸应随视口压缩，不得挤占中间 telemetry、右侧完整日期时间或全屏按钮。
 
 顶部状态栏在紧凑电视和浏览器页面缩放后的等效视口中仍必须保留完整日期时间与全屏按钮。不能为了压缩布局改成只显示 `HH:mm`、隐藏时间、隐藏全屏按钮，或缩小到远距离不可读；应通过 grid 右侧 `auto` 列、压缩中间摘要、减少次要文案来保证可见性。
 
@@ -239,7 +239,13 @@ overview 不再返回设备或工位明细 `items`。前端只能使用 `devices
 - 数据面板层：边栏和底部信息块，边界清晰但不厚重。
 - 状态层：异常、刷新、系统状态，用小面积高对比色。
 
-### 4.3 色彩与状态
+### 4.3 品牌标识
+
+`/admin/dashboard` 是深色沉浸式生产大屏，顶部品牌区应使用 ArcheBase 银白横向 logo，以保证暗屏上的远距离识别和克制质感。该替换只作用于生产大屏，不替换普通管理后台侧边栏、数据预览页或全局 `logo.png`。
+
+品牌区由银白横向 logo 和 `生产指挥中心` 标题组成，不再显示 `SYNAPSE` 小标识。横向 logo 应按高度约束等比缩放，标题与 logo 保持同一水平视觉组，宽度响应式压缩，不得挤占中间 telemetry、完整日期时间或全屏按钮。
+
+### 4.4 色彩与状态
 
 建议引入 ArcheBase 品牌色作为生产大屏的主强调色，但不是把页面改成品牌营销页。大屏基底仍以工业深色、冷灰和低饱和中性色为主，品牌色只用于建立识别度和当前焦点。
 
@@ -273,7 +279,7 @@ Synapse 现有全局变量中已经定义 ArcheBase 品牌色：
 
 禁止把大屏改成紫色霓虹、全卡发光或高饱和科技风。即使后续品牌资产中出现更鲜艳的颜色，也必须先转换成适合远距离观看、暗背景对比稳定的生产大屏 token。
 
-### 4.4 字体与数字
+### 4.5 字体与数字
 
 - 标题：中等字重，清晰，不使用装饰字体。
 - KPI 数字：大字号、tabular numbers、强对比。
@@ -281,7 +287,7 @@ Synapse 现有全局变量中已经定义 ArcheBase 品牌色：
 - 任务 ID、设备 ID：等宽字体，支持中间截断或换行。
 - 小屏下用 `clamp()` 限制字号范围，不用 `vw` 线性缩放所有文字。
 
-### 4.5 非视频区域动效
+### 4.6 非视频区域动效
 
 除 Video Flight Stage 外，其他区域可以使用克制、低频、生产语义明确的动效。动效必须帮助观看者理解系统状态，不能成为装饰噪音。
 

From 3204a50f7dba22f1e302b3bec7509db8b5ed5165 Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Tue, 19 May 2026 10:03:50 +0800
Subject: [PATCH 15/17] feat(production): add dashboard display token

---
 docker/.env.example                           |  4 +
 .../synapse-production-big-screen-tasks.md    | 59 ++++++++++++-
 docs/designs/synapse-production-big-screen.md | 46 +++++++++-
 internal/api/handlers/episode.go              | 28 +++++--
 internal/api/handlers/production_dashboard.go |  2 +-
 .../api/handlers/production_dashboard_test.go | 17 ++++
 internal/config/config.go                     | 22 ++---
 internal/config/config_test.go                | 20 +++--
 internal/middleware/jwt_auth.go               | 84 +++++++++++++++++++
 internal/middleware/jwt_auth_test.go          | 69 +++++++++++++++
 internal/server/server.go                     |  3 +-
 11 files changed, 326 insertions(+), 28 deletions(-)
 create mode 100644 internal/middleware/jwt_auth_test.go

diff --git a/docker/.env.example b/docker/.env.example
index 9ff6f87..7d1c145 100644
--- a/docker/.env.example
+++ b/docker/.env.example
@@ -115,6 +115,10 @@ KEYSTONE_AXON_RECORDER_RESPONSE_TIMEOUT=300
 KEYSTONE_JWT_SECRET=your-strong-secret-here
 KEYSTONE_JWT_EXPIRY_HOURS=24
 KEYSTONE_JWT_ISSUER=keystone-edge
+# Optional long-lived read-only token for /admin/dashboard TV display mode.
+# Generate with: openssl rand -hex 48
+# Leave empty to disable display-token access.
+KEYSTONE_DASHBOARD_DISPLAY_TOKEN=
 # Admin user credentials (for full API access)
 KEYSTONE_ADMIN_USERNAME=admin
 KEYSTONE_ADMIN_PASSWORD=admin123
diff --git a/docs/designs/synapse-production-big-screen-tasks.md b/docs/designs/synapse-production-big-screen-tasks.md
index 9ceaf68..7d360a4 100644
--- a/docs/designs/synapse-production-big-screen-tasks.md
+++ b/docs/designs/synapse-production-big-screen-tasks.md
@@ -65,7 +65,7 @@ SPDX-License-Identifier: MulanPSL-2.0
 
 **验收标准:**
 
-- `GET /api/v1/production/dashboard/overview` 需要 JWT，允许 `admin` 和 `data_collector`。
+- `GET /api/v1/production/dashboard/overview` 默认需要 JWT，允许 `admin` 和 `data_collector`；常驻电视模式按 T8 支持专用 display token。
 - `data_collector` 自动限定到绑定工位。
 - 空数据返回 200，数值为 0，数组为空。
 - 参数错误返回 400，未认证返回 401。
@@ -398,12 +398,69 @@ npm run build
 
 - 不同电视浏览器对 CSS filter、autoplay、fullscreen 支持不同；需要保留降级路径。
 
+### T8. 生产大屏 display token 常驻模式
+
+**仓库:** `keystone-worktree2`、`synapse-worktree2`
+
+**目标:** 让 `/admin/dashboard` 可以在电视上连续播放多天，不因普通登录 JWT 默认 24 小时过期而停止刷新，同时不把 admin token 改成长效凭证。
+
+**依赖:** T1、T3、T5。
+
+**建议修改范围:**
+
+- `keystone-worktree2/internal/config/config.go`
+- `keystone-worktree2/internal/middleware/`
+- `keystone-worktree2/internal/server/server.go`
+- `keystone-worktree2/internal/api/handlers/episode.go`
+- `synapse-worktree2/src/router/index.js`
+- `synapse-worktree2/src/api/productionDashboard.js`
+- `synapse-worktree2/src/components/production/VideoFlightStage.vue`
+- `synapse-worktree2/src/views/FullscreenDashboard.vue`
+- `synapse-worktree2/src/auth/`
+
+**实现要点:**
+
+- 后端新增可选环境变量 `KEYSTONE_DASHBOARD_DISPLAY_TOKEN`；为空时 display token 功能关闭，现有 JWT 行为不变。
+- Display token 请求头使用 `Authorization: Display <token>`；校验时使用 constant-time compare。
+- `/api/v1/production/dashboard/overview`、`snapshot`、`batches/:id/task-summary` 支持普通 JWT 或 display token。
+- `GET /api/v1/episodes/:id/presign?kind=mcap` 支持普通 JWT 或 display token，但 display token 只允许 `kind=mcap`。
+- Display token 不允许访问普通后台 CRUD、写接口、统计导出、组织/工厂/设备管理或其他 episode 详情接口。
+- Episode presign 仍返回短期 `/api/v1/storage/object?...&dl_token=...`；不生成永久 storage URL，不把 display token 透传给 MinIO。
+- 前端 `/admin/dashboard?display_token=...` 首次进入时保存 token 到本地浏览器存储，并立即清除 URL 参数。
+- `/admin/dashboard` route guard 在没有普通 admin JWT 时，可以用已保存的 display token 放行；其他 `/admin/*` 页面仍必须登录。
+- 生产大屏 API 优先使用普通 `Bearer` JWT；没有普通登录态时才使用 `Authorization: Display ...`。
+- 全局 `api/client.js` 不自动携带 display token，避免普通后台接口误用大屏展示凭证。
+- Video Flight Stage 调 episode presign 时使用同一套生产大屏鉴权头，保证普通 JWT 过期后 MCAP 预览仍可持续轮播。
+- Display token 失效或后端未配置时，大屏不白屏；已有数据保留旧数据并显示异常，首次加载失败则进入降级展示。
+
+**验收标准:**
+
+- 未设置 `KEYSTONE_DASHBOARD_DISPLAY_TOKEN` 时，现有 JWT 登录与 `/admin/dashboard` 行为保持不变。
+- 设置 display token 后，未登录浏览器访问 `/admin/dashboard?display_token=...` 可以进入生产大屏。
+- 进入后地址栏不再包含 `display_token`。
+- Display token 可以成功刷新 overview，并能获取 MCAP presign。
+- Display token 不能访问普通后台页面或普通 CRUD API。
+- 错误 display token 返回 401，页面保持稳定降级。
+
+**验证命令:**
+
+```bash
+go test ./internal/middleware ./internal/api/handlers/... -run 'Dashboard|Episode|Display' -v
+npm run build
+```
+
+**风险:**
+
+- Display token 是部署级长期密钥，必须使用足够长的随机字符串并通过环境变量配置，不得写入前端构建产物或代码仓库；推荐 `openssl rand -hex 48`，避免 URL 中的 base64 `+`、`/` 转义问题。
+- 如果电视浏览器 profile 被复制，display token 也会被复制；撤销方式是更换环境变量并重启 Keystone。
+
 ## 5. 跨任务依赖
 
 ```text
 T1 -> T3 -> T4 -> T5 -> T7
 T1 -> T2 -> T3
 T4 -> T6 -> T7
+T1 -> T8 -> T7
 ```
 
 说明：
diff --git a/docs/designs/synapse-production-big-screen.md b/docs/designs/synapse-production-big-screen.md
index d34a7b0..3d528e2 100644
--- a/docs/designs/synapse-production-big-screen.md
+++ b/docs/designs/synapse-production-big-screen.md
@@ -721,12 +721,55 @@ GET /api/v1/production/dashboard/overview
 - 未认证返回 401。
 - 无权限返回 403，由现有 middleware 控制。
 
+### 7.8 常驻电视展示 token
+
+生产大屏需要支持在电视上连续播放多天，不能因为普通登录 JWT 默认 24 小时过期而停止刷新。第一版采用简单的部署级 display token，不引入数据库、管理 UI 或 refresh token 流程。
+
+后端通过可选环境变量启用：
+
+```bash
+KEYSTONE_DASHBOARD_DISPLAY_TOKEN=<long-random-token>
+```
+
+当该变量为空时，display token 功能关闭，现有 JWT 行为保持不变。启用后，大屏相关只读接口接受：
+
+```http
+Authorization: Display <long-random-token>
+```
+
+Display token 的边界：
+
+- 只用于 `/admin/dashboard` 生产大屏常驻展示，不是普通后台登录态。
+- 只允许访问生产大屏聚合接口：`GET /api/v1/production/dashboard/overview`，以及保留兼容的 `snapshot`、`batches/:id/task-summary`。
+- 只允许为 Video Flight Stage 获取 MCAP 预览签名：`GET /api/v1/episodes/:id/presign?kind=mcap`。
+- 不允许访问普通后台 CRUD、任务修改、统计导出、组织/工厂/设备管理等接口。
+- 不直接生成永久 storage URL；episode presign 仍返回绑定对象的短期 `dl_token` storage proxy URL。
+- token 校验必须使用 constant-time compare；生产部署应使用足够长的随机字符串，例如 `openssl rand -hex 48`。如果使用 base64，需要在 URL 中正确转义 `+`、`/` 等字符。
+- 轮换或撤销 display token 时，修改环境变量并重启 Keystone 即可。
+
+前端入口：
+
+```text
+/admin/dashboard?display_token=<long-random-token>
+```
+
+页面首次读取 `display_token` 后保存到本地浏览器存储，并立即清除 URL 查询参数，避免 token 长时间暴露在地址栏、截图或浏览器历史中。普通后台路由仍只接受 admin JWT；display token 只能放行 `/admin/dashboard`。
+
+前端请求策略：
+
+- 如果存在普通 `access_token`，大屏 API 继续使用 `Authorization: Bearer <jwt>`。
+- 如果没有普通登录态但存在 display token，大屏 API 和 MCAP presign 使用 `Authorization: Display <token>`。
+- 全局后台 API client 不应自动携带 display token，避免 display token 被误用于普通后台接口。
+- Display token 失效、缺失或后端未配置时，大屏不白屏；已有成功数据则保留旧数据并显示接口异常，首次加载失败则进入降级展示并提示展示凭证不可用。
+
 ## 8. 前端数据流与组件拆分方案
 
 ### 8.1 建议页面入口
 
 建议优先改造 `src/views/FullscreenDashboard.vue` 作为管理端大屏入口，因为当前 `/admin/dashboard` 已指向该页面，且它已经包含全屏按钮、ECharts 和大屏样式。
 
+电视常驻模式通过 `/admin/dashboard?display_token=...` 进入。该入口只影响生产大屏页面，不改变 `/admin` 默认跳转、不影响普通后台侧边栏或其他管理页面的登录要求。
+
 `src/views/ProductionDashboard.vue` 可以继续作为普通运营 dashboard，或在后续统一为共享组件。
 
 ### 8.2 建议组件
@@ -1086,6 +1129,8 @@ page mounted
 
 - 聚合 API 可返回生产大屏所需数据。
 - 前端优先使用聚合 API。
+- `/admin/dashboard` 支持 display token 常驻模式；普通后台页面不接受 display token。
+- Display token 可让 overview 和 MCAP presign 在普通 JWT 过期后继续刷新，但不能访问普通后台 CRUD 或写接口。
 - 视频舞台可自动轮播。
 - 当前条进入播放后，后台开始准备下一条；网络正常时，从第二条开始切换不应出现明显黑屏、空白或长时间加载。
 - 下一条未 ready 时，舞台保留当前最后画面最多 10 秒；仍未 ready 时从头重播当前条，不做空白离场。
@@ -1127,7 +1172,6 @@ page mounted
 - 真实 `video_url` 从哪里来：直接上传视频、MCAP 转码，还是前端实时渲染后产出可播放视频流。未确认前不得伪造视频 URL。
 - `preview_url` 应来自 episode、task 还是 MinIO 对象。
 - 视频/预览 URL 是否需要鉴权，presigned URL 有效期多久。
-- 大屏是否必须登录，是否需要专用只读展示 token。
 - 大屏刷新频率是 15s、30s 还是可配置。
 - 异常展示规则：哪些任务/同步/设备状态需要在顶部状态、设备状态或任务流中突出。
 - 后续如需展示部分联通，应定义 recorder-only、transfer-only 与完全不在线的展示规则；当前设备在线只按 recorder/transfer hub 均联通计算。
diff --git a/internal/api/handlers/episode.go b/internal/api/handlers/episode.go
index b02ccce..38024b6 100644
--- a/internal/api/handlers/episode.go
+++ b/internal/api/handlers/episode.go
@@ -21,6 +21,7 @@ import (
 	"archebase.com/keystone-edge/internal/auth"
 	"archebase.com/keystone-edge/internal/config"
 	"archebase.com/keystone-edge/internal/logger"
+	"archebase.com/keystone-edge/internal/middleware"
 	"archebase.com/keystone-edge/internal/storage/s3"
 )
 
@@ -56,6 +57,24 @@ func (h *EpisodeHandler) requireBearerJWT(c *gin.Context) bool {
 	return true
 }
 
+func (h *EpisodeHandler) requireEpisodePresignAuth(c *gin.Context, kind string) bool {
+	if h.authCfg == nil {
+		return true
+	}
+	if middleware.IsDashboardDisplayRequest(c) {
+		if kind != "mcap" {
+			c.JSON(http.StatusForbidden, gin.H{"error": "display token can only presign mcap previews"})
+			return false
+		}
+		if !middleware.IsDashboardDisplayToken(c, h.authCfg) {
+			c.JSON(http.StatusUnauthorized, gin.H{"error": "invalid display token"})
+			return false
+		}
+		return true
+	}
+	return h.requireBearerJWT(c)
+}
+
 // episodeRow represents an episode row from the database.
 type episodeRow struct {
 	ID                 int64           `db:"id"`
@@ -503,12 +522,6 @@ func (h *EpisodeHandler) GetEpisodePresignedURL(c *gin.Context) {
 		c.JSON(http.StatusServiceUnavailable, gin.H{"error": "storage is not configured"})
 		return
 	}
-	if h.authCfg != nil {
-		if !h.requireBearerJWT(c) {
-			return
-		}
-	}
-
 	episodeID, ok := parseEpisodeIDParam(c)
 	if !ok {
 		return
@@ -519,6 +532,9 @@ func (h *EpisodeHandler) GetEpisodePresignedURL(c *gin.Context) {
 		c.JSON(http.StatusBadRequest, gin.H{"error": "kind must be mcap or sidecar"})
 		return
 	}
+	if !h.requireEpisodePresignAuth(c, kind) {
+		return
+	}
 
 	var row struct {
 		McapPath    string `db:"mcap_path"`
diff --git a/internal/api/handlers/production_dashboard.go b/internal/api/handlers/production_dashboard.go
index 12e9e62..f3bd5bf 100644
--- a/internal/api/handlers/production_dashboard.go
+++ b/internal/api/handlers/production_dashboard.go
@@ -785,7 +785,7 @@ func (h *ProductionDashboardHandler) resolveProductionDashboardScope(c *gin.Cont
 	}
 
 	switch claims.Role {
-	case "admin":
+	case "admin", "display":
 		return scope, nil
 	case "data_collector":
 		var workstationID string
diff --git a/internal/api/handlers/production_dashboard_test.go b/internal/api/handlers/production_dashboard_test.go
index 0a58a3d..1e0a96c 100644
--- a/internal/api/handlers/production_dashboard_test.go
+++ b/internal/api/handlers/production_dashboard_test.go
@@ -10,6 +10,7 @@ import (
 	"strings"
 	"testing"
 
+	"archebase.com/keystone-edge/internal/auth"
 	"github.com/gin-gonic/gin"
 )
 
@@ -107,6 +108,22 @@ func TestDashboardTaskScopeUsesCollectorAssignment(t *testing.T) {
 	}
 }
 
+func TestResolveProductionDashboardScopeAllowsDisplayRole(t *testing.T) {
+	gin.SetMode(gin.TestMode)
+
+	c, _ := gin.CreateTestContext(httptest.NewRecorder())
+	c.Request = httptest.NewRequest(http.MethodGet, "/dashboard/overview?factory_id=12", nil)
+	h := &ProductionDashboardHandler{}
+
+	scope, err := h.resolveProductionDashboardScope(c, &auth.Claims{Role: "display"}, productionDashboardQuery{FactoryID: "12"})
+	if err != nil {
+		t.Fatalf("resolveProductionDashboardScope returned error: %v", err)
+	}
+	if scope.Role != "display" || scope.FactoryID != "12" {
+		t.Fatalf("unexpected display scope: %+v", scope)
+	}
+}
+
 func TestDashboardActiveBatchesQueryLimitsBeforeTaskAggregation(t *testing.T) {
 	query, args := buildDashboardActiveBatchesQuery(
 		productionDashboardScope{
diff --git a/internal/config/config.go b/internal/config/config.go
index d5f6d21..137c1c7 100644
--- a/internal/config/config.go
+++ b/internal/config/config.go
@@ -131,11 +131,12 @@ type RecorderConfig struct {
 
 // AuthConfig JWT authentication configuration (collector login).
 type AuthConfig struct {
-	JWTSecret      string // #nosec G117 -- signing secret loaded from env; must exist in config struct
-	Issuer         string
-	JWTExpiryHours int
-	AdminUsername  string // #nosec G101 -- admin account name loaded from env
-	AdminPassword  string // #nosec G101 -- admin password loaded from env; never logged
+	JWTSecret             string // #nosec G117 -- signing secret loaded from env; must exist in config struct
+	Issuer                string
+	JWTExpiryHours        int
+	AdminUsername         string // #nosec G101 -- admin account name loaded from env
+	AdminPassword         string // #nosec G101 -- admin password loaded from env; never logged
+	DashboardDisplayToken string // #nosec G101 -- optional long-lived dashboard display token loaded from env
 }
 
 // Load loads configuration from environment variables and defaults
@@ -196,11 +197,12 @@ func Load() (*Config, error) {
 			MaxRestartCount:    getEnvInt("KEYSTONE_SYNC_MAX_RESTART_COUNT", 3),
 		},
 		Auth: AuthConfig{
-			JWTSecret:      getEnv("KEYSTONE_JWT_SECRET", ""),
-			Issuer:         getEnv("KEYSTONE_JWT_ISSUER", "keystone-edge"),
-			JWTExpiryHours: getEnvInt("KEYSTONE_JWT_EXPIRY_HOURS", 24),
-			AdminUsername:  getEnv("KEYSTONE_ADMIN_USERNAME", ""),
-			AdminPassword:  getEnv("KEYSTONE_ADMIN_PASSWORD", ""),
+			JWTSecret:             getEnv("KEYSTONE_JWT_SECRET", ""),
+			Issuer:                getEnv("KEYSTONE_JWT_ISSUER", "keystone-edge"),
+			JWTExpiryHours:        getEnvInt("KEYSTONE_JWT_EXPIRY_HOURS", 24),
+			AdminUsername:         getEnv("KEYSTONE_ADMIN_USERNAME", ""),
+			AdminPassword:         getEnv("KEYSTONE_ADMIN_PASSWORD", ""),
+			DashboardDisplayToken: getEnv("KEYSTONE_DASHBOARD_DISPLAY_TOKEN", ""),
 		},
 		Features: FeaturesConfig{
 			StrataEnabled:  false,
diff --git a/internal/config/config_test.go b/internal/config/config_test.go
index 54e5474..7d9532d 100644
--- a/internal/config/config_test.go
+++ b/internal/config/config_test.go
@@ -90,13 +90,14 @@ func TestLoad(t *testing.T) {
 func TestLoadWithCustomEnv(t *testing.T) {
 	// Save original environment variables
 	originalEnv := map[string]string{
-		"KEYSTONE_MODE":             os.Getenv("KEYSTONE_MODE"),
-		"KEYSTONE_BIND_ADDR":        os.Getenv("KEYSTONE_BIND_ADDR"),
-		"KEYSTONE_MYSQL_PASSWORD":   os.Getenv("KEYSTONE_MYSQL_PASSWORD"),
-		"KEYSTONE_MINIO_ACCESS_KEY": os.Getenv("KEYSTONE_MINIO_ACCESS_KEY"),
-		"KEYSTONE_MINIO_SECRET_KEY": os.Getenv("KEYSTONE_MINIO_SECRET_KEY"),
-		"KEYSTONE_QA_MAX_WORKERS":   os.Getenv("KEYSTONE_QA_MAX_WORKERS"),
-		"KEYSTONE_MAX_MEMORY_MB":    os.Getenv("KEYSTONE_MAX_MEMORY_MB"),
+		"KEYSTONE_MODE":                    os.Getenv("KEYSTONE_MODE"),
+		"KEYSTONE_BIND_ADDR":               os.Getenv("KEYSTONE_BIND_ADDR"),
+		"KEYSTONE_MYSQL_PASSWORD":          os.Getenv("KEYSTONE_MYSQL_PASSWORD"),
+		"KEYSTONE_MINIO_ACCESS_KEY":        os.Getenv("KEYSTONE_MINIO_ACCESS_KEY"),
+		"KEYSTONE_MINIO_SECRET_KEY":        os.Getenv("KEYSTONE_MINIO_SECRET_KEY"),
+		"KEYSTONE_QA_MAX_WORKERS":          os.Getenv("KEYSTONE_QA_MAX_WORKERS"),
+		"KEYSTONE_MAX_MEMORY_MB":           os.Getenv("KEYSTONE_MAX_MEMORY_MB"),
+		"KEYSTONE_DASHBOARD_DISPLAY_TOKEN": os.Getenv("KEYSTONE_DASHBOARD_DISPLAY_TOKEN"),
 	}
 	defer func() {
 		for k, v := range originalEnv {
@@ -116,6 +117,7 @@ func TestLoadWithCustomEnv(t *testing.T) {
 	os.Setenv("KEYSTONE_MINIO_SECRET_KEY", "custom-secret")
 	os.Setenv("KEYSTONE_QA_MAX_WORKERS", "8")
 	os.Setenv("KEYSTONE_MAX_MEMORY_MB", "8192")
+	os.Setenv("KEYSTONE_DASHBOARD_DISPLAY_TOKEN", "display-secret")
 
 	cfg, err := Load()
 	if err != nil {
@@ -133,6 +135,10 @@ func TestLoadWithCustomEnv(t *testing.T) {
 	if cfg.Resources.MaxMemoryMB != 8192 {
 		t.Errorf("Load().Resources.MaxMemoryMB = %v, want 8192", cfg.Resources.MaxMemoryMB)
 	}
+
+	if cfg.Auth.DashboardDisplayToken != "display-secret" {
+		t.Errorf("Load().Auth.DashboardDisplayToken = %q, want display-secret", cfg.Auth.DashboardDisplayToken)
+	}
 }
 
 func TestConfigValidate(t *testing.T) {
diff --git a/internal/middleware/jwt_auth.go b/internal/middleware/jwt_auth.go
index 04724ed..e24adff 100644
--- a/internal/middleware/jwt_auth.go
+++ b/internal/middleware/jwt_auth.go
@@ -6,6 +6,8 @@
 package middleware
 
 import (
+	"crypto/sha256"
+	"crypto/subtle"
 	"net/http"
 	"strings"
 
@@ -17,6 +19,10 @@ import (
 // ClaimsKey is the gin.Context key used to store parsed JWT claims.
 const ClaimsKey = "auth_claims"
 
+// DashboardDisplayKey is set when a request is authenticated by the production
+// dashboard display token rather than a normal user JWT.
+const DashboardDisplayKey = "dashboard_display_auth"
+
 // JWTAuth validates JWT tokens.
 // Header: Authorization: Bearer <jwt_token>
 func JWTAuth(cfg *config.AuthConfig) gin.HandlerFunc {
@@ -44,6 +50,84 @@ func JWTAuth(cfg *config.AuthConfig) gin.HandlerFunc {
 	}
 }
 
+// DashboardAuth allows a normal Bearer JWT or the optional production dashboard
+// display token. It must only be mounted on production-dashboard read routes.
+func DashboardAuth(cfg *config.AuthConfig) gin.HandlerFunc {
+	return func(c *gin.Context) {
+		if IsDashboardDisplayRequest(c) {
+			if !IsDashboardDisplayToken(c, cfg) {
+				c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "invalid display token"})
+				return
+			}
+			c.Set(ClaimsKey, &auth.Claims{Role: "display"})
+			c.Set(DashboardDisplayKey, true)
+			c.Next()
+			return
+		}
+
+		authHeader := c.GetHeader("Authorization")
+		if authHeader == "" {
+			c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "authentication required"})
+			return
+		}
+
+		parts := strings.SplitN(authHeader, " ", 2)
+		if len(parts) != 2 || !strings.EqualFold(parts[0], "Bearer") {
+			c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "invalid authorization header format"})
+			return
+		}
+
+		claims, err := auth.ParseToken(parts[1], cfg)
+		if err != nil {
+			c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "invalid or expired token"})
+			return
+		}
+
+		c.Set(ClaimsKey, claims)
+		c.Next()
+	}
+}
+
+// IsDashboardDisplayRequest reports whether the request uses the Display auth
+// scheme. It does not validate the token value.
+func IsDashboardDisplayRequest(c *gin.Context) bool {
+	scheme, _, ok := splitAuthorization(c.GetHeader("Authorization"))
+	return ok && strings.EqualFold(scheme, "Display")
+}
+
+// IsDashboardDisplayToken validates Authorization: Display <token> against the
+// optional KEYSTONE_DASHBOARD_DISPLAY_TOKEN value.
+func IsDashboardDisplayToken(c *gin.Context, cfg *config.AuthConfig) bool {
+	if cfg == nil {
+		return false
+	}
+	scheme, token, ok := splitAuthorization(c.GetHeader("Authorization"))
+	if !ok || !strings.EqualFold(scheme, "Display") {
+		return false
+	}
+	expected := strings.TrimSpace(cfg.DashboardDisplayToken)
+	token = strings.TrimSpace(token)
+	if expected == "" || token == "" {
+		return false
+	}
+	expectedHash := sha256.Sum256([]byte(expected))
+	tokenHash := sha256.Sum256([]byte(token))
+	return subtle.ConstantTimeCompare(expectedHash[:], tokenHash[:]) == 1
+}
+
+func splitAuthorization(authHeader string) (string, string, bool) {
+	parts := strings.SplitN(strings.TrimSpace(authHeader), " ", 2)
+	if len(parts) != 2 {
+		return "", "", false
+	}
+	scheme := strings.TrimSpace(parts[0])
+	token := strings.TrimSpace(parts[1])
+	if scheme == "" || token == "" {
+		return "", "", false
+	}
+	return scheme, token, true
+}
+
 // GetClaims returns JWT claims previously stored in the gin.Context by JWTAuth.
 func GetClaims(c *gin.Context) *auth.Claims {
 	if v, ok := c.Get(ClaimsKey); ok {
diff --git a/internal/middleware/jwt_auth_test.go b/internal/middleware/jwt_auth_test.go
new file mode 100644
index 0000000..5115832
--- /dev/null
+++ b/internal/middleware/jwt_auth_test.go
@@ -0,0 +1,69 @@
+// SPDX-FileCopyrightText: 2026 ArcheBase
+//
+// SPDX-License-Identifier: MulanPSL-2.0
+
+package middleware
+
+import (
+	"net/http"
+	"net/http/httptest"
+	"testing"
+
+	"archebase.com/keystone-edge/internal/config"
+	"github.com/gin-gonic/gin"
+)
+
+func TestIsDashboardDisplayToken(t *testing.T) {
+	gin.SetMode(gin.TestMode)
+	cfg := &config.AuthConfig{DashboardDisplayToken: "display-secret"}
+
+	tests := []struct {
+		name   string
+		header string
+		want   bool
+	}{
+		{name: "valid display token", header: "Display display-secret", want: true},
+		{name: "wrong token", header: "Display wrong", want: false},
+		{name: "bearer is not display", header: "Bearer display-secret", want: false},
+		{name: "empty configured token", header: "Display display-secret", want: false},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			c, _ := gin.CreateTestContext(httptest.NewRecorder())
+			c.Request = httptest.NewRequest(http.MethodGet, "/dashboard", nil)
+			c.Request.Header.Set("Authorization", tt.header)
+			testCfg := cfg
+			if tt.name == "empty configured token" {
+				testCfg = &config.AuthConfig{}
+			}
+			if got := IsDashboardDisplayToken(c, testCfg); got != tt.want {
+				t.Fatalf("IsDashboardDisplayToken() = %v, want %v", got, tt.want)
+			}
+		})
+	}
+}
+
+func TestDashboardAuthAcceptsDisplayToken(t *testing.T) {
+	gin.SetMode(gin.TestMode)
+	router := gin.New()
+	router.GET("/dashboard", DashboardAuth(&config.AuthConfig{DashboardDisplayToken: "display-secret"}), func(c *gin.Context) {
+		claims := GetClaims(c)
+		if claims == nil || claims.Role != "display" {
+			t.Fatalf("claims = %#v, want display claims", claims)
+		}
+		if v, ok := c.Get(DashboardDisplayKey); !ok || v != true {
+			t.Fatalf("dashboard display marker = %#v, want true", v)
+		}
+		c.Status(http.StatusNoContent)
+	})
+
+	req := httptest.NewRequest(http.MethodGet, "/dashboard", nil)
+	req.Header.Set("Authorization", "Display display-secret")
+	w := httptest.NewRecorder()
+	router.ServeHTTP(w, req)
+
+	if w.Code != http.StatusNoContent {
+		t.Fatalf("status = %d, want %d; body=%s", w.Code, http.StatusNoContent, w.Body.String())
+	}
+}
diff --git a/internal/server/server.go b/internal/server/server.go
index 12dfbfa..d863e93 100644
--- a/internal/server/server.go
+++ b/internal/server/server.go
@@ -299,8 +299,7 @@ func (s *Server) buildRoutes() http.Handler {
 		s.dataStats.RegisterRoutes(adminStats)
 	}
 	if s.productionDashboard != nil {
-		jwtMw := middleware.JWTAuth(&s.cfg.Auth)
-		dashboard := v1Routes.Group("/production/dashboard", jwtMw, middleware.RequireAnyRole("admin", "data_collector"))
+		dashboard := v1Routes.Group("/production/dashboard", middleware.DashboardAuth(&s.cfg.Auth), middleware.RequireAnyRole("admin", "data_collector", "display"))
 		s.productionDashboard.RegisterRoutes(dashboard)
 	}
 

From f4d59151d63b4813bca2ed37bee92cd3ec4def87 Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Tue, 19 May 2026 17:02:55 +0800
Subject: [PATCH 16/17] feat(dashboard): add production totals to overview

---
 internal/api/handlers/production_dashboard.go | 88 ++++++++++++++++---
 1 file changed, 77 insertions(+), 11 deletions(-)

diff --git a/internal/api/handlers/production_dashboard.go b/internal/api/handlers/production_dashboard.go
index f3bd5bf..c6520f5 100644
--- a/internal/api/handlers/production_dashboard.go
+++ b/internal/api/handlers/production_dashboard.go
@@ -109,7 +109,9 @@ type productionDashboardOverviewResponse struct {
 
 type dashboardOverviewSummary struct {
 	TotalTasks           int64   `json:"total_tasks"`
+	TotalEpisodes        int64   `json:"total_episodes"`
 	TodayTasks           int64   `json:"today_tasks"`
+	TodayEpisodes        int64   `json:"today_episodes"`
 	CompletedTasks       int64   `json:"completed_tasks"`
 	InProgressTasks      int64   `json:"in_progress_tasks"`
 	PendingTasks         int64   `json:"pending_tasks"`
@@ -121,6 +123,9 @@ type dashboardOverviewSummary struct {
 	RobotOnlineRate      float64 `json:"robot_online_rate"`
 	QualityPassRate      float64 `json:"quality_pass_rate"`
 	TotalDataDurationSec float64 `json:"total_data_duration_sec"`
+	TotalDataSizeBytes   int64   `json:"total_data_size_bytes"`
+	TodayDataDurationSec float64 `json:"today_data_duration_sec"`
+	TodayDataSizeBytes   int64   `json:"today_data_size_bytes"`
 }
 
 type dashboardTaskCounts struct {
@@ -191,7 +196,15 @@ type dashboardQualityRow struct {
 	Failed           sql.NullInt64   `db:"failed"`
 	Inspecting       sql.NullInt64   `db:"inspecting"`
 	PendingQA        sql.NullInt64   `db:"pending_qa"`
+	TotalEpisodes    sql.NullInt64   `db:"total_episodes"`
 	TotalDurationSec sql.NullFloat64 `db:"total_duration_sec"`
+	TotalDataSize    sql.NullInt64   `db:"total_data_size_bytes"`
+}
+
+type dashboardProductionTotals struct {
+	TotalEpisodes        int64
+	TotalDataDurationSec float64
+	TotalDataSizeBytes   int64
 }
 
 type dashboardSystemStatus struct {
@@ -412,7 +425,7 @@ func (h *ProductionDashboardHandler) GetSnapshot(c *gin.Context) {
 		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard"})
 		return
 	}
-	quality, totalDurationSec, err := h.dashboardQuality(tx, scope)
+	quality, productionTotals, err := h.dashboardQuality(tx, scope)
 	if err != nil {
 		logger.Printf("[DASHBOARD] quality query failed: %v", err)
 		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard"})
@@ -461,7 +474,7 @@ func (h *ProductionDashboardHandler) GetSnapshot(c *gin.Context) {
 		Quality: quality,
 		System: dashboardSystemStatus{
 			OperatingDays:        operatingDays,
-			TotalDataDurationSec: totalDurationSec,
+			TotalDataDurationSec: productionTotals.TotalDataDurationSec,
 			OnlineStations:       countOnlineDashboardStations(stations),
 		},
 		Stations:      stations,
@@ -534,13 +547,19 @@ func (h *ProductionDashboardHandler) GetOverview(c *gin.Context) {
 		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
 		return
 	}
+	todayProductionTotals, err := h.dashboardTodayProductionTotals(tx, scope, q)
+	if err != nil {
+		logger.Printf("[DASHBOARD] overview today production query failed: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
+		return
+	}
 	trend, err := h.dashboardDataProductionTrend(tx, scope, q)
 	if err != nil {
 		logger.Printf("[DASHBOARD] overview data production trend query failed: %v", err)
 		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
 		return
 	}
-	quality, totalDurationSec, err := h.dashboardQuality(tx, scope)
+	quality, productionTotals, err := h.dashboardQuality(tx, scope)
 	if err != nil {
 		logger.Printf("[DASHBOARD] overview quality query failed: %v", err)
 		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
@@ -590,7 +609,7 @@ func (h *ProductionDashboardHandler) GetOverview(c *gin.Context) {
 	c.JSON(http.StatusOK, productionDashboardOverviewResponse{
 		GeneratedAt:            time.Now().UTC().Format(time.RFC3339),
 		Scope:                  scope,
-		Summary:                buildOverviewSummary(tasks, todayTasks, quality, totalDurationSec, devices, stationsOverview, len(activeBatches)),
+		Summary:                buildOverviewSummary(tasks, todayTasks, todayProductionTotals, quality, productionTotals, devices, stationsOverview, len(activeBatches)),
 		Trend:                  trend,
 		TaskStatusDistribution: buildTaskStatusDistribution(tasks),
 		Quality: dashboardOverviewQuality{
@@ -885,6 +904,39 @@ func (h *ProductionDashboardHandler) dashboardTodayTaskCount(db dashboardDB, sco
 	return nullInt64(count), nil
 }
 
+func (h *ProductionDashboardHandler) dashboardTodayProductionTotals(db dashboardDB, scope productionDashboardScope, q productionDashboardQuery) (dashboardProductionTotals, error) {
+	location := fixedZoneFromOffset(q.TimezoneOffset)
+	nowLocal := time.Now().In(location)
+	startLocal := time.Date(nowLocal.Year(), nowLocal.Month(), nowLocal.Day(), 0, 0, 0, 0, location)
+	endLocal := startLocal.AddDate(0, 0, 1)
+	startUTC := startLocal.UTC()
+	endUTC := endLocal.UTC()
+
+	eventTimeExpr := "COALESCE(t.completed_at, e.created_at)"
+	conditions := []string{"e.deleted_at IS NULL", eventTimeExpr + " >= ?", eventTimeExpr + " < ?"}
+	args := []interface{}{startUTC, endUTC}
+	conditions, args = appendDashboardEpisodeScope(conditions, args, scope)
+
+	query := `
+		SELECT
+			COUNT(e.id) AS total_episodes,
+			COALESCE(SUM(COALESCE(e.duration_sec, 0)), 0) AS total_duration_sec,
+			COALESCE(SUM(COALESCE(e.file_size_bytes, 0)), 0) AS total_data_size_bytes
+		FROM episodes e
+		LEFT JOIN tasks t ON t.id = e.task_id AND t.deleted_at IS NULL
+		WHERE ` + strings.Join(conditions, " AND ")
+
+	var row dashboardQualityRow
+	if err := db.Get(&row, query, args...); err != nil {
+		return dashboardProductionTotals{}, err
+	}
+	return dashboardProductionTotals{
+		TotalEpisodes:        nullInt64(row.TotalEpisodes),
+		TotalDataDurationSec: nullFloat64(row.TotalDurationSec),
+		TotalDataSizeBytes:   nullInt64(row.TotalDataSize),
+	}, nil
+}
+
 func (h *ProductionDashboardHandler) dashboardTaskTrend(db dashboardDB, scope productionDashboardScope, q productionDashboardQuery) ([]dashboardTrendItem, error) {
 	location := fixedZoneFromOffset(q.TimezoneOffset)
 	endLocal := time.Now().In(location).AddDate(0, 0, 1)
@@ -1008,7 +1060,7 @@ func (h *ProductionDashboardHandler) dashboardTaskDistribution(db dashboardDB, s
 	return items, db.Select(&items, query, args...)
 }
 
-func (h *ProductionDashboardHandler) dashboardQuality(db dashboardDB, scope productionDashboardScope) (dashboardQuality, float64, error) {
+func (h *ProductionDashboardHandler) dashboardQuality(db dashboardDB, scope productionDashboardScope) (dashboardQuality, dashboardProductionTotals, error) {
 	conditions := []string{"e.deleted_at IS NULL"}
 	args := []interface{}{}
 	conditions, args = appendDashboardEpisodeScope(conditions, args, scope)
@@ -1019,13 +1071,15 @@ func (h *ProductionDashboardHandler) dashboardQuality(db dashboardDB, scope prod
 			COALESCE(SUM(CASE WHEN e.qa_status = 'rejected' THEN 1 ELSE 0 END), 0) AS failed,
 			COALESCE(SUM(CASE WHEN e.qa_status = 'needs_inspection' THEN 1 ELSE 0 END), 0) AS inspecting,
 			COALESCE(SUM(CASE WHEN e.qa_status = 'pending_qa' THEN 1 ELSE 0 END), 0) AS pending_qa,
-			COALESCE(SUM(COALESCE(e.duration_sec, 0)), 0) AS total_duration_sec
+			COUNT(1) AS total_episodes,
+			COALESCE(SUM(COALESCE(e.duration_sec, 0)), 0) AS total_duration_sec,
+			COALESCE(SUM(COALESCE(e.file_size_bytes, 0)), 0) AS total_data_size_bytes
 		FROM episodes e
 		WHERE ` + strings.Join(conditions, " AND ")
 
 	var row dashboardQualityRow
 	if err := db.Get(&row, query, args...); err != nil {
-		return dashboardQuality{}, 0, err
+		return dashboardQuality{}, dashboardProductionTotals{}, err
 	}
 	inspected := nullInt64(row.TotalInspected)
 	passed := nullInt64(row.Passed)
@@ -1033,14 +1087,20 @@ func (h *ProductionDashboardHandler) dashboardQuality(db dashboardDB, scope prod
 	if inspected > 0 {
 		passRate = math.Round((float64(passed)/float64(inspected))*1000) / 10
 	}
-	return dashboardQuality{
+	quality := dashboardQuality{
 		PassRate:       passRate,
 		TotalInspected: inspected,
 		Passed:         passed,
 		Failed:         nullInt64(row.Failed),
 		Inspecting:     nullInt64(row.Inspecting),
 		PendingQA:      nullInt64(row.PendingQA),
-	}, nullFloat64(row.TotalDurationSec), nil
+	}
+	productionTotals := dashboardProductionTotals{
+		TotalEpisodes:        nullInt64(row.TotalEpisodes),
+		TotalDataDurationSec: nullFloat64(row.TotalDurationSec),
+		TotalDataSizeBytes:   nullInt64(row.TotalDataSize),
+	}
+	return quality, productionTotals, nil
 }
 
 func (h *ProductionDashboardHandler) dashboardStations(db dashboardDB, scope productionDashboardScope) ([]dashboardStationItem, error) {
@@ -1343,15 +1403,18 @@ func dashboardEpisodePreviewURL(id string, mcapPath string) string {
 func buildOverviewSummary(
 	tasks dashboardTaskCounts,
 	todayTasks int64,
+	todayProductionTotals dashboardProductionTotals,
 	quality dashboardQuality,
-	totalDurationSec float64,
+	productionTotals dashboardProductionTotals,
 	devices dashboardOverviewDevices,
 	stations dashboardOverviewStations,
 	activeBatchCount int,
 ) dashboardOverviewSummary {
 	return dashboardOverviewSummary{
 		TotalTasks:           tasks.Total,
+		TotalEpisodes:        productionTotals.TotalEpisodes,
 		TodayTasks:           todayTasks,
+		TodayEpisodes:        todayProductionTotals.TotalEpisodes,
 		CompletedTasks:       tasks.Completed,
 		InProgressTasks:      tasks.InProgress,
 		PendingTasks:         tasks.Pending + tasks.Ready,
@@ -1362,7 +1425,10 @@ func buildOverviewSummary(
 		TotalStations:        stations.Summary.Total,
 		RobotOnlineRate:      devices.Summary.OnlineRate,
 		QualityPassRate:      quality.PassRate,
-		TotalDataDurationSec: totalDurationSec,
+		TotalDataDurationSec: productionTotals.TotalDataDurationSec,
+		TotalDataSizeBytes:   productionTotals.TotalDataSizeBytes,
+		TodayDataDurationSec: todayProductionTotals.TotalDataDurationSec,
+		TodayDataSizeBytes:   todayProductionTotals.TotalDataSizeBytes,
 	}
 }
 

From 938e973f4cec4ccea5e8c1d715e1836e58fbfa69 Mon Sep 17 00:00:00 2001
From: shark <mandoreshark@gmail.com>
Date: Tue, 19 May 2026 17:21:52 +0800
Subject: [PATCH 17/17] fix(dashboard): align task metric scopes

---
 internal/api/handlers/production_dashboard.go | 42 +++++++++++--------
 1 file changed, 24 insertions(+), 18 deletions(-)

diff --git a/internal/api/handlers/production_dashboard.go b/internal/api/handlers/production_dashboard.go
index c6520f5..4e9d0aa 100644
--- a/internal/api/handlers/production_dashboard.go
+++ b/internal/api/handlers/production_dashboard.go
@@ -541,9 +541,9 @@ func (h *ProductionDashboardHandler) GetOverview(c *gin.Context) {
 		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
 		return
 	}
-	todayTasks, err := h.dashboardTodayTaskCount(tx, scope, q)
+	overviewTaskMetrics, err := h.dashboardOverviewTaskMetrics(tx, scope, q)
 	if err != nil {
-		logger.Printf("[DASHBOARD] overview today task query failed: %v", err)
+		logger.Printf("[DASHBOARD] overview task metric query failed: %v", err)
 		c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to get production dashboard overview"})
 		return
 	}
@@ -609,7 +609,7 @@ func (h *ProductionDashboardHandler) GetOverview(c *gin.Context) {
 	c.JSON(http.StatusOK, productionDashboardOverviewResponse{
 		GeneratedAt:            time.Now().UTC().Format(time.RFC3339),
 		Scope:                  scope,
-		Summary:                buildOverviewSummary(tasks, todayTasks, todayProductionTotals, quality, productionTotals, devices, stationsOverview, len(activeBatches)),
+		Summary:                buildOverviewSummary(tasks, overviewTaskMetrics, todayProductionTotals, quality, productionTotals, devices, stationsOverview, len(activeBatches)),
 		Trend:                  trend,
 		TaskStatusDistribution: buildTaskStatusDistribution(tasks),
 		Quality: dashboardOverviewQuality{
@@ -883,25 +883,31 @@ func (h *ProductionDashboardHandler) dashboardTaskCounts(db dashboardDB, scope p
 	return row, db.Get(&row, query, args...)
 }
 
-func (h *ProductionDashboardHandler) dashboardTodayTaskCount(db dashboardDB, scope productionDashboardScope, q productionDashboardQuery) (int64, error) {
+func (h *ProductionDashboardHandler) dashboardOverviewTaskMetrics(db dashboardDB, scope productionDashboardScope, q productionDashboardQuery) (dashboardTaskCounts, error) {
 	location := fixedZoneFromOffset(q.TimezoneOffset)
 	nowLocal := time.Now().In(location)
 	startLocal := time.Date(nowLocal.Year(), nowLocal.Month(), nowLocal.Day(), 0, 0, 0, 0, location)
 	endLocal := startLocal.AddDate(0, 0, 1)
+	startUTC := startLocal.UTC()
+	endUTC := endLocal.UTC()
 
-	conditions := []string{"t.deleted_at IS NULL", "t.created_at >= ?", "t.created_at < ?"}
-	args := []interface{}{startLocal.UTC(), endLocal.UTC()}
+	conditions := []string{"t.deleted_at IS NULL"}
+	args := []interface{}{startUTC, endUTC, startUTC, endUTC, startUTC, endUTC}
 	conditions, args = appendDashboardTaskScope(conditions, args, scope)
 	query := `
-		SELECT COUNT(1)
+		SELECT
+			COALESCE(SUM(CASE WHEN t.assigned_at >= ? AND t.assigned_at < ? THEN 1 ELSE 0 END), 0) AS total,
+			COALESCE(SUM(CASE WHEN t.status = 'completed' AND t.completed_at >= ? AND t.completed_at < ? THEN 1 ELSE 0 END), 0) AS completed,
+			COALESCE(SUM(CASE WHEN t.status = 'in_progress' THEN 1 ELSE 0 END), 0) AS in_progress,
+			COALESCE(SUM(CASE WHEN t.status = 'pending' THEN 1 ELSE 0 END), 0) AS pending,
+			0 AS ready,
+			COALESCE(SUM(CASE WHEN t.status = 'failed' AND t.completed_at >= ? AND t.completed_at < ? THEN 1 ELSE 0 END), 0) AS failed,
+			COALESCE(SUM(CASE WHEN t.status = 'cancelled' THEN 1 ELSE 0 END), 0) AS cancelled
 		FROM tasks t
 		WHERE ` + strings.Join(conditions, " AND ")
 
-	var count sql.NullInt64
-	if err := db.Get(&count, query, args...); err != nil {
-		return 0, err
-	}
-	return nullInt64(count), nil
+	var row dashboardTaskCounts
+	return row, db.Get(&row, query, args...)
 }
 
 func (h *ProductionDashboardHandler) dashboardTodayProductionTotals(db dashboardDB, scope productionDashboardScope, q productionDashboardQuery) (dashboardProductionTotals, error) {
@@ -1402,7 +1408,7 @@ func dashboardEpisodePreviewURL(id string, mcapPath string) string {
 
 func buildOverviewSummary(
 	tasks dashboardTaskCounts,
-	todayTasks int64,
+	overviewTaskMetrics dashboardTaskCounts,
 	todayProductionTotals dashboardProductionTotals,
 	quality dashboardQuality,
 	productionTotals dashboardProductionTotals,
@@ -1413,12 +1419,12 @@ func buildOverviewSummary(
 	return dashboardOverviewSummary{
 		TotalTasks:           tasks.Total,
 		TotalEpisodes:        productionTotals.TotalEpisodes,
-		TodayTasks:           todayTasks,
+		TodayTasks:           overviewTaskMetrics.Total,
 		TodayEpisodes:        todayProductionTotals.TotalEpisodes,
-		CompletedTasks:       tasks.Completed,
-		InProgressTasks:      tasks.InProgress,
-		PendingTasks:         tasks.Pending + tasks.Ready,
-		FailedTasks:          tasks.Failed,
+		CompletedTasks:       overviewTaskMetrics.Completed,
+		InProgressTasks:      overviewTaskMetrics.InProgress,
+		PendingTasks:         overviewTaskMetrics.Pending,
+		FailedTasks:          overviewTaskMetrics.Failed,
 		CancelledTasks:       tasks.Cancelled,
 		ActiveBatches:        int64(activeBatchCount),
 		ActiveStations:       stations.Summary.Active,