# django-vue3-admin-lk

**Repository Path**: lao-ke1990/django-vue3-admin

## Basic Information

- **Project Name**: django-vue3-admin-lk
- **Description**: django-vue3-admin 是一套全部开源的快速开发平台，毫无保留给个人免费使用、团体授权使用。 django-vue3-admin 基于RBAC模型的权限控制的一整套基础开发平台，权限粒度达到列级别，前后端分离，后端采用django + django-rest-framework，前端采用基于 vue3 + CompositionAPI + typescript + vite + ele
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: rygl
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1185
- **Created**: 2025-10-18
- **Last Updated**: 2025-10-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# django-vue3-admin

[![license](https://img.shields.io/github/license/liqianggh/django-vue3-admin)](https://github.com/liqianggh/django-vue3-admin)
[![license](https://img.shields.io/github/languages/code-size/liqianggh/django-vue3-admin)](https://github.com/liqianggh/django-vue3-admin)
[![license](https://img.shields.io/github/commit-activity/m/liqianggh/django-vue3-admin)](https://github.com/liqianggh/django-vue3-admin)

# 平台简介

- 本项目后端采用 Django 框架，前端采用 Vue3 + Element Plus 实现。
- 实现了前后端分离的后台管理系统，包含用户管理、角色管理、菜单管理、部门管理、岗位管理、字典管理、参数配置、通知公告、操作日志、登录日志、定时任务等基础功能。
- 集成了权限管理、菜单管理、组织架构管理、数据字典等通用功能模块。

# 本地开发

## 后端启动

1. 进入后端目录
   ```bash
   cd backend
   ```

2. 复制环境变量配置文件
   ```bash
   cp conf/env.example.py conf/env.py
   ```
   修改 `conf/env.py` 中的数据库配置和其他相关配置

3. 创建并激活虚拟环境（如果尚未创建）
   ```bash
   # 在项目根目录下创建虚拟环境
   cd ..
   python3 -m venv venv
   ```
   
4. 激活虚拟环境并安装依赖
   ```bash
   # 检查是否存在虚拟环境，如果存在则激活
   if [ -d "venv" ]; then
       source venv/bin/activate
   fi
   
   # 安装依赖
   cd backend
   pip install -r requirements.txt
   ```

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

6. 初始化数据
   ```bash
   python manage.py init -y
   ```

7. 启动服务
   ```bash
   python manage.py runserver 0.0.0.0:8000
   ```
   
   或者使用我们提供的本地开发启动脚本（推荐）：
   ```bash
   ./start_dev.sh
   ```

## 前端启动

1. 进入前端目录
   ```bash
   cd frontend
   ```

2. 安装依赖
   ```bash
   npm install
   ```

3. 启动服务
   ```bash
   npm run dev
   ```

# 项目结构

```
django-vue3-admin
├── backend              # 后端项目
│   ├── application      # Django项目配置
│   ├── conf             # 配置文件
│   ├── dvadmin          # 业务模块
│   ├── manage.py        # Django管理脚本
│   └── requirements.txt # 依赖文件
├── frontend             # 前端项目
│   ├── public           # 静态资源
│   └── src              # 源码
└── README.md            # 说明文档
```

# 功能模块

- 用户管理：管理系统用户
- 角色管理：管理用户角色和权限
- 菜单管理：配置系统菜单
- 部门管理：管理组织架构
- 岗位管理：管理系统岗位
- 字典管理：管理系统字典数据
- 参数配置：管理系统参数
- 通知公告：管理系统通知公告
- 操作日志：记录用户操作日志
- 登录日志：记录用户登录日志
- 定时任务：管理系统定时任务

# 技术栈

## 后端技术

- Django 4.2
- Django REST Framework
- MySQL 8.0
- Redis
- Celery
- Simple JWT

## 前端技术

- Vue 3
- Element Plus
- Vite
- Pinia
- Vue Router

# 部署说明

## 后端部署

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

2. 配置环境变量
   ```bash
   cp conf/env.example.py conf/env.py
   ```
   修改 `conf/env.py` 中的配置

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

4. 初始化数据
   ```bash
   python manage.py init -y
   ```

5. 启动服务
   ```bash
   # 开发环境
   python manage.py runserver 0.0.0.0:8000
   
   # 生产环境
   gunicorn application.asgi:application -c gunicorn_conf.py
   ```

## 前端部署

1. 构建项目
   ```bash
   npm run build
   ```

2. 部署静态文件
   将 `dist` 目录下的文件部署到 Web 服务器

# 许可证

[MIT](LICENSE)