优化更新

2026-09-13 17:33:13 +08:00
parent 8be23a62a3
commit 7f758cc6e9
97 changed files with 2333 additions and 3595 deletions
@@ -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 脚本导入。脚本位于项目对应目录中：

@@ -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`），确保数据库结构与代码保持同步。如需使用代码生成器创建新模块，生成器会自动处理数据库迁移。
@@ -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'

 # ============================================================
 # 数据库配置
@@ -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

@@ -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 温馨提示
@@ -1,6 +1,6 @@
 # 前端启动

-本章节介绍如何将前端项目安装依赖并启动开发服务器。前端基于 `Vue3` + `ElementPlus` + `TypeScript` + `Vite` 构建，采用组件化开发模式，支持热更新和代理配置。
+本章节介绍如何将前端项目安装依赖并启动开发服务器。前端基于 `Vue3` + `Ant Design Vue` + `TypeScript` + `Vite` 构建，采用组件化开发模式，支持热更新和代理配置。

 :::tip 温馨提示
 启动前端前，请确保已完成 [环境准备](/zh/volume1/environment) 章节中的 `Node.js` 和 `pnpm` 安装，并已启动后端服务（参见 [后端启动](/zh/volume1/backend)）。