签入版本

2026-10-27 16:15:53 +08:00
parent 06a855c0f4
commit de8edd1b3c
129 changed files with 141 additions and 141 deletions
@@ -1,6 +1,6 @@
 # 数据库与 ORM

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 项目使用 Django ORM 作为数据库访问层，数据库连接配置位于 `config/env.py` 和 `application/settings.py`。默认使用 MySQL 数据库，通过 `django.db.backends.mysql` 引擎连接。
@@ -1,6 +1,6 @@
 # 导入导出

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 基于 `openpyxl` 实现 Excel 导入导出功能，支持通过 `file_template` 模块管理导入模板配置。
@@ -1,6 +1,6 @@
 # IP/UA 解析

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 提供客户端 IP 获取、IP 地理位置查询和 User-Agent 解析三大能力，位于 `utils/common.py`。三者组合使用，为登录日志、操作日志等场景提供客户端身份信息。
@@ -1,6 +1,6 @@
 # 日志系统

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 通过 Python 标准库 `logging` 实现结构化日志，Django 框架内置日志配置，支持控制台 + 文件双输出。各模块通过 `logging.getLogger(__name__)` 获取 logger 实例。
@@ -1,6 +1,6 @@
 # 密码工具

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 密码加密使用 Django 内置的 `make_password` 和 `check_password` 函数，基于 PBKDF2 算法（默认工作因子 320000 次迭代）。用户安全信息获取工具位于 `utils/security.py`。
@@ -1,6 +1,6 @@
 # 权限缓存

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 通过 Redis 实现用户权限和菜单的缓存，采用用户级缓存 + 全局版本号双层策略。权限查询函数位于 `application/menu/services.py`，供 `PermissionRequired` 中间件调用。
@@ -1,6 +1,6 @@
 # 请求解析工具

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 `utils/common.py` 提供请求数据解析相关的工具函数，核心函数 `parse_request_body()` 用于解析请求体 JSON 数据。这些工具函数在各业务模块中广泛使用。
@@ -1,6 +1,6 @@
 # 富文本过滤

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 富文本编辑器内容存在存储型 XSS 风险，通过 `save_content()` 函数实现 HTML 内容处理，在落盘前统一过滤危险内容并迁移嵌入图片。源码位于 `utils/common.py`，涉及富文本的模块（文章、通知公告等）均调用 `save_content()` 处理。
@@ -1,6 +1,6 @@
 # 文件上传完整流程

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 本章从配置到使用，完整说明文件上传功能的实现方式，包括后端接口、前端组件、安全机制和最佳实践。

@@ -1,6 +1,6 @@
 # 文件上传

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 提供本地文件上传功能，支持图片和通用文件上传，内置扩展名白名单校验。服务层位于 `application/upload/services.py`，视图层位于 `application/upload/views.py`。