13 KiB
13 KiB
出国党籍保留 - 手动配置权限指南
📋 文档信息
- 功能模块: 出国党籍保留管理
- 配置方式: 手动配置（通过系统管理界面）
- 创建日期: 2025-10-05
- 配置人员: [填写配置人员姓名]
- 版本: v1.0
🎯 配置目标
为"出国党籍保留"功能配置完整的菜单和权限体系，包括：
- ✅ 1个主菜单（在"人事管理"下）
- ✅ 8个功能权限按钮
- ✅ 管理员角色权限分配
📊 菜单ID分配规划
⚠️ 重要安全规则：
- 人事管理模块菜单ID范围：2000-2028（共29个ID）
- 已使用ID：2000-2009（基础人事管理菜单）
- 本次使用ID：2010-2018（党籍保留，共9个ID）
- 剩余可用ID：2019-2028（供未来扩展）
菜单ID分配表
| 菜单ID | 菜单名称 | 类型 | 权限标识（三段式） | 父菜单ID |
|---|---|---|---|---|
| 2010 | 出国党籍保留 | C(菜单) | rs:partyretention:list | 2000 |
| 2011 | 党籍保留查询 | F(按钮) | rs:partyretention:query | 2010 |
| 2012 | 党籍保留新增 | F(按钮) | rs:partyretention:add | 2010 |
| 2013 | 党籍保留修改 | F(按钮) | rs:partyretention:edit | 2010 |
| 2014 | 党籍保留删除 | F(按钮) | rs:partyretention:remove | 2010 |
| 2015 | 党籍保留导出 | F(按钮) | rs:partyretention:export | 2010 |
| 2016 | 党籍保留提交 | F(按钮) | rs:partyretention:submit | 2010 |
| 2017 | 党籍保留撤回 | F(按钮) | rs:partyretention:withdraw | 2010 |
| 2018 | 党籍保留审批 | F(按钮) | rs:partyretention:approve | 2010 |
🔧 方法一：通过系统管理界面手动配置
步骤1：登录系统管理后台
- 访问系统管理后台：
http://localhost - 使用管理员账号登录
- 进入：系统管理 → 菜单管理
步骤2：创建主菜单（ID: 2010）
点击【新增】按钮，填写以下信息：
基本信息
| 字段 | 值 | 说明 |
|---|---|---|
| 菜单ID | 2010 |
⚠️ 必须手动输入固定ID |
| 菜单名称 | 出国党籍保留 |
显示在菜单栏的名称 |
| 上级菜单 | 人事管理 |
选择父菜单（ID: 2000） |
| 显示排序 | 5 |
在人事管理下的排序 |
| 菜单类型 | 菜单 |
选择"菜单"类型 |
| 菜单图标 | peoples |
选择图标 |
路由信息
| 字段 | 值 | 说明 |
|---|---|---|
| 路由地址 | party-membership-retention |
URL路径 |
| 组件路径 | rs/party-membership-retention/index |
Vue组件路径 |
| 路由参数 | 留空 | 不需要参数 |
权限信息
| 字段 | 值 | 说明 |
|---|---|---|
| 权限标识 | rs:partyretention:list |
列表查询权限（三段式） |
其他设置
| 字段 | 值 | 说明 |
|---|---|---|
| 是否外链 | 否 |
内部页面 |
| 是否缓存 | 是 |
缓存页面 |
| 显示状态 | 显示 |
在菜单中显示 |
| 菜单状态 | 正常 |
启用菜单 |
| 备注 | 出国党籍保留管理菜单 |
说明信息 |
✅ 点击【确定】保存主菜单
步骤3：创建功能权限按钮（ID: 2011-2018）
为主菜单添加8个功能权限按钮，每个按钮的配置如下：
3.1 查询权限（ID: 2011）
| 字段 | 值 |
|---|---|
| 菜单ID | 2011 |
| 菜单名称 | 党籍保留查询 |
| 上级菜单 | 出国党籍保留 (选择刚创建的主菜单) |
| 显示排序 | 1 |
| 菜单类型 | 按钮 |
| 权限标识 | rs:partyretention:query |
| 显示状态 | 显示 |
| 菜单状态 | 正常 |
| 备注 | 查询党籍保留详情权限 |
✅ 点击【确定】保存
3.2 新增权限（ID: 2012）
| 字段 | 值 |
|---|---|
| 菜单ID | 2012 |
| 菜单名称 | 党籍保留新增 |
| 上级菜单 | 出国党籍保留 |
| 显示排序 | 2 |
| 菜单类型 | 按钮 |
| 权限标识 | rs:partyretention:add |
| 显示状态 | 显示 |
| 菜单状态 | 正常 |
| 备注 | 新增党籍保留申请权限 |
✅ 点击【确定】保存
3.3 修改权限（ID: 2013）
| 字段 | 值 |
|---|---|
| 菜单ID | 2013 |
| 菜单名称 | 党籍保留修改 |
| 上级菜单 | 出国党籍保留 |
| 显示排序 | 3 |
| 菜单类型 | 按钮 |
| 权限标识 | rs:partyretention:edit |
| 显示状态 | 显示 |
| 菜单状态 | 正常 |
| 备注 | 修改党籍保留申请权限 |
✅ 点击【确定】保存
3.4 删除权限（ID: 2014）
| 字段 | 值 |
|---|---|
| 菜单ID | 2014 |
| 菜单名称 | 党籍保留删除 |
| 上级菜单 | 出国党籍保留 |
| 显示排序 | 4 |
| 菜单类型 | 按钮 |
| 权限标识 | rs:partyretention:remove |
| 显示状态 | 显示 |
| 菜单状态 | 正常 |
| 备注 | 删除党籍保留申请权限（仅草稿） |
✅ 点击【确定】保存
3.5 导出权限（ID: 2015）
| 字段 | 值 |
|---|---|
| 菜单ID | 2015 |
| 菜单名称 | 党籍保留导出 |
| 上级菜单 | 出国党籍保留 |
| 显示排序 | 5 |
| 菜单类型 | 按钮 |
| 权限标识 | rs:partyretention:export |
| 显示状态 | 显示 |
| 菜单状态 | 正常 |
| 备注 | 导出党籍保留列表权限 |
✅ 点击【确定】保存
3.6 提交权限（ID: 2016）
| 字段 | 值 |
|---|---|
| 菜单ID | 2016 |
| 菜单名称 | 党籍保留提交 |
| 上级菜单 | 出国党籍保留 |
| 显示排序 | 6 |
| 菜单类型 | 按钮 |
| 权限标识 | rs:partyretention:submit |
| 显示状态 | 显示 |
| 菜单状态 | 正常 |
| 备注 | 提交党籍保留申请权限 |
✅ 点击【确定】保存
3.7 撤回权限（ID: 2017）
| 字段 | 值 |
|---|---|
| 菜单ID | 2017 |
| 菜单名称 | 党籍保留撤回 |
| 上级菜单 | 出国党籍保留 |
| 显示排序 | 7 |
| 菜单类型 | 按钮 |
| 权限标识 | rs:partyretention:withdraw |
| 显示状态 | 显示 |
| 菜单状态 | 正常 |
| 备注 | 撤回党籍保留申请权限 |
✅ 点击【确定】保存
3.8 审批权限（ID: 2018）
| 字段 | 值 |
|---|---|
| 菜单ID | 2018 |
| 菜单名称 | 党籍保留审批 |
| 上级菜单 | 出国党籍保留 |
| 显示排序 | 8 |
| 菜单类型 | 按钮 |
| 权限标识 | rs:partyretention:approve |
| 显示状态 | 显示 |
| 菜单状态 | 正常 |
| 备注 | 审批党籍保留申请权限 |
✅ 点击【确定】保存
步骤4：为管理员角色分配权限
- 进入：系统管理 → 角色管理
- 找到【管理员】角色，点击【修改】
- 点击【菜单权限】标签页
- 在菜单树中找到：人事管理 → 出国党籍保留
- 勾选以下所有权限：
- ☑️ 出国党籍保留（主菜单）
- ☑️ 党籍保留查询
- ☑️ 党籍保留新增
- ☑️ 党籍保留修改
- ☑️ 党籍保留删除
- ☑️ 党籍保留导出
- ☑️ 党籍保留提交
- ☑️ 党籍保留撤回
- ☑️ 党籍保留审批
- 点击【确定】保存
步骤5：验证配置
5.1 验证菜单显示
- 刷新浏览器页面
- 在左侧菜单栏中找到：人事管理 → 出国党籍保留
- 点击菜单，应该能正常跳转到页面
5.2 验证权限按钮
- 进入"出国党籍保留"页面
- 检查页面上是否显示以下按钮：
- ✅ 新增按钮
- ✅ 修改按钮
- ✅ 删除按钮
- ✅ 导出按钮
- ✅ 提交按钮
- ✅ 撤回按钮
- ✅ 审批按钮
5.3 验证功能操作
- 点击【新增】按钮，测试新增功能
- 点击【导出】按钮，测试导出功能
- 测试其他功能按钮是否正常工作
🔧 方法二：通过SQL脚本快速配置
如果手动配置太繁琐，可以使用SQL脚本快速配置：
执行SQL脚本
- 打开数据库管理工具（如Navicat、DBeaver）
- 连接到项目数据库
- 打开SQL脚本文件：
backend/ruoyi-modules/ruoyi-rs/出国党籍保留权限菜单配置.sql - 按照脚本中的说明，分步骤执行：
- ✅ 第一部分：验证父菜单
- ✅ 第二部分：检查ID冲突
- ✅ 第三部分：删除旧菜单
- ✅ 第四部分：创建主菜单
- ✅ 第五部分：创建功能权限按钮
- ✅ 第六部分：分配管理员权限
- ✅ 第七部分：验证配置
SQL脚本优势
- ✅ 快速配置，一键完成
- ✅ 固定ID，避免冲突
- ✅ 可重复执行
- ✅ 包含完整验证
⚠️ 重要注意事项
1. 菜单ID必须固定
- 必须使用ID 2010-2018
- 不要使用系统自动生成的ID
- 避免与其他模块冲突
2. 父菜单ID必须正确
- 主菜单的父菜单ID必须是 2000（人事管理）
- 所有按钮的父菜单ID必须是 2010（出国党籍保留主菜单）
3. 权限标识必须准确
- 权限标识格式：
rs:partyretention:xxx（三段式：模块:功能:操作） - 必须与后端Controller中的
@SaCheckPermission注解一致 - 不要随意修改权限标识
4. 菜单类型必须正确
- 主菜单：类型为 C（菜单）
- 功能按钮：类型为 F（按钮）
- 不要选错类型
5. 路由地址和组件路径
- 路由地址：
party-membership-retention - 组件路径：
rs/party-membership-retention/index - 必须与前端路由配置一致
📋 配置检查清单
配置完成后，请逐项检查：
菜单配置检查
- 主菜单（ID: 2010）已创建
- 主菜单显示在"人事管理"下
- 主菜单图标正确显示
- 主菜单路由地址正确
权限按钮检查
- 查询权限（ID: 2011）已创建
- 新增权限（ID: 2012）已创建
- 修改权限（ID: 2013）已创建
- 删除权限（ID: 2014）已创建
- 导出权限（ID: 2015）已创建
- 提交权限（ID: 2016）已创建
- 撤回权限（ID: 2017）已创建
- 审批权限（ID: 2018）已创建
角色权限检查
- 管理员角色已分配所有权限
- 其他角色根据需要分配权限
功能验证检查
- 菜单可以正常访问
- 页面可以正常显示
- 功能按钮可以正常显示
- 权限控制正常生效
🔍 常见问题排查
问题1：菜单不显示
原因：
- 菜单状态为"停用"
- 显示状态为"隐藏"
- 角色没有分配权限
解决方案：
- 检查菜单状态是否为"正常"
- 检查显示状态是否为"显示"
- 检查角色是否分配了该菜单权限
- 刷新浏览器缓存
问题2：点击菜单404错误
原因：
- 路由地址配置错误
- 组件路径配置错误
- 前端组件文件不存在
解决方案：
- 检查路由地址：
party-membership-retention - 检查组件路径：
rs/party-membership-retention/index - 确认前端组件文件存在
问题3：功能按钮不显示
原因：
- 权限标识配置错误
- 角色没有分配按钮权限
- 前端代码没有使用权限指令
解决方案：
- 检查权限标识是否正确：
rs:partyretention:xxx（三段式） - 检查角色是否分配了按钮权限
- 检查前端代码是否使用了
v-hasPermi指令
问题4：菜单ID冲突
原因：
- ID范围与其他模块冲突
- 手动输入ID时输入错误
解决方案：
- 确认使用ID范围：2010-2018
- 检查数据库中是否已存在相同ID
- 如有冲突，调整ID范围
📞 技术支持
如果配置过程中遇到问题，请联系：
- 技术支持: [填写联系方式]
- 配置文档:
/backend/ruoyi-modules/ruoyi-rs/出国党籍保留权限菜单配置.sql - 参考案例: 出国登记权限配置
📝 配置记录
请记录配置过程中的关键信息：
| 项目 | 信息 |
|---|---|
| 配置日期 | [填写日期] |
| 配置人员 | [填写姓名] |
| 配置方式 | [ ] 手动配置 [ ] SQL脚本 |
| 配置环境 | [ ] 开发环境 [ ] 测试环境 [ ] 生产环境 |
| 验证结果 | [ ] 通过 [ ] 失败 |
| 备注说明 | [填写备注] |
✅ 配置完成
配置完成后，您应该能够：
- ✅ 在"人事管理"菜单下看到"出国党籍保留"菜单
- ✅ 点击菜单能正常访问页面
- ✅ 页面上显示所有功能按钮
- ✅ 各个功能按钮可以正常使用
- ✅ 权限控制正常生效
🎉 恭喜！出国党籍保留权限配置完成！
文档版本: v1.0
最后更新: 2025-10-05
维护人员: [填写维护人员]