# 6.4 部门管理

:::tip 概述
部门（gin_dept，租户级）是组织树（parent_id 自关联），同时是**数据权限的锚点**——用户挂部门、角色数据范围按部门收敛、"本部门及以下"档位依赖树形子孙计算。
:::

## 功能清单

| 接口 | 说明 |
|---|---|
| Page / List / Detail / Add / Update / Delete / BatchDelete | 标准维护（树形） |

## 树形声明

deptSpec 以 ModuleSpec 树形能力声明（IsTree + ParentOf），List 平铺结果自动组树返回——前端树选择器/表格展开直接消费。

## 在数据权限中的角色

```text
用户.dept_id → 部门树 → 数据范围档位展开：
  2 本部门及以下 = dept_id IN（自身部门 + 全部子孙部门）
  3 本部门       = dept_id = 自身部门
```

部门调整（移动/删除）会即时影响受影响用户的数据可见范围——删除前应先迁移用户。

## 约束

- 删除部门前确认无用户与子部门引用（应用层校验，无外键）
- 部门名在租户内建议唯一（UniqueFields 预检可配）

## 管理界面

`system/dept`：树形表格 + 新增子部门 + 拖拽调整层级。

## 相关

- [5.10 数据权限](/zh/core/data-scope.html)
- [6.1 用户管理](/zh/modules/user.html)