Files
Gnuboard7/app/Http/Requests/Admin/LayoutVersionListRequest.php
HeuJung b5c0ec1178 fix(core,ecommerce,board,page,admin_basic,basic): 목록 응답의 하위 컬렉션 전량 직렬화 해소
관리자 상품목록을 한 페이지 여는 것만으로 그 페이지 모든 상품의 옵션이 응답에 실렸다.
같은 패턴을 저장소 전역에서 찾아 14개 목록 엔드포인트를 함께 정리했다.

근본 원인은 둘이다. Resource 가 whenLoaded 로 방어하는데 Repository 가 목록 쿼리에서
관계를 무조건 로드해 가드가 항상 참이 되는 가짜 가드, 그리고 toListArray 경량 표현을
정의해 두고도 컬렉션이 toArray 를 부르는 목록/상세 미분리다. 둘 다 응답만 보면
정상이라 오류도 경고도 없이 페이로드만 불어난다.

목록은 화면이 실제로 그리는 것만 싣는다. 개수·합계는 PHP 컬렉션 연산이 아니라 DB
집계로, 대표 1건이 필요한 곳은 관계 자체를 oldestOfMany 로 좁힌다. eager load 의
limit(1) 은 부모별이 아니라 배치 쿼리 전체에 걸려 첫 행만 값을 갖게 되므로 쓸 수 없다.

뺀 값에는 대체 경로를 먼저 만들었다. 상품 옵션은 행을 펼칠 때 배치로 불러오고(상품 수와
무관하게 쿼리 상수), 종전 동작이 필요한 호출자를 위해 ?with_options=1 등 opt-in 을 남겼다.
배송정책 국가설정과 리뷰 첨부 이미지는 소비처를 실측한 결과 화면이 실제로 그리고 있어
제거하지 않았다 — 그 소비 사실을 회귀 테스트로 고정했다.

재발 방지로 정적 검사 룰 4종과 규정 문서 항목을 함께 넣었다.
2026-08-05 21:20:05 +09:00

62 lines
1.8 KiB
PHP

<?php
namespace App\Http\Requests\Admin;
use App\Extension\HookManager;
use Illuminate\Foundation\Http\FormRequest;
/**
* 레이아웃 버전 목록 조회 요청
*
* 버전 행은 저장할 때마다 쌓이고 정리(pruning)되지 않습니다. 상한이 없으면 오래 편집한
* 레이아웃 하나가 수백~수천 건의 버전을 한 응답에 담게 되므로 조회 건수를 제한합니다.
* 더 오래된 이력이 필요하면 `limit` 을 명시해 넓힐 수 있습니다.
*/
class LayoutVersionListRequest extends FormRequest
{
/** 기본 조회 건수 (미지정 시) */
public const DEFAULT_LIMIT = 100;
/** 한 번에 조회 가능한 최대 건수 */
public const MAX_LIMIT = 500;
/**
* 권한 확인
*
* @return bool 인가 여부 (권한 체크는 미들웨어에 위임)
*/
public function authorize(): bool
{
return true;
}
/**
* 유효성 검사 규칙
*
* @return array<string, mixed> 검증 규칙
*/
public function rules(): array
{
$rules = [
'limit' => ['nullable', 'integer', 'min:1', 'max:'.self::MAX_LIMIT],
];
// 모듈/플러그인이 목록 조회 파라미터를 확장할 수 있도록 훅을 노출한다
return HookManager::applyFilters('core.layout_version.list_validation_rules', $rules, $this);
}
/**
* 검증 오류 메시지 커스터마이징
*
* @return array<string, string> 오류 메시지
*/
public function messages(): array
{
return [
'limit.integer' => __('validation.layout_version.limit.integer'),
'limit.min' => __('validation.layout_version.limit.min'),
'limit.max' => __('validation.layout_version.limit.max', ['max' => self::MAX_LIMIT]),
];
}
}