# Django-Vue-Admin 管理系统

## 📖 项目简介
本项目是一个全栈管理系统解决方案，包含：
1.  **管理后台**：基于 **Django** + **Vue.js** 的前后端分离管理系统。包含用户管理、权限管理 (RBAC)、CRM 客户关系管理以及工作流 (Workflow) 等功能模块。
2.  **微信小程序**：基于原生微信小程序开发，提供移动端服务。

## 🛠 技术栈

### 后端 (Backend) - `admin/server`
- **核心框架**: Django 3.2.23
- **API 框架**: Django REST Framework (DRF) 3.12.4
- **异步任务**: Celery 5.2.7
- **缓存/消息队列**: Redis
- **认证**: SimpleJWT
- **文档**: drf-yasg (Swagger/Redoc)

### 后端管理前端 (Web Client) - `admin/client`
- **核心框架**: Vue.js 2.6.10
- **UI 组件库**: Element UI 2.15.14
- **状态管理**: Vuex
- **路由管理**: Vue Router
- **脚手架**: Vue CLI

### 微信小程序 (Mini Program) - `wechat-mini-program`
- **开发框架**: 微信原生小程序 (Native)
- **UI 样式**: WXSS (支持 PostCSS)
- **配置文件**: `project.config.json`

## 📂 目录结构

```
gemini测试/
├── admin/               # 管理后台项目
│   ├── client/          # 管理后台前端源码 (Vue)
│   │   ├── src/         # 源代码
│   │   ├── package.json # 依赖配置
│   │   └── ...
│   └── server/          # 后端服务源码 (Django)
│       ├── apps/        # 业务应用模块 (crm, system, wf)
│       ├── server/      # 项目核心配置
│       ├── manage.py    # Django 管理脚本
│       └── ...
├── wechat-mini-program/ # 微信小程序源码
│   ├── pages/           # 小程序页面 (index, detail, etc.)
│   ├── utils/           # 工具函数
│   ├── app.json         # 全局配置
│   └── project.config.json # 项目配置
└── README.md            # 项目说明文档
```

## 🚀 快速开始

### 1. 环境准备
确保您的开发环境已安装以下软件：
- Python 3.8+
- Node.js 12+
- Redis (用于缓存和 Celery)
- Git
- 微信开发者工具 (用于小程序开发)

### 2. 后端启动 (Server)

进入后端目录：
```bash
cd admin/server
```

创建并激活虚拟环境 (推荐)：
```bash
# Windows
python -m venv .venv
.venv\Scripts\activate

# Linux/macOS
python3 -m venv .venv
source .venv/bin/activate
```

安装依赖：
```bash
pip install -r requirements.txt
```

配置数据库：
默认使用 SQLite，配置文件位于 `admin/server/server/conf_e.py`。如需修改为 MySQL/PostgreSQL，请修改该文件中的 `DATABASES` 配置。

执行数据库迁移：
```bash
python manage.py makemigrations
python manage.py migrate
```

创建超级管理员：
```bash
python manage.py createsuperuser
```

启动开发服务器：
```bash
python manage.py runserver
```
后端服务默认运行在 `http://127.0.0.1:8000`。

启动 Celery Worker (可选，用于异步任务)：
```bash
# Windows (需安装 gevent 或 eventlet)
celery -A server worker -l info -P eventlet

# Linux/macOS
celery -A server worker -l info
```

### 3. 后端管理前端启动 (Web Client)

进入前端目录：
```bash
cd admin/client
```

安装依赖：
```bash
npm install
# 或者使用 yarn / cnpm
# npm install --registry=https://registry.npmmirror.com
```

启动开发服务器：
```bash
npm run dev
```
前端服务启动后，通常访问地址为 `http://localhost:9528`。

### 4. 微信小程序启动 (Mini Program)

1.  下载并安装 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)。
2.  打开微信开发者工具，选择 **导入项目**。
3.  目录选择本项目下的 `wechat-mini-program` 文件夹。
4.  AppID 请在 `project.config.json` 中查看或替换为您自己的 AppID。
5.  点击 **编译** 即可预览。

**注意**: 请确保后端服务已启动，并在小程序代码中 (`utils/request.js` 或类似文件) 配置正确的后端 API 地址。

## 📦 功能模块

- **系统管理 (System)**
  - 用户/角色/菜单/部门管理。

- **客户关系管理 (CRM)**
  - 客户信息维护与线索管理。

- **工作流 (Workflow)**
  - 审批流程配置与流转。

- **移动端 (Mini Program)**
  - 首页展示、详情浏览、个人中心等功能。

## 🔧 部署构建

### Web 前端构建
```bash
cd admin/client
npm run build:prod
```
构建生成的静态文件位于 `admin/client/dist` 目录。

### 后端部署
推荐使用 Gunicorn + Nginx 进行部署。
参考 `admin/server/start.sh` 进行容器化部署。

### 小程序发布
在微信开发者工具中点击 **上传**，然后在微信公众平台进行版本管理和发布。

## 📄 许可证
MIT License
