Showing
15 changed files
with
1494 additions
and
119 deletions
| @@ -110,4 +110,25 @@ public class CpsProblemController { | @@ -110,4 +110,25 @@ public class CpsProblemController { | ||
| 110 | startTime, endTime, wtly); | 110 | startTime, endTime, wtly); |
| 111 | return new JsonResult<>(true, "成功", detailList); | 111 | return new JsonResult<>(true, "成功", detailList); |
| 112 | } | 112 | } |
| 113 | + | ||
| 114 | + /** | ||
| 115 | + * 根据年份、月份、区域、状态查询问题记录明细 | ||
| 116 | + * <p> | ||
| 117 | + * 所有条件均可为空;月份(1-12)为空时默认当前月,年份为空时默认当前年,按创建时间范围过滤; | ||
| 118 | + * 线体、单位、班次在问题记录属性中无对应字段,不作为查询条件 | ||
| 119 | + * | ||
| 120 | + * @param year 年份,可为空(默认当前年) | ||
| 121 | + * @param month 月份(1-12),可为空(默认当前月) | ||
| 122 | + * @param qy 区域id,可为空 | ||
| 123 | + * @param status 问题处理状态编号(#1#-待处理;#2#-处理中;#3#-已关闭;#4#-已逾期),可为空 | ||
| 124 | + * @return 问题记录明细列表 | ||
| 125 | + */ | ||
| 126 | + @GetMapping("/list/detail/condition") | ||
| 127 | + public JsonResult listDetailByCondition(@RequestParam(required = false) Integer year, | ||
| 128 | + @RequestParam(required = false) Integer month, | ||
| 129 | + @RequestParam(required = false) String qy, | ||
| 130 | + @RequestParam(required = false) String status) { | ||
| 131 | + List<CpsProblemDetailDTO> detailList = cpsProblemService.listDetailByCondition(year, month, qy, status); | ||
| 132 | + return new JsonResult<>(true, "成功", detailList); | ||
| 133 | + } | ||
| 113 | } | 134 | } |
| @@ -79,4 +79,19 @@ public class PjoExecController { | @@ -79,4 +79,19 @@ public class PjoExecController { | ||
| 79 | List<PjoExecDetailDTO> detailList = pjoExecService.listDetailByCondition(startTime, endTime, cj, pjozxr); | 79 | List<PjoExecDetailDTO> detailList = pjoExecService.listDetailByCondition(startTime, endTime, cj, pjozxr); |
| 80 | return new JsonResult<>(true, "成功", detailList); | 80 | return new JsonResult<>(true, "成功", detailList); |
| 81 | } | 81 | } |
| 82 | + | ||
| 83 | + /** | ||
| 84 | + * 查询区域内当前时间所在周(周一至周日)的 PJO 执行记录明细列表 | ||
| 85 | + * <p> | ||
| 86 | + * 以当前时间所在自然周为准,按 PJO 开展日期筛选本周范围内的记录; | ||
| 87 | + * qy 为空时不限定区域。返回含关联实体名称、枚举中文描述及各阶段问题标记的明细 | ||
| 88 | + * | ||
| 89 | + * @param qy 区域id,可为空,为空时不限定区域 | ||
| 90 | + * @return PJO 计划执行记录明细列表 | ||
| 91 | + */ | ||
| 92 | + @GetMapping("/list/detail/currentWeek") | ||
| 93 | + public JsonResult listDetailByAreaCurrentWeek(@RequestParam(required = false) String qy) { | ||
| 94 | + List<PjoExecDetailDTO> detailList = pjoExecService.listDetailByAreaCurrentWeek(qy); | ||
| 95 | + return new JsonResult<>(true, "成功", detailList); | ||
| 96 | + } | ||
| 82 | } | 97 | } |
| 1 | package com.qgutech.qgyun.apaas.sync.cps.controller; | 1 | package com.qgutech.qgyun.apaas.sync.cps.controller; |
| 2 | 2 | ||
| 3 | +import com.qgutech.qgyun.apaas.sync.cps.dto.ProcessConfirmTeamPlanDetailDTO; | ||
| 3 | import com.qgutech.qgyun.apaas.sync.cps.model.ProcessConfirmTeamPlan; | 4 | import com.qgutech.qgyun.apaas.sync.cps.model.ProcessConfirmTeamPlan; |
| 4 | import com.qgutech.qgyun.apaas.sync.cps.service.ProcessConfirmTeamPlanService; | 5 | import com.qgutech.qgyun.apaas.sync.cps.service.ProcessConfirmTeamPlanService; |
| 5 | import com.qgutech.qgyun.framework.common.result.JsonResult; | 6 | import com.qgutech.qgyun.framework.common.result.JsonResult; |
| 6 | import lombok.extern.slf4j.Slf4j; | 7 | import lombok.extern.slf4j.Slf4j; |
| 7 | import org.springframework.web.bind.annotation.GetMapping; | 8 | import org.springframework.web.bind.annotation.GetMapping; |
| 8 | import org.springframework.web.bind.annotation.RequestMapping; | 9 | import org.springframework.web.bind.annotation.RequestMapping; |
| 10 | +import org.springframework.web.bind.annotation.RequestParam; | ||
| 9 | import org.springframework.web.bind.annotation.RestController; | 11 | import org.springframework.web.bind.annotation.RestController; |
| 10 | 12 | ||
| 11 | import javax.annotation.Resource; | 13 | import javax.annotation.Resource; |
| @@ -32,4 +34,18 @@ public class ProcessConfirmTeamPlanController { | @@ -32,4 +34,18 @@ public class ProcessConfirmTeamPlanController { | ||
| 32 | List<ProcessConfirmTeamPlan> processConfirmTeamPlanList = processConfirmTeamPlanService.listAll(); | 34 | List<ProcessConfirmTeamPlan> processConfirmTeamPlanList = processConfirmTeamPlanService.listAll(); |
| 33 | return new JsonResult<>(true, "成功", processConfirmTeamPlanList); | 35 | return new JsonResult<>(true, "成功", processConfirmTeamPlanList); |
| 34 | } | 36 | } |
| 37 | + | ||
| 38 | + /** | ||
| 39 | + * 按区域查询当前时间所在周(周一至周日)的过程确认班组计划明细列表 | ||
| 40 | + * <p> | ||
| 41 | + * 明细中关联计划走访班组、工位的编号与名称 | ||
| 42 | + * | ||
| 43 | + * @param qyxx 区域信息(区域id),可为空,为空时不限定区域 | ||
| 44 | + * @return 当前周过程确认班组计划明细列表 | ||
| 45 | + */ | ||
| 46 | + @GetMapping("/list/currentWeek") | ||
| 47 | + public JsonResult listCurrentWeek(@RequestParam(required = false) String qyxx) { | ||
| 48 | + List<ProcessConfirmTeamPlanDetailDTO> list = processConfirmTeamPlanService.listCurrentWeekByQyxx(qyxx); | ||
| 49 | + return new JsonResult<>(true, "成功", list); | ||
| 50 | + } | ||
| 35 | } | 51 | } |
| 1 | package com.qgutech.qgyun.apaas.sync.cps.controller; | 1 | package com.qgutech.qgyun.apaas.sync.cps.controller; |
| 2 | 2 | ||
| 3 | import com.qgutech.qgyun.apaas.sync.cps.dto.StopRecordDailySummaryDTO; | 3 | import com.qgutech.qgyun.apaas.sync.cps.dto.StopRecordDailySummaryDTO; |
| 4 | -import com.qgutech.qgyun.apaas.sync.cps.dto.StopRecordDetailSummaryDTO; | 4 | +import com.qgutech.qgyun.apaas.sync.cps.dto.StopRecordWorkstationSummaryDTO; |
| 5 | import com.qgutech.qgyun.apaas.sync.cps.model.StopRecord; | 5 | import com.qgutech.qgyun.apaas.sync.cps.model.StopRecord; |
| 6 | import com.qgutech.qgyun.apaas.sync.cps.service.StopRecordService; | 6 | import com.qgutech.qgyun.apaas.sync.cps.service.StopRecordService; |
| 7 | import com.qgutech.qgyun.framework.common.result.JsonResult; | 7 | import com.qgutech.qgyun.framework.common.result.JsonResult; |
| @@ -61,17 +61,17 @@ public class StopRecordController { | @@ -61,17 +61,17 @@ public class StopRecordController { | ||
| 61 | } | 61 | } |
| 62 | 62 | ||
| 63 | /** | 63 | /** |
| 64 | - * 按工位汇总统计停线时长并返回明细 | 64 | + * 按工位汇总统计停线时长 |
| 65 | * <p> | 65 | * <p> |
| 66 | * 根据线体、班次、区域、板块条件筛选停线记录,加上指定日期, | 66 | * 根据线体、班次、区域、板块条件筛选停线记录,加上指定日期, |
| 67 | - * 返回满足条件的所有停线记录列表,并按工位汇总停线时长(降序) | 67 | + * 按工位汇总停线时长(降序),仅返回汇总结果,不含停线记录明细 |
| 68 | * | 68 | * |
| 69 | * @param xtxx 线体信息,可为空 | 69 | * @param xtxx 线体信息,可为空 |
| 70 | * @param bcxx 班次信息,可为空 | 70 | * @param bcxx 班次信息,可为空 |
| 71 | * @param txqyxx 停线区域信息,可为空 | 71 | * @param txqyxx 停线区域信息,可为空 |
| 72 | * @param txbkxx 停线板块信息,可为空 | 72 | * @param txbkxx 停线板块信息,可为空 |
| 73 | * @param date 指定日期(yyyy-MM-dd),可为空,为空时不限定日期 | 73 | * @param date 指定日期(yyyy-MM-dd),可为空,为空时不限定日期 |
| 74 | - * @return 停线记录明细 + 工位汇总结果 | 74 | + * @return 各工位停线时长汇总列表 |
| 75 | */ | 75 | */ |
| 76 | @GetMapping("/summary/workstation") | 76 | @GetMapping("/summary/workstation") |
| 77 | public JsonResult summaryByWorkstation(@RequestParam(required = false) String xtxx, | 77 | public JsonResult summaryByWorkstation(@RequestParam(required = false) String xtxx, |
| @@ -79,7 +79,31 @@ public class StopRecordController { | @@ -79,7 +79,31 @@ public class StopRecordController { | ||
| 79 | @RequestParam(required = false) String txqyxx, | 79 | @RequestParam(required = false) String txqyxx, |
| 80 | @RequestParam(required = false) String txbkxx, | 80 | @RequestParam(required = false) String txbkxx, |
| 81 | @RequestParam(required = false) String date) { | 81 | @RequestParam(required = false) String date) { |
| 82 | - StopRecordDetailSummaryDTO result = stopRecordService.summaryByWorkstation(xtxx, bcxx, txqyxx, txbkxx, date); | 82 | + List<StopRecordWorkstationSummaryDTO> result = stopRecordService.summaryByWorkstation(xtxx, bcxx, txqyxx, txbkxx, date); |
| 83 | + return new JsonResult<>(true, "成功", result); | ||
| 84 | + } | ||
| 85 | + | ||
| 86 | + /** | ||
| 87 | + * 查询停线记录明细列表 | ||
| 88 | + * <p> | ||
| 89 | + * 根据线体、班次、区域、板块、工位条件及指定日期筛选停线记录,返回明细列表 | ||
| 90 | + * | ||
| 91 | + * @param xtxx 线体信息,可为空 | ||
| 92 | + * @param bcxx 班次信息,可为空 | ||
| 93 | + * @param txqyxx 停线区域信息,可为空 | ||
| 94 | + * @param txbkxx 停线板块信息,可为空 | ||
| 95 | + * @param txgwxx 停线工位信息,可为空 | ||
| 96 | + * @param date 指定日期(yyyy-MM-dd),可为空,为空时不限定日期 | ||
| 97 | + * @return 停线记录明细列表 | ||
| 98 | + */ | ||
| 99 | + @GetMapping("/list/detail") | ||
| 100 | + public JsonResult listDetail(@RequestParam(required = false) String xtxx, | ||
| 101 | + @RequestParam(required = false) String bcxx, | ||
| 102 | + @RequestParam(required = false) String txqyxx, | ||
| 103 | + @RequestParam(required = false) String txbkxx, | ||
| 104 | + @RequestParam(required = false) String txgwxx, | ||
| 105 | + @RequestParam(required = false) String date) { | ||
| 106 | + List<StopRecord> result = stopRecordService.listDetail(xtxx, bcxx, txqyxx, txbkxx, txgwxx, date); | ||
| 83 | return new JsonResult<>(true, "成功", result); | 107 | return new JsonResult<>(true, "成功", result); |
| 84 | } | 108 | } |
| 85 | } | 109 | } |
src/main/java/com/qgutech/qgyun/apaas/sync/cps/dto/StopRecordDetailSummaryDTO.java
deleted
100644 → 0
| 1 | -package com.qgutech.qgyun.apaas.sync.cps.dto; | ||
| 2 | - | ||
| 3 | -import com.qgutech.qgyun.apaas.sync.cps.model.StopRecord; | ||
| 4 | -import lombok.Getter; | ||
| 5 | -import lombok.Setter; | ||
| 6 | -import lombok.ToString; | ||
| 7 | - | ||
| 8 | -import java.io.Serializable; | ||
| 9 | -import java.util.ArrayList; | ||
| 10 | -import java.util.List; | ||
| 11 | - | ||
| 12 | -/** | ||
| 13 | - * 停线记录明细 + 工位汇总结果 | ||
| 14 | - * <p> | ||
| 15 | - * 返回满足条件的所有停线记录列表,以及按工位汇总的停线时长(按停线时长降序) | ||
| 16 | - */ | ||
| 17 | -@Getter | ||
| 18 | -@Setter | ||
| 19 | -@ToString | ||
| 20 | -public class StopRecordDetailSummaryDTO implements Serializable { | ||
| 21 | - | ||
| 22 | - private static final long serialVersionUID = 1L; | ||
| 23 | - | ||
| 24 | - /* | ||
| 25 | - * 满足条件的所有停线记录列表 | ||
| 26 | - */ | ||
| 27 | - private List<StopRecord> records = new ArrayList<>(); | ||
| 28 | - | ||
| 29 | - /* | ||
| 30 | - * 各工位停线时长汇总(按停线时长降序) | ||
| 31 | - */ | ||
| 32 | - private List<StopRecordWorkstationSummaryDTO> workstationSummary = new ArrayList<>(); | ||
| 33 | -} |
| @@ -23,6 +23,7 @@ public class CpsProblem extends BaseCorpModel { | @@ -23,6 +23,7 @@ public class CpsProblem extends BaseCorpModel { | ||
| 23 | public static final String WTCLZT = "wtclzt"; | 23 | public static final String WTCLZT = "wtclzt"; |
| 24 | public static final String WTLY = "wtly"; | 24 | public static final String WTLY = "wtly"; |
| 25 | public static final String LYGCQRZX = "lygcqrzx"; | 25 | public static final String LYGCQRZX = "lygcqrzx"; |
| 26 | + public static final String QY = "qy"; | ||
| 26 | 27 | ||
| 27 | /* | 28 | /* |
| 28 | * 问题编号 | 29 | * 问题编号 |
| @@ -22,6 +22,7 @@ public class PjoExec extends BaseCorpModel { | @@ -22,6 +22,7 @@ public class PjoExec extends BaseCorpModel { | ||
| 22 | public static final String CJ = "cj"; | 22 | public static final String CJ = "cj"; |
| 23 | public static final String GWXZ = "gwxz"; | 23 | public static final String GWXZ = "gwxz"; |
| 24 | public static final String ZT = "zt"; | 24 | public static final String ZT = "zt"; |
| 25 | + public static final String QY = "qy"; | ||
| 25 | 26 | ||
| 26 | /* | 27 | /* |
| 27 | * 当日生产班次 | 28 | * 当日生产班次 |
| @@ -24,6 +24,7 @@ public class ProcessConfirmTeamPlan extends BaseCorpModel { | @@ -24,6 +24,7 @@ public class ProcessConfirmTeamPlan extends BaseCorpModel { | ||
| 24 | public static final String BCXX = "bcxx"; | 24 | public static final String BCXX = "bcxx"; |
| 25 | public static final String ZT = "zt"; | 25 | public static final String ZT = "zt"; |
| 26 | public static final String SFFXWT = "sffxwt"; | 26 | public static final String SFFXWT = "sffxwt"; |
| 27 | + public static final String QYXX = "qyxx"; | ||
| 27 | 28 | ||
| 28 | /* | 29 | /* |
| 29 | * 计划日期 | 30 | * 计划日期 |
| @@ -485,6 +485,93 @@ public class CpsProblemService extends BaseServiceImpl<CpsProblem> { | @@ -485,6 +485,93 @@ public class CpsProblemService extends BaseServiceImpl<CpsProblem> { | ||
| 485 | } | 485 | } |
| 486 | 486 | ||
| 487 | /** | 487 | /** |
| 488 | + * 根据年份、月份、区域、状态查询问题记录明细 | ||
| 489 | + * <p> | ||
| 490 | + * 所有条件均可为空;月份为空时默认当前月,年份为空时默认当前年,按创建时间(createdAt)范围过滤; | ||
| 491 | + * 线体、单位、班次在问题记录属性中无对应字段,故不作为查询条件。 | ||
| 492 | + * 结果中包含工作单位、责任单位、室组、区域、班组、问题提出人、问题处理人等关联实体名称 | ||
| 493 | + * | ||
| 494 | + * @param year 年份,可为空(默认当前年) | ||
| 495 | + * @param month 月份(1-12),可为空(默认当前月),按创建时间范围过滤 | ||
| 496 | + * @param qy 区域id,可为空 | ||
| 497 | + * @param status 问题处理状态编号(#1#-待处理;#2#-处理中;#3#-已关闭;#4#-已逾期),可为空;兼容传入 1~4 短形式 | ||
| 498 | + * @return 问题记录明细列表(按创建时间降序) | ||
| 499 | + */ | ||
| 500 | + @Transactional(readOnly = true) | ||
| 501 | + public List<CpsProblemDetailDTO> listDetailByCondition(Integer year, Integer month, String qy, String status) { | ||
| 502 | + // 1. 解析年月为创建时间范围,年份为空默认当前年、月份为空默认当前月 | ||
| 503 | + Date start = DateDealUtils.getMonthStartTime(year, month); | ||
| 504 | + Date end = DateDealUtils.getMonthEndTime(year, month); | ||
| 505 | + Assert.notNull(start, "month is invalid!"); | ||
| 506 | + Assert.notNull(end, "month is invalid!"); | ||
| 507 | + Assert.isTrue(!start.after(end), "month range is invalid!"); | ||
| 508 | + | ||
| 509 | + // 2. 构建查询条件:创建时间范围 + 区域 + 状态(线体、单位、班次无对应字段,不作为条件) | ||
| 510 | + Example example = new Example(CpsProblem.class); | ||
| 511 | + Example.Criteria criteria = CorpExample.criteria(example); | ||
| 512 | + criteria.andBetween(CpsProblem.CREATED_AT, start, end); | ||
| 513 | + if (StringUtils.isNotBlank(qy)) { | ||
| 514 | + criteria.andEqualTo(CpsProblem.QY, qy); | ||
| 515 | + } | ||
| 516 | + if (StringUtils.isNotBlank(status)) { | ||
| 517 | + // 校验状态格式,允许传入 #1# 或 1 两种形式,统一转换为 #1# | ||
| 518 | + WtclztEnum statusEnum = WtclztEnum.fromCode(status); | ||
| 519 | + Assert.notNull(statusEnum, "status format is invalid!"); | ||
| 520 | + criteria.andEqualTo(CpsProblem.WTCLZT, statusEnum.getCode()); | ||
| 521 | + } | ||
| 522 | + | ||
| 523 | + // 3. 查询并组装明细结果 | ||
| 524 | + List<CpsProblem> cpsProblemList = cpsProblemMapper.selectByExample(example); | ||
| 525 | + return buildSortedDetailList(cpsProblemList); | ||
| 526 | + } | ||
| 527 | + | ||
| 528 | + /** | ||
| 529 | + * 收集关联实体ID、批量查询关联实体并组装为问题明细列表(按创建时间降序) | ||
| 530 | + * | ||
| 531 | + * @param cpsProblemList 问题记录列表 | ||
| 532 | + * @return 问题明细列表 | ||
| 533 | + */ | ||
| 534 | + private List<CpsProblemDetailDTO> buildSortedDetailList(List<CpsProblem> cpsProblemList) { | ||
| 535 | + if (CollectionUtils.isEmpty(cpsProblemList)) { | ||
| 536 | + return new ArrayList<>(0); | ||
| 537 | + } | ||
| 538 | + | ||
| 539 | + // 收集所有关联实体ID | ||
| 540 | + Set<String> workshopIds = new HashSet<>(); | ||
| 541 | + Set<String> roomGroupIds = new HashSet<>(); | ||
| 542 | + Set<String> areaIds = new HashSet<>(); | ||
| 543 | + Set<String> teamIds = new HashSet<>(); | ||
| 544 | + Set<String> userIds = new HashSet<>(); | ||
| 545 | + for (CpsProblem item : cpsProblemList) { | ||
| 546 | + if (item.getGzdw() != null) workshopIds.add(item.getGzdw()); | ||
| 547 | + if (item.getWtzrdw() != null) workshopIds.add(item.getWtzrdw()); | ||
| 548 | + if (item.getSz() != null) roomGroupIds.add(item.getSz()); | ||
| 549 | + if (item.getQy() != null) areaIds.add(item.getQy()); | ||
| 550 | + if (item.getBz() != null) teamIds.add(item.getBz()); | ||
| 551 | + if (item.getWttcr() != null) userIds.add(item.getWttcr()); | ||
| 552 | + if (item.getWtclr() != null) userIds.add(item.getWtclr()); | ||
| 553 | + } | ||
| 554 | + | ||
| 555 | + // 批量查询关联实体 | ||
| 556 | + Map<String, Workshop> workshopMap = CollectionUtils.isEmpty(workshopIds) | ||
| 557 | + ? new HashMap<>(0) : workshopService.mapByIds(workshopIds); | ||
| 558 | + Map<String, RoomGroup> roomGroupMap = CollectionUtils.isEmpty(roomGroupIds) | ||
| 559 | + ? new HashMap<>(0) : roomGroupService.mapByIds(roomGroupIds); | ||
| 560 | + Map<String, Area> areaMap = CollectionUtils.isEmpty(areaIds) | ||
| 561 | + ? new HashMap<>(0) : areaService.mapByIds(areaIds); | ||
| 562 | + Map<String, Team> teamMap = CollectionUtils.isEmpty(teamIds) | ||
| 563 | + ? new HashMap<>(0) : teamService.mapByIds(teamIds); | ||
| 564 | + Map<String, UcUser> userMap = CollectionUtils.isEmpty(userIds) | ||
| 565 | + ? new HashMap<>(0) : ucUserService.mapByIds(userIds); | ||
| 566 | + | ||
| 567 | + // 组装明细并按创建时间降序排序 | ||
| 568 | + List<CpsProblemDetailDTO> resultList = buildDetailList(cpsProblemList, workshopMap, roomGroupMap, areaMap, teamMap, userMap); | ||
| 569 | + resultList.sort(Comparator.comparing(CpsProblemDetailDTO::getCreatedAt, | ||
| 570 | + Comparator.nullsLast(Comparator.reverseOrder()))); | ||
| 571 | + return resultList; | ||
| 572 | + } | ||
| 573 | + | ||
| 574 | + /** | ||
| 488 | * 组装 CPS 问题明细 DTO 列表(含枚举名称、关联实体名称) | 575 | * 组装 CPS 问题明细 DTO 列表(含枚举名称、关联实体名称) |
| 489 | */ | 576 | */ |
| 490 | private List<CpsProblemDetailDTO> buildDetailList(List<CpsProblem> cpsProblemList, | 577 | private List<CpsProblemDetailDTO> buildDetailList(List<CpsProblem> cpsProblemList, |
| @@ -321,6 +321,39 @@ public class PjoExecService extends BaseServiceImpl<PjoExec> { | @@ -321,6 +321,39 @@ public class PjoExecService extends BaseServiceImpl<PjoExec> { | ||
| 321 | criteria.andEqualTo(PjoExec.PJOZXR, pjozxr); | 321 | criteria.andEqualTo(PjoExec.PJOZXR, pjozxr); |
| 322 | } | 322 | } |
| 323 | List<PjoExec> execList = pjoExecMapper.selectByExample(example); | 323 | List<PjoExec> execList = pjoExecMapper.selectByExample(example); |
| 324 | + return buildSortedDetailList(execList); | ||
| 325 | + } | ||
| 326 | + | ||
| 327 | + /** | ||
| 328 | + * 查询区域内当前时间所在周(周一至周日)的 PJO 计划执行记录明细列表 | ||
| 329 | + * <p> | ||
| 330 | + * 以当前时间所在自然周为准,PJO 开展日期(qkxdwk)在周一 00:00:00.000 ~ 周日 23:59:59.999 范围内; | ||
| 331 | + * qy 非空时按区域过滤,为空时不限定区域。结果含关联实体名称、枚举中文描述及各阶段问题标记,按 PJO 开展日期降序 | ||
| 332 | + * | ||
| 333 | + * @param qy 区域id,可为空,为空时不限定区域 | ||
| 334 | + * @return PJO 计划执行记录明细列表 | ||
| 335 | + */ | ||
| 336 | + @Transactional(readOnly = true) | ||
| 337 | + public List<PjoExecDetailDTO> listDetailByAreaCurrentWeek(String qy) { | ||
| 338 | + // 1. 当前时间所在周的周一 00:00:00 ~ 周日 23:59:59 | ||
| 339 | + Date start = DateDealUtils.getCurrentWeekMondayStartTime(); | ||
| 340 | + Date end = DateDealUtils.getCurrentWeekSundayEndTime(); | ||
| 341 | + | ||
| 342 | + // 2. 构建查询条件(PJO 开展日期在本周范围内必带,区域非空才追加) | ||
| 343 | + Example example = new Example(PjoExec.class); | ||
| 344 | + Example.Criteria criteria = CorpExample.criteria(example) | ||
| 345 | + .andBetween(PjoExec.QKXDWK, start, end); | ||
| 346 | + if (StringUtils.isNotBlank(qy)) { | ||
| 347 | + criteria.andEqualTo(PjoExec.QY, qy); | ||
| 348 | + } | ||
| 349 | + List<PjoExec> execList = pjoExecMapper.selectByExample(example); | ||
| 350 | + return buildSortedDetailList(execList); | ||
| 351 | + } | ||
| 352 | + | ||
| 353 | + /** | ||
| 354 | + * 收集关联实体ID、批量查询关联实体并组装为 PJO 明细列表(按 PJO 开展日期降序) | ||
| 355 | + */ | ||
| 356 | + private List<PjoExecDetailDTO> buildSortedDetailList(List<PjoExec> execList) { | ||
| 324 | if (CollectionUtils.isEmpty(execList)) { | 357 | if (CollectionUtils.isEmpty(execList)) { |
| 325 | return new ArrayList<>(0); | 358 | return new ArrayList<>(0); |
| 326 | } | 359 | } |
| @@ -4,12 +4,17 @@ import com.qgutech.qgyun.framework.database.mybatis.service.BaseServiceImpl; | @@ -4,12 +4,17 @@ import com.qgutech.qgyun.framework.database.mybatis.service.BaseServiceImpl; | ||
| 4 | import com.qgutech.qgyun.apaas.sync.base.BoErrorCode; | 4 | import com.qgutech.qgyun.apaas.sync.base.BoErrorCode; |
| 5 | import com.qgutech.qgyun.apaas.sync.base.BoException; | 5 | import com.qgutech.qgyun.apaas.sync.base.BoException; |
| 6 | import com.qgutech.qgyun.apaas.sync.cps.enums.GcqrZtEnum; | 6 | import com.qgutech.qgyun.apaas.sync.cps.enums.GcqrZtEnum; |
| 7 | +import com.qgutech.qgyun.apaas.sync.cps.dto.ProcessConfirmTeamPlanDetailDTO; | ||
| 7 | import com.qgutech.qgyun.apaas.sync.cps.mapper.ProcessConfirmTeamPlanMapper; | 8 | import com.qgutech.qgyun.apaas.sync.cps.mapper.ProcessConfirmTeamPlanMapper; |
| 8 | import com.qgutech.qgyun.apaas.sync.cps.model.ProcessConfirmExec; | 9 | import com.qgutech.qgyun.apaas.sync.cps.model.ProcessConfirmExec; |
| 9 | import com.qgutech.qgyun.apaas.sync.cps.model.ProcessConfirmTeamPlan; | 10 | import com.qgutech.qgyun.apaas.sync.cps.model.ProcessConfirmTeamPlan; |
| 11 | +import com.qgutech.qgyun.apaas.sync.cps.model.Team; | ||
| 12 | +import com.qgutech.qgyun.apaas.sync.cps.model.Workstation; | ||
| 13 | +import com.qgutech.qgyun.apaas.sync.utils.DateDealUtils; | ||
| 10 | import lombok.extern.slf4j.Slf4j; | 14 | import lombok.extern.slf4j.Slf4j; |
| 11 | import org.apache.commons.collections4.CollectionUtils; | 15 | import org.apache.commons.collections4.CollectionUtils; |
| 12 | import org.apache.commons.lang3.StringUtils; | 16 | import org.apache.commons.lang3.StringUtils; |
| 17 | +import org.springframework.beans.BeanUtils; | ||
| 13 | import org.springframework.stereotype.Service; | 18 | import org.springframework.stereotype.Service; |
| 14 | import org.springframework.transaction.annotation.Transactional; | 19 | import org.springframework.transaction.annotation.Transactional; |
| 15 | import org.springframework.util.Assert; | 20 | import org.springframework.util.Assert; |
| @@ -33,6 +38,12 @@ public class ProcessConfirmTeamPlanService extends BaseServiceImpl<ProcessConfir | @@ -33,6 +38,12 @@ public class ProcessConfirmTeamPlanService extends BaseServiceImpl<ProcessConfir | ||
| 33 | @Resource | 38 | @Resource |
| 34 | private ProcessConfirmExecService processConfirmExecService; | 39 | private ProcessConfirmExecService processConfirmExecService; |
| 35 | 40 | ||
| 41 | + @Resource | ||
| 42 | + private TeamService teamService; | ||
| 43 | + | ||
| 44 | + @Resource | ||
| 45 | + private WorkstationService workstationService; | ||
| 46 | + | ||
| 36 | @Transactional(readOnly = true) | 47 | @Transactional(readOnly = true) |
| 37 | public ProcessConfirmTeamPlan getById(String id) { | 48 | public ProcessConfirmTeamPlan getById(String id) { |
| 38 | Assert.hasLength(id, "id is empty!"); | 49 | Assert.hasLength(id, "id is empty!"); |
| @@ -102,6 +113,80 @@ public class ProcessConfirmTeamPlanService extends BaseServiceImpl<ProcessConfir | @@ -102,6 +113,80 @@ public class ProcessConfirmTeamPlanService extends BaseServiceImpl<ProcessConfir | ||
| 102 | } | 113 | } |
| 103 | 114 | ||
| 104 | /** | 115 | /** |
| 116 | + * 按区域查询当前时间所在周(周一至周日)的过程确认班组计划记录列表 | ||
| 117 | + * <p> | ||
| 118 | + * 以当前时间所在自然周为准,计划日期(jhrq)在周一 00:00:00.000 ~ 周日 23:59:59.999 范围内; | ||
| 119 | + * 结果关联计划走访班组、工位的编号与名称,并按计划日期升序排列 | ||
| 120 | + * | ||
| 121 | + * @param qyxx 区域信息(区域id),可为空,为空时不限定区域 | ||
| 122 | + * @return 当前周过程确认班组计划明细列表 | ||
| 123 | + */ | ||
| 124 | + @Transactional(readOnly = true) | ||
| 125 | + public List<ProcessConfirmTeamPlanDetailDTO> listCurrentWeekByQyxx(String qyxx) { | ||
| 126 | + // 1. 当前时间所在周的周一 00:00:00.000 ~ 周日 23:59:59.999 | ||
| 127 | + Date start = DateDealUtils.getCurrentWeekMondayStartTime(); | ||
| 128 | + Date end = DateDealUtils.getCurrentWeekSundayEndTime(); | ||
| 129 | + | ||
| 130 | + // 2. 按计划日期范围 + 区域(可选)查询 | ||
| 131 | + Example example = new Example(entityClass); | ||
| 132 | + Example.Criteria criteria = CorpExample.criteria(example); | ||
| 133 | + criteria.andBetween(ProcessConfirmTeamPlan.JHRQ, start, end); | ||
| 134 | + if (StringUtils.isNotBlank(qyxx)) { | ||
| 135 | + criteria.andEqualTo(ProcessConfirmTeamPlan.QYXX, qyxx); | ||
| 136 | + } | ||
| 137 | + List<ProcessConfirmTeamPlan> list = processConfirmTeamPlanMapper.selectByExample(example); | ||
| 138 | + if (CollectionUtils.isEmpty(list)) { | ||
| 139 | + return new ArrayList<>(0); | ||
| 140 | + } | ||
| 141 | + | ||
| 142 | + // 3. 批量查询关联班组、工位(避免 N+1 查询) | ||
| 143 | + Set<String> teamIds = list.stream() | ||
| 144 | + .map(ProcessConfirmTeamPlan::getJhzfbz) | ||
| 145 | + .filter(StringUtils::isNotBlank) | ||
| 146 | + .collect(Collectors.toSet()); | ||
| 147 | + Set<String> workstationIds = list.stream() | ||
| 148 | + .map(ProcessConfirmTeamPlan::getJhzfgw) | ||
| 149 | + .filter(StringUtils::isNotBlank) | ||
| 150 | + .collect(Collectors.toSet()); | ||
| 151 | + Map<String, Team> teamMap = CollectionUtils.isEmpty(teamIds) | ||
| 152 | + ? new HashMap<>(0) : teamService.mapByIds(teamIds); | ||
| 153 | + Map<String, Workstation> workstationMap = CollectionUtils.isEmpty(workstationIds) | ||
| 154 | + ? new HashMap<>(0) : workstationService.mapByIds(workstationIds); | ||
| 155 | + | ||
| 156 | + // 4. 组装明细并按计划日期升序排列 | ||
| 157 | + List<ProcessConfirmTeamPlanDetailDTO> resultList = list.stream() | ||
| 158 | + .map(item -> { | ||
| 159 | + ProcessConfirmTeamPlanDetailDTO dto = new ProcessConfirmTeamPlanDetailDTO(); | ||
| 160 | + BeanUtils.copyProperties(item, dto); | ||
| 161 | + | ||
| 162 | + // 计划走访班组编号、名称 | ||
| 163 | + if (StringUtils.isNotBlank(item.getJhzfbz())) { | ||
| 164 | + Team team = teamMap.get(item.getJhzfbz()); | ||
| 165 | + if (team != null) { | ||
| 166 | + dto.setJhzfbzName(team.getBzmc()); | ||
| 167 | + dto.setJhzfbzCode(team.getBzbh()); | ||
| 168 | + } | ||
| 169 | + } | ||
| 170 | + | ||
| 171 | + // 计划走访工位编号、名称 | ||
| 172 | + if (StringUtils.isNotBlank(item.getJhzfgw())) { | ||
| 173 | + Workstation workstation = workstationMap.get(item.getJhzfgw()); | ||
| 174 | + if (workstation != null) { | ||
| 175 | + dto.setJhzfgwName(workstation.getGwmc()); | ||
| 176 | + dto.setJhzfgwCode(workstation.getGwbh()); | ||
| 177 | + } | ||
| 178 | + } | ||
| 179 | + | ||
| 180 | + return dto; | ||
| 181 | + }) | ||
| 182 | + .collect(Collectors.toList()); | ||
| 183 | + | ||
| 184 | + resultList.sort(Comparator.comparing(ProcessConfirmTeamPlanDetailDTO::getJhrq, | ||
| 185 | + Comparator.nullsLast(Comparator.naturalOrder()))); | ||
| 186 | + return resultList; | ||
| 187 | + } | ||
| 188 | + | ||
| 189 | + /** | ||
| 105 | * 批量更新过程确认班组计划记录 | 190 | * 批量更新过程确认班组计划记录 |
| 106 | * | 191 | * |
| 107 | * @param list 待更新的记录列表 | 192 | * @param list 待更新的记录列表 |
| @@ -4,7 +4,6 @@ import com.qgutech.qgyun.framework.database.mybatis.service.BaseServiceImpl; | @@ -4,7 +4,6 @@ import com.qgutech.qgyun.framework.database.mybatis.service.BaseServiceImpl; | ||
| 4 | import com.qgutech.qgyun.apaas.sync.base.BoErrorCode; | 4 | import com.qgutech.qgyun.apaas.sync.base.BoErrorCode; |
| 5 | import com.qgutech.qgyun.apaas.sync.base.BoException; | 5 | import com.qgutech.qgyun.apaas.sync.base.BoException; |
| 6 | import com.qgutech.qgyun.apaas.sync.cps.dto.StopRecordDailySummaryDTO; | 6 | import com.qgutech.qgyun.apaas.sync.cps.dto.StopRecordDailySummaryDTO; |
| 7 | -import com.qgutech.qgyun.apaas.sync.cps.dto.StopRecordDetailSummaryDTO; | ||
| 8 | import com.qgutech.qgyun.apaas.sync.cps.dto.StopRecordWorkstationSummaryDTO; | 7 | import com.qgutech.qgyun.apaas.sync.cps.dto.StopRecordWorkstationSummaryDTO; |
| 9 | import com.qgutech.qgyun.apaas.sync.cps.mapper.StopRecordMapper; | 8 | import com.qgutech.qgyun.apaas.sync.cps.mapper.StopRecordMapper; |
| 10 | import com.qgutech.qgyun.apaas.sync.cps.model.StopRecord; | 9 | import com.qgutech.qgyun.apaas.sync.cps.model.StopRecord; |
| @@ -86,13 +85,14 @@ public class StopRecordService extends BaseServiceImpl<StopRecord> { | @@ -86,13 +85,14 @@ public class StopRecordService extends BaseServiceImpl<StopRecord> { | ||
| 86 | * @param bcxx 班次信息,可为空 | 85 | * @param bcxx 班次信息,可为空 |
| 87 | * @param txqyxx 停线区域信息,可为空 | 86 | * @param txqyxx 停线区域信息,可为空 |
| 88 | * @param txbkxx 停线板块信息,可为空 | 87 | * @param txbkxx 停线板块信息,可为空 |
| 88 | + * @param txgwxx 停线工位信息,可为空 | ||
| 89 | * @param start 停线开始时间范围-开始 | 89 | * @param start 停线开始时间范围-开始 |
| 90 | * @param end 停线开始时间范围-结束 | 90 | * @param end 停线开始时间范围-结束 |
| 91 | * @return 停线记录列表 | 91 | * @return 停线记录列表 |
| 92 | */ | 92 | */ |
| 93 | @Transactional(readOnly = true) | 93 | @Transactional(readOnly = true) |
| 94 | public List<StopRecord> listByCondition(String xtxx, String bcxx, String txqyxx, String txbkxx, | 94 | public List<StopRecord> listByCondition(String xtxx, String bcxx, String txqyxx, String txbkxx, |
| 95 | - Date start, Date end) { | 95 | + String txgwxx, Date start, Date end) { |
| 96 | Example example = new Example(entityClass); | 96 | Example example = new Example(entityClass); |
| 97 | Example.Criteria criteria = CorpExample.criteria(example); | 97 | Example.Criteria criteria = CorpExample.criteria(example); |
| 98 | if (StringUtils.isNotBlank(xtxx)) { | 98 | if (StringUtils.isNotBlank(xtxx)) { |
| @@ -107,6 +107,9 @@ public class StopRecordService extends BaseServiceImpl<StopRecord> { | @@ -107,6 +107,9 @@ public class StopRecordService extends BaseServiceImpl<StopRecord> { | ||
| 107 | if (StringUtils.isNotBlank(txbkxx)) { | 107 | if (StringUtils.isNotBlank(txbkxx)) { |
| 108 | criteria.andEqualTo(StopRecord.TXBKXX, txbkxx); | 108 | criteria.andEqualTo(StopRecord.TXBKXX, txbkxx); |
| 109 | } | 109 | } |
| 110 | + if (StringUtils.isNotBlank(txgwxx)) { | ||
| 111 | + criteria.andEqualTo(StopRecord.TXGWXX, txgwxx); | ||
| 112 | + } | ||
| 110 | if (start != null && end != null) { | 113 | if (start != null && end != null) { |
| 111 | criteria.andBetween(StopRecord.START_TIME, start, end); | 114 | criteria.andBetween(StopRecord.START_TIME, start, end); |
| 112 | } | 115 | } |
| @@ -118,6 +121,37 @@ public class StopRecordService extends BaseServiceImpl<StopRecord> { | @@ -118,6 +121,37 @@ public class StopRecordService extends BaseServiceImpl<StopRecord> { | ||
| 118 | } | 121 | } |
| 119 | 122 | ||
| 120 | /** | 123 | /** |
| 124 | + * 将指定日期(yyyy-MM-dd)解析为当天的起止时间范围 | ||
| 125 | + * | ||
| 126 | + * @param date 指定日期,可为空 | ||
| 127 | + * @return 长度为 2 的数组 [start, end],date 为空时返回 [null, null] | ||
| 128 | + */ | ||
| 129 | + private Date[] parseDateRange(String date) { | ||
| 130 | + if (StringUtils.isBlank(date)) { | ||
| 131 | + return new Date[]{null, null}; | ||
| 132 | + } | ||
| 133 | + try { | ||
| 134 | + SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); | ||
| 135 | + Calendar cal = Calendar.getInstance(); | ||
| 136 | + cal.setTime(sdf.parse(date)); | ||
| 137 | + cal.set(Calendar.HOUR_OF_DAY, 0); | ||
| 138 | + cal.set(Calendar.MINUTE, 0); | ||
| 139 | + cal.set(Calendar.SECOND, 0); | ||
| 140 | + cal.set(Calendar.MILLISECOND, 0); | ||
| 141 | + Date start = cal.getTime(); | ||
| 142 | + | ||
| 143 | + cal.set(Calendar.HOUR_OF_DAY, 23); | ||
| 144 | + cal.set(Calendar.MINUTE, 59); | ||
| 145 | + cal.set(Calendar.SECOND, 59); | ||
| 146 | + cal.set(Calendar.MILLISECOND, 999); | ||
| 147 | + Date end = cal.getTime(); | ||
| 148 | + return new Date[]{start, end}; | ||
| 149 | + } catch (Exception e) { | ||
| 150 | + throw new BoException(BoErrorCode.PARAM_ERROR, "日期格式错误,应为 yyyy-MM-dd"); | ||
| 151 | + } | ||
| 152 | + } | ||
| 153 | + | ||
| 154 | + /** | ||
| 121 | * 按天汇总统计停线时长 | 155 | * 按天汇总统计停线时长 |
| 122 | * <p> | 156 | * <p> |
| 123 | * 根据线体、班次、区域、板块条件筛选停线记录,按天分组汇总停线时长 | 157 | * 根据线体、班次、区域、板块条件筛选停线记录,按天分组汇总停线时长 |
| @@ -156,7 +190,7 @@ public class StopRecordService extends BaseServiceImpl<StopRecord> { | @@ -156,7 +190,7 @@ public class StopRecordService extends BaseServiceImpl<StopRecord> { | ||
| 156 | Date end = cal.getTime(); | 190 | Date end = cal.getTime(); |
| 157 | 191 | ||
| 158 | // 查询该月份内满足条件的停线记录 | 192 | // 查询该月份内满足条件的停线记录 |
| 159 | - List<StopRecord> list = listByCondition(xtxx, bcxx, txqyxx, txbkxx, start, end); | 193 | + List<StopRecord> list = listByCondition(xtxx, bcxx, txqyxx, txbkxx, null, start, end); |
| 160 | if (CollectionUtils.isEmpty(list)) { | 194 | if (CollectionUtils.isEmpty(list)) { |
| 161 | return new ArrayList<>(0); | 195 | return new ArrayList<>(0); |
| 162 | } | 196 | } |
| @@ -190,58 +224,53 @@ public class StopRecordService extends BaseServiceImpl<StopRecord> { | @@ -190,58 +224,53 @@ public class StopRecordService extends BaseServiceImpl<StopRecord> { | ||
| 190 | } | 224 | } |
| 191 | 225 | ||
| 192 | /** | 226 | /** |
| 193 | - * 按工位汇总统计停线时长并返回明细 | 227 | + * 按工位汇总统计停线时长 |
| 194 | * <p> | 228 | * <p> |
| 195 | * 根据线体、班次、区域、板块条件筛选停线记录,加上指定日期, | 229 | * 根据线体、班次、区域、板块条件筛选停线记录,加上指定日期, |
| 196 | - * 返回满足条件的所有停线记录列表,并按工位汇总停线时长(按停线时长降序排列) | 230 | + * 按工位汇总停线时长(按停线时长降序排列),仅返回汇总结果,不含明细 |
| 197 | * | 231 | * |
| 198 | * @param xtxx 线体信息,可为空 | 232 | * @param xtxx 线体信息,可为空 |
| 199 | * @param bcxx 班次信息,可为空 | 233 | * @param bcxx 班次信息,可为空 |
| 200 | * @param txqyxx 停线区域信息,可为空 | 234 | * @param txqyxx 停线区域信息,可为空 |
| 201 | * @param txbkxx 停线板块信息,可为空 | 235 | * @param txbkxx 停线板块信息,可为空 |
| 202 | * @param date 指定日期(yyyy-MM-dd),可为空,为空时不限定日期 | 236 | * @param date 指定日期(yyyy-MM-dd),可为空,为空时不限定日期 |
| 203 | - * @return 停线记录明细 + 工位汇总结果 | 237 | + * @return 各工位停线时长汇总列表 |
| 204 | */ | 238 | */ |
| 205 | @Transactional(readOnly = true) | 239 | @Transactional(readOnly = true) |
| 206 | - public StopRecordDetailSummaryDTO summaryByWorkstation(String xtxx, String bcxx, String txqyxx, | ||
| 207 | - String txbkxx, String date) { | ||
| 208 | - StopRecordDetailSummaryDTO result = new StopRecordDetailSummaryDTO(); | ||
| 209 | - | 240 | + public List<StopRecordWorkstationSummaryDTO> summaryByWorkstation(String xtxx, String bcxx, String txqyxx, |
| 241 | + String txbkxx, String date) { | ||
| 210 | // 解析指定日期为当天时间范围 | 242 | // 解析指定日期为当天时间范围 |
| 211 | - Date start = null; | ||
| 212 | - Date end = null; | ||
| 213 | - if (StringUtils.isNotBlank(date)) { | ||
| 214 | - try { | ||
| 215 | - SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); | ||
| 216 | - Calendar cal = Calendar.getInstance(); | ||
| 217 | - cal.setTime(sdf.parse(date)); | ||
| 218 | - cal.set(Calendar.HOUR_OF_DAY, 0); | ||
| 219 | - cal.set(Calendar.MINUTE, 0); | ||
| 220 | - cal.set(Calendar.SECOND, 0); | ||
| 221 | - cal.set(Calendar.MILLISECOND, 0); | ||
| 222 | - start = cal.getTime(); | ||
| 223 | - | ||
| 224 | - cal.set(Calendar.HOUR_OF_DAY, 23); | ||
| 225 | - cal.set(Calendar.MINUTE, 59); | ||
| 226 | - cal.set(Calendar.SECOND, 59); | ||
| 227 | - cal.set(Calendar.MILLISECOND, 999); | ||
| 228 | - end = cal.getTime(); | ||
| 229 | - } catch (Exception e) { | ||
| 230 | - throw new BoException(BoErrorCode.PARAM_ERROR, "日期格式错误,应为 yyyy-MM-dd"); | ||
| 231 | - } | ||
| 232 | - } | 243 | + Date[] range = parseDateRange(date); |
| 233 | 244 | ||
| 234 | // 查询满足条件的停线记录 | 245 | // 查询满足条件的停线记录 |
| 235 | - List<StopRecord> list = listByCondition(xtxx, bcxx, txqyxx, txbkxx, start, end); | 246 | + List<StopRecord> list = listByCondition(xtxx, bcxx, txqyxx, txbkxx, null, range[0], range[1]); |
| 236 | if (CollectionUtils.isEmpty(list)) { | 247 | if (CollectionUtils.isEmpty(list)) { |
| 237 | - return result; | 248 | + return new ArrayList<>(0); |
| 238 | } | 249 | } |
| 239 | 250 | ||
| 240 | - // 满足条件的所有停线记录列表 | ||
| 241 | - result.setRecords(list); | ||
| 242 | // 各工位停线时长汇总(降序) | 251 | // 各工位停线时长汇总(降序) |
| 243 | - result.setWorkstationSummary(buildWorkstationSummary(list)); | ||
| 244 | - return result; | 252 | + return buildWorkstationSummary(list); |
| 253 | + } | ||
| 254 | + | ||
| 255 | + /** | ||
| 256 | + * 根据条件查询停线记录明细列表 | ||
| 257 | + * <p> | ||
| 258 | + * 根据线体、班次、区域、板块、工位条件及指定日期筛选停线记录,返回明细列表 | ||
| 259 | + * | ||
| 260 | + * @param xtxx 线体信息,可为空 | ||
| 261 | + * @param bcxx 班次信息,可为空 | ||
| 262 | + * @param txqyxx 停线区域信息,可为空 | ||
| 263 | + * @param txbkxx 停线板块信息,可为空 | ||
| 264 | + * @param txgwxx 停线工位信息,可为空 | ||
| 265 | + * @param date 指定日期(yyyy-MM-dd),可为空,为空时不限定日期 | ||
| 266 | + * @return 停线记录明细列表 | ||
| 267 | + */ | ||
| 268 | + @Transactional(readOnly = true) | ||
| 269 | + public List<StopRecord> listDetail(String xtxx, String bcxx, String txqyxx, String txbkxx, | ||
| 270 | + String txgwxx, String date) { | ||
| 271 | + // 解析指定日期为当天时间范围 | ||
| 272 | + Date[] range = parseDateRange(date); | ||
| 273 | + return listByCondition(xtxx, bcxx, txqyxx, txbkxx, txgwxx, range[0], range[1]); | ||
| 245 | } | 274 | } |
| 246 | 275 | ||
| 247 | /** | 276 | /** |
| @@ -244,4 +244,87 @@ public class DateDealUtils { | @@ -244,4 +244,87 @@ public class DateDealUtils { | ||
| 244 | } | 244 | } |
| 245 | return parseEndTime(dateStr); | 245 | return parseEndTime(dateStr); |
| 246 | } | 246 | } |
| 247 | + | ||
| 248 | + /** | ||
| 249 | + * 根据年份、月份定位 Calendar;year 为空默认当前年,month(1-12)为空默认当前月 | ||
| 250 | + */ | ||
| 251 | + private static Calendar resolveYearMonth(Integer year, Integer month) { | ||
| 252 | + if (month != null && (month < 1 || month > 12)) { | ||
| 253 | + throw new BoException(BoErrorCode.PARAM_ERROR, "月份必须在 1-12 之间"); | ||
| 254 | + } | ||
| 255 | + Calendar cal = Calendar.getInstance(); | ||
| 256 | + if (year != null) { | ||
| 257 | + cal.set(Calendar.YEAR, year); | ||
| 258 | + } | ||
| 259 | + if (month != null) { | ||
| 260 | + cal.set(Calendar.MONTH, month - 1); | ||
| 261 | + } | ||
| 262 | + return cal; | ||
| 263 | + } | ||
| 264 | + | ||
| 265 | + /** | ||
| 266 | + * 获取指定年月的开始时间(当月 1 号 00:00:00.000);year 为空默认当前年,month(1-12)为空默认当前月 | ||
| 267 | + */ | ||
| 268 | + public static Date getMonthStartTime(Integer year, Integer month) { | ||
| 269 | + Calendar cal = resolveYearMonth(year, month); | ||
| 270 | + cal.set(Calendar.DAY_OF_MONTH, 1); | ||
| 271 | + cal.set(Calendar.HOUR_OF_DAY, 0); | ||
| 272 | + cal.set(Calendar.MINUTE, 0); | ||
| 273 | + cal.set(Calendar.SECOND, 0); | ||
| 274 | + cal.set(Calendar.MILLISECOND, 0); | ||
| 275 | + return cal.getTime(); | ||
| 276 | + } | ||
| 277 | + | ||
| 278 | + /** | ||
| 279 | + * 获取指定年月的结束时间(当月最后一天 23:59:59.999);year 为空默认当前年,month(1-12)为空默认当前月 | ||
| 280 | + */ | ||
| 281 | + public static Date getMonthEndTime(Integer year, Integer month) { | ||
| 282 | + Calendar cal = resolveYearMonth(year, month); | ||
| 283 | + cal.set(Calendar.DAY_OF_MONTH, cal.getActualMaximum(Calendar.DAY_OF_MONTH)); | ||
| 284 | + cal.set(Calendar.HOUR_OF_DAY, 23); | ||
| 285 | + cal.set(Calendar.MINUTE, 59); | ||
| 286 | + cal.set(Calendar.SECOND, 59); | ||
| 287 | + cal.set(Calendar.MILLISECOND, 999); | ||
| 288 | + return cal.getTime(); | ||
| 289 | + } | ||
| 290 | + | ||
| 291 | + /** | ||
| 292 | + * 计算指定 Calendar 所处日期距离本周周一的天数(以周一为一周起始) | ||
| 293 | + * <p> | ||
| 294 | + * Calendar 中 SUNDAY=1、MONDAY=2 ... SATURDAY=7,周日需向前推 6 天 | ||
| 295 | + */ | ||
| 296 | + private static int diffToMonday(Calendar cal) { | ||
| 297 | + int dayOfWeek = cal.get(Calendar.DAY_OF_WEEK); | ||
| 298 | + return (dayOfWeek == Calendar.SUNDAY) ? 6 : dayOfWeek - Calendar.MONDAY; | ||
| 299 | + } | ||
| 300 | + | ||
| 301 | + /** | ||
| 302 | + * 获取当前时间所在周的周一开始时间(周一 00:00:00.000) | ||
| 303 | + */ | ||
| 304 | + public static Date getCurrentWeekMondayStartTime() { | ||
| 305 | + Calendar cal = Calendar.getInstance(); | ||
| 306 | + cal.set(Calendar.HOUR_OF_DAY, 0); | ||
| 307 | + cal.set(Calendar.MINUTE, 0); | ||
| 308 | + cal.set(Calendar.SECOND, 0); | ||
| 309 | + cal.set(Calendar.MILLISECOND, 0); | ||
| 310 | + cal.add(Calendar.DAY_OF_MONTH, -diffToMonday(cal)); | ||
| 311 | + return cal.getTime(); | ||
| 312 | + } | ||
| 313 | + | ||
| 314 | + /** | ||
| 315 | + * 获取当前时间所在周的周日结束时间(周日 23:59:59.999) | ||
| 316 | + */ | ||
| 317 | + public static Date getCurrentWeekSundayEndTime() { | ||
| 318 | + Calendar cal = Calendar.getInstance(); | ||
| 319 | + cal.set(Calendar.HOUR_OF_DAY, 0); | ||
| 320 | + cal.set(Calendar.MINUTE, 0); | ||
| 321 | + cal.set(Calendar.SECOND, 0); | ||
| 322 | + cal.set(Calendar.MILLISECOND, 0); | ||
| 323 | + cal.add(Calendar.DAY_OF_MONTH, -diffToMonday(cal) + 6); | ||
| 324 | + cal.set(Calendar.HOUR_OF_DAY, 23); | ||
| 325 | + cal.set(Calendar.MINUTE, 59); | ||
| 326 | + cal.set(Calendar.SECOND, 59); | ||
| 327 | + cal.set(Calendar.MILLISECOND, 999); | ||
| 328 | + return cal.getTime(); | ||
| 329 | + } | ||
| 247 | } | 330 | } |
| @@ -17,6 +17,7 @@ | @@ -17,6 +17,7 @@ | ||
| 17 | - [3.3 根据计划解决时间范围、责任单位id、问题处理状态查询问题记录明细](#33-根据计划解决时间范围责任单位id问题处理状态查询问题记录明细) | 17 | - [3.3 根据计划解决时间范围、责任单位id、问题处理状态查询问题记录明细](#33-根据计划解决时间范围责任单位id问题处理状态查询问题记录明细) |
| 18 | - [3.4 根据创建时间范围汇总各问题来源对应的问题数](#34-根据创建时间范围汇总各问题来源对应的问题数) | 18 | - [3.4 根据创建时间范围汇总各问题来源对应的问题数](#34-根据创建时间范围汇总各问题来源对应的问题数) |
| 19 | - [3.5 根据创建时间范围、问题来源查询问题记录明细](#35-根据创建时间范围问题来源查询问题记录明细) | 19 | - [3.5 根据创建时间范围、问题来源查询问题记录明细](#35-根据创建时间范围问题来源查询问题记录明细) |
| 20 | + - [3.6 根据年月、区域、状态查询问题记录明细 🆕新增](#36-根据年月区域状态查询问题记录明细) | ||
| 20 | - [4. 过程确认执行接口](#4-过程确认执行接口) | 21 | - [4. 过程确认执行接口](#4-过程确认执行接口) |
| 21 | - [4.1 获取所有过程确认执行记录列表](#41-获取所有过程确认执行记录列表) | 22 | - [4.1 获取所有过程确认执行记录列表](#41-获取所有过程确认执行记录列表) |
| 22 | - [4.2 根据活动执行日期范围汇总过程确认执行记录统计信息](#42-根据活动执行日期范围汇总过程确认执行记录统计信息) | 23 | - [4.2 根据活动执行日期范围汇总过程确认执行记录统计信息](#42-根据活动执行日期范围汇总过程确认执行记录统计信息) |
| @@ -25,6 +26,7 @@ | @@ -25,6 +26,7 @@ | ||
| 25 | - [5. PJO计划执行接口](#5-pjo计划执行接口) | 26 | - [5. PJO计划执行接口](#5-pjo计划执行接口) |
| 26 | - [5.1 根据PJO开展日期范围汇总PJO计划执行统计信息](#51-根据pjo开展日期范围汇总pjo计划执行统计信息) | 27 | - [5.1 根据PJO开展日期范围汇总PJO计划执行统计信息](#51-根据pjo开展日期范围汇总pjo计划执行统计信息) |
| 27 | - [5.2 根据条件查询人员PJO计划明细列表](#52-根据条件查询人员pjo计划明细列表) | 28 | - [5.2 根据条件查询人员PJO计划明细列表](#52-根据条件查询人员pjo计划明细列表) |
| 29 | + - [5.3 查询区域内当前周PJO执行记录明细列表 🆕新增](#53-查询区域内当前周pjo执行记录明细列表) | ||
| 28 | - [6. 枚举定义接口](#6-枚举定义接口) | 30 | - [6. 枚举定义接口](#6-枚举定义接口) |
| 29 | - [6.1 获取所有枚举定义常量数组信息](#61-获取所有枚举定义常量数组信息) | 31 | - [6.1 获取所有枚举定义常量数组信息](#61-获取所有枚举定义常量数组信息) |
| 30 | - [7. 基础信息接口](#7-基础信息接口) | 32 | - [7. 基础信息接口](#7-基础信息接口) |
| @@ -37,7 +39,10 @@ | @@ -37,7 +39,10 @@ | ||
| 37 | - [8. 停线记录接口](#8-停线记录接口) | 39 | - [8. 停线记录接口](#8-停线记录接口) |
| 38 | - [8.1 获取所有停线记录列表 🆕新增](#81-获取所有停线记录列表) | 40 | - [8.1 获取所有停线记录列表 🆕新增](#81-获取所有停线记录列表) |
| 39 | - [8.2 按月份汇总统计每天的停线时长 🆕新增](#82-按月份汇总统计每天的停线时长) | 41 | - [8.2 按月份汇总统计每天的停线时长 🆕新增](#82-按月份汇总统计每天的停线时长) |
| 40 | - - [8.3 按工位汇总统计停线时长并返回明细 🆕新增](#83-按工位汇总统计停线时长并返回明细) | 42 | + - [8.3 按工位汇总统计停线时长 ✏️更新](#83-按工位汇总统计停线时长) |
| 43 | + - [8.4 查询停线记录明细列表 🆕新增](#84-查询停线记录明细列表) | ||
| 44 | +- [9. 过程确认班组计划接口](#9-过程确认班组计划接口) | ||
| 45 | + - [9.1 按区域查询当前周过程确认班组计划明细列表 🆕新增](#91-按区域查询当前周过程确认班组计划明细列表) | ||
| 41 | 46 | ||
| 42 | --- | 47 | --- |
| 43 | 48 | ||
| @@ -50,10 +55,14 @@ | @@ -50,10 +55,14 @@ | ||
| 50 | | 🆕 | [1.3](#13-根据单位和年份查询ab类改善部门汇总) | `GET /abImprovement/summary/dept` | 新增接口 | 以单位 + 年份为入参,查询该年度时间范围内该单位下的记录,按申请部门分组汇总 AB 类改善,含部门目标值与完成率 | | 55 | | 🆕 | [1.3](#13-根据单位和年份查询ab类改善部门汇总) | `GET /abImprovement/summary/dept` | 新增接口 | 以单位 + 年份为入参,查询该年度时间范围内该单位下的记录,按申请部门分组汇总 AB 类改善,含部门目标值与完成率 | |
| 51 | | ✏️ | [2.2](#22-根据年份和季度查询c类改善发起率汇总) | `GET /cImprovement/summary/quarter` | 接口更新 | 统计维度由「室组」调整为「单位车间」(按季度人员所在单位 shdw 分组),目标值改按单位车间 dwcj 匹配,返回字段以 dwcj/dwcjName/dwcjCode 为主 | | 56 | | ✏️ | [2.2](#22-根据年份和季度查询c类改善发起率汇总) | `GET /cImprovement/summary/quarter` | 接口更新 | 统计维度由「室组」调整为「单位车间」(按季度人员所在单位 shdw 分组),目标值改按单位车间 dwcj 匹配,返回字段以 dwcj/dwcjName/dwcjCode 为主 | |
| 52 | | 🆕 | [2.3](#23-根据年份季度和单位车间查询c类改善发起率汇总) | `GET /cImprovement/summary/workshop` | 新增接口 | 按单位 + 季度查询,统计指定单位车间下各室组的 C 类改善发起率(即原 2.2 的室组维度逻辑,目标值按室组 szxx 匹配) | | 57 | | 🆕 | [2.3](#23-根据年份季度和单位车间查询c类改善发起率汇总) | `GET /cImprovement/summary/workshop` | 新增接口 | 按单位 + 季度查询,统计指定单位车间下各室组的 C 类改善发起率(即原 2.2 的室组维度逻辑,目标值按室组 szxx 匹配) | |
| 58 | +| 🆕 | [3.6](#36-根据年月区域状态查询问题记录明细) | `GET /cpsProblem/list/detail/condition` | 新增接口 | 按年份(为空默认当前年)、月份(1-12,为空默认当前月,按创建时间过滤)、区域 qy、处理状态筛选问题记录明细;线体、单位、班次无对应字段不作为条件 | | ||
| 53 | | 🆕 | [4.4](#44-根据条件查询过程确认执行记录对应的问题记录明细列表) | `GET /processConfirmExec/list/problem` | 新增接口 | 入参同 [4.3](#43-根据条件查询过程确认执行记录明细列表) 但去掉状态 zt,返回这些执行记录来源发现的 CPS 问题记录明细 | | 59 | | 🆕 | [4.4](#44-根据条件查询过程确认执行记录对应的问题记录明细列表) | `GET /processConfirmExec/list/problem` | 新增接口 | 入参同 [4.3](#43-根据条件查询过程确认执行记录明细列表) 但去掉状态 zt,返回这些执行记录来源发现的 CPS 问题记录明细 | |
| 60 | +| 🆕 | [5.3](#53-查询区域内当前周pjo执行记录明细列表) | `GET /pjoExec/list/detail/currentWeek` | 新增接口 | 按区域(qy,可选)查询当前时间所在周(周一~周日)的 PJO 执行记录明细,出参结构同 [5.2](#52-根据条件查询人员pjo计划明细列表) | | ||
| 54 | | 🆕 | [8.1](#81-获取所有停线记录列表) | `GET /stopRecord/list/all` | 新增接口 | 获取当前企业下所有停线记录信息列表 | | 61 | | 🆕 | [8.1](#81-获取所有停线记录列表) | `GET /stopRecord/list/all` | 新增接口 | 获取当前企业下所有停线记录信息列表 | |
| 55 | | 🆕 | [8.2](#82-按月份汇总统计每天的停线时长) | `GET /stopRecord/summary/daily` | 新增接口 | 按线体、班次、区域、板块、年月(1-12)筛选停线记录,按天汇总每天的停线时长,结果按日期升序 | | 62 | | 🆕 | [8.2](#82-按月份汇总统计每天的停线时长) | `GET /stopRecord/summary/daily` | 新增接口 | 按线体、班次、区域、板块、年月(1-12)筛选停线记录,按天汇总每天的停线时长,结果按日期升序 | |
| 56 | -| 🆕 | [8.3](#83-按工位汇总统计停线时长并返回明细) | `GET /stopRecord/summary/workstation` | 新增接口 | 在 8.2 条件基础上加指定日期,返回满足条件的停线记录列表,并按工位汇总停线时长(降序) | | 63 | +| ✏️ | [8.3](#83-按工位汇总统计停线时长) | `GET /stopRecord/summary/workstation` | 接口更新 | 出参精简:不再返回停线记录明细 records,仅返回各工位停线时长汇总(`List<StopRecordWorkstationSummaryDTO>`,降序) | |
| 64 | +| 🆕 | [8.4](#84-查询停线记录明细列表) | `GET /stopRecord/list/detail` | 新增接口 | 拆分自原 8.3:按线体、班次、区域、板块、工位(新增 txgwxx)及指定日期筛选,返回停线记录明细列表 | | ||
| 65 | +| 🆕 | [9.1](#91-按区域查询当前周过程确认班组计划明细列表) | `GET /processConfirmTeamPlan/list/currentWeek` | 新增接口 | 按区域(qyxx,可选)查询当前时间所在周(周一~周日)的过程确认班组计划明细,关联计划走访班组、工位的编号与名称 | | ||
| 57 | 66 | ||
| 58 | > 编号调整说明:因 2.3 新增了「按单位车间查室组」接口,原「2.3 根据年份、季度、室组id查询C类改善记录详情」顺延为 **2.4**(接口路径与内容未变)。 | 67 | > 编号调整说明:因 2.3 新增了「按单位车间查室组」接口,原「2.3 根据年份、季度、室组id查询C类改善记录详情」顺延为 **2.4**(接口路径与内容未变)。 |
| 59 | 68 | ||
| @@ -1190,6 +1199,49 @@ uat3环境: https://uat3.qgutech.com/fkyycustom | @@ -1190,6 +1199,49 @@ uat3环境: https://uat3.qgutech.com/fkyycustom | ||
| 1190 | } | 1199 | } |
| 1191 | ``` | 1200 | ``` |
| 1192 | 1201 | ||
| 1202 | +### 3.6 根据年月、区域、状态查询问题记录明细 🆕新增 | ||
| 1203 | + | ||
| 1204 | +> 🆕 **新增接口**(本次变更):所有条件均可为空,月份(1-12)未传默认当前月、年份未传默认当前年(按创建时间过滤),返回问题记录明细。 | ||
| 1205 | + | ||
| 1206 | +**接口路径:** `GET /cpsProblem/list/detail/condition` | ||
| 1207 | + | ||
| 1208 | +**接口说明:** 按年月、区域、处理状态筛选问题记录明细(含关联实体名称与枚举中文描述),结果按创建时间降序。所有参数均非必填;`year` 为空时默认当前年,`month`(1-12)为空时默认当前月,按创建时间(createdAt)在该年月范围内过滤。**线体、单位、班次在问题记录属性中无对应字段,故不作为查询条件。** | ||
| 1209 | + | ||
| 1210 | +**请求参数:** | ||
| 1211 | + | ||
| 1212 | +| 参数名 | 类型 | 必传 | 说明 | | ||
| 1213 | +|--------|------|------|------| | ||
| 1214 | +| year | Integer | 否 | 年份(如 2026),为空默认当前年 | | ||
| 1215 | +| month | Integer | 否 | 月份(1-12,分别代表 1~12 月),为空默认当前月;按创建时间范围过滤 | | ||
| 1216 | +| qy | String | 否 | 区域id,为空则不限定 | | ||
| 1217 | +| status | String | 否 | 问题处理状态编号(#1#-待处理;#2#-处理中;#3#-已关闭;#4#-已逾期),兼容传入 1~4 短形式,为空则不限定 | | ||
| 1218 | + | ||
| 1219 | +**响应数据:** `List<CpsProblemDetailDTO>` | ||
| 1220 | + | ||
| 1221 | +**响应字段说明:** 同 [3.3 根据计划解决时间范围、责任单位id、问题处理状态查询问题记录明细](#33-根据计划解决时间范围责任单位id问题处理状态查询问题记录明细) | ||
| 1222 | + | ||
| 1223 | +**响应示例:** | ||
| 1224 | + | ||
| 1225 | +```json | ||
| 1226 | +{ | ||
| 1227 | + "success": true, | ||
| 1228 | + "msg": "成功", | ||
| 1229 | + "data": [ | ||
| 1230 | + { | ||
| 1231 | + "id": "p123", | ||
| 1232 | + "createdAt": "2026-10-05 09:00:00", | ||
| 1233 | + "wtbh": "WT202610001", | ||
| 1234 | + "wtms": "装配线设备故障", | ||
| 1235 | + "qy": "area001", | ||
| 1236 | + "qyName": "装配区域", | ||
| 1237 | + "qyCode": "QY001", | ||
| 1238 | + "wtclzt": "#2#", | ||
| 1239 | + "wtclztDesc": "处理中" | ||
| 1240 | + } | ||
| 1241 | + ] | ||
| 1242 | +} | ||
| 1243 | +``` | ||
| 1244 | + | ||
| 1193 | --- | 1245 | --- |
| 1194 | 1246 | ||
| 1195 | ## 4. 过程确认执行接口 | 1247 | ## 4. 过程确认执行接口 |
| @@ -1930,6 +1982,55 @@ uat3环境: https://uat3.qgutech.com/fkyycustom | @@ -1930,6 +1982,55 @@ uat3环境: https://uat3.qgutech.com/fkyycustom | ||
| 1930 | 1982 | ||
| 1931 | --- | 1983 | --- |
| 1932 | 1984 | ||
| 1985 | +### 5.3 查询区域内当前周PJO执行记录明细列表 | ||
| 1986 | + | ||
| 1987 | +> 🆕 **新增接口**(本次变更) | ||
| 1988 | + | ||
| 1989 | +**接口路径:** `GET /pjoExec/list/detail/currentWeek` | ||
| 1990 | + | ||
| 1991 | +**接口说明:** 以当前时间所在自然周为准(周一为一周起始),查询 PJO 开展日期(qkxdwk)落在本周 **周一 00:00:00.000 ~ 周日 23:59:59.999** 范围内的 PJO 执行记录明细,可按区域过滤,并补充关联实体名称/编号、枚举中文描述及各阶段问题标记。区域为空时不限定区域;结果按 PJO 开展日期降序排列。 | ||
| 1992 | + | ||
| 1993 | +**请求参数:** | ||
| 1994 | + | ||
| 1995 | +| 参数名 | 类型 | 必传 | 说明 | | ||
| 1996 | +|--------|------|------|------| | ||
| 1997 | +| qy | String | 否 | 区域id,为空时不限定区域 | | ||
| 1998 | + | ||
| 1999 | +**响应数据:** `List<PjoExecDetailDTO>` | ||
| 2000 | + | ||
| 2001 | +> 响应字段与 [5.2](#52-根据条件查询人员pjo计划明细列表) 完全一致,此处不再重复。 | ||
| 2002 | + | ||
| 2003 | +**响应示例:** | ||
| 2004 | + | ||
| 2005 | +```json | ||
| 2006 | +{ | ||
| 2007 | + "success": true, | ||
| 2008 | + "msg": "成功", | ||
| 2009 | + "data": [ | ||
| 2010 | + { | ||
| 2011 | + "id": "53DfARB8Lllis48Qc5S", | ||
| 2012 | + "qkxdwk": "2026-10-07 08:00:00", | ||
| 2013 | + "pjozxr": "jU1pkX6iMiZjUPP19MP", | ||
| 2014 | + "pjozxrName": "陈工", | ||
| 2015 | + "zt": "#3#", | ||
| 2016 | + "ztDesc": "已执行", | ||
| 2017 | + "problemCount": 0, | ||
| 2018 | + "cjName": "总装车间", | ||
| 2019 | + "cjCode": "104", | ||
| 2020 | + "qy": "fmGDmYdCswHy1AfNO7R", | ||
| 2021 | + "qyName": "底盘分装", | ||
| 2022 | + "qyCode": "51", | ||
| 2023 | + "bzName": "发动机分装班", | ||
| 2024 | + "bzCode": "142", | ||
| 2025 | + "xtName": "B线", | ||
| 2026 | + "xtCode": "B" | ||
| 2027 | + } | ||
| 2028 | + ] | ||
| 2029 | +} | ||
| 2030 | +``` | ||
| 2031 | + | ||
| 2032 | +--- | ||
| 2033 | + | ||
| 1933 | ## 6. 枚举定义接口 | 2034 | ## 6. 枚举定义接口 |
| 1934 | 2035 | ||
| 1935 | ### 6.1 获取所有枚举定义常量数组信息 | 2036 | ### 6.1 获取所有枚举定义常量数组信息 |
| @@ -2393,11 +2494,13 @@ uat3环境: https://uat3.qgutech.com/fkyycustom | @@ -2393,11 +2494,13 @@ uat3环境: https://uat3.qgutech.com/fkyycustom | ||
| 2393 | 2494 | ||
| 2394 | --- | 2495 | --- |
| 2395 | 2496 | ||
| 2396 | -### 8.3 按工位汇总统计停线时长并返回明细 🆕新增 | 2497 | +### 8.3 按工位汇总统计停线时长 ✏️更新 |
| 2498 | + | ||
| 2499 | +> ✏️ **接口更新**(本次变更:出参精简,不再返回停线记录明细 records,仅返回各工位停线时长汇总;明细查询拆分至 [8.4](#84-查询停线记录明细列表)) | ||
| 2397 | 2500 | ||
| 2398 | **接口路径:** `GET /stopRecord/summary/workstation` | 2501 | **接口路径:** `GET /stopRecord/summary/workstation` |
| 2399 | 2502 | ||
| 2400 | -**接口说明:** 在 [8.2](#82-按月份汇总统计每天的停线时长) 相同的线体、班次、区域、板块条件基础上,加上指定日期,返回满足条件的所有停线记录列表,并按工位汇总停线时长(关联停线工位信息补充工位名称与编号),汇总结果按停线时长降序排列。`date` 为空时不限定日期。 | 2503 | +**接口说明:** 在 [8.2](#82-按月份汇总统计每天的停线时长) 相同的线体、班次、区域、板块条件基础上,加上指定日期,按工位汇总停线时长(关联停线工位信息补充工位名称与编号),汇总结果按停线时长降序排列。`date` 为空时不限定日期。**仅返回汇总结果,不含停线记录明细。** |
| 2401 | 2504 | ||
| 2402 | **请求参数:** | 2505 | **请求参数:** |
| 2403 | 2506 | ||
| @@ -2409,56 +2512,158 @@ uat3环境: https://uat3.qgutech.com/fkyycustom | @@ -2409,56 +2512,158 @@ uat3环境: https://uat3.qgutech.com/fkyycustom | ||
| 2409 | | txbkxx | String | 否 | 停线板块信息(板块id),为空则不限定 | | 2512 | | txbkxx | String | 否 | 停线板块信息(板块id),为空则不限定 | |
| 2410 | | date | String | 否 | 指定日期,格式:yyyy-MM-dd,为空时不限定日期 | | 2513 | | date | String | 否 | 指定日期,格式:yyyy-MM-dd,为空时不限定日期 | |
| 2411 | 2514 | ||
| 2412 | -**响应数据:** `StopRecordDetailSummaryDTO` | 2515 | +**响应数据:** `List<StopRecordWorkstationSummaryDTO>` |
| 2413 | 2516 | ||
| 2414 | **响应字段说明:** | 2517 | **响应字段说明:** |
| 2415 | 2518 | ||
| 2416 | | 字段 | 类型 | 说明 | | 2519 | | 字段 | 类型 | 说明 | |
| 2417 | |------|------|------| | 2520 | |------|------|------| |
| 2418 | -| records | Array | 满足条件的所有停线记录列表(结构同 [8.1](#81-获取所有停线记录列表) 的 StopRecord) | | ||
| 2419 | -| workstationSummary | Array | 各工位停线时长汇总(按停线时长降序) | | ||
| 2420 | -| workstationSummary[].txgwxx | String | 工位id | | ||
| 2421 | -| workstationSummary[].gwmc | String | 工位名称(关联停线工位信息) | | ||
| 2422 | -| workstationSummary[].gwbh | String | 工位编号(关联停线工位信息) | | ||
| 2423 | -| workstationSummary[].totalTxsc | Double | 该工位停线时长总计(分钟) | | ||
| 2424 | -| workstationSummary[].totalCount | Integer | 该工位停线记录数 | | 2521 | +| txgwxx | String | 工位id | |
| 2522 | +| gwmc | String | 工位名称(关联停线工位信息) | | ||
| 2523 | +| gwbh | String | 工位编号(关联停线工位信息) | | ||
| 2524 | +| totalTxsc | Double | 该工位停线时长总计(分钟) | | ||
| 2525 | +| totalCount | Integer | 该工位停线记录数 | | ||
| 2425 | 2526 | ||
| 2426 | **响应示例:** | 2527 | **响应示例:** |
| 2427 | 2528 | ||
| 2428 | ```json | 2529 | ```json |
| 2429 | { | 2530 | { |
| 2430 | "success": true, | 2531 | "success": true, |
| 2431 | - "data": { | ||
| 2432 | - "records": [ | ||
| 2433 | - { | ||
| 2434 | - "id": "SR20260901001", | ||
| 2435 | - "xtxx": "XT001", | ||
| 2436 | - "bcxx": "BC001", | ||
| 2437 | - "txqyxx": "QY001", | ||
| 2438 | - "txgwxx": "GW001", | ||
| 2439 | - "startTime": "2026-09-01 08:30:00", | ||
| 2440 | - "endTime": "2026-09-01 10:00:00", | ||
| 2441 | - "txsc": 90.0, | ||
| 2442 | - "txbkxx": "BK001" | ||
| 2443 | - } | ||
| 2444 | - ], | ||
| 2445 | - "workstationSummary": [ | ||
| 2446 | - { | ||
| 2447 | - "txgwxx": "GW001", | ||
| 2448 | - "gwmc": "焊接工位", | ||
| 2449 | - "gwbh": "01", | ||
| 2450 | - "totalTxsc": 90.0, | ||
| 2451 | - "totalCount": 1 | ||
| 2452 | - }, | ||
| 2453 | - { | ||
| 2454 | - "txgwxx": "GW002", | ||
| 2455 | - "gwmc": "装配工位", | ||
| 2456 | - "gwbh": "02", | ||
| 2457 | - "totalTxsc": 30.0, | ||
| 2458 | - "totalCount": 1 | ||
| 2459 | - } | ||
| 2460 | - ] | ||
| 2461 | - }, | 2532 | + "data": [ |
| 2533 | + { | ||
| 2534 | + "txgwxx": "GW001", | ||
| 2535 | + "gwmc": "焊接工位", | ||
| 2536 | + "gwbh": "01", | ||
| 2537 | + "totalTxsc": 90.0, | ||
| 2538 | + "totalCount": 1 | ||
| 2539 | + }, | ||
| 2540 | + { | ||
| 2541 | + "txgwxx": "GW002", | ||
| 2542 | + "gwmc": "装配工位", | ||
| 2543 | + "gwbh": "02", | ||
| 2544 | + "totalTxsc": 30.0, | ||
| 2545 | + "totalCount": 1 | ||
| 2546 | + } | ||
| 2547 | + ], | ||
| 2548 | + "msg": "成功", | ||
| 2549 | + "errCode": null | ||
| 2550 | +} | ||
| 2551 | +``` | ||
| 2552 | + | ||
| 2553 | +--- | ||
| 2554 | + | ||
| 2555 | +### 8.4 查询停线记录明细列表 🆕新增 | ||
| 2556 | + | ||
| 2557 | +> 🆕 **新增接口**(本次变更:停线记录明细从原 8.3 拆分独立,查询条件新增「工位 txgwxx」) | ||
| 2558 | + | ||
| 2559 | +**接口路径:** `GET /stopRecord/list/detail` | ||
| 2560 | + | ||
| 2561 | +**接口说明:** 根据线体、班次、区域、板块、工位条件及指定日期筛选停线记录,返回停线记录明细列表。所有参数均为可选,`date` 为空时不限定日期。 | ||
| 2562 | + | ||
| 2563 | +**请求参数:** | ||
| 2564 | + | ||
| 2565 | +| 参数名 | 类型 | 必传 | 说明 | | ||
| 2566 | +|--------|------|------|------| | ||
| 2567 | +| xtxx | String | 否 | 线体信息(线体id),为空则不限定 | | ||
| 2568 | +| bcxx | String | 否 | 班次信息(班次id),为空则不限定 | | ||
| 2569 | +| txqyxx | String | 否 | 停线区域信息(区域id),为空则不限定 | | ||
| 2570 | +| txbkxx | String | 否 | 停线板块信息(板块id),为空则不限定 | | ||
| 2571 | +| txgwxx | String | 否 | 停线工位信息(工位id),为空则不限定 | | ||
| 2572 | +| date | String | 否 | 指定日期,格式:yyyy-MM-dd,为空时不限定日期 | | ||
| 2573 | + | ||
| 2574 | +**响应数据:** `List<StopRecord>`(结构同 [8.1](#81-获取所有停线记录列表) 的 StopRecord) | ||
| 2575 | + | ||
| 2576 | +**响应示例:** | ||
| 2577 | + | ||
| 2578 | +```json | ||
| 2579 | +{ | ||
| 2580 | + "success": true, | ||
| 2581 | + "data": [ | ||
| 2582 | + { | ||
| 2583 | + "id": "SR20260901001", | ||
| 2584 | + "xtxx": "XT001", | ||
| 2585 | + "bcxx": "BC001", | ||
| 2586 | + "txqyxx": "QY001", | ||
| 2587 | + "txgwxx": "GW001", | ||
| 2588 | + "startTime": "2026-09-01 08:30:00", | ||
| 2589 | + "endTime": "2026-09-01 10:00:00", | ||
| 2590 | + "txsc": 90.0, | ||
| 2591 | + "txbkxx": "BK001" | ||
| 2592 | + } | ||
| 2593 | + ], | ||
| 2594 | + "msg": "成功", | ||
| 2595 | + "errCode": null | ||
| 2596 | +} | ||
| 2597 | +``` | ||
| 2598 | + | ||
| 2599 | +--- | ||
| 2600 | + | ||
| 2601 | +## 9. 过程确认班组计划接口 | ||
| 2602 | + | ||
| 2603 | +### 9.1 按区域查询当前周过程确认班组计划明细列表 🆕新增 | ||
| 2604 | + | ||
| 2605 | +> 🆕 **新增接口**(本次变更):按区域查询当前时间所在周(周一至周日)的过程确认班组计划明细,关联计划走访班组、工位的编号与名称。 | ||
| 2606 | + | ||
| 2607 | +**接口路径:** `GET /processConfirmTeamPlan/list/currentWeek` | ||
| 2608 | + | ||
| 2609 | +**接口说明:** 以当前时间所在自然周为准,查询计划日期(jhrq)在周一 00:00:00 ~ 周日 23:59:59 范围内的过程确认班组计划记录,关联计划走访班组(jhzfbz)、计划走访工位(jhzfgw)的编号与名称,结果按计划日期升序排列。`qyxx` 为空时不限定区域。 | ||
| 2610 | + | ||
| 2611 | +**请求参数:** | ||
| 2612 | + | ||
| 2613 | +| 参数名 | 类型 | 必传 | 说明 | | ||
| 2614 | +|--------|------|------|------| | ||
| 2615 | +| qyxx | String | 否 | 区域信息(区域id),为空则不限定区域 | | ||
| 2616 | + | ||
| 2617 | +**响应数据:** `List<ProcessConfirmTeamPlanDetailDTO>` | ||
| 2618 | + | ||
| 2619 | +**响应字段说明:** | ||
| 2620 | + | ||
| 2621 | +| 字段 | 类型 | 说明 | | ||
| 2622 | +|------|------|------| | ||
| 2623 | +| id | String | 记录ID | | ||
| 2624 | +| createdAt | String | 创建时间(yyyy-MM-dd HH:mm:ss) | | ||
| 2625 | +| jhrq | String | 计划日期(yyyy-MM-dd HH:mm:ss) | | ||
| 2626 | +| zxr | String | 执行人 | | ||
| 2627 | +| dwxx | String | 单位信息 | | ||
| 2628 | +| xtxx | String | 线体信息 | | ||
| 2629 | +| szxx | String | 室组信息 | | ||
| 2630 | +| qyxx | String | 区域信息 | | ||
| 2631 | +| zt | String | 状态(#1#-待确认;#2#-未执行;#3#-已执行;#4#-已逾期) | | ||
| 2632 | +| sffxwt | Boolean | 是否发现问题 | | ||
| 2633 | +| bcxx | String | 班次信息 | | ||
| 2634 | +| jhzfbz | String | 计划走访班组id | | ||
| 2635 | +| jhzfbzName | String | 计划走访班组名称 | | ||
| 2636 | +| jhzfbzCode | String | 计划走访班组编号 | | ||
| 2637 | +| jhzfgw | String | 计划走访工位id | | ||
| 2638 | +| jhzfgwName | String | 计划走访工位名称 | | ||
| 2639 | +| jhzfgwCode | String | 计划走访工位编号 | | ||
| 2640 | + | ||
| 2641 | +**响应示例:** | ||
| 2642 | + | ||
| 2643 | +```json | ||
| 2644 | +{ | ||
| 2645 | + "success": true, | ||
| 2646 | + "data": [ | ||
| 2647 | + { | ||
| 2648 | + "id": "PCTP20261005001", | ||
| 2649 | + "createdAt": "2026-10-05 08:00:00", | ||
| 2650 | + "jhrq": "2026-10-06 00:00:00", | ||
| 2651 | + "zxr": "user001", | ||
| 2652 | + "dwxx": "workshop001", | ||
| 2653 | + "xtxx": "XT001", | ||
| 2654 | + "szxx": "rg001", | ||
| 2655 | + "qyxx": "area001", | ||
| 2656 | + "zt": "#1#", | ||
| 2657 | + "sffxwt": false, | ||
| 2658 | + "bcxx": "BC001", | ||
| 2659 | + "jhzfbz": "team001", | ||
| 2660 | + "jhzfbzName": "装配一班", | ||
| 2661 | + "jhzfbzCode": "BZ001", | ||
| 2662 | + "jhzfgw": "ws001", | ||
| 2663 | + "jhzfgwName": "装配工位", | ||
| 2664 | + "jhzfgwCode": "GW001" | ||
| 2665 | + } | ||
| 2666 | + ], | ||
| 2462 | "msg": "成功", | 2667 | "msg": "成功", |
| 2463 | "errCode": null | 2668 | "errCode": null |
| 2464 | } | 2669 | } |
src/main/resources/doc/IPO看板接口API说明文档.md
0 → 100644
| 1 | +# IPO 看板接口 API 说明文档 | ||
| 2 | + | ||
| 3 | +> 本文档梳理 2026-10-06 之后新建的看板相关接口,涵盖 **板块信息、停线工位、停线记录、过程确认班组计划** 4 个新建控制器下的全部端点。文档格式与《CPS 模块接口 API 说明文档》保持一致。 | ||
| 4 | + | ||
| 5 | +## 目录 | ||
| 6 | + | ||
| 7 | +- [1. 板块信息接口](#1-板块信息接口) | ||
| 8 | + - [1.1 获取所有板块信息列表 🆕新增](#11-获取所有板块信息列表) | ||
| 9 | +- [2. 停线工位接口](#2-停线工位接口) | ||
| 10 | + - [2.1 获取所有停线工位信息列表 🆕新增](#21-获取所有停线工位信息列表) | ||
| 11 | +- [3. 停线记录接口](#3-停线记录接口) | ||
| 12 | + - [3.1 获取所有停线记录列表 🆕新增](#31-获取所有停线记录列表) | ||
| 13 | + - [3.2 按月份汇总统计每天的停线时长 🆕新增](#32-按月份汇总统计每天的停线时长) | ||
| 14 | + - [3.3 按工位汇总统计停线时长 🆕新增](#33-按工位汇总统计停线时长) | ||
| 15 | + - [3.4 查询停线记录明细列表 🆕新增](#34-查询停线记录明细列表) | ||
| 16 | +- [4. 过程确认班组计划接口](#4-过程确认班组计划接口) | ||
| 17 | + - [4.1 获取所有过程确认班组计划列表 🆕新增](#41-获取所有过程确认班组计划列表) | ||
| 18 | + - [4.2 按区域查询当前周过程确认班组计划明细列表 🆕新增](#42-按区域查询当前周过程确认班组计划明细列表) | ||
| 19 | +- [5. PJO计划执行接口](#5-pjo计划执行接口) | ||
| 20 | + - [5.1 查询区域内当前周PJO执行记录明细列表 🆕新增](#51-查询区域内当前周pjo执行记录明细列表) | ||
| 21 | +- [6. CPS问题接口](#6-cps问题接口) | ||
| 22 | + - [6.1 根据年月、区域、状态查询问题记录明细 🆕新增](#61-根据年月区域状态查询问题记录明细) | ||
| 23 | + | ||
| 24 | +--- | ||
| 25 | + | ||
| 26 | +## 变更记录 | ||
| 27 | + | ||
| 28 | +> 标记说明:🆕 **新增接口**(2026-10-06 之后新建的接口) | ||
| 29 | + | ||
| 30 | +| 标记 | 章节 | 接口路径 | 变更类型 | 变更说明 | | ||
| 31 | +|------|------|----------|----------|----------| | ||
| 32 | +| 🆕 | [1.1](#11-获取所有板块信息列表) | `GET /blockInfo/list/all` | 新增接口 | 获取当前企业下所有板块信息列表 | | ||
| 33 | +| 🆕 | [2.1](#21-获取所有停线工位信息列表) | `GET /stopWorkstation/list/all` | 新增接口 | 获取当前企业下所有停线工位信息列表 | | ||
| 34 | +| 🆕 | [3.1](#31-获取所有停线记录列表) | `GET /stopRecord/list/all` | 新增接口 | 获取当前企业下所有停线记录信息列表 | | ||
| 35 | +| 🆕 | [3.2](#32-按月份汇总统计每天的停线时长) | `GET /stopRecord/summary/daily` | 新增接口 | 按线体、班次、区域、板块、年月(1-12)筛选停线记录,按天汇总每天的停线时长,结果按日期升序 | | ||
| 36 | +| 🆕 | [3.3](#33-按工位汇总统计停线时长) | `GET /stopRecord/summary/workstation` | 新增接口 | 按线体、班次、区域、板块及指定日期筛选,按工位汇总停线时长(降序),仅返回汇总不含明细 | | ||
| 37 | +| 🆕 | [3.4](#34-查询停线记录明细列表) | `GET /stopRecord/list/detail` | 新增接口 | 按线体、班次、区域、板块、工位及指定日期筛选,返回停线记录明细列表 | | ||
| 38 | +| 🆕 | [4.1](#41-获取所有过程确认班组计划列表) | `GET /processConfirmTeamPlan/list/all` | 新增接口 | 获取当前企业下所有过程确认班组计划列表 | | ||
| 39 | +| 🆕 | [4.2](#42-按区域查询当前周过程确认班组计划明细列表) | `GET /processConfirmTeamPlan/list/currentWeek` | 新增接口 | 按区域(qyxx,可选)查询当前时间所在周(周一~周日)的过程确认班组计划明细,关联计划走访班组、工位的编号与名称 | | ||
| 40 | +| 🆕 | [5.1](#51-查询区域内当前周pjo执行记录明细列表) | `GET /pjoExec/list/detail/currentWeek` | 新增接口 | 按区域(qy,可选)查询当前时间所在周(周一~周日)的 PJO 执行记录明细,含关联实体名称/编号、枚举中文描述及各阶段问题标记 | | ||
| 41 | +| 🆕 | [6.1](#61-根据年月区域状态查询问题记录明细) | `GET /cpsProblem/list/detail/condition` | 新增接口 | 按年份(默认当前年)、月份(1-12,默认当前月,按创建时间过滤)、区域 qy、处理状态筛选问题记录明细,含关联实体名称与枚举中文描述;线体/单位/班次无对应字段不作条件 | | ||
| 42 | + | ||
| 43 | +--- | ||
| 44 | + | ||
| 45 | +## 通用说明 | ||
| 46 | + | ||
| 47 | +### 环境域名 | ||
| 48 | + | ||
| 49 | +uat3 环境: https://uat3.qgutech.com/fkyycustom | ||
| 50 | + | ||
| 51 | +### 统一响应格式 | ||
| 52 | + | ||
| 53 | +所有接口返回统一的 `JsonResult` 结构(字段顺序以实际序列化为准): | ||
| 54 | + | ||
| 55 | +```json | ||
| 56 | +{ | ||
| 57 | + "success": true, | ||
| 58 | + "data": [], | ||
| 59 | + "msg": "成功", | ||
| 60 | + "errCode": null | ||
| 61 | +} | ||
| 62 | +``` | ||
| 63 | + | ||
| 64 | +| 字段 | 类型 | 说明 | | ||
| 65 | +|------|------|------| | ||
| 66 | +| success | Boolean | 请求是否成功 | | ||
| 67 | +| data | Object/Array | 响应数据体 | | ||
| 68 | +| msg | String | 响应消息 | | ||
| 69 | +| errCode | String | 错误码,成功时为 null | | ||
| 70 | + | ||
| 71 | +### 多企业数据隔离 | ||
| 72 | + | ||
| 73 | +所有实体均继承 `BaseCorpModel`(含 `corpCode`,对应列 `corp_code`),响应中的每条记录都带有 `corpCode`。服务端统一按当前请求上下文的企业编码过滤数据,前端无需传入。 | ||
| 74 | + | ||
| 75 | +--- | ||
| 76 | + | ||
| 77 | +## 1. 板块信息接口 | ||
| 78 | + | ||
| 79 | +### 1.1 获取所有板块信息列表 🆕新增 | ||
| 80 | + | ||
| 81 | +> 🆕 **新增接口**(2026-10-06 之后新建) | ||
| 82 | + | ||
| 83 | +**接口路径:** `GET /blockInfo/list/all` | ||
| 84 | + | ||
| 85 | +**接口说明:** 获取当前企业下所有板块信息列表。 | ||
| 86 | + | ||
| 87 | +**请求参数:** 无 | ||
| 88 | + | ||
| 89 | +**响应数据:** `List<BlockInfo>` | ||
| 90 | + | ||
| 91 | +**响应字段说明:** | ||
| 92 | + | ||
| 93 | +| 字段 | 类型 | 说明 | | ||
| 94 | +|------|------|------| | ||
| 95 | +| id | String | 记录ID | | ||
| 96 | +| corpCode | String | 企业编码 | | ||
| 97 | +| mc | String | 板块名称 | | ||
| 98 | +| bm | String | 板块编码 | | ||
| 99 | +| xh | String | 序号 | | ||
| 100 | +| qtdw | String | 牵头单位 | | ||
| 101 | +| qtdwfzr | String | 牵头单位负责人 | | ||
| 102 | + | ||
| 103 | +**响应示例:** | ||
| 104 | + | ||
| 105 | +```json | ||
| 106 | +{ | ||
| 107 | + "success": true, | ||
| 108 | + "data": [ | ||
| 109 | + { | ||
| 110 | + "id": "BK20260901001", | ||
| 111 | + "corpCode": "hfca", | ||
| 112 | + "mc": "总装板块", | ||
| 113 | + "bm": "BK001", | ||
| 114 | + "xh": "1", | ||
| 115 | + "qtdw": "总装车间", | ||
| 116 | + "qtdwfzr": "张三" | ||
| 117 | + } | ||
| 118 | + ], | ||
| 119 | + "msg": "成功", | ||
| 120 | + "errCode": null | ||
| 121 | +} | ||
| 122 | +``` | ||
| 123 | + | ||
| 124 | +--- | ||
| 125 | + | ||
| 126 | +## 2. 停线工位接口 | ||
| 127 | + | ||
| 128 | +### 2.1 获取所有停线工位信息列表 🆕新增 | ||
| 129 | + | ||
| 130 | +> 🆕 **新增接口**(2026-10-06 之后新建) | ||
| 131 | + | ||
| 132 | +**接口路径:** `GET /stopWorkstation/list/all` | ||
| 133 | + | ||
| 134 | +**接口说明:** 获取当前企业下所有停线工位信息列表。停线工位用于停线时长汇总(见 [3.3](#33-按工位汇总统计停线时长))时补充工位名称与编号。 | ||
| 135 | + | ||
| 136 | +**请求参数:** 无 | ||
| 137 | + | ||
| 138 | +**响应数据:** `List<StopWorkstation>` | ||
| 139 | + | ||
| 140 | +**响应字段说明:** | ||
| 141 | + | ||
| 142 | +| 字段 | 类型 | 说明 | | ||
| 143 | +|------|------|------| | ||
| 144 | +| id | String | 记录ID | | ||
| 145 | +| corpCode | String | 企业编码 | | ||
| 146 | +| xtxx | String | 线体信息(线体id) | | ||
| 147 | +| qyxx | String | 区域信息(区域id) | | ||
| 148 | +| bzxx | String | 班组信息(班组id) | | ||
| 149 | +| gwmc | String | 工位名称 | | ||
| 150 | +| gwbh | String | 工位编号 | | ||
| 151 | +| gwxz | String | 工位性质 | | ||
| 152 | + | ||
| 153 | +**响应示例:** | ||
| 154 | + | ||
| 155 | +```json | ||
| 156 | +{ | ||
| 157 | + "success": true, | ||
| 158 | + "data": [ | ||
| 159 | + { | ||
| 160 | + "id": "GW20260901001", | ||
| 161 | + "corpCode": "hfca", | ||
| 162 | + "xtxx": "XT001", | ||
| 163 | + "qyxx": "QY001", | ||
| 164 | + "bzxx": "BZ001", | ||
| 165 | + "gwmc": "焊接工位", | ||
| 166 | + "gwbh": "01", | ||
| 167 | + "gwxz": "A类" | ||
| 168 | + } | ||
| 169 | + ], | ||
| 170 | + "msg": "成功", | ||
| 171 | + "errCode": null | ||
| 172 | +} | ||
| 173 | +``` | ||
| 174 | + | ||
| 175 | +--- | ||
| 176 | + | ||
| 177 | +## 3. 停线记录接口 | ||
| 178 | + | ||
| 179 | +### 3.1 获取所有停线记录列表 🆕新增 | ||
| 180 | + | ||
| 181 | +> 🆕 **新增接口**(2026-10-06 之后新建) | ||
| 182 | + | ||
| 183 | +**接口路径:** `GET /stopRecord/list/all` | ||
| 184 | + | ||
| 185 | +**接口说明:** 获取当前企业下所有停线记录信息列表。 | ||
| 186 | + | ||
| 187 | +**请求参数:** 无 | ||
| 188 | + | ||
| 189 | +**响应数据:** `List<StopRecord>` | ||
| 190 | + | ||
| 191 | +**响应字段说明:** | ||
| 192 | + | ||
| 193 | +| 字段 | 类型 | 说明 | | ||
| 194 | +|------|------|------| | ||
| 195 | +| id | String | 记录ID | | ||
| 196 | +| corpCode | String | 企业编码 | | ||
| 197 | +| createdAt | String | 创建时间(yyyy-MM-dd HH:mm:ss) | | ||
| 198 | +| cyxx | String | 成员信息 | | ||
| 199 | +| xtxx | String | 线体信息 | | ||
| 200 | +| bcxx | String | 班次信息 | | ||
| 201 | +| txqyxx | String | 停线区域信息 | | ||
| 202 | +| txbzxx | String | 停线班组信息 | | ||
| 203 | +| txgwxx | String | 停线工位信息 | | ||
| 204 | +| gwxz | String | 工位性质 | | ||
| 205 | +| startTime | String | 停线开始时间(yyyy-MM-dd HH:mm:ss) | | ||
| 206 | +| endTime | String | 停线结束时间(yyyy-MM-dd HH:mm:ss) | | ||
| 207 | +| txsc | Double | 停线时长(分钟) | | ||
| 208 | +| txbkxx | String | 停线板块信息 | | ||
| 209 | +| txflxx | String | 停线分类信息 | | ||
| 210 | +| txms | String | 停线描述 | | ||
| 211 | +| qgxtbxz | String | 切换系统备选组 | | ||
| 212 | +| bsbqgxyy | String | 本班停线工艺原因 | | ||
| 213 | +| zrbkfzr | String | 责任板块负责人 | | ||
| 214 | +| txwthf | String | 停线问题回复 | | ||
| 215 | +| sbtzxx | String | 设备台账信息 | | ||
| 216 | +| sbbm | String | 设备编码 | | ||
| 217 | +| sbmc | String | 设备名称 | | ||
| 218 | +| sbgzlx | String | 设备故障类型 | | ||
| 219 | +| sbgzsfcf | Boolean | 设备故障是否重复 | | ||
| 220 | +| sbgzywbz | String | 设备故障业务板块 | | ||
| 221 | +| sbgzlxfj | String | 设备故障类型附件 | | ||
| 222 | +| sbgzyy | String | 设备故障原因 | | ||
| 223 | +| sblscs | String | 设备临时措施 | | ||
| 224 | +| sbyjcs | String | 设备应急措施 | | ||
| 225 | +| sbghbj | String | 设备更换备件 | | ||
| 226 | +| tbry | String | 填报人员 | | ||
| 227 | +| tbrygh | String | 填报人员工号 | | ||
| 228 | +| czry | String | 处置人员 | | ||
| 229 | +| czrygh | String | 处置人员工号 | | ||
| 230 | +| ylwtclfa | String | 遗留问题处理方案 | | ||
| 231 | + | ||
| 232 | +**响应示例:** | ||
| 233 | + | ||
| 234 | +```json | ||
| 235 | +{ | ||
| 236 | + "success": true, | ||
| 237 | + "data": [ | ||
| 238 | + { | ||
| 239 | + "id": "SR20260901001", | ||
| 240 | + "corpCode": "hfca", | ||
| 241 | + "xtxx": "XT001", | ||
| 242 | + "bcxx": "BC001", | ||
| 243 | + "txqyxx": "QY001", | ||
| 244 | + "txgwxx": "GW001", | ||
| 245 | + "startTime": "2026-09-01 08:30:00", | ||
| 246 | + "endTime": "2026-09-01 09:00:00", | ||
| 247 | + "txsc": 30.0, | ||
| 248 | + "txbkxx": "BK001" | ||
| 249 | + } | ||
| 250 | + ], | ||
| 251 | + "msg": "成功", | ||
| 252 | + "errCode": null | ||
| 253 | +} | ||
| 254 | +``` | ||
| 255 | + | ||
| 256 | +--- | ||
| 257 | + | ||
| 258 | +### 3.2 按月份汇总统计每天的停线时长 🆕新增 | ||
| 259 | + | ||
| 260 | +> 🆕 **新增接口**(2026-10-06 之后新建) | ||
| 261 | + | ||
| 262 | +**接口路径:** `GET /stopRecord/summary/daily` | ||
| 263 | + | ||
| 264 | +**接口说明:** 根据线体、班次、区域、板块条件筛选指定年月(1-12 月)范围内的停线记录,按天分组汇总每天的停线时长与记录数,结果按日期升序排列。 | ||
| 265 | + | ||
| 266 | +**请求参数:** | ||
| 267 | + | ||
| 268 | +| 参数名 | 类型 | 必传 | 说明 | | ||
| 269 | +|--------|------|------|------| | ||
| 270 | +| xtxx | String | 否 | 线体信息(线体id),为空则不限定 | | ||
| 271 | +| bcxx | String | 否 | 班次信息(班次id),为空则不限定 | | ||
| 272 | +| txqyxx | String | 否 | 停线区域信息(区域id),为空则不限定 | | ||
| 273 | +| txbkxx | String | 否 | 停线板块信息(板块id),为空则不限定 | | ||
| 274 | +| year | String | 是 | 年份,如 2026 | | ||
| 275 | +| month | Integer | 是 | 月份(1-12) | | ||
| 276 | + | ||
| 277 | +**响应数据:** `List<StopRecordDailySummaryDTO>` | ||
| 278 | + | ||
| 279 | +**响应字段说明:** | ||
| 280 | + | ||
| 281 | +| 字段 | 类型 | 说明 | | ||
| 282 | +|------|------|------| | ||
| 283 | +| date | String | 日期(yyyy-MM-dd) | | ||
| 284 | +| totalTxsc | Double | 当日停线时长总计(分钟),单条记录 txsc 为 null 时按 0 计 | | ||
| 285 | +| totalCount | Integer | 当日停线记录数 | | ||
| 286 | + | ||
| 287 | +**响应示例:** | ||
| 288 | + | ||
| 289 | +```json | ||
| 290 | +{ | ||
| 291 | + "success": true, | ||
| 292 | + "data": [ | ||
| 293 | + { | ||
| 294 | + "date": "2026-09-01", | ||
| 295 | + "totalTxsc": 120.5, | ||
| 296 | + "totalCount": 3 | ||
| 297 | + }, | ||
| 298 | + { | ||
| 299 | + "date": "2026-09-02", | ||
| 300 | + "totalTxsc": 60.0, | ||
| 301 | + "totalCount": 1 | ||
| 302 | + } | ||
| 303 | + ], | ||
| 304 | + "msg": "成功", | ||
| 305 | + "errCode": null | ||
| 306 | +} | ||
| 307 | +``` | ||
| 308 | + | ||
| 309 | +--- | ||
| 310 | + | ||
| 311 | +### 3.3 按工位汇总统计停线时长 🆕新增 | ||
| 312 | + | ||
| 313 | +> 🆕 **新增接口**(2026-10-06 之后新建) | ||
| 314 | + | ||
| 315 | +**接口路径:** `GET /stopRecord/summary/workstation` | ||
| 316 | + | ||
| 317 | +**接口说明:** 在 [3.2](#32-按月份汇总统计每天的停线时长) 相同的线体、班次、区域、板块条件基础上,加上指定日期,按工位汇总停线时长(关联停线工位信息补充工位名称与编号),汇总结果按停线时长降序排列。`date` 为空时不限定日期。**仅返回汇总结果,不含停线记录明细**(明细查询见 [3.4](#34-查询停线记录明细列表))。 | ||
| 318 | + | ||
| 319 | +**请求参数:** | ||
| 320 | + | ||
| 321 | +| 参数名 | 类型 | 必传 | 说明 | | ||
| 322 | +|--------|------|------|------| | ||
| 323 | +| xtxx | String | 否 | 线体信息(线体id),为空则不限定 | | ||
| 324 | +| bcxx | String | 否 | 班次信息(班次id),为空则不限定 | | ||
| 325 | +| txqyxx | String | 否 | 停线区域信息(区域id),为空则不限定 | | ||
| 326 | +| txbkxx | String | 否 | 停线板块信息(板块id),为空则不限定 | | ||
| 327 | +| date | String | 否 | 指定日期,格式:yyyy-MM-dd,为空时不限定日期 | | ||
| 328 | + | ||
| 329 | +**响应数据:** `List<StopRecordWorkstationSummaryDTO>` | ||
| 330 | + | ||
| 331 | +**响应字段说明:** | ||
| 332 | + | ||
| 333 | +| 字段 | 类型 | 说明 | | ||
| 334 | +|------|------|------| | ||
| 335 | +| txgwxx | String | 工位id | | ||
| 336 | +| gwmc | String | 工位名称(关联停线工位信息) | | ||
| 337 | +| gwbh | String | 工位编号(关联停线工位信息) | | ||
| 338 | +| totalTxsc | Double | 该工位停线时长总计(分钟) | | ||
| 339 | +| totalCount | Integer | 该工位停线记录数 | | ||
| 340 | + | ||
| 341 | +**响应示例:** | ||
| 342 | + | ||
| 343 | +```json | ||
| 344 | +{ | ||
| 345 | + "success": true, | ||
| 346 | + "data": [ | ||
| 347 | + { | ||
| 348 | + "txgwxx": "GW001", | ||
| 349 | + "gwmc": "焊接工位", | ||
| 350 | + "gwbh": "01", | ||
| 351 | + "totalTxsc": 90.0, | ||
| 352 | + "totalCount": 1 | ||
| 353 | + }, | ||
| 354 | + { | ||
| 355 | + "txgwxx": "GW002", | ||
| 356 | + "gwmc": "装配工位", | ||
| 357 | + "gwbh": "02", | ||
| 358 | + "totalTxsc": 30.0, | ||
| 359 | + "totalCount": 1 | ||
| 360 | + } | ||
| 361 | + ], | ||
| 362 | + "msg": "成功", | ||
| 363 | + "errCode": null | ||
| 364 | +} | ||
| 365 | +``` | ||
| 366 | + | ||
| 367 | +--- | ||
| 368 | + | ||
| 369 | +### 3.4 查询停线记录明细列表 🆕新增 | ||
| 370 | + | ||
| 371 | +> 🆕 **新增接口**(2026-10-06 之后新建) | ||
| 372 | + | ||
| 373 | +**接口路径:** `GET /stopRecord/list/detail` | ||
| 374 | + | ||
| 375 | +**接口说明:** 根据线体、班次、区域、板块、工位条件及指定日期筛选停线记录,返回停线记录明细列表。所有参数均为可选,`date` 为空时不限定日期。 | ||
| 376 | + | ||
| 377 | +**请求参数:** | ||
| 378 | + | ||
| 379 | +| 参数名 | 类型 | 必传 | 说明 | | ||
| 380 | +|--------|------|------|------| | ||
| 381 | +| xtxx | String | 否 | 线体信息(线体id),为空则不限定 | | ||
| 382 | +| bcxx | String | 否 | 班次信息(班次id),为空则不限定 | | ||
| 383 | +| txqyxx | String | 否 | 停线区域信息(区域id),为空则不限定 | | ||
| 384 | +| txbkxx | String | 否 | 停线板块信息(板块id),为空则不限定 | | ||
| 385 | +| txgwxx | String | 否 | 停线工位信息(工位id),为空则不限定 | | ||
| 386 | +| date | String | 否 | 指定日期,格式:yyyy-MM-dd,为空时不限定日期 | | ||
| 387 | + | ||
| 388 | +**响应数据:** `List<StopRecord>`(结构同 [3.1](#31-获取所有停线记录列表) 的 StopRecord) | ||
| 389 | + | ||
| 390 | +**响应示例:** | ||
| 391 | + | ||
| 392 | +```json | ||
| 393 | +{ | ||
| 394 | + "success": true, | ||
| 395 | + "data": [ | ||
| 396 | + { | ||
| 397 | + "id": "SR20260901001", | ||
| 398 | + "corpCode": "hfca", | ||
| 399 | + "xtxx": "XT001", | ||
| 400 | + "bcxx": "BC001", | ||
| 401 | + "txqyxx": "QY001", | ||
| 402 | + "txgwxx": "GW001", | ||
| 403 | + "startTime": "2026-09-01 08:30:00", | ||
| 404 | + "endTime": "2026-09-01 10:00:00", | ||
| 405 | + "txsc": 90.0, | ||
| 406 | + "txbkxx": "BK001" | ||
| 407 | + } | ||
| 408 | + ], | ||
| 409 | + "msg": "成功", | ||
| 410 | + "errCode": null | ||
| 411 | +} | ||
| 412 | +``` | ||
| 413 | + | ||
| 414 | +--- | ||
| 415 | + | ||
| 416 | +## 4. 过程确认班组计划接口 | ||
| 417 | + | ||
| 418 | +### 4.1 获取所有过程确认班组计划列表 🆕新增 | ||
| 419 | + | ||
| 420 | +> 🆕 **新增接口**(2026-10-06 之后新建) | ||
| 421 | + | ||
| 422 | +**接口路径:** `GET /processConfirmTeamPlan/list/all` | ||
| 423 | + | ||
| 424 | +**接口说明:** 获取当前企业下所有过程确认班组计划列表。 | ||
| 425 | + | ||
| 426 | +**请求参数:** 无 | ||
| 427 | + | ||
| 428 | +**响应数据:** `List<ProcessConfirmTeamPlan>` | ||
| 429 | + | ||
| 430 | +**响应字段说明:** | ||
| 431 | + | ||
| 432 | +| 字段 | 类型 | 说明 | | ||
| 433 | +|------|------|------| | ||
| 434 | +| id | String | 记录ID | | ||
| 435 | +| corpCode | String | 企业编码 | | ||
| 436 | +| createdAt | String | 创建时间(yyyy-MM-dd HH:mm:ss) | | ||
| 437 | +| jhrq | String | 计划日期(yyyy-MM-dd HH:mm:ss) | | ||
| 438 | +| zxr | String | 执行人 | | ||
| 439 | +| dwxx | String | 单位信息 | | ||
| 440 | +| xtxx | String | 线体信息 | | ||
| 441 | +| szxx | String | 室组信息 | | ||
| 442 | +| qyxx | String | 区域信息 | | ||
| 443 | +| jhzfbz | String | 计划走访班组id | | ||
| 444 | +| jhzfgw | String | 计划走访工位id | | ||
| 445 | +| zt | String | 状态(#1#-待确认;#2#-未执行;#3#-已执行;#4#-已逾期) | | ||
| 446 | +| sffxwt | Boolean | 是否发现问题 | | ||
| 447 | +| bcxx | String | 班次信息 | | ||
| 448 | + | ||
| 449 | +**响应示例:** | ||
| 450 | + | ||
| 451 | +```json | ||
| 452 | +{ | ||
| 453 | + "success": true, | ||
| 454 | + "data": [ | ||
| 455 | + { | ||
| 456 | + "id": "PCTP20261005001", | ||
| 457 | + "corpCode": "hfca", | ||
| 458 | + "createdAt": "2026-10-05 08:00:00", | ||
| 459 | + "jhrq": "2026-10-06 00:00:00", | ||
| 460 | + "zxr": "user001", | ||
| 461 | + "dwxx": "workshop001", | ||
| 462 | + "xtxx": "XT001", | ||
| 463 | + "szxx": "rg001", | ||
| 464 | + "qyxx": "area001", | ||
| 465 | + "jhzfbz": "team001", | ||
| 466 | + "jhzfgw": "ws001", | ||
| 467 | + "zt": "#1#", | ||
| 468 | + "sffxwt": false, | ||
| 469 | + "bcxx": "BC001" | ||
| 470 | + } | ||
| 471 | + ], | ||
| 472 | + "msg": "成功", | ||
| 473 | + "errCode": null | ||
| 474 | +} | ||
| 475 | +``` | ||
| 476 | + | ||
| 477 | +--- | ||
| 478 | + | ||
| 479 | +### 4.2 按区域查询当前周过程确认班组计划明细列表 🆕新增 | ||
| 480 | + | ||
| 481 | +> 🆕 **新增接口**(2026-10-06 之后新建):按区域查询当前时间所在周(周一至周日)的过程确认班组计划明细,关联计划走访班组、工位的编号与名称。 | ||
| 482 | + | ||
| 483 | +**接口路径:** `GET /processConfirmTeamPlan/list/currentWeek` | ||
| 484 | + | ||
| 485 | +**接口说明:** 以当前时间所在自然周为准(周一为一周起始),查询计划日期(jhrq)在周一 00:00:00.000 ~ 周日 23:59:59.999 范围内的过程确认班组计划记录,关联计划走访班组(jhzfbz)、计划走访工位(jhzfgw)的编号与名称,结果按计划日期升序排列。`qyxx` 为空时不限定区域。 | ||
| 486 | + | ||
| 487 | +**请求参数:** | ||
| 488 | + | ||
| 489 | +| 参数名 | 类型 | 必传 | 说明 | | ||
| 490 | +|--------|------|------|------| | ||
| 491 | +| qyxx | String | 否 | 区域信息(区域id),为空则不限定区域 | | ||
| 492 | + | ||
| 493 | +**响应数据:** `List<ProcessConfirmTeamPlanDetailDTO>` | ||
| 494 | + | ||
| 495 | +**响应字段说明:** | ||
| 496 | + | ||
| 497 | +| 字段 | 类型 | 说明 | | ||
| 498 | +|------|------|------| | ||
| 499 | +| id | String | 记录ID | | ||
| 500 | +| createdAt | String | 创建时间(yyyy-MM-dd HH:mm:ss) | | ||
| 501 | +| jhrq | String | 计划日期(yyyy-MM-dd HH:mm:ss) | | ||
| 502 | +| zxr | String | 执行人 | | ||
| 503 | +| dwxx | String | 单位信息 | | ||
| 504 | +| xtxx | String | 线体信息 | | ||
| 505 | +| szxx | String | 室组信息 | | ||
| 506 | +| qyxx | String | 区域信息 | | ||
| 507 | +| zt | String | 状态(#1#-待确认;#2#-未执行;#3#-已执行;#4#-已逾期) | | ||
| 508 | +| sffxwt | Boolean | 是否发现问题 | | ||
| 509 | +| bcxx | String | 班次信息 | | ||
| 510 | +| jhzfbz | String | 计划走访班组id | | ||
| 511 | +| jhzfbzName | String | 计划走访班组名称 | | ||
| 512 | +| jhzfbzCode | String | 计划走访班组编号 | | ||
| 513 | +| jhzfgw | String | 计划走访工位id | | ||
| 514 | +| jhzfgwName | String | 计划走访工位名称 | | ||
| 515 | +| jhzfgwCode | String | 计划走访工位编号 | | ||
| 516 | + | ||
| 517 | +**响应示例:** | ||
| 518 | + | ||
| 519 | +```json | ||
| 520 | +{ | ||
| 521 | + "success": true, | ||
| 522 | + "data": [ | ||
| 523 | + { | ||
| 524 | + "id": "PCTP20261005001", | ||
| 525 | + "createdAt": "2026-10-05 08:00:00", | ||
| 526 | + "jhrq": "2026-10-06 00:00:00", | ||
| 527 | + "zxr": "user001", | ||
| 528 | + "dwxx": "workshop001", | ||
| 529 | + "xtxx": "XT001", | ||
| 530 | + "szxx": "rg001", | ||
| 531 | + "qyxx": "area001", | ||
| 532 | + "zt": "#1#", | ||
| 533 | + "sffxwt": false, | ||
| 534 | + "bcxx": "BC001", | ||
| 535 | + "jhzfbz": "team001", | ||
| 536 | + "jhzfbzName": "装配一班", | ||
| 537 | + "jhzfbzCode": "BZ001", | ||
| 538 | + "jhzfgw": "ws001", | ||
| 539 | + "jhzfgwName": "装配工位", | ||
| 540 | + "jhzfgwCode": "GW001" | ||
| 541 | + } | ||
| 542 | + ], | ||
| 543 | + "msg": "成功", | ||
| 544 | + "errCode": null | ||
| 545 | +} | ||
| 546 | +``` | ||
| 547 | + | ||
| 548 | +--- | ||
| 549 | + | ||
| 550 | +## 5. PJO计划执行接口 | ||
| 551 | + | ||
| 552 | +### 5.1 查询区域内当前周PJO执行记录明细列表 🆕新增 | ||
| 553 | + | ||
| 554 | +> 🆕 **新增接口**(2026-10-06 之后新建) | ||
| 555 | + | ||
| 556 | +**接口路径:** `GET /pjoExec/list/detail/currentWeek` | ||
| 557 | + | ||
| 558 | +**接口说明:** 以当前时间所在自然周为准(周一为一周起始),查询 PJO 开展日期(qkxdwk)落在本周 **周一 00:00:00.000 ~ 周日 23:59:59.999** 范围内的 PJO 执行记录明细,可按区域过滤,并补充关联实体名称/编号、枚举中文描述及各阶段问题标记。区域为空时不限定区域;结果按 PJO 开展日期降序排列。 | ||
| 559 | + | ||
| 560 | +**请求参数:** | ||
| 561 | + | ||
| 562 | +| 参数名 | 类型 | 必传 | 说明 | | ||
| 563 | +|--------|------|------|------| | ||
| 564 | +| qy | String | 否 | 区域id,为空时不限定区域 | | ||
| 565 | + | ||
| 566 | +**响应数据:** `List<PjoExecDetailDTO>` | ||
| 567 | + | ||
| 568 | +**响应字段说明:** | ||
| 569 | + | ||
| 570 | +| 字段 | 类型 | 说明 | | ||
| 571 | +|------|------|------| | ||
| 572 | +| id | String | 记录ID | | ||
| 573 | +| createdAt | Date | 创建时间(yyyy-MM-dd HH:mm:ss) | | ||
| 574 | +| qkxdwk | Date | PJO开展日期(yyyy-MM-dd HH:mm:ss) | | ||
| 575 | +| drscbc | String | 当日生产班次id | | ||
| 576 | +| drscbcName | String | 当日生产班次名称 | | ||
| 577 | +| drscbcCode | String | 当日生产班次编号 | | ||
| 578 | +| pjozxr | String | PJO执行人id(组织用户) | | ||
| 579 | +| pjozxrName | String | PJO执行人姓名 | | ||
| 580 | +| pjogcrxm | String | PJO观察人姓名 | | ||
| 581 | +| pjopc | String | PJO批次id | | ||
| 582 | +| pjopcName | String | PJO批次名称 | | ||
| 583 | +| pjopcCode | String | PJO批次编号 | | ||
| 584 | +| gwxz | String | 岗位性质编号(#1#-A类;#2#-B类;#3#-C类) | | ||
| 585 | +| gwxzDesc | String | 岗位性质名称 | | ||
| 586 | +| gwzx1 | String | 工位1-PJO工位执行情况记录id | | ||
| 587 | +| gwzx1Name | String | 工位1名称 | | ||
| 588 | +| gwzx1Code | String | 工位1编号 | | ||
| 589 | +| gwzx2 | String | 工位2-PJO工位执行情况记录id | | ||
| 590 | +| gwzx2Name | String | 工位2名称 | | ||
| 591 | +| gwzx2Code | String | 工位2编号 | | ||
| 592 | +| pjosfzckz | Boolean | PJO是否正常开展 | | ||
| 593 | +| gchtxzyyc | String | 观察和填写主要异常 | | ||
| 594 | +| gchtxcyyc | String | 观察和填写次要异常 | | ||
| 595 | +| gcdwt | String | 观察的问题(第一阶段问题来源) | | ||
| 596 | +| gcgjjh | String | 观测改进机会 | | ||
| 597 | +| lfwkuc | String | 观察的改善点描述(第二阶段问题来源) | | ||
| 598 | +| zyczdwt | String | 组员存在的问题编号(第三阶段问题来源,#1#-无) | | ||
| 599 | +| zyczdwtDesc | String | 组员存在的问题名称 | | ||
| 600 | +| zdbgwdgsjy | String | 针对本工位的改善建议 | | ||
| 601 | +| lvqwyc | String | 三个动作 | | ||
| 602 | +| zysfyjy | Boolean | 组员是否有建议 | | ||
| 603 | +| cyjy | String | 成员建议&意见处理人员id(组织用户) | | ||
| 604 | +| cyjyName | String | 成员建议&意见处理人员姓名 | | ||
| 605 | +| zyjy | String | 组员建议&意见处理方案 | | ||
| 606 | +| zt | String | 状态编号(#1#-待执行;#2#-执行中;#3#-已执行;#4#-已关闭) | | ||
| 607 | +| ztDesc | String | 状态名称 | | ||
| 608 | +| stage1Problem | Boolean | 第一阶段是否发现问题(gcdwt 有值) | | ||
| 609 | +| stage2Problem | Boolean | 第二阶段是否发现问题(lfwkuc 有值) | | ||
| 610 | +| stage3Problem | Boolean | 第三阶段是否发现问题(zyczdwt 有值且非 #1#-无) | | ||
| 611 | +| problemCount | Integer | 该记录发现问题总数(三阶段合计,0~3) | | ||
| 612 | +| cj | String | 车间id | | ||
| 613 | +| cjName | String | 车间名称 | | ||
| 614 | +| cjCode | String | 车间编号 | | ||
| 615 | +| qy | String | 区域id | | ||
| 616 | +| qyName | String | 区域名称 | | ||
| 617 | +| qyCode | String | 区域编号 | | ||
| 618 | +| bz | String | 班组id | | ||
| 619 | +| bzName | String | 班组名称 | | ||
| 620 | +| bzCode | String | 班组编号 | | ||
| 621 | +| xt | String | 线体id | | ||
| 622 | +| xtName | String | 线体名称 | | ||
| 623 | +| xtCode | String | 线体编号 | | ||
| 624 | + | ||
| 625 | +**响应示例:** | ||
| 626 | + | ||
| 627 | +```json | ||
| 628 | +{ | ||
| 629 | + "success": true, | ||
| 630 | + "data": [ | ||
| 631 | + { | ||
| 632 | + "id": "53DfARB8Lllis48Qc5S", | ||
| 633 | + "createdAt": null, | ||
| 634 | + "qkxdwk": "2026-10-07 08:00:00", | ||
| 635 | + "drscbc": "04XZ79FFFNlMQvVRbNC", | ||
| 636 | + "drscbcName": "白班", | ||
| 637 | + "drscbcCode": "BC001", | ||
| 638 | + "pjozxr": "jU1pkX6iMiZjUPP19MP", | ||
| 639 | + "pjozxrName": "陈工", | ||
| 640 | + "pjogcrxm": "17", | ||
| 641 | + "pjopc": "Rx9pcihofirkRXKwp7U", | ||
| 642 | + "pjopcName": "1111", | ||
| 643 | + "pjopcCode": "103", | ||
| 644 | + "gwxz": "#1#", | ||
| 645 | + "gwxzDesc": "A类", | ||
| 646 | + "gwzx1": "sWIvFIxMCEIBPQe1vnp", | ||
| 647 | + "gwzx1Name": "PT-17", | ||
| 648 | + "gwzx1Code": "PT-17", | ||
| 649 | + "gwzx2": null, | ||
| 650 | + "gwzx2Name": null, | ||
| 651 | + "gwzx2Code": null, | ||
| 652 | + "pjosfzckz": true, | ||
| 653 | + "gcdwt": null, | ||
| 654 | + "lfwkuc": null, | ||
| 655 | + "zyczdwt": null, | ||
| 656 | + "zyczdwtDesc": null, | ||
| 657 | + "zt": "#3#", | ||
| 658 | + "ztDesc": "已执行", | ||
| 659 | + "stage1Problem": false, | ||
| 660 | + "stage2Problem": false, | ||
| 661 | + "stage3Problem": false, | ||
| 662 | + "problemCount": 0, | ||
| 663 | + "cj": "ahImSLxXBuQkFtU8Ace", | ||
| 664 | + "cjName": "总装车间", | ||
| 665 | + "cjCode": "104", | ||
| 666 | + "qy": "fmGDmYdCswHy1AfNO7R", | ||
| 667 | + "qyName": "底盘分装", | ||
| 668 | + "qyCode": "51", | ||
| 669 | + "bz": "GQ8wL2PXGUutYA7HKks", | ||
| 670 | + "bzName": "发动机分装班", | ||
| 671 | + "bzCode": "142", | ||
| 672 | + "xt": "6J4vk1uvwmoj6e3AL2G", | ||
| 673 | + "xtName": "B线", | ||
| 674 | + "xtCode": "B" | ||
| 675 | + } | ||
| 676 | + ], | ||
| 677 | + "msg": "成功", | ||
| 678 | + "errCode": null | ||
| 679 | +} | ||
| 680 | +``` | ||
| 681 | + | ||
| 682 | +--- | ||
| 683 | + | ||
| 684 | +## 6. CPS问题接口 | ||
| 685 | + | ||
| 686 | +### 6.1 根据年月、区域、状态查询问题记录明细 🆕新增 | ||
| 687 | + | ||
| 688 | +> 🆕 **新增接口**(2026-10-06 之后新建):所有条件均可为空,月份(1-12)未传默认当前月、年份未传默认当前年(按创建时间过滤),返回问题记录明细。 | ||
| 689 | + | ||
| 690 | +**接口路径:** `GET /cpsProblem/list/detail/condition` | ||
| 691 | + | ||
| 692 | +**接口说明:** 按年月、区域、处理状态筛选问题记录明细(含关联实体名称与枚举中文描述),结果按创建时间降序。所有参数均非必填;`year` 为空时默认当前年,`month`(1-12)为空时默认当前月,按创建时间(createdAt)在该年月范围内过滤。**线体、单位、班次在问题记录属性中无对应字段,故不作为查询条件。** | ||
| 693 | + | ||
| 694 | +**请求参数:** | ||
| 695 | + | ||
| 696 | +| 参数名 | 类型 | 必传 | 说明 | | ||
| 697 | +|--------|------|------|------| | ||
| 698 | +| year | Integer | 否 | 年份(如 2026),为空默认当前年 | | ||
| 699 | +| month | Integer | 否 | 月份(1-12,分别代表 1~12 月),为空默认当前月;按创建时间范围过滤 | | ||
| 700 | +| qy | String | 否 | 区域id,为空则不限定 | | ||
| 701 | +| status | String | 否 | 问题处理状态编号(#1#-待处理;#2#-处理中;#3#-已关闭;#4#-已逾期),兼容传入 1~4 短形式,为空则不限定 | | ||
| 702 | + | ||
| 703 | +**响应数据:** `List<CpsProblemDetailDTO>` | ||
| 704 | + | ||
| 705 | +**响应字段说明:** | ||
| 706 | + | ||
| 707 | +| 字段 | 类型 | 说明 | | ||
| 708 | +|------|------|------| | ||
| 709 | +| id | String | 记录ID | | ||
| 710 | +| createdAt | Date | 创建时间(yyyy-MM-dd HH:mm:ss) | | ||
| 711 | +| wtbh | String | 问题编号 | | ||
| 712 | +| wtms | String | 问题描述 | | ||
| 713 | +| wtly | String | 问题来源编号(#1#-开班;#2#-过程验证;#3#-过程确认;#4#-体系健康体检;#5#-单位自检) | | ||
| 714 | +| wtlyDesc | String | 问题来源名称 | | ||
| 715 | +| wtssbk | String | 问题所属板块 | | ||
| 716 | +| wtlb | String | 问题类别编号(#1#-方针展开;#2#-标准化作业;#3#-目视化;#4#-时间数据处理;#5#-过程确认;#6#-持续改善) | | ||
| 717 | +| wtlbDesc | String | 问题类别名称 | | ||
| 718 | +| wtxz | String | 问题性质编号(#1#-无标准;#2#-未执行标准;#3#-标准不足) | | ||
| 719 | +| wtxzDesc | String | 问题性质名称 | | ||
| 720 | +| sfl | String | 6S分类编号(#1#-整理;#2#-整顿;#3#-清洁;#4#-清扫;#5#-素养;#6#-安全) | | ||
| 721 | +| sflDesc | String | 6S分类名称 | | ||
| 722 | +| mbghlk | String | 问题层级编号(#1#-1;#2#-2;#3#-3;#4#-4;#5#-5;#0#-0) | | ||
| 723 | +| mbghlkDesc | String | 问题层级名称 | | ||
| 724 | +| rylb | String | 人员类别编号(#1#-区长;#2#-班长;#3#-高级经理;#4#-经理;#5#-主管;#6#-专家;#7#-一般员工) | | ||
| 725 | +| rylbDesc | String | 人员类别名称 | | ||
| 726 | +| wtsfgb | Boolean | 问题是否关闭 | | ||
| 727 | +| wtfj | String | 问题附件 | | ||
| 728 | +| wtzghfj | String | 问题整改后附件 | | ||
| 729 | +| wtjjcs | String | 问题解决措施 | | ||
| 730 | +| wtclfs | String | 问题处理方式编号(#1#-自己解决;#2#-工作安排/同级支持;#3#-问题升级至) | | ||
| 731 | +| wtclfsDesc | String | 问题处理方式名称 | | ||
| 732 | +| gzap | String | 工作安排/同级支持 | | ||
| 733 | +| wtsjz | String | 问题升级至 | | ||
| 734 | +| wtclfs2 | String | 问题处理方式2编号 | | ||
| 735 | +| wtclfs2Desc | String | 问题处理方式2名称 | | ||
| 736 | +| gzap2 | String | 工作安排/同级支持2 | | ||
| 737 | +| wtsjz2 | String | 问题升级至2 | | ||
| 738 | +| wtclfs3 | String | 问题处理方式3编号 | | ||
| 739 | +| wtclfs3Desc | String | 问题处理方式3名称 | | ||
| 740 | +| gzap3 | String | 工作安排/同级支持3 | | ||
| 741 | +| wtsjz3 | String | 问题升级至3 | | ||
| 742 | +| jhjjsj | Date | 计划解决时间(yyyy-MM-dd HH:mm:ss) | | ||
| 743 | +| tntpvy | Date | 问题解决时间(yyyy-MM-dd HH:mm:ss) | | ||
| 744 | +| processInstanceId | String | 流程实例ID | | ||
| 745 | +| approvalStatus | String | 审批状态 | | ||
| 746 | +| gzdw | String | 工作单位id | | ||
| 747 | +| gzdwName | String | 工作单位名称 | | ||
| 748 | +| gzdwCode | String | 工作单位编号 | | ||
| 749 | +| wtzrdw | String | 问题责任单位id | | ||
| 750 | +| wtzrdwName | String | 问题责任单位名称 | | ||
| 751 | +| wtzrdwCode | String | 问题责任单位编号 | | ||
| 752 | +| sz | String | 室组id | | ||
| 753 | +| szName | String | 室组名称 | | ||
| 754 | +| szCode | String | 室组编号 | | ||
| 755 | +| qy | String | 区域id | | ||
| 756 | +| qyName | String | 区域名称 | | ||
| 757 | +| qyCode | String | 区域编号 | | ||
| 758 | +| bz | String | 班组id | | ||
| 759 | +| bzName | String | 班组名称 | | ||
| 760 | +| bzCode | String | 班组编号 | | ||
| 761 | +| wttcr | String | 问题提出人id | | ||
| 762 | +| wttcrName | String | 问题提出人姓名 | | ||
| 763 | +| wtclr | String | 问题处理人id | | ||
| 764 | +| wtclrName | String | 问题处理人姓名 | | ||
| 765 | +| wtclzt | String | 问题处理状态编号(#1#-待处理;#2#-处理中;#3#-已关闭;#4#-已逾期) | | ||
| 766 | +| wtclztDesc | String | 问题处理状态名称 | | ||
| 767 | + | ||
| 768 | +**响应示例:** | ||
| 769 | + | ||
| 770 | +```json | ||
| 771 | +{ | ||
| 772 | + "success": true, | ||
| 773 | + "data": [ | ||
| 774 | + { | ||
| 775 | + "id": "p123", | ||
| 776 | + "createdAt": "2026-10-05 09:00:00", | ||
| 777 | + "wtbh": "WT202610001", | ||
| 778 | + "wtms": "装配线设备故障", | ||
| 779 | + "wtly": "#2#", | ||
| 780 | + "wtlyDesc": "过程验证", | ||
| 781 | + "wtlb": "#5#", | ||
| 782 | + "wtlbDesc": "过程确认", | ||
| 783 | + "jhjjsj": "2026-10-10 18:00:00", | ||
| 784 | + "gzdw": "workshop001", | ||
| 785 | + "gzdwName": "总装车间", | ||
| 786 | + "gzdwCode": "104", | ||
| 787 | + "wtzrdw": "workshop001", | ||
| 788 | + "wtzrdwName": "总装车间", | ||
| 789 | + "wtzrdwCode": "104", | ||
| 790 | + "qy": "area001", | ||
| 791 | + "qyName": "装配区域", | ||
| 792 | + "qyCode": "QY001", | ||
| 793 | + "bz": "team001", | ||
| 794 | + "bzName": "装配一班", | ||
| 795 | + "bzCode": "BZ001", | ||
| 796 | + "wttcr": "user001", | ||
| 797 | + "wttcrName": "张三", | ||
| 798 | + "wtclr": "user002", | ||
| 799 | + "wtclrName": "李四", | ||
| 800 | + "wtclzt": "#2#", | ||
| 801 | + "wtclztDesc": "处理中" | ||
| 802 | + } | ||
| 803 | + ], | ||
| 804 | + "msg": "成功", | ||
| 805 | + "errCode": null | ||
| 806 | +} | ||
| 807 | +``` |