应为不同角色的相同操作添加前缀以区分职责边界，如‘admin:manage_users’和‘city_manager:manage_users’；控制器用match按权限名分发，Blade中用@can精确控制渲染。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Laravel 应用中，当 admin 和 city_manager 都能查看营收数据、管理下属用户、审批申请时，仅靠权限名称（如 'view_revenue'）无法体现业务职责边界，容易导致误操作或越权访问。
用角色语义明确区分行为归属
不直接给两个角色赋予相同权限名，而是为同一类操作添加角色前缀。例如：创建 'admin:manage_users' 和 'city_manager:manage_users' 两个独立权限，而非共用 'manage_users'。
这一步必须在权限初始化阶段完成，否则后期修改需同步更新所有授权逻辑和中间件判断。
执行命令生成权限记录：
php artisan tinker → 【Permission::create(['name' => 'admin:manage_users'])】 → Permission::create(['name' => 'city_manager:manage_users'])
在控制器中按角色语义路由逻辑分支
方法一：用 match 表达式精准分发
在处理营收统计的控制器方法中，根据当前用户持有的具体权限名匹配分支：
return match (true) {
$user->can('admin:manage_users') => $this->handleAdminUserManagement(),
$user->can('city_manager:manage_users') => $this->handleCityManagerUserManagement(),
default => abort(403),
};
方法二：用角色名兜底，但仅限无细粒度权限场景
if ($user->hasRole('admin')) { return $this->syncAllGyms(); }
if ($user->hasRole('city_manager')) { return $this->syncCityGyms($user->city_id); }
【注意：此方式绕过权限系统，一旦角色名变更或新增子角色，逻辑即失效】
Blade 模板中按权限名条件渲染
第一步：检查精确权限，不是角色
@can('admin:export_reports')
@endcan
第二步：避免用 @role 判断功能入口
@role('admin') ❌ 不推荐——它无法区分 admin 和 super_admin 的能力差异
第三步：组合权限做复合控制
@can('admin:manage_users')
@can('admin:assign_roles')
@endcan
@endcan
