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

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)
+

doc/PRD.md

@@ -0,0 +1,129 @@
+# 静置库大屏看板 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)
+

doc/README.md

@@ -0,0 +1,47 @@
+# 静置库大屏看板文档
+
+## 项目简介
+
+静置库大屏看板用于展示智柔宁德二线 Pack 静置过程状态，重点关注当前静置数量、已达标待流转数量、超时异常、工位过站状态、线体段滞留和今日入出静置节拍。
+
+## 项目范围
+
+- 看板对象：智柔宁德二线静置过程。
+- 静置起点：OP410 有效过站。
+- 静置终点：下层静置结束对应工位，有待业务确认。
+- 新线约束：不按老线库区、库位、层数展示。
+- 当前阶段：先完成内容规划和页面信息结构，后续再细化图表样式、数据接口和存储过程。
+
+## 技术栈
+
+| 类型 | 选型 |
+| --- | --- |
+| 前端框架 | Vue 3 |
+| 构建工具 | Vite |
+| 图表 | ECharts |
+| 大屏组件 | @kjgl77/datav-vue3 |
+| UI 组件 | Element Plus、TDesign Vue Next |
+| 状态管理 | Pinia |
+| 接口方式 | CreateData / ExecDatabase 调用 MES 存储过程 |
+
+## 文档索引
+
+| 文档 | 说明 |
+| --- | --- |
+| [PRD.md](./PRD.md) | 产品需求与业务目标 |
+| [UI_SPEC.md](./UI_SPEC.md) | 大屏页面内容与布局规划 |
+| [DATA_SPEC.md](./DATA_SPEC.md) | 数据口径与接口能力规划 |
+| [TODO.md](./TODO.md) | 后续开发任务清单 |
+
+## 参考资料
+
+- [参考看板图片 但新线无库位号一说.png](./参考看板图片%20但新线无库位号一说.png)
+
+## 关键待确认项
+
+1. “下层静置结束”对应的准确工位号。
+2. 产品型号对应标准静置时长的数据来源。
+3. 超时阈值定义。
+4. 42-50 是否全部属于静置过程必过工位。
+5. 班次边界是否需要纳入统计。
+

doc/TODO.md

@@ -0,0 +1,62 @@
+# 静置库大屏看板开发任务清单
+
+## A. 业务确认
+
+- [ ] A1 确认下层静置结束工位号。
+- [ ] A2 确认 42-50 是否全部属于必过工位。
+- [ ] A3 确认标准静置时长来源。
+- [ ] A4 确认超时阈值定义。
+- [ ] A5 确认是否需要班次统计及班次时间。
+
+## B. 数据查询
+
+- [ ] B1 梳理 Pack 过站数据来源。
+- [ ] B2 编写或复用静置汇总查询。
+- [ ] B3 编写或复用静置 Pack 列表查询。
+- [ ] B4 编写或复用工位过站矩阵查询。
+- [ ] B5 编写或复用待流转清单查询。
+- [ ] B6 编写或复用异常清单查询。
+- [ ] B7 编写或复用线体段滞留查询。
+- [ ] B8 编写或复用小时 JPH 查询。
+
+## C. 前端页面改造
+
+- [ ] C1 将现有生产追溯标题和模块替换为静置库看板内容。
+- [ ] C2 改造顶部 6 个指标卡。
+- [ ] C3 实现静置中 Pack 主表。
+- [ ] C4 实现 42-50 工位过站灯。
+- [ ] C5 实现待流转清单。
+- [ ] C6 实现超时/异常清单。
+- [ ] C7 实现线体段滞留图。
+- [ ] C8 实现今日小时 JPH 图表。
+- [ ] C9 调整左侧当前入静置/出静置信息。
+
+## D. 联调验证
+
+- [ ] D1 用测试数据验证静置开始口径。
+- [ ] D2 用测试数据验证静置结束口径。
+- [ ] D3 验证已达标、静置中、超时状态判断。
+- [ ] D4 验证 42-50 工位灯显示。
+- [ ] D5 验证空数据场景。
+- [ ] D6 验证接口失败时页面不崩溃。
+- [ ] D7 验证 1920x1080 大屏显示无明显重叠。
+
+## E. 交付准备
+
+- [ ] E1 补充最终存储过程字段说明。
+- [ ] E2 更新 README 文档索引。
+- [ ] E3 提交 Git 版本。
+- [ ] E4 部署到目标大屏环境验证。
+
+## 任务索引
+
+| 分组 | 数量 |
+| --- | ---: |
+| A. 业务确认 | 5 |
+| B. 数据查询 | 8 |
+| C. 前端页面改造 | 9 |
+| D. 联调验证 | 7 |
+| E. 交付准备 | 4 |
+
+总任务数：33。
+

doc/UI_SPEC.md

@@ -0,0 +1,150 @@
+# 静置库大屏看板 UI 规划
+
+## 1. 设计原则
+
+1. 过程优先：新线不展示库位，以 Pack 静置状态和工位过站过程为主。
+2. 异常前置：超时、已达标待流转、过站缺失必须优先可见。
+3. 信息密度适中：大屏用于远距离浏览，不堆叠过多小字。
+4. 图表服务业务：每个图表必须回答一个现场问题。
+
+## 2. 页面结构
+
+```text
+--------------------------------------------------------------------------------+
+| Logo                   静置库大屏看板                    日期 / 时间 / 刷新状态 |
++--------------------------------------------------------------------------------+
+| 当前静置数 | 满足静置时间数 | 静置中数量 | 超时数量 | 今日开始 | 今日完成        |
++--------------------------------------------------------------------------------+
+| 左侧概览区          | 中心主区：静置中 Pack 列表 + 工位过站灯 | 右侧监控区       |
+| - 当班统计          | Pack码 产品型号 开始时间 时长 状态 42-50 | - 待流转清单     |
+| - 当前入静置 Pack   |                                        | - 超时异常清单   |
+| - 当前出静置 Pack   |                                        | - 线体段滞留     |
++--------------------------------------------------------------------------------+
+| 今日小时 JPH：开始静置 / 静置结束 / 净增        | 静置异常明细或过站矩阵补充 |
++--------------------------------------------------------------------------------+
+```
+
+## 3. 顶部指标条
+
+建议使用 6 个指标卡：
+
+| 指标 | 颜色建议 | 说明 |
+| --- | --- | --- |
+| 当前静置数 | 蓝色 | 当前池子总压力 |
+| 满足静置时间数 | 绿色 | 可优先流转 |
+| 静置中数量 | 青色 | 未达到标准时间 |
+| 超时数量 | 红色 | 需要现场关注 |
+| 今日开始静置数 | 蓝紫色 | 今日入口 |
+| 今日静置完成数 | 金色 | 今日出口 |
+
+## 4. 中心主表
+
+中心主表是首页核心区域，建议使用滚动表格。
+
+字段规划：
+
+| 字段 | 展示方式 |
+| --- | --- |
+| 序号 | 2 位序号 |
+| Pack 码 | 主字段，超长省略 |
+| 产品型号 | 文本 |
+| 静置开始时间 | 月日 时分 |
+| 当前静置时长 | 数字 + 单位 |
+| 标准静置时长 | 数字 + 单位 |
+| 剩余/超时时长 | 正常显示剩余，超时显示红色 |
+| 状态 | 标签：静置中、已达标、超时、异常 |
+| 当前所在段 | 文本标签 |
+| 42-50 | 灯点矩阵 |
+
+工位灯规则：
+
+| 状态 | 颜色 | 含义 |
+| --- | --- | --- |
+| 已过站 | 绿色 | Pack 已完成该工位 |
+| 当前最新过站 | 蓝色 | Pack 最近一次过站位置 |
+| 未过站 | 灰色 | Pack 尚未经过该工位 |
+| 异常 | 红色 | 应过未过、顺序异常或数据异常 |
+
+## 5. 左侧概览区
+
+### 5.1 当班统计
+
+建议展示：
+- 当班开始静置数。
+- 当班静置完成数。
+- 平均静置时长。
+- 平均达标后等待时长。
+- 超时 Pack 数。
+- 静置完成率。
+
+### 5.2 当前入静置 Pack
+
+显示最近进入 OP410 的 Pack：
+- Pack 码。
+- 产品型号。
+- OP410 过站时间。
+- 当前静置时长。
+
+### 5.3 当前出静置 Pack
+
+显示最近完成下层静置结束的 Pack：
+- Pack 码。
+- 产品型号。
+- 静置结束时间。
+- 总静置时长。
+
+## 6. 右侧监控区
+
+### 6.1 满足静置待流转清单
+
+用于提醒现场优先处理。
+
+字段：
+- Pack 码。
+- 达标时间。
+- 达标后等待时长。
+- 当前所在段。
+
+### 6.2 超时/异常清单
+
+异常类型：
+- 静置超时。
+- 过站缺失。
+- 过站顺序异常。
+- 数据缺失。
+
+### 6.3 线体段滞留
+
+建议使用横向条形图或过程流转图，不使用库位矩阵。
+
+分段：
+- OP410 入静置段。
+- 42-44 段。
+- 45-47 段。
+- 48-50 段。
+- 下层静置结束待确认段。
+
+## 7. 底部趋势区
+
+### 今日 JPH
+
+建议使用双柱状图：
+- 开始静置数量。
+- 静置结束数量。
+
+可选增加净增折线：
+- 净增 = 开始静置数量 - 静置结束数量。
+
+## 8. 视觉参考
+
+可参考老线图片的大屏蓝色工业风、顶部指标、滚动表格和 JPH 图表表现，但不复用库位矩阵、库区、层数、强制入库/出库操作区域。
+
+参考图：
+- [参考看板图片 但新线无库位号一说.png](./参考看板图片%20但新线无库位号一说.png)
+
+## 9. 关联文档
+
+- [PRD.md](./PRD.md)
+- [DATA_SPEC.md](./DATA_SPEC.md)
+- [TODO.md](./TODO.md)
+