docs: update feature doc - replace task log with device history, add alarm chart, match current UI

work/working1/09-看板功能说明.md

@@ -4,24 +4,24 @@
 
 ---
 
-本看板将生产线上的设备运行信号、机器人搬运任务、物料库位状态、报警事件和三维产线模型整合到一块大屏上，帮助车间管理人员和生产调度人员实时掌握整条产线的运行情况。
+本看板将生产线上的设备运行信号、机器人搬运任务、物料库位状态、报警事件和三维产线模型整合到一块大屏上，帮助车间管理和生产调度人员实时掌握整条产线的运行情况。
 
 ---
 
 ## 1. 页面整体布局
 
-看板采用 1920×1080 分辨率大屏设计，从上到下、从左到右分为以下区域：
+看板采用 1920×1080 分辨率大屏设计，上下共三行、中间分三列，各区域分工如下：
 
 | 区域 | 位置 | 展示内容 |
 |---|---|---|
-| 标题栏 | 页面顶部 | 系统名称、模式切换按钮、当前时间、视角切换按钮 |
-| 线体联动监控 | 左侧 | 长地轨、短地轨、关节机器人三大单元的运行状态、当前任务和任务进度 |
-| 三维产线模型 | 中央（全屏背景） | 产线三维数字模型，可随视角按钮切换观察角度 |
-| 加工设备状态 | 右侧上方 | 六台主要加工设备的实时状态、程序号和上下料信号 |
-| 辅助设备状态 | 右侧下方 | 打标机、清洗机、测量仪等辅助设备的运行状态 |
-| 物料库位矩阵 | 底部左侧 | 三个库区的物料存放情况，一目了然看到哪些库位有料 |
-| 报警与异常事件 | 底部中间 | 当前发生的报警和异常事件列表 |
-| 任务日志 | 底部右侧 | 机器人搬运任务的关键节点记录 |
+| 标题栏 | 页面顶部 | 系统名称、模式切换按钮、当前日期时间、视角切换按钮 |
+| 线体任务联动状态 | 左侧 | 长地轨、短地轨、关节机器人三大单元的线体信号、任务信息和握手状态 |
+| 三维产线模型 | 中央（全屏背景） | 产线三维数字模型，随视角按钮切换观察角度 |
+| 加工设备状态 | 右侧上方 | 六台主要加工设备的产量、联动信号和运行状态 |
+| 辅助设备状态 | 右侧下方 | 打标机、清洗机、桁架、测量仪等辅助设备的运行状态 |
+| 物料库位矩阵 | 底部左侧 | 三个库区的物料存放情况，一眼看出哪些库位有料、哪些空着 |
+| 报警与异常事件 | 底部中间 | 报警频次统计图 + 实时报警事件列表 |
+| 设备运行履历 | 底部右侧 | 15 台设备的 24 小时运行状态时间轴 |
 
 ---
 
@@ -33,71 +33,72 @@
 
 | 按钮 | 用途 |
 |---|---|
-| **孪生模式** | 点击后，三维区域展示真实产线的数字孪生画面，设备状态由产线 PLC 实时数据驱动，看到的即是现场正在发生的情况。 |
-| **仿真模式** | 点击后，三维区域切换到仿真运行画面，可用于离线演示、方案推演或培训，不依赖真实产线数据。 |
+| **孪生模式** | 点击后，三维区域展示真实产线的数字孪生画面，设备状态由产线 PLC 实时数据驱动，即车间现场正在发生的实时情况。 |
+| **仿真模式** | 点击后，三维区域切换到离线仿真画面，可用于方案推演、操作培训或对外演示，不依赖现场设备运行。 |
 
-> 两个模式互斥，同一时间只有一个处于激活状态。当前激活的按钮会有高亮边框和光效，便于识别。
+> 两个模式互斥，同一时间只有一个处于激活状态。当前激活的按钮有高亮光效，一眼就能识别。
 
 ### 2.2 长地轨视角 / 短地轨视角 / 关节视角
 
-页面右上角有三个视角切换按钮，分别对应产线上的三大作业单元：
+页面右上角有三个视角切换按钮，分别对应产线三大作业单元：
 
-| 按钮 | 切换到的观察区域 | 可以看到的设备 |
+| 按钮 | 三维画面切换到的区域 | 该区域包含的设备 |
 |---|---|---|
 | **长地轨视角** | 长地轨线体区域 | 长地轨机器人、长地轨库区、F500、L2000LSY、L2100SY |
 | **短地轨视角** | 短地轨线体区域 | 短地轨机器人、短地轨库区、新日、MAZAK |
 | **关节视角** | 关节机器人区域 | 关节机器人、关节库区、YKD5132H、清洗机、测量仪 |
 
-> 点击按钮后，中央三维画面会自动切换到对应区域的最佳观察角度，方便快速定位到想看的线体。当前选中的视角按钮会有高亮显示。
+> 点击按钮后，中央三维画面自动切换到对应区域的最佳观察角度。当前选中的按钮高亮显示，便于确认正在看哪个单元。
 
 ### 2.3 实时时钟
 
-页面标题栏右侧显示当前日期和时间，每秒自动更新，方便现场人员确认数据时效。
+标题栏右侧显示当前日期和时间，每秒自动刷新，方便核对数据时效。
 
 ---
 
-## 3. 线体联动监控（左侧）
+## 3. 线体任务联动状态（左侧）
 
-此模块集中展示长地轨、短地轨和关节机器人三大核心单元的实时运行情况。每个单元以一张卡片呈现，包含以下信息：
+本模块集中展示长地轨、短地轨、关节机器人三大核心单元的实时运行情况。每个单元以一张独立卡片呈现，包含四部分信息：
 
-**单元综合状态**
+**① 单元综合状态**
 
-顶部显示单元名称（如"长地轨"）和当前综合状态，例如：
-- **可派发任务**（绿色）：单元在线、自动模式、允许接收任务，且无急停
-- **执行中**（蓝色）：机器人正在执行搬运任务
-- **准备就绪**（绿色）：机器人已就绪，等待任务下发
-- **异常中断**（红色）：发生错误或急停
+卡片顶部显示单元名称（如"长地轨"）和当前综合状态。状态根据多项信号综合判定，例如：
+- **可派发任务**：单元在线、自动模式、允许接任务，一切正常可派发
+- **执行中**：机器人正在执行搬运任务
+- **准备就绪**：机器人已就绪，等待任务下发
+- **异常中断**：发生错误或急停，需要人工介入
 
-**当前任务信息**
+**② 当前任务信息**
 
-展示机器人正在执行的任务详情：
-- **任务流向**：显示搬运的起点位置和终点位置，如 `01 → 06`
-- **配方号**：当前任务使用的加工配方
-- **托盘类型**：当前使用的托盘
-- **零件类型**：长轴或短轴
+展示机器人正在执行的搬运任务详情：
+- 任务编号
+- 起止位置（如 `01 → 06`），即从哪里搬到哪里
+- 配方号、托盘类型、零件类型（长轴/短轴）
 
-**线体运行信号**
+**③ 线体状态信号**
 
-四个核心状态指示灯：
-- PCS 运行（绿色 = 在线）
-- 允许接收任务（绿色 = 可接任务）
-- 自动模式（绿色 = 自动 / 黄色 = 待恢复）
-- 急停状态（灰色 = 正常 / 红色 = 急停激活）
+四个核心指示灯，判断单元是否具备接任务条件：
+- PCS 运行（亮 = 在线，灭 = 离线）
+- 允许接收任务（亮 = 可以接任务）
+- 自动模式（亮 = 自动运行中）
+- 急停状态（亮红 = 急停已激活，正常时为灰色）
 
-**任务进度流程条**
+> 四个条件全部满足（PCS 在线 + 允许接任务 + 自动模式 + 无急停）时，单元可正常派发任务。任意一项不满足都能快速定位原因。
 
-展示机器人任务的四个阶段：`FLAG（任务下发）→ READY（就绪）→ BUSY（执行中）→ COMPLETE（完成）`。当前所处的阶段节点会高亮发光，错误阶段显示为红色。一眼就能判断任务走到哪一步、卡在哪一步。
+**④ 任务握手信号**
+
+展示机器人与 PLC 之间的任务握手流程：FLAG（任务下发）→ READY（就绪）→ BUSY（执行中）→ ERROR（异常）→ COMPLETE（完成）。每个信号以指示灯形式呈现，当前生效的信号高亮，异常信号红色闪烁，一眼就能判断任务走到了哪个阶段、卡在哪一步。
 
 ---
 
-## 4. 三维产线模型（中央背景）
+## 4. 三维产线模型（中央）
 
-页面中央区域以全屏方式嵌入整条产线的三维数字模型，是看板的视觉核心。三维模型中可以直观看到设备与机器人的空间位置和动作状态。
+页面中央区域嵌入整条产线的三维数字模型，是看板的视觉核心。三维模型中可直观看到设备与机器人的空间布局和运行状态。
 
-三维模型会响应以下操作：
-- 点击顶部**视角按钮**，自动切换到长地轨、短地轨或关节区域
-- 点击顶**模式按钮**，在孪生（真实数据驱动）和仿真（离线演示）之间切换
-- 后续可扩展：当某台设备报警时，模型中对应设备高亮红色
+三维模型支持以下操作：
+- 点击顶部**视角按钮**，画面自动聚焦到长地轨、短地轨或关节区域
+- 点击**模式按钮**，在孪生（真实数据驱动）和仿真（离线演示）之间切换
+- 后续可扩展：设备报警时，模型中对应设备高亮红色，点击可直接定位
 
 ---
 
@@ -107,20 +108,22 @@
 
 | 设备 | 所属单元 | 监控内容 |
 |---|---|---|
-| F500 | 长地轨 | 当前程序号、上料/下料是否完成、运行/待机/报警状态 |
-| L2000LSY | 长地轨 | 当前程序号、上料/下料是否完成、运行/待机/报警状态 |
-| L2100SY | 长地轨 | 当前程序号、上料/下料是否完成、运行/待机/报警状态 |
-| 新日 | 短地轨 | 当前程序号、上料/下料是否就绪、运行/待机/报警状态 |
-| MAZAK | 短地轨 | 上料/下料是否就绪、运行/待机/报警状态 |
-| YKD5132H | 关节 | 当前程序号、上料/下料是否就绪、运行/待机/报警状态 |
+| F500 | 长地轨 | 产量、上料/下料完成信号、运行/报警状态 |
+| L2000LSY | 长地轨 | 产量、上料/下料完成信号、运行/报警状态 |
+| L2100SY | 长地轨 | 产量、上料/下料完成信号、运行/报警状态 |
+| 新日 | 短地轨 | 产量、上料/下料就绪信号、运行/报警状态 |
+| MAZAK | 短地轨 | 产量、上料/下料就绪信号、运行/报警状态 |
+| YKD5132H | 关节 | 产量、上料/下料就绪信号、运行/报警状态 |
 
-每台设备以一行展示，包含：
-- **设备名称**
-- **目标程序号 / 实际程序号**：当两者不一致时会黄色预警
-- **上下料状态标签**：上料完成/下料完成/上料就绪/下料就绪
-- **运行状态标签**：运行中（蓝色）/ 正常（绿色）/ 预警（黄色）/ 报警（红色）
+每台设备以一行展示，从左到右依次为：设备名称 → 当前产量 → 联动信号标签 → 运行状态标签。
 
-> 报警设备整行红色高亮，方便快速定位异常。
+状态颜色含义：
+- 绿色 = 正常、就绪、完成
+- 蓝色 = 运行中
+- 黄色 = 预警（需关注）
+- 红色 = 报警（需立即处理）
+
+> 报警设备整行红色高亮。设备列表支持自动滚动，鼠标悬浮时暂停，方便逐行查看。
 
 ---
 
@@ -130,11 +133,13 @@
 
 | 设备 | 监控内容 |
 |---|---|
-| 打标机 | 是否开机、是否正在打标、是否待机等待任务 |
-| 清洗机 | 是否运行中、是否有错误、上料/下料是否就绪 |
-| 测量仪 | 是否运行中、是否有错误、上料/下料是否就绪 |
+| 打标机 | 开机信号、打标进行中、待机等待任务 |
+| 清洗机 | 运行中、上料就绪、下料就绪、是否有错误 |
+| 桁架 | 开机信号、运行/待机状态 |
+| 测量仪 | 运行中、上料就绪、下料就绪、是否有错误 |
+| 复测工位 | 复测等待、是否有错误 |
 
-每台设备显示综合状态标签和具体信号指示灯。
+每台设备一行，显示设备名称、联动信号标签和综合状态标签。状态判定规则：报警优先于运行、运行优先于待机，确保最严重的状态不被掩盖。
 
 ---
 
@@ -142,79 +147,77 @@
 
 展示三个库区的物料存放情况：
 
-| 库区 | 库位数 | 说明 |
+| 库区 | 库位数 | 对应线体 |
 |---|---|---|
-| A 库区（长地轨） | 9 个库位 | 长地轨线体的物料缓存区 |
-| B 库区（短地轨） | 9 个库位 | 短地轨线体的物料缓存区 |
-| C 库区（关节） | 6 个库位 | 关节机器人的物料缓存区 |
+| A 库区 | 9 个（S1–S9） | 长地轨线体的物料缓存区 |
+| B 库区 | 9 个（S1–S9） | 短地轨线体的物料缓存区 |
+| C 库区 | 6 个（S1–S6） | 关节机器人的物料缓存区 |
 
 每个库位以方格显示：
 - **绿色高亮** = 有料
 - **灰色暗框** = 空位
 
-每个库区顶部显示有料数量占比，如 "6 / 9"，方便快速了解各库区剩余容量。
+每个库区顶部标注有料数量和总数（如"6 / 9"），管理人员扫一眼就能判断各库区剩余容量，合理安排物料配送。
 
 ---
 
 ## 8. 报警与异常事件（底部中间）
 
-实时展示当前发生的报警和异常事件，包括：
+本模块从两个维度展示报警信息：
 
-- **时间**：事件发生时间
-- **设备**：报警来源设备名称
-- **级别**：严重（红色）/ 警告（黄色）
-- **事件内容**：简要描述
+**① 报警频次统计图**
 
-报警触发条件包括：
-- 设备报警信号触发
+顶部柱状图按报警次数从高到低排列，展示当前报警最多的设备和机器人，帮助管理人员识别高频故障点。图表自动适配数据范围，柱形越高表示该设备报警越频繁。
+
+**② 实时报警事件列表**
+
+列表展示每条报警的关键信息：
+- **时间**：报警发生时间
+- **设备**：报警来源
+- **事件内容**：简要描述发生了什么
+
+报警来源覆盖整条产线：
+- 加工设备报警
 - 机器人执行错误
-- 急停按钮激活
-- 程序号不一致
-- 测量/清洗流程异常
+- 急停激活
+- 清洗机/测量仪异常
 
-> 事件列表自动滚动刷新。鼠标移到列表上时会暂停滚动，方便仔细阅读。
+> 事件列表自动滚动刷新。鼠标悬浮时暂停滚动。报警恢复后，对应记录从列表中清除。
 
 ---
 
-## 9. 任务日志（底部右侧）
+## 9. 设备运行履历（底部右侧）
 
-记录机器人搬运任务的关键节点，形成完整的任务履历：
+以 24 小时时间轴的形式，展示 15 台设备过去一天内的运行状态变化，直观反映每台设备的工作节奏和异常时段。
 
-- 任务创建时间
-- 哪个单元
-- 从哪个位置搬运到哪个位置
-- 当前到了哪个阶段（已下发 / 已就绪 / 执行中 / 已完成 / 异常）
+**显示设备范围**：长地轨机器人、短地轨机器人、关节机器人、F500、L2000LSY、L2100SY、新日、MAZAK、YKD5132H、打标机（3 台）、清洗机、测量仪。
 
-示例日志：
-```
-10:31  长地轨从 01 工位向 06 工位搬运，机器人保持 BUSY
-10:29  短地轨任务已下发，READY=1，等待进入 BUSY
-10:24  关节机器人在测量仪工位异常中断，ERROR=1
-```
+**四种运行状态**，以不同颜色区分：
+
+| 状态 | 颜色 | 含义 |
+|---|---|---|
+| 关机 | 灰色 | 设备未开机或离线 |
+| 待机 | 黄色 | 设备在线但未执行加工任务 |
+| 运行 | 绿色 | 设备正在执行加工或搬运任务 |
+| 报警 | 红色 | 设备发生报警，需要人工处理 |
+
+**时间轴**：横轴为 24 小时刻度（00:00 → 04:00 → 08:00 → 12:00 → 16:00 → 20:00 → 24:00），每台设备对应一行状态条，不同颜色段表示该时段所处的运行状态。
+
+> 通过时间轴，可以快速发现设备是否长期待机（黄色占比过高）、是否频繁报警（红色段集中）、关机时段是否合理等问题。设备列表支持自动滚动，鼠标悬浮暂停。
 
 ---
 
 ## 10. 数据来源说明
 
-看板上展示的实时数据来源于产线 PLC 控制系统，通过数据采集服务实时获取以下信号：
+看板上展示的实时数据来源于产线 PLC 控制系统，通过数据采集服务实时获取：
 
-| 数据类型 | 信号示例 | 刷新频率 |
+| 数据类型 | 包含信号 | 刷新频率 |
 |---|---|---|
 | 线体运行状态 | PCS 在线、自动模式、允许接任务、急停 | 约 1 秒 |
-| 机器人任务 | 任务号、起点、终点、配方、托盘类型 | 约 1 秒 |
-| 设备状态 | 运行中、报警、上下料就绪/完成 | 约 1-2 秒 |
-| 物料库位 | 各库位有料/无料 | 约 1-3 秒 |
+| 机器人任务 | 任务号、起止位置、配方、托盘类型、零件类型 | 约 1 秒 |
+| 机器人握手 | FLAG、READY、BUSY、ERROR、COMPLETE | 约 1 秒 |
+| 设备状态 | 运行中、报警、上下料就绪/完成 | 约 1–2 秒 |
+| 物料库位 | 各库位有料/无料 | 约 1–3 秒 |
 | 报警事件 | 设备报警、错误、急停 | 实时推送 |
 
-> 产量数据、24 小时设备运行履历等统计类数据，由后端系统根据 PLC 信号变化进行累计计算后提供。
-
----
-
-## 11. 版本信息
-
-| 项目 | 内容 |
-|---|---|
-| 看板页面 | `DaLuJiaTV1.vue` |
-| 适用分辨率 | 1920×1080（自适应缩放） |
-| 三维模型 | 通过页面配置地址加载 |
-| 数据来源 | 产线 PLC → 采集服务 → 看板 |
+> 产量数据、24 小时设备运行履历等统计类数据，由后端采集系统根据 PLC 信号变化进行累计计算和落库后提供。