cykj/hzdyjs
1
0 Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
e79bf5a26c2b9c66d1a1cd38ba6448e9bbeaa529
hzdyjs/出国党籍保留手动配置权限指南.md
T
weizhong e79bf5a26c “编译修改”
2025-10-14 16:41:19 +08:00

475 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 出国党籍保留 - 手动配置权限指南
## 📋 文档信息
- **功能模块**: 出国党籍保留管理
- **配置方式**: 手动配置（通过系统管理界面）
- **创建日期**: 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：登录系统管理后台
1. 访问系统管理后台：`http://localhost`
2. 使用管理员账号登录
3. 进入：**系统管理 → 菜单管理**
---
### 步骤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：为管理员角色分配权限
1. 进入：**系统管理 → 角色管理**
2. 找到【管理员】角色，点击【修改】
3. 点击【菜单权限】标签页
4. 在菜单树中找到：**人事管理 → 出国党籍保留**
5. 勾选以下所有权限：
- ☑️ 出国党籍保留（主菜单）
- ☑️ 党籍保留查询
- ☑️ 党籍保留新增
- ☑️ 党籍保留修改
- ☑️ 党籍保留删除
- ☑️ 党籍保留导出
- ☑️ 党籍保留提交
- ☑️ 党籍保留撤回
- ☑️ 党籍保留审批
6. 点击【确定】保存
---
### 步骤5：验证配置
#### 5.1 验证菜单显示
1. 刷新浏览器页面
2. 在左侧菜单栏中找到：**人事管理 → 出国党籍保留**
3. 点击菜单，应该能正常跳转到页面
#### 5.2 验证权限按钮
1. 进入"出国党籍保留"页面
2. 检查页面上是否显示以下按钮：
- ✅ 新增按钮
- ✅ 修改按钮
- ✅ 删除按钮
- ✅ 导出按钮
- ✅ 提交按钮
- ✅ 撤回按钮
- ✅ 审批按钮
#### 5.3 验证功能操作
1. 点击【新增】按钮，测试新增功能
2. 点击【导出】按钮，测试导出功能
3. 测试其他功能按钮是否正常工作
---
## 🔧 方法二：通过SQL脚本快速配置
如果手动配置太繁琐，可以使用SQL脚本快速配置：
### 执行SQL脚本
1. 打开数据库管理工具（如Navicat、DBeaver）
2. 连接到项目数据库
3. 打开SQL脚本文件：
```
backend/ruoyi-modules/ruoyi-rs/出国党籍保留权限菜单配置.sql
```
4. 按照脚本中的说明，分步骤执行：
- ✅ 第一部分：验证父菜单
- ✅ 第二部分：检查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：菜单不显示
**原因**：
- 菜单状态为"停用"
- 显示状态为"隐藏"
- 角色没有分配权限
**解决方案**：
1. 检查菜单状态是否为"正常"
2. 检查显示状态是否为"显示"
3. 检查角色是否分配了该菜单权限
4. 刷新浏览器缓存
---
### 问题2：点击菜单404错误
**原因**：
- 路由地址配置错误
- 组件路径配置错误
- 前端组件文件不存在
**解决方案**：
1. 检查路由地址：`party-membership-retention`
2. 检查组件路径：`rs/party-membership-retention/index`
3. 确认前端组件文件存在
---
### 问题3：功能按钮不显示
**原因**：
- 权限标识配置错误
- 角色没有分配按钮权限
- 前端代码没有使用权限指令
**解决方案**：
1. 检查权限标识是否正确：`rs:partyretention:xxx`（三段式）
2. 检查角色是否分配了按钮权限
3. 检查前端代码是否使用了`v-hasPermi`指令
---
### 问题4：菜单ID冲突
**原因**：
- ID范围与其他模块冲突
- 手动输入ID时输入错误
**解决方案**：
1. 确认使用ID范围：2010-2018
2. 检查数据库中是否已存在相同ID
3. 如有冲突，调整ID范围
---
## 📞 技术支持
如果配置过程中遇到问题，请联系：
- **技术支持**: [填写联系方式]
- **配置文档**: `/backend/ruoyi-modules/ruoyi-rs/出国党籍保留权限菜单配置.sql`
- **参考案例**: 出国登记权限配置
---
## 📝 配置记录
请记录配置过程中的关键信息：
| 项目 | 信息 |
|------|------|
| 配置日期 | [填写日期] |
| 配置人员 | [填写姓名] |
| 配置方式 | [ ] 手动配置 [ ] SQL脚本 |
| 配置环境 | [ ] 开发环境 [ ] 测试环境 [ ] 生产环境 |
| 验证结果 | [ ] 通过 [ ] 失败 |
| 备注说明 | [填写备注] |
---
## ✅ 配置完成
配置完成后，您应该能够：
1. ✅ 在"人事管理"菜单下看到"出国党籍保留"菜单
2. ✅ 点击菜单能正常访问页面
3. ✅ 页面上显示所有功能按钮
4. ✅ 各个功能按钮可以正常使用
5. ✅ 权限控制正常生效
---
**🎉 恭喜！出国党籍保留权限配置完成！**
---
**文档版本**: v1.0
**最后更新**: 2025-10-05
**维护人员**: [填写维护人员]
Reference in new issue View Git Blame Copy Permalink