Merge pull request #44 from prgrms-aibe-devcourse/feat/#43

warcat12 · web-flow · commit 28d84af7afa4 · 2026-06-01T10:40:18.000+09:00
feat/ #43 enum추가, 외부 출처 추가
diff --git a/src/main/java/com/closetnangam/be/domain/catalog/controller/CategoryController.java b/src/main/java/com/closetnangam/be/domain/catalog/controller/CategoryController.java
@@ -2,6 +2,7 @@
 
 import com.closetnangam.be.domain.catalog.dto.response.CategoryCatalogResponse;
 import com.closetnangam.be.domain.catalog.dto.response.CategoryUsageGuideResponse;
+import com.closetnangam.be.domain.catalog.dto.response.ExternalSourcesResponse;
 import com.closetnangam.be.domain.catalog.service.CategoryCatalogService;
 import com.closetnangam.be.global.common.response.ApiResponse;
 import io.swagger.v3.oas.annotations.Operation;
@@ -51,4 +52,17 @@ public ResponseEntity<ApiResponse<CategoryUsageGuideResponse>> getUsageGuide() {
     public ResponseEntity<ApiResponse<String>> getAiGuide() {
         return ResponseEntity.ok(ApiResponse.ok(categoryCatalogService.getAiClassificationGuide()));
     }
+
+    @Operation(
+            summary = "외부 쇼핑 출처 목록 조회",
+            description = """
+                    미보유 옷 저장 시 선택할 외부 출처 12개 + 직접입력 옵션을 반환합니다.
+                    - 선택 항목: externalSource에 code 저장 (예: NAVER_SHOPPING, MUSINSA)
+                    - 직접입력: allowsCustomInput=true 항목 선택 후 사용자 입력값을 externalSource에 저장
+                    """
+    )
+    @GetMapping("/external-sources")
+    public ResponseEntity<ApiResponse<ExternalSourcesResponse>> getExternalSources() {
+        return ResponseEntity.ok(ApiResponse.ok(categoryCatalogService.getExternalSources()));
+    }
 }
diff --git a/src/main/java/com/closetnangam/be/domain/catalog/dto/response/ExternalSourceResponse.java b/src/main/java/com/closetnangam/be/domain/catalog/dto/response/ExternalSourceResponse.java
@@ -0,0 +1,23 @@
+package com.closetnangam.be.domain.catalog.dto.response;
+
+import com.closetnangam.be.domain.catalog.enums.ExternalSource;
+import com.closetnangam.be.domain.catalog.enums.ExternalSourceGroup;
+
+public record ExternalSourceResponse(
+        String code,
+        String label,
+        ExternalSourceGroup group,
+        String groupLabel,
+        boolean allowsCustomInput
+) {
+
+    public static ExternalSourceResponse from(ExternalSource source) {
+        return new ExternalSourceResponse(
+                source.name(),
+                source.getLabel(),
+                source.getGroup(),
+                source.getGroup().getLabel(),
+                source.isAllowsCustomInput()
+        );
+    }
+}
diff --git a/src/main/java/com/closetnangam/be/domain/catalog/dto/response/ExternalSourcesResponse.java b/src/main/java/com/closetnangam/be/domain/catalog/dto/response/ExternalSourcesResponse.java
@@ -0,0 +1,9 @@
+package com.closetnangam.be.domain.catalog.dto.response;
+
+import java.util.List;
+
+public record ExternalSourcesResponse(
+        String description,
+        List<ExternalSourceResponse> sources
+) {
+}
diff --git a/src/main/java/com/closetnangam/be/domain/catalog/enums/ExternalSource.java b/src/main/java/com/closetnangam/be/domain/catalog/enums/ExternalSource.java
@@ -0,0 +1,52 @@
+package com.closetnangam.be.domain.catalog.enums;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+import java.util.Optional;
+
+@Getter
+@RequiredArgsConstructor
+public enum ExternalSource {
+
+    NAVER_SHOPPING("네이버쇼핑", ExternalSourceGroup.OPEN_MARKET, false),
+    COUPANG("쿠팡", ExternalSourceGroup.OPEN_MARKET, false),
+    MUSINSA("무신사", ExternalSourceGroup.FASHION_PLATFORM, false),
+    ABLY("에이블리", ExternalSourceGroup.FASHION_PLATFORM, false),
+    ZIGZAG("지그재그", ExternalSourceGroup.FASHION_PLATFORM, false),
+    TWENTYNINE_CM("29CM", ExternalSourceGroup.FASHION_PLATFORM, false),
+    WCONCEPT("W컨셉", ExternalSourceGroup.FASHION_PLATFORM, false),
+    BRANDI("브랜디", ExternalSourceGroup.FASHION_PLATFORM, false),
+    UNIQLO("유니클로", ExternalSourceGroup.SPA, false),
+    SPAO("스파오", ExternalSourceGroup.SPA, false),
+    EIGHT_SECONDS("에잇세컨즈", ExternalSourceGroup.SPA, false),
+    HM("H&M", ExternalSourceGroup.SPA, false),
+    CUSTOM("직접입력", ExternalSourceGroup.CUSTOM, true);
+
+    private final String label;
+    private final ExternalSourceGroup group;
+    private final boolean allowsCustomInput;
+
+    public static ExternalSource fromCode(String code) {
+        return Arrays.stream(values())
+                .filter(source -> source.name().equals(code))
+                .findFirst()
+                .orElseThrow(() -> new IllegalArgumentException("유효하지 않은 외부 출처 코드입니다: " + code));
+    }
+
+    public static Optional<ExternalSource> findByCode(String code) {
+        return Arrays.stream(values())
+                .filter(source -> source.name().equals(code))
+                .findFirst();
+    }
+
+    public static String resolveDisplayName(String storedValue) {
+        if (storedValue == null) {
+            return null;
+        }
+        return findByCode(storedValue)
+                .map(ExternalSource::getLabel)
+                .orElse(storedValue);
+    }
+}
diff --git a/src/main/java/com/closetnangam/be/domain/catalog/enums/ExternalSourceGroup.java b/src/main/java/com/closetnangam/be/domain/catalog/enums/ExternalSourceGroup.java
@@ -0,0 +1,16 @@
+package com.closetnangam.be.domain.catalog.enums;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum ExternalSourceGroup {
+
+    OPEN_MARKET("플랫폼"),
+    FASHION_PLATFORM("플랫폼 및 SPA"),
+    SPA("SPA"),
+    CUSTOM("직접입력");
+
+    private final String label;
+}
diff --git a/src/main/java/com/closetnangam/be/domain/catalog/service/CategoryCatalogService.java b/src/main/java/com/closetnangam/be/domain/catalog/service/CategoryCatalogService.java
@@ -6,11 +6,13 @@
 import com.closetnangam.be.domain.catalog.enums.ClothesCategory;
 import com.closetnangam.be.domain.catalog.enums.ClothesColor;
 import com.closetnangam.be.domain.catalog.enums.ClothesItemType;
+import com.closetnangam.be.domain.catalog.enums.ExternalSource;
 import com.closetnangam.be.domain.catalog.enums.StyleCode;
 import com.closetnangam.be.domain.catalog.repository.StyleRepository;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
+import org.springframework.util.StringUtils;
 
 import java.util.Arrays;
 import java.util.HashSet;
@@ -201,6 +203,38 @@ public void validateStyleCodes(List<String> styleCodes) {
         }
     }
 
+    public ExternalSourcesResponse getExternalSources() {
+        return new ExternalSourcesResponse(
+                """
+                        미보유 옷 저장 시 사용할 외부 쇼핑 출처 목록입니다.
+                        - 목록에서 선택: externalSource에 code 값(예: MUSINSA)을 저장합니다.
+                        - 직접입력: 사용자가 입력한 출처명을 externalSource VARCHAR에 그대로 저장합니다.
+                        DB 컬럼은 enum이 아닌 VARCHAR(50)입니다.
+                        """,
+                Arrays.stream(ExternalSource.values())
+                        .map(ExternalSourceResponse::from)
+                        .toList()
+        );
+    }
+
+    public void validateExternalSource(String externalSource) {
+        if (!StringUtils.hasText(externalSource)) {
+            throw new IllegalArgumentException("외부 출처는 필수입니다.");
+        }
+        if (externalSource.length() > 50) {
+            throw new IllegalArgumentException("외부 출처는 50자 이하여야 합니다.");
+        }
+        if ("NONE".equals(externalSource)) {
+            throw new IllegalArgumentException("외부 출처를 선택하거나 입력해 주세요.");
+        }
+
+        ExternalSource.findByCode(externalSource).ifPresent(matched -> {
+            if (matched.isAllowsCustomInput()) {
+                throw new IllegalArgumentException("직접입력 출처명을 입력해 주세요.");
+            }
+        });
+    }
+
     private java.util.List<CategoryGroupResponse> getCategoryGroups() {
         return Arrays.stream(ClothesCategory.values())
                 .map(category -> new CategoryGroupResponse(
diff --git a/src/main/java/com/closetnangam/be/domain/clothes/dto/response/ClothesResponse.java b/src/main/java/com/closetnangam/be/domain/clothes/dto/response/ClothesResponse.java
@@ -5,6 +5,7 @@
 import com.closetnangam.be.domain.clothes.entity.ClothingColor;
 import com.closetnangam.be.domain.clothes.entity.WardrobeClothes;
 import com.closetnangam.be.domain.clothes.enums.ColorRole;
+import com.closetnangam.be.domain.clothes.enums.ClothesInfoSource;
 import com.closetnangam.be.domain.clothes.enums.SourceType;
 
 import java.time.LocalDateTime;
@@ -26,6 +27,7 @@ public record ClothesResponse(
         List<SecondaryColorResponse> secondaryColors,
         List<StyleTagResponse> styles,
         SourceType sourceType,
+        ClothesInfoSource infoSource,
         String externalSource,
         String externalProductId,
         String externalProductUrl,
@@ -88,6 +90,7 @@ public static ClothesResponse from(Clothes clothes, WardrobeClothes wardrobeClot
                 secondaryColors,
                 styles,
                 clothes.getSourceType(),
+                clothes.getInfoSource(),
                 clothes.getExternalSource(),
                 clothes.getExternalProductId(),
                 clothes.getExternalProductUrl(),
diff --git a/src/main/java/com/closetnangam/be/domain/clothes/dto/response/PhotoClothesRegistrationResponse.java b/src/main/java/com/closetnangam/be/domain/clothes/dto/response/PhotoClothesRegistrationResponse.java
@@ -1,15 +1,15 @@
 package com.closetnangam.be.domain.clothes.dto.response;
 
+import com.closetnangam.be.domain.clothes.enums.ClothesInfoSource;
 import com.closetnangam.be.domain.clothes.enums.OwnershipStatus;
-import com.closetnangam.be.domain.clothes.enums.RegistrationSource;
 
 public record PhotoClothesRegistrationResponse(
         Long wardrobeClothesId,
         Long clothesId,
         Long photoId,
         String userImageUrl,
         OwnershipStatus ownershipStatus,
-        RegistrationSource registrationSource,
+        ClothesInfoSource infoSource,
         String size,
         String season,
         Boolean favorite,
diff --git a/src/main/java/com/closetnangam/be/domain/clothes/entity/Clothes.java b/src/main/java/com/closetnangam/be/domain/clothes/entity/Clothes.java
@@ -1,5 +1,6 @@
 package com.closetnangam.be.domain.clothes.entity;
 
+import com.closetnangam.be.domain.clothes.enums.ClothesInfoSource;
 import com.closetnangam.be.domain.clothes.enums.SourceType;
 import com.closetnangam.be.global.common.entity.BaseEntity;
 import jakarta.persistence.CascadeType;
@@ -31,7 +32,7 @@
 @Table(name = "clothes")
 public class Clothes extends BaseEntity {
 
-    private static final String EXTERNAL_NONE = "NONE";
+    public static final String EXTERNAL_NONE = "NONE";
 
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
@@ -60,6 +61,10 @@ public class Clothes extends BaseEntity {
     @Column(name = "source_type", nullable = false, length = 50)
     private SourceType sourceType;
 
+    @Enumerated(EnumType.STRING)
+    @Column(name = "info_source", nullable = false, length = 50)
+    private ClothesInfoSource infoSource;
+
     @Column(name = "external_source", nullable = false, length = 50)
     private String externalSource;
 
@@ -95,6 +100,7 @@ private Clothes(
             String category,
             String itemType,
             SourceType sourceType,
+            ClothesInfoSource infoSource,
             String externalSource,
             String externalProductId,
             String externalProductUrl,
@@ -107,6 +113,10 @@ private Clothes(
         this.category = category;
         this.itemType = itemType;
         this.sourceType = sourceType;
+        if (infoSource == null) {
+            throw new IllegalArgumentException("옷 정보 출처는 필수입니다.");
+        }
+        this.infoSource = infoSource;
         this.externalSource = externalSource;
         this.externalProductId = externalProductId;
         this.externalProductUrl = externalProductUrl;
@@ -166,6 +176,7 @@ public void convertToOwned(String productCode, Boolean isVerified) {
             throw new IllegalArgumentException("미보유 옷만 보유 옷으로 전환할 수 있습니다.");
         }
         this.sourceType = SourceType.OWNED;
+        this.infoSource = ClothesInfoSource.PURCHASE_HISTORY;
         this.externalSource = EXTERNAL_NONE;
         this.externalProductId = EXTERNAL_NONE;
         this.externalProductUrl = EXTERNAL_NONE;
diff --git a/src/main/java/com/closetnangam/be/domain/clothes/entity/WardrobeClothes.java b/src/main/java/com/closetnangam/be/domain/clothes/entity/WardrobeClothes.java
@@ -1,7 +1,7 @@
 package com.closetnangam.be.domain.clothes.entity;
 
+import com.closetnangam.be.domain.clothes.enums.ClothesInfoSource;
 import com.closetnangam.be.domain.clothes.enums.OwnershipStatus;
-import com.closetnangam.be.domain.clothes.enums.RegistrationSource;
 import com.closetnangam.be.domain.wardrobe.entity.Wardrobe;
 import com.closetnangam.be.global.common.entity.BaseEntity;
 import jakarta.persistence.Column;
@@ -52,9 +52,10 @@ public class WardrobeClothes extends BaseEntity {
     @Column(nullable = false)
     private Boolean favorite = false;
 
+    /** clothes.info_source와 동기화되는 비정규화 컬럼(레거시). 빌더에서 clothes 기준으로만 설정합니다. */
     @Enumerated(EnumType.STRING)
     @Column(name = "registration_source", nullable = false, length = 50)
-    private RegistrationSource registrationSource;
+    private ClothesInfoSource registrationSource;
 
     @Column(name = "user_image_url", nullable = false, length = 500)
     private String userImageUrl;
@@ -67,7 +68,6 @@ private WardrobeClothes(
             String size,
             String season,
             Boolean favorite,
-            RegistrationSource registrationSource,
             String userImageUrl
     ) {
         this.wardrobe = wardrobe;
@@ -76,8 +76,11 @@ private WardrobeClothes(
         this.size = size;
         this.season = season;
         this.favorite = favorite != null ? favorite : false;
-        this.registrationSource = registrationSource;
         this.userImageUrl = userImageUrl;
+        if (clothes.getInfoSource() == null) {
+            throw new IllegalArgumentException("옷 정보 출처가 설정되지 않았습니다.");
+        }
+        this.registrationSource = clothes.getInfoSource();
     }
 
     public void updateFavorite(Boolean favorite) {
@@ -95,5 +98,6 @@ public void convertToOwned(String size, String season, String userImageUrl) {
         this.size = size;
         this.season = season;
         this.userImageUrl = userImageUrl;
+        this.registrationSource = this.clothes.getInfoSource();
     }
 }
diff --git a/src/main/java/com/closetnangam/be/domain/clothes/enums/ClothesInfoSource.java b/src/main/java/com/closetnangam/be/domain/clothes/enums/ClothesInfoSource.java
@@ -0,0 +1,15 @@
+package com.closetnangam.be.domain.clothes.enums;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum ClothesInfoSource {
+
+    PHOTO("사진 기반 등록"),
+    PURCHASE_HISTORY("구매 내역 기반 등록"),
+    EXTERNAL_SHOPPING("외부 쇼핑몰 등록");
+
+    private final String label;
+}
diff --git a/src/main/java/com/closetnangam/be/domain/clothes/enums/RegistrationSource.java b/src/main/java/com/closetnangam/be/domain/clothes/enums/RegistrationSource.java
diff --git a/src/main/java/com/closetnangam/be/domain/clothes/helper/ClothesTagHelper.java b/src/main/java/com/closetnangam/be/domain/clothes/helper/ClothesTagHelper.java
@@ -36,6 +36,10 @@ public void validateClassification(
         categoryCatalogService.validateStyleCodes(styles);
     }
 
+    public void validateExternalSource(String externalSource) {
+        categoryCatalogService.validateExternalSource(externalSource);
+    }
+
     public void applyColorTags(Clothes clothes, String primaryColor, List<String> secondaryColors) {
         buildColorTags(clothes, primaryColor, secondaryColors).forEach(clothes::addColorTag);
     }
diff --git a/src/main/java/com/closetnangam/be/domain/clothes/service/ClothesService.java b/src/main/java/com/closetnangam/be/domain/clothes/service/ClothesService.java
diff --git a/src/main/java/com/closetnangam/be/domain/clothes/service/PhotoClothesRegistrationService.java b/src/main/java/com/closetnangam/be/domain/clothes/service/PhotoClothesRegistrationService.java
diff --git a/src/main/resources/db/migration-info-source-enum.sql b/src/main/resources/db/migration-info-source-enum.sql
diff --git a/src/main/resources/db/migration.sql b/src/main/resources/db/migration.sql
