fix(core,board,ecommerce,page,gdpr,basic): 깊은 OFFSET 목록 조회 개선 및 raw/테이블명 전수 정리

목록이 뒤쪽 페이지로 갈수록 느려지는 원인은 건너뛰는 행의 넓은 컬럼까지 읽는 것이었다.
지연 조인(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인당 사용 제한 부분 수정 차단도 함께 수정.
This commit is contained in:
HeuJung committed 2026-08-02 14:36:37 +09:00
1 parent 95ffdf9eed
commit be9befe023
81 files changed
+5799 -457

No files matched your search

+41 -15
View File
@@ -3,15 +3,24 @@
namespace App\Repositories;
use App\Contracts\Repositories\MenuRepositoryInterface;
use App\Helpers\PermissionHelper;
use App\Enums\ExtensionOwnerType;
use App\Helpers\PermissionHelper;
use App\Models\Menu;
use App\Models\Module;
use App\Models\Plugin;
use App\Models\User;
use App\Repositories\Concerns\ResolvesSortSpec;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Support\Facades\DB;
class MenuRepository implements MenuRepositoryInterface
{
use ResolvesSortSpec;
/** 허용 정렬 컬럼 (MenuListRequest 와 동일 집합) */
private const SORTABLE_COLUMNS = ['created_at', 'name', 'slug', 'order'];
/**
* 모든 메뉴를 조회합니다.
*
@@ -37,6 +46,14 @@ class MenuRepository implements MenuRepositoryInterface
->get();
}
/**
* 관리용 최상위 메뉴 목록을 조회합니다. (비활성 확장 메뉴 제외)
*
* @param array $activeModuleIdentifiers 활성 모듈 식별자 목록
* @param array $activePluginIdentifiers 활성 플러그인 식별자 목록
* @param User|null $user 접근 권한 판정 대상 사용자 (null 이면 역할 필터 미적용)
* @return Collection 최상위 메뉴 컬렉션 (자식 메뉴 포함)
*/
public function getTopLevelMenusForManagement(array $activeModuleIdentifiers = [], array $activePluginIdentifiers = [], ?User $user = null): Collection
{
$extensionFilter = function ($query) use ($activeModuleIdentifiers, $activePluginIdentifiers) {
@@ -67,13 +84,13 @@ class MenuRepository implements MenuRepositoryInterface
}
return $query->with(['creator', 'roles', 'children' => function ($query) use ($extensionFilter, $user) {
$query->where($extensionFilter);
if ($user) {
$query->accessibleBy($user);
}
$query->with('roles')
->orderBy('order');
}])
$query->where($extensionFilter);
if ($user) {
$query->accessibleBy($user);
}
$query->with('roles')
->orderBy('order');
}])
->orderBy('order')
->get();
}
@@ -260,7 +277,7 @@ class MenuRepository implements MenuRepositoryInterface
$q->where('extension_type', ExtensionOwnerType::Module)
->whereExists(function ($subQuery) {
$subQuery->select(DB::raw(1))
->from('modules')
->from((new Module)->getTable())
->whereColumn('modules.identifier', 'menus.extension_identifier')
->where('modules.status', 'active');
});
@@ -270,7 +287,7 @@ class MenuRepository implements MenuRepositoryInterface
$q->where('extension_type', ExtensionOwnerType::Plugin)
->whereExists(function ($subQuery) {
$subQuery->select(DB::raw(1))
->from('plugins')
->from((new Plugin)->getTable())
->whereColumn('plugins.identifier', 'menus.extension_identifier')
->where('plugins.status', 'active');
});
@@ -359,6 +376,15 @@ class MenuRepository implements MenuRepositoryInterface
return (int) Menu::where('parent_id', $parentId)->max('order');
}
/**
* 필터 조건이 적용된 최상위 메뉴 목록을 조회합니다.
*
* @param array $filters 필터 조건 배열 (sort_by/sort_order/검색 필드)
* @param array $activeModuleIdentifiers 활성 모듈 식별자 목록
* @param array $activePluginIdentifiers 활성 플러그인 식별자 목록
* @param User|null $user 접근 권한 판정 대상 사용자 (null 이면 역할 필터 미적용)
* @return Collection 최상위 메뉴 컬렉션 (자식 메뉴 포함)
*/
public function getFilteredTopLevelMenus(array $filters, array $activeModuleIdentifiers = [], array $activePluginIdentifiers = [], ?User $user = null): Collection
{
$extensionFilter = function ($query) use ($activeModuleIdentifiers, $activePluginIdentifiers) {
@@ -418,10 +444,10 @@ class MenuRepository implements MenuRepositoryInterface
}
}
// 정렬
$sortBy = $filters['sort_by'] ?? 'order';
$sortOrder = $filters['sort_order'] ?? 'asc';
$query->orderBy($sortBy, $sortOrder);
// 정렬 (허용 컬럼 화이트리스트로 해석)
foreach ($this->resolveSortSpec($filters, self::SORTABLE_COLUMNS, 'order', 'asc') as $sort) {
$query->orderBy($sort['column'], $sort['direction']);
}
// 자식 메뉴도 동일한 조건 적용하여 로드
return $query->with(['creator', 'roles', 'children' => function ($childQuery) use ($extensionFilter, $filters, $user) {
@@ -444,7 +470,7 @@ class MenuRepository implements MenuRepositoryInterface
/**
* 필터 연산자를 쿼리에 적용합니다.
*
* @param \Illuminate\Database\Eloquent\Builder $query 쿼리 빌더
* @param Builder $query 쿼리 빌더
* @param string $field 필드명
* @param string $value 검색 값
* @param string $operator 연산자 (like, eq, starts_with, ends_with)