feat: 개별 메뉴 조회 API 추가 및 menuUrl 필드 검증 강화

src/main/java/com/campustable/be/domain/menu/controller/MenuController.java

@@ -18,6 +18,7 @@
 @RequiredArgsConstructor
 public class MenuController implements MenuControllerDocs {
 
+
     private final MenuService menuService;
 
 
@@ -44,16 +45,23 @@ public ResponseEntity<List<MenuResponse>> getAllMenusByCategoryId(
 
     }
 
-  @Override
-  @LogMonitoringInvocation
-  @GetMapping("/cafeteria/{cafeteria-id}")
-  public ResponseEntity<List<MenuResponse>> getAllMenusByCafeteriaId(
-    @PathVariable(name = "cafeteria-id") Long cafeteriaId
-  ) {
-    return ResponseEntity.ok(menuService.getAllMenusByCafeteriaId(cafeteriaId));
-  }
+    @Override
+    @LogMonitoringInvocation
+    @GetMapping("/{menuId}")
+    public ResponseEntity<MenuResponse> getMenuById(@PathVariable Long menuId){
+      return ResponseEntity.ok(menuService.getMenuById(menuId));
+    }
 
-  @Override
+    @Override
+    @LogMonitoringInvocation
+    @GetMapping("/cafeteria/{cafeteria-id}")
+    public ResponseEntity<List<MenuResponse>> getAllMenusByCafeteriaId(
+      @PathVariable(name = "cafeteria-id") Long cafeteriaId
+    ) {
+      return ResponseEntity.ok(menuService.getAllMenusByCafeteriaId(cafeteriaId));
+    }
+
+    @Override
     @PostMapping
     @LogMonitoringInvocation
     public ResponseEntity<MenuResponse> createMenu(@Valid @RequestBody MenuRequest createRequest){

src/main/java/com/campustable/be/domain/menu/controller/MenuControllerDocs.java

@@ -15,68 +15,112 @@
 
 import java.util.List;
 
-@Tag(name = "Menu Management", description = "메뉴 CURD 및 조회 API")
+/**
+ * 메뉴 관리 시스템의 API 명세를 정의하는 인터페이스입니다.
+ * 메뉴의 등록, 수정, 삭제 및 다양한 조건별 조회 기능을 제공합니다.
+ */
+@Tag(name = "Menu Management", description = "메뉴 CRUD 및 조회 API")
 public interface MenuControllerDocs {
 
-    @Operation(summary = "메뉴 전체 조회", description = "모든 메뉴 목록을 조회합니다.")
-    @ApiResponse(responseCode = "200", description = "조회 성공")
-    ResponseEntity<List<MenuResponse>> getAllMenus();
+  /**
+   * 시스템에 등록된 모든 메뉴 목록을 조회합니다.
+   * * @return 메뉴 정보 리스트를 담은 ResponseEntity
+   */
+  @Operation(summary = "메뉴 전체 조회", description = "모든 메뉴 목록을 조회합니다.")
+  @ApiResponse(responseCode = "200", description = "조회 성공")
+  ResponseEntity<List<MenuResponse>> getAllMenus();
 
-    @Operation(summary = "카테고리별 메뉴 조회", description = "특정 카테고리 ID에 해당하는 메뉴 목록을 조회합니다.")
-    @ApiResponses({
-            @ApiResponse(responseCode = "200", description = "조회 성공"),
-            @ApiResponse(responseCode = "404", description = "해당 카테고리를 찾을 수 없습니다.", content = @Content(schema = @Schema(implementation = ErrorResponse.class)))
-    })
-    ResponseEntity<List<MenuResponse>> getAllMenusByCategoryId(
-            @Parameter(description = "조회할 카테고리 ID", example = "1")
-            Long categoryId
-    );
+  /**
+   * 고유 식별자를 통해 단일 메뉴의 상세 정보를 조회합니다.
+   * * @param menuId 조회하고자 하는 메뉴의 ID
+   * @return 해당 메뉴의 상세 정보를 담은 ResponseEntity
+   */
+  @Operation(summary = "단일 메뉴 상세 조회", description = "특정 ID에 해당하는 메뉴의 상세 정보를 조회합니다.")
+  @ApiResponses({
+      @ApiResponse(responseCode = "200", description = "조회 성공"),
+      @ApiResponse(responseCode = "404", description = "해당 메뉴를 찾을 수 없습니다.",
+          content = @Content(schema = @Schema(implementation = ErrorResponse.class)))
+  })
+  ResponseEntity<MenuResponse> getMenuById(
+      @Parameter(description = "조회할 메뉴 ID", example = "1") Long menuId
+  );
 
-    @Operation(summary = "식당별 메뉴 조회", description = "식당 ID에 해당하는 메뉴 목록을 조회합니다.")
-    ResponseEntity<List<MenuResponse>> getAllMenusByCafeteriaId(
-      @Parameter(description = "조회할 식당 ID", example = "1")
-      Long cafeteriaId
-    );
+  /**
+   * 특정 카테고리에 속한 모든 메뉴를 조회합니다.
+   * * @param categoryId 카테고리 고유 식별자
+   * @return 해당 카테고리의 메뉴 리스트를 담은 ResponseEntity
+   */
+  @Operation(summary = "카테고리별 메뉴 조회", description = "특정 카테고리 ID에 해당하는 메뉴 목록을 조회합니다.")
+  @ApiResponses({
+      @ApiResponse(responseCode = "200", description = "조회 성공"),
+      @ApiResponse(responseCode = "404", description = "해당 카테고리를 찾을 수 없습니다.",
+          content = @Content(schema = @Schema(implementation = ErrorResponse.class)))
+  })
+  ResponseEntity<List<MenuResponse>> getAllMenusByCategoryId(
+      @Parameter(description = "조회할 카테고리 ID", example = "1") Long categoryId
+  );
 
-    @Operation(
-            summary = "신규 메뉴 생성 (관리자 전용)",
-            description = "새로운 메뉴를 등록합니다."
-    )
-    @ApiResponses({
-            @ApiResponse(responseCode = "201", description = "메뉴 생성 성공"),
-            @ApiResponse(responseCode = "400", description = "입력값 오류(이름/가격/사용 가능)",
-            content = @Content(schema = @Schema(implementation = ErrorResponse.class))),
-            @ApiResponse(responseCode = "409", description = "해당 카테고리에 이미 존재하는 메뉴입니다.",
-            content = @Content(schema = @Schema(implementation = ErrorResponse.class)))
-    })
-    ResponseEntity<MenuResponse> createMenu(MenuRequest menuRequest);
+  /**
+   * 특정 식당에서 제공하는 모든 메뉴를 조회합니다.
+   * * @param cafeteriaId 식당 고유 식별자
+   * @return 해당 식당의 메뉴 리스트를 담은 ResponseEntity
+   */
+  @Operation(summary = "식당별 메뉴 조회", description = "식당 ID에 해당하는 메뉴 목록을 조회합니다.")
+  @ApiResponses({
+      @ApiResponse(responseCode = "200", description = "조회 성공"),
+      @ApiResponse(responseCode = "404", description = "해당 식당을 찾을 수 없습니다.",
+          content = @Content(schema = @Schema(implementation = ErrorResponse.class)))
+  })
+  ResponseEntity<List<MenuResponse>> getAllMenusByCafeteriaId(
+      @Parameter(description = "조회할 식당 ID", example = "1") Long cafeteriaId
+  );
 
-    @Operation(
-            summary = "메뉴 정보 수정(관리자 전용)",
-            description = "특정 ID의 메뉴 정보를 수정합니다."
-    )
-    @ApiResponses({
-            @ApiResponse(responseCode = "200", description = "메뉴 수정 성공"),
-            @ApiResponse(responseCode = "400", description = "입력값 오류" ,
-            content = @Content(schema = @Schema(implementation = ErrorResponse.class)))
-    })
-    ResponseEntity<MenuResponse> updateMenu(
-            @Parameter(description = "수정할 메뉴의 ID", example = "1")
-            Long menuId,
-            MenuUpdateRequest menuUpdateRequest
-    );
+  /**
+   * 새로운 메뉴를 시스템에 등록합니다. (관리자 권한 필요)
+   * * @param menuRequest 생성할 메뉴의 상세 정보 DTO
+   * @return 생성된 메뉴 정보를 담은 ResponseEntity
+   */
+  @Operation(summary = "신규 메뉴 생성 (관리자 전용)", description = "새로운 메뉴를 등록합니다.")
+  @ApiResponses({
+      @ApiResponse(responseCode = "201", description = "메뉴 생성 성공"),
+      @ApiResponse(responseCode = "400", description = "입력값 오류(이름/가격 등)",
+          content = @Content(schema = @Schema(implementation = ErrorResponse.class))),
+      @ApiResponse(responseCode = "409", description = "이미 존재하는 메뉴입니다.",
+          content = @Content(schema = @Schema(implementation = ErrorResponse.class)))
+  })
+  ResponseEntity<MenuResponse> createMenu(MenuRequest menuRequest);
 
-    @Operation(
-            summary = "메뉴 삭제 (관리자 전용)",
-            description = "특정 ID의 메뉴를 삭제 합니다."
-    )
-    @ApiResponses({
-            @ApiResponse(responseCode = "204", description = "메뉴 삭제 성공"),
-            @ApiResponse(responseCode = "404", description = "해당 메뉴를 찾을 수 없습니다.",
-            content = @Content(schema = @Schema(implementation = ErrorResponse.class)))
-    })
-    ResponseEntity<Void> deleteMenu(
-            @Parameter(description = "삭제할 메뉴의 ID", example = "1")
-            Long menuId
-    );
-}
+  /**
+   * 기존 메뉴 정보를 수정합니다. (관리자 권한 필요)
+   * * @param menuId 수정할 메뉴의 ID
+   * @param menuUpdateRequest 수정할 내용이 담긴 DTO
+   * @return 수정 완료된 메뉴 정보를 담은 ResponseEntity
+   */
+  @Operation(summary = "메뉴 정보 수정 (관리자 전용)", description = "특정 ID의 메뉴 정보를 수정합니다.")
+  @ApiResponses({
+      @ApiResponse(responseCode = "200", description = "메뉴 수정 성공"),
+      @ApiResponse(responseCode = "400", description = "입력값 오류",
+          content = @Content(schema = @Schema(implementation = ErrorResponse.class))),
+      @ApiResponse(responseCode = "404", description = "해당 메뉴를 찾을 수 없습니다.",
+          content = @Content(schema = @Schema(implementation = ErrorResponse.class)))
+  })
+  ResponseEntity<MenuResponse> updateMenu(
+      @Parameter(description = "수정할 메뉴 ID", example = "1") Long menuId,
+      MenuUpdateRequest menuUpdateRequest
+  );
+
+  /**
+   * 특정 메뉴를 시스템에서 삭제합니다. (관리자 권한 필요)
+   * * @param menuId 삭제할 메뉴의 ID
+   * @return 삭제 성공 시 빈 바디를 담은 ResponseEntity (204 No Content)
+   */
+  @Operation(summary = "메뉴 삭제 (관리자 전용)", description = "특정 ID의 메뉴를 삭제합니다.")
+  @ApiResponses({
+      @ApiResponse(responseCode = "204", description = "메뉴 삭제 성공"),
+      @ApiResponse(responseCode = "404", description = "해당 메뉴를 찾을 수 없습니다.",
+          content = @Content(schema = @Schema(implementation = ErrorResponse.class)))
+  })
+  ResponseEntity<Void> deleteMenu(
+      @Parameter(description = "삭제할 메뉴 ID", example = "1") Long menuId
+  );
+}

src/main/java/com/campustable/be/domain/menu/dto/MenuRequest.java

@@ -26,6 +26,7 @@ public class MenuRequest {
   @Min(value = 0, message = "가격은 0원 이상이어야 합니다.")
   private Integer price;
 
+  @NotBlank(message = "이미지를 위한url은 필수입니다.")
   private String menuUrl;
 
   @NotNull(message = "판매 가능 여부는 필수입니다.")

src/main/java/com/campustable/be/domain/menu/service/MenuService.java

@@ -10,17 +10,13 @@
 import com.campustable.be.domain.menu.dto.MenuUpdateRequest;
 import com.campustable.be.domain.menu.entity.Menu;
 import com.campustable.be.domain.menu.repository.MenuRepository;
-import com.campustable.be.global.aop.LogMonitoringInvocation;
 import com.campustable.be.global.exception.CustomException;
 import com.campustable.be.global.exception.ErrorCode;
 import java.util.ArrayList;
 import lombok.extern.slf4j.Slf4j;
-import org.springframework.beans.propertyeditors.CustomNumberEditor;
 import org.springframework.transaction.annotation.Transactional;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
-
-import java.math.BigDecimal;
 import java.util.List;
 import java.util.Optional;
 
@@ -41,7 +37,7 @@ public MenuResponse createMenu(MenuRequest request) {
     Category category = categoryRepository.findById(request.getCategoryId())
         .orElseThrow(() -> {
           log.warn("createMenu: 유효하지 않은 category id");
-          throw new CustomException(ErrorCode.CATEGORY_NOT_FOUND);
+          return new CustomException(ErrorCode.CATEGORY_NOT_FOUND);
         });
 
     Optional<Menu> existingMenu = menuRepository.findByCategoryAndMenuName(
@@ -59,6 +55,19 @@ public MenuResponse createMenu(MenuRequest request) {
 
   }
 
+  @Transactional(readOnly = true)
+  public MenuResponse getMenuById(Long menuId) {
+
+    Menu menu = menuRepository.findById(menuId)
+        .orElseThrow(()->{
+          log.error("getMenuById : 유효하지않은 menuId");
+          return new CustomException(ErrorCode.MENU_NOT_FOUND);
+        });
+
+    return MenuResponse.from(menu);
+
+  }
+
   @Transactional(readOnly = true)
   public List<MenuResponse> getAllMenus() {
 
@@ -73,7 +82,7 @@ public List<MenuResponse> getAllMenusByCategory(Long categoryId) {
     Category category = categoryRepository.findById(categoryId)
         .orElseThrow(() -> {
           log.warn("getAllMenusByCategory: 유효하지 않은 category id");
-          throw new CustomException(ErrorCode.CATEGORY_NOT_FOUND);
+          return new CustomException(ErrorCode.CATEGORY_NOT_FOUND);
         });
 
     List<Menu> menus = menuRepository.findByCategory(category);