즐겨찾기_만들기_기능_추가

src/main/java/jombi/freemates/config/FileStorageConfig.java

@@ -0,0 +1,26 @@
+package jombi.freemates.config;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+public class FileStorageConfig {
+  @Bean
+  public Path uploadDir(FileStorageProperties props) {
+    Path path = Paths
+        .get(props.getUploadDir())
+        .toAbsolutePath()
+        .normalize();
+    try {
+      Files.createDirectories(path);
+    } catch (IOException e) {
+      throw new RuntimeException("업로드 디렉터리 생성 실패", e);
+    }
+    return path;
+  }
+
+}

src/main/java/jombi/freemates/config/FileStorageProperties.java

@@ -0,0 +1,16 @@
+package jombi.freemates.config;
+
+import lombok.Getter;
+import lombok.Setter;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+@ConfigurationProperties(prefix = "file")
+@Getter
+@Setter
+public class FileStorageProperties {
+  private String uploadDir;
+
+
+}

src/main/java/jombi/freemates/config/StaticResourceConfig.java

@@ -0,0 +1,20 @@
+package jombi.freemates.config;
+
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
+import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
+
+@Configuration
+public class StaticResourceConfig implements WebMvcConfigurer {
+  @Value("${file.upload-dir}")        // application.yml 에 정의된 경로
+  private String uploadDir;
+
+  @Override
+  public void addResourceHandlers(ResourceHandlerRegistry registry) {
+    // 클라이언트가 /uploads/** 로 요청하면, 실제 디스크의 uploadDir 경로를 뒤에 매핑
+    registry
+        .addResourceHandler("/uploads/**")
+        .addResourceLocations("file:" + uploadDir + "/");
+  }
+}

src/main/java/jombi/freemates/config/WebSecurityConfig.java

@@ -1,5 +1,7 @@
 package jombi.freemates.config;
 
+import static org.springframework.security.config.Customizer.withDefaults;
+
 import jombi.freemates.service.CustomUserDetailsService;
 import jombi.freemates.util.filter.CustomAuthenticationEntryPoint;
 import jombi.freemates.util.JwtUtil;
@@ -29,12 +31,15 @@ public WebSecurityConfig(JwtUtil jwtUtil, CustomUserDetailsService customUserDet
   public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
 
     http
+        .cors(withDefaults())
         .csrf(csrf -> csrf.disable())
         .sessionManagement(session -> session.sessionCreationPolicy(SessionCreationPolicy.STATELESS))
         .exceptionHandling(ex -> ex.authenticationEntryPoint(new CustomAuthenticationEntryPoint()))
         .authorizeHttpRequests(auth -> auth
             // 허용 URL
             .requestMatchers(SecurityUrls.AUTH_WHITELIST.toArray(new String[0])).permitAll()
+            // 업로드된 이미지 파일은 모두에게 허용
+            .requestMatchers(HttpMethod.GET,"/uploads/**").permitAll()
             // 관리자 URL
             .requestMatchers(SecurityUrls.ADMIN_PATHS.toArray(new String[0])).hasRole("ADMIN")
             // 회원 관련 예시 URL

src/main/java/jombi/freemates/controller/BookmarkController.java

@@ -0,0 +1,173 @@
+package jombi.freemates.controller;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import java.util.List;
+import java.util.UUID;
+import jombi.freemates.model.constant.Author;
+import jombi.freemates.model.constant.PinColor;
+import jombi.freemates.model.constant.Visibility;
+import jombi.freemates.model.dto.BookmarkRequest;
+import jombi.freemates.model.dto.BookmarkResponse;
+import jombi.freemates.model.dto.CustomUserDetails;
+import jombi.freemates.service.BookmarkService;
+import jombi.freemates.util.docs.ApiChangeLog;
+import jombi.freemates.util.docs.ApiChangeLogs;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.ResponseStatus;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+@Tag(
+    name = "즐겨찾기 API",
+    description = "즐겨찾기 관련 API 제공"
+)
+@RestController
+@RequiredArgsConstructor
+@Slf4j
+@RequestMapping("/api/bookmark")
+public class BookmarkController {
+  private final BookmarkService bookmarkService;
+
+  @ApiChangeLogs({
+      @ApiChangeLog(
+          date = "2025-05-26",
+          author = Author.LEEDAYE,
+          issueNumber = 96,
+          description = "즐겨찾기 만들기"
+      )
+  })
+  @Operation(
+      summary = "즐겨찾기 생성",
+      description = """
+        ## 인증(JWT): **필요**
+
+        ## 요청 파라미터 (multipart/form-data)
+        - **`title`**: 즐겨찾기 제목  
+        - **`description`**: 즐겨찾기 설명  
+        - **`pinColor`**: 핀 색깔 (ENUM, 6가지 중 하나)  
+        - **`visibility`**: 공개 여부 (ENUM: `PUBLIC` 또는 `PRIVATE`)  
+        - **`file`**: 이미지 파일 (MultipartFile)  
+
+        ## 반환값 (`BookmarkResponse`)
+        - **`memberId`**: 즐겨찾기를 생성한 회원 ID (UUID)  
+        - **`nickname`**: 닉네임
+        - **`imageUrl`**: 저장된 이미지 URL  
+        - **`title`**, **`description`**, **`pinColor`**, **`visibility`**: 요청값 그대로 반환  
+
+        ## 에러코드
+        """
+
+  )
+
+  @PostMapping(value = "/create",
+      consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+  @ResponseStatus(HttpStatus.CREATED)
+  public ResponseEntity<BookmarkResponse> create(
+      @RequestParam String title,
+      @RequestParam String description,
+      @RequestParam PinColor pinColor,
+      @RequestParam Visibility visibility,
+      @RequestParam(value = "image", required = false)
+      @Parameter(description = "이미지 파일", content = @Content(mediaType = MediaType.MULTIPART_FORM_DATA_VALUE))
+      MultipartFile image,
+      @AuthenticationPrincipal CustomUserDetails user
+  ) {
+    BookmarkRequest req = new BookmarkRequest();
+    req.setTitle(title);
+    req.setDescription(description);
+    req.setPinColor(pinColor);
+    req.setVisibility(visibility);
+    BookmarkResponse response = bookmarkService.create(user, req, image);
+    return ResponseEntity.status(HttpStatus.CREATED).body(response);
+  }
+
+  @ApiChangeLogs({
+      @ApiChangeLog(
+          date = "2025-05-26",
+          author = Author.LEEDAYE,
+          issueNumber = 96,
+          description = "즐겨찾기 유저별로 가져오기"
+      )
+  })
+  @Operation(
+      summary = "내 즐겨찾기 가져오기",
+      description = """
+        ## 인증(JWT): **필요**
+
+        ## 요청 파라미터
+        - **`없음`**
+
+        ## 반환값 (`BookmarkResponse`)
+        - **`memberId`**: 즐겨찾기를 생성한 회원 ID (UUID)  
+        - **`nickname`**: 닉네임
+        - **`imageUrl`**: 저장된 이미지 URL  
+        - **`title`**, **`description`**, **`pinColor`**, **`visibility`**: 요청값 그대로 반환  
+
+        ## 에러코드
+        """
+  )
+  @GetMapping("/mylist")
+  public List<BookmarkResponse> list(
+      @AuthenticationPrincipal CustomUserDetails customUserDetails
+  ) {
+    return bookmarkService.listByMember(customUserDetails);
+  }
+
+
+  /**
+   * 장소를 즐겨찾기에 추가하는 API입니다.
+   * */
+  @ApiChangeLogs({
+      @ApiChangeLog(
+          date = "2025-05-26",
+          author = Author.LEEDAYE,
+          issueNumber = 96,
+          description = "장소 즐겨찾기에 추가하기"
+      )
+  })
+  @Operation(
+      summary = "장소 즐겨찾기에 추가하기",
+      description = """
+        ## 인증(JWT): **필요**
+
+        ## 요청 파라미터
+        - **Path Variable**
+          - `bookmarkId` (UUID): 장소를 추가할 즐겨찾기 ID
+        **Request Parameter**
+          - `placeId` (UUID): 추가할 장소 ID
+
+        ## 반환값
+        - **HTTP Status 200 OK** (혹은 204 No Content)
+
+        ## 에러코드
+        - `UNAUTHORIZED (401)`: 인증되지 않은 사용자입니다.
+        - `BOOKMARK_NOT_FOUND (404)`: 존재하지 않는 즐겨찾기입니다.
+        - `PLACE_NOT_FOUND (404)`: 존재하지 않는 장소입니다.
+        - `DUPLICATE_PLACE_IN_BOOKMARK (409)`: 이미 즐겨찾기에 추가된 장소입니다.
+        """
+  )
+  @PostMapping( "/{bookmarkId}/place")
+  public ResponseEntity<Void> addPlaceToBookmark(
+      @AuthenticationPrincipal CustomUserDetails customUserDetails,
+      @PathVariable("bookmarkId") UUID bookmarkId,
+      @RequestParam UUID placeId
+  ) {
+    log.debug("placeId:{}", placeId);
+    bookmarkService.addPlaceToBookmark(customUserDetails, bookmarkId, placeId);
+    return ResponseEntity.ok().build();  // 혹은 204 No Content
+  }
+
+}

src/main/java/jombi/freemates/controller/PlaceController.java

@@ -1,12 +1,23 @@
 package jombi.freemates.controller;
 
+import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
+import java.util.List;
+import jombi.freemates.model.constant.Author;
+import jombi.freemates.model.postgres.Place;
 import jombi.freemates.service.PlaceService;
+import jombi.freemates.util.docs.ApiChangeLog;
+import jombi.freemates.util.docs.ApiChangeLogs;
 import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.PageRequest;
+import org.springframework.data.domain.Pageable;
 import org.springframework.http.ResponseEntity;
 import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
 @Tag(
@@ -26,4 +37,45 @@ public ResponseEntity<Void> refreshPlaces() {
     return ResponseEntity.ok().build();
   }
 
+  @ApiChangeLogs({
+      @ApiChangeLog(
+          date = "2025-05-26",
+          author = Author.LEEDAYE,
+          issueNumber = 96,
+          description = "장소가져오기"
+      )
+  })
+  @Operation(
+      summary = "장소가져오기",
+      description = """
+        ## 인증(JWT): **필요**
+
+        ## 요청 파라미터 (multipart/form-data)
+        - **`page`**: 페이지(0부터 시작, 최대 32)
+        - **`size`**: 크기
+
+        ## 반환값 (`ResponseEntity<Page<Place>>`)
+        - **`content`**: 장소 목록
+        - **`totalElements`**: 전체 요소 수
+        - **`totalPages`**: 전체 페이지 수
+        - **`number`**: 현재 페이지 번호
+        - **`size`**: 페이지 크기
+        - **`sort`**: 정렬 정보
+        - **`numberOfElements`**: 현재 페이지의 요소 수
+        - **`empty`**: 현재 페이지가 비어있는지 여부
+
+        ## 에러코드
+        """
+
+  )
+  @GetMapping("/list")
+  public ResponseEntity<Page<Place>> getPagedPlaces(
+      @RequestParam(defaultValue = "0") int page,
+      @RequestParam(defaultValue = "10") int size
+  ) {
+    // 페이지와 사이즈만으로 Pageable 생성
+    Pageable pageable = PageRequest.of(page, size);
+    return ResponseEntity.ok(placeService.getPlaces(pageable));
+  }
+
 }

src/main/java/jombi/freemates/model/dto/BookmarkRequest.java

@@ -0,0 +1,31 @@
+package jombi.freemates.model.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jombi.freemates.model.constant.PinColor;
+import jombi.freemates.model.constant.Visibility;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.RequiredArgsConstructor;
+import lombok.Setter;
+import lombok.ToString;
+import org.springframework.web.multipart.MultipartFile;
+
+@ToString
+@Getter
+@Setter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class BookmarkRequest {
+
+  private String title;
+  private String description;
+  @Schema(implementation = PinColor.class)
+  private PinColor pinColor;
+  @Schema(implementation = Visibility.class)
+  private Visibility visibility;
+
+
+}

src/main/java/jombi/freemates/model/dto/BookmarkResponse.java

@@ -0,0 +1,30 @@
+package jombi.freemates.model.dto;
+
+import java.util.UUID;
+import jombi.freemates.model.constant.PinColor;
+import jombi.freemates.model.constant.Visibility;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+import lombok.ToString;
+
+@Builder
+@ToString
+@Getter
+@Setter
+@AllArgsConstructor
+@NoArgsConstructor
+public class BookmarkResponse {
+
+  private UUID bookmarkId;
+  private String imageUrl;
+  private String title;
+  private String description;
+  private PinColor pinColor;
+  private Visibility visibility;
+  private UUID memberId;
+  private String nickname;
+
+}