签入版本

DjangoAdmin_Flask_EleVue/zh/volume2/blueprint.md

@@ -1,5 +1,9 @@
 # 路由注册（Flask Blueprint）
 
+:::tip 概述
+路由注册基于 Flask Blueprint 机制实现模块化挂载，本页讲解 Blueprint 的定义与在路由中心统一注册的方法。
+:::
+
 Flask 使用 `Blueprint` 机制实现模块化路由注册。每个业务模块定义自己的 Blueprint，然后在路由注册中心统一挂载到应用。
 
 ## Blueprint 概念

DjangoAdmin_Flask_EleVue/zh/volume2/code-list.md

@@ -1,5 +1,9 @@
 # 完整代码清单
 
+:::tip 概述
+本页汇总岗位管理（Position）模块涉及的全部文件代码，开发时可快速查阅与复制对照。
+:::
+
 本章汇总 Position 岗位模块涉及的全部文件，便于开发时快速查阅和复制。
 
 ## 后端文件清单

DjangoAdmin_Flask_EleVue/zh/volume2/endpoint.md

@@ -1,5 +1,9 @@
 # Router 层（Flask Blueprint）
 
+:::tip 概述
+Router 层是 HTTP 接口层，负责定义路由、权限装饰器与请求参数解析，编写新接口从本页开始。
+:::
+
 Router 层是 HTTP 接口层，负责定义路由、权限装饰器和请求参数解析。每个业务模块对应一个 router 文件，所有业务逻辑委托给 Service 层处理。
 
 ## 文件位置

DjangoAdmin_Flask_EleVue/zh/volume2/faq.md

@@ -1,5 +1,9 @@
 # 常见问题与排错
 
+:::tip 概述
+本页汇总模块开发过程中的常见问题与排错方法，开发受阻时按症状索引即可定位。
+:::
+
 本章汇总模块开发过程中的常见问题和解决方案。
 
 ## 后端问题

DjangoAdmin_Flask_EleVue/zh/volume2/fe-api.md

@@ -1,5 +1,9 @@
 # 前端 API 层
 
+:::tip 概述
+前端 API 层封装后端接口的 HTTP 请求，每个业务模块对应一个 API 文件，本页讲解基于 Axios 封装的编写规范。
+:::
+
 前端 API 层负责封装后端接口的 HTTP 请求。每个业务模块对应一个 API 文件，使用项目封装的 Axios 工具发送请求。
 
 ## 文件位置

DjangoAdmin_Flask_EleVue/zh/volume2/fe-router.md

@@ -1,5 +1,9 @@
 # 前端路由与菜单
 
+:::tip 概述
+本页讲解前端路由与菜单机制——路由和菜单由后端动态返回，前端只需注册路由组件映射。
+:::
+
 前端路由定义页面的访问路径，菜单是路由的可视化展示。项目的路由和菜单由后端动态返回，前端只需注册路由组件映射。
 
 ## 路由配置

DjangoAdmin_Flask_EleVue/zh/volume2/fe-view.md

@@ -1,5 +1,9 @@
 # 前端页面视图
 
+:::tip 概述
+前端页面视图是用户直接交互的界面，本页讲解 Vue3 + ElementPlus 下一个完整 CRUD 页面的文件组成与编写方式。
+:::
+
 前端页面视图是用户直接交互的界面。项目使用 Vue3 + ElementPlus + Vite 构建。一个完整的 CRUD 页面由 4 个文件组成：
 
 ```

DjangoAdmin_Flask_EleVue/zh/volume2/model.md

@@ -1,5 +1,9 @@
 # 数据模型（Model）
 
+:::tip 概述
+数据模型是模块开发的第一步，讲解如何用 SQLAlchemy ORM 与基类定义数据库表结构，新建模块时从本页开始。
+:::
+
 数据模型是模块开发的第一步，用于定义数据库表结构。项目使用 `SQLAlchemy ORM`，模型类通过继承基类自动获得通用字段和方法。
 
 ## 文件位置

DjangoAdmin_Flask_EleVue/zh/volume2/repository.md

@@ -1,5 +1,9 @@
 # Repository 层
 
+:::tip 概述
+Repository 层是数据访问层，封装全部数据库查询操作，本页讲解基于 BaseRepository 基类的通用 CRUD 用法。
+:::
+
 Repository 层是数据访问层，封装所有数据库查询操作。项目通过 `BaseRepository` 基类提供通用 CRUD 能力，子类只需声明 `model` 并按需实现 `page()` 和 `list_enabled()` 方法。
 
 ## 文件位置

DjangoAdmin_Flask_EleVue/zh/volume2/router.md

@@ -1,5 +1,9 @@
 # 路由注册
 
+:::tip 概述
+路由注册是将模块 Blueprint 挂载到应用的过程，本页讲解在路由注册中心统一挂载的方法。
+:::
+
 路由注册是将模块的 Blueprint 挂载到应用的过程。所有模块的路由在 `src/routes/v1.py` 中统一注册。
 
 ## 文件位置

DjangoAdmin_Flask_EleVue/zh/volume2/schema.md

@@ -1,5 +1,9 @@
 # WTForms Schema
 
+:::tip 概述
+Schema 层负责请求数据校验，本页讲解基于 WTForms 表单类与 validators 的校验规范。
+:::
+
 Schema 层负责请求数据的校验。项目使用 `WTForms` 定义表单类，通过 `validators` 约束字段格式，框架在接收请求体时自动执行校验。
 
 ## 文件位置

DjangoAdmin_Flask_EleVue/zh/volume2/service.md

@@ -1,5 +1,9 @@
 # Service 层
 
+:::tip 概述
+Service 层是业务逻辑层，本页讲解基于 BaseService 基类声明差异点即可获得完整增删改查能力的编写方式。
+:::
+
 Service 层是业务逻辑层，负责实现具体的业务规则。简单 CRUD 模块继承 `BaseService` 基类，只需声明差异点即可获得完整的增删改查能力。
 
 ## 文件位置