✨ feat/custom/KIKI-73-BE-추천 : 키보드 추천 튜토리얼, 유사상품 리스트 조회 구현 #67

build.gradle

@@ -4,7 +4,7 @@ plugins {
 	id 'io.spring.dependency-management' version '1.1.7'
 }
 
-group = 'com.jiyoung.kikihi'
+group = 'site.kikihi.custom'
 version = '0.0.1-SNAPSHOT'
 
 java {

src/main/java/site/kikihi/custom/platform/adapter/in/web/RecommendationController.java

@@ -1,16 +1,17 @@
 package site.kikihi.custom.platform.adapter.in.web;
 
+import jakarta.validation.Valid;
+import org.springframework.web.bind.annotation.*;
 import site.kikihi.custom.global.response.ApiResponse;
+import site.kikihi.custom.platform.adapter.in.web.dto.request.product.KeyboardRecommendationRequest;
+import site.kikihi.custom.platform.adapter.in.web.dto.response.product.KeyboardRecommendationResponse;
 import site.kikihi.custom.platform.adapter.in.web.dto.response.product.ProductListResponse;
 import site.kikihi.custom.platform.adapter.in.web.swagger.RecommendControllerSpec;
 import site.kikihi.custom.platform.application.in.recommendation.RecommendationUseCase;
 import site.kikihi.custom.platform.domain.product.Product;
 import site.kikihi.custom.security.oauth2.domain.PrincipalDetails;
 import lombok.RequiredArgsConstructor;
 import org.springframework.security.core.annotation.AuthenticationPrincipal;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
 import java.util.UUID;
@@ -43,6 +44,41 @@ public ApiResponse<List<ProductListResponse>> getProductRecommendation(
         return ApiResponse.ok(ProductListResponse.from(recommendation));
     }
 
+    /**
+     * 튜토리얼 키보드 추천 API
+     */
+    @PostMapping("/tutorial")
+    public ApiResponse<List<KeyboardRecommendationResponse>> getTutorialKeyboardRecommendation(
+            @AuthenticationPrincipal PrincipalDetails principalDetails,
+            @Valid @RequestBody KeyboardRecommendationRequest request
+    ) {
+
+        // 유저가 존재하면 넣기
+        UUID userId = principalDetails != null ? principalDetails.getId() : null;
+
+        // 튜토리얼 키보드 추천 서비스 호출
+        List<KeyboardRecommendationResponse> recommendation = service.getTutorialKeyboardRecommendation(userId,request);
+
+        // 응답 주기
+        return ApiResponse.ok(recommendation);
+    }
 
 
+    /**
+     * 유사한 상품 추천
+     */
+    @GetMapping("/{productId}")
+    public ApiResponse<List<KeyboardRecommendationResponse>> getSimilarProducts(
+            @PathVariable("productId") String productId,
+            @AuthenticationPrincipal PrincipalDetails principalDetails
+    ) {
+        // 유저가 존재하면 넣기
+        UUID userId = principalDetails != null ? principalDetails.getId() : null;
+
+        // 유사한 상품 추천 서비스 호출
+        List<Product> similarProducts = service.getSimilarProducts(userId,productId);
+
+        // 응답 주기
+        return ApiResponse.ok(KeyboardRecommendationResponse.from(similarProducts));
+    }
 }

src/main/java/site/kikihi/custom/platform/adapter/in/web/converter/KeyboardOptionsConverter.java

@@ -0,0 +1,69 @@
+package site.kikihi.custom.platform.adapter.in.web.converter;
+
+import site.kikihi.custom.platform.adapter.in.web.dto.request.product.KeyboardOptions;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+public class KeyboardOptionsConverter {
+
+    // Size enum → description 검색 키워드 맵핑
+    public static String mapSizeToDescription(KeyboardOptions.Size size) {
+        if (size == null) return null;
+        return switch (size) {
+            case TENKEYLESS -> "텐키리스";
+            case FULL -> "풀배열";
+            case MINI -> "미니";
+        };
+    }
+
+    // SwitchType enum → options.option_name 중 매칭되는 문자열 배열 리턴
+    public static List<String> mapSwitchTypeToOptionNames(KeyboardOptions.SwitchType switchType) {
+        if (switchType == null) return Collections.emptyList();
+
+        return switch (switchType) {
+            case SILENT -> Arrays.asList(
+                    "저소음 적축", "저소음 갈축", "저소음 흑축",
+                    "저소음 바다축", "저소음 잉크축", "저소음 바닐라축",
+                    "저소음 딸기축", "저소음 바나나축"
+            );
+            case NORMAL -> Arrays.asList(
+                    "갈축",  "바나나축", "바닐라축",
+                    "핑크축", "레몬축", "딸기축", "경해축",
+                    "잉크축 V2", "모가축", "판다축",
+                    "바다축", "라벤더축", "체리 스피드 실버",
+                    "리니어 옵티컬"
+            );
+            case LOUD -> Arrays.asList(
+                    "청축", "녹축","백축","clicky"
+            );
+            case SMOOTH -> Arrays.asList(
+                    "적축", "흑축", "자석축", "광축",
+                    "실버축", "스피드 적축", "잉크축",
+                    "바다축", "바닐라축", "체리 리니어 옵티컬",
+                    "라떼축", "모카축", "사파이어축","밀키축",
+                    "무지개축", "크림축"
+            );
+        };
+
+    }
+
+    // Layout enum → description 검색 키워드 맵핑
+    public static String mapLayoutToDescription(KeyboardOptions.Layout layout) {
+        if (layout == null) return null;
+        return switch (layout) {
+            case ERGONOMIC -> "스텝스컬쳐2";
+            case SIMPLE -> "로우프로파일(LP)";
+        };
+    }
+
+    // 키압에서 g빼기
+    public static Integer mapKeyPressureToSpecTable(KeyboardOptions.KeyPressure keyPressure) {
+        if (keyPressure == null) return null;
+        return switch (keyPressure) {
+            case LIGHT -> 49;
+            case NORMAL -> 50;
+        };
+    }
+}

src/main/java/site/kikihi/custom/platform/adapter/in/web/dto/request/product/KeyboardOptions.java

@@ -0,0 +1,135 @@
+package site.kikihi.custom.platform.adapter.in.web.dto.request.product;
+
+import com.fasterxml.jackson.annotation.JsonValue;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+@Schema(
+        name = "[요청][상품] 키보드 옵션 Enum",
+        description = "키보드 추천 서비스에서 사용하는 키보드 옵션 Enum입니다."
+)
+public class KeyboardOptions {
+
+    @Getter
+    @RequiredArgsConstructor
+    @Schema(name = "[요청][상품] 배열(Size) Enum", description = "키보드 배열 옵션")
+    public enum Size {
+        @Schema(description = "텐키리스 배열", example = "tenkeyless")
+        TENKEYLESS("tenkeyless"),
+
+        @Schema(description = "풀배열", example = "full")
+        FULL("full"),
+
+        @Schema(description = "미니 배열", example = "mini")
+        MINI("mini");
+
+        private final String value;
+
+        @JsonValue
+        public String getValue() {
+            return value;
+        }
+    }
+
+    @Getter
+    @RequiredArgsConstructor
+    @Schema(name = "[요청][상품] 키압(Key Pressure) Enum", description = "키압 옵션")
+    public enum KeyPressure {
+        @Schema(description = "가벼운 키압 (50g 미만)", example = "light")
+        LIGHT("light"),
+
+        @Schema(description = "보통 키압 (50g 이상)", example = "normal")
+        NORMAL("normal");
+
+        private final String value;
+
+        @JsonValue
+        public String getValue() {
+            return value;
+        }
+    }
+
+    @Getter
+    @RequiredArgsConstructor
+    @Schema(name = "[요청][상품] 키압(Key Pressure) Enum", description = "키압 옵션")
+    public enum Layout {
+        @Schema(description = "인체공학적 (스텝스컬쳐2)", example = "egonomic")
+        ERGONOMIC("egonomic"),
+
+        @Schema(description = "심플하고 깔끔한 (low 프로파일)", example = "simple")
+        SIMPLE("simple");
+
+        private final String value;
+
+        @JsonValue
+        public String getValue() {
+            return value;
+        }
+    }
+
+    @Getter
+    @RequiredArgsConstructor
+    @Schema(name = "[요청][상품] 스위치 종류(Switch Type) Enum", description = "스위치 종류 옵션")
+    public enum SwitchType {
+
+        @Schema(description = "조용한", example = "silent")
+        SILENT("silent"),
+
+        @Schema(description = "적당한", example = "normal")
+        NORMAL("normal"),
+
+        @Schema(description = "강한", example = "loud")
+        LOUD("loud"),
+
+        @Schema(description = "부드러운", example = "smooth")
+        SMOOTH("smooth");
+
+        private final String value;
+
+        @JsonValue
+        public String getValue() {
+            return value;
+        }
+    }
+
+    @Getter
+    @RequiredArgsConstructor
+    @Schema(name = "[요청][상품] 흡음재 여부 Enum", description = "흡음재 유무 옵션")
+    public enum SoundDampener {
+        @Schema(description = "흡음재 있음", example = "○")
+        YES("○"),
+
+        @Schema(description = "흡음재 없음", example = "X")
+        NO("X");
+
+        private final String value;
+
+        @JsonValue
+        public String getValue() {
+            return value;
+        }
+    }
+
+    @Getter
+    @RequiredArgsConstructor
+    @Schema(name = "[요청][상품] RGB 여부 Enum", description = "RGB 유무 옵션")
+    public enum RGB {
+        @Schema(description = "RGB 있음", example = "○")
+        YES("○"),
+
+        @Schema(description = "RGB 없음", example = "X")
+        NO("X");
+
+        private final String value;
+
+        @JsonValue
+        public String getValue() {
+            return value;
+        }
+    }
+
+
+}

src/main/java/site/kikihi/custom/platform/adapter/in/web/dto/request/product/KeyboardRecommendationRequest.java

@@ -0,0 +1,35 @@
+package site.kikihi.custom.platform.adapter.in.web.dto.request.product;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Getter;
+import lombok.Setter;
+
+@Getter
+@Setter
+@Schema(name = "[요청][상품] 키보드 추천 요청 DTO", description = "키보드 추천 요청에 사용하는 DTO입니다.")
+public class KeyboardRecommendationRequest {
+
+    @Schema(description = "키보드 배열(Size) 옵션", example = "ten", required = true)
+    private KeyboardOptions.Size size;
+
+    @Schema(description = "키압(Key Pressure) 옵션", example = "light", required = true)
+    private KeyboardOptions.KeyPressure keyPressure;
+
+    @Schema(description = "레이아웃 종류(Layout) 옵션", example = "egonomic", required = true)
+    private KeyboardOptions.Layout layout;
+
+    @Schema(description = "스위치 종류(Switch Type) 옵션", example = "silent", required = true)
+    private KeyboardOptions.SwitchType switchType;
+
+    @Schema(description = "흡음재(Sound Dampener) 적용 여부", example = "○", required = true)
+    private KeyboardOptions.SoundDampener soundDampener;
+
+    @Schema(description = "RGB 적용 여부", example = "○", required = true)
+    private KeyboardOptions.RGB rgb;
+
+    @Schema(description = "최소 가격 (단위: 원)", example = "0", required = true)
+    private int minPrice;
+
+    @Schema(description = "최대 가격 (단위: 원)", example = "200000", required = true)
+    private int maxPrice;
+}

src/main/java/site/kikihi/custom/platform/adapter/in/web/dto/response/product/KeyboardRecommendationResponse.java

@@ -0,0 +1,68 @@
+package site.kikihi.custom.platform.adapter.in.web.dto.response.product;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+import site.kikihi.custom.platform.domain.product.Product;
+
+import java.util.List;
+
+/**
+ * 상품 상세 응답 DTO
+ *
+ * @param id                 상품 ID
+ * @param thumbnail          상품 썸네일
+ * @param manufacturerName   제조사명
+ * @param productName        제품명
+ * @param price
+ * @param likedByMe          나의 북마크 여부
+ */
+
+@Builder
+@Schema(name = "KeyboardRecommendationListResponse", description = "튜토리얼 키보드 추천 리스트 응답")
+public record KeyboardRecommendationResponse(
+
+        @Schema(description = "상품 아이디", example = "101")
+        String id,
+
+        @Schema(description = "상품 썸네일 이미지 URL", example = "https://example.com/product/101.jpg")
+        String thumbnail,
+
+        @Schema(description = "제조사명", example = "독거미")
+        String manufacturerName,
+
+        @Schema(description = "제품명", example = "독거미 Aula F99")
+        String productName,
+
+        @Schema(description = "정상가(원)", example = "599000.0")
+        double price,
+
+        @Schema(description = "북마크(좋아요)한 상품 여부", example = "true")
+        boolean likedByMe
+
+) {
+
+    /// 정적 팩토리 메서드
+    // 단일 객체 변환 메서드 추가
+    public static KeyboardRecommendationResponse from(Product product) {
+        return KeyboardRecommendationResponse.builder()
+                .id(product.getId())
+                .thumbnail(product.getThumbnail())
+                .manufacturerName(product.getManufacturer())
+                .productName(product.getName())
+                .price(product.getPrice())
+                .likedByMe(false)
+                .build();
+    }
+
+
+    // 기존 리스트 변환 메서드는 그대로 유지
+    public static List<KeyboardRecommendationResponse> from(List<Product> productList) {
+        return productList.stream()
+                .map(KeyboardRecommendationResponse::from) // 단일 객체 변환 메서드 호출
+                .toList();
+    }
+
+
+
+}
+