优化更新

DjangoAdmin_Flask_NaiveVue/zh/volume1/backend.md

@@ -37,16 +37,16 @@ cd djangoadmin
 │ ├── core/            # 核心模块（数据库、缓存、认证、响应等）
 │ ├── routes/          # 路由层（HTTP 接口定义）
 │ ├── modules/         # 业务模块（模型、仓库、服务）
-│ ├── middleware/      # 中间件（CORS、限流、日志、操作记录等）
-│ ├── common/          # 公共模块（基类、常量、工具函数等）
-│ └── utils/           # 工具函数
+│ ├── middleware/      # 中间件（认证、事务、日志、操作记录等）
+│ └── common/          # 公共模块（基类、常量、工具函数等）
 ├── ui/                # 前端源码（独立仓库或子目录）
+├── config/            # 配置文件（base / database / redis / auth）
+├── docker/            # Docker 部署配置（Dockerfile / docker-compose.yml）
 ├── scripts/           # 脚本工具（数据库初始化、数据迁移等）
 ├── migrations/        # Flask-Migrate 数据库迁移文件
 ├── tests/             # 测试代码
 ├── .env.example       # 环境变量示例文件
 ├── requirements.txt   # Python 依赖清单
-├── docker-compose.yml # Docker 编排文件
 └── Makefile           # 常用命令集合
 ```
 
@@ -72,7 +72,7 @@ pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
 ```bash
 # 检查 Flask 是否安装成功
 python -c "import flask; print(flask.__version__)"
-3.1.1
+3.1.3
 
 # 检查 SQLAlchemy 是否安装成功
 python -c "import sqlalchemy; print(sqlalchemy.__version__)"
@@ -101,7 +101,7 @@ copy .env.example .env # Windows CMD
 # ============================================================
 # 基础配置
 # ============================================================
-FLASK_NAME=DjangoAdmin Flask+EleVue旗舰版
+FLASK_NAME=DjangoAdmin Flask+NaiveUI版
 FLASK_VERSION=v3.0.0
 FLASK_HOST=0.0.0.0
 FLASK_PORT=8021
@@ -114,7 +114,7 @@ FLASK_DEBUG=True
 DB_DRIVER=mysql
 DB_HOST=127.0.0.1
 DB_PORT=3306
-DB_DATABASE=djangoadmin.flask.elevue
+DB_DATABASE=djangoadmin.flask.naivevue
 DB_USERNAME=root
 DB_PASSWORD=your_mysql_password # 修改为真实密码
 DB_PREFIX=flask_
@@ -155,10 +155,10 @@ python -c "import secrets; print(secrets.token_urlsafe(48))"
 ```bash
 # 1. 登录 MySQL，创建数据库
 mysql -uroot -p
-CREATE DATABASE `djangoadmin.flask.elevue` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
+CREATE DATABASE `djangoadmin.flask.naivevue` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
 
 # 2. 导入数据库脚本（脚本位于 document/mysql/ 目录下）
-mysql -uroot -p djangoadmin.flask.elevue < document/mysql/djangoadmin.flask.elevue.sql
+mysql -uroot -p djangoadmin.flask.naivevue < document/mysql/djangoadmin.flask.naivevue.sql
 ```
 
 :::tip 温馨提示
@@ -265,14 +265,20 @@ curl http://127.0.0.1:8021/api/v1/captcha
 
 | 命令 | 对应命令 | 说明 |
 |:----|:----|:----|
-| `make install` | `pip install -r requirements.txt` | 安装运行时 + 开发依赖 |
+| `make install` | `pip install -r requirements.txt` | 安装生产依赖 |
+| `make install-dev` | `pip install -r requirements-dev.txt` | 安装开发依赖（含测试/规范工具） |
 | `make dev` | `python app.py` | 启动开发服务 |
-| `make test` | `pytest` | 运行全部测试（默认跳过 integration） |
-| `make test-contract` | `pytest tests/contract` | 运行契约快照测试 |
-| `make test-unit` | `pytest tests/unit` | 运行单元测试 |
-| `make test-integration` | `pytest tests/integration` | 运行集成测试（需真实 MySQL/Redis） |
-| `make db-init` | `python scripts/setup_db.py` | 初始化数据库 |
-| `make seed-dict` | `python scripts/seed_dict.py` | 初始化业务字典数据 |
+| `make lint` | `flake8 + black --check + isort --check-only` | 静态检查 |
+| `make format` | `black + isort` | 自动格式化 |
+| `make type-check` | `mypy src` | 类型检查 |
+| `make test` | `pytest` | 运行全部测试 |
+| `make test-cov` | `pytest --cov=src` | 带覆盖率运行测试 |
+| `make db-migrate` | `flask db migrate` | 生成迁移脚本 |
+| `make db-upgrade` | `flask db upgrade` | 应用迁移到最新 |
+| `make db-downgrade` | `flask db downgrade` | 回滚一次迁移 |
+| `make docker-up` | `cd docker && docker-compose up -d` | 启动 Docker 服务 |
+| `make docker-down` | `cd docker && docker-compose down` | 停止 Docker 服务 |
+| `make clean` | 清理 `__pycache__` / `.pyc` / `.pytest_cache` | 清理缓存与临时文件 |
 
 ## 常见问题