HeuJung
be9befe023
목록이 뒤쪽 페이지로 갈수록 느려지는 원인은 건너뛰는 행의 넓은 컬럼까지 읽는 것이었다. 지연 조인(inner 는 키 컬럼만, outer 는 이번 페이지 행만 전체 컬럼)과 정렬 컬럼 해석을 코어 공통 트레이트로 두고 코어 8 + 확장 6 저장소에 적용했다. 감사 지적 처리: - 그룹 쿼리의 총 건수 오산 — count 는 groupBy 를 벗기지 않아 첫 그룹의 행 수를 총 건수로 돌려준다. getCountForPagination 으로 교정. - audit 전수 스캔이 버퍼 한계로 한 번도 동작하지 않던 결함과, 확장 경로를 놓치던 정규식 5건을 함께 고쳤다. 그동안 번들 확장의 위반이 보이지 않았다. raw 20건을 빌더 표현으로 치환하고 하드코딩 테이블명 16건을 모델 유래로 바꿨다. 이 과정에서 마이페이지 「내가 댓글 단 글」 검색이 조인 별칭 충돌로 SQL 오류를 내던 결함이 해소됐다. 재발 차단용 룰 2종을 신설하고, 컬럼 프루닝 룰을 error 로 승격했다 (전역 위반 0건 — warning 으로 두면 "0 error" 판정을 통과하며 무음으로 재누적된다). 정렬 허용 목록은 FormRequest 게이트를 덮어야 한다. 좁으면 검증을 통과한 정렬이 422 도 로그도 없이 기본값으로 되돌아간다(스케줄 실행 이력의 종료시각·소요시간 정렬이 그랬다). 호출처를 스캔해 매핑 완전성까지 검사하는 계약 테스트로 전수 강제한다. 해외 배송지 결함도 함께 고쳤다 — 조회는 city/state/postal_code 로 내려주고 폼은 intl_* 로 제출하는 비대칭 때문에, 수정 시 입력칸이 비어 보이고 저장하면 기존 값이 유실됐다. 쿠폰 수정의 유효기간 미검증과 1인당 사용 제한 부분 수정 차단도 함께 수정.
437 lines
13 KiB
PHP
437 lines
13 KiB
PHP
<?php
|
|
|
|
namespace App\Repositories;
|
|
|
|
use App\Contracts\Repositories\UserRepositoryInterface;
|
|
use App\Helpers\PermissionHelper;
|
|
use App\Models\User;
|
|
use App\Repositories\Concerns\HasMultipleSearchFilters;
|
|
use App\Repositories\Concerns\PaginatesWithDeferredJoin;
|
|
use App\Repositories\Concerns\ResolvesSortSpec;
|
|
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
|
|
use Illuminate\Database\Eloquent\Builder;
|
|
use Illuminate\Database\Eloquent\Collection;
|
|
use Illuminate\Support\Carbon;
|
|
use Laravel\Sanctum\PersonalAccessToken;
|
|
|
|
class UserRepository implements UserRepositoryInterface
|
|
{
|
|
use HasMultipleSearchFilters;
|
|
use PaginatesWithDeferredJoin;
|
|
use ResolvesSortSpec;
|
|
|
|
/**
|
|
* 검색 가능한 필드 목록
|
|
*/
|
|
private const SEARCHABLE_FIELDS = ['name', 'email'];
|
|
|
|
/**
|
|
* 허용 정렬 컬럼 (UserListRequest 와 동일 집합)
|
|
*/
|
|
private const SORTABLE_COLUMNS = ['created_at', 'name', 'email', 'last_login_at'];
|
|
|
|
/**
|
|
* 이메일로 사용자를 찾습니다.
|
|
*
|
|
* @param string $email 찾을 사용자의 이메일
|
|
* @return User|null 찾은 사용자 모델 또는 null
|
|
*/
|
|
public function findByEmail(string $email): ?User
|
|
{
|
|
return User::where('email', $email)->first();
|
|
}
|
|
|
|
/**
|
|
* 새로운 사용자를 생성합니다.
|
|
*
|
|
* @param array $data 사용자 생성 데이터
|
|
* @return User 생성된 사용자 모델
|
|
*/
|
|
public function create(array $data): User
|
|
{
|
|
return User::create($data);
|
|
}
|
|
|
|
/**
|
|
* 기존 사용자를 업데이트합니다.
|
|
*
|
|
* @param User $user 업데이트할 사용자 모델
|
|
* @param array $data 업데이트할 데이터
|
|
* @return bool 업데이트 성공 여부
|
|
*/
|
|
public function update(User $user, array $data): bool
|
|
{
|
|
return $user->update($data);
|
|
}
|
|
|
|
/**
|
|
* 사용자를 삭제합니다.
|
|
*
|
|
* @param User $user 삭제할 사용자 모델
|
|
* @return bool 삭제 성공 여부
|
|
*/
|
|
public function delete(User $user): bool
|
|
{
|
|
return $user->delete();
|
|
}
|
|
|
|
/**
|
|
* 모든 사용자를 조회합니다.
|
|
*
|
|
* @return Collection 사용자 컬렉션
|
|
*/
|
|
public function getAll(): Collection
|
|
{
|
|
return User::all();
|
|
}
|
|
|
|
/**
|
|
* ID로 사용자를 찾습니다.
|
|
*
|
|
* @param int $id 사용자 ID
|
|
* @return User|null 찾은 사용자 모델 또는 null
|
|
*/
|
|
public function findById(int $id): ?User
|
|
{
|
|
return User::find($id);
|
|
}
|
|
|
|
/**
|
|
* 필터링 및 페이지네이션이 적용된 사용자 목록을 조회합니다.
|
|
*
|
|
* @param array $filters 필터 조건 배열
|
|
* @return LengthAwarePaginator 페이지네이션된 사용자 목록
|
|
*/
|
|
public function getPaginatedUsers(array $filters = []): LengthAwarePaginator
|
|
{
|
|
$query = User::query();
|
|
|
|
// 권한 스코프 필터링
|
|
PermissionHelper::applyPermissionScope($query, 'core.users.read');
|
|
|
|
// 검색 조건 적용
|
|
$this->applyFilters($query, $filters);
|
|
|
|
// 정렬 적용 (허용 컬럼 화이트리스트로 해석)
|
|
$sort = $this->resolveSortSpec($filters, self::SORTABLE_COLUMNS, 'created_at');
|
|
|
|
// 페이지네이션 적용
|
|
$perPage = $filters['per_page'] ?? 15;
|
|
|
|
// 지연 조인: inner 는 id 만 훑고 roles eager loading 은 해당 페이지에만 적용된다
|
|
return $this->paginateWithDeferredJoin(
|
|
query: $query,
|
|
columns: ['*'],
|
|
sort: $sort,
|
|
perPage: $perPage,
|
|
relations: ['roles'],
|
|
);
|
|
}
|
|
|
|
/**
|
|
* 쿼리에 필터 조건을 적용합니다.
|
|
*
|
|
* @param Builder $query Eloquent 쿼리 빌더
|
|
* @param array $filters 적용할 필터 조건 배열
|
|
*/
|
|
private function applyFilters(Builder $query, array $filters): void
|
|
{
|
|
// 다중 검색 조건 적용
|
|
if (! empty($filters['filters']) && is_array($filters['filters'])) {
|
|
$this->applyMultipleSearchFilters($query, $filters['filters'], self::SEARCHABLE_FIELDS);
|
|
}
|
|
|
|
// 날짜 필터
|
|
$this->applyDateFilters($query, $filters);
|
|
}
|
|
|
|
/**
|
|
* 날짜 필터를 적용합니다.
|
|
*
|
|
* @param Builder $query Eloquent 쿼리 빌더
|
|
* @param array $filters 필터 조건 배열
|
|
*/
|
|
private function applyDateFilters(Builder $query, array $filters): void
|
|
{
|
|
if (! empty($filters['start_date'])) {
|
|
$query->whereDate('created_at', '>=', $filters['start_date']);
|
|
}
|
|
|
|
if (! empty($filters['end_date'])) {
|
|
$query->whereDate('created_at', '<=', $filters['end_date']);
|
|
}
|
|
|
|
// 기본 날짜 필터 (전체가 아닌 경우)
|
|
if (empty($filters['start_date']) && empty($filters['end_date']) &&
|
|
($filters['date_filter'] ?? 'all') !== 'all') {
|
|
$dateFilter = $filters['date_filter'] ?? 'all';
|
|
|
|
match ($dateFilter) {
|
|
'week' => $query->where('created_at', '>=', now()->subWeek()),
|
|
'month' => $query->where('created_at', '>=', now()->subMonth()),
|
|
default => null,
|
|
};
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 사용자 관련 통계 정보를 조회합니다.
|
|
*
|
|
* @return array 사용자 통계 데이터 배열
|
|
*/
|
|
public function getStatistics(): array
|
|
{
|
|
return [
|
|
'total_users' => User::count(),
|
|
'users_this_week' => User::where('created_at', '>=', now()->subWeek())->count(),
|
|
'users_this_month' => User::where('created_at', '>=', now()->subMonth())->count(),
|
|
'users_today' => User::whereDate('created_at', today())->count(),
|
|
'active_users_this_week' => User::where('last_login_at', '>=', now()->subWeek())->count(),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 키워드로 사용자를 검색합니다. (이름, 닉네임, 이메일)
|
|
*
|
|
* @param string $keyword 검색할 키워드
|
|
* @return Collection 검색된 사용자 컬렉션
|
|
*/
|
|
public function searchByKeyword(string $keyword): Collection
|
|
{
|
|
$query = User::where(function ($q) use ($keyword) {
|
|
$q->where('name', 'like', "%{$keyword}%")
|
|
->orWhere('nickname', 'like', "%{$keyword}%")
|
|
->orWhere('email', 'like', "%{$keyword}%");
|
|
});
|
|
|
|
// 권한 스코프 필터링
|
|
PermissionHelper::applyPermissionScope($query, 'core.users.read');
|
|
|
|
return $query->get();
|
|
}
|
|
|
|
/**
|
|
* 최근 등록된 사용자들을 조회합니다.
|
|
*
|
|
* @param int $limit 조회할 사용자 수 (기본값: 10)
|
|
* @return Collection 최근 사용자 컬렉션
|
|
*/
|
|
public function getRecentUsers(int $limit = 10): Collection
|
|
{
|
|
return User::orderBy('created_at', 'desc')->limit($limit)->get();
|
|
}
|
|
|
|
/**
|
|
* 언어별 사용자 수를 조회합니다.
|
|
*
|
|
* @return array 언어별 사용자 수 배열
|
|
*/
|
|
public function getUsersByLanguage(): array
|
|
{
|
|
return User::selectRaw('language, count(*) as count')
|
|
->groupBy('language')
|
|
->pluck('count', 'language')
|
|
->toArray();
|
|
}
|
|
|
|
/**
|
|
* UUID 목록으로 사용자들을 조회하고 UUID 키 맵으로 반환합니다.
|
|
*
|
|
* @param array<int, string> $uuids 사용자 UUID 목록
|
|
* @return Collection<string, User> uuid => User 매핑
|
|
*/
|
|
public function findManyByUuidsKeyed(array $uuids): Collection
|
|
{
|
|
return User::whereIn('uuid', $uuids)->get()->keyBy('uuid');
|
|
}
|
|
|
|
/**
|
|
* UUID 목록으로 사용자들을 조회합니다.
|
|
*
|
|
* @param array<int, string> $uuids 사용자 UUID 목록
|
|
* @return Collection<int, User> 조회된 사용자 컬렉션
|
|
*/
|
|
public function findManyByUuids(array $uuids): Collection
|
|
{
|
|
return User::whereIn('uuid', $uuids)->get();
|
|
}
|
|
|
|
/**
|
|
* 슈퍼관리자 1명을 조회합니다.
|
|
*
|
|
* 역할 기반 수신자 해석에서 대상 역할에 사용자가 없을 때 폴백 수신자로 사용합니다.
|
|
*
|
|
* @return User|null 슈퍼관리자 또는 없으면 null
|
|
*/
|
|
public function findSuperAdmin(): ?User
|
|
{
|
|
return User::superAdmins()->first();
|
|
}
|
|
|
|
/**
|
|
* 특정 권한 identifier 를 가진 역할에 소속된 모든 사용자를 조회합니다.
|
|
*
|
|
* "권한을 가진 자" 기준이므로 권한이 회수되면 자동으로 결과에서 제외됩니다.
|
|
*
|
|
* @param string $permissionIdentifier 권한 identifier
|
|
* @return Collection<int, User> 권한 보유 사용자 컬렉션
|
|
*/
|
|
public function findManyByPermissionIdentifier(string $permissionIdentifier): Collection
|
|
{
|
|
return User::query()
|
|
->whereHas('roles.permissions', function ($query) use ($permissionIdentifier) {
|
|
$query->where('permissions.identifier', $permissionIdentifier);
|
|
})
|
|
->get();
|
|
}
|
|
|
|
/**
|
|
* 사용자의 연속 로그인 실패 카운터를 1 증가시킵니다.
|
|
*
|
|
* @param User $user 대상 사용자
|
|
* @return int 증가 후 카운트
|
|
*/
|
|
public function incrementFailedAttempts(User $user): int
|
|
{
|
|
$next = (int) ($user->failed_login_attempts ?? 0) + 1;
|
|
|
|
$user->forceFill([
|
|
'failed_login_attempts' => $next,
|
|
'last_failed_login_at' => now(),
|
|
])->save();
|
|
|
|
return $next;
|
|
}
|
|
|
|
/**
|
|
* 사용자의 계정을 지정된 분만큼 잠급니다.
|
|
*
|
|
* `$minutes <= 0` 은 보안 환경설정의 "0 = 무한대" 규약에 따라 영구 잠금으로 처리합니다.
|
|
* 영구 잠금은 해제 시각이 없으므로 `locked_until` 을 NULL 로 두고
|
|
* `locked_permanently` 플래그로 상태를 표현합니다 (NULL 은 이미 "잠금 없음" 을 의미).
|
|
*
|
|
* @param User $user 잠글 사용자
|
|
* @param int $minutes 잠금 유지 시간(분). 0 이하는 무기한
|
|
* @return Carbon|null 잠금 해제 시각 (영구 잠금은 null)
|
|
*/
|
|
public function lockAccount(User $user, int $minutes): ?Carbon
|
|
{
|
|
$permanent = $minutes <= 0;
|
|
$lockedUntil = $permanent ? null : now()->addMinutes($minutes);
|
|
|
|
$user->forceFill([
|
|
'locked_until' => $lockedUntil,
|
|
'locked_permanently' => $permanent,
|
|
'failed_login_attempts' => 0,
|
|
])->save();
|
|
|
|
return $lockedUntil;
|
|
}
|
|
|
|
/**
|
|
* 사용자의 모든 로그인 시도 추적 컬럼을 초기화합니다.
|
|
*
|
|
* 멱등 — 모든 컬럼이 이미 초기 상태면 UPDATE 를 발행하지 않습니다.
|
|
*
|
|
* @param User $user 대상 사용자
|
|
*/
|
|
public function resetLoginAttempts(User $user): void
|
|
{
|
|
$needsReset = ($user->failed_login_attempts ?? 0) > 0
|
|
|| $user->locked_until !== null
|
|
|| (bool) $user->locked_permanently
|
|
|| $user->last_failed_login_at !== null;
|
|
|
|
if (! $needsReset) {
|
|
return;
|
|
}
|
|
|
|
// locked_permanently 를 빠뜨리면 성공 로그인·관리자 해제 후에도 영구 잠금이 잔존한다.
|
|
$user->forceFill([
|
|
'failed_login_attempts' => 0,
|
|
'locked_until' => null,
|
|
'locked_permanently' => false,
|
|
'last_failed_login_at' => null,
|
|
])->save();
|
|
}
|
|
|
|
/**
|
|
* 사용자의 계정이 현재 시점에 잠금 상태인지 판정합니다.
|
|
*
|
|
* @param User $user 대상 사용자
|
|
* @return bool 잠금 여부
|
|
*/
|
|
public function isLocked(User $user): bool
|
|
{
|
|
// 영구 잠금 판정이 먼저 — 해제 시각이 없으므로 NULL 체크에 먼저 걸리면 안 된다.
|
|
if ((bool) $user->locked_permanently) {
|
|
return true;
|
|
}
|
|
|
|
if ($user->locked_until === null) {
|
|
return false;
|
|
}
|
|
|
|
return $user->locked_until->isFuture();
|
|
}
|
|
|
|
/**
|
|
* UUID 로 사용자를 찾습니다.
|
|
*
|
|
* @param string $uuid 사용자 UUID
|
|
* @return User|null 찾은 사용자 모델 또는 null
|
|
*/
|
|
public function findByUuid(string $uuid): ?User
|
|
{
|
|
return User::where('uuid', $uuid)->first();
|
|
}
|
|
|
|
/**
|
|
* UUID 목록에 해당하는 사용자의 정수 ID 배열을 반환합니다.
|
|
*
|
|
* @param array $uuids 사용자 UUID 배열
|
|
* @return array<int, int> 사용자 ID 배열
|
|
*/
|
|
public function getIdsByUuids(array $uuids): array
|
|
{
|
|
if (empty($uuids)) {
|
|
return [];
|
|
}
|
|
|
|
return User::whereIn('uuid', $uuids)->pluck('id')->all();
|
|
}
|
|
|
|
/**
|
|
* 사용자 ID 목록의 지정 컬럼을 일괄 갱신합니다.
|
|
*
|
|
* @param array $ids 사용자 ID 배열
|
|
* @param array $data 갱신할 컬럼 값
|
|
* @return int 갱신된 행 수
|
|
*/
|
|
public function updateManyByIds(array $ids, array $data): int
|
|
{
|
|
if (empty($ids)) {
|
|
return 0;
|
|
}
|
|
|
|
return User::whereIn('id', $ids)->update($data);
|
|
}
|
|
|
|
/**
|
|
* 사용자 ID 목록의 인증 토큰을 모두 삭제합니다.
|
|
*
|
|
* @param array $ids 사용자 ID 배열
|
|
* @return int 삭제된 토큰 수
|
|
*/
|
|
public function deleteTokensByUserIds(array $ids): int
|
|
{
|
|
if (empty($ids)) {
|
|
return 0;
|
|
}
|
|
|
|
return PersonalAccessToken::where('tokenable_type', User::class)
|
|
->whereIn('tokenable_id', $ids)
|
|
->delete();
|
|
}
|
|
}
|