RuoYi-Vue-Plus/PMS价格管理模块路由配置指南.md

PMS价格管理模块路由配置指南

背景说明

由于elegant-router系统的限制，价格管理模块的路由需要通过系统菜单管理进行配置，而不能直接修改路由文件。

配置步骤

1. 登录系统管理后台

使用管理员账号登录系统，进入"系统管理" -> "菜单管理"

2. 创建价格管理主菜单

点击"新增"按钮，创建价格管理主菜单：

菜单名称：价格管理
菜单类型：目录
路由地址：/pms/pricing
组件路径：Layout
显示排序：4
菜单图标：icon-park-outline:calculator
菜单状态：正常

3. 创建价格规则管理菜单

在"价格管理"菜单下创建子菜单：

菜单名称：价格规则
菜单类型：菜单
路由地址：/pms/pricing/rules
组件路径：pms/pricing-rules/index
显示排序：1
菜单图标：icon-park-outline:setting-config
菜单状态：正常
权限标识：pms:pricingRules:list

4. 创建价格计算历史菜单

菜单名称：价格计算
菜单类型：菜单
路由地址：/pms/pricing/calculations
组件路径：pms/pricing-calculations/index
显示排序：2
菜单图标：icon-park-outline:calculator
菜单状态：正常
权限标识：pms:pricingCalculations:list

5. 创建特殊日期价格菜单

菜单名称：特殊日期
菜单类型：菜单
路由地址：/pms/pricing/special-dates
组件路径：pms/special-dates/index
显示排序：3
菜单图标：icon-park-outline:calendar
菜单状态：正常
权限标识：pms:specialDates:list

权限配置

1. 创建权限点

在"系统管理" -> "权限管理"中添加以下权限：

价格规则权限

pms:pricingRules:list - 价格规则查询
pms:pricingRules:add - 价格规则新增
pms:pricingRules:edit - 价格规则编辑
pms:pricingRules:remove - 价格规则删除
pms:pricingRules:enable - 价格规则启用
pms:pricingRules:disable - 价格规则禁用
pms:pricingRules:copy - 价格规则复制
pms:pricingRules:export - 价格规则导出

价格计算权限

pms:pricingCalculations:list - 价格计算查询
pms:pricingCalculations:calculate - 价格计算
pms:pricingCalculations:detail - 价格计算详情
pms:pricingCalculations:remove - 价格计算删除
pms:pricingCalculations:export - 价格计算导出
pms:pricingCalculations:analysis - 价格分析

特殊日期权限

pms:specialDates:list - 特殊日期查询
pms:specialDates:add - 特殊日期新增
pms:specialDates:edit - 特殊日期编辑
pms:specialDates:remove - 特殊日期删除
pms:specialDates:enable - 特殊日期启用
pms:specialDates:disable - 特殊日期禁用
pms:specialDates:copy - 特殊日期复制
pms:specialDates:export - 特殊日期导出

2. 分配权限给角色

在"系统管理" -> "角色管理"中，为相应角色分配权限：

• PMS管理员：分配所有价格管理权限
• 前台接待：分配价格查询和计算权限
• 财务人员：分配价格规则管理和分析权限

菜单层级结构

配置完成后的菜单结构如下：

PMS系统
├── 联系人管理
├── 房型管理
├── 房间管理
├── 价格管理 (新增)
│   ├── 价格规则
│   ├── 价格计算
│   └── 特殊日期
└── 其他模块...

验证配置

1. 检查菜单显示

登录系统后，在左侧导航栏应该能看到"价格管理"菜单及其子菜单。

2. 检查页面访问

点击各个菜单项，确认能正常访问对应的页面：

• /pms/pricing/rules - 价格规则管理页面
• /pms/pricing/calculations - 价格计算历史页面
• /pms/pricing/special-dates - 特殊日期价格页面

3. 检查权限控制

使用不同权限的用户登录，验证权限控制是否生效：

• 有权限的用户能看到菜单和操作按钮
• 无权限的用户看不到相关菜单或按钮被禁用

常见问题

Q1: 菜单配置后不显示

A: 检查以下几点：

1. 菜单状态是否为"正常"
2. 当前用户是否有对应权限
3. 路由地址是否正确
4. 组件路径是否存在

Q2: 页面访问404错误

A: 检查：

1. 组件路径是否正确
2. Vue组件文件是否存在
3. 路由地址是否与菜单配置一致

Q3: 权限控制不生效

A: 检查：

1. 权限标识是否正确
2. 用户角色是否分配了对应权限
3. 前端组件中的权限判断是否正确

技术说明

elegant-router限制

elegant-router是一个基于文件系统的路由生成器，它有以下限制：

1. 自动生成：路由是根据文件结构自动生成的
2. 类型安全：有严格的TypeScript类型检查
3. 不可直接编辑：生成的路由文件不能手动修改

解决方案

通过系统菜单管理配置路由的优势：

1. 动态配置：可以在运行时动态配置菜单和路由
2. 权限集成：与权限系统无缝集成
3. 用户友好：管理员可以通过界面配置，无需修改代码

总结

通过系统菜单管理配置价格管理模块的路由是最佳实践，它不仅解决了elegant-router的限制问题，还提供了更好的权限控制和用户体验。

配置完成后，用户就可以正常使用价格管理模块的所有功能了。