docs: 更新元利MES分析与今日工作汇报

MES_Manage_View_V20/新增需求分析与开发记录_2026-05-23.md

@@ -1158,7 +1158,307 @@ AI 关键记录：
 - 前端提示优化。
 - 不涉及复杂业务逻辑。
 
-## 31. 追加需求处理状态汇总
+## 31. 设备数据采集与大屏指标需求
+
+本次补充需求不是单个页面小改，而是“设备档案 + 设备采集 + 产能/OEE 指标 + 工时异常 + 条码拣配 + 现场大屏”的一组联动需求。它会影响设备管理、工艺标准工时、生产报工、质检、拣配、机加/装配现场看板和综合大屏。
+
+### 31.1 设备档案管理
+
+页面：设备档案/设备管理相关页面  
+关联页面线索：`DeviceManagement/DeviceInformation`、`SystemMaintenance/WorkstationManagement`、设备工位绑定相关页面
+
+需求：
+- 维护设备档案。
+- 设备档案中需要标记“主要设备”。
+- 设备档案或设备工艺能力中需要维护标准工时相关字段。
+- 后续设备采集、设备利用率、OEE、设备异常报表都以设备档案为基础。
+
+建议字段：
+- 设备编号/设备名称
+- 工位编号/工位名称
+- 设备类型
+- 是否主要设备
+- 设备状态采集点位
+- 程序工时采集点位
+- 标准工时来源
+- 标准单件工时
+- 计划产量来源
+- 是否参与 OEE
+
+开发思路：
+1. 梳理现有设备档案表、工位表、设备工位人员视图。
+2. 确认标准工时放在设备档案、工艺路线，还是设备+工序能力表。
+3. “主要设备”建议独立字段，不能只靠设备名称判断。
+4. OEE 只统计参与 OEE 的主要设备，避免普通辅助设备拉低指标。
+
+风险点：
+- 如果标准工时只放在工艺里，设备利用率无法按单台设备准确计算。
+- 如果标准工时只放在设备档案里，同一设备加工不同零件时又会失真。
+- 更稳妥的口径是：设备档案负责“是否主要设备、是否采集、是否参与 OEE”，工艺/设备能力表负责“标准单件工时”。
+
+预估周期：
+- 字段梳理和表结构确认：0.5 到 1 天
+- 页面字段改造：0.5 到 1 天
+- 联调：0.5 天
+
+### 31.2 设备数据采集
+
+页面/模块：设备数据采集、设备状态监控、设备历史数据  
+现有对象线索：`CaChe_Var`、`历史_设备数据_定时`、`历史_工位设备状态每分钟记录`、`YL_设备管理_工时记录`、`设备管理_设备状态_查询`
+
+需求：
+- 采集程序工时。
+- 采集单件工时。
+- 采集设备状态。
+- 采集数据后用于设备利用率、开动率、OEE、工时异常报表和现场大屏。
+
+采集数据建议：
+- 设备编号/工位号
+- 采集时间
+- 设备状态：运行、待机、报警、关机
+- 操作模式
+- 程序号
+- 循环时间
+- 程序开始时间
+- 程序结束时间
+- 当前加工数量
+- 当前任务或条码绑定信息
+- 采集来源和采集质量标识
+
+关键口径：
+- 程序工时：设备程序运行累计时间，不等于 MES 人工报工工时。
+- 单件工时：单件实际加工时间，优先由程序循环时间或“设备运行时间 / 实际产量”计算。
+- 设备状态：要有时间段，不只保存当前状态，否则无法算设备工时。
+- 设备工时：用于设备利用率时，应指设备处于运行/有效加工状态的累计时长。
+
+开发思路：
+1. 明确采集系统把数据写入 MES 表，还是 MES 定时读取设备/PLC/MQTT。
+2. 建采集原始表，保留原始点位值，不直接覆盖业务结果。
+3. 建设备状态分钟级/秒级汇总表，用于快速计算设备状态时长。
+4. 建设备任务绑定规则：设备采集数据如何关联 MES 任务。
+5. 建异常数据清洗规则：断点、重复、设备离线、跨班次、跨天。
+
+预估周期：
+- 采集字段和接口确认：1 到 2 天
+- 数据落库和历史汇总：2 到 4 天
+- 与 MES 任务关联：2 到 3 天
+- 看板联调：1 到 2 天
+
+AI 关键记录：
+- 设备采集必须先落原始数据，再计算指标。
+- 程序工时、设备工时、人工报工工时是三套口径，不能直接混用。
+
+### 31.3 设备指标与 OEE 计算
+
+目标：支持单台设备产能利用率、设备利用率、设备性能开动率、产品合格率、OEE。
+
+公式：
+
+| 指标 | 公式 | 数据来源建议 | 说明 |
+|---|---|---|---|
+| 产能利用率（单台） | 实际产量 / 计划产量 * 100% | MES 报工数量或质检合格前产量 / 排产计划数量 | 计划产量必须按设备、日期、班次拆分 |
+| 设备利用率（单台） | 设备工时 / 标准工时 | 设备采集运行时长 / 设备或工艺标准工时 | 标准工时要明确是班次标准工时、计划标准工时还是理论可用工时 |
+| 设备性能开动率（单台） | 标准单件工时 / 实际单件工时 | 工艺标准单件工时 / 设备采集单件工时 | 实际单件工时异常时要剔除停机、等待、返工 |
+| 产品合格率（工位） | 良品数 / 总产量 | 质检记录、报工良品/不良品 | 质检滞后时会导致当天合格率滞后 |
+| 设备综合效率 OEE | 设备利用率 * 开动率 * 合格率 | 上面三项 | 三项必须同设备、同班次、同日期口径 |
+
+需要新增或确认的字段：
+- 计划产量
+- 实际产量
+- 良品数
+- 不良品数
+- 标准单件工时
+- 实际单件工时
+- 设备运行工时
+- 标准工时
+- 统计日期
+- 班次
+- 设备/工位
+
+开发风险：
+- 如果实际产量来自报工、良品数来自质检，而质检跨天完成，则当天 OEE 会被低估。
+- 如果设备运行工时来自采集、计划产量来自排产，但任务没有绑定到设备，则单台设备产能利用率无法准确计算。
+- 如果标准工时来源不统一，设备利用率和性能开动率会互相冲突。
+
+建议：
+- 先做设备日/班次指标明细表，再做大屏汇总。
+- 看板显示的 OEE 必须能下钻到三个组成指标。
+- 每个指标保留计算口径说明，不要只显示百分比。
+
+预估周期：
+- 指标口径确认：1 天
+- SQL/视图/汇总表：2 到 4 天
+- 大屏对接：1 到 2 天
+
+### 31.4 工时异常报表
+
+页面：新增报表或工时查询扩展
+
+需求：
+- 单件工时大于标准工时，形成工时异常报表。
+- 报表用于发现设备、工序、人员、程序、物料导致的异常加工。
+
+判断口径：
+- 异常条件：`实际单件工时 > 标准单件工时`。
+- 实际单件工时建议优先来自设备采集；无采集时可用人工报工工时 / 完成数量作为降级口径。
+- 标准单件工时来自生产工艺或设备能力表。
+
+建议字段：
+- 设备/工位
+- 生产订单
+- 物料编码/名称
+- 工序名称
+- 指派对象
+- 操作人
+- 程序号
+- 标准单件工时
+- 实际单件工时
+- 超出时长
+- 超出比例
+- 开始时间/结束时间
+- 班次
+- 异常原因
+
+开发思路：
+1. 建单件工时明细视图。
+2. 计算标准与实际差异。
+3. 超出阈值的进入异常报表。
+4. 支持按设备、工位、人员、物料、工序、日期筛选。
+5. 如需闭环，增加异常确认人、确认时间、处理说明。
+
+预估周期：
+- 报表查询：1 到 2 天
+- 页面和导出：0.5 到 1 天
+- 异常确认闭环：另加 1 到 2 天
+
+### 31.5 及时拣配（机加/装配）
+
+页面/模块：机加拣配、装配拣配、条码扫描
+
+需求：
+- 及时拣配（机加）：条码 → MES。
+- 及时拣配（装配）：条码 → MES。
+
+业务含义：
+- 扫描条码后，MES 要识别任务、物料、领料/发料状态、是否齐套、是否可开工。
+- 机加和装配都需要及时拣配，但拣配对象不同：机加更偏工序/零件加工前物料，装配更偏装配 BOM/缺件齐套。
+
+建议流程：
+
+```mermaid
+flowchart LR
+  A[扫描条码] --> B[解析条码]
+  B --> C[查 MES 任务/物料/BOM]
+  C --> D{是否匹配当前任务}
+  D -- 否 --> E[提示异常并记录]
+  D -- 是 --> F[更新拣配状态]
+  F --> G[判断齐套/缺件]
+  G --> H[反馈可开工或缺件清单]
+```
+
+需要确认：
+- 条码代表物料、箱号、批次、生产订单，还是拣配单。
+- SAP 库存和 MES 拣配状态谁是主口径。
+- 拣配后是否自动改变 `拣配状态`、`齐套`、`发料状态`。
+- 机加和装配是否共用同一套拣配表。
+
+预估周期：
+- 条码规则确认：0.5 到 1 天
+- 机加拣配流程：1 到 2 天
+- 装配拣配流程：1 到 2 天
+- 与看板联动：0.5 到 1 天
+
+### 31.6 一楼质检大屏幕
+
+页面：质检任务看板/一楼质检大屏
+
+需求：
+- 质检及时率：报检任务超过 2 天未检验，时间基准取最后一次生产完成时间。
+- 关键工序检验任务汇总数和明细：工艺编辑时标记关键工序。
+
+质检及时率口径：
+- 应检任务：已有生产完成/报检触发的任务。
+- 超期任务：最后一次生产完成时间超过 2 天，仍未完成检验。
+- 已检任务：已存在对应质检记录且检验数量满足应检数量。
+- 及时率建议：及时检验任务数 / 应检任务数 * 100%。
+
+关键工序需求：
+- 工艺维护时增加“是否关键工序”字段。
+- 生产工艺生成任务时，要把关键工序标识快照到生产任务。
+- 质检大屏按关键工序标识统计应检/未检/已检/加急。
+
+影响：
+- `质量任务看板_未完成统计`、`质量任务看板_未完成明细查询` 需要补超期天数、最后生产完成时间、是否关键工序。
+- 若仅在工艺库改“关键工序”，历史任务是否跟着变，需要确认。建议任务下发时快照，不自动影响历史。
+
+预估周期：
+- 工艺字段和任务快照：1 到 2 天
+- 质检及时率过程：1 到 2 天
+- 大屏改造：1 天
+
+### 31.7 机加现场大屏幕
+
+页面：机加设备生产运营看板/机加现场大屏
+
+需求：
+- 缺勤人员：显示岗位、工位、姓名；一个人或一个岗位可能对应多个工位，需要合并显示。
+- 关键工序任务汇总数和明细：工艺编辑时标记关键工序。
+
+缺勤人员口径：
+- 应到人员：班次人员绑定表或岗位排班表。
+- 实到人员：打卡/登录/报工/绑定上岗记录，需要确认来源。
+- 缺勤：应到但无实到记录。
+- 展示：岗位、工位列表、姓名；多工位用逗号合并。
+
+关键工序任务口径：
+- 已排产且未完成的关键工序任务。
+- 可区分未开工、进行中、超期、加急。
+- 明细至少显示订单、合同、物料、工序、设备/工位、指派对象、计划开始、完成数量、上序合格数。
+
+影响：
+- `机加设备生产运营看板_机加在制查询2` 需要补关键工序标识。
+- 需要新增缺勤人员查询过程，不能继续使用静态示例数据。
+
+预估周期：
+- 缺勤来源确认：0.5 到 1 天
+- 缺勤查询过程和页面对接：1 天
+- 关键工序标识和大屏改造：1 到 2 天
+
+### 31.8 装配现场大屏幕
+
+页面：装配任务看板/装配现场大屏
+
+需求：
+- 缺勤人员：岗位、工位、姓名，一对多合并显示。
+- 及时送检任务列表：可与加急/任务列表合并，用颜色区分；排序在加急后；规则为发料齐套后 2 天未送检。
+
+及时送检口径：
+- 起算时间：发料齐套时间。
+- 超期规则：发料齐套后超过 2 天仍未送检。
+- 送检判断：是否存在送检/质检任务/质检记录，需要确认具体表。
+- 排序：加急任务优先，其次及时送检超期任务，再按计划开始或齐套时间排序。
+
+影响：
+- `装配中心任务看板_装配任务查询` 需要返回发料齐套时间、是否已送检、送检时间、超期天数。
+- `装配中心任务看板_在制品缺件查询` 和发货状态列表需要区分缺件、齐套未送检、已送检未检。
+- 装配缺勤人员不能再用静态样例，需要与班次/岗位/工位绑定联动。
+
+预估周期：
+- 发料齐套时间来源确认：0.5 天
+- 送检状态过程：1 到 2 天
+- 大屏颜色/排序改造：0.5 到 1 天
+- 缺勤人员对接：1 天
+
+### 31.9 本组需求总风险
+
+1. 设备数据采集是前置条件。没有稳定采集数据，程序工时、单件工时、设备利用率、OEE 都只能是估算。
+2. 标准工时来源必须统一。工艺标准工时、设备标准工时、班次标准工时不是同一件事。
+3. 质检及时率和产品合格率存在时间滞后。生产完成当天不一定当天质检，日报和大屏要明确口径。
+4. 关键工序标识要做任务快照。否则工艺维护改字段会影响历史统计。
+5. 缺勤人员必须有排班/应到和实到来源，不能只从当前报工人员反推。
+6. 条码拣配会反向影响 `齐套`、`拣配状态`、`发料状态`，必须同步改生产任务看板和装配看板。
+
+## 32. 追加需求处理状态汇总
 
 | 需求 | 处理状态 | 周期 |
 |---|---|---|
@@ -1175,3 +1475,81 @@ AI 关键记录：
 | 标牌打印操作 | 需求未确定 | 无法排期 |
 | 发货通知列表 | SAP 数据已提供，可开发 | 0.5 天 |
 | 制定标准工艺保存提示 | 可开发 | 0.1 天 |
+| 设备档案管理-主要设备/标准工时 | 可开发，需先定字段归属 | 1.5 到 2.5 天 |
+| 设备数据采集-程序工时/单件工时/设备状态 | 需先确认采集接口和落库表 | 待评估，预计 6 到 11 天 |
+| 设备产能/OEE 指标 | 依赖设备采集和标准工时口径 | 4 到 7 天 |
+| 工时异常报表 | 依赖单件工时和标准工时 | 1.5 到 3 天 |
+| 及时拣配（机加/装配） | 需确认条码规则和状态写回 | 3 到 6 天 |
+| 一楼质检大屏-及时率/关键工序 | 可开发，需补关键工序标识 | 3 到 5 天 |
+| 机加现场大屏-缺勤/关键工序 | 可开发，需确认缺勤来源 | 2.5 到 4 天 |
+| 装配现场大屏-缺勤/及时送检 | 可开发，需确认送检状态来源 | 3 到 5 天 |
+
+## 33. 补充修正：按“数据来源、维护入口、是否新建页面”重新复核
+
+前面部分有些需求只写成“新增页面”或“页面改造”，这个口径还不够。后续评估必须先拆成三件事：
+
+1. 查询/看板页面：给谁看、按什么条件筛选、是否导出。
+2. 数据维护入口：这个字段由谁维护、在哪个业务页面维护、是否要留修改记录。
+3. 数据来源口径：来自 MES 业务表、SAP 同步、设备采集、人工维护、排班/考勤，还是计算结果。
+
+原则：
+- 报表类需求可以新建查询页，但不要把所有字段维护都放进报表页。
+- 主数据类字段优先放在主数据页面维护，例如人员、班次、工位、设备、工序、标准工艺。
+- 订单/任务过程字段优先放在生产计划、生产工艺、装配中心、机加中心、质检中心等业务页面维护。
+- 看板只展示和钻取，不作为唯一维护入口，除非需求明确就是现场确认动作。
+- 如果没有现成维护入口，才考虑新增维护页面，并同步菜单、权限、日志和历史记录。
+
+### 33.1 逐项落点复核
+
+| 需求/字段 | 数据来源建议 | 维护入口建议 | 是否新建页面 | 同步影响 |
+|---|---|---|---|---|
+| 缺勤人员 | 应到：班次/排班/岗位工位人员绑定；实到：考勤、上岗绑定、登录或报工记录 | 若已有班次管理、人员绑定、工位人员关系，则扩展这些页面；若没有排班入口，需要新增 `班次排班/人员出勤维护` 页面 | 看板查询过程要新增；维护页视现有排班能力决定 | 机加看板、装配看板、班次产量、人员绩效 |
+| 关键工序 | 标准工艺/生产工艺中的工序标识，任务下发时快照到生产任务 | `制定标准工艺` 和 `生产工艺` 页面都要支持维护 `是否关键工序`；生产工艺可继承标准工艺但允许按订单调整 | 不建议单独新建“关键工序维护”页；可新增查询/批量检查页 | 质检看板、机加现场大屏、及时检验、生产计划跟踪 |
+| 标准单件工时 | 标准工艺、生产工艺；必要时扩展设备+工序能力表 | 优先在标准工艺/生产工艺维护，设备档案只维护设备能力和是否参与 OEE | 不单独新建维护页，除非要做设备+工序能力矩阵 | OEE、工时异常、未完工工时、计划工时 |
+| 生产工艺自动带出标准工艺 | 标准工艺库生成草稿，保存后进入生产工艺库 | `生产工艺` 页面编辑入口处理；`制定标准工艺` 负责标准来源 | 不新建页面 | 排产、流转卡、工时报表、任务快照 |
+| 设计任务报工 | MES 自建设计任务、设计工时 | 需要独立任务创建、报工、查询和权限 | 需要新建业务页面 | 合同工时、设计工时报表、装配已排产需求 |
+| 编程任务清单/编程报工 | 编程任务、程序号、设备/工位、编程工时 | 需要独立编程任务维护和报工；可从生产订单/设备任务派生 | 需要新建业务页面 | 机加可开工判断、工时报表、及时开工 |
+| 发料齐套时间 | SAP/MES 发料状态、齐套计算或人工维护字段 | 优先落在生产计划/装配排产相关页面；装配已排产需求可展示和必要时编辑 | 报表可新建，字段维护不应只放报表 | 装配完成时间、及时送检、齐套看板 |
+| 装配完成时间 | 规则计算：发料齐套时间 + 3 天；也可能人工调整 | 装配已排产需求或装配排产页面显示；若允许调整需保存调整日志 | 新建装配已排产需求页是合理的，但要明确它既是进度页也是部分字段维护入口 | 质检任务早知道、日计划、合同进度 |
+| 预计可执行时间 | SAP 缺件明细 + 主子订单关系 + 人工判断 | 及时齐套跟踪结果报表中可维护，但必须记录维护人、时间、来源说明 | 可在新报表内做维护动作，不必另建维护页 | 生产任务看板、及时开工、装配计划 |
+| 主订单与缺料子订单关系 | SAP/MES 订单关系，必要时人工绑定 | 若 SAP 无法稳定提供，需要新增主子订单关系维护入口 | 可能需要新增维护页或在齐套报表内维护 | 及时齐套、装配缺件、生产看板 |
+| 手续确认 | 人工确认状态、确认人、确认时间 | 手续确认报表本身就是待办确认入口，可在该页面维护 | 需要新建待办/报表页 | 装配中心、生产任务看板、订单关闭 |
+| 让步接收记录 | 质检记录中的让步接收字段 | 质检中心/不合格处置页面负责维护；新页面只查询 | 新建查询页，不新建维护页 | 质检看板、供应商质量、未清任务 |
+| 外协供应商/SAP 收货单号 | 外协任务、采购收货、质检收检记录 | 序检收检、外协收货、外协任务页面补字段 | 不单独新建维护页 | 外协报表、供应商合格率、SAP 追溯 |
+| 机加班次产量 | 报工记录 + 设备 + 班次规则 | 班次规则在班次管理维护；报表只查询 | 新建报表页，不新建维护页 | 设备看板、工位汇总、OEE |
+| 及时检验 | 生产完成/报工完成时间 + 质检记录 | 质检业务在质检中心维护；及时检验页只催办和查询 | 新建报表页 | 质检看板、生产日报、异常提醒 |
+| 生产日报-送检 | 送检记录、质检记录、部门归属 | 送检和质检在原业务页面维护；日报只汇总 | 可新建报表页 | 日报、质检统计、部门绩效 |
+| 发货通知列表 | SAP 发货通知或同步落地表 | SAP 为主，MES 页面只查询；若需备注/确认再加本地扩展表 | 新建查询页 | 装配看板、合同交付、board_view |
+| 批量关闭 SAP 订单 | MES 订单 + SAP 关闭接口返回 | 生产订单关闭页维护，增加批量动作和结果日志 | 不新建页面，扩展现有关闭页 | 排产页、生产中心、手续确认 |
+| 异常管控直接报异常 | 所有报工页面选中任务带入异常 | 异常管控页维护异常主流程；各报工页只提供入口 | 不新建页面，改异常页和各报工页入口 | 机加、装配、质检、外协、设计、编程 |
+| 条码拣配 | 条码、物料、批次、任务、拣配状态 | 机加中心/装配中心增加扫码入口；条码规则可单独维护 | 扫码操作不一定新建页面，条码规则可能要新建维护页 | 齐套、发料、看板、SAP 库存 |
+| 设备 OEE | 设备采集、报工产量、质检良品、标准工时 | 设备档案、工位管理、工艺维护、设备采集配置分别维护 | OEE 是报表/看板，不是单独维护页 | 机加看板、board_view、设备报表 |
+| 工时异常 | 设备采集单件工时/人工工时 + 标准工时 | 异常报表可增加确认动作；标准工时仍在工艺/设备能力维护 | 新建报表或扩展工时查询 | 工时校验、异常管控、绩效 |
+
+### 33.2 对两个典型问题的明确修正
+
+#### 缺勤数据来源
+
+缺勤不能从“没有报工”反推。正确链路应该是：
+
+```mermaid
+flowchart LR
+  A[班次/排班] --> B[应到人员]
+  C[岗位/工位人员绑定] --> B
+  D[考勤/上岗/登录/报工] --> E[实到人员]
+  B --> F[缺勤判断]
+  E --> F
+  F --> G[机加/装配现场看板]
+```
+
+如果系统没有排班或应到人员维护能力，就必须补一个维护入口。可以是扩展 `ShiftManagement`、人员绑定、工位人员角色页面，也可以新增 `人员排班/出勤维护` 页面。单纯新增看板查询过程只能展示结果，不能解决应到人员从哪里来的问题。
+
+#### 关键工序维护位置
+
+关键工序属于工艺属性，不属于看板属性。维护位置应放在：
+
+- `制定标准工艺`：维护物料标准工艺路线时标记标准关键工序。
+- `生产工艺`：按生产订单生成/编辑工艺时继承标准关键工序，并允许订单级调整。
+- 生产任务生成/下发时：把 `是否关键工序` 快照到任务，避免后续修改标准工艺导致历史看板重算。
+
+因此“一楼质检大屏”和“机加现场大屏”只读取关键工序，不负责维护关键工序。若客户需要批量检查哪些工艺未标关键工序，可以新增查询/批量修正页，但主维护仍应落在标准工艺和生产工艺页面。