HeuJung
b5c0ec1178
관리자 상품목록을 한 페이지 여는 것만으로 그 페이지 모든 상품의 옵션이 응답에 실렸다. 같은 패턴을 저장소 전역에서 찾아 14개 목록 엔드포인트를 함께 정리했다. 근본 원인은 둘이다. Resource 가 whenLoaded 로 방어하는데 Repository 가 목록 쿼리에서 관계를 무조건 로드해 가드가 항상 참이 되는 가짜 가드, 그리고 toListArray 경량 표현을 정의해 두고도 컬렉션이 toArray 를 부르는 목록/상세 미분리다. 둘 다 응답만 보면 정상이라 오류도 경고도 없이 페이로드만 불어난다. 목록은 화면이 실제로 그리는 것만 싣는다. 개수·합계는 PHP 컬렉션 연산이 아니라 DB 집계로, 대표 1건이 필요한 곳은 관계 자체를 oldestOfMany 로 좁힌다. eager load 의 limit(1) 은 부모별이 아니라 배치 쿼리 전체에 걸려 첫 행만 값을 갖게 되므로 쓸 수 없다. 뺀 값에는 대체 경로를 먼저 만들었다. 상품 옵션은 행을 펼칠 때 배치로 불러오고(상품 수와 무관하게 쿼리 상수), 종전 동작이 필요한 호출자를 위해 ?with_options=1 등 opt-in 을 남겼다. 배송정책 국가설정과 리뷰 첨부 이미지는 소비처를 실측한 결과 화면이 실제로 그리고 있어 제거하지 않았다 — 그 소비 사실을 회귀 테스트로 고정했다. 재발 방지로 정적 검사 룰 4종과 규정 문서 항목을 함께 넣었다.
89 lines
3.4 KiB
PHP
89 lines
3.4 KiB
PHP
<?php
|
|
|
|
namespace App\Contracts\Repositories;
|
|
|
|
use App\Models\TemplateLayoutExtensionVersion;
|
|
use Illuminate\Database\Eloquent\Collection;
|
|
use Illuminate\Database\Eloquent\ModelNotFoundException;
|
|
|
|
interface LayoutExtensionVersionRepositoryInterface
|
|
{
|
|
/**
|
|
* 버전 저장 (자동 증가)
|
|
*
|
|
* @param int $extensionId 레이아웃 확장 ID
|
|
* @param array $oldContent 이전 콘텐츠
|
|
* @param array|null $newContent 새 콘텐츠 (null이면 현재 확장 content 사용)
|
|
* @return TemplateLayoutExtensionVersion 생성된 버전 모델
|
|
*/
|
|
public function saveVersion(int $extensionId, array $oldContent, ?array $newContent = null): TemplateLayoutExtensionVersion;
|
|
|
|
/**
|
|
* 특정 확장의 모든 버전 조회 (최신순)
|
|
*
|
|
* @param int $extensionId 레이아웃 확장 ID
|
|
* @return Collection 버전 컬렉션
|
|
*/
|
|
public function getVersions(int $extensionId, int $limit = 100): Collection;
|
|
|
|
/**
|
|
* 확장의 특정 버전 번호 조회 (본문 포함)
|
|
*
|
|
* 목록(getVersions)은 경량 조회라 `content` 를 담지 않고 건수 상한이 있다. 단건은 그
|
|
* 대체 경로이므로 반드시 전용 조회를 쓴다 — 목록 조회를 재사용하면 본문이 사라지고
|
|
* 상한 밖의 오래된 버전을 찾지 못한다.
|
|
*
|
|
* @param int $extensionId 레이아웃 확장 ID
|
|
* @param int $version 버전 번호
|
|
* @return TemplateLayoutExtensionVersion|null 찾은 버전 모델 또는 null
|
|
*/
|
|
public function findVersionByNumber(int $extensionId, int $version): ?TemplateLayoutExtensionVersion;
|
|
|
|
/**
|
|
* 확장 ID 목록의 현재(최신) 버전 번호 맵 조회
|
|
*
|
|
* 레이아웃 편집기 라우트 트리의 확장 노드 버전 배지 데이터
|
|
* 소스로, 버전 이력이 1건 이상인 확장만 포함된다(미저장 확장 = 원본 → 맵 제외).
|
|
*
|
|
* @param array<int> $extensionIds 확장 ID 목록
|
|
* @return array<int, int> 확장 ID → 최신 버전 번호
|
|
*/
|
|
public function getCurrentVersionsByExtensionIds(array $extensionIds): array;
|
|
|
|
/**
|
|
* 특정 버전 조회
|
|
*
|
|
* @param int $versionId 버전 ID
|
|
* @return TemplateLayoutExtensionVersion|null 찾은 버전 모델 또는 null
|
|
*/
|
|
public function getVersion(int $versionId): ?TemplateLayoutExtensionVersion;
|
|
|
|
/**
|
|
* 다음 버전 번호 계산
|
|
*
|
|
* @param int $extensionId 레이아웃 확장 ID
|
|
* @return int 다음 버전 번호
|
|
*/
|
|
public function getNextVersion(int $extensionId): int;
|
|
|
|
/**
|
|
* JSON content 변경사항 카운트 계산 (라인 단위)
|
|
*
|
|
* @param array $oldContent 이전 콘텐츠
|
|
* @param array $newContent 새 콘텐츠
|
|
* @return array{added: int, removed: int, char_diff: int} 추가/삭제 라인 수 + 문자 수 변화
|
|
*/
|
|
public function calculateChanges(array $oldContent, array $newContent): array;
|
|
|
|
/**
|
|
* 버전 복원
|
|
*
|
|
* @param int $extensionId 레이아웃 확장 ID
|
|
* @param int $versionId 복원할 버전 ID
|
|
* @return TemplateLayoutExtensionVersion 복원 후 생성된 새 버전 모델
|
|
*
|
|
* @throws ModelNotFoundException 버전을 찾을 수 없는 경우
|
|
*/
|
|
public function restoreVersion(int $extensionId, int $versionId): TemplateLayoutExtensionVersion;
|
|
}
|