计算机ssm项目 SpringBoot的客户关系管理系统

左手的ㄟ右手 2024-02-05 11:42 27阅读 0赞

### 项目背景 ###

随着科学技术的飞速发展，社会的方方面面、各行各业都在努力与现代的先进技术接轨，通过科技手段来提高自身的优势，客户关系管理系统当然也不能排除在外。客户关系管理系统是以实际运用为开发背景，运用软件工程原理和开发方法，采用springboot框架构建的一个管理系统。整个开发过程首先对软件系统进行需求分析，得出系统的主要功能。接着对系统进行总体设计和详细设计。总体设计主要包括系统功能设计、系统总体结构设计、系统数据结构设计和系统安全设计等；详细设计主要包括系统数据库访问的实现，主要功能模块的具体实现，模块实现关键代码等。最后对系统进行功能测试，并对测试结果进行分析总结，得出系统中存在的不足及需要改进的地方，为以后的系统维护提供了方便，同时也为今后开发类似系统提供了借鉴和帮助。这种个性化的网上管理系统特别注重交互协调与管理的相互配合，激发了管理人员的创造性与主动性，对客户关系管理系统而言非常有利。  
本客户关系管理系统采用的数据库是Mysql，使用springboot框架开发。在设计过程中，充分保证了系统代码的良好可读性、实用性、易扩展性、通用性、便于后期维护、操作方便以及页面简洁等特点。

### 功能设计 ###

##### 功能模块图 #####

系统登录流程图  
![在这里插入图片描述][2cdfd67ab63c42c3b562a23b7112c959.png]  
添加信息流程图  
![在这里插入图片描述][3e6b2b9e092f44dd8773774af20c4a5a.png]  
删除信息流程图  
![在这里插入图片描述][7755be28518242fd80a05539d8907b16.png]

### 功能截图 ###

管理员登录，通过填写用户名、密码、角色进行登录  
![在这里插入图片描述][d5b09ab5191649c8baea720e377cca26.png]  
管理员登录进入客户关系管理系统可以查看首页、个人中心、高管管理、经理管理、员工管理、外出拜访申请管理、客户资料管理、客户投诉管理、部门类别管理、职务类别管理、产品出入库管理、工单管理、公海管理、私海管理、商机管理、合同管理、回款管理、开票管理、退款管理、客户贡献分析管理、系统管理等信息。  
高管管理，在高管管理页面中可以通过查看账号、姓名、性别、部门、职务、手机、邮箱、头像进行详情、修改或者删除  
![在这里插入图片描述][3e0f0f5de36f4816a4503bcf94903994.png]  
主管管理，在主管管理页面中可以通过查看账号、姓名、性别、部门、职务、手机、邮箱、头像进行详情、修改或者删除  
![在这里插入图片描述][57617f99781b4f3ea474c6392e6b5f27.png]  
经理管理，在经理管理页面中可以通过查看账号、姓名、性别、部门、职务、手机、邮箱、头像进行详情、修改或者删除  
![在这里插入图片描述][64cb0a945b5e4735b7b2b0f0a04f1027.png]  
员工管理，在员工管理页面中可以通过查看账号、姓名、性别、部门、职务、手机、邮箱、头像进行详情、修改或者删除  
![在这里插入图片描述][7e55c7a698a8406b93561f2f62327c46.png]  
外出拜访申请管理，在外出拜访申请管理页面中可以查看客户名称、外出开始时间、外出结束时间、员工账号、审核回复、审核状态、是否审核等内容，并且根据需要对外出拜访申请管理进行详情、修改或删除等详细操作  
![在这里插入图片描述][fa7bd18649db4f48afe69232e9cb3eed.png]  
客户资料管理，在客户资料管理页面中可以查看客户名称、销售顾问、客户来源、客户等级、客户所处阶段、最近联系时间、客户联系人、头像等内容，并且根据需要对客户资料管理进行详情、修改或删除等详细操作  
![在这里插入图片描述][838e9b0d8a474671ab5ce2d05c3f2dc3.png]  
客户投诉管理，在客户投诉管理页面中可以查看客户名称、投诉标题、投诉时间、审核回复、审核状态、审核等内容，并且根据需要对客户投诉管理进行详情、修改或删除等详细操作  
![在这里插入图片描述][c9abe4cd7e8d467f846548ca6a80fc3e.png]  
部门类别管理，在部门类别管理页面中可以查看相关部门的类别等内容，并且根据需要对部门类别管理进行修改或删除等详细操作  
![在这里插入图片描述][8e8bdd1b1f5840e68ea2466777f3fa96.png]  
职务类别管理，在职务类别管理页面中可以查看相关职务的类别等内容，并且根据需要对职务类别管理进行修改或删除等详细操作  
![在这里插入图片描述][13c8b4d218d043e08db0a817efb40cd4.png]  
产品出入库管理，在产品出入库管理页面中可以查看产品名称、规格、数量、出入库、负责人、时间等内容，并且根据需要对产品出入库管理进行修改或删除等详细操作  
![在这里插入图片描述][5eeb03b7a8bb475ba9c31f33e6d9b94b.png]

### 相关代码 ###

##### 数据库配置 #####

# Tomcat
    server:
        tomcat:
            uri-encoding: UTF-8
        port: 8080
        servlet:
            context-path: /springbootr1tjf
    
    spring:
        datasource:
            driverClassName: com.mysql.jdbc.Driver
            url: jdbc:mysql://127.0.0.1:3306/springbootr1tjf?useUnicode=true&characterEncoding=utf-8&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=GMT%2B8
            username: root
            password: 123456
    
    #        driverClassName: com.microsoft.sqlserver.jdbc.SQLServerDriver
    #        url: jdbc:sqlserver://127.0.0.1:1433;DatabaseName=springbootr1tjf
    #        username: sa
    #        password: 123456
    
        servlet:
          multipart:
            max-file-size: 10MB
            max-request-size: 10MB
        resources:
          static-locations: classpath:static/,file:static/
    
    #mybatis
    mybatis-plus:
      mapper-locations: classpath*:mapper/*.xml
      #实体扫描，多个package用逗号或者分号分隔
      typeAliasesPackage: com.entity
      global-config:
        #主键类型  0:"数据库ID自增", 1:"用户输入ID",2:"全局唯一ID (数字类型唯一ID)", 3:"全局唯一ID UUID";
        id-type: 1
        #字段策略 0:"忽略判断",1:"非 NULL 判断"),2:"非空判断"
        field-strategy: 2
        #驼峰下划线转换
        db-column-underline: true
        #刷新mapper 调试神器
        refresh-mapper: true
        #逻辑删除配置
        logic-delete-value: -1
        logic-not-delete-value: 0
        #自定义SQL注入器
        sql-injector: com.baomidou.mybatisplus.mapper.LogicSqlInjector
      configuration:
        map-underscore-to-camel-case: true
        cache-enabled: false
        call-setters-on-nulls: true
        #springboot 项目mybatis plus 设置 jdbcTypeForNull (oracle数据库需配置JdbcType.NULL, 默认是Other)
        jdbc-type-for-null: 'null'

##### 控制层（controller） #####

package com.controller;
    
    
        import java.util.Arrays;
        import java.util.Calendar;
        import java.util.Date;
        import java.util.Map;
        
        import javax.servlet.http.HttpServletRequest;
        
        import org.springframework.beans.factory.annotation.Autowired;
        import org.springframework.stereotype.Controller;
        import org.springframework.web.bind.annotation.GetMapping;
        import org.springframework.web.bind.annotation.PathVariable;
        import org.springframework.web.bind.annotation.PostMapping;
        import org.springframework.web.bind.annotation.RequestBody;
        import org.springframework.web.bind.annotation.RequestMapping;
        import org.springframework.web.bind.annotation.RequestParam;
        import org.springframework.web.bind.annotation.ResponseBody;
        import org.springframework.web.bind.annotation.RestController;
        
        import com.annotation.IgnoreAuth;
        import com.baomidou.mybatisplus.mapper.EntityWrapper;
        import com.entity.TokenEntity;
        import com.entity.UserEntity;
        import com.service.TokenService;
        import com.service.UserService;
        import com.utils.CommonUtil;
        import com.utils.MPUtil;
        import com.utils.PageUtils;
        import com.utils.R;
        import com.utils.ValidatorUtils;
        
        /**
         * 登录相关
         */
        @RequestMapping("users")
        @RestController
        public class UserController{
        
        	
        	@Autowired
        	private UserService userService;
        	
        	@Autowired
        	private TokenService tokenService;
        
        	/**
        	 * 登录
        	 */
        	@IgnoreAuth
        	@PostMapping(value = "/login")
        	public R login(String username, String password, String captcha, HttpServletRequest request) {
        
        		UserEntity user = userService.selectOne(new EntityWrapper<UserEntity>().eq("username", username));
        		if(user==null || !user.getPassword().equals(password)) {
        
        			return R.error("账号或密码不正确");
        		}
        		String token = tokenService.generateToken(user.getId(),username, "users", user.getRole());
        		return R.ok().put("token", token);
        	}
        	
        	/**
        	 * 注册
        	 */
        	@IgnoreAuth
        	@PostMapping(value = "/register")
        	public R register(@RequestBody UserEntity user){
        
        //    	ValidatorUtils.validateEntity(user);
            	if(userService.selectOne(new EntityWrapper<UserEntity>().eq("username", user.getUsername())) !=null) {
        
            		return R.error("用户已存在");
            	}
                userService.insert(user);
                return R.ok();
            }
        
        	/**
        	 * 退出
        	 */
        	@GetMapping(value = "logout")
        	public R logout(HttpServletRequest request) {
        
        		request.getSession().invalidate();
        		return R.ok("退出成功");
        	}
        	
        	/**
             * 密码重置
             */
            @IgnoreAuth
        	@RequestMapping(value = "/resetPass")
            public R resetPass(String username, HttpServletRequest request){
        
            	UserEntity user = userService.selectOne(new EntityWrapper<UserEntity>().eq("username", username));
            	if(user==null) {
        
            		return R.error("账号不存在");
            	}
            	user.setPassword("123456");
                userService.update(user,null);
                return R.ok("密码已重置为：123456");
            }
        	
        	/**
             * 列表
             */
            @RequestMapping("/page")
            public R page(@RequestParam Map<String, Object> params,UserEntity user){
        
                EntityWrapper<UserEntity> ew = new EntityWrapper<UserEntity>();
            	PageUtils page = userService.queryPage(params, MPUtil.sort(MPUtil.between(MPUtil.allLike(ew, user), params), params));
                return R.ok().put("data", page);
            }
        
        	/**
             * 列表
             */
            @RequestMapping("/list")
            public R list( UserEntity user){
        
               	EntityWrapper<UserEntity> ew = new EntityWrapper<UserEntity>();
              	ew.allEq(MPUtil.allEQMapPre( user, "user")); 
                return R.ok().put("data", userService.selectListView(ew));
            }
        
            /**
             * 信息
             */
            @RequestMapping("/info/{id}")
            public R info(@PathVariable("id") String id){
        
                UserEntity user = userService.selectById(id);
                return R.ok().put("data", user);
            }
            
            /**
             * 获取用户的session用户信息
             */
            @RequestMapping("/session")
            public R getCurrUser(HttpServletRequest request){
        
            	Long id = (Long)request.getSession().getAttribute("userId");
                UserEntity user = userService.selectById(id);
                return R.ok().put("data", user);
            }
        
            /**
             * 保存
             */
            @PostMapping("/save")
            public R save(@RequestBody UserEntity user){
        
        //    	ValidatorUtils.validateEntity(user);
            	if(userService.selectOne(new EntityWrapper<UserEntity>().eq("username", user.getUsername())) !=null) {
        
            		return R.error("用户已存在");
            	}
                userService.insert(user);
                return R.ok();
            }
        
            /**
             * 修改
             */
            @RequestMapping("/update")
            public R update(@RequestBody UserEntity user){
        
        //        ValidatorUtils.validateEntity(user);
            	UserEntity u = userService.selectOne(new EntityWrapper<UserEntity>().eq("username", user.getUsername()));
            	if(u!=null && u.getId()!=user.getId() && u.getUsername().equals(user.getUsername())) {
        
            		return R.error("用户名已存在。");
            	}
                userService.updateById(user);//全部更新
                return R.ok();
            }
        
            /**
             * 删除
             */
            @RequestMapping("/delete")
            public R delete(@RequestBody Long[] ids){
        
                userService.deleteBatchIds(Arrays.asList(ids));
                return R.ok();
            }
        }

##### 业务层（Service） #####

package com.service;
        
        import java.util.List;
        import java.util.Map;
        
        import org.apache.ibatis.annotations.Param;
        
        import com.baomidou.mybatisplus.mapper.Wrapper;
        import com.baomidou.mybatisplus.service.IService;
        import com.entity.UserEntity;
        import com.utils.PageUtils;
    
    
        /**
         * 系统用户
         */
        public interface UserService extends IService<UserEntity> {
        
         	PageUtils queryPage(Map<String, Object> params);
            
           	List<UserEntity> selectListView(Wrapper<UserEntity> wrapper);
           	
           	PageUtils queryPage(Map<String, Object> params,Wrapper<UserEntity> wrapper);
        	   	
        }

##### 数据访问层（Dao） #####

package com.dao;
    
    import java.util.List;
    
    import org.apache.ibatis.annotations.Param;
    
    import com.baomidou.mybatisplus.mapper.BaseMapper;
    import com.baomidou.mybatisplus.mapper.Wrapper;
    import com.baomidou.mybatisplus.plugins.pagination.Pagination;
    import com.entity.UserEntity;
    
    /**
     * 用户
     */
    public interface UserDao extends BaseMapper<UserEntity> {
        
    	
    	List<UserEntity> selectListView(@Param("ew") Wrapper<UserEntity> wrapper);
    
    	List<UserEntity> selectListView(Pagination page,@Param("ew") Wrapper<UserEntity> wrapper);
    	
    }

## 项目获取: ##

[https://gitee.com/sinonfin/L-javaWebSha/tree/master][https_gitee.com_sinonfin_L-javaWebSha_tree_master]

[2cdfd67ab63c42c3b562a23b7112c959.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/98040c559f224a528df052e74a436121.png
[3e6b2b9e092f44dd8773774af20c4a5a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/07ed83da40e14eed847b109f002f85bf.png
[7755be28518242fd80a05539d8907b16.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/6fc37891df2a4477acfcc032d67afc21.png
[d5b09ab5191649c8baea720e377cca26.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/dd03cd8992d545dab037180b56d400d5.png
[3e0f0f5de36f4816a4503bcf94903994.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/6d698cdc10f740b38765016f6b9cb330.png
[57617f99781b4f3ea474c6392e6b5f27.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/b784c4d85bce4a639138a5a59bb24b88.png
[64cb0a945b5e4735b7b2b0f0a04f1027.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/58540c6d2c0547d5888b1f199d3a20b6.png
[7e55c7a698a8406b93561f2f62327c46.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/01f309df52dd40f6927c063c03eb9f42.png
[fa7bd18649db4f48afe69232e9cb3eed.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/5d8f3aa9a11143a1a552625d5783598c.png
[838e9b0d8a474671ab5ce2d05c3f2dc3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/386b2c337deb4ca1a21b82052e5fcfe4.png
[c9abe4cd7e8d467f846548ca6a80fc3e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/a1e874564394447bb7b4ef101c5b5c2b.png
[8e8bdd1b1f5840e68ea2466777f3fa96.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/013b451d3d1140eba93e7caa6f366bca.png
[13c8b4d218d043e08db0a817efb40cd4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/e60270bb4fc7429b8c2ae397f1efe266.png
[5eeb03b7a8bb475ba9c31f33e6d9b94b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/66faeae0095743caa8b8c9014bdd0da2.png
[https_gitee.com_sinonfin_L-javaWebSha_tree_master]: https://gitee.com/sinonfin/L-javaWebSha/tree/master