签入版本
This commit is contained in:
@@ -1,5 +1,9 @@
|
||||
# 完整代码清单
|
||||
|
||||
:::tip 概述
|
||||
本页汇总案例管理（Example）模块涉及的全部文件代码，开发时可快速查阅与复制对照。
|
||||
:::
|
||||
|
||||
本章汇总 Example 案例模块涉及的全部文件，便于开发时快速查阅和复制。
|
||||
|
||||
## 后端文件清单
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# 常见问题与排错
|
||||
|
||||
:::tip 概述
|
||||
本页汇总模块开发过程中的常见问题与排错方法，开发受阻时按症状索引即可定位。
|
||||
:::
|
||||
|
||||
本章汇总模块开发过程中的常见问题和解决方案。
|
||||
|
||||
## 后端问题
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# 前端 API 层
|
||||
|
||||
:::tip 概述
|
||||
前端 API 层封装后端接口的 HTTP 请求，每个业务模块对应一个 API 文件，本页讲解基于 Axios 封装的编写规范。
|
||||
:::
|
||||
|
||||
前端 API 层负责封装后端接口的 HTTP 请求。每个业务模块对应一个 API 文件，使用项目封装的 Axios 工具发送请求。
|
||||
|
||||
## 文件位置
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# 前端路由与菜单
|
||||
|
||||
:::tip 概述
|
||||
本页讲解前端路由与菜单机制——路由和菜单由后端动态返回，前端只需注册路由组件映射。
|
||||
:::
|
||||
|
||||
前端路由定义页面的访问路径，菜单是路由的可视化展示。项目的路由和菜单由后端动态返回，前端只需注册路由组件映射。
|
||||
|
||||
## 动态路由机制
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# 前端页面视图
|
||||
|
||||
:::tip 概述
|
||||
前端页面视图是用户直接交互的界面，本页讲解 Vue3 + ElementPlus 下一个完整 CRUD 页面的文件组成与编写方式。
|
||||
:::
|
||||
|
||||
前端页面视图是用户直接交互的界面。项目使用 Vue3 + ElementPlus + Vite 构建。一个完整的 CRUD 页面由 5 个文件组成：
|
||||
|
||||
```
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# 表单验证（Form）
|
||||
|
||||
:::tip 概述
|
||||
表单验证是模块开发的第二步，讲解基于 Django ModelForm 的提交数据校验与错误信息约定。
|
||||
:::
|
||||
|
||||
表单验证是模块开发的第二步，用于对前端提交的数据进行验证。项目使用 Django 的 `ModelForm` 实现表单验证，所有错误信息使用中文提示。
|
||||
|
||||
## 文件位置
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# 数据模型（Model）
|
||||
|
||||
:::tip 概述
|
||||
数据模型是模块开发的第一步，讲解如何用 Django ORM 与 BaseModel 定义数据库表结构，新建模块时从本页开始。
|
||||
:::
|
||||
|
||||
数据模型是模块开发的第一步，用于定义数据库表结构。项目使用 Django ORM，模型类通过继承 `BaseModel` 自动获得通用字段。
|
||||
|
||||
## 文件位置
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# 模块开发实战概述
|
||||
|
||||
:::tip 概述
|
||||
本章以案例管理（Example）模块为完整案例，手把手演示从零开发一个业务模块的全流程，学完即可掌握项目中任意模块的开发方式。
|
||||
:::
|
||||
|
||||
本章以「案例管理（Example）」模块为完整案例，手把手演示从零开发一个业务模块的全流程。学完本章后，你将掌握项目中任意模块的开发方式。
|
||||
|
||||
## 你将学到什么
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# 权限节点配置
|
||||
|
||||
:::tip 概述
|
||||
本页讲解接口权限字符串的定义与菜单权限节点的配置方法，联调 403 问题时对照本页。
|
||||
:::
|
||||
|
||||
后端代码中的 `permission_required = ("sys:example:page",)` 定义了接口所需的权限字符串，但权限节点本身需要在数据库中配置，才能在「菜单管理」中分配给角色。
|
||||
|
||||
## 权限字符串格式
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# 业务逻辑层（Service）
|
||||
|
||||
:::tip 概述
|
||||
业务逻辑层是模块开发的核心，CRUD 操作、业务规则与数据处理均封装在 Service 层函数，本页讲解其编写规范。
|
||||
:::
|
||||
|
||||
业务逻辑层是模块开发的第三步，也是最核心的部分。所有 CRUD 操作、业务规则、数据处理都封装在 Service 层的独立函数中。
|
||||
|
||||
## 文件位置
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# URL 路由配置
|
||||
|
||||
:::tip 概述
|
||||
URL 路由是模块开发的最后一步，本页讲解用 Django path() 将路径映射到视图类的配置方法。
|
||||
:::
|
||||
|
||||
URL 路由是模块开发的最后一步，负责将 URL 路径映射到视图类。项目使用 Django 的 `path()` 函数定义路由，通过 `include()` 将模块路由注册到主路由。
|
||||
|
||||
## 文件位置
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# 视图层（View）
|
||||
|
||||
:::tip 概述
|
||||
视图层负责处理 HTTP 请求并调用 Service 业务逻辑，本页讲解 Django 类视图的编写方式与响应约定。
|
||||
:::
|
||||
|
||||
视图层是模块开发的第四步，负责处理 HTTP 请求并调用 Service 层的业务逻辑。项目使用 Django 的类视图（Class-Based Views），每个视图类对应一个 API 端点。
|
||||
|
||||
## 文件位置
|
||||
|
||||
Reference in New Issue
Block a user