admin/gemini-cs

Fork 0

Files

admin 0bbb3d0a47 Initial commit

2025-12-09 02:45:30 +08:00

4.7 KiB

Raw Permalink Blame History

Django-Vue-Admin 管理系统

📖 项目简介

本项目是一个全栈管理系统解决方案，包含：

管理后台：基于 Django + Vue.js 的前后端分离管理系统。包含用户管理、权限管理 (RBAC)、CRM 客户关系管理以及工作流 (Workflow) 等功能模块。
微信小程序：基于原生微信小程序开发，提供移动端服务。

🛠 技术栈

后端 (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)

进入后端目录：

cd admin/server

创建并激活虚拟环境 (推荐)：

# Windows
python -m venv .venv
.venv\Scripts\activate

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

安装依赖：

pip install -r requirements.txt

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

执行数据库迁移：

python manage.py makemigrations
python manage.py migrate

创建超级管理员：

python manage.py createsuperuser

启动开发服务器：

python manage.py runserver

后端服务默认运行在 http://127.0.0.1:8000。

启动 Celery Worker (可选，用于异步任务)：

# Windows (需安装 gevent 或 eventlet)
celery -A server worker -l info -P eventlet

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

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

进入前端目录：

cd admin/client

安装依赖：

npm install
# 或者使用 yarn / cnpm
# npm install --registry=https://registry.npmmirror.com

启动开发服务器：

npm run dev

前端服务启动后，通常访问地址为 http://localhost:9528。

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

下载并安装微信开发者工具。
打开微信开发者工具，选择 导入项目。
目录选择本项目下的 wechat-mini-program 文件夹。
AppID 请在 project.config.json 中查看或替换为您自己的 AppID。
点击编译即可预览。

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

📦 功能模块

系统管理 (System)
- 用户/角色/菜单/部门管理。
客户关系管理 (CRM)
- 客户信息维护与线索管理。
工作流 (Workflow)
- 审批流程配置与流转。
移动端 (Mini Program)
- 首页展示、详情浏览、个人中心等功能。

🔧 部署构建

Web 前端构建

cd admin/client
npm run build:prod

构建生成的静态文件位于 admin/client/dist 目录。

后端部署

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

小程序发布

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

📄 许可证

MIT License

4.7 KiB Raw Permalink Blame History Unescape Escape