# KP-PRPP-CRM

**Repository Path**: elfbobo_admin_admin/KP-PRPP-CRM

## Basic Information

- **Project Name**: KP-PRPP-CRM
- **Description**: KP-PRPP-CRM是一款基于 BuildAdmin 框架开发的一体化销售管理平台，采用前后端分离架构，集成了客户管理、商机管理、订单管理、产品管理、财务管理、任务管理等核心功能，旨在帮助企业实现销售流程的数字化、智能化管理。

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

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-07
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<br />
<div align="center">
    <h1 style="font-size: 36px;color: #2c3e50;font-weight: 600;margin: 0 0 6px 0;">PRPP CRM - 一体化销售管理平台</h1>
    <p style="font-size: 17px;color: #6a8bad;margin-bottom: 10px;">基于 BuildAdmin 框架的企业级客户关系管理系统</p>
</div>
<br />
<p align="center">
    <a href="https://www.thinkphp.cn/" target="_blank">
        <img src="https://img.shields.io/badge/ThinkPHP-%3E8.1-brightgreen?color=91aac3&labelColor=439EFD" alt="thinkphp">
    </a>
    <a href="https://v3.vuejs.org/" target="_blank">
        <img src="https://img.shields.io/badge/Vue-%3E3.5-brightgreen?color=91aac3&labelColor=439EFD" alt="vue">
    </a>
    <a href="https://element-plus.org/zh-CN/guide/changelog.html" target="_blank">
        <img src="https://img.shields.io/badge/Element--Plus-%3E2.9-brightgreen?color=91aac3&labelColor=439EFD" alt="element plus">
    </a>
    <a href="https://www.tslang.cn/" target="_blank">
        <img src="https://img.shields.io/badge/TypeScript-%3E5.7-blue?color=91aac3&labelColor=439EFD" alt="typescript">
    </a>
    <a href="https://vitejs.dev/" target="_blank">
        <img src="https://img.shields.io/badge/Vite-%3E6.0-blue?color=91aac3&labelColor=439EFD" alt="vite">
    </a>
    <a href="https://pinia.vuejs.org/" target="_blank">
        <img src="https://img.shields.io/badge/Pinia-%3E2.3-blue?color=91aac3&labelColor=439EFD" alt="pinia">
    </a>
    <a href="LICENSE" target="_blank">
        <img src="https://img.shields.io/badge/Apache2.0-license-blue?color=91aac3&labelColor=439EFD" alt="license">
    </a>
</p>

<br>

### 📖 项目介绍

**KP-PRPP-CRM** 是一款基于 BuildAdmin 框架开发的一体化销售管理平台，采用前后端分离架构，集成了客户管理、商机管理、订单管理、产品管理、财务管理、任务管理等核心功能，旨在帮助企业实现销售流程的数字化、智能化管理。

#### 💡 核心功能模块

**🎯 客户信息管理**

- 完整的客户档案：支持客户基本信息、联系方式、地址、附件等多维度管理
- 客户分级分类：支持 VIP、高级、普通、潜在等等级的客户等级体系
- 客户行业细分：覆盖科技、金融、教育、医疗等 10+ 个行业分类
- 客户标签体系：支持自定义标签颜色与分类，精准标记客户特征
- 客户跟进记录：完整的跟进历史，支持电话、拜访、邮件等多种跟进方式
- 合作状态追踪：实时统计累计订单金额、最后订单时间等关键指标

**💼 商机全流程管理**

- 商机阶段管理：新商机→已联系→已报价→谈判中→待签合同→已成交/已丢失
- 商机优先级划分：支持低/中/高/紧急四个优先级
- 商机类型分类：产品类、服务类、项目类多种类型
- 预期与实际对比：支持预期成交金额与实际成交金额对比分析
- 成交概率评估：0-100% 成交概率预测
- 竞争对手分析：记录竞争对手信息，制定针对性策略
- 商机关联用户：支持多销售人员协同跟进同一商机

**📝 订单精细化管理**

- 订单全生命周期管理：从洽谈、报价、合同、收款、交付到完成的全流程跟踪
- 产品明细管理：支持单个订单包含多个产品明细项
- 价格体系完善：产品单价、成本价、运费、税费、利润自动计算
- 支付状态跟踪：未支付、部分支付、已支付、超额支付多种状态
- 发货物流管理：物流公司、物流单号、发货状态实时更新
- 开票管理：支持部分开票、全部开票等多种开票状态
- 销售提成计算：自动计算销售提成比例与金额

**🛍️ 产品与库存管理**

- 产品分类体系：支持多级产品分类（电子产品、家居用品、服装配饰等）
- 产品信息完善：产品编码、名称、描述、图片、单位等完整信息
- 价格管理：单价、成本价双重价格体系
- 库存预警：支持库存数量监控与预警设置
- 佣金设置：每个产品可独立设置销售提成比例
- 最小起订量：支持设置产品最小订购量

**💰 财务管理**

- 财务记录管理：收入、支出、提成、成本四种财务类型
- 支付方式多样：现金、微信、支付宝、线上支付、银行转账
- 支付状态跟踪：待支付、已支付、退款三种状态
- 财务描述详细：每笔财务记录支持详细描述
- 关联订单管理：财务记录与订单一一关联

**📊 销售业绩统计**

- 业绩月度统计：订单数量、订单总额、提成总额自动统计
- 新增客户数：每月新增客户数量统计
- 商机转化率：商机数量与转化效率分析
- 销售漏斗：线索→商机→方案→谈判→成交的完整漏斗分析

**✅ 任务与待办管理**

- 任务清单管理：周期事项与定期事项两种类型
- 任务状态跟踪：已完成、未完成、进行中三种状态
- 任务分配：支持将任务分配给指定用户

**📢 市场营销活动**

- 营销活动管理：邮件、短信、社交、活动等多种营销类型
- 预算与实际对比：支持预算与实际花费对比分析
- 预期与实际收入：营销活动 ROI 分析
- 活动联系人管理：记录客户对营销活动的响应情况

**🔔 系统通知**

- 消息通知：系统通知、任务通知、销售通知、市场通知
- 已读未读状态：实时跟踪消息阅读状态
- 关联业务 ID：支持关联具体业务记录

#### ✨ 系统特色

**🚀 可视化 CRUD代码生成**

- 图形化拖拽生成后台增删改查代码
- 自动创建数据表，支持 24 种表单组件
- 表格行拖拽排序，受权限控制的编辑和删除
- 支持关联表操作，节省大量开发时间

**💻 前后端分离架构**

- 后端：ThinkPHP 8 + MySQL
- 前端：Vue 3 + TypeScript + Vite + Pinia + Element Plus
- 代码完全分离，便于前后端协作开发

**🔐 完善的权限管理**

- 可视化权限管理界面
- 动态注册路由、菜单、页面、按钮权限
- 支持无限父子级权限分组
- 前后端搭配鉴权，自由分派页面和按钮权限

**♻️ 数据回收站机制**

- 全局数据回收站，支持字段级数据修改记录
- 修改对比可视化展示
- 随时回滚和还原数据，安全无感

**🎨 高颜值界面设计**

- 无边框设计风格，功能版块悬浮布局
- 合理高效利用屏幕空间
- 自适应 PC、平板、手机等多端

**⚡️ 高性能体验**

- 支持常驻内存运行，性能提升数十倍
- 前端组件按需加载
- 服务端基于 PSR 规范真正按需加载

### 🛠️ 技术栈

#### 后端技术

- **框架**: ThinkPHP 8.1.1
- **数据库**: MySQL 5.7+
- **语言**: PHP 8.2.9+
- **依赖管理**: Composer
- **其他**: Workerman(WebSocket)、PayLib(支付)

#### 前端技术

- **框架**: Vue 3.5.13
- **构建工具**: Vite 6.3.5
- **语言**: TypeScript 5.7.2
- **UI 组件库**: Element Plus 2.9.1
- **状态管理**: Pinia 2.3.0
- **路由**: Vue Router 4.5.0
- **HTTP 客户端**: Axios 1.9.0
- **图表**: ECharts 5.5.1
- **代码编辑器**: MD Editor V3 5.1.1

### 📦 安装部署

#### 环境要求

- PHP >= 8.2.9
- MySQL >= 5.7
- Node.js >= 18.x
- Composer >= 2.x
- NPM / PNPM / Yarn

#### 后端安装

```bash
# 克隆项目
git clone https://gitee.com/your-repo/prpp-crm.git

# 进入项目目录
cd prpp-crm

# 安装依赖
composer install

# 配置环境变量
cp .env-example.env

# 导入数据库
mysql -u root -p prpp_cms < database/ba.sql
mysql -u root -p prpp_cms < database/prpp.sql
mysql -u root -p prpp_cms < database/prpp_data.sql

# 设置目录权限
chmod -R 777 runtime public/uploads

# 启动服务 (传统模式)
php think run

# 或使用 Workerman 常驻内存模式 (需要安装 Workerman 模块)
php think worker:start
```

#### 前端安装

```bash
# 进入前端目录
cd web

# 安装依赖 (推荐使用 pnpm)
pnpm install

# 启动开发服务器
pnpm dev

# 构建生产版本
pnpm build
```

### 📸 系统截图

#### 登录页面

![登录](https://doc.buildadmin.com/images/readme/login.gif)

#### 控制台

![控制台](https://doc.buildadmin.com/images/readme/dashboard.png)

#### 客户管理

![客户列表](https://via.placeholder.com/800x450.png?text=客户管理)

#### 商机管理

![商机列表](https://via.placeholder.com/800x450.png?text=商机管理)

#### 订单管理

![订单列表](https://via.placeholder.com/800x450.png?text=订单管理)

#### 产品管理

![产品列表](https://via.placeholder.com/800x450.png?text=产品管理)

#### 财务管理

![财务列表](https://via.placeholder.com/800x450.png?text=财务管理)

#### 系统配置

![系统配置](https://doc.buildadmin.com/images/readme/config.png)

### 📋 数据库说明

系统数据库包含以下核心数据表：

#### 基础数据表

- `kp_admin` - 管理员表
- `kp_admin_group` - 管理分组表
- `kp_user` - 用户表

#### 客户管理表

- `kp_client` - 客户表
- `kp_client_contact` - 客户联系方式表
- `kp_client_industry` - 客户行业表
- `kp_client_level` - 客户等级表
- `kp_client_tag` - 客户标签表
- `kp_client_tag_ref` - 客户标签关联表
- `kp_client_follow` - 客户跟进记录表
- `kp_client_address` - 客户地址表

#### 商机管理表

- `kp_opp` - 商机表
- `kp_opp_follow` - 商机跟进记录表
- `kp_opp_ref` - 商机关联用户表

#### 订单管理表

- `kp_orders` - 销售订单表
- `kp_orders_item` - 订单明细表

#### 产品管理表

- `kp_product` - 产品表
- `kp_product_category` - 产品分类表

#### 财务管理表

- `kp_finance` - 财务记录表
- `kp_sales_performance` - 销售业绩统计表

#### 任务管理表

- `kp_task` - 任务清单表
- `kp_task_ref` - 用户任务清单表

#### 营销管理表

- `kp_marketing_campaign` - 市场营销活动表
- `kp_marketing_campaign_contact` - 市场营销活动联系人表

#### 系统管理表

- `kp_notification` - 通知表
- `kp_sales_funnel` - 销售漏斗表

### 🔧 开发与贡献

#### 开发指南

```bash
# 克隆项目后
git checkout -b feature/your-feature-name

# 开发完成后提交
git commit -m "feat: add your feature description"
git push origin feature/your-feature-name

# 创建 Pull Request
```

#### 贡献指南

我们欢迎任何形式的贡献，包括但不限于：

- Bug 修复
- 功能新增
- 文档完善
- 性能优化
- 问题反馈

### 📄 开源协议

本项目遵循 [Apache2.0](LICENSE) 开源协议发布，提供无需授权的免费使用，可自由用于商业用途。

### 🙏 特别鸣谢

感谢以下开源项目提供的支持：

- [BuildAdmin](https://gitee.com/wonderful-code/buildadmin) - 基础框架
- [ThinkPHP](http://www.thinkphp.cn/) - PHP 框架
- [Vue](https://github.com/vuejs/core) - 前端框架
- [Element Plus](https://github.com/element-plus/element-plus) - UI 组件库
- [TypeScript](https://github.com/microsoft/TypeScript) - 编程语言
- [Vite](https://github.com/vitejs/vite) - 构建工具
- [Pinia](https://github.com/vuejs/pinia) - 状态管理

### 📞 联系我们

- **问题反馈**: 请通过 Gitee Issues 提交问题
- **技术交流**: 欢迎加入我们的开发者社区
- **商务合作**: 请联系项目负责人

### 🌟 Star History

如果这个项目对您有帮助，请给我们一个 ⭐ Star！您的支持是我们持续更新的动力！

---

<div align="center">
    <p>Copyright © 2026 PRPP CRM Team</p>
</div>