SpringBoot+MyBatis销售团队CRM系统开发实践

1. 项目概述

这个销售团队后台管理系统是基于SpringBoot框架开发的企业级应用，主要面向销售团队的管理需求。系统采用前后端分离架构，后端使用Java+SpringBoot+MyBatis技术栈，前端采用FreeMarker+Bootstrap+ECharts的组合方案。

作为一个完整的CRM系统，它包含了销售团队日常工作中最核心的几个功能模块：客户管理、业务机会跟踪、日报系统以及组织架构管理。特别值得一提的是，系统内置了数据可视化看板，通过ECharts实现了销售数据的直观展示，这对销售团队的决策支持非常有帮助。

2. 技术架构解析

2.1 后端技术选型

SpringBoot 2.x作为基础框架，这是目前Java领域最主流的微服务框架。选择它的原因主要有三点：

1. 自动配置特性大大减少了XML配置的工作量
2. 内嵌Tomcat服务器，简化了部署流程
3. 丰富的starter依赖可以快速集成各种组件

MyBatis作为ORM框架，相比Hibernate更轻量级，对于需要精细控制SQL的场景特别适合。我们在项目中大量使用了MyBatis的动态SQL功能，比如：

java复制@SelectProvider(type = CustomerSqlProvider.class, method = "findByCondition")
List<Customer> findByCondition(QueryCustomerVo vo);

2.2 前端技术方案

FreeMarker作为模板引擎，替代了传统的JSP。它的优势在于：

• 模板与业务逻辑完全分离
• 性能优于JSP
• 语法简洁，学习成本低

前端UI基于Bootstrap 4构建响应式布局，确保在PC和移动设备上都有良好的显示效果。数据可视化则使用ECharts 5，这是一个功能强大且文档完善的图表库。

3. 核心功能实现

3.1 权限管理系统

系统采用RBAC（基于角色的访问控制）模型，包含用户、角色、菜单三个核心实体。权限控制通过自定义注解和拦截器实现：

java复制@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface RequirePermission {
    String value();
}

public class PermissionInterceptor extends HandlerInterceptorAdapter {
    @Override
    public boolean preHandle(HttpServletRequest request, 
                           HttpServletResponse response, 
                           Object handler) throws Exception {
        // 权限校验逻辑
    }
}

3.2 客户管理模块

客户信息管理包含基础CRUD操作和高级查询功能。我们设计了客户分类、行业类型等维度数据，便于后续统计分析。一个典型的高级查询实现如下：

java复制public PageInfo<Customer> find(QueryCustomerVo vo) {
    PageHelper.startPage(vo.getPageNum(), vo.getPageSize());
    List<Customer> list = customerMapper.findByCondition(vo);
    return new PageInfo<>(list);
}

3.3 日报系统

日报系统分为个人日报和团队日报两个视图：

• 个人日报：展示当前用户的工作记录
• 团队日报：部门负责人可以查看下属的日报

日报数据通过Activity实体进行建模，包含活动类型、客户关联、内容描述等字段。团队日报的查询逻辑涉及组织架构的层级关系：

java复制public PageInfo<Activity> findTeamDailyReport(QueryActivityVo vo) {
    // 获取当前用户的所有下属ID
    List<Integer> subordinate = orgUnitService.findSubordinate(getUser().getUserId());
    vo.setCreateBy(subordinate);
    return activityService.find(vo);
}

4. 数据可视化实现

4.1 ECharts集成

系统看板使用ECharts展示销售漏斗、业绩趋势等关键指标。后端提供JSON格式的数据接口，前端通过AJAX获取数据后渲染图表：

javascript复制$.post('/dashboard/salesTrend', function(data) {
    var chart = echarts.init(document.getElementById('trend-chart'));
    chart.setOption({
        xAxis: {data: data.categories},
        yAxis: {},
        series: [{data: data.values}]
    });
});

4.2 Excel导出功能

系统提供了数据导出功能，基于Apache POI实现。我们封装了一个通用的Excel导出工具类：

java复制public <T> void export(String fileName, List<T> data) {
    // 创建Workbook
    HSSFWorkbook workbook = new HSSFWorkbook();
    // 设置表头
    HSSFRow headerRow = sheet.createRow(0);
    // 填充数据行
    for (int i = 0; i < data.size(); i++) {
        T item = data.get(i);
        HSSFRow row = sheet.createRow(i + 1);
        // 反射获取字段值
        field.setAccessible(true);
        Object value = field.get(item);
        // 设置单元格值
        cell.setCellValue(value.toString());
    }
}

5. 项目部署与配置

5.1 开发环境要求

• JDK 1.8+
• MySQL 5.7+
• Maven 3.6+
• IDE推荐使用IntelliJ IDEA

5.2 数据库配置

在application.properties中配置数据库连接：

properties复制spring.datasource.url=jdbc:mysql://localhost:3306/sales_crm?useSSL=false
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

5.3 系统初始化

项目启动时会自动执行init.sql脚本，创建必要的表结构和初始化数据。管理员账号为admin/123456。

6. 开发经验分享

6.1 前后端分离实践

虽然使用了FreeMarker作为模板引擎，但我们仍然遵循前后端分离的原则：

• 后端只提供RESTful API
• 前端通过AJAX获取数据
• FreeMarker仅负责页面骨架的渲染

这种架构既保留了传统MVC的便利性，又具备了前后端分离的灵活性。

6.2 MyBatis使用技巧

在复杂查询场景下，我们推荐使用MyBatis的注解方式动态SQL：

java复制@Select("<script>" +
        "SELECT * FROM customer " +
        "<where>" +
        "   <if test='name != null'>AND name LIKE CONCAT('%',#{name},'%')</if>" +
        "   <if test='categoryId != null'>AND category_id = #{categoryId}</if>" +
        "</where>" +
        "</script>")
List<Customer> searchCustomers(@Param("name") String name, 
                              @Param("categoryId") Integer categoryId);

6.3 性能优化建议

1. 数据库层面：

   • 为常用查询条件添加索引
   • 避免SELECT *，只查询需要的字段
   • 大数据量分页使用PageHelper

2. 应用层面：

   • 频繁访问的数据使用Redis缓存
   • 静态资源启用CDN加速
   • 启用Gzip压缩减少网络传输

7. 常见问题排查

7.1 登录失败

可能原因：

1. 用户名或密码错误
2. 账号被禁用
3. 数据库连接异常

排查步骤：

1. 检查控制台日志是否有SQL异常
2. 直接查询数据库确认账号状态
3. 测试数据库连接是否正常

7.2 页面加载缓慢

优化建议：

1. 检查Nginx/Apache配置是否启用了Gzip
2. 合并CSS/JS文件减少HTTP请求
3. 使用Chrome开发者工具分析性能瓶颈

7.3 Excel导出乱码

解决方案：

1. 确保响应头设置了正确的Content-Type

java复制response.setContentType("application/vnd.ms-excel;charset=UTF-8");

2. 文件名进行URL编码

java复制String fileName = URLEncoder.encode("客户列表.xls", "UTF-8");
response.setHeader("Content-Disposition", "attachment;filename=" + fileName);

8. 项目扩展方向

这个系统还有很大的扩展空间，以下是一些可能的改进方向：

1. 移动端适配：开发专门的H5页面或小程序
2. 工作流引擎：集成Activiti实现销售审批流程
3. 消息通知：集成WebSocket实现实时消息推送
4. 第三方集成：对接企业微信、钉钉等平台

在实际开发中，我们遇到的一个典型挑战是组织架构的树形展示。最初使用递归查询性能较差，后来改为一次性查询所有节点，在内存中构建树形结构，性能提升了10倍以上。这个经验告诉我们，有时候数据库操作越少越好，合理利用应用层计算反而能获得更好的性能。