# 静置库大屏看板 PRD

## 1. 背景与目标

智柔宁德二线静置过程需要通过大屏实时展示 Pack 静置状态。老线看板以库区、库位、层数为主要展示对象，但新线静置不分库位，因此本项目需要转为以 Pack 静置进度、工位过站状态和线体段滞留为核心的过程监控看板。

核心目标：
- 让现场人员快速知道当前静置池压力。
- 明确哪些 Pack 已满足静置时间，应该优先流转。
- 暴露超时、过站缺失、顺序异常等风险。
- 通过今日小时入出静置 JPH 判断是否存在堆积趋势。

## 2. 用户与场景

| 用户 | 使用场景 | 关注内容 |
| --- | --- | --- |
| 现场操作人员 | 查看当前可流转 Pack | 满足静置时间数、待流转清单 |
| 班组长 | 判断当前班次静置节拍 | 当班开始静置数、完成数、平均静置时长 |
| 工艺/质量人员 | 排查异常 Pack | 超时、过站缺失、顺序异常 |
| 设备/线体管理人员 | 定位堆积段 | 线体段滞留数量、最长滞留时长 |
| 生产管理人员 | 总览当日趋势 | 今日 JPH、静置完成数、当前静置数 |

## 3. 功能范围

### 3.1 顶部实时指标

展示当前静置数、满足静置时间数、静置中数量、超时数量、今日开始静置数、今日静置完成数。

**验收标准**：
- [ ] 大屏顶部能同时看到 6 个关键指标。
- [ ] 超时数量有明显告警色。
- [ ] 满足静置时间数有明显可流转提示色。

### 3.2 静置中 Pack 主列表

按照超时、已达标、开始时间优先级滚动展示静置中的 Pack。

字段包括：
- Pack 码。
- 产品型号。
- 静置开始时间。
- 当前静置时长。
- 标准静置时长。
- 剩余/超时时长。
- 当前状态。
- 当前所在段。
- 42-50 工位过站灯。

**验收标准**：
- [ ] 超时 Pack 排在普通静置 Pack 前面。
- [ ] 已满足静置时间 Pack 排在未达标 Pack 前面。
- [ ] 每个 Pack 能看到 42-50 的过站状态。
- [ ] 静置时长超过标准后状态能变为已达标或超时。

### 3.3 满足静置待流转清单

展示已经达到标准静置时长但尚未结束静置的 Pack。

**验收标准**：
- [ ] 能看到 Pack 码、产品型号、达标时间、达标后等待时长。
- [ ] 清单为空时显示空状态，不误报异常。

### 3.4 超时/异常清单

展示静置超时、过站缺失、过站顺序异常、数据缺失等异常 Pack。

**验收标准**：
- [ ] 不同异常类型有不同标签。
- [ ] 能看到最近过站和最近过站时间。
- [ ] 异常清单控制在大屏可读范围内。

### 3.5 线体段滞留分布

按线体过程段展示滞留情况，不展示库位矩阵。

建议分段：
- OP410 入静置段。
- 42-44 段。
- 45-47 段。
- 48-50 段。
- 下层静置结束待确认段。

**验收标准**：
- [ ] 每个段展示当前 Pack 数。
- [ ] 每个段展示超时 Pack 数。
- [ ] 每个段展示最长滞留时长。

### 3.6 今日 JPH

展示今日每小时开始静置数量和静置结束数量。

**验收标准**：
- [ ] 横轴按今日小时展示。
- [ ] 同时展示开始静置和静置结束两组数据。
- [ ] 可选展示净增数量，用于判断堆积趋势。

## 4. 已排除功能

| 功能 | 排除原因 |
| --- | --- |
| 库区/库位/层数矩阵 | 新线静置不分库位，照搬老线会误导现场 |
| 强制入库/强制出库操作 | 当前阶段是看板展示，不做操作闭环 |
| 手工修改 Pack 状态 | 数据应来自 MES 过站记录，避免大屏成为业务录入入口 |
| 多页面菜单 | 当前目标是首页大屏，先保证核心监控完整 |

## 5. 非功能要求

| 类别 | 要求 |
| --- | --- |
| 分辨率 | 优先适配 1920x1080 大屏 |
| 刷新频率 | 建议 30-60 秒刷新一次，后续按数据库压力确认 |
| 可读性 | 关键数字和异常状态必须远距离可读 |
| 稳定性 | 接口失败时保留页面框架，不出现整屏崩溃 |
| 数据可信 | 指标口径必须可追溯到过站记录或明确存储过程 |

## 6. 业务待确认

1. “下层静置结束”对应工位号。
2. 标准静置时长来源。
3. 超时阈值。
4. 42-50 是否全部必过。
5. 是否需要班次统计及班次边界。

## 7. 关联文档

- [UI_SPEC.md](./UI_SPEC.md)
- [DATA_SPEC.md](./DATA_SPEC.md)
- [TODO.md](./TODO.md)

