# 静置库大屏看板数据口径规划

## 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)

