签入版本

EasyGoAdmin_Gin_NaiveVue/zh/modules/dept.md

@@ -1,145 +1,39 @@
 # 6.4 部门管理
 
 :::tip 概述
-部门管理维护组织架构数据，支持树形结构，是数据权限（按部门过滤）的基础。继承 BaseTenantLogic 实现租户隔离。
+部门（gin_dept，租户级）是组织树（parent_id 自关联），同时是**数据权限的锚点**——用户挂部门、角色数据范围按部门收敛、"本部门及以下"档位依赖树形子孙计算。
 :::
 
-## 模块特点
+## 功能清单
 
-| 特性 | 说明 |
-|------|------|
-| 基类 | BaseTenantLogic（租户隔离） |
-| 树形结构 | treeParentField='parent_id' |
-| 唯一校验 | name 全局唯一 |
-| 删除校验 | beforeDelete 检查是否存在子部门 |
-| 数据权限 | 被 UserLogic 的 dataScopeDeptField='dept_id' 引用 |
+| 接口 | 说明 |
+|---|---|
+| Page / List / Detail / Add / Update / Delete / BatchDelete | 标准维护（树形） |
 
-## 数据库表结构
+## 树形声明
 
-```sql
-CREATE TABLE `think_dept` (
-  `id` int NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `name` varchar(150) NOT NULL COMMENT '部门名称',
-  `type` int DEFAULT 0 COMMENT '部门类型：1-公司 2-子公司 3-部门 4-小组',
-  `parent_id` int DEFAULT 0 COMMENT '上级部门ID',
-  `sort` int DEFAULT 0 COMMENT '部门排序',
-  `note` varchar(255) DEFAULT NULL COMMENT '备注',
-  `create_user` varchar(50) DEFAULT NULL COMMENT '创建人',
-  `create_time` datetime DEFAULT (now()) COMMENT '创建时间',
-  `update_user` varchar(50) DEFAULT NULL COMMENT '更新人',
-  `update_time` datetime DEFAULT (now()) COMMENT '更新时间',
-  `is_delete` int DEFAULT 0 COMMENT '删除标识：0-正常 1-已删除',
-  PRIMARY KEY (`id`)
-) COMMENT = '部门表';
+deptSpec 以 ModuleSpec 树形能力声明（IsTree + ParentOf），List 平铺结果自动组树返回——前端树选择器/表格展开直接消费。
+
+## 在数据权限中的角色
+
+```text
+用户.dept_id → 部门树 → 数据范围档位展开：
+  2 本部门及以下 = dept_id IN（自身部门 + 全部子孙部门）
+  3 本部门       = dept_id = 自身部门
 ```
 
-## API 接口
+部门调整（移动/删除）会即时影响受影响用户的数据可见范围——删除前应先迁移用户。
 
-| 方法 | 路径 | 权限码 | 说明 |
-|------|------|--------|------|
-| GET | `/api/dept/list` | sys:dept:page | 树形列表 |
-| GET | `/api/dept/detail/:id` | sys:dept:detail | 详情 |
-| POST | `/api/dept/add` | sys:dept:add | 新增 |
-| PUT | `/api/dept/update` | sys:dept:update | 修改 |
-| DELETE | `/api/dept/delete/:id` | sys:dept:delete | 删除 |
+## 约束
 
-## 核心代码
+- 删除部门前确认无用户与子部门引用（应用层校验，无外键）
+- 部门名在租户内建议唯一（UniqueFields 预检可配）
 
-### Logic 配置
+## 管理界面
 
-```php
-// app/logic/DeptLogic.php
+`system/dept`：树形表格 + 新增子部门 + 拖拽调整层级。
 
-class DeptLogic extends BaseTenantLogic
-{
-    /**
-     * 关联的模型类
-     *
-     * @var string
-     */
-    protected string $modelClass = Dept::class;
-
-    /**
-     * LIKE 模糊匹配字段
-     *
-     * @var array
-     */
-    protected array $pageLikeFields = ['name'];
-
-    /**
-     * 精确匹配字段
-     *
-     * @var array
-     */
-    protected array $pageEqFields = ['type'];
-
-    /**
-     * 默认排序规则
-     *
-     * @var array
-     */
-    protected array $pageOrderBy = [
-        ['field' => 'tenant_id', 'type' => 'asc'],
-        ['field' => 'sort', 'type' => 'asc'],
-    ];
-
-    /**
-     * 唯一性校验字段
-     *
-     * @var array
-     */
-    protected array $uniqueFields = ['name'];
-
-    /**
-     * 删除前处理：检查是否存在子部门
-     *
-     * @param int $id 待删除的部门 ID
-     * @return void
-     * @throws \Exception 当存在子部门时抛出
-     */
-    protected function beforeDelete(int $id): void
-    {
-        $childCount = Dept::where('parent_id', $id)->count();
-        if ($childCount > 0) {
-            throw new \Exception('该部门下存在子部门，不可删除');
-        }
-    }
-}
-```
-
-:::tip 树形接口
-部门使用 `_list()` 而非 `_index()`，返回全量数据后由前端或 Logic 构建树形结构。
-:::
-
-### Controller 示例
-
-```php
-// app/controller/DeptController.php
-
-class DeptController extends BaseController
-{
-    protected DeptLogic $logic;
-
-    protected function initialize(): void
-    {
-        $this->logic = new DeptLogic();
-    }
-
-    #[Log('部门管理-查询树形列表', Log::TYPE_QUERY)]
-    #[Permission('sys:dept:page', '部门列表')]
-    public function list(): Json
-    {
-        return parent::_list($this->logic);
-    }
-
-    #[Log('部门管理-新增记录', Log::TYPE_ADD, '新增部门：{name}')]
-    #[Permission('sys:dept:add', '添加部门')]
-    public function add(): Json
-    {
-        return parent::_add($this->logic, $this->getJsonBody());
-    }
-
-    // ... 其他 CRUD 方法
-}
-```
+## 相关
 
+- [5.10 数据权限](/zh/core/data-scope.html)
+- [6.1 用户管理](/zh/modules/user.html)