Files
Gnuboard7/app/Repositories/IdentityMessageDefinitionRepository.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

209 lines
6.7 KiB
PHP

<?php
namespace App\Repositories;
use App\Contracts\Repositories\IdentityMessageDefinitionRepositoryInterface;
use App\Models\IdentityMessageDefinition;
use App\Repositories\Concerns\ResolvesSortSpec;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Pagination\LengthAwarePaginator;
class IdentityMessageDefinitionRepository implements IdentityMessageDefinitionRepositoryInterface
{
use ResolvesSortSpec;
/** 허용 정렬 컬럼 (AdminIdentityMessageDefinitionIndexRequest 와 동일 집합) */
private const SORTABLE_COLUMNS = [
'id',
'provider_id',
'scope_type',
'scope_value',
'is_active',
'created_at',
'updated_at',
];
/**
* ID로 메시지 정의 조회.
*
* @param int $id
* @return IdentityMessageDefinition|null
*/
public function findById(int $id): ?IdentityMessageDefinition
{
return IdentityMessageDefinition::find($id);
}
/**
* (provider, scope_type, scope_value) 조합으로 메시지 정의 조회.
*
* @param string $providerId
* @param string $scopeType
* @param string|null $scopeValue
* @return IdentityMessageDefinition|null
*/
public function findByScope(string $providerId, string $scopeType, ?string $scopeValue = null): ?IdentityMessageDefinition
{
return IdentityMessageDefinition::byProvider($providerId)
->byScope($scopeType, $scopeValue)
->first();
}
/**
* 활성 상태인 (provider, scope_type, scope_value) 메시지 정의 조회.
*
* @param string $providerId
* @param string $scopeType
* @param string|null $scopeValue
* @return IdentityMessageDefinition|null
*/
public function getActiveByScope(string $providerId, string $scopeType, ?string $scopeValue = null): ?IdentityMessageDefinition
{
return IdentityMessageDefinition::active()
->byProvider($providerId)
->byScope($scopeType, $scopeValue)
->first();
}
/**
* 모든 활성 메시지 정의 조회.
*
* @return Collection
*/
public function getAllActive(): Collection
{
return IdentityMessageDefinition::active()->get();
}
/**
* 활성 메시지 정의의 로케일별 라벨 맵.
*
* 키: "{provider_id}|{scope_type}|{scope_value}", 값: 다국어 라벨
*
* @param string|null $locale
* @return array<string, string>
*/
public function getLabelMap(?string $locale = null): array
{
$locale = $locale ?? app()->getLocale();
return IdentityMessageDefinition::active()
->get(['id', 'provider_id', 'scope_type', 'scope_value', 'name'])
->mapWithKeys(fn (IdentityMessageDefinition $def) => [
"{$def->provider_id}|{$def->scope_type->value}|{$def->scope_value}" => $def->getLocalizedName($locale),
])
->all();
}
/**
* 전체 메시지 정의 조회.
*
* @return Collection
*/
public function getAll(): Collection
{
return IdentityMessageDefinition::all();
}
/**
* 특정 확장의 메시지 정의 목록 조회.
*
* @param string $extensionType
* @param string $extensionIdentifier
* @return Collection
*/
public function getByExtension(string $extensionType, string $extensionIdentifier): Collection
{
return IdentityMessageDefinition::byExtension($extensionType, $extensionIdentifier)->get();
}
/**
* 메시지 정의 신규 생성.
*
* @param array $data
* @return IdentityMessageDefinition
*/
public function store(array $data): IdentityMessageDefinition
{
return IdentityMessageDefinition::create($data)->fresh();
}
/**
* 메시지 정의 수정.
*
* @param IdentityMessageDefinition $definition
* @param array $data
* @return IdentityMessageDefinition
*/
public function update(IdentityMessageDefinition $definition, array $data): IdentityMessageDefinition
{
$definition->update($data);
return $definition->fresh();
}
/**
* 페이지네이션 목록 조회.
*
* @param array $filters
* @param int $perPage
* @return LengthAwarePaginator
*/
public function getPaginated(array $filters = [], int $perPage = 20): LengthAwarePaginator
{
// 목록은 대표 템플릿 1건만 싣는다 — 화면이 그리는 것은 `templates[0]` 의 제목/본문뿐이다.
// `templates` 를 통째로 로드하면 한 페이지를 여는 것만으로 그 페이지 전 정의의 모든 채널
// 템플릿 본문이 응답에 실린다. 전체 템플릿은 단건 조회(show)가 공급한다.
$query = IdentityMessageDefinition::with('firstTemplate')
->withCount('templates as templates_count');
if (! empty($filters['provider_id'])) {
$query->where('provider_id', $filters['provider_id']);
}
if (! empty($filters['scope_type'])) {
$query->where('scope_type', $filters['scope_type']);
}
if (! empty($filters['scope_value'])) {
$query->where('scope_value', $filters['scope_value']);
}
if (! empty($filters['extension_type'])) {
$query->where('extension_type', $filters['extension_type']);
}
if (! empty($filters['extension_identifier'])) {
$query->where('extension_identifier', $filters['extension_identifier']);
}
if (isset($filters['is_active'])) {
$query->where('is_active', $filters['is_active']);
}
if (! empty($filters['channel'])) {
$query->whereJsonContains('channels', $filters['channel']);
}
if (! empty($filters['search'])) {
$search = $filters['search'];
$locales = config('app.supported_locales', ['ko', 'en']);
$query->where(function ($q) use ($search, $locales) {
$q->where('provider_id', 'like', "%{$search}%")
->orWhere('scope_value', 'like', "%{$search}%");
foreach ($locales as $locale) {
$q->orWhere("name->{$locale}", 'like', "%{$search}%");
}
});
}
foreach ($this->resolveSortSpec($filters, self::SORTABLE_COLUMNS, 'id', 'asc') as $sort) {
$query->orderBy($sort['column'], $sort['direction']);
}
// audit:allow repository-paginate-column-pruning reason: 본인인증 메시지 정의 테이블 — 정의 수가 고정이고 넓은 컬럼이 없다
return $query->paginate($perPage);
}
}