签入版本

DjangoAdmin_Tornado_NaiveVue/zh/volume2/code-list.md

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

DjangoAdmin_Tornado_NaiveVue/zh/volume2/faq.md

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

DjangoAdmin_Tornado_NaiveVue/zh/volume2/fe-api.md

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

DjangoAdmin_Tornado_NaiveVue/zh/volume2/fe-router.md

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

DjangoAdmin_Tornado_NaiveVue/zh/volume2/fe-view.md

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

DjangoAdmin_Tornado_NaiveVue/zh/volume2/handler.md

@@ -1,5 +1,9 @@
 # 请求处理器（Handler）
 
+:::tip 概述
+Handler 层是 HTTP 接口层，负责接收请求、校验权限与记录操作日志，编写新接口从本页开始。
+:::
+
 Handler 层是 HTTP 接口层，负责接收请求、校验权限、记录操作日志，然后委托给 Service 层处理。每个业务模块对应一个 `handlers.py` 文件，所有 Handler 继承 `BaseHandler`。
 
 ## 文件位置

DjangoAdmin_Tornado_NaiveVue/zh/volume2/repository.md

@@ -1,5 +1,9 @@
 # Repository 层
 
+:::tip 概述
+Repository 层是数据访问层，封装全部数据库查询操作，本页讲解基于 BaseRepository 基类的通用 CRUD 用法。
+:::
+
 Repository 层是数据访问层，封装所有数据库查询操作。项目通过 `BaseRepository` 基类提供通用 CRUD 能力，子类通常只需声明类名，无需编写任何代码。
 
 ## 文件位置

DjangoAdmin_Tornado_NaiveVue/zh/volume2/schema.md

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