meswork/76-ZhiRouNingdeLine2-StandingDashboard
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新静置业务口径与虚拟数据方案

Browse Source
This commit is contained in:
XingCheng3
2026-06-29 11:34:31 +08:00
parent 5d0cad9e10
commit 7cfb3dbc36
6 changed files with 325 additions and 250 deletions
Download Patch File Download Diff File Expand all files Collapse all files

231
doc/DATA_SPEC.md
View File

@@ -2,37 +2,78 @@
## 1. 数据原则
1. 优先复用 MES 现有过站数据、Pack 数据、产品型号数据和工艺参数数据。
2. 前端不自行推测业务状态，复杂口径优先由存储过程统一计算。
3. 存储过程和字段名称在确认数据来源后再最终固化。
4. 当前文档只定义查询能力和口径，不编写数据库 DDL。
1. 当前版本全部使用前端硬编码虚拟数据。
2. 暂不接入数据库，暂不调用 MES 存储过程。
3. 业务状态可以先由前端根据虚拟数据计算。
4. 文档保留后续真实数据接入所需口径，但不写数据库 DDL。
## 2. 核心口径
## 2. 虚拟数据结构建议
当前建议在 Vue 文件中定义本地变量，例如：
```js
const standardRestMinutes = 30
const mockPacks = [
{
packCode: 'PACK202606290001',
productModel: 'PDC',
op410FinishTime: '2026-06-29 08:10:00',
op505FinishTime: '',
currentStation: 'OP460',
stationStatus: {
OP420: 'PASS',
OP430: 'PASS',
OP440: 'PASS',
OP450: 'PASS',
OP460: 'CURRENT',
OP470: 'WAIT',
OP480: 'WAIT',
OP490: 'WAIT',
OP500: 'WAIT'
}
}
]
```
虚拟数据需要覆盖：
- 未满 30 分钟的上层静置 Pack。
- 未满 30 分钟的下层静置 Pack。
- 已满 30 分钟但 OP505 未出站的 Pack。
- 已完成 OP505 出站的 Pack。
- 过站缺失或顺序异常的 Pack。
## 3. 核心口径
| 指标 | 口径 |
| --- | --- |
| 静置开始 | Pack 在 OP410 的有效过站时间 |
| 静置结束 | Pack 在下层静置结束工位的有效过站时间 |
| 当前静置数 | 存在静置开始时间，且不存在静置结束时间的 Pack 数 |
| 静置中数量 | 当前静置数中，当前时间 - 静置开始时间 < 标准静置时长 |
| 满足静置时间数 | 当前静置数中，当前时间 - 静置开始时间 >= 标准静置时长 |
| 超时数量 | 当前静置数中，当前时间 - 静置开始时间 > 标准静置时长 + 超时阈值 |
| 今日开始静置数 | OP410 过站时间属于今日的 Pack 数 |
| 今日静置完成数 | 静置结束时间属于今日的 Pack 数 |
| 静置开始 | Pack 在 OP410 的完工时间 |
| 下层静置开始 | Pack 在 OP500 的完工时间 |
| 静置结束 | Pack 在 OP505 的完工时间 |
| 标准静置时间 | 30 分钟 |
| 达标时间 | OP410 完工时间 + 30 分钟 |
| 当前静置数 | 存在 OP410 完工时间，且不存在 OP505 完工时间的 Pack 数 |
| 未满 30 分钟数量 | 当前静置数中，当前时间 - OP410 完工时间 < 30 分钟 |
| 已满 30 分钟待出站数量 | 当前静置数中，当前时间 - OP410 完工时间 >= 30 分钟 |
| 今日开始静置数 | OP410 完工时间属于今日的 Pack 数 |
| 今日静置完成数 | OP505 完工时间属于今日的 Pack 数 |
| 达标后等待时长 | 当前时间 - 达标时间 |
## 3. 工位过站矩阵
## 4. 工位过站矩阵
表头工位：
- 42。
- 43。
- 44。
- 45。
- 46。
- 47。
- 48。
- 49。
- 50。
表头短码与工位对应关系：
| 短码 | 工位 | 名称 | 是否必过 |
| --- | --- | --- | --- |
| 42 | OP420 | 极柱紧固 | 是 |
| 43 | OP430 | 密封盖装配 | 是 |
| 44 | OP440 | 密封盖紧固1 | 是 |
| 45 | OP450 | 密封盖紧固2 | 是 |
| 46 | OP460 | EOL测试 | 是 |
| 47 | OP470 | DCR测试 | 是 |
| 48 | OP480 | 警告标签粘贴 | 是 |
| 49 | OP490 | 标签打印粘贴 | 是 |
| 50 | OP500 | 密封盖安装确认 | 是 |
每个工位返回状态建议：
@@ -43,135 +84,47 @@
| WAIT | 未过站 |
| ERROR | 应过未过、顺序异常或数据异常 |
## 4. 线体段映射
OP505 常温静置是静置结束出站工位，不属于 42-50 矩阵，但可以在主表中单独展示出站状态。
## 5. 线体段映射
当前建议分段如下，后续以现场设备命名为准：
| 段编码 | 段名称 | 映射规则 |
| --- | --- | --- |
| S1 | OP410 入静置段 | 已过 OP410，未过 42 |
| S2 | 42-44 段 | 最近过站在 42、43、44 |
| S3 | 45-47 段 | 最近过站在 45、46、47 |
| S4 | 48-50 段 | 最近过站在 48、49、50 |
| S5 | 下层静置结束待确认段 | 已过 50，未过静置结束工位 |
| S1 | 上层静置 | 已完成 OP410，未完成 OP500 |
| S2 | 下层静置 | 已完成 OP500，未完成 OP505 |
| S3 | 已满 30 分钟待出站 | 已满 30 分钟，未完成 OP505 |
| S4 | 已出站 | 已完成 OP505 |
| S5 | 过程异常 | 工位缺失、顺序异常或数据异常 |
## 5. 建议查询能力
## 6. 本地计算字段
### 5.1 静置看板_汇总查询
建议前端根据虚拟数据计算：
用途：顶部指标和当班统计。
| 字段 | 计算方式 |
| --- | --- |
| restMinutes | 当前时间 - OP410 完工时间 |
| targetFinishTime | OP410 完工时间 + 30 分钟 |
| remainMinutes | 30 - restMinutes，最小为 0 |
| waitAfterTargetMinutes | restMinutes - 30，最小为 0 |
| isTargetReached | restMinutes >= 30 |
| isFinished | 存在 OP505 完工时间 |
| currentStage | 根据 OP500、OP505 完工情况判断上层/下层/已出站 |
建议返回字段：
- 当前静置数。
- 满足静置时间数。
- 静置中数量。
- 超时数量。
- 今日开始静置数。
- 今日静置完成数。
- 当班开始静置数。
- 当班静置完成数。
- 平均静置时长。
- 平均达标后等待时长。
- 静置完成率。
## 7. 后续真实数据接入建议
### 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. 班次时间边界。
1. 静置看板_汇总查询。
2. 静置看板_静置Pack列表查询。
3. 静置看板_待出站清单查询。
4. 静置看板_异常清单查询。
5. 静置看板_小时JPH查询。
## 8. 关联文档
- [PRD.md](./PRD.md)
- [BUSINESS_RULES.md](./BUSINESS_RULES.md)
- [UI_SPEC.md](./UI_SPEC.md)
- [TODO.md](./TODO.md)