Django-Vue3-Admin升级指南：从旧版本迁移到最新版

【免费下载链接】django-vue3-adminDjango-Vue3-Admin is a comprehensive basic development platform based on the RBAC (Role-Based Access Control) model for permission control, with column-level granularity. It follows a frontend-backend separation architecture, with项目地址: https://gitcode.com/gh_mirrors/dj/django-vue3-admin

Django-Vue3-Admin是基于RBAC模型的权限控制开发平台，权限粒度达到列级别，采用前后端分离架构。本指南将帮助您快速完成从旧版本到最新版的迁移，确保系统平稳升级并享受全新功能体验。

为什么选择升级到最新版？

最新版的Django-Vue3-Admin带来了多项重要改进：

• 更完善的列权限管控，粒度细化到每一列
• 优化的前端架构，采用Vue3+TS+pinia+fastcrud
• 增强的安全性和性能优化
• 丰富的插件生态系统，如审批流插件、celery插件等

Django-Vue3-Admin登录界面展示

升级前的准备工作

在开始升级前，请确保您的环境满足以下要求：

环境要求

• Python >= 3.11.0 (最低3.9+版本)
• Node.js >= 16.0
• Mysql >= 8.0 (可选，默认数据库sqlite3，支持5.7+，推荐8.0版本)
• Redis (可选，最新版)

数据备份

在升级前，请务必备份您的数据库和重要配置文件：

# 数据库备份示例 mysqldump -u username -p database_name > backup_before_upgrade.sql

快速升级步骤

1. 获取最新代码

git clone https://gitcode.com/gh_mirrors/dj/django-vue3-admin cd django-vue3-admin

2. 后端升级

2.1 配置环境变量

cd backend cp ./conf/env.example.py ./conf/env.py

编辑env.py文件，配置数据库信息等必要参数。

2.2 安装依赖

pip3 install -r requirements.txt

2.3 执行数据库迁移

python3 manage.py makemigrations python3 manage.py migrate

2.4 初始化数据

python3 manage.py init python3 manage.py init_area

3. 前端升级

3.1 安装依赖

cd ../web npm install yarn yarn install --registry=https://registry.npmmirror.com

3.2 构建前端

yarn run build

4. 启动服务

# 后端启动 cd ../backend python3 manage.py runserver 0.0.0.0:8000 # 或使用uvicorn uvicorn application.asgi:application --port 8000 --host 0.0.0.0 --workers 8 # 前端启动（开发模式） cd ../web yarn run dev

Docker方式升级

如果您使用Docker部署，可以通过以下步骤快速升级：

# 拉取最新代码后执行 docker-compose up -d --build # 初始化后端数据 docker exec -ti dvadmin3-django bash python manage.py makemigrations python manage.py migrate python manage.py init_area python manage.py init exit

升级后验证

升级完成后，访问系统验证是否正常运行：

• 前端地址：http://127.0.0.1:8080
• 后端地址：http://127.0.0.1:8080/api
• 使用账号：superadmin，密码：admin123456登录系统

常见问题解决

依赖冲突问题

如果遇到依赖冲突，可以尝试创建虚拟环境并重新安装依赖：

python -m venv venv source venv/bin/activate # Windows系统使用 venv\Scripts\activate pip install -r requirements.txt

数据库迁移失败

如果数据库迁移失败，请检查数据库版本是否符合要求，并确保备份数据后尝试：

python manage.py makemigrations --empty app_name python manage.py migrate

探索新功能

升级完成后，您可以探索最新版带来的新功能：

插件市场

最新版支持插件扩展，您可以访问插件市场获取更多功能插件，如：

• dvadmin3-folw 后台审批流插件
• dvadmin3 celery插件
• dvadmin3-build插件

列权限控制

新的列权限管控功能可以在system/columns/目录下找到相关实现，您可以根据需求配置更精细的数据权限。

总结

通过本指南，您已经成功将Django-Vue3-Admin升级到最新版本。如果在升级过程中遇到任何问题，欢迎通过社区寻求帮助。祝您使用愉快！

提示：定期关注项目更新，及时获取最新功能和安全补丁。

【免费下载链接】django-vue3-adminDjango-Vue3-Admin is a comprehensive basic development platform based on the RBAC (Role-Based Access Control) model for permission control, with column-level granularity. It follows a frontend-backend separation architecture, with项目地址: https://gitcode.com/gh_mirrors/dj/django-vue3-admin