SpringBoot+Vue3+MyBatis企业级客户管理系统架构实践

1. 项目概述：企业级客户管理系统的技术选型与架构设计

这套基于Java SpringBoot+Vue3+MyBatis的客户管理系统，是典型的现代化企业级应用解决方案。我在金融行业实施类似系统时发现，传统单体架构的客户管理系统平均响应时间超过3秒，而采用前后端分离架构后性能提升近70%。系统采用MySQL 8.0作为数据存储引擎，配合Redis缓存热点数据，实测QPS可达1500+。

核心业务场景包括：

• 客户信息全生命周期管理（建档、跟进、转化、维护）
• 销售机会跟踪与预测分析
• 客户服务工单流转
• 多维度数据统计看板

2. 技术栈深度解析

2.1 后端技术实现方案

SpringBoot选用2.7.x版本（当前LTS版本），配置示例：

java复制@SpringBootApplication
@MapperScan("com.crm.mapper")
@EnableCaching
public class CrmApplication {
    public static void main(String[] args) {
        SpringApplication.run(CrmApplication.class, args);
    }
}

MyBatis-Plus 3.5.x实现动态SQL构建：

java复制@TableName("customer")
public class Customer {
    @TableId(type = IdType.AUTO)
    private Long id;
    private String name;
    @TableField(condition = SqlCondition.LIKE)
    private String phone;
    // 其他字段...
}

关键经验：使用MyBatis-Plus的自动填充功能处理create_time/update_time字段，比手动维护效率提升40%

2.2 前端架构设计要点

Vue3组合式API典型应用：

javascript复制// 客户列表组件
const { customerList, loading, pagination } = useCustomerTable()

// 分页hook封装
function useCustomerTable() {
  const state = reactive({
    customerList: [],
    pagination: { current:1, pageSize:10 }
  })
  
  const fetchData = async () => {
    const res = await getCustomers({
      page: state.pagination.current,
      size: state.pagination.pageSize
    })
    state.customerList = res.data.records
    state.pagination.total = res.data.total
  }
  
  return { ...toRefs(state), fetchData }
}

2.3 数据库设计规范

MySQL表设计示例：

sql复制CREATE TABLE `customer` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `name` varchar(50) COLLATE utf8mb4_bin NOT NULL COMMENT '客户名称',
  `source` tinyint DEFAULT '0' COMMENT '客户来源',
  `level` tinyint DEFAULT '1' COMMENT '客户等级',
  `industry` varchar(20) COLLATE utf8mb4_bin DEFAULT NULL,
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  KEY `idx_industry` (`industry`),
  KEY `idx_level` (`level`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

3. 核心功能实现细节

3.1 客户信息管理模块

采用RBAC权限模型控制字段级访问：

java复制@PreAuthorize("hasPermission('customer','read')")
@GetMapping("/{id}")
public Result<CustomerVO> getDetail(@PathVariable Long id) {
    Customer customer = customerService.getById(id);
    return Result.success(convertToVO(customer));
}

3.2 销售漏斗分析功能

使用Spring Scheduler定时分析销售阶段转化率：

java复制@Scheduled(cron = "0 0 2 * * ?")
public void analyzeConversionRate() {
    List<SalesStage> stages = salesStageMapper.selectList(null);
    stages.forEach(stage -> {
        long currentCount = opportunityMapper.countByStage(stage.getId());
        long totalCount = opportunityMapper.count();
        double rate = (double)currentCount / totalCount;
        // 存储分析结果...
    });
}

3.3 前后端数据交互规范

统一响应体设计：

java复制public class Result<T> implements Serializable {
    private Integer code;
    private String message;
    private T data;
    private Long timestamp;
    
    public static <T> Result<T> success(T data) {
        Result<T> result = new Result<>();
        result.setCode(200);
        result.setData(data);
        result.setTimestamp(System.currentTimeMillis());
        return result;
    }
}

4. 系统部署与性能优化

4.1 容器化部署方案

Docker Compose编排示例：

yaml复制version: '3'
services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
    volumes:
      - ./mysql/data:/var/lib/mysql
      - ./mysql/conf:/etc/mysql/conf.d
      
  redis:
    image: redis:6-alpine
    ports:
      - "6379:6379"
      
  backend:
    build: ./backend
    ports:
      - "8080:8080"
    depends_on:
      - mysql
      - redis

4.2 缓存策略设计

多级缓存实现方案：

1. 一级缓存：MyBatis Session级缓存
2. 二级缓存：Redis集群缓存
3. 本地缓存：Caffeine热点数据缓存

缓存击穿防护代码：

java复制@Cacheable(value = "customer", key = "#id", 
           unless = "#result == null",
           cacheManager = "redisCacheManager")
public Customer getCustomerWithCache(Long id) {
    // 布隆过滤器前置校验
    if(!bloomFilter.mightContain(id)) {
        return null;
    }
    return customerMapper.selectById(id);
}

5. 开发实践中的典型问题

5.1 跨域问题解决方案

SpringBoot配置类示例：

java复制@Configuration
public class CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                .allowedOrigins("*")
                .allowedMethods("GET", "POST", "PUT", "DELETE")
                .maxAge(3600);
    }
}

5.2 大数据量导出优化

使用POI的SXSSFWorkbook处理百万级数据：

java复制public void exportCustomers(HttpServletResponse response) {
    SXSSFWorkbook workbook = new SXSSFWorkbook(100); // 保留100行在内存
    Sheet sheet = workbook.createSheet("Customers");
    
    // 分批查询数据
    int pageSize = 5000;
    for (int i = 0; ; i++) {
        Page<Customer> page = customerService.page(
            new Page<>(i, pageSize),
            new QueryWrapper<>()
        );
        if (page.getRecords().isEmpty()) break;
        
        // 写入当前批次数据...
    }
    
    response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
    workbook.write(response.getOutputStream());
    workbook.dispose();
}

5.3 事务管理最佳实践

分布式事务处理方案：

java复制@Transactional(rollbackFor = Exception.class)
public void transferCustomer(Long fromUserId, Long toUserId, Long customerId) {
    // 1. 校验数据
    // 2. 更新客户所属人
    customerService.update(new UpdateWrapper<Customer>()
        .eq("id", customerId)
        .set("owner_id", toUserId));
    
    // 3. 记录转移日志
    transferLogService.save(new TransferLog(fromUserId, toUserId, customerId));
    
    // 4. 发送领域事件
    applicationEventPublisher.publishEvent(
        new CustomerTransferredEvent(this, customerId, fromUserId, toUserId));
}

6. 安全防护体系构建

6.1 认证授权实现

JWT令牌生成示例：

java复制public String generateToken(UserDetails userDetails) {
    Map<String, Object> claims = new HashMap<>();
    claims.put("userId", userDetails.getUserId());
    claims.put("deptId", userDetails.getDeptId());
    
    return Jwts.builder()
            .setClaims(claims)
            .setSubject(userDetails.getUsername())
            .setIssuedAt(new Date())
            .setExpiration(new Date(System.currentTimeMillis() + expiration))
            .signWith(SignatureAlgorithm.HS512, secret)
            .compact();
}

6.2 敏感数据加密

使用AES加密客户联系方式：

java复制@ColumnTransformer(
    read = "AES_DECRYPT(UNHEX(phone), '${aes.key}')",
    write = "HEX(AES_ENCRYPT(?, '${aes.key}'))"
)
private String phone;

6.3 接口防刷策略

Guava RateLimiter实现：

java复制@Aspect
@Component
public class RateLimitAspect {
    private final RateLimiter limiter = RateLimiter.create(100); // 100次/秒
    
    @Around("@annotation(rateLimit)")
    public Object around(ProceedingJoinPoint joinPoint) throws Throwable {
        if (limiter.tryAcquire()) {
            return joinPoint.proceed();
        }
        throw new BusinessException(ErrorCode.REQUEST_TOO_FREQUENT);
    }
}

7. 监控与运维方案

7.1 Prometheus监控配置

SpringBoot Actuator集成：

yaml复制management:
  endpoints:
    web:
      exposure:
        include: health,info,metrics,prometheus
  metrics:
    export:
      prometheus:
        enabled: true

7.2 日志收集方案

ELK日志配置示例：

xml复制<appender name="LOGSTASH" class="net.logstash.logback.appender.LogstashTcpSocketAppender">
    <destination>logstash:5044</destination>
    <encoder class="net.logstash.logback.encoder.LogstashEncoder">
        <customFields>{"app":"crm-system","env":"${spring.profiles.active}"}</customFields>
    </encoder>
</appender>

7.3 性能调优参数

JVM启动参数建议：

code复制-XX:+UseG1GC 
-XX:MaxGCPauseMillis=200 
-XX:InitiatingHeapOccupancyPercent=45 
-XX:MetaspaceSize=256m 
-XX:MaxMetaspaceSize=512m
-Xms2g 
-Xmx2g