吴羡
66 分钟以前 3d416372d21acb1a554e4e3eb96e2f9dead6d5a4
feat(mes): 新增数据采集设备接入、记录、看板与统计(需求6系统侧)
已添加37个文件
已修改13个文件
13145 ■■■■■ 文件已修改
docs/mes_dc_frontend_integration.md 175 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/README.md 9 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/data/business.json 13 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/data/flows.json 12 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/data/modules.json 8 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/data/objects.json 4 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/data/roles.json 1 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/index.html 99 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/mermaid/01-business-mindmap.mmd 6 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/mermaid/08-module-relation.mmd 3 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/mermaid/09-data-flow.mmd 12 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/mermaid/10-business-object.mmd 4 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/sql/config_export_all_20261110.sql 10170 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
sql/mysql/mes_dc_init_20261110.sql 218 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/device/MesDcDeviceController.java 128 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/device/vo/MesDcDeviceBindWorkOrderReqVO.java 19 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/device/vo/MesDcDeviceCreateRespVO.java 20 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/device/vo/MesDcDevicePageReqVO.java 33 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/device/vo/MesDcDeviceRespVO.java 66 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/device/vo/MesDcDeviceSaveReqVO.java 51 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/open/MesDcOpenController.java 62 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/open/vo/MesDcHeartbeatReqVO.java 25 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/open/vo/MesDcHeartbeatRespVO.java 27 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/open/vo/MesDcIngestReqVO.java 50 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/open/vo/MesDcIngestRespVO.java 31 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/record/MesDcRecordController.java 110 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/record/vo/MesDcRecordCancelReqVO.java 22 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/record/vo/MesDcRecordCorrectReqVO.java 28 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/record/vo/MesDcRecordPageReqVO.java 49 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/record/vo/MesDcRecordRespVO.java 109 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/statistics/MesDcStatisticsController.java 55 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/statistics/vo/MesDcDeviceOverviewRespVO.java 46 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/statistics/vo/MesDcStatisticsDeviceItemVO.java 30 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/statistics/vo/MesDcStatisticsReqVO.java 32 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/statistics/vo/MesDcStatisticsSummaryRespVO.java 28 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/statistics/vo/MesDcStatisticsTrendItemVO.java 24 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/dal/dataobject/dc/device/MesDcDeviceDO.java 100 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/dal/dataobject/dc/record/MesDcRecordDO.java 129 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/dal/mysql/dc/device/MesDcDeviceMapper.java 41 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/dal/mysql/dc/record/MesDcRecordMapper.java 129 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/enums/DictTypeConstants.java 5 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/enums/ErrorCodeConstants.java 20 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/enums/dc/MesDcDeviceStatusEnum.java 38 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/enums/dc/MesDcRecordStatusEnum.java 39 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/dc/device/MesDcDeviceService.java 114 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/dc/device/MesDcDeviceServiceImpl.java 227 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/dc/record/MesDcRecordService.java 59 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/dc/record/MesDcRecordServiceImpl.java 277 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/dc/statistics/MesDcStatisticsService.java 40 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/dc/statistics/MesDcStatisticsServiceImpl.java 148 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/mes_dc_frontend_integration.md
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,175 @@
# MES æ•°æ®é‡‡é›†ï¼ˆé¸¡çˆªè®¡æ•°è®¾å¤‡ï¼‰å‰ç«¯è”调方案
> éœ€æ±‚6:鸡爪自动计数/称重设备接入 MOM。第一阶段只做「采集 â†’ å±•示 â†’ ç»Ÿè®¡ã€ï¼Œä¸è‡ªåŠ¨å›žå†™ç”Ÿäº§æŠ¥å·¥æˆ–åŒ…è£…ã€‚
> çŽ°åœºè®¾å¤‡æŽ¥çº¿ä¸Žç½‘å…³ç”±çŽ°åœºåŒäº‹è´Ÿè´£ï¼Œç³»ç»Ÿä¾§æä¾› HTTP JSON ä¸ŠæŠ¥æŽ¥å£ + ç®¡ç†ç«¯é¡µé¢ã€‚
## æ¶‰åŠé¡µé¢
- ç”Ÿäº§ç®¡æŽ§ â†’ æ•°æ®é‡‡é›† â†’ è®¾å¤‡ç®¡ç†ï¼ˆ`/mes/dc/device`)
- ç”Ÿäº§ç®¡æŽ§ â†’ æ•°æ®é‡‡é›† â†’ å®žæ—¶çœ‹æ¿ï¼ˆ`/mes/dc/dashboard`)
- ç”Ÿäº§ç®¡æŽ§ â†’ æ•°æ®é‡‡é›† â†’ é‡‡é›†è®°å½•(`/mes/dc/record`)
- ç”Ÿäº§ç®¡æŽ§ â†’ æ•°æ®é‡‡é›† â†’ ç»Ÿè®¡åˆ†æžï¼ˆ`/mes/dc/statistics`)
## è®¾å¤‡ç«¯æŽ¥å…¥ï¼ˆçŽ°åœºç½‘å…³/同事对接用)
### 1. æŽ¥å…¥å‡†å¤‡
1. åœ¨ã€Œè®¾å¤‡ç®¡ç†ã€æ–°å¢žé‡‡é›†è®¾å¤‡ï¼Œå¡«å†™è®¾å¤‡ç¼–号(如 `DC001`)、名称、设备类型;
2. åˆ›å»ºæˆåŠŸåŽå¼¹çª—ä¸€æ¬¡æ€§æ˜¾ç¤º 40 ä½é‡‡é›†ä»¤ç‰Œï¼Œé…ç½®åˆ°è®¾å¤‡ç«¯ï¼›
3. ä»¤ç‰Œä»…在创建/重置时返回,遗失只能重置(旧令牌立即失效);
4. è®¾å¤‡ç«¯æ¯æ¬¡è¯·æ±‚携带请求头 `X-Device-Token: <令牌>`(也支持 URL å‚æ•° `token`,请求头优先)。
### 2. ä¸ŠæŠ¥æŽ¥å£
| æ–¹æ³• | è·¯å¾„ | è¯´æ˜Ž |
|------|------|------|
| POST | `/admin-api/mes/data-collection/open/ingest` | ä¸ŠæŠ¥ä¸€æ¬¡é‡‡é›†æ•°æ® |
| POST | `/admin-api/mes/data-collection/open/heartbeat` | ä¸ŠæŠ¥å¿ƒè·³ï¼ˆå»ºè®®æ¯ 1 åˆ†é’Ÿä¸€æ¬¡ï¼‰ |
**上报请求参数:**
| å‚æ•° | ç±»åž‹ | å¿…å¡« | è¯´æ˜Ž |
|------|------|------|------|
| deviceCode | String | æ˜¯ | è®¾å¤‡ç¼–号,须与设备台账一致 |
| bizId | String | å»ºè®® | è®¾å¤‡ä¾§å”¯ä¸€é”®ï¼Œé‡å¤ä¸ŠæŠ¥æŒ‰å¹‚等处理(返回 `duplicate=true`,不新增记录) |
| recordNo | String | å¦ | è®¾å¤‡ä¾§è®°å½•序号,仅展示 |
| recordTime | String | å¦ | è®¾å¤‡é‡‡é›†æ—¶é—´ï¼Œæ ¼å¼ `yyyy-MM-dd HH:mm:ss`,不传取服务器时间 |
| count | Integer | äºŒé€‰ä¸€ | æœ¬æ¬¡è®¡æ•°ï¼›ä¸Ž `totalCount` éƒ½ä¼ æ—¶ä»¥ `count` ä¸ºå‡† |
| totalCount | Integer | äºŒé€‰ä¸€ | è®¾å¤‡ç´¯è®¡è®¡æ•°ï¼›åªä¼ ç´¯è®¡å€¼æ—¶ï¼Œç³»ç»Ÿç”¨ã€Œæœ¬æ¬¡ç´¯è®¡ - ä¸Šæ¬¡ç´¯è®¡ã€è®¡ç®—本次数量 |
| weight | BigDecimal | å¦ | æœ¬æ¬¡é‡é‡ï¼ˆg) |
| totalWeight | BigDecimal | å¦ | è®¾å¤‡ç´¯è®¡é‡é‡ï¼ˆg),仅留存 |
| online | Boolean | å¦ | æ˜¯å¦åœ¨çº¿å®žæ—¶ä¸ŠæŠ¥ï¼Œç¦»çº¿è¡¥æŠ¥ä¼  `false`,默认 `true` |
| firmwareVersion | String | å¦ | å›ºä»¶ç‰ˆæœ¬ï¼Œä¸ŠæŠ¥åŽæ›´æ–°åˆ°è®¾å¤‡å°è´¦ |
**上报响应示例:**
```json
{
  "code": 0,
  "msg": "",
  "data": {
    "recordId": 1024,
    "duplicate": false,
    "quantity": 12,
    "todayQuantity": 120,
    "todayWeight": 3600.50,
    "serverTime": "2026-11-10 14:23:05"
  }
}
```
**心跳请求参数:**
| å‚æ•° | ç±»åž‹ | å¿…å¡« | è¯´æ˜Ž |
|------|------|------|------|
| deviceCode | String | æ˜¯ | è®¾å¤‡ç¼–号 |
| firmwareVersion | String | å¦ | å›ºä»¶ç‰ˆæœ¬ |
| ip | String | å¦ | è®¾å¤‡ IP |
**心跳响应:** `{ "code": 0, "data": { "serverTime": "...", "deviceName": "...", "enabled": true, "workOrderId": 2048, "workOrderCode": "WO202611100001" } }`
### 3. è®¾å¤‡ç«¯æ³¨æ„äº‹é¡¹
- è®¾å¤‡ç¼–号与令牌必须同时正确,否则返回业务错误码(未携带令牌 / ä»¤ç‰Œæ— æ•ˆ / è®¾å¤‡ä¸å­˜åœ¨ï¼‰ï¼›
- è®¾å¤‡çŠ¶æ€ä¸ºã€Œç¦ç”¨ã€æ—¶æ‹’ç»ä¸ŠæŠ¥ï¼Œéœ€å…ˆåœ¨è®¾å¤‡ç®¡ç†å¯ç”¨ï¼›
- è®¡æ•°ä¸Žç´¯è®¡å€¼ä¸èƒ½ä¸ºè´Ÿï¼Œé‡é‡ä¸èƒ½ä¸ºè´Ÿï¼›
- åŒä¸€ `bizId` é‡å¤ä¸ŠæŠ¥è¿”回首次记录的 `recordId` ä¸Ž `duplicate=true`,网关可安全重试;
- åªæŠ¥ `totalCount` ä¸”与上次累计值相同(设备重试未带 bizId)时按重复上报处理,不新增记录;
- è®¾å¤‡è®¡æ•°å™¨æ¸…零(本次累计小于上次累计)时,系统直接把本次累计值当作本次数量;
- æ—¶é—´ç»Ÿä¸€æŒ‰æœåŠ¡å™¨æœ¬åœ°æ—¶åŒºï¼Œ`recordTime` ä¸ä¼ å³è®°å½•接收时间。
## ç®¡ç†ç«¯ API
| æ–¹æ³• | è·¯å¾„ | æƒé™ | è¯´æ˜Ž |
|------|------|------|------|
| POST | `/mes/data-collection/device/create` | `mes:dc-device:create` | æ–°å¢žè®¾å¤‡ï¼Œè¿”回 `id` + ä¸€æ¬¡æ€§ `token` |
| PUT | `/mes/data-collection/device/update` | `mes:dc-device:update` | ä¿®æ”¹è®¾å¤‡ï¼ˆä¸ä¼šä¿®æ”¹ä»¤ç‰Œï¼‰ |
| DELETE | `/mes/data-collection/device/delete?id=` | `mes:dc-device:delete` | åˆ é™¤è®¾å¤‡ |
| GET | `/mes/data-collection/device/get?id=` | `mes:dc-device:query` | è®¾å¤‡è¯¦æƒ… |
| GET | `/mes/data-collection/device/page` | `mes:dc-device:query` | è®¾å¤‡åˆ†é¡µï¼ˆcode/name/deviceType/status/workOrderCode) |
| GET | `/mes/data-collection/device/simple-list` | `mes:dc-device:query` | è®¾å¤‡ç²¾ç®€åˆ—表(下拉用) |
| PUT | `/mes/data-collection/device/reset-token?id=` | `mes:dc-device:reset-token` | é‡ç½®ä»¤ç‰Œï¼Œè¿”回新令牌 |
| PUT | `/mes/data-collection/device/bind-work-order` | `mes:dc-device:bind` | ç»‘定生产工单,body:`{ id, workOrderId }` |
| PUT | `/mes/data-collection/device/unbind-work-order?id=` | `mes:dc-device:bind` | è§£ç»‘生产工单 |
| GET | `/mes/data-collection/record/page` | `mes:dc-record:query` | è®°å½•分页(deviceId/deviceCode/workOrderCode/productId/batchCode/status/recordTime èŒƒå›´ï¼‰ |
| GET | `/mes/data-collection/record/get?id=` | `mes:dc-record:query` | è®°å½•详情 |
| PUT | `/mes/data-collection/record/correct` | `mes:dc-record:correct` | æ›´æ­£è®°å½•,body:`{ id, quantity, reason }` |
| PUT | `/mes/data-collection/record/cancel` | `mes:dc-record:cancel` | ä½œåºŸè®°å½•,body:`{ id, reason }` |
| GET | `/mes/data-collection/record/export-excel` | `mes:dc-record:export` | å¯¼å‡º Excel(按当前筛选条件,不分页) |
| GET | `/mes/data-collection/statistics/summary` | `mes:dc-statistics:query` | ç»Ÿè®¡æ±‡æ€» |
| GET | `/mes/data-collection/statistics/trend` | `mes:dc-statistics:query` | é‡‡é›†è¶‹åŠ¿ |
| GET | `/mes/data-collection/statistics/device-overview` | `mes:dc-statistics:query` | è®¾å¤‡å®žæ—¶æ¦‚览(看板) |
**统计查询参数:** `beginTime`、`endTime`(`yyyy-MM-dd HH:mm:ss`)、`deviceId`、`workOrderId`、`granularity`(`day` æŒ‰å¤© / `hour` æŒ‰å°æ—¶ï¼Œé»˜è®¤ `day`)。
**统计响应:**
```json
{
  "code": 0,
  "data": {
    "totalQuantity": 1234,
    "totalWeight": 370200.50,
    "recordCount": 56,
    "deviceCount": 2,
    "devices": [
      { "deviceId": 1, "deviceCode": "DC001", "deviceName": "一号线鸡爪计数", "totalQuantity": 800, "totalWeight": 240000.00, "recordCount": 36 }
    ]
  }
}
```
趋势项:`{ "period": "2026-11-10", "totalQuantity": 120, "totalWeight": 36000.00 }`(按小时时 period å½¢å¦‚ `2026-11-10 14:00`)。
## ä¸šåŠ¡æµç¨‹ä¸Žæ•°æ®å¸¦å…¥
1. è®¾å¤‡ç®¡ç†æ–°å¢žè®¾å¤‡ â†’ ä¸€æ¬¡æ€§ä»¤ç‰Œ â†’ è®¾å¤‡ç«¯é…ç½®ï¼›
2. è®¾å¤‡ç«¯å¿ƒè·³ â†’ è®¾å¤‡åˆ—表「在线状态」按最后心跳时间判定(超过 5 åˆ†é’Ÿæ— å¿ƒè·³è§†ä¸ºç¦»çº¿ï¼‰ï¼›
3. è®¾å¤‡ç«¯ä¸ŠæŠ¥ â†’ ç”Ÿæˆé‡‡é›†è®°å½•(正常状态 0);上报时若设备已绑定工单,记录自动带入:
   - ç”Ÿäº§å·¥å• ID / å·¥å•编号;
   - äº§å“ ID / äº§å“ç¼–码 / äº§å“åç§°ï¼›
   - ç”Ÿäº§æ‰¹æ¬¡å·ã€‚
4. ç»‘定生产工单后,只影响**后续新上报**的记录;历史记录不回溯改绑;
5. è§£ç»‘后,后续新记录不再带工单信息,历史记录保留绑定时的工单信息;
6. é‡‡é›†è®°å½•可更正(数量改为实际值,状态 1 å·²æ›´æ­£ï¼Œä¿ç•™æ›´æ­£å‰åŽŸå§‹æ•°é‡ä¸ŽåŽŸå› ï¼‰æˆ–ä½œåºŸï¼ˆçŠ¶æ€ 2,仍保留在列表可追溯);
7. å®žæ—¶çœ‹æ¿å±•示设备在线状态与今日产量;统计分析按时间范围/设备给出数量、重量、记录数、设备数与日/小时趋势;
8. ç»Ÿè®¡ä¸Žçœ‹æ¿**排除已作废记录**;已更正记录按更正后数量参与统计。
## å­—段展示规则
| å­—段 | å±•示位置 | è¯´æ˜Ž |
|------|----------|------|
| è®¾å¤‡ç¼–号/名称/类型/型号/安装位置 | è®¾å¤‡åˆ—表、记录列表、看板 | ç±»åž‹èµ°å­—å…¸ `mes_dc_device_type` |
| è®¾å¤‡çŠ¶æ€ | è®¾å¤‡åˆ—表 | å­—å…¸ `mes_dc_device_status`:0 å¯ç”¨ / 1 ç¦ç”¨ |
| åœ¨çº¿çŠ¶æ€ | è®¾å¤‡åˆ—表、看板 | æœ€åŽå¿ƒè·³æ—¶é—´åœ¨ 5 åˆ†é’Ÿå†…为在线 |
| å½“前绑定工单 | è®¾å¤‡åˆ—表 | æ˜¾ç¤ºå·¥å•编号;操作按是否已绑定显示「绑定工单/解绑工单」 |
| æœ€åŽå¿ƒè·³/最后上报时间 | è®¾å¤‡åˆ—表 | ç²¾ç¡®åˆ°ç§’ |
| å›ºä»¶ç‰ˆæœ¬ | è®¾å¤‡åˆ—表 | å¿ƒè·³æˆ–上报时更新 |
| é‡‡é›†æ•°é‡/设备累计数量/重量 | é‡‡é›†è®°å½• | é‡é‡ä¿ç•™ 2 ä½å°æ•° |
| è®°å½•状态 | é‡‡é›†è®°å½• | å­—å…¸ `mes_dc_record_status`:0 æ­£å¸¸ / 1 å·²æ›´æ­£ / 2 å·²ä½œåºŸ |
| ä¸ŠæŠ¥æ–¹å¼ | é‡‡é›†è®°å½• | åœ¨çº¿ / ç¦»çº¿è¡¥æŠ¥ |
| ç”Ÿäº§å·¥å•编号/产品/批次 | é‡‡é›†è®°å½• | ä¸ŠæŠ¥æ—¶ç”±ç»‘定工单带入,可能为空 |
| ç»Ÿè®¡æ±‡æ€»/趋势/按设备汇总 | ç»Ÿè®¡åˆ†æž | æŽ’除作废记录 |
## ä¸šåŠ¡è§„åˆ™è¯´æ˜Ž
| åœºæ™¯ | è§„则 |
|------|------|
| ä»¤ç‰Œåˆ›å»º/重置 | ä»…本次接口返回,列表与详情不返回令牌 |
| å¹‚ç­‰ | åŒä¸€è®¾å¤‡ + ç›¸åŒ bizId åªè½ä¸€æ¡è®°å½•,重复请求返回首次记录并标记 `duplicate=true` |
| åªæŠ¥ç´¯è®¡å€¼ | æŒ‰ã€Œæœ¬æ¬¡ç´¯è®¡ - ä¸Šæ¬¡ç´¯è®¡ã€è®¡ç®—;首次或计数器清零按本次累计 |
| åœç”¨è®¾å¤‡ | æ‹’绝上报与心跳以外的采集操作;需先启用 |
| æ›´æ­£ | ä»…「正常」状态可更正;更正后不可再次更正;记录保留原始数量 |
| ä½œåºŸ | å·²ä½œåºŸä¸å¯é‡å¤ä½œåºŸï¼›ä½œåºŸè®°å½•不参与统计与看板 |
| ç»Ÿè®¡èŒƒå›´ | é»˜è®¤å…¨éƒ¨æ—¶é—´ï¼›å¯æŒ‰è®¾å¤‡/工单/时间范围筛选 |
| ç¬¬ä¸€é˜¶æ®µè¾¹ç•Œ | é‡‡é›†æ•°é‡åªåšå±•示与统计,**不自动回写生产报工、包装或库存**;回写逻辑待后续需求确认 |
## æ³¨æ„äº‹é¡¹
- è®¾å¤‡ç«¯ä¸ŠæŠ¥åœ°å€ä¸ºç½‘关可访问的后端地址(开发环境经前端代理 `/admin-api`,生产环境直接用后端域名 + `/admin-api`);
- ä»¤ç‰Œæ˜¯è®¾å¤‡èº«ä»½å‡­è¯ï¼Œåªé…ç½®åœ¨ç½‘关,不写入日志/截图/文档;
- ä¸€ä¸ªè®¾å¤‡åŒä¸€æ—¶é—´åªç»‘定一张生产工单;换单需先解绑再绑定;
- ç»‘定时只允许选择未完工、未取消的生产工单;
- è®¾å¤‡å·²æœ‰é‡‡é›†è®°å½•时禁止删除(提示先处理记录),避免历史数据失去设备主体;
- é‡‡é›†è®°å½•导出使用当前筛选条件,导出全部匹配行(不分页);
- çŽ°åœºè®¾å¤‡è‹¥åªè¾“å‡ºç´¯è®¡å€¼ï¼Œå»ºè®®åŒæ—¶ä¸ŠæŠ¥ `bizId`,避免网络重试造成重复计数。
docs/project-business/README.md
@@ -14,12 +14,12 @@
```text
docs/project-business/
├── index.html      # å¯è§†åŒ–页面:双击直接打开(file:// å³å¯ï¼Œæ— éœ€ä»»ä½•服务)
├── mermaid/        # 11 å¼  Mermaid ä¸šåŠ¡å›¾ï¼ˆæƒå¨æºï¼Œæ”¹è¿™é‡Œï¼‰
├── mermaid/        # 12 å¼  Mermaid ä¸šåŠ¡å›¾ï¼ˆæƒå¨æºï¼Œæ”¹è¿™é‡Œï¼‰
├── data/           # ä¸šåŠ¡æ•°æ®ï¼ˆæƒå¨æºï¼Œæ”¹è¿™é‡Œï¼‰
│   â”œâ”€â”€ business.json  # é¡¹ç›®å…ƒä¿¡æ¯/业务十问/AI能力/待确认事项
│   â”œâ”€â”€ modules.json   # 12 ä¸ªä¸šåŠ¡æ¨¡å—å®šä¹‰
│   â”œâ”€â”€ modules.json   # 14 ä¸ªä¸šåŠ¡æ¨¡å—å®šä¹‰
│   â”œâ”€â”€ objects.json   # æ ¸å¿ƒä¸šåŠ¡å¯¹è±¡ï¼ˆä½œç”¨/上游/下游/表名)
│   â”œâ”€â”€ flows.json     # 7 æ¡æµç¨‹ï¼ˆæ‘˜è¦+步骤+角色)
│   â”œâ”€â”€ flows.json     # 8 æ¡æµç¨‹ï¼ˆæ‘˜è¦+步骤+角色)
│   â””── roles.json     # è§’色权限
└── README.md
```
@@ -45,6 +45,7 @@
| 09-data-flow | è·¨æ¨¡å—数据流(单据生成、字段带入、数量回写、事件) |
| 10-business-object | æ ¸å¿ƒä¸šåŠ¡å¯¹è±¡ ER(只含业务对象,非全库表) |
| 11-ai-business-flow | AI ä¸šåŠ¡é“¾è·¯ï¼ˆOCR/质检判定/四类预测/RAG,含 API ä¾èµ–) |
| 12-data-collection-flow | æ•°æ®é‡‡é›†ï¼šè®¾å¤‡å»ºæ¡£ä»¤ç‰Œâ†’心跳/上报(幂等·累计差值)→绑定工单带入产品批次→更正作废→看板统计,第一阶段不回写 |
图中状态数字均为源码枚举真实值(如工单 0草稿/1已确认/2完成/3取消;ERP å®¡æ‰¹ 15审批中/20已审核)。
@@ -65,7 +66,7 @@
- æœ¬ç›®å½•由项目技能 **project-business-analysis** ç®¡ç†ï¼ˆ`.claude/skills/project-business-analysis/`),并有规则 `.claude/rules/business-visualization-maintenance.md` å¼ºåˆ¶ï¼šä¸šåŠ¡æ¨¡å—/流程/状态/对象/角色/AI å˜æ›´åŽéœ€åŒæ­¥ç»´æŠ¤æœ¬ç›®å½•。
- å¢žé‡ç»´æŠ¤ï¼šæ”¹å¯¹åº”çš„ `mermaid/*.mmd` + `data/*.json` â†’ è¿è¡Œä¸Šé¢çš„ sync è„šæœ¬ â†’ æµè§ˆå™¨éªŒè¯å—影响图。
- å…¨é‡é‡åšï¼ˆåå·®è¿‡å¤§æ—¶ï¼‰ï¼šå¯¹ Claude è¯´ã€Œé‡æ–°ç”Ÿæˆä¸šåŠ¡å…¨æ™¯ã€ï¼ŒæŠ€èƒ½ä¼šé‡æ–°èµ°è¯»æºç å¹¶æŒ‰ç”Ÿæˆæ¨¡å¼é‡å»ºã€‚
- ç”ŸæˆåŸºçº¿ï¼šdev_business @ 87bf4a99,2026-09-10。
- ç”ŸæˆåŸºçº¿ï¼šdev_business @ 87bf4a99,2026-09-10;数据采集(MES-DC)增量维护于 2026-11-10。
## 7. å·²çŸ¥å¾…确认业务
docs/project-business/data/business.json
@@ -4,7 +4,7 @@
    "type": "混合系统",
    "mainSystem": "MOM åˆ¶é€ è¿è¥ç®¡ç†ç³»ç»Ÿ",
    "subSystems": [
      "MES(生产·仓储·质量·设备)",
      "MES(生产·仓储·质量·设备·数据采集)",
      "ERP(进销存·财务)",
      "CRM(客户关系)",
      "SRM(供应商关系)",
@@ -21,9 +21,9 @@
    "frontend": "mom-pro2-before(Vue3 ç®¡ç†åŽå°ï¼ŒåŒä»“库存放,只读参考)"
  },
  "stats": {
    "businessModules": 13,
    "coreObjects": 48,
    "documentFlows": 6,
    "businessModules": 14,
    "coreObjects": 50,
    "documentFlows": 7,
    "approvalListeners": 13,
    "aiCapabilities": 9,
    "wmBillTypes": 15
@@ -153,8 +153,9 @@
    "MesWmSnDO æ–°å¢žçš„ uuid å­—段生成/消费逻辑未在核心 Service ä¸­ç¡®è®¤",
    "转正申请(hrm_regularize_application)、培训证书等仅有 SQL ä¸Žèœå•初始化,Java ä¾§ Service/Controller æœªå®žçް",
    "NCR å¤„置结果(返工/退货)未回写触发源单据,仅台账记录",
    "MPS çŠ¶æ€æžšä¸¾ç‹¬ç«‹ç¼–å·(0/1/2/3),与通用单据常量(0/1/4/5)不一致"
    "MPS çŠ¶æ€æžšä¸¾ç‹¬ç«‹ç¼–å·(0/1/2/3),与通用单据常量(0/1/4/5)不一致",
    "数据采集(鸡爪计数/称重设备)第一阶段只做采集→展示→统计,不自动回写生产报工、包装或库存;现场设备接线与网关由现场同事对接待联调【第一阶段边界】"
  ],
  "generatedAt": "2026-09-10",
  "generatedAt": "2026-11-10",
  "analysisBasis": "基于 dev_business åˆ†æ”¯ 87bf4a99 æºç ï¼Œ6 ç»„并行源码走读(MES ç”Ÿäº§è´¨é‡ / MES ä»“储 / ERP / CRM+SRM / å”®åŽ+HRM / AI+BI+MDM+BPM+底座)"
}
docs/project-business/data/flows.json
@@ -64,6 +64,16 @@
       {"stage": "辅助判定", "action": "质检单+指标+缺陷 â†’ å»ºè®®åˆæ ¼/特采/退货/报废+理由", "roles": ["质检员"]},
       {"stage": "决策预测", "action": "缺料/生产时长/生产风险/交付四类预测供计划排产参考", "roles": ["计划员"]},
       {"stage": "模板识别", "action": "上传既有检验报告文件(扫描件/照片、电子版 PDF、Word/Excel) â†’ åˆ†é€šé“抽取(有文本层走文本、扫描版逐页转图) â†’ å¤§æ¨¡åž‹æŒ‰å‰ç«¯ä¸Šä¼ çš„组件清单产出扁平组件草稿 â†’ äººå·¥åœ¨è®¾è®¡å™¨ç¡®è®¤åŽä¿å­˜ä¸ºæ¨¡æ¿ç‰ˆæœ¬", "roles": ["质检员", "质量工程师"]},
       {"stage": "知识检索", "action": "文档→切片→Milvus å‘量→检索接口(预留)", "roles": ["—"]}]}
       {"stage": "知识检索", "action": "文档→切片→Milvus å‘量→检索接口(预留)", "roles": ["—"]}]},
    {"id": "datacollection", "name": "数据采集流程", "mermaid": "mermaid/12-data-collection-flow.mmd", "color": "#3fa9a0",
     "summary": "设备建档发放一次性令牌 â†’ çŽ°åœºç½‘å…³å¿ƒè·³ä¸Žä¸ŠæŠ¥(幂等·支持只报累计值) â†’ ç»‘定生产工单后新记录带入工单/产品/批次 â†’ è®°å½•æ›´æ­£/作废留痕 â†’ å®žæ—¶çœ‹æ¿ä¸Žç»Ÿè®¡åˆ†æžï¼›ç¬¬ä¸€é˜¶æ®µåªé‡‡é›†å±•示统计,不自动回写生产报工与包装。",
     "steps": [
       {"stage": "接入", "action": "新增采集设备(编号/名称/类型),创建时一次性显示 40 ä½ä»¤ç‰Œå¹¶é…ç½®åˆ°çŽ°åœºç½‘å…³ï¼›è®¾å¤‡ç«¯è¯·æ±‚æºå¸¦ X-Device-Token(也支持 URL å‚æ•° token,请求头优先),遗失只能重置且旧令牌立即失效", "roles": ["设备管理员", "现场同事"]},
       {"stage": "心跳", "action": "设备建议每 1 åˆ†é’Ÿä¸ŠæŠ¥å¿ƒè·³ï¼Œæ›´æ–°æœ€åŽå¿ƒè·³æ—¶é—´ä¸Žå›ºä»¶ç‰ˆæœ¬ï¼›æœ€åŽå¿ƒè·³ 5 åˆ†é’Ÿå†…为在线,超时视为离线;禁用设备拒绝上报", "roles": ["现场网关"]},
       {"stage": "上报", "action": "上报 count æˆ– totalCount(都传以 count ä¸ºå‡†):同一设备+同一 bizId åªè½ä¸€æ¡ï¼Œé‡å¤è¯·æ±‚返回首次记录并标记 duplicate=true;只报累计值时按本次累计-上次累计计算,首次或计数器清零按本次累计;离线补报传 online=false", "roles": ["现场网关"]},
       {"stage": "绑定", "action": "设备绑定未完工、未取消的生产工单(同一时间一张,换单先解绑);仅后续新上报记录自动带入工单编号、产品编码名称与生产批次,历史记录不回溯;解绑后新记录不再带工单信息", "roles": ["设备管理员"]},
       {"stage": "追溯", "action": "正常记录可更正(数量改为实际值并填原因,保留原始数量,状态1)或作废(状态2,仍可查询);仅正常状态可更正且更正后不可再改,已作废不可重复作废", "roles": ["生产统计员"]},
       {"stage": "统计", "action": "实时看板展示设备在线与今日产量;统计分析按时间范围/设备/工单给出数量、重量、记录数、设备数与日/小时趋势,排除作废记录、已更正按更正后数量参与;可按筛选条件导出 Excel", "roles": ["生产统计员", "管理层"]},
       {"stage": "边界", "action": "第一阶段采集数量只做展示与统计,不自动回写生产报工、包装或库存;回写逻辑待后续需求确认", "roles": ["系统(不执行)"]}]}
  ]
}
docs/project-business/data/modules.json
@@ -40,6 +40,14 @@
     "roles": ["计划员", "车间主任", "操作工", "工艺员"],
     "upstream": ["进销存(销售订单)"], "downstream": ["仓储(领料/入库)", "质量(IPQC)"],
     "coreTables": ["mes_pro_mps", "mes_pro_work_order", "mes_pro_task", "mes_pro_feedback", "mes_pro_route", "mes_pro_process", "mes_pro_work_order_bom", "mes_pd_project"]},
    {"key": "dc", "name": "数据采集", "color": "#3fa9a0", "tag": "MES-DC", "flow": "datacollection",
     "positioning": "生产现场计数/称重设备的接入与产量采集",
     "problem": "鸡爪计数/称重设备数据靠人工抄录,设备产量与生产工单、批次脱节",
     "features": ["采集设备台账与40位一次性令牌", "设备端 HTTP ä¸ŠæŠ¥ä¸Žå¿ƒè·³ï¼ˆX-Device-Token)", "bizId å¹‚等与只报累计值的差值计算", "设备绑定生产工单,仅后续新记录带入工单/产品/批次", "采集记录更正与作废留痕", "实时看板(在线状态+今日产量)", "统计分析(汇总/趋势/按设备)", "第一阶段只采集、展示、统计,不自动回写生产报工与包装"],
     "objects": ["采集设备", "采集记录"],
     "roles": ["设备管理员", "生产统计员"],
     "upstream": ["生产(绑定工单带入产品批次)"], "downstream": ["BI(产量统计)"],
     "coreTables": ["mes_dc_device", "mes_dc_record"]},
    {"key": "wm", "name": "仓储管理", "color": "#7e6bd6", "tag": "MES-WM", "flow": "warehouse",
     "positioning": "厂内 WMS:单据驱动的库存账实一致",
     "problem": "多来源出入库、批次/SN è¿½æº¯ã€åº“存精确到库位",
docs/project-business/data/objects.json
@@ -50,6 +50,8 @@
    {"name": "离职交接", "module": "人力", "table": "hrm_user_handover", "doc": "from→to æ˜ å°„,已完成20 åŽ expandUserIds æ‰©å±•交接人可见数据(当前各业务模块尚未实际接入调用)", "upstream": ["离职申请"], "downstream": ["各模块我的数据查询"], "keywords": "交接 ç¦»èŒ handover expandUserIds"},
    {"name": "排班计划", "module": "设备", "table": "mes_cal_plan", "doc": "班组×班次×日期排班,供生产与考勤引用", "upstream": [], "downstream": ["生产任务", "考勤"], "keywords": "排班 ç­ç»„ ç­æ¬¡ æ—¥åކ"},
    {"name": "报告模板", "module": "质检报告", "table": "qc_report_template", "doc": "智能质检报告模板,启用0/停用1;画布内容存在 qc_report_template_version(草稿0/已发布1/已停用2,已发布不可覆盖),currentVersion æŒ‡å‘当前已发布版本;源文件经 AI å¯¼å…¥è¯†åˆ«æˆè‰ç¨¿åŽç”±äººå·¥ç¡®è®¤æ‰æˆä¸ºç‰ˆæœ¬ï¼›åŒä¸€æ¨¡æ¿é‡å¤å¯¼å…¥æŒ‰ã€æ›¿æ¢ã€‘处理——先删旧附件(连带 blob è¡Œä¸Žç£ç›˜æ–‡ä»¶ï¼‰å†ç»‘新的,不留孤儿文件;删除模板会连带清附件", "upstream": ["人工设计(GrapesJS è®¾è®¡å™¨)", "AI å¯¼å…¥è‰ç¨¿(qc-report/ai-import/draft)"], "downstream": ["模板版本", "报告实例"], "keywords": "报告模板 è´¨æ£€æŠ¥å‘Š template è®¾è®¡å™¨ ç‰ˆæœ¬ AI导入 è¯†åˆ« è‰ç¨¿ æºæ–‡ä»¶æ›¿æ¢"},
    {"name": "报告实例", "module": "质检报告", "table": "qc_report_instance", "doc": "出件产物,编号 QR+yyyyMMdd+4位流水按天独立且业务唯一,可显式指定覆盖(注意 uk_report_no ä¸åŒºåˆ†è½¯åˆ é™¤ï¼Œåˆ æŽ‰çš„号不回收);两条出件入口:通用 generate(调用方自带 context)与 generate-from-qc(数据从 MES è´¨æ£€å•取,权限码 qc-report:instance:generate å·²å…¥ system_menu id=1075416,五道校验按业务优先级只报第一处:105_000 ç±»åž‹éžæ³• / 105_001 å•据不存在 / 105_002 æœªå®Œæˆ / 105_003 æœªåˆ¤å®š / 105_005 æ¨¡æ¿ç±»åž‹ä¸ç¬¦ / 105_006 æ— å¯ç”¨æ£€éªŒé¡¹ï¼›å››å¼ è´¨æ£€å•列表的行操作「出报告」仅在 status=已完成时可见,弹窗只列 reportType ä¸€è‡´ã€æ¨¡æ¿å¯ç”¨ã€ä¸” currentVersion æŒ‡å‘的版本已发布的模板(后端 /qc-report/template/selectable åˆ¤å®šâ€”—停用版本不清空 currentVersion,前端拿分页结果自己推导会漏),结果就地展示并跳本页列表);冻结 data_snapshot(判定后数据,含后端算好的 PASS/FAIL ä¸Žåˆæ ¼çŽ‡ï¼‰ä¸Ž render_html;regenerate åªé‡æ¸²æŽ’版、数据与编号不变;business_id/business_type å­˜ MES è¡¨åï¼ˆmes_qc_iqc ç­‰ï¼‰ä¸Žå•据 ID,可反查、一单可出多份;报告头另带单据原判定 qcResult(数)/qcResultText(中文,合格/特采/不合格退货/不合格报废),与引擎三态判定并存互不覆盖;响应带 undecidableCount=快照中 result ä¸ºç©ºä¸²çš„项数与 warnings(分组标题跳过/指标已删/未录实测值/样品超3),两者都不落库、事后看不到", "upstream": ["报告模板版本", "质检单上下文(通用 generate ç”±è°ƒç”¨æ–¹ä¼ å…¥)", "MES è´¨æ£€å• IQC/IPQC/OQC/RQC(generate-from-qc ç» MesQcReportApi å–æ•°)"], "downstream": ["前端实例页 /qc/report-instance(列表·iframe预览·快照页签·导出PDF)", "PDF归档(system_storage_attachment recordType=qc_report_instance)"], "keywords": "报告实例 å‡ºä»¶ QR编号 å¿«ç…§ å¤çް regenerate PDF归档 æŠ¥å‘Šå®žä¾‹é¡µ å¯¼å‡ºPDF generate-from-qc è´¨æ£€å•出报告 å‡ºæŠ¥å‘Šå¼¹çª— qcResult undecidableCount warnings å¾…判定 åæŸ¥ ä¸šåŠ¡å•æ®ç­›é€‰"}
    {"name": "报告实例", "module": "质检报告", "table": "qc_report_instance", "doc": "出件产物,编号 QR+yyyyMMdd+4位流水按天独立且业务唯一,可显式指定覆盖(注意 uk_report_no ä¸åŒºåˆ†è½¯åˆ é™¤ï¼Œåˆ æŽ‰çš„号不回收);两条出件入口:通用 generate(调用方自带 context)与 generate-from-qc(数据从 MES è´¨æ£€å•取,权限码 qc-report:instance:generate å·²å…¥ system_menu id=1075416,五道校验按业务优先级只报第一处:105_000 ç±»åž‹éžæ³• / 105_001 å•据不存在 / 105_002 æœªå®Œæˆ / 105_003 æœªåˆ¤å®š / 105_005 æ¨¡æ¿ç±»åž‹ä¸ç¬¦ / 105_006 æ— å¯ç”¨æ£€éªŒé¡¹ï¼›å››å¼ è´¨æ£€å•列表的行操作「出报告」仅在 status=已完成时可见,弹窗只列 reportType ä¸€è‡´ã€æ¨¡æ¿å¯ç”¨ã€ä¸” currentVersion æŒ‡å‘的版本已发布的模板(后端 /qc-report/template/selectable åˆ¤å®šâ€”—停用版本不清空 currentVersion,前端拿分页结果自己推导会漏),结果就地展示并跳本页列表);冻结 data_snapshot(判定后数据,含后端算好的 PASS/FAIL ä¸Žåˆæ ¼çŽ‡ï¼‰ä¸Ž render_html;regenerate åªé‡æ¸²æŽ’版、数据与编号不变;business_id/business_type å­˜ MES è¡¨åï¼ˆmes_qc_iqc ç­‰ï¼‰ä¸Žå•据 ID,可反查、一单可出多份;报告头另带单据原判定 qcResult(数)/qcResultText(中文,合格/特采/不合格退货/不合格报废),与引擎三态判定并存互不覆盖;响应带 undecidableCount=快照中 result ä¸ºç©ºä¸²çš„项数与 warnings(分组标题跳过/指标已删/未录实测值/样品超3),两者都不落库、事后看不到", "upstream": ["报告模板版本", "质检单上下文(通用 generate ç”±è°ƒç”¨æ–¹ä¼ å…¥)", "MES è´¨æ£€å• IQC/IPQC/OQC/RQC(generate-from-qc ç» MesQcReportApi å–æ•°)"], "downstream": ["前端实例页 /qc/report-instance(列表·iframe预览·快照页签·导出PDF)", "PDF归档(system_storage_attachment recordType=qc_report_instance)"], "keywords": "报告实例 å‡ºä»¶ QR编号 å¿«ç…§ å¤çް regenerate PDF归档 æŠ¥å‘Šå®žä¾‹é¡µ å¯¼å‡ºPDF generate-from-qc è´¨æ£€å•出报告 å‡ºæŠ¥å‘Šå¼¹çª— qcResult undecidableCount warnings å¾…判定 åæŸ¥ ä¸šåŠ¡å•æ®ç­›é€‰"},
    {"name": "采集设备", "module": "数据采集", "table": "mes_dc_device", "doc": "鸡爪计数/称重设备台账,编号唯一;40 ä½é‡‡é›†ä»¤ç‰Œä»…创建与重置时返回、库内哈希存储;最后心跳/上报时间与固件版本由设备请求更新,最后心跳 5 åˆ†é’Ÿå†…视为在线;同一时间只绑定一张未完工、未取消的生产工单,已有采集记录的设备禁止删除;设备禁用时拒绝上报与心跳以外的采集操作", "upstream": ["生产工单(绑定)"], "downstream": ["采集记录", "实时看板"], "keywords": "采集设备 æ•°é‡‡ é¸¡çˆªè®¡æ•° ç§°é‡ ä»¤ç‰Œ token å¿ƒè·³ åœ¨çº¿ device"},
    {"name": "采集记录", "module": "数据采集", "table": "mes_dc_record", "doc": "设备上报产生,正常0/已更正1/已作废2;同一设备+bizId å¹‚等只落一条,重复上报返回首次记录并标记 duplicate=true;只报 totalCount æ—¶æŒ‰æœ¬æ¬¡ç´¯è®¡-上次累计计算本次数量,首次或计数器清零按本次累计;上报时设备已绑定工单则自动带入生产工单、产品编码名称与批次,历史记录不回溯改绑;仅正常状态可更正且保留原始数量与原因,已作废不可重复作废;统计与看板排除作废记录、已更正按更正后数量参与", "upstream": ["采集设备", "生产工单(绑定带入)", "设备端上报"], "downstream": ["实时看板", "统计分析", "Excel导出"], "keywords": "采集记录 ä¸ŠæŠ¥ ingest å¹‚ç­‰ bizId ç´¯è®¡ æ›´æ­£ ä½œåºŸ äº§é‡ record"}
  ]
}
docs/project-business/data/roles.json
@@ -16,6 +16,7 @@
    {"role": "仓管员", "modules": ["MES-WM"], "operations": ["15 ç±»å‡ºå…¥åº“单据执行", "调拨", "盘点", "条码装箱"], "data": ["mes_wm_*"], "scope": "仓库维度;WMS å¯æŒ‰ä»“库配置出入库/调拨/盘点是否走 BPM"},
    {"role": "质检员", "modules": ["MES-QC"], "operations": ["IQC/IPQC/OQC/RQC æ£€éªŒ", "NCR è¯„审处置"], "data": ["mes_qc_*"], "scope": "inspectorUserId å½’属"},
    {"role": "设备员/维修工", "modules": ["MES-DV"], "operations": ["点检保养", "维修工单", "工装领用"], "data": ["mes_dv_*", "mes_tm_*"], "scope": "chargeUserId å½’属"},
    {"role": "设备管理员/生产统计员", "modules": ["MES-DC"], "operations": ["采集设备台账与令牌重置", "绑定/解绑生产工单", "采集记录更正与作废", "实时看板与统计分析"], "data": ["mes_dc_device", "mes_dc_record"], "scope": "菜单权限控制:mes:dc-device:* / mes:dc-record:* / mes:dc-statistics:query"},
    {"role": "客服/售后工程师", "modules": ["售后"], "operations": ["工单受理派工", "ç»´ä¿®", "退货申请"], "data": ["after_sale_*"], "scope": "行级数据权限四视图:我负责/我参与/下属负责/全部(aftersales:view-all)"},
    {"role": "财务", "modules": ["ERP", "CRM"], "operations": ["收款单", "付款单", "开票审核", "结算账户"], "data": ["erp_finance_*", "crm_invoice", "crm_receivable"], "scope": "financeUserId å½’属"},
    {"role": "HR", "modules": ["HRM"], "operations": ["员工档案入转调离", "考勤规则排班(本人打卡全员可用,不设权限点)", "薪酬核算发放", "离职交接"], "data": ["hrm_*"], "scope": "部门范围 dataScope"},
docs/project-business/index.html
@@ -9,7 +9,7 @@
  --bg:#0b1220; --bg2:#101a2e; --panel:#131f36; --panel2:#182742;
  --line:#24344f; --text:#dbe4f0; --muted:#8fa1b8;
  --c-base:#8a94a6; --c-sale:#4f9cff; --c-sup:#c9a86a; --c-erp:#5fc79e;
  --c-prod:#e0b34f; --c-wm:#7e6bd6; --c-qc:#e06c6c; --c-dv:#59a8b8;
  --c-prod:#e0b34f; --c-dc:#3fa9a0; --c-wm:#7e6bd6; --c-qc:#e06c6c; --c-dv:#59a8b8;
  --c-as:#c78bd6; --c-hrm:#9db85a; --c-bpm:#e6a23c; --c-ai:#56c8d8; --c-fin:#3ec9a7;
}
*{box-sizing:border-box;margin:0;padding:0}
@@ -108,6 +108,7 @@
  <a data-t="flow-sales"><span class="dot" style="background:var(--c-sale)"></span>销售流程</a>
  <a data-t="flow-purchase"><span class="dot" style="background:var(--c-erp)"></span>采购流程</a>
  <a data-t="flow-production"><span class="dot" style="background:var(--c-prod)"></span>生产流程</a>
  <a data-t="flow-datacollection"><span class="dot" style="background:var(--c-dc)"></span>数据采集流程</a>
  <a data-t="flow-quality"><span class="dot" style="background:var(--c-qc)"></span>质量流程</a>
  <a data-t="flow-warehouse"><span class="dot" style="background:var(--c-wm)"></span>仓储流程</a>
  <a data-t="flow-aftersales"><span class="dot" style="background:var(--c-as)"></span>售后流程</a>
@@ -134,6 +135,7 @@
<section class="page" id="flow-sales"></section>
<section class="page" id="flow-purchase"></section>
<section class="page" id="flow-production"></section>
<section class="page" id="flow-datacollection"></section>
<section class="page" id="flow-quality"></section>
<section class="page" id="flow-warehouse"></section>
<section class="page" id="flow-aftersales"></section>
@@ -184,7 +186,7 @@
    "type": "混合系统",
    "mainSystem": "MOM åˆ¶é€ è¿è¥ç®¡ç†ç³»ç»Ÿ",
    "subSystems": [
      "MES(生产·仓储·质量·设备)",
      "MES(生产·仓储·质量·设备·数据采集)",
      "ERP(进销存·财务)",
      "CRM(客户关系)",
      "SRM(供应商关系)",
@@ -201,9 +203,9 @@
    "frontend": "mom-pro2-before(Vue3 ç®¡ç†åŽå°ï¼ŒåŒä»“库存放,只读参考)"
  },
  "stats": {
    "businessModules": 13,
    "coreObjects": 48,
    "documentFlows": 6,
    "businessModules": 14,
    "coreObjects": 50,
    "documentFlows": 7,
    "approvalListeners": 13,
    "aiCapabilities": 9,
    "wmBillTypes": 15
@@ -333,9 +335,10 @@
    "MesWmSnDO æ–°å¢žçš„ uuid å­—段生成/消费逻辑未在核心 Service ä¸­ç¡®è®¤",
    "转正申请(hrm_regularize_application)、培训证书等仅有 SQL ä¸Žèœå•初始化,Java ä¾§ Service/Controller æœªå®žçް",
    "NCR å¤„置结果(返工/退货)未回写触发源单据,仅台账记录",
    "MPS çŠ¶æ€æžšä¸¾ç‹¬ç«‹ç¼–å·(0/1/2/3),与通用单据常量(0/1/4/5)不一致"
    "MPS çŠ¶æ€æžšä¸¾ç‹¬ç«‹ç¼–å·(0/1/2/3),与通用单据常量(0/1/4/5)不一致",
    "数据采集(鸡爪计数/称重设备)第一阶段只做采集→展示→统计,不自动回写生产报工、包装或库存;现场设备接线与网关由现场同事对接待联调【第一阶段边界】"
  ],
  "generatedAt": "2026-09-10",
  "generatedAt": "2026-11-10",
  "analysisBasis": "基于 dev_business åˆ†æ”¯ 87bf4a99 æºç ï¼Œ6 ç»„并行源码走读(MES ç”Ÿäº§è´¨é‡ / MES ä»“储 / ERP / CRM+SRM / å”®åŽ+HRM / AI+BI+MDM+BPM+底座)"
}</script>
<script type="application/json" id="data-modules">{
@@ -380,6 +383,14 @@
     "roles": ["计划员", "车间主任", "操作工", "工艺员"],
     "upstream": ["进销存(销售订单)"], "downstream": ["仓储(领料/入库)", "质量(IPQC)"],
     "coreTables": ["mes_pro_mps", "mes_pro_work_order", "mes_pro_task", "mes_pro_feedback", "mes_pro_route", "mes_pro_process", "mes_pro_work_order_bom", "mes_pd_project"]},
    {"key": "dc", "name": "数据采集", "color": "#3fa9a0", "tag": "MES-DC", "flow": "datacollection",
     "positioning": "生产现场计数/称重设备的接入与产量采集",
     "problem": "鸡爪计数/称重设备数据靠人工抄录,设备产量与生产工单、批次脱节",
     "features": ["采集设备台账与40位一次性令牌", "设备端 HTTP ä¸ŠæŠ¥ä¸Žå¿ƒè·³ï¼ˆX-Device-Token)", "bizId å¹‚等与只报累计值的差值计算", "设备绑定生产工单,仅后续新记录带入工单/产品/批次", "采集记录更正与作废留痕", "实时看板(在线状态+今日产量)", "统计分析(汇总/趋势/按设备)", "第一阶段只采集、展示、统计,不自动回写生产报工与包装"],
     "objects": ["采集设备", "采集记录"],
     "roles": ["设备管理员", "生产统计员"],
     "upstream": ["生产(绑定工单带入产品批次)"], "downstream": ["BI(产量统计)"],
     "coreTables": ["mes_dc_device", "mes_dc_record"]},
    {"key": "wm", "name": "仓储管理", "color": "#7e6bd6", "tag": "MES-WM", "flow": "warehouse",
     "positioning": "厂内 WMS:单据驱动的库存账实一致",
     "problem": "多来源出入库、批次/SN è¿½æº¯ã€åº“存精确到库位",
@@ -503,7 +514,9 @@
    {"name": "离职交接", "module": "人力", "table": "hrm_user_handover", "doc": "from→to æ˜ å°„,已完成20 åŽ expandUserIds æ‰©å±•交接人可见数据(当前各业务模块尚未实际接入调用)", "upstream": ["离职申请"], "downstream": ["各模块我的数据查询"], "keywords": "交接 ç¦»èŒ handover expandUserIds"},
    {"name": "排班计划", "module": "设备", "table": "mes_cal_plan", "doc": "班组×班次×日期排班,供生产与考勤引用", "upstream": [], "downstream": ["生产任务", "考勤"], "keywords": "排班 ç­ç»„ ç­æ¬¡ æ—¥åކ"},
    {"name": "报告模板", "module": "质检报告", "table": "qc_report_template", "doc": "智能质检报告模板,启用0/停用1;画布内容存在 qc_report_template_version(草稿0/已发布1/已停用2,已发布不可覆盖),currentVersion æŒ‡å‘当前已发布版本;源文件经 AI å¯¼å…¥è¯†åˆ«æˆè‰ç¨¿åŽç”±äººå·¥ç¡®è®¤æ‰æˆä¸ºç‰ˆæœ¬ï¼›åŒä¸€æ¨¡æ¿é‡å¤å¯¼å…¥æŒ‰ã€æ›¿æ¢ã€‘处理——先删旧附件(连带 blob è¡Œä¸Žç£ç›˜æ–‡ä»¶ï¼‰å†ç»‘新的,不留孤儿文件;删除模板会连带清附件", "upstream": ["人工设计(GrapesJS è®¾è®¡å™¨)", "AI å¯¼å…¥è‰ç¨¿(qc-report/ai-import/draft)"], "downstream": ["模板版本", "报告实例"], "keywords": "报告模板 è´¨æ£€æŠ¥å‘Š template è®¾è®¡å™¨ ç‰ˆæœ¬ AI导入 è¯†åˆ« è‰ç¨¿ æºæ–‡ä»¶æ›¿æ¢"},
    {"name": "报告实例", "module": "质检报告", "table": "qc_report_instance", "doc": "出件产物,编号 QR+yyyyMMdd+4位流水按天独立且业务唯一,可显式指定覆盖(注意 uk_report_no ä¸åŒºåˆ†è½¯åˆ é™¤ï¼Œåˆ æŽ‰çš„号不回收);两条出件入口:通用 generate(调用方自带 context)与 generate-from-qc(数据从 MES è´¨æ£€å•取,权限码 qc-report:instance:generate å·²å…¥ system_menu id=1075416,五道校验按业务优先级只报第一处:105_000 ç±»åž‹éžæ³• / 105_001 å•据不存在 / 105_002 æœªå®Œæˆ / 105_003 æœªåˆ¤å®š / 105_005 æ¨¡æ¿ç±»åž‹ä¸ç¬¦ / 105_006 æ— å¯ç”¨æ£€éªŒé¡¹ï¼›å››å¼ è´¨æ£€å•列表的行操作「出报告」仅在 status=已完成时可见,弹窗只列 reportType ä¸€è‡´ã€æ¨¡æ¿å¯ç”¨ã€ä¸” currentVersion æŒ‡å‘的版本已发布的模板(后端 /qc-report/template/selectable åˆ¤å®šâ€”—停用版本不清空 currentVersion,前端拿分页结果自己推导会漏),结果就地展示并跳本页列表);冻结 data_snapshot(判定后数据,含后端算好的 PASS/FAIL ä¸Žåˆæ ¼çŽ‡ï¼‰ä¸Ž render_html;regenerate åªé‡æ¸²æŽ’版、数据与编号不变;business_id/business_type å­˜ MES è¡¨åï¼ˆmes_qc_iqc ç­‰ï¼‰ä¸Žå•据 ID,可反查、一单可出多份;报告头另带单据原判定 qcResult(数)/qcResultText(中文,合格/特采/不合格退货/不合格报废),与引擎三态判定并存互不覆盖;响应带 undecidableCount=快照中 result ä¸ºç©ºä¸²çš„项数与 warnings(分组标题跳过/指标已删/未录实测值/样品超3),两者都不落库、事后看不到", "upstream": ["报告模板版本", "质检单上下文(通用 generate ç”±è°ƒç”¨æ–¹ä¼ å…¥)", "MES è´¨æ£€å• IQC/IPQC/OQC/RQC(generate-from-qc ç» MesQcReportApi å–æ•°)"], "downstream": ["前端实例页 /qc/report-instance(列表·iframe预览·快照页签·导出PDF)", "PDF归档(system_storage_attachment recordType=qc_report_instance)"], "keywords": "报告实例 å‡ºä»¶ QR编号 å¿«ç…§ å¤çް regenerate PDF归档 æŠ¥å‘Šå®žä¾‹é¡µ å¯¼å‡ºPDF generate-from-qc è´¨æ£€å•出报告 å‡ºæŠ¥å‘Šå¼¹çª— qcResult undecidableCount warnings å¾…判定 åæŸ¥ ä¸šåŠ¡å•æ®ç­›é€‰"}
    {"name": "报告实例", "module": "质检报告", "table": "qc_report_instance", "doc": "出件产物,编号 QR+yyyyMMdd+4位流水按天独立且业务唯一,可显式指定覆盖(注意 uk_report_no ä¸åŒºåˆ†è½¯åˆ é™¤ï¼Œåˆ æŽ‰çš„号不回收);两条出件入口:通用 generate(调用方自带 context)与 generate-from-qc(数据从 MES è´¨æ£€å•取,权限码 qc-report:instance:generate å·²å…¥ system_menu id=1075416,五道校验按业务优先级只报第一处:105_000 ç±»åž‹éžæ³• / 105_001 å•据不存在 / 105_002 æœªå®Œæˆ / 105_003 æœªåˆ¤å®š / 105_005 æ¨¡æ¿ç±»åž‹ä¸ç¬¦ / 105_006 æ— å¯ç”¨æ£€éªŒé¡¹ï¼›å››å¼ è´¨æ£€å•列表的行操作「出报告」仅在 status=已完成时可见,弹窗只列 reportType ä¸€è‡´ã€æ¨¡æ¿å¯ç”¨ã€ä¸” currentVersion æŒ‡å‘的版本已发布的模板(后端 /qc-report/template/selectable åˆ¤å®šâ€”—停用版本不清空 currentVersion,前端拿分页结果自己推导会漏),结果就地展示并跳本页列表);冻结 data_snapshot(判定后数据,含后端算好的 PASS/FAIL ä¸Žåˆæ ¼çŽ‡ï¼‰ä¸Ž render_html;regenerate åªé‡æ¸²æŽ’版、数据与编号不变;business_id/business_type å­˜ MES è¡¨åï¼ˆmes_qc_iqc ç­‰ï¼‰ä¸Žå•据 ID,可反查、一单可出多份;报告头另带单据原判定 qcResult(数)/qcResultText(中文,合格/特采/不合格退货/不合格报废),与引擎三态判定并存互不覆盖;响应带 undecidableCount=快照中 result ä¸ºç©ºä¸²çš„项数与 warnings(分组标题跳过/指标已删/未录实测值/样品超3),两者都不落库、事后看不到", "upstream": ["报告模板版本", "质检单上下文(通用 generate ç”±è°ƒç”¨æ–¹ä¼ å…¥)", "MES è´¨æ£€å• IQC/IPQC/OQC/RQC(generate-from-qc ç» MesQcReportApi å–æ•°)"], "downstream": ["前端实例页 /qc/report-instance(列表·iframe预览·快照页签·导出PDF)", "PDF归档(system_storage_attachment recordType=qc_report_instance)"], "keywords": "报告实例 å‡ºä»¶ QR编号 å¿«ç…§ å¤çް regenerate PDF归档 æŠ¥å‘Šå®žä¾‹é¡µ å¯¼å‡ºPDF generate-from-qc è´¨æ£€å•出报告 å‡ºæŠ¥å‘Šå¼¹çª— qcResult undecidableCount warnings å¾…判定 åæŸ¥ ä¸šåŠ¡å•æ®ç­›é€‰"},
    {"name": "采集设备", "module": "数据采集", "table": "mes_dc_device", "doc": "鸡爪计数/称重设备台账,编号唯一;40 ä½é‡‡é›†ä»¤ç‰Œä»…创建与重置时返回、库内哈希存储;最后心跳/上报时间与固件版本由设备请求更新,最后心跳 5 åˆ†é’Ÿå†…视为在线;同一时间只绑定一张未完工、未取消的生产工单,已有采集记录的设备禁止删除;设备禁用时拒绝上报与心跳以外的采集操作", "upstream": ["生产工单(绑定)"], "downstream": ["采集记录", "实时看板"], "keywords": "采集设备 æ•°é‡‡ é¸¡çˆªè®¡æ•° ç§°é‡ ä»¤ç‰Œ token å¿ƒè·³ åœ¨çº¿ device"},
    {"name": "采集记录", "module": "数据采集", "table": "mes_dc_record", "doc": "设备上报产生,正常0/已更正1/已作废2;同一设备+bizId å¹‚等只落一条,重复上报返回首次记录并标记 duplicate=true;只报 totalCount æ—¶æŒ‰æœ¬æ¬¡ç´¯è®¡-上次累计计算本次数量,首次或计数器清零按本次累计;上报时设备已绑定工单则自动带入生产工单、产品编码名称与批次,历史记录不回溯改绑;仅正常状态可更正且保留原始数量与原因,已作废不可重复作废;统计与看板排除作废记录、已更正按更正后数量参与", "upstream": ["采集设备", "生产工单(绑定带入)", "设备端上报"], "downstream": ["实时看板", "统计分析", "Excel导出"], "keywords": "采集记录 ä¸ŠæŠ¥ ingest å¹‚ç­‰ bizId ç´¯è®¡ æ›´æ­£ ä½œåºŸ äº§é‡ record"}
  ]
}</script>
<script type="application/json" id="data-flows">{
@@ -572,7 +585,17 @@
       {"stage": "辅助判定", "action": "质检单+指标+缺陷 â†’ å»ºè®®åˆæ ¼/特采/退货/报废+理由", "roles": ["质检员"]},
       {"stage": "决策预测", "action": "缺料/生产时长/生产风险/交付四类预测供计划排产参考", "roles": ["计划员"]},
       {"stage": "模板识别", "action": "上传既有检验报告文件(扫描件/照片、电子版 PDF、Word/Excel) â†’ åˆ†é€šé“抽取(有文本层走文本、扫描版逐页转图) â†’ å¤§æ¨¡åž‹æŒ‰å‰ç«¯ä¸Šä¼ çš„组件清单产出扁平组件草稿 â†’ äººå·¥åœ¨è®¾è®¡å™¨ç¡®è®¤åŽä¿å­˜ä¸ºæ¨¡æ¿ç‰ˆæœ¬", "roles": ["质检员", "质量工程师"]},
       {"stage": "知识检索", "action": "文档→切片→Milvus å‘量→检索接口(预留)", "roles": ["—"]}]}
       {"stage": "知识检索", "action": "文档→切片→Milvus å‘量→检索接口(预留)", "roles": ["—"]}]},
    {"id": "datacollection", "name": "数据采集流程", "mermaid": "mermaid/12-data-collection-flow.mmd", "color": "#3fa9a0",
     "summary": "设备建档发放一次性令牌 â†’ çŽ°åœºç½‘å…³å¿ƒè·³ä¸Žä¸ŠæŠ¥(幂等·支持只报累计值) â†’ ç»‘定生产工单后新记录带入工单/产品/批次 â†’ è®°å½•æ›´æ­£/作废留痕 â†’ å®žæ—¶çœ‹æ¿ä¸Žç»Ÿè®¡åˆ†æžï¼›ç¬¬ä¸€é˜¶æ®µåªé‡‡é›†å±•示统计,不自动回写生产报工与包装。",
     "steps": [
       {"stage": "接入", "action": "新增采集设备(编号/名称/类型),创建时一次性显示 40 ä½ä»¤ç‰Œå¹¶é…ç½®åˆ°çŽ°åœºç½‘å…³ï¼›è®¾å¤‡ç«¯è¯·æ±‚æºå¸¦ X-Device-Token(也支持 URL å‚æ•° token,请求头优先),遗失只能重置且旧令牌立即失效", "roles": ["设备管理员", "现场同事"]},
       {"stage": "心跳", "action": "设备建议每 1 åˆ†é’Ÿä¸ŠæŠ¥å¿ƒè·³ï¼Œæ›´æ–°æœ€åŽå¿ƒè·³æ—¶é—´ä¸Žå›ºä»¶ç‰ˆæœ¬ï¼›æœ€åŽå¿ƒè·³ 5 åˆ†é’Ÿå†…为在线,超时视为离线;禁用设备拒绝上报", "roles": ["现场网关"]},
       {"stage": "上报", "action": "上报 count æˆ– totalCount(都传以 count ä¸ºå‡†):同一设备+同一 bizId åªè½ä¸€æ¡ï¼Œé‡å¤è¯·æ±‚返回首次记录并标记 duplicate=true;只报累计值时按本次累计-上次累计计算,首次或计数器清零按本次累计;离线补报传 online=false", "roles": ["现场网关"]},
       {"stage": "绑定", "action": "设备绑定未完工、未取消的生产工单(同一时间一张,换单先解绑);仅后续新上报记录自动带入工单编号、产品编码名称与生产批次,历史记录不回溯;解绑后新记录不再带工单信息", "roles": ["设备管理员"]},
       {"stage": "追溯", "action": "正常记录可更正(数量改为实际值并填原因,保留原始数量,状态1)或作废(状态2,仍可查询);仅正常状态可更正且更正后不可再改,已作废不可重复作废", "roles": ["生产统计员"]},
       {"stage": "统计", "action": "实时看板展示设备在线与今日产量;统计分析按时间范围/设备/工单给出数量、重量、记录数、设备数与日/小时趋势,排除作废记录、已更正按更正后数量参与;可按筛选条件导出 Excel", "roles": ["生产统计员", "管理层"]},
       {"stage": "边界", "action": "第一阶段采集数量只做展示与统计,不自动回写生产报工、包装或库存;回写逻辑待后续需求确认", "roles": ["系统(不执行)"]}]}
  ]
}</script>
<script type="application/json" id="data-roles">{
@@ -593,6 +616,7 @@
    {"role": "仓管员", "modules": ["MES-WM"], "operations": ["15 ç±»å‡ºå…¥åº“单据执行", "调拨", "盘点", "条码装箱"], "data": ["mes_wm_*"], "scope": "仓库维度;WMS å¯æŒ‰ä»“库配置出入库/调拨/盘点是否走 BPM"},
    {"role": "质检员", "modules": ["MES-QC"], "operations": ["IQC/IPQC/OQC/RQC æ£€éªŒ", "NCR è¯„审处置"], "data": ["mes_qc_*"], "scope": "inspectorUserId å½’属"},
    {"role": "设备员/维修工", "modules": ["MES-DV"], "operations": ["点检保养", "维修工单", "工装领用"], "data": ["mes_dv_*", "mes_tm_*"], "scope": "chargeUserId å½’属"},
    {"role": "设备管理员/生产统计员", "modules": ["MES-DC"], "operations": ["采集设备台账与令牌重置", "绑定/解绑生产工单", "采集记录更正与作废", "实时看板与统计分析"], "data": ["mes_dc_device", "mes_dc_record"], "scope": "菜单权限控制:mes:dc-device:* / mes:dc-record:* / mes:dc-statistics:query"},
    {"role": "客服/售后工程师", "modules": ["售后"], "operations": ["工单受理派工", "ç»´ä¿®", "退货申请"], "data": ["after_sale_*"], "scope": "行级数据权限四视图:我负责/我参与/下属负责/全部(aftersales:view-all)"},
    {"role": "财务", "modules": ["ERP", "CRM"], "operations": ["收款单", "付款单", "开票审核", "结算账户"], "data": ["erp_finance_*", "crm_invoice", "crm_receivable"], "scope": "financeUserId å½’属"},
    {"role": "HR", "modules": ["HRM"], "operations": ["员工档案入转调离", "考勤规则排班(本人打卡全员可用,不设权限点)", "薪酬核算发放", "离职交接"], "data": ["hrm_*"], "scope": "部门范围 dataScope"},
@@ -639,6 +663,12 @@
      å·¥å•BOM
      ç ”发设计项目
      å®‰ç¯
    æ•°æ®é‡‡é›† MES-DC
      é‡‡é›†è®¾å¤‡å°è´¦ä¸Žä»¤ç‰Œ
      è®¾å¤‡ä¸ŠæŠ¥ä¸Žå¿ƒè·³
      å·¥å•绑定与数据带入
      é‡‡é›†è®°å½•更正作废
      å®žæ—¶çœ‹æ¿ä¸Žç»Ÿè®¡åˆ†æž
    ä»“储管理 MES-WM
      ä»“库库区库位
      åˆ°è´§é€šçŸ¥
@@ -956,6 +986,9 @@
  AI -.->|质检判定与生产预测| MES
  MES -.->|质检单上下文·本轮由调用方传入 å¾… MesQcReportApi æ‰“通| QCR[智能质检报告 qcreport æ¨¡æ¿ç‰ˆæœ¬å®žä¾‹å¿«ç…§]
  QCR -.->|PDF å½’档·后续轮次| STG
  MES -.->|绑定工单带入产品与批次| DC[数据采集 MES-DC è®¾å¤‡å°è´¦Â·é‡‡é›†è®°å½•]
  DC -->|采集产量与趋势| BI
  DC -.->|第一阶段不回写报工与包装| MES
  MES --> BI[BI ç®¡ç†é©¾é©¶èˆ± SQL配置大屏]
  ERP --> BI
  CRM --> BI
@@ -1038,6 +1071,18 @@
  UIREP -.->|结果就地展示 reportNo itemCount ä¸Ž undecidableCount å‘Šè­¦| QCFE
  QCFE -.->|进入时带 businessType+businessId è·¯ç”± query·预填搜索表单的「业务单据」字段| UIREP
  RPT -.->|权限码 qc-report:template:ai-import å·²å…¥ system_menu| SYS1
  subgraph S5 [数据采集 MES-DC]
    DCD[采集设备台账·40位一次性令牌] -->|创建或重置令牌配置到网关| DCG[现场网关·鸡爪计数称重设备]
    DCG -->|X-Device-Token å¿ƒè·³Â·çº¦1分钟一次| DCG2[最后心跳/固件版本更新]
    DCG -->|X-Device-Token ä¸ŠæŠ¥ count æˆ– totalCount·bizId幂等| DCR[采集记录·正常0]
    DCR --> DCC[已更正1·留原始数量与原因]
    DCR --> DCX[已作废2·仍可查询]
    DCR --> DCS[实时看板·今日产量与在线状态]
    DCR --> DCT[统计分析·汇总/趋势/按设备]
  end
  WO -->|设备绑定未完工未取消工单·仅后续新记录带入工单产品批次| DCR
  DCS -.->|产量趋势进大屏| BI[BI ç®¡ç†é©¾é©¶èˆ±]
  DCT -.->|第一阶段不回写报工与包装| WO
</pre>
<pre style="display:none" class="mmd-src" data-mmd="10-business-object">
erDiagram
@@ -1081,6 +1126,10 @@
  hrm_employee ||--o{ hrm_employee_contract : "签订合同(自动生成合同文档)"
  qc_report_template ||--o{ qc_report_template_version : "多版本"
  qc_report_template_version ||--o{ qc_report_instance : "冻结出件版本"
  mes_dc_device ||--o{ mes_dc_record : "产生采集记录"
  mes_pro_work_order ||--o{ mes_dc_device : "设备绑定工单"
  mes_pro_work_order ||--o{ mes_dc_record : "记录带入工单产品批次"
  mdm_item ||--o{ mes_dc_record : "采集产品"
</pre>
<pre style="display:none" class="mmd-src" data-mmd="11-ai-business-flow">
flowchart TD
@@ -1146,6 +1195,32 @@
  AHIDE -.-> R2
</pre>
<pre style="display:none" class="mmd-src" data-mmd="12-data-collection-flow">
flowchart LR
  DEV[现场计数称重设备 é¸¡çˆªè‡ªåŠ¨è®¡æ•°] -->|HTTP JSON| GW[现场网关]
  DEVADMIN[采集设备台账] -->|新增设备·一次性显示40位令牌| TOKEN[采集令牌 X-Device-Token]
  TOKEN -->|配置到网关·遗失只能重置| GW
  GW -->|心跳 å»ºè®®æ¯1分钟 æºå¸¦å›ºä»¶ç‰ˆæœ¬IP| HB[心跳接口]
  HB -->|更新最后心跳时间与固件版本| DEVADMIN
  DEVADMIN -->|最后心跳5分钟内=在线 è¶…æ—¶=离线| DASH[实时看板]
  GW -->|上报 count æˆ– totalCount å¯å¸¦bizId| ING[上报接口]
  ING -->|同一设备+bizId é‡å¤è¿”回首次记录 duplicate=true| ING
  ING -->|只报累计值按本次累计-上次累计 é¦–次或清零按本次累计| ING
  ING -->|禁用设备拒绝上报| ERR[业务错误码]
  ING --> REC[采集记录 æ­£å¸¸0]
  WO[生产工单 æœªå®Œå·¥æœªå–消] -->|设备绑定工单 åŒä¸€æ—¶é—´ä¸€å¼ | DEVADMIN
  WO -->|仅后续新记录带入 å·¥å•编号 äº§å“ç¼–码名称 ç”Ÿäº§æ‰¹æ¬¡| REC
  REC -->|更正 ä»…正常态 ç•™åŽŸå§‹æ•°é‡ä¸ŽåŽŸå› | COR[已更正1]
  REC -->|作废 ä¸å¯é‡å¤ä½œåºŸ| CAN[已作废2]
  REC --> DASH
  REC --> STAT[统计分析 æ•°é‡ é‡é‡ è®°å½•æ•° è®¾å¤‡æ•° æ—¥æˆ–小时趋势]
  COR -->|按更正后数量参与| STAT
  CAN -.->|作废不参与统计与看板| STAT
  STAT -->|按筛选条件导出全部匹配行| XLS[Excel导出]
  STAT -.->|第一阶段不回写 ç”Ÿäº§æŠ¥å·¥ åŒ…装 åº“å­˜| WO
  GW -.->|离线补报 online=false| ING
</pre>
<script type="module">
const DATA = {};
async function loadJson(key){
@@ -1164,7 +1239,7 @@
const mmdSrc = {};
document.querySelectorAll('pre.mmd-src').forEach(p=>{ mmdSrc[p.dataset.mmd]=p.textContent.trim(); });
const flowColor = {sales:'var(--c-sale)',purchase:'var(--c-erp)',production:'var(--c-prod)',quality:'var(--c-qc)',warehouse:'var(--c-wm)',aftersales:'var(--c-as)',ai:'var(--c-ai)'};
const flowColor = {sales:'var(--c-sale)',purchase:'var(--c-erp)',production:'var(--c-prod)',datacollection:'var(--c-dc)',quality:'var(--c-qc)',warehouse:'var(--c-wm)',aftersales:'var(--c-as)',ai:'var(--c-ai)'};
async function boot(){
  DATA.business = await loadJson('business');
@@ -1201,8 +1276,8 @@
  </div>
  <h3 class="sec">业务模块</h3>
  <div class="grid cards">`;
  const targets = {crm:'flow-sales',erp:'flow-purchase',pro:'flow-production',wm:'flow-warehouse',qc:'flow-quality',aftersales:'flow-aftersales',ai:'ai',srm:'flow-purchase',mdm:'objects',dv:'objects',hrm:'objects',bpm:'relation'};
  const accs = {mdm:'var(--c-base)',crm:'var(--c-sale)',srm:'var(--c-sup)',erp:'var(--c-erp)',pro:'var(--c-prod)',wm:'var(--c-wm)',qc:'var(--c-qc)',dv:'var(--c-dv)',aftersales:'var(--c-as)',hrm:'var(--c-hrm)',bpm:'var(--c-bpm)',ai:'var(--c-ai)'};
  const targets = {crm:'flow-sales',erp:'flow-purchase',pro:'flow-production',dc:'flow-datacollection',wm:'flow-warehouse',qc:'flow-quality',aftersales:'flow-aftersales',ai:'ai',srm:'flow-purchase',mdm:'objects',dv:'objects',hrm:'objects',bpm:'relation'};
  const accs = {mdm:'var(--c-base)',crm:'var(--c-sale)',srm:'var(--c-sup)',erp:'var(--c-erp)',pro:'var(--c-prod)',dc:'var(--c-dc)',wm:'var(--c-wm)',qc:'var(--c-qc)',dv:'var(--c-dv)',aftersales:'var(--c-as)',hrm:'var(--c-hrm)',bpm:'var(--c-bpm)',ai:'var(--c-ai)'};
  DATA.modules.modules.forEach(m=>{
    html += `<div class="card" style="--acc:${accs[m.key]||'#2c5cff'}" data-goto="${targets[m.key]||'panorama'}">
      <h3>${esc(m.name)}<span class="tag">${esc(m.tag)}</span></h3>
docs/project-business/mermaid/01-business-mindmap.mmd
@@ -37,6 +37,12 @@
      å·¥å•BOM
      ç ”发设计项目
      å®‰ç¯
    æ•°æ®é‡‡é›† MES-DC
      é‡‡é›†è®¾å¤‡å°è´¦ä¸Žä»¤ç‰Œ
      è®¾å¤‡ä¸ŠæŠ¥ä¸Žå¿ƒè·³
      å·¥å•绑定与数据带入
      é‡‡é›†è®°å½•更正作废
      å®žæ—¶çœ‹æ¿ä¸Žç»Ÿè®¡åˆ†æž
    ä»“储管理 MES-WM
      ä»“库库区库位
      åˆ°è´§é€šçŸ¥
docs/project-business/mermaid/08-module-relation.mmd
@@ -21,6 +21,9 @@
  AI -.->|质检判定与生产预测| MES
  MES -.->|质检单上下文·本轮由调用方传入 å¾… MesQcReportApi æ‰“通| QCR[智能质检报告 qcreport æ¨¡æ¿ç‰ˆæœ¬å®žä¾‹å¿«ç…§]
  QCR -.->|PDF å½’档·后续轮次| STG
  MES -.->|绑定工单带入产品与批次| DC[数据采集 MES-DC è®¾å¤‡å°è´¦Â·é‡‡é›†è®°å½•]
  DC -->|采集产量与趋势| BI
  DC -.->|第一阶段不回写报工与包装| MES
  MES --> BI[BI ç®¡ç†é©¾é©¶èˆ± SQL配置大屏]
  ERP --> BI
  CRM --> BI
docs/project-business/mermaid/09-data-flow.mmd
@@ -71,3 +71,15 @@
  UIREP -.->|结果就地展示 reportNo itemCount ä¸Ž undecidableCount å‘Šè­¦| QCFE
  QCFE -.->|进入时带 businessType+businessId è·¯ç”± query·预填搜索表单的「业务单据」字段| UIREP
  RPT -.->|权限码 qc-report:template:ai-import å·²å…¥ system_menu| SYS1
  subgraph S5 [数据采集 MES-DC]
    DCD[采集设备台账·40位一次性令牌] -->|创建或重置令牌配置到网关| DCG[现场网关·鸡爪计数称重设备]
    DCG -->|X-Device-Token å¿ƒè·³Â·çº¦1分钟一次| DCG2[最后心跳/固件版本更新]
    DCG -->|X-Device-Token ä¸ŠæŠ¥ count æˆ– totalCount·bizId幂等| DCR[采集记录·正常0]
    DCR --> DCC[已更正1·留原始数量与原因]
    DCR --> DCX[已作废2·仍可查询]
    DCR --> DCS[实时看板·今日产量与在线状态]
    DCR --> DCT[统计分析·汇总/趋势/按设备]
  end
  WO -->|设备绑定未完工未取消工单·仅后续新记录带入工单产品批次| DCR
  DCS -.->|产量趋势进大屏| BI[BI ç®¡ç†é©¾é©¶èˆ±]
  DCT -.->|第一阶段不回写报工与包装| WO
docs/project-business/mermaid/10-business-object.mmd
@@ -39,3 +39,7 @@
  hrm_employee ||--o{ hrm_employee_contract : "签订合同(自动生成合同文档)"
  qc_report_template ||--o{ qc_report_template_version : "多版本"
  qc_report_template_version ||--o{ qc_report_instance : "冻结出件版本"
  mes_dc_device ||--o{ mes_dc_record : "产生采集记录"
  mes_pro_work_order ||--o{ mes_dc_device : "设备绑定工单"
  mes_pro_work_order ||--o{ mes_dc_record : "记录带入工单产品批次"
  mdm_item ||--o{ mes_dc_record : "采集产品"
docs/sql/config_export_all_20261110.sql
¶Ô±ÈÐÂÎļþ
ÎļþÌ«´ó
sql/mysql/mes_dc_init_20261110.sql
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,218 @@
-- ============================================
-- MES æ•°æ®é‡‡é›†ï¼ˆéœ€æ±‚6 é¸¡çˆªæ•°é‡‡å¯¹æŽ¥ï¼‰åˆå§‹åŒ–脚本
-- å¯é‡å¤æ‰§è¡Œ
-- ============================================
-- 1. é‡‡é›†è®¾å¤‡è¡¨
CREATE TABLE IF NOT EXISTS `mes_dc_device` (
    `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID',
    `code` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '设备编号(设备端上报时使用)',
    `name` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '设备名称',
    `device_type` varchar(32) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT 'CHICKEN_FEET_COUNTER' COMMENT '设备类型',
    `model` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '设备型号',
    `serial_no` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '设备序列号',
    `location` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '安装位置',
    `status` tinyint NOT NULL DEFAULT 0 COMMENT '设备状态:0 å¯ç”¨ / 1 ç¦ç”¨',
    `token` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '采集令牌(设备端 X-Device-Token)',
    `work_order_id` bigint NULL DEFAULT NULL COMMENT '当前绑定生产工单ID',
    `work_order_code` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '当前绑定生产工单编号(冗余)',
    `bind_time` datetime NULL DEFAULT NULL COMMENT '绑定工单时间',
    `last_heartbeat_time` datetime NULL DEFAULT NULL COMMENT '最后心跳时间',
    `last_ingest_time` datetime NULL DEFAULT NULL COMMENT '最后数据上报时间',
    `firmware_version` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '固件版本',
    `device_ip` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '设备IP',
    `remark` varchar(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '备注',
    `creator` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT '' COMMENT '创建者',
    `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    `updater` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT '' COMMENT '更新者',
    `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
    `deleted` bit(1) NOT NULL DEFAULT b'0' COMMENT '是否删除',
    PRIMARY KEY (`id`) USING BTREE,
    UNIQUE INDEX `uk_code` (`code`) USING BTREE,
    INDEX `idx_work_order_id` (`work_order_id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 1 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci COMMENT = 'MES æ•°æ®é‡‡é›†è®¾å¤‡' ROW_FORMAT = Dynamic;
-- 2. é‡‡é›†è®°å½•表
CREATE TABLE IF NOT EXISTS `mes_dc_record` (
    `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID',
    `device_id` bigint NOT NULL COMMENT '采集设备ID',
    `device_code` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '设备编号(冗余)',
    `device_name` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '设备名称(冗余)',
    `work_order_id` bigint NULL DEFAULT NULL COMMENT '采集时绑定的生产工单ID',
    `work_order_code` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '生产工单编号(冗余)',
    `product_id` bigint NULL DEFAULT NULL COMMENT '产品ID',
    `product_code` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '产品编码(冗余)',
    `product_name` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '产品名称(冗余)',
    `batch_code` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '生产批次号',
    `record_no` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '设备侧记录序号',
    `biz_id` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '设备侧唯一键(用于幂等)',
    `quantity` int NOT NULL COMMENT '本次采集数量',
    `total_quantity` int NULL DEFAULT NULL COMMENT '设备累计数量(设备只报累计值时用于计算差值)',
    `weight` decimal(12, 2) NULL DEFAULT NULL COMMENT '本次重量(g)',
    `total_weight` decimal(12, 2) NULL DEFAULT NULL COMMENT '设备累计重量(g)',
    `record_time` datetime NOT NULL COMMENT '设备采集时间',
    `receive_time` datetime NOT NULL COMMENT '服务器接收时间',
    `online` bit(1) NOT NULL DEFAULT b'1' COMMENT '是否在线实时上报(离线补报为 0)',
    `raw_data` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL COMMENT '原始上报报文',
    `status` tinyint NOT NULL DEFAULT 0 COMMENT '记录状态:0 æ­£å¸¸ / 1 å·²æ›´æ­£ / 2 å·²ä½œåºŸ',
    `original_quantity` int NULL DEFAULT NULL COMMENT '更正前的原始数量(首次更正时留痕)',
    `correct_reason` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '更正/作废原因',
    `remark` varchar(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL COMMENT '备注',
    `creator` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT '' COMMENT '创建者',
    `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    `updater` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT '' COMMENT '更新者',
    `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
    `deleted` bit(1) NOT NULL DEFAULT b'0' COMMENT '是否删除',
    PRIMARY KEY (`id`) USING BTREE,
    UNIQUE INDEX `uk_device_biz` (`device_id`, `biz_id`) USING BTREE,
    INDEX `idx_device_time` (`device_id`, `record_time`) USING BTREE,
    INDEX `idx_work_order_id` (`work_order_id`) USING BTREE,
    INDEX `idx_record_time` (`record_time`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 1 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci COMMENT = 'MES æ•°æ®é‡‡é›†è®°å½•' ROW_FORMAT = Dynamic;
-- 3. å­—典类型
INSERT INTO `system_dict_type` (`name`, `type`, `status`, `remark`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 'MES æ•°æ®é‡‡é›†è®¾å¤‡ç±»åž‹', 'mes_dc_device_type', 0, 'MES æ•°æ®é‡‡é›†è®¾å¤‡ç±»åž‹', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_dict_type` WHERE `type` = 'mes_dc_device_type' AND `deleted` = b'0');
INSERT INTO `system_dict_type` (`name`, `type`, `status`, `remark`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 'MES æ•°æ®é‡‡é›†è®¾å¤‡çŠ¶æ€', 'mes_dc_device_status', 0, 'MES æ•°æ®é‡‡é›†è®¾å¤‡çŠ¶æ€', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_dict_type` WHERE `type` = 'mes_dc_device_status' AND `deleted` = b'0');
INSERT INTO `system_dict_type` (`name`, `type`, `status`, `remark`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 'MES æ•°æ®é‡‡é›†è®°å½•状态', 'mes_dc_record_status', 0, 'MES æ•°æ®é‡‡é›†è®°å½•状态', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_dict_type` WHERE `type` = 'mes_dc_record_status' AND `deleted` = b'0');
-- 4. å­—典数据
INSERT INTO `system_dict_data` (`sort`, `label`, `value`, `dict_type`, `status`, `color_type`, `css_class`, `remark`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1, '鸡爪计数称重设备', 'CHICKEN_FEET_COUNTER', 'mes_dc_device_type', 0, 'primary', '', '鸡爪自动计数/称重设备', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_dict_data` WHERE `dict_type` = 'mes_dc_device_type' AND `value` = 'CHICKEN_FEET_COUNTER' AND `deleted` = b'0');
INSERT INTO `system_dict_data` (`sort`, `label`, `value`, `dict_type`, `status`, `color_type`, `css_class`, `remark`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1, '启用', '0', 'mes_dc_device_status', 0, 'success', '', '', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_dict_data` WHERE `dict_type` = 'mes_dc_device_status' AND `value` = '0' AND `deleted` = b'0');
INSERT INTO `system_dict_data` (`sort`, `label`, `value`, `dict_type`, `status`, `color_type`, `css_class`, `remark`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 2, '禁用', '1', 'mes_dc_device_status', 0, 'danger', '', '', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_dict_data` WHERE `dict_type` = 'mes_dc_device_status' AND `value` = '1' AND `deleted` = b'0');
INSERT INTO `system_dict_data` (`sort`, `label`, `value`, `dict_type`, `status`, `color_type`, `css_class`, `remark`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1, '正常', '0', 'mes_dc_record_status', 0, 'success', '', '', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_dict_data` WHERE `dict_type` = 'mes_dc_record_status' AND `value` = '0' AND `deleted` = b'0');
INSERT INTO `system_dict_data` (`sort`, `label`, `value`, `dict_type`, `status`, `color_type`, `css_class`, `remark`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 2, '已更正', '1', 'mes_dc_record_status', 0, 'warning', '', '', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_dict_data` WHERE `dict_type` = 'mes_dc_record_status' AND `value` = '1' AND `deleted` = b'0');
INSERT INTO `system_dict_data` (`sort`, `label`, `value`, `dict_type`, `status`, `color_type`, `css_class`, `remark`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 3, '已作废', '2', 'mes_dc_record_status', 0, 'danger', '', '', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_dict_data` WHERE `dict_type` = 'mes_dc_record_status' AND `value` = '2' AND `deleted` = b'0');
-- 5. èœå•:生产管控 â†’ æ•°æ®é‡‡é›†
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080085, '数据采集', '', 1, 60, 5100, 'dc', 'ep:data-line', '', '', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080085);
-- 5.1 è®¾å¤‡ç®¡ç†
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080086, '设备管理', '', 2, 1, 1080085, 'device', 'ep:monitor', 'mes/dc/device/index', 'MesDcDevice', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080086);
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080087, '设备查询', 'mes:dc-device:query', 3, 1, 1080086, '', '', '', '', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080087);
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080088, '设备新增', 'mes:dc-device:create', 3, 2, 1080086, '', '', '', '', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080088);
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080089, '设备修改', 'mes:dc-device:update', 3, 3, 1080086, '', '', '', '', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080089);
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080090, '设备删除', 'mes:dc-device:delete', 3, 4, 1080086, '', '', '', '', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080090);
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080091, '重置令牌', 'mes:dc-device:reset-token', 3, 5, 1080086, '', '', '', '', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080091);
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080092, '绑定工单', 'mes:dc-device:bind', 3, 6, 1080086, '', '', '', '', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080092);
-- 5.2 å®žæ—¶çœ‹æ¿
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080093, '实时看板', '', 2, 2, 1080085, 'dashboard', 'ep:data-board', 'mes/dc/dashboard/index', 'MesDcDashboard', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080093);
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080094, '看板查询', 'mes:dc-statistics:query', 3, 1, 1080093, '', '', '', '', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080094);
-- 5.3 é‡‡é›†è®°å½•
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080095, '采集记录', '', 2, 3, 1080085, 'record', 'ep:list', 'mes/dc/record/index', 'MesDcRecord', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080095);
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080096, '记录查询', 'mes:dc-record:query', 3, 1, 1080095, '', '', '', '', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080096);
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080097, '记录更正', 'mes:dc-record:correct', 3, 2, 1080095, '', '', '', '', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080097);
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080098, '记录作废', 'mes:dc-record:cancel', 3, 3, 1080095, '', '', '', '', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080098);
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080099, '记录导出', 'mes:dc-record:export', 3, 4, 1080095, '', '', '', '', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080099);
-- 5.4 ç»Ÿè®¡åˆ†æž
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080100, '统计分析', '', 2, 4, 1080085, 'statistics', 'ep:trend-charts', 'mes/dc/statistics/index', 'MesDcStatistics', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080100);
INSERT INTO `system_menu` (`id`, `name`, `permission`, `type`, `sort`, `parent_id`, `path`, `icon`, `component`, `component_name`, `status`, `visible`, `keep_alive`, `always_show`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT 1080101, '统计查询', 'mes:dc-statistics:query', 3, 1, 1080100, '', '', '', '', 0, b'1', b'1', b'1', '1', NOW(), '1', NOW(), b'0'
FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM `system_menu` WHERE `id` = 1080101);
-- 6. è§’色授权(与现有生产/质检菜单保持一致:普通角色 + 155/160/162/163)
INSERT INTO `system_role_menu` (`role_id`, `menu_id`, `creator`, `create_time`, `updater`, `update_time`, `deleted`)
SELECT r.id, m.id, '1', NOW(), '1', NOW(), b'0'
FROM `system_role` r
JOIN `system_menu` m ON m.id IN (1080085, 1080086, 1080087, 1080088, 1080089, 1080090, 1080091, 1080092, 1080093, 1080094, 1080095, 1080096, 1080097, 1080098, 1080099, 1080100, 1080101) AND m.deleted = b'0'
WHERE r.id IN (2, 155, 160, 162, 163) AND r.deleted = b'0'
  AND NOT EXISTS (SELECT 1 FROM `system_role_menu` rm WHERE rm.role_id = r.id AND rm.menu_id = m.id);
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/device/MesDcDeviceController.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,128 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.device;
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
import cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo.MesDcDeviceBindWorkOrderReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo.MesDcDeviceCreateRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo.MesDcDevicePageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo.MesDcDeviceRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo.MesDcDeviceSaveReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.dc.device.MesDcDeviceDO;
import cn.iocoder.yudao.module.mes.service.dc.device.MesDcDeviceService;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.annotation.Resource;
import jakarta.validation.Valid;
import org.springframework.security.access.prepost.PreAuthorize;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
import java.time.LocalDateTime;
import java.util.List;
import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
@Tag(name = "管理后台 - MES æ•°æ®é‡‡é›†è®¾å¤‡")
@RestController
@RequestMapping("/mes/data-collection/device")
@Validated
public class MesDcDeviceController {
    /**
     * è®¾å¤‡åœ¨çº¿åˆ¤å®šé˜ˆå€¼ï¼ˆåˆ†é’Ÿï¼‰ï¼šè¶…过该时间无心跳视为离线
     */
    private static final int ONLINE_TIMEOUT_MINUTES = 5;
    @Resource
    private MesDcDeviceService deviceService;
    @PostMapping("/create")
    @Operation(summary = "创建设备")
    @PreAuthorize("@ss.hasPermission('mes:dc-device:create')")
    public CommonResult<MesDcDeviceCreateRespVO> createDevice(
            @Valid @RequestBody MesDcDeviceSaveReqVO createReqVO) {
        MesDcDeviceDO device = deviceService.createDevice(createReqVO);
        return success(new MesDcDeviceCreateRespVO(device.getId(), device.getToken()));
    }
    @PutMapping("/update")
    @Operation(summary = "更新设备")
    @PreAuthorize("@ss.hasPermission('mes:dc-device:update')")
    public CommonResult<Boolean> updateDevice(@Valid @RequestBody MesDcDeviceSaveReqVO updateReqVO) {
        deviceService.updateDevice(updateReqVO);
        return success(true);
    }
    @DeleteMapping("/delete")
    @Operation(summary = "删除设备")
    @Parameter(name = "id", description = "编号", required = true)
    @PreAuthorize("@ss.hasPermission('mes:dc-device:delete')")
    public CommonResult<Boolean> deleteDevice(@RequestParam("id") Long id) {
        deviceService.deleteDevice(id);
        return success(true);
    }
    @GetMapping("/get")
    @Operation(summary = "获得设备详情")
    @Parameter(name = "id", description = "编号", required = true, example = "1024")
    @PreAuthorize("@ss.hasPermission('mes:dc-device:query')")
    public CommonResult<MesDcDeviceRespVO> getDevice(@RequestParam("id") Long id) {
        MesDcDeviceDO device = deviceService.getDevice(id);
        return success(device == null ? null : buildDeviceRespVOList(List.of(device)).get(0));
    }
    @GetMapping("/page")
    @Operation(summary = "获得设备分页")
    @PreAuthorize("@ss.hasPermission('mes:dc-device:query')")
    public CommonResult<PageResult<MesDcDeviceRespVO>> getDevicePage(
            @Valid MesDcDevicePageReqVO pageReqVO) {
        PageResult<MesDcDeviceDO> pageResult = deviceService.getDevicePage(pageReqVO);
        return success(new PageResult<>(buildDeviceRespVOList(pageResult.getList()),
                pageResult.getTotal()));
    }
    @GetMapping("/simple-list")
    @Operation(summary = "获得设备精简列表")
    @PreAuthorize("@ss.hasPermission('mes:dc-device:query')")
    public CommonResult<List<MesDcDeviceRespVO>> getDeviceSimpleList() {
        return success(buildDeviceRespVOList(deviceService.getDeviceList()));
    }
    @PutMapping("/reset-token")
    @Operation(summary = "重置采集令牌")
    @Parameter(name = "id", description = "编号", required = true)
    @PreAuthorize("@ss.hasPermission('mes:dc-device:reset-token')")
    public CommonResult<String> resetToken(@RequestParam("id") Long id) {
        return success(deviceService.resetToken(id));
    }
    @PutMapping("/bind-work-order")
    @Operation(summary = "绑定生产工单")
    @PreAuthorize("@ss.hasPermission('mes:dc-device:bind')")
    public CommonResult<Boolean> bindWorkOrder(
            @Valid @RequestBody MesDcDeviceBindWorkOrderReqVO reqVO) {
        deviceService.bindWorkOrder(reqVO.getId(), reqVO.getWorkOrderId());
        return success(true);
    }
    @PutMapping("/unbind-work-order")
    @Operation(summary = "解绑生产工单")
    @Parameter(name = "id", description = "编号", required = true)
    @PreAuthorize("@ss.hasPermission('mes:dc-device:bind')")
    public CommonResult<Boolean> unbindWorkOrder(@RequestParam("id") Long id) {
        deviceService.unbindWorkOrder(id);
        return success(true);
    }
    // ==================== æ‹¼æŽ¥ VO ====================
    private static List<MesDcDeviceRespVO> buildDeviceRespVOList(List<MesDcDeviceDO> list) {
        LocalDateTime threshold = LocalDateTime.now().minusMinutes(ONLINE_TIMEOUT_MINUTES);
        return BeanUtils.toBean(list, MesDcDeviceRespVO.class,
                vo -> vo.setOnline(vo.getLastHeartbeatTime() != null
                        && vo.getLastHeartbeatTime().isAfter(threshold)));
    }
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/device/vo/MesDcDeviceBindWorkOrderReqVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,19 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotNull;
import lombok.Data;
@Schema(description = "管理后台 - MES é‡‡é›†è®¾å¤‡ç»‘定工单 Request VO")
@Data
public class MesDcDeviceBindWorkOrderReqVO {
    @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
    @NotNull(message = "设备编号不能为空")
    private Long id;
    @Schema(description = "生产工单编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "2048")
    @NotNull(message = "生产工单不能为空")
    private Long workOrderId;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/device/vo/MesDcDeviceCreateRespVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,20 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
@Schema(description = "管理后台 - MES é‡‡é›†è®¾å¤‡åˆ›å»º Response VO")
@Data
@NoArgsConstructor
@AllArgsConstructor
public class MesDcDeviceCreateRespVO {
    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
    private Long id;
    @Schema(description = "采集令牌(仅创建/重置时返回一次,请立即配置到设备端)", requiredMode = Schema.RequiredMode.REQUIRED)
    private String token;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/device/vo/MesDcDevicePageReqVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,33 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo;
import cn.iocoder.yudao.framework.common.pojo.PageParam;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.ToString;
@Schema(description = "管理后台 - MES é‡‡é›†è®¾å¤‡åˆ†é¡µ Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class MesDcDevicePageReqVO extends PageParam {
    @Schema(description = "设备编号", example = "DC001")
    private String code;
    @Schema(description = "设备名称", example = "一车间鸡爪计数器")
    private String name;
    @Schema(description = "设备类型", example = "CHICKEN_FEET_COUNTER")
    private String deviceType;
    @Schema(description = "设备状态:0 å¯ç”¨ / 1 ç¦ç”¨", example = "0")
    private Integer status;
    @Schema(description = "当前绑定生产工单ID", example = "1024")
    private Long workOrderId;
    @Schema(description = "当前绑定生产工单编号", example = "WO202611100001")
    private String workOrderCode;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/device/vo/MesDcDeviceRespVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,66 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import java.time.LocalDateTime;
@Schema(description = "管理后台 - MES é‡‡é›†è®¾å¤‡ Response VO")
@Data
public class MesDcDeviceRespVO {
    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
    private Long id;
    @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "DC001")
    private String code;
    @Schema(description = "设备名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "一车间鸡爪计数器")
    private String name;
    @Schema(description = "设备类型", example = "CHICKEN_FEET_COUNTER")
    private String deviceType;
    @Schema(description = "设备型号", example = "CF-2000")
    private String model;
    @Schema(description = "设备序列号", example = "SN20261110001")
    private String serialNo;
    @Schema(description = "安装位置", example = "一车间东侧包装线")
    private String location;
    @Schema(description = "设备状态:0 å¯ç”¨ / 1 ç¦ç”¨", example = "0")
    private Integer status;
    @Schema(description = "是否在线(5 åˆ†é’Ÿå†…有心跳)", example = "true")
    private Boolean online;
    @Schema(description = "当前绑定生产工单ID", example = "1024")
    private Long workOrderId;
    @Schema(description = "当前绑定生产工单编号", example = "WO202611100001")
    private String workOrderCode;
    @Schema(description = "绑定工单时间")
    private LocalDateTime bindTime;
    @Schema(description = "最后心跳时间")
    private LocalDateTime lastHeartbeatTime;
    @Schema(description = "最后数据上报时间")
    private LocalDateTime lastIngestTime;
    @Schema(description = "固件版本", example = "1.0.2")
    private String firmwareVersion;
    @Schema(description = "设备 IP", example = "192.168.1.50")
    private String deviceIp;
    @Schema(description = "备注")
    private String remark;
    @Schema(description = "创建时间")
    private LocalDateTime createTime;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/device/vo/MesDcDeviceSaveReqVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,51 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Size;
import lombok.Data;
@Schema(description = "管理后台 - MES é‡‡é›†è®¾å¤‡æ–°å¢ž/修改 Request VO")
@Data
public class MesDcDeviceSaveReqVO {
    @Schema(description = "编号", example = "1024")
    private Long id;
    @Schema(description = "设备编号(设备端上报时使用,创建后不可修改)", requiredMode = Schema.RequiredMode.REQUIRED, example = "DC001")
    @NotBlank(message = "设备编号不能为空")
    @Size(max = 64, message = "设备编号长度不能超过 64 ä¸ªå­—符")
    private String code;
    @Schema(description = "设备名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "一车间鸡爪计数器")
    @NotBlank(message = "设备名称不能为空")
    @Size(max = 100, message = "设备名称长度不能超过 100 ä¸ªå­—符")
    private String name;
    @Schema(description = "设备类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "CHICKEN_FEET_COUNTER")
    @NotBlank(message = "设备类型不能为空")
    @Size(max = 32, message = "设备类型长度不能超过 32 ä¸ªå­—符")
    private String deviceType;
    @Schema(description = "设备型号", example = "CF-2000")
    @Size(max = 100, message = "设备型号长度不能超过 100 ä¸ªå­—符")
    private String model;
    @Schema(description = "设备序列号", example = "SN20261110001")
    @Size(max = 100, message = "设备序列号长度不能超过 100 ä¸ªå­—符")
    private String serialNo;
    @Schema(description = "安装位置", example = "一车间东侧包装线")
    @Size(max = 200, message = "安装位置长度不能超过 200 ä¸ªå­—符")
    private String location;
    @Schema(description = "设备状态:0 å¯ç”¨ / 1 ç¦ç”¨", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
    @NotNull(message = "设备状态不能为空")
    private Integer status;
    @Schema(description = "备注", example = "鸡爪自动计数/称重设备")
    @Size(max = 500, message = "备注长度不能超过 500 ä¸ªå­—符")
    private String remark;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/open/MesDcOpenController.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,62 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.open;
import cn.hutool.core.util.StrUtil;
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcHeartbeatReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcHeartbeatRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcIngestReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcIngestRespVO;
import cn.iocoder.yudao.module.mes.service.dc.device.MesDcDeviceService;
import cn.iocoder.yudao.module.mes.service.dc.record.MesDcRecordService;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.annotation.Resource;
import jakarta.annotation.security.PermitAll;
import jakarta.validation.Valid;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
@Tag(name = "设备端 - MES æ•°æ®é‡‡é›†")
@RestController
@RequestMapping("/mes/data-collection/open")
@Validated
public class MesDcOpenController {
    @Resource
    private MesDcRecordService dcRecordService;
    @Resource
    private MesDcDeviceService deviceService;
    @PostMapping("/ingest")
    @Operation(summary = "接收设备上报的采集数据")
    @PermitAll
    public CommonResult<MesDcIngestRespVO> ingest(
            @Valid @RequestBody MesDcIngestReqVO reqVO,
            @RequestHeader(value = "X-Device-Token", required = false) String headerToken,
            @RequestParam(value = "token", required = false) String paramToken) {
        String token = resolveToken(headerToken, paramToken);
        return success(dcRecordService.ingest(reqVO, token, JsonUtils.toJsonString(reqVO)));
    }
    @PostMapping("/heartbeat")
    @Operation(summary = "接收设备心跳")
    @PermitAll
    public CommonResult<MesDcHeartbeatRespVO> heartbeat(
            @Valid @RequestBody MesDcHeartbeatReqVO reqVO,
            @RequestHeader(value = "X-Device-Token", required = false) String headerToken,
            @RequestParam(value = "token", required = false) String paramToken) {
        String token = resolveToken(headerToken, paramToken);
        return success(deviceService.heartbeat(reqVO, token));
    }
    /**
     * ä¼˜å…ˆå–请求头 X-Device-Token,其次取 URL å‚æ•° token
     */
    private static String resolveToken(String headerToken, String paramToken) {
        return StrUtil.isNotBlank(headerToken) ? headerToken : paramToken;
    }
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/open/vo/MesDcHeartbeatReqVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,25 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Size;
import lombok.Data;
@Schema(description = "设备端 - å¿ƒè·³ Request VO")
@Data
public class MesDcHeartbeatReqVO {
    @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "DC001")
    @NotBlank(message = "设备编号不能为空")
    @Size(max = 64, message = "设备编号长度不能超过 64 ä¸ªå­—符")
    private String deviceCode;
    @Schema(description = "固件版本", example = "1.0.2")
    @Size(max = 64, message = "固件版本长度不能超过 64 ä¸ªå­—符")
    private String firmwareVersion;
    @Schema(description = "设备 IP", example = "192.168.1.50")
    @Size(max = 64, message = "设备 IP é•¿åº¦ä¸èƒ½è¶…过 64 ä¸ªå­—符")
    private String ip;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/open/vo/MesDcHeartbeatRespVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,27 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import java.time.LocalDateTime;
@Schema(description = "设备端 - å¿ƒè·³ Response VO")
@Data
public class MesDcHeartbeatRespVO {
    @Schema(description = "服务器当前时间")
    private LocalDateTime serverTime;
    @Schema(description = "设备名称", example = "一车间鸡爪计数器")
    private String deviceName;
    @Schema(description = "设备是否启用", example = "true")
    private Boolean enabled;
    @Schema(description = "当前绑定生产工单ID", example = "2048")
    private Long workOrderId;
    @Schema(description = "当前绑定生产工单编号", example = "WO202611100001")
    private String workOrderCode;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/open/vo/MesDcIngestReqVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,50 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Size;
import lombok.Data;
import java.math.BigDecimal;
import java.time.LocalDateTime;
@Schema(description = "设备端 - é‡‡é›†æ•°æ®ä¸ŠæŠ¥ Request VO")
@Data
public class MesDcIngestReqVO {
    @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "DC001")
    @NotBlank(message = "设备编号不能为空")
    @Size(max = 64, message = "设备编号长度不能超过 64 ä¸ªå­—符")
    private String deviceCode;
    @Schema(description = "设备侧唯一键(推荐上报,用于重复上报幂等)", example = "20261110142305-0001")
    @Size(max = 64, message = "设备侧唯一键长度不能超过 64 ä¸ªå­—符")
    private String bizId;
    @Schema(description = "设备侧记录序号", example = "0001")
    @Size(max = 64, message = "设备侧记录序号长度不能超过 64 ä¸ªå­—符")
    private String recordNo;
    @Schema(description = "设备采集时间,不传则取服务器当前时间", example = "2026-11-10 14:23:05")
    private LocalDateTime recordTime;
    @Schema(description = "本次计数(与 totalCount è‡³å°‘填一个;都填时以 count ä¸ºå‡†ï¼‰", example = "12")
    private Integer count;
    @Schema(description = "设备累计计数(设备只报累计值时,系统按上一次累计值的差值计算本次数量)", example = "1234")
    private Integer totalCount;
    @Schema(description = "本次重量(g)", example = "3500.50")
    private BigDecimal weight;
    @Schema(description = "设备累计重量(g)", example = "123456.70")
    private BigDecimal totalWeight;
    @Schema(description = "是否在线实时上报;离线补报请传 false,默认 true", example = "true")
    private Boolean online;
    @Schema(description = "固件版本(可选,上报后更新到设备台账)", example = "1.0.2")
    @Size(max = 64, message = "固件版本长度不能超过 64 ä¸ªå­—符")
    private String firmwareVersion;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/open/vo/MesDcIngestRespVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,31 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import java.math.BigDecimal;
import java.time.LocalDateTime;
@Schema(description = "设备端 - é‡‡é›†æ•°æ®ä¸ŠæŠ¥ Response VO")
@Data
public class MesDcIngestRespVO {
    @Schema(description = "采集记录编号", example = "1024")
    private Long recordId;
    @Schema(description = "是否为重复上报(重复上报不会新增记录)", example = "false")
    private Boolean duplicate;
    @Schema(description = "本次入库数量", example = "12")
    private Integer quantity;
    @Schema(description = "设备今日累计数量(不含已作废记录)", example = "1234")
    private Long todayQuantity;
    @Schema(description = "设备今日累计重量(g,不含已作废记录)", example = "123456.70")
    private BigDecimal todayWeight;
    @Schema(description = "服务器当前时间")
    private LocalDateTime serverTime;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/record/MesDcRecordController.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,110 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.record;
import cn.hutool.core.collection.CollUtil;
import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
import cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo.MesDcRecordCancelReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo.MesDcRecordCorrectReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo.MesDcRecordPageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo.MesDcRecordRespVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.dc.record.MesDcRecordDO;
import cn.iocoder.yudao.module.mes.enums.dc.MesDcRecordStatusEnum;
import cn.iocoder.yudao.module.mes.service.dc.record.MesDcRecordService;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.annotation.Resource;
import jakarta.servlet.http.HttpServletResponse;
import jakarta.validation.Valid;
import org.springframework.security.access.prepost.PreAuthorize;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
import java.io.IOException;
import java.util.Collections;
import java.util.List;
import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
@Tag(name = "管理后台 - MES æ•°æ®é‡‡é›†è®°å½•")
@RestController
@RequestMapping("/mes/data-collection/record")
@Validated
public class MesDcRecordController {
    @Resource
    private MesDcRecordService dcRecordService;
    @GetMapping("/get")
    @Operation(summary = "获得采集记录详情")
    @Parameter(name = "id", description = "编号", required = true, example = "1024")
    @PreAuthorize("@ss.hasPermission('mes:dc-record:query')")
    public CommonResult<MesDcRecordRespVO> getRecord(@RequestParam("id") Long id) {
        MesDcRecordDO record = dcRecordService.getRecord(id);
        return success(record == null ? null
                : buildRecordRespVOList(Collections.singletonList(record)).get(0));
    }
    @GetMapping("/page")
    @Operation(summary = "获得采集记录分页")
    @PreAuthorize("@ss.hasPermission('mes:dc-record:query')")
    public CommonResult<PageResult<MesDcRecordRespVO>> getRecordPage(
            @Valid MesDcRecordPageReqVO pageReqVO) {
        PageResult<MesDcRecordDO> pageResult = dcRecordService.getRecordPage(pageReqVO);
        return success(new PageResult<>(buildRecordRespVOList(pageResult.getList()),
                pageResult.getTotal()));
    }
    @PutMapping("/correct")
    @Operation(summary = "更正采集记录")
    @PreAuthorize("@ss.hasPermission('mes:dc-record:correct')")
    public CommonResult<Boolean> correctRecord(@Valid @RequestBody MesDcRecordCorrectReqVO reqVO) {
        dcRecordService.correctRecord(reqVO);
        return success(true);
    }
    @PutMapping("/cancel")
    @Operation(summary = "作废采集记录")
    @PreAuthorize("@ss.hasPermission('mes:dc-record:cancel')")
    public CommonResult<Boolean> cancelRecord(@Valid @RequestBody MesDcRecordCancelReqVO reqVO) {
        dcRecordService.cancelRecord(reqVO);
        return success(true);
    }
    @GetMapping("/export-excel")
    @Operation(summary = "导出采集记录 Excel")
    @PreAuthorize("@ss.hasPermission('mes:dc-record:export')")
    @ApiAccessLog(operateType = EXPORT)
    public void exportRecordExcel(@Valid MesDcRecordPageReqVO pageReqVO,
                                  HttpServletResponse response) throws IOException {
        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
        PageResult<MesDcRecordDO> pageResult = dcRecordService.getRecordPage(pageReqVO);
        ExcelUtils.write(response, "采集记录.xls", "数据", MesDcRecordRespVO.class,
                buildRecordRespVOList(pageResult.getList()));
    }
    // ==================== æ‹¼æŽ¥ VO ====================
    private static List<MesDcRecordRespVO> buildRecordRespVOList(List<MesDcRecordDO> list) {
        if (CollUtil.isEmpty(list)) {
            return Collections.emptyList();
        }
        List<MesDcRecordRespVO> result = BeanUtils.toBean(list, MesDcRecordRespVO.class);
        result.forEach(vo -> {
            vo.setStatusName(resolveStatusName(vo.getStatus()));
            vo.setOnlineName(Boolean.FALSE.equals(vo.getOnline()) ? "离线补报" : "在线");
        });
        return result;
    }
    private static String resolveStatusName(Integer status) {
        MesDcRecordStatusEnum statusEnum = MesDcRecordStatusEnum.valueOf(status);
        return statusEnum != null ? statusEnum.getName() : "未知状态(" + status + ")";
    }
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/record/vo/MesDcRecordCancelReqVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,22 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Size;
import lombok.Data;
@Schema(description = "管理后台 - MES é‡‡é›†è®°å½•作废 Request VO")
@Data
public class MesDcRecordCancelReqVO {
    @Schema(description = "记录编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
    @NotNull(message = "记录编号不能为空")
    private Long id;
    @Schema(description = "作废原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "重复上报,作废本条记录")
    @NotBlank(message = "作废原因不能为空")
    @Size(max = 255, message = "作废原因长度不能超过 255 ä¸ªå­—符")
    private String reason;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/record/vo/MesDcRecordCorrectReqVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,28 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.Min;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Size;
import lombok.Data;
@Schema(description = "管理后台 - MES é‡‡é›†è®°å½•æ›´æ­£ Request VO")
@Data
public class MesDcRecordCorrectReqVO {
    @Schema(description = "记录编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
    @NotNull(message = "记录编号不能为空")
    private Long id;
    @Schema(description = "更正后的采集数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
    @NotNull(message = "更正后的数量不能为空")
    @Min(value = 0, message = "更正后的数量不能小于 0")
    private Integer quantity;
    @Schema(description = "更正原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "设备误计数,按实际数量更正")
    @NotBlank(message = "更正原因不能为空")
    @Size(max = 255, message = "更正原因长度不能超过 255 ä¸ªå­—符")
    private String reason;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/record/vo/MesDcRecordPageReqVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,49 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo;
import cn.iocoder.yudao.framework.common.pojo.PageParam;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.ToString;
import org.springframework.format.annotation.DateTimeFormat;
import java.time.LocalDateTime;
import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
@Schema(description = "管理后台 - MES é‡‡é›†è®°å½•分页 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
public class MesDcRecordPageReqVO extends PageParam {
    @Schema(description = "采集设备ID", example = "1024")
    private Long deviceId;
    @Schema(description = "设备编号", example = "DC001")
    private String deviceCode;
    @Schema(description = "生产工单ID", example = "2048")
    private Long workOrderId;
    @Schema(description = "生产工单编号", example = "WO202611100001")
    private String workOrderCode;
    @Schema(description = "产品ID", example = "88")
    private Long productId;
    @Schema(description = "生产批次号", example = "B20261110001")
    private String batchCode;
    @Schema(description = "记录状态:0 æ­£å¸¸ / 1 å·²æ›´æ­£ / 2 å·²ä½œåºŸ", example = "0")
    private Integer status;
    @Schema(description = "设备采集时间")
    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
    private LocalDateTime[] recordTime;
    @Schema(description = "服务器接收时间")
    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
    private LocalDateTime[] createTime;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/record/vo/MesDcRecordRespVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,109 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo;
import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
import cn.idev.excel.annotation.ExcelProperty;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import java.math.BigDecimal;
import java.time.LocalDateTime;
@Schema(description = "管理后台 - MES é‡‡é›†è®°å½• Response VO")
@Data
@ExcelIgnoreUnannotated
public class MesDcRecordRespVO {
    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
    private Long id;
    @Schema(description = "采集设备ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
    private Long deviceId;
    @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "DC001")
    @ExcelProperty("设备编号")
    private String deviceCode;
    @Schema(description = "设备名称", example = "一车间鸡爪计数器")
    @ExcelProperty("设备名称")
    private String deviceName;
    @Schema(description = "生产工单ID", example = "2048")
    private Long workOrderId;
    @Schema(description = "生产工单编号", example = "WO202611100001")
    @ExcelProperty("生产工单编号")
    private String workOrderCode;
    @Schema(description = "产品ID", example = "88")
    private Long productId;
    @Schema(description = "产品编码", example = "P001")
    @ExcelProperty("产品编码")
    private String productCode;
    @Schema(description = "产品名称", example = "自热火锅")
    @ExcelProperty("产品名称")
    private String productName;
    @Schema(description = "生产批次号", example = "B20261110001")
    @ExcelProperty("生产批次号")
    private String batchCode;
    @Schema(description = "设备侧记录序号", example = "0001")
    @ExcelProperty("设备记录序号")
    private String recordNo;
    @Schema(description = "本次采集数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "12")
    @ExcelProperty("采集数量")
    private Integer quantity;
    @Schema(description = "设备累计数量", example = "1234")
    private Integer totalQuantity;
    @Schema(description = "本次重量(g)", example = "3500.50")
    @ExcelProperty("重量(g)")
    private BigDecimal weight;
    @Schema(description = "设备累计重量(g)", example = "123456.70")
    private BigDecimal totalWeight;
    @Schema(description = "设备采集时间", requiredMode = Schema.RequiredMode.REQUIRED)
    @ExcelProperty("采集时间")
    private LocalDateTime recordTime;
    @Schema(description = "服务器接收时间", requiredMode = Schema.RequiredMode.REQUIRED)
    @ExcelProperty("接收时间")
    private LocalDateTime receiveTime;
    @Schema(description = "是否在线实时上报", example = "true")
    private Boolean online;
    @Schema(description = "上报方式", example = "在线")
    @ExcelProperty("上报方式")
    private String onlineName;
    @Schema(description = "记录状态:0 æ­£å¸¸ / 1 å·²æ›´æ­£ / 2 å·²ä½œåºŸ", example = "0")
    private Integer status;
    @Schema(description = "记录状态名称", example = "正常")
    @ExcelProperty("记录状态")
    private String statusName;
    @Schema(description = "更正前的原始数量", example = "11")
    @ExcelProperty("原始数量")
    private Integer originalQuantity;
    @Schema(description = "更正/作废原因", example = "设备误计数,按实际数量更正")
    @ExcelProperty("更正/作废原因")
    private String correctReason;
    @Schema(description = "备注")
    private String remark;
    @Schema(description = "原始上报报文")
    private String rawData;
    @Schema(description = "创建时间")
    private LocalDateTime createTime;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/statistics/MesDcStatisticsController.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,55 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.statistics;
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcDeviceOverviewRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcStatisticsReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcStatisticsSummaryRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcStatisticsTrendItemVO;
import cn.iocoder.yudao.module.mes.service.dc.statistics.MesDcStatisticsService;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.annotation.Resource;
import jakarta.validation.Valid;
import org.springframework.security.access.prepost.PreAuthorize;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;
import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
@Tag(name = "管理后台 - MES æ•°æ®é‡‡é›†ç»Ÿè®¡")
@RestController
@RequestMapping("/mes/data-collection/statistics")
@Validated
public class MesDcStatisticsController {
    @Resource
    private MesDcStatisticsService statisticsService;
    @GetMapping("/summary")
    @Operation(summary = "获得采集统计汇总")
    @PreAuthorize("@ss.hasPermission('mes:dc-statistics:query')")
    public CommonResult<MesDcStatisticsSummaryRespVO> getSummary(
            @Valid MesDcStatisticsReqVO reqVO) {
        return success(statisticsService.getSummary(reqVO));
    }
    @GetMapping("/trend")
    @Operation(summary = "获得采集趋势")
    @PreAuthorize("@ss.hasPermission('mes:dc-statistics:query')")
    public CommonResult<List<MesDcStatisticsTrendItemVO>> getTrend(
            @Valid MesDcStatisticsReqVO reqVO) {
        return success(statisticsService.getTrend(reqVO));
    }
    @GetMapping("/device-overview")
    @Operation(summary = "获得设备实时概览")
    @PreAuthorize("@ss.hasPermission('mes:dc-statistics:query')")
    public CommonResult<List<MesDcDeviceOverviewRespVO>> getDeviceOverview() {
        return success(statisticsService.getDeviceOverview());
    }
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/statistics/vo/MesDcDeviceOverviewRespVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,46 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import java.math.BigDecimal;
import java.time.LocalDateTime;
@Schema(description = "管理后台 - MES é‡‡é›†è®¾å¤‡å®žæ—¶æ¦‚览 VO")
@Data
public class MesDcDeviceOverviewRespVO {
    @Schema(description = "采集设备ID", example = "1024")
    private Long deviceId;
    @Schema(description = "设备编号", example = "DC001")
    private String code;
    @Schema(description = "设备名称", example = "一车间鸡爪计数器")
    private String name;
    @Schema(description = "设备是否启用", example = "true")
    private Boolean enabled;
    @Schema(description = "是否在线(5 åˆ†é’Ÿå†…有心跳)", example = "true")
    private Boolean online;
    @Schema(description = "当前绑定生产工单ID", example = "2048")
    private Long workOrderId;
    @Schema(description = "当前绑定生产工单编号", example = "WO202611100001")
    private String workOrderCode;
    @Schema(description = "今日采集数量(不含已作废记录)", example = "1234")
    private Long todayQuantity;
    @Schema(description = "今日重量(g,不含已作废记录)", example = "123456.70")
    private BigDecimal todayWeight;
    @Schema(description = "最后数据上报时间")
    private LocalDateTime lastIngestTime;
    @Schema(description = "最后心跳时间")
    private LocalDateTime lastHeartbeatTime;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/statistics/vo/MesDcStatisticsDeviceItemVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,30 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import java.math.BigDecimal;
@Schema(description = "管理后台 - MES æ•°æ®é‡‡é›†æŒ‰è®¾å¤‡ç»Ÿè®¡é¡¹ VO")
@Data
public class MesDcStatisticsDeviceItemVO {
    @Schema(description = "采集设备ID", example = "1024")
    private Long deviceId;
    @Schema(description = "设备编号", example = "DC001")
    private String deviceCode;
    @Schema(description = "设备名称", example = "一车间鸡爪计数器")
    private String deviceName;
    @Schema(description = "采集数量", example = "1234")
    private Long totalQuantity;
    @Schema(description = "重量(g)", example = "123456.70")
    private BigDecimal totalWeight;
    @Schema(description = "记录条数", example = "25")
    private Long recordCount;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/statistics/vo/MesDcStatisticsReqVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,32 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import org.springframework.format.annotation.DateTimeFormat;
import java.time.LocalDateTime;
import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
@Schema(description = "管理后台 - MES æ•°æ®é‡‡é›†ç»Ÿè®¡ Request VO")
@Data
public class MesDcStatisticsReqVO {
    @Schema(description = "开始采集时间(含),不传则不限", example = "2026-11-01 00:00:00")
    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
    private LocalDateTime beginTime;
    @Schema(description = "结束采集时间(含),不传则不限", example = "2026-11-10 23:59:59")
    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
    private LocalDateTime endTime;
    @Schema(description = "采集设备ID", example = "1024")
    private Long deviceId;
    @Schema(description = "生产工单ID", example = "2048")
    private Long workOrderId;
    @Schema(description = "趋势粒度:day æŒ‰å¤© / hour æŒ‰å°æ—¶ï¼Œé»˜è®¤ day", example = "day")
    private String granularity;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/statistics/vo/MesDcStatisticsSummaryRespVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,28 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import java.math.BigDecimal;
import java.util.List;
@Schema(description = "管理后台 - MES æ•°æ®é‡‡é›†ç»Ÿè®¡æ±‡æ€» Response VO")
@Data
public class MesDcStatisticsSummaryRespVO {
    @Schema(description = "总采集数量(不含已作废记录)", example = "12345")
    private Long totalQuantity;
    @Schema(description = "总重量(g,不含已作废记录)", example = "1234567.80")
    private BigDecimal totalWeight;
    @Schema(description = "记录条数(不含已作废记录)", example = "120")
    private Long recordCount;
    @Schema(description = "参与统计的设备数", example = "3")
    private Integer deviceCount;
    @Schema(description = "按设备分组的统计")
    private List<MesDcStatisticsDeviceItemVO> devices;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/dc/statistics/vo/MesDcStatisticsTrendItemVO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,24 @@
package cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import java.math.BigDecimal;
@Schema(description = "管理后台 - MES æ•°æ®é‡‡é›†è¶‹åŠ¿é¡¹ VO")
@Data
public class MesDcStatisticsTrendItemVO {
    @Schema(description = "时间段:按天为 yyyy-MM-dd,按小时为 yyyy-MM-dd HH:00", example = "2026-11-10")
    private String period;
    @Schema(description = "采集数量", example = "1234")
    private Long totalQuantity;
    @Schema(description = "重量(g)", example = "123456.70")
    private BigDecimal totalWeight;
    @Schema(description = "记录条数", example = "25")
    private Long recordCount;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/dal/dataobject/dc/device/MesDcDeviceDO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,100 @@
package cn.iocoder.yudao.module.mes.dal.dataobject.dc.device;
import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
import com.baomidou.mybatisplus.annotation.KeySequence;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.*;
import java.time.LocalDateTime;
/**
 * MES æ•°æ®é‡‡é›†è®¾å¤‡ DO
 *
 * @author è¶…级管理员
 */
@TableName("mes_dc_device")
@KeySequence("mes_dc_device_seq")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class MesDcDeviceDO extends BaseDO {
    /**
     * ç¼–号
     */
    @TableId
    private Long id;
    /**
     * è®¾å¤‡ç¼–号(设备端上报时使用)
     */
    private String code;
    /**
     * è®¾å¤‡åç§°
     */
    private String name;
    /**
     * è®¾å¤‡ç±»åž‹
     *
     * å­—å…¸ {@link cn.iocoder.yudao.module.mes.enums.DictTypeConstants#MES_DC_DEVICE_TYPE}
     */
    private String deviceType;
    /**
     * è®¾å¤‡åž‹å·
     */
    private String model;
    /**
     * è®¾å¤‡åºåˆ—号
     */
    private String serialNo;
    /**
     * å®‰è£…位置
     */
    private String location;
    /**
     * è®¾å¤‡çŠ¶æ€
     *
     * æžšä¸¾ {@link cn.iocoder.yudao.module.mes.enums.dc.MesDcDeviceStatusEnum}
     */
    private Integer status;
    /**
     * é‡‡é›†ä»¤ç‰Œ
     */
    private String token;
    /**
     * å½“前绑定生产工单编号
     */
    private Long workOrderId;
    /**
     * å½“前绑定生产工单编号(冗余)
     */
    private String workOrderCode;
    /**
     * ç»‘定工单时间
     */
    private LocalDateTime bindTime;
    /**
     * æœ€åŽå¿ƒè·³æ—¶é—´
     */
    private LocalDateTime lastHeartbeatTime;
    /**
     * æœ€åŽæ•°æ®ä¸ŠæŠ¥æ—¶é—´
     */
    private LocalDateTime lastIngestTime;
    /**
     * å›ºä»¶ç‰ˆæœ¬
     */
    private String firmwareVersion;
    /**
     * è®¾å¤‡ IP
     */
    private String deviceIp;
    /**
     * å¤‡æ³¨
     */
    private String remark;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/dal/dataobject/dc/record/MesDcRecordDO.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,129 @@
package cn.iocoder.yudao.module.mes.dal.dataobject.dc.record;
import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
import com.baomidou.mybatisplus.annotation.KeySequence;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.*;
import java.math.BigDecimal;
import java.time.LocalDateTime;
/**
 * MES æ•°æ®é‡‡é›†è®°å½• DO
 *
 * @author è¶…级管理员
 */
@TableName("mes_dc_record")
@KeySequence("mes_dc_record_seq")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class MesDcRecordDO extends BaseDO {
    /**
     * ç¼–号
     */
    @TableId
    private Long id;
    /**
     * é‡‡é›†è®¾å¤‡ç¼–号
     *
     * å…³è” {@link cn.iocoder.yudao.module.mes.dal.dataobject.dc.device.MesDcDeviceDO#getId()}
     */
    private Long deviceId;
    /**
     * è®¾å¤‡ç¼–号(冗余)
     */
    private String deviceCode;
    /**
     * è®¾å¤‡åç§°ï¼ˆå†—余)
     */
    private String deviceName;
    /**
     * é‡‡é›†æ—¶ç»‘定的生产工单编号
     */
    private Long workOrderId;
    /**
     * ç”Ÿäº§å·¥å•编号(冗余)
     */
    private String workOrderCode;
    /**
     * äº§å“ç¼–号
     */
    private Long productId;
    /**
     * äº§å“ç¼–码(冗余)
     */
    private String productCode;
    /**
     * äº§å“åç§°ï¼ˆå†—余)
     */
    private String productName;
    /**
     * ç”Ÿäº§æ‰¹æ¬¡å·
     */
    private String batchCode;
    /**
     * è®¾å¤‡ä¾§è®°å½•序号
     */
    private String recordNo;
    /**
     * è®¾å¤‡ä¾§å”¯ä¸€é”®ï¼ˆç”¨äºŽå¹‚等)
     */
    private String bizId;
    /**
     * æœ¬æ¬¡é‡‡é›†æ•°é‡
     */
    private Integer quantity;
    /**
     * è®¾å¤‡ç´¯è®¡æ•°é‡ï¼ˆè®¾å¤‡åªæŠ¥ç´¯è®¡å€¼æ—¶ç”¨äºŽè®¡ç®—差值)
     */
    private Integer totalQuantity;
    /**
     * æœ¬æ¬¡é‡é‡ï¼ˆg)
     */
    private BigDecimal weight;
    /**
     * è®¾å¤‡ç´¯è®¡é‡é‡ï¼ˆg)
     */
    private BigDecimal totalWeight;
    /**
     * è®¾å¤‡é‡‡é›†æ—¶é—´
     */
    private LocalDateTime recordTime;
    /**
     * æœåŠ¡å™¨æŽ¥æ”¶æ—¶é—´
     */
    private LocalDateTime receiveTime;
    /**
     * æ˜¯å¦åœ¨çº¿å®žæ—¶ä¸ŠæŠ¥
     */
    private Boolean online;
    /**
     * åŽŸå§‹ä¸ŠæŠ¥æŠ¥æ–‡
     */
    private String rawData;
    /**
     * è®°å½•状态
     *
     * æžšä¸¾ {@link cn.iocoder.yudao.module.mes.enums.dc.MesDcRecordStatusEnum}
     */
    private Integer status;
    /**
     * æ›´æ­£å‰çš„原始数量(首次更正/作废时留痕)
     */
    private Integer originalQuantity;
    /**
     * æ›´æ­£/作废原因
     */
    private String correctReason;
    /**
     * å¤‡æ³¨
     */
    private String remark;
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/dal/mysql/dc/device/MesDcDeviceMapper.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,41 @@
package cn.iocoder.yudao.module.mes.dal.mysql.dc.device;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
import cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo.MesDcDevicePageReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.dc.device.MesDcDeviceDO;
import org.apache.ibatis.annotations.Mapper;
import java.util.List;
/**
 * MES æ•°æ®é‡‡é›†è®¾å¤‡ Mapper
 *
 * @author è¶…级管理员
 */
@Mapper
public interface MesDcDeviceMapper extends BaseMapperX<MesDcDeviceDO> {
    default PageResult<MesDcDeviceDO> selectPage(MesDcDevicePageReqVO reqVO) {
        return selectPage(reqVO, new LambdaQueryWrapperX<MesDcDeviceDO>()
                .likeIfPresent(MesDcDeviceDO::getCode, reqVO.getCode())
                .likeIfPresent(MesDcDeviceDO::getName, reqVO.getName())
                .eqIfPresent(MesDcDeviceDO::getDeviceType, reqVO.getDeviceType())
                .eqIfPresent(MesDcDeviceDO::getStatus, reqVO.getStatus())
                .eqIfPresent(MesDcDeviceDO::getWorkOrderId, reqVO.getWorkOrderId())
                .likeIfPresent(MesDcDeviceDO::getWorkOrderCode, reqVO.getWorkOrderCode())
                .orderByAsc(MesDcDeviceDO::getCode)
                .orderByDesc(MesDcDeviceDO::getId));
    }
    default MesDcDeviceDO selectByCode(String code) {
        return selectOne(MesDcDeviceDO::getCode, code);
    }
    default List<MesDcDeviceDO> selectSimpleList() {
        return selectList(new LambdaQueryWrapperX<MesDcDeviceDO>()
                .orderByAsc(MesDcDeviceDO::getCode));
    }
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/dal/mysql/dc/record/MesDcRecordMapper.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,129 @@
package cn.iocoder.yudao.module.mes.dal.mysql.dc.record;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
import cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo.MesDcRecordPageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcStatisticsReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.dc.record.MesDcRecordDO;
import cn.iocoder.yudao.module.mes.enums.dc.MesDcRecordStatusEnum;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import org.apache.ibatis.annotations.Mapper;
import java.util.List;
import java.util.Map;
/**
 * MES æ•°æ®é‡‡é›†è®°å½• Mapper
 *
 * @author è¶…级管理员
 */
@Mapper
public interface MesDcRecordMapper extends BaseMapperX<MesDcRecordDO> {
    default PageResult<MesDcRecordDO> selectPage(MesDcRecordPageReqVO reqVO) {
        return selectPage(reqVO, new LambdaQueryWrapperX<MesDcRecordDO>()
                .eqIfPresent(MesDcRecordDO::getDeviceId, reqVO.getDeviceId())
                .likeIfPresent(MesDcRecordDO::getDeviceCode, reqVO.getDeviceCode())
                .eqIfPresent(MesDcRecordDO::getWorkOrderId, reqVO.getWorkOrderId())
                .likeIfPresent(MesDcRecordDO::getWorkOrderCode, reqVO.getWorkOrderCode())
                .eqIfPresent(MesDcRecordDO::getProductId, reqVO.getProductId())
                .eqIfPresent(MesDcRecordDO::getBatchCode, reqVO.getBatchCode())
                .eqIfPresent(MesDcRecordDO::getStatus, reqVO.getStatus())
                .betweenIfPresent(MesDcRecordDO::getRecordTime, reqVO.getRecordTime())
                .betweenIfPresent(MesDcRecordDO::getCreateTime, reqVO.getCreateTime())
                .orderByDesc(MesDcRecordDO::getRecordTime)
                .orderByDesc(MesDcRecordDO::getId));
    }
    default MesDcRecordDO selectByDeviceIdAndBizId(Long deviceId, String bizId) {
        return selectOne(new LambdaQueryWrapperX<MesDcRecordDO>()
                .eq(MesDcRecordDO::getDeviceId, deviceId)
                .eq(MesDcRecordDO::getBizId, bizId));
    }
    default MesDcRecordDO selectLastByDeviceId(Long deviceId) {
        return selectOne(new LambdaQueryWrapperX<MesDcRecordDO>()
                .eq(MesDcRecordDO::getDeviceId, deviceId)
                .orderByDesc(MesDcRecordDO::getId)
                .last("LIMIT 1"));
    }
    default Long selectCountByDeviceId(Long deviceId) {
        return selectCount(MesDcRecordDO::getDeviceId, deviceId);
    }
    /**
     * æŒ‰è®¾å¤‡åˆ†ç»„统计采集数量、重量、记录条数(不含已作废记录)
     */
    default List<Map<String, Object>> selectDeviceSummary(MesDcStatisticsReqVO reqVO) {
        QueryWrapper<MesDcRecordDO> wrapper = new QueryWrapper<>();
        wrapper.select("device_id AS deviceId", "device_code AS deviceCode",
                "MAX(device_name) AS deviceName",
                "COALESCE(SUM(quantity), 0) AS totalQuantity",
                "COALESCE(SUM(weight), 0) AS totalWeight",
                "COUNT(*) AS recordCount");
        appendStatisticsWhere(wrapper, reqVO);
        wrapper.groupBy("device_id", "device_code");
        wrapper.orderByDesc("totalQuantity");
        return selectMaps(wrapper);
    }
    /**
     * ç»Ÿè®¡æ±‡æ€»æ•°é‡ã€é‡é‡ã€è®°å½•条数(不含已作废记录)
     */
    default List<Map<String, Object>> selectTotals(MesDcStatisticsReqVO reqVO) {
        QueryWrapper<MesDcRecordDO> wrapper = new QueryWrapper<>();
        wrapper.select("COALESCE(SUM(quantity), 0) AS totalQuantity",
                "COALESCE(SUM(weight), 0) AS totalWeight",
                "COUNT(*) AS recordCount");
        appendStatisticsWhere(wrapper, reqVO);
        return selectMaps(wrapper);
    }
    /**
     * æŒ‰å¤©/小时统计采集趋势(不含已作废记录)
     *
     * @param reqVO  æŸ¥è¯¢æ¡ä»¶
     * @param byHour æ˜¯å¦æŒ‰å°æ—¶åˆ†ç»„
     */
    default List<Map<String, Object>> selectTrend(MesDcStatisticsReqVO reqVO, boolean byHour) {
        String periodExpression = byHour
                ? "DATE_FORMAT(record_time, '%Y-%m-%d %H:00')"
                : "DATE_FORMAT(record_time, '%Y-%m-%d')";
        QueryWrapper<MesDcRecordDO> wrapper = new QueryWrapper<>();
        wrapper.select(periodExpression + " AS period",
                "COALESCE(SUM(quantity), 0) AS totalQuantity",
                "COALESCE(SUM(weight), 0) AS totalWeight",
                "COUNT(*) AS recordCount");
        appendStatisticsWhere(wrapper, reqVO);
        wrapper.groupBy(periodExpression);
        wrapper.orderByAsc(periodExpression);
        return selectMaps(wrapper);
    }
    /**
     * æ‹¼æŽ¥ç»Ÿè®¡æŸ¥è¯¢æ¡ä»¶ï¼šæŽ’除已作废记录,可选设备、工单、时间范围
     */
    private void appendStatisticsWhere(QueryWrapper<MesDcRecordDO> wrapper,
                                       MesDcStatisticsReqVO reqVO) {
        if (reqVO == null) {
            wrapper.ne("status", MesDcRecordStatusEnum.CANCELED.getStatus());
            return;
        }
        wrapper.ne("status", MesDcRecordStatusEnum.CANCELED.getStatus());
        if (reqVO.getDeviceId() != null) {
            wrapper.eq("device_id", reqVO.getDeviceId());
        }
        if (reqVO.getWorkOrderId() != null) {
            wrapper.eq("work_order_id", reqVO.getWorkOrderId());
        }
        if (reqVO.getBeginTime() != null) {
            wrapper.ge("record_time", reqVO.getBeginTime());
        }
        if (reqVO.getEndTime() != null) {
            wrapper.le("record_time", reqVO.getEndTime());
        }
    }
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/enums/DictTypeConstants.java
@@ -99,6 +99,11 @@
    String MES_DV_METERING_STATUS = "mes_dv_metering_status"; // MES è®¡é‡å™¨å…·çŠ¶æ€
    String MES_DV_METERING_CHECK_RESULT = "mes_dv_metering_check_result"; // MES è®¡é‡æ£€æµ‹ç»“论
    // ========== æ•°æ®é‡‡é›† (DC) ==========
    String MES_DC_DEVICE_TYPE = "mes_dc_device_type"; // MES æ•°æ®é‡‡é›†è®¾å¤‡ç±»åž‹
    String MES_DC_DEVICE_STATUS = "mes_dc_device_status"; // MES æ•°æ®é‡‡é›†è®¾å¤‡çŠ¶æ€
    String MES_DC_RECORD_STATUS = "mes_dc_record_status"; // MES æ•°æ®é‡‡é›†è®°å½•状态
    // ========== æŽ’班日历 (CAL) ==========
    String MES_CAL_HOLIDAY_TYPE = "mes_cal_holiday_type"; // MES å‡æœŸç±»åž‹
    String MES_CAL_SHIFT_TYPE = "mes_cal_shift_type"; // MES è½®ç­æ–¹å¼
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/enums/ErrorCodeConstants.java
@@ -478,6 +478,26 @@
    ErrorCode QC_RETENTION_SAMPLE_SALE_ORDER_AMBIGUOUS = new ErrorCode(1_040_610_011, "生产工单【{}】由多张销售订单合并下发({}),请选择本次留样对应的销售订单");
    ErrorCode QC_RETENTION_SAMPLE_MPS_SALE_ORDER_NOT_EXISTS = new ErrorCode(1_040_610_012, "生产工单【{}】由 MPS ä¸‹å‘,但 MPS è®°å½•的销售订单【{}】(ID={})在销售订单中不存在,无法登记留样;请先修正该 MPS çš„销售订单信息后再登记");
    // ========== MES æ•°æ®é‡‡é›†-设备(1-040-611-000) ==========
    ErrorCode DC_DEVICE_NOT_EXISTS = new ErrorCode(1_040_611_000, "采集设备不存在,请刷新页面后重试");
    ErrorCode DC_DEVICE_CODE_DUPLICATE = new ErrorCode(1_040_611_001, "设备编号【{}】已被其他设备使用,请更换设备编号后重试");
    ErrorCode DC_DEVICE_DISABLED = new ErrorCode(1_040_611_002, "采集设备【{}】已禁用,数据未接收;请在【生产管控 â†’ æ•°æ®é‡‡é›† â†’ è®¾å¤‡ç®¡ç†ã€‘中将该设备改为启用");
    ErrorCode DC_DEVICE_TOKEN_REQUIRED = new ErrorCode(1_040_611_003, "未携带采集令牌:请在请求头 X-Device-Token(或 URL å‚æ•° token)中提供设备令牌");
    ErrorCode DC_DEVICE_CODE_MISSING = new ErrorCode(1_040_611_004, "未提供设备编号:请在报文中填写 deviceCode,或在 URL å‚æ•° deviceCode ä¸­æä¾›");
    ErrorCode DC_DEVICE_CODE_NOT_EXISTS = new ErrorCode(1_040_611_005, "设备编号【{}】尚未登记:请先在【生产管控 â†’ æ•°æ®é‡‡é›† â†’ è®¾å¤‡ç®¡ç†ã€‘中新增该设备");
    ErrorCode DC_DEVICE_TOKEN_INVALID = new ErrorCode(1_040_611_006, "设备【{}】采集令牌校验失败:请核对设备端配置的令牌;如系统已重置令牌,请以设备管理中最新显示的令牌重新配置设备端");
    ErrorCode DC_DEVICE_WORK_ORDER_BIND_INVALID = new ErrorCode(1_040_611_007, "生产工单【{}】当前状态为【{}】,不能绑定采集设备;请选择未完工、未取消的工单");
    ErrorCode DC_DEVICE_DELETE_HAS_RECORD = new ErrorCode(1_040_611_008, "设备【{}】已有采集记录,无法删除;如需停用,请将设备状态改为【禁用】");
    ErrorCode DC_DEVICE_WORK_ORDER_NOT_EXISTS = new ErrorCode(1_040_611_009, "生产工单不存在或已删除,请重新选择未完工、未取消的工单");
    // ========== MES æ•°æ®é‡‡é›†-记录(1-040-612-000) ==========
    ErrorCode DC_RECORD_NOT_EXISTS = new ErrorCode(1_040_612_000, "采集记录不存在,请刷新页面后重试");
    ErrorCode DC_RECORD_OPERATE_STATUS_INVALID = new ErrorCode(1_040_612_001, "采集记录【{}】当前状态为【{}】,不能{};仅【正常】状态的记录可更正,仅【正常/已更正】状态的记录可作废,请刷新页面后重试");
    ErrorCode DC_RECORD_COUNT_REQUIRED = new ErrorCode(1_040_612_002, "上报数量无效:count ä¸Ž totalCount è‡³å°‘填写一个;请检查设备端上报内容");
    ErrorCode DC_RECORD_COUNT_INVALID = new ErrorCode(1_040_612_003, "上报数量不能为负数:count={},totalCount={};请检查设备端上报内容");
    ErrorCode DC_RECORD_WEIGHT_INVALID = new ErrorCode(1_040_612_004, "上报重量不能为负数:weight={},totalWeight={};请检查设备端上报内容");
    ErrorCode DC_RECORD_CORRECT_QUANTITY_INVALID = new ErrorCode(1_040_612_005, "更正后的数量【{}】无效:必须为不小于 0 çš„æ•´æ•°ï¼Œè¯·å¡«å†™å®žé™…采集数量");
    // ========== MES ä»“库管理-仓库(1-040-700-000) ==========
    ErrorCode WM_WAREHOUSE_NOT_EXISTS = new ErrorCode(1_040_700_000, "仓库不存在");
    ErrorCode WM_WAREHOUSE_CODE_DUPLICATE = new ErrorCode(1_040_700_001, "仓库编码已存在");
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/enums/dc/MesDcDeviceStatusEnum.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,38 @@
package cn.iocoder.yudao.module.mes.enums.dc;
import cn.iocoder.yudao.framework.common.core.ArrayValuable;
import lombok.AllArgsConstructor;
import lombok.Getter;
import java.util.Arrays;
/**
 * MES æ•°æ®é‡‡é›†è®¾å¤‡çŠ¶æ€æžšä¸¾
 *
 * @author è¶…级管理员
 */
@Getter
@AllArgsConstructor
public enum MesDcDeviceStatusEnum implements ArrayValuable<Integer> {
    ENABLE(0, "启用"),
    DISABLE(1, "禁用");
    private final Integer status;
    private final String name;
    public static final Integer[] ARRAYS = Arrays.stream(values())
            .map(MesDcDeviceStatusEnum::getStatus).toArray(Integer[]::new);
    @Override
    public Integer[] array() {
        return ARRAYS;
    }
    public static MesDcDeviceStatusEnum valueOf(Integer status) {
        return Arrays.stream(values())
                .filter(item -> item.getStatus().equals(status))
                .findFirst().orElse(null);
    }
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/enums/dc/MesDcRecordStatusEnum.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,39 @@
package cn.iocoder.yudao.module.mes.enums.dc;
import cn.iocoder.yudao.framework.common.core.ArrayValuable;
import lombok.AllArgsConstructor;
import lombok.Getter;
import java.util.Arrays;
/**
 * MES æ•°æ®é‡‡é›†è®°å½•状态枚举
 *
 * @author è¶…级管理员
 */
@Getter
@AllArgsConstructor
public enum MesDcRecordStatusEnum implements ArrayValuable<Integer> {
    NORMAL(0, "正常"),
    CORRECTED(1, "已更正"),
    CANCELED(2, "已作废");
    private final Integer status;
    private final String name;
    public static final Integer[] ARRAYS = Arrays.stream(values())
            .map(MesDcRecordStatusEnum::getStatus).toArray(Integer[]::new);
    @Override
    public Integer[] array() {
        return ARRAYS;
    }
    public static MesDcRecordStatusEnum valueOf(Integer status) {
        return Arrays.stream(values())
                .filter(item -> item.getStatus().equals(status))
                .findFirst().orElse(null);
    }
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/dc/device/MesDcDeviceService.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,114 @@
package cn.iocoder.yudao.module.mes.service.dc.device;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo.MesDcDevicePageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo.MesDcDeviceSaveReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcHeartbeatReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcHeartbeatRespVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.dc.device.MesDcDeviceDO;
import jakarta.validation.Valid;
import java.util.List;
/**
 * MES æ•°æ®é‡‡é›†è®¾å¤‡ Service æŽ¥å£
 *
 * @author è¶…级管理员
 */
public interface MesDcDeviceService {
    /**
     * åˆ›å»ºè®¾å¤‡
     *
     * @param createReqVO åˆ›å»ºä¿¡æ¯
     * @return åˆ›å»ºè®¾å¤‡ï¼ˆå«è‡ªåŠ¨ç”Ÿæˆçš„é‡‡é›†ä»¤ç‰Œï¼‰
     */
    MesDcDeviceDO createDevice(@Valid MesDcDeviceSaveReqVO createReqVO);
    /**
     * æ›´æ–°è®¾å¤‡
     *
     * @param updateReqVO æ›´æ–°ä¿¡æ¯
     */
    void updateDevice(@Valid MesDcDeviceSaveReqVO updateReqVO);
    /**
     * åˆ é™¤è®¾å¤‡
     *
     * @param id ç¼–号
     */
    void deleteDevice(Long id);
    /**
     * èŽ·å¾—è®¾å¤‡
     *
     * @param id ç¼–号
     * @return è®¾å¤‡
     */
    MesDcDeviceDO getDevice(Long id);
    /**
     * æ ¡éªŒè®¾å¤‡å­˜åœ¨
     *
     * @param id ç¼–号
     * @return è®¾å¤‡
     */
    MesDcDeviceDO validateDeviceExists(Long id);
    /**
     * èŽ·å¾—è®¾å¤‡åˆ†é¡µ
     *
     * @param pageReqVO åˆ†é¡µæŸ¥è¯¢
     * @return è®¾å¤‡åˆ†é¡µ
     */
    PageResult<MesDcDeviceDO> getDevicePage(MesDcDevicePageReqVO pageReqVO);
    /**
     * èŽ·å¾—å…¨éƒ¨è®¾å¤‡åˆ—è¡¨ï¼ˆæŒ‰è®¾å¤‡ç¼–å·å‡åºï¼‰
     *
     * @return è®¾å¤‡åˆ—表
     */
    List<MesDcDeviceDO> getDeviceList();
    /**
     * é‡ç½®é‡‡é›†ä»¤ç‰Œ
     *
     * @param id ç¼–号
     * @return æ–°ä»¤ç‰Œï¼ˆä»…本次返回)
     */
    String resetToken(Long id);
    /**
     * ç»‘定生产工单
     *
     * @param id          è®¾å¤‡ç¼–号
     * @param workOrderId ç”Ÿäº§å·¥å•编号
     */
    void bindWorkOrder(Long id, Long workOrderId);
    /**
     * è§£ç»‘生产工单
     *
     * @param id è®¾å¤‡ç¼–号
     */
    void unbindWorkOrder(Long id);
    /**
     * æ ¡éªŒè®¾å¤‡ç¼–号与采集令牌(仅校验存在性与令牌,不校验禁用状态)
     *
     * @param deviceCode è®¾å¤‡ç¼–号
     * @param token      é‡‡é›†ä»¤ç‰Œ
     * @return è®¾å¤‡
     */
    MesDcDeviceDO validateDeviceToken(String deviceCode, String token);
    /**
     * è®¾å¤‡å¿ƒè·³
     *
     * @param heartbeatReqVO å¿ƒè·³ä¿¡æ¯
     * @param token          é‡‡é›†ä»¤ç‰Œ
     * @return å¿ƒè·³å“åº”
     */
    MesDcHeartbeatRespVO heartbeat(MesDcHeartbeatReqVO heartbeatReqVO, String token);
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/dc/device/MesDcDeviceServiceImpl.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,227 @@
package cn.iocoder.yudao.module.mes.service.dc.device;
import cn.hutool.core.util.ObjUtil;
import cn.hutool.core.util.RandomUtil;
import cn.hutool.core.util.StrUtil;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
import cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo.MesDcDevicePageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.device.vo.MesDcDeviceSaveReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcHeartbeatReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcHeartbeatRespVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.dc.device.MesDcDeviceDO;
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.workorder.MesProWorkOrderDO;
import cn.iocoder.yudao.module.mes.dal.mysql.dc.device.MesDcDeviceMapper;
import cn.iocoder.yudao.module.mes.dal.mysql.dc.record.MesDcRecordMapper;
import cn.iocoder.yudao.module.mes.enums.dc.MesDcDeviceStatusEnum;
import cn.iocoder.yudao.module.mes.enums.pro.MesProWorkOrderStatusEnum;
import cn.iocoder.yudao.module.mes.service.pro.workorder.MesProWorkOrderService;
import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
import jakarta.annotation.Resource;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.validation.annotation.Validated;
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.time.LocalDateTime;
import java.util.Arrays;
import java.util.List;
import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
import static cn.iocoder.yudao.module.mes.enums.ErrorCodeConstants.*;
/**
 * MES æ•°æ®é‡‡é›†è®¾å¤‡ Service å®žçŽ°ç±»
 *
 * @author è¶…级管理员
 */
@Service
@Validated
public class MesDcDeviceServiceImpl implements MesDcDeviceService {
    /**
     * é‡‡é›†ä»¤ç‰Œé•¿åº¦
     */
    private static final int TOKEN_LENGTH = 40;
    @Resource
    private MesDcDeviceMapper deviceMapper;
    @Resource
    private MesDcRecordMapper recordMapper;
    @Resource
    private MesProWorkOrderService workOrderService;
    @Override
    @Transactional(rollbackFor = Exception.class)
    public MesDcDeviceDO createDevice(MesDcDeviceSaveReqVO createReqVO) {
        validateDeviceCodeUnique(null, createReqVO.getCode());
        MesDcDeviceDO device = BeanUtils.toBean(createReqVO, MesDcDeviceDO.class);
        device.setId(null);
        device.setToken(RandomUtil.randomString(TOKEN_LENGTH));
        deviceMapper.insert(device);
        return device;
    }
    @Override
    @Transactional(rollbackFor = Exception.class)
    public void updateDevice(MesDcDeviceSaveReqVO updateReqVO) {
        MesDcDeviceDO oldDevice = validateDeviceExists(updateReqVO.getId());
        // è®¾å¤‡ç¼–号变化时校验唯一性(设备端需同步修改上报的 deviceCode)
        if (StrUtil.isNotBlank(updateReqVO.getCode())
                && ObjUtil.notEqual(oldDevice.getCode(), updateReqVO.getCode())) {
            validateDeviceCodeUnique(updateReqVO.getId(), updateReqVO.getCode());
        }
        MesDcDeviceDO updateObj = BeanUtils.toBean(updateReqVO, MesDcDeviceDO.class);
        updateObj.setToken(null); // ä»¤ç‰Œä»…通过重置接口变更
        deviceMapper.updateById(updateObj);
    }
    @Override
    @Transactional(rollbackFor = Exception.class)
    public void deleteDevice(Long id) {
        MesDcDeviceDO device = validateDeviceExists(id);
        Long recordCount = recordMapper.selectCountByDeviceId(id);
        if (recordCount != null && recordCount > 0) {
            throw exception(DC_DEVICE_DELETE_HAS_RECORD, device.getCode());
        }
        deviceMapper.deleteById(id);
    }
    @Override
    public MesDcDeviceDO getDevice(Long id) {
        return deviceMapper.selectById(id);
    }
    @Override
    public MesDcDeviceDO validateDeviceExists(Long id) {
        MesDcDeviceDO device = deviceMapper.selectById(id);
        if (device == null) {
            throw exception(DC_DEVICE_NOT_EXISTS);
        }
        return device;
    }
    @Override
    public PageResult<MesDcDeviceDO> getDevicePage(MesDcDevicePageReqVO pageReqVO) {
        return deviceMapper.selectPage(pageReqVO);
    }
    @Override
    public List<MesDcDeviceDO> getDeviceList() {
        return deviceMapper.selectSimpleList();
    }
    @Override
    @Transactional(rollbackFor = Exception.class)
    public String resetToken(Long id) {
        MesDcDeviceDO device = validateDeviceExists(id);
        String token = RandomUtil.randomString(TOKEN_LENGTH);
        MesDcDeviceDO updateObj = new MesDcDeviceDO();
        updateObj.setId(device.getId());
        updateObj.setToken(token);
        deviceMapper.updateById(updateObj);
        return token;
    }
    @Override
    @Transactional(rollbackFor = Exception.class)
    public void bindWorkOrder(Long id, Long workOrderId) {
        MesDcDeviceDO device = validateDeviceExists(id);
        MesProWorkOrderDO workOrder = workOrderService.getWorkOrder(workOrderId);
        if (workOrder == null) {
            throw exception(DC_DEVICE_WORK_ORDER_NOT_EXISTS);
        }
        // å·²å®Œå·¥ã€å·²å–消的工单不能绑定
        if (ObjUtil.equal(workOrder.getStatus(), MesProWorkOrderStatusEnum.FINISHED.getStatus())
                || ObjUtil.equal(workOrder.getStatus(), MesProWorkOrderStatusEnum.CANCELED.getStatus())) {
            throw exception(DC_DEVICE_WORK_ORDER_BIND_INVALID, workOrder.getCode(),
                    resolveWorkOrderStatusName(workOrder.getStatus()));
        }
        MesDcDeviceDO updateObj = MesDcDeviceDO.builder()
                .id(device.getId())
                .workOrderId(workOrder.getId())
                .workOrderCode(workOrder.getCode())
                .bindTime(LocalDateTime.now())
                .build();
        deviceMapper.updateById(updateObj);
    }
    @Override
    @Transactional(rollbackFor = Exception.class)
    public void unbindWorkOrder(Long id) {
        MesDcDeviceDO device = validateDeviceExists(id);
        deviceMapper.update(null, new LambdaUpdateWrapper<MesDcDeviceDO>()
                .eq(MesDcDeviceDO::getId, device.getId())
                .set(MesDcDeviceDO::getWorkOrderId, null)
                .set(MesDcDeviceDO::getWorkOrderCode, null)
                .set(MesDcDeviceDO::getBindTime, null));
    }
    @Override
    public MesDcDeviceDO validateDeviceToken(String deviceCode, String token) {
        if (StrUtil.isBlank(deviceCode)) {
            throw exception(DC_DEVICE_CODE_MISSING);
        }
        if (StrUtil.isBlank(token)) {
            throw exception(DC_DEVICE_TOKEN_REQUIRED);
        }
        MesDcDeviceDO device = deviceMapper.selectByCode(deviceCode);
        if (device == null) {
            throw exception(DC_DEVICE_CODE_NOT_EXISTS, deviceCode);
        }
        if (!isTokenMatch(token, device.getToken())) {
            throw exception(DC_DEVICE_TOKEN_INVALID, device.getCode());
        }
        return device;
    }
    @Override
    @Transactional(rollbackFor = Exception.class)
    public MesDcHeartbeatRespVO heartbeat(MesDcHeartbeatReqVO heartbeatReqVO, String token) {
        MesDcDeviceDO device = validateDeviceToken(heartbeatReqVO.getDeviceCode(), token);
        MesDcDeviceDO updateObj = new MesDcDeviceDO();
        updateObj.setId(device.getId());
        updateObj.setLastHeartbeatTime(LocalDateTime.now());
        if (StrUtil.isNotBlank(heartbeatReqVO.getFirmwareVersion())) {
            updateObj.setFirmwareVersion(heartbeatReqVO.getFirmwareVersion());
        }
        if (StrUtil.isNotBlank(heartbeatReqVO.getIp())) {
            updateObj.setDeviceIp(heartbeatReqVO.getIp());
        }
        deviceMapper.updateById(updateObj);
        MesDcHeartbeatRespVO respVO = new MesDcHeartbeatRespVO();
        respVO.setServerTime(LocalDateTime.now());
        respVO.setDeviceName(device.getName());
        respVO.setEnabled(ObjUtil.equal(device.getStatus(), MesDcDeviceStatusEnum.ENABLE.getStatus()));
        respVO.setWorkOrderId(device.getWorkOrderId());
        respVO.setWorkOrderCode(device.getWorkOrderCode());
        return respVO;
    }
    // ==================== ç§æœ‰æ–¹æ³• ====================
    private void validateDeviceCodeUnique(Long id, String code) {
        MesDcDeviceDO device = deviceMapper.selectByCode(code);
        if (device != null && ObjUtil.notEqual(device.getId(), id)) {
            throw exception(DC_DEVICE_CODE_DUPLICATE, code);
        }
    }
    private static boolean isTokenMatch(String submittedToken, String storedToken) {
        if (submittedToken == null || storedToken == null) {
            return false;
        }
        return MessageDigest.isEqual(submittedToken.getBytes(StandardCharsets.UTF_8),
                storedToken.getBytes(StandardCharsets.UTF_8));
    }
    private static String resolveWorkOrderStatusName(Integer status) {
        return Arrays.stream(MesProWorkOrderStatusEnum.values())
                .filter(item -> ObjUtil.equal(item.getStatus(), status))
                .findFirst().map(MesProWorkOrderStatusEnum::getName)
                .orElse("未知状态(" + status + ")");
    }
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/dc/record/MesDcRecordService.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,59 @@
package cn.iocoder.yudao.module.mes.service.dc.record;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcIngestReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcIngestRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo.MesDcRecordCancelReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo.MesDcRecordCorrectReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo.MesDcRecordPageReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.dc.record.MesDcRecordDO;
import jakarta.validation.Valid;
/**
 * MES æ•°æ®é‡‡é›†è®°å½• Service æŽ¥å£
 *
 * @author è¶…级管理员
 */
public interface MesDcRecordService {
    /**
     * æŽ¥æ”¶è®¾å¤‡ä¸ŠæŠ¥çš„采集数据
     *
     * @param reqVO   ä¸ŠæŠ¥å†…容
     * @param token   é‡‡é›†ä»¤ç‰Œ
     * @param rawData åŽŸå§‹ä¸ŠæŠ¥æŠ¥æ–‡ï¼ˆJSON)
     * @return ä¸ŠæŠ¥ç»“æžœ
     */
    MesDcIngestRespVO ingest(@Valid MesDcIngestReqVO reqVO, String token, String rawData);
    /**
     * æ›´æ­£é‡‡é›†è®°å½•
     *
     * @param reqVO æ›´æ­£ä¿¡æ¯
     */
    void correctRecord(@Valid MesDcRecordCorrectReqVO reqVO);
    /**
     * ä½œåºŸé‡‡é›†è®°å½•
     *
     * @param reqVO ä½œåºŸä¿¡æ¯
     */
    void cancelRecord(@Valid MesDcRecordCancelReqVO reqVO);
    /**
     * èŽ·å¾—é‡‡é›†è®°å½•
     *
     * @param id ç¼–号
     * @return é‡‡é›†è®°å½•
     */
    MesDcRecordDO getRecord(Long id);
    /**
     * èŽ·å¾—é‡‡é›†è®°å½•åˆ†é¡µ
     *
     * @param pageReqVO åˆ†é¡µæŸ¥è¯¢
     * @return é‡‡é›†è®°å½•分页
     */
    PageResult<MesDcRecordDO> getRecordPage(MesDcRecordPageReqVO pageReqVO);
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/dc/record/MesDcRecordServiceImpl.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,277 @@
package cn.iocoder.yudao.module.mes.service.dc.record;
import cn.hutool.core.util.ObjUtil;
import cn.hutool.core.util.StrUtil;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcIngestReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.open.vo.MesDcIngestRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo.MesDcRecordCancelReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo.MesDcRecordCorrectReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.record.vo.MesDcRecordPageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcStatisticsReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.dc.device.MesDcDeviceDO;
import cn.iocoder.yudao.module.mes.dal.dataobject.dc.record.MesDcRecordDO;
import cn.iocoder.yudao.module.mes.dal.dataobject.md.item.MesMdItemDO;
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.workorder.MesProWorkOrderDO;
import cn.iocoder.yudao.module.mes.dal.mysql.dc.device.MesDcDeviceMapper;
import cn.iocoder.yudao.module.mes.dal.mysql.dc.record.MesDcRecordMapper;
import cn.iocoder.yudao.module.mes.enums.dc.MesDcDeviceStatusEnum;
import cn.iocoder.yudao.module.mes.enums.dc.MesDcRecordStatusEnum;
import cn.iocoder.yudao.module.mes.service.dc.device.MesDcDeviceService;
import cn.iocoder.yudao.module.mes.service.md.item.MesMdItemService;
import cn.iocoder.yudao.module.mes.service.pro.workorder.MesProWorkOrderService;
import jakarta.annotation.Resource;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.validation.annotation.Validated;
import java.math.BigDecimal;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;
import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
import static cn.iocoder.yudao.module.mes.enums.ErrorCodeConstants.*;
/**
 * MES æ•°æ®é‡‡é›†è®°å½• Service å®žçŽ°ç±»
 *
 * @author è¶…级管理员
 */
@Service
@Validated
public class MesDcRecordServiceImpl implements MesDcRecordService {
    @Resource
    private MesDcRecordMapper recordMapper;
    @Resource
    private MesDcDeviceMapper deviceMapper;
    @Resource
    private MesDcDeviceService deviceService;
    @Resource
    private MesProWorkOrderService workOrderService;
    @Resource
    private MesMdItemService itemService;
    @Override
    @Transactional(rollbackFor = Exception.class)
    public MesDcIngestRespVO ingest(MesDcIngestReqVO reqVO, String token, String rawData) {
        // 1. æ ¡éªŒè®¾å¤‡ç¼–号与令牌
        MesDcDeviceDO device = deviceService.validateDeviceToken(reqVO.getDeviceCode(), token);
        // 2. å¹‚等:同一设备 + bizId é‡å¤ä¸ŠæŠ¥ç›´æŽ¥è¿”回已有记录
        if (StrUtil.isNotBlank(reqVO.getBizId())) {
            MesDcRecordDO existing = recordMapper.selectByDeviceIdAndBizId(device.getId(), reqVO.getBizId());
            if (existing != null) {
                return buildIngestResp(existing, device, true);
            }
        }
        // 3. æ ¡éªŒä¸ŠæŠ¥æ•°é‡ä¸Žé‡é‡
        validateIngestPayload(device, reqVO);
        // 4. è®¡ç®—本次数量:优先 count;只有累计值时按上一次累计值求差
        int quantity = resolveQuantity(device, reqVO);
        // ç´¯è®¡å€¼é‡å¤ä¸ŠæŠ¥ï¼ˆè®¾å¤‡é‡è¯•但未带 bizId):不新增记录,按重复上报返回
        if (reqVO.getCount() == null && reqVO.getTotalCount() != null && quantity == 0) {
            MesDcRecordDO last = recordMapper.selectLastByDeviceId(device.getId());
            if (last != null) {
                return buildIngestResp(last, device, true);
            }
        }
        // 5. ç»„装记录(截断到秒,避免数据库按秒四舍五入后落到下一时刻)
        LocalDateTime now = LocalDateTime.now().withNano(0);
        MesDcRecordDO record = new MesDcRecordDO();
        record.setDeviceId(device.getId());
        record.setDeviceCode(device.getCode());
        record.setDeviceName(device.getName());
        record.setRecordNo(reqVO.getRecordNo());
        record.setBizId(StrUtil.emptyToNull(reqVO.getBizId()));
        record.setQuantity(quantity);
        record.setTotalQuantity(reqVO.getTotalCount());
        record.setWeight(reqVO.getWeight());
        record.setTotalWeight(reqVO.getTotalWeight());
        record.setRecordTime(reqVO.getRecordTime() != null ? reqVO.getRecordTime() : now);
        record.setReceiveTime(now);
        record.setOnline(reqVO.getOnline() == null || reqVO.getOnline());
        record.setRawData(rawData);
        record.setStatus(MesDcRecordStatusEnum.NORMAL.getStatus());
        fillWorkOrderInfo(record, device);
        recordMapper.insert(record);
        // 6. æ›´æ–°è®¾å¤‡æœ€åŽä¸ŠæŠ¥æ—¶é—´ä¸Žå›ºä»¶ç‰ˆæœ¬
        MesDcDeviceDO updateObj = new MesDcDeviceDO();
        updateObj.setId(device.getId());
        updateObj.setLastIngestTime(now);
        if (StrUtil.isNotBlank(reqVO.getFirmwareVersion())) {
            updateObj.setFirmwareVersion(reqVO.getFirmwareVersion());
        }
        deviceMapper.updateById(updateObj);
        return buildIngestResp(record, device, false);
    }
    @Override
    @Transactional(rollbackFor = Exception.class)
    public void correctRecord(MesDcRecordCorrectReqVO reqVO) {
        MesDcRecordDO record = validateRecordExists(reqVO.getId());
        if (!ObjUtil.equal(record.getStatus(), MesDcRecordStatusEnum.NORMAL.getStatus())) {
            throw exception(DC_RECORD_OPERATE_STATUS_INVALID, record.getId(),
                    resolveRecordStatusName(record.getStatus()), "更正");
        }
        MesDcRecordDO updateObj = new MesDcRecordDO();
        updateObj.setId(record.getId());
        updateObj.setQuantity(reqVO.getQuantity());
        updateObj.setStatus(MesDcRecordStatusEnum.CORRECTED.getStatus());
        updateObj.setCorrectReason(reqVO.getReason());
        if (record.getOriginalQuantity() == null) {
            updateObj.setOriginalQuantity(record.getQuantity());
        }
        recordMapper.updateById(updateObj);
    }
    @Override
    @Transactional(rollbackFor = Exception.class)
    public void cancelRecord(MesDcRecordCancelReqVO reqVO) {
        MesDcRecordDO record = validateRecordExists(reqVO.getId());
        if (ObjUtil.equal(record.getStatus(), MesDcRecordStatusEnum.CANCELED.getStatus())) {
            throw exception(DC_RECORD_OPERATE_STATUS_INVALID, record.getId(),
                    resolveRecordStatusName(record.getStatus()), "作废");
        }
        MesDcRecordDO updateObj = new MesDcRecordDO();
        updateObj.setId(record.getId());
        updateObj.setStatus(MesDcRecordStatusEnum.CANCELED.getStatus());
        updateObj.setCorrectReason(reqVO.getReason());
        if (record.getOriginalQuantity() == null) {
            updateObj.setOriginalQuantity(record.getQuantity());
        }
        recordMapper.updateById(updateObj);
    }
    @Override
    public MesDcRecordDO getRecord(Long id) {
        return recordMapper.selectById(id);
    }
    @Override
    public PageResult<MesDcRecordDO> getRecordPage(MesDcRecordPageReqVO pageReqVO) {
        return recordMapper.selectPage(pageReqVO);
    }
    // ==================== ç§æœ‰æ–¹æ³• ====================
    private MesDcRecordDO validateRecordExists(Long id) {
        MesDcRecordDO record = recordMapper.selectById(id);
        if (record == null) {
            throw exception(DC_RECORD_NOT_EXISTS);
        }
        return record;
    }
    private void validateIngestPayload(MesDcDeviceDO device, MesDcIngestReqVO reqVO) {
        if (ObjUtil.equal(device.getStatus(), MesDcDeviceStatusEnum.DISABLE.getStatus())) {
            throw exception(DC_DEVICE_DISABLED, device.getName() + "(" + device.getCode() + ")");
        }
        if (reqVO.getCount() == null && reqVO.getTotalCount() == null) {
            throw exception(DC_RECORD_COUNT_REQUIRED);
        }
        if ((reqVO.getCount() != null && reqVO.getCount() < 0)
                || (reqVO.getTotalCount() != null && reqVO.getTotalCount() < 0)) {
            throw exception(DC_RECORD_COUNT_INVALID,
                    reqVO.getCount() == null ? "未填写" : String.valueOf(reqVO.getCount()),
                    reqVO.getTotalCount() == null ? "未填写" : String.valueOf(reqVO.getTotalCount()));
        }
        if ((reqVO.getWeight() != null && reqVO.getWeight().signum() < 0)
                || (reqVO.getTotalWeight() != null && reqVO.getTotalWeight().signum() < 0)) {
            throw exception(DC_RECORD_WEIGHT_INVALID,
                    reqVO.getWeight() == null ? "未填写" : reqVO.getWeight().toPlainString(),
                    reqVO.getTotalWeight() == null ? "未填写" : reqVO.getTotalWeight().toPlainString());
        }
    }
    /**
     * è®¡ç®—本次数量:
     * 1. ä¸ŠæŠ¥ count æ—¶ç›´æŽ¥ä½¿ç”¨ï¼›
     * 2. åªæœ‰ totalCount æ—¶ï¼Œä¸Žä¸Šä¸€æ¬¡è®°å½•的累计值求差;首次上报或设备计数器清零时直接使用累计值。
     */
    private int resolveQuantity(MesDcDeviceDO device, MesDcIngestReqVO reqVO) {
        if (reqVO.getCount() != null) {
            return reqVO.getCount();
        }
        MesDcRecordDO last = recordMapper.selectLastByDeviceId(device.getId());
        Integer lastTotal = last != null ? last.getTotalQuantity() : null;
        if (lastTotal == null || reqVO.getTotalCount() < lastTotal) {
            return reqVO.getTotalCount();
        }
        return reqVO.getTotalCount() - lastTotal;
    }
    private void fillWorkOrderInfo(MesDcRecordDO record, MesDcDeviceDO device) {
        if (device.getWorkOrderId() == null) {
            return;
        }
        MesProWorkOrderDO workOrder = workOrderService.getWorkOrder(device.getWorkOrderId());
        if (workOrder == null) {
            return;
        }
        record.setWorkOrderId(workOrder.getId());
        record.setWorkOrderCode(workOrder.getCode());
        record.setProductId(workOrder.getProductId());
        record.setBatchCode(workOrder.getBatchCode());
        if (workOrder.getProductId() != null) {
            MesMdItemDO item = itemService.getItem(workOrder.getProductId());
            if (item != null) {
                record.setProductCode(item.getCode());
                record.setProductName(item.getName());
            }
        }
    }
    private MesDcIngestRespVO buildIngestResp(MesDcRecordDO record, MesDcDeviceDO device,
                                              boolean duplicate) {
        MesDcIngestRespVO respVO = new MesDcIngestRespVO();
        respVO.setRecordId(record.getId());
        respVO.setDuplicate(duplicate);
        respVO.setQuantity(record.getQuantity());
        respVO.setServerTime(LocalDateTime.now());
        // ä»Šæ—¥ç´¯è®¡ï¼ˆä¸å«å·²ä½œåºŸè®°å½•)
        MesDcStatisticsReqVO todayReqVO = new MesDcStatisticsReqVO();
        todayReqVO.setBeginTime(LocalDate.now().atStartOfDay());
        todayReqVO.setEndTime(LocalDate.now().plusDays(1).atStartOfDay());
        todayReqVO.setDeviceId(device.getId());
        List<Map<String, Object>> totals = recordMapper.selectTotals(todayReqVO);
        Map<String, Object> totalRow = totals.isEmpty() ? Map.of() : totals.get(0);
        respVO.setTodayQuantity(toLong(totalRow.get("totalQuantity")));
        respVO.setTodayWeight(toDecimal(totalRow.get("totalWeight")));
        return respVO;
    }
    private static String resolveRecordStatusName(Integer status) {
        MesDcRecordStatusEnum statusEnum = MesDcRecordStatusEnum.valueOf(status);
        return statusEnum != null ? statusEnum.getName() : "未知状态(" + status + ")";
    }
    private static long toLong(Object value) {
        if (value == null) {
            return 0L;
        }
        if (value instanceof Number number) {
            return number.longValue();
        }
        return Long.parseLong(value.toString());
    }
    private static BigDecimal toDecimal(Object value) {
        if (value == null) {
            return BigDecimal.ZERO;
        }
        if (value instanceof BigDecimal decimal) {
            return decimal;
        }
        if (value instanceof Number number) {
            return new BigDecimal(number.toString());
        }
        return new BigDecimal(value.toString());
    }
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/dc/statistics/MesDcStatisticsService.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,40 @@
package cn.iocoder.yudao.module.mes.service.dc.statistics;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcDeviceOverviewRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcStatisticsReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcStatisticsSummaryRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcStatisticsTrendItemVO;
import java.util.List;
/**
 * MES æ•°æ®é‡‡é›†ç»Ÿè®¡ Service æŽ¥å£
 *
 * @author è¶…级管理员
 */
public interface MesDcStatisticsService {
    /**
     * èŽ·å¾—é‡‡é›†ç»Ÿè®¡æ±‡æ€»ï¼ˆä¸å«å·²ä½œåºŸè®°å½•ï¼‰
     *
     * @param reqVO ç»Ÿè®¡æ¡ä»¶
     * @return ç»Ÿè®¡æ±‡æ€»
     */
    MesDcStatisticsSummaryRespVO getSummary(MesDcStatisticsReqVO reqVO);
    /**
     * èŽ·å¾—é‡‡é›†è¶‹åŠ¿ï¼ˆä¸å«å·²ä½œåºŸè®°å½•ï¼‰
     *
     * @param reqVO ç»Ÿè®¡æ¡ä»¶
     * @return è¶‹åŠ¿åˆ—è¡¨
     */
    List<MesDcStatisticsTrendItemVO> getTrend(MesDcStatisticsReqVO reqVO);
    /**
     * èŽ·å¾—è®¾å¤‡å®žæ—¶æ¦‚è§ˆï¼ˆå…¨éƒ¨è®¾å¤‡çš„ä»Šæ—¥é‡‡é›†ä¸Žåœ¨çº¿çŠ¶æ€ï¼‰
     *
     * @return è®¾å¤‡æ¦‚览列表
     */
    List<MesDcDeviceOverviewRespVO> getDeviceOverview();
}
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/dc/statistics/MesDcStatisticsServiceImpl.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,148 @@
package cn.iocoder.yudao.module.mes.service.dc.statistics;
import cn.hutool.core.util.ObjUtil;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcDeviceOverviewRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcStatisticsDeviceItemVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcStatisticsReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcStatisticsSummaryRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.dc.statistics.vo.MesDcStatisticsTrendItemVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.dc.device.MesDcDeviceDO;
import cn.iocoder.yudao.module.mes.dal.mysql.dc.device.MesDcDeviceMapper;
import cn.iocoder.yudao.module.mes.dal.mysql.dc.record.MesDcRecordMapper;
import cn.iocoder.yudao.module.mes.enums.dc.MesDcDeviceStatusEnum;
import jakarta.annotation.Resource;
import org.springframework.stereotype.Service;
import org.springframework.validation.annotation.Validated;
import java.math.BigDecimal;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
/**
 * MES æ•°æ®é‡‡é›†ç»Ÿè®¡ Service å®žçŽ°ç±»
 *
 * @author è¶…级管理员
 */
@Service
@Validated
public class MesDcStatisticsServiceImpl implements MesDcStatisticsService {
    /**
     * è®¾å¤‡åœ¨çº¿åˆ¤å®šé˜ˆå€¼ï¼ˆåˆ†é’Ÿï¼‰ï¼šè¶…过该时间无心跳视为离线
     */
    private static final int ONLINE_TIMEOUT_MINUTES = 5;
    @Resource
    private MesDcRecordMapper recordMapper;
    @Resource
    private MesDcDeviceMapper deviceMapper;
    @Override
    public MesDcStatisticsSummaryRespVO getSummary(MesDcStatisticsReqVO reqVO) {
        MesDcStatisticsSummaryRespVO summary = new MesDcStatisticsSummaryRespVO();
        // 1. æ±‡æ€»æ•°é‡ã€é‡é‡ã€æ¡æ•°
        List<Map<String, Object>> totals = recordMapper.selectTotals(reqVO);
        Map<String, Object> totalRow = totals.isEmpty() ? Map.of() : totals.get(0);
        summary.setTotalQuantity(toLong(totalRow.get("totalQuantity")));
        summary.setTotalWeight(toDecimal(totalRow.get("totalWeight")));
        summary.setRecordCount(toLong(totalRow.get("recordCount")));
        // 2. æŒ‰è®¾å¤‡åˆ†ç»„
        List<MesDcStatisticsDeviceItemVO> devices = new ArrayList<>();
        for (Map<String, Object> row : recordMapper.selectDeviceSummary(reqVO)) {
            MesDcStatisticsDeviceItemVO item = new MesDcStatisticsDeviceItemVO();
            item.setDeviceId(toLong(row.get("deviceId")));
            item.setDeviceCode(toString(row.get("deviceCode")));
            item.setDeviceName(toString(row.get("deviceName")));
            item.setTotalQuantity(toLong(row.get("totalQuantity")));
            item.setTotalWeight(toDecimal(row.get("totalWeight")));
            item.setRecordCount(toLong(row.get("recordCount")));
            devices.add(item);
        }
        summary.setDevices(devices);
        summary.setDeviceCount(devices.size());
        return summary;
    }
    @Override
    public List<MesDcStatisticsTrendItemVO> getTrend(MesDcStatisticsReqVO reqVO) {
        boolean byHour = "hour".equalsIgnoreCase(reqVO.getGranularity());
        List<MesDcStatisticsTrendItemVO> result = new ArrayList<>();
        for (Map<String, Object> row : recordMapper.selectTrend(reqVO, byHour)) {
            MesDcStatisticsTrendItemVO item = new MesDcStatisticsTrendItemVO();
            item.setPeriod(toString(row.get("period")));
            item.setTotalQuantity(toLong(row.get("totalQuantity")));
            item.setTotalWeight(toDecimal(row.get("totalWeight")));
            item.setRecordCount(toLong(row.get("recordCount")));
            result.add(item);
        }
        return result;
    }
    @Override
    public List<MesDcDeviceOverviewRespVO> getDeviceOverview() {
        List<MesDcDeviceDO> devices = deviceMapper.selectSimpleList();
        // ä»Šæ—¥æŒ‰è®¾å¤‡ç»Ÿè®¡
        MesDcStatisticsReqVO todayReqVO = new MesDcStatisticsReqVO();
        todayReqVO.setBeginTime(LocalDate.now().atStartOfDay());
        todayReqVO.setEndTime(LocalDate.now().plusDays(1).atStartOfDay());
        Map<Long, Map<String, Object>> summaryByDevice = new HashMap<>();
        for (Map<String, Object> row : recordMapper.selectDeviceSummary(todayReqVO)) {
            summaryByDevice.put(toLong(row.get("deviceId")), row);
        }
        // ç»„装概览
        LocalDateTime onlineThreshold = LocalDateTime.now().minusMinutes(ONLINE_TIMEOUT_MINUTES);
        List<MesDcDeviceOverviewRespVO> result = new ArrayList<>(devices.size());
        for (MesDcDeviceDO device : devices) {
            MesDcDeviceOverviewRespVO item = new MesDcDeviceOverviewRespVO();
            item.setDeviceId(device.getId());
            item.setCode(device.getCode());
            item.setName(device.getName());
            item.setEnabled(ObjUtil.equal(device.getStatus(), MesDcDeviceStatusEnum.ENABLE.getStatus()));
            item.setOnline(device.getLastHeartbeatTime() != null
                    && device.getLastHeartbeatTime().isAfter(onlineThreshold));
            item.setWorkOrderId(device.getWorkOrderId());
            item.setWorkOrderCode(device.getWorkOrderCode());
            Map<String, Object> row = summaryByDevice.get(device.getId());
            item.setTodayQuantity(row == null ? 0L : toLong(row.get("totalQuantity")));
            item.setTodayWeight(row == null ? BigDecimal.ZERO : toDecimal(row.get("totalWeight")));
            item.setLastIngestTime(device.getLastIngestTime());
            item.setLastHeartbeatTime(device.getLastHeartbeatTime());
            result.add(item);
        }
        return result;
    }
    // ==================== è½¬æ¢æ–¹æ³• ====================
    private static long toLong(Object value) {
        if (value == null) {
            return 0L;
        }
        if (value instanceof Number number) {
            return number.longValue();
        }
        return Long.parseLong(value.toString());
    }
    private static BigDecimal toDecimal(Object value) {
        if (value == null) {
            return BigDecimal.ZERO;
        }
        if (value instanceof BigDecimal decimal) {
            return decimal;
        }
        if (value instanceof Number number) {
            return new BigDecimal(number.toString());
        }
        return new BigDecimal(value.toString());
    }
    private static String toString(Object value) {
        return value == null ? null : value.toString();
    }
}