[Feature] 경매 상세 api swagger 이넘 추가 (#15)

* feature: 경매 상세 api swagger 구현

* feature: 경매 상세 api swagger 인터페이스 구현

* feature: 경매 상세 응답 dto 생성

* chore: 중복 제거

* chore: 누락된 스키마 추가

* chore: 누락 어노테이션 추가 및 주석 추가

* chore: 불필요한 파일 ignore 설정

* feature: 경매 상태 변경 이넘

* feature: 판매자 감정표현 이모지 이넘

* refactor: 생성된 이넘 적용

* refactor: 감정표현 이모지 이넘 적용

Author: dpwl0974

src/main/java/com/windfall/api/auction/controller/AuctionController.java

@@ -2,6 +2,7 @@
 
 import com.windfall.api.auction.dto.response.AuctionDetailResponse;
 import com.windfall.api.auction.dto.response.AuctionHistoryResponse;
+import com.windfall.domain.auction.enums.EmojiType;
 import com.windfall.global.response.ApiResponse;
 import lombok.RequiredArgsConstructor;
 import org.springframework.web.bind.annotation.GetMapping;
@@ -43,7 +44,7 @@ public ApiResponse<AuctionHistoryResponse> getAuctionHistory(
   @PostMapping("/{auctionId}/emojis/{emojiType}")
   public ApiResponse<Void> sendEmoji(
       @PathVariable Long auctionId,
-      @PathVariable String emojiType,
+      @PathVariable EmojiType emojiType,
       @RequestBody Long userId) {
 
     //TODO: Redis Pub/Sub으로 이모지 발생 로직 구현

src/main/java/com/windfall/api/auction/controller/AuctionSpecification.java

@@ -2,6 +2,7 @@
 
 import com.windfall.api.auction.dto.response.AuctionDetailResponse;
 import com.windfall.api.auction.dto.response.AuctionHistoryResponse;
+import com.windfall.domain.auction.enums.EmojiType;
 import com.windfall.global.response.ApiResponse;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.Parameter;
@@ -33,7 +34,7 @@ ApiResponse<Void> sendEmoji(
       @PathVariable Long auctionId,
 
       @Parameter(description = "이모지 타입", required = true, example = "LIKE")
-      @PathVariable String emojiType,
+      @PathVariable EmojiType emojiType,
 
       @Parameter(description = "사용자 ID", required = true, example = "42")
       @RequestBody Long userId

src/main/java/com/windfall/api/auction/dto/response/AuctionDetailResponse.java

@@ -1,5 +1,7 @@
 package com.windfall.api.auction.dto.response;
 
+import com.windfall.domain.auction.enums.AuctionCategory;
+import com.windfall.domain.auction.enums.AuctionStatus;
 import io.swagger.v3.oas.annotations.media.Schema;
 import java.time.LocalDateTime;
 import java.util.List;
@@ -17,7 +19,7 @@ public record AuctionDetailResponse(
     String description,
 
     @Schema(description = "카테고리", example = "피규어")
-    String category,
+    AuctionCategory category,
 
     @Schema(description = "상품 이미지 URL 목록", example = "[\"https://example.com/image1.jpg\"]")
     List<String> imageUrls,
@@ -38,7 +40,7 @@ public record AuctionDetailResponse(
     double discountRate,
 
     @Schema(description = "경매 상태", example = "ONGOING")
-    String status,
+    AuctionStatus status,
 
     @Schema(description = "찜 수", example = "25")
     int likeCount,

src/main/java/com/windfall/domain/auction/enums/AuctionStatus.java

@@ -1,5 +1,17 @@
 package com.windfall.domain.auction.enums;
 
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
 public enum AuctionStatus {
-  END, START
+
+  SCHEDULED("경매 예정"),
+  PROCESS("경매 진행 중"),
+  COMPLETED("낙찰 완료"),
+  FAILED("유찰"),
+  CANCELED("경매 취소");
+
+  private final String description;
 }

src/main/java/com/windfall/domain/auction/enums/EmojiType.java

@@ -0,0 +1,13 @@
+package com.windfall.domain.auction.enums;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public enum EmojiType {
+  LIKE,
+  FIRE,
+  SAD,
+  SMILE;
+}