Files
Gnuboard7/app/Http/Resources/Admin/Identity/IdentityMessageDefinitionResource.php
T
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

88 lines
3.6 KiB
PHP

<?php
namespace App\Http\Resources\Admin\Identity;
use App\Http\Resources\BaseApiResource;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\MissingValue;
/**
* IDV 메시지 정의 리소스.
*/
class IdentityMessageDefinitionResource extends BaseApiResource
{
/**
* {@inheritDoc}
*/
protected function abilityMap(): array
{
return [
'can_update' => 'core.admin.identity.messages.update',
'can_delete' => 'core.admin.identity.messages.update',
];
}
/**
* abilities 동적 후처리 — 시드 정의(is_default=true)는 삭제 거부.
*
* @param Request $request
* @return array<string, bool>
*/
protected function resolveAbilities(Request $request): array
{
$abilities = parent::resolveAbilities($request);
if (isset($abilities['can_delete']) && $this->getValue('is_default')) {
$abilities['can_delete'] = false;
}
return $abilities;
}
/**
* 리소스를 배열로 변환합니다.
*
* @param Request $request
* @return array
*/
public function toArray(Request $request): array
{
return [
'id' => $this->getValue('id'),
'provider_id' => $this->getValue('provider_id'),
'scope_type' => $this->getValue('scope_type'),
'scope_value' => $this->getValue('scope_value'),
'name' => $this->getValue('name'),
'description' => $this->getValue('description'),
'channels' => $this->getValue('channels'),
'variables' => $this->getValue('variables'),
'extension_type' => $this->getValue('extension_type'),
'extension_identifier' => $this->getValue('extension_identifier'),
'is_active' => (bool) $this->getValue('is_active'),
'is_default' => (bool) $this->getValue('is_default'),
'user_overrides' => $this->getValue('user_overrides'),
// 목록은 대표 템플릿 1건만 로드하고(firstTemplate), 단건은 전체를 로드한다(templates).
// 화면 계약은 양쪽 모두 `templates` 배열이라 여기서 하나로 합류시킨다 —
// 로드된 쪽을 쓰고, 어느 쪽도 로드되지 않았으면 키 자체를 내보내지 않는다.
//
// 대표 템플릿 분기는 `whenLoaded` 로 쓸 수 없다. `whenLoaded($relation, $value)` 는
// 관계가 로드됐어도 값이 null 이면 $value 를 평가하지 않고 그대로 null 을 돌려준다
// (HasOne 이 0건이면 null). 그러면 "로드하지 않음"(null)과 "로드했더니 0건"(빈 배열)이
// 같은 값이 되어 소비자가 둘을 구분할 수 없다 — 관계 로드 여부는 직접 판정한다.
'templates' => $this->whenLoaded(
'templates',
fn () => IdentityMessageTemplateResource::collection($this->templates),
fn () => $this->resource->relationLoaded('firstTemplate')
? ($this->firstTemplate
? IdentityMessageTemplateResource::collection(collect([$this->firstTemplate]))
: [])
: new MissingValue,
),
// 목록이 대표 1건만 싣기 때문에, "템플릿이 더 있는가" 는 배열 길이로 알 수 없다.
'templates_count' => $this->whenHas('templates_count', fn () => (int) $this->templates_count),
...$this->formatTimestamps(),
...$this->resourceMeta($request),
];
}
}