HeuJung
4e1ec6e001
공개이슈 ··· 및 그 전수 해소분. - 설정 저장·복원·초기화가 상주 프로세스 미러를 갱신하도록 단일 소유자화 - 만료 데이터 자동 정리 예약 12종 신설, 파기는 기본키 배치로 분할 - 회원 탈퇴를 전 경로 원자화하고 관리자 상태변경 경로를 정식 탈퇴로 통일 - 일괄 처리 목록의 선택을 화면에 보이는 행으로 한정(selectionScope) - 비밀번호 정책 문구를 도메인 중립 라벨로 정정 - 정적 검사 2종·검증 스킬 설계 정합성 축 신설
77 lines
2.5 KiB
PHP
77 lines
2.5 KiB
PHP
<?php
|
|
|
|
namespace App\Contracts\Repositories;
|
|
|
|
use Illuminate\Contracts\Pagination\CursorPaginator;
|
|
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
|
|
use Illuminate\Database\Eloquent\Collection;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
|
|
/**
|
|
* 활동 로그 Repository 인터페이스
|
|
*/
|
|
interface ActivityLogRepositoryInterface
|
|
{
|
|
/**
|
|
* 특정 모델의 활동 로그를 페이지네이션하여 조회합니다.
|
|
*
|
|
* @param Model $model 대상 모델
|
|
* @param array $filters 필터 조건
|
|
* @return LengthAwarePaginator 페이지네이션된 로그 목록
|
|
*/
|
|
public function getPaginatedForModel(Model $model, array $filters = []): LengthAwarePaginator;
|
|
|
|
/**
|
|
* 활동 로그 목록을 페이지네이션하여 조회합니다.
|
|
*
|
|
* 요청에 `cursor` 가 있으면 키셋(커서) 방식으로 응답합니다.
|
|
*
|
|
* @param array $filters 필터 조건
|
|
* @return LengthAwarePaginator|CursorPaginator 페이지네이션된 로그 목록
|
|
*/
|
|
public function getPaginated(array $filters = []): LengthAwarePaginator|CursorPaginator;
|
|
|
|
/**
|
|
* 활동 로그를 삭제합니다.
|
|
*
|
|
* @param int $id 삭제할 활동 로그 ID
|
|
* @return bool 삭제 성공 여부
|
|
*/
|
|
public function delete(int $id): bool;
|
|
|
|
/**
|
|
* 여러 활동 로그를 일괄 삭제합니다.
|
|
*
|
|
* @param array<int> $ids 삭제할 활동 로그 ID 목록
|
|
* @return int 삭제된 건수
|
|
*/
|
|
public function deleteMany(array $ids): int;
|
|
|
|
/**
|
|
* 최근 활동 로그를 스코프 권한 적용하여 조회합니다.
|
|
*
|
|
* @param string $permission 권한 식별자
|
|
* @param int $limit 조회할 활동 수
|
|
* @return Collection 활동 로그 컬렉션
|
|
*/
|
|
public function getRecent(string $permission, int $limit = 5): Collection;
|
|
|
|
/**
|
|
* 사용자 삭제 시 해당 사용자의 모든 activity_logs.user_id 컬럼을 NULL 로 익명화합니다.
|
|
*
|
|
* 외래키가 제거된 파티셔닝 호환 스키마에서 직접 익명화 책임을 갖습니다.
|
|
*
|
|
* @param int $userId 익명화 대상 사용자 ID
|
|
* @return int 익명화된 row 수
|
|
*/
|
|
public function anonymizeUserId(int $userId): int;
|
|
|
|
/**
|
|
* 보존 기간이 지난 활동 로그를 삭제합니다.
|
|
*
|
|
* @param int $days 보존 기간 (일)
|
|
* @return int 삭제된 건수
|
|
*/
|
|
public function deleteOlderThan(int $days): int;
|
|
}
|