Merge pull request #527 from projects200/feat/feeds/create-feed-images

[Feat] 피드에 이미지 추가하는 기능 개발 [0.11.10]

Author: joohyun1996

build.gradle

@@ -7,7 +7,7 @@ plugins {
 }
 
 group = 'com.project200'
-version = '0.11.9-SNAPSHOT'
+version = '0.11.10-SNAPSHOT'
 
 java {
     toolchain {

documents/Undabang SQL/Undabang Database DML.sql

@@ -218,7 +218,7 @@ VALUES ('레슬링', 'https://undabang-public-assets.s3.ap-northeast-2.amazonaws
        ('미식축구',
         'https://undabang-public-assets.s3.ap-northeast-2.amazonaws.com/images/exercises/American_football.png');
 
-INSERT INTO policies (policy_key, policy_value, policy_unit, policy_description)
+INSERT INTO policies (policy_id, policy_key, policy_value, policy_unit, policy_description)
 VALUES (21, 'PREFERRED_EXERCISE_MAX_COUNT', '5', 'COUNT', '선호 운동 최대 보유 갯수');
 
 INSERT INTO policies (policy_id, policy_key, policy_value, policy_unit, policy_description)
@@ -268,4 +268,13 @@ CREATE INDEX idx_feed_likes_feed_member ON feed_likes (feed_id, member_id);
 CREATE INDEX idx_comments_feed_member ON comments (feed_id, member_id);
 
 -- 댓글 좋아요 인덱스: (댓글ID + 회원ID)
-CREATE INDEX idx_comment_likes_comment_member ON comment_likes (comment_id, member_id);
+CREATE INDEX idx_comment_likes_comment_member ON comment_likes (comment_id, member_id);
+
+INSERT INTO policies (policy_id, policy_key, policy_value, policy_unit, policy_description)
+VALUES (23, 'FEED_PICTURE_MAX_COUNT', '5', 'COUNT', '저장할 수 있는 최대 피드 사진 수');
+
+INSERT INTO policy_groups (policy_groups_id, policy_groups_name)
+VALUES (6, 'feed');
+
+INSERT INTO policy_group_mappings (policy_id, policy_groups_id)
+VALUES (23, 6);

src/docs/asciidoc/feed/피드-이미지-목록-추가-API.adoc

@@ -0,0 +1,36 @@
+== 피드 이미지 목록 추가 API
+
+=== 설명
+
+- #POST# `/api/v1/feeds/{feedId}/pictures`
+- 회원이 작성한 피드에 이미지를 추가하는 API 입니다.
+- 저장 가능한 최대 이미지 갯수는 5개 입니다.
+
+=== 개발 이력
+
+- Sprint 23 (2026-02-02): 기능 개발이 완료되었습니다.
+
+=== 개발 참고 사항
+
+- <<공통-개발-참고-사항,공통 개발 참고 사항>>을 참고하세요.
+
+=== 코드 샘플
+
+operation::create-feed-pictures/create-feed-pictures_-success[snippets="curl-request,http-request,http-response"]
+
+=== 매개 변수
+
+operation::create-feed-pictures/create-feed-pictures_-success[snippets="request-headers,path-parameters,request-parts,response-fields"]
+
+==== 응답 상태 코드
+
+|===
+|상태 코드|설명
+|200|요청이 성공적으로 처리되었습니다.
+|400|요청 본문을 읽을 수 없거나 형식이 올바르지 않습니다.
+|401|인증되지 않은 요청입니다. Access Token이 없거나 유효하지 않습니다
+|404|존재하지 않는 회원입니다. +
+존재하지 않는 피드 입니다.
+|409|저장할 수 있는 최대 피드 사진 갯수를 초과했습니다.
+|===
+

src/docs/asciidoc/index.adoc

@@ -257,4 +257,6 @@ include::overview/공통-개발-참고-사항.adoc[]
 
 - 피드 수정 API #PATCH# `/api/v1/feeds/{feedId}`
 
-- 피드 삭제 API #DELETE# `/api/v1/feeds/{feedId}`
+- 피드 삭제 API #DELETE# `/api/v1/feeds/{feedId}`
+
+- 피드 이미지 목록 추가 API #POST# `/api/v1/feeds/{feedId}/pictures`

src/docs/asciidoc/피드-API.adoc

@@ -29,4 +29,6 @@ include::feed/피드-생성-API.adoc[]
 
 include::feed/피드-수정-API.adoc[]
 
-include::feed/피드-삭제-API.adoc[]
+include::feed/피드-삭제-API.adoc[]
+
+include::feed/피드-이미지-목록-추가-API.adoc[]

src/main/java/com/project200/undabang/common/service/FileType.java

@@ -3,7 +3,8 @@
 public enum FileType {
     EXERCISE("exercises"),
     PROFILE("profiles"),
-    THUMBNAIL("thumbnails");
+    THUMBNAIL("thumbnails"),
+    FEED("feeds");
 
     private final String path;
 

src/main/java/com/project200/undabang/common/web/exception/ErrorCode.java

@@ -102,7 +102,10 @@ public enum ErrorCode {
     FEED_NOT_FOUND(404, "FEED_NOT_FOUND", "존재하지 않는 피드입니다."),
 
     // 피드 타입 관련 에러
-    FEED_TYPE_NOT_FOUND(404, "FEED_TYPE_NOT_FOUND", "존재하지 않는 피드 타입입니다.");
+    FEED_TYPE_NOT_FOUND(404, "FEED_TYPE_NOT_FOUND", "존재하지 않는 피드 타입입니다."),
+
+    // 피드 사진 관련 에러
+    FEED_PICTURE_MAX_COUNT_EXCEED(409, "FEED_PICTURE_MAX_COUNT_EXCEED", "저장할 수 있는 최대 피드 사진 갯수를 초과했습니다.");
 
     private final HttpStatusCode status;
     private final String code;

src/main/java/com/project200/undabang/feed/controller/FeedCommandController.java

@@ -1,23 +1,35 @@
 package com.project200.undabang.feed.controller;
 
+import com.project200.undabang.common.validation.AllowedExtensions;
 import com.project200.undabang.common.web.response.CommonResponse;
 import com.project200.undabang.feed.dto.request.CreateFeedRequest;
 import com.project200.undabang.feed.dto.request.UpdateFeedRequest;
+import com.project200.undabang.feed.dto.response.CreateFeedPictureResponse;
 import com.project200.undabang.feed.dto.response.CreateFeedResponse;
 import com.project200.undabang.feed.dto.response.UpdateFeedResponse;
 import com.project200.undabang.feed.service.FeedCommandService;
+import com.project200.undabang.feed.service.FeedPictureService;
 import jakarta.validation.Valid;
+import jakarta.validation.constraints.Positive;
+import jakarta.validation.constraints.Size;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.HttpStatus;
+import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;
+import org.springframework.validation.annotation.Validated;
 import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
 
+import java.util.List;
+
+@Validated
 @RestController
 @RequiredArgsConstructor
 @RequestMapping("/api")
 public class FeedCommandController {
 
     private final FeedCommandService feedCommandService;
+    private final FeedPictureService feedPictureService;
 
     /**
      * 사용자가 제공한 요청 데이터를 기반으로 새로운 피드 리소스를 생성합니다.
@@ -47,4 +59,14 @@ public ResponseEntity<CommonResponse<Void>> deleteMemberFeed(@PathVariable Long
 
         return ResponseEntity.ok(CommonResponse.delete(feedCommandService.deleteMemberFeed(feedId)));
     }
+
+    @PostMapping(value = "/v1/feeds/{feedId}/pictures", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+    public ResponseEntity<CommonResponse<List<CreateFeedPictureResponse>>> createFeedPictures(
+            @PathVariable @Positive(message = "올바른 피드 식별자를 입력해주세요") Long feedId,
+            @Size(max = 5, message = "최대 5개의 파일만 업로드 할 수 있습니다.")
+            @AllowedExtensions(extensions = {".jpg", ".jpeg", ".png"})
+            @RequestPart("pictures") List<MultipartFile> feedPictureList) {
+
+        return ResponseEntity.status(HttpStatus.CREATED).body(CommonResponse.create(feedPictureService.createFeedPictures(feedId, feedPictureList)));
+    }
 }

src/main/java/com/project200/undabang/feed/dto/response/CreateFeedPictureResponse.java

@@ -0,0 +1,18 @@
+package com.project200.undabang.feed.dto.response;
+
+import com.project200.undabang.feed.entity.FeedPicture;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+public class CreateFeedPictureResponse {
+    private Long pictureId;
+    private String pictureUrl;
+
+    public static CreateFeedPictureResponse of(FeedPicture feedPicture) {
+        return new CreateFeedPictureResponse(feedPicture.getId(), feedPicture.getPicture().getPictureUrl());
+    }
+}

src/main/java/com/project200/undabang/feed/entity/FeedPicture.java

@@ -27,4 +27,10 @@ public class FeedPicture {
     @JoinColumn(name = "feed_id", nullable = false, updatable = false)
     private Feed feed;
 
+    public static FeedPicture of(Picture picture, Feed feed) {
+        return FeedPicture.builder()
+                .picture(picture)
+                .feed(feed)
+                .build();
+    }
 }