178 lines
4.4 KiB
Markdown
178 lines
4.4 KiB
Markdown
# 静置库大屏看板数据口径规划
|
||
|
||
## 1. 数据原则
|
||
|
||
1. 优先复用 MES 现有过站数据、Pack 数据、产品型号数据和工艺参数数据。
|
||
2. 前端不自行推测业务状态，复杂口径优先由存储过程统一计算。
|
||
3. 存储过程和字段名称在确认数据来源后再最终固化。
|
||
4. 当前文档只定义查询能力和口径，不编写数据库 DDL。
|
||
|
||
## 2. 核心口径
|
||
|
||
| 指标 | 口径 |
|
||
| --- | --- |
|
||
| 静置开始 | Pack 在 OP410 的有效过站时间 |
|
||
| 静置结束 | Pack 在下层静置结束工位的有效过站时间 |
|
||
| 当前静置数 | 存在静置开始时间，且不存在静置结束时间的 Pack 数 |
|
||
| 静置中数量 | 当前静置数中，当前时间 - 静置开始时间 < 标准静置时长 |
|
||
| 满足静置时间数 | 当前静置数中，当前时间 - 静置开始时间 >= 标准静置时长 |
|
||
| 超时数量 | 当前静置数中，当前时间 - 静置开始时间 > 标准静置时长 + 超时阈值 |
|
||
| 今日开始静置数 | OP410 过站时间属于今日的 Pack 数 |
|
||
| 今日静置完成数 | 静置结束时间属于今日的 Pack 数 |
|
||
| 达标后等待时长 | 当前时间 - 达标时间 |
|
||
|
||
## 3. 工位过站矩阵
|
||
|
||
表头工位：
|
||
- 42。
|
||
- 43。
|
||
- 44。
|
||
- 45。
|
||
- 46。
|
||
- 47。
|
||
- 48。
|
||
- 49。
|
||
- 50。
|
||
|
||
每个工位返回状态建议：
|
||
|
||
| 状态值 | 含义 |
|
||
| --- | --- |
|
||
| PASS | 已过站 |
|
||
| CURRENT | 当前最新过站 |
|
||
| WAIT | 未过站 |
|
||
| ERROR | 应过未过、顺序异常或数据异常 |
|
||
|
||
## 4. 线体段映射
|
||
|
||
当前建议分段如下，后续以现场设备命名为准：
|
||
|
||
| 段编码 | 段名称 | 映射规则 |
|
||
| --- | --- | --- |
|
||
| S1 | OP410 入静置段 | 已过 OP410，未过 42 |
|
||
| S2 | 42-44 段 | 最近过站在 42、43、44 |
|
||
| S3 | 45-47 段 | 最近过站在 45、46、47 |
|
||
| S4 | 48-50 段 | 最近过站在 48、49、50 |
|
||
| S5 | 下层静置结束待确认段 | 已过 50，未过静置结束工位 |
|
||
|
||
## 5. 建议查询能力
|
||
|
||
### 5.1 静置看板_汇总查询
|
||
|
||
用途：顶部指标和当班统计。
|
||
|
||
建议返回字段：
|
||
- 当前静置数。
|
||
- 满足静置时间数。
|
||
- 静置中数量。
|
||
- 超时数量。
|
||
- 今日开始静置数。
|
||
- 今日静置完成数。
|
||
- 当班开始静置数。
|
||
- 当班静置完成数。
|
||
- 平均静置时长。
|
||
- 平均达标后等待时长。
|
||
- 静置完成率。
|
||
|
||
### 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. 班次时间边界。
|
||
|
||
## 8. 关联文档
|
||
|
||
- [PRD.md](./PRD.md)
|
||
- [UI_SPEC.md](./UI_SPEC.md)
|
||
- [TODO.md](./TODO.md)
|
||
|