初始化静置库大屏看板项目

doc/DATA_SPEC.md

@@ -0,0 +1,177 @@
+# 静置库大屏看板数据口径规划
+
+## 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)
+