前言在企业级SaaS与微服务开发中CRM客户模块是业务拓展类系统的核心基础模块。自研客户管理系统普遍存在客户数据重复、归属权限混乱、公海回收逻辑复杂、多租户数据穿透等技术问题。尤其是多销售、多团队并行开发跟进场景数据控制逻辑编写繁琐、极易出现漏洞。EzCloud 独立拆分ez-cloud-crm插件模块完全解耦于底层框架与其他业务模块统一封装客户新增查重、客户归属、公海流转、跟进记录、数据权限隔离等底层通用逻辑代码分层规范可作为微服务客户模块开发的标准参考实现。1、EzCloud CRM模块工程分层结构CRM模块内部采用精细化业务分层职责单一、互不耦合crm-customer 客户主体层负责客户基础信息的新增、编辑、归档、查重、状态管理crm-follow 跟进记录层统一封装客户跟进、回访记录、跟进日志时序逻辑crm-public 客户公海层实现公海释放、自动回收、抢单分配、客户流转规则所有客户数据权限、流转规则统一收敛在CRM模块内部其他业务模块仅通过Feign标准接口调用数据不直接操作客户底层数据表保证数据一致性与安全性。2、核心源码客户防重复租户隔离校验实现多租户场景下客户手机号、企业名称重复是高频问题模块内置全局唯一校验逻辑规避跨重复客户数据核心源码如下https://gitee.com/tan-tianming/ez-cloud.gitService public class CrmCustomerServiceImpl implements CrmCustomerService { Autowired private CrmCustomerMapper customerMapper; Override public void checkCustomerRepeat(String phone, String companyName, Long tenantId) { // 同一租户下手机号唯一校验 LambdaQueryChainWrapperCrmCustomerDO phoneWrapper new LambdaQueryChainWrapper(customerMapper) .eq(CrmCustomerDO::getTenantId, tenantId) .eq(CrmCustomerDO::getPhone, phone); if (phoneWrapper.exists()) { throw new BusinessException(当前租户内已存在该手机号客户); } // 同一租户下企业名称唯一校验 LambdaQueryChainWrapperCrmCustomerDO companyWrapper new LambdaQueryChainWrapper(customerMapper) .eq(CrmCustomerDO::getTenantId, tenantId) .eq(CrmCustomerDO::getCompanyName, companyName); if (companyWrapper.exists()) { throw new BusinessException(当前租户内已存在该企业客户); } } Override Transactional(rollbackFor Exception.class) public void saveCustomer(CrmCustomerDO customerDO) { // 前置查重校验 checkCustomerRepeat(customerDO.getPhone(), customerDO.getCompanyName(), customerDO.getTenantId()); customerDO.setCreateTime(new Date()); customerMapper.insert(customerDO); } }代码技术设计亮点1. 强绑定 tenantId 做数据隔离从代码层面杜绝不同租户客户数据穿透、混淆问题2. 新增客户前置双重查重手机号企业名称规避人工录入导致的数据重复冗余3. 事务包裹新增逻辑保证校验与新增操作原子执行避免并发插入重复数据4. 校验逻辑统一封装对外暴露通用方法新增客户导入、批量新增场景可直接复用。3、CRM核心技术机制客户公海自动流转模块内置标准化公海客户管理机制适配企业销售团队常规管理规则1. 支持自定义未跟进天数阈值超时未跟进客户自动回收至公海池2. 公海客户支持全员抢单、指定人员分配两种模式3. 客户分配后自动锁定归属人防止多人重复跟进、争抢客户4. 所有流转记录持久化留存可追溯客户变更、流转、归属历史。4、模块二次开发拓展特性1. 客户字段完全可拓展可根据行业需求新增行业专属字段无需改动底层校验与流转逻辑2. 客户数据权限与系统RBAC权限体系打通支持按员工、部门维度数据隔离3. 可独立插拔部署无需客户管理业务可直接移除模块不影响ERP、OA、流程引擎运行4. 跟进记录时序封装完整可快速对接消息通知、报表统计、大屏数据展示。总结EzCloud CRM模块解决了传统自研客户系统数据重复、权限混乱、流转逻辑复杂的开发痛点以分层解耦架构、标准化校验机制、完整的公海流转逻辑提供了一套可直接复用的微服务客户管理业务方案适合企业级业务系统开发与技术学习参考。