签入版本

2026-10-25 22:36:33 +08:00
parent 40ebd01770
commit e1ff172d27
501 changed files with 8295 additions and 65 deletions
@@ -1,5 +1,9 @@
 # 第四章 架构设计 - 核心基类体系

+:::tip 概述
+本页汇总项目核心基类体系的总览与用法，编写业务代码前先了解可复用的基座能力。
+:::
+
 ## 4.1 基类总览

 核心基类体系由四大基类组成，覆盖从数据模型到请求校验再到响应输出的完整链路。子类只需声明差异点，即可获得标准化的增删改查能力。
@@ -1,5 +1,9 @@
 # 第四章 架构设计 - 缓存架构

+:::tip 概述
+本页说明系统缓存架构的设计与使用方式，涉及缓存一致性或性能问题时查阅。
+:::
+
 ## 4.1 缓存架构概述

 项目使用 Redis 作为缓存后端，通过 Django 的缓存框架实现统一的缓存管理。缓存主要用于以下场景：
@@ -1,5 +1,9 @@
 # 第四章 架构设计 - 数据库设计

+:::tip 概述
+本页说明数据库设计原则与表结构组织方式，建表或数据迁移时对照本页。
+:::
+
 ## 4.1 数据库设计概述

 项目使用 MySQL 8.0 作为主数据库，通过 Django ORM 进行数据访问。所有业务表继承 BaseModel 抽象基类，自动获得 6 个通用字段。
@@ -1,5 +1,9 @@
 # 第四章 架构设计 - 目录结构设计

+:::tip 概述
+本页说明项目根目录与各层目录的组织设计，二次开发定位文件时对照查阅。
+:::
+
 ## 4.1 项目根目录

 ```
@@ -1,5 +1,9 @@
 # 第四章 架构设计 - 扩展性设计

+:::tip 概述
+本页说明系统的扩展性设计原则，二次开发新增能力或改造现有模块时参考。
+:::
+
 ## 4.1 扩展性设计原则

 项目遵循开闭原则（OCP）：对扩展开放，对修改关闭。新功能通过添加新模块实现，而非修改现有代码。系统通过 Django App 机制、代码生成器、模板定制等方式提供扩展能力。
@@ -1,5 +1,9 @@
 # 第四章 架构设计 - 分层架构详解

+:::tip 概述
+本页详解后端分层架构的职责划分与调用关系，编写代码前先理解各层边界。
+:::
+
 ## 4.1 分层架构概述

 项目采用经典的五层架构设计，各层职责明确，依赖关系清晰：
@@ -1,5 +1,9 @@
 # 第四章 架构设计 - 系统架构总览

+:::tip 概述
+本页给出系统整体架构总览，理解各层职责与模块关系时从本页开始。
+:::
+
 ## 4.1 整体架构

 项目采用前后端分离的 B/S 架构，后端基于 Django 6.0.3 提供 RESTful API，前端基于 Vue3 + NaiveUI 构建单页应用。系统通过 Nginx 反向代理统一入口，实现静态资源托管与 API 转发。
@@ -1,5 +1,9 @@
 # 第四章 架构设计 - 请求处理流程

+:::tip 概述
+本页给出请求从进入路由到返回响应的全链路处理流程，排查接口问题时对照追踪。
+:::
+
 ## 4.1 请求处理全链路

 一个完整的 HTTP 请求在 系统中的处理流程如下：
@@ -1,5 +1,9 @@
 # 第四章 架构设计 - 安全架构

+:::tip 概述
+本页说明系统安全架构设计，含认证、权限与数据安全等防护机制。
+:::
+
 ## 4.1 安全架构概述

 系统从认证、授权、防护三个维度构建安全体系：
@@ -1,5 +1,9 @@
 # 第四章 架构设计 - 技术栈选型

+:::tip 概述
+本页列出项目后端与前端完整技术选型及版本要求，评估兼容性或升级影响时对照本表。
+:::
+
 ## 4.1 后端技术栈

 ### Django 6.0.3