优化更新

2026-09-13 18:12:07 +08:00
parent 7f758cc6e9
commit d7a081e8b7
92 changed files with 2429 additions and 1117 deletions
@@ -17,7 +17,7 @@

 ```sql
 -- 创建数据库（UTF-8 编码）
-CREATE DATABASE `djangoadmin.django.elevue`
+CREATE DATABASE `djangoadmin.django.naivevue`
  DEFAULT CHARACTER SET utf8mb4
  COLLATE utf8mb4_general_ci;

@@ -26,7 +26,7 @@ SHOW DATABASES;
 ```

 :::tip 温馨提示
-数据库名称需要与 `.env` 文件中的 `DATABASE_NAME` 配置一致，默认为 `djangoadmin.django.elevue`。
+数据库名称需要与 `.env` 文件中的 `DATABASE_NAME` 配置一致，默认为 `djangoadmin.django.naivevue`。
 :::

 ## 第二步：配置数据库连接
@@ -38,7 +38,7 @@ SHOW DATABASES;
 # 数据库配置
 # ============================================================
 DATABASE_ENGINE="django.db.backends.mysql"   # 数据库引擎
-DATABASE_NAME='djangoadmin.django.elevue'    # 数据库名称
+DATABASE_NAME='djangoadmin.django.naivevue'    # 数据库名称
 DATABASE_HOST="127.0.0.1"                   # 数据库地址
 DATABASE_PORT=3306                           # 数据库端口
 DATABASE_USER="root"                         # 数据库用户名
@@ -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：
@@ -105,7 +105,7 @@ python manage.py migrate application.user 0001

 ```bash
 # 使用 mysql 命令行导入
-mysql -uroot -p djangoadmin.django.elevue < document/mysql/djangoadmin.django.elevue.sql
+mysql -uroot -p djangoadmin.django.naivevue < document/mysql/djangoadmin.django.naivevue.sql

 # 或使用 Navicat 等工具：右键数据库 → 运行 SQL 文件
 ```
@@ -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 等工具查看表结构时理解每个字段的含义。
-:::
-
-## 第六步：验证
+## 第五步：验证

 启动后端服务，验证数据库连接是否正常：

@@ -236,20 +223,20 @@ python generator.py --config config.json

 ```bash
 # 备份数据库
-mysqldump -uroot -p djangoadmin.django.elevue > backup.sql
+mysqldump -uroot -p djangoadmin.django.naivevue > backup.sql

 # 恢复数据库
-mysql -uroot -p djangoadmin.django.elevue < backup.sql
+mysql -uroot -p djangoadmin.django.naivevue < backup.sql
 ```

 + PostgreSQL 备份

 ```bash
 # 备份数据库
-pg_dump -U postgres djangoadmin.django.elevue > backup.sql
+pg_dump -U postgres djangoadmin.django.naivevue > backup.sql

 # 恢复数据库
-psql -U postgres djangoadmin.django.elevue < backup.sql
+psql -U postgres djangoadmin.django.naivevue < backup.sql
 ```

 + SQLite 备份
@@ -267,11 +254,10 @@ cp db_backup.sqlite3 db.sqlite3
 数据库初始化的核心步骤：

 ```
-1. 创建数据库：CREATE DATABASE `djangoadmin.django.elevue`
+1. 创建数据库：CREATE DATABASE `djangoadmin.django.naivevue`
 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
+4. 导入初始数据：mysql ... < document/mysql/djangoadmin.django.naivevue.sql
 ```

 后续的模型变更通过 Django 迁移系统管理（`makemigrations` + `migrate`），确保数据库结构与代码保持同步。如需使用代码生成器创建新模块，生成器会自动处理数据库迁移。