107 lines
3.1 KiB
PHP
107 lines
3.1 KiB
PHP
<?php
|
|
|
|
namespace App\Contracts\Repositories;
|
|
|
|
use App\Enums\ExtensionOwnerType;
|
|
use App\Models\Permission;
|
|
use Illuminate\Database\Eloquent\Collection;
|
|
|
|
interface PermissionRepositoryInterface
|
|
{
|
|
/**
|
|
* 모든 권한을 조회합니다.
|
|
*
|
|
* @return Collection 권한 컬렉션
|
|
*/
|
|
public function getAll(): Collection;
|
|
|
|
/**
|
|
* ID로 권한을 찾습니다.
|
|
*
|
|
* @param int $id 권한 ID
|
|
* @return Permission|null 찾은 권한 모델 또는 null
|
|
*/
|
|
public function findById(int $id): ?Permission;
|
|
|
|
/**
|
|
* 식별자로 권한을 찾습니다.
|
|
*
|
|
* @param string $identifier 권한 식별자
|
|
* @return Permission|null 찾은 권한 모델 또는 null
|
|
*/
|
|
public function findByIdentifier(string $identifier): ?Permission;
|
|
|
|
/**
|
|
* 새로운 권한을 생성합니다.
|
|
*
|
|
* @param array $data 권한 생성 데이터
|
|
* @return Permission 생성된 권한 모델
|
|
*/
|
|
public function create(array $data): Permission;
|
|
|
|
/**
|
|
* 권한을 생성하거나 업데이트합니다.
|
|
*
|
|
* @param array $attributes 조회 조건
|
|
* @param array $values 생성/업데이트할 데이터
|
|
* @return Permission 생성 또는 업데이트된 권한 모델
|
|
*/
|
|
public function updateOrCreate(array $attributes, array $values): Permission;
|
|
|
|
/**
|
|
* 기존 권한을 업데이트합니다.
|
|
*
|
|
* @param Permission $permission 업데이트할 권한 모델
|
|
* @param array $data 업데이트할 데이터
|
|
* @return bool 업데이트 성공 여부
|
|
*/
|
|
public function update(Permission $permission, array $data): bool;
|
|
|
|
/**
|
|
* 권한을 삭제합니다.
|
|
*
|
|
* @param Permission $permission 삭제할 권한 모델
|
|
* @return bool 삭제 성공 여부
|
|
*/
|
|
public function delete(Permission $permission): bool;
|
|
|
|
/**
|
|
* 특정 확장의 모든 권한을 조회합니다.
|
|
*
|
|
* @param ExtensionOwnerType $type 확장 타입
|
|
* @param string|null $identifier 확장 식별자
|
|
* @return Collection 확장에 속한 권한 컬렉션
|
|
*/
|
|
public function getByExtension(ExtensionOwnerType $type, ?string $identifier = null): Collection;
|
|
|
|
/**
|
|
* 특정 확장의 모든 권한을 삭제합니다.
|
|
*
|
|
* @param ExtensionOwnerType $type 확장 타입
|
|
* @param string|null $identifier 확장 식별자
|
|
* @return int 삭제된 레코드 수
|
|
*/
|
|
public function deleteByExtension(ExtensionOwnerType $type, ?string $identifier = null): int;
|
|
|
|
/**
|
|
* 코어 권한들을 조회합니다.
|
|
*
|
|
* @return Collection 코어 권한 컬렉션
|
|
*/
|
|
public function getCorePermissions(): Collection;
|
|
|
|
/**
|
|
* 최상위 권한(루트)을 모든 자식과 함께 조회합니다.
|
|
*
|
|
* @return Collection 루트 권한 컬렉션 (allChildren 관계 포함)
|
|
*/
|
|
public function getRootsWithChildren(): Collection;
|
|
|
|
/**
|
|
* 할당 가능한 권한 ID 목록을 반환합니다. (리프 노드만)
|
|
*
|
|
* @return array 할당 가능한 권한 ID 배열
|
|
*/
|
|
public function getAssignableIds(): array;
|
|
}
|