# 出国党籍保留 - 手动配置权限指南

## 📋 文档信息

- **功能模块**: 出国党籍保留管理
- **配置方式**: 手动配置（通过系统管理界面）
- **创建日期**: 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  
**维护人员**: [填写维护人员]