package cn.iocoder.yudao.module.aftersales.controller.admin.ticket; import cn.hutool.core.collection.CollUtil; import cn.iocoder.yudao.framework.common.pojo.CommonResult; import cn.iocoder.yudao.framework.common.pojo.PageResult; import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils; import cn.iocoder.yudao.framework.common.util.object.BeanUtils; import cn.iocoder.yudao.module.aftersales.controller.admin.ticket.vo.ticket.AfterSaleTicketEscalateReqVO; import cn.iocoder.yudao.module.aftersales.controller.admin.ticket.vo.ticket.AfterSaleTicketHandleReqVO; import cn.iocoder.yudao.module.aftersales.controller.admin.ticket.vo.ticket.AfterSaleTicketLogRespVO; import cn.iocoder.yudao.module.aftersales.controller.admin.ticket.vo.ticket.AfterSaleTicketPageReqVO; import cn.iocoder.yudao.module.aftersales.controller.admin.ticket.vo.ticket.AfterSaleTicketRespVO; import cn.iocoder.yudao.module.aftersales.controller.admin.ticket.vo.ticket.AfterSaleTicketSaveReqVO; import cn.iocoder.yudao.module.aftersales.controller.admin.ticket.vo.ticket.AfterSaleTicketSignInReqVO; import cn.iocoder.yudao.module.aftersales.controller.admin.ticket.vo.ticket.AfterSaleTicketStatisticsRespVO; import cn.iocoder.yudao.module.aftersales.controller.admin.ticket.vo.ticket.AfterSaleTicketTransferReqVO; import cn.iocoder.yudao.module.aftersales.dal.dataobject.ticket.AfterSaleTicketDO; import cn.iocoder.yudao.module.aftersales.dal.dataobject.ticket.AfterSaleTicketItemDO; import cn.iocoder.yudao.module.aftersales.dal.dataobject.ticket.AfterSaleTicketLogDO; import cn.iocoder.yudao.module.aftersales.enums.AfterSaleTicketLogActionEnum; import cn.iocoder.yudao.module.aftersales.service.ticket.AfterSaleTicketService; import cn.iocoder.yudao.module.crm.api.customer.CrmCustomerApi; import cn.iocoder.yudao.module.crm.api.customer.dto.CrmCustomerRespDTO; import cn.iocoder.yudao.module.system.api.user.AdminUserApi; import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.Parameter; import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.annotation.Resource; import jakarta.validation.Valid; import org.springframework.security.access.prepost.PreAuthorize; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import java.util.*; import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success; import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet; import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId; @Tag(name = "管理后台 - 售后工单") @RestController @RequestMapping("/aftersales/ticket") @Validated public class AfterSaleTicketController { @Resource private AfterSaleTicketService ticketService; @Resource private CrmCustomerApi customerApi; @Resource private AdminUserApi adminUserApi; @Resource private cn.iocoder.yudao.module.system.api.storage.StorageAttachmentApi storageAttachmentApi; @PostMapping("/create") @Operation(summary = "创建售后工单") @PreAuthorize("@ss.hasPermission('aftersales:ticket:create')") public CommonResult createTicket(@Valid @RequestBody AfterSaleTicketSaveReqVO createReqVO) { return success(ticketService.createTicket(createReqVO, getLoginUserId())); } @PutMapping("/update") @Operation(summary = "更新售后工单") @PreAuthorize("@ss.hasPermission('aftersales:ticket:update')") public CommonResult updateTicket(@Valid @RequestBody AfterSaleTicketSaveReqVO updateReqVO) { ticketService.updateTicket(updateReqVO); return success(true); } @DeleteMapping("/delete") @Operation(summary = "删除售后工单") @Parameter(name = "id", description = "工单编号", required = true) @PreAuthorize("@ss.hasPermission('aftersales:ticket:delete')") public CommonResult deleteTicket(@RequestParam("id") Long id) { ticketService.deleteTicket(id); return success(true); } @GetMapping("/get") @Operation(summary = "获得售后工单") @Parameter(name = "id", description = "工单编号", required = true, example = "1") public CommonResult getTicket(@RequestParam("id") Long id) { AfterSaleTicketDO ticket = ticketService.getTicket(id); List items = ticketService.getTicketItemListByTicketId(id); // 批量加载关联名称 List enrichedList = buildTicketDetailList(List.of(ticket)); AfterSaleTicketRespVO respVO = enrichedList.get(0); respVO.setItems(BeanUtils.toBean(items, AfterSaleTicketRespVO.Item.class)); respVO.setAttachmentList(storageAttachmentApi.listAttachments("aftersales_after_sale_ticket", id)); return success(respVO); } @GetMapping("/page") @Operation(summary = "获得售后工单分页") public CommonResult> getTicketPage(@Valid AfterSaleTicketPageReqVO pageReqVO) { PageResult pageResult = ticketService.getTicketPage(pageReqVO, getLoginUserId()); List list = buildTicketDetailList(pageResult.getList()); return success(new PageResult<>(list, pageResult.getTotal())); } @PostMapping("/assign") @Operation(summary = "分配处理人") @PreAuthorize("@ss.hasPermission('aftersales:ticket:update')") public CommonResult assignTicket(@RequestParam("id") Long id, @RequestParam("handlerUserId") Long handlerUserId) { ticketService.assignTicket(id, handlerUserId, getLoginUserId()); return success(true); } @PostMapping("/classify") @Operation(summary = "问题判定") @PreAuthorize("@ss.hasPermission('aftersales:ticket:update')") public CommonResult classifyTicket(@RequestParam("id") Long id, @RequestParam("issueType") Integer issueType, @RequestParam(value = "issueCategory", required = false) String issueCategory, @RequestParam(value = "severityLevel", required = false) Integer severityLevel) { ticketService.classifyTicket(id, issueType, issueCategory, severityLevel, getLoginUserId()); return success(true); } @PutMapping("/resolve") @Operation(summary = "完结工单") @PreAuthorize("@ss.hasPermission('aftersales:ticket:update')") public CommonResult resolveTicket(@RequestParam("id") Long id) { ticketService.resolveTicket(id, getLoginUserId()); return success(true); } @PutMapping("/close") @Operation(summary = "关闭工单") @PreAuthorize("@ss.hasPermission('aftersales:ticket:update')") public CommonResult closeTicket(@RequestParam("id") Long id) { ticketService.closeTicket(id, getLoginUserId()); return success(true); } @PutMapping("/cancel") @Operation(summary = "取消工单") @PreAuthorize("@ss.hasPermission('aftersales:ticket:update')") public CommonResult cancelTicket(@RequestParam("id") Long id) { ticketService.cancelTicket(id, getLoginUserId()); return success(true); } @PostMapping("/sign-in") @Operation(summary = "现场签到") @PreAuthorize("@ss.hasPermission('aftersales:ticket:update')") public CommonResult signInTicket(@Valid @RequestBody AfterSaleTicketSignInReqVO reqVO) { ticketService.signInTicket(reqVO, getLoginUserId()); return success(true); } @PostMapping("/transfer") @Operation(summary = "转派工单") @PreAuthorize("@ss.hasPermission('aftersales:ticket:update')") public CommonResult transferTicket(@Valid @RequestBody AfterSaleTicketTransferReqVO reqVO) { ticketService.transferTicket(reqVO, getLoginUserId()); return success(true); } @PostMapping("/escalate") @Operation(summary = "升级工单") @PreAuthorize("@ss.hasPermission('aftersales:ticket:update')") public CommonResult escalateTicket(@Valid @RequestBody AfterSaleTicketEscalateReqVO reqVO) { ticketService.escalateTicket(reqVO, getLoginUserId()); return success(true); } @PostMapping("/handle") @Operation(summary = "新增处理记录") @PreAuthorize("@ss.hasPermission('aftersales:ticket:update')") public CommonResult addHandleRecord(@Valid @RequestBody AfterSaleTicketHandleReqVO reqVO) { ticketService.addHandleRecord(reqVO, getLoginUserId()); return success(true); } @GetMapping("/log-list") @Operation(summary = "获得工单操作/进度记录列表") @Parameter(name = "ticketId", description = "工单编号", required = true, example = "1") public CommonResult> getTicketLogList(@RequestParam("ticketId") Long ticketId) { return success(buildLogRespList(ticketService.getTicketLogList(ticketId))); } @GetMapping("/statistics") @Operation(summary = "获得工单助手统计") @Parameter(name = "sceneType", description = "场景类型: 1-我负责的 2-我参与的 3-下属负责的 4-全部", example = "4") public CommonResult getTicketStatistics( @RequestParam(value = "sceneType", required = false) Integer sceneType) { return success(ticketService.getTicketStatistics(sceneType, getLoginUserId())); } // ========== 内部方法:拼装进度记录 ========== private List buildLogRespList(List logList) { if (CollUtil.isEmpty(logList)) { return Collections.emptyList(); } Set userIds = convertSet(logList, AfterSaleTicketLogDO::getOperatorUserId); Map userMap = adminUserApi.getUserMap(userIds); return BeanUtils.toBean(logList, AfterSaleTicketLogRespVO.class, vo -> { vo.setActionName(AfterSaleTicketLogActionEnum.getName(vo.getActionType())); AdminUserRespDTO user = userMap.get(vo.getOperatorUserId()); if (user != null) { vo.setOperatorUserName(user.getNickname()); } }); } // ========== 内部方法:批量拼装关联名称 ========== private List buildTicketDetailList(List ticketList) { if (CollUtil.isEmpty(ticketList)) { return Collections.emptyList(); } // 1. 批量加载客户名称 Set customerIds = convertSet(ticketList, AfterSaleTicketDO::getCustomerId); Map customerMap = customerApi.getCustomerMap(customerIds); // 2. 批量加载用户名称(负责人 + 处理人) Set userIds = new HashSet<>(); ticketList.forEach(t -> { if (t.getOwnerUserId() != null) userIds.add(t.getOwnerUserId()); if (t.getHandlerUserId() != null) userIds.add(t.getHandlerUserId()); }); Map userMap = adminUserApi.getUserMap(userIds); // 3. 拼装名称字段 return BeanUtils.toBean(ticketList, AfterSaleTicketRespVO.class, vo -> { CrmCustomerRespDTO customer = customerMap.get(vo.getCustomerId()); if (customer != null) vo.setCustomerName(customer.getName()); AdminUserRespDTO ownerUser = userMap.get(vo.getOwnerUserId()); if (ownerUser != null) vo.setOwnerUserName(ownerUser.getNickname()); AdminUserRespDTO handlerUser = userMap.get(vo.getHandlerUserId()); if (handlerUser != null) vo.setHandlerUserName(handlerUser.getNickname()); }); } }