상품 이미지 업로드 규칙

개요

어드민에서 상품 이미지를 업로드할 때, 파일명 suffix(번호) 에 따라 이미지 타입(HOVER / THUMBNAIL / DETAIL 등)이 자동으로 결정된다. 이 규칙은 ProductBulkImageService.kt의 fetchImageType 함수에 구현되어 있으며, 스토어별로 다른 번호 체계를 사용한다.

스토어별 이미지 번호 규칙

WORKSOUT / CARHARTT (기본 규칙)

파일명 형식: {상품코드}-{번호}.jpg
예: WO24FAJACKET001-0.jpg, WO24FAJACKET001-2.jpg

번호	이미지 타입	조건
0	`HOVER`	항상
1	`THUMBNAIL`	90번 파일이 없을 때만
2 ~ 79	`DETAIL`	항상
80 ~ 89	`FITTING`	착용 이미지
90	`THUMBNAIL`	상품코드가 `CA`로 시작하지 않을 때
99	`SCHEME`	항상

THUMBNAIL 결정 우선순위: 90번이 존재하면 90번이 썸네일. 90번이 없을 때만 1번이 썸네일로 사용됨.

CARHARTT 예외: 상품코드가 CA로 시작하는 경우 90번은 타입 매핑 안 됨 (null 반환).

GRAMICCI

파일명 형식: {상품코드}-{번호}.jpg
예: GR24FAPANTS001-200.jpg, GR24FAPANTS001-201.jpg

번호	이미지 타입	조건
200	`HOVER`	항상
201	`THUMBNAIL`	항상
202 ~ 299	`DETAIL`	항상

GRAMICCI 이미지를 2세트 업로드하는 이유

GRAMICCI 상품은 WORKSOUT 스토어와 GRAMICCI 스토어 양쪽에 노출된다. 각 스토어는 자신의 번호 규칙에 맞는 이미지만 인식하므로, 두 스토어에 동일 이미지를 모두 노출하려면 번호 체계를 달리한 파일을 각각 업로드해야 한다.

세트	번호	목적	노출 스토어
1세트	0, 1 (또는 90), 2~79	WORKSOUT 규칙 적용	WORKSOUT 스토어
2세트	200, 201, 202~	GRAMICCI 규칙 적용	GRAMICCI 스토어

동일한 이미지 파일을 번호만 바꿔 두 번 업로드하는 방식.
한 세트만 올리면 해당 규칙을 사용하는 스토어에서만 이미지가 노출됨.

정렬 순서(sort)와 타입의 관계

sort 값은 프론트엔드에서 이미지를 노출 순서대로 정렬할 때 사용하는 DB 컬럼이다. 이미지 타입 결정과는 완전히 독립적으로 동작한다.

항목	설명
역할	프론트 이미지 갤러리의 표시 순서
기준	숫자 오름차순 (작은 값이 먼저 표시)
타입과의 관계	무관 — sort=1000이든 9999든 타입 결정에 영향 없음
예시	어드민에서 영상 파일 업로드 시 sort=1000으로 저장되어도 타입 매핑과 무관하게 정렬만 처리됨

번호 범위 외 값(예: 1000): fetchImageType이 null을 반환하여 타입 미지정 상태가 됨. sort 값과 혼동하지 않도록 주의.

업로드 체크리스트

WORKSOUT / CARHARTT 상품

{코드}-0.jpg — HOVER
{코드}-90.jpg — THUMBNAIL (CA 코드 제외)
※ 90번 없으면 {코드}-1.jpg가 THUMBNAIL로 대체됨
{코드}-2.jpg ~ — DETAIL (필요한 수만큼)
{코드}-80.jpg ~ — FITTING (착용 이미지, 선택)
{코드}-99.jpg — SCHEME (선택)

GRAMICCI 상품

WORKSOUT 세트: {코드}-0.jpg, {코드}-1.jpg, {코드}-2.jpg ~
GRAMICCI 세트: {코드}-200.jpg, {코드}-201.jpg, {코드}-202.jpg ~

변경 이력

버전	날짜	변경 내용
v1.0	2026-07-21	최초 작성 — 스토어별 이미지 번호 규칙, GRAMICCI 2세트 업로드 이유, sort vs 타입 관계, 업로드 체크리스트