perf(core): 대용량 목록 상한 총 건수·커서 계약 신설 및 요청당 반복 실행 비용 정리
공개 이슈 gnuboard/g7 이 지목한 병목은 "같은 일을 반복 실행한다" 축이다. 응답·행의 무게를 다룬 · 과 겹치지 않는다. 공통 계약 — 총 건수 상한과 페이지 이동 범위는 별개 결정이다. 묶으면 필요 없이 기능이 깎인다. 총 건수만 상한을 받고(파생 테이블 COUNT), "다음" 이동은 per_page + 1 실측으로 끝까지 열어 둔다. 계산이 불가능해지는 것은 마지막 페이지 번호 하나뿐이며 그 사실은 last_page: null 이 알린다. 최신순처럼 실제 컬럼으로 정렬하는 목록은 커서로 전환해 깊이와 무관하게 일정 속도로 이동한다. 관련도순은 계산값 정렬이라 커서 키로 쓸 수 없어 offset 을 유지한다. 계약의 입구는 표준 paginate 와 같은 폭이어야 한다. 관계·쿼리 빌더를 받지 못하면 그 좁은 만큼이 그대로 운영 500 이 되고, 실제로 관리자 알림 목록에서 그렇게 터졌다. 응답 조립도 컬렉션마다 손으로 하면 형태가 늘어나는 순간 없는 값을 부르거나 새 필드를 흘리므로, 형태 판정을 paginationMeta 한 곳에 모았다. 표준 paginate 응답은 필드 단위로 이전과 동일하다. 요청당 반복 비용 — 훅 구독마다 남기던 로그 400줄, 요청당 스무 번 넘던 설정 파일 재읽기, 이미 캐시된 목록의 DB 재조회를 없앴다. 권한 판정은 요청 스코프 메모를 두어 화면 요소마다 나가던 조회를 한 번으로 줄였고, 크로스 요청 캐시는 두지 않아 권한 변경이 종전처럼 다음 요청에 반영된다. 검색 질의는 활성 엔진이 만든다. 저장소가 구체 엔진을 지목하면 플러그인이 등록한 엔진은 호출될 기회 자체를 잃고 오류 없이 다른 방식으로 동작한다. 해석기를 두어 활성 엔진에 위임하고, 전문검색이 없는 DBMS 의 부분일치 폴백도 드라이버명 하드코딩 대신 선언형 config 로 옮겼다. 총 건수가 잘린 목록에서 순번을 역산하면 0 과 음수가 나온다. 지어내지 않고 null 을 돌려주며, 그 원칙을 last_page 와 동일하게 적용했다.
This commit is contained in:
1 parent
97ab99b7cd
commit
2ae1972a3b
101 files changed
+6160
-322
No files matched your search
@@ -2,6 +2,7 @@
|
||||
|
||||
namespace App\Http\Controllers\Api\Base;
|
||||
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Support\Facades\Log;
|
||||
|
||||
/**
|
||||
@@ -21,7 +22,7 @@ abstract class AuthBaseController extends BaseApiController
|
||||
/**
|
||||
* 사용자 소유권을 확인합니다.
|
||||
*
|
||||
* @param int $userId 확인할 사용자 ID
|
||||
* @param int $userId 확인할 사용자 ID
|
||||
* @return bool
|
||||
*/
|
||||
protected function isOwner(int $userId): bool
|
||||
@@ -32,7 +33,7 @@ abstract class AuthBaseController extends BaseApiController
|
||||
/**
|
||||
* 사용자가 특정 리소스에 접근할 수 있는지 확인합니다.
|
||||
*
|
||||
* @param mixed $resource 접근하려는 리소스
|
||||
* @param mixed $resource 접근하려는 리소스
|
||||
* @return bool
|
||||
*/
|
||||
protected function canAccessResource($resource): bool
|
||||
@@ -48,8 +49,8 @@ abstract class AuthBaseController extends BaseApiController
|
||||
/**
|
||||
* 사용자 활동을 기록합니다.
|
||||
*
|
||||
* @param string $action 수행한 작업
|
||||
* @param array $data 관련 데이터
|
||||
* @param string $action 수행한 작업
|
||||
* @param array $data 관련 데이터
|
||||
* @return void
|
||||
*/
|
||||
protected function logUserActivity(string $action, array $data = []): void
|
||||
@@ -58,20 +59,20 @@ abstract class AuthBaseController extends BaseApiController
|
||||
Log::info("User Activity: {$action}", [
|
||||
'user_id' => $this->getCurrentUser()?->uuid,
|
||||
'data' => $data,
|
||||
'timestamp' => now()
|
||||
'timestamp' => now(),
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 리소스 소유권을 확인하고, 소유자가 아니면 Forbidden 응답을 반환합니다.
|
||||
*
|
||||
* @param mixed $resource 확인할 리소스
|
||||
* @param string $messageKey 오류 메시지 키
|
||||
* @return \Illuminate\Http\JsonResponse|null 소유자이면 null, 아니면 Forbidden 응답
|
||||
* @param mixed $resource 확인할 리소스
|
||||
* @param string $messageKey 오류 메시지 키
|
||||
* @return JsonResponse|null 소유자이면 null, 아니면 Forbidden 응답
|
||||
*/
|
||||
protected function checkOwnership($resource, string $messageKey = 'common.forbidden')
|
||||
{
|
||||
if (!$this->canAccessResource($resource)) {
|
||||
if (! $this->canAccessResource($resource)) {
|
||||
return $this->forbidden($messageKey);
|
||||
}
|
||||
|
||||
@@ -81,14 +82,21 @@ abstract class AuthBaseController extends BaseApiController
|
||||
/**
|
||||
* API 사용량을 기록합니다.
|
||||
*
|
||||
* @param string $endpoint 엔드포인트
|
||||
* @param array $data 관련 데이터
|
||||
* @param string $endpoint 엔드포인트
|
||||
* @param array $data 관련 데이터
|
||||
* @return void
|
||||
*/
|
||||
protected function logApiUsage(string $endpoint, array $data = []): void
|
||||
{
|
||||
// TODO: API 사용량 통계 시스템 구현
|
||||
Log::info("Auth API Usage: {$endpoint}", [
|
||||
//
|
||||
// PublicBaseController 와 같은 이유로 디버그 모드에서만 기록한다.
|
||||
// 통계 시스템이 서기 전까지 요청마다 로그 파일에 줄을 쌓지 않는다.
|
||||
if (! config('app.debug')) {
|
||||
return;
|
||||
}
|
||||
|
||||
Log::debug("Auth API Usage: {$endpoint}", [
|
||||
'user_id' => $this->getCurrentUser()?->uuid,
|
||||
'ip' => request()->ip(),
|
||||
'user_agent' => request()->userAgent(),
|
||||
|
||||
@@ -3,9 +3,7 @@
|
||||
namespace App\Http\Controllers\Api\Base;
|
||||
|
||||
use App\Contracts\Extension\CacheInterface;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Support\Facades\Log;
|
||||
use Symfony\Component\HttpFoundation\BinaryFileResponse;
|
||||
|
||||
/**
|
||||
* 공개 API용 베이스 컨트롤러
|
||||
@@ -27,9 +25,9 @@ abstract class PublicBaseController extends BaseApiController
|
||||
* 이는 확장 설치 직후·활성화 전 등의 일시적 상태에서 얻은 "not found" 같은
|
||||
* 에러 응답이 영구 캐시되어 복구 후에도 잘못된 응답을 반환하는 문제를 방지한다.
|
||||
*
|
||||
* @param string $key 캐시 키
|
||||
* @param callable $callback 데이터 생성 콜백
|
||||
* @param int $ttl 캐시 유지 시간 (초)
|
||||
* @param string $key 캐시 키
|
||||
* @param callable $callback 데이터 생성 콜백
|
||||
* @param int $ttl 캐시 유지 시간 (초)
|
||||
* @return mixed
|
||||
*/
|
||||
protected function cached(string $key, callable $callback, int $ttl = 3600)
|
||||
@@ -54,18 +52,27 @@ abstract class PublicBaseController extends BaseApiController
|
||||
/**
|
||||
* API 사용량을 기록합니다.
|
||||
*
|
||||
* @param string $endpoint 엔드포인트
|
||||
* @param array $data 관련 데이터
|
||||
* @param string $endpoint 엔드포인트
|
||||
* @param array $data 관련 데이터
|
||||
* @return void
|
||||
*/
|
||||
protected function logApiUsage(string $endpoint, array $data = []): void
|
||||
{
|
||||
// TODO: API 사용량 통계 시스템 구현
|
||||
Log::info("Public API Usage: {$endpoint}", [
|
||||
//
|
||||
// 호출 지점은 레이아웃·확장 번들·정적 자산처럼 페이지 로드마다 여러 번 열리는
|
||||
// 공개 엔드포인트다. 통계 시스템이 서기 전까지 이 자리가 요청마다 로그 파일에
|
||||
// 줄을 쌓지 않도록, 디버그 모드에서만 기록한다. 기본 설치는 APP_DEBUG=false 이므로
|
||||
// 아무것도 쓰지 않는다.
|
||||
if (! config('app.debug')) {
|
||||
return;
|
||||
}
|
||||
|
||||
Log::debug("Public API Usage: {$endpoint}", [
|
||||
'ip' => request()->ip(),
|
||||
'user_agent' => request()->userAgent(),
|
||||
'data' => $data,
|
||||
'timestamp' => now()
|
||||
'timestamp' => now(),
|
||||
]);
|
||||
}
|
||||
|
||||
@@ -80,8 +87,7 @@ abstract class PublicBaseController extends BaseApiController
|
||||
'ip' => request()->ip(),
|
||||
'user_agent' => request()->userAgent(),
|
||||
'referer' => request()->header('referer'),
|
||||
'timestamp' => now()
|
||||
'timestamp' => now(),
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
@@ -2,9 +2,11 @@
|
||||
|
||||
namespace App\Http\Controllers\Api\Public;
|
||||
|
||||
use App\Enums\TotalRelation;
|
||||
use App\Extension\HookManager;
|
||||
use App\Http\Controllers\Api\Base\PublicBaseController;
|
||||
use App\Http\Requests\Public\SearchRequest;
|
||||
use App\Support\Query\PaginationLimits;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
|
||||
/**
|
||||
@@ -18,7 +20,7 @@ class PublicSearchController extends PublicBaseController
|
||||
/**
|
||||
* 통합 검색 수행
|
||||
*
|
||||
* @param SearchRequest $request HTTP 요청
|
||||
* @param SearchRequest $request HTTP 요청
|
||||
* @return JsonResponse 검색 결과
|
||||
*/
|
||||
public function search(SearchRequest $request): JsonResponse
|
||||
@@ -36,6 +38,14 @@ class PublicSearchController extends PublicBaseController
|
||||
return $this->success(__('search.empty_keyword'), $this->buildEmptyResponse());
|
||||
}
|
||||
|
||||
// 특정 탭을 보는 중이라면, 다른 탭의 배지 건수를 아예 세지 않을 수 있다.
|
||||
// 기본값은 세는 쪽이다 — 탭 배지가 화면 요소라 끄면 숫자가 사라진다. 다만 배지가
|
||||
// 필요 없는 화면(더 보기 페이지 등)은 with_counts=false 로 그 비용을 없앤다.
|
||||
// 전체 탭은 배지가 화면의 주 정보라 이 값과 무관하게 항상 센다.
|
||||
$includeInactiveCounts = $type === 'all'
|
||||
? true
|
||||
: $request->boolean('with_counts', true);
|
||||
|
||||
// 검색 컨텍스트 구성 (모듈별 파라미터는 request 전체를 전달하여 각 모듈이 직접 처리)
|
||||
$context = [
|
||||
'q' => $q,
|
||||
@@ -44,6 +54,10 @@ class PublicSearchController extends PublicBaseController
|
||||
'page' => $page,
|
||||
'per_page' => $perPage,
|
||||
'all_tab_limit' => 5,
|
||||
// 커서는 특정 탭을 볼 때만 의미가 있다. 전체 탭은 카테고리마다 몇 건씩만
|
||||
// 보여 주므로 깊은 페이지 자체가 없고, 카테고리별 커서를 하나로 합칠 수도 없다.
|
||||
'cursor' => $type === 'all' ? null : ($validated['cursor'] ?? null),
|
||||
'include_inactive_counts' => $includeInactiveCounts,
|
||||
'user' => $request->user(),
|
||||
'request' => $request,
|
||||
];
|
||||
@@ -56,8 +70,14 @@ class PublicSearchController extends PublicBaseController
|
||||
// 프론트엔드용 응답 구조로 변환 (훅을 통해 모듈이 처리)
|
||||
$response = $this->buildResponse($q, $results, $context);
|
||||
|
||||
// 총 건수가 상한에 걸렸으면 "N건" 이 아니라 "N건 이상" 으로 알린다.
|
||||
// 세지 않은 값을 정확한 것처럼 말하지 않는다.
|
||||
$messageKey = ($response['total_is_exact'] ?? true)
|
||||
? 'search.results_found'
|
||||
: 'search.results_found_at_least';
|
||||
|
||||
return $this->success(
|
||||
__('search.results_found', ['count' => number_format($response['total'])]),
|
||||
__($messageKey, ['count' => number_format($response['total'])]),
|
||||
$response
|
||||
);
|
||||
}
|
||||
@@ -72,6 +92,9 @@ class PublicSearchController extends PublicBaseController
|
||||
return [
|
||||
'q' => '',
|
||||
'total' => 0,
|
||||
'total_relation' => TotalRelation::Exact->value,
|
||||
'total_is_exact' => true,
|
||||
'result_cap' => null,
|
||||
];
|
||||
}
|
||||
|
||||
@@ -81,9 +104,9 @@ class PublicSearchController extends PublicBaseController
|
||||
* 코어는 기본 응답 구조만 생성하고,
|
||||
* 각 모듈이 core.search.build_response 훅을 통해 자신의 카테고리 응답을 구성합니다.
|
||||
*
|
||||
* @param string $q 검색어
|
||||
* @param array $results Hook에서 반환된 검색 결과
|
||||
* @param array $context 검색 컨텍스트
|
||||
* @param string $q 검색어
|
||||
* @param array $results Hook에서 반환된 검색 결과
|
||||
* @param array $context 검색 컨텍스트
|
||||
* @return array 프론트엔드용 응답 구조
|
||||
*/
|
||||
private function buildResponse(string $q, array $results, array $context): array
|
||||
@@ -97,8 +120,15 @@ class PublicSearchController extends PublicBaseController
|
||||
// 모듈은 $results에서 자신의 데이터를 가져와 $response에 추가
|
||||
$response = HookManager::applyFilters('core.search.build_response', $response, $results, $context);
|
||||
|
||||
// 전체 합계를 항상 보존 (탭 UI에서 전체 건수 표시용)
|
||||
// 전체 합계를 항상 보존 (탭 UI에서 전체 건수 표시용).
|
||||
// "전체" 탭 배지도 잘린 합계인지 알아야 하므로 정확도를 함께 붙인다.
|
||||
$response['all_count'] = $response['total'];
|
||||
$response['all_count_is_exact'] = $this->resolveTotalAccuracy($results)['total_is_exact'];
|
||||
|
||||
// 탭 배지는 카테고리마다 하나씩 그려지므로 정확도도 카테고리마다 필요하다.
|
||||
// 모듈이 각자 자기 키를 내보내면 어떤 배지는 정확도를 받고 어떤 배지는 못 받아,
|
||||
// 상한에 걸린 숫자가 그 배지에서만 정확한 값처럼 보인다. 코어가 일괄로 붙인다.
|
||||
$response['counts_are_exact'] = $this->resolveCategoryAccuracy($results);
|
||||
|
||||
// 특정 탭 조회 시 total을 해당 탭의 count로 설정
|
||||
$type = $context['type'] ?? 'all';
|
||||
@@ -109,13 +139,14 @@ class PublicSearchController extends PublicBaseController
|
||||
}
|
||||
}
|
||||
|
||||
return $response;
|
||||
// 정확도 메타 — 전체 탭은 카테고리 합집합, 특정 탭은 그 카테고리 하나만 본다.
|
||||
return array_merge($response, $this->resolveTotalAccuracy($results, $type));
|
||||
}
|
||||
|
||||
/**
|
||||
* 전체 검색 결과 수 계산
|
||||
*
|
||||
* @param array $results Hook에서 반환된 검색 결과
|
||||
* @param array $results Hook에서 반환된 검색 결과
|
||||
* @return int 전체 결과 수
|
||||
*/
|
||||
private function calculateTotal(array $results): int
|
||||
@@ -127,4 +158,60 @@ class PublicSearchController extends PublicBaseController
|
||||
|
||||
return $total;
|
||||
}
|
||||
|
||||
/**
|
||||
* 카테고리별 총 건수 정확도를 모읍니다.
|
||||
*
|
||||
* 탭 배지는 카테고리 수만큼 그려지므로 정확도도 그 수만큼 있어야 합니다. 하나라도
|
||||
* 빠지면 그 배지에서만 상한에 걸린 숫자가 정확한 값처럼 보이고, 오류로는 드러나지
|
||||
* 않은 채 그냥 틀린 숫자로 남습니다.
|
||||
*
|
||||
* @param array $results Hook에서 반환된 검색 결과
|
||||
* @return array<string, bool> 카테고리 => 정확 여부
|
||||
*/
|
||||
private function resolveCategoryAccuracy(array $results): array
|
||||
{
|
||||
$accuracy = [];
|
||||
|
||||
foreach ($results as $category => $categoryData) {
|
||||
$accuracy[$category] = ($categoryData['total_is_exact'] ?? true) === true;
|
||||
}
|
||||
|
||||
return $accuracy;
|
||||
}
|
||||
|
||||
/**
|
||||
* 응답 전체의 총 건수 정확도를 정합니다.
|
||||
*
|
||||
* 전체 탭에서는 카테고리 중 하나라도 상한에 걸리면 합계도 "이상" 이다 — 정확한
|
||||
* 카테고리 몇 개를 더해 봐야 전체가 정확해지지 않는다.
|
||||
*
|
||||
* 특정 탭을 보는 중이면 `total` 이 그 카테고리 건수로 바뀌므로 정확도도 그 카테고리
|
||||
* 하나만 본다. 다른 카테고리가 잘렸다는 이유로 정확한 값을 "이상" 이라 말하지 않는다.
|
||||
*
|
||||
* @param array $results Hook에서 반환된 검색 결과
|
||||
* @param string $type 조회 탭 (all 이면 전체 합계)
|
||||
* @return array{total_relation: string, total_is_exact: bool, result_cap: int|null} 정확도 메타
|
||||
*/
|
||||
private function resolveTotalAccuracy(array $results, string $type = 'all'): array
|
||||
{
|
||||
$scoped = ($type !== 'all' && array_key_exists($type, $results))
|
||||
? [$results[$type]]
|
||||
: $results;
|
||||
|
||||
$isExact = true;
|
||||
|
||||
foreach ($scoped as $categoryData) {
|
||||
if (($categoryData['total_is_exact'] ?? true) === false) {
|
||||
$isExact = false;
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
return [
|
||||
'total_relation' => $isExact ? TotalRelation::Exact->value : TotalRelation::AtLeast->value,
|
||||
'total_is_exact' => $isExact,
|
||||
'result_cap' => PaginationLimits::resultCap('search'),
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -6,6 +6,7 @@ use App\Enums\PermissionType;
|
||||
use App\Helpers\PermissionHelper;
|
||||
use App\Helpers\ResponseHelper;
|
||||
use App\Models\Role;
|
||||
use App\Support\GuestRoleResolver;
|
||||
use Closure;
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
use Illuminate\Http\Request;
|
||||
@@ -14,13 +15,6 @@ use Symfony\Component\HttpFoundation\Response;
|
||||
|
||||
class PermissionMiddleware
|
||||
{
|
||||
/**
|
||||
* guest role 캐시
|
||||
*
|
||||
* @var Role|null
|
||||
*/
|
||||
protected static $guestRoleCache = null;
|
||||
|
||||
/**
|
||||
* 특정 권한을 가진 사용자 또는 비회원(guest)의 접근을 허용합니다.
|
||||
*
|
||||
@@ -125,10 +119,9 @@ class PermissionMiddleware
|
||||
return false;
|
||||
}
|
||||
|
||||
return $guestRole->permissions()
|
||||
->where('identifier', $permission)
|
||||
->where('type', $type)
|
||||
->exists();
|
||||
// 적재해 둔 권한 컬렉션에서 판정한다. permissions() 로 빌더를 다시 열면
|
||||
// 캐시해 둔 의미가 사라져 판정마다 쿼리가 나간다.
|
||||
return GuestRoleResolver::hasPermission($permission, $type);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -138,13 +131,7 @@ class PermissionMiddleware
|
||||
*/
|
||||
protected function getGuestRole(): ?Role
|
||||
{
|
||||
if (self::$guestRoleCache === null) {
|
||||
self::$guestRoleCache = Role::where('identifier', 'guest')
|
||||
->with('permissions')
|
||||
->first();
|
||||
}
|
||||
|
||||
return self::$guestRoleCache;
|
||||
return GuestRoleResolver::resolve();
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -158,7 +145,7 @@ class PermissionMiddleware
|
||||
*/
|
||||
public static function clearGuestRoleCache(): void
|
||||
{
|
||||
self::$guestRoleCache = null;
|
||||
GuestRoleResolver::flush();
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@@ -47,6 +47,10 @@ class ActivityLogIndexRequest extends FormRequest
|
||||
// 조용히 기본 정렬로 되돌리지 않도록 한다 (service-repository.md "정렬 컬럼 화이트리스트").
|
||||
'sort_by' => ['nullable', 'string', Rule::in(['created_at', 'action', 'log_type'])],
|
||||
'sort_order' => ['nullable', 'string', Rule::in(['asc', 'desc'])],
|
||||
// 커서를 주면 목록이 키셋 방식으로 응답한다. 로그는 계속 쌓이기만 하므로 깊은
|
||||
// 페이지를 OFFSET 으로 훑으면 건너뛸 행을 실제로 읽어야 한다.
|
||||
// 형식이 깨진 값은 KeysetPaginator 가 첫 페이지로 되돌리므로 여기서는 길이만 본다.
|
||||
'cursor' => ['nullable', 'string', 'max:500'],
|
||||
];
|
||||
|
||||
return HookManager::applyFilters('core.activity_log.index_validation_rules', $rules, $this);
|
||||
|
||||
@@ -40,6 +40,10 @@ class NotificationLogIndexRequest extends FormRequest
|
||||
// 게이트가 더 좁으면 화면 정렬 셀렉트가 제공하는 옵션(수신자명순/제목순)이 422 로 막힌다.
|
||||
'sort_by' => ['nullable', 'string', 'in:id,channel,notification_type,status,sent_at,created_at,recipient_name,subject'],
|
||||
'sort_order' => ['nullable', 'string', 'in:asc,desc'],
|
||||
// 커서를 주면 목록이 키셋 방식으로 응답한다. 로그는 계속 쌓이기만 하므로 깊은
|
||||
// 페이지를 OFFSET 으로 훑으면 건너뛸 행을 실제로 읽어야 한다.
|
||||
// 형식이 깨진 값은 KeysetPaginator 가 첫 페이지로 되돌리므로 여기서는 길이만 본다.
|
||||
'cursor' => ['nullable', 'string', 'max:500'],
|
||||
];
|
||||
|
||||
return HookManager::applyFilters(
|
||||
|
||||
@@ -3,6 +3,8 @@
|
||||
namespace App\Http\Requests\Public;
|
||||
|
||||
use App\Extension\HookManager;
|
||||
use App\Support\Query\PaginationLimits;
|
||||
use Illuminate\Contracts\Validation\ValidationRule;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
/**
|
||||
@@ -23,10 +25,30 @@ class SearchRequest extends FormRequest
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* 검증 전에 쿼리 파라미터를 정규화합니다.
|
||||
*
|
||||
* 쿼리스트링은 언제나 문자열로 도착하므로 `with_counts=false` 가 `boolean` 규칙에
|
||||
* 걸려 422 가 된다. 해석 가능한 값만 캐스팅하고, 그 외(오타 등)는 손대지 않아
|
||||
* 규칙이 그대로 걸러내게 둔다 — null 로 바꾸면 오타가 "미지정" 으로 통과한다.
|
||||
*/
|
||||
protected function prepareForValidation(): void
|
||||
{
|
||||
if (! $this->has('with_counts')) {
|
||||
return;
|
||||
}
|
||||
|
||||
$normalized = filter_var($this->input('with_counts'), FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
|
||||
|
||||
if ($normalized !== null) {
|
||||
$this->merge(['with_counts' => $normalized]);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the validation rules that apply to the request.
|
||||
*
|
||||
* @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
|
||||
* @return array<string, ValidationRule|array<mixed>|string>
|
||||
*/
|
||||
public function rules(): array
|
||||
{
|
||||
@@ -35,8 +57,21 @@ class SearchRequest extends FormRequest
|
||||
'q' => ['nullable', 'string', 'min:2', 'max:200'],
|
||||
'type' => ['nullable', 'string'],
|
||||
'sort' => ['nullable', 'string'],
|
||||
'page' => ['nullable', 'integer', 'min:1'],
|
||||
// 페이지 상한은 남용 차단용이다. 정상 탐색은 has_more_pages 로 계속 열려 있고,
|
||||
// 임의의 큰 페이지 번호를 직접 던져 초대형 OFFSET 을 만드는 것만 막는다.
|
||||
'page' => array_filter([
|
||||
'nullable',
|
||||
'integer',
|
||||
'min:1',
|
||||
($maxPage = PaginationLimits::maxPage('search')) !== null ? 'max:'.$maxPage : null,
|
||||
]),
|
||||
'per_page' => ['nullable', 'integer', 'min:1', 'max:100'],
|
||||
// 깊은 페이지를 OFFSET 없이 넘기기 위한 커서. 형식이 깨진 값은
|
||||
// KeysetPaginator 가 첫 페이지로 되돌리므로 여기서는 길이만 본다.
|
||||
'cursor' => ['nullable', 'string', 'max:500'],
|
||||
// 특정 탭만 볼 때 다른 탭의 배지 건수를 세지 않게 하는 스위치.
|
||||
// 배지를 그리지 않는 화면에서 그 집계 비용을 없앤다 (기본값은 세는 쪽).
|
||||
'with_counts' => ['nullable', 'boolean'],
|
||||
];
|
||||
|
||||
// 모듈/플러그인이 validation rules를 동적으로 추가할 수 있도록 훅 제공
|
||||
@@ -59,6 +94,7 @@ class SearchRequest extends FormRequest
|
||||
'q.max' => __('search.validation.q_max'),
|
||||
'page.integer' => __('search.validation.page_integer'),
|
||||
'page.min' => __('search.validation.page_min'),
|
||||
'page.max' => __('search.validation.page_max'),
|
||||
'per_page.integer' => __('search.validation.per_page_integer'),
|
||||
'per_page.min' => __('search.validation.per_page_min'),
|
||||
'per_page.max' => __('search.validation.per_page_max'),
|
||||
|
||||
@@ -308,6 +308,10 @@ class SaveSettingsRequest extends FormRequest
|
||||
'advanced.geoip_license_key' => ['nullable', 'string', 'max:200', 'regex:/^[A-Za-z0-9_]+$/'],
|
||||
'advanced.geoip_auto_update_enabled' => ['nullable', 'boolean'],
|
||||
|
||||
// 목록 한계값 (advanced 탭) — 0 은 무제한
|
||||
'advanced.pagination_result_cap' => ['nullable', 'integer', 'min:'.config('core.settings_limits.advanced_pagination_result_cap_min', 0), 'max:'.config('core.settings_limits.advanced_pagination_result_cap_max', 1000000)],
|
||||
'advanced.pagination_max_page' => ['nullable', 'integer', 'min:'.config('core.settings_limits.advanced_pagination_max_page_min', 0), 'max:'.config('core.settings_limits.advanced_pagination_max_page_max', 100000)],
|
||||
|
||||
// 드라이버 설정 (drivers 탭)
|
||||
'drivers.storage_driver' => $this->getTabRules($tab, 'drivers', [Rule::in(self::SUPPORTED_STORAGE_DRIVERS)]),
|
||||
'drivers.s3_bucket' => ['nullable', 'string', 'max:255'],
|
||||
@@ -713,6 +717,14 @@ class SaveSettingsRequest extends FormRequest
|
||||
'advanced.sql_query_log.required' => __('validation.settings.sql_query_log_required'),
|
||||
'advanced.sql_query_log.boolean' => __('validation.settings.sql_query_log_boolean'),
|
||||
|
||||
// 목록 한계값
|
||||
'advanced.pagination_result_cap.integer' => __('validation.settings.pagination_result_cap_integer'),
|
||||
'advanced.pagination_result_cap.min' => __('validation.settings.pagination_result_cap_min'),
|
||||
'advanced.pagination_result_cap.max' => __('validation.settings.pagination_result_cap_max'),
|
||||
'advanced.pagination_max_page.integer' => __('validation.settings.pagination_max_page_integer'),
|
||||
'advanced.pagination_max_page.min' => __('validation.settings.pagination_max_page_min'),
|
||||
'advanced.pagination_max_page.max' => __('validation.settings.pagination_max_page_max'),
|
||||
|
||||
// 코어 업데이트 설정
|
||||
'advanced.core_update_github_url.url' => __('validation.settings.core_update_github_url_invalid'),
|
||||
'advanced.core_update_github_url.max' => __('validation.settings.core_update_github_url_max'),
|
||||
|
||||
@@ -3,7 +3,6 @@
|
||||
namespace App\Http\Resources;
|
||||
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Pagination\LengthAwarePaginator;
|
||||
|
||||
/**
|
||||
* 활동 로그 컬렉션 리소스
|
||||
@@ -36,15 +35,10 @@ class ActivityLogCollection extends BaseApiCollection
|
||||
'data' => $this->mapWithRowNumber(function ($activityLog) {
|
||||
return (new ActivityLogResource($activityLog))->toArray(request());
|
||||
}),
|
||||
'pagination' => $this->resource instanceof LengthAwarePaginator ? [
|
||||
'current_page' => $this->resource->currentPage(),
|
||||
'last_page' => $this->resource->lastPage(),
|
||||
'per_page' => $this->resource->perPage(),
|
||||
'total' => $this->resource->total(),
|
||||
'from' => $this->resource->firstItem(),
|
||||
'to' => $this->resource->lastItem(),
|
||||
'has_more_pages' => $this->resource->hasMorePages(),
|
||||
] : null,
|
||||
// 메타를 손으로 조립하면 정확도 필드(total_relation·total_is_exact·result_cap)가
|
||||
// 빠진다. 그러면 상한에 걸려 잘린 건수가 화면에서 정확한 값처럼 읽힌다
|
||||
// (실측: 실제 88,792 건이 "10000건" 으로 표기). 표준 메타 한 곳만 쓴다.
|
||||
...$this->paginationMeta(),
|
||||
...($abilities ? ['abilities' => $abilities] : []),
|
||||
];
|
||||
}
|
||||
|
||||
@@ -36,15 +36,8 @@ class IdentityMessageDefinitionCollection extends BaseApiCollection
|
||||
'data' => $this->mapWithRowNumber(function ($definition) use ($request) {
|
||||
return (new IdentityMessageDefinitionResource($definition))->toArray($request);
|
||||
}, $sortOrder),
|
||||
'pagination' => [
|
||||
'current_page' => $this->currentPage(),
|
||||
'last_page' => $this->lastPage(),
|
||||
'per_page' => $this->perPage(),
|
||||
'total' => $this->total(),
|
||||
'from' => $this->firstItem(),
|
||||
'to' => $this->lastItem(),
|
||||
'has_more_pages' => $this->hasMorePages(),
|
||||
],
|
||||
// 표준 메타를 쓴다 — 페이지 결과의 형태를 스스로 판정해 그 형태가 아는 값만 낸다.
|
||||
...$this->paginationMeta(),
|
||||
...($abilities ? ['abilities' => $abilities] : []),
|
||||
];
|
||||
}
|
||||
|
||||
@@ -2,10 +2,14 @@
|
||||
|
||||
namespace App\Http\Resources;
|
||||
|
||||
use App\Contracts\Pagination\BoundedTotalAware;
|
||||
use App\Helpers\PermissionHelper;
|
||||
use App\Http\Resources\Traits\HasRowNumber;
|
||||
use App\Support\Query\BoundedPage;
|
||||
use Illuminate\Contracts\Pagination\LengthAwarePaginator as LengthAwarePaginatorContract;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Http\Resources\Json\ResourceCollection;
|
||||
use Illuminate\Pagination\CursorPaginator;
|
||||
|
||||
/**
|
||||
* API 컬렉션 리소스 기본 클래스
|
||||
@@ -61,24 +65,71 @@ abstract class BaseApiCollection extends ResourceCollection
|
||||
* 정확히 판정할 수 있도록 노출합니다. 전체 조회(get) 등 paginator 가 아닌
|
||||
* 경우에는 빈 배열을 반환하므로 toArray 에서 array_merge 로 안전하게 합칠 수 있습니다.
|
||||
*
|
||||
* 페이지 결과는 세 형태 중 하나이며, 형태를 스스로 판정해 그 형태가 실제로 아는
|
||||
* 값만 내보냅니다. 모르는 값을 0 이나 1 로 채우면 화면이 그것을 사실로 읽습니다.
|
||||
*
|
||||
* | 형태 | 예 | total | last_page | 추가 |
|
||||
* |---|---|---|---|---|
|
||||
* | 전체건수형 | `paginate()` | 정확 | 정확 | — |
|
||||
* | 상한형 | {@see BoundedPage} | 정확 또는 하한 | 하한이면 null | `total_relation` `total_is_exact` `result_cap` |
|
||||
* | 단순형 | `simplePaginate()` / `cursorPaginate()` | 없음 | 없음 | 커서면 `next_cursor` `prev_cursor` |
|
||||
*
|
||||
* 기존 필드는 하나도 제거하지 않으므로, 표준 `paginate()` 를 쓰는 기존 컬렉션의
|
||||
* 응답은 이전과 완전히 동일합니다.
|
||||
*
|
||||
* @return array<string, mixed> ['pagination' => [...]] 또는 빈 배열
|
||||
*/
|
||||
protected function paginationMeta(): array
|
||||
{
|
||||
if (! method_exists($this->resource, 'currentPage')) {
|
||||
$resource = $this->resource;
|
||||
|
||||
if ($resource instanceof CursorPaginator) {
|
||||
return ['pagination' => $this->cursorPaginationMeta($resource)];
|
||||
}
|
||||
|
||||
if (! method_exists($resource, 'currentPage')) {
|
||||
return [];
|
||||
}
|
||||
|
||||
$meta = [
|
||||
'current_page' => $resource->currentPage(),
|
||||
'per_page' => $resource->perPage(),
|
||||
'from' => $resource->firstItem(),
|
||||
'to' => $resource->lastItem(),
|
||||
'has_more_pages' => $resource->hasMorePages(),
|
||||
];
|
||||
|
||||
// 단순형(simplePaginate)은 총 건수를 아예 세지 않으므로 total/last_page 를 내보내지 않는다.
|
||||
if ($resource instanceof LengthAwarePaginatorContract) {
|
||||
$meta['last_page'] = $resource->lastPage();
|
||||
$meta['total'] = $resource->total();
|
||||
}
|
||||
|
||||
if ($resource instanceof BoundedTotalAware) {
|
||||
$meta['total_relation'] = $resource->totalRelation()->value;
|
||||
$meta['total_is_exact'] = $resource->totalRelation()->isExact();
|
||||
$meta['result_cap'] = $resource->resultCap();
|
||||
}
|
||||
|
||||
return ['pagination' => $meta];
|
||||
}
|
||||
|
||||
/**
|
||||
* 커서 페이지의 pagination 메타를 만듭니다.
|
||||
*
|
||||
* 커서 방식은 총 건수와 페이지 번호를 계산하지 않습니다. 대신 앞뒤 이동 커서를
|
||||
* 그대로 실어 보내며, 화면은 이 값으로 이전/다음 버튼을 만듭니다.
|
||||
*
|
||||
* @param CursorPaginator $resource 커서 페이지 결과
|
||||
* @return array<string, mixed> pagination 메타
|
||||
*/
|
||||
private function cursorPaginationMeta(CursorPaginator $resource): array
|
||||
{
|
||||
return [
|
||||
'pagination' => [
|
||||
'current_page' => $this->resource->currentPage(),
|
||||
'last_page' => $this->resource->lastPage(),
|
||||
'per_page' => $this->resource->perPage(),
|
||||
'total' => $this->resource->total(),
|
||||
'from' => $this->resource->firstItem(),
|
||||
'to' => $this->resource->lastItem(),
|
||||
'has_more_pages' => $this->resource->hasMorePages(),
|
||||
],
|
||||
'per_page' => $resource->perPage(),
|
||||
'has_more_pages' => $resource->hasMorePages(),
|
||||
'next_cursor' => $resource->nextCursor()?->encode(),
|
||||
'prev_cursor' => $resource->previousCursor()?->encode(),
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -19,7 +19,7 @@ class NotificationDefinitionCollection extends BaseApiCollection
|
||||
/**
|
||||
* 컬렉션을 배열로 변환합니다.
|
||||
*
|
||||
* @param Request $request
|
||||
* @param Request $request
|
||||
* @return array
|
||||
*/
|
||||
public function toArray(Request $request): array
|
||||
@@ -31,15 +31,8 @@ class NotificationDefinitionCollection extends BaseApiCollection
|
||||
'data' => $this->mapWithRowNumber(function ($definition) use ($request) {
|
||||
return (new NotificationDefinitionResource($definition))->toArray($request);
|
||||
}, $sortOrder),
|
||||
'pagination' => [
|
||||
'current_page' => $this->currentPage(),
|
||||
'last_page' => $this->lastPage(),
|
||||
'per_page' => $this->perPage(),
|
||||
'total' => $this->total(),
|
||||
'from' => $this->firstItem(),
|
||||
'to' => $this->lastItem(),
|
||||
'has_more_pages' => $this->hasMorePages(),
|
||||
],
|
||||
// 표준 메타를 쓴다 — 페이지 결과의 형태를 스스로 판정해 그 형태가 아는 값만 낸다.
|
||||
...$this->paginationMeta(),
|
||||
...($abilities ? ['abilities' => $abilities] : []),
|
||||
];
|
||||
}
|
||||
|
||||
@@ -19,7 +19,7 @@ class NotificationLogCollection extends BaseApiCollection
|
||||
/**
|
||||
* 컬렉션을 배열로 변환합니다.
|
||||
*
|
||||
* @param Request $request
|
||||
* @param Request $request
|
||||
* @return array
|
||||
*/
|
||||
public function toArray(Request $request): array
|
||||
@@ -31,15 +31,10 @@ class NotificationLogCollection extends BaseApiCollection
|
||||
'data' => $this->mapWithRowNumber(function ($log) use ($request) {
|
||||
return (new NotificationLogResource($log))->toArray($request);
|
||||
}, $sortOrder),
|
||||
'pagination' => [
|
||||
'current_page' => $this->resource->currentPage(),
|
||||
'last_page' => $this->resource->lastPage(),
|
||||
'per_page' => $this->resource->perPage(),
|
||||
'total' => $this->resource->total(),
|
||||
'from' => $this->resource->firstItem(),
|
||||
'to' => $this->resource->lastItem(),
|
||||
'has_more_pages' => $this->resource->hasMorePages(),
|
||||
],
|
||||
// 표준 메타를 쓴다. 이 목록은 커서 요청이면 CursorPaginator 로, 그 외에는 상한형
|
||||
// 페이지로 온다. 손으로 조립하면 커서 결과에 없는 total()/lastPage() 를 불러
|
||||
// 그 요청만 500 이 되고, 상한형에서는 정확도 메타가 빠진다.
|
||||
...$this->paginationMeta(),
|
||||
...($abilities ? ['abilities' => $abilities] : []),
|
||||
];
|
||||
}
|
||||
|
||||
@@ -2,6 +2,7 @@
|
||||
|
||||
namespace App\Http\Resources\Traits;
|
||||
|
||||
use App\Contracts\Pagination\BoundedTotalAware;
|
||||
use Illuminate\Pagination\LengthAwarePaginator;
|
||||
use Illuminate\Support\Collection;
|
||||
|
||||
@@ -57,7 +58,7 @@ trait HasRowNumber
|
||||
* @param int $total 전체 항목 수
|
||||
* @param int $perPage 페이지당 항목 수
|
||||
* @param int $currentPage 현재 페이지 번호
|
||||
* @return int 계산된 순번
|
||||
* @return int|null 계산된 순번 (총 건수가 잘린 내림차순이면 null)
|
||||
*/
|
||||
protected function calculateRowNumber(
|
||||
int $index,
|
||||
@@ -65,13 +66,22 @@ trait HasRowNumber
|
||||
int $total,
|
||||
int $perPage,
|
||||
int $currentPage
|
||||
): int {
|
||||
): ?int {
|
||||
if ($sortOrder === 'asc') {
|
||||
// 오름차순: 1, 2, 3, ... (페이지별 연속)
|
||||
// 예: 2페이지 → ((2-1) * 10) + 0 + 1 = 11, 12, 13, ...
|
||||
// offset 만으로 정해지므로 총 건수가 잘려도 그대로 정확하다.
|
||||
return (($currentPage - 1) * $perPage) + $index + 1;
|
||||
}
|
||||
|
||||
// 내림차순 순번은 "전체 몇 건 중 몇 번째" 라 총 건수를 알아야 나온다. 총 건수가
|
||||
// 상한에 걸려 잘렸으면 그 값으로 역산한 순번은 첫 페이지부터 이미 틀리고, 상한을
|
||||
// 넘어선 페이지에서는 0 과 음수까지 내려간다. 틀린 숫자를 내보내는 것보다
|
||||
// 내보내지 않는 편이 낫으므로 `last_page` 와 같은 원칙으로 null 을 돌려준다.
|
||||
if ($this->resource instanceof BoundedTotalAware && ! $this->resource->totalRelation()->isExact()) {
|
||||
return null;
|
||||
}
|
||||
|
||||
// 내림차순: total, total-1, ... (역순)
|
||||
// 예: 총 30개, 2페이지 → 30 - ((2-1) * 10) - 0 = 20, 19, 18, ...
|
||||
return $total - (($currentPage - 1) * $perPage) - $index;
|
||||
|
||||
@@ -5,14 +5,16 @@ namespace App\Http\Resources;
|
||||
use App\Contracts\Repositories\NotificationDefinitionRepositoryInterface;
|
||||
use Illuminate\Http\Request;
|
||||
|
||||
/**
|
||||
* 알림함 컬렉션
|
||||
*/
|
||||
class UserNotificationCollection extends BaseApiCollection
|
||||
{
|
||||
|
||||
/**
|
||||
* 컬렉션을 배열로 변환합니다.
|
||||
*
|
||||
* @param Request $request
|
||||
* @return array
|
||||
* @param Request $request HTTP 요청
|
||||
* @return array<string, mixed> 변환된 배열
|
||||
*/
|
||||
public function toArray(Request $request): array
|
||||
{
|
||||
@@ -29,15 +31,10 @@ class UserNotificationCollection extends BaseApiCollection
|
||||
->withTypeLabelMap($typeLabelMap)
|
||||
->toArray($request);
|
||||
}, $sortOrder),
|
||||
'pagination' => [
|
||||
'current_page' => $this->resource->currentPage(),
|
||||
'last_page' => $this->resource->lastPage(),
|
||||
'per_page' => $this->resource->perPage(),
|
||||
'total' => $this->resource->total(),
|
||||
'from' => $this->resource->firstItem(),
|
||||
'to' => $this->resource->lastItem(),
|
||||
'has_more_pages' => $this->resource->hasMorePages(),
|
||||
],
|
||||
// 표준 메타를 쓴다. 손으로 조립하면 페이지 결과의 형태(전체건수형/상한형/단순형)를
|
||||
// 구분하지 못해, 상한에 걸려 잘린 총 건수가 정확한 값처럼 나가고 마지막 페이지도
|
||||
// 계산할 수 없는데 숫자가 채워진다.
|
||||
...$this->paginationMeta(),
|
||||
];
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user