# 静置库大屏看板 PRD

## 1. 背景与目标

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

当前版本先使用前端硬编码虚拟数据，不接入数据库，不调用 MES 存储过程。页面内容先用于业务评审和视觉规划，真实数据接入放到后续阶段。

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

## 2. 业务规则摘要

| 项目 | 规则 |
| --- | --- |
| 静置开始 | OP410 上盖安装确认完工 |
| 上层静置 | OP410 完工后，到 OP500 完工前 |
| 下层静置开始 | OP500 密封盖安装确认完工 |
| 静置结束出站 | OP505 常温静置完工 |
| 标准静置时间 | 30 分钟 |
| 计时方式 | 从 OP410 完工开始计时 |
| 必过工位 | OP420、OP430、OP440、OP450、OP460、OP470、OP480、OP490、OP500 |
| 班次统计 | 当前不考虑 |
| 数据来源 | 当前全部使用前端虚拟数据 |

## 3. 用户与场景

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

## 4. 功能范围

### 4.1 顶部实时指标

展示当前静置数、未满 30 分钟数量、已满 30 分钟待出站数量、超时/异常数量、今日开始静置数、今日静置完成数。

**验收标准**：
- [ ] 大屏顶部能同时看到 6 个关键指标。
- [ ] 未满 30 分钟和已满 30 分钟待出站能明确区分。
- [ ] 已满 30 分钟待出站有明显可流转提示色。
- [ ] 超时/异常数量有明显告警色。

### 4.2 静置中 Pack 主列表

按照异常、已满 30 分钟待出站、未满 30 分钟、开始时间优先级滚动展示静置中的 Pack。

字段包括：
- Pack 码。
- 产品型号。
- OP410 完工时间。
- 当前静置时长。
- 30 分钟达标时间。
- 剩余/达标后等待时长。
- 当前状态。
- 当前所在段。
- 42-50 工位过站灯。
- OP505 出站状态。

**验收标准**：
- [ ] 已满 30 分钟待出站 Pack 排在未达标 Pack 前面。
- [ ] 每个 Pack 能看到 42-50 的过站状态。
- [ ] OP505 已出站 Pack 不再计入当前静置数。
- [ ] 未满 30 分钟 Pack 能看到剩余时间。
- [ ] 已满 30 分钟但未出站 Pack 能看到达标后等待时长。

### 4.3 满 30 分钟待出站清单

展示从 OP410 完工开始已满 30 分钟，但 OP505 尚未完工出站的 Pack。

**验收标准**：
- [ ] 能看到 Pack 码、产品型号、30 分钟达标时间、达标后等待时长。
- [ ] 能区分前序工位未过完和已到 OP505 前等待两类情况。
- [ ] 清单为空时显示空状态，不误报异常。

### 4.4 超时/异常清单

展示达标后等待过久、过站缺失、过站顺序异常、数据缺失等异常 Pack。

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

### 4.5 线体段滞留分布

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

建议分段：
- 上层静置：OP410 完工后到 OP500 完工前。
- 下层静置：OP500 完工后到 OP505 完工前。
- 已满 30 分钟待出站。
- 已出站：OP505 完工。

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

### 4.6 今日 JPH

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

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

## 5. 已排除功能

| 功能 | 排除原因 |
| --- | --- |
| 库区/库位/层数矩阵 | 新线静置不分库位，照搬老线会误导现场 |
| 强制入库/强制出库操作 | 当前阶段是看板展示，不做操作闭环 |
| 手工修改 Pack 状态 | 大屏只展示虚拟数据和后续真实数据，不做业务录入入口 |
| 多页面菜单 | 当前目标是首页大屏，先保证核心监控完整 |
| 数据库接入 | 当前阶段只做虚拟数据演示，暂不接数据库 |
| 班次统计 | 用户已确认当前不考虑班次 |

## 6. 非功能要求

| 类别 | 要求 |
| --- | --- |
| 分辨率 | 优先适配 1920x1080 大屏 |
| 刷新频率 | 当前虚拟数据可本地定时刷新或静态展示，后续真实数据再确认 |
| 可读性 | 关键数字和异常状态必须远距离可读 |
| 稳定性 | 当前不依赖接口，页面应可独立打开运行 |
| 数据可信 | 虚拟数据必须覆盖主要业务状态，不误导 30 分钟规则 |

## 7. 业务待确认

1. 达标后等待多久需要定义为重点告警。
2. 上层静置和下层静置是否需要在顶部指标中分别展示。
3. OP505 是否需要在主表中用独立灯点展示，还是只展示出站时间/状态。
4. 虚拟数据条数和示例 Pack 编码格式是否有现场偏好。

## 8. 关联文档

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