|
|
@@ -1,316 +0,0 @@
|
|
|
-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<Long> createCustomer(@Valid @RequestBody CrmCustomerSaveReqVO createReqVO) {
|
|
|
- return success(customerService.createCustomer(createReqVO, getLoginUserId()));
|
|
|
- }
|
|
|
-
|
|
|
- @PutMapping("/update")
|
|
|
- @Operation(summary = "更新客户")
|
|
|
- @PreAuthorize("@ss.hasPermission('crm:customer:update')")
|
|
|
- public CommonResult<Boolean> 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<Boolean> 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<Boolean> 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<CrmCustomerRespVO> 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<PageResult<CrmCustomerRespVO>> getCustomerPage(@Valid CrmCustomerPageReqVO pageVO) {
|
|
|
- // 1. 查询客户分页
|
|
|
- PageResult<CrmCustomerDO> 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<CrmCustomerRespVO> buildCustomerDetailList(List<CrmCustomerDO> list) {
|
|
|
- if (CollUtil.isEmpty(list)) {
|
|
|
- return java.util.Collections.emptyList();
|
|
|
- }
|
|
|
- // 1.1 获取创建人、负责人列表
|
|
|
- Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(convertSetByFlatMap(list,
|
|
|
- contact -> Stream.of(NumberUtils.parseLong(contact.getCreator()), contact.getOwnerUserId())));
|
|
|
- Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(convertSet(userMap.values(), AdminUserRespDTO::getDeptId));
|
|
|
- // 1.2 获取距离进入公海的时间
|
|
|
- Map<Long, Long> 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<PageResult<CrmCustomerRespVO>> getPutPoolRemindCustomerPage(@Valid CrmCustomerPageReqVO pageVO) {
|
|
|
- // 1. 查询客户分页
|
|
|
- PageResult<CrmCustomerDO> 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<Long> getPutPoolRemindCustomerCount() {
|
|
|
- return success(customerService.getPutPoolRemindCustomerCount(getLoginUserId()));
|
|
|
- }
|
|
|
-
|
|
|
- @GetMapping("/today-contact-count")
|
|
|
- @Operation(summary = "获得今日需联系客户数量")
|
|
|
- @PreAuthorize("@ss.hasPermission('crm:customer:query')")
|
|
|
- public CommonResult<Long> getTodayContactCustomerCount() {
|
|
|
- return success(customerService.getTodayContactCustomerCount(getLoginUserId()));
|
|
|
- }
|
|
|
-
|
|
|
- @GetMapping("/follow-count")
|
|
|
- @Operation(summary = "获得分配给我、待跟进的线索数量的客户数量")
|
|
|
- @PreAuthorize("@ss.hasPermission('crm:customer:query')")
|
|
|
- public CommonResult<Long> getFollowCustomerCount() {
|
|
|
- return success(customerService.getFollowCustomerCount(getLoginUserId()));
|
|
|
- }
|
|
|
-
|
|
|
- /**
|
|
|
- * 获取距离进入公海的时间 Map
|
|
|
- *
|
|
|
- * @param list 客户列表
|
|
|
- * @return key 客户编号, value 距离进入公海的时间
|
|
|
- */
|
|
|
- private Map<Long, Long> getPoolDayMap(List<CrmCustomerDO> 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<List<CrmCustomerRespVO>> getCustomerSimpleList() {
|
|
|
- CrmCustomerPageReqVO reqVO = new CrmCustomerPageReqVO();
|
|
|
- reqVO.setPageSize(PAGE_SIZE_NONE); // 不分页
|
|
|
- List<CrmCustomerDO> 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<CrmCustomerDO> 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<CrmCustomerImportExcelVO> 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<CrmCustomerImportRespVO> importExcel(@Valid CrmCustomerImportReqVO importReqVO)
|
|
|
- throws Exception {
|
|
|
- List<CrmCustomerImportExcelVO> 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<Boolean> transferCustomer(@Valid @RequestBody CrmCustomerTransferReqVO reqVO) {
|
|
|
- customerService.transferCustomer(reqVO, getLoginUserId());
|
|
|
- return success(true);
|
|
|
- }
|
|
|
-
|
|
|
- @PutMapping("/lock")
|
|
|
- @Operation(summary = "锁定/解锁客户")
|
|
|
- @PreAuthorize("@ss.hasPermission('crm:customer:update')")
|
|
|
- public CommonResult<Boolean> 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<Boolean> 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<Boolean> receiveCustomer(@RequestParam(value = "ids") List<Long> ids) {
|
|
|
- customerService.receiveCustomer(ids, getLoginUserId(), Boolean.TRUE);
|
|
|
- return success(true);
|
|
|
- }
|
|
|
-
|
|
|
- @PutMapping("/distribute")
|
|
|
- @Operation(summary = "分配公海给对应负责人")
|
|
|
- @PreAuthorize("@ss.hasPermission('crm:customer:distribute')")
|
|
|
- public CommonResult<Boolean> distributeCustomer(@Valid @RequestBody CrmCustomerDistributeReqVO distributeReqVO) {
|
|
|
- customerService.receiveCustomer(distributeReqVO.getIds(), distributeReqVO.getOwnerUserId(), Boolean.FALSE);
|
|
|
- return success(true);
|
|
|
- }
|
|
|
-
|
|
|
-}
|