HeuJung
71abdeaf60
위임 관리자(부관리자)가 권한·역할·표현식·비밀 콘텐츠 경계를 우회하던 결함군을 계층 대칭성 원칙으로 전건 차단한다. 약한 경로가 정상 응답을 내보내는 것이 유일한 증상이라, 게이트를 생산 지점 한 곳(SSoT)에 두고 같은 데이터를 내보내는 소비 경로 전부가 그 게이트를 경유하도록 맞췄다. - 등급 상한(rank ceiling): 슈퍼관리자 보호·역할/사용자 역할 배정(추가·제거 대칭)·일괄 상태변경·순서변경을 상세 경로와 동일 강도로 재적용. 가드는 DB 쓰기에 선행하여 거부 시 상태 불변. - 레이아웃 표현식: new Function/with 실행을 AST 화이트리스트 평가기로 교체. 비-문자열 computed 키 정규화(normalizeKey)·Object facade(리플렉션 static 제거)·legacy 접근자 차단. 저장측 검증·정적 검사와 3계층 동형. - secret 게이트: 비밀글의 댓글·첨부·문의 독립 경로 재적용, hash 파일서빙 소유권·비밀·발행 상태 검사 통일. - 신뢰 스크립트 호스트: 확장 선언 기반 + same-origin 브라우저 정규화를 런타임·저장측·정적검사 3층 동형화. - 회귀 감지: 단위·Feature·E2E·시나리오 매니페스트 전축 + audit 룰 4종 신설.
115 lines
3.4 KiB
PHP
115 lines
3.4 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;
|
|
|
|
/**
|
|
* 여러 ID로 권한을 일괄 조회합니다.
|
|
*
|
|
* @param array<int> $ids 권한 ID 배열
|
|
* @return Collection 권한 컬렉션 (ID 기준)
|
|
*/
|
|
public function getByIds(array $ids): Collection;
|
|
|
|
/**
|
|
* 새로운 권한을 생성합니다.
|
|
*
|
|
* @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;
|
|
}
|