# SCRM

**Repository Path**: CY2007/scrm

## Basic Information

- **Project Name**: SCRM
- **Description**: 企业微信管理工具，建设阶段
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-19
- **Last Updated**: 2026-05-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 企业微信SCRM系统

## 系统概述
企业微信SCRM（Social Customer Relationship Management）系统是一套完整的企业微信客户关系管理解决方案，帮助企业实现多企业微信账号统一管控、客户全生命周期管理、营销自动化等功能。

## 技术架构

### 后端技术栈
- **Java 17**: 编程语言
- **Spring Boot 3.2**: 核心框架
- **MyBatis-Plus 3.5**: ORM框架
- **MySQL 8.0**: 数据库
- **Redis**: 缓存
- **JWT**: 认证授权
- **WebSocket**: 实时通讯
- **Spring Schedule**: 定时任务
- **Swagger**: API文档

### 前端技术栈
- **Vue 3**: 核心框架
- **Vue Router 4**: 路由管理
- **Pinia**: 状态管理
- **Ant Design Vue 4**: UI组件库
- **Axios**: HTTP客户端
- **Vite**: 构建工具
- **WebSocket**: 实时通讯

## 功能完成清单

### ✅ 一、多企业微信账号统一管控模块

#### 1.1 多账号管理
- ✅ 多企业微信账号批量添加、绑定、解绑
- ✅ 企业主体区分（多主体运营）
- ✅ 账号状态实时监控（在线/离线/异常）
- ✅ 账号权限分级管控
- ✅ 单账号/多账号模式切换
- ✅ 账号信息批量编辑

#### 1.2 员工账号管理
- ✅ 多企微账号下员工批量导入、新增、禁用
- ✅ 员工离职处理
- ✅ 员工角色自定义（管理员、运营、销售、客服）
- ✅ 权限精细化分配
- ✅ 员工操作日志记录
- ✅ 员工离职继承（客户自动转移）
- ✅ 员工绩效数据统计

#### 1.3 组织架构管理
- ✅ 多企微账号共用组织架构
- ✅ 部门层级管理
- ✅ 员工批量分配部门
- ✅ 部门权限管控

### ✅ 二、客户全生命周期管理模块

#### 2.1 客户获取与沉淀
- ✅ 多企微账号统一生成渠道活码矩阵
- ✅ 按渠道区分（广告、门店、短视频、裂变、LBS）
- ✅ LBS定位+新老客区分
- ✅ 活码关联员工/部门，自动分流
- ✅ 员工好友接近上限自动分流
- ✅ 客户扫码后自动打标签
- ✅ 自动发送欢迎语
- ✅ 差异化欢迎语（新客/老客）

#### 2.2 客户画像与标签管理
- ✅ 客户360°全景画像
- ✅ 标签体系自定义（客户属性、行为、需求、消费能力）
- ✅ 自动打标签
- ✅ 客户分组管理
- ✅ 客户健康度评估（0-100分）
- ✅ 健康度低于60分自动预警

#### 2.3 客户跟进与维护
- ✅ 跟进计划设置
- ✅ 跟进提醒（系统通知）
- ✅ 跟进记录管理
- ✅ 客户沉默唤醒（30天未互动）
- ✅ 客户流失预警
- ✅ 流失客户挽回

#### 2.4 客户资产保护
- ✅ 客户数据加密存储
- ✅ 限制批量删除、导出
- ✅ 客户数据备份与恢复
- ✅ 客户归属权管理
- ✅ 转移后跟进记录同步迁移

### ✅ 三、营销自动化模块

#### 3.1 社群运营管理
- ✅ 多企微账号社群统一管理
- ✅ 社群批量创建、解散
- ✅ 社群标签管理
- ✅ 社群SOP管理（欢迎语、推送、活动提醒）
- ✅ 定时发送、触发式发送
- ✅ 群满自动新建
- ✅ 社群互动工具（投票、红包、打卡、抽奖）
- ✅ 社群风控（违规检测）

#### 3.2 营销活动管理
- ✅ 多企微账号统一创建营销活动
- ✅ 活动类型（裂变、优惠券、秒杀、抽奖）
- ✅ 裂变活动支持
- ✅ 老客邀请新客自动发放奖励
- ✅ 防刷功能
- ✅ 活动数据实时监控
- ✅ 活动模板库

#### 3.3 内容运营管理
- ✅ 多企微账号共用内容库
- ✅ 内容类型（图、文、视频、语音、链接）
- ✅ 朋友圈运营
- ✅ 按客户标签定向发送
- ✅ 内容定时发送
- ✅ 内容数据统计

#### 3.4 转化闭环管理
- ✅ 会员等级体系
- ✅ 积分规则（添加、邀请、进群、消费、兑换）
- ✅ 复购激活策略
- ✅ 商机管理（标记、跟踪、提醒）
- ✅ 商机进度管理

### ✅ 核心能力

#### 实时通讯
- ✅ WebSocket实时通知
- ✅ 客户流失即时通知
- ✅ 新客户提醒
- ✅ 跟进提醒
- ✅ 健康度预警

#### 自动化任务
- ✅ 客户健康度每日计算
- ✅ 沉默客户自动唤醒
- ✅ 流失客户挽回
- ✅ 自动打标签
- ✅ 跟进提醒
- ✅ SOP定时执行

#### 企微API对接
- ✅ AccessToken管理
- ✅ 消息发送
- ✅ 欢迎语发送
- ✅ 客户信息获取
- ✅ 群聊信息获取
- ✅ 标签管理
- ✅ 回调消息处理

## 数据库设计

### 核心表（20+）
1. `wecom_account` - 企微账号表
2. `wecom_employee` - 员工表
3. `sys_user` - 系统用户表
4. `sys_department` - 部门表
5. `sys_role` - 角色表
6. `sys_menu` - 菜单表
7. `crm_customer` - 客户表
8. `crm_tag` - 标签表
9. `crm_channel_code` - 渠道活码表
10. `crm_follow_record` - 跟进记录表
11. `crm_community` - 社群表
12. `crm_marketing_activity` - 营销活动表
13. `crm_content` - 内容库表
14. `crm_business` - 商机表
15. `sys_oper_log` - 操作日志表
16. `sys_job` - 定时任务表
17. `crm_member_level` - 会员等级表
18. `crm_customer_points` - 客户积分表

### 扩展表（11+）
19. `crm_customer_behavior` - 客户行为记录表
20. `wecom_callback_log` - 企微回调日志表
21. `crm_community_sop` - 社群SOP表
22. `crm_sop_execute_log` - SOP执行记录表
23. `crm_fission_record` - 裂变活动记录表
24. `crm_content_schedule` - 内容定时发送表
25. `wecom_api_log` - 企微API日志表
26. `crm_message_template` - 消息模板表
27. `crm_auto_task` - 自动化任务表
28. `crm_customer_recover` - 流失挽回记录表

## 项目结构

```
scrm/
├── scrm-server/                      # 后端服务
│   ├── src/main/java/com/scrm/
│   │   ├── common/                   # 通用模块
│   │   ├── config/                   # 配置模块
│   │   ├── controller/               # 控制器
│   │   ├── service/                  # 服务层
│   │   ├── mapper/                   # 数据层
│   │   ├── entity/                   # 实体类
│   │   └── util/                     # 工具类
│   └── src/main/resources/
│       └── application.yml
├── scrm-admin/                       # 前端管理后台
│   ├── src/
│   │   ├── views/                    # 页面组件
│   │   ├── router/                   # 路由配置
│   │   ├── pinia/                    # 状态管理
│   │   ├── utils/                    # 工具函数
│   │   └── assets/                   # 静态资源
│   └── package.json
└── sql/                              # 数据库脚本
    ├── scrm_database.sql             # 核心表
    └── update_v2.sql                 # 扩展表
```

## 快速开始

### 环境要求
- JDK 17+
- Node.js 18+
- MySQL 8.0+
- Redis 6.0+

### 后端启动

```bash
cd scrm-server
mvn clean install
mvn spring-boot:run
```

### 前端启动

```bash
cd scrm-admin
npm install
npm run dev
```

### 数据库初始化

```bash
mysql -u root -p < sql/scrm_database.sql
mysql -u root -p < sql/update_v2.sql
```

## API文档

启动后端服务后访问：
```
http://localhost:8080/swagger-ui.html
```

## 核心接口

### 企微账号管理
- `POST /api/wecom/account/bind` - 绑定企微账号
- `GET /api/wecom/account/list` - 获取账号列表
- `POST /api/wecom/account/unbind/{id}` - 解绑账号

### 员工管理
- `POST /api/wecom/employee` - 添加员工
- `GET /api/wecom/employee/page` - 分页查询
- `POST /api/wecom/employee/leave/{id}` - 员工离职

### 客户管理
- `POST /api/crm/customer` - 添加客户
- `GET /api/crm/customer/page` - 分页查询
- `GET /api/crm/customer/portrait/{id}` - 客户画像
- `POST /api/crm/customer/transfer/{id}` - 转移客户

### 标签管理
- `POST /api/crm/tag` - 添加标签
- `GET /api/crm/tag/tree` - 标签树

### 社群管理
- `GET /api/crm/community/list` - 社群列表

### 营销活动
- `POST /api/marketing/activity` - 创建活动

### 回调处理
- `POST /api/wecom/callback/receive` - 接收回调

## 定时任务

| 任务名称 | 执行时间 | 功能 |
|---------|---------|------|
| 健康度计算 | 每天02:00 | 计算所有客户健康度评分 |
| 沉默唤醒 | 每天03:00 | 唤醒30天未互动客户 |
| 流失挽回 | 每天10:00 | 发送挽回消息 |
| 绩效统计 | 每天00:00 | 统计员工绩效数据 |
| 内容发送 | 按配置 | 发送定时朋友圈/社群 |

## 安全特性

- ✅ 密码BCrypt加密存储
- ✅ JWT Token身份认证
- ✅ 操作日志完整记录
- ✅ 敏感操作权限控制
- ✅ 数据定期备份

## 待完善功能

- [ ] AI销售助手（话术推荐、聊天总结）
- [ ] 公域线索导入（抖音、美团API对接）
- [ ] 朋友圈智能运营（企微朋友圈API）
- [ ] 私域交易链路（商城对接）

## 许可证

MIT License