[BACKEND] 가이드 조회 기능 추가, 예시 가이드 데이터 추가 (#66)

## 📝작업 내용

>- getGuide GET /guide : 가이드 조회, 카테고리 필수
>- guide별로 category, intro, detail, caution, beginner 세분화
>- Guide SamleData 추가

## 주의사항
> - 편리한 테스트를 위해 guide API는 인증을 필요로 하지 않도록 열어둔 상태입니다. 실제로는 필요합니다..
> - data.sql은 테스트 용 데이터입니다. 실제 데이터는 추후에 변경 필요합니다.

Author: ddoed

backend/src/main/java/com/cmg/comtogether/common/exception/ErrorCode.java

@@ -26,7 +26,10 @@ public enum ErrorCode {
     OAUTH_PROVIDER_ERROR(502, "OAUTH-999", "카카오 서버와 통신 중 오류가 발생했습니다."),
 
     // 네이버 상품 API
-    NAVER_API_ERROR(502, "NAVER-999", "네이버 서버와 통신 중 오류가 발생했습니다.");
+    NAVER_API_ERROR(502, "NAVER-999", "네이버 서버와 통신 중 오류가 발생했습니다."),
+    
+    // 가이드
+    GUIDE_NOT_FOUND(404, "GUIDE-001", "가이드를 찾을 수 없습니다");
 
     private final int status;
     private final String code;

backend/src/main/java/com/cmg/comtogether/common/security/config/SecurityConfig.java

@@ -40,6 +40,7 @@ public SecurityFilterChain securityFilterChain(HttpSecurity http, CorsConfigurat
                                 "/swagger-ui/**",
                                 "/v3/api-docs/**",
                                 "/products/**",
+                                "/guide/**",
                                 "/users/all"
                         ).permitAll()
                         .anyRequest().authenticated()

backend/src/main/java/com/cmg/comtogether/guide/controller/GuideController.java

@@ -0,0 +1,23 @@
+package com.cmg.comtogether.guide.controller;
+
+import com.cmg.comtogether.common.response.ApiResponse;
+import com.cmg.comtogether.guide.dto.GuideResponseDto;
+import com.cmg.comtogether.guide.service.GuideService;
+import jakarta.validation.constraints.NotBlank;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/guide")
+public class GuideController {
+
+    private final GuideService guideService;
+
+    @GetMapping
+    public ResponseEntity<ApiResponse<GuideResponseDto>> getGuide(@RequestParam @NotBlank(message = "카테고리는 필수입니다.") String category) {
+        GuideResponseDto guideResponseDto = guideService.getGuide(category);
+        return ResponseEntity.ok(ApiResponse.success(guideResponseDto));
+    }
+}

backend/src/main/java/com/cmg/comtogether/guide/dto/Description.java

@@ -0,0 +1,15 @@
+package com.cmg.comtogether.guide.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+@Builder
+public class Description {
+    private String intro;
+    private String detail;
+    private String caution;
+    private String beginner;
+}

backend/src/main/java/com/cmg/comtogether/guide/dto/GuideResponseDto.java

@@ -0,0 +1,13 @@
+package com.cmg.comtogether.guide.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@Builder
+@AllArgsConstructor
+public class GuideResponseDto {
+    private String category;
+    private Description description;
+}

backend/src/main/java/com/cmg/comtogether/guide/entity/Guide.java

@@ -0,0 +1,34 @@
+package com.cmg.comtogether.guide.entity;
+
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Entity
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class Guide {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long guideId;
+
+    @Column(nullable = false, unique = true)
+    private String category;
+
+    @Column(columnDefinition = "TEXT")
+    private String intro;
+
+    @Column(columnDefinition = "TEXT")
+    private String detail;
+
+    @Column(columnDefinition = "TEXT")
+    private String caution;
+
+    @Column(columnDefinition = "TEXT")
+    private String beginner;
+}

backend/src/main/java/com/cmg/comtogether/guide/repository/GuideRepository.java

@@ -0,0 +1,10 @@
+package com.cmg.comtogether.guide.repository;
+
+import com.cmg.comtogether.guide.entity.Guide;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.Optional;
+
+public interface GuideRepository extends JpaRepository<Guide, Long> {
+    Optional<Guide> findByCategory(String category);
+}

backend/src/main/java/com/cmg/comtogether/guide/service/GuideService.java

@@ -0,0 +1,35 @@
+package com.cmg.comtogether.guide.service;
+
+import com.cmg.comtogether.common.exception.BusinessException;
+import com.cmg.comtogether.common.exception.ErrorCode;
+import com.cmg.comtogether.guide.dto.Description;
+import com.cmg.comtogether.guide.dto.GuideResponseDto;
+import com.cmg.comtogether.guide.entity.Guide;
+import com.cmg.comtogether.guide.repository.GuideRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+
+
+@Service
+@RequiredArgsConstructor
+public class GuideService {
+
+    private final GuideRepository guideRepository;
+
+    public GuideResponseDto getGuide(String category) {
+        Guide guide = guideRepository.findByCategory(category)
+                .orElseThrow(() -> new BusinessException(ErrorCode.GUIDE_NOT_FOUND));
+
+        return GuideResponseDto.builder()
+                .category(guide.getCategory())
+                .description(
+                    Description.builder()
+                            .intro(guide.getIntro())
+                            .detail(guide.getDetail())
+                            .caution(guide.getCaution())
+                            .beginner(guide.getBeginner())
+                            .build()
+                )
+                .build();
+    }
+}