feat: Swagger 설정 및 모집글 API 문서화 완료

recruitment-service/build.gradle

@@ -1,7 +1,7 @@
 plugins {
 	id 'java'
-	id 'org.springframework.boot' version '3.4.5'
-	id 'io.spring.dependency-management' version '1.1.7'
+	id 'org.springframework.boot' version '3.1.5'
+	id 'io.spring.dependency-management' version '1.1.3'
 }
 
 group = 'com.example'
@@ -28,6 +28,7 @@ dependencies {
 	implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
 	implementation 'org.springframework.boot:spring-boot-starter-web'
 	implementation 'org.springframework.boot:spring-boot-starter-validation'
+	implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.2.0'
 	compileOnly 'org.projectlombok:lombok'
 	developmentOnly 'org.springframework.boot:spring-boot-devtools'
 	runtimeOnly 'com.mysql:mysql-connector-j'

recruitment-service/src/main/java/com/example/recruitment/controller/SwaggerTestController.java

@@ -0,0 +1,14 @@
+package com.example.recruitment.controller;
+
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/swagger-test")
+public class SwaggerTestController {
+    @GetMapping
+    public String test() {
+        return "Swagger works!";
+    }
+}

recruitment-service/src/main/java/com/example/recruitment/dto/RecruitmentRequestDto.java

@@ -27,25 +27,7 @@ public class RecruitmentRequestDto {
 
     @NotNull(message = "마감 시간은 필수입니다.")
     private LocalDateTime deadlineTime;
-}
-
-
-
-//원래 dto 코드
-/*
- * package com.example.recruitment.dto;
 
-import java.time.LocalDateTime;
-
-import lombok.Getter;
-import lombok.Setter;
-
-@Getter @Setter
-public class RecruitmentRequestDto {
-    private Long userId;
-    private Long storeId;
-    private String title;
-    private String description;
-    private LocalDateTime deadlineTime;
+    @NotBlank(message = "카테고리는 비어 있을 수 없습니다.")
+    private String category;
 }
- */

recruitment-service/src/main/java/com/example/recruitment/entity/MenuItem.java

@@ -0,0 +1,14 @@
+package com.example.recruitment.entity;
+
+import jakarta.persistence.Embeddable;
+import lombok.*;
+
+@Embeddable
+@Getter @Setter
+@NoArgsConstructor
+@AllArgsConstructor
+public class MenuItem {
+
+    private String name;
+    private int price;
+}

recruitment-service/src/main/java/com/example/recruitment/entity/Order.java

@@ -0,0 +1,29 @@
+package com.example.recruitment.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.util.List;
+
+@Entity
+@Table(name = "orders")
+@Getter @Setter
+@NoArgsConstructor
+@AllArgsConstructor
+public class Order {
+
+    @Id @GeneratedValue
+    private Long id;
+
+    @ManyToOne
+    private Recruitment recruitment; // 어떤 모집글에 대한 주문인지
+
+    @ManyToOne
+    private User user; // 누가 주문했는지
+
+    @ElementCollection
+    @CollectionTable(name = "order_menu_items", joinColumns = @JoinColumn(name = "order_id"))
+    private List<MenuItem> menuItems; // 메뉴 리스트 (내장 객체로 구성)
+
+    private int totalPrice; // 총 가격
+}

recruitment-service/src/main/java/com/example/recruitment/entity/Recruitment.java

@@ -24,9 +24,14 @@ public class Recruitment {
     @OneToMany(mappedBy = "recruitment", cascade = CascadeType.ALL, orphanRemoval = true)
     private List<RecruitmentParticipant> participants;
 
-
     private String title;
     private String description;
+
     private String status;  // RECRUITING, CONFIRMED 등
+
     private LocalDateTime deadlineTime;
+
+    //카테고리 추가가
+    @Column(nullable = false)
+    private String category;
 }

recruitment-service/src/main/java/com/example/recruitment/exception/GlobalExceptionHandler.java

@@ -1,13 +1,13 @@
 package com.example.recruitment.exception;
 
+import com.example.recruitment.common.ApiResponse;
+import com.example.recruitment.common.FieldErrorDetail;
+import jakarta.servlet.http.HttpServletRequest;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.MethodArgumentNotValidException;
 import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.bind.annotation.RestControllerAdvice;
 
-import com.example.recruitment.common.ApiResponse;
-import com.example.recruitment.common.FieldErrorDetail;
-
 import java.util.List;
 
 @RestControllerAdvice
@@ -21,7 +21,7 @@ public ResponseEntity<ApiResponse<Object>> handleCustomException(CustomException
                 .body(ApiResponse.fail(ec.getCode(), ec.getMessage(), ec.getStatus()));
     }
 
-    //유효성 검사 실패
+    // 유효성 검사 실패
     @ExceptionHandler(MethodArgumentNotValidException.class)
     public ResponseEntity<ApiResponse<Object>> handleValidationException(MethodArgumentNotValidException e) {
         List<FieldErrorDetail> errorList = e.getBindingResult().getFieldErrors()
@@ -34,8 +34,17 @@ public ResponseEntity<ApiResponse<Object>> handleValidationException(MethodArgum
                 .body(ApiResponse.validationFail(errorList));
     }
 
+    // 그 외 모든 예외 처리
     @ExceptionHandler(Exception.class)
-    public ResponseEntity<ApiResponse<Object>> handleGeneralException(Exception e) {
+    public ResponseEntity<ApiResponse<Object>> handleGeneralException(Exception e, HttpServletRequest request) throws Exception {
+        String path = request.getRequestURI();
+
+        if (path != null && (path.contains("/v3/api-docs") || path.contains("/swagger"))) {
+    throw e; // Swagger 요청은 예외 처리하지 않고 Spring에게 맡김
+}
+
+
+
         return ResponseEntity
                 .status(ErrorCode.INTERNAL_ERROR.getStatus())
                 .body(ApiResponse.fail(
@@ -45,5 +54,3 @@ public ResponseEntity<ApiResponse<Object>> handleGeneralException(Exception e) {
                 ));
     }
 }
-
-

recruitment-service/src/main/java/com/example/recruitment/repository/OrderRepository.java

@@ -0,0 +1,7 @@
+package com.example.recruitment.repository;
+
+import com.example.recruitment.entity.Order;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface OrderRepository extends JpaRepository<Order, Long> {
+}