1. 项目整体设计与技术选型拆解1.1 这套后台管理系统到底在管什么做销售团队后台管理系统最先要想清楚的往往不是代码而是业务边界。很多人一上来就设计几十张表把客户、订单、回款、提成、业绩目标、拜访记录全塞进去结果半年过去能用起来的功能没几个。这次分享的这套系统刻意把范围收紧在销售团队最关心的四件事员工管理、客户跟进、订单成交、业绩统计。业务场景可以理解成这样一个简化模型销售员把客户信息录入系统每天更新跟进状态客户有购买意向后销售员在系统里生成订单订单审核通过后系统根据成交金额自动计算业绩和提成月底老板登录后台看一张数据看板按时间、按人员、按客户来源看整体趋势。这个模型不大但覆盖了一个销售团队日常管理的核心闭环用来做SpringBoot练手项目非常合适也完全能支撑一个中小型销售团队的实际运转。1.2 技术选型经典组合背后的取舍这套系统的技术栈是Java生态里很经典的一套SpringBoot Freemarker Bootstrap ECharts MySQL Maven。它不是最近几年流行的那种前后端分离架构而是采用服务端渲染的方式。选择这套组合不是技术上的偷懒而是基于“中小型内部管理系统”这个明确场景做的取舍。SpringBoot负责快速构建后端服务省掉一堆XML配置Freemarker做服务端模板渲染页面可以直接拿到后台数据不需要额外写接口联调Bootstrap管UI组件表格、表单、按钮、分页条都有现成风格ECharts负责把销售趋势、人员业绩排名、客户来源占比等数据可视化MySQL存业务数据Maven管依赖和打包。这套组合的最大优势是开发效率高一个人可以在两三天内把核心功能串起来。维度前后端分离服务端渲染本系统开发成本高需要同时维护前端工程和后端工程低一个工程搞定团队要求需要前端工程师或全栈工程师后端Java开发即可权限控制需处理Token、跨域、路由守卫Session 拦截器逻辑直观适合场景高交互、多端复用、并发较高内部管理系统、报表后台、小型团队所以如果你的目标是一个团队内部使用、数据量在百万以下、不需要多端适配的后台系统服务端渲染反而比前后端分离更省心。很多人盲目跟风前后端分离结果光联调、跨域就折腾了好几周这个教训我在项目里见得太多了。1.3 数据库设计销售数据建模的四个核心表数据库设计是这套系统真正需要花心思的地方。我按“用户—客户—订单—统计”这条主线设计了四张核心表实际项目中还可以拆更多但一开始能少则少后面加表比删表容易得多。用户表保存登录账号和角色信息字段包括用户名、密码、真实姓名、角色、手机号、状态、创建时间。角色只分管理员和销售员两种管理员看全局数据销售员只能看自己的客户和业绩。客户表保存客户基础信息和归属关系重点是owner_user_id这个字段用来标识客户由哪个销售员负责另一个重点是status状态字段用于标记未跟进、跟进中、已成交、已流失。订单表保存成交记录通过customer_id关联客户、user_id关联销售员金额字段用decimal类型精确到两位小数。业绩统计不单独建表需要的时候直接基于订单表做聚合查询这样可以避免数据冗余带来的对账问题。表名核心字段说明sys_userid, username, password, real_name, role, status登录人员customerid, name, phone, source, level, owner_user_id, status, create_time客户档案sale_orderid, order_no, customer_id, user_id, amount, status, order_date成交订单performance基于订单表聚合不落表动态统计设计心得金额这个字段一定要用decimal(10,2)别用float或double否则报表里出现0.30000000000000004这种值会让你怀疑人生。时间字段统一用datetime日期统计用的是order_date需要在上面建索引方便按月份维度查询。外键我建议只做逻辑关联表里存对应的id查询时通过Java代码或JOIN去关联不要物理外键。物理外键在数据量大和业务调整频繁时会成为维护负担团队内部管理系统尤其明显。2. 核心功能实现要点2.1 登录认证与权限控制小系统用拦截器就够了登录和权限是后台系统绕不开的第一道门。这套系统没有引入Spring Security和Shiro这种重型安全框架因为就两个角色、几十个接口的情况下自己写一个拦截器反而更清晰可控。核心方案是登录成功后把用户信息存进Session再自定义一个HandlerInterceptor拦截所有需要权限的请求判断Session里有没有用户、角色是否匹配。具体实现思路是先定义角色常量比如role1代表管理员role2代表销售员。然后写一个AuthInterceptor实现preHandle方法从Session中取出登录用户如果为空就直接重定向到登录页接着根据注解或URL规则判断接口权限比如管理员可以访问/user/list、/order/list等全部接口销售员访问这些的时候返回无权限提示。SpringBoot里注册这个拦截器只需要写一个WebMvcConfigurer实现类覆盖addInterceptors方法配置拦截路径比写一整套Security配置快得多。public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object loginUser request.getSession().getAttribute(loginUser); if (loginUser null) { response.sendRedirect(/login); return false; } return true; } }这里有个特别容易被忽略的坑登录用户的密码不能明文存在数据库里必须用BCrypt或者至少加盐哈希。很多练手项目为了省事直接明文存储上线之后如果数据库泄露整个销售团队的客户资料全完蛋。我在这个项目里用了一个简单的SHA256加盐方案虽然不如BCrypt安全但至少不会让密码直接裸奔。另外session超时时间也需要单独配一下SpringBoot默认的session过期时间是30分钟销售员填了半天客户资料突然跳登录页体验会很差建议配置成60分钟或120分钟。2.2 ECharts数据看板后端接口怎么组织数据前端才能少改代码销售团队后台最重要的一块内容就是数据看板。看板上一般会放三个图表近30天的销售趋势折线图、销售员业绩排名柱状图、客户来源占比饼图。这三个图可以共用一套接口风格后端返回标准JSON格式前端通过Ajax拿数据后直接setOption渲染。以销售趋势为例后端接口返回的数据结构是一个包含两个数组的Map日期数组和成交金额数组。日期格式统一成yyyy-MM-dd金额保留两位小数。前端拿到之后把这两个数组分别塞给ECharts的xAxis和series。这里有一个非常关键的坑如果某一天没有订单聚合结果里就少了这个日期折线图会出现断点。处理办法有两种一种是在SQL层用日期辅助表补齐另一种是在后端根据完整的日期范围遍历补零。我的习惯是在后端补零因为SQL写法更简单而且日期范围由前端参数控制后端更好维护。ListMapString, Object list orderMapper.selectDailySales(startDate, endDate); MapString, BigDecimal map new HashMap(); for (MapString, Object row : list) { String date String.valueOf(row.get(order_date)); map.put(date, (BigDecimal) row.get(total_amount)); } // 按日期范围补齐缺失日期 ListString dateList getDateRange(startDate, endDate); for (String date : dateList) { if (!map.containsKey(date)) { map.put(date, BigDecimal.ZERO); } }ECharts在前端渲染的时候注意给图表容器设置固定高度比如height: 300px。很多新手查了半天“图表不出来”的问题最后发现是div的height是0。此外ECharts的引入地址可以用静态资源路径也可以走CDN但内网部署环境建议把echarts.min.js下载到本地static目录下否则生产环境访问外网CDN可能会很慢甚至超时图表还是会白屏。2.3 客户、订单、业绩三个业务模块怎么串起来这三个模块是后台操作最频繁的地方也是最容易把代码写乱的地方。客户模块的核心是“归属”和“状态”。客户列表查询时管理员可以查所有客户销售员只能查owner_user_id等于自己的客户。查询条件一般包括客户名称、手机号、状态和负责销售员后端用动态SQL拼接条件。分页我用的是PageHelper插件一行代码就能完成分页但要注意PageHelper一定要在查询语句之前调用而且不要连续调用两次否则分页参数会被覆盖这个坑在很多项目里都出现过。订单模块的核心是“成交转化”和“提成计算”。客户状态从“跟进中”变成“已成交”时系统会生成一条订单记录。订单包含订单号、客户ID、销售员ID、成交金额和订单日期。订单审核通过后业绩自动累加到对应销售员的当月绩效里。提成规则可以配置成阶梯模式比如3万以下提成3%3万到10万提成5%超过10万的部分提成8%。实现这种规则不需要设计复杂的规则引擎一个按金额区间遍历的Java方法就够用了。public BigDecimal calcCommission(BigDecimal amount) { if (amount.compareTo(new BigDecimal(30000)) 0) { return amount.multiply(new BigDecimal(0.03)); } else if (amount.compareTo(new BigDecimal(100000)) 0) { return amount.multiply(new BigDecimal(0.05)); } else { return amount.multiply(new BigDecimal(0.08)); } }业绩统计模块我建议直接用SQL聚合别用Java内存计算。比如统计本月每位销售员的业绩一条GROUP BY语句就能搞定。数据量不大时这种写法最清晰后期就算要加其他维度改SQL的成本也最低。3. 实操过程从零搭建这套后台3.1 环境准备与Maven工程初始化先把基础环境列出来JDK 8或JDK 11IDEAMySQL 5.7或8.0Maven 3.6以上。SpringBoot版本选择2.7.x。这个版本兼容性很稳Freemarker集成和MyBatis集成都有成熟方案。在IDEA里新建项目时直接选择Spring InitializrGroup填com.xxxArtifact填sales-manage。依赖不需要贪多核心是spring-boot-starter-web、spring-boot-starter-freemarker、MySQL驱动、mybatis-spring-boot-starter以及lombok。如果你不想用MyBatis换成Spring Data JPA也可以但下面的代码示例我会用MyBatis来说因为团队内部项目里它出现频率更高。pom.xml的核心依赖这样加dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-freemarker/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.2.2/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency注意Maven仓库如果下载依赖慢去settings.xml里把镜像源换成国内镜像。这一步看起来不复杂但几乎每个新手都要卡半小时。另外Maven默认的Java编译版本是1.5记得在pom.xml里显式指定编译级别为1.8否则Java代码里连Lambda表达式都用不了。3.2 项目结构与配置文件Maven工程初始化好之后项目结构按照controller、service、mapper、entity、interceptor、config这几个包来组织。controller只负责接收参数和返回视图或JSONservice层写业务逻辑mapper层是MyBatis的数据访问接口entity对应数据库表实体。这样分层虽然老派但维护起来非常清晰也不会出现几百行的controller。resources目录下重点看application.yml。数据源配置和Freemarker配置是核心server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/sales_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver freemarker: template-loader-path: classpath:/templates/ suffix: .ftl charset: UTF-8 cache: false mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.xxx.sales.entity这里有个小提示数据源URL里的characterEncodingutf8和serverTimezoneAsia/Shanghai一个都不能少。少了前者中文乱码少了后者MySQL时区报错而且MySQL 8.0的驱动类名是com.mysql.cj.jdbc.Driver不是老项目里的com.mysql.jdbc.Driver。3.3 从数据库到页面客户模块完整实现流程客户模块是这套系统里最典型的CRUD功能做完它就是一套流水线流程。第一步建表SQL大致是这样的CREATE TABLE customer ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, phone VARCHAR(20), source VARCHAR(20), level VARCHAR(10), owner_user_id INT NOT NULL, status TINYINT DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP );第二步创建实体类字段和表对应。我用Lombok省去了getter和setterData注解直接搞定。第三步写Mapper接口核心是一个list方法按条件查询配合XML里写的动态SQL。第四步写Service调用Mapper并处理分页参数。第五步写Controller接收请求参数、返回ModelAndView或Model把客户列表数据传给Freemarker页面。Freemarker页面里展示表格核心代码类似这样table classtable table-bordered tr th客户名称/th th手机号/th th客户来源/th th负责人/th th状态/th th操作/th /tr #list customerList as customer tr td${customer.name}/td td${customer.phone}/td td${customer.source}/td td${customer.ownerName}/td td${customer.statusText}/td tda href/customer/edit/${customer.id}编辑/a/td /tr /#list /table这里要注意的是Freemarker模板里输出变量时如果变量为null页面会直接报错。所以实体类里面的状态字段和负责人姓名字段要么在Service层提前转换好文本要么用默认值兜底。我在项目里习惯在Service层把这些展示字段拼好模板里只负责显示这样即使以后换前端框架业务数据也完整。3.4 看板接口与ECharts接入看板页面的开发相对独立。后端先提供一个接口比如/api/dashboard/salesTrend参数是startDate和endDate返回JSON格式的日期列表和金额列表。前端页面不管整套接口有多复杂只需要关心两个数组是否对齐。页面引入ECharts之后初始化折线图$.ajax({ url: /api/dashboard/salesTrend, data: {startDate: 2025-01-01, endDate: 2025-01-31}, success: function(res) { var chart echarts.init(document.getElementById(trendChart)); chart.setOption({ tooltip: {}, xAxis: { data: res.dateList }, yAxis: {}, series: [{ type: line, data: res.amountList }] }); } });实际做的时候这张图通常会搭配日期选择器让管理员自己选月份。注意选择器传过去的日期不要搞混格式前端用YYYY-MM-DD后端LocalDate.parse就能直接解析。图表渲染完成后务必手动调整一下窗口大小因为很多浏览器在页面加载过程里如果容器尺寸变化图表不会自动重绘。可以在window.resize事件里调用chart.resize()这个细节能让看板页面在缩放窗口时表现得更舒服。4. 常见问题与排查技巧实录4.1 页面中文乱码数据和页面全是问号这个问题出现频率极高原因基本集中在三处。第一是MySQL连接串里没加characterEncodingutf8导致数据库读取乱码第二是Freemarker模板编码不是UTF-8application.yml里需要配置charset: UTF-8第三是页面本身的meta标签可能被漏掉HTML里加上。排查顺序也很有讲究先看数据库里的数据是否正常再看Java后端实体类里的值是否正常最后看浏览器端响应头里的charset。如果前两步都正常只有浏览器乱码那就是模板编码问题。按照这个顺序查基本五分钟内能定位。我记得有一次折腾了很久最后发现是IDEA的File Encoding设置成了GBK导致保存的页面文件本身就是乱码这个坑值得单独提一下新建项目时先检查右下角编码格式。4.2 ECharts 图表不显示的几种可能图表不显示的排查难度不高但很烦人。常见原因有四个。第一个是容器高度为0div没设置height这是最典型的。第二个是引入的ECharts路径写错了浏览器按F12看Network看到echarts.min.js是404就说明静态资源配置有问题。第三个是返回的JSON字段名对不上前端取的是dateList后端返回的是datesECharts拿到undefined不会报错但图表就是空的。第四个是图表容器被隐藏了比如放在tab页里初始时display:noneECharts在初始化时拿不到正常宽高后面就算显示也无效需要在tab切换后重新调用init。针对最后一个问题我的经验是给图表容器在页面加载时就固定尺寸而不是等tab切换后再初始化。实在要放在tab里就在切换事件里调用一下resize方法或者重新执行初始化逻辑。4.3 Maven 依赖冲突与SpringBoot版本坑Maven依赖冲突是JavaWeb绕不开的话题。常见表现是启动时报NoSuchMethodError或ClassNotFoundException一般用mvn dependency:tree命令看冲突来源。最容易出错的是重复引入不同版本的commons-logging或slf4j导致日志系统崩溃。解决方案是用exclusion排除多余依赖或者直接升级到统一版本。SpringBoot版本选择上的坑是另一个重点。有些教程用SpringBoot 3.x但SpringBoot 3要求JDK17而且默认的JavaEE包名从javax变成了jakarta导致老代码里import javax.servlet.*全部报错。如果手里是JDK8环境务必确认自己用的SpringBoot是2.x不要盲目抄新版本配置。这个坑我已经见过太多人踩了每次都要专门说一句先看JDK版本再决定SpringBoot大版本。4.4 部署上线时需要注意的几个细节本地跑通了不代表部署没问题。首先打包方式是打jar包还是war包要提前确定。SpringBoot默认打成jar包内嵌Tomcat用java -jar就能启动这种方式最省事。但公司如果强制要求部署到外部Tomcat就需要修改打包方式为war并把spring-boot-starter-tomcat依赖改成provided。第二个是MySQL时区。上生产环境后如果数据库服务器和云服务器时区不一致时间数据会差8小时。启动命令里加上-Duser.timezoneAsia/Shanghai或者数据源URL里加上serverTimezoneAsia/Shanghai都能解决。第三个是端口和进程问题。Linux上启动SpringBoot应用如果8080端口被占用启动会直接失败。用lsof -i:8080查端口占用先kill掉旧进程再启动。另外比较稳妥的方式是用nohup java -jar sales-manage.jar logs.txt 21 这样SSH断开后进程也不会挂掉。问题现象解决中文乱码页面显示问号URL加characterEncodingutf8模板配置UTF-8图表空白ECharts无内容检查容器高度、JS路径、JSON字段名启动报错NoSuchMethodError用dependency:tree排查冲突时区差8小时时间数据偏差指定serverTimezoneAsia/Shanghai端口占用启动失败lsof查端口kill旧进程5. 经验复盘与后续扩展方向5.1 这个项目给我的三点启发做完这套系统最深的体会不是学会了SpringBoot而是理解了“业务规则比技术框架更容易让项目失控”。提成规则一改可能牵扯到订单、业绩、看板、导出报表多个模块。所以设计时要尽量把业务规则收拢到一个地方比如我后来把提成计算单独抽成一个CommissionService所有模块都调它以后改规则只动一个类。第二个启发就是数据可视化不能只看炫酷数据定义要比图表类型更重要。销售趋势图到底是按订单日期还是按回款日期算不同人理解完全不一样。我在做这套系统时专门把口径写在了看板页面的角落里避免销售团队争论数据不对。第三个启发是不要小看权限控制。很多内部系统觉得都是熟人用权限做得很随意结果销售离职后客户资料被带走老板才后悔。即使是最简单的角色区分也能在一定程度上避免这个风险。5.2 如果要继续往下做我会优先扩展这几个点这套系统目前是单机单体架构扩展方向上第一优先级是Excel导出。销售团队每天看数据光在页面上看不够月底要导出报表发给财务没有导出功能就得手工摘录效率很低。第二优先级是操作日志客户信息的修改记录、订单删除记录需要留痕方便审计。第三优先级是数据权限更细化从按销售员归属升级到按团队、按区域划分配合一个新的组织架构表。如果业务量真的大到MySQL顶不住再考虑给看板接口加Redis缓存或者把统计查询迁到ClickHouse这类OLAP数据库。不过这属于后话对中小团队来说把这套SpringBoot系统做得扎实、数据准确、权限清晰已经能带来非常大的效率提升。做项目最怕的不是技术不够新而是连最基本的数据都管不明白那就真的舍本逐末了。 
长河君 · 2026/10/22 13:34:10 · 阅读 1.2k SpringBoot销售团队后台管理系统：技术选型与实战详解
1. 项目整体设计与技术选型拆解1.1 这套后台管理系统到底在管什么做销售团队后台管理系统最先要想清楚的往往不是代码而是业务边界。很多人一上来就设计几十张表把客户、订单、回款、提成、业绩目标、拜访记录全塞进去结果半年过去能用起来的功能没几个。这次分享的这套系统刻意把范围收紧在销售团队最关心的四件事员工管理、客户跟进、订单成交、业绩统计。业务场景可以理解成这样一个简化模型销售员把客户信息录入系统每天更新跟进状态客户有购买意向后销售员在系统里生成订单订单审核通过后系统根据成交金额自动计算业绩和提成月底老板登录后台看一张数据看板按时间、按人员、按客户来源看整体趋势。这个模型不大但覆盖了一个销售团队日常管理的核心闭环用来做SpringBoot练手项目非常合适也完全能支撑一个中小型销售团队的实际运转。1.2 技术选型经典组合背后的取舍这套系统的技术栈是Java生态里很经典的一套SpringBoot Freemarker Bootstrap ECharts MySQL Maven。它不是最近几年流行的那种前后端分离架构而是采用服务端渲染的方式。选择这套组合不是技术上的偷懒而是基于“中小型内部管理系统”这个明确场景做的取舍。SpringBoot负责快速构建后端服务省掉一堆XML配置Freemarker做服务端模板渲染页面可以直接拿到后台数据不需要额外写接口联调Bootstrap管UI组件表格、表单、按钮、分页条都有现成风格ECharts负责把销售趋势、人员业绩排名、客户来源占比等数据可视化MySQL存业务数据Maven管依赖和打包。这套组合的最大优势是开发效率高一个人可以在两三天内把核心功能串起来。维度前后端分离服务端渲染本系统开发成本高需要同时维护前端工程和后端工程低一个工程搞定团队要求需要前端工程师或全栈工程师后端Java开发即可权限控制需处理Token、跨域、路由守卫Session 拦截器逻辑直观适合场景高交互、多端复用、并发较高内部管理系统、报表后台、小型团队所以如果你的目标是一个团队内部使用、数据量在百万以下、不需要多端适配的后台系统服务端渲染反而比前后端分离更省心。很多人盲目跟风前后端分离结果光联调、跨域就折腾了好几周这个教训我在项目里见得太多了。1.3 数据库设计销售数据建模的四个核心表数据库设计是这套系统真正需要花心思的地方。我按“用户—客户—订单—统计”这条主线设计了四张核心表实际项目中还可以拆更多但一开始能少则少后面加表比删表容易得多。用户表保存登录账号和角色信息字段包括用户名、密码、真实姓名、角色、手机号、状态、创建时间。角色只分管理员和销售员两种管理员看全局数据销售员只能看自己的客户和业绩。客户表保存客户基础信息和归属关系重点是owner_user_id这个字段用来标识客户由哪个销售员负责另一个重点是status状态字段用于标记未跟进、跟进中、已成交、已流失。订单表保存成交记录通过customer_id关联客户、user_id关联销售员金额字段用decimal类型精确到两位小数。业绩统计不单独建表需要的时候直接基于订单表做聚合查询这样可以避免数据冗余带来的对账问题。表名核心字段说明sys_userid, username, password, real_name, role, status登录人员customerid, name, phone, source, level, owner_user_id, status, create_time客户档案sale_orderid, order_no, customer_id, user_id, amount, status, order_date成交订单performance基于订单表聚合不落表动态统计设计心得金额这个字段一定要用decimal(10,2)别用float或double否则报表里出现0.30000000000000004这种值会让你怀疑人生。时间字段统一用datetime日期统计用的是order_date需要在上面建索引方便按月份维度查询。外键我建议只做逻辑关联表里存对应的id查询时通过Java代码或JOIN去关联不要物理外键。物理外键在数据量大和业务调整频繁时会成为维护负担团队内部管理系统尤其明显。2. 核心功能实现要点2.1 登录认证与权限控制小系统用拦截器就够了登录和权限是后台系统绕不开的第一道门。这套系统没有引入Spring Security和Shiro这种重型安全框架因为就两个角色、几十个接口的情况下自己写一个拦截器反而更清晰可控。核心方案是登录成功后把用户信息存进Session再自定义一个HandlerInterceptor拦截所有需要权限的请求判断Session里有没有用户、角色是否匹配。具体实现思路是先定义角色常量比如role1代表管理员role2代表销售员。然后写一个AuthInterceptor实现preHandle方法从Session中取出登录用户如果为空就直接重定向到登录页接着根据注解或URL规则判断接口权限比如管理员可以访问/user/list、/order/list等全部接口销售员访问这些的时候返回无权限提示。SpringBoot里注册这个拦截器只需要写一个WebMvcConfigurer实现类覆盖addInterceptors方法配置拦截路径比写一整套Security配置快得多。public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object loginUser request.getSession().getAttribute(loginUser); if (loginUser null) { response.sendRedirect(/login); return false; } return true; } }这里有个特别容易被忽略的坑登录用户的密码不能明文存在数据库里必须用BCrypt或者至少加盐哈希。很多练手项目为了省事直接明文存储上线之后如果数据库泄露整个销售团队的客户资料全完蛋。我在这个项目里用了一个简单的SHA256加盐方案虽然不如BCrypt安全但至少不会让密码直接裸奔。另外session超时时间也需要单独配一下SpringBoot默认的session过期时间是30分钟销售员填了半天客户资料突然跳登录页体验会很差建议配置成60分钟或120分钟。2.2 ECharts数据看板后端接口怎么组织数据前端才能少改代码销售团队后台最重要的一块内容就是数据看板。看板上一般会放三个图表近30天的销售趋势折线图、销售员业绩排名柱状图、客户来源占比饼图。这三个图可以共用一套接口风格后端返回标准JSON格式前端通过Ajax拿数据后直接setOption渲染。以销售趋势为例后端接口返回的数据结构是一个包含两个数组的Map日期数组和成交金额数组。日期格式统一成yyyy-MM-dd金额保留两位小数。前端拿到之后把这两个数组分别塞给ECharts的xAxis和series。这里有一个非常关键的坑如果某一天没有订单聚合结果里就少了这个日期折线图会出现断点。处理办法有两种一种是在SQL层用日期辅助表补齐另一种是在后端根据完整的日期范围遍历补零。我的习惯是在后端补零因为SQL写法更简单而且日期范围由前端参数控制后端更好维护。ListMapString, Object list orderMapper.selectDailySales(startDate, endDate); MapString, BigDecimal map new HashMap(); for (MapString, Object row : list) { String date String.valueOf(row.get(order_date)); map.put(date, (BigDecimal) row.get(total_amount)); } // 按日期范围补齐缺失日期 ListString dateList getDateRange(startDate, endDate); for (String date : dateList) { if (!map.containsKey(date)) { map.put(date, BigDecimal.ZERO); } }ECharts在前端渲染的时候注意给图表容器设置固定高度比如height: 300px。很多新手查了半天“图表不出来”的问题最后发现是div的height是0。此外ECharts的引入地址可以用静态资源路径也可以走CDN但内网部署环境建议把echarts.min.js下载到本地static目录下否则生产环境访问外网CDN可能会很慢甚至超时图表还是会白屏。2.3 客户、订单、业绩三个业务模块怎么串起来这三个模块是后台操作最频繁的地方也是最容易把代码写乱的地方。客户模块的核心是“归属”和“状态”。客户列表查询时管理员可以查所有客户销售员只能查owner_user_id等于自己的客户。查询条件一般包括客户名称、手机号、状态和负责销售员后端用动态SQL拼接条件。分页我用的是PageHelper插件一行代码就能完成分页但要注意PageHelper一定要在查询语句之前调用而且不要连续调用两次否则分页参数会被覆盖这个坑在很多项目里都出现过。订单模块的核心是“成交转化”和“提成计算”。客户状态从“跟进中”变成“已成交”时系统会生成一条订单记录。订单包含订单号、客户ID、销售员ID、成交金额和订单日期。订单审核通过后业绩自动累加到对应销售员的当月绩效里。提成规则可以配置成阶梯模式比如3万以下提成3%3万到10万提成5%超过10万的部分提成8%。实现这种规则不需要设计复杂的规则引擎一个按金额区间遍历的Java方法就够用了。public BigDecimal calcCommission(BigDecimal amount) { if (amount.compareTo(new BigDecimal(30000)) 0) { return amount.multiply(new BigDecimal(0.03)); } else if (amount.compareTo(new BigDecimal(100000)) 0) { return amount.multiply(new BigDecimal(0.05)); } else { return amount.multiply(new BigDecimal(0.08)); } }业绩统计模块我建议直接用SQL聚合别用Java内存计算。比如统计本月每位销售员的业绩一条GROUP BY语句就能搞定。数据量不大时这种写法最清晰后期就算要加其他维度改SQL的成本也最低。3. 实操过程从零搭建这套后台3.1 环境准备与Maven工程初始化先把基础环境列出来JDK 8或JDK 11IDEAMySQL 5.7或8.0Maven 3.6以上。SpringBoot版本选择2.7.x。这个版本兼容性很稳Freemarker集成和MyBatis集成都有成熟方案。在IDEA里新建项目时直接选择Spring InitializrGroup填com.xxxArtifact填sales-manage。依赖不需要贪多核心是spring-boot-starter-web、spring-boot-starter-freemarker、MySQL驱动、mybatis-spring-boot-starter以及lombok。如果你不想用MyBatis换成Spring Data JPA也可以但下面的代码示例我会用MyBatis来说因为团队内部项目里它出现频率更高。pom.xml的核心依赖这样加dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-freemarker/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.2.2/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency注意Maven仓库如果下载依赖慢去settings.xml里把镜像源换成国内镜像。这一步看起来不复杂但几乎每个新手都要卡半小时。另外Maven默认的Java编译版本是1.5记得在pom.xml里显式指定编译级别为1.8否则Java代码里连Lambda表达式都用不了。3.2 项目结构与配置文件Maven工程初始化好之后项目结构按照controller、service、mapper、entity、interceptor、config这几个包来组织。controller只负责接收参数和返回视图或JSONservice层写业务逻辑mapper层是MyBatis的数据访问接口entity对应数据库表实体。这样分层虽然老派但维护起来非常清晰也不会出现几百行的controller。resources目录下重点看application.yml。数据源配置和Freemarker配置是核心server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/sales_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver freemarker: template-loader-path: classpath:/templates/ suffix: .ftl charset: UTF-8 cache: false mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.xxx.sales.entity这里有个小提示数据源URL里的characterEncodingutf8和serverTimezoneAsia/Shanghai一个都不能少。少了前者中文乱码少了后者MySQL时区报错而且MySQL 8.0的驱动类名是com.mysql.cj.jdbc.Driver不是老项目里的com.mysql.jdbc.Driver。3.3 从数据库到页面客户模块完整实现流程客户模块是这套系统里最典型的CRUD功能做完它就是一套流水线流程。第一步建表SQL大致是这样的CREATE TABLE customer ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, phone VARCHAR(20), source VARCHAR(20), level VARCHAR(10), owner_user_id INT NOT NULL, status TINYINT DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP );第二步创建实体类字段和表对应。我用Lombok省去了getter和setterData注解直接搞定。第三步写Mapper接口核心是一个list方法按条件查询配合XML里写的动态SQL。第四步写Service调用Mapper并处理分页参数。第五步写Controller接收请求参数、返回ModelAndView或Model把客户列表数据传给Freemarker页面。Freemarker页面里展示表格核心代码类似这样table classtable table-bordered tr th客户名称/th th手机号/th th客户来源/th th负责人/th th状态/th th操作/th /tr #list customerList as customer tr td${customer.name}/td td${customer.phone}/td td${customer.source}/td td${customer.ownerName}/td td${customer.statusText}/td tda href/customer/edit/${customer.id}编辑/a/td /tr /#list /table这里要注意的是Freemarker模板里输出变量时如果变量为null页面会直接报错。所以实体类里面的状态字段和负责人姓名字段要么在Service层提前转换好文本要么用默认值兜底。我在项目里习惯在Service层把这些展示字段拼好模板里只负责显示这样即使以后换前端框架业务数据也完整。3.4 看板接口与ECharts接入看板页面的开发相对独立。后端先提供一个接口比如/api/dashboard/salesTrend参数是startDate和endDate返回JSON格式的日期列表和金额列表。前端页面不管整套接口有多复杂只需要关心两个数组是否对齐。页面引入ECharts之后初始化折线图$.ajax({ url: /api/dashboard/salesTrend, data: {startDate: 2025-01-01, endDate: 2025-01-31}, success: function(res) { var chart echarts.init(document.getElementById(trendChart)); chart.setOption({ tooltip: {}, xAxis: { data: res.dateList }, yAxis: {}, series: [{ type: line, data: res.amountList }] }); } });实际做的时候这张图通常会搭配日期选择器让管理员自己选月份。注意选择器传过去的日期不要搞混格式前端用YYYY-MM-DD后端LocalDate.parse就能直接解析。图表渲染完成后务必手动调整一下窗口大小因为很多浏览器在页面加载过程里如果容器尺寸变化图表不会自动重绘。可以在window.resize事件里调用chart.resize()这个细节能让看板页面在缩放窗口时表现得更舒服。4. 常见问题与排查技巧实录4.1 页面中文乱码数据和页面全是问号这个问题出现频率极高原因基本集中在三处。第一是MySQL连接串里没加characterEncodingutf8导致数据库读取乱码第二是Freemarker模板编码不是UTF-8application.yml里需要配置charset: UTF-8第三是页面本身的meta标签可能被漏掉HTML里加上。排查顺序也很有讲究先看数据库里的数据是否正常再看Java后端实体类里的值是否正常最后看浏览器端响应头里的charset。如果前两步都正常只有浏览器乱码那就是模板编码问题。按照这个顺序查基本五分钟内能定位。我记得有一次折腾了很久最后发现是IDEA的File Encoding设置成了GBK导致保存的页面文件本身就是乱码这个坑值得单独提一下新建项目时先检查右下角编码格式。4.2 ECharts 图表不显示的几种可能图表不显示的排查难度不高但很烦人。常见原因有四个。第一个是容器高度为0div没设置height这是最典型的。第二个是引入的ECharts路径写错了浏览器按F12看Network看到echarts.min.js是404就说明静态资源配置有问题。第三个是返回的JSON字段名对不上前端取的是dateList后端返回的是datesECharts拿到undefined不会报错但图表就是空的。第四个是图表容器被隐藏了比如放在tab页里初始时display:noneECharts在初始化时拿不到正常宽高后面就算显示也无效需要在tab切换后重新调用init。针对最后一个问题我的经验是给图表容器在页面加载时就固定尺寸而不是等tab切换后再初始化。实在要放在tab里就在切换事件里调用一下resize方法或者重新执行初始化逻辑。4.3 Maven 依赖冲突与SpringBoot版本坑Maven依赖冲突是JavaWeb绕不开的话题。常见表现是启动时报NoSuchMethodError或ClassNotFoundException一般用mvn dependency:tree命令看冲突来源。最容易出错的是重复引入不同版本的commons-logging或slf4j导致日志系统崩溃。解决方案是用exclusion排除多余依赖或者直接升级到统一版本。SpringBoot版本选择上的坑是另一个重点。有些教程用SpringBoot 3.x但SpringBoot 3要求JDK17而且默认的JavaEE包名从javax变成了jakarta导致老代码里import javax.servlet.*全部报错。如果手里是JDK8环境务必确认自己用的SpringBoot是2.x不要盲目抄新版本配置。这个坑我已经见过太多人踩了每次都要专门说一句先看JDK版本再决定SpringBoot大版本。4.4 部署上线时需要注意的几个细节本地跑通了不代表部署没问题。首先打包方式是打jar包还是war包要提前确定。SpringBoot默认打成jar包内嵌Tomcat用java -jar就能启动这种方式最省事。但公司如果强制要求部署到外部Tomcat就需要修改打包方式为war并把spring-boot-starter-tomcat依赖改成provided。第二个是MySQL时区。上生产环境后如果数据库服务器和云服务器时区不一致时间数据会差8小时。启动命令里加上-Duser.timezoneAsia/Shanghai或者数据源URL里加上serverTimezoneAsia/Shanghai都能解决。第三个是端口和进程问题。Linux上启动SpringBoot应用如果8080端口被占用启动会直接失败。用lsof -i:8080查端口占用先kill掉旧进程再启动。另外比较稳妥的方式是用nohup java -jar sales-manage.jar logs.txt 21 这样SSH断开后进程也不会挂掉。问题现象解决中文乱码页面显示问号URL加characterEncodingutf8模板配置UTF-8图表空白ECharts无内容检查容器高度、JS路径、JSON字段名启动报错NoSuchMethodError用dependency:tree排查冲突时区差8小时时间数据偏差指定serverTimezoneAsia/Shanghai端口占用启动失败lsof查端口kill旧进程5. 经验复盘与后续扩展方向5.1 这个项目给我的三点启发做完这套系统最深的体会不是学会了SpringBoot而是理解了“业务规则比技术框架更容易让项目失控”。提成规则一改可能牵扯到订单、业绩、看板、导出报表多个模块。所以设计时要尽量把业务规则收拢到一个地方比如我后来把提成计算单独抽成一个CommissionService所有模块都调它以后改规则只动一个类。第二个启发就是数据可视化不能只看炫酷数据定义要比图表类型更重要。销售趋势图到底是按订单日期还是按回款日期算不同人理解完全不一样。我在做这套系统时专门把口径写在了看板页面的角落里避免销售团队争论数据不对。第三个启发是不要小看权限控制。很多内部系统觉得都是熟人用权限做得很随意结果销售离职后客户资料被带走老板才后悔。即使是最简单的角色区分也能在一定程度上避免这个风险。5.2 如果要继续往下做我会优先扩展这几个点这套系统目前是单机单体架构扩展方向上第一优先级是Excel导出。销售团队每天看数据光在页面上看不够月底要导出报表发给财务没有导出功能就得手工摘录效率很低。第二优先级是操作日志客户信息的修改记录、订单删除记录需要留痕方便审计。第三优先级是数据权限更细化从按销售员归属升级到按团队、按区域划分配合一个新的组织架构表。如果业务量真的大到MySQL顶不住再考虑给看板接口加Redis缓存或者把统计查询迁到ClickHouse这类OLAP数据库。不过这属于后话对中小团队来说把这套SpringBoot系统做得扎实、数据准确、权限清晰已经能带来非常大的效率提升。做项目最怕的不是技术不够新而是连最基本的数据都管不明白那就真的舍本逐末了。