签入版本

2026-10-25 22:36:33 +08:00
parent 40ebd01770
commit e1ff172d27
501 changed files with 8295 additions and 65 deletions
@@ -1,3 +1,5 @@
+# 文章管理
+
 :::tip 文章管理
 文章管理模块支持富文本编辑、分类关联、封面图片上传、图集管理等功能。适用于新闻、公告、帮助文档等内容管理场景。本模块是典型的「带文件处理」业务模块，涵盖了封面迁移、图集处理、富文本 XSS 清洗等核心机制。
 :::
@@ -1,3 +1,5 @@
+# 分类管理
+
 :::tip 分类管理
 分类管理模块用于管理树形分类数据，如文章分类、产品分类等。通过 `parent_id` 字段实现无限级分类。
 :::
@@ -1,3 +1,5 @@
+# 行政区划管理
+
 :::tip 行政区划
 行政区划模块管理全国省/市/区/街道四级区域数据，支持树形结构查询、级联选择器、拼音自动生成等功能。用户表通过 `province_code`/`city_code`/`district_code`/`street_code` 四个字段关联城市表的 `area_code`。
 :::
@@ -1,3 +1,5 @@
+# 公告与链接管理
+
 :::tip 公告/链接/城市
 公告、链接、城市是三个简单 CRUD 内容模块，均继承 BaseService，提供标准的增删改查接口。适用于系统公告、友情链接、城市数据等场景。
 :::
@@ -1,3 +1,5 @@
+# 部门/职级/岗位管理
+
 :::tip 部门/职级/岗位
 部门、职级、岗位是组织架构管理的三个核心模块。部门采用树形结构，职级和岗位为简单 CRUD 模块，均继承 `BaseService`。用户表通过 `dept_id`、`position_id`、`level_id` 三个外键关联这三个模块。
 :::
@@ -1,3 +1,5 @@
+# 案例演示
+
 :::tip 案例演示
 案例演示模块是代码生成器的参考模板，展示了标准 CRUD 模块的完整实现。包含文件字段处理、枚举字典映射、状态管理等功能，可作为新模块开发的参考范例。
 :::
@@ -1,3 +1,5 @@
+# 文件模板管理
+
 :::tip 文件模板
 文件模板模块用于管理系统中的文件模板，如导入导出模板、报表模板等。支持模板文件上传、按编码查询、文件 URL 自动转换等功能。
 :::
@@ -1,3 +1,5 @@
+# 定时任务
+
 :::tip 定时任务
 定时任务模块基于 APScheduler 实现，支持 Cron 表达式调度、任务执行日志、动态启停等功能。包含 job（任务定义）、job_log（执行日志）、scheduler（调度器）三个子模块。
 :::
@@ -1,3 +1,5 @@
+# 菜单管理
+
 :::tip 菜单管理
 菜单管理是 RBAC 权限系统的基础，负责管理系统的导航菜单和权限节点。支持目录/菜单（type=0）和权限按钮节点（type=1）两种类型，通过树形结构组织。权限节点由系统根据前端勾选自动生成，采用 `sys:module:action` 三段式命名。
 :::
@@ -1,3 +1,5 @@
+# 参数管理
+
 :::tip 参数管理
 参数管理模块用于管理系统配置和业务配置，每个参数包含名称、编码、值、类型、排序、状态等属性。本模块是典型的「BaseService 简单模块」，通过声明差异点即可获得完整 CRUD 能力。
 :::
@@ -1,3 +1,5 @@
+# 角色管理
+
 :::tip 角色管理
 角色是 RBAC 权限模型的核心，连接用户和菜单（权限）。通过为角色分配菜单权限，再将角色分配给用户，实现灵活的权限管理。角色删除时需清理关联的用户角色和角色菜单数据，并即时失效受影响用户的权限缓存。
 :::
@@ -1,3 +1,5 @@
+# 用户管理
+
 :::tip 用户管理
 用户管理是系统的核心模块，属于复杂业务模块。包含用户 CRUD、角色关联、密码加密、行政区划、Excel 导入导出等功能。用户管理继承 `BaseService` 获得标准 CRUD 能力，并通过覆写钩子方法实现头像保存、密码加密、角色关联等定制逻辑。
 :::