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<Long> createTicket(@Valid @RequestBody AfterSaleTicketSaveReqVO createReqVO) {
|
return success(ticketService.createTicket(createReqVO, getLoginUserId()));
|
}
|
|
@PutMapping("/update")
|
@Operation(summary = "更新售后工单")
|
@PreAuthorize("@ss.hasPermission('aftersales:ticket:update')")
|
public CommonResult<Boolean> 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<Boolean> 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<AfterSaleTicketRespVO> getTicket(@RequestParam("id") Long id) {
|
AfterSaleTicketDO ticket = ticketService.getTicket(id);
|
List<AfterSaleTicketItemDO> items = ticketService.getTicketItemListByTicketId(id);
|
// 批量加载关联名称
|
List<AfterSaleTicketRespVO> 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<PageResult<AfterSaleTicketRespVO>> getTicketPage(@Valid AfterSaleTicketPageReqVO pageReqVO) {
|
PageResult<AfterSaleTicketDO> pageResult = ticketService.getTicketPage(pageReqVO, getLoginUserId());
|
List<AfterSaleTicketRespVO> list = buildTicketDetailList(pageResult.getList());
|
return success(new PageResult<>(list, pageResult.getTotal()));
|
}
|
|
@PostMapping("/assign")
|
@Operation(summary = "分配处理人")
|
@PreAuthorize("@ss.hasPermission('aftersales:ticket:update')")
|
public CommonResult<Boolean> 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<Boolean> 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<Boolean> resolveTicket(@RequestParam("id") Long id) {
|
ticketService.resolveTicket(id, getLoginUserId());
|
return success(true);
|
}
|
|
@PutMapping("/close")
|
@Operation(summary = "关闭工单")
|
@PreAuthorize("@ss.hasPermission('aftersales:ticket:update')")
|
public CommonResult<Boolean> closeTicket(@RequestParam("id") Long id) {
|
ticketService.closeTicket(id, getLoginUserId());
|
return success(true);
|
}
|
|
@PutMapping("/cancel")
|
@Operation(summary = "取消工单")
|
@PreAuthorize("@ss.hasPermission('aftersales:ticket:update')")
|
public CommonResult<Boolean> 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<Boolean> signInTicket(@Valid @RequestBody AfterSaleTicketSignInReqVO reqVO) {
|
ticketService.signInTicket(reqVO, getLoginUserId());
|
return success(true);
|
}
|
|
@PostMapping("/transfer")
|
@Operation(summary = "转派工单")
|
@PreAuthorize("@ss.hasPermission('aftersales:ticket:update')")
|
public CommonResult<Boolean> transferTicket(@Valid @RequestBody AfterSaleTicketTransferReqVO reqVO) {
|
ticketService.transferTicket(reqVO, getLoginUserId());
|
return success(true);
|
}
|
|
@PostMapping("/escalate")
|
@Operation(summary = "升级工单")
|
@PreAuthorize("@ss.hasPermission('aftersales:ticket:update')")
|
public CommonResult<Boolean> escalateTicket(@Valid @RequestBody AfterSaleTicketEscalateReqVO reqVO) {
|
ticketService.escalateTicket(reqVO, getLoginUserId());
|
return success(true);
|
}
|
|
@PostMapping("/handle")
|
@Operation(summary = "新增处理记录")
|
@PreAuthorize("@ss.hasPermission('aftersales:ticket:update')")
|
public CommonResult<Boolean> 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<List<AfterSaleTicketLogRespVO>> 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<AfterSaleTicketStatisticsRespVO> getTicketStatistics(
|
@RequestParam(value = "sceneType", required = false) Integer sceneType) {
|
return success(ticketService.getTicketStatistics(sceneType, getLoginUserId()));
|
}
|
|
// ========== 内部方法：拼装进度记录 ==========
|
|
private List<AfterSaleTicketLogRespVO> buildLogRespList(List<AfterSaleTicketLogDO> logList) {
|
if (CollUtil.isEmpty(logList)) {
|
return Collections.emptyList();
|
}
|
Set<Long> userIds = convertSet(logList, AfterSaleTicketLogDO::getOperatorUserId);
|
Map<Long, AdminUserRespDTO> 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<AfterSaleTicketRespVO> buildTicketDetailList(List<AfterSaleTicketDO> ticketList) {
|
if (CollUtil.isEmpty(ticketList)) {
|
return Collections.emptyList();
|
}
|
// 1. 批量加载客户名称
|
Set<Long> customerIds = convertSet(ticketList, AfterSaleTicketDO::getCustomerId);
|
Map<Long, CrmCustomerRespDTO> customerMap = customerApi.getCustomerMap(customerIds);
|
// 2. 批量加载用户名称（负责人 + 处理人）
|
Set<Long> userIds = new HashSet<>();
|
ticketList.forEach(t -> {
|
if (t.getOwnerUserId() != null) userIds.add(t.getOwnerUserId());
|
if (t.getHandlerUserId() != null) userIds.add(t.getHandlerUserId());
|
});
|
Map<Long, AdminUserRespDTO> 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());
|
});
|
}
|
|
}
|
