Crm-客户治理
客户治理表结构设计
客户信息管理模块表构造
这里次要波及表:
t_customer 客户表、t_customer_contact 客户来往记录表、t_customer_linkman 客户联系人表、t_customer_order 客户订单表、t_order_details 订单详情表
| t_customer | 客户信息表 | |||
|---|---|---|---|---|
| 字段 | 字段类型 | 字段限度 | 字段形容 | |
| 主键 | id | int(11) | 自增 | id主键 |
| khno | varchar(20) | 可空 | 客户编号 | |
| name | varchar(20) | 可空 | 客户姓名 | |
| area | varchar(20) | 可空 | 客户所属地区 | |
| cus_manager | varchar(20) | 可空 | 客户经理 | |
| level | varchar(30) | 可空 | 客户级别 | |
| myd | varchar(30) | 可空 | 客户满意度 | |
| xyd | varchar(30) | 可空 | 客户信用度 | |
| address | varchar(500) | 可空 | 客户地址 | |
| post_code | varchar(50) | 可空 | 邮编 | |
| phone | varchar(20) | 可空 | 联系电话 | |
| fax | varchar(20) | 可空 | 传真 | |
| web_site | varchar(20) | 可空 | 网址 | |
| yyzzzch | varchar(50) | 可空 | 营业执照注册号 | |
| fr | varchar(20) | 可空 | 法人代表 | |
| zczj | varchar(20) | 可空 | 注册资金 | |
| nyye | varchar(20) | 可空 | 年营业额 | |
| khyh | varchar(50) | 可空 | 开户银行 | |
| khzh | varchar(50) | 可空 | 开户账号 | |
| dsdjh | varchar(50) | 可空 | 地税登记号 | |
| gsdjh | varchar(50) | 可空 | 国税登记号 | |
| state | int(11) | 可空 | 散失状态 | |
| is_valid | int(4) | 可空 | 无效状态 | |
| create_date | datetime | 可空 | 创立工夫 | |
| update_date | datetime | 可空 | 更新工夫 |
| t_customer_contact | 客户来往记录表 | |||
|---|---|---|---|---|
| 字段 | 字段类型 | 字段限度 | 字段形容 | |
| 主键 | id | int(11) | 自增 | id主键 |
| cus_id | int(11) | 可空 | 客户id | |
| contact_time | datetime | 可空 | 来往工夫 | |
| address | varchar(500) | 可空 | 来往地址 | |
| overview | varchar(100) | 可空 | 地址 | |
| create_date | datetime | 可空 | 创立工夫 | |
| update_date | datetime | 可空 | 更新工夫 | |
| is_valid | int(4) | 可空 | 无效状态 |
| t_customer_linkman | 客户联系人表 | |||
|---|---|---|---|---|
| 字段 | 字段类型 | 字段限度 | 字段形容 | |
| 主键 | id | int(11) | 自增 | id主键 |
| cus_id | int(11) | 可空 | 客户id | |
| link_name | varchar(20) | 可空 | 联系人姓名 | |
| sex | varchar(20) | 可空 | 性别 | |
| zhiwei | varchar(50) | 可空 | 职位 | |
| office_phone | varchar(50) | 可空 | 办公电话 | |
| phone | varchar(20) | 可空 | 手机号 | |
| is_valid | int(4) | 可空 | 无效状态 | |
| ceate_date | datetime | 可空 | 创立工夫 | |
| update_date | datetime | 可空 | 更新工夫 |
| t_customer_order | 客户订单 | |||
|---|---|---|---|---|
| 字段 | 字段类型 | 字段限度 | 字段形容 | |
| 主键 | id | int(11) | 自增 | id主键 |
| cus_id | int(11) | 可空 | 客户id | |
| order_no | varchar(40) | 可空 | 订单编号 | |
| order_date | datetime | 可空 | 下单工夫 | |
| address | varchar(200) | 可空 | 地址 | |
| state | int(11) | 可空 | 状态 | |
| create_date | datetime | 可空 | 创立工夫 | |
| update_date | datetime | 可空 | 更新工夫 | |
| is_valid | int(4) | 可空 | 无效状态 |
| t_order_details | 订单详情表 | |||
|---|---|---|---|---|
| 字段 | 字段类型 | 字段限度 | 字段形容 | |
| 主键 | id | int(11) | 自增 | id主键 |
| order_id | int(11) | 可空 | 订单id | |
| goods_name | varchar(100) | 可空 | 商品名称 | |
| goods_num | int(11) | 可空 | 商品数量 | |
| unit | varchar(20) | 可空 | 商品单位 | |
| price | float | 可空 | 单价 | |
| sum | float | 可空 | 总金额 | |
| is_valid | int(4) | 可空 | 无效状态 | |
| create_date | datetime | 可空 | 创立工夫 | |
| update_date | datetime | 可空 | 更新工夫 |
客户散失治理模块表构造
这里次要波及表有
t_customer_loss 客户散失表
t_customer_reprieve 客户散失暂缓表
| t_customer_loss | 客户散失表 | |||
|---|---|---|---|---|
| 字段 | 字段类型 | 字段限度 | 字段形容 | |
| 主键 | id | int(11) | 自增 | id主键 |
| cus_no | varchar(40) | 可空 | 客户编号 | |
| cus_name | varchar(20) | 可空 | 客户姓名 | |
| cus_manager | varchar(20) | 可空 | 客户经理 | |
| last_order_time | date | 可空 | 最初下单工夫 | |
| confirm_loss_time | date | 可空 | 确认散失工夫 | |
| state | int(11) | 可空 | 散失状态 | |
| loss_reason | varchar(1000) | 可空 | 散失起因 | |
| is_valid | tinyint(4) | 可空 | 无效状态 | |
| create_date | datetime | 可空 | 创立工夫 | |
| update_date | datetime | 可空 | 更新工夫 |
| t_customer_reprieve | 客户散失暂缓表 | |||
|---|---|---|---|---|
| 字段 | 字段类型 | 字段限度 | 字段形容 | |
| 主键 | id | int(11) | 自增 | id主键 |
| loss_id | int(11) | 可空 | 散失id | |
| measure | varchar(500) | 可空 | 措施 | |
| is_valid | tinyint(4) | 可空 | 无效状态 | |
| create_date | datetime | 可空 | 创立工夫 | |
| update_date | datetime | 可空 | 更新工夫 |
客户信息查问后端代码实现
layui 框架通过表格展现后端表数据,数据格式见官网测试数据地址。
CustomerMapper 接口定义与Sql配置
- CustomerMapper .java
public interface CustomerMapper extends BaseMapper<Customer,Integer> { /* 因为思考到多个模块均波及多条件查问 这里对于多条件分页查询方法由父接口BaseMapper定义 */}- CustomerMapper .xml
<select id="selectByParams" parameterType="com.xxxx.crm.query.CustomerQuery" resultMap="BaseResultMap"> select <include refid="Base_Column_List"/> from t_customer <where> is_valid=1 <!-- state 散失状态 0 未散失 1 已散失 --> and state =0 <if test="null !=cusName and cusName !=''"> and name like concat('%',#{cusName},'%') </if> <if test="null !=cusNo and cusNo !=''"> and khno =#{cusNo} </if> <if test="null !=level and level !=''"> and level =#{level} </if> <if test="null !=myd and myd !=''"> and myd =#{myd} </if> </where> </select>- CustomerQuery.java
在crm.query 包下创立CustomerQuery.java 查问类，设置查问条件
public class CustomerQuery extends BaseQuery { private String cusName; private String cusNo; private String level;}CustomerService 定义
- CustomerService .java
@Servicepublic class CustomerService extends BaseService<Customer, Integer> { /* 因为思考到多个模块均波及多条件查问 这里对于多条件分页查询方法由父类BaseService定义并实现 */}- BaseService.java 分页查询方法定义与实现
public Map<String, Object> queryByParamsForTable(BaseQuery baseQuery) { Map<String,Object> result = new HashMap<String,Object>(); PageHelper.startPage(baseQuery.getPage(),baseQuery.getLimit()); PageInfo<T> pageInfo =new PageInfo<T>(selectByParams(baseQuery)); result.put("count",pageInfo.getTotal()); result.put("data",pageInfo.getList()); result.put("code",0); result.put("msg",""); return result; }CustomerController.java
@Controller@RequestMapping("customer")public class CustomerController extends BaseController { @Resource private CustomerService customerService; @Resource private CustomerOrderService orderService; @RequestMapping("index") public String index(){ return "customer/customer"; } @RequestMapping("list") @ResponseBody public Map<String,Object> queryCustomersByParams(CustomerQuery customerQuery){ return customerService.queryByParamsForTable(customerQuery); }客户信息管理前端外围代码
客户信息管理主页面模板
resources/views/customer目录创立customer.ftl 模块文件,模板内容如下(模板依赖的layui文件由common.ftl 文件提供),layui表格数据展现模板文件实现参考该地址
- customer.ftl
<!DOCTYPE html><html><head> <title>客户治理</title> <#include "../common.ftl"></head><body class="childrenBody"><form class="layui-form" > <blockquote class="layui-elem-quote quoteBox"> <form class="layui-form"> <div class="layui-inline"> <div class="layui-input-inline"> <input type="text" name="name" class="layui-input searchVal" placeholder="客户名" /> </div> <div class="layui-input-inline"> <input type="text" name="khno" class="layui-input searchVal" placeholder="客户编号" /> </div> <div class="layui-input-inline"> <select name="level" id="level"> <option value="">请抉择...</option> <option value="策略合作伙伴">策略合作伙伴</option> <option value="大客户">大客户</option> <option value="重点开发客户">重点开发客户</option> </select> </div> <a class="layui-btn search_btn" data-type="reload"><i class="layui-icon"></i> 搜寻</a> </div> </form> </blockquote> <table id="customerList" class="layui-table" lay-filter="customers"></table> <!--操作--> <script id="customerListBar" type="text/html"> <a class="layui-btn layui-btn-xs" id="edit" lay-event="edit">编辑</a> <a class="layui-btn layui-btn-xs layui-btn-danger" lay-event="del">删除</a> </script></form><script type="text/javascript" src="${ctx}/static/js/customer/customer.js"></script></body></html>客户信息管理主页面模板外围js
static/js/customer目录下创立customer.js 文件,初始化layui表格数据,layui表格数据展现模板文件实现参考该地址
- customer.js
layui.use(['table','layer',"form"],function(){ var layer = parent.layer === undefined ? layui.layer : top.layer, $ = layui.jquery, table = layui.table, form = layui.form; //客户列表展现 var tableIns = table.render({ elem: '#customerList', url : ctx+'/customer/list', cellMinWidth : 95, page : true, height : "full-125", limits : [10,15,20,25], limit : 10, toolbar: "#toolbarDemo", id : "customerListTable", cols : [[ {type: "checkbox", fixed:"center"}, {field: "id", title:'编号',fixed:"true"}, {field: 'name', title: '客户名',align:"center"}, {field: 'fr', title: '法人', align:'center'}, {field: 'khno', title: '客户编号', align:'center'}, {field: 'area', title: '地区', align:'center'}, {field: 'cusManager', title: '客户经理', align:'center'}, {field: 'myd', title: '满意度', align:'center'}, {field: 'level', title: '客户级别', align:'center'}, {field: 'xyd', title: '信用度', align:'center'}, {field: 'address', title: '具体地址', align:'center'}, {field: 'postCode', title: '邮编', align:'center'}, {field: 'phone', title: '电话', align:'center'}, {field: 'webSite', title: '网站', align:'center'}, {field: 'fax', title: '传真', align:'center'}, {field: 'zczj', title: '注册资金', align:'center'}, {field: 'yyzzzch', title: '营业执照', align:'center'}, {field: 'khyh', title: '开户行', align:'center'}, {field: 'khzh', title: '开户账号', align:'center'}, {field: 'gsdjh', title: '国税', align:'center'}, {field: 'dsdjh', title: '地税', align:'center'}, {field: 'createDate', title: '创立工夫', align:'center'}, {field: 'updateDate', title: '更新工夫', align:'center'}, {title: '操作', templet:'#customerListBar',fixed:"right",align:"center", minWidth:150} ]] });});客户信息多条件查问事件增加
客户信息数据表格数据展现胜利后,接下来思考增加多条件查问点击事件,这里应用layui表格reload重载根底办法实现，点击这里参考官网介绍。
<script type="text/html" id="toolbarDemo"> <div class="layui-btn-container"> <a class="layui-btn layui-btn-normal addNews_btn" lay-event="add"> <i class="layui-icon"></i> 增加 </a> <a class="layui-btn layui-btn-normal " lay-event="link"> <i class="layui-icon"></i> 联系人治理 </a> <a class="layui-btn layui-btn-normal addNews_btn" lay-event="recode"> <i class="layui-icon"></i> 来往记录 </a> <a class="layui-btn layui-btn-normal addNews_btn" lay-event="order"> <i class="layui-icon"></i> 订单查看 </a> </div> </script>- customer.js 增加搜寻点击事件
// 多条件搜寻 $(".search_btn").on("click",function(){ table.reload("customerListTable",{ page: { curr: 1 //从新从第 1 页开始 }, where: { cusName: $("input[name='name']").val(), //客户名 cusNo: $("input[name='khno']").val(), //客户编号 level: $("#level").val() //客户等级 } }) });机会数据增加实现思路
/** * 1.参数校验 * 客户名称 name 非空 不可反复 * phone 联系电话 非空 格局符合规范 * 法人 非空 * 2.默认值设置 * isValid state cteaetDate updadteDate * khno 系统生成 惟一 (uuid| 工夫戳 | 年月日时分秒 雪花算法) *3.执行增加 判断后果 */机会数据增加外围代码
@Transactional(propagation = Propagation.REQUIRED)public void saveCustomer(Customer customer){ checkParams(customer.getName(),customer.getPhone(),customer.getFr()); AssertUtil.isTrue(null!=customerMapper.queryCustomerByName(customer.getName()),"该客户已存在!"); customer.setIsValid(1); customer.setState(0); customer.setCreateDate(new Date()); customer.setUpdateDate(new Date()); String khno = "KH_"+new SimpleDateFormat("yyyyMMddHHmmss").format(new Date()); customer.setKhno(khno); AssertUtil.isTrue(insertSelective(customer)<1,"客户增加失败!");}private void checkParams(String name, String phone, String fr) { AssertUtil.isTrue(StringUtils.isBlank(name),"请指定客户名称!"); AssertUtil.isTrue(!(PhoneUtil.isMobile(phone)),"手机号格局非法！"); AssertUtil.isTrue(StringUtils.isBlank(fr),"请指定公司法人!");}客户治理数据增加后端页面转发&增加办法调用
对于机会数据增加与更新表单页能够实现共享,这里在转发机会数据增加与更新页面时共用一套代码即可(思考更新时波及到机会数据显示操作，这里依据机会id查问机会记录并放入到申请域中)。
@RequestMapping("addOrUpdateSaleChancePage")public String addOrUpdateSaleChancePage(Integer id,Model model){ model.addAttribute("customer",customerService.selectByPrimaryKey(id)) ; return "customer/add_update";}@RequestMapping("save")@ResponseBodypublic ResultInfo saveCustomer(Customer customer){ customerService.saveCustomer(customer); return success("客户增加胜利");}客户治理增加前台模板与外围js
客户数据增加工具栏事件
这里对于对话框关上办法代码请参考官网页面
//头工具栏事件 table.on('toolbar(customers)', function(obj){ var checkStatus = table.checkStatus(obj.config.id); switch(obj.event){ case "add": openAddOrUpdateCustomerDialog(); break; }; }); // 关上增加客户数据页面 function openAddOrUpdateCustomerDialog(id){ var url = ctx+"/customer/addOrUpdateSaleChancePage"; var title="客户治理-增加"; if(id){ url = url+"?id="+id; title="客户治理-更新"; } layui.layer.open({ title : title, type : 2, area:["700px","500px"], maxmin:true, content : url }); }add_update.ftl 表单模板文件
views/customer目录下增加add_update.ftl 表单模板
<!DOCTYPE html><html><head> <#include "../common.ftl"></head><body class="childrenBody"><form class="layui-form" style="width:80%;"> <input name="id" type="hidden" value="${(customer.id)!}"/> <div class="layui-form-item layui-row"> <div class="layui-col-xs6"> <label class="layui-form-label">客户名称</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="name" id="name" lay-verify="required" value="${(customer.name)!}" placeholder="请输出客户名"> </div> </div> <div class="layui-col-xs6"> <label class="layui-form-label">法人</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="fr" id="fr" lay-verify="required" value="${(customer.fr)!}" placeholder="请输入法人"> </div> </div> </div> <div class="layui-form-item layui-row"> <div class="layui-col-xs6"> <label class="layui-form-label">区域</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="area" lay-verify="required" value="${(customer.area)!}" placeholder="请输出区域"> </div> </div> <div class="layui-col-xs6"> <label class="layui-form-label">客户经理</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="cusManager" value="${(customer.cusManager)!}" placeholder="请输出客户经理"> </div> </div> </div> <div class="layui-form-item layui-row"> <div class="layui-col-xs6"> <label class="layui-form-label">客户级别</label> <div class="layui-input-block"> <select name="level" id="level"> <option value="" >请抉择</option> <option value="一般客户">一般客户</option> <option value="重点开发客户" >重点开发客户</option> <option value="大客户" >大客户</option> <option value="合作伙伴" >合作伙伴</option> </select> </div> </div> <div class="layui-col-xs6"> <label class="layui-form-label">信用度</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="xyd" value="${(customer.xyd)!}" placeholder="请输出客户信用级别"> </div> </div> </div> <div class="layui-form-item layui-row"> <div class="layui-col-xs6"> <label class="layui-form-label">邮编</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="postCode" value="${(customer.postCode)!}" placeholder="请输出客户邮编"> </div> </div> <div class="layui-col-xs6"> <label class="layui-form-label">联系电话</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="phone" value="${(customer.phone)!}" placeholder="请输出客户联系电话"> </div> </div> </div> <div class="layui-form-item layui-row"> <div class="layui-col-xs6"> <label class="layui-form-label">客户地址</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="address" value="${(customer.address)!}" placeholder="请输出客户地址"> </div> </div> <div class="layui-col-xs6"> <label class="layui-form-label">传真</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="fax" value="${(customer.fax)!}" placeholder="请输出客户传真"> </div> </div> </div> <div class="layui-form-item layui-row"> <div class="layui-col-xs6"> <label class="layui-form-label">网站</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="webSite" value="${(customer.webSite)!}" placeholder="请输出客户网站地址"> </div> </div> <div class="layui-col-xs6"> <label class="layui-form-label">注册资金</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="zczj" value="${(customer.zczj)!}" placeholder="请输出注册资金"> </div> </div> </div> <div class="layui-form-item layui-row"> <div class="layui-col-xs6"> <label class="layui-form-label">开户行</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="khyh" value="${(customer.khyh)!}" placeholder="请输出客户开户行"> </div> </div> <div class="layui-col-xs6"> <label class="layui-form-label">开户账号</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="khzh" value="${(customer.khzh)!}" placeholder="请输出开户账号"> </div> </div> </div> <div class="layui-form-item layui-row"> <div class="layui-col-xs6"> <label class="layui-form-label">国税</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="gsdjh" value="${(customer.gsdjh)!}" placeholder="请输出国税"> </div> </div> <div class="layui-col-xs6"> <label class="layui-form-label">地税</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="dsdjh" value="${(customer.dsdjh)!}" placeholder="请输出地税"> </div> </div> </div> <div class="layui-form-item layui-row"> <div class="layui-col-xs6"> <label class="layui-form-label">年营业额</label> <div class="layui-input-block"> <input type="text" class="layui-input" name="nyye" value="${(customer.nyye)!}" placeholder="请输出客户年营业额"> </div> </div> </div> <br/> <div class="layui-form-item layui-row layui-col-xs12"> <div class="layui-input-block"> <button class="layui-btn layui-btn-lg" lay-submit="" lay-filter="addOrUpdateCustomer">确认 </button> <button class="layui-btn layui-btn-lg layui-btn-normal">勾销</button> </div> </div></form><script type="text/javascript" src="${ctx}/static/js/customer/add.update.js"></script></body></html>add.update.js 文件增加
js/customer目录下增加add.update.js 文件,实现机会数据增加与更新表单提交操作
layui.use(['form', 'layer'], function () { var form = layui.form, layer = parent.layer === undefined ? layui.layer : top.layer, $ = layui.jquery; form.on("submit(addOrUpdateCustomer)", function (data) { var index = top.layer.msg('数据提交中，请稍候', {icon: 16, time: false, shade: 0.8}); //弹出loading var url=ctx + "/customer/save"; if($("input[name='id']").val()){ url=ctx + "/customer/update"; } $.post(url, data.field, function (res) { if (res.code == 200) { setTimeout(function () { top.layer.close(index); top.layer.msg("操作胜利！"); layer.closeAll("iframe"); //刷新父页面 parent.location.reload(); }, 500); } else { layer.msg( res.msg, { icon: 5 } ); } }); return false; });});客户信息数据更新
客户信息数据后端更新
客户信息后端更新实现思路
/** * 1.参数校验 * 记录存在校验 * 客户名称 name 非空 不可反复 * phone 联系电话 非空 格局符合规范 * 法人 非空 * 2.默认值设置 * updadteDate *3.执行更新 判断后果 */客户信息数据更新外围代码
@Transactional(propagation = Propagation.REQUIRED) public void updateCustomer(Customer customer){ AssertUtil.isTrue(null==customer.getId()||null==selectByPrimaryKey(customer.getId()),"待更新记录不存在!"); checkParams(customer.getName(),customer.getPhone(),customer.getFr()); Customer temp =customerMapper.queryCustomerByName(customer.getName()); AssertUtil.isTrue(null !=temp && !(temp.getId().equals(customer.getId())),"该客户已存在!"); customer.setUpdateDate(new Date()); AssertUtil.isTrue(updateByPrimaryKeySelective(customer)<1,"客户更新失败!"); }客户信息数据更新后端页面转发 & 更新办法调用
这里客户信息数据更新页面视图与增加操作实现视图代码共用。
@RequestMapping("update") @ResponseBody public ResultInfo updateCustomer(Customer customer){ customerService.updateCustomer(customer); return success("客户更新胜利"); }客户信息数据前端模板与外围js
客户信息数据表格行监听事件增加
- sale.chance.js
表格增加行监听事件,行监听事件参考这里
/** * 行监听 */ table.on("tool(customers)", function(obj){ var layEvent = obj.event; if(layEvent === "edit") { openAddOrUpdateCustomerDialog(obj.data.id); } }); // 关上增加客户数据页面 function openAddOrUpdateCustomerDialog(id){ var url = ctx+"/customer/addOrUpdateSaleChancePage"; var title="客户治理-增加"; if(id){ url = url+"?id="+id; title="客户治理-更新"; } layui.layer.open({ title : title, type : 2, area:["700px","500px"], maxmin:true, content : url }); }客户信息管理数据删除
客户信息数据后端删除
[外链图片转存失败,源站可能有防盗链机制,倡议将图片保留下来间接上传(img-7ErRpREW-1608794638358)(images\image-20200227221545509.png)]
客户信息后端删除外围代码
- CustomerService.java
@Transactional(propagation = Propagation.REQUIRED)public void deleteCustomer(Integer cid){ Customer customer= selectByPrimaryKey(cid); AssertUtil.isTrue(null==cid||null==cid,"待删除记录不存在!"); /** * 如果客户被删除 * 级联 客户联系人 客户来往记录 客户订单 被删除 * * 如果客户被删除 * 如果子表存在记录 不反对删除 */ customer.setIsValid(0); AssertUtil.isTrue(updateByPrimaryKeySelective(customer)<1,"客户删除失败!");}- CustomerController.java
@RequestMapping("delete")@ResponseBodypublic ResultInfo deleteCustomer(Integer id){ customerService.deleteCustomer(id); return success("客户删除胜利");}