优化更新

This commit is contained in:
2026-09-13 23:01:19 +08:00
parent 0c67b3e8b5
commit 23bd737b82
88 changed files with 2214 additions and 2503 deletions
@@ -105,14 +105,15 @@ def get_tree(data, parent_id):
## 前端使用
分类选择通常使用 el-tree 或 el-cascader 组件:
分类选择通常使用 n-tree-select 或 n-cascader 组件:
```vue
<!-- 树形选择 -->
<el-tree-select
v-model="form.category_id"
:data="categoryTree"
:props="{ label: 'name', value: 'id' }"
<n-tree-select
v-model:value="form.category_id"
:options="categoryTree"
label-field="name"
key-field="id"
/>
```
@@ -125,6 +126,6 @@ def get_tree(data, parent_id):
2. 通用设计:适用于文章分类、产品分类等场景
3. 分类编码:category_code 字段支持程序化标识
4. 排序控制:sort 字段控制分类显示顺序
5. 前端集成:el-tree-select 或 el-cascader 组件
5. 前端集成:n-tree-select 或 n-cascader 组件
6. 继承 BaseService:声明 repository/form/model_name 即可获得完整 CRUD 能力
```
@@ -173,12 +173,13 @@ class RoleService(BaseService):
角色管理页面通常包含菜单树组件,用于勾选分配权限:
```vue
<el-tree
<n-tree
ref="menuTree"
:data="menuTreeData"
show-checkbox
node-key="id"
checkable
:default-checked-keys="checkedMenuIds"
key-field="id"
selectable
/>
```
@@ -1,5 +1,5 @@
:::tip 用户管理
用户管理是系统的核心模块,属于复杂业务模块。包含用户 CRUD、角色关联、密码加密、行政区划、Excel 导入导出等功能。与简单 CRUD 模块不同,用户管理使用自定义 service 函数而非继承 BaseService 的类方法。
用户管理是系统的核心模块,属于复杂业务模块。包含用户 CRUD、角色关联、密码加密、行政区划、Excel 导入导出等功能。用户管理继承 `BaseService` 获得标准 CRUD 能力,并通过覆写钩子方法实现头像保存、密码加密、角色关联等定制逻辑。
:::
## 模块结构
@@ -237,7 +237,7 @@ def _enrich_user_records(records):
role_map = user_role.get_user_roles_batch(user_ids)
for data in records:
data["genderName"] = gender_map.get(str(data.get("gender")))
data["genderText"] = gender_map.get(str(data.get("gender")))
data["deptName"] = dept_map.get(data.get("deptId"))
data["levelName"] = level_map.get(data.get("levelId"))
data["positionName"] = position_map.get(data.get("positionId"))