76-ZhiRouNingdeLine2-StandingDashboard/doc/DATA_SPEC.md

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

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
• UI_SPEC.md
• TODO.md