feat: add warehouse dashboard

work/仓库大屏规划/仓库大屏看板规划方案.md

@@ -0,0 +1,269 @@
+# 仓库大屏看板规划方案
+
+## 1. 目标定位
+
+仓库大屏用于展示仓库当前待处理任务压力、超期风险和发货保障情况。页面应优先显示汇总指标和趋势/结构图表，只有在空间允许时展示明细列表。
+
+核心原则：
+
+- 优先汇总：首屏先看总量、异常、加急、超期。
+- 图表优先：能用柱状图、环图、排行图表达的，不优先放大表格。
+- 明细兜底：明细只展示风险最高或最需要处理的少量记录。
+- 按仓库作业链路组织：入库、上架、拣配出库、销售发货。
+
+## 2. 数据范围
+
+文档 `doc/仓库大屏数据.docx` 中涉及的数据源来自 `SAP.SBO_YL.dbo` 下的仓库大屏视图。
+
+### 2.1 入库
+
+| 数据源 | 业务含义 | 建议用途 |
+|---|---|---|
+| `UBT_MES_DP_receipttask_101` | 已质检、未入库汇总-装配件 | 入库分类汇总、加急占比 |
+| `UBT_MES_DP_receipttask_103` | 已质检、未入库汇总-机加件 | 入库分类汇总、加急占比 |
+| `UBT_MES_DP_receipttask_105` | 已质检、未入库汇总-原材料 | 入库分类汇总、加急占比 |
+| `UBT_MES_DP_receipttask_106` | 已质检、未入库汇总-外购件 | 入库分类汇总、加急占比 |
+| `UBT_MES_DP_receipttask_material_101` | 已质检、未入库明细-装配件 | 明细兜底 |
+| `UBT_MES_DP_receipttask_material_103` | 已质检、未入库明细-机加件 | 明细兜底 |
+| `UBT_MES_DP_receipttask_material_105` | 已质检、未入库明细-原材料 | 明细兜底 |
+| `UBT_MES_DP_receipttask_material_106` | 已质检、未入库明细-外购件 | 明细兜底 |
+| `UBT_MES_DP_receipttask_material_2Days` | 超过 2 天未入库任务 | 重点风险指标、超期明细 |
+
+### 2.2 上架
+
+| 数据源 | 业务含义 | 建议用途 |
+|---|---|---|
+| `UBT_MES_DP_inventory_2Days` | 超过 2 天未上架物料 | 重点风险指标、库位/物料排行 |
+
+### 2.3 拣配与出库
+
+| 数据源 | 业务含义 | 建议用途 |
+|---|---|---|
+| `UBT_MES_DP_OpenOPKL_101` | 未清拣配汇总-装配件 | 拣配分类汇总 |
+| `UBT_MES_DP_OpenOPKL_103` | 未清拣配汇总-机加件 | 拣配分类汇总 |
+| `UBT_MES_DP_OpenOPKL_material_101` | 未清拣配明细-装配件 | 明细兜底 |
+| `UBT_MES_DP_OpenOPKL_material_103` | 未清拣配明细-机加件 | 明细兜底 |
+| `UBT_MES_DP_OpenOPKL_material_10Days` | 超过 10 天未出库拣配任务 | 重点风险指标、超期明细 |
+| `UBT_MES_DP_ubt_wm_issuetask_material_OPKL` | 拣配任务已清、汇报未清 | 异常闭环指标、明细兜底 |
+
+### 2.4 销售发货
+
+| 数据源 | 业务含义 | 建议用途 |
+|---|---|---|
+| `UBT_MES_DP_OpenODLN_material` | 销售交货未清任务 | 发货未清总量、加急总量 |
+| `UBT_MES_DP_OpenODLN_material_ToDay` | 发货日期小于等于今天的及时发货任务 | 今日应发、今日加急 |
+
+## 3. 当前数据体量参考
+
+以下为规划时的数据库抽样统计结果，用于判断展示优先级。实际看板应实时查询。
+
+| 指标 | 行数 | 数量 | 加急数量 |
+|---|---:|---:|---:|
+| 入库汇总-装配件 | 31 | 898 | 0 |
+| 入库汇总-机加件 | 65 | 4448 | 11061 |
+| 入库汇总-原材料 | 10 | 4177 | 1584 |
+| 入库汇总-外购件 | 47 | 2521 | 21 |
+| 超过 2 天未入库 | 345 | 135030 | 21795 |
+| 超过 2 天未上架 | 526 | 2994729.774 | - |
+| 拣配汇总-装配件 | 414 | 284748 | 2185 |
+| 拣配汇总-机加件 | 17 | 18144 | 0 |
+| 超过 10 天未出库拣配 | 239 | 71972 | 86 |
+| 拣配已清、汇报未清 | 20 | 10286 | 9000 |
+| 销售交货未清 | 10 | 27 | 144 |
+| 今日应发 | 9 | 21 | 19 |
+
+## 4. 首屏布局建议
+
+建议按 1920 x 1080 设计。
+
+### 4.1 顶部：全局汇总 KPI
+
+顶部放 8 个指标卡，作为进入页面第一眼看到的仓库压力总览。
+
+| 指标卡 | 口径 | 颜色建议 |
+|---|---|---|
+| 待入库任务 | 四类入库汇总行数或未入库数量合计 | 蓝色 |
+| 入库加急 | 四类入库汇总加急数量合计 | 红色 |
+| 超 2 天未入库 | `UBT_MES_DP_receipttask_material_2Days` 行数/数量 | 橙色 |
+| 超 2 天未上架 | `UBT_MES_DP_inventory_2Days` 行数/库存 | 橙色 |
+| 未清拣配 | 装配件 + 机加件拣配汇总 | 蓝色 |
+| 超 10 天未出库 | `UBT_MES_DP_OpenOPKL_material_10Days` | 红色 |
+| 汇报未清 | `UBT_MES_DP_ubt_wm_issuetask_material_OPKL` | 红色 |
+| 今日应发 | `UBT_MES_DP_OpenODLN_material_ToDay` | 绿色/红色按加急占比 |
+
+### 4.2 中部：四个主图表
+
+中部占页面主要区域，优先用图表表达。
+
+1. 入库任务结构图
+   - 图表：分组柱状图
+   - X 轴：装配件、机加件、原材料、外购件
+   - Y 轴：未入库数量
+   - 系列：总数量、加急数量
+   - 价值：快速看哪类入库压力最大，加急压力集中在哪类。
+
+2. 拣配任务结构图
+   - 图表：分组柱状图
+   - X 轴：装配件、机加件
+   - Y 轴：计划数量/任务数
+   - 系列：总数量、加急数量
+   - 价值：对比装配和机加出库准备压力。
+
+3. 超期风险雷达/环图
+   - 图表：环图或玫瑰图
+   - 维度：超 2 天未入库、超 2 天未上架、超 10 天未出库、汇报未清、今日应发加急
+   - 指标：行数或数量
+   - 价值：把风险事项集中到一个区域，突出处理优先级。
+
+4. 今日发货保障图
+   - 图表：仪表盘 + 小柱状图
+   - 指标：今日应发数量、今日应发加急数量、销售交货未清数量
+   - 价值：突出当天必须处理的发货任务。
+
+### 4.3 底部：风险明细区
+
+底部只保留 2 到 3 个高优先级明细表，每个表显示 5 到 8 行，自动滚动，但不重复补齐。
+
+建议明细优先级：
+
+1. 超 2 天未入库明细
+   - 数据源：`UBT_MES_DP_receipttask_material_2Days`
+   - 字段：单据日期、订单号、物料编码、物料名称、未入库数量、加急数量
+
+2. 超 10 天未出库拣配明细
+   - 数据源：`UBT_MES_DP_OpenOPKL_material_10Days`
+   - 字段：拣配清单号、拣配日期、生产订单号、物料编码、物料描述、计划数量、加急数量、行状态
+
+3. 今日应发明细
+   - 数据源：`UBT_MES_DP_OpenODLN_material_ToDay`
+   - 字段：发货日期、客户、订单号、物料编码、物料名称、未清数量、加急数量
+
+如果屏幕空间不足，只保留前两个风险明细；今日应发用图表表达。
+
+## 5. 推荐页面线框
+
+```text
+┌────────────────────────────────────────────────────────────────────────────┐
+│ 仓库任务大屏                         当前时间 / 数据刷新时间              │
+├──────────┬──────────┬──────────┬──────────┬──────────┬──────────┬────────┤
+│待入库任务│入库加急  │超2天未入库│超2天未上架│未清拣配  │超10天出库│今日应发│
+├──────────────────────────────┬─────────────────────────────────────────────┤
+│ 入库任务结构图               │ 拣配任务结构图                              │
+│ 分组柱状：总量/加急           │ 分组柱状：装配件/机加件，总量/加急           │
+├──────────────────────────────┼─────────────────────────────────────────────┤
+│ 超期风险环图/玫瑰图           │ 今日发货保障图                              │
+│ 入库超期/上架超期/出库超期     │ 今日应发、今日加急、销售交货未清             │
+├──────────────────────────────┴─────────────────────────────────────────────┤
+│ 明细区：超2天未入库 / 超10天未出库 / 今日应发（按空间展示 2-3 个表）        │
+└────────────────────────────────────────────────────────────────────────────┘
+```
+
+## 6. 图表与指标映射
+
+### 6.1 入库任务结构
+
+| 分类 | 汇总视图 | 明细视图 |
+|---|---|---|
+| 装配件 | `UBT_MES_DP_receipttask_101` | `UBT_MES_DP_receipttask_material_101` |
+| 机加件 | `UBT_MES_DP_receipttask_103` | `UBT_MES_DP_receipttask_material_103` |
+| 原材料 | `UBT_MES_DP_receipttask_105` | `UBT_MES_DP_receipttask_material_105` |
+| 外购件 | `UBT_MES_DP_receipttask_106` | `UBT_MES_DP_receipttask_material_106` |
+
+建议统计：
+
+- 任务行数：`COUNT(*)`
+- 未入库数量：汇总视图用 `SUM(总计未入库数)`，明细视图用 `SUM(open_quantity)`
+- 加急数量：`SUM(加急数量)`
+
+### 6.2 超期任务
+
+| 指标 | 数据源 | 建议图表 |
+|---|---|---|
+| 超 2 天未入库 | `UBT_MES_DP_receipttask_material_2Days` | KPI + 明细表 |
+| 超 2 天未上架 | `UBT_MES_DP_inventory_2Days` | KPI + 物料/库位排行 |
+| 超 10 天未出库 | `UBT_MES_DP_OpenOPKL_material_10Days` | KPI + 明细表 |
+
+### 6.3 拣配出库
+
+| 分类 | 汇总视图 | 明细视图 |
+|---|---|---|
+| 装配件 | `UBT_MES_DP_OpenOPKL_101` | `UBT_MES_DP_OpenOPKL_material_101` |
+| 机加件 | `UBT_MES_DP_OpenOPKL_103` | `UBT_MES_DP_OpenOPKL_material_103` |
+
+建议统计：
+
+- 未清拣配任务：`COUNT(*)`
+- 未清拣配数量：`SUM(计划数量)`
+- 加急拣配数量：`SUM(加急数量)`
+
+### 6.4 销售发货
+
+| 指标 | 数据源 | 建议展示 |
+|---|---|---|
+| 销售交货未清 | `UBT_MES_DP_OpenODLN_material` | KPI + 小表 |
+| 今日应发 | `UBT_MES_DP_OpenODLN_material_ToDay` | KPI + 仪表盘 |
+
+建议统计：
+
+- 未清数量：`SUM(open_quantity)`
+- 加急数量：`SUM(加急数量)`
+- 今日应发任务：`COUNT(*)`
+
+## 7. 数据刷新与交互
+
+建议：
+
+- 自动刷新：5 分钟一次。
+- 大屏不做复杂筛选，只保留数据刷新时间。
+- 明细自动滚动，但查询出几条显示几条，不做重复补齐。
+- 加急、超期用红色；普通待处理用蓝色；正常今日应发用绿色。
+
+## 8. 实施建议
+
+### 8.1 后端/数据层
+
+建议新增一个统一查询入口，避免前端直接拼多个跨库视图。
+
+建议过程：
+
+- `仓库大屏_汇总查询`
+- `仓库大屏_入库超期明细`
+- `仓库大屏_出库超期明细`
+- `仓库大屏_今日应发明细`
+
+如果短期先做前端，也可以直接通过 `CreateData('11', 过程名/视图包装过程, 参数)` 调用多个接口，但建议最终收敛为存储过程，降低前端计算复杂度。
+
+### 8.2 前端页面
+
+建议新增页面：
+
+- 文件：`src/views/WarehouseDashboard.vue`
+- 路由名称：`WarehouseDashboard`
+- 图表库：继续使用项目现有 `echarts`
+
+页面组件结构：
+
+- 顶部 KPI：`summaryCards`
+- 入库结构图：`inboundChart`
+- 拣配结构图：`pickingChart`
+- 风险环图：`riskChart`
+- 今日发货图：`deliveryChart`
+- 明细表：`riskTables`
+
+### 8.3 开发顺序
+
+1. 先实现汇总接口或视图包装过程。
+2. 实现顶部 KPI 和四个主图表。
+3. 接入 2 个风险明细表。
+4. 根据真实屏幕效果决定是否增加第三个明细表。
+5. 做字体、行高、滚动和适配调优。
+
+## 9. 验收标准
+
+- 首屏优先展示汇总和图表，明细不占据主要视觉区域。
+- 入库、上架、拣配、发货四条链路都有可见指标。
+- 加急和超期任务有明显红色/橙色强调。
+- 明细列表不重复补齐，查询几条显示几条。
+- 页面在 1920 x 1080 下无文字重叠、无表格溢出。
+- 数据刷新后图表和明细同步更新。
+