档案管理系统多部门分级权限设置实操落地完整解决方案

前置准备

本文方案适配绝大多数通用B/S架构档案管理系统，需提前确认你拥有系统管理员身份，提前开通对应权限，准备内容如下：

• 系统最高权限管理员账号
• 数据库读写操作权限（用于初始化权限表结构）
• 系统内已经完成部门基础档案、档案目录的录入

第一步：设计部门权限关联数据结构

新增两张核心权限表，适配所有场景的权限配置，以下是可直接在MySQL执行的建表SQL：

```sql -- 部门-档案目录权限关联表 CREATE TABLE `dept_archive_perm` ( `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID', `dept_id` bigint NOT NULL COMMENT '部门ID', `catalog_id` bigint NOT NULL COMMENT '档案目录ID', `perm_type` tinyint NOT NULL COMMENT '权限类型：1=查看 2=编辑 3=删除', `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', PRIMARY KEY (`id`), KEY `idx_dept` (`dept_id`), KEY `idx_catalog` (`catalog_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='部门档案权限关联表'; -- 部门特殊权限白名单表 CREATE TABLE `dept_perm_whitelist` ( `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键', `dept_id` bigint NOT NULL COMMENT '部门ID', `user_id` bigint NOT NULL COMMENT '特殊权限用户ID', `extra_perm` varchar(255) DEFAULT NULL COMMENT '额外权限，逗号分隔', PRIMARY KEY (`id`), KEY `idx_dept_user` (`dept_id`,`user_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='部门特殊权限白名单'; ```

如果你的系统已经有权限模块，只需要在原有权限表中新增dept_id字段关联部门即可，不需要新建表。

数据初始化操作

给所有已有部门批量初始化根目录查看权限，执行以下SQL即可一键完成初始化：

```sql -- 批量给所有未删除部门初始化根档案目录查看权限，1代表根目录ID、1代表查看权限 INSERT INTO dept_archive_perm (dept_id, catalog_id, perm_type) SELECT id, 1, 1 FROM sys_dept WHERE deleted = 0; ```

第二步：配置后端权限拦截规则

在系统的全局接口拦截器中新增部门权限校验逻辑，以下是SpringBoot项目可直接复用的核心校验代码：

```java // 部门档案权限校验核心方法，直接注入拦截器即可 public boolean checkDeptArchivePerm(Long archiveId, Long userId, Integer requirePerm) { // 1. 获取当前登录用户所属部门ID Long userDeptId = userService.getUserDeptId(userId); // 2. 获取当前操作档案所属的目录ID Long catalogId = archiveService.getArchiveCatalogId(archiveId); // 3. 超级管理员直接放行 if (userService.isAdmin(userId)) { return true; } // 4. 校验白名单特殊权限 if (whitelistService.hasExtraPerm(userDeptId, userId, requirePerm)) { return true; } // 5. 匹配部门权限配置 return permMapper.countMatchPerm(userDeptId, catalogId, requirePerm) > 0; } ```

将上述方法注入到所有档案操作接口的前置拦截环节，包括档案列表、查看、编辑、删除接口，未授权访问直接返回403无权限提示即可。

第三步：后台可视化配置实操步骤

完成开发后，进入管理员后台按以下步骤即可完成业务配置：

• 步骤1：进入配置页：打开菜单「系统设置」-「部门权限管理」，选中需要设置权限的部门点击进入配置页
• 步骤2：勾选权限：在左侧档案目录树中，勾选该部门允许访问的目录，按需求勾选对应权限类型：仅允许查看勾选「查看」，允许修改勾选「编辑」，允许删除勾选「删除」
• 步骤3：配置特殊权限：如果部门内有员工需要超出部门规则的特殊权限，在白名单区域添加对应用户账号，勾选额外权限即可
• 步骤4：保存生效：点击「保存配置」按钮，系统自动更新数据库权限数据，配置即时生效，不需要重启服务

常见场景配置参考

• 普通业务部门：仅允许查看本部门业务档案，仅可编辑本部门上传的档案，配置为：本部门业务目录勾选查看权限，本部门归档目录勾选编辑权限
• 财务部门：全部门可查看所有财务档案，仅财务负责人可删除，配置为：所有财务目录给全部门勾选查看权限，财务负责人添加到白名单，额外赋予删除权限
• 跨部门共享档案：将共享档案目录同时添加到多个部门的权限列表，即可实现多部门共同访问

第四步：测试验证避免权限漏洞

配置完成后按以下步骤测试，确认无漏洞：

• 用部门普通账号登录，直接在地址栏输入未授权档案的访问地址，确认返回无权限提示
• 访问已授权目录，确认可以正常列出档案，对应权限的操作可正常执行，无权限的操作按钮自动隐藏
• 白名单特殊用户登录，确认额外权限正常生效

常见问题解决

• 配置后不生效：检查拦截器是否注入校验逻辑，检查数据库中部门ID、目录ID是否匹配，清空系统权限缓存后重试
• 需要子部门继承父部门权限：查询权限时改用以下SQL，即可自动获取所有父部门权限： ```sql SELECT FROM dept_archive_perm WHERE dept_id IN (SELECT id FROM sys_dept WHERE id = {deptId} OR FIND_IN_SET(id, parent_dept_path)) ```
• 员工同时属于多个部门：校验时取用户所有部门的权限并集，默认开放最高权限即可

按照以上步骤操作，即可完成稳定可用、可灵活调整的档案管理部门权限设置，无需对现有系统做大规模架构改造。