Files
sam-manage/app/Services/RolePermissionService.php
2026-02-20 09:30:33 +09:00

331 lines
11 KiB
PHP

<?php
namespace App\Services;
use App\Models\Commons\Menu;
use App\Models\Permission;
use Illuminate\Support\Facades\DB;
class RolePermissionService
{
/**
* 권한 유형 목록
*/
private array $permissionTypes = ['view', 'create', 'update', 'delete', 'approve', 'export', 'manage'];
/**
* 역할의 권한 매트릭스 조회
*
* @param int $roleId 역할 ID
* @param int|null $tenantId 테넌트 ID
* @param string $guardName 가드 이름
* @return array 메뉴별 권한 상태 매트릭스
*/
public function getRolePermissionMatrix(int $roleId, ?int $tenantId = null, string $guardName = 'web'): array
{
$query = DB::table('role_has_permissions')
->join('permissions', 'role_has_permissions.permission_id', '=', 'permissions.id')
->where('role_has_permissions.role_id', $roleId)
->where('permissions.guard_name', $guardName)
->where('permissions.name', 'like', 'menu:%');
if ($tenantId) {
$query->where('permissions.tenant_id', $tenantId);
}
$rolePermissions = $query->pluck('permissions.name')->toArray();
$permissions = [];
foreach ($rolePermissions as $permName) {
if (preg_match('/^menu:(\d+)\.(\w+)$/', $permName, $matches)) {
$menuId = (int) $matches[1];
$type = $matches[2];
if (! isset($permissions[$menuId])) {
$permissions[$menuId] = [];
}
$permissions[$menuId][$type] = true;
}
}
return $permissions;
}
/**
* 특정 메뉴의 특정 권한 토글
*
* @param int $roleId 역할 ID
* @param int $menuId 메뉴 ID
* @param string $permissionType 권한 유형
* @param int|null $tenantId 테넌트 ID
* @param string $guardName 가드 이름
* @return bool 토글 후 상태 (true: 허용, false: 거부)
*/
public function togglePermission(int $roleId, int $menuId, string $permissionType, ?int $tenantId = null, string $guardName = 'web'): bool
{
$permissionName = "menu:{$menuId}.{$permissionType}";
// 권한 생성 또는 조회
$permission = Permission::firstOrCreate(
['name' => $permissionName, 'guard_name' => $guardName, 'tenant_id' => $tenantId],
['created_by' => auth()->id()]
);
// 현재 권한 상태 확인
$exists = DB::table('role_has_permissions')
->where('role_id', $roleId)
->where('permission_id', $permission->id)
->exists();
if ($exists) {
// 권한 제거
DB::table('role_has_permissions')
->where('role_id', $roleId)
->where('permission_id', $permission->id)
->delete();
$newValue = false;
} else {
// 권한 부여
DB::table('role_has_permissions')->insert([
'role_id' => $roleId,
'permission_id' => $permission->id,
]);
$newValue = true;
}
// 하위 메뉴에 권한 전파
$this->propagateToChildren($roleId, $menuId, $permissionType, $newValue, $tenantId, $guardName);
return $newValue;
}
/**
* 하위 메뉴에 권한 전파
*
* @param int $roleId 역할 ID
* @param int $parentMenuId 부모 메뉴 ID
* @param string $permissionType 권한 유형
* @param bool $value 권한 값 (true: 허용, false: 거부)
* @param int|null $tenantId 테넌트 ID
* @param string $guardName 가드 이름
*/
protected function propagateToChildren(int $roleId, int $parentMenuId, string $permissionType, bool $value, ?int $tenantId = null, string $guardName = 'web'): void
{
$children = Menu::where('parent_id', $parentMenuId)->get();
foreach ($children as $child) {
$permissionName = "menu:{$child->id}.{$permissionType}";
$permission = Permission::firstOrCreate(
['name' => $permissionName, 'guard_name' => $guardName, 'tenant_id' => $tenantId],
['created_by' => auth()->id()]
);
if ($value) {
// 권한 부여
$exists = DB::table('role_has_permissions')
->where('role_id', $roleId)
->where('permission_id', $permission->id)
->exists();
if (! $exists) {
DB::table('role_has_permissions')->insert([
'role_id' => $roleId,
'permission_id' => $permission->id,
]);
}
} else {
// 권한 제거
DB::table('role_has_permissions')
->where('role_id', $roleId)
->where('permission_id', $permission->id)
->delete();
}
// 재귀적으로 하위 메뉴 처리
$this->propagateToChildren($roleId, $child->id, $permissionType, $value, $tenantId, $guardName);
}
}
/**
* 모든 권한 허용
*
* @param int $roleId 역할 ID
* @param int|null $tenantId 테넌트 ID
* @param string $guardName 가드 이름
*/
public function allowAllPermissions(int $roleId, ?int $tenantId = null, string $guardName = 'web'): void
{
$query = Menu::where('is_active', 1);
if ($tenantId) {
$query->where('tenant_id', $tenantId);
}
$menus = $query->get();
foreach ($menus as $menu) {
foreach ($this->permissionTypes as $type) {
$permissionName = "menu:{$menu->id}.{$type}";
$permission = Permission::firstOrCreate(
['name' => $permissionName, 'guard_name' => $guardName, 'tenant_id' => $tenantId],
['created_by' => auth()->id()]
);
// 권한 부여
$exists = DB::table('role_has_permissions')
->where('role_id', $roleId)
->where('permission_id', $permission->id)
->exists();
if (! $exists) {
DB::table('role_has_permissions')->insert([
'role_id' => $roleId,
'permission_id' => $permission->id,
]);
}
}
}
}
/**
* 모든 권한 거부
*
* @param int $roleId 역할 ID
* @param int|null $tenantId 테넌트 ID
* @param string $guardName 가드 이름
*/
public function denyAllPermissions(int $roleId, ?int $tenantId = null, string $guardName = 'web'): void
{
// menu: 접두사를 가진 해당 테넌트/가드의 모든 권한 ID 조회
$query = DB::table('permissions')
->where('guard_name', $guardName)
->where('name', 'like', 'menu:%');
if ($tenantId) {
$query->where('tenant_id', $tenantId);
}
$permissionIds = $query->pluck('id');
if ($permissionIds->isNotEmpty()) {
DB::table('role_has_permissions')
->where('role_id', $roleId)
->whereIn('permission_id', $permissionIds)
->delete();
}
}
/**
* 기본 권한으로 초기화 (view만 허용)
*
* @param int $roleId 역할 ID
* @param int|null $tenantId 테넌트 ID
* @param string $guardName 가드 이름
*/
public function resetToDefaultPermissions(int $roleId, ?int $tenantId = null, string $guardName = 'web'): void
{
// 1. 먼저 모든 권한 제거
$this->denyAllPermissions($roleId, $tenantId, $guardName);
// 2. view 권한만 허용
$query = Menu::where('is_active', 1);
if ($tenantId) {
$query->where('tenant_id', $tenantId);
}
$menus = $query->get();
foreach ($menus as $menu) {
$permissionName = "menu:{$menu->id}.view";
$permission = Permission::firstOrCreate(
['name' => $permissionName, 'guard_name' => $guardName, 'tenant_id' => $tenantId],
['created_by' => auth()->id()]
);
// 이미 존재하는지 확인
$exists = DB::table('role_has_permissions')
->where('role_id', $roleId)
->where('permission_id', $permission->id)
->exists();
if (! $exists) {
DB::table('role_has_permissions')->insert([
'role_id' => $roleId,
'permission_id' => $permission->id,
]);
}
}
}
/**
* 메뉴 트리 조회 (권한 매트릭스 표시용)
*
* @param int|null $tenantId 테넌트 ID
* @return \Illuminate\Support\Collection 메뉴 트리
*/
public function getMenuTree(?int $tenantId = null): \Illuminate\Support\Collection
{
$query = Menu::with('parent')
->where('is_active', 1);
if ($tenantId) {
$query->where('tenant_id', $tenantId);
}
$allMenus = $query->orderBy('sort_order', 'asc')
->orderBy('id', 'asc')
->get();
// depth 계산하여 플랫한 구조로 변환
return $this->flattenMenuTree($allMenus);
}
/**
* 트리 구조를 플랫한 배열로 변환 (depth 정보 포함)
*
* @param \Illuminate\Support\Collection $menus 메뉴 컬렉션
* @param int|null $parentId 부모 메뉴 ID
* @param int $depth 현재 깊이
*/
private function flattenMenuTree(\Illuminate\Support\Collection $menus, ?int $parentId = null, int $depth = 0): \Illuminate\Support\Collection
{
$result = collect();
$filteredMenus = $menus->where('parent_id', $parentId)->sortBy('sort_order');
foreach ($filteredMenus as $menu) {
$menu->depth = $depth;
// 자식 메뉴 존재 여부 확인
$menu->has_children = $menus->where('parent_id', $menu->id)->count() > 0;
$result->push($menu);
// 자식 메뉴 재귀적으로 추가
$children = $this->flattenMenuTree($menus, $menu->id, $depth + 1);
$result = $result->merge($children);
}
return $result;
}
/**
* 특정 역할의 활성 메뉴 권한 확인
*
* @param int $roleId 역할 ID
* @param int $menuId 메뉴 ID
* @param string $permissionType 권한 유형
* @return bool 권한 존재 여부
*/
public function hasPermission(int $roleId, int $menuId, string $permissionType): bool
{
$permissionName = "menu:{$menuId}.{$permissionType}";
return DB::table('role_has_permissions')
->join('permissions', 'role_has_permissions.permission_id', '=', 'permissions.id')
->where('role_has_permissions.role_id', $roleId)
->where('permissions.name', $permissionName)
->exists();
}
}