diff --git a/aucma-report/boardAPIComplete.md b/aucma-report/boardAPIComplete.md new file mode 100644 index 0000000..f24a668 --- /dev/null +++ b/aucma-report/boardAPIComplete.md @@ -0,0 +1,997 @@ +# Board4 看板真实数据接口实现方案 + +## 一、接口概述 + +### 1.1 接口列表 + +| 序号 | 接口路径 | 请求方式 | 功能描述 | 实体类 | +|------|----------|----------|----------|--------| +| 1 | `/board4/productionTotal` | GET | 产量统计(年/月/日累计) | Board4ProductionTotalVo | +| 2 | `/board4/orderStatistics` | GET | 工单统计(计划/完成/差异/完成率) | Board4OrderStatisticsVo | +| 3 | `/board4/orderProgressList` | GET | 工单进度列表 | Board4OrderProgressVo | +| 4 | `/board4/deviceStatus` | GET | 设备状态统计 | Board4DeviceStatusVo | +| 5 | `/board4/alarmInfo` | GET | 最新报警信息 | Board4AlarmInfoVo | +| 6 | `/board4/repairAnalysisList` | GET | 维修分析列表(按设备聚合) | Board4RepairAnalysisVo | +| 7 | `/board4/repairTrendList` | GET | 报修趋势列表 | Board4RepairTrendVo | +| 8 | `/board4/qualityStatistics` | GET | 质量统计 | Board4QualityStatisticsVo | +| 9 | `/board4/qualityTraceList` | GET | 质量追溯列表 | Board4QualityTraceVo | +| 10 | `/board4/deviceProductionList` | GET | 设备分析/产量列表 | Board4DeviceProductionVo | + +### 1.2 前端页面 + +- **页面位置**: `zs_aucma-mes-ui/src/views/board/board4/index.vue` +- **前端API**: `zs_aucma-mes-ui/src/api/board/board4.js` + +--- + +## 二、后端文件清单 + +### 2.1 VO实体类(10个) + +| 序号 | 文件路径 | 说明 | +|------|----------|------| +| 1 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board4ProductionTotalVo.java` | 产量统计 | +| 2 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board4OrderStatisticsVo.java` | 工单统计 | +| 3 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board4OrderProgressVo.java` | 工单进度 | +| 4 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board4DeviceStatusVo.java` | 设备状态 | +| 5 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board4AlarmInfoVo.java` | 报警信息 | +| 6 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board4RepairAnalysisVo.java` | 维修分析 | +| 7 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board4RepairTrendVo.java` | 报修趋势 | +| 8 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board4QualityStatisticsVo.java` | 质量统计 | +| 9 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board4QualityTraceVo.java` | 质量追溯 | +| 10 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board4DeviceProductionVo.java` | 设备产量 | + +### 2.2 后端核心文件(4个) + +| 序号 | 文件类型 | 文件路径 | +|------|----------|----------| +| 1 | Mapper接口 | `aucma-report/src/main/java/com/aucma/report/mapper/Board4Mapper.java` | +| 2 | Mapper XML | `aucma-report/src/main/resources/mapper/report/Board4Mapper.xml` | +| 3 | Service接口 | `aucma-report/src/main/java/com/aucma/report/service/IBoard4Service.java` | +| 4 | Service实现 | `aucma-report/src/main/java/com/aucma/report/service/impl/Board4ServiceImpl.java` | +| 5 | Controller | `aucma-report/src/main/java/com/aucma/report/controller/Board4Controller.java` | + +### 2.3 前端文件 + +| 序号 | 文件类型 | 文件路径 | +|------|----------|----------| +| 1 | API文件 | `zs_aucma-mes-ui/src/api/board/board4.js` | + +--- + +## 三、实体类定义 + +### 3.1 Board4ProductionTotalVo - 产量统计 + +```java +public class Board4ProductionTotalVo { + /** 年累计产量(去年数据,来源BASE_ORDERINFO) */ + private Long yearTotal; + + /** 月累计产量(当月数据,来源BASE_ORDERINFO) */ + private Long monthTotal; + + /** 日累计产量(当天数据,来源BASE_DEVICE_PARAM_VAL,PARAM_NAME='机台状态-实际产出数量') */ + private Long dayTotal; +} +``` + +### 3.2 Board4OrderStatisticsVo - 工单统计 + +```java +public class Board4OrderStatisticsVo { + /** 今日计划数 */ + private Long planCount; + + /** 今日完成数 */ + private Long completeCount; + + /** 今日差异数(计划-完成) */ + private Long diffCount; + + /** 今日完成率(百分比,不含%) */ + private String completeRate; +} +``` + +### 3.3 Board4OrderProgressVo - 工单进度 + +```java +public class Board4OrderProgressVo { + /** 型号/物料名称 */ + private String materialName; + + /** 计划数 */ + private Long planCount; + + /** 完成数 */ + private Long completeCount; + + /** 差异数 */ + private Long diffCount; + + /** 执行进度(如 90%) */ + private String progress; +} +``` + +### 3.4 Board4DeviceStatusVo - 设备状态 + +```java +public class Board4DeviceStatusVo { + /** 设备正常数(DEVICE_STATUS='0') */ + private Long normalCount; + + /** 设备告警数(DEVICE_STATUS='1') */ + private Long alarmCount; + + /** 设备停机数(DEVICE_STATUS='2') */ + private Long stopCount; + + /** 设备总数 */ + private Long totalCount; + + /** 总维修次数 */ + private Long repairCount; +} +``` + +### 3.5 Board4AlarmInfoVo - 报警信息 + +```java +public class Board4AlarmInfoVo { + /** 是否有报警 */ + private Boolean hasAlarm; + + /** 报警设备名称 */ + private String deviceName; + + /** 报警原因 */ + private String alarmReason; + + /** 报警时间 */ + private String alarmTime; +} +``` + +### 3.6 Board4RepairAnalysisVo - 维修分析 + +```java +public class Board4RepairAnalysisVo { + /** 设备名称 */ + private String deviceName; + + /** 占比(百分比数值) */ + private Long percent; + + /** 维修次数 */ + private Long repairCount; +} +``` + +### 3.7 Board4RepairTrendVo - 报修趋势 + +```java +public class Board4RepairTrendVo { + /** 时间(小时,如 08:00) */ + private String timeHour; + + /** 报修次数 */ + private Long repairCount; +} +``` + +### 3.8 Board4QualityStatisticsVo - 质量统计 + +```java +public class Board4QualityStatisticsVo { + /** 合格数(TREATMENT_MEASURE='3') */ + private Long qualifiedCount; + + /** 不合格数(TREATMENT_MEASURE='1') */ + private Long unqualifiedCount; +} +``` + +### 3.9 Board4QualityTraceVo - 质量追溯 + +```java +public class Board4QualityTraceVo { + /** 产品名/物料名称 */ + private String materialName; + + /** 合格率(百分比数值) */ + private Long passRate; + + /** 合格上限(默认100) */ + private Long passLimit; +} +``` + +### 3.10 Board4DeviceProductionVo - 设备产量 + +```java +public class Board4DeviceProductionVo { + /** 设备名称 */ + private String deviceName; + + /** 实际产量(当天工艺参数,PARAM_NAME='机台状态-实际产出数量') */ + private Long production; +} +``` + +--- + +## 四、数据源与业务逻辑 + +### 4.1 接口数据源映射表 + +| 接口 | 数据源表 | 业务逻辑 | +| productionTotal | BASE_ORDERINFO, BASE_DEVICE_PARAM_VAL | 年累计=去年SUM(COMPLETE_AMOUNT),月累计=当月SUM(COMPLETE_AMOUNT),日累计=当天PARAM_NAME='机台状态-实际产出数量'最新值汇总(按设备取最新一条) | +| orderStatistics | BASE_ORDERINFO | 当天SUM(ORDER_AMOUNT)和SUM(COMPLETE_AMOUNT),差异=计划-完成,完成率=完成/计划 | +| orderProgressList | BASE_ORDERINFO | 当天工单列表,进度=完成/计划百分比并带% | +| deviceStatus | BASE_DEVICELEDGER, DMS_BILLS_FAULT_INSTANCE | IS_FLAG=0有效设备,按DEVICE_STATUS分组统计+总维修次数 | +| alarmInfo | RECORD_ALARM_DEVICE | IS_FLAG=0的最新一条报警记录,时间格式HH24:MI:SS | +| repairAnalysisList | DMS_BILLS_FAULT_INSTANCE, BASE_DEVICELEDGER | 按设备聚合故障次数,按次数倒序取TOP10 | +| repairTrendList | DMS_BILLS_FAULT_INSTANCE | 按小时统计当天报修次数 | +| qualityStatistics | REPORT_QUALITY_INSPECTION | 当天TREATMENT_MEASURE='3'和'1'分组统计 | +| qualityTraceList | REPORT_QUALITY_INSPECTION | 近7天按产品统计合格率,按合格率倒序取TOP10 | +| deviceProductionList | BASE_DEVICE_PARAM_VAL, BASE_DEVICELEDGER | 仅生产设备DEVICE_TYPE='1'且IS_FLAG=0,取当天每台设备最新产出值 | + +### 4.2 关键SQL说明 + +#### 4.2.1 日累计产量(BASE_DEVICE_PARAM_VAL) + +```sql +SELECT NVL(SUM(TO_NUMBER(PARAM_VALUE)), 0) +FROM ( + SELECT DEVICE_CODE, PARAM_VALUE, + ROW_NUMBER() OVER (PARTITION BY DEVICE_CODE ORDER BY COLLECT_TIME DESC) AS RN + FROM BASE_DEVICE_PARAM_VAL + WHERE PARAM_NAME = '机台状态-实际产出数量' + AND TO_CHAR(COLLECT_TIME, 'YYYY-MM-DD') = TO_CHAR(SYSDATE, 'YYYY-MM-DD') +) +WHERE RN = 1 +``` + +**业务逻辑说明**: +- **使用 PARAM_NAME 而非 PARAM_CODE**:`PARAM_CODE` 可能因不同设备而变化,但 `PARAM_NAME` 是固定的,始终为 "机台状态-实际产出数量" +- **窗口函数作用**:`ROW_NUMBER() OVER (PARTITION BY DEVICE_CODE ORDER BY COLLECT_TIME DESC)` 按设备分组,按采集时间倒序排列,取 RN=1 即每台设备当天最新的一条记录 +- **汇总逻辑**:将所有设备的最新实际产出数量求和,得到日累计产量 + +#### 4.2.2 维修分析(按设备聚合) + +```sql +SELECT d.DEVICE_NAME AS deviceName, + COUNT(*) AS repairCount, + ROUND(COUNT(*) * 100.0 / NULLIF((SELECT COUNT(*) FROM DMS_BILLS_FAULT_INSTANCE WHERE IS_FLAG = 1), 0), 0) AS percent +FROM DMS_BILLS_FAULT_INSTANCE f +LEFT JOIN BASE_DEVICELEDGER d ON f.DEVICE_ID = d.OBJ_ID +WHERE f.IS_FLAG = 1 AND f.DEVICE_ID IS NOT NULL +GROUP BY d.OBJ_ID, d.DEVICE_NAME +ORDER BY repairCount DESC +``` + +#### 4.2.3 设备产量列表 + +```sql +SELECT d.DEVICE_NAME AS deviceName, + NVL(TO_NUMBER(p.PARAM_VALUE), 0) AS production +FROM BASE_DEVICELEDGER d +LEFT JOIN ( + SELECT DEVICE_CODE, PARAM_VALUE + FROM ( + SELECT DEVICE_CODE, PARAM_VALUE, + ROW_NUMBER() OVER (PARTITION BY DEVICE_CODE ORDER BY COLLECT_TIME DESC) AS RN + FROM BASE_DEVICE_PARAM_VAL + WHERE PARAM_NAME = '机台状态-实际产出数量' + AND TO_CHAR(COLLECT_TIME, 'YYYY-MM-DD') = TO_CHAR(SYSDATE, 'YYYY-MM-DD') + ) + WHERE RN = 1 +) p ON d.DEVICE_CODE = p.DEVICE_CODE +WHERE d.IS_FLAG = 0 AND d.DEVICE_TYPE = '1' +ORDER BY production DESC +``` + +**业务逻辑说明**: +- **关联查询**:将设备台账表(BASE_DEVICELEDGER)与设备工艺参数表(BASE_DEVICE_PARAM_VAL)通过 DEVICE_CODE 关联 +- **筛选条件**:`PARAM_NAME = '机台状态-实际产出数量'` 获取实际产出数量参数 +- **设备过滤**:`IS_FLAG = 0`(NUMBER类型,有效设备)且 `DEVICE_TYPE = '1'`(生产设备) +- **排序逻辑**:按产量降序排列,产量高的设备排在前面 + +### 4.3 服务层返回规则补充 + +- 所有统计类数值默认返回0,避免空值导致前端异常 +- 完成率等比例字段返回的是数字字符串,不包含“%” +- 工单进度列表的 progress 字段为带“%”的字符串(如 90%) +- 最新报警无数据时:hasAlarm=false,其他字段为空字符串 + +--- + +## 五、前端API + +### 5.1 API文件 + +**文件**: `zs_aucma-mes-ui/src/api/board/board4.js` + +```javascript +import request from '@/utils/request' + +// 获取产量统计(年累计、月累计、日累计) +export function getProductionTotal() { + return request({ url: '/board4/productionTotal', method: 'get' }) +} + +// 获取今日工单统计 +export function getOrderStatistics() { + return request({ url: '/board4/orderStatistics', method: 'get' }) +} + +// 获取今日工单进度列表 +export function getOrderProgressList() { + return request({ url: '/board4/orderProgressList', method: 'get' }) +} + +// 获取设备状态统计 +export function getDeviceStatus() { + return request({ url: '/board4/deviceStatus', method: 'get' }) +} + +// 获取最新报警信息 +export function getAlarmInfo() { + return request({ url: '/board4/alarmInfo', method: 'get' }) +} + +// 获取维修分析列表 +export function getRepairAnalysisList() { + return request({ url: '/board4/repairAnalysisList', method: 'get' }) +} + +// 获取报修趋势列表 +export function getRepairTrendList() { + return request({ url: '/board4/repairTrendList', method: 'get' }) +} + +// 获取质量统计 +export function getQualityStatistics() { + return request({ url: '/board4/qualityStatistics', method: 'get' }) +} + +// 获取质量追溯列表 +export function getQualityTraceList() { + return request({ url: '/board4/qualityTraceList', method: 'get' }) +} + +// 获取设备分析/产量列表 +export function getDeviceProductionList() { + return request({ url: '/board4/deviceProductionList', method: 'get' }) +} +``` + +--- + +## 六、数据库表结构参考 + +### 6.1 BASE_ORDERINFO(工单表) + +| 字段 | 类型 | 说明 | +|------|------|------| +| OBJ_ID | NUMBER | 主键 | +| MATERIAL_NAME | VARCHAR2 | 物料名称 | +| ORDER_AMOUNT | NUMBER | 订单数量 | +| COMPLETE_AMOUNT | NUMBER | 完成数量 | +| BEGIN_DATE | DATE | 计划开始日期 | + +### 6.2 BASE_DEVICE_PARAM_VAL(设备工艺参数表) + +| 字段 | 类型 | 说明 | +|------|------|------| +| PARAM_NAME | VARCHAR2 | 参数名称(固定值,如 "机台状态-实际产出数量") | +| DEVICE_CODE | VARCHAR2 | 设备编号 | +| PARAM_VALUE | VARCHAR2 | 参数值 | +| COLLECT_TIME | DATE | 采集时间 | + +### 6.3 BASE_DEVICELEDGER(设备台账表) + + +| 字段 | 类型 | 说明 | +|------|------|------| +| OBJ_ID | NUMBER | 主键标识(用于关联查询) | +| DEVICE_CODE | VARCHAR2(64) | 设备编号 | +| DEVICE_NAME | VARCHAR2(64) | 设备名称 | +| DEVICE_STATUS | NUMBER(1,0) | 设备状态(0=使用,1=停用,2=报废) | +| DEVICE_TYPE | VARCHAR2(32) | 设备类型(1=生产设备,2=计量设备) | +| IS_FLAG | NUMBER(1,0) | 是否标识(0=有效) | + +**重要说明**: +- `DEVICE_STATUS` 和 `IS_FLAG` 是 `NUMBER(1,0)` 类型,SQL查询时不加引号 +- 关联查询使用 `OBJ_ID` 作为主键,不是 `DEVICE_ID` + +### 6.4 RECORD_ALARM_DEVICE(设备告警记录表) + +| 字段 | 类型 | 说明 | +|------|------|------| +| OBJ_ID | NUMBER(38,0) | 主键 | +| DEVICE_CODE | VARCHAR2(128) | 设备编号 | +| DEVICE_NAME | VARCHAR2(128) | 设备名称 | +| DEVICE_TYPE | VARCHAR2(32) | 设备类型 | +| ALARM_INFO | VARCHAR2(255) | 报警信息 | +| ALARM_TIME | DATE | 报警时间 | +| REMARK | VARCHAR2(255) | 备注 | +| IS_FLAG | NUMBER | 是否标识(0=有效) | +| CREATED_BY | VARCHAR2(32) | 创建人 | +| CREATED_TIME | DATE | 创建时间 | +| BATCH_ID | VARCHAR2(128) | 批次ID | +| PARAM_CODE | VARCHAR2(32) | 参数编码 | +| PARAM_VALUE | VARCHAR2(32) | 参数值 | + +**报警信息来源**:使用 `RECORD_ALARM_DEVICE` 表,字段 `ALARM_INFO` 和 `ALARM_TIME`,并以 `IS_FLAG = 0` 过滤有效记录 + +### 6.5 DMS_BILLS_FAULT_INSTANCE(故障报修工单表) + + +--- + +## 七、接口返回示例 + +### 7.1 产量统计 + +```json +{ "code": 200, "data": { "yearTotal": 125000, "monthTotal": 12500, "dayTotal": 27218 } } +``` + +### 7.2 工单统计 + +```json +{ "code": 200, "data": { "planCount": 1000, "completeCount": 850, "diffCount": 150, "completeRate": "85" } } +``` + +### 7.3 维修分析列表 + +```json +{ "code": 200, "data": [{ "deviceName": "YZM-01", "percent": 40, "repairCount": 10 }] } +``` + +### 7.4 设备产量列表 + +```json +{ "code": 200, "data": [{ "deviceName": "YZM-02", "production": 27218 }] } +``` + +--- + +## 八、注意事项 + +1. **❗重要:使用 PARAM_NAME 而非 PARAM_CODE** + - 错误写法:`WHERE PARAM_CODE = '19'` + - 正确写法:`WHERE PARAM_NAME = '机台状态-实际产出数量'` + - 原因:`PARAM_CODE` 可能因不同设备而变化,但 `PARAM_NAME` 是固定的 + +2. **设备状态映射**(NUMBER类型,不加引号):0=正常/使用,1=告警/停用,2=停机/报废 + +3. **❗重要:BASE_DEVICELEDGER 表字段类型** + - `OBJ_ID`:NUMBER 主键,用于关联 DMS_BILLS_FAULT_INSTANCE.DEVICE_ID + - `DEVICE_STATUS`:NUMBER(1,0),查询时使用 `= 0`,不是 `= '0'` + - `IS_FLAG`:NUMBER(1,0),查询时使用 `= 0`,不是 `= '0'` + +4. **质检结果映射**:TREATMENT_MEASURE='3'=合格,'1'=不合格 + +5. **日累计产量查询逻辑**: + - 使用窗口函数 `ROW_NUMBER() OVER (PARTITION BY DEVICE_CODE ORDER BY COLLECT_TIME DESC)` 取每台设备当天最新的一条记录 + - 避免重复计算,确保每台设备只取一个值 + - 将所有设备的最新值求和得到日累计产量 + +6. **维修分析**:使用 DMS_BILLS_FAULT_INSTANCE 故障报修表,通过 `DEVICE_ID = BASE_DEVICELEDGER.OBJ_ID` 关联设备表 + +7. **报警信息来源**:使用 RECORD_ALARM_DEVICE 表,字段 `ALARM_INFO` 和 `ALARM_TIME`,并以 `IS_FLAG = 0` 过滤有效记录 + +--- + +## 九、变更记录 + +| 日期 | 版本 | 变更内容 | 作者 | +|------|------|----------|------| +| 2026-01-21 | 1.0 | 初始版本 | YinQ | +| 2026-01-21 | 2.0 | 重构为独立接口模式,一个接口一个实体类 | YinQ | +| 2026-01-21 | 2.1 | 修复产量查询逻辑,使用 PARAM_NAME 替代 PARAM_CODE | YinQ | +| 2026-01-21 | 2.2 | 修复设备表结构:BASE_DEVICELEDGER 字段类型修正,DEVICE_STATUS/IS_FLAG 为 NUMBER 类型 | YinQ | +| 2026-01-21 | 2.3 | 修复报警表来源:使用 RECORD_ALARM_DEVICE 替代 DMS_RECORD_ALARM_INFO | YinQ | + +--- + +# Board5 看板真实数据接口实现方案 + +## 一、接口概述 + +### 1.1 接口列表 + +| 序号 | 接口路径 | 请求方式 | 功能描述 | 实体类 | +|------|----------|----------|----------|--------| +| 1 | `/board5/orderWorkStatistics` | GET | 工单统计(总数、已完成、完成率、停机) | Board5OrderWorkStatisticsVo | +| 2 | `/board5/repairTimeStatistics` | GET | 维修时间统计(平均响应时间、平均维修时间) | Board5RepairTimeStatisticsVo | +| 3 | `/board5/maintStatistics` | GET | 保养执行情况统计 | Board5MaintStatisticsVo | +| 4 | `/board5/inspectStatistics` | GET | 巡检执行情况统计 | Board5InspectStatisticsVo | +| 5 | `/board5/deviceStatusDistribution` | GET | 设备状态分布 | Board5DeviceStatusDistributionVo | +| 6 | `/board5/faultSourceDistribution` | GET | 故障来源分布 | Board5FaultSourceDistributionVo | +| 7 | `/board5/faultTrendList` | GET | 故障数量曲线(近30天) | Board5FaultTrendVo | +| 8 | `/board5/productionTop5` | GET | 产量机台TOP5 | Board5ProductionTopVo | + +### 1.2 前端页面 + +- **页面位置**: `zs_aucma-mes-ui/src/views/board/board5/index.vue` +- **前端API**: `zs_aucma-mes-ui/src/api/board/board5.js` + +--- + +## 二、后端文件清单 + +### 2.1 VO实体类(8个) + +| 序号 | 文件路径 | 说明 | +|------|----------|------| +| 1 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board5OrderWorkStatisticsVo.java` | 工单统计 | +| 2 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board5RepairTimeStatisticsVo.java` | 维修时间统计 | +| 3 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board5MaintStatisticsVo.java` | 保养执行情况 | +| 4 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board5InspectStatisticsVo.java` | 巡检执行情况 | +| 5 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board5DeviceStatusDistributionVo.java` | 设备状态分布 | +| 6 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board5FaultSourceDistributionVo.java` | 故障来源分布 | +| 7 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board5FaultTrendVo.java` | 故障数量曲线 | +| 8 | `aucma-report/src/main/java/com/aucma/report/domain/vo/Board5ProductionTopVo.java` | 产量机台TOP5 | + +### 2.2 后端核心文件(5个) + +| 序号 | 文件类型 | 文件路径 | +|------|----------|----------| +| 1 | Mapper接口 | `aucma-report/src/main/java/com/aucma/report/mapper/Board5Mapper.java` | +| 2 | Mapper XML | `aucma-report/src/main/resources/mapper/report/Board5Mapper.xml` | +| 3 | Service接口 | `aucma-report/src/main/java/com/aucma/report/service/IBoard5Service.java` | +| 4 | Service实现 | `aucma-report/src/main/java/com/aucma/report/service/impl/Board5ServiceImpl.java` | +| 5 | Controller | `aucma-report/src/main/java/com/aucma/report/controller/Board5Controller.java` | + +### 2.3 前端文件 + +| 序号 | 文件类型 | 文件路径 | +|------|----------|----------| +| 1 | API文件 | `zs_aucma-mes-ui/src/api/board/board5.js` | + +--- + +## 三、实体类定义 + +### 3.1 Board5OrderWorkStatisticsVo - 工单统计 + +```java +public class Board5OrderWorkStatisticsVo { + /** 工单总数 */ + private Long totalCount; + + /** 已完成数量 */ + private Long completeCount; + + /** 完成率(百分比数值,不含%) */ + private String completeRate; + + /** 停机工单数量 */ + private Long stopCount; +} +``` + +### 3.2 Board5RepairTimeStatisticsVo - 维修时间统计 + +```java +public class Board5RepairTimeStatisticsVo { + /** 平均响应时间(分钟) */ + private String avgResponseTime; + + /** 平均维修时间(小时) */ + private String avgRepairTime; +} +``` + +### 3.3 Board5MaintStatisticsVo - 保养执行情况 + +```java +public class Board5MaintStatisticsVo { + /** 计划保养数量 */ + private Long planCount; + + /** 已保养数量(MAINT_STATUS=3) */ + private Long completeCount; + + /** 待保养数量(MAINT_STATUS=1) */ + private Long waitingCount; + + /** 待保养比例 */ + private String waitingRate; + + /** 保养中数量(MAINT_STATUS=2) */ + private Long doingCount; + + /** 保养中比例 */ + private String doingRate; + + /** 待验证数量(MAINT_STATUS=4) */ + private Long verifyCount; + + /** 待验证比例 */ + private String verifyRate; + + /** 设备保养完成率 */ + private String completeRate; +} +``` + +### 3.4 Board5InspectStatisticsVo - 巡检执行情况 + +```java +public class Board5InspectStatisticsVo { + /** 应检设备数量 */ + private Long deviceCount; + + /** 设备巡检完成率 */ + private String completeRate; +} +``` + +### 3.5 Board5DeviceStatusDistributionVo - 设备状态分布 + +```java +public class Board5DeviceStatusDistributionVo { + /** 实验设备占比 */ + private Long experimentPercent; + + /** 未检设备占比 */ + private Long uncheckedPercent; + + /** 正常设备占比 */ + private Long normalPercent; + + /** 异常设备占比 */ + private Long abnormalPercent; +} +``` + +### 3.6 Board5FaultSourceDistributionVo - 故障来源分布 + +```java +public class Board5FaultSourceDistributionVo { + /** 维护故障占比(FAULT_SOURCE_TYPE=1) */ + private Long maintainPercent; + + /** 运行故障占比(FAULT_SOURCE_TYPE=2,3) */ + private Long runningPercent; + + /** 自然故障占比(FAULT_SOURCE_TYPE=9) */ + private Long naturalPercent; +} +``` + +### 3.7 Board5FaultTrendVo - 故障数量曲线 + +```java +public class Board5FaultTrendVo { + /** 日期(格式:日,如 01、02...) */ + private String dateValue; + + /** 故障数量 */ + private Long faultCount; +} +``` + +### 3.8 Board5ProductionTopVo - 产量机台TOP5 + +```java +public class Board5ProductionTopVo { + /** 设备名称 */ + private String deviceName; + + /** 百分比(相对于最大产量) */ + private Long percent; + + /** 产量 */ + private Long production; +} +``` + +--- + +## 四、数据源与业务逻辑 + +### 4.1 接口数据源映射表 + +| 接口 | 数据源表 | 业务逻辑 | +|------|----------|----------| +| orderWorkStatistics | BASE_ORDERINFO | 统计工单总数、已完成(EXECUTION_STATUS='COMPLETED')、停机(EXECUTION_STATUS='PAUSED') | +| repairTimeStatistics | DMS_BILLS_FAULT_INSTANCE | 平均响应时间=(REAL_BEGIN_TIME-APPLY_TIME),平均维修时间=(REAL_END_TIME-REAL_BEGIN_TIME) | +| maintStatistics | DMS_PLAN_MAINT | 按MAINT_STATUS分组统计:1=待保养,2=保养中,3=已完成,4=待验证 | +| inspectStatistics | DMS_PLAN_INSPECT, DMS_BILLS_INSPECT_INSTANCE | 应检设备=SUM(DEVICE_AMOUNT),已检=INSPECT_STATUS='2'的数量 | +| deviceStatusDistribution | BASE_DEVICELEDGER | 按DEVICE_STATUS和DEVICE_TYPE分组统计 | +| faultSourceDistribution | DMS_BILLS_FAULT_INSTANCE | 按FAULT_SOURCE_TYPE分组:1=维护故障,2/3=运行故障,9=自然故障 | +| faultTrendList | RECORD_ALARM_DEVICE | 近30天每日告警数量,按ALARM_TIME日期分组 | +| productionTop5 | BASE_DEVICE_PARAM_VAL, BASE_DEVICELEDGER | 各设备当天PARAM_NAME='机台状态-实际产出数量'最新值,取TOP5 | + +### 4.2 关键SQL说明 + +#### 4.2.1 维修时间统计 + +```sql +SELECT ROUND(NVL(AVG((REAL_BEGIN_TIME - APPLY_TIME) * 24 * 60), 0), 2) AS AVG_RESPONSE_TIME, + ROUND(NVL(AVG((REAL_END_TIME - REAL_BEGIN_TIME) * 24), 0), 2) AS AVG_REPAIR_TIME +FROM DMS_BILLS_FAULT_INSTANCE +WHERE IS_FLAG = '1' + AND REAL_BEGIN_TIME IS NOT NULL + AND APPLY_TIME IS NOT NULL +``` + +**业务逻辑说明**: +- 平均响应时间 = (实际开始时间 - 申请时间) × 24 × 60,单位:分钟 +- 平均维修时间 = (实际结束时间 - 实际开始时间) × 24,单位:小时 + +#### 4.2.2 故障数量曲线(使用RECORD_ALARM_DEVICE) + +```sql +SELECT TO_CHAR(ALARM_TIME, 'DD') AS dateValue, + COUNT(*) AS faultCount +FROM RECORD_ALARM_DEVICE +WHERE IS_FLAG = 0 + AND ALARM_TIME >= TRUNC(SYSDATE) - 30 +GROUP BY TO_CHAR(ALARM_TIME, 'DD'), TRUNC(ALARM_TIME) +ORDER BY TRUNC(ALARM_TIME) +``` + +**业务逻辑说明**: +- 数据来源:`RECORD_ALARM_DEVICE` 设备告警记录表 +- 时间范围:近30天 +- 分组方式:按日期分组,返回每日告警数量 + +#### 4.2.3 产量机台TOP5(替代备件消耗费用TOP5) + +```sql +SELECT * FROM ( + SELECT d.DEVICE_NAME AS deviceName, + NVL(TO_NUMBER(p.PARAM_VALUE), 0) AS production, + 0 AS percent + FROM BASE_DEVICELEDGER d + LEFT JOIN ( + SELECT DEVICE_CODE, PARAM_VALUE + FROM ( + SELECT DEVICE_CODE, PARAM_VALUE, + ROW_NUMBER() OVER (PARTITION BY DEVICE_CODE ORDER BY COLLECT_TIME DESC) AS RN + FROM BASE_DEVICE_PARAM_VAL + WHERE PARAM_NAME = '机台状态-实际产出数量' + AND TO_CHAR(COLLECT_TIME, 'YYYY-MM-DD') = TO_CHAR(SYSDATE, 'YYYY-MM-DD') + ) + WHERE RN = 1 + ) p ON d.DEVICE_CODE = p.DEVICE_CODE + WHERE d.IS_FLAG = 0 + AND d.DEVICE_TYPE = '1' + ORDER BY production DESC +) WHERE ROWNUM <= 5 +``` + +**业务逻辑说明**: +- 使用 `PARAM_NAME = '机台状态-实际产出数量'` 获取各设备当天实际产出 +- 取每台设备当天最新的一条记录(使用窗口函数ROW_NUMBER) +- 按产量降序排列,取前5名 +- 百分比在Service层计算:`percent = production / maxProduction * 100` + +#### 4.2.4 故障来源分布 + +```sql +SELECT COUNT(*) AS TOTAL_COUNT, + SUM(CASE WHEN FAULT_SOURCE_TYPE = 1 THEN 1 ELSE 0 END) AS MAINTAIN_COUNT, + SUM(CASE WHEN FAULT_SOURCE_TYPE IN (2, 3) THEN 1 ELSE 0 END) AS RUNNING_COUNT, + SUM(CASE WHEN FAULT_SOURCE_TYPE = 9 THEN 1 ELSE 0 END) AS NATURAL_COUNT +FROM DMS_BILLS_FAULT_INSTANCE +WHERE IS_FLAG = '1' +``` + +**业务逻辑说明**: +- FAULT_SOURCE_TYPE=1(检修)→ 维护故障 +- FAULT_SOURCE_TYPE=2,3(点检/巡检)→ 运行故障 +- FAULT_SOURCE_TYPE=9(其他)→ 自然故障 + +--- + +## 五、前端API + +### 5.1 API文件 + +**文件**: `zs_aucma-mes-ui/src/api/board/board5.js` + +```javascript +import request from '@/utils/request' + +// 获取工单统计(工单总数、已完成、完成率、停机工单) +export function getOrderWorkStatistics() { + return request({ url: '/board5/orderWorkStatistics', method: 'get' }) +} + +// 获取维修时间统计(平均响应时间、平均维修时间) +export function getRepairTimeStatistics() { + return request({ url: '/board5/repairTimeStatistics', method: 'get' }) +} + +// 获取保养执行情况统计 +export function getMaintStatistics() { + return request({ url: '/board5/maintStatistics', method: 'get' }) +} + +// 获取巡检执行情况统计 +export function getInspectStatistics() { + return request({ url: '/board5/inspectStatistics', method: 'get' }) +} + +// 获取设备状态分布 +export function getDeviceStatusDistribution() { + return request({ url: '/board5/deviceStatusDistribution', method: 'get' }) +} + +// 获取故障来源分布 +export function getFaultSourceDistribution() { + return request({ url: '/board5/faultSourceDistribution', method: 'get' }) +} + +// 获取故障数量曲线 +export function getFaultTrendList() { + return request({ url: '/board5/faultTrendList', method: 'get' }) +} + +// 获取产量机台TOP5 +export function getProductionTop5() { + return request({ url: '/board5/productionTop5', method: 'get' }) +} +``` + +--- + +## 六、数据库表结构参考 + +### 6.1 BASE_ORDERINFO(工单表) + +| 字段 | 类型 | 说明 | +|------|------|------| +| OBJ_ID | NUMBER | 主键 | +| EXECUTION_STATUS | VARCHAR2 | 执行状态(PENDING/RUNNING/COMPLETED/PAUSED) | +| IS_FLAG | NUMBER | 是否标识(0=有效) | + +### 6.2 DMS_BILLS_FAULT_INSTANCE(故障报修工单表) + +| 字段 | 类型 | 说明 | +|------|------|------| +| REPAIR_INSTANCE_ID | NUMBER(20) | 主键 | +| APPLY_TIME | DATE | 申请时间 | +| REAL_BEGIN_TIME | DATE | 实际开始时间 | +| REAL_END_TIME | DATE | 实际完成时间 | +| FAULT_SOURCE_TYPE | NUMBER | 报修来源类型(1检修 2点检 3巡检 9其他) | +| IS_FLAG | CHAR(1) | 激活标识(1是 0否) | + +### 6.3 DMS_PLAN_MAINT(保养计划表) + +| 字段 | 类型 | 说明 | +|------|------|------| +| PLAN_MAINT_ID | NUMBER(20) | 主键 | +| MAINT_STATUS | NUMBER | 保养状态(1待保养 2保养中 3已完成 4待验证) | +| IS_FLAG | NUMBER | 是否标识(1是 2否) | + +### 6.4 DMS_PLAN_INSPECT(巡检计划表) + +| 字段 | 类型 | 说明 | +|------|------|------| +| PLAN_INSPECT_ID | NUMBER(20) | 主键 | +| DEVICE_AMOUNT | NUMBER | 设备总数 | +| IS_FLAG | CHAR(1) | 是否标识(1是 0否) | + +### 6.5 RECORD_ALARM_DEVICE(设备告警记录表) + +| 字段 | 类型 | 说明 | +|------|------|------| +| OBJ_ID | NUMBER(38) | 主键 | +| DEVICE_CODE | VARCHAR2(128) | 设备编号 | +| DEVICE_NAME | VARCHAR2(128) | 设备名称 | +| ALARM_INFO | VARCHAR2(255) | 报警信息 | +| ALARM_TIME | DATE | 报警时间 | +| IS_FLAG | NUMBER | 是否标识(0=有效) | + +### 6.6 BASE_DEVICELEDGER(设备台账表) + +| 字段 | 类型 | 说明 | +|------|------|------| +| OBJ_ID | NUMBER | 主键 | +| DEVICE_CODE | VARCHAR2(64) | 设备编号 | +| DEVICE_NAME | VARCHAR2(64) | 设备名称 | +| DEVICE_STATUS | NUMBER(1,0) | 设备状态(0使用 1停用 2报废) | +| DEVICE_TYPE | VARCHAR2(32) | 设备类型(1生产设备 2计量设备) | +| IS_FLAG | NUMBER(1,0) | 是否标识(0有效) | + +### 6.7 BASE_DEVICE_PARAM_VAL(设备工艺参数表) + +| 字段 | 类型 | 说明 | +|------|------|------| +| RECORD_ID | NUMBER | 主键 | +| DEVICE_CODE | VARCHAR2(255) | 设备编号 | +| PARAM_NAME | VARCHAR2(255) | 参数名称(固定值,如"机台状态-实际产出数量") | +| PARAM_VALUE | VARCHAR2(255) | 参数值 | +| COLLECT_TIME | DATE | 采集时间 | + +--- + +## 七、接口返回示例 + +### 7.1 工单统计 + +```json +{ "code": 200, "data": { "totalCount": 100, "completeCount": 85, "completeRate": "85", "stopCount": 5 } } +``` + +### 7.2 维修时间统计 + +```json +{ "code": 200, "data": { "avgResponseTime": "123.45", "avgRepairTime": "0.25" } } +``` + +### 7.3 保养执行情况 + +```json +{ "code": 200, "data": { "planCount": 10, "completeCount": 5, "waitingCount": 2, "waitingRate": "20", "doingCount": 2, "doingRate": "20", "verifyCount": 1, "verifyRate": "10", "completeRate": "50" } } +``` + +### 7.4 故障数量曲线 + +```json +{ "code": 200, "data": [{ "dateValue": "01", "faultCount": 5 }, { "dateValue": "02", "faultCount": 3 }] } +``` + +### 7.5 产量机台TOP5 + +```json +{ "code": 200, "data": [{ "deviceName": "YZM-02", "percent": 100, "production": 27218 }, { "deviceName": "YZM-01", "percent": 80, "production": 21774 }] } +``` + +--- + +## 八、注意事项 + +1. **❗重要:故障数量曲线使用 RECORD_ALARM_DEVICE 表** + - 数据来源:`RECORD_ALARM_DEVICE` 设备告警记录表 + - 筛选条件:`IS_FLAG = 0` 且 `ALARM_TIME >= TRUNC(SYSDATE) - 30` + +2. **❗重要:产量机台TOP5 替代备件消耗费用TOP5** + - 使用 `PARAM_NAME = '机台状态-实际产出数量'` 获取设备产量 + - 取每台设备当天最新值,按产量降序排列 + +3. **保养状态映射**(DMS_PLAN_MAINT.MAINT_STATUS): + - 1 = 待保养 + - 2 = 保养中 + - 3 = 已完成 + - 4 = 待验证 + +4. **故障来源类型映射**(DMS_BILLS_FAULT_INSTANCE.FAULT_SOURCE_TYPE): + - 1 = 检修 → 维护故障 + - 2 = 点检 → 运行故障 + - 3 = 巡检 → 运行故障 + - 9 = 其他 → 自然故障 + +5. **设备表字段类型**(BASE_DEVICELEDGER): + - `DEVICE_STATUS`:NUMBER(1,0),查询时使用 `= 0` + - `IS_FLAG`:NUMBER(1,0),查询时使用 `= 0` + +6. **前端页面字段映射**: + - text1-text4 → orderWorkStatistics(工单总数、已完成、完成率、停机工单) + - text5-text6 → repairTimeStatistics(平均响应时间、平均维修时间) + - text7-text15 → maintStatistics(保养执行情况) + - text16-text17 → inspectStatistics(巡检执行情况) + - value1-value4 → deviceStatusDistribution(设备状态分布) + - value5-value7 → faultSourceDistribution(故障来源分布) + - chart1 → faultTrendList(故障数量曲线) + - chart2 → productionTop5(产量机台TOP5) + +--- + +## 九、变更记录 + +| 日期 | 版本 | 变更内容 | 作者 | +|------|------|----------|------| +| 2026-01-21 | 1.0 | Board5看板接口初始版本 | YinQ | +| 2026-01-21 | 1.1 | 故障数量曲线使用RECORD_ALARM_DEVICE表真实数据 | YinQ | +| 2026-01-21 | 1.2 | 产量机台TOP5替代备件消耗费用TOP5 | YinQ |