package cn.iocoder.yudao.module.crm.controller.admin.customer; import cn.hutool.core.collection.CollUtil; import cn.hutool.core.map.MapUtil; import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog; 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.collection.MapUtils; import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils; import cn.iocoder.yudao.framework.common.util.number.NumberUtils; import cn.iocoder.yudao.framework.common.util.object.BeanUtils; import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils; import cn.iocoder.yudao.framework.ip.core.utils.AreaUtils; import cn.iocoder.yudao.module.crm.controller.admin.customer.vo.customer.*; import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerDO; import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerPoolConfigDO; import cn.iocoder.yudao.module.crm.service.customer.CrmCustomerPoolConfigService; import cn.iocoder.yudao.module.crm.service.customer.CrmCustomerService; import cn.iocoder.yudao.module.system.api.dept.DeptApi; import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO; 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.Parameters; import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.annotation.Resource; import jakarta.servlet.http.HttpServletResponse; import jakarta.validation.Valid; import org.springframework.security.access.prepost.PreAuthorize; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import java.io.IOException; import java.time.LocalDateTime; import java.util.Arrays; import java.util.List; import java.util.Map; import java.util.stream.Stream; import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT; import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success; import static cn.iocoder.yudao.framework.common.pojo.PageParam.PAGE_SIZE_NONE; import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.*; import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId; import static java.util.Collections.singletonList; @Tag(name = "管理后台 - CRM 客户") @RestController @RequestMapping("/crm/customer") @Validated public class CrmCustomerController { @Resource private CrmCustomerService customerService; @Resource private CrmCustomerPoolConfigService customerPoolConfigService; @Resource private DeptApi deptApi; @Resource private AdminUserApi adminUserApi; @PostMapping("/create") @Operation(summary = "创建客户") @PreAuthorize("@ss.hasPermission('crm:customer:create')") public CommonResult createCustomer(@Valid @RequestBody CrmCustomerSaveReqVO createReqVO) { return success(customerService.createCustomer(createReqVO, getLoginUserId())); } @PutMapping("/update") @Operation(summary = "更新客户") @PreAuthorize("@ss.hasPermission('crm:customer:update')") public CommonResult updateCustomer(@Valid @RequestBody CrmCustomerSaveReqVO updateReqVO) { customerService.updateCustomer(updateReqVO); return success(true); } @PutMapping("/update-deal-status") @Operation(summary = "更新客户的成交状态") @Parameters({ @Parameter(name = "id", description = "客户编号", required = true), @Parameter(name = "dealStatus", description = "成交状态", required = true) }) public CommonResult updateCustomerDealStatus(@RequestParam("id") Long id, @RequestParam("dealStatus") Boolean dealStatus) { customerService.updateCustomerDealStatus(id, dealStatus); return success(true); } @DeleteMapping("/delete") @Operation(summary = "删除客户") @Parameter(name = "id", description = "客户编号", required = true) @PreAuthorize("@ss.hasPermission('crm:customer:delete')") public CommonResult deleteCustomer(@RequestParam("id") Long id) { customerService.deleteCustomer(id); return success(true); } @GetMapping("/get") @Operation(summary = "获得客户") @Parameter(name = "id", description = "编号", required = true, example = "1024") @PreAuthorize("@ss.hasPermission('crm:customer:query')") public CommonResult getCustomer(@RequestParam("id") Long id) { // 1. 获取客户 CrmCustomerDO customer = customerService.getCustomer(id); // 2. 拼接数据 return success(buildCustomerDetail(customer)); } public CrmCustomerRespVO buildCustomerDetail(CrmCustomerDO customer) { if (customer == null) { return null; } return buildCustomerDetailList(singletonList(customer)).get(0); } @GetMapping("/page") @Operation(summary = "获得客户分页") @PreAuthorize("@ss.hasPermission('crm:customer:query')") public CommonResult> getCustomerPage(@Valid CrmCustomerPageReqVO pageVO) { // 1. 查询客户分页 PageResult pageResult = customerService.getCustomerPage(pageVO, getLoginUserId()); if (CollUtil.isEmpty(pageResult.getList())) { return success(PageResult.empty(pageResult.getTotal())); } // 2. 拼接数据 return success(new PageResult<>(buildCustomerDetailList(pageResult.getList()), pageResult.getTotal())); } public List buildCustomerDetailList(List list) { if (CollUtil.isEmpty(list)) { return java.util.Collections.emptyList(); } // 1.1 获取创建人、负责人列表 Map userMap = adminUserApi.getUserMap(convertSetByFlatMap(list, contact -> Stream.of(NumberUtils.parseLong(contact.getCreator()), contact.getOwnerUserId()))); Map deptMap = deptApi.getDeptMap(convertSet(userMap.values(), AdminUserRespDTO::getDeptId)); // 1.2 获取距离进入公海的时间 Map poolDayMap = getPoolDayMap(list); // 2. 转换成 VO return BeanUtils.toBean(list, CrmCustomerRespVO.class, customerVO -> { customerVO.setAreaName(AreaUtils.format(customerVO.getAreaId())); // 2.1 设置创建人、负责人名称 MapUtils.findAndThen(userMap, NumberUtils.parseLong(customerVO.getCreator()), user -> customerVO.setCreatorName(user.getNickname())); MapUtils.findAndThen(userMap, customerVO.getOwnerUserId(), user -> { customerVO.setOwnerUserName(user.getNickname()); MapUtils.findAndThen(deptMap, user.getDeptId(), dept -> customerVO.setOwnerUserDeptName(dept.getName())); }); // 2.2 设置距离进入公海的时间 if (customerVO.getOwnerUserId() != null) { customerVO.setPoolDay(poolDayMap.get(customerVO.getId())); } }); } @GetMapping("/put-pool-remind-page") @Operation(summary = "获得待进入公海客户分页") @PreAuthorize("@ss.hasPermission('crm:customer:query')") public CommonResult> getPutPoolRemindCustomerPage(@Valid CrmCustomerPageReqVO pageVO) { // 1. 查询客户分页 PageResult pageResult = customerService.getPutPoolRemindCustomerPage(pageVO, getLoginUserId()); // 2. 拼接数据 return success(new PageResult<>(buildCustomerDetailList(pageResult.getList()), pageResult.getTotal())); } @GetMapping("/put-pool-remind-count") @Operation(summary = "获得待进入公海客户数量") @PreAuthorize("@ss.hasPermission('crm:customer:query')") public CommonResult getPutPoolRemindCustomerCount() { return success(customerService.getPutPoolRemindCustomerCount(getLoginUserId())); } @GetMapping("/today-contact-count") @Operation(summary = "获得今日需联系客户数量") @PreAuthorize("@ss.hasPermission('crm:customer:query')") public CommonResult getTodayContactCustomerCount() { return success(customerService.getTodayContactCustomerCount(getLoginUserId())); } @GetMapping("/follow-count") @Operation(summary = "获得分配给我、待跟进的线索数量的客户数量") @PreAuthorize("@ss.hasPermission('crm:customer:query')") public CommonResult getFollowCustomerCount() { return success(customerService.getFollowCustomerCount(getLoginUserId())); } /** * 获取距离进入公海的时间 Map * * @param list 客户列表 * @return key 客户编号, value 距离进入公海的时间 */ private Map getPoolDayMap(List list) { CrmCustomerPoolConfigDO poolConfig = customerPoolConfigService.getCustomerPoolConfig(); if (poolConfig == null || !poolConfig.getEnabled()) { return MapUtil.empty(); } list = CollectionUtils.filterList(list, customer -> { // 特殊:如果没负责人,则说明已经在公海,不用计算 if (customer.getOwnerUserId() == null) { return false; } // 已成交 or 已锁定,不进入公海 return !customer.getDealStatus() && !customer.getLockStatus(); }); return convertMap(list, CrmCustomerDO::getId, customer -> { // 1.1 未成交放入公海天数 long dealExpireDay = poolConfig.getDealExpireDays() - LocalDateTimeUtils.between(customer.getOwnerTime()); // 1.2 未跟进放入公海天数 LocalDateTime lastTime = customer.getOwnerTime(); if (customer.getContactLastTime() != null && customer.getContactLastTime().isAfter(lastTime)) { lastTime = customer.getContactLastTime(); } long contactExpireDay = poolConfig.getContactExpireDays() - LocalDateTimeUtils.between(lastTime); // 2. 返回最小的天数 long poolDay = Math.min(dealExpireDay, contactExpireDay); return poolDay > 0 ? poolDay : 0; }); } @GetMapping(value = "/simple-list") @Operation(summary = "获取客户精简信息列表", description = "只包含有读权限的客户,主要用于前端的下拉选项") public CommonResult> getCustomerSimpleList() { CrmCustomerPageReqVO reqVO = new CrmCustomerPageReqVO(); reqVO.setPageSize(PAGE_SIZE_NONE); // 不分页 List list = customerService.getCustomerPage(reqVO, getLoginUserId()).getList(); return success(convertList(list, customer -> // 只返回 id、name 精简字段 new CrmCustomerRespVO().setId(customer.getId()).setName(customer.getName()))); } @GetMapping("/export-excel") @Operation(summary = "导出客户 Excel") @PreAuthorize("@ss.hasPermission('crm:customer:export')") @ApiAccessLog(operateType = EXPORT) public void exportCustomerExcel(@Valid CrmCustomerPageReqVO pageVO, HttpServletResponse response) throws IOException { pageVO.setPageSize(PAGE_SIZE_NONE); // 不分页 List list = customerService.getCustomerPage(pageVO, getLoginUserId()).getList(); // 导出 Excel ExcelUtils.write(response, "客户.xls", "数据", CrmCustomerRespVO.class, buildCustomerDetailList(list)); } @GetMapping("/get-import-template") @Operation(summary = "获得导入客户模板") public void importTemplate(HttpServletResponse response) throws IOException { // 手动创建导出 demo List list = Arrays.asList( CrmCustomerImportExcelVO.builder().name("芋道").industryId(1).level(1).source(1) .mobile("15601691300").telephone("").qq("").wechat("").email("yunai@iocoder.cn") .areaId(null).detailAddress("").remark("").build(), CrmCustomerImportExcelVO.builder().name("源码").industryId(1).level(1).source(1) .mobile("15601691300").telephone("").qq("").wechat("").email("yunai@iocoder.cn") .areaId(null).detailAddress("").remark("").build() ); // 输出 ExcelUtils.write(response, "客户导入模板.xls", "客户列表", CrmCustomerImportExcelVO.class, list); } @PostMapping("/import") @Operation(summary = "导入客户") @PreAuthorize("@ss.hasPermission('crm:customer:import')") public CommonResult importExcel(@Valid CrmCustomerImportReqVO importReqVO) throws Exception { List list = ExcelUtils.read(importReqVO.getFile(), CrmCustomerImportExcelVO.class); return success(customerService.importCustomerList(list, importReqVO)); } @PutMapping("/transfer") @Operation(summary = "转移客户") @PreAuthorize("@ss.hasPermission('crm:customer:update')") public CommonResult transferCustomer(@Valid @RequestBody CrmCustomerTransferReqVO reqVO) { customerService.transferCustomer(reqVO, getLoginUserId()); return success(true); } @PutMapping("/lock") @Operation(summary = "锁定/解锁客户") @PreAuthorize("@ss.hasPermission('crm:customer:update')") public CommonResult lockCustomer(@Valid @RequestBody CrmCustomerLockReqVO lockReqVO) { customerService.lockCustomer(lockReqVO, getLoginUserId()); return success(true); } // ==================== 公海相关操作 ==================== @PutMapping("/put-pool") @Operation(summary = "数据放入公海") @Parameter(name = "id", description = "客户编号", required = true, example = "1024") @PreAuthorize("@ss.hasPermission('crm:customer:update')") public CommonResult putCustomerPool(@RequestParam("id") Long id) { customerService.putCustomerPool(id); return success(true); } @PutMapping("/receive") @Operation(summary = "领取公海客户") @Parameter(name = "ids", description = "编号数组", required = true, example = "1,2,3") @PreAuthorize("@ss.hasPermission('crm:customer:receive')") public CommonResult receiveCustomer(@RequestParam(value = "ids") List ids) { customerService.receiveCustomer(ids, getLoginUserId(), Boolean.TRUE); return success(true); } @PutMapping("/distribute") @Operation(summary = "分配公海给对应负责人") @PreAuthorize("@ss.hasPermission('crm:customer:distribute')") public CommonResult distributeCustomer(@Valid @RequestBody CrmCustomerDistributeReqVO distributeReqVO) { customerService.receiveCustomer(distributeReqVO.getIds(), distributeReqVO.getOwnerUserId(), Boolean.FALSE); return success(true); } }