# 仓库大屏看板规划方案

## 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 下无文字重叠、无表格溢出。
- 数据刷新后图表和明细同步更新。

