# CRM

**Repository Path**: liupantl/crm

## Basic Information

- **Project Name**: CRM
- **Description**: CRM客户管理系统
一款功能完善、界面美观的企业级客户关系管理系统，帮助企业高效管理客户资源、跟踪销售机会、分析业务数据。

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CRM客户管理系统

一款功能完善、界面美观的企业级客户关系管理系统，帮助企业高效管理客户资源、跟踪销售机会、分析业务数据。

## 技术栈

### 后端
- **Spring Boot 3.5.x** - 核心框架
- **MyBatis-Plus 3.5.x** - ORM框架
- **MySQL 8.0+** - 数据库
- **JWT** - 身份认证
- **Lombok** - 代码简化

### 前端
- **Vue 3.4.x** - 前端框架
- **Element Plus 2.7.x** - UI组件库
- **Vue Router 4.x** - 路由管理
- **Pinia 2.x** - 状态管理
- **Axios** - HTTP请求
- **ECharts** - 数据可视化

## 项目结构

```
CRM/
├── crm-backend/          # 后端项目
│   ├── src/main/java/com/crm/
│   │   ├── common/       # 公共类
│   │   ├── config/       # 配置类
│   │   ├── controller/   # 控制器层
│   │   ├── entity/       # 实体类
│   │   ├── mapper/       # 数据访问层
│   │   ├── service/      # 服务层
│   │   └── util/         # 工具类
│   └── src/main/resources/
│       ├── db/           # 数据库脚本
│       └── application.yml
│
└── crm-frontend/         # 前端项目
    ├── src/
    │   ├── api/          # API接口
    │   ├── assets/       # 静态资源
    │   ├── components/   # 公共组件
    │   ├── router/       # 路由配置
    │   ├── stores/       # Pinia状态
    │   ├── utils/        # 工具函数
    │   └── views/        # 页面视图
    └── package.json
```

## 功能模块

### 1. 用户认证
- 用户登录/登出
- JWT Token认证
- 用户信息管理

### 2. 客户管理
- 客户信息CRUD
- 客户分类（潜在客户、正式客户、流失客户）
- 客户跟进记录
- 客户行业分布统计

### 3. 销售管理
- 商机管理
- 订单管理
- 销售阶段跟踪

### 4. 报表分析
- 仪表盘统计
- 销售趋势图
- 客户分布图
- 商机阶段分布

### 5. 系统管理
- 用户管理
- 角色管理
- 权限控制

## 界面特色

### 登录页
- 全屏轮播图背景（4张商务风格图片）
- 毛玻璃效果登录卡片
- 平滑过渡动画
- 响应式布局

### 首页仪表盘
- 顶部统计卡片（客户数、订单数、销售额等）
- 销售趋势折线图
- 客户行业分布饼图
- 商机阶段柱状图
- 待办事项列表

## 快速开始

### 环境要求
- JDK 21+
- Node.js 18+
- MySQL 8.0+

### 后端启动

1. 创建数据库
```sql
-- 执行数据库初始化脚本
crm-backend/src/main/resources/db/schema.sql
```

2. 修改数据库配置
```yaml
# crm-backend/src/main/resources/application.yml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/crm_db
    username: root
    password: your_password
```

3. 启动项目
```bash
cd crm-backend
./mvnw spring-boot:run
```

后端服务默认运行在 http://localhost:8080

### 前端启动

```bash
cd crm-frontend
npm install
npm run dev
```

前端服务默认运行在 http://localhost:3000

### 默认账号
- 用户名: admin
- 密码: admin123

## API文档

启动后端服务后，访问 Swagger UI:
http://localhost:8080/swagger-ui.html

## 开发计划

- [x] 基础架构搭建
- [x] 用户认证模块
- [x] 客户管理模块
- [x] 报表统计模块
- [x] 登录页轮播图
- [x] 首页仪表盘
- [ ] 商机管理模块
- [ ] 订单管理模块
- [ ] 系统管理模块
- [ ] 数据权限控制

## 截图

### 登录页
登录页采用全屏轮播图背景，展示4张商务风格图片，配有毛玻璃效果的登录卡片，整体画面协调丝滑。

### 首页仪表盘
首页展示统计卡片、销售趋势图、客户分布图、商机阶段分布图和待办事项，数据可视化效果丰富。

## 许可证

MIT License