diff --git a/doc/BUSINESS_RULES.md b/doc/BUSINESS_RULES.md new file mode 100644 index 0000000..fbfe73a --- /dev/null +++ b/doc/BUSINESS_RULES.md @@ -0,0 +1,82 @@ +# 静置业务规则 + +## 1. 当前数据约束 + +当前版本只使用前端虚拟数据,不接入数据库,不调用 MES 存储过程。 + +实现要求: +- 所有看板数据先硬编码到 Vue 变量中。 +- 图表、表格、指标卡都从本地变量计算或读取。 +- 暂不编写数据库查询和接口联调逻辑。 +- 后续接入真实数据时,再按本规则映射接口字段。 + +## 2. 工位清单 + +| 工位 | 工位名称 | 静置业务含义 | +| --- | --- | --- | +| OP410 | 上盖安装确认 | 静置开始计时点 | +| OP420 | 极柱紧固 | 上层静置过程必过工位 | +| OP430 | 密封盖装配 | 上层静置过程必过工位 | +| OP440 | 密封盖紧固1 | 上层静置过程必过工位 | +| OP450 | 密封盖紧固2 | 上层静置过程必过工位 | +| OP460 | EOL测试 | 上层静置过程必过工位 | +| OP470 | DCR测试 | 上层静置过程必过工位 | +| OP480 | 警告标签粘贴 | 上层静置过程必过工位 | +| OP490 | 标签打印粘贴 | 上层静置过程必过工位 | +| OP500 | 密封盖安装确认 | 下层静置开始点 | +| OP505 | 常温静置 | 静置结束出站工位 | + +## 3. 静置阶段定义 + +| 阶段 | 起点 | 终点 | 说明 | +| --- | --- | --- | --- | +| 上层静置 | OP410 完工 | OP500 完工前 | OP410 完工后开始计时,OP420-OP500 仍需按线体节拍依次完成 | +| 下层静置 | OP500 完工 | OP505 完工 | OP500 完工后进入下层静置,OP505 完工代表静置结束出站 | +| 静置结束 | OP505 完工 | - | Pack 完成常温静置出站 | + +## 4. 30 分钟放行规则 + +标准静置时间当前固定为 30 分钟。 + +计时规则: +- 起算时间:OP410 完工时间。 +- 达标时间:OP410 完工时间 + 30 分钟。 +- 未满 30 分钟:即使前序工位已完成,也不能从 OP505 出站,需要等待。 +- 已满 30 分钟:只代表时间达标,不代表一定已经出站。 +- 已满 30 分钟但未出站的原因可能包括:前面工位还没过完、环状线未排到 OP505、现场节拍等待。 + +## 5. 状态定义 + +| 状态 | 判定规则 | 展示重点 | +| --- | --- | --- | +| 上层静置中 | 已完成 OP410,未完成 OP500,且未完成 OP505 | 展示当前工位进度和距离 30 分钟达标的剩余时间 | +| 下层静置中 | 已完成 OP500,未完成 OP505,且未满 30 分钟 | 展示正在等待 30 分钟达标 | +| 已达标待出站 | 已完成 OP410 满 30 分钟,未完成 OP505 | 展示达标后等待时长,提示可优先流转 | +| 已出站 | 已完成 OP505 | 计入今日静置完成 | +| 过程异常 | 必过工位缺失、顺序异常或数据异常 | 进入异常清单 | + +## 6. 必过工位 + +OP420 到 OP500 都是静置过程必过工位,也就是看板中原先简写的 42-50 工位。 + +展示表头建议使用短码: +- 42 对应 OP420。 +- 43 对应 OP430。 +- 44 对应 OP440。 +- 45 对应 OP450。 +- 46 对应 OP460。 +- 47 对应 OP470。 +- 48 对应 OP480。 +- 49 对应 OP490。 +- 50 对应 OP500。 + +OP505 是静置结束出站工位,不放在 42-50 必过灯矩阵中,可单独作为“出站状态”或“静置结束时间”展示。 + +## 7. 看板表达重点 + +1. 30 分钟达标线必须明显体现。 +2. 区分“时间达标”和“已经出站”。 +3. 已满 30 分钟但未出站的 Pack 需要独立突出。 +4. 上层静置和下层静置可以作为分段统计,不使用库位、库区、层数。 +5. 当前版本使用虚拟数据,虚拟数据需要覆盖未达标、已达标待出站、已出站、过程异常等场景。 + diff --git a/doc/DATA_SPEC.md b/doc/DATA_SPEC.md index 01a2d84..b1ac507 100644 --- a/doc/DATA_SPEC.md +++ b/doc/DATA_SPEC.md @@ -2,37 +2,78 @@ ## 1. 数据原则 -1. 优先复用 MES 现有过站数据、Pack 数据、产品型号数据和工艺参数数据。 -2. 前端不自行推测业务状态,复杂口径优先由存储过程统一计算。 -3. 存储过程和字段名称在确认数据来源后再最终固化。 -4. 当前文档只定义查询能力和口径,不编写数据库 DDL。 +1. 当前版本全部使用前端硬编码虚拟数据。 +2. 暂不接入数据库,暂不调用 MES 存储过程。 +3. 业务状态可以先由前端根据虚拟数据计算。 +4. 文档保留后续真实数据接入所需口径,但不写数据库 DDL。 -## 2. 核心口径 +## 2. 虚拟数据结构建议 + +当前建议在 Vue 文件中定义本地变量,例如: + +```js +const standardRestMinutes = 30 + +const mockPacks = [ + { + packCode: 'PACK202606290001', + productModel: 'PDC', + op410FinishTime: '2026-06-29 08:10:00', + op505FinishTime: '', + currentStation: 'OP460', + stationStatus: { + OP420: 'PASS', + OP430: 'PASS', + OP440: 'PASS', + OP450: 'PASS', + OP460: 'CURRENT', + OP470: 'WAIT', + OP480: 'WAIT', + OP490: 'WAIT', + OP500: 'WAIT' + } + } +] +``` + +虚拟数据需要覆盖: +- 未满 30 分钟的上层静置 Pack。 +- 未满 30 分钟的下层静置 Pack。 +- 已满 30 分钟但 OP505 未出站的 Pack。 +- 已完成 OP505 出站的 Pack。 +- 过站缺失或顺序异常的 Pack。 + +## 3. 核心口径 | 指标 | 口径 | | --- | --- | -| 静置开始 | Pack 在 OP410 的有效过站时间 | -| 静置结束 | Pack 在下层静置结束工位的有效过站时间 | -| 当前静置数 | 存在静置开始时间,且不存在静置结束时间的 Pack 数 | -| 静置中数量 | 当前静置数中,当前时间 - 静置开始时间 < 标准静置时长 | -| 满足静置时间数 | 当前静置数中,当前时间 - 静置开始时间 >= 标准静置时长 | -| 超时数量 | 当前静置数中,当前时间 - 静置开始时间 > 标准静置时长 + 超时阈值 | -| 今日开始静置数 | OP410 过站时间属于今日的 Pack 数 | -| 今日静置完成数 | 静置结束时间属于今日的 Pack 数 | +| 静置开始 | Pack 在 OP410 的完工时间 | +| 下层静置开始 | Pack 在 OP500 的完工时间 | +| 静置结束 | Pack 在 OP505 的完工时间 | +| 标准静置时间 | 30 分钟 | +| 达标时间 | OP410 完工时间 + 30 分钟 | +| 当前静置数 | 存在 OP410 完工时间,且不存在 OP505 完工时间的 Pack 数 | +| 未满 30 分钟数量 | 当前静置数中,当前时间 - OP410 完工时间 < 30 分钟 | +| 已满 30 分钟待出站数量 | 当前静置数中,当前时间 - OP410 完工时间 >= 30 分钟 | +| 今日开始静置数 | OP410 完工时间属于今日的 Pack 数 | +| 今日静置完成数 | OP505 完工时间属于今日的 Pack 数 | | 达标后等待时长 | 当前时间 - 达标时间 | -## 3. 工位过站矩阵 +## 4. 工位过站矩阵 -表头工位: -- 42。 -- 43。 -- 44。 -- 45。 -- 46。 -- 47。 -- 48。 -- 49。 -- 50。 +表头短码与工位对应关系: + +| 短码 | 工位 | 名称 | 是否必过 | +| --- | --- | --- | --- | +| 42 | OP420 | 极柱紧固 | 是 | +| 43 | OP430 | 密封盖装配 | 是 | +| 44 | OP440 | 密封盖紧固1 | 是 | +| 45 | OP450 | 密封盖紧固2 | 是 | +| 46 | OP460 | EOL测试 | 是 | +| 47 | OP470 | DCR测试 | 是 | +| 48 | OP480 | 警告标签粘贴 | 是 | +| 49 | OP490 | 标签打印粘贴 | 是 | +| 50 | OP500 | 密封盖安装确认 | 是 | 每个工位返回状态建议: @@ -43,135 +84,47 @@ | WAIT | 未过站 | | ERROR | 应过未过、顺序异常或数据异常 | -## 4. 线体段映射 +OP505 常温静置是静置结束出站工位,不属于 42-50 矩阵,但可以在主表中单独展示出站状态。 + +## 5. 线体段映射 当前建议分段如下,后续以现场设备命名为准: | 段编码 | 段名称 | 映射规则 | | --- | --- | --- | -| S1 | OP410 入静置段 | 已过 OP410,未过 42 | -| S2 | 42-44 段 | 最近过站在 42、43、44 | -| S3 | 45-47 段 | 最近过站在 45、46、47 | -| S4 | 48-50 段 | 最近过站在 48、49、50 | -| S5 | 下层静置结束待确认段 | 已过 50,未过静置结束工位 | +| S1 | 上层静置 | 已完成 OP410,未完成 OP500 | +| S2 | 下层静置 | 已完成 OP500,未完成 OP505 | +| S3 | 已满 30 分钟待出站 | 已满 30 分钟,未完成 OP505 | +| S4 | 已出站 | 已完成 OP505 | +| S5 | 过程异常 | 工位缺失、顺序异常或数据异常 | -## 5. 建议查询能力 +## 6. 本地计算字段 -### 5.1 静置看板_汇总查询 +建议前端根据虚拟数据计算: -用途:顶部指标和当班统计。 +| 字段 | 计算方式 | +| --- | --- | +| restMinutes | 当前时间 - OP410 完工时间 | +| targetFinishTime | OP410 完工时间 + 30 分钟 | +| remainMinutes | 30 - restMinutes,最小为 0 | +| waitAfterTargetMinutes | restMinutes - 30,最小为 0 | +| isTargetReached | restMinutes >= 30 | +| isFinished | 存在 OP505 完工时间 | +| currentStage | 根据 OP500、OP505 完工情况判断上层/下层/已出站 | -建议返回字段: -- 当前静置数。 -- 满足静置时间数。 -- 静置中数量。 -- 超时数量。 -- 今日开始静置数。 -- 今日静置完成数。 -- 当班开始静置数。 -- 当班静置完成数。 -- 平均静置时长。 -- 平均达标后等待时长。 -- 静置完成率。 +## 7. 后续真实数据接入建议 -### 5.2 静置看板_静置Pack列表查询 +当前不开发真实数据接口。后续需要接入时,再按以下能力补充存储过程: -用途:中心主表。 - -建议参数: -- 记录条数。 - -建议返回字段: -- Pack码。 -- 产品型号。 -- 静置开始时间。 -- 当前静置时长。 -- 标准静置时长。 -- 剩余时长。 -- 超时时长。 -- 当前状态。 -- 当前所在段。 -- 最近过站。 -- 最近过站时间。 -- 工位42状态。 -- 工位43状态。 -- 工位44状态。 -- 工位45状态。 -- 工位46状态。 -- 工位47状态。 -- 工位48状态。 -- 工位49状态。 -- 工位50状态。 - -### 5.3 静置看板_待流转清单查询 - -用途:满足静置时间但未结束静置的 Pack 清单。 - -建议返回字段: -- Pack码。 -- 产品型号。 -- 静置开始时间。 -- 达标时间。 -- 达标后等待时长。 -- 当前所在段。 - -### 5.4 静置看板_异常清单查询 - -用途:超时和过站异常。 - -建议返回字段: -- Pack码。 -- 产品型号。 -- 异常类型。 -- 当前静置时长。 -- 超时时长。 -- 最近过站。 -- 最近过站时间。 -- 异常说明。 - -### 5.5 静置看板_线体段滞留查询 - -用途:线体段滞留分布。 - -建议返回字段: -- 段编码。 -- 段名称。 -- 当前Pack数。 -- 超时Pack数。 -- 最长滞留时长。 - -### 5.6 静置看板_小时JPH查询 - -用途:今日小时入出静置 JPH。 - -建议返回字段: -- 小时。 -- 开始静置数量。 -- 静置结束数量。 -- 净增数量。 - -## 6. 前端调用约定 - -当前项目通过注入的 `CreateData` 和 `ExecDatabase` 调用 MES 存储过程。 - -前端编码时应遵循: -- 不猜测接口返回结构,先确认存储过程字段。 -- 字段名以存储过程实际返回为准。 -- 对空数据展示空状态,不写大量模糊错误兜底。 -- 查询失败时保持页面基本结构,避免大屏整屏空白。 - -## 7. 待确认数据项 - -1. Pack 过站记录表或现有查询存储过程。 -2. 产品型号来源字段。 -3. 标准静置时长来源。 -4. OP410 与 42-50 的实际工位编码关系。 -5. 下层静置结束工位。 -6. 班次时间边界。 +1. 静置看板_汇总查询。 +2. 静置看板_静置Pack列表查询。 +3. 静置看板_待出站清单查询。 +4. 静置看板_异常清单查询。 +5. 静置看板_小时JPH查询。 ## 8. 关联文档 - [PRD.md](./PRD.md) +- [BUSINESS_RULES.md](./BUSINESS_RULES.md) - [UI_SPEC.md](./UI_SPEC.md) - [TODO.md](./TODO.md) - diff --git a/doc/PRD.md b/doc/PRD.md index ae297f6..8b39117 100644 --- a/doc/PRD.md +++ b/doc/PRD.md @@ -4,88 +4,108 @@ 智柔宁德二线静置过程需要通过大屏实时展示 Pack 静置状态。老线看板以库区、库位、层数为主要展示对象,但新线静置不分库位,因此本项目需要转为以 Pack 静置进度、工位过站状态和线体段滞留为核心的过程监控看板。 +当前版本先使用前端硬编码虚拟数据,不接入数据库,不调用 MES 存储过程。页面内容先用于业务评审和视觉规划,真实数据接入放到后续阶段。 + 核心目标: - 让现场人员快速知道当前静置池压力。 - 明确哪些 Pack 已满足静置时间,应该优先流转。 +- 明确 30 分钟静置达标线,区分“时间达标”和“已经出站”。 - 暴露超时、过站缺失、顺序异常等风险。 - 通过今日小时入出静置 JPH 判断是否存在堆积趋势。 -## 2. 用户与场景 +## 2. 业务规则摘要 + +| 项目 | 规则 | +| --- | --- | +| 静置开始 | OP410 上盖安装确认完工 | +| 上层静置 | OP410 完工后,到 OP500 完工前 | +| 下层静置开始 | OP500 密封盖安装确认完工 | +| 静置结束出站 | OP505 常温静置完工 | +| 标准静置时间 | 30 分钟 | +| 计时方式 | 从 OP410 完工开始计时 | +| 必过工位 | OP420、OP430、OP440、OP450、OP460、OP470、OP480、OP490、OP500 | +| 班次统计 | 当前不考虑 | +| 数据来源 | 当前全部使用前端虚拟数据 | + +## 3. 用户与场景 | 用户 | 使用场景 | 关注内容 | | --- | --- | --- | | 现场操作人员 | 查看当前可流转 Pack | 满足静置时间数、待流转清单 | -| 班组长 | 判断当前班次静置节拍 | 当班开始静置数、完成数、平均静置时长 | +| 班组长 | 判断当前静置节拍 | 今日开始静置数、完成数、平均静置时长 | | 工艺/质量人员 | 排查异常 Pack | 超时、过站缺失、顺序异常 | | 设备/线体管理人员 | 定位堆积段 | 线体段滞留数量、最长滞留时长 | | 生产管理人员 | 总览当日趋势 | 今日 JPH、静置完成数、当前静置数 | -## 3. 功能范围 +## 4. 功能范围 -### 3.1 顶部实时指标 +### 4.1 顶部实时指标 -展示当前静置数、满足静置时间数、静置中数量、超时数量、今日开始静置数、今日静置完成数。 +展示当前静置数、未满 30 分钟数量、已满 30 分钟待出站数量、超时/异常数量、今日开始静置数、今日静置完成数。 **验收标准**: - [ ] 大屏顶部能同时看到 6 个关键指标。 -- [ ] 超时数量有明显告警色。 -- [ ] 满足静置时间数有明显可流转提示色。 +- [ ] 未满 30 分钟和已满 30 分钟待出站能明确区分。 +- [ ] 已满 30 分钟待出站有明显可流转提示色。 +- [ ] 超时/异常数量有明显告警色。 -### 3.2 静置中 Pack 主列表 +### 4.2 静置中 Pack 主列表 -按照超时、已达标、开始时间优先级滚动展示静置中的 Pack。 +按照异常、已满 30 分钟待出站、未满 30 分钟、开始时间优先级滚动展示静置中的 Pack。 字段包括: - Pack 码。 - 产品型号。 -- 静置开始时间。 +- OP410 完工时间。 - 当前静置时长。 -- 标准静置时长。 -- 剩余/超时时长。 +- 30 分钟达标时间。 +- 剩余/达标后等待时长。 - 当前状态。 - 当前所在段。 - 42-50 工位过站灯。 +- OP505 出站状态。 **验收标准**: -- [ ] 超时 Pack 排在普通静置 Pack 前面。 -- [ ] 已满足静置时间 Pack 排在未达标 Pack 前面。 +- [ ] 已满 30 分钟待出站 Pack 排在未达标 Pack 前面。 - [ ] 每个 Pack 能看到 42-50 的过站状态。 -- [ ] 静置时长超过标准后状态能变为已达标或超时。 +- [ ] OP505 已出站 Pack 不再计入当前静置数。 +- [ ] 未满 30 分钟 Pack 能看到剩余时间。 +- [ ] 已满 30 分钟但未出站 Pack 能看到达标后等待时长。 -### 3.3 满足静置待流转清单 +### 4.3 满 30 分钟待出站清单 -展示已经达到标准静置时长但尚未结束静置的 Pack。 +展示从 OP410 完工开始已满 30 分钟,但 OP505 尚未完工出站的 Pack。 **验收标准**: -- [ ] 能看到 Pack 码、产品型号、达标时间、达标后等待时长。 +- [ ] 能看到 Pack 码、产品型号、30 分钟达标时间、达标后等待时长。 +- [ ] 能区分前序工位未过完和已到 OP505 前等待两类情况。 - [ ] 清单为空时显示空状态,不误报异常。 -### 3.4 超时/异常清单 +### 4.4 超时/异常清单 -展示静置超时、过站缺失、过站顺序异常、数据缺失等异常 Pack。 +展示达标后等待过久、过站缺失、过站顺序异常、数据缺失等异常 Pack。 **验收标准**: - [ ] 不同异常类型有不同标签。 - [ ] 能看到最近过站和最近过站时间。 - [ ] 异常清单控制在大屏可读范围内。 -### 3.5 线体段滞留分布 +### 4.5 线体段滞留分布 按线体过程段展示滞留情况,不展示库位矩阵。 建议分段: -- OP410 入静置段。 -- 42-44 段。 -- 45-47 段。 -- 48-50 段。 -- 下层静置结束待确认段。 +- 上层静置:OP410 完工后到 OP500 完工前。 +- 下层静置:OP500 完工后到 OP505 完工前。 +- 已满 30 分钟待出站。 +- 已出站:OP505 完工。 **验收标准**: - [ ] 每个段展示当前 Pack 数。 -- [ ] 每个段展示超时 Pack 数。 +- [ ] 每个段展示已满 30 分钟 Pack 数。 - [ ] 每个段展示最长滞留时长。 -### 3.6 今日 JPH +### 4.6 今日 JPH 展示今日每小时开始静置数量和静置结束数量。 @@ -94,36 +114,37 @@ - [ ] 同时展示开始静置和静置结束两组数据。 - [ ] 可选展示净增数量,用于判断堆积趋势。 -## 4. 已排除功能 +## 5. 已排除功能 | 功能 | 排除原因 | | --- | --- | | 库区/库位/层数矩阵 | 新线静置不分库位,照搬老线会误导现场 | | 强制入库/强制出库操作 | 当前阶段是看板展示,不做操作闭环 | -| 手工修改 Pack 状态 | 数据应来自 MES 过站记录,避免大屏成为业务录入入口 | +| 手工修改 Pack 状态 | 大屏只展示虚拟数据和后续真实数据,不做业务录入入口 | | 多页面菜单 | 当前目标是首页大屏,先保证核心监控完整 | +| 数据库接入 | 当前阶段只做虚拟数据演示,暂不接数据库 | +| 班次统计 | 用户已确认当前不考虑班次 | -## 5. 非功能要求 +## 6. 非功能要求 | 类别 | 要求 | | --- | --- | | 分辨率 | 优先适配 1920x1080 大屏 | -| 刷新频率 | 建议 30-60 秒刷新一次,后续按数据库压力确认 | +| 刷新频率 | 当前虚拟数据可本地定时刷新或静态展示,后续真实数据再确认 | | 可读性 | 关键数字和异常状态必须远距离可读 | -| 稳定性 | 接口失败时保留页面框架,不出现整屏崩溃 | -| 数据可信 | 指标口径必须可追溯到过站记录或明确存储过程 | +| 稳定性 | 当前不依赖接口,页面应可独立打开运行 | +| 数据可信 | 虚拟数据必须覆盖主要业务状态,不误导 30 分钟规则 | -## 6. 业务待确认 +## 7. 业务待确认 -1. “下层静置结束”对应工位号。 -2. 标准静置时长来源。 -3. 超时阈值。 -4. 42-50 是否全部必过。 -5. 是否需要班次统计及班次边界。 +1. 达标后等待多久需要定义为重点告警。 +2. 上层静置和下层静置是否需要在顶部指标中分别展示。 +3. OP505 是否需要在主表中用独立灯点展示,还是只展示出站时间/状态。 +4. 虚拟数据条数和示例 Pack 编码格式是否有现场偏好。 -## 7. 关联文档 +## 8. 关联文档 +- [BUSINESS_RULES.md](./BUSINESS_RULES.md) - [UI_SPEC.md](./UI_SPEC.md) - [DATA_SPEC.md](./DATA_SPEC.md) - [TODO.md](./TODO.md) - diff --git a/doc/README.md b/doc/README.md index 500665a..1f8b77b 100644 --- a/doc/README.md +++ b/doc/README.md @@ -7,10 +7,12 @@ ## 项目范围 - 看板对象:智柔宁德二线静置过程。 -- 静置起点:OP410 有效过站。 -- 静置终点:下层静置结束对应工位,有待业务确认。 +- 静置起点:OP410 上盖安装确认完工。 +- 下层静置起点:OP500 密封盖安装确认完工。 +- 静置终点:OP505 常温静置完工出站。 +- 标准静置时间:30 分钟,从 OP410 完工开始计时。 - 新线约束:不按老线库区、库位、层数展示。 -- 当前阶段:先完成内容规划和页面信息结构,后续再细化图表样式、数据接口和存储过程。 +- 当前阶段:先使用前端硬编码虚拟数据,不接入数据库,不调用存储过程。 ## 技术栈 @@ -22,13 +24,14 @@ | 大屏组件 | @kjgl77/datav-vue3 | | UI 组件 | Element Plus、TDesign Vue Next | | 状态管理 | Pinia | -| 接口方式 | CreateData / ExecDatabase 调用 MES 存储过程 | +| 数据方式 | 前端变量硬编码虚拟数据 | ## 文档索引 | 文档 | 说明 | | --- | --- | | [PRD.md](./PRD.md) | 产品需求与业务目标 | +| [BUSINESS_RULES.md](./BUSINESS_RULES.md) | 静置业务规则与工位口径 | | [UI_SPEC.md](./UI_SPEC.md) | 大屏页面内容与布局规划 | | [DATA_SPEC.md](./DATA_SPEC.md) | 数据口径与接口能力规划 | | [TODO.md](./TODO.md) | 后续开发任务清单 | @@ -39,9 +42,7 @@ ## 关键待确认项 -1. “下层静置结束”对应的准确工位号。 -2. 产品型号对应标准静置时长的数据来源。 -3. 超时阈值定义。 -4. 42-50 是否全部属于静置过程必过工位。 -5. 班次边界是否需要纳入统计。 - +1. 虚拟数据需要展示多少条 Pack 才能满足现场评审。 +2. 30 分钟达标后等待多久需要视为重点告警。 +3. 上层静置、下层静置在画面上是否需要分别统计。 +4. OP505 出站是否需要进入主表灯点矩阵,还是保持独立出站状态。 diff --git a/doc/TODO.md b/doc/TODO.md index 7c35dbb..56c54f6 100644 --- a/doc/TODO.md +++ b/doc/TODO.md @@ -1,49 +1,52 @@ # 静置库大屏看板开发任务清单 -## A. 业务确认 +## A. 已确认业务口径 -- [ ] A1 确认下层静置结束工位号。 -- [ ] A2 确认 42-50 是否全部属于必过工位。 -- [ ] A3 确认标准静置时长来源。 -- [ ] A4 确认超时阈值定义。 -- [ ] A5 确认是否需要班次统计及班次时间。 +- [x] A1 OP410 上盖安装确认完工为静置开始。 +- [x] A2 OP500 密封盖安装确认完工为下层静置开始。 +- [x] A3 OP505 常温静置完工为静置结束出站。 +- [x] A4 标准静置时间当前固定为 30 分钟。 +- [x] A5 42-50 对应 OP420-OP500,全部是必过工位。 +- [x] A6 当前不考虑班次统计。 +- [x] A7 当前全部使用前端虚拟数据,不接数据库。 -## B. 数据查询 +## B. 虚拟数据 -- [ ] B1 梳理 Pack 过站数据来源。 -- [ ] B2 编写或复用静置汇总查询。 -- [ ] B3 编写或复用静置 Pack 列表查询。 -- [ ] B4 编写或复用工位过站矩阵查询。 -- [ ] B5 编写或复用待流转清单查询。 -- [ ] B6 编写或复用异常清单查询。 -- [ ] B7 编写或复用线体段滞留查询。 -- [ ] B8 编写或复用小时 JPH 查询。 +- [ ] B1 在 Vue 中定义标准静置时间变量 `standardRestMinutes = 30`。 +- [ ] B2 硬编码 Pack 虚拟数据列表。 +- [ ] B3 虚拟数据覆盖未满 30 分钟上层静置。 +- [ ] B4 虚拟数据覆盖未满 30 分钟下层静置。 +- [ ] B5 虚拟数据覆盖已满 30 分钟待出站。 +- [ ] B6 虚拟数据覆盖 OP505 已出站。 +- [ ] B7 虚拟数据覆盖过站缺失或顺序异常。 ## C. 前端页面改造 - [ ] C1 将现有生产追溯标题和模块替换为静置库看板内容。 -- [ ] C2 改造顶部 6 个指标卡。 +- [ ] C2 改造顶部 6 个指标卡,突出未满 30 分钟和已满 30 分钟待出站。 - [ ] C3 实现静置中 Pack 主表。 -- [ ] C4 实现 42-50 工位过站灯。 -- [ ] C5 实现待流转清单。 +- [ ] C4 实现 42-50 工位过站灯,并映射 OP420-OP500。 +- [ ] C5 实现已满 30 分钟待出站清单。 - [ ] C6 实现超时/异常清单。 - [ ] C7 实现线体段滞留图。 - [ ] C8 实现今日小时 JPH 图表。 - [ ] C9 调整左侧当前入静置/出静置信息。 +- [ ] C10 在主表中体现 30 分钟达标线、剩余时间、达标后等待时长。 ## D. 联调验证 -- [ ] D1 用测试数据验证静置开始口径。 -- [ ] D2 用测试数据验证静置结束口径。 -- [ ] D3 验证已达标、静置中、超时状态判断。 -- [ ] D4 验证 42-50 工位灯显示。 -- [ ] D5 验证空数据场景。 -- [ ] D6 验证接口失败时页面不崩溃。 -- [ ] D7 验证 1920x1080 大屏显示无明显重叠。 +- [ ] D1 用虚拟数据验证 OP410 完工即开始计时。 +- [ ] D2 用虚拟数据验证 OP500 完工后进入下层静置。 +- [ ] D3 用虚拟数据验证 OP505 完工即静置结束出站。 +- [ ] D4 验证未满 30 分钟状态和剩余时间。 +- [ ] D5 验证已满 30 分钟待出站状态和等待时长。 +- [ ] D6 验证 42-50 工位灯显示。 +- [ ] D7 验证异常虚拟数据展示。 +- [ ] D8 验证 1920x1080 大屏显示无明显重叠。 ## E. 交付准备 -- [ ] E1 补充最终存储过程字段说明。 +- [ ] E1 补充虚拟数据字段说明。 - [ ] E2 更新 README 文档索引。 - [ ] E3 提交 Git 版本。 - [ ] E4 部署到目标大屏环境验证。 @@ -52,11 +55,10 @@ | 分组 | 数量 | | --- | ---: | -| A. 业务确认 | 5 | -| B. 数据查询 | 8 | -| C. 前端页面改造 | 9 | -| D. 联调验证 | 7 | +| A. 已确认业务口径 | 7 | +| B. 虚拟数据 | 7 | +| C. 前端页面改造 | 10 | +| D. 联调验证 | 8 | | E. 交付准备 | 4 | -总任务数:33。 - +总任务数:36。 diff --git a/doc/UI_SPEC.md b/doc/UI_SPEC.md index 27c83f6..aa9e776 100644 --- a/doc/UI_SPEC.md +++ b/doc/UI_SPEC.md @@ -3,9 +3,10 @@ ## 1. 设计原则 1. 过程优先:新线不展示库位,以 Pack 静置状态和工位过站过程为主。 -2. 异常前置:超时、已达标待流转、过站缺失必须优先可见。 -3. 信息密度适中:大屏用于远距离浏览,不堆叠过多小字。 -4. 图表服务业务:每个图表必须回答一个现场问题。 +2. 达标线清晰:30 分钟静置达标线必须明显体现。 +3. 异常前置:已满 30 分钟待出站、达标后等待过久、过站缺失必须优先可见。 +4. 信息密度适中:大屏用于远距离浏览,不堆叠过多小字。 +5. 图表服务业务:每个图表必须回答一个现场问题。 ## 2. 页面结构 @@ -13,10 +14,10 @@ --------------------------------------------------------------------------------+ | Logo 静置库大屏看板 日期 / 时间 / 刷新状态 | +--------------------------------------------------------------------------------+ -| 当前静置数 | 满足静置时间数 | 静置中数量 | 超时数量 | 今日开始 | 今日完成 | +| 当前静置数 | 未满30分钟 | 已满30分钟待出站 | 异常数量 | 今日开始 | 今日完成 | +--------------------------------------------------------------------------------+ | 左侧概览区 | 中心主区:静置中 Pack 列表 + 工位过站灯 | 右侧监控区 | -| - 当班统计 | Pack码 产品型号 开始时间 时长 状态 42-50 | - 待流转清单 | +| - 今日统计 | Pack码 产品型号 OP410时间 时长 30分钟线 42-50 | - 待出站清单 | | - 当前入静置 Pack | | - 超时异常清单 | | - 当前出静置 Pack | | - 线体段滞留 | +--------------------------------------------------------------------------------+ @@ -31,9 +32,9 @@ | 指标 | 颜色建议 | 说明 | | --- | --- | --- | | 当前静置数 | 蓝色 | 当前池子总压力 | -| 满足静置时间数 | 绿色 | 可优先流转 | -| 静置中数量 | 青色 | 未达到标准时间 | -| 超时数量 | 红色 | 需要现场关注 | +| 未满 30 分钟 | 青色 | 仍需等待静置达标 | +| 已满 30 分钟待出站 | 绿色 | 时间达标但 OP505 未出站 | +| 异常数量 | 红色 | 过程异常或达标后等待过久 | | 今日开始静置数 | 蓝紫色 | 今日入口 | | 今日静置完成数 | 金色 | 今日出口 | @@ -48,13 +49,14 @@ | 序号 | 2 位序号 | | Pack 码 | 主字段,超长省略 | | 产品型号 | 文本 | -| 静置开始时间 | 月日 时分 | +| OP410 完工时间 | 月日 时分 | | 当前静置时长 | 数字 + 单位 | -| 标准静置时长 | 数字 + 单位 | -| 剩余/超时时长 | 正常显示剩余,超时显示红色 | -| 状态 | 标签:静置中、已达标、超时、异常 | +| 30 分钟达标时间 | 月日 时分 | +| 剩余/等待时长 | 未满显示剩余,已满显示达标后等待 | +| 状态 | 标签:上层静置中、下层静置中、已达标待出站、已出站、异常 | | 当前所在段 | 文本标签 | | 42-50 | 灯点矩阵 | +| OP505 | 出站状态或出站时间 | 工位灯规则: @@ -65,16 +67,30 @@ | 未过站 | 灰色 | Pack 尚未经过该工位 | | 异常 | 红色 | 应过未过、顺序异常或数据异常 | +42-50 对应关系: + +| 短码 | 工位 | 名称 | +| --- | --- | --- | +| 42 | OP420 | 极柱紧固 | +| 43 | OP430 | 密封盖装配 | +| 44 | OP440 | 密封盖紧固1 | +| 45 | OP450 | 密封盖紧固2 | +| 46 | OP460 | EOL测试 | +| 47 | OP470 | DCR测试 | +| 48 | OP480 | 警告标签粘贴 | +| 49 | OP490 | 标签打印粘贴 | +| 50 | OP500 | 密封盖安装确认 | + ## 5. 左侧概览区 -### 5.1 当班统计 +### 5.1 今日统计 建议展示: -- 当班开始静置数。 -- 当班静置完成数。 +- 今日开始静置数。 +- 今日静置完成数。 - 平均静置时长。 - 平均达标后等待时长。 -- 超时 Pack 数。 +- 已满 30 分钟待出站 Pack 数。 - 静置完成率。 ### 5.2 当前入静置 Pack @@ -82,7 +98,7 @@ 显示最近进入 OP410 的 Pack: - Pack 码。 - 产品型号。 -- OP410 过站时间。 +- OP410 完工时间。 - 当前静置时长。 ### 5.3 当前出静置 Pack @@ -90,25 +106,26 @@ 显示最近完成下层静置结束的 Pack: - Pack 码。 - 产品型号。 -- 静置结束时间。 +- OP505 完工时间。 - 总静置时长。 ## 6. 右侧监控区 -### 6.1 满足静置待流转清单 +### 6.1 已满 30 分钟待出站清单 用于提醒现场优先处理。 字段: - Pack 码。 -- 达标时间。 +- 30 分钟达标时间。 - 达标后等待时长。 - 当前所在段。 +- 最近完成工位。 ### 6.2 超时/异常清单 异常类型: -- 静置超时。 +- 达标后等待过久。 - 过站缺失。 - 过站顺序异常。 - 数据缺失。 @@ -118,11 +135,10 @@ 建议使用横向条形图或过程流转图,不使用库位矩阵。 分段: -- OP410 入静置段。 -- 42-44 段。 -- 45-47 段。 -- 48-50 段。 -- 下层静置结束待确认段。 +- 上层静置:OP410 完工后到 OP500 完工前。 +- 下层静置:OP500 完工后到 OP505 完工前。 +- 已满 30 分钟待出站。 +- 已出站:OP505 完工。 ## 7. 底部趋势区 @@ -145,6 +161,6 @@ ## 9. 关联文档 - [PRD.md](./PRD.md) +- [BUSINESS_RULES.md](./BUSINESS_RULES.md) - [DATA_SPEC.md](./DATA_SPEC.md) - [TODO.md](./TODO.md) -