diff --git a/DjangoAdmin_Django_AntdVue/.vitepress/config/shared.ts b/DjangoAdmin_Django_AntdVue/.vitepress/config/shared.ts index 6eed447..9ad31b0 100644 Binary files a/DjangoAdmin_Django_AntdVue/.vitepress/config/shared.ts and b/DjangoAdmin_Django_AntdVue/.vitepress/config/shared.ts differ diff --git a/DjangoAdmin_Django_AntdVue/.vitepress/config/zh.ts b/DjangoAdmin_Django_AntdVue/.vitepress/config/zh.ts index 18523b5..ed8b103 100644 --- a/DjangoAdmin_Django_AntdVue/.vitepress/config/zh.ts +++ b/DjangoAdmin_Django_AntdVue/.vitepress/config/zh.ts @@ -3,7 +3,7 @@ import type { DefaultTheme, LocaleSpecificConfig } from "vitepress"; export const META_URL = "https://www.djangoadmin.cn"; export const META_TITLE = "DjangoAdmin 企业级中台解决方案"; export const META_DESCRIPTION = - "DjangoAdmin 企业级中台解决方案 - Django + ElementPlus 前后端分离版本"; + "DjangoAdmin 企业级中台解决方案 - Django + AntDesign 前后端分离版本"; export const zhConfig: LocaleSpecificConfig = { description: META_DESCRIPTION, @@ -30,7 +30,7 @@ export const zhConfig: LocaleSpecificConfig = { themeConfig: { editLink: { - pattern: "https://gitee.com/djangoadmin/DjangoAdmin_Django_EleVue", + pattern: "https://gitee.com/djangoadmin/DjangoAdmin_Django_AntdVue", text: "对本页提出修改建议", }, @@ -197,7 +197,7 @@ export const zhConfig: LocaleSpecificConfig = { }, { text: "Gitee 仓库", - link: "https://gitee.com/djangoadmin/DjangoAdmin_Django_EleVue", + link: "https://gitee.com/djangoadmin/DjangoAdmin_Django_AntdVue", }, { text: "Django 文档", @@ -208,8 +208,8 @@ export const zhConfig: LocaleSpecificConfig = { link: "https://cn.vuejs.org/", }, { - text: "ElementPlus", - link: "https://element-plus.org/zh-CN/", + text: "Ant Design Vue", + link: "https://antdv.com/components/overview", }, ], }, @@ -779,10 +779,10 @@ export const zhConfig: LocaleSpecificConfig = { }, // ================================================================ - // 第 9 章：其他 + // 第 9 章：附录 // ================================================================ { - text: "📄 9. 其他", + text: "📄 附录", collapsed: false, items: [ { text: "9.1 常见问题汇总", link: "/zh/faq.html" }, @@ -790,7 +790,7 @@ export const zhConfig: LocaleSpecificConfig = { { text: "9.3 免责声明", link: "/zh/other/declare.html" }, { text: "9.4 开源协议", - link: "https://gitee.com/djangoadmin/DjangoAdmin_Django_EleVue/blob/master/LICENSE", + link: "https://gitee.com/djangoadmin/DjangoAdmin_Django_AntdVue/blob/master/LICENSE", }, { text: "9.5 广告赞助", link: "/zh/other/sponsor.html" }, ], diff --git a/DjangoAdmin_Django_AntdVue/index.md b/DjangoAdmin_Django_AntdVue/index.md index 5dd7f17..e14f5e6 100644 --- a/DjangoAdmin_Django_AntdVue/index.md +++ b/DjangoAdmin_Django_AntdVue/index.md @@ -2,11 +2,11 @@ layout: home title: DjangoAdmin文档 -titleTemplate: 前后端分离Django+ElementPlus版 +titleTemplate: 前后端分离Django+AntDesign版 hero: name: DjangoAdmin - text: "企业级中台解决方案Django+ElementPlus版" + text: "企业级中台解决方案Django+AntDesign版" tagline: "赋能开发者，助力企业发展。\n企业级数据平台底座 · 让数字化触手可及。" image: src: /logo.svg @@ -17,7 +17,7 @@ hero: link: /zh/introduction - theme: alt text: 在线演示 - link: http://manage.django.elevue.djangoadmin.cn + link: http://manage.django.antdvue.djangoadmin.cn - theme: alt text: 官方授权 link: https://www.djangoadmin.cn/goods/detail/2 diff --git a/DjangoAdmin_Django_AntdVue/zh/changelog.md b/DjangoAdmin_Django_AntdVue/zh/changelog.md index ff043fd..682c51e 100644 --- a/DjangoAdmin_Django_AntdVue/zh/changelog.md +++ b/DjangoAdmin_Django_AntdVue/zh/changelog.md @@ -12,15 +12,15 @@ | 2.1.0 | 2024-06-23 | RBAC 权限体系 + JWT 认证 + 验证码 | | 2.2.0 | 2024-09-06 | 字典管理 + 系统配置 + 参数管理 | | 2.3.0 | 2024-12-19 | 文章管理 + 分类管理 + 文件上传 + XSS 防护 | -| 2.4.0 | 2025-03-11 | Vue3 + ElementPlus + TypeScript + Vite | +| 2.4.0 | 2025-03-11 | Vue3 + Ant Design Vue + TypeScript + Vite | | 2.5.0 | 2025-06-25 | 代码生成器 CLI + Web UI + Excel 导入导出 | | 2.6.0 | 2025-09-17 | 定时任务 + 操作日志 + 登录日志 | | 2.7.0 | 2025-12-08 | 接口限流 + IP 地理位置 + 安全防护 | | 2.8.0 | 2026-03-22 | Docker 容器化 + Nginx + Supervisor | | 2.9.0 | 2026-06-15 | 文档体系 + 缓存优化 + 性能提升 | -| **3.0.0** | **2026-09-01** | **Django 6.0 + Python 3.12 + 架构优化** | +| **3.0.0** | **2026-09-10** | **Django 6.0 + Python 3.12 + 架构优化** | -## [3.0.0] - 2026-09-01 +## [3.0.0] - 2026-09-10 **Django 6.0 升级，技术栈全面焕新。** @@ -172,7 +172,7 @@ ### 新增 - **Vue3 升级**：前端框架从 Vue 2 升级至 Vue3.4+，全面拥抱 Composition API -- **ElementPlus**：采用 ElementPlus 组件库，适配 Vue3 生态 +- **Ant Design Vue**：采用 Ant Design Vue 组件库，适配 Vue3 生态 - **Pinia 状态管理**：替代 Vuex，更轻量、更灵活、TypeScript 支持更完善 - **TypeScript 类型安全**：全量类型定义，IDE 智能提示与编译时类型检查 - **Vite 构建工具**：替代 Webpack，开发服务器毫秒级启动，HMR 即时生效 @@ -274,7 +274,7 @@ - **Django Web 框架**：基于 Django 5.x，成熟的 MTV 架构，丰富的生态系统 - **Django ORM**：声明式模型定义，自动迁移，多数据库方言支持 - **Django ModelForm**：声明式表单验证，自动错误信息生成 -- **Vue3 前端**：基于 Vue3 + ElementPlus，前后端分离架构 +- **Vue3 前端**：基于 Vue3 + Ant Design Vue，前后端分离架构 - **用户管理**：用户账号管理、密码重置、启用/停用状态控制 - **角色管理**：角色 CRUD、权限节点配置 - **菜单管理**：菜单 CRUD、图标设置、动态路由生成 diff --git a/DjangoAdmin_Django_AntdVue/zh/course.md b/DjangoAdmin_Django_AntdVue/zh/course.md index aaec8cd..6523ab2 100644 --- a/DjangoAdmin_Django_AntdVue/zh/course.md +++ b/DjangoAdmin_Django_AntdVue/zh/course.md @@ -45,7 +45,7 @@ ```bash # 进入项目目录（以实际解压路径为准） -cd DjangoAdmin_Django_EleVue +cd DjangoAdmin_Django_AntdVue ``` :::tip 温馨提示 @@ -112,7 +112,7 @@ REDIS_DB=0 DJANGO_FILE_URL=http://file.django.elevue ``` -:::danger +:::danger 重要提示 `DATABASE_NAME` 需要提前在 MySQL 中创建对应的数据库： ```sql CREATE DATABASE `djangoadmin.django.elevue` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; diff --git a/DjangoAdmin_Django_AntdVue/zh/introduction.md b/DjangoAdmin_Django_AntdVue/zh/introduction.md index 17bf11b..d40f7ff 100644 --- a/DjangoAdmin_Django_AntdVue/zh/introduction.md +++ b/DjangoAdmin_Django_AntdVue/zh/introduction.md @@ -8,9 +8,9 @@ ## 软件说明 -基于 Django、Django ORM、Vue3、TypeScript、Vite、ElementPlus、MySQL 等技术栈构建的企业级前后端分离后台管理系统。 +基于 Django、Django ORM、Vue3、TypeScript、Vite、Ant Design Vue 等技术栈构建的企业级前后端分离后台管理系统，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库。 -后端采用 Python 语言，基于 Django Web 框架、Django ORM 数据库操作、Django Form 数据校验等主流技术栈；前端基于 Vue3、TypeScript、Vite 构建，采用 ElementPlus 框架，遵循 Vue 前后端分离主流设计思想。 +后端采用 Python 语言，基于 Django Web 框架、Django ORM 数据库操作、Django Form 数据校验等主流技术栈；前端基于 Vue3、TypeScript、Vite 构建，采用 Ant Design Vue 框架，遵循 Vue 前后端分离主流设计思想。 系统采用完全前后端分离架构，前端通过 API 调用后端服务实现数据交互。内置完善的 RBAC 权限体系，权限颗粒度精细至按钮级别；支持多主题切换，兼容桌面端和平板端。系统预置了用户、角色、菜单、部门、岗位、职级、日志、字典、配置、参数、定时任务、代码生成器等基础功能模块，开箱即用。 @@ -21,7 +21,7 @@ + **分层架构**：Model（数据）→ Form（验证）→ Service（业务）→ View（视图）→ URL（路由），职责清晰 + **基类复用**：BaseModel 提供 6 个公共字段（id、创建人、时间、软删除），子类只需声明业务字段 + **模块可插拔**：业务模块位于 `application/`，按 Django App 机制注册，增删不影响核心框架 -+ **多数据库支持**：通过 `DATABASE_ENGINE` 环境变量一键切换 MySQL / PostgreSQL / SQLite / Oracle ++ **多数据库支持**：通过 `DATABASE_ENGINE` 环境变量一键切换 MySQL / PostgreSQL / SQLite / Oracle / SQL Server 等数据库 + **中间件可扩展**：CORS、认证、权限、日志通过 Django 中间件链式处理，按需注册 + **RBAC 权限**：后端 PermissionRequired + 前端 v-perm 指令双重校验，精确到按钮级 + **代码生成器**：根据数据库表结构一键生成前后端 CRUD 代码，含列表、表单、API 全套 @@ -42,13 +42,17 @@ + **通知公告**：主要对通知、公告等站内数据进行管理 + **行政区划**：针对全国行政区划分数据进行管理和维护 + **文件模板**：主要对系统中使用的文件模板进行上传和管理 ++ **文件上传**：提供统一的文件上传服务，支持图片、文档等多类型文件管理，自动重命名、按日期分目录存储 ++ **友情链接**：用于管理外部链接和合作伙伴链接数据，支持分类管理和排序 ++ **文章管理**：用于发布和管理文章内容，支持富文本编辑、分类管理和状态管理 + **任务调度**：主要用于对定时任务进行定义和统一调度管理 + **代码生成**：根据数据库表结构一键生成前后端 CRUD 代码，含列表、表单、API 全套 + **分类管理**：用于文章分类、商品分类等树形分类数据的管理 ++ **示例模块**：提供代码生成器的示例参考，展示标准 CRUD 模块的实现方式 ## 软件出处 -+ 软件名称：小蚂蚁云前后端分离Django+ElementPlus版本 ++ 软件名称：小蚂蚁云前后端分离Django+AntDesign版本 + 软件作者：@小蚂蚁云团队 + 软件协议：Apache-2.0 + 官网网址：[https://www.djangoadmin.cn](https://www.djangoadmin.cn) @@ -59,82 +63,84 @@ | 版本名称 | 说明 | 地址 | |:---------|:-----|:-----| -| Django+Layui混编版 | 基于 Django、Jinja2、Layui、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Django_Layui) | -| Django+EleVue前后端分离版 | 基于 Django、Django ORM、Vue3、ElementPlus、TypeScript、Vite、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Django_EleVue) | -| Django+AntdVue前后端分离版 | 基于 Django、Django ORM、Vue3、AntDesign、TypeScript、Vite、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Django_AntdVue) | -| Django+NaiveVue前后端分离版 | 基于 Django、Django ORM、Vue3、NaiveUI、TypeScript、Vite、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Django_NaiveVue) | -| Flask+Layui混编版 | 基于 Flask、Jinja2、Layui、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Flask_Layui) | -| Flask+EleVue前后端分离版 | 基于 Flask、SQLAlchemy、Pydantic、Vue3、ElementPlus、TypeScript、Vite、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Flask_EleVue) | -| Flask+AntdVue前后端分离版 | 基于 Flask、SQLAlchemy、Pydantic、Vue3、AntDesign、TypeScript、Vite、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Flask_AntdVue) | -| Flask+NaiveVue前后端分离版 | 基于 Flask、SQLAlchemy、Pydantic、Vue3、NaiveUI、TypeScript、Vite、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Flask_NaiveVue) | -| FastAPI+Layui混编版 | 基于 FastAPI、Jinja2、Layui、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Fastapi_Layui) | -| FastAPI+EleVue前后端分离版 | 基于 FastAPI、SQLAlchemy、Pydantic、Vue3、ElementPlus、TypeScript、Vite、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Fastapi_EleVue) | -| FastAPI+AntdVue前后端分离版 | 基于 FastAPI、SQLAlchemy、Pydantic、Vue3、AntDesign、TypeScript、Vite、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Fastapi_AntdVue) | -| FastAPI+NaiveVue前后端分离版 | 基于 FastAPI、SQLAlchemy、Pydantic、Vue3、NaiveUI、TypeScript、Vite、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Fastapi_NaiveVue) | -| Tornado+Layui混编版 | 基于 Tornado、Jinja2、Layui、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Tornado_Layui) | -| Tornado+EleVue前后端分离版 | 基于 Tornado、SQLAlchemy、Pydantic、Vue3、ElementPlus、TypeScript、Vite、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Tornado_EleVue) | -| Tornado+AntdVue前后端分离版 | 基于 Tornado、SQLAlchemy、Pydantic、Vue3、AntDesign、TypeScript、Vite、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Tornado_AntdVue) | -| Tornado+NaiveVue前后端分离版 | 基于 Tornado、SQLAlchemy、Pydantic、Vue3、NaiveUI、TypeScript、Vite、MySQL 等技术栈 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Tornado_NaiveVue) | +| Django+Layui混编版 | 基于 Django、Jinja2、Layui 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Django_Layui) | +| Django+ElementPlus前后端分离版 | 基于 Django、Django ORM、Vue3、ElementPlus、TypeScript、Vite 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Django_EleVue) | +| Django+AntDesign前后端分离版 | 基于 Django、Django ORM、Vue3、AntDesign、TypeScript、Vite 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Django_AntdVue) | +| Django+NaiveUI前后端分离版 | 基于 Django、Django ORM、Vue3、NaiveUI、TypeScript、Vite 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Django_NaiveVue) | +| Flask+Layui混编版 | 基于 Flask、Jinja2、Layui 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Flask_Layui) | +| Flask+ElementPlus前后端分离版 | 基于 Flask、SQLAlchemy、Pydantic、Vue3、ElementPlus、TypeScript、Vite 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Flask_EleVue) | +| Flask+AntDesign前后端分离版 | 基于 Flask、SQLAlchemy、Pydantic、Vue3、AntDesign、TypeScript、Vite 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Flask_AntdVue) | +| Flask+NaiveUI前后端分离版 | 基于 Flask、SQLAlchemy、Pydantic、Vue3、NaiveUI、TypeScript、Vite 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Flask_NaiveVue) | +| FastAPI+Layui混编版 | 基于 FastAPI、Jinja2、Layui 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Fastapi_Layui) | +| FastAPI+ElementPlus前后端分离版 | 基于 FastAPI、SQLAlchemy、Pydantic、Vue3、ElementPlus、TypeScript、Vite 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Fastapi_EleVue) | +| FastAPI+AntDesign前后端分离版 | 基于 FastAPI、SQLAlchemy、Pydantic、Vue3、AntDesign、TypeScript、Vite 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Fastapi_AntdVue) | +| FastAPI+NaiveUI前后端分离版 | 基于 FastAPI、SQLAlchemy、Pydantic、Vue3、NaiveUI、TypeScript、Vite 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Fastapi_NaiveVue) | +| Tornado+Layui混编版 | 基于 Tornado、Jinja2、Layui 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Tornado_Layui) | +| Tornado+ElementPlus前后端分离版 | 基于 Tornado、SQLAlchemy、Pydantic、Vue3、ElementPlus、TypeScript、Vite 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Tornado_EleVue) | +| Tornado+AntDesign前后端分离版 | 基于 Tornado、SQLAlchemy、Pydantic、Vue3、AntDesign、TypeScript、Vite 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Tornado_AntdVue) | +| Tornado+NaiveUI前后端分离版 | 基于 Tornado、SQLAlchemy、Pydantic、Vue3、NaiveUI、TypeScript、Vite 等技术栈，支持 MySQL、PostgreSQL、SQLite、Oracle、SQL Server 等数据库 | [Gitee地址](https://gitee.com/djangoadmin/DjangoAdmin_Tornado_NaiveVue) | ## 模块展示 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
## 开源协议 @@ -145,4 +151,3 @@ ## 版权信息 版权所有 Copyright © 2021~2026 [djangoadmin.cn](https://www.djangoadmin.cn) All rights reserved。 - diff --git a/DjangoAdmin_Django_AntdVue/zh/other/contributing.md b/DjangoAdmin_Django_AntdVue/zh/other/contributing.md index 68c9275..2d327c8 100644 --- a/DjangoAdmin_Django_AntdVue/zh/other/contributing.md +++ b/DjangoAdmin_Django_AntdVue/zh/other/contributing.md @@ -7,7 +7,7 @@ ## 开发环境搭建 1. Fork 项目到自己的 Gitee/GitHub 账号 -2. 克隆到本地：`git clone https://gitee.com/yourname/DjangoAdmin_Django_EleVue.git` +2. 克隆到本地：`git clone https://gitee.com/yourname/DjangoAdmin_Django_AntdVue.git` 3. 参考 [开发环境准备](/zh/volume1/environment.html) 安装依赖 4. 创建开发分支：`git checkout -b feature/your-feature` @@ -60,7 +60,7 @@ feat(generator): 支持树形表格模板生成 - 新增 ui2/ 树形模板目录 - 自动识别 parent_id/pid 字段 -- 支持 el-tree-select 组件 +- 支持 a-tree-select 组件 Closes #123 ``` diff --git a/DjangoAdmin_Django_AntdVue/zh/struct.md b/DjangoAdmin_Django_AntdVue/zh/struct.md index e2a0cc3..5347f87 100644 --- a/DjangoAdmin_Django_AntdVue/zh/struct.md +++ b/DjangoAdmin_Django_AntdVue/zh/struct.md @@ -3,7 +3,6 @@ ## 整体结构 ``` -DjangoAdmin_Django_EleVue/ ├── application/ # Django 应用目录（所有业务模块） │ ├── example/ # 示例模块（标准 CRUD 模板，可作为开发参考） │ │ ├── models.py # 数据模型 diff --git a/DjangoAdmin_Django_AntdVue/zh/volume1/backend.md b/DjangoAdmin_Django_AntdVue/zh/volume1/backend.md index 519bbd4..19b7615 100644 --- a/DjangoAdmin_Django_AntdVue/zh/volume1/backend.md +++ b/DjangoAdmin_Django_AntdVue/zh/volume1/backend.md @@ -19,7 +19,7 @@ ```bash # 进入项目根目录（以实际解压路径为准 -cd DjangoAdmin_Django_EleVue +cd DjangoAdmin_Django_AntdVue ``` :::tip 温馨提示 @@ -204,14 +204,7 @@ python manage.py migrate `makemigrations` 会根据 `models.py` 中的模型定义自动生成迁移文件，`migrate` 会执行迁移文件创建或修改数据表结构。更多数据库相关内容请参见 [数据库初始化](/zh/volume1/database) 章节。 ::: -### 第三步：回填数据库字段注释（可选） - -```bash -# 为数据库表和字段添加中文注释 -python manage.py add_full_comments -``` - -### 第四步：导入初始数据 +### 第三步：导入初始数据 数据库初始数据（管理员账号、默认角色、菜单权限等）通过 SQL 脚本导入。脚本位于项目对应目录中： diff --git a/DjangoAdmin_Django_AntdVue/zh/volume1/database.md b/DjangoAdmin_Django_AntdVue/zh/volume1/database.md index d061e51..5efc94b 100644 --- a/DjangoAdmin_Django_AntdVue/zh/volume1/database.md +++ b/DjangoAdmin_Django_AntdVue/zh/volume1/database.md @@ -54,7 +54,7 @@ DATABASE_PREFIX="django_" # 数据表前缀 | MySQL | `django.db.backends.mysql` | 3306 | mysqlclient | | PostgreSQL | `django.db.backends.postgresql` | 5432 | psycopg2-binary | | SQLite | `django.db.backends.sqlite3` | - | 内置 | -| Oracle | `django.db.backends.oracle` | 1521 | cx-Oracle | +| Oracle | `django.db.backends.oracle` | 1521 | oracledb | | SQL Server | `mssql` | 1433 | mssql-django | 切换数据库引擎后，需安装对应的 Python 驱动包。例如切换到 PostgreSQL： @@ -122,20 +122,7 @@ mysql -uroot -p djangoadmin.django.elevue < document/mysql/djangoadmin.django.el | 系统配置 | 系统默认配置项 | ::: -## 第五步：回填数据库字段注释（可选） - -项目提供了自定义管理命令，用于为数据库表和字段添加中文注释： - -```bash -# 为所有数据表添加字段注释 -python manage.py add_full_comments -``` - -:::tip 温馨提示 -此命令会读取 Django 模型中的 `verbose_name` 和 `help_text` 属性，将其写入数据库的字段注释中，便于使用 Navicat 等工具查看表结构时理解每个字段的含义。 -::: - -## 第六步：验证 +## 第五步：验证 启动后端服务，验证数据库连接是否正常： @@ -271,7 +258,6 @@ cp db_backup.sqlite3 db.sqlite3 2. 配置 .env：设置 DATABASE_ENGINE、DATABASE_NAME 等连接信息 3. 执行迁移：python manage.py makemigrations && python manage.py migrate 4. 导入初始数据：mysql ... < document/mysql/djangoadmin.django.elevue.sql -5. 回填注释（可选）：python manage.py add_full_comments ``` 后续的模型变更通过 Django 迁移系统管理（`makemigrations` + `migrate`），确保数据库结构与代码保持同步。如需使用代码生成器创建新模块，生成器会自动处理数据库迁移。 diff --git a/DjangoAdmin_Django_AntdVue/zh/volume1/env-vars.md b/DjangoAdmin_Django_AntdVue/zh/volume1/env-vars.md index ce6d622..e7cd37e 100644 --- a/DjangoAdmin_Django_AntdVue/zh/volume1/env-vars.md +++ b/DjangoAdmin_Django_AntdVue/zh/volume1/env-vars.md @@ -146,8 +146,8 @@ DJANGO_NAME=Django+EleVue旗舰版 DJANGO_VERSION=v3.0.0 DJANGO_DEBUG=True DJANGO_DEMO=False # 代码默认True（演示模式），开发环境设为False以启用写操作 -DJANGO_UPLOAD_DIR="E:\DjangoAdmin_V3\DjangoAdmin_Django_EleVue\public\uploads" -DJANGO_FILE_URL='http://file.django.elevue' +DJANGO_UPLOAD_DIR="E:\DjangoAdmin_Django_AntdVue\public\uploads" +DJANGO_FILE_URL='http://file.django.antdvue' # ============================================================ # 数据库配置 diff --git a/DjangoAdmin_Django_AntdVue/zh/volume1/environment.md b/DjangoAdmin_Django_AntdVue/zh/volume1/environment.md index b69e2dd..c3365f6 100644 --- a/DjangoAdmin_Django_AntdVue/zh/volume1/environment.md +++ b/DjangoAdmin_Django_AntdVue/zh/volume1/environment.md @@ -1,8 +1,8 @@ # 环境准备 -本章节介绍在本地搭建项目所需的基础环境和软件安装。项目采用 `Python` + `Django` 后端、`Vue3` + `ElementPlus` 前端的分离架构，本地开发需准备以下软件。 +本章节介绍在本地搭建项目所需的基础环境和软件安装。项目采用 `Python` + `Django` 后端、`Vue3` + `Ant Design Vue` 前端的分离架构，本地开发需准备以下软件。 -安装软件：`Python(3.12+)`、`MySQL(8.0+)`、`Redis(6.0+)`、`Node.js(18+)`、`pnpm` 等。 +安装软件：`Python(3.12+)`、`MySQL(8.0+)`（或其他支持的数据库）、`Redis(6.0+)`、`Node.js(18+)`、`pnpm` 等。 :::tip 温馨提示 1. 部分软件安装后需要设置本地环境变量，便于在终端中使用命令。 @@ -192,7 +192,7 @@ OK ## 安装 Node.js -`Node.js` 是前端项目的运行环境，要求 `18` 或更高版本。前端基于 `Vue3` + `ElementPlus` 构建。 +`Node.js` 是前端项目的运行环境，要求 `18` 或更高版本。前端基于 `Vue3` + `Ant Design Vue` 构建。 + 下载 Node.js diff --git a/DjangoAdmin_Django_AntdVue/zh/volume1/faq.md b/DjangoAdmin_Django_AntdVue/zh/volume1/faq.md index 0a7efcf..d551fe1 100644 --- a/DjangoAdmin_Django_AntdVue/zh/volume1/faq.md +++ b/DjangoAdmin_Django_AntdVue/zh/volume1/faq.md @@ -378,8 +378,8 @@ python manage.py shell ```bash # .env 中的上传配置 -DJANGO_UPLOAD_DIR="E:\DjangoAdmin_V3\DjangoAdmin_Django_EleVue\public\uploads" -DJANGO_FILE_URL='http://file.django.elevue' +DJANGO_UPLOAD_DIR="E:\DjangoAdmin_Django_AntdVue\public\uploads" +DJANGO_FILE_URL='http://file.django.antdvue' ``` :::tip 温馨提示 diff --git a/DjangoAdmin_Django_AntdVue/zh/volume1/frontend.md b/DjangoAdmin_Django_AntdVue/zh/volume1/frontend.md index 3481f0e..d3c4b28 100644 --- a/DjangoAdmin_Django_AntdVue/zh/volume1/frontend.md +++ b/DjangoAdmin_Django_AntdVue/zh/volume1/frontend.md @@ -1,6 +1,6 @@ # 前端启动 -本章节介绍如何将前端项目安装依赖并启动开发服务器。前端基于 `Vue3` + `ElementPlus` + `TypeScript` + `Vite` 构建，采用组件化开发模式，支持热更新和代理配置。 +本章节介绍如何将前端项目安装依赖并启动开发服务器。前端基于 `Vue3` + `Ant Design Vue` + `TypeScript` + `Vite` 构建，采用组件化开发模式，支持热更新和代理配置。 :::tip 温馨提示 启动前端前，请确保已完成 [环境准备](/zh/volume1/environment) 章节中的 `Node.js` 和 `pnpm` 安装，并已启动后端服务（参见 [后端启动](/zh/volume1/backend)）。 diff --git a/DjangoAdmin_Django_AntdVue/zh/volume2/faq.md b/DjangoAdmin_Django_AntdVue/zh/volume2/faq.md index 1eb4a98..4c244cb 100644 --- a/DjangoAdmin_Django_AntdVue/zh/volume2/faq.md +++ b/DjangoAdmin_Django_AntdVue/zh/volume2/faq.md @@ -162,7 +162,7 @@ avatar = save_file(avatar_url, "example") ```vue -添加案例 +添加案例 ``` ### Q13: 表格数据不刷新 diff --git a/DjangoAdmin_Django_AntdVue/zh/volume2/fe-view.md b/DjangoAdmin_Django_AntdVue/zh/volume2/fe-view.md index 37d8d3a..cd3da3c 100644 --- a/DjangoAdmin_Django_AntdVue/zh/volume2/fe-view.md +++ b/DjangoAdmin_Django_AntdVue/zh/volume2/fe-view.md @@ -1,6 +1,6 @@ # 前端页面视图 -前端页面视图是用户直接交互的界面。项目使用 Vue3 + ElementPlus + Vite 构建。一个完整的 CRUD 页面由 5 个文件组成： +前端页面视图是用户直接交互的界面。项目使用 Vue3 + Ant Design Vue + Vite 构建。一个完整的 CRUD 页面由 5 个文件组成： ``` ui/src/views/tool/example/ @@ -21,30 +21,52 @@ ui/src/views/tool/example/ @@ -726,7 +731,7 @@ async function getDeptOptions() { ```vue ``` @@ -734,7 +739,7 @@ async function getDeptOptions() { :::tip v-perm 指令 除了 `Authority` 组件，项目还提供 `v-perm` 指令，功能相同但更简洁： ```vue -新增用户 +新增用户 ``` ::: @@ -742,7 +747,7 @@ async function getDeptOptions() { ## Icon 图标 -统一图标组件，支持 ElementPlus 图标和 SVG 图标。 +统一图标组件，支持 Ant Design Icons 和 SVG 图标。 ### Props @@ -756,8 +761,8 @@ async function getDeptOptions() { ```vue @@ -838,4 +843,4 @@ setupCustomComponents(app); // 注册所有自定义组件 ## 总结 -公共组件库基于 ElementPlus 二次封装，核心三件套 BasicTable（表格）、BasicForm（表单）、BasicModal（弹窗）覆盖列表页标准场景。辅以 Upload、Editor、Cropper 等业务组件，以及 Authority、v-perm 权限体系。通过全局注册，任何页面直接使用，无需单独 import。优先使用公共组件，避免重复开发。 +公共组件库基于 Ant Design Vue 二次封装，核心三件套 BasicTable（表格）、BasicForm（表单）、BasicModal（弹窗）覆盖列表页标准场景。辅以 Upload、Editor、Cropper 等业务组件，以及 Authority、v-perm 权限体系。通过全局注册，任何页面直接使用，无需单独 import。优先使用公共组件，避免重复开发。 diff --git a/DjangoAdmin_Django_AntdVue/zh/volume4/frontend/form.md b/DjangoAdmin_Django_AntdVue/zh/volume4/frontend/form.md index 3efc9f9..640d310 100644 --- a/DjangoAdmin_Django_AntdVue/zh/volume4/frontend/form.md +++ b/DjangoAdmin_Django_AntdVue/zh/volume4/frontend/form.md @@ -3,7 +3,7 @@ :::tip 说明 -`BasicForm` 位于 `src/components/Form/src/BasicForm.vue`，基于 ElementPlus 的 `el-form` 二次封装，通过 schemas 配置化定义表单字段，支持查询表单和业务表单两种模式。 +`BasicForm` 位于 `src/components/Form/src/BasicForm.vue`，基于 Ant Design Vue 的 `a-form` 二次封装，通过 schemas 配置化定义表单字段，支持查询表单和业务表单两种模式。 ::: ## 组件架构 @@ -26,9 +26,9 @@ src/components/Form/ 列表页的搜索区域使用 `useForm` 注册表单： ```vue - + - + ``` ### querySchemas 定义 @@ -40,7 +40,7 @@ import { FormSchema } from '@/components/Form/index'; export const schemas: FormSchema[] = [ { - field: 'name', + name: 'name', component: 'Input', label: '岗位名称', componentProps: { @@ -48,12 +48,13 @@ export const schemas: FormSchema[] = [ }, }, { - field: 'status', + name: 'status', component: 'Select', label: '状态', componentProps: { placeholder: '请选择状态', clearable: true, + allowClear: true, options: [ { label: '正常', value: '1' }, { label: '禁用', value: '2' }, @@ -68,15 +69,19 @@ export const schemas: FormSchema[] = [ ```typescript import { schemas } from './querySchemas'; import { useForm } from '@/components/Form/index'; -import { ColProps } from 'element-plus'; const formParams = reactive({ name: '', status: '' }); const [register, {}] = useForm({ - labelWidth: 80, - layout: 'horizontal', - colProps: { span: 6 } as ColProps, - submitOnReset: true, + rowProps: { gutter: [16, 0] }, + colProps: { + xs: 24, + sm: 24, + md: 12, + lg: 8, + xl: 6, + }, + labelCol: { span: 6, offset: 0 }, schemas, }); @@ -95,73 +100,73 @@ function handleReset() { ## 业务表单（编辑弹窗） -编辑弹窗中直接使用 `el-form` + `el-form-item` 构建表单： +编辑弹窗中直接使用 `a-form` + `a-form-item` 构建表单： ```vue ``` ## BasicForm 内部渲染机制 -`BasicForm.vue` 根据 `schema.component` 动态渲染对应的 ElementPlus 组件： +`BasicForm.vue` 根据 `schema.component` 动态渲染对应的 Ant Design Vue 组件： ```vue -