chore: checkpoint before scada visual polish

work/working1/08-PLC数据与看板内容匹配分析.md

@@ -0,0 +1,274 @@
+# PLC数据与看板内容匹配分析
+
+分析对象：
+
+- 客户PLC点位文档：`07-功能确认.md`
+- 当前看板页面：`src/views/DaLuJiaTV1.vue`
+- 当前看板模块：线体任务联动状态、加工设备状态、辅助设备状态、物料库位矩阵、报警与异常事件、设备运行履历、顶部视角按钮
+
+## 1. 总体结论
+
+客户目前提供的PLC点位，能够支撑看板中大部分“实时状态类”内容，包括线体是否在线、是否允许接任务、自动模式、急停、机器人任务号、起止位置、配方号、托盘类型、零件类型、机器人握手反馈、库位有无料、设备忙碌/报警/上下料就绪等。
+
+但当前看板中有几类内容不能直接由现有PLC点位一次性满足，需要数据库、采集服务或客户补充字段：
+
+1. **产量**：现有点位没有直接的设备产量计数器。加工设备状态里的“产量”需要通过任务完成、下料完成、COMPLETE上升沿等事件计算并落库。
+2. **报警事件文本**：现有点位只有 `ALARM`、`ERROR`、`EMG` 等布尔信号，没有报警代码、报警文本、报警发生时间。报警与异常事件模块需要采集服务根据点位变化生成事件。
+3. **24小时设备运行履历**：PLC能提供当前状态，但24小时履历必须由采集服务按分钟或按状态变化记录到数据库，再由页面读取。
+4. **关机状态**：目前多数加工设备只有 `BUSY`、`ALARM`、上下料信号，没有明确的“开机/在线/心跳”信号。若要区分“关机”和“待机”，需要客户补充设备在线/开机/心跳点位，或由通讯中断推断。
+5. **程序一致性**：PLC提供实际程序号 `A_PROG_NO`，但页面若要判断“目标程序与实际程序不一致”，还需要目标程序号或配方号到程序号的映射关系。
+
+## 2. 模块匹配矩阵
+
+| 看板模块 | 当前显示内容 | 07文档可用数据 | 满足度 | 说明 |
+| --- | --- | --- | --- | --- |
+| 线体任务联动状态 | 长地轨、短地轨、关节机器人状态；当前任务；起止工位；接任务条件；当前阶段 | `PCS_RUN`、`ALLOW_TASK`、`AUTO_ACTIVE`、`EMG`、`TASK_NO`、`START_POS`、`END_POS`、`RECIPE_CODE`、`PALLET_TYPE`、`PART_KIND`、`FLAG`、`READY`、`BUSY`、`ERROR`、`COMPLETE` | 高 | 能支撑当前模块。需要补充工位编号字典、托盘类型字典、零件类型字典。长地轨任务中未看到 `PART_KIND`，若需要显示长轴/短轴，需要确认来源。 |
+| 加工设备状态 | 设备名称、产量、运行条件、状态 | F500、L2000LSY、L2100SY、新日、MAZAK、YKD5132H 的 `A_PROG_NO`、上下料完成/就绪、`BUSY`、`ALARM` | 中 | 状态和运行条件可支撑；产量没有直接点位，需要计算；程序一致性需要目标程序来源。 |
+| 辅助设备状态 | 长地轨打标机、短地轨打标机、关节打标机、清洗机、测量仪状态 | 打标机 `NORMAL`、`START`、`BUSY`、`IDLE`；清洗机 `BUSY`、`ERROR`、上下料就绪；测量仪 `BUSY`、`ERROR`、上下料就绪 | 中高 | 可支撑状态显示。长地轨打标机文档中 `NORMAL`、`BUSY` 地址为空，需要客户确认。 |
+| 物料库位矩阵 | 长地轨库区9个库位、短地轨库区9个库位、关节库区6个库位有料/无料 | `S1_YES` 至 `S9_YES`，关节 `S1_YES` 至 `S6_YES` | 高 | 可直接支撑。需要确认长地轨和短地轨是否真的共用 `DB50.DBX101.0` 至 `DB50.DBX109.0`，还是不同PLC/不同上下文。还需要库位编号到现场位置的映射。 |
+| 报警与异常事件 | 时间、设备、级别、事件内容 | 设备 `ALARM`，辅助设备 `ERROR`，机器人 `ERROR`，线体 `EMG` | 中低 | 可判断是否报警，但缺报警代码、报警文本、报警等级、开始/结束时间。建议采集服务在信号上升沿生成报警事件。 |
+| 设备运行履历 | 24小时设备状态甘特图：关机、运行、待机、报警 | `BUSY`、`ALARM`、`ERROR`、`NORMAL`、`IDLE`、`PCS_RUN` 等当前状态信号 | 中 | 当前状态可判断；24小时履历必须落库。关机状态需要明确开机/在线/心跳点位，否则只能按通讯状态或 `NORMAL=0` 推断。 |
+| 顶部视角按钮 | 长地轨视角、短地轨视角、关节视角 | 无PLC点位要求 | 不依赖PLC | 属于前端/DMT相机视角控制，不需要PLC数据。 |
+
+## 3. 当前看板字段逐项判断
+
+### 3.1 线体任务联动状态
+
+可满足：
+
+- PCS在线：`PCS_RUN`
+- 自动模式：`AUTO_ACTIVE`
+- 允许接任务：`ALLOW_TASK`
+- 急停/安全异常：`EMG`
+- 当前任务编号：`TASK_NO`
+- 任务流向：`START_POS`、`END_POS`
+- 配方号：`RECIPE_CODE`
+- 托盘类型：`PALLET_TYPE`
+- 零件类型：`PART_KIND`，短地轨和关节已有，长地轨需要确认
+- 当前阶段：可由 `FLAG`、`READY`、`BUSY`、`ERROR`、`COMPLETE` 推导
+
+建议规则：
+
+- `ERROR=1` 或 `EMG=1`：异常中断
+- `BUSY=1`：执行中
+- `READY=1` 且 `BUSY=0`：准备就绪
+- `ALLOW_TASK=1` 且 `AUTO_ACTIVE=1` 且 `PCS_RUN=1` 且 `EMG=0`：可接任务
+- `COMPLETE=1`：任务完成，可显示完成保持或等待下一任务
+
+需要补充确认：
+
+- `START_POS`、`END_POS` 对应的工位名称字典
+- `PALLET_TYPE` 对应的托盘名称字典
+- `PART_KIND` 的字典是否全线统一
+- 长地轨是否需要 `PART_KIND`，如果需要，从哪里取
+
+### 3.2 加工设备状态
+
+可满足：
+
+- F500：实际程序号、上料完成、下料完成、运行中、报警
+- L2000LSY：实际程序号、上料完成、下料完成、运行中、报警
+- L2100SY：实际程序号、上料完成、下料完成、运行中、报警
+- 新日：实际程序号、上料就绪、下料就绪、运行中、报警
+- MAZAK：上料就绪、下料就绪、运行中、报警；实际程序号标注为不需要
+- YKD5132H：实际程序号、上料就绪、下料就绪、运行中、报警
+
+不能直接满足：
+
+- 产量：未看到直接产量计数器
+- 目标程序号：未看到目标程序号点位
+- 程序一致性：只有实际程序号，不足以独立判断
+
+建议处理：
+
+- 页面保留“产量”可以，但数据来源应由采集服务计算：
+  - 方案A：设备 `UNLOAD_COMPLETE` 或 `UNLOAD_READY` 上升沿计数
+  - 方案B：机器人任务 `COMPLETE` 上升沿按目标设备归属计数
+  - 方案C：客户补充每台设备的产量计数器，页面直接读取
+- 程序一致性建议由 `RECIPE_CODE` 或生产任务中的目标程序号，与设备 `A_PROG_NO` 比对。
+- 若客户暂时不能提供产量，建议把“产量”暂时改为“程序号”，或在接口层返回计算产量。
+
+### 3.3 辅助设备状态
+
+可满足：
+
+- 短地轨打标机：`NORMAL`、`START`、`BUSY`、`IDLE`
+- 关节打标机：`NORMAL`、`START`、`BUSY`、`IDLE`
+- 清洗机：`BUSY`、`ERROR`、`UPLOAD_READY`、`UNLOAD_READY`
+- 测量仪：`BUSY`、`ERROR`、`UPLOAD_READY`、`UNLOAD_READY`
+
+部分缺口：
+
+- 长地轨打标机 `NORMAL`、`BUSY` 地址为空，需要客户补齐或确认是否不采集。
+- 打标机 `START` 可能是短脉冲，不能直接作为状态长期显示，需要采集服务捕获边沿或只用于事件记录。
+
+建议状态规则：
+
+- 打标机：`BUSY=1` 显示运行中；`IDLE=1` 显示待机；`NORMAL=0` 显示关机或离线；如后续有错误点位，优先显示报警。
+- 清洗机/测量仪：`ERROR=1` 显示报警；`BUSY=1` 显示运行中；`UPLOAD_READY` 或 `UNLOAD_READY` 显示等待上下料；否则显示待机。
+
+### 3.4 物料库位矩阵
+
+可满足：
+
+- 长地轨库区：9个库位 `S1_YES` 至 `S9_YES`
+- 短地轨库区：9个库位 `S1_YES` 至 `S9_YES`
+- 关节库区：6个库位 `S1_YES` 至 `S6_YES`
+
+需要确认：
+
+- 长地轨和短地轨库区在文档中使用相同地址 `DB50.DBX101.0` 至 `DB50.DBX109.0`。需要确认是否为同一个PLC地址空间下的重复，还是Excel转换时上下文丢失。
+- 每个 `S1` 至 `S9` 对应现场哪个实际库位、工位、料框位置。
+
+建议：
+
+- 页面可以继续显示库位矩阵。
+- 可以增加库位统计：占用数、空位数、占用率。
+- 若客户能提供物料类型或托盘号，可进一步显示“有料但类型未知/长轴/短轴”等状态。
+
+### 3.5 报警与异常事件
+
+现有点位可作为报警源：
+
+- 线体：`EMG`
+- 机器人：`ERROR`
+- 加工设备：`ALARM`
+- 清洗机/测量仪：`ERROR`
+- 打标机：目前未看到明确错误点位
+
+当前缺口：
+
+- 没有报警代码
+- 没有报警文本
+- 没有报警等级
+- 没有报警开始时间、恢复时间
+
+建议实现：
+
+- 采集服务保存报警事件表，而不是页面直接读当前布尔值。
+- 每个报警布尔点从 `0 -> 1` 时生成一条事件，记录：时间、设备、点位、事件名称、等级、是否恢复。
+- 从 `1 -> 0` 时记录恢复时间。
+
+建议报警等级：
+
+- 严重：急停 `EMG`、机器人 `ERROR`、设备 `ALARM`、清洗机/测量仪 `ERROR`
+- 警告：程序不一致、上下料等待超时、允许接任务条件不满足
+- 提示：任务完成、等待上游/下游放行
+
+### 3.6 设备运行履历
+
+可用当前PLC信号生成实时状态：
+
+- 报警：`ALARM=1` 或 `ERROR=1`
+- 运行：`BUSY=1`
+- 待机：`IDLE=1`、`READY=1`、或无报警且无运行
+- 关机：需要 `NORMAL=0`、`PCS_RUN=0`、通讯断开、或客户补充开机/在线信号
+
+当前缺口：
+
+- 现有PLC只提供当前状态，不提供历史。
+- 页面要显示24小时履历，必须由后端或采集服务按分钟存储状态。
+
+建议数据库表：
+
+| 字段 | 说明 |
+| --- | --- |
+| device_code | 设备编码 |
+| device_name | 设备名称 |
+| state | off/run/standby/alarm |
+| start_time | 状态开始时间 |
+| end_time | 状态结束时间 |
+| source_tags | 参与判断的PLC点位 |
+
+建议状态优先级：
+
+`报警 > 运行 > 待机 > 关机/离线`
+
+## 4. 建议新增或优化的看板内容
+
+基于客户目前PLC点位，建议优先考虑以下内容：
+
+1. **线体接任务条件指示**
+   - 展示 `PCS_RUN`、`ALLOW_TASK`、`AUTO_ACTIVE`、`EMG` 四个条件。
+   - 适合放在线体任务联动状态中，能快速判断为什么不能发任务。
+
+2. **机器人握手信号诊断**
+   - 展示 `FLAG`、`READY`、`BUSY`、`ERROR`、`COMPLETE`。
+   - 当前页面已经精简过，如果现场调试需要，可以做成点击详情或悬浮面板，不一定常驻主屏。
+
+3. **程序号核对**
+   - 设备侧 `A_PROG_NO` 已有。
+   - 如果能拿到目标程序号，可新增“程序一致/不一致”提示。
+   - 如果拿不到目标程序号，页面不建议直接写“程序不一致”，避免误导。
+
+4. **库位占用统计**
+   - 当前库位矩阵已具备点位基础。
+   - 可增加每个库区的占用数、空位数、占用率。
+
+5. **报警事件列表**
+   - 当前布尔点足够做基础报警事件。
+   - 需要采集服务生成事件文本，例如：“MAZAK 报警信号触发”“关节机器人 ERROR=1”“长地轨急停激活”。
+
+6. **设备运行履历**
+   - 当前页面已有模块。
+   - 必须配套状态落库，否则只能显示当前状态，不能显示24小时历史。
+
+7. **生产/产量统计**
+   - 现有PLC文档不直接提供产量。
+   - 建议客户补充产量计数器，或确认用哪个完成信号作为计数依据。
+   - 没有确认前，看板上“产量”应标注为接口计算值，而不是PLC直采值。
+
+## 5. 需要客户补充确认的问题清单
+
+1. 是否有每台加工设备的**产量计数器**？如果没有，是否允许用 `UNLOAD_COMPLETE`、`UNLOAD_READY` 或机器人 `COMPLETE` 上升沿计算产量？
+2. 是否有每台设备的**开机/在线/心跳**信号？用于区分“关机”和“待机”。
+3. 是否有**报警代码、报警文本、报警等级**？如果没有，是否接受由点位名称生成简化报警事件？
+4. 是否有**目标程序号**或 `RECIPE_CODE -> A_PROG_NO` 的映射表？用于判断程序一致性。
+5. 长地轨打标机的 `NORMAL`、`BUSY` 地址为空，是否需要补充？
+6. 长地轨任务是否有 `PART_KIND`？如果没有，长轴/短轴从哪里判断？
+7. 长地轨和短地轨物料库位是否共用 `DB50.DBX101.0` 至 `DB50.DBX109.0`？如果不是，需要提供真实地址。
+8. `START_POS`、`END_POS` 的工位编号字典是什么？
+9. `PALLET_TYPE` 的托盘类型字典是什么？
+10. PLC点位虽然标注 `RW`，看板是否只读？建议看板侧默认只读，不向PLC写入。
+11. 数据采集周期要求是多少？状态看板建议1秒级刷新，运行履历可按状态变化或1分钟粒度落库。
+
+## 6. 对当前看板的落地建议
+
+### 建议保留
+
+- 线体任务联动状态
+- 加工设备状态
+- 辅助设备状态
+- 物料库位矩阵
+- 报警与异常事件
+- 设备运行履历
+- 顶部视角按钮
+
+### 建议调整数据口径
+
+- 加工设备状态中的“产量”应明确为“接口计算产量”，当前PLC文档不能直接支撑。
+- 报警与异常事件应由采集服务生成事件，不应只读当前报警位。
+- 设备运行履历应由数据库提供24小时历史，不应只依赖页面前端模拟。
+
+### 建议新增后端/数据库能力
+
+1. PLC当前快照表：保存每个点位当前值。
+2. 状态变化事件表：保存报警、任务阶段、设备运行状态变化。
+3. 设备分钟状态表或状态区间表：支撑24小时运行履历。
+4. 产量统计表：按设备、班次、日期统计产量。
+5. 字典表：工位、托盘类型、零件类型、设备编码、点位含义、报警等级。
+
+## 7. 数据满足度结论
+
+当前PLC点位对看板的支撑度可以概括为：
+
+- **实时状态显示：基本满足**
+- **任务联动显示：基本满足**
+- **库位矩阵显示：满足**
+- **设备运行/报警当前状态：基本满足**
+- **产量显示：不直接满足，需要计算或补点**
+- **报警事件列表：部分满足，需要事件化**
+- **24小时运行履历：部分满足，需要历史落库**
+- **程序一致性：部分满足，需要目标程序或映射表**
+
+因此，当前数据可以支撑看板进入联调，但在正式交付前，需要重点确认“产量、报警事件、运行履历、关机状态、程序一致性”这五类数据口径。