一套千万级用户量的开源CRM系统

目前软件已达到千万级的用户量，开源系统下载量达到200多万次，已覆盖设计制造业、服务业、金融业、政府机构等多种行业。与阿里巴巴、腾讯、OPPO、航天信息、CCTV等多家知名企业达成战略合作。

目录结构

wk_crm
├── admin         -- 系统管理模块和用户管理模块
├── authorization -- 鉴权模块，目前仅用于登录鉴权，后期可能有更改
├── bi            -- 商业智能模块
├── core          -- 通用的代码和工具类
├── crm           -- 客户管理模块
├── examine       -- 审批模块
├── gateway       -- 网关模块
├── job           -- 定时任务模块
├── oa            -- OA模块
└── work          -- 项目管理模块
└── hrm           -- 人力资源管理模块

核心功能模块

CRM/OA功能：
客户管理：客户数据录入，支持数据查重，数据转移
线索管理：支持线索转化客户
客户池管理：可配置多个客户池，根据成交等多种条件设置回收规则
商机管理：支持设置多个商机，商机阶段自定义配置
合同管理：合同审批流配置
回款管理：回款审核、审批流配置
办公审批：支持配置审批流（请假、报销、借款、出差等自定义配置）
日程/任务：支持任务分配、任务

人力资源功能：

招聘管理：支持候选人添加、筛选、面试管理
人员管理：多维度组织架构配置
薪酬管理：可以灵活配置薪酬类型
社保管理：支持全国不同地区社保配置
绩效考核：灵活配置绩效考核流程，支持OKR和KPI绩效考核模板

员工端：
员工自助查询个人信息、薪酬信息、社保信息、绩效考核信息

系统配置：
系统自定义字段配置
审批流配置
员工组织架构配置
角色权限配置（精确到字段权限）
日志配置
公海规则配置
业务参数配置
初始化数据配置
其他配置

主要技术栈

项目架构图

使用说明

一、前置环境

• Jdk1.8

• Maven3.5.0+

• Mysql5.7.20 （数据库安装注意事项）

• Redis(版本不限)

• Elasticsearch 6.8.6 （环境配置注意事项）

• Seata（1.2.0）（配置说明）

• Sentinel（1.7.2）（项目中sentinel使用8079端口）

• Nacos（1.2.1)

手动安装说明

1. 导入初始化sql,目前项目下gateway模块使用的独立数据库，其他模块使用同一数据库

• 安装nacos，新建数据库 nacos
   在nacos
  数据库中运行 DB/nacos.sql
  
  修改nacos安装目录/conf/application.properties文件，修改数据持久化类型为mysql，添加mysql数据源的url、用户名和密码,配置如下。
  

   spring.datasource.platform=mysql
   db.num=1
   db.url.0=jdbc:mysql://127.0.0.1:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true
   db.user=root
   db.password=password

• 修改gateway模块数据库配置为nacos
  数据库

• 初始化其余模块数据库：新建数据库 wk_crm_single
   在wk_crm_single
  数据库中运行 DB/wk_crm_single.sql
  

• 初始化定时任务模块数据库：新建数据库 xxl_job
   在xxl_job
  数据库中运行 DB/xxl_job.sql
  

• 初始化seata数据库：新建数据库 seata
   在seata
  数据库中运行 DB/seata.sql
  

2.在项目根目录执行mvn install

3.在各个模块下resource目录配置数据库帐号信息以及redis帐号信息（默认使用的是application-dev.yml配置文件,打包后启动脚本默认使用的application-test.yml配置文件）

4.在crm\src\main\resources\application-dev.yml
里面修改elasticsearch配置

spring.elasticsearch.rest.uris = elasticsearch地址 例：127.0.0.1:9200
spring.elasticsearch.rest.username = elasticsearch用户名 例：elastic 无密码可留空
spring.elasticsearch.rest.password = elasticsearch密码 例: password 无密码可留空

注意：elasticsearch 配置注意点

5.（可选）修改系统中文件上传地址，默认为本地配置，本地上传还需配置公网地址，指向服务器网关

crm.upload.config:1                文件上传配置 1:本地 2:阿里云OSS 
crm.upload.oss                     oss上传文件所需配置内容 
crm.upload.oss.bucketName        需要配置两个bucket，0为登录才可访问文件上传地址，1为完全公开文件上传地址
crm.upload.local                   本地上传文件所需配置内容 
crm.upload.local.uploadPath      需要配置两个地址0为登录才可访问文件上传地址，1为完全公开文件上传地址

6.（可选）修改jetcache缓存配置详见

7.（可选）项目日志文件在core\src\main\resources\logback-spring.xml
修改

8. 项目打包部署

·在项目根目录下执行 mvn clean -Dmaven.test.skip=true package
·然后把对应模块下target文件夹下
·${name}-${version}-SNAPSHOT.zip/tar.gz上传到服务器,例：admin-0.0.1-SNAPSHOT.zip 并将压缩文件解压，检查对应配置文件。

9. 项目启动

先启动nacos,seata,sentinel, elasticsearch,mysql,redis等基础服务
在第八步解压的文件模块下通过执行`sh 72crm.sh start`（windows下直接运行72crm.bat）启动各个模块服务。
其中项目基础模块：gateway，authorization，admin必须启动，其他模块可按需启动。
启动完成后，在浏览器中访问：http://localhost:8443/即可登录系统

10. 初始化用户信息

访问http://localhost:8443/  
按照提示初始化超级管理员账号和密码信息，成功之后使用初始化后的管理员账户登录系统添加其他员工，分配权限等

11. 升级说明以及注意事项

1、后端代码更新直接下载全量代码替换即可
2、数据库更新请下载 DB/update/V11.x.x.sql，增量执行即可（比如当前版本为V11.0.1，升级为V11.1.0需执行 V11.0.2.sql,V11.1.0.sql）
3、docker更新请使用在线更新或手动将数据库数据备份后执行增量升级SQL，再备份至本地，然后下载新版docker镜像，将增量升级后SQL恢复至新版数据库

三、其他说明

1.代码生成器及接口文档

代码生成器地址：core\src\test\com\kakarote\generator\Generator.java
接口文档地址`http://localhost:8443/doc.html`

2.模块依赖关系

- 除网关外，其余项目均依赖于admin模块，用于获取当前登录人的信息
- oa模块的任务依赖于work模块，其余一些关联业务功能依赖于crm模块，examine模块
- 商业智能依赖crm,oa模块

四、功能模块预览

下载地址，请关注微信公众号，回复数字6