管理驾驶舱与统计分析模块

1. 模块概述

对应招标需求书第 12 条：**整合生产、质检、库存、出库、追溯五大维度核心指标，提供可视化图表展示，支持 Excel/PDF 格式报表导出和打印存档。**

五大维度：
生产：生产批次、袋码（一袋一码）、托盘码、今日扫码入库袋数、生产趋势；
质检：种子四项指标（纯度/净度/发芽率/水分）检验结果分布、均值与合格率；
库存：按仓库/品种/库存状态（暂存库/合格库/已出库）分布、低库存预警数；
出库：出库按日趋势、按经销商出库 TOP20；
追溯：消费者扫码趋势、省份分布、渠道分布、窜货预警汇总。
导出能力：
Excel：后端 EasyExcel（fastexcel）生成多 sheet 工作簿，共 6 个 sheet（驾驶舱总览 / 生产统计 / 质检统计 / 库存统计 / 出库统计 / 追溯统计）；
PDF：前端 html2canvas + jspdf 将驾驶舱报表区域生成为可直接下载的 PDF 文件；
打印：前端 vue3-print-nb 打印报表区域用于存档。

2. 数据源要求（重要）

种子业务数据表位于 mom-thzy 库（含生产批次 mes_pro_batch、袋码 mes_pro_bag_code、托盘 mes_pro_pallet、种子质检 mes_qc_seed_quality、扫码事件 mes_trace_consumer_scan_event 等全部业务表）。

✅ 已处理：yudao-server/src/main/resources/application-local.yaml 主数据源已指回 jdbc:mysql://192.168.197.128:3306/mom-thzy（root / sugaozhixing.cn）。驾驶舱及一袋一码等种子业务功能**必须连接 mom-thzy 库**才能正常统计，请勿再切回 ruoyi-vue-pro（该库不含种子业务表）。

若目标库缺少种子业务表，需先执行 sql/mysql/ 下的初始化脚本：
- mes_pro_batch_bag_code_init.sql（生产批次/袋码/托盘）
- mes_seed_quality_init.sql（种子质检）
- mes_trace_consumer_scan_event.sql（消费者扫码事件）
- mes_trace_anti_cross_region_init.sql（窜货预警）
- mes_pro_scan_inbound_init.sql（生产线扫码入库）

3. 后端实现

后端位于 yudao-module-mes，新增包：

文件	说明
`controller/admin/dashboard/MesDashboardController.java`	`/mes/dashboard` 统计接口 + Excel 多 sheet 导出
`controller/admin/dashboard/vo/*.java`	统计响应 VO 与 Excel 导出 VO
`service/dashboard/MesDashboardService(.java\|Impl)`	五维度统计聚合（含按日补零）
`dal/mysql/dashboard/MesDashboardMapper.java`	MyBatis Mapper 接口
`resources/mapper/dashboard/MesDashboardMapper.xml`	手写统计 SQL

接口清单（权限 mes:dashboard:query / mes:dashboard:export）：

接口	说明
`GET /mes/dashboard/summary`	五维度 KPI 汇总
`GET /mes/dashboard/production-trend?days=`	生产趋势
`GET /mes/dashboard/quality-statistics`	质检维度统计
`GET /mes/dashboard/inventory-statistics`	库存维度统计
`GET /mes/dashboard/outbound-statistics?days=`	出库维度统计
`GET /mes/dashboard/trace-statistics?days=`	追溯维度统计（复用扫码统计与窜货预警服务）
`GET /mes/dashboard/export-excel`	Excel 多 sheet 报表导出

设计要点：
- 追溯维度**复用** MesTraceConsumerScanStatisticsService、MesTraceCrossRegionService，避免重复 SQL；
- 库存低预警数**复用** MesWmStockWarningService.getCurrentWarnings()；
- 空数据表（如质检/库存/出库尚无数据）返回 0 或空数组，前端图表正常渲染；Excel 导出空 sheet 自动补「暂无数据」行，保证表头可推断。

4. 前端实现

前端位于 mom-pro2-before，新增：

文件	说明
`src/api/mes/management-cockpit/index.ts`	驾驶舱 API（`requestClient`）
`src/views/management-cockpit/index.vue`	驾驶舱主页面（工具栏 + 报表区域）
`src/views/management-cockpit/chart-options.ts`	ECharts 配置工厂
`src/views/management-cockpit/modules/*.vue`	KPI 卡 + 生产/质检/库存/出库/追溯图表组件

页面能力：
- 刷新：整体刷新全部维度数据；
- 导出 Excel：requestClient.download 下载后端多 sheet 工作簿；
- 导出 PDF：html2canvas 截取报表区域 + jspdf 生成可下载 PDF；
- 打印：vue3-print-nb 打印报表区域，用于存档。

新增依赖（根 package.json）：html2canvas、jspdf。

5. 菜单与权限

执行 sql/mysql/mes_dashboard_module_init.sql（幂等）注册：

顶级目录「统计分析」（id=602700，已存在时复用）；
页面「管理驾驶舱」（id=602701，component = management-cockpit/index）；
按钮权限 mes:dashboard:query、mes:dashboard:export。

菜单由后端 system_menu 动态下发，前端 component 字段映射到 src/views/management-cockpit/index.vue。

6. 验证

后端编译：mvn compile -pl yudao-module-mes -am -q
前端类型检查：pnpm typecheck（本次新增文件无类型错误）
执行 mes_dashboard_module_init.sql 后登录系统，菜单出现「统计分析 → 管理驾驶舱」
核对五大维度图表数据与 mom-thzy 库实际数据一致
分别验证 Excel 下载、PDF 下载、打印三个功能