# ThinkCrmSystem迪信云客户管理系统

**Repository Path**: petplanet/think-crm-system

## Basic Information

- **Project Name**: ThinkCrmSystem迪信云客户管理系统
- **Description**: 基于 ThinkPHP 8 + Vue 3 + TypeScript + Vite + Element Plus + Pinia 的开源 CRM 管理系统：线索与客户、项目、产品订单、回款与维护费、工作台催款、业务统计，适合中小企业与团队二次开发。
- **Primary Language**: PHP
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://gitee.com/petplanet
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-18
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Think CRM System

基于 **ThinkPHP 8** + **Vue 3 + TypeScript + Vite + Element Plus + Pinia** 的开源 CRM 管理系统：线索与客户、项目、产品订单、回款与维护费、工作台催款、业务统计，适合中小企业与团队二次开发。

| 语言 | 说明 |
|------|------|
| 中文 | 本文档 |
| English | [README.en.md](./README.en.md) |

## 关于迪信云

**[XH team](https://zhengqianlo.cn/)** 专注软件研发，面向企业与创业者提供标准化产品及定制开发服务。  
本仓库在 DxinAdmin 管理框架之上集成完整 CRM 业务，可直接部署或 fork 后扩展。

## 功能概览

| 模块 | 能力 |
|------|------|
| **客户中心** | 线索、正式客户、公海池、跟进记录 |
| **项目管理** | 项目款项、状态（含已结束/烂账口径）、同事共享只读 |
| **产品中心** | 分类、产品、售价/成本 |
| **交易回款** | 产品订单（定金/部分/结清）、回款登记、续费维护费 |
| **业务统计** | 款项汇总、近 7 日趋势与周期构成（等高对齐）、业务漏斗 |
| **工作台** | 指标、催款提醒、7 日趋势/构成、待跟进、快捷入口 |
| **权限体系** | 菜单 RBAC + GrantScope 子集授权 + CRM 数据隔离 |
| **系统能力** | 项目信息、备案、政策协议、上传、定时任务 |

款项模型（项目款 / 订单款 / 维护费、烂账口径）详见 [docs/crm.md](docs/crm.md)。

## 技术栈

| 端 | 技术 |
|----|------|
| 后端 | ThinkPHP 8、think-orm、think-multi-app（`adminapi`） |
| 前端 | Vue 3.5、Vite 6、TypeScript、Element Plus、Pinia |
| 数据库 | MySQL 5.7+ / 8.0，表前缀默认 `da_` |

## 环境要求

| 项 | 要求 |
|----|------|
| PHP | **8.2+**（json、mbstring、openssl、pdo_mysql、fileinfo；可选 gd） |
| MySQL | 5.7+ / 8.0，utf8mb4 |
| Node.js | 18+ |
| Composer | 仅升级 ThinkPHP / 依赖时需要；日常克隆 **不必** `composer install` |

## 目录结构

```text
dxin-crm-system/
├── server/                          # 后端（含 vendor，可直接 php think）
│   ├── app/adminapi/                # 管理端 API + CRM
│   ├── public/                      # Web 入口（站点根目录）
│   ├── sql/
│   │   ├── dxin_crm_system.sql      # v1.0.0 基线
│   │   ├── dxin_crm_system_full.sql # 最新完整库（新装推荐）
│   │   └── upgrade/crm_v1.0.x.sql   # 增量升级
│   └── .env.example
├── admin/                           # 管理端前端（npm）
└── docs/                            # 安装、SQL、CRM、升级说明
```

## 命令行工作目录

| 操作 | 目录 |
|------|------|
| `php think run`、`php think clear`、编辑 `.env` | **`server/`** |
| `npm install`、`npm run dev`、`npm run build` | **`admin/`** |

---

## 快速开始

### 1. 克隆与配置

```bash
git clone <your-gitee-repo-url> dxin-crm-system
cd dxin-crm-system/server
copy .env.example .env          # Windows；Linux 用 cp
```

编辑 `server/.env`（**UTF-8 无 BOM**）：

```ini
DB_HOST = 127.0.0.1
DB_NAME = dxin_crm_system
DB_USER = root
DB_PASS = 你的密码
DB_PREFIX = da_

project.unique_identification = dxin_crm_system
```

### 2. 导入数据库

**推荐：最新完整库**

```bash
mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS dxin_crm_system DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;"
mysql -u root -p dxin_crm_system < sql/dxin_crm_system_full.sql
```

- 仅要 v1.0.0 基线：改导入 `sql/dxin_crm_system.sql`，再按顺序执行 `sql/upgrade/crm_v1.0.x.sql`
- 脚本规划详见 [docs/sql.md](docs/sql.md)

### 3. 启动后端

```bash
cd server
php think run
# 默认 http://127.0.0.1:8000
```

验证：`GET http://127.0.0.1:8000/adminapi/config/getConfig` 应返回 `code=1`。

**默认账号**：`root` / `123456`（请立即修改）

### 4. 启动前端

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

`admin/.env.development`：

```ini
VITE_APP_BASE_URL=http://127.0.0.1:8000
```

浏览器访问：<http://localhost:5173/admin/>

---

## 生产部署（概要）

1. 站点根目录指向 **`server/public`**
2. PHP 8.2 + MySQL，导入 **`dxin_crm_system_full.sql`**
3. 配置 Nginx ThinkPHP 伪静态（见 [docs/install.md](docs/install.md)）
4. `cd admin && npm run build`，将 `dist/*` 复制到 `server/public/admin/`
5. 生产 `VITE_APP_BASE_URL` 留空（同源 `/adminapi`）
6. 定时任务：` * * * * * php think crontab:run`（每分钟）

宝塔 / phpEnv 详细步骤见 [docs/install.md](docs/install.md) 与下文 README 历史章节（Windows 本地、Linux 宝塔）。

---

## 数据库与版本

| 文件 | 用途 |
|------|------|
| `server/sql/dxin_crm_system.sql` | v1.0.0 基线（全新安装） |
| `server/sql/dxin_crm_system_full.sql` | 当前 release 完整库（**新装推荐**） |
| `server/sql/upgrade/crm_v1.0.1.sql` … | 自 1.0.0 起按序增量升级 |

线上升级流程：[docs/upgrade.md](docs/upgrade.md) · 脚本文档：[docs/sql.md](docs/sql.md)

---

## 文档索引

| 文档 | 说明 |
|------|------|
| [docs/install.md](docs/install.md) | 安装细节、cron、常见问题 |
| [docs/sql.md](docs/sql.md) | 数据库脚本规划与升级顺序 |
| [docs/crm.md](docs/crm.md) | CRM 模块、款项模型、统计/工作台 |
| [docs/upgrade.md](docs/upgrade.md) | 代码与数据库升级 |
| [docs/CHANGELOG.md](docs/CHANGELOG.md) | 版本变更 |
| [docs/README.md](docs/README.md) | 文档目录 |

## 开源到 Gitee 建议流程

1. **Fork / 新建仓库** → 推送本代码
2. **补充 LICENSE**（若尚未添加）与仓库简介、标签（ThinkPHP、Vue3、CRM）
3. **Release** 附带说明：对应 `dxin_crm_system_full.sql` 版本号
4. **Issues 模板**：环境、PHP/MySQL 版本、是否 full 安装、报错截图
5. **演示站**（可选）：只读 `app_demo=true`，定期重置数据库

## 开发约定

- 管理端页面路径与 `admin/src/views` 一致，菜单编辑支持扫描联想
- Windows 下 `.vue` 保存为 **UTF-8（无 BOM）**
- CRM 款项计算统一走 `CrmProjectFinanceService`，勿在页面重复写口径
- 后端中间件：`server/app/adminapi/config/route.php`

## License

后端 `server/vendor/` 含 ThinkPHP 等第三方依赖，见其各自协议；业务代码以仓库根目录 LICENSE 为准（发布前请确认已添加 LICENSE 文件）。