44 lines
1.9 KiB
Markdown
44 lines
1.9 KiB
Markdown
# 6.4 部门管理
|
||
|
||
:::tip 概述
|
||
部门模块（goframe_dept，租户级表）管理组织架构：树形结构、删除有子级/用户守卫、租户内名称唯一。部门是数据权限（本部门及以下/本部门）的组织基础。
|
||
:::
|
||
|
||
## 接口清单
|
||
|
||
```text
|
||
七件套：sys:dept:{page|list|detail|add|update|delete|batchDelete}
|
||
List 返回树形（IsTree + ParentOf）
|
||
```
|
||
|
||
## 模块特征
|
||
|
||
| 特征 | 实现 |
|
||
|------|------|
|
||
| 树形 | IsTree + ParentOf，List 自动建树 |
|
||
| 删除守卫 | 存在子部门拒绝（1011）；存在用户引用拒绝（1014 语义） |
|
||
| 唯一性 | 租户内部门名唯一（uk_tenant_name） |
|
||
| 数据权限 | dept_id 是 data_scope 档 2/3 的过滤维度 |
|
||
| 子树查询 | data_scope.go deptSubtreeIds：拉全租户部门行后 BFS |
|
||
|
||
## 与其他模块的关系
|
||
|
||
```text
|
||
user.dept_id → dept.id 用户归属部门（用户表单部门选择）
|
||
data_scope 档 2/3 按部门维度过滤可见数据（见 5.9 数据权限）
|
||
deptSubtreeIds(deptId) 档 2 "本部门及以下"的子孙部门集合计算
|
||
（每次全量拉部门表 BFS，树小无缓存；
|
||
部门表数百行内无感知，上万行需加短时缓存）
|
||
```
|
||
|
||
## 唯一性说明
|
||
|
||
建表有 `uk_tenant_name (tenant_id, name, del_flag)` 唯一索引，但 dept 模块未声明 UniqueFields 预检——重复名称提交会收到数据库 1062 裸错误。修复方向：补 `UniqueFields{Field:"name", Group:"tenant_id"}`（预检范围=索引范围）。
|
||
|
||
## 管理建议
|
||
|
||
+ 部门层级建议控制在 5 层内（子树 BFS 与前端展示友好）
|
||
+ 删除部门前先处理子部门与挂载用户（守卫会拦截）
|
||
+ 未分配部门（dept_id=0）的用户挂数据权限档 2/3 时降级为"仅本人"（防可见面意外放大）
|
||
+ 部门调整后，受影响用户的数据权限即时生效（user.Update 清身份缓存路径覆盖 dept_id 变更）
|