reactor：移除 crm 的 api 包

YunaiV
1 parent 13da7eba
Showing 303 changed files with 3282 additions and 3347 deletions
yudao-module-crm/pom.xml
yudao-module-crm/yudao-module-crm-api/src/main/java/cn/iocoder/yudao/module/crm/api/package-info.java → yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/api/package-info.java
yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/convert/package-info.java → yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/convert/package-info.java
yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/framework/package-info.java → yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/framework/package-info.java
yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/api/package-info.java → yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/framework/web/package-info.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/job/package-info.java
yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/package-info.java → yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/package-info.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/business/CrmBusinessStatusService.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/clue/CrmClueService.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/contact/CrmContactBusinessService.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/contact/CrmContactService.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/contract/CrmContractConfigServiceImpl.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/contract/listener/CrmContractStatusListener.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/customer/CrmCustomerLimitConfigService.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/customer/CrmCustomerPoolConfigServiceImpl.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/customer/bo/CrmCustomerCreateReqBO.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/followup/CrmFollowUpRecordService.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/followup/bo/CrmFollowUpCreateReqBO.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/permission/CrmPermissionService.java
yudao-module-crm/src/main/java/cn/iocoder/yudao/module/crm/service/permission/bo/CrmPermissionCreateReqBO.java
@@ -7,13 +7,9 @@
         <artifactId>yudao</artifactId>
         <version>${revision}</version>
     </parent>
-    <modules>
-        <module>yudao-module-crm-api</module>
-        <module>yudao-module-crm-biz</module>
-    </modules>
     <modelVersion>4.0.0</modelVersion>
     <artifactId>yudao-module-crm</artifactId>
-    <packaging>pom</packaging>
+    <packaging>jar</packaging>
  
     <name>${project.artifactId}</name>
     <description>
@@ -21,4 +17,60 @@
         例如说：客户、联系人、商机、合同、回款等等
     </description>
  
+    <dependencies>
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-module-system</artifactId>
+            <version>${revision}</version>
+        </dependency>
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-module-infra</artifactId>
+            <version>${revision}</version>
+        </dependency>
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-module-bpm</artifactId>
+            <version>${revision}</version>
+        </dependency>
+
+        <!-- 业务组件 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-biz-ip</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-biz-tenant</artifactId>
+        </dependency>
+
+        <!-- Web 相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-web</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-security</artifactId>
+        </dependency>
+
+        <!-- DB 相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-mybatis</artifactId>
+        </dependency>
+
+        <!-- 工具类相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-excel</artifactId>
+        </dependency>
+
+        <!-- Test 测试相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-test</artifactId>
+        </dependency>
+    </dependencies>
 </project>
 /**
- * crm API 包，定义暴露给其它模块的 API
+ * crm API 包，定义并实现提供给其它模块的 API
  */
 package cn.iocoder.yudao.module.crm.api;
-package cn.iocoder.yudao.module.crm.controller.admin.statistics;
-
-import cn.iocoder.yudao.framework.common.pojo.CommonResult;
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO;
-import cn.iocoder.yudao.module.crm.service.statistics.CrmStatisticsPerformanceService;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import org.springframework.security.access.prepost.PreAuthorize;
-import org.springframework.validation.annotation.Validated;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
-
-import jakarta.annotation.Resource;
-import jakarta.validation.Valid;
-import java.util.List;
-
-import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
-
-
-@Tag(name = "管理后台 - CRM 员工业绩统计")
-@RestController
-@RequestMapping("/crm/statistics-performance")
-@Validated
-public class CrmStatisticsPerformanceController {
-
-    @Resource
-    private CrmStatisticsPerformanceService performanceService;
-
-    @GetMapping("/get-contract-count-performance")
-    @Operation(summary = "合同数量统计", description = "用于【合同数量分析】页面")
-    @PreAuthorize("@ss.hasPermission('crm:statistics-performance:query')")
-    public CommonResult<List<CrmStatisticsPerformanceRespVO>> getContractCountPerformance(@Valid CrmStatisticsPerformanceReqVO performanceReqVO) {
-        return success(performanceService.getContractCountPerformance(performanceReqVO));
-    }
-
-    @GetMapping("/get-contract-price-performance")
-    @Operation(summary = "合同金额统计")
-    @PreAuthorize("@ss.hasPermission('crm:statistics-performance:query')")
-    public CommonResult<List<CrmStatisticsPerformanceRespVO>> getContractPriceStaffPerformance(@Valid CrmStatisticsPerformanceReqVO performanceReqVO) {
-        return success(performanceService.getContractPricePerformance(performanceReqVO));
-    }
-
-    @GetMapping("/get-receivable-price-performance")
-    @Operation(summary = "回款金额统计")
-    @PreAuthorize("@ss.hasPermission('crm:statistics-performance:query')")
-    public CommonResult<List<CrmStatisticsPerformanceRespVO>> getReceivablePriceStaffPerformance(@Valid CrmStatisticsPerformanceReqVO performanceReqVO) {
-        return success(performanceService.getReceivablePricePerformance(performanceReqVO));
-    }
-
-}
+package cn.iocoder.yudao.module.crm.controller.admin.statistics;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO;
+import cn.iocoder.yudao.module.crm.service.statistics.CrmStatisticsPerformanceService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+
+@Tag(name = "管理后台 - CRM 员工业绩统计")
+@RestController
+@RequestMapping("/crm/statistics-performance")
+@Validated
+public class CrmStatisticsPerformanceController {
+
+    @Resource
+    private CrmStatisticsPerformanceService performanceService;
+
+    @GetMapping("/get-contract-count-performance")
+    @Operation(summary = "合同数量统计", description = "用于【合同数量分析】页面")
+    @PreAuthorize("@ss.hasPermission('crm:statistics-performance:query')")
+    public CommonResult<List<CrmStatisticsPerformanceRespVO>> getContractCountPerformance(@Valid CrmStatisticsPerformanceReqVO performanceReqVO) {
+        return success(performanceService.getContractCountPerformance(performanceReqVO));
+    }
+
+    @GetMapping("/get-contract-price-performance")
+    @Operation(summary = "合同金额统计")
+    @PreAuthorize("@ss.hasPermission('crm:statistics-performance:query')")
+    public CommonResult<List<CrmStatisticsPerformanceRespVO>> getContractPriceStaffPerformance(@Valid CrmStatisticsPerformanceReqVO performanceReqVO) {
+        return success(performanceService.getContractPricePerformance(performanceReqVO));
+    }
+
+    @GetMapping("/get-receivable-price-performance")
+    @Operation(summary = "回款金额统计")
+    @PreAuthorize("@ss.hasPermission('crm:statistics-performance:query')")
+    public CommonResult<List<CrmStatisticsPerformanceRespVO>> getReceivablePriceStaffPerformance(@Valid CrmStatisticsPerformanceReqVO performanceReqVO) {
+        return success(performanceService.getReceivablePricePerformance(performanceReqVO));
+    }
+
+}
-package cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance;
-
-import io.swagger.v3.oas.annotations.media.Schema;
-import lombok.Data;
-import org.springframework.format.annotation.DateTimeFormat;
-
-import jakarta.validation.constraints.NotEmpty;
-import jakarta.validation.constraints.NotNull;
-import java.time.LocalDateTime;
-import java.util.List;
-
-import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
-
-@Schema(description = "管理后台 - CRM 员工业绩统计 Request VO")
-@Data
-public class CrmStatisticsPerformanceReqVO {
-
-    @Schema(description = "部门 id", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
-    @NotNull(message = "部门 id 不能为空")
-    private Long deptId;
-
-    /**
-     * 负责人用户 id, 当用户为空, 则计算部门下用户
-     */
-    @Schema(description = "负责人用户 id", requiredMode = Schema.RequiredMode.NOT_REQUIRED, example = "1")
-    private Long userId;
-
-    /**
-     * userIds 目前不用前端传递，目前是方便后端通过 deptId 读取编号后，设置回来
-     * <p>
-     * 后续，可能会支持选择部分用户进行查询
-     */
-    @Schema(description = "负责人用户 id 集合", requiredMode = Schema.RequiredMode.NOT_REQUIRED, example = "2")
-    private List<Long> userIds;
-
-    @Schema(description = "时间范围", requiredMode = Schema.RequiredMode.REQUIRED)
-    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
-    @NotEmpty(message = "时间范围不能为空")
-    private LocalDateTime[] times;
-
-}
+package cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - CRM 员工业绩统计 Request VO")
+@Data
+public class CrmStatisticsPerformanceReqVO {
+
+    @Schema(description = "部门 id", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "部门 id 不能为空")
+    private Long deptId;
+
+    /**
+     * 负责人用户 id, 当用户为空, 则计算部门下用户
+     */
+    @Schema(description = "负责人用户 id", requiredMode = Schema.RequiredMode.NOT_REQUIRED, example = "1")
+    private Long userId;
+
+    /**
+     * userIds 目前不用前端传递，目前是方便后端通过 deptId 读取编号后，设置回来
+     * <p>
+     * 后续，可能会支持选择部分用户进行查询
+     */
+    @Schema(description = "负责人用户 id 集合", requiredMode = Schema.RequiredMode.NOT_REQUIRED, example = "2")
+    private List<Long> userIds;
+
+    @Schema(description = "时间范围", requiredMode = Schema.RequiredMode.REQUIRED)
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    @NotEmpty(message = "时间范围不能为空")
+    private LocalDateTime[] times;
+
+}
-package cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance;
-
-import io.swagger.v3.oas.annotations.media.Schema;
-import lombok.Data;
-import java.math.BigDecimal;
-
-
-@Schema(description = "管理后台 - CRM 员工业绩统计 Response VO")
-@Data
-public class CrmStatisticsPerformanceRespVO {
-
-    @Schema(description = "时间轴", requiredMode = Schema.RequiredMode.REQUIRED, example = "202401")
-    private String time;
-
-    @Schema(description = "当月统计结果", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
-    private BigDecimal currentMonthCount;
-
-    @Schema(description = "上月统计结果", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
-    private BigDecimal lastMonthCount;
-
-    @Schema(description = "去年同期统计结果", requiredMode = Schema.RequiredMode.REQUIRED, example = "3")
-    private BigDecimal lastYearCount;
-
-}
+package cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import java.math.BigDecimal;
+
+
+@Schema(description = "管理后台 - CRM 员工业绩统计 Response VO")
+@Data
+public class CrmStatisticsPerformanceRespVO {
+
+    @Schema(description = "时间轴", requiredMode = Schema.RequiredMode.REQUIRED, example = "202401")
+    private String time;
+
+    @Schema(description = "当月统计结果", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private BigDecimal currentMonthCount;
+
+    @Schema(description = "上月统计结果", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    private BigDecimal lastMonthCount;
+
+    @Schema(description = "去年同期统计结果", requiredMode = Schema.RequiredMode.REQUIRED, example = "3")
+    private BigDecimal lastYearCount;
+
+}
-package cn.iocoder.yudao.module.crm.dal.mysql.statistics;
-
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO;
-import org.apache.ibatis.annotations.Mapper;
-
-import java.util.List;
-
-/**
- * CRM 员工业绩分析 Mapper
- *
- * @author scholar
- */
-@Mapper
-public interface CrmStatisticsPerformanceMapper {
-
-    /**
-     * 员工签约合同数量
-     *
-     * @param performanceReqVO 参数
-     * @return 员工签约合同数量
-     */
-    List<CrmStatisticsPerformanceRespVO> selectContractCountPerformance(CrmStatisticsPerformanceReqVO performanceReqVO);
-
-    /**
-     * 员工签约合同金额
-     *
-     * @param performanceReqVO 参数
-     * @return 员工签约合同金额
-     */
-    List<CrmStatisticsPerformanceRespVO> selectContractPricePerformance(CrmStatisticsPerformanceReqVO performanceReqVO);
-
-    /**
-     * 员工回款金额
-     *
-     * @param performanceReqVO 参数
-     * @return 员工回款金额
-     */
-    List<CrmStatisticsPerformanceRespVO> selectReceivablePricePerformance(CrmStatisticsPerformanceReqVO performanceReqVO);
-
-}
+package cn.iocoder.yudao.module.crm.dal.mysql.statistics;
+
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * CRM 员工业绩分析 Mapper
+ *
+ * @author scholar
+ */
+@Mapper
+public interface CrmStatisticsPerformanceMapper {
+
+    /**
+     * 员工签约合同数量
+     *
+     * @param performanceReqVO 参数
+     * @return 员工签约合同数量
+     */
+    List<CrmStatisticsPerformanceRespVO> selectContractCountPerformance(CrmStatisticsPerformanceReqVO performanceReqVO);
+
+    /**
+     * 员工签约合同金额
+     *
+     * @param performanceReqVO 参数
+     * @return 员工签约合同金额
+     */
+    List<CrmStatisticsPerformanceRespVO> selectContractPricePerformance(CrmStatisticsPerformanceReqVO performanceReqVO);
+
+    /**
+     * 员工回款金额
+     *
+     * @param performanceReqVO 参数
+     * @return 员工回款金额
+     */
+    List<CrmStatisticsPerformanceRespVO> selectReceivablePricePerformance(CrmStatisticsPerformanceReqVO performanceReqVO);
+
+}
 /**
- * crm API 实现类，定义暴露给其它模块的 API
+ * crm 模块的 web 拓展封装
  */
-package cn.iocoder.yudao.module.crm.api;
+package cn.iocoder.yudao.module.crm.framework.web;
+/**
+ * 定时任务
+ */
+package cn.iocoder.yudao.module.crm.job;
 \ No newline at end of file
+package cn.iocoder.yudao.module.crm.service.business;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.crm.controller.admin.business.vo.status.CrmBusinessStatusSaveReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.business.CrmBusinessStatusDO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.business.CrmBusinessStatusTypeDO;
+import jakarta.validation.Valid;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * 商机状态 Service 接口
+ *
+ * @author ljlleo
+ */
+public interface CrmBusinessStatusService {
+
+    /**
+     * 创建商机状态
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createBusinessStatus(@Valid CrmBusinessStatusSaveReqVO createReqVO);
+
+    /**
+     * 更新商机状态
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateBusinessStatus(@Valid CrmBusinessStatusSaveReqVO updateReqVO);
+
+    /**
+     * 删除商机状态
+     *
+     * @param id 编号
+     */
+    void deleteBusinessStatusType(Long id);
+
+    /**
+     * 获得商机状态组
+     *
+     * @param id 编号
+     * @return 商机状态组
+     */
+    CrmBusinessStatusTypeDO getBusinessStatusType(Long id);
+
+    /**
+     * 校验商机状态组
+     *
+     * @param id 编号
+     */
+    void validateBusinessStatusType(Long id);
+
+    /**
+     * 获得商机状态组列表
+     *
+     * @return 商机状态组列表
+     */
+    List<CrmBusinessStatusTypeDO> getBusinessStatusTypeList();
+
+    /**
+     * 获得商机状态组分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 商机状态组分页
+     */
+    PageResult<CrmBusinessStatusTypeDO> getBusinessStatusTypePage(PageParam pageReqVO);
+
+    /**
+     * 获得商机状态组列表
+     *
+     * @param ids 编号数组
+     * @return 商机状态组列表
+     */
+    List<CrmBusinessStatusTypeDO> getBusinessStatusTypeList(Collection<Long> ids);
+
+    /**
+     * 获得商机状态组 Map
+     *
+     * @param ids 编号数组
+     * @return 商机状态组 Map
+     */
+    default Map<Long, CrmBusinessStatusTypeDO> getBusinessStatusTypeMap(Collection<Long> ids) {
+        return convertMap(getBusinessStatusTypeList(ids), CrmBusinessStatusTypeDO::getId);
+    }
+
+    /**
+     * 获得指定类型的商机状态列表
+     *
+     * @param typeId 商机状态组编号
+     * @return 商机状态列表
+     */
+    List<CrmBusinessStatusDO> getBusinessStatusListByTypeId(Long typeId);
+
+    /**
+     * 获得商机状态列表
+     *
+     * @param ids 编号数组
+     * @return 商机状态列表
+     */
+    List<CrmBusinessStatusDO> getBusinessStatusList(Collection<Long> ids);
+
+    /**
+     * 获得商机状态 Map
+     *
+     * @param ids 编号数组
+     * @return 商机状态 Map
+     */
+    default Map<Long, CrmBusinessStatusDO> getBusinessStatusMap(Collection<Long> ids) {
+        return convertMap(getBusinessStatusList(ids), CrmBusinessStatusDO::getId);
+    }
+
+    /**
+     * 获得商机状态
+     *
+     * @param id 编号
+     * @return 商机状态
+     */
+    CrmBusinessStatusDO getBusinessStatus(Long id);
+
+    /**
+     * 校验商机状态
+     *
+     * @param statusTypeId 商机状态组编号
+     * @param statusId     商机状态编号
+     */
+    CrmBusinessStatusDO validateBusinessStatus(Long statusTypeId, Long statusId);
+
+}
+package cn.iocoder.yudao.module.crm.service.clue;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.crm.controller.admin.clue.vo.CrmCluePageReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.clue.vo.CrmClueSaveReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.clue.vo.CrmClueTransferReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.clue.CrmClueDO;
+import jakarta.validation.Valid;
+
+import java.time.LocalDateTime;
+
+/**
+ * 线索 Service 接口
+ *
+ * @author Wanwan
+ */
+public interface CrmClueService {
+
+    /**
+     * 创建线索
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createClue(@Valid CrmClueSaveReqVO createReqVO);
+
+    /**
+     * 更新线索
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateClue(@Valid CrmClueSaveReqVO updateReqVO);
+
+    /**
+     * 更新线索相关的跟进信息
+     *
+     * @param id 编号
+     * @param contactNextTime 下次联系时间
+     * @param contactLastContent 最后联系内容
+     */
+    void updateClueFollowUp(Long id, LocalDateTime contactNextTime, String contactLastContent);
+
+    /**
+     * 删除线索
+     *
+     * @param id 编号
+     */
+    void deleteClue(Long id);
+
+    /**
+     * 获得线索
+     *
+     * @param id 编号
+     * @return 线索
+     */
+    CrmClueDO getClue(Long id);
+
+    /**
+     * 获得线索分页
+     *
+     * @param pageReqVO 分页查询
+     * @param userId    用户编号
+     * @return 线索分页
+     */
+    PageResult<CrmClueDO> getCluePage(CrmCluePageReqVO pageReqVO, Long userId);
+
+    /**
+     * 线索转移
+     *
+     * @param reqVO  请求
+     * @param userId 用户编号
+     */
+    void transferClue(CrmClueTransferReqVO reqVO, Long userId);
+
+    /**
+     * 线索转化为客户
+     *
+     * @param id  线索编号
+     * @param userId 用户编号
+     */
+    void transformClue(Long id, Long userId);
+
+    /**
+     * 获得分配给我的、待跟进的线索数量
+     *
+     * @param userId 用户编号
+     * @return 数量
+     */
+    Long getFollowClueCount(Long userId);
+
+}
+package cn.iocoder.yudao.module.crm.service.contact;
+
+import cn.iocoder.yudao.module.crm.controller.admin.contact.vo.CrmContactBusiness2ReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.contact.vo.CrmContactBusinessReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.contact.CrmContactBusinessDO;
+import jakarta.validation.Valid;
+
+import java.util.List;
+
+/**
+ * CRM 联系人与商机的关联 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface CrmContactBusinessService {
+
+    /**
+     * 创建联系人与商机的关联【通过联系人，关联商机】
+     *
+     * @param createReqVO 创建信息
+     */
+    void createContactBusinessList(@Valid CrmContactBusinessReqVO createReqVO);
+
+    /**
+     * 创建联系人与商机的关联【通过商机，关联联系人】
+     *
+     * @param createReqVO 创建信息
+     */
+    void createContactBusinessList2(@Valid CrmContactBusiness2ReqVO createReqVO);
+
+    /**
+     * 删除联系人与商机的关联【通过联系人，取关商机】
+     *
+     * @param deleteReqVO 删除信息
+     */
+    void deleteContactBusinessList(@Valid CrmContactBusinessReqVO deleteReqVO);
+
+    /**
+     * 删除联系人与商机的关联【通过商机，取关联系人】
+     *
+     * @param deleteReqVO 删除信息
+     */
+    void deleteContactBusinessList2(@Valid CrmContactBusiness2ReqVO deleteReqVO);
+
+    /**
+     * 删除联系人与商机的关联，基于联系人编号
+     *
+     * @param contactId 联系人编号
+     */
+    void deleteContactBusinessByContactId(Long contactId);
+
+    /**
+     * 获得联系人与商机的关联列表，基于联系人编号
+     *
+     * @param contactId 联系人编号
+     * @return 联系人商机关联
+     */
+    List<CrmContactBusinessDO> getContactBusinessListByContactId(Long contactId);
+
+    /**
+     * 获得联系人与商机的关联列表，基于商机编号
+     *
+     * @param businessId 商机编号
+     * @return 联系人商机关联
+     */
+    List<CrmContactBusinessDO> getContactBusinessListByBusinessId(Long businessId);
+
+}
 \ No newline at end of file
+package cn.iocoder.yudao.module.crm.service.contact;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.crm.controller.admin.contact.vo.CrmContactPageReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.contact.vo.CrmContactSaveReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.contact.vo.CrmContactTransferReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.business.CrmBusinessDO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.contact.CrmContactDO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerDO;
+import jakarta.validation.Valid;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * CRM 联系人 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface CrmContactService {
+
+    /**
+     * 创建联系人
+     *
+     * @param createReqVO 创建信息
+     * @param userId      用户编号
+     * @return 编号
+     */
+    Long createContact(@Valid CrmContactSaveReqVO createReqVO, Long userId);
+
+    /**
+     * 更新联系人
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateContact(@Valid CrmContactSaveReqVO updateReqVO);
+
+    /**
+     * 删除联系人
+     *
+     * @param id 编号
+     */
+    void deleteContact(Long id);
+
+    /**
+     * 联系人转移
+     *
+     * @param reqVO  请求
+     * @param userId 用户编号
+     */
+    void transferContact(CrmContactTransferReqVO reqVO, Long userId);
+
+    /**
+     * 更新指定客户的联系人的负责人
+     * 数据权限基于 【客户】
+     *
+     * @param customerId  客户编号
+     * @param ownerUserId 用户编号
+     */
+    void updateOwnerUserIdByCustomerId(Long customerId, Long ownerUserId);
+
+    /**
+     * 更新联系人相关跟进信息
+     *
+     * @param id                 编号
+     * @param contactNextTime    下次联系时间
+     * @param contactLastContent 最后联系内容
+     */
+    void updateContactFollowUp(Long id, LocalDateTime contactNextTime, String contactLastContent);
+
+    /**
+     * 更新联系人的下次联系时间
+     *
+     * @param ids             编号数组
+     * @param contactNextTime 下次联系时间
+     */
+    void updateContactContactNextTime(Collection<Long> ids, LocalDateTime contactNextTime);
+
+    /**
+     * 获得联系人
+     *
+     * @param id 编号
+     * @return 联系人
+     */
+    CrmContactDO getContact(Long id);
+
+    /**
+     * 校验联系人
+     *
+     * @param id 编号
+     */
+    void validateContact(Long id);
+
+    /**
+     * 获得联系人列表
+     *
+     * @param ids 编号
+     * @return 联系人列表
+     */
+    List<CrmContactDO> getContactList(Collection<Long> ids);
+
+    /**
+     * 获得联系人 Map
+     *
+     * @param ids 编号
+     * @return 联系人 Map
+     */
+    default Map<Long, CrmContactDO> getContactMap(Collection<Long> ids) {
+        return convertMap(getContactList(ids), CrmContactDO::getId);
+    }
+
+    /**
+     * 获取联系人列表（校验权限）
+     *
+     * @param userId 用户编号
+     * @return 联系人列表
+     */
+    List<CrmContactDO> getContactList(Long userId);
+
+    /**
+     * 获得联系人分页
+     *
+     * 数据权限：基于 {@link CrmContactDO}
+     *
+     * @param pageReqVO 分页查询
+     * @param userId    用户编号
+     * @return 联系人分页
+     */
+    PageResult<CrmContactDO> getContactPage(CrmContactPageReqVO pageReqVO, Long userId);
+
+    /**
+     * 获得联系人分页
+     *
+     * 数据权限：基于 {@link CrmCustomerDO}
+     *
+     * @param pageVO 分页查询
+     * @return 联系人分页
+     */
+    PageResult<CrmContactDO> getContactPageByCustomerId(CrmContactPageReqVO pageVO);
+
+    /**
+     * 获得联系人分页
+     *
+     * 数据权限：基于 {@link CrmBusinessDO}
+     *
+     * @param pageVO 分页查询
+     * @return 联系人分页
+     */
+    PageResult<CrmContactDO> getContactPageByBusinessId(CrmContactPageReqVO pageVO);
+
+    /**
+     * 获取关联客户的联系人数量
+     *
+     * @param customerId 客户编号
+     * @return 数量
+     */
+    Long getContactCountByCustomerId(Long customerId);
+
+    /**
+     * 获得联系人列表
+     *
+     * @param customerId  客户编号
+     * @param ownerUserId 负责人编号
+     * @return 联系人列表
+     */
+    List<CrmContactDO> getContactListByCustomerIdOwnerUserId(Long customerId, Long ownerUserId);
+
+}
+package cn.iocoder.yudao.module.crm.service.contract;
+
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.crm.controller.admin.contract.vo.config.CrmContractConfigSaveReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.contract.CrmContractConfigDO;
+import cn.iocoder.yudao.module.crm.dal.mysql.contract.CrmContractConfigMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Objects;
+
+import static cn.iocoder.yudao.module.crm.enums.LogRecordConstants.*;
+
+/**
+ * 合同配置 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class CrmContractConfigServiceImpl implements CrmContractConfigService {
+
+    @Resource
+    private CrmContractConfigMapper contractConfigMapper;
+
+    @Override
+    public CrmContractConfigDO getContractConfig() {
+        return contractConfigMapper.selectOne();
+    }
+
+    @Override
+    @LogRecord(type = CRM_CONTRACT_CONFIG_TYPE, subType = CRM_CONTRACT_CONFIG_SUB_TYPE, bizNo = "{{#configId}}",
+            success = CRM_CONTRACT_CONFIG_SUCCESS)
+    public void saveContractConfig(CrmContractConfigSaveReqVO saveReqVO) {
+        // 1. 存在，则进行更新
+        CrmContractConfigDO dbConfig = getContractConfig();
+        CrmContractConfigDO config = BeanUtils.toBean(saveReqVO, CrmContractConfigDO.class);
+        if (Objects.nonNull(dbConfig)) {
+            contractConfigMapper.updateById(config.setId(dbConfig.getId()));
+            // 记录操作日志上下文
+            LogRecordContext.putVariable("isConfigUpdate", Boolean.TRUE);
+            LogRecordContext.putVariable("configId", config.getId());
+            return;
+        }
+
+        // 2. 不存在，则进行插入
+        contractConfigMapper.insert(config);
+        // 记录操作日志上下文
+        LogRecordContext.putVariable("isConfigUpdate", Boolean.FALSE);
+        LogRecordContext.putVariable("configId", config.getId());
+    }
+
+}
+package cn.iocoder.yudao.module.crm.service.contract.listener;
+
+import cn.iocoder.yudao.module.bpm.api.event.BpmProcessInstanceStatusEvent;
+import cn.iocoder.yudao.module.bpm.api.event.BpmProcessInstanceStatusEventListener;
+import cn.iocoder.yudao.module.crm.service.contract.CrmContractService;
+import cn.iocoder.yudao.module.crm.service.contract.CrmContractServiceImpl;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Component;
+
+/**
+ * 合同审批的结果的监听器实现类
+ *
+ * @author HUIHUI
+ */
+@Component
+public class CrmContractStatusListener extends BpmProcessInstanceStatusEventListener {
+
+    @Resource
+    private CrmContractService contractService;
+
+    @Override
+    public String getProcessDefinitionKey() {
+        return CrmContractServiceImpl.BPM_PROCESS_DEFINITION_KEY;
+    }
+
+    @Override
+    protected void onEvent(BpmProcessInstanceStatusEvent event) {
+        contractService.updateContractAuditStatus(Long.parseLong(event.getBusinessKey()), event.getStatus());
+    }
+
+}
+package cn.iocoder.yudao.module.crm.service.customer;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.crm.controller.admin.customer.vo.limitconfig.CrmCustomerLimitConfigPageReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.customer.vo.limitconfig.CrmCustomerLimitConfigSaveReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerLimitConfigDO;
+import jakarta.validation.Valid;
+
+import java.util.List;
+
+/**
+ * 客户限制配置 Service 接口
+ *
+ * @author Wanwan
+ */
+public interface CrmCustomerLimitConfigService {
+
+    /**
+     * 创建客户限制配置
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createCustomerLimitConfig(@Valid CrmCustomerLimitConfigSaveReqVO createReqVO);
+
+    /**
+     * 更新客户限制配置
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateCustomerLimitConfig(@Valid CrmCustomerLimitConfigSaveReqVO updateReqVO);
+
+    /**
+     * 删除客户限制配置
+     *
+     * @param id 编号
+     */
+    void deleteCustomerLimitConfig(Long id);
+
+    /**
+     * 获得客户限制配置
+     *
+     * @param id 编号
+     * @return 客户限制配置
+     */
+    CrmCustomerLimitConfigDO getCustomerLimitConfig(Long id);
+
+    /**
+     * 获得客户限制配置分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 客户限制配置分页
+     */
+    PageResult<CrmCustomerLimitConfigDO> getCustomerLimitConfigPage(CrmCustomerLimitConfigPageReqVO pageReqVO);
+
+    /**
+     * 查询用户对应的配置列表
+     *
+     * @param type   类型
+     * @param userId 用户类型
+     */
+    List<CrmCustomerLimitConfigDO> getCustomerLimitConfigListByUserId(Integer type, Long userId);
+
+}
+package cn.iocoder.yudao.module.crm.service.customer;
+
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.crm.controller.admin.customer.vo.poolconfig.CrmCustomerPoolConfigSaveReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerPoolConfigDO;
+import cn.iocoder.yudao.module.crm.dal.mysql.customer.CrmCustomerPoolConfigMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Objects;
+
+import static cn.iocoder.yudao.module.crm.enums.LogRecordConstants.*;
+
+/**
+ * 客户公海配置 Service 实现类
+ *
+ * @author Wanwan
+ */
+@Service
+@Validated
+public class CrmCustomerPoolConfigServiceImpl implements CrmCustomerPoolConfigService {
+
+    @Resource
+    private CrmCustomerPoolConfigMapper customerPoolConfigMapper;
+
+    @Override
+    public CrmCustomerPoolConfigDO getCustomerPoolConfig() {
+        return customerPoolConfigMapper.selectOne();
+    }
+
+    @Override
+    @LogRecord(type = CRM_CUSTOMER_POOL_CONFIG_TYPE, subType = CRM_CUSTOMER_POOL_CONFIG_SUB_TYPE, bizNo = "{{#poolConfigId}}",
+            success = CRM_CUSTOMER_POOL_CONFIG_SUCCESS)
+    public void saveCustomerPoolConfig(CrmCustomerPoolConfigSaveReqVO saveReqVO) {
+        // 1. 存在，则进行更新
+        CrmCustomerPoolConfigDO dbConfig = getCustomerPoolConfig();
+        CrmCustomerPoolConfigDO poolConfig = BeanUtils.toBean(saveReqVO, CrmCustomerPoolConfigDO.class);
+        if (Objects.nonNull(dbConfig)) {
+            customerPoolConfigMapper.updateById(poolConfig.setId(dbConfig.getId()));
+            // 记录操作日志上下文
+            LogRecordContext.putVariable("isPoolConfigUpdate", Boolean.TRUE);
+            LogRecordContext.putVariable("poolConfigId", poolConfig.getId());
+            return;
+        }
+
+        // 2. 不存在，则进行插入
+        customerPoolConfigMapper.insert(poolConfig);
+        // 记录操作日志上下文
+        LogRecordContext.putVariable("isPoolConfigUpdate", Boolean.FALSE);
+        LogRecordContext.putVariable("poolConfigId", poolConfig.getId());
+    }
+
+}
-package cn.iocoder.yudao.module.crm.service.contact;
+package cn.iocoder.yudao.module.crm.service.customer;
  
 import cn.iocoder.yudao.framework.common.pojo.PageResult;
-import cn.iocoder.yudao.module.crm.controller.admin.contact.vo.CrmContactPageReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.contact.vo.CrmContactSaveReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.contact.vo.CrmContactTransferReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.business.CrmBusinessDO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.contact.CrmContactDO;
+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.service.customer.bo.CrmCustomerCreateReqBO;
 import jakarta.validation.Valid;
  
 import java.time.LocalDateTime;
@@ -17,156 +14,185 @@ import java.util.Map;
 import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
  
 /**
- * CRM 联系人 Service 接口
+ * 客户 Service 接口
  *
- * @author 芋道源码
+ * @author Wanwan
  */
-public interface CrmContactService {
+public interface CrmCustomerService {
  
     /**
-     * 创建联系人
+     * 创建客户
      *
      * @param createReqVO 创建信息
      * @param userId      用户编号
      * @return 编号
      */
-    Long createContact(@Valid CrmContactSaveReqVO createReqVO, Long userId);
+    Long createCustomer(@Valid CrmCustomerSaveReqVO createReqVO, Long userId);
  
     /**
-     * 更新联系人
+     * 更新客户
      *
      * @param updateReqVO 更新信息
      */
-    void updateContact(@Valid CrmContactSaveReqVO updateReqVO);
+    void updateCustomer(@Valid CrmCustomerSaveReqVO updateReqVO);
  
     /**
-     * 删除联系人
+     * 更新客户的跟进状态
      *
-     * @param id 编号
+     * @param id         编号
+     * @param dealStatus 跟进状态
      */
-    void deleteContact(Long id);
+    void updateCustomerDealStatus(Long id, Boolean dealStatus);
  
     /**
-     * 联系人转移
+     * 更新客户相关的跟进信息
      *
-     * @param reqVO  请求
-     * @param userId 用户编号
+     * @param id                 编号
+     * @param contactNextTime    下次联系时间
+     * @param contactLastContent 最后联系内容
      */
-    void transferContact(CrmContactTransferReqVO reqVO, Long userId);
+    void updateCustomerFollowUp(Long id, LocalDateTime contactNextTime, String contactLastContent);
  
     /**
-     * 更新指定客户的联系人的负责人
-     * 数据权限基于 【客户】
+     * 删除客户
      *
-     * @param customerId  客户编号
-     * @param ownerUserId 用户编号
+     * @param id 编号
      */
-    void updateOwnerUserIdByCustomerId(Long customerId, Long ownerUserId);
+    void deleteCustomer(Long id);
  
     /**
-     * 更新联系人相关跟进信息
+     * 获得客户
      *
-     * @param id                 编号
-     * @param contactNextTime    下次联系时间
-     * @param contactLastContent 最后联系内容
+     * @param id 编号
+     * @return 客户
      */
-    void updateContactFollowUp(Long id, LocalDateTime contactNextTime, String contactLastContent);
+    CrmCustomerDO getCustomer(Long id);
  
     /**
-     * 更新联系人的下次联系时间
+     * 获得客户列表
      *
-     * @param ids             编号数组
-     * @param contactNextTime 下次联系时间
+     * @param ids 客户编号数组
+     * @return 客户列表
+     * @author ljlleo
      */
-    void updateContactContactNextTime(Collection<Long> ids, LocalDateTime contactNextTime);
+    List<CrmCustomerDO> getCustomerList(Collection<Long> ids);
  
     /**
-     * 获得联系人
+     * 获得客户 Map
      *
-     * @param id 编号
-     * @return 联系人
+     * @param ids 客户编号数组
+     * @return 客户 Map
      */
-    CrmContactDO getContact(Long id);
+    default Map<Long, CrmCustomerDO> getCustomerMap(Collection<Long> ids) {
+        return convertMap(getCustomerList(ids), CrmCustomerDO::getId);
+    }
  
     /**
-     * 校验联系人
+     * 获得客户分页
      *
-     * @param id 编号
+     * @param pageReqVO 分页查询
+     * @param userId    用户编号
+     * @return 客户分页
      */
-    void validateContact(Long id);
+    PageResult<CrmCustomerDO> getCustomerPage(CrmCustomerPageReqVO pageReqVO, Long userId);
  
     /**
-     * 获得联系人列表
+     * 获得放入公海提醒的客户分页
      *
-     * @param ids 编号
-     * @return 联系人列表
+     * @param pageVO 分页查询
+     * @param userId 用户编号
+     * @return 客户分页
      */
-    List<CrmContactDO> getContactList(Collection<Long> ids);
+    PageResult<CrmCustomerDO> getPutPoolRemindCustomerPage(CrmCustomerPageReqVO pageVO, Long userId);
  
     /**
-     * 获得联系人 Map
+     * 获得待进入公海的客户数量
      *
-     * @param ids 编号
-     * @return 联系人 Map
+     * @param userId 用户编号
+     * @return 提醒数量
      */
-    default Map<Long, CrmContactDO> getContactMap(Collection<Long> ids) {
-        return convertMap(getContactList(ids), CrmContactDO::getId);
-    }
+    Long getPutPoolRemindCustomerCount(Long userId);
  
     /**
-     * 获取联系人列表（校验权限）
+     * 获得今日需联系客户数量
      *
      * @param userId 用户编号
-     * @return 联系人列表
+     * @return 提醒数量
      */
-    List<CrmContactDO> getContactList(Long userId);
+    Long getTodayContactCustomerCount(Long userId);
  
     /**
-     * 获得联系人分页
+     * 获得分配给我的客户数量
      *
-     * 数据权限：基于 {@link CrmContactDO}
+     * @param userId 用户编号
+     * @return 提醒数量
+     */
+    Long getFollowCustomerCount(Long userId);
+
+    /**
+     * 校验客户是否存在
      *
-     * @param pageReqVO 分页查询
-     * @param userId    用户编号
-     * @return 联系人分页
+     * @param id 编号
      */
-    PageResult<CrmContactDO> getContactPage(CrmContactPageReqVO pageReqVO, Long userId);
+    void validateCustomer(Long id);
  
     /**
-     * 获得联系人分页
+     * 客户转移
      *
-     * 数据权限：基于 {@link CrmCustomerDO}
+     * @param reqVO  请求
+     * @param userId 用户编号
+     */
+    void transferCustomer(CrmCustomerTransferReqVO reqVO, Long userId);
+
+    /**
+     * 锁定/解锁客户
      *
-     * @param pageVO 分页查询
-     * @return 联系人分页
+     * @param lockReqVO 更新信息
+     * @param userId    用户编号
      */
-    PageResult<CrmContactDO> getContactPageByCustomerId(CrmContactPageReqVO pageVO);
+    void lockCustomer(@Valid CrmCustomerLockReqVO lockReqVO, Long userId);
  
     /**
-     * 获得联系人分页
+     * 创建客户
      *
-     * 数据权限：基于 {@link CrmBusinessDO}
+     * @param customerCreateReq 请求信息
+     * @param userId            用户编号
+     * @return 客户列表
+     */
+    Long createCustomer(CrmCustomerCreateReqBO customerCreateReq, Long userId);
+
+    /**
+     * 批量导入客户
      *
-     * @param pageVO 分页查询
-     * @return 联系人分页
+     * @param importCustomers 导入客户列表
+     * @param importReqVO     请求
+     * @return 导入结果
+     */
+    CrmCustomerImportRespVO importCustomerList(List<CrmCustomerImportExcelVO> importCustomers, CrmCustomerImportReqVO importReqVO);
+
+    // ==================== 公海相关操作 ====================
+
+    /**
+     * 客户放入公海
+     *
+     * @param id 客户编号
      */
-    PageResult<CrmContactDO> getContactPageByBusinessId(CrmContactPageReqVO pageVO);
+    void putCustomerPool(Long id);
  
     /**
-     * 获取关联客户的联系人数量
+     * 领取公海客户
      *
-     * @param customerId 客户编号
-     * @return 数量
+     * @param ids         要领取的客户编号数组
+     * @param ownerUserId 负责人
+     * @param isReceive   是/否领取；true - 领取；false - 分配
      */
-    Long getContactCountByCustomerId(Long customerId);
+    void receiveCustomer(List<Long> ids, Long ownerUserId, Boolean isReceive);
  
     /**
-     * 获得联系人列表
+     * 【系统】客户自动掉入公海
      *
-     * @param customerId  客户编号
-     * @param ownerUserId 负责人编号
-     * @return 联系人列表
+     * @return 掉入公海数量
      */
-    List<CrmContactDO> getContactListByCustomerIdOwnerUserId(Long customerId, Long ownerUserId);
+    int autoPutCustomerPool();
  
 }
+package cn.iocoder.yudao.module.crm.service.customer.bo;
+
+import cn.iocoder.yudao.framework.common.validation.Mobile;
+import cn.iocoder.yudao.framework.common.validation.Telephone;
+import cn.iocoder.yudao.module.crm.enums.DictTypeConstants;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+/**
+ * 客户创建 Create Req BO
+ *
+ * @author HUIHUI
+ */
+@Data
+public class CrmCustomerCreateReqBO {
+
+    /**
+     * 客户名称
+     */
+    @NotEmpty(message = "客户名称不能为空")
+    private String name;
+    /**
+     * 跟进状态
+     */
+    private Boolean followUpStatus;
+    /**
+     * 锁定状态
+     */
+    private Boolean lockStatus;
+    /**
+     * 成交状态
+     */
+    private Boolean dealStatus;
+    /**
+     * 所属行业
+     *
+     * 对应字典 {@link DictTypeConstants#CRM_CUSTOMER_INDUSTRY}
+     */
+    private Integer industryId;
+    /**
+     * 客户等级
+     *
+     * 对应字典 {@link DictTypeConstants#CRM_CUSTOMER_LEVEL}
+     */
+    private Integer level;
+    /**
+     * 客户来源
+     *
+     * 对应字典 {@link DictTypeConstants#CRM_CUSTOMER_SOURCE}
+     */
+    private Integer source;
+
+    /**
+     * 手机
+     */
+    @Mobile
+    private String mobile;
+    /**
+     * 电话
+     */
+    @Telephone
+    private String telephone;
+    /**
+     * QQ
+     */
+    private String qq;
+    /**
+     * wechat
+     */
+    private String wechat;
+
+    /**
+     * 邮箱
+     */
+    @Email(message = "邮箱格式不正确")
+    private String email;
+
+    /**
+     * 客户描述
+     */
+    @Size(max = 4096, message = "客户描述长度不能超过 4096 个字符")
+    private String description;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 负责人的用户编号
+     *
+     * 关联 AdminUserDO 的 id 字段
+     */
+    private Long ownerUserId;
+    /**
+     * 所在地
+     *
+     * 关联 {@link cn.iocoder.yudao.framework.ip.core.Area#getId()} 字段
+     */
+    private Integer areaId;
+    /**
+     * 详细地址
+     */
+    private String detailAddress;
+
+    /**
+     * 最后跟进时间
+     */
+    private LocalDateTime contactLastTime;
+    /**
+     * 最后跟进内容
+     */
+    private String contactLastContent;
+    /**
+     * 下次联系时间
+     */
+    private LocalDateTime contactNextTime;
+
+}
+package cn.iocoder.yudao.module.crm.service.followup;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.crm.controller.admin.followup.vo.CrmFollowUpRecordPageReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.followup.vo.CrmFollowUpRecordSaveReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.followup.CrmFollowUpRecordDO;
+import cn.iocoder.yudao.module.crm.service.followup.bo.CrmFollowUpCreateReqBO;
+import jakarta.validation.Valid;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * 跟进记录 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface CrmFollowUpRecordService {
+
+    /**
+     * 创建跟进记录 (数据权限基于 bizType、 bizId)
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createFollowUpRecord(@Valid CrmFollowUpRecordSaveReqVO createReqVO);
+
+    /**
+     * 创建更进
+     *
+     * @param list 请求
+     */
+    void createFollowUpRecordBatch(List<CrmFollowUpCreateReqBO> list);
+
+    /**
+     * 删除跟进记录 (数据权限基于 bizType、 bizId)
+     *
+     * @param id     编号
+     * @param userId 用户编号
+     */
+    void deleteFollowUpRecord(Long id, Long userId);
+
+    /**
+     * 删除跟进
+     *
+     * @param bizType 模块类型
+     * @param bizId   模块数据编号
+     */
+    void deleteFollowUpRecordByBiz(Integer bizType, Long bizId);
+
+    /**
+     * 获得跟进记录
+     *
+     * @param id 编号
+     * @return 跟进记录
+     */
+    CrmFollowUpRecordDO getFollowUpRecord(Long id);
+
+    /**
+     * 获得跟进记录分页 (数据权限基于 bizType、 bizId)
+     *
+     * @param pageReqVO 分页查询
+     * @return 跟进记录分页
+     */
+    PageResult<CrmFollowUpRecordDO> getFollowUpRecordPage(CrmFollowUpRecordPageReqVO pageReqVO);
+
+    /**
+     * 获取跟进记录
+     *
+     * @param bizType 模块类型
+     * @param bizIds  模块数据编号
+     * @return 跟进列表
+     */
+    List<CrmFollowUpRecordDO> getFollowUpRecordByBiz(Integer bizType, Collection<Long> bizIds);
+
+}
 \ No newline at end of file
+package cn.iocoder.yudao.module.crm.service.followup.bo;
+
+import cn.iocoder.yudao.module.crm.dal.dataobject.business.CrmBusinessDO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.contact.CrmContactDO;
+import cn.iocoder.yudao.module.crm.enums.DictTypeConstants;
+import cn.iocoder.yudao.module.crm.enums.common.CrmBizTypeEnum;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * 跟进信息 Create Req BO
+ *
+ * @author HUIHUI
+ */
+@Data
+public class CrmFollowUpCreateReqBO {
+
+    /**
+     * 数据类型
+     *
+     * 枚举 {@link CrmBizTypeEnum}
+     */
+    @NotNull(message = "数据类型不能为空")
+    private Integer bizType;
+    /**
+     * 数据编号
+     *
+     * 关联 {@link CrmBizTypeEnum} 对应模块 DO 的 id 字段
+     */
+    @NotNull(message = "数据编号不能为空")
+    private Long bizId;
+
+    /**
+     * 跟进类型
+     *
+     * 关联 {@link DictTypeConstants#CRM_FOLLOW_UP_TYPE} 字典
+     */
+    @NotNull(message = "跟进类型不能为空")
+    private Integer type;
+    /**
+     * 跟进内容
+     */
+    @NotEmpty(message = "跟进内容不能为空")
+    private String content;
+    /**
+     * 下次联系时间
+     */
+    @NotNull(message = "下次联系时间不能为空")
+    private LocalDateTime nextTime;
+
+    /**
+     * 图片
+     */
+    private List<String> picUrls;
+    /**
+     * 附件
+     */
+    private List<String> fileUrls;
+
+    /**
+     * 关联的商机编号数组
+     *
+     * 关联 {@link CrmBusinessDO#getId()}
+     */
+    private List<Long> businessIds;
+
+    /**
+     * 关联的联系人编号数组
+     *
+     * 关联 {@link CrmContactDO#getId()}
+     */
+    private List<Long> contactIds;
+
+}
+package cn.iocoder.yudao.module.crm.service.permission;
+
+
+import cn.iocoder.yudao.module.crm.controller.admin.permission.vo.CrmPermissionSaveReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.permission.vo.CrmPermissionUpdateReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.permission.CrmPermissionDO;
+import cn.iocoder.yudao.module.crm.enums.common.CrmBizTypeEnum;
+import cn.iocoder.yudao.module.crm.enums.permission.CrmPermissionLevelEnum;
+import cn.iocoder.yudao.module.crm.service.permission.bo.CrmPermissionCreateReqBO;
+import cn.iocoder.yudao.module.crm.service.permission.bo.CrmPermissionTransferReqBO;
+import jakarta.validation.Valid;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * crm 数据权限 Service 接口
+ *
+ * @author HUIHUI
+ */
+public interface CrmPermissionService {
+
+    /**
+     * 创建数据权限
+     *
+     * @param reqVO  创建信息
+     * @param userId 用户编号
+     */
+    void createPermission(CrmPermissionSaveReqVO reqVO, Long userId);
+
+    /**
+     * 创建数据权限
+     *
+     * @param createReqBO 创建信息
+     * @return 编号
+     */
+    Long createPermission(@Valid CrmPermissionCreateReqBO createReqBO);
+
+    /**
+     * 创建数据权限
+     *
+     * @param createReqBOs 创建信息
+     */
+    void createPermissionBatch(@Valid List<CrmPermissionCreateReqBO> createReqBOs);
+
+    /**
+     * 更新数据权限
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updatePermission(CrmPermissionUpdateReqVO updateReqVO);
+
+    /**
+     * 数据权限转移
+     *
+     * @param crmPermissionTransferReqBO 数据权限转移请求
+     */
+    void transferPermission(@Valid CrmPermissionTransferReqBO crmPermissionTransferReqBO);
+
+    /**
+     * 删除数据权限
+     *
+     * @param bizType 数据类型，关联 {@link CrmBizTypeEnum}
+     * @param bizId   数据编号，关联 {@link CrmBizTypeEnum} 对应模块 DO#getId()
+     * @param level   数据权限级别，关联 {@link CrmPermissionLevelEnum}
+     */
+    void deletePermission(Integer bizType, Long bizId, Integer level);
+
+    /**
+     * 删除数据权限
+     *
+     * @param bizType 数据类型，关联 {@link CrmBizTypeEnum}
+     * @param bizId   数据编号，关联 {@link CrmBizTypeEnum} 对应模块 DO#getId()
+     */
+    void deletePermission(Integer bizType, Long bizId);
+
+    /**
+     * 批量删除数据权限
+     *
+     * @param ids    权限编号
+     * @param userId 用户编号
+     */
+    void deletePermissionBatch(Collection<Long> ids, Long userId);
+
+    /**
+     * 删除指定用户数据权限
+     *
+     * @param id     权限编号
+     * @param userId 用户编号
+     */
+    void deleteSelfPermission(Long id, Long userId);
+
+    /**
+     * 获取数据权限列表，通过 数据类型 x 某个数据
+     *
+     * @param bizType 数据类型，关联 {@link CrmBizTypeEnum}
+     * @param bizId   数据编号，关联 {@link CrmBizTypeEnum} 对应模块 DO#getId()
+     * @return Crm 数据权限列表
+     */
+    List<CrmPermissionDO> getPermissionListByBiz(Integer bizType, Long bizId);
+
+    /**
+     * 获取数据权限列表，通过 数据类型 x 某个数据
+     *
+     * @param bizType 数据类型，关联 {@link CrmBizTypeEnum}
+     * @param bizIds  数据编号，关联 {@link CrmBizTypeEnum} 对应模块 DO#getId()
+     * @return Crm 数据权限列表
+     */
+    List<CrmPermissionDO> getPermissionListByBiz(Integer bizType, Collection<Long> bizIds);
+
+    /**
+     * 获取用户参与的模块数据列表
+     *
+     * @param bizType 模块类型
+     * @param userId  用户编号
+     * @return 模块数据列表
+     */
+    List<CrmPermissionDO> getPermissionListByBizTypeAndUserId(Integer bizType, Long userId);
+
+    /**
+     * 校验是否有指定数据的操作权限
+     *
+     * @param bizType 数据类型，关联 {@link CrmBizTypeEnum}
+     * @param bizId   数据编号，关联 {@link CrmBizTypeEnum} 对应模块 DO#getId()
+     * @param userId  用户编号
+     * @param level   权限级别
+     * @return 是否有权限
+     */
+    boolean hasPermission(Integer bizType, Long bizId, Long userId, CrmPermissionLevelEnum level);
+
+}
+package cn.iocoder.yudao.module.crm.service.permission.bo;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.crm.enums.common.CrmBizTypeEnum;
+import cn.iocoder.yudao.module.crm.enums.permission.CrmPermissionLevelEnum;
+import lombok.Data;
+
+import jakarta.validation.constraints.NotNull;
+
+/**
+ * crm 数据权限 Create Req BO
+ *
+ * @author HUIHUI
+ */
+@Data
+public class CrmPermissionCreateReqBO {
+
+    /**
+     * 当前登录用户编号
+     */
+    @NotNull(message = "用户编号不能为空")
+    private Long userId;
+
+    /**
+     * Crm 类型
+     */
+    @NotNull(message = "Crm 类型不能为空")
+    @InEnum(CrmBizTypeEnum.class)
+    private Integer bizType;
+    /**
+     * 数据编号
+     */
+    @NotNull(message = "Crm 数据编号不能为空")
+    private Long bizId;
+
+    /**
+     * 权限级别
+     */
+    @NotNull(message = "权限级别不能为空")
+    @InEnum(CrmPermissionLevelEnum.class)
+    private Integer level;
+
+}
+package cn.iocoder.yudao.module.crm.service.permission.bo;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.crm.enums.common.CrmBizTypeEnum;
+import cn.iocoder.yudao.module.crm.enums.permission.CrmPermissionLevelEnum;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+import jakarta.validation.constraints.NotNull;
+import lombok.NoArgsConstructor;
+
+/**
+ * 数据权限转移 Request BO
+ *
+ * @author HUIHUI
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class CrmPermissionTransferReqBO {
+
+    /**
+     * 当前登录用户编号
+     */
+    @NotNull(message = "用户编号不能为空")
+    private Long userId;
+
+    /**
+     * CRM 类型
+     */
+    @NotNull(message = "Crm 类型不能为空")
+    @InEnum(CrmBizTypeEnum.class)
+    private Integer bizType;
+    /**
+     * 数据编号
+     */
+    @NotNull(message = "CRM 数据编号不能为空")
+    private Long bizId;
+
+    /**
+     * 新负责人的用户编号
+     */
+    @NotNull(message = "新负责人的用户编号不能为空")
+    private Long newOwnerUserId;
+
+    /**
+     * 老负责人加入团队后的权限级别。如果 null 说明移除
+     *
+     * 关联 {@link CrmPermissionLevelEnum}
+     */
+    private Integer oldOwnerPermissionLevel;
+
+}
+package cn.iocoder.yudao.module.crm.service.product;
+
+import cn.iocoder.yudao.module.crm.controller.admin.product.vo.category.CrmProductCategoryCreateReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.product.vo.category.CrmProductCategoryListReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.product.CrmProductCategoryDO;
+import jakarta.validation.Valid;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * CRM 产品分类 Service 接口
+ *
+ * @author ZanGe丶
+ */
+public interface CrmProductCategoryService {
+
+    /**
+     * 创建产品分类
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createProductCategory(@Valid CrmProductCategoryCreateReqVO createReqVO);
+
+    /**
+     * 更新产品分类
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateProductCategory(@Valid CrmProductCategoryCreateReqVO updateReqVO);
+
+    /**
+     * 删除产品分类
+     *
+     * @param id 编号
+     */
+    void deleteProductCategory(Long id);
+
+    /**
+     * 获得产品分类
+     *
+     * @param id 编号
+     * @return 产品分类
+     */
+    CrmProductCategoryDO getProductCategory(Long id);
+
+    /**
+     * 获得产品分类列表
+     *
+     * @param listReqVO 列表请求
+     * @return 产品分类列表
+     */
+    List<CrmProductCategoryDO> getProductCategoryList(CrmProductCategoryListReqVO listReqVO);
+
+    /**
+     * 获得产品分类列表
+     *
+     * @param ids 编号数组
+     * @return 产品分类列表
+     */
+    List<CrmProductCategoryDO> getProductCategoryList(Collection<Long> ids);
+
+    /**
+     * 获得产品分类 Map
+     *
+     * @param ids 编号数组
+     * @return 产品分类 Map
+     */
+    default Map<Long, CrmProductCategoryDO> getProductCategoryMap(Collection<Long> ids) {
+        return convertMap(getProductCategoryList(ids), CrmProductCategoryDO::getId);
+    }
+
+}
+package cn.iocoder.yudao.module.crm.service.product;
+
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.crm.controller.admin.product.vo.category.CrmProductCategoryCreateReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.product.vo.category.CrmProductCategoryListReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.product.CrmProductCategoryDO;
+import cn.iocoder.yudao.module.crm.dal.mysql.product.CrmProductCategoryMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Objects;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.crm.dal.dataobject.product.CrmProductCategoryDO.PARENT_ID_NULL;
+import static cn.iocoder.yudao.module.crm.enums.ErrorCodeConstants.*;
+import static cn.iocoder.yudao.module.crm.enums.LogRecordConstants.*;
+
+/**
+ * CRM 产品分类 Service 实现类
+ *
+ * @author ZanGe丶
+ */
+@Service
+@Validated
+public class CrmProductCategoryServiceImpl implements CrmProductCategoryService {
+
+    @Resource(name = "crmProductCategoryMapper")
+    private CrmProductCategoryMapper productCategoryMapper;
+
+    @Resource
+    @Lazy // 延迟加载，解决循环依赖问题
+    private CrmProductService crmProductService;
+
+    @Override
+    @LogRecord(type = CRM_PRODUCT_CATEGORY_TYPE, subType = CRM_PRODUCT_CATEGORY_CREATE_SUB_TYPE, bizNo = "{{#productCategoryId}}",
+            success = CRM_PRODUCT_CATEGORY_CREATE_SUCCESS)
+    public Long createProductCategory(CrmProductCategoryCreateReqVO createReqVO) {
+        // 1.1 校验父分类存在
+        validateParentProductCategory(createReqVO.getParentId());
+        // 1.2 分类名称是否存在
+        validateProductNameExists(null, createReqVO.getParentId(), createReqVO.getName());
+
+        // 2. 插入分类
+        CrmProductCategoryDO category = BeanUtils.toBean(createReqVO, CrmProductCategoryDO.class);
+        productCategoryMapper.insert(category);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("productCategoryId", category.getId());
+        return category.getId();
+    }
+
+    @Override
+    @LogRecord(type = CRM_PRODUCT_CATEGORY_TYPE, subType = CRM_PRODUCT_CATEGORY_UPDATE_SUB_TYPE, bizNo = "{{#updateReqVO.id}}",
+            success = CRM_PRODUCT_CATEGORY_UPDATE_SUCCESS)
+    public void updateProductCategory(CrmProductCategoryCreateReqVO updateReqVO) {
+        // 1.1 校验存在
+        validateProductCategoryExists(updateReqVO.getId());
+        // 1.2 校验父分类存在
+        validateParentProductCategory(updateReqVO.getParentId());
+        // 1.3 分类名称是否存在
+        validateProductNameExists(updateReqVO.getId(), updateReqVO.getParentId(), updateReqVO.getName());
+
+        // 2. 更新分类
+        CrmProductCategoryDO updateObj = BeanUtils.toBean(updateReqVO, CrmProductCategoryDO.class);
+        productCategoryMapper.updateById(updateObj);
+    }
+
+    private void validateProductCategoryExists(Long id) {
+        if (productCategoryMapper.selectById(id) == null) {
+            throw exception(PRODUCT_CATEGORY_NOT_EXISTS);
+        }
+    }
+
+    private void validateParentProductCategory(Long id) {
+        // 如果是根分类，无需验证
+        if (Objects.equals(id, PARENT_ID_NULL)) {
+            return;
+        }
+        // 父分类不存在
+        CrmProductCategoryDO category = productCategoryMapper.selectById(id);
+        if (category == null) {
+            throw exception(PRODUCT_CATEGORY_PARENT_NOT_EXISTS);
+        }
+        // 父分类不能是二级分类
+        if (!Objects.equals(category.getParentId(), PARENT_ID_NULL)) {
+            throw exception(PRODUCT_CATEGORY_PARENT_NOT_FIRST_LEVEL);
+        }
+    }
+
+    private void validateProductNameExists(Long id, Long parentId, String name) {
+        CrmProductCategoryDO category = productCategoryMapper.selectByParentIdAndName(parentId, name);
+        if (category == null
+            || category.getId().equals(id)) {
+            return;
+        }
+        throw exception(PRODUCT_CATEGORY_EXISTS);
+    }
+
+    @Override
+    @LogRecord(type = CRM_PRODUCT_CATEGORY_TYPE, subType = CRM_PRODUCT_CATEGORY_DELETE_SUB_TYPE, bizNo = "{{#id}}",
+            success = CRM_PRODUCT_CATEGORY_DELETE_SUCCESS)
+    public void deleteProductCategory(Long id) {
+        // 1.1 校验存在
+        validateProductCategoryExists(id);
+        // 1.2 校验是否还有子分类
+        if (productCategoryMapper.selectCountByParentId(id) > 0) {
+            throw exception(PRODUCT_CATEGORY_EXISTS_CHILDREN);
+        }
+        // 1.3 校验是否被产品使用
+        if (crmProductService.getProductByCategoryId(id) > 0) {
+            throw exception(PRODUCT_CATEGORY_USED);
+        }
+        // 2. 删除
+        productCategoryMapper.deleteById(id);
+    }
+
+    @Override
+    public CrmProductCategoryDO getProductCategory(Long id) {
+        return productCategoryMapper.selectById(id);
+    }
+
+    @Override
+    public List<CrmProductCategoryDO> getProductCategoryList(CrmProductCategoryListReqVO listReqVO) {
+        return productCategoryMapper.selectList(listReqVO);
+    }
+
+    @Override
+    public List<CrmProductCategoryDO> getProductCategoryList(Collection<Long> ids) {
+        return productCategoryMapper.selectBatchIds(ids);
+    }
+
+}
+package cn.iocoder.yudao.module.crm.service.product;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.crm.controller.admin.product.vo.product.CrmProductPageReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.product.vo.product.CrmProductSaveReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.product.CrmProductDO;
+import jakarta.validation.Valid;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * CRM 产品 Service 接口
+ *
+ * @author ZanGe丶
+ */
+public interface CrmProductService {
+
+    /**
+     * 创建产品
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createProduct(@Valid CrmProductSaveReqVO createReqVO);
+
+    /**
+     * 更新产品
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateProduct(@Valid CrmProductSaveReqVO updateReqVO);
+
+    /**
+     * 删除产品
+     *
+     * @param id 编号
+     */
+    void deleteProduct(Long id);
+
+    /**
+     * 获得产品
+     *
+     * @param id 编号
+     * @return 产品
+     */
+    CrmProductDO getProduct(Long id);
+
+    /**
+     * 获得产品列表
+     *
+     * @param ids 编号
+     * @return 产品列表
+     */
+    List<CrmProductDO> getProductList(Collection<Long> ids);
+
+    /**
+     * 获得产品 Map
+     *
+     * @param ids 编号
+     * @return 产品 Map
+     */
+    default Map<Long, CrmProductDO> getProductMap(Collection<Long> ids) {
+        return convertMap(getProductList(ids), CrmProductDO::getId);
+    }
+
+    /**
+     * 获得产品分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 产品分页
+     */
+    PageResult<CrmProductDO> getProductPage(CrmProductPageReqVO pageReqVO);
+
+    /**
+     * 获得产品数量
+     *
+     * @param categoryId 分类编号
+     * @return 产品
+     */
+    Long getProductByCategoryId(Long categoryId);
+
+    /**
+     * 获得指定状态的产品列表
+     *
+     * @param status 状态
+     * @return 产品列表
+     */
+    List<CrmProductDO> getProductListByStatus(Integer status);
+
+    /**
+     * 校验产品们的有效性
+     *
+     * @param ids 编号数组
+     * @return 产品列表
+     */
+    List<CrmProductDO> validProductList(Collection<Long> ids);
+
+}
+package cn.iocoder.yudao.module.crm.service.receivable;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.crm.controller.admin.receivable.vo.plan.CrmReceivablePlanPageReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.receivable.vo.plan.CrmReceivablePlanSaveReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerDO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.receivable.CrmReceivablePlanDO;
+import jakarta.validation.Valid;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * CRM 回款计划 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface CrmReceivablePlanService {
+
+    /**
+     * 创建回款计划
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createReceivablePlan(@Valid CrmReceivablePlanSaveReqVO createReqVO);
+
+    /**
+     * 更新回款计划
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateReceivablePlan(@Valid CrmReceivablePlanSaveReqVO updateReqVO);
+
+    /**
+     * 更新回款计划关联的回款编号
+     *
+     * @param id           编号
+     * @param receivableId 回款编号
+     */
+    void updateReceivablePlanReceivableId(Long id, Long receivableId);
+
+    /**
+     * 删除回款计划
+     *
+     * @param id 编号
+     */
+    void deleteReceivablePlan(Long id);
+
+    /**
+     * 获得回款计划
+     *
+     * @param id 编号
+     * @return 回款计划
+     */
+    CrmReceivablePlanDO getReceivablePlan(Long id);
+
+    /**
+     * 获得回款计划列表
+     *
+     * @param ids 编号
+     * @return 回款计划列表
+     */
+    List<CrmReceivablePlanDO> getReceivablePlanList(Collection<Long> ids);
+
+    /**
+     * 获得回款计划分页
+     *
+     * 数据权限：基于 {@link CrmReceivablePlanDO} 读取
+     *
+     * @param pageReqVO 分页查询
+     * @param userId    用户编号
+     * @return 回款计划分页
+     */
+    PageResult<CrmReceivablePlanDO> getReceivablePlanPage(CrmReceivablePlanPageReqVO pageReqVO, Long userId);
+
+    /**
+     * 获得回款计划分页，基于指定客户
+     *
+     * 数据权限：基于 {@link CrmCustomerDO} 读取
+     *
+     * @param pageReqVO 分页查询
+     * @return 回款计划分页
+     */
+    PageResult<CrmReceivablePlanDO> getReceivablePlanPageByCustomerId(CrmReceivablePlanPageReqVO pageReqVO);
+
+    /**
+     * 获得待回款提醒数量
+     *
+     * @param userId 用户编号
+     * @return 提醒数量
+     */
+    Long getReceivablePlanRemindCount(Long userId);
+
+}
+package cn.iocoder.yudao.module.crm.service.receivable;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.crm.controller.admin.receivable.vo.receivable.CrmReceivablePageReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.receivable.vo.receivable.CrmReceivableSaveReqVO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerDO;
+import cn.iocoder.yudao.module.crm.dal.dataobject.receivable.CrmReceivableDO;
+import jakarta.validation.Valid;
+
+import java.math.BigDecimal;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * CRM 回款 Service 接口
+ *
+ * @author 赤焰
+ */
+public interface CrmReceivableService {
+
+    /**
+     * 创建回款
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createReceivable(@Valid CrmReceivableSaveReqVO createReqVO);
+
+    /**
+     * 更新回款
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateReceivable(@Valid CrmReceivableSaveReqVO updateReqVO);
+
+    /**
+     * 更新回款流程审批结果
+     *
+     * @param id        回款编号
+     * @param bpmResult BPM 审批结果
+     */
+    void updateReceivableAuditStatus(Long id, Integer bpmResult);
+
+    /**
+     * 删除回款
+     *
+     * @param id 编号
+     */
+    void deleteReceivable(Long id);
+
+    /**
+     * 发起回款审批流程
+     *
+     * @param id     回款编号
+     * @param userId 用户编号
+     */
+    void submitReceivable(Long id, Long userId);
+
+    /**
+     * 获得回款
+     *
+     * @param id 编号
+     * @return 回款
+     */
+    CrmReceivableDO getReceivable(Long id);
+
+    /**
+     * 获得回款列表
+     *
+     * @param ids 编号
+     * @return 回款列表
+     */
+    List<CrmReceivableDO> getReceivableList(Collection<Long> ids);
+
+    /**
+     * 获得回款 Map
+     *
+     * @param ids 编号
+     * @return 回款 Map
+     */
+    default Map<Long, CrmReceivableDO> getReceivableMap(Collection<Long> ids) {
+        return convertMap(getReceivableList(ids), CrmReceivableDO::getId);
+    }
+
+    /**
+     * 获得回款分页
+     *
+     * 数据权限：基于 {@link CrmReceivableDO} 读取
+     *
+     * @param pageReqVO 分页查询
+     * @param userId    用户编号
+     * @return 回款分页
+     */
+    PageResult<CrmReceivableDO> getReceivablePage(CrmReceivablePageReqVO pageReqVO, Long userId);
+
+    /**
+     * 获得回款分页，基于指定客户
+     *
+     * 数据权限：基于 {@link CrmCustomerDO} 读取
+     *
+     * @param pageReqVO 分页查询
+     * @return 回款分页
+     */
+    PageResult<CrmReceivableDO> getReceivablePageByCustomerId(CrmReceivablePageReqVO pageReqVO);
+
+    /**
+     * 获得待审核回款数量
+     *
+     * @param userId 用户编号
+     * @return 待审批数量
+     */
+    Long getAuditReceivableCount(Long userId);
+
+    /**
+     * 获得合同已回款金额 Map
+     *
+     * @param contractIds 合同编号
+     * @return 回款金额 Map
+     */
+    Map<Long, BigDecimal> getReceivablePriceMapByContractId(Collection<Long> contractIds);
+
+    /**
+     * 根据合同编号查询回款数量
+     *
+     * @param contractId 合同编号
+     * @return 回款数量
+     */
+    Long getReceivableCountByContractId(Long contractId);
+
+}
+package cn.iocoder.yudao.module.crm.service.receivable.listener;
+
+import cn.iocoder.yudao.module.bpm.api.event.BpmProcessInstanceStatusEvent;
+import cn.iocoder.yudao.module.bpm.api.event.BpmProcessInstanceStatusEventListener;
+import cn.iocoder.yudao.module.crm.service.receivable.CrmReceivableService;
+import cn.iocoder.yudao.module.crm.service.receivable.CrmReceivableServiceImpl;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Component;
+
+/**
+ * 回款审批的结果的监听器实现类
+ *
+ * @author HUIHUI
+ */
+@Component
+public class CrmReceivableStatusListener extends BpmProcessInstanceStatusEventListener {
+
+    @Resource
+    private CrmReceivableService receivableService;
+
+    @Override
+    public String getProcessDefinitionKey() {
+        return CrmReceivableServiceImpl.BPM_PROCESS_DEFINITION_KEY;
+    }
+
+    @Override
+    public void onEvent(BpmProcessInstanceStatusEvent event) {
+        receivableService.updateReceivableAuditStatus(Long.parseLong(event.getBusinessKey()), event.getStatus());
+    }
+
+}
+package cn.iocoder.yudao.module.crm.service.statistics;
+
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.customer.*;
+
+import java.util.List;
+
+/**
+ * CRM 客户分析 Service 接口
+ *
+ * @author dhb52
+ */
+public interface CrmStatisticsCustomerService {
+
+    /**
+     * 总量分析(按日期)
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticsCustomerSummaryByDateRespVO> getCustomerSummaryByDate(CrmStatisticsCustomerReqVO reqVO);
+
+    /**
+     * 总量分析(按用户)
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticsCustomerSummaryByUserRespVO> getCustomerSummaryByUser(CrmStatisticsCustomerReqVO reqVO);
+
+    /**
+     * 跟进次数分析(按日期)
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticsFollowUpSummaryByDateRespVO> getFollowUpSummaryByDate(CrmStatisticsCustomerReqVO reqVO);
+
+    /**
+     * 跟进次数分析(按用户)
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticsFollowUpSummaryByUserRespVO> getFollowUpSummaryByUser(CrmStatisticsCustomerReqVO reqVO);
+
+    /**
+     * 客户跟进次数分析(按类型)
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticsFollowUpSummaryByTypeRespVO> getFollowUpSummaryByType(CrmStatisticsCustomerReqVO reqVO);
+
+    /**
+     * 获取客户的首次合同、回款信息列表，用于【客户转化率】页面
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticsCustomerContractSummaryRespVO> getContractSummary(CrmStatisticsCustomerReqVO reqVO);
+
+    /**
+     * 公海客户分析(按日期)
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticsPoolSummaryByDateRespVO> getPoolSummaryByDate(CrmStatisticsCustomerReqVO reqVO);
+
+    /**
+     * 公海客户分析(按用户)
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticsPoolSummaryByUserRespVO> getPoolSummaryByUser(CrmStatisticsCustomerReqVO reqVO);
+
+    /**
+     * 客户成交周期(按日期)
+     *
+     * 成交周期的定义：客户 customer 在创建出来，到合同 contract 第一次成交的时间差
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticsCustomerDealCycleByDateRespVO> getCustomerDealCycleByDate(CrmStatisticsCustomerReqVO reqVO);
+
+    /**
+     * 客户成交周期(按用户)
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticsCustomerDealCycleByUserRespVO> getCustomerDealCycleByUser(CrmStatisticsCustomerReqVO reqVO);
+
+    /**
+     * 客户成交周期(按区域)
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticsCustomerDealCycleByAreaRespVO> getCustomerDealCycleByArea(CrmStatisticsCustomerReqVO reqVO);
+
+    /**
+     * 客户成交周期(按产品)
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticsCustomerDealCycleByProductRespVO> getCustomerDealCycleByProduct(CrmStatisticsCustomerReqVO reqVO);
+
+}
+package cn.iocoder.yudao.module.crm.service.statistics;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.funnel.*;
+import cn.iocoder.yudao.module.crm.dal.dataobject.business.CrmBusinessDO;
+
+import java.util.List;
+
+/**
+ * CRM 销售漏斗分析 Service
+ *
+ * @author HUIHUI
+ */
+public interface CrmStatisticsFunnelService {
+
+    /**
+     * 获得销售漏斗数据
+     *
+     * @param reqVO 请求
+     * @return 销售漏斗数据
+     */
+    CrmStatisticFunnelSummaryRespVO getFunnelSummary(CrmStatisticsFunnelReqVO reqVO);
+
+    /**
+     * 获得商机结束状态统计
+     *
+     * @param reqVO 请求
+     * @return 商机结束状态统计
+     */
+    List<CrmStatisticsBusinessSummaryByEndStatusRespVO> getBusinessSummaryByEndStatus(CrmStatisticsFunnelReqVO reqVO);
+
+    /**
+     * 获取新增商机分析(按日期)
+     *
+     * @param reqVO 请求
+     * @return 新增商机分析
+     */
+    List<CrmStatisticsBusinessSummaryByDateRespVO> getBusinessSummaryByDate(CrmStatisticsFunnelReqVO reqVO);
+
+    /**
+     * 获得商机转化率分析(按日期)
+     *
+     * @param reqVO 请求
+     * @return 商机转化率分析
+     */
+    List<CrmStatisticsBusinessInversionRateSummaryByDateRespVO> getBusinessInversionRateSummaryByDate(CrmStatisticsFunnelReqVO reqVO);
+
+    /**
+     * 获得商机分页(按日期)
+     *
+     * @param pageVO 请求
+     * @return 商机分页
+     */
+    PageResult<CrmBusinessDO> getBusinessPageByDate(CrmStatisticsFunnelReqVO pageVO);
+
+}
+package cn.iocoder.yudao.module.crm.service.statistics;
+
+
+
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO;
+
+import java.util.List;
+
+/**
+ * CRM 员工绩效统计 Service 接口
+ *
+ * @author scholar
+ */
+public interface CrmStatisticsPerformanceService {
+
+    /**
+     * 员工签约合同数量分析
+     *
+     * @param performanceReqVO 排行参数
+     * @return 员工签约合同数量排行分析
+     */
+    List<CrmStatisticsPerformanceRespVO> getContractCountPerformance(CrmStatisticsPerformanceReqVO performanceReqVO);
+
+    /**
+     * 员工签约合同金额分析
+     *
+     * @param performanceReqVO 排行参数
+     * @return 员工签约合同金额分析
+     */
+    List<CrmStatisticsPerformanceRespVO> getContractPricePerformance(CrmStatisticsPerformanceReqVO performanceReqVO);
+
+    /**
+     * 员工获得回款金额分析
+     *
+     * @param performanceReqVO 排行参数
+     * @return 员工获得回款金额分析
+     */
+    List<CrmStatisticsPerformanceRespVO> getReceivablePricePerformance(CrmStatisticsPerformanceReqVO performanceReqVO);
+
+
+}
+package cn.iocoder.yudao.module.crm.service.statistics;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.collection.ListUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO;
+import cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsPerformanceMapper;
+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 jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Function;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * CRM 员工业绩分析 Service 实现类
+ *
+ * @author scholar
+ */
+@Service
+@Validated
+public class CrmStatisticsPerformanceServiceImpl implements CrmStatisticsPerformanceService {
+
+    @Resource
+    private CrmStatisticsPerformanceMapper performanceMapper;
+
+    @Resource
+    private AdminUserApi adminUserApi;
+    @Resource
+    private DeptApi deptApi;
+
+    @Override
+    public List<CrmStatisticsPerformanceRespVO> getContractCountPerformance(CrmStatisticsPerformanceReqVO performanceReqVO) {
+        return getPerformance(performanceReqVO, performanceMapper::selectContractCountPerformance);
+    }
+
+    @Override
+    public List<CrmStatisticsPerformanceRespVO> getContractPricePerformance(CrmStatisticsPerformanceReqVO performanceReqVO) {
+        return getPerformance(performanceReqVO, performanceMapper::selectContractPricePerformance);
+    }
+
+    @Override
+    public List<CrmStatisticsPerformanceRespVO> getReceivablePricePerformance(CrmStatisticsPerformanceReqVO performanceReqVO) {
+        return getPerformance(performanceReqVO, performanceMapper::selectReceivablePricePerformance);
+    }
+
+    /**
+     * 获得员工业绩数据
+     *
+     * 1. 获得今年 + 去年的数据
+     * 2. 遍历今年的月份，逐个拼接去年的月份数据
+     *
+     * @param performanceReqVO  参数
+     * @param performanceFunction 员工业绩统计方法
+     * @return 员工业绩数据
+     */
+    private List<CrmStatisticsPerformanceRespVO> getPerformance(CrmStatisticsPerformanceReqVO performanceReqVO,
+                                                                Function<CrmStatisticsPerformanceReqVO, List<CrmStatisticsPerformanceRespVO>> performanceFunction) {
+
+        // 1. 获得用户编号数组
+        List<Long> userIds = getUserIds(performanceReqVO);
+        if (CollUtil.isEmpty(userIds)) {
+            return Collections.emptyList();
+        }
+        performanceReqVO.setUserIds(userIds);
+
+        // 2. 获得业绩数据
+        int year = performanceReqVO.getTimes()[0].getYear(); // 获取查询的年份
+        performanceReqVO.getTimes()[0] = performanceReqVO.getTimes()[0].minusYears(1);
+        List<CrmStatisticsPerformanceRespVO> performanceList = performanceFunction.apply(performanceReqVO);
+        Map<String, BigDecimal> performanceMap = convertMap(performanceList, CrmStatisticsPerformanceRespVO::getTime,
+                CrmStatisticsPerformanceRespVO::getCurrentMonthCount);
+
+        // 3. 组装数据返回
+        List<CrmStatisticsPerformanceRespVO> result = new ArrayList<>();
+        for (int month = 1; month <= 12; month++) {
+            String currentMonth = String.format("%d%02d", year, month);
+            String lastMonth = month == 1 ? String.format("%d%02d", year - 1, 12) : String.format("%d%02d", year, month - 1);
+            String lastYear = String.format("%d%02d", year - 1, month);
+            result.add(new CrmStatisticsPerformanceRespVO().setTime(currentMonth)
+                    .setCurrentMonthCount(performanceMap.getOrDefault(currentMonth, BigDecimal.ZERO))
+                    .setLastMonthCount(performanceMap.getOrDefault(lastMonth, BigDecimal.ZERO))
+                    .setLastYearCount(performanceMap.getOrDefault(lastYear, BigDecimal.ZERO)));
+        }
+        return result;
+    }
+
+    /**
+     * 获取用户编号数组。如果用户编号为空, 则获得部门下的用户编号数组，包括子部门的所有用户编号
+     *
+     * @param reqVO 请求参数
+     * @return 用户编号数组
+     */
+    private List<Long> getUserIds(CrmStatisticsPerformanceReqVO reqVO) {
+        // 情况一：选中某个用户
+        if (ObjUtil.isNotNull(reqVO.getUserId())) {
+            return ListUtil.of(reqVO.getUserId());
+        }
+        // 情况二：选中某个部门
+        // 2.1 获得部门列表
+        final Long deptId = reqVO.getDeptId();
+        List<Long> deptIds = convertList(deptApi.getChildDeptList(deptId), DeptRespDTO::getId);
+        deptIds.add(deptId);
+        // 2.2 获得用户编号
+        return convertList(adminUserApi.getUserListByDeptIds(deptIds), AdminUserRespDTO::getId);
+    }
+
+}
 \ No newline at end of file
+package cn.iocoder.yudao.module.crm.service.statistics;
+
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.portrait.*;
+
+import java.util.List;
+
+/**
+ * CRM 客户画像 Service 接口
+ *
+ * @author HUIHUI
+ */
+public interface CrmStatisticsPortraitService {
+
+    /**
+     * 获取客户地区统计数据
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticCustomerAreaRespVO> getCustomerSummaryByArea(CrmStatisticsPortraitReqVO reqVO);
+
+    /**
+     * 获取客户行业统计数据
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticCustomerIndustryRespVO> getCustomerSummaryByIndustry(CrmStatisticsPortraitReqVO reqVO);
+
+    /**
+     * 获取客户级别统计数据
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticCustomerLevelRespVO> getCustomerSummaryByLevel(CrmStatisticsPortraitReqVO reqVO);
+
+    /**
+     * 获取客户来源统计数据
+     *
+     * @param reqVO 请求参数
+     * @return 统计数据
+     */
+    List<CrmStatisticCustomerSourceRespVO> getCustomerSummaryBySource(CrmStatisticsPortraitReqVO reqVO);
+
+}
+package cn.iocoder.yudao.module.crm.service.statistics;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.collection.ListUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.ip.core.Area;
+import cn.iocoder.yudao.framework.ip.core.enums.AreaTypeEnum;
+import cn.iocoder.yudao.framework.ip.core.utils.AreaUtils;
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.portrait.*;
+import cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsPortraitMapper;
+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 jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * CRM 客户画像 Service 实现类
+ *
+ * @author HUIHUI
+ */
+@Service
+public class CrmStatisticsPortraitServiceImpl implements CrmStatisticsPortraitService {
+
+    @Resource
+    private CrmStatisticsPortraitMapper portraitMapper;
+
+    @Resource
+    private AdminUserApi adminUserApi;
+    @Resource
+    private DeptApi deptApi;
+
+    @Override
+    public List<CrmStatisticCustomerAreaRespVO> getCustomerSummaryByArea(CrmStatisticsPortraitReqVO reqVO) {
+        // 1. 获得用户编号数组
+        List<Long> userIds = getUserIds(reqVO);
+        if (CollUtil.isEmpty(userIds)) {
+            return Collections.emptyList();
+        }
+        reqVO.setUserIds(userIds);
+
+        // 2. 获取客户地区统计数据
+        List<CrmStatisticCustomerAreaRespVO> list = portraitMapper.selectSummaryListGroupByAreaId(reqVO);
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+
+        // 3. 拼接数据
+        List<Area> areaList = AreaUtils.getByType(AreaTypeEnum.PROVINCE, area -> area);
+        Map<Integer, Area> areaMap = convertMap(areaList, Area::getId);
+        return convertList(list, item -> {
+            Integer parentId = AreaUtils.getParentIdByType(item.getAreaId(), AreaTypeEnum.PROVINCE);
+            if (parentId != null) {
+                Area area = areaMap.get(parentId);
+                if (area != null) {
+                    item.setAreaId(parentId).setAreaName(area.getName());
+                    return item;
+                }
+            }
+            // 找不到，归到未知
+            return item.setAreaId(null).setAreaName("未知");
+        });
+    }
+
+    @Override
+    public List<CrmStatisticCustomerIndustryRespVO> getCustomerSummaryByIndustry(CrmStatisticsPortraitReqVO reqVO) {
+        // 1. 获得用户编号数组
+        List<Long> userIds = getUserIds(reqVO);
+        if (CollUtil.isEmpty(userIds)) {
+            return Collections.emptyList();
+        }
+        reqVO.setUserIds(userIds);
+
+        // 2. 获取客户行业统计数据
+        return portraitMapper.selectCustomerIndustryListGroupByIndustryId(reqVO);
+    }
+
+    @Override
+    public List<CrmStatisticCustomerSourceRespVO> getCustomerSummaryBySource(CrmStatisticsPortraitReqVO reqVO) {
+        // 1. 获得用户编号数组
+        List<Long> userIds = getUserIds(reqVO);
+        if (CollUtil.isEmpty(userIds)) {
+            return Collections.emptyList();
+        }
+        reqVO.setUserIds(userIds);
+
+        // 2. 获取客户行业统计数据
+        return portraitMapper.selectCustomerSourceListGroupBySource(reqVO);
+    }
+
+    @Override
+    public List<CrmStatisticCustomerLevelRespVO> getCustomerSummaryByLevel(CrmStatisticsPortraitReqVO reqVO) {
+        // 1. 获得用户编号数组
+        List<Long> userIds = getUserIds(reqVO);
+        if (CollUtil.isEmpty(userIds)) {
+            return Collections.emptyList();
+        }
+        reqVO.setUserIds(userIds);
+
+        // 2. 获取客户级别统计数据
+        return portraitMapper.selectCustomerLevelListGroupByLevel(reqVO);
+    }
+
+    /**
+     * 获取用户编号数组。如果用户编号为空, 则获得部门下的用户编号数组，包括子部门的所有用户编号
+     *
+     * @param reqVO 请求参数
+     * @return 用户编号数组
+     */
+    private List<Long> getUserIds(CrmStatisticsPortraitReqVO reqVO) {
+        // 情况一：选中某个用户
+        if (ObjUtil.isNotNull(reqVO.getUserId())) {
+            return ListUtil.of(reqVO.getUserId());
+        }
+        // 情况二：选中某个部门
+        // 2.1 获得部门列表
+        List<Long> deptIds = convertList(deptApi.getChildDeptList(reqVO.getDeptId()), DeptRespDTO::getId);
+        deptIds.add(reqVO.getDeptId());
+        // 2.2 获得用户编号
+        return convertList(adminUserApi.getUserListByDeptIds(deptIds), AdminUserRespDTO::getId);
+    }
+
+}
+package cn.iocoder.yudao.module.crm.service.statistics;
+
+
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO;
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankReqVO;
+
+import java.util.List;
+
+/**
+ * CRM 排行榜统计 Service 接口
+ *
+ * @author anhaohao
+ */
+public interface CrmStatisticsRankService {
+
+    /**
+     * 获得合同金额排行榜
+     *
+     * @param rankReqVO 排行参数
+     * @return 合同金额排行榜
+     */
+    List<CrmStatisticsRankRespVO> getContractPriceRank(CrmStatisticsRankReqVO rankReqVO);
+
+    /**
+     * 获得回款金额排行榜
+     *
+     * @param rankReqVO 排行参数
+     * @return 回款金额排行榜
+     */
+    List<CrmStatisticsRankRespVO> getReceivablePriceRank(CrmStatisticsRankReqVO rankReqVO);
+
+    /**
+     * 获得签约合同数量排行榜
+     *
+     * @param rankReqVO 排行参数
+     * @return 签约合同数量排行榜
+     */
+    List<CrmStatisticsRankRespVO> getContractCountRank(CrmStatisticsRankReqVO rankReqVO);
+
+    /**
+     * 获得产品销量排行榜
+     *
+     * @param rankReqVO 排行参数
+     * @return 产品销量排行榜
+     */
+    List<CrmStatisticsRankRespVO> getProductSalesRank(CrmStatisticsRankReqVO rankReqVO);
+
+    /**
+     * 获得新增客户数排行榜
+     *
+     * @param rankReqVO 排行参数
+     * @return 新增客户数排行榜
+     */
+    List<CrmStatisticsRankRespVO> getCustomerCountRank(CrmStatisticsRankReqVO rankReqVO);
+
+    /**
+     * 获得联系人数量排行榜
+     *
+     * @param rankReqVO 排行参数
+     * @return 联系人数量排行榜
+     */
+    List<CrmStatisticsRankRespVO> getContactsCountRank(CrmStatisticsRankReqVO rankReqVO);
+
+    /**
+     * 获得跟进次数排行榜
+     *
+     * @param rankReqVO 排行参数
+     * @return 跟进次数排行榜
+     */
+    List<CrmStatisticsRankRespVO> getFollowCountRank(CrmStatisticsRankReqVO rankReqVO);
+
+    /**
+     * 获得跟进客户数排行榜
+     *
+     * @param rankReqVO 排行参数
+     * @return 跟进客户数排行榜
+     */
+    List<CrmStatisticsRankRespVO> getFollowCustomerCountRank(CrmStatisticsRankReqVO rankReqVO);
+
+}
+package cn.iocoder.yudao.module.crm.service.statistics;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankReqVO;
+import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO;
+import cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsRankMapper;
+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 jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Function;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+/**
+ * CRM 排行榜统计 Service 实现类
+ *
+ * @author anhaohao
+ */
+@Service
+@Validated
+public class CrmStatisticsRankServiceImpl implements CrmStatisticsRankService {
+
+    @Resource
+    private CrmStatisticsRankMapper rankMapper;
+
+    @Resource
+    private AdminUserApi adminUserApi;
+    @Resource
+    private DeptApi deptApi;
+
+    @Override
+    public List<CrmStatisticsRankRespVO> getContractPriceRank(CrmStatisticsRankReqVO rankReqVO) {
+        return getRank(rankReqVO, rankMapper::selectContractPriceRank);
+    }
+
+    @Override
+    public List<CrmStatisticsRankRespVO> getReceivablePriceRank(CrmStatisticsRankReqVO rankReqVO) {
+        return getRank(rankReqVO, rankMapper::selectReceivablePriceRank);
+    }
+
+    @Override
+    public List<CrmStatisticsRankRespVO> getContractCountRank(CrmStatisticsRankReqVO rankReqVO) {
+        return getRank(rankReqVO, rankMapper::selectContractCountRank);
+    }
+
+    @Override
+    public List<CrmStatisticsRankRespVO> getProductSalesRank(CrmStatisticsRankReqVO rankReqVO) {
+        return getRank(rankReqVO, rankMapper::selectProductSalesRank);
+    }
+
+    @Override
+    public List<CrmStatisticsRankRespVO> getCustomerCountRank(CrmStatisticsRankReqVO rankReqVO) {
+        return getRank(rankReqVO, rankMapper::selectCustomerCountRank);
+    }
+
+    @Override
+    public List<CrmStatisticsRankRespVO> getContactsCountRank(CrmStatisticsRankReqVO rankReqVO) {
+        return getRank(rankReqVO, rankMapper::selectContactsCountRank);
+    }
+
+    @Override
+    public List<CrmStatisticsRankRespVO> getFollowCountRank(CrmStatisticsRankReqVO rankReqVO) {
+        return getRank(rankReqVO, rankMapper::selectFollowCountRank);
+    }
+
+    @Override
+    public List<CrmStatisticsRankRespVO> getFollowCustomerCountRank(CrmStatisticsRankReqVO rankReqVO) {
+        return getRank(rankReqVO, rankMapper::selectFollowCustomerCountRank);
+    }
+
+    /**
+     * 获得排行版数据
+     *
+     * @param rankReqVO    参数
+     * @param rankFunction 排行榜方法
+     * @return 排行版数据
+     */
+    private List<CrmStatisticsRankRespVO> getRank(CrmStatisticsRankReqVO rankReqVO, Function<CrmStatisticsRankReqVO, List<CrmStatisticsRankRespVO>> rankFunction) {
+        // 1. 获得用户编号数组
+        rankReqVO.setUserIds(getUserIds(rankReqVO.getDeptId()));
+        if (CollUtil.isEmpty(rankReqVO.getUserIds())) {
+            return Collections.emptyList();
+        }
+        // 2. 获得排行数据
+        List<CrmStatisticsRankRespVO> ranks = rankFunction.apply(rankReqVO);
+        if (CollUtil.isEmpty(ranks)) {
+            return Collections.emptyList();
+        }
+        ranks.sort(Comparator.comparing(CrmStatisticsRankRespVO::getCount).reversed());
+        // 3. 拼接用户信息
+        appendUserInfo(ranks);
+        return ranks;
+    }
+
+    /**
+     * 拼接用户信息（昵称、部门）
+     *
+     * @param ranks 排行榜数据
+     */
+    private void appendUserInfo(List<CrmStatisticsRankRespVO> ranks) {
+        Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(convertSet(ranks, CrmStatisticsRankRespVO::getOwnerUserId));
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(convertSet(userMap.values(), AdminUserRespDTO::getDeptId));
+        ranks.forEach(rank -> MapUtils.findAndThen(userMap, rank.getOwnerUserId(), user -> {
+            rank.setNickname(user.getNickname());
+            MapUtils.findAndThen(deptMap, user.getDeptId(), dept -> rank.setDeptName(dept.getName()));
+        }));
+    }
+
+    /**
+     * 获得部门下的用户编号数组，包括子部门的
+     *
+     * @param deptId 部门编号
+     * @return 用户编号数组
+     */
+    public List<Long> getUserIds(Long deptId) {
+        // 1. 获得部门列表
+        List<Long> deptIds = convertList(deptApi.getChildDeptList(deptId), DeptRespDTO::getId);
+        deptIds.add(deptId);
+        // 2. 获得用户编号
+        return convertList(adminUserApi.getUserListByDeptIds(deptIds), AdminUserRespDTO::getId);
+    }
+
+}
 \ No newline at end of file
+package cn.iocoder.yudao.module.crm.util;
+
+import cn.hutool.core.lang.Assert;
+import cn.iocoder.yudao.module.bpm.enums.task.BpmTaskStatusEnum;
+import cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum;
+
+/**
+ * CRM 流程工具类
+ *
+ * @author HUIHUI
+ */
+public class CrmAuditStatusUtils {
+
+    /**
+     * BPM 审批结果转换
+     *
+     * @param bpmResult BPM 审批结果
+     */
+    public static Integer convertBpmResultToAuditStatus(Integer bpmResult) {
+        Integer auditStatus = BpmTaskStatusEnum.APPROVE.getStatus().equals(bpmResult) ? CrmAuditStatusEnum.APPROVE.getStatus()
+                : BpmTaskStatusEnum.REJECT.getStatus().equals(bpmResult) ? CrmAuditStatusEnum.REJECT.getStatus()
+                : BpmTaskStatusEnum.CANCEL.getStatus().equals(bpmResult) ? BpmTaskStatusEnum.CANCEL.getStatus() : null;
+        Assert.notNull(auditStatus, "BPM 审批结果({}) 转换失败", bpmResult);
+        return auditStatus;
+    }
+
+}
+package cn.iocoder.yudao.module.crm.util;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.extra.spring.SpringUtil;
+import cn.iocoder.yudao.module.crm.dal.dataobject.permission.CrmPermissionDO;
+import cn.iocoder.yudao.module.crm.enums.common.CrmBizTypeEnum;
+import cn.iocoder.yudao.module.crm.enums.common.CrmSceneTypeEnum;
+import cn.iocoder.yudao.module.crm.enums.permission.CrmPermissionLevelEnum;
+import cn.iocoder.yudao.module.system.api.permission.PermissionApi;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import cn.iocoder.yudao.module.system.enums.permission.RoleCodeEnum;
+import com.baomidou.mybatisplus.core.toolkit.support.SFunction;
+import com.github.yulichang.autoconfigure.MybatisPlusJoinProperties;
+import com.github.yulichang.wrapper.MPJLambdaWrapper;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+/**
+ * 数据权限工具类
+ *
+ * @author HUIHUI
+ */
+public class CrmPermissionUtils {
+
+    /**
+     * 校验用户是否是 CRM 管理员
+     *
+     * @return 是/否
+     */
+    public static boolean isCrmAdmin() {
+        PermissionApi permissionApi = SpringUtil.getBean(PermissionApi.class);
+        return permissionApi.hasAnyRoles(getLoginUserId(), RoleCodeEnum.CRM_ADMIN.getCode());
+    }
+
+    /**
+     * 构造 CRM 数据类型数据【分页】查询条件
+     *
+     * @param query     连表查询对象
+     * @param bizType   数据类型 {@link CrmBizTypeEnum}
+     * @param bizId     数据编号
+     * @param userId    用户编号
+     * @param sceneType 场景类型
+     */
+    public static <T extends MPJLambdaWrapper<?>, S> void appendPermissionCondition(T query, Integer bizType, SFunction<S, ?> bizId,
+                                                                                    Long userId, Integer sceneType) {
+        MybatisPlusJoinProperties mybatisPlusJoinProperties = SpringUtil.getBean(MybatisPlusJoinProperties.class);
+        final String ownerUserIdField = mybatisPlusJoinProperties.getTableAlias() + ".owner_user_id";
+        // 场景一：我负责的数据
+        if (CrmSceneTypeEnum.isOwner(sceneType)) {
+            query.eq(ownerUserIdField, userId);
+        }
+        // 场景二：我参与的数据（我有读或写权限，并且不是负责人）
+        if (CrmSceneTypeEnum.isInvolved(sceneType)) {
+            if (CrmPermissionUtils.isCrmAdmin()) { // 特殊逻辑：如果是超管，直接查询所有，不过滤数据权限
+                return;
+            }
+            query.innerJoin(CrmPermissionDO.class, on -> on.eq(CrmPermissionDO::getBizType, bizType)
+                    .eq(CrmPermissionDO::getBizId, bizId)
+                    .in(CrmPermissionDO::getLevel, CrmPermissionLevelEnum.READ.getLevel(), CrmPermissionLevelEnum.WRITE.getLevel())
+                    .eq(CrmPermissionDO::getUserId,userId));
+            query.ne(ownerUserIdField, userId);
+        }
+        // 场景三：下属负责的数据（下属是负责人）
+        if (CrmSceneTypeEnum.isSubordinate(sceneType)) {
+            AdminUserApi adminUserApi = SpringUtil.getBean(AdminUserApi.class);
+            List<AdminUserRespDTO> subordinateUsers = adminUserApi.getUserListBySubordinate(userId);
+            if (CollUtil.isEmpty(subordinateUsers)) {
+                query.eq(ownerUserIdField, -1); // 不返回任何结果
+            } else {
+                query.in(ownerUserIdField, convertSet(subordinateUsers, AdminUserRespDTO::getId));
+            }
+        }
+    }
+
+}
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsFunnelMapper">
+
+    <select id="selectCustomerCountByDate" resultType="java.lang.Long">
+        SELECT
+            COUNT(*)
+        FROM crm_customer
+        WHERE deleted = 0
+        AND owner_user_id IN
+        <!-- TODO @puhui999：这个 foreach 搞个缩进哈 - -->
+        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+            #{userId}
+        </foreach>
+        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime} AND
+        <!-- TODO @puhui999：下面这个，就不缩进啦 - -->
+        #{times[1],javaType=java.time.LocalDateTime}
+    </select>
+
+    <select id="selectBusinessCountByDateAndEndStatus" resultType="java.lang.Long">
+        SELECT
+            COUNT(*)
+        FROM crm_business
+        WHERE deleted = 0
+        <if test="status != null">
+            AND end_status = #{status}
+        </if>
+        AND owner_user_id IN
+        <foreach collection="reqVO.userIds" item="userId" open="(" close=")" separator=",">
+            #{userId}
+        </foreach>
+        AND create_time BETWEEN #{reqVO.times[0],javaType=java.time.LocalDateTime} AND
+        #{reqVO.times[1],javaType=java.time.LocalDateTime}
+    </select>
+
+    <select id="selectBusinessSummaryListGroupByEndStatus"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.funnel.CrmStatisticsBusinessSummaryByEndStatusRespVO">
+        SELECT
+            end_status AS endStatus,
+            COUNT(*) AS businessCount,
+            SUM(total_price) AS totalPrice
+        FROM crm_business
+        WHERE deleted = 0 AND end_status IS NOT NULL
+        AND owner_user_id IN
+        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+            #{userId}
+        </foreach>
+        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime} AND
+        #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY end_status
+    </select>
+
+    <select id="selectBusinessSummaryGroupByDate"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.funnel.CrmStatisticsBusinessSummaryByDateRespVO">
+        SELECT
+            DATE_FORMAT(create_time, '%Y-%m-%d') AS time,
+            COUNT(*) AS businessCreateCount,
+            SUM(total_price) AS totalPrice
+        FROM crm_business
+        WHERE deleted = 0
+        AND owner_user_id IN
+        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+            #{userId}
+        </foreach>
+        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime} AND
+        #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY time
+    </select>
+
+    <select id="selectBusinessInversionRateSummaryByDate"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.funnel.CrmStatisticsBusinessInversionRateSummaryByDateRespVO">
+        SELECT
+            DATE_FORMAT(create_time, '%Y-%m-%d') AS time,
+            COUNT(*) AS businessCount,
+            SUM(IF(end_status = 1, 1, 0)) AS businessWinCount
+        FROM crm_business
+        WHERE deleted = 0
+        AND owner_user_id IN
+        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+            #{userId}
+        </foreach>
+        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime} AND
+        #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY time
+    </select>
+
+</mapper>
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsPerformanceMapper">
+
+    <select id="selectContractCountPerformance"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO">
+        SELECT
+            DATE_FORMAT(order_date, '%Y%m') AS time,
+            COUNT(1) AS currentMonthCount
+        FROM crm_contract
+        WHERE deleted = 0
+        AND audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
+        AND owner_user_id in
+            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+                #{userId}
+            </foreach>
+        AND order_date between #{times[0],javaType=java.time.LocalDateTime} and
+            #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY time
+    </select>
+
+    <select id="selectContractPricePerformance"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO">
+        SELECT
+            DATE_FORMAT(order_date, '%Y%m') AS time,
+            IFNULL(SUM(total_price), 0) AS currentMonthCount
+        FROM crm_contract
+        WHERE deleted = 0
+        AND audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
+        AND owner_user_id in
+            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+                #{userId}
+            </foreach>
+        AND order_date between #{times[0],javaType=java.time.LocalDateTime} and
+            #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY time
+    </select>
+
+    <select id="selectReceivablePricePerformance"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO">
+        SELECT
+            DATE_FORMAT(return_time, '%Y%m') AS time,
+            IFNULL(SUM(price), 0) AS currentMonthCount
+        FROM crm_receivable
+        WHERE deleted = 0
+        AND audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
+        AND owner_user_id in
+            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+                #{userId}
+            </foreach>
+        AND return_time between #{times[0],javaType=java.time.LocalDateTime} and
+            #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY time
+    </select>
+
+</mapper>
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsPortraitMapper">
+
+    <select id="selectSummaryListGroupByAreaId"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.portrait.CrmStatisticCustomerAreaRespVO">
+        SELECT area_id, COUNT(*) AS customerCount, SUM(deal_status) AS dealCount
+        FROM crm_customer
+        WHERE deleted = 0 AND area_id IS NOT NULL
+        AND owner_user_id IN
+        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+            #{userId}
+        </foreach>
+        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime}
+        AND #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY area_id
+    </select>
+
+    <select id="selectCustomerIndustryListGroupByIndustryId"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.portrait.CrmStatisticCustomerIndustryRespVO">
+        SELECT industry_id, COUNT(*) AS customerCount, SUM(deal_status) AS dealCount
+        FROM crm_customer
+        WHERE deleted = 0 AND industry_id IS NOT NULL
+        AND owner_user_id IN
+        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+            #{userId}
+        </foreach>
+        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime}
+        AND #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY industry_id
+    </select>
+
+    <select id="selectCustomerSourceListGroupBySource"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.portrait.CrmStatisticCustomerSourceRespVO">
+        SELECT source, COUNT(*) AS customerCount, SUM(deal_status) AS dealCount
+        FROM crm_customer
+        WHERE deleted = 0 AND source IS NOT NULL
+        AND owner_user_id IN
+        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+            #{userId}
+        </foreach>
+        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime}
+        AND #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY source
+    </select>
+
+    <select id="selectCustomerLevelListGroupByLevel"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.portrait.CrmStatisticCustomerLevelRespVO">
+        SELECT level, COUNT(*) AS customerCount, SUM(deal_status) AS dealCount
+        FROM crm_customer
+        WHERE deleted = 0 AND level IS NOT NULL
+        AND owner_user_id IN
+        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+            #{userId}
+        </foreach>
+        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime}
+        AND #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY level
+    </select>
+
+</mapper>
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsRankMapper">
+
+    <select id="selectContractPriceRank"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
+        SELECT IFNULL(SUM(total_price), 0) AS count, owner_user_id
+        FROM crm_contract
+        WHERE deleted = 0
+        AND audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
+        and owner_user_id in
+            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+                #{userId}
+            </foreach>
+        AND order_date between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY owner_user_id
+    </select>
+
+    <select id="selectReceivablePriceRank"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
+        SELECT IFNULL(SUM(price), 0) AS count, owner_user_id
+        FROM crm_receivable
+        WHERE deleted = 0
+        AND audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
+        AND owner_user_id in
+            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+                #{userId}
+            </foreach>
+        AND return_time between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY owner_user_id
+    </select>
+
+    <select id="selectContractCountRank"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
+        SELECT COUNT(1) AS count, owner_user_id
+        FROM crm_contract
+        WHERE deleted = 0
+        AND audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
+        AND owner_user_id in
+            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+                #{userId}
+            </foreach>
+        AND order_date between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY owner_user_id
+    </select>
+
+    <select id="selectProductSalesRank"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
+        SELECT COUNT(product.count) AS count, contract.owner_user_id
+        FROM crm_contract_product product
+        INNER JOIN crm_contract contract ON product.contract_id = contract.id
+        WHERE contract.deleted = 0 AND contract.deleted = 0
+        AND contract.audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
+        AND contract.owner_user_id in
+            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+                #{userId}
+            </foreach>
+        AND contract.order_date between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY contract.owner_user_id
+    </select>
+
+    <select id="selectCustomerCountRank"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
+        SELECT COUNT(1) AS count, owner_user_id
+        FROM crm_customer
+        WHERE deleted = 0
+        AND owner_user_id in
+            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+                #{userId}
+            </foreach>
+        AND create_time between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY owner_user_id
+    </select>
+
+    <select id="selectContactsCountRank"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
+        SELECT COUNT(1) AS count, owner_user_id
+        FROM crm_contact
+        WHERE deleted = 0
+        AND owner_user_id in
+            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+                #{userId}
+            </foreach>
+        AND create_time between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY owner_user_id
+    </select>
+
+    <select id="selectFollowCountRank"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
+        SELECT COUNT(1) AS count, cc.owner_user_id
+        FROM crm_follow_up_record AS cfur
+        LEFT JOIN crm_contact AS cc ON FIND_IN_SET(cc.id, cfur.contact_ids)
+        WHERE cfur.deleted = 0
+        AND cc.deleted = 0
+        AND cc.owner_user_id in
+            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+                #{userId}
+            </foreach>
+        AND cfur.create_time between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY cc.owner_user_id
+    </select>
+
+    <select id="selectFollowCustomerCountRank"
+            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
+        SELECT COUNT(DISTINCT cc.id) AS count, cc.owner_user_id
+        FROM crm_follow_up_record AS cfur
+        LEFT JOIN crm_contact AS cc ON FIND_IN_SET(cc.id, cfur.contact_ids)
+        WHERE cfur.deleted = 0
+        AND cc.deleted = 0
+        AND cc.owner_user_id in
+            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
+                #{userId}
+            </foreach>
+        AND cfur.create_time between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
+        GROUP BY cc.owner_user_id
+    </select>
+
+</mapper>
+spring:
+    main:
+        lazy-initialization: true # 开启懒加载，加快速度
+        banner-mode: off # 单元测试，禁用 Banner
+
+--- #################### 数据库相关配置 ####################
+
+spring:
+    # 数据源配置项
+    datasource:
+        name: ruoyi-vue-pro
+        url: jdbc:h2:mem:testdb;MODE=MYSQL;DATABASE_TO_UPPER=false;NON_KEYWORDS=value; # MODE 使用 MySQL 模式；DATABASE_TO_UPPER 配置表和字段使用小写
+        driver-class-name: org.h2.Driver
+        username: sa
+        password:
+        druid:
+            async-init: true # 单元测试，异步初始化 Druid 连接池，提升启动速度
+            initial-size: 1 # 单元测试，配置为 1，提升启动速度
+    sql:
+        init:
+            schema-locations: classpath:/sql/create_tables.sql
+
+    # Redis 配置。Redisson 默认的配置足够使用，一般不需要进行调优
+    data:
+      redis:
+        host: 127.0.0.1 # 地址
+        port: 16379 # 端口（单元测试，使用 16379 端口）
+        database: 0 # 数据库索引
+
+mybatis-plus:
+    lazy-initialization: true # 单元测试，设置 MyBatis Mapper 延迟加载，加速每个单元测试
+    type-aliases-package: ${yudao.info.base-package}.module.*.dal.dataobject
+
+--- #################### 定时任务相关配置 ####################
+
+--- #################### 配置中心相关配置 ####################
+
+--- #################### 服务保障相关配置 ####################
+
+# Lock4j 配置项（单元测试，禁用 Lock4j）
+
+--- #################### 监控相关配置 ####################
+
+--- #################### 芋道相关配置 ####################
+
+# 芋道配置项，设置当前项目所有自定义的配置
+yudao:
+  info:
+    base-package: cn.iocoder.yudao
-<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0"
-         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
-    <parent>
-        <groupId>cn.iocoder.boot</groupId>
-        <artifactId>yudao-module-crm</artifactId>
-        <version>${revision}</version>
-    </parent>
-    <modelVersion>4.0.0</modelVersion>
-    <artifactId>yudao-module-crm-api</artifactId>
-    <packaging>jar</packaging>
-
-    <name>${project.artifactId}</name>
-    <description>
-        crm 模块 API，暴露给其它模块调用
-    </description>
-
-    <dependencies>
-        <dependency>
-            <groupId>cn.iocoder.boot</groupId>
-            <artifactId>yudao-common</artifactId>
-        </dependency>
-
-        <!-- 参数校验 -->
-        <dependency>
-            <groupId>org.springframework.boot</groupId>
-            <artifactId>spring-boot-starter-validation</artifactId>
-            <optional>true</optional>
-        </dependency>
-    </dependencies>
-
-</project>
-<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xmlns="http://maven.apache.org/POM/4.0.0"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
-    <parent>
-        <groupId>cn.iocoder.boot</groupId>
-        <artifactId>yudao-module-crm</artifactId>
-        <version>${revision}</version>
-    </parent>
-    <modelVersion>4.0.0</modelVersion>
-    <artifactId>yudao-module-crm-biz</artifactId>
-
-    <name>${project.artifactId}</name>
-    <description>
-        crm 包下，客户关系管理（Customer Relationship Management）。
-        例如说：客户、联系人、商机、合同、回款等等
-    </description>
-
-    <dependencies>
-        <dependency>
-            <groupId>cn.iocoder.boot</groupId>
-            <artifactId>yudao-module-system-api</artifactId>
-            <version>${revision}</version>
-        </dependency>
-        <dependency>
-            <groupId>cn.iocoder.boot</groupId>
-            <artifactId>yudao-module-infra-api</artifactId>
-            <version>${revision}</version>
-        </dependency>
-        <dependency>
-            <groupId>cn.iocoder.boot</groupId>
-            <artifactId>yudao-module-crm-api</artifactId>
-            <version>${revision}</version>
-        </dependency>
-        <dependency>
-            <groupId>cn.iocoder.boot</groupId>
-            <artifactId>yudao-module-bpm-api</artifactId>
-            <version>${revision}</version>
-        </dependency>
-
-        <!-- 业务组件 -->
-        <dependency>
-            <groupId>cn.iocoder.boot</groupId>
-            <artifactId>yudao-spring-boot-starter-biz-ip</artifactId>
-        </dependency>
-        <dependency>
-            <groupId>cn.iocoder.boot</groupId>
-            <artifactId>yudao-spring-boot-starter-biz-tenant</artifactId>
-        </dependency>
-
-        <!-- Web 相关 -->
-        <dependency>
-            <groupId>cn.iocoder.boot</groupId>
-            <artifactId>yudao-spring-boot-starter-web</artifactId>
-        </dependency>
-
-        <dependency>
-            <groupId>cn.iocoder.boot</groupId>
-            <artifactId>yudao-spring-boot-starter-security</artifactId>
-        </dependency>
-
-        <!-- DB 相关 -->
-        <dependency>
-            <groupId>cn.iocoder.boot</groupId>
-            <artifactId>yudao-spring-boot-starter-mybatis</artifactId>
-        </dependency>
-
-        <!-- 工具类相关 -->
-        <dependency>
-            <groupId>cn.iocoder.boot</groupId>
-            <artifactId>yudao-spring-boot-starter-excel</artifactId>
-        </dependency>
-
-        <!-- Test 测试相关 -->
-        <dependency>
-            <groupId>cn.iocoder.boot</groupId>
-            <artifactId>yudao-spring-boot-starter-test</artifactId>
-        </dependency>
-    </dependencies>
-</project>
-/**
- * crm 模块的 web 拓展封装
- */
-package cn.iocoder.yudao.module.crm.framework.web;
-/**
- * 定时任务
- */
-package cn.iocoder.yudao.module.crm.job;
 \ No newline at end of file
-package cn.iocoder.yudao.module.crm.service.business;
-
-import cn.iocoder.yudao.framework.common.pojo.PageParam;
-import cn.iocoder.yudao.framework.common.pojo.PageResult;
-import cn.iocoder.yudao.module.crm.controller.admin.business.vo.status.CrmBusinessStatusSaveReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.business.CrmBusinessStatusDO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.business.CrmBusinessStatusTypeDO;
-import jakarta.validation.Valid;
-
-import java.util.Collection;
-import java.util.List;
-import java.util.Map;
-
-import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
-
-/**
- * 商机状态 Service 接口
- *
- * @author ljlleo
- */
-public interface CrmBusinessStatusService {
-
-    /**
-     * 创建商机状态
-     *
-     * @param createReqVO 创建信息
-     * @return 编号
-     */
-    Long createBusinessStatus(@Valid CrmBusinessStatusSaveReqVO createReqVO);
-
-    /**
-     * 更新商机状态
-     *
-     * @param updateReqVO 更新信息
-     */
-    void updateBusinessStatus(@Valid CrmBusinessStatusSaveReqVO updateReqVO);
-
-    /**
-     * 删除商机状态
-     *
-     * @param id 编号
-     */
-    void deleteBusinessStatusType(Long id);
-
-    /**
-     * 获得商机状态组
-     *
-     * @param id 编号
-     * @return 商机状态组
-     */
-    CrmBusinessStatusTypeDO getBusinessStatusType(Long id);
-
-    /**
-     * 校验商机状态组
-     *
-     * @param id 编号
-     */
-    void validateBusinessStatusType(Long id);
-
-    /**
-     * 获得商机状态组列表
-     *
-     * @return 商机状态组列表
-     */
-    List<CrmBusinessStatusTypeDO> getBusinessStatusTypeList();
-
-    /**
-     * 获得商机状态组分页
-     *
-     * @param pageReqVO 分页查询
-     * @return 商机状态组分页
-     */
-    PageResult<CrmBusinessStatusTypeDO> getBusinessStatusTypePage(PageParam pageReqVO);
-
-    /**
-     * 获得商机状态组列表
-     *
-     * @param ids 编号数组
-     * @return 商机状态组列表
-     */
-    List<CrmBusinessStatusTypeDO> getBusinessStatusTypeList(Collection<Long> ids);
-
-    /**
-     * 获得商机状态组 Map
-     *
-     * @param ids 编号数组
-     * @return 商机状态组 Map
-     */
-    default Map<Long, CrmBusinessStatusTypeDO> getBusinessStatusTypeMap(Collection<Long> ids) {
-        return convertMap(getBusinessStatusTypeList(ids), CrmBusinessStatusTypeDO::getId);
-    }
-
-    /**
-     * 获得指定类型的商机状态列表
-     *
-     * @param typeId 商机状态组编号
-     * @return 商机状态列表
-     */
-    List<CrmBusinessStatusDO> getBusinessStatusListByTypeId(Long typeId);
-
-    /**
-     * 获得商机状态列表
-     *
-     * @param ids 编号数组
-     * @return 商机状态列表
-     */
-    List<CrmBusinessStatusDO> getBusinessStatusList(Collection<Long> ids);
-
-    /**
-     * 获得商机状态 Map
-     *
-     * @param ids 编号数组
-     * @return 商机状态 Map
-     */
-    default Map<Long, CrmBusinessStatusDO> getBusinessStatusMap(Collection<Long> ids) {
-        return convertMap(getBusinessStatusList(ids), CrmBusinessStatusDO::getId);
-    }
-
-    /**
-     * 获得商机状态
-     *
-     * @param id 编号
-     * @return 商机状态
-     */
-    CrmBusinessStatusDO getBusinessStatus(Long id);
-
-    /**
-     * 校验商机状态
-     *
-     * @param statusTypeId 商机状态组编号
-     * @param statusId     商机状态编号
-     */
-    CrmBusinessStatusDO validateBusinessStatus(Long statusTypeId, Long statusId);
-
-}
-package cn.iocoder.yudao.module.crm.service.clue;
-
-import cn.iocoder.yudao.framework.common.pojo.PageResult;
-import cn.iocoder.yudao.module.crm.controller.admin.clue.vo.CrmCluePageReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.clue.vo.CrmClueSaveReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.clue.vo.CrmClueTransferReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.clue.CrmClueDO;
-import jakarta.validation.Valid;
-
-import java.time.LocalDateTime;
-
-/**
- * 线索 Service 接口
- *
- * @author Wanwan
- */
-public interface CrmClueService {
-
-    /**
-     * 创建线索
-     *
-     * @param createReqVO 创建信息
-     * @return 编号
-     */
-    Long createClue(@Valid CrmClueSaveReqVO createReqVO);
-
-    /**
-     * 更新线索
-     *
-     * @param updateReqVO 更新信息
-     */
-    void updateClue(@Valid CrmClueSaveReqVO updateReqVO);
-
-    /**
-     * 更新线索相关的跟进信息
-     *
-     * @param id 编号
-     * @param contactNextTime 下次联系时间
-     * @param contactLastContent 最后联系内容
-     */
-    void updateClueFollowUp(Long id, LocalDateTime contactNextTime, String contactLastContent);
-
-    /**
-     * 删除线索
-     *
-     * @param id 编号
-     */
-    void deleteClue(Long id);
-
-    /**
-     * 获得线索
-     *
-     * @param id 编号
-     * @return 线索
-     */
-    CrmClueDO getClue(Long id);
-
-    /**
-     * 获得线索分页
-     *
-     * @param pageReqVO 分页查询
-     * @param userId    用户编号
-     * @return 线索分页
-     */
-    PageResult<CrmClueDO> getCluePage(CrmCluePageReqVO pageReqVO, Long userId);
-
-    /**
-     * 线索转移
-     *
-     * @param reqVO  请求
-     * @param userId 用户编号
-     */
-    void transferClue(CrmClueTransferReqVO reqVO, Long userId);
-
-    /**
-     * 线索转化为客户
-     *
-     * @param id  线索编号
-     * @param userId 用户编号
-     */
-    void transformClue(Long id, Long userId);
-
-    /**
-     * 获得分配给我的、待跟进的线索数量
-     *
-     * @param userId 用户编号
-     * @return 数量
-     */
-    Long getFollowClueCount(Long userId);
-
-}
-package cn.iocoder.yudao.module.crm.service.contact;
-
-import cn.iocoder.yudao.module.crm.controller.admin.contact.vo.CrmContactBusiness2ReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.contact.vo.CrmContactBusinessReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.contact.CrmContactBusinessDO;
-import jakarta.validation.Valid;
-
-import java.util.List;
-
-/**
- * CRM 联系人与商机的关联 Service 接口
- *
- * @author 芋道源码
- */
-public interface CrmContactBusinessService {
-
-    /**
-     * 创建联系人与商机的关联【通过联系人，关联商机】
-     *
-     * @param createReqVO 创建信息
-     */
-    void createContactBusinessList(@Valid CrmContactBusinessReqVO createReqVO);
-
-    /**
-     * 创建联系人与商机的关联【通过商机，关联联系人】
-     *
-     * @param createReqVO 创建信息
-     */
-    void createContactBusinessList2(@Valid CrmContactBusiness2ReqVO createReqVO);
-
-    /**
-     * 删除联系人与商机的关联【通过联系人，取关商机】
-     *
-     * @param deleteReqVO 删除信息
-     */
-    void deleteContactBusinessList(@Valid CrmContactBusinessReqVO deleteReqVO);
-
-    /**
-     * 删除联系人与商机的关联【通过商机，取关联系人】
-     *
-     * @param deleteReqVO 删除信息
-     */
-    void deleteContactBusinessList2(@Valid CrmContactBusiness2ReqVO deleteReqVO);
-
-    /**
-     * 删除联系人与商机的关联，基于联系人编号
-     *
-     * @param contactId 联系人编号
-     */
-    void deleteContactBusinessByContactId(Long contactId);
-
-    /**
-     * 获得联系人与商机的关联列表，基于联系人编号
-     *
-     * @param contactId 联系人编号
-     * @return 联系人商机关联
-     */
-    List<CrmContactBusinessDO> getContactBusinessListByContactId(Long contactId);
-
-    /**
-     * 获得联系人与商机的关联列表，基于商机编号
-     *
-     * @param businessId 商机编号
-     * @return 联系人商机关联
-     */
-    List<CrmContactBusinessDO> getContactBusinessListByBusinessId(Long businessId);
-
-}
 \ No newline at end of file
-package cn.iocoder.yudao.module.crm.service.contract;
-
-import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
-import cn.iocoder.yudao.module.crm.controller.admin.contract.vo.config.CrmContractConfigSaveReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.contract.CrmContractConfigDO;
-import cn.iocoder.yudao.module.crm.dal.mysql.contract.CrmContractConfigMapper;
-import com.mzt.logapi.context.LogRecordContext;
-import com.mzt.logapi.starter.annotation.LogRecord;
-import jakarta.annotation.Resource;
-import org.springframework.stereotype.Service;
-import org.springframework.validation.annotation.Validated;
-
-import java.util.Objects;
-
-import static cn.iocoder.yudao.module.crm.enums.LogRecordConstants.*;
-
-/**
- * 合同配置 Service 实现类
- *
- * @author 芋道源码
- */
-@Service
-@Validated
-public class CrmContractConfigServiceImpl implements CrmContractConfigService {
-
-    @Resource
-    private CrmContractConfigMapper contractConfigMapper;
-
-    @Override
-    public CrmContractConfigDO getContractConfig() {
-        return contractConfigMapper.selectOne();
-    }
-
-    @Override
-    @LogRecord(type = CRM_CONTRACT_CONFIG_TYPE, subType = CRM_CONTRACT_CONFIG_SUB_TYPE, bizNo = "{{#configId}}",
-            success = CRM_CONTRACT_CONFIG_SUCCESS)
-    public void saveContractConfig(CrmContractConfigSaveReqVO saveReqVO) {
-        // 1. 存在，则进行更新
-        CrmContractConfigDO dbConfig = getContractConfig();
-        CrmContractConfigDO config = BeanUtils.toBean(saveReqVO, CrmContractConfigDO.class);
-        if (Objects.nonNull(dbConfig)) {
-            contractConfigMapper.updateById(config.setId(dbConfig.getId()));
-            // 记录操作日志上下文
-            LogRecordContext.putVariable("isConfigUpdate", Boolean.TRUE);
-            LogRecordContext.putVariable("configId", config.getId());
-            return;
-        }
-
-        // 2. 不存在，则进行插入
-        contractConfigMapper.insert(config);
-        // 记录操作日志上下文
-        LogRecordContext.putVariable("isConfigUpdate", Boolean.FALSE);
-        LogRecordContext.putVariable("configId", config.getId());
-    }
-
-}
-package cn.iocoder.yudao.module.crm.service.contract.listener;
-
-import cn.iocoder.yudao.module.bpm.event.BpmProcessInstanceStatusEvent;
-import cn.iocoder.yudao.module.bpm.event.BpmProcessInstanceStatusEventListener;
-import cn.iocoder.yudao.module.crm.service.contract.CrmContractService;
-import cn.iocoder.yudao.module.crm.service.contract.CrmContractServiceImpl;
-import jakarta.annotation.Resource;
-import org.springframework.stereotype.Component;
-
-/**
- * 合同审批的结果的监听器实现类
- *
- * @author HUIHUI
- */
-@Component
-public class CrmContractStatusListener extends BpmProcessInstanceStatusEventListener {
-
-    @Resource
-    private CrmContractService contractService;
-
-    @Override
-    public String getProcessDefinitionKey() {
-        return CrmContractServiceImpl.BPM_PROCESS_DEFINITION_KEY;
-    }
-
-    @Override
-    protected void onEvent(BpmProcessInstanceStatusEvent event) {
-        contractService.updateContractAuditStatus(Long.parseLong(event.getBusinessKey()), event.getStatus());
-    }
-
-}
-package cn.iocoder.yudao.module.crm.service.customer;
-
-import cn.iocoder.yudao.framework.common.pojo.PageResult;
-import cn.iocoder.yudao.module.crm.controller.admin.customer.vo.limitconfig.CrmCustomerLimitConfigPageReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.customer.vo.limitconfig.CrmCustomerLimitConfigSaveReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerLimitConfigDO;
-import jakarta.validation.Valid;
-
-import java.util.List;
-
-/**
- * 客户限制配置 Service 接口
- *
- * @author Wanwan
- */
-public interface CrmCustomerLimitConfigService {
-
-    /**
-     * 创建客户限制配置
-     *
-     * @param createReqVO 创建信息
-     * @return 编号
-     */
-    Long createCustomerLimitConfig(@Valid CrmCustomerLimitConfigSaveReqVO createReqVO);
-
-    /**
-     * 更新客户限制配置
-     *
-     * @param updateReqVO 更新信息
-     */
-    void updateCustomerLimitConfig(@Valid CrmCustomerLimitConfigSaveReqVO updateReqVO);
-
-    /**
-     * 删除客户限制配置
-     *
-     * @param id 编号
-     */
-    void deleteCustomerLimitConfig(Long id);
-
-    /**
-     * 获得客户限制配置
-     *
-     * @param id 编号
-     * @return 客户限制配置
-     */
-    CrmCustomerLimitConfigDO getCustomerLimitConfig(Long id);
-
-    /**
-     * 获得客户限制配置分页
-     *
-     * @param pageReqVO 分页查询
-     * @return 客户限制配置分页
-     */
-    PageResult<CrmCustomerLimitConfigDO> getCustomerLimitConfigPage(CrmCustomerLimitConfigPageReqVO pageReqVO);
-
-    /**
-     * 查询用户对应的配置列表
-     *
-     * @param type   类型
-     * @param userId 用户类型
-     */
-    List<CrmCustomerLimitConfigDO> getCustomerLimitConfigListByUserId(Integer type, Long userId);
-
-}
-package cn.iocoder.yudao.module.crm.service.customer;
-
-import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
-import cn.iocoder.yudao.module.crm.controller.admin.customer.vo.poolconfig.CrmCustomerPoolConfigSaveReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerPoolConfigDO;
-import cn.iocoder.yudao.module.crm.dal.mysql.customer.CrmCustomerPoolConfigMapper;
-import com.mzt.logapi.context.LogRecordContext;
-import com.mzt.logapi.starter.annotation.LogRecord;
-import jakarta.annotation.Resource;
-import org.springframework.stereotype.Service;
-import org.springframework.validation.annotation.Validated;
-
-import java.util.Objects;
-
-import static cn.iocoder.yudao.module.crm.enums.LogRecordConstants.*;
-
-/**
- * 客户公海配置 Service 实现类
- *
- * @author Wanwan
- */
-@Service
-@Validated
-public class CrmCustomerPoolConfigServiceImpl implements CrmCustomerPoolConfigService {
-
-    @Resource
-    private CrmCustomerPoolConfigMapper customerPoolConfigMapper;
-
-    @Override
-    public CrmCustomerPoolConfigDO getCustomerPoolConfig() {
-        return customerPoolConfigMapper.selectOne();
-    }
-
-    @Override
-    @LogRecord(type = CRM_CUSTOMER_POOL_CONFIG_TYPE, subType = CRM_CUSTOMER_POOL_CONFIG_SUB_TYPE, bizNo = "{{#poolConfigId}}",
-            success = CRM_CUSTOMER_POOL_CONFIG_SUCCESS)
-    public void saveCustomerPoolConfig(CrmCustomerPoolConfigSaveReqVO saveReqVO) {
-        // 1. 存在，则进行更新
-        CrmCustomerPoolConfigDO dbConfig = getCustomerPoolConfig();
-        CrmCustomerPoolConfigDO poolConfig = BeanUtils.toBean(saveReqVO, CrmCustomerPoolConfigDO.class);
-        if (Objects.nonNull(dbConfig)) {
-            customerPoolConfigMapper.updateById(poolConfig.setId(dbConfig.getId()));
-            // 记录操作日志上下文
-            LogRecordContext.putVariable("isPoolConfigUpdate", Boolean.TRUE);
-            LogRecordContext.putVariable("poolConfigId", poolConfig.getId());
-            return;
-        }
-
-        // 2. 不存在，则进行插入
-        customerPoolConfigMapper.insert(poolConfig);
-        // 记录操作日志上下文
-        LogRecordContext.putVariable("isPoolConfigUpdate", Boolean.FALSE);
-        LogRecordContext.putVariable("poolConfigId", poolConfig.getId());
-    }
-
-}
-package cn.iocoder.yudao.module.crm.service.customer;
-
-import cn.iocoder.yudao.framework.common.pojo.PageResult;
-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.service.customer.bo.CrmCustomerCreateReqBO;
-import jakarta.validation.Valid;
-
-import java.time.LocalDateTime;
-import java.util.Collection;
-import java.util.List;
-import java.util.Map;
-
-import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
-
-/**
- * 客户 Service 接口
- *
- * @author Wanwan
- */
-public interface CrmCustomerService {
-
-    /**
-     * 创建客户
-     *
-     * @param createReqVO 创建信息
-     * @param userId      用户编号
-     * @return 编号
-     */
-    Long createCustomer(@Valid CrmCustomerSaveReqVO createReqVO, Long userId);
-
-    /**
-     * 更新客户
-     *
-     * @param updateReqVO 更新信息
-     */
-    void updateCustomer(@Valid CrmCustomerSaveReqVO updateReqVO);
-
-    /**
-     * 更新客户的跟进状态
-     *
-     * @param id         编号
-     * @param dealStatus 跟进状态
-     */
-    void updateCustomerDealStatus(Long id, Boolean dealStatus);
-
-    /**
-     * 更新客户相关的跟进信息
-     *
-     * @param id                 编号
-     * @param contactNextTime    下次联系时间
-     * @param contactLastContent 最后联系内容
-     */
-    void updateCustomerFollowUp(Long id, LocalDateTime contactNextTime, String contactLastContent);
-
-    /**
-     * 删除客户
-     *
-     * @param id 编号
-     */
-    void deleteCustomer(Long id);
-
-    /**
-     * 获得客户
-     *
-     * @param id 编号
-     * @return 客户
-     */
-    CrmCustomerDO getCustomer(Long id);
-
-    /**
-     * 获得客户列表
-     *
-     * @param ids 客户编号数组
-     * @return 客户列表
-     * @author ljlleo
-     */
-    List<CrmCustomerDO> getCustomerList(Collection<Long> ids);
-
-    /**
-     * 获得客户 Map
-     *
-     * @param ids 客户编号数组
-     * @return 客户 Map
-     */
-    default Map<Long, CrmCustomerDO> getCustomerMap(Collection<Long> ids) {
-        return convertMap(getCustomerList(ids), CrmCustomerDO::getId);
-    }
-
-    /**
-     * 获得客户分页
-     *
-     * @param pageReqVO 分页查询
-     * @param userId    用户编号
-     * @return 客户分页
-     */
-    PageResult<CrmCustomerDO> getCustomerPage(CrmCustomerPageReqVO pageReqVO, Long userId);
-
-    /**
-     * 获得放入公海提醒的客户分页
-     *
-     * @param pageVO 分页查询
-     * @param userId 用户编号
-     * @return 客户分页
-     */
-    PageResult<CrmCustomerDO> getPutPoolRemindCustomerPage(CrmCustomerPageReqVO pageVO, Long userId);
-
-    /**
-     * 获得待进入公海的客户数量
-     *
-     * @param userId 用户编号
-     * @return 提醒数量
-     */
-    Long getPutPoolRemindCustomerCount(Long userId);
-
-    /**
-     * 获得今日需联系客户数量
-     *
-     * @param userId 用户编号
-     * @return 提醒数量
-     */
-    Long getTodayContactCustomerCount(Long userId);
-
-    /**
-     * 获得分配给我的客户数量
-     *
-     * @param userId 用户编号
-     * @return 提醒数量
-     */
-    Long getFollowCustomerCount(Long userId);
-
-    /**
-     * 校验客户是否存在
-     *
-     * @param id 编号
-     */
-    void validateCustomer(Long id);
-
-    /**
-     * 客户转移
-     *
-     * @param reqVO  请求
-     * @param userId 用户编号
-     */
-    void transferCustomer(CrmCustomerTransferReqVO reqVO, Long userId);
-
-    /**
-     * 锁定/解锁客户
-     *
-     * @param lockReqVO 更新信息
-     * @param userId    用户编号
-     */
-    void lockCustomer(@Valid CrmCustomerLockReqVO lockReqVO, Long userId);
-
-    /**
-     * 创建客户
-     *
-     * @param customerCreateReq 请求信息
-     * @param userId            用户编号
-     * @return 客户列表
-     */
-    Long createCustomer(CrmCustomerCreateReqBO customerCreateReq, Long userId);
-
-    /**
-     * 批量导入客户
-     *
-     * @param importCustomers 导入客户列表
-     * @param importReqVO     请求
-     * @return 导入结果
-     */
-    CrmCustomerImportRespVO importCustomerList(List<CrmCustomerImportExcelVO> importCustomers, CrmCustomerImportReqVO importReqVO);
-
-    // ==================== 公海相关操作 ====================
-
-    /**
-     * 客户放入公海
-     *
-     * @param id 客户编号
-     */
-    void putCustomerPool(Long id);
-
-    /**
-     * 领取公海客户
-     *
-     * @param ids         要领取的客户编号数组
-     * @param ownerUserId 负责人
-     * @param isReceive   是/否领取；true - 领取；false - 分配
-     */
-    void receiveCustomer(List<Long> ids, Long ownerUserId, Boolean isReceive);
-
-    /**
-     * 【系统】客户自动掉入公海
-     *
-     * @return 掉入公海数量
-     */
-    int autoPutCustomerPool();
-
-}
-package cn.iocoder.yudao.module.crm.service.customer.bo;
-
-import cn.iocoder.yudao.framework.common.validation.Mobile;
-import cn.iocoder.yudao.framework.common.validation.Telephone;
-import cn.iocoder.yudao.module.crm.enums.DictTypeConstants;
-import jakarta.validation.constraints.Email;
-import jakarta.validation.constraints.NotEmpty;
-import jakarta.validation.constraints.Size;
-import lombok.Data;
-
-import java.time.LocalDateTime;
-
-/**
- * 客户创建 Create Req BO
- *
- * @author HUIHUI
- */
-@Data
-public class CrmCustomerCreateReqBO {
-
-    /**
-     * 客户名称
-     */
-    @NotEmpty(message = "客户名称不能为空")
-    private String name;
-    /**
-     * 跟进状态
-     */
-    private Boolean followUpStatus;
-    /**
-     * 锁定状态
-     */
-    private Boolean lockStatus;
-    /**
-     * 成交状态
-     */
-    private Boolean dealStatus;
-    /**
-     * 所属行业
-     *
-     * 对应字典 {@link DictTypeConstants#CRM_CUSTOMER_INDUSTRY}
-     */
-    private Integer industryId;
-    /**
-     * 客户等级
-     *
-     * 对应字典 {@link DictTypeConstants#CRM_CUSTOMER_LEVEL}
-     */
-    private Integer level;
-    /**
-     * 客户来源
-     *
-     * 对应字典 {@link DictTypeConstants#CRM_CUSTOMER_SOURCE}
-     */
-    private Integer source;
-
-    /**
-     * 手机
-     */
-    @Mobile
-    private String mobile;
-    /**
-     * 电话
-     */
-    @Telephone
-    private String telephone;
-    /**
-     * QQ
-     */
-    private String qq;
-    /**
-     * wechat
-     */
-    private String wechat;
-
-    /**
-     * 邮箱
-     */
-    @Email(message = "邮箱格式不正确")
-    private String email;
-
-    /**
-     * 客户描述
-     */
-    @Size(max = 4096, message = "客户描述长度不能超过 4096 个字符")
-    private String description;
-    /**
-     * 备注
-     */
-    private String remark;
-    /**
-     * 负责人的用户编号
-     *
-     * 关联 AdminUserDO 的 id 字段
-     */
-    private Long ownerUserId;
-    /**
-     * 所在地
-     *
-     * 关联 {@link cn.iocoder.yudao.framework.ip.core.Area#getId()} 字段
-     */
-    private Integer areaId;
-    /**
-     * 详细地址
-     */
-    private String detailAddress;
-
-    /**
-     * 最后跟进时间
-     */
-    private LocalDateTime contactLastTime;
-    /**
-     * 最后跟进内容
-     */
-    private String contactLastContent;
-    /**
-     * 下次联系时间
-     */
-    private LocalDateTime contactNextTime;
-
-}
-package cn.iocoder.yudao.module.crm.service.followup;
-
-import cn.iocoder.yudao.framework.common.pojo.PageResult;
-import cn.iocoder.yudao.module.crm.controller.admin.followup.vo.CrmFollowUpRecordPageReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.followup.vo.CrmFollowUpRecordSaveReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.followup.CrmFollowUpRecordDO;
-import cn.iocoder.yudao.module.crm.service.followup.bo.CrmFollowUpCreateReqBO;
-import jakarta.validation.Valid;
-
-import java.util.Collection;
-import java.util.List;
-
-/**
- * 跟进记录 Service 接口
- *
- * @author 芋道源码
- */
-public interface CrmFollowUpRecordService {
-
-    /**
-     * 创建跟进记录 (数据权限基于 bizType、 bizId)
-     *
-     * @param createReqVO 创建信息
-     * @return 编号
-     */
-    Long createFollowUpRecord(@Valid CrmFollowUpRecordSaveReqVO createReqVO);
-
-    /**
-     * 创建更进
-     *
-     * @param list 请求
-     */
-    void createFollowUpRecordBatch(List<CrmFollowUpCreateReqBO> list);
-
-    /**
-     * 删除跟进记录 (数据权限基于 bizType、 bizId)
-     *
-     * @param id     编号
-     * @param userId 用户编号
-     */
-    void deleteFollowUpRecord(Long id, Long userId);
-
-    /**
-     * 删除跟进
-     *
-     * @param bizType 模块类型
-     * @param bizId   模块数据编号
-     */
-    void deleteFollowUpRecordByBiz(Integer bizType, Long bizId);
-
-    /**
-     * 获得跟进记录
-     *
-     * @param id 编号
-     * @return 跟进记录
-     */
-    CrmFollowUpRecordDO getFollowUpRecord(Long id);
-
-    /**
-     * 获得跟进记录分页 (数据权限基于 bizType、 bizId)
-     *
-     * @param pageReqVO 分页查询
-     * @return 跟进记录分页
-     */
-    PageResult<CrmFollowUpRecordDO> getFollowUpRecordPage(CrmFollowUpRecordPageReqVO pageReqVO);
-
-    /**
-     * 获取跟进记录
-     *
-     * @param bizType 模块类型
-     * @param bizIds  模块数据编号
-     * @return 跟进列表
-     */
-    List<CrmFollowUpRecordDO> getFollowUpRecordByBiz(Integer bizType, Collection<Long> bizIds);
-
-}
 \ No newline at end of file
-package cn.iocoder.yudao.module.crm.service.followup.bo;
-
-import cn.iocoder.yudao.module.crm.dal.dataobject.business.CrmBusinessDO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.contact.CrmContactDO;
-import cn.iocoder.yudao.module.crm.enums.DictTypeConstants;
-import cn.iocoder.yudao.module.crm.enums.common.CrmBizTypeEnum;
-import jakarta.validation.constraints.NotEmpty;
-import jakarta.validation.constraints.NotNull;
-import lombok.Data;
-
-import java.time.LocalDateTime;
-import java.util.List;
-
-/**
- * 跟进信息 Create Req BO
- *
- * @author HUIHUI
- */
-@Data
-public class CrmFollowUpCreateReqBO {
-
-    /**
-     * 数据类型
-     *
-     * 枚举 {@link CrmBizTypeEnum}
-     */
-    @NotNull(message = "数据类型不能为空")
-    private Integer bizType;
-    /**
-     * 数据编号
-     *
-     * 关联 {@link CrmBizTypeEnum} 对应模块 DO 的 id 字段
-     */
-    @NotNull(message = "数据编号不能为空")
-    private Long bizId;
-
-    /**
-     * 跟进类型
-     *
-     * 关联 {@link DictTypeConstants#CRM_FOLLOW_UP_TYPE} 字典
-     */
-    @NotNull(message = "跟进类型不能为空")
-    private Integer type;
-    /**
-     * 跟进内容
-     */
-    @NotEmpty(message = "跟进内容不能为空")
-    private String content;
-    /**
-     * 下次联系时间
-     */
-    @NotNull(message = "下次联系时间不能为空")
-    private LocalDateTime nextTime;
-
-    /**
-     * 图片
-     */
-    private List<String> picUrls;
-    /**
-     * 附件
-     */
-    private List<String> fileUrls;
-
-    /**
-     * 关联的商机编号数组
-     *
-     * 关联 {@link CrmBusinessDO#getId()}
-     */
-    private List<Long> businessIds;
-
-    /**
-     * 关联的联系人编号数组
-     *
-     * 关联 {@link CrmContactDO#getId()}
-     */
-    private List<Long> contactIds;
-
-}
-package cn.iocoder.yudao.module.crm.service.permission;
-
-
-import cn.iocoder.yudao.module.crm.controller.admin.permission.vo.CrmPermissionSaveReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.permission.vo.CrmPermissionUpdateReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.permission.CrmPermissionDO;
-import cn.iocoder.yudao.module.crm.enums.common.CrmBizTypeEnum;
-import cn.iocoder.yudao.module.crm.enums.permission.CrmPermissionLevelEnum;
-import cn.iocoder.yudao.module.crm.service.permission.bo.CrmPermissionCreateReqBO;
-import cn.iocoder.yudao.module.crm.service.permission.bo.CrmPermissionTransferReqBO;
-import jakarta.validation.Valid;
-
-import java.util.Collection;
-import java.util.List;
-
-/**
- * crm 数据权限 Service 接口
- *
- * @author HUIHUI
- */
-public interface CrmPermissionService {
-
-    /**
-     * 创建数据权限
-     *
-     * @param reqVO  创建信息
-     * @param userId 用户编号
-     */
-    void createPermission(CrmPermissionSaveReqVO reqVO, Long userId);
-
-    /**
-     * 创建数据权限
-     *
-     * @param createReqBO 创建信息
-     * @return 编号
-     */
-    Long createPermission(@Valid CrmPermissionCreateReqBO createReqBO);
-
-    /**
-     * 创建数据权限
-     *
-     * @param createReqBOs 创建信息
-     */
-    void createPermissionBatch(@Valid List<CrmPermissionCreateReqBO> createReqBOs);
-
-    /**
-     * 更新数据权限
-     *
-     * @param updateReqVO 更新信息
-     */
-    void updatePermission(CrmPermissionUpdateReqVO updateReqVO);
-
-    /**
-     * 数据权限转移
-     *
-     * @param crmPermissionTransferReqBO 数据权限转移请求
-     */
-    void transferPermission(@Valid CrmPermissionTransferReqBO crmPermissionTransferReqBO);
-
-    /**
-     * 删除数据权限
-     *
-     * @param bizType 数据类型，关联 {@link CrmBizTypeEnum}
-     * @param bizId   数据编号，关联 {@link CrmBizTypeEnum} 对应模块 DO#getId()
-     * @param level   数据权限级别，关联 {@link CrmPermissionLevelEnum}
-     */
-    void deletePermission(Integer bizType, Long bizId, Integer level);
-
-    /**
-     * 删除数据权限
-     *
-     * @param bizType 数据类型，关联 {@link CrmBizTypeEnum}
-     * @param bizId   数据编号，关联 {@link CrmBizTypeEnum} 对应模块 DO#getId()
-     */
-    void deletePermission(Integer bizType, Long bizId);
-
-    /**
-     * 批量删除数据权限
-     *
-     * @param ids    权限编号
-     * @param userId 用户编号
-     */
-    void deletePermissionBatch(Collection<Long> ids, Long userId);
-
-    /**
-     * 删除指定用户数据权限
-     *
-     * @param id     权限编号
-     * @param userId 用户编号
-     */
-    void deleteSelfPermission(Long id, Long userId);
-
-    /**
-     * 获取数据权限列表，通过 数据类型 x 某个数据
-     *
-     * @param bizType 数据类型，关联 {@link CrmBizTypeEnum}
-     * @param bizId   数据编号，关联 {@link CrmBizTypeEnum} 对应模块 DO#getId()
-     * @return Crm 数据权限列表
-     */
-    List<CrmPermissionDO> getPermissionListByBiz(Integer bizType, Long bizId);
-
-    /**
-     * 获取数据权限列表，通过 数据类型 x 某个数据
-     *
-     * @param bizType 数据类型，关联 {@link CrmBizTypeEnum}
-     * @param bizIds  数据编号，关联 {@link CrmBizTypeEnum} 对应模块 DO#getId()
-     * @return Crm 数据权限列表
-     */
-    List<CrmPermissionDO> getPermissionListByBiz(Integer bizType, Collection<Long> bizIds);
-
-    /**
-     * 获取用户参与的模块数据列表
-     *
-     * @param bizType 模块类型
-     * @param userId  用户编号
-     * @return 模块数据列表
-     */
-    List<CrmPermissionDO> getPermissionListByBizTypeAndUserId(Integer bizType, Long userId);
-
-    /**
-     * 校验是否有指定数据的操作权限
-     *
-     * @param bizType 数据类型，关联 {@link CrmBizTypeEnum}
-     * @param bizId   数据编号，关联 {@link CrmBizTypeEnum} 对应模块 DO#getId()
-     * @param userId  用户编号
-     * @param level   权限级别
-     * @return 是否有权限
-     */
-    boolean hasPermission(Integer bizType, Long bizId, Long userId, CrmPermissionLevelEnum level);
-
-}
-package cn.iocoder.yudao.module.crm.service.permission.bo;
-
-import cn.iocoder.yudao.framework.common.validation.InEnum;
-import cn.iocoder.yudao.module.crm.enums.common.CrmBizTypeEnum;
-import cn.iocoder.yudao.module.crm.enums.permission.CrmPermissionLevelEnum;
-import lombok.Data;
-
-import jakarta.validation.constraints.NotNull;
-
-/**
- * crm 数据权限 Create Req BO
- *
- * @author HUIHUI
- */
-@Data
-public class CrmPermissionCreateReqBO {
-
-    /**
-     * 当前登录用户编号
-     */
-    @NotNull(message = "用户编号不能为空")
-    private Long userId;
-
-    /**
-     * Crm 类型
-     */
-    @NotNull(message = "Crm 类型不能为空")
-    @InEnum(CrmBizTypeEnum.class)
-    private Integer bizType;
-    /**
-     * 数据编号
-     */
-    @NotNull(message = "Crm 数据编号不能为空")
-    private Long bizId;
-
-    /**
-     * 权限级别
-     */
-    @NotNull(message = "权限级别不能为空")
-    @InEnum(CrmPermissionLevelEnum.class)
-    private Integer level;
-
-}
-package cn.iocoder.yudao.module.crm.service.permission.bo;
-
-import cn.iocoder.yudao.framework.common.validation.InEnum;
-import cn.iocoder.yudao.module.crm.enums.common.CrmBizTypeEnum;
-import cn.iocoder.yudao.module.crm.enums.permission.CrmPermissionLevelEnum;
-import lombok.AllArgsConstructor;
-import lombok.Data;
-
-import jakarta.validation.constraints.NotNull;
-import lombok.NoArgsConstructor;
-
-/**
- * 数据权限转移 Request BO
- *
- * @author HUIHUI
- */
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-public class CrmPermissionTransferReqBO {
-
-    /**
-     * 当前登录用户编号
-     */
-    @NotNull(message = "用户编号不能为空")
-    private Long userId;
-
-    /**
-     * CRM 类型
-     */
-    @NotNull(message = "Crm 类型不能为空")
-    @InEnum(CrmBizTypeEnum.class)
-    private Integer bizType;
-    /**
-     * 数据编号
-     */
-    @NotNull(message = "CRM 数据编号不能为空")
-    private Long bizId;
-
-    /**
-     * 新负责人的用户编号
-     */
-    @NotNull(message = "新负责人的用户编号不能为空")
-    private Long newOwnerUserId;
-
-    /**
-     * 老负责人加入团队后的权限级别。如果 null 说明移除
-     *
-     * 关联 {@link CrmPermissionLevelEnum}
-     */
-    private Integer oldOwnerPermissionLevel;
-
-}
-package cn.iocoder.yudao.module.crm.service.product;
-
-import cn.iocoder.yudao.module.crm.controller.admin.product.vo.category.CrmProductCategoryCreateReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.product.vo.category.CrmProductCategoryListReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.product.CrmProductCategoryDO;
-import jakarta.validation.Valid;
-
-import java.util.Collection;
-import java.util.List;
-import java.util.Map;
-
-import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
-
-/**
- * CRM 产品分类 Service 接口
- *
- * @author ZanGe丶
- */
-public interface CrmProductCategoryService {
-
-    /**
-     * 创建产品分类
-     *
-     * @param createReqVO 创建信息
-     * @return 编号
-     */
-    Long createProductCategory(@Valid CrmProductCategoryCreateReqVO createReqVO);
-
-    /**
-     * 更新产品分类
-     *
-     * @param updateReqVO 更新信息
-     */
-    void updateProductCategory(@Valid CrmProductCategoryCreateReqVO updateReqVO);
-
-    /**
-     * 删除产品分类
-     *
-     * @param id 编号
-     */
-    void deleteProductCategory(Long id);
-
-    /**
-     * 获得产品分类
-     *
-     * @param id 编号
-     * @return 产品分类
-     */
-    CrmProductCategoryDO getProductCategory(Long id);
-
-    /**
-     * 获得产品分类列表
-     *
-     * @param listReqVO 列表请求
-     * @return 产品分类列表
-     */
-    List<CrmProductCategoryDO> getProductCategoryList(CrmProductCategoryListReqVO listReqVO);
-
-    /**
-     * 获得产品分类列表
-     *
-     * @param ids 编号数组
-     * @return 产品分类列表
-     */
-    List<CrmProductCategoryDO> getProductCategoryList(Collection<Long> ids);
-
-    /**
-     * 获得产品分类 Map
-     *
-     * @param ids 编号数组
-     * @return 产品分类 Map
-     */
-    default Map<Long, CrmProductCategoryDO> getProductCategoryMap(Collection<Long> ids) {
-        return convertMap(getProductCategoryList(ids), CrmProductCategoryDO::getId);
-    }
-
-}
-package cn.iocoder.yudao.module.crm.service.product;
-
-import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
-import cn.iocoder.yudao.module.crm.controller.admin.product.vo.category.CrmProductCategoryCreateReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.product.vo.category.CrmProductCategoryListReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.product.CrmProductCategoryDO;
-import cn.iocoder.yudao.module.crm.dal.mysql.product.CrmProductCategoryMapper;
-import com.mzt.logapi.context.LogRecordContext;
-import com.mzt.logapi.starter.annotation.LogRecord;
-import jakarta.annotation.Resource;
-import org.springframework.context.annotation.Lazy;
-import org.springframework.stereotype.Service;
-import org.springframework.validation.annotation.Validated;
-
-import java.util.Collection;
-import java.util.List;
-import java.util.Objects;
-
-import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
-import static cn.iocoder.yudao.module.crm.dal.dataobject.product.CrmProductCategoryDO.PARENT_ID_NULL;
-import static cn.iocoder.yudao.module.crm.enums.ErrorCodeConstants.*;
-import static cn.iocoder.yudao.module.crm.enums.LogRecordConstants.*;
-
-/**
- * CRM 产品分类 Service 实现类
- *
- * @author ZanGe丶
- */
-@Service
-@Validated
-public class CrmProductCategoryServiceImpl implements CrmProductCategoryService {
-
-    @Resource(name = "crmProductCategoryMapper")
-    private CrmProductCategoryMapper productCategoryMapper;
-
-    @Resource
-    @Lazy // 延迟加载，解决循环依赖问题
-    private CrmProductService crmProductService;
-
-    @Override
-    @LogRecord(type = CRM_PRODUCT_CATEGORY_TYPE, subType = CRM_PRODUCT_CATEGORY_CREATE_SUB_TYPE, bizNo = "{{#productCategoryId}}",
-            success = CRM_PRODUCT_CATEGORY_CREATE_SUCCESS)
-    public Long createProductCategory(CrmProductCategoryCreateReqVO createReqVO) {
-        // 1.1 校验父分类存在
-        validateParentProductCategory(createReqVO.getParentId());
-        // 1.2 分类名称是否存在
-        validateProductNameExists(null, createReqVO.getParentId(), createReqVO.getName());
-
-        // 2. 插入分类
-        CrmProductCategoryDO category = BeanUtils.toBean(createReqVO, CrmProductCategoryDO.class);
-        productCategoryMapper.insert(category);
-
-        // 3. 记录操作日志上下文
-        LogRecordContext.putVariable("productCategoryId", category.getId());
-        return category.getId();
-    }
-
-    @Override
-    @LogRecord(type = CRM_PRODUCT_CATEGORY_TYPE, subType = CRM_PRODUCT_CATEGORY_UPDATE_SUB_TYPE, bizNo = "{{#updateReqVO.id}}",
-            success = CRM_PRODUCT_CATEGORY_UPDATE_SUCCESS)
-    public void updateProductCategory(CrmProductCategoryCreateReqVO updateReqVO) {
-        // 1.1 校验存在
-        validateProductCategoryExists(updateReqVO.getId());
-        // 1.2 校验父分类存在
-        validateParentProductCategory(updateReqVO.getParentId());
-        // 1.3 分类名称是否存在
-        validateProductNameExists(updateReqVO.getId(), updateReqVO.getParentId(), updateReqVO.getName());
-
-        // 2. 更新分类
-        CrmProductCategoryDO updateObj = BeanUtils.toBean(updateReqVO, CrmProductCategoryDO.class);
-        productCategoryMapper.updateById(updateObj);
-    }
-
-    private void validateProductCategoryExists(Long id) {
-        if (productCategoryMapper.selectById(id) == null) {
-            throw exception(PRODUCT_CATEGORY_NOT_EXISTS);
-        }
-    }
-
-    private void validateParentProductCategory(Long id) {
-        // 如果是根分类，无需验证
-        if (Objects.equals(id, PARENT_ID_NULL)) {
-            return;
-        }
-        // 父分类不存在
-        CrmProductCategoryDO category = productCategoryMapper.selectById(id);
-        if (category == null) {
-            throw exception(PRODUCT_CATEGORY_PARENT_NOT_EXISTS);
-        }
-        // 父分类不能是二级分类
-        if (!Objects.equals(category.getParentId(), PARENT_ID_NULL)) {
-            throw exception(PRODUCT_CATEGORY_PARENT_NOT_FIRST_LEVEL);
-        }
-    }
-
-    private void validateProductNameExists(Long id, Long parentId, String name) {
-        CrmProductCategoryDO category = productCategoryMapper.selectByParentIdAndName(parentId, name);
-        if (category == null
-            || category.getId().equals(id)) {
-            return;
-        }
-        throw exception(PRODUCT_CATEGORY_EXISTS);
-    }
-
-    @Override
-    @LogRecord(type = CRM_PRODUCT_CATEGORY_TYPE, subType = CRM_PRODUCT_CATEGORY_DELETE_SUB_TYPE, bizNo = "{{#id}}",
-            success = CRM_PRODUCT_CATEGORY_DELETE_SUCCESS)
-    public void deleteProductCategory(Long id) {
-        // 1.1 校验存在
-        validateProductCategoryExists(id);
-        // 1.2 校验是否还有子分类
-        if (productCategoryMapper.selectCountByParentId(id) > 0) {
-            throw exception(PRODUCT_CATEGORY_EXISTS_CHILDREN);
-        }
-        // 1.3 校验是否被产品使用
-        if (crmProductService.getProductByCategoryId(id) > 0) {
-            throw exception(PRODUCT_CATEGORY_USED);
-        }
-        // 2. 删除
-        productCategoryMapper.deleteById(id);
-    }
-
-    @Override
-    public CrmProductCategoryDO getProductCategory(Long id) {
-        return productCategoryMapper.selectById(id);
-    }
-
-    @Override
-    public List<CrmProductCategoryDO> getProductCategoryList(CrmProductCategoryListReqVO listReqVO) {
-        return productCategoryMapper.selectList(listReqVO);
-    }
-
-    @Override
-    public List<CrmProductCategoryDO> getProductCategoryList(Collection<Long> ids) {
-        return productCategoryMapper.selectBatchIds(ids);
-    }
-
-}
-package cn.iocoder.yudao.module.crm.service.product;
-
-import cn.iocoder.yudao.framework.common.pojo.PageResult;
-import cn.iocoder.yudao.module.crm.controller.admin.product.vo.product.CrmProductPageReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.product.vo.product.CrmProductSaveReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.product.CrmProductDO;
-import jakarta.validation.Valid;
-
-import java.util.Collection;
-import java.util.List;
-import java.util.Map;
-
-import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
-
-/**
- * CRM 产品 Service 接口
- *
- * @author ZanGe丶
- */
-public interface CrmProductService {
-
-    /**
-     * 创建产品
-     *
-     * @param createReqVO 创建信息
-     * @return 编号
-     */
-    Long createProduct(@Valid CrmProductSaveReqVO createReqVO);
-
-    /**
-     * 更新产品
-     *
-     * @param updateReqVO 更新信息
-     */
-    void updateProduct(@Valid CrmProductSaveReqVO updateReqVO);
-
-    /**
-     * 删除产品
-     *
-     * @param id 编号
-     */
-    void deleteProduct(Long id);
-
-    /**
-     * 获得产品
-     *
-     * @param id 编号
-     * @return 产品
-     */
-    CrmProductDO getProduct(Long id);
-
-    /**
-     * 获得产品列表
-     *
-     * @param ids 编号
-     * @return 产品列表
-     */
-    List<CrmProductDO> getProductList(Collection<Long> ids);
-
-    /**
-     * 获得产品 Map
-     *
-     * @param ids 编号
-     * @return 产品 Map
-     */
-    default Map<Long, CrmProductDO> getProductMap(Collection<Long> ids) {
-        return convertMap(getProductList(ids), CrmProductDO::getId);
-    }
-
-    /**
-     * 获得产品分页
-     *
-     * @param pageReqVO 分页查询
-     * @return 产品分页
-     */
-    PageResult<CrmProductDO> getProductPage(CrmProductPageReqVO pageReqVO);
-
-    /**
-     * 获得产品数量
-     *
-     * @param categoryId 分类编号
-     * @return 产品
-     */
-    Long getProductByCategoryId(Long categoryId);
-
-    /**
-     * 获得指定状态的产品列表
-     *
-     * @param status 状态
-     * @return 产品列表
-     */
-    List<CrmProductDO> getProductListByStatus(Integer status);
-
-    /**
-     * 校验产品们的有效性
-     *
-     * @param ids 编号数组
-     * @return 产品列表
-     */
-    List<CrmProductDO> validProductList(Collection<Long> ids);
-
-}
-package cn.iocoder.yudao.module.crm.service.receivable;
-
-import cn.iocoder.yudao.framework.common.pojo.PageResult;
-import cn.iocoder.yudao.module.crm.controller.admin.receivable.vo.plan.CrmReceivablePlanPageReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.receivable.vo.plan.CrmReceivablePlanSaveReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerDO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.receivable.CrmReceivablePlanDO;
-import jakarta.validation.Valid;
-
-import java.util.Collection;
-import java.util.List;
-
-/**
- * CRM 回款计划 Service 接口
- *
- * @author 芋道源码
- */
-public interface CrmReceivablePlanService {
-
-    /**
-     * 创建回款计划
-     *
-     * @param createReqVO 创建信息
-     * @return 编号
-     */
-    Long createReceivablePlan(@Valid CrmReceivablePlanSaveReqVO createReqVO);
-
-    /**
-     * 更新回款计划
-     *
-     * @param updateReqVO 更新信息
-     */
-    void updateReceivablePlan(@Valid CrmReceivablePlanSaveReqVO updateReqVO);
-
-    /**
-     * 更新回款计划关联的回款编号
-     *
-     * @param id           编号
-     * @param receivableId 回款编号
-     */
-    void updateReceivablePlanReceivableId(Long id, Long receivableId);
-
-    /**
-     * 删除回款计划
-     *
-     * @param id 编号
-     */
-    void deleteReceivablePlan(Long id);
-
-    /**
-     * 获得回款计划
-     *
-     * @param id 编号
-     * @return 回款计划
-     */
-    CrmReceivablePlanDO getReceivablePlan(Long id);
-
-    /**
-     * 获得回款计划列表
-     *
-     * @param ids 编号
-     * @return 回款计划列表
-     */
-    List<CrmReceivablePlanDO> getReceivablePlanList(Collection<Long> ids);
-
-    /**
-     * 获得回款计划分页
-     *
-     * 数据权限：基于 {@link CrmReceivablePlanDO} 读取
-     *
-     * @param pageReqVO 分页查询
-     * @param userId    用户编号
-     * @return 回款计划分页
-     */
-    PageResult<CrmReceivablePlanDO> getReceivablePlanPage(CrmReceivablePlanPageReqVO pageReqVO, Long userId);
-
-    /**
-     * 获得回款计划分页，基于指定客户
-     *
-     * 数据权限：基于 {@link CrmCustomerDO} 读取
-     *
-     * @param pageReqVO 分页查询
-     * @return 回款计划分页
-     */
-    PageResult<CrmReceivablePlanDO> getReceivablePlanPageByCustomerId(CrmReceivablePlanPageReqVO pageReqVO);
-
-    /**
-     * 获得待回款提醒数量
-     *
-     * @param userId 用户编号
-     * @return 提醒数量
-     */
-    Long getReceivablePlanRemindCount(Long userId);
-
-}
-package cn.iocoder.yudao.module.crm.service.receivable;
-
-import cn.iocoder.yudao.framework.common.pojo.PageResult;
-import cn.iocoder.yudao.module.crm.controller.admin.receivable.vo.receivable.CrmReceivablePageReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.receivable.vo.receivable.CrmReceivableSaveReqVO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerDO;
-import cn.iocoder.yudao.module.crm.dal.dataobject.receivable.CrmReceivableDO;
-import jakarta.validation.Valid;
-
-import java.math.BigDecimal;
-import java.util.Collection;
-import java.util.List;
-import java.util.Map;
-
-import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
-
-/**
- * CRM 回款 Service 接口
- *
- * @author 赤焰
- */
-public interface CrmReceivableService {
-
-    /**
-     * 创建回款
-     *
-     * @param createReqVO 创建信息
-     * @return 编号
-     */
-    Long createReceivable(@Valid CrmReceivableSaveReqVO createReqVO);
-
-    /**
-     * 更新回款
-     *
-     * @param updateReqVO 更新信息
-     */
-    void updateReceivable(@Valid CrmReceivableSaveReqVO updateReqVO);
-
-    /**
-     * 更新回款流程审批结果
-     *
-     * @param id        回款编号
-     * @param bpmResult BPM 审批结果
-     */
-    void updateReceivableAuditStatus(Long id, Integer bpmResult);
-
-    /**
-     * 删除回款
-     *
-     * @param id 编号
-     */
-    void deleteReceivable(Long id);
-
-    /**
-     * 发起回款审批流程
-     *
-     * @param id     回款编号
-     * @param userId 用户编号
-     */
-    void submitReceivable(Long id, Long userId);
-
-    /**
-     * 获得回款
-     *
-     * @param id 编号
-     * @return 回款
-     */
-    CrmReceivableDO getReceivable(Long id);
-
-    /**
-     * 获得回款列表
-     *
-     * @param ids 编号
-     * @return 回款列表
-     */
-    List<CrmReceivableDO> getReceivableList(Collection<Long> ids);
-
-    /**
-     * 获得回款 Map
-     *
-     * @param ids 编号
-     * @return 回款 Map
-     */
-    default Map<Long, CrmReceivableDO> getReceivableMap(Collection<Long> ids) {
-        return convertMap(getReceivableList(ids), CrmReceivableDO::getId);
-    }
-
-    /**
-     * 获得回款分页
-     *
-     * 数据权限：基于 {@link CrmReceivableDO} 读取
-     *
-     * @param pageReqVO 分页查询
-     * @param userId    用户编号
-     * @return 回款分页
-     */
-    PageResult<CrmReceivableDO> getReceivablePage(CrmReceivablePageReqVO pageReqVO, Long userId);
-
-    /**
-     * 获得回款分页，基于指定客户
-     *
-     * 数据权限：基于 {@link CrmCustomerDO} 读取
-     *
-     * @param pageReqVO 分页查询
-     * @return 回款分页
-     */
-    PageResult<CrmReceivableDO> getReceivablePageByCustomerId(CrmReceivablePageReqVO pageReqVO);
-
-    /**
-     * 获得待审核回款数量
-     *
-     * @param userId 用户编号
-     * @return 待审批数量
-     */
-    Long getAuditReceivableCount(Long userId);
-
-    /**
-     * 获得合同已回款金额 Map
-     *
-     * @param contractIds 合同编号
-     * @return 回款金额 Map
-     */
-    Map<Long, BigDecimal> getReceivablePriceMapByContractId(Collection<Long> contractIds);
-
-    /**
-     * 根据合同编号查询回款数量
-     *
-     * @param contractId 合同编号
-     * @return 回款数量
-     */
-    Long getReceivableCountByContractId(Long contractId);
-
-}
-package cn.iocoder.yudao.module.crm.service.receivable.listener;
-
-import cn.iocoder.yudao.module.bpm.event.BpmProcessInstanceStatusEvent;
-import cn.iocoder.yudao.module.bpm.event.BpmProcessInstanceStatusEventListener;
-import cn.iocoder.yudao.module.crm.service.receivable.CrmReceivableService;
-import cn.iocoder.yudao.module.crm.service.receivable.CrmReceivableServiceImpl;
-import jakarta.annotation.Resource;
-import org.springframework.stereotype.Component;
-
-/**
- * 回款审批的结果的监听器实现类
- *
- * @author HUIHUI
- */
-@Component
-public class CrmReceivableStatusListener extends BpmProcessInstanceStatusEventListener {
-
-    @Resource
-    private CrmReceivableService receivableService;
-
-    @Override
-    public String getProcessDefinitionKey() {
-        return CrmReceivableServiceImpl.BPM_PROCESS_DEFINITION_KEY;
-    }
-
-    @Override
-    public void onEvent(BpmProcessInstanceStatusEvent event) {
-        receivableService.updateReceivableAuditStatus(Long.parseLong(event.getBusinessKey()), event.getStatus());
-    }
-
-}
-package cn.iocoder.yudao.module.crm.service.statistics;
-
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.customer.*;
-
-import java.util.List;
-
-/**
- * CRM 客户分析 Service 接口
- *
- * @author dhb52
- */
-public interface CrmStatisticsCustomerService {
-
-    /**
-     * 总量分析(按日期)
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticsCustomerSummaryByDateRespVO> getCustomerSummaryByDate(CrmStatisticsCustomerReqVO reqVO);
-
-    /**
-     * 总量分析(按用户)
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticsCustomerSummaryByUserRespVO> getCustomerSummaryByUser(CrmStatisticsCustomerReqVO reqVO);
-
-    /**
-     * 跟进次数分析(按日期)
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticsFollowUpSummaryByDateRespVO> getFollowUpSummaryByDate(CrmStatisticsCustomerReqVO reqVO);
-
-    /**
-     * 跟进次数分析(按用户)
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticsFollowUpSummaryByUserRespVO> getFollowUpSummaryByUser(CrmStatisticsCustomerReqVO reqVO);
-
-    /**
-     * 客户跟进次数分析(按类型)
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticsFollowUpSummaryByTypeRespVO> getFollowUpSummaryByType(CrmStatisticsCustomerReqVO reqVO);
-
-    /**
-     * 获取客户的首次合同、回款信息列表，用于【客户转化率】页面
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticsCustomerContractSummaryRespVO> getContractSummary(CrmStatisticsCustomerReqVO reqVO);
-
-    /**
-     * 公海客户分析(按日期)
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticsPoolSummaryByDateRespVO> getPoolSummaryByDate(CrmStatisticsCustomerReqVO reqVO);
-
-    /**
-     * 公海客户分析(按用户)
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticsPoolSummaryByUserRespVO> getPoolSummaryByUser(CrmStatisticsCustomerReqVO reqVO);
-
-    /**
-     * 客户成交周期(按日期)
-     *
-     * 成交周期的定义：客户 customer 在创建出来，到合同 contract 第一次成交的时间差
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticsCustomerDealCycleByDateRespVO> getCustomerDealCycleByDate(CrmStatisticsCustomerReqVO reqVO);
-
-    /**
-     * 客户成交周期(按用户)
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticsCustomerDealCycleByUserRespVO> getCustomerDealCycleByUser(CrmStatisticsCustomerReqVO reqVO);
-
-    /**
-     * 客户成交周期(按区域)
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticsCustomerDealCycleByAreaRespVO> getCustomerDealCycleByArea(CrmStatisticsCustomerReqVO reqVO);
-
-    /**
-     * 客户成交周期(按产品)
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticsCustomerDealCycleByProductRespVO> getCustomerDealCycleByProduct(CrmStatisticsCustomerReqVO reqVO);
-
-}
-package cn.iocoder.yudao.module.crm.service.statistics;
-
-import cn.iocoder.yudao.framework.common.pojo.PageResult;
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.funnel.*;
-import cn.iocoder.yudao.module.crm.dal.dataobject.business.CrmBusinessDO;
-
-import java.util.List;
-
-/**
- * CRM 销售漏斗分析 Service
- *
- * @author HUIHUI
- */
-public interface CrmStatisticsFunnelService {
-
-    /**
-     * 获得销售漏斗数据
-     *
-     * @param reqVO 请求
-     * @return 销售漏斗数据
-     */
-    CrmStatisticFunnelSummaryRespVO getFunnelSummary(CrmStatisticsFunnelReqVO reqVO);
-
-    /**
-     * 获得商机结束状态统计
-     *
-     * @param reqVO 请求
-     * @return 商机结束状态统计
-     */
-    List<CrmStatisticsBusinessSummaryByEndStatusRespVO> getBusinessSummaryByEndStatus(CrmStatisticsFunnelReqVO reqVO);
-
-    /**
-     * 获取新增商机分析(按日期)
-     *
-     * @param reqVO 请求
-     * @return 新增商机分析
-     */
-    List<CrmStatisticsBusinessSummaryByDateRespVO> getBusinessSummaryByDate(CrmStatisticsFunnelReqVO reqVO);
-
-    /**
-     * 获得商机转化率分析(按日期)
-     *
-     * @param reqVO 请求
-     * @return 商机转化率分析
-     */
-    List<CrmStatisticsBusinessInversionRateSummaryByDateRespVO> getBusinessInversionRateSummaryByDate(CrmStatisticsFunnelReqVO reqVO);
-
-    /**
-     * 获得商机分页(按日期)
-     *
-     * @param pageVO 请求
-     * @return 商机分页
-     */
-    PageResult<CrmBusinessDO> getBusinessPageByDate(CrmStatisticsFunnelReqVO pageVO);
-
-}
-package cn.iocoder.yudao.module.crm.service.statistics;
-
-
-
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO;
-
-import java.util.List;
-
-/**
- * CRM 员工绩效统计 Service 接口
- *
- * @author scholar
- */
-public interface CrmStatisticsPerformanceService {
-
-    /**
-     * 员工签约合同数量分析
-     *
-     * @param performanceReqVO 排行参数
-     * @return 员工签约合同数量排行分析
-     */
-    List<CrmStatisticsPerformanceRespVO> getContractCountPerformance(CrmStatisticsPerformanceReqVO performanceReqVO);
-
-    /**
-     * 员工签约合同金额分析
-     *
-     * @param performanceReqVO 排行参数
-     * @return 员工签约合同金额分析
-     */
-    List<CrmStatisticsPerformanceRespVO> getContractPricePerformance(CrmStatisticsPerformanceReqVO performanceReqVO);
-
-    /**
-     * 员工获得回款金额分析
-     *
-     * @param performanceReqVO 排行参数
-     * @return 员工获得回款金额分析
-     */
-    List<CrmStatisticsPerformanceRespVO> getReceivablePricePerformance(CrmStatisticsPerformanceReqVO performanceReqVO);
-
-
-}
-package cn.iocoder.yudao.module.crm.service.statistics;
-
-import cn.hutool.core.collection.CollUtil;
-import cn.hutool.core.collection.ListUtil;
-import cn.hutool.core.util.ObjUtil;
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO;
-import cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsPerformanceMapper;
-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 jakarta.annotation.Resource;
-import org.springframework.stereotype.Service;
-import org.springframework.validation.annotation.Validated;
-
-import java.math.BigDecimal;
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.List;
-import java.util.Map;
-import java.util.function.Function;
-
-import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
-import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
-
-/**
- * CRM 员工业绩分析 Service 实现类
- *
- * @author scholar
- */
-@Service
-@Validated
-public class CrmStatisticsPerformanceServiceImpl implements CrmStatisticsPerformanceService {
-
-    @Resource
-    private CrmStatisticsPerformanceMapper performanceMapper;
-
-    @Resource
-    private AdminUserApi adminUserApi;
-    @Resource
-    private DeptApi deptApi;
-
-    @Override
-    public List<CrmStatisticsPerformanceRespVO> getContractCountPerformance(CrmStatisticsPerformanceReqVO performanceReqVO) {
-        return getPerformance(performanceReqVO, performanceMapper::selectContractCountPerformance);
-    }
-
-    @Override
-    public List<CrmStatisticsPerformanceRespVO> getContractPricePerformance(CrmStatisticsPerformanceReqVO performanceReqVO) {
-        return getPerformance(performanceReqVO, performanceMapper::selectContractPricePerformance);
-    }
-
-    @Override
-    public List<CrmStatisticsPerformanceRespVO> getReceivablePricePerformance(CrmStatisticsPerformanceReqVO performanceReqVO) {
-        return getPerformance(performanceReqVO, performanceMapper::selectReceivablePricePerformance);
-    }
-
-    /**
-     * 获得员工业绩数据
-     *
-     * 1. 获得今年 + 去年的数据
-     * 2. 遍历今年的月份，逐个拼接去年的月份数据
-     *
-     * @param performanceReqVO  参数
-     * @param performanceFunction 员工业绩统计方法
-     * @return 员工业绩数据
-     */
-    private List<CrmStatisticsPerformanceRespVO> getPerformance(CrmStatisticsPerformanceReqVO performanceReqVO,
-                                                                Function<CrmStatisticsPerformanceReqVO, List<CrmStatisticsPerformanceRespVO>> performanceFunction) {
-
-        // 1. 获得用户编号数组
-        List<Long> userIds = getUserIds(performanceReqVO);
-        if (CollUtil.isEmpty(userIds)) {
-            return Collections.emptyList();
-        }
-        performanceReqVO.setUserIds(userIds);
-
-        // 2. 获得业绩数据
-        int year = performanceReqVO.getTimes()[0].getYear(); // 获取查询的年份
-        performanceReqVO.getTimes()[0] = performanceReqVO.getTimes()[0].minusYears(1);
-        List<CrmStatisticsPerformanceRespVO> performanceList = performanceFunction.apply(performanceReqVO);
-        Map<String, BigDecimal> performanceMap = convertMap(performanceList, CrmStatisticsPerformanceRespVO::getTime,
-                CrmStatisticsPerformanceRespVO::getCurrentMonthCount);
-
-        // 3. 组装数据返回
-        List<CrmStatisticsPerformanceRespVO> result = new ArrayList<>();
-        for (int month = 1; month <= 12; month++) {
-            String currentMonth = String.format("%d%02d", year, month);
-            String lastMonth = month == 1 ? String.format("%d%02d", year - 1, 12) : String.format("%d%02d", year, month - 1);
-            String lastYear = String.format("%d%02d", year - 1, month);
-            result.add(new CrmStatisticsPerformanceRespVO().setTime(currentMonth)
-                    .setCurrentMonthCount(performanceMap.getOrDefault(currentMonth, BigDecimal.ZERO))
-                    .setLastMonthCount(performanceMap.getOrDefault(lastMonth, BigDecimal.ZERO))
-                    .setLastYearCount(performanceMap.getOrDefault(lastYear, BigDecimal.ZERO)));
-        }
-        return result;
-    }
-
-    /**
-     * 获取用户编号数组。如果用户编号为空, 则获得部门下的用户编号数组，包括子部门的所有用户编号
-     *
-     * @param reqVO 请求参数
-     * @return 用户编号数组
-     */
-    private List<Long> getUserIds(CrmStatisticsPerformanceReqVO reqVO) {
-        // 情况一：选中某个用户
-        if (ObjUtil.isNotNull(reqVO.getUserId())) {
-            return ListUtil.of(reqVO.getUserId());
-        }
-        // 情况二：选中某个部门
-        // 2.1 获得部门列表
-        final Long deptId = reqVO.getDeptId();
-        List<Long> deptIds = convertList(deptApi.getChildDeptList(deptId), DeptRespDTO::getId);
-        deptIds.add(deptId);
-        // 2.2 获得用户编号
-        return convertList(adminUserApi.getUserListByDeptIds(deptIds), AdminUserRespDTO::getId);
-    }
-
-}
 \ No newline at end of file
-package cn.iocoder.yudao.module.crm.service.statistics;
-
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.portrait.*;
-
-import java.util.List;
-
-/**
- * CRM 客户画像 Service 接口
- *
- * @author HUIHUI
- */
-public interface CrmStatisticsPortraitService {
-
-    /**
-     * 获取客户地区统计数据
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticCustomerAreaRespVO> getCustomerSummaryByArea(CrmStatisticsPortraitReqVO reqVO);
-
-    /**
-     * 获取客户行业统计数据
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticCustomerIndustryRespVO> getCustomerSummaryByIndustry(CrmStatisticsPortraitReqVO reqVO);
-
-    /**
-     * 获取客户级别统计数据
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticCustomerLevelRespVO> getCustomerSummaryByLevel(CrmStatisticsPortraitReqVO reqVO);
-
-    /**
-     * 获取客户来源统计数据
-     *
-     * @param reqVO 请求参数
-     * @return 统计数据
-     */
-    List<CrmStatisticCustomerSourceRespVO> getCustomerSummaryBySource(CrmStatisticsPortraitReqVO reqVO);
-
-}
-package cn.iocoder.yudao.module.crm.service.statistics;
-
-import cn.hutool.core.collection.CollUtil;
-import cn.hutool.core.collection.ListUtil;
-import cn.hutool.core.util.ObjUtil;
-import cn.iocoder.yudao.framework.ip.core.Area;
-import cn.iocoder.yudao.framework.ip.core.enums.AreaTypeEnum;
-import cn.iocoder.yudao.framework.ip.core.utils.AreaUtils;
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.portrait.*;
-import cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsPortraitMapper;
-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 jakarta.annotation.Resource;
-import org.springframework.stereotype.Service;
-
-import java.util.Collections;
-import java.util.List;
-import java.util.Map;
-
-import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
-import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
-
-/**
- * CRM 客户画像 Service 实现类
- *
- * @author HUIHUI
- */
-@Service
-public class CrmStatisticsPortraitServiceImpl implements CrmStatisticsPortraitService {
-
-    @Resource
-    private CrmStatisticsPortraitMapper portraitMapper;
-
-    @Resource
-    private AdminUserApi adminUserApi;
-    @Resource
-    private DeptApi deptApi;
-
-    @Override
-    public List<CrmStatisticCustomerAreaRespVO> getCustomerSummaryByArea(CrmStatisticsPortraitReqVO reqVO) {
-        // 1. 获得用户编号数组
-        List<Long> userIds = getUserIds(reqVO);
-        if (CollUtil.isEmpty(userIds)) {
-            return Collections.emptyList();
-        }
-        reqVO.setUserIds(userIds);
-
-        // 2. 获取客户地区统计数据
-        List<CrmStatisticCustomerAreaRespVO> list = portraitMapper.selectSummaryListGroupByAreaId(reqVO);
-        if (CollUtil.isEmpty(list)) {
-            return Collections.emptyList();
-        }
-
-        // 3. 拼接数据
-        List<Area> areaList = AreaUtils.getByType(AreaTypeEnum.PROVINCE, area -> area);
-        Map<Integer, Area> areaMap = convertMap(areaList, Area::getId);
-        return convertList(list, item -> {
-            Integer parentId = AreaUtils.getParentIdByType(item.getAreaId(), AreaTypeEnum.PROVINCE);
-            if (parentId != null) {
-                Area area = areaMap.get(parentId);
-                if (area != null) {
-                    item.setAreaId(parentId).setAreaName(area.getName());
-                    return item;
-                }
-            }
-            // 找不到，归到未知
-            return item.setAreaId(null).setAreaName("未知");
-        });
-    }
-
-    @Override
-    public List<CrmStatisticCustomerIndustryRespVO> getCustomerSummaryByIndustry(CrmStatisticsPortraitReqVO reqVO) {
-        // 1. 获得用户编号数组
-        List<Long> userIds = getUserIds(reqVO);
-        if (CollUtil.isEmpty(userIds)) {
-            return Collections.emptyList();
-        }
-        reqVO.setUserIds(userIds);
-
-        // 2. 获取客户行业统计数据
-        return portraitMapper.selectCustomerIndustryListGroupByIndustryId(reqVO);
-    }
-
-    @Override
-    public List<CrmStatisticCustomerSourceRespVO> getCustomerSummaryBySource(CrmStatisticsPortraitReqVO reqVO) {
-        // 1. 获得用户编号数组
-        List<Long> userIds = getUserIds(reqVO);
-        if (CollUtil.isEmpty(userIds)) {
-            return Collections.emptyList();
-        }
-        reqVO.setUserIds(userIds);
-
-        // 2. 获取客户行业统计数据
-        return portraitMapper.selectCustomerSourceListGroupBySource(reqVO);
-    }
-
-    @Override
-    public List<CrmStatisticCustomerLevelRespVO> getCustomerSummaryByLevel(CrmStatisticsPortraitReqVO reqVO) {
-        // 1. 获得用户编号数组
-        List<Long> userIds = getUserIds(reqVO);
-        if (CollUtil.isEmpty(userIds)) {
-            return Collections.emptyList();
-        }
-        reqVO.setUserIds(userIds);
-
-        // 2. 获取客户级别统计数据
-        return portraitMapper.selectCustomerLevelListGroupByLevel(reqVO);
-    }
-
-    /**
-     * 获取用户编号数组。如果用户编号为空, 则获得部门下的用户编号数组，包括子部门的所有用户编号
-     *
-     * @param reqVO 请求参数
-     * @return 用户编号数组
-     */
-    private List<Long> getUserIds(CrmStatisticsPortraitReqVO reqVO) {
-        // 情况一：选中某个用户
-        if (ObjUtil.isNotNull(reqVO.getUserId())) {
-            return ListUtil.of(reqVO.getUserId());
-        }
-        // 情况二：选中某个部门
-        // 2.1 获得部门列表
-        List<Long> deptIds = convertList(deptApi.getChildDeptList(reqVO.getDeptId()), DeptRespDTO::getId);
-        deptIds.add(reqVO.getDeptId());
-        // 2.2 获得用户编号
-        return convertList(adminUserApi.getUserListByDeptIds(deptIds), AdminUserRespDTO::getId);
-    }
-
-}
-package cn.iocoder.yudao.module.crm.service.statistics;
-
-
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO;
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankReqVO;
-
-import java.util.List;
-
-/**
- * CRM 排行榜统计 Service 接口
- *
- * @author anhaohao
- */
-public interface CrmStatisticsRankService {
-
-    /**
-     * 获得合同金额排行榜
-     *
-     * @param rankReqVO 排行参数
-     * @return 合同金额排行榜
-     */
-    List<CrmStatisticsRankRespVO> getContractPriceRank(CrmStatisticsRankReqVO rankReqVO);
-
-    /**
-     * 获得回款金额排行榜
-     *
-     * @param rankReqVO 排行参数
-     * @return 回款金额排行榜
-     */
-    List<CrmStatisticsRankRespVO> getReceivablePriceRank(CrmStatisticsRankReqVO rankReqVO);
-
-    /**
-     * 获得签约合同数量排行榜
-     *
-     * @param rankReqVO 排行参数
-     * @return 签约合同数量排行榜
-     */
-    List<CrmStatisticsRankRespVO> getContractCountRank(CrmStatisticsRankReqVO rankReqVO);
-
-    /**
-     * 获得产品销量排行榜
-     *
-     * @param rankReqVO 排行参数
-     * @return 产品销量排行榜
-     */
-    List<CrmStatisticsRankRespVO> getProductSalesRank(CrmStatisticsRankReqVO rankReqVO);
-
-    /**
-     * 获得新增客户数排行榜
-     *
-     * @param rankReqVO 排行参数
-     * @return 新增客户数排行榜
-     */
-    List<CrmStatisticsRankRespVO> getCustomerCountRank(CrmStatisticsRankReqVO rankReqVO);
-
-    /**
-     * 获得联系人数量排行榜
-     *
-     * @param rankReqVO 排行参数
-     * @return 联系人数量排行榜
-     */
-    List<CrmStatisticsRankRespVO> getContactsCountRank(CrmStatisticsRankReqVO rankReqVO);
-
-    /**
-     * 获得跟进次数排行榜
-     *
-     * @param rankReqVO 排行参数
-     * @return 跟进次数排行榜
-     */
-    List<CrmStatisticsRankRespVO> getFollowCountRank(CrmStatisticsRankReqVO rankReqVO);
-
-    /**
-     * 获得跟进客户数排行榜
-     *
-     * @param rankReqVO 排行参数
-     * @return 跟进客户数排行榜
-     */
-    List<CrmStatisticsRankRespVO> getFollowCustomerCountRank(CrmStatisticsRankReqVO rankReqVO);
-
-}
-package cn.iocoder.yudao.module.crm.service.statistics;
-
-import cn.hutool.core.collection.CollUtil;
-import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankReqVO;
-import cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO;
-import cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsRankMapper;
-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 jakarta.annotation.Resource;
-import org.springframework.stereotype.Service;
-import org.springframework.validation.annotation.Validated;
-
-import java.util.Collections;
-import java.util.Comparator;
-import java.util.List;
-import java.util.Map;
-import java.util.function.Function;
-
-import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
-import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
-
-/**
- * CRM 排行榜统计 Service 实现类
- *
- * @author anhaohao
- */
-@Service
-@Validated
-public class CrmStatisticsRankServiceImpl implements CrmStatisticsRankService {
-
-    @Resource
-    private CrmStatisticsRankMapper rankMapper;
-
-    @Resource
-    private AdminUserApi adminUserApi;
-    @Resource
-    private DeptApi deptApi;
-
-    @Override
-    public List<CrmStatisticsRankRespVO> getContractPriceRank(CrmStatisticsRankReqVO rankReqVO) {
-        return getRank(rankReqVO, rankMapper::selectContractPriceRank);
-    }
-
-    @Override
-    public List<CrmStatisticsRankRespVO> getReceivablePriceRank(CrmStatisticsRankReqVO rankReqVO) {
-        return getRank(rankReqVO, rankMapper::selectReceivablePriceRank);
-    }
-
-    @Override
-    public List<CrmStatisticsRankRespVO> getContractCountRank(CrmStatisticsRankReqVO rankReqVO) {
-        return getRank(rankReqVO, rankMapper::selectContractCountRank);
-    }
-
-    @Override
-    public List<CrmStatisticsRankRespVO> getProductSalesRank(CrmStatisticsRankReqVO rankReqVO) {
-        return getRank(rankReqVO, rankMapper::selectProductSalesRank);
-    }
-
-    @Override
-    public List<CrmStatisticsRankRespVO> getCustomerCountRank(CrmStatisticsRankReqVO rankReqVO) {
-        return getRank(rankReqVO, rankMapper::selectCustomerCountRank);
-    }
-
-    @Override
-    public List<CrmStatisticsRankRespVO> getContactsCountRank(CrmStatisticsRankReqVO rankReqVO) {
-        return getRank(rankReqVO, rankMapper::selectContactsCountRank);
-    }
-
-    @Override
-    public List<CrmStatisticsRankRespVO> getFollowCountRank(CrmStatisticsRankReqVO rankReqVO) {
-        return getRank(rankReqVO, rankMapper::selectFollowCountRank);
-    }
-
-    @Override
-    public List<CrmStatisticsRankRespVO> getFollowCustomerCountRank(CrmStatisticsRankReqVO rankReqVO) {
-        return getRank(rankReqVO, rankMapper::selectFollowCustomerCountRank);
-    }
-
-    /**
-     * 获得排行版数据
-     *
-     * @param rankReqVO    参数
-     * @param rankFunction 排行榜方法
-     * @return 排行版数据
-     */
-    private List<CrmStatisticsRankRespVO> getRank(CrmStatisticsRankReqVO rankReqVO, Function<CrmStatisticsRankReqVO, List<CrmStatisticsRankRespVO>> rankFunction) {
-        // 1. 获得用户编号数组
-        rankReqVO.setUserIds(getUserIds(rankReqVO.getDeptId()));
-        if (CollUtil.isEmpty(rankReqVO.getUserIds())) {
-            return Collections.emptyList();
-        }
-        // 2. 获得排行数据
-        List<CrmStatisticsRankRespVO> ranks = rankFunction.apply(rankReqVO);
-        if (CollUtil.isEmpty(ranks)) {
-            return Collections.emptyList();
-        }
-        ranks.sort(Comparator.comparing(CrmStatisticsRankRespVO::getCount).reversed());
-        // 3. 拼接用户信息
-        appendUserInfo(ranks);
-        return ranks;
-    }
-
-    /**
-     * 拼接用户信息（昵称、部门）
-     *
-     * @param ranks 排行榜数据
-     */
-    private void appendUserInfo(List<CrmStatisticsRankRespVO> ranks) {
-        Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(convertSet(ranks, CrmStatisticsRankRespVO::getOwnerUserId));
-        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(convertSet(userMap.values(), AdminUserRespDTO::getDeptId));
-        ranks.forEach(rank -> MapUtils.findAndThen(userMap, rank.getOwnerUserId(), user -> {
-            rank.setNickname(user.getNickname());
-            MapUtils.findAndThen(deptMap, user.getDeptId(), dept -> rank.setDeptName(dept.getName()));
-        }));
-    }
-
-    /**
-     * 获得部门下的用户编号数组，包括子部门的
-     *
-     * @param deptId 部门编号
-     * @return 用户编号数组
-     */
-    public List<Long> getUserIds(Long deptId) {
-        // 1. 获得部门列表
-        List<Long> deptIds = convertList(deptApi.getChildDeptList(deptId), DeptRespDTO::getId);
-        deptIds.add(deptId);
-        // 2. 获得用户编号
-        return convertList(adminUserApi.getUserListByDeptIds(deptIds), AdminUserRespDTO::getId);
-    }
-
-}
 \ No newline at end of file
-package cn.iocoder.yudao.module.crm.util;
-
-import cn.hutool.core.lang.Assert;
-import cn.iocoder.yudao.module.bpm.enums.task.BpmTaskStatusEnum;
-import cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum;
-
-/**
- * CRM 流程工具类
- *
- * @author HUIHUI
- */
-public class CrmAuditStatusUtils {
-
-    /**
-     * BPM 审批结果转换
-     *
-     * @param bpmResult BPM 审批结果
-     */
-    public static Integer convertBpmResultToAuditStatus(Integer bpmResult) {
-        Integer auditStatus = BpmTaskStatusEnum.APPROVE.getStatus().equals(bpmResult) ? CrmAuditStatusEnum.APPROVE.getStatus()
-                : BpmTaskStatusEnum.REJECT.getStatus().equals(bpmResult) ? CrmAuditStatusEnum.REJECT.getStatus()
-                : BpmTaskStatusEnum.CANCEL.getStatus().equals(bpmResult) ? BpmTaskStatusEnum.CANCEL.getStatus() : null;
-        Assert.notNull(auditStatus, "BPM 审批结果({}) 转换失败", bpmResult);
-        return auditStatus;
-    }
-
-}
-package cn.iocoder.yudao.module.crm.util;
-
-import cn.hutool.core.collection.CollUtil;
-import cn.hutool.extra.spring.SpringUtil;
-import cn.iocoder.yudao.module.crm.dal.dataobject.permission.CrmPermissionDO;
-import cn.iocoder.yudao.module.crm.enums.common.CrmBizTypeEnum;
-import cn.iocoder.yudao.module.crm.enums.common.CrmSceneTypeEnum;
-import cn.iocoder.yudao.module.crm.enums.permission.CrmPermissionLevelEnum;
-import cn.iocoder.yudao.module.system.api.permission.PermissionApi;
-import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
-import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
-import cn.iocoder.yudao.module.system.enums.permission.RoleCodeEnum;
-import com.baomidou.mybatisplus.core.toolkit.support.SFunction;
-import com.github.yulichang.autoconfigure.MybatisPlusJoinProperties;
-import com.github.yulichang.wrapper.MPJLambdaWrapper;
-
-import java.util.List;
-
-import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
-import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
-
-/**
- * 数据权限工具类
- *
- * @author HUIHUI
- */
-public class CrmPermissionUtils {
-
-    /**
-     * 校验用户是否是 CRM 管理员
-     *
-     * @return 是/否
-     */
-    public static boolean isCrmAdmin() {
-        PermissionApi permissionApi = SpringUtil.getBean(PermissionApi.class);
-        return permissionApi.hasAnyRoles(getLoginUserId(), RoleCodeEnum.CRM_ADMIN.getCode());
-    }
-
-    /**
-     * 构造 CRM 数据类型数据【分页】查询条件
-     *
-     * @param query     连表查询对象
-     * @param bizType   数据类型 {@link CrmBizTypeEnum}
-     * @param bizId     数据编号
-     * @param userId    用户编号
-     * @param sceneType 场景类型
-     */
-    public static <T extends MPJLambdaWrapper<?>, S> void appendPermissionCondition(T query, Integer bizType, SFunction<S, ?> bizId,
-                                                                                    Long userId, Integer sceneType) {
-        MybatisPlusJoinProperties mybatisPlusJoinProperties = SpringUtil.getBean(MybatisPlusJoinProperties.class);
-        final String ownerUserIdField = mybatisPlusJoinProperties.getTableAlias() + ".owner_user_id";
-        // 场景一：我负责的数据
-        if (CrmSceneTypeEnum.isOwner(sceneType)) {
-            query.eq(ownerUserIdField, userId);
-        }
-        // 场景二：我参与的数据（我有读或写权限，并且不是负责人）
-        if (CrmSceneTypeEnum.isInvolved(sceneType)) {
-            if (CrmPermissionUtils.isCrmAdmin()) { // 特殊逻辑：如果是超管，直接查询所有，不过滤数据权限
-                return;
-            }
-            query.innerJoin(CrmPermissionDO.class, on -> on.eq(CrmPermissionDO::getBizType, bizType)
-                    .eq(CrmPermissionDO::getBizId, bizId)
-                    .in(CrmPermissionDO::getLevel, CrmPermissionLevelEnum.READ.getLevel(), CrmPermissionLevelEnum.WRITE.getLevel())
-                    .eq(CrmPermissionDO::getUserId,userId));
-            query.ne(ownerUserIdField, userId);
-        }
-        // 场景三：下属负责的数据（下属是负责人）
-        if (CrmSceneTypeEnum.isSubordinate(sceneType)) {
-            AdminUserApi adminUserApi = SpringUtil.getBean(AdminUserApi.class);
-            List<AdminUserRespDTO> subordinateUsers = adminUserApi.getUserListBySubordinate(userId);
-            if (CollUtil.isEmpty(subordinateUsers)) {
-                query.eq(ownerUserIdField, -1); // 不返回任何结果
-            } else {
-                query.in(ownerUserIdField, convertSet(subordinateUsers, AdminUserRespDTO::getId));
-            }
-        }
-    }
-
-}
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
-<mapper namespace="cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsFunnelMapper">
-
-    <select id="selectCustomerCountByDate" resultType="java.lang.Long">
-        SELECT
-            COUNT(*)
-        FROM crm_customer
-        WHERE deleted = 0
-        AND owner_user_id IN
-        <!-- TODO @puhui999：这个 foreach 搞个缩进哈 - -->
-        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-            #{userId}
-        </foreach>
-        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime} AND
-        <!-- TODO @puhui999：下面这个，就不缩进啦 - -->
-        #{times[1],javaType=java.time.LocalDateTime}
-    </select>
-
-    <select id="selectBusinessCountByDateAndEndStatus" resultType="java.lang.Long">
-        SELECT
-            COUNT(*)
-        FROM crm_business
-        WHERE deleted = 0
-        <if test="status != null">
-            AND end_status = #{status}
-        </if>
-        AND owner_user_id IN
-        <foreach collection="reqVO.userIds" item="userId" open="(" close=")" separator=",">
-            #{userId}
-        </foreach>
-        AND create_time BETWEEN #{reqVO.times[0],javaType=java.time.LocalDateTime} AND
-        #{reqVO.times[1],javaType=java.time.LocalDateTime}
-    </select>
-
-    <select id="selectBusinessSummaryListGroupByEndStatus"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.funnel.CrmStatisticsBusinessSummaryByEndStatusRespVO">
-        SELECT
-            end_status AS endStatus,
-            COUNT(*) AS businessCount,
-            SUM(total_price) AS totalPrice
-        FROM crm_business
-        WHERE deleted = 0 AND end_status IS NOT NULL
-        AND owner_user_id IN
-        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-            #{userId}
-        </foreach>
-        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime} AND
-        #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY end_status
-    </select>
-
-    <select id="selectBusinessSummaryGroupByDate"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.funnel.CrmStatisticsBusinessSummaryByDateRespVO">
-        SELECT
-            DATE_FORMAT(create_time, '%Y-%m-%d') AS time,
-            COUNT(*) AS businessCreateCount,
-            SUM(total_price) AS totalPrice
-        FROM crm_business
-        WHERE deleted = 0
-        AND owner_user_id IN
-        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-            #{userId}
-        </foreach>
-        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime} AND
-        #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY time
-    </select>
-
-    <select id="selectBusinessInversionRateSummaryByDate"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.funnel.CrmStatisticsBusinessInversionRateSummaryByDateRespVO">
-        SELECT
-            DATE_FORMAT(create_time, '%Y-%m-%d') AS time,
-            COUNT(*) AS businessCount,
-            SUM(IF(end_status = 1, 1, 0)) AS businessWinCount
-        FROM crm_business
-        WHERE deleted = 0
-        AND owner_user_id IN
-        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-            #{userId}
-        </foreach>
-        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime} AND
-        #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY time
-    </select>
-
-</mapper>
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
-<mapper namespace="cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsPerformanceMapper">
-
-    <select id="selectContractCountPerformance"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO">
-        SELECT
-            DATE_FORMAT(order_date, '%Y%m') AS time,
-            COUNT(1) AS currentMonthCount
-        FROM crm_contract
-        WHERE deleted = 0
-        AND audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
-        AND owner_user_id in
-            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-                #{userId}
-            </foreach>
-        AND order_date between #{times[0],javaType=java.time.LocalDateTime} and
-            #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY time
-    </select>
-
-    <select id="selectContractPricePerformance"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO">
-        SELECT
-            DATE_FORMAT(order_date, '%Y%m') AS time,
-            IFNULL(SUM(total_price), 0) AS currentMonthCount
-        FROM crm_contract
-        WHERE deleted = 0
-        AND audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
-        AND owner_user_id in
-            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-                #{userId}
-            </foreach>
-        AND order_date between #{times[0],javaType=java.time.LocalDateTime} and
-            #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY time
-    </select>
-
-    <select id="selectReceivablePricePerformance"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.performance.CrmStatisticsPerformanceRespVO">
-        SELECT
-            DATE_FORMAT(return_time, '%Y%m') AS time,
-            IFNULL(SUM(price), 0) AS currentMonthCount
-        FROM crm_receivable
-        WHERE deleted = 0
-        AND audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
-        AND owner_user_id in
-            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-                #{userId}
-            </foreach>
-        AND return_time between #{times[0],javaType=java.time.LocalDateTime} and
-            #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY time
-    </select>
-
-</mapper>
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
-<mapper namespace="cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsPortraitMapper">
-
-    <select id="selectSummaryListGroupByAreaId"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.portrait.CrmStatisticCustomerAreaRespVO">
-        SELECT area_id, COUNT(*) AS customerCount, SUM(deal_status) AS dealCount
-        FROM crm_customer
-        WHERE deleted = 0 AND area_id IS NOT NULL
-        AND owner_user_id IN
-        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-            #{userId}
-        </foreach>
-        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime}
-        AND #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY area_id
-    </select>
-
-    <select id="selectCustomerIndustryListGroupByIndustryId"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.portrait.CrmStatisticCustomerIndustryRespVO">
-        SELECT industry_id, COUNT(*) AS customerCount, SUM(deal_status) AS dealCount
-        FROM crm_customer
-        WHERE deleted = 0 AND industry_id IS NOT NULL
-        AND owner_user_id IN
-        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-            #{userId}
-        </foreach>
-        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime}
-        AND #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY industry_id
-    </select>
-
-    <select id="selectCustomerSourceListGroupBySource"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.portrait.CrmStatisticCustomerSourceRespVO">
-        SELECT source, COUNT(*) AS customerCount, SUM(deal_status) AS dealCount
-        FROM crm_customer
-        WHERE deleted = 0 AND source IS NOT NULL
-        AND owner_user_id IN
-        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-            #{userId}
-        </foreach>
-        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime}
-        AND #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY source
-    </select>
-
-    <select id="selectCustomerLevelListGroupByLevel"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.portrait.CrmStatisticCustomerLevelRespVO">
-        SELECT level, COUNT(*) AS customerCount, SUM(deal_status) AS dealCount
-        FROM crm_customer
-        WHERE deleted = 0 AND level IS NOT NULL
-        AND owner_user_id IN
-        <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-            #{userId}
-        </foreach>
-        AND create_time BETWEEN #{times[0],javaType=java.time.LocalDateTime}
-        AND #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY level
-    </select>
-
-</mapper>
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
-<mapper namespace="cn.iocoder.yudao.module.crm.dal.mysql.statistics.CrmStatisticsRankMapper">
-
-    <select id="selectContractPriceRank"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
-        SELECT IFNULL(SUM(total_price), 0) AS count, owner_user_id
-        FROM crm_contract
-        WHERE deleted = 0
-        AND audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
-        and owner_user_id in
-            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-                #{userId}
-            </foreach>
-        AND order_date between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY owner_user_id
-    </select>
-
-    <select id="selectReceivablePriceRank"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
-        SELECT IFNULL(SUM(price), 0) AS count, owner_user_id
-        FROM crm_receivable
-        WHERE deleted = 0
-        AND audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
-        AND owner_user_id in
-            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-                #{userId}
-            </foreach>
-        AND return_time between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY owner_user_id
-    </select>
-
-    <select id="selectContractCountRank"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
-        SELECT COUNT(1) AS count, owner_user_id
-        FROM crm_contract
-        WHERE deleted = 0
-        AND audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
-        AND owner_user_id in
-            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-                #{userId}
-            </foreach>
-        AND order_date between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY owner_user_id
-    </select>
-
-    <select id="selectProductSalesRank"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
-        SELECT COUNT(product.count) AS count, contract.owner_user_id
-        FROM crm_contract_product product
-        INNER JOIN crm_contract contract ON product.contract_id = contract.id
-        WHERE contract.deleted = 0 AND contract.deleted = 0
-        AND contract.audit_status = ${@cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum@APPROVE.status}
-        AND contract.owner_user_id in
-            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-                #{userId}
-            </foreach>
-        AND contract.order_date between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY contract.owner_user_id
-    </select>
-
-    <select id="selectCustomerCountRank"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
-        SELECT COUNT(1) AS count, owner_user_id
-        FROM crm_customer
-        WHERE deleted = 0
-        AND owner_user_id in
-            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-                #{userId}
-            </foreach>
-        AND create_time between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY owner_user_id
-    </select>
-
-    <select id="selectContactsCountRank"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
-        SELECT COUNT(1) AS count, owner_user_id
-        FROM crm_contact
-        WHERE deleted = 0
-        AND owner_user_id in
-            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-                #{userId}
-            </foreach>
-        AND create_time between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY owner_user_id
-    </select>
-
-    <select id="selectFollowCountRank"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
-        SELECT COUNT(1) AS count, cc.owner_user_id
-        FROM crm_follow_up_record AS cfur
-        LEFT JOIN crm_contact AS cc ON FIND_IN_SET(cc.id, cfur.contact_ids)
-        WHERE cfur.deleted = 0
-        AND cc.deleted = 0
-        AND cc.owner_user_id in
-            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-                #{userId}
-            </foreach>
-        AND cfur.create_time between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY cc.owner_user_id
-    </select>
-
-    <select id="selectFollowCustomerCountRank"
-            resultType="cn.iocoder.yudao.module.crm.controller.admin.statistics.vo.rank.CrmStatisticsRankRespVO">
-        SELECT COUNT(DISTINCT cc.id) AS count, cc.owner_user_id
-        FROM crm_follow_up_record AS cfur
-        LEFT JOIN crm_contact AS cc ON FIND_IN_SET(cc.id, cfur.contact_ids)
-        WHERE cfur.deleted = 0
-        AND cc.deleted = 0
-        AND cc.owner_user_id in
-            <foreach collection="userIds" item="userId" open="(" close=")" separator=",">
-                #{userId}
-            </foreach>
-        AND cfur.create_time between #{times[0],javaType=java.time.LocalDateTime} and #{times[1],javaType=java.time.LocalDateTime}
-        GROUP BY cc.owner_user_id
-    </select>
-
-</mapper>
-spring:
-    main:
-        lazy-initialization: true # 开启懒加载，加快速度
-        banner-mode: off # 单元测试，禁用 Banner
-
---- #################### 数据库相关配置 ####################
-
-spring:
-    # 数据源配置项
-    datasource:
-        name: ruoyi-vue-pro
-        url: jdbc:h2:mem:testdb;MODE=MYSQL;DATABASE_TO_UPPER=false;NON_KEYWORDS=value; # MODE 使用 MySQL 模式；DATABASE_TO_UPPER 配置表和字段使用小写
-        driver-class-name: org.h2.Driver
-        username: sa
-        password:
-        druid:
-            async-init: true # 单元测试，异步初始化 Druid 连接池，提升启动速度
-            initial-size: 1 # 单元测试，配置为 1，提升启动速度
-    sql:
-        init:
-            schema-locations: classpath:/sql/create_tables.sql
-
-    # Redis 配置。Redisson 默认的配置足够使用，一般不需要进行调优
-    data:
-      redis:
-        host: 127.0.0.1 # 地址
-        port: 16379 # 端口（单元测试，使用 16379 端口）
-        database: 0 # 数据库索引
-
-mybatis-plus:
-    lazy-initialization: true # 单元测试，设置 MyBatis Mapper 延迟加载，加速每个单元测试
-    type-aliases-package: ${yudao.info.base-package}.module.*.dal.dataobject
-
---- #################### 定时任务相关配置 ####################
-
---- #################### 配置中心相关配置 ####################
-
---- #################### 服务保障相关配置 ####################
-
-# Lock4j 配置项（单元测试，禁用 Lock4j）
-
---- #################### 监控相关配置 ####################
-
---- #################### 芋道相关配置 ####################
-
-# 芋道配置项，设置当前项目所有自定义的配置
-yudao:
-  info:
-    base-package: cn.iocoder.yudao
@@ -46,11 +46,11 @@
 <!--            <version>${revision}</version>-->
 <!--        </dependency>-->
         <!-- 工作流。默认注释，保证编译速度 -->
-<!--        <dependency>-->
-<!--            <groupId>cn.iocoder.boot</groupId>-->
-<!--            <artifactId>yudao-module-bpm-biz</artifactId>-->
-<!--            <version>${revision}</version>-->
-<!--        </dependency>-->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-module-bpm</artifactId>
+            <version>${revision}</version>
+        </dependency>
         <!-- 支付服务。默认注释，保证编译速度 -->
 <!--        <dependency>-->
 <!--            <groupId>cn.iocoder.boot</groupId>-->
@@ -90,7 +90,7 @@
         <!-- CRM 相关模块。默认注释，保证编译速度 -->
 <!--        <dependency>-->
 <!--            <groupId>cn.iocoder.boot</groupId>-->
-<!--            <artifactId>yudao-module-crm-biz</artifactId>-->
+<!--            <artifactId>yudao-module-crm</artifactId>-->
 <!--            <version>${revision}</version>-->
 <!--        </dependency>-->