Merge pull request #62 from prgrms-web-devcourse-final-project/feature/EA3-108-recruitment-post-crud

[EA3-108] Feature: 모집글 수정 삭제 구현 및 테스트 추가

Author: Tokwasp

.gitignore

@@ -1,4 +1,5 @@
 # === Gradle ===
+src/main/generated/**
 .gradle
 build/
 !gradle/wrapper/gradle-wrapper.jar

src/main/java/grep/neogul_coder/domain/recruitment/RecruitmentErrorCode.java

@@ -0,0 +1,22 @@
+package grep.neogul_coder.domain.recruitment;
+
+import grep.neogul_coder.global.response.ErrorCode;
+import lombok.Getter;
+import org.springframework.http.HttpStatus;
+
+@Getter
+public enum RecruitmentErrorCode implements ErrorCode {
+    NOT_FOUND(HttpStatus.NOT_FOUND, HttpStatus.NOT_FOUND.name(), "모집글을 찾지 못했습니다."),
+    NOT_OWNER(HttpStatus.BAD_REQUEST, HttpStatus.BAD_REQUEST.name(), "모집글을 등록한 당사자가 아닙니다.");
+
+    private final HttpStatus status;
+    private final String code;
+    private final String message;
+
+    RecruitmentErrorCode(HttpStatus status, String code, String message) {
+        this.status = status;
+        this.code = code;
+        this.message = message;
+    }
+
+}

src/main/java/grep/neogul_coder/domain/recruitment/post/RecruitmentPost.java

@@ -1,24 +1,62 @@
 package grep.neogul_coder.domain.recruitment.post;
 
 import grep.neogul_coder.domain.recruitment.RecruitmentPostStatus;
+import grep.neogul_coder.global.entity.BaseEntity;
 import jakarta.persistence.Entity;
 import jakarta.persistence.GeneratedValue;
 import jakarta.persistence.GenerationType;
 import jakarta.persistence.Id;
+import lombok.Builder;
+import lombok.Getter;
 
 import java.time.LocalDate;
 
+@Getter
 @Entity
-public class RecruitmentPost {
+public class RecruitmentPost extends BaseEntity {
 
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
     private Long id;
+    private long userId;
     private long studyId;
 
     private String subject;
     private String content;
     private int recruitmentCount;
     private LocalDate expiredDate;
     private RecruitmentPostStatus status;
+    private boolean isDeleted;
+
+    @Builder
+    private RecruitmentPost(long studyId, String subject, String content, long userId,
+                           int recruitmentCount, LocalDate expiredDate, RecruitmentPostStatus status) {
+        this.studyId = studyId;
+        this.userId = userId;
+        this.subject = subject;
+        this.content = content;
+        this.recruitmentCount = recruitmentCount;
+        this.expiredDate = expiredDate;
+        this.status = status;
+    }
+
+    protected RecruitmentPost() {}
+
+    public void update(String subject, String content, int recruitmentCount) {
+        this.subject = subject;
+        this.content = content;
+        this.recruitmentCount = recruitmentCount;
+    }
+
+    public boolean isNotOwnedBy(long userId) {
+        return this.userId != userId;
+    }
+
+    public void delete() {
+        this.isDeleted = true;
+    }
+
+    public void updateStatus(RecruitmentPostStatus status) {
+        this.status = status;
+    }
 }

src/main/java/grep/neogul_coder/domain/recruitment/post/controller/RecruitmentPostController.java

@@ -1,48 +1,81 @@
 package grep.neogul_coder.domain.recruitment.post.controller;
 
-import grep.neogul_coder.domain.recruitment.post.controller.dto.request.RecruitmentPostEditRequest;
-import grep.neogul_coder.domain.recruitment.post.controller.dto.request.RecruitmentPostSaveRequest;
-import grep.neogul_coder.domain.recruitment.post.controller.dto.request.RecruitmentPostStatusEditRequest;
-import grep.neogul_coder.domain.recruitment.post.controller.dto.response.RecruitmentPostInfo;
-import grep.neogul_coder.domain.studyapplication.controller.dto.response.ApplicationResponse;
+import grep.neogul_coder.domain.recruitment.post.controller.dto.request.RecruitmentPostCreateRequest;
+import grep.neogul_coder.domain.recruitment.post.controller.dto.request.RecruitmentPostStatusUpdateRequest;
+import grep.neogul_coder.domain.recruitment.post.controller.dto.request.RecruitmentPostUpdateRequest;
+import grep.neogul_coder.domain.recruitment.post.controller.dto.response.*;
+import grep.neogul_coder.domain.recruitment.post.service.RecruitmentPostService;
+import grep.neogul_coder.global.auth.Principal;
 import grep.neogul_coder.global.response.ApiResponse;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.web.PageableDefault;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
 import org.springframework.web.bind.annotation.*;
 
-import java.util.List;
-
 @RequestMapping("/recruitment-posts")
+@RequiredArgsConstructor
 @RestController
 public class RecruitmentPostController implements RecruitmentPostSpecification {
 
+    private final RecruitmentPostService recruitmentPostService;
+
     @GetMapping("/{recruitment-post-id}")
     public ApiResponse<RecruitmentPostInfo> get(@PathVariable("recruitment-post-id") long recruitmentPostId) {
         return ApiResponse.success(new RecruitmentPostInfo());
     }
 
+    @GetMapping("/studies")
+    public ApiResponse<ParticipatedStudyNamesInfo> getParticipatedStudyNames(@AuthenticationPrincipal Principal userDetails) {
+        return ApiResponse.success(new ParticipatedStudyNamesInfo());
+    }
+
+    @GetMapping("/studies/{study-id}")
+    public ApiResponse<ParticipatedStudyInfo> getParticipatedStudy(@PathVariable("study-id") long StudyId,
+                                                                   @AuthenticationPrincipal Principal userDetails) {
+        return ApiResponse.success(new ParticipatedStudyInfo());
+    }
+
     @PostMapping
-    public ApiResponse<Void> save(@RequestBody RecruitmentPostSaveRequest request) {
+    public ApiResponse<Void> save(@Valid @RequestBody RecruitmentPostCreateRequest request,
+                                  @AuthenticationPrincipal Principal userDetails) {
+        recruitmentPostService.create(request.toServiceRequest(), userDetails.getUserId());
         return ApiResponse.noContent();
     }
 
     @PutMapping("/{recruitment-post-id}")
-    public ApiResponse<Void> edit(@PathVariable("recruitment-post-id") long recruitmentPostId,
-                                  RecruitmentPostEditRequest request) {
+    public ApiResponse<Void> update(@PathVariable("recruitment-post-id") long recruitmentPostId,
+                                    @Valid @RequestBody RecruitmentPostUpdateRequest request,
+                                    @AuthenticationPrincipal Principal userDetails) {
+        recruitmentPostService.update(request.toServiceRequest(), recruitmentPostId, userDetails.getUserId());
         return ApiResponse.noContent();
     }
 
     @DeleteMapping("/{recruitment-post-id}")
-    public ApiResponse<Void> delete(@PathVariable("recruitment-post-id") long recruitmentPostId) {
+    public ApiResponse<Void> delete(@PathVariable("recruitment-post-id") long recruitmentPostId,
+                                    @AuthenticationPrincipal Principal userDetails) {
+        recruitmentPostService.delete(recruitmentPostId, userDetails.getUserId());
         return ApiResponse.noContent();
     }
 
     @PostMapping("/{recruitment-post-id}/status")
     public ApiResponse<Void> changeStatus(@PathVariable("recruitment-post-id") long recruitmentPostId,
-                                          @RequestBody RecruitmentPostStatusEditRequest request) {
+                                          @RequestBody RecruitmentPostStatusUpdateRequest request,
+                                          @AuthenticationPrincipal Principal userDetails) {
+        recruitmentPostService.updateStatus(request.toServiceRequest(), recruitmentPostId, userDetails.getUserId());
         return ApiResponse.noContent();
     }
 
     @GetMapping("{recruitment-post-id}/applications")
-    public ApiResponse<List<ApplicationResponse>> getApplications(@PathVariable("recruitment-post-id") long recruitmentPostId) {
-        return ApiResponse.success(List.of(new ApplicationResponse()));
+    public ApiResponse<RecruitmentApplicationPagingInfo> getApplications(@PageableDefault(size = 5) Pageable pageable,
+                                                                         @PathVariable("recruitment-post-id") long recruitmentPostId) {
+        return ApiResponse.success(new RecruitmentApplicationPagingInfo());
+    }
+
+    @GetMapping("{recruitment-post-id}/comments")
+    public ApiResponse<RecruitmentPostCommentPagingInfo> getComments(@PageableDefault(size = 5) Pageable pageable,
+                                                                     @PathVariable("recruitment-post-id") long recruitmentPostId) {
+        return ApiResponse.success(new RecruitmentPostCommentPagingInfo());
     }
 }

src/main/java/grep/neogul_coder/domain/recruitment/post/controller/RecruitmentPostSpecification.java

@@ -1,15 +1,14 @@
 package grep.neogul_coder.domain.recruitment.post.controller;
 
-import grep.neogul_coder.domain.recruitment.post.controller.dto.request.RecruitmentPostEditRequest;
-import grep.neogul_coder.domain.recruitment.post.controller.dto.request.RecruitmentPostSaveRequest;
-import grep.neogul_coder.domain.recruitment.post.controller.dto.request.RecruitmentPostStatusEditRequest;
-import grep.neogul_coder.domain.recruitment.post.controller.dto.response.RecruitmentPostInfo;
-import grep.neogul_coder.domain.studyapplication.controller.dto.response.ApplicationResponse;
+import grep.neogul_coder.domain.recruitment.post.controller.dto.request.RecruitmentPostCreateRequest;
+import grep.neogul_coder.domain.recruitment.post.controller.dto.request.RecruitmentPostStatusUpdateRequest;
+import grep.neogul_coder.domain.recruitment.post.controller.dto.request.RecruitmentPostUpdateRequest;
+import grep.neogul_coder.domain.recruitment.post.controller.dto.response.*;
+import grep.neogul_coder.global.auth.Principal;
 import grep.neogul_coder.global.response.ApiResponse;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
-
-import java.util.List;
+import org.springframework.data.domain.Pageable;
 
 @Tag(name = "Recruitment-Post", description = "모집 글 API")
 public interface RecruitmentPostSpecification {
@@ -18,17 +17,29 @@ public interface RecruitmentPostSpecification {
     ApiResponse<RecruitmentPostInfo> get(long id);
 
     @Operation(summary = "모집 글 저장", description = "스터디 모집 글을 저장 합니다.")
-    ApiResponse<Void> save(RecruitmentPostSaveRequest request);
+    ApiResponse<Void> save(RecruitmentPostCreateRequest request, Principal userDetails);
+
+    @Operation(summary = "참여 중인 스터디 이름들 조회", description = "스터디 모집글 작성시 내가 참여한 스터디 이름들을 가져올수 있습니다.")
+    ApiResponse<ParticipatedStudyNamesInfo> getParticipatedStudyNames(Principal userDetails);
+
+    @Operation(summary = "스터디 불러오기", description = "스터디 모집글 작성시 스터디 불러오기를 통해 스터디 정보를 조회할 수 있습니다.")
+    ApiResponse<ParticipatedStudyInfo> getParticipatedStudy(long studyId, Principal userDetails);
 
     @Operation(summary = "모집 글 수정", description = "모집글을 수정 합니다.")
-    ApiResponse<Void> edit(long recruitmentPostId, RecruitmentPostEditRequest request);
+    ApiResponse<Void> update(long recruitmentPostId, RecruitmentPostUpdateRequest request, Principal userDetails);
 
     @Operation(summary = "모집 글 삭제", description = "모집글을 삭제 합니다.")
-    ApiResponse<Void> delete(long recruitmentPostId);
+    ApiResponse<Void> delete(long recruitmentPostId, Principal userDetails);
 
     @Operation(summary = "모집 상태 변경", description = "모집글의 상태를 변경 합니다.")
-    ApiResponse<Void> changeStatus(long recruitmentPostId, RecruitmentPostStatusEditRequest request);
+    ApiResponse<Void> changeStatus(long recruitmentPostId, RecruitmentPostStatusUpdateRequest request, Principal userDetails);
+
+    @Operation(summary = "스터디 신청 목록 페이징 조회", description =
+            "스터디 신청 목록들을 페이징 조회합니다. <br>" +
+                    "사용법 : /recruitment-post/{id}/applications?page=0&size=5")
+    ApiResponse<RecruitmentApplicationPagingInfo> getApplications(Pageable pageable, long recruitmentPostId);
 
-    @Operation(summary = "스터디 신청 목록 조회", description = "스터디장이 스터디 신청 목록을 조회합니다.")
-    ApiResponse<List<ApplicationResponse>> getApplications(long recruitmentPostId);
+    @Operation(summary = "모집글 댓글 페이징 조회", description = "모집글의 댓글들을 페이징 조회 합니다. <br>" +
+            "사용법 : /recruitment-post/{id}/comments?page=0&size=5")
+    ApiResponse<RecruitmentPostCommentPagingInfo> getComments(Pageable pageable, long recruitmentPostId);
 }

src/main/java/grep/neogul_coder/domain/recruitment/post/controller/dto/request/RecruitmentPostCreateRequest.java

@@ -0,0 +1,57 @@
+package grep.neogul_coder.domain.recruitment.post.controller.dto.request;
+
+import grep.neogul_coder.domain.recruitment.post.service.request.RecruitmentPostCreateServiceRequest;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.FutureOrPresent;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Positive;
+import lombok.Builder;
+import lombok.Getter;
+
+import java.time.LocalDate;
+
+@Getter
+public class RecruitmentPostCreateRequest {
+
+    @Schema(example = "2", description = "스터디 ID")
+    @NotNull(message = "스터디 ID 값은 필수 입니다.")
+    private long studyId;
+
+    @Schema(example = "모각코 1일 스터디 모집 합니다.", description = "제목")
+    @NotBlank(message = "제목은 필수 입니다.")
+    private String subject;
+
+    @Schema(example = "모각코 1일 스터디에 참여하실분들은 신청 해주시면 감사합니다!", description = "소개 글 내용")
+    @NotBlank(message = "내용은 필수 입니다.")
+    private String content;
+
+    @Schema(example = "3", description = "모집글 인원 수")
+    @Positive(message = "모집인원은 최소 1명을 입력해 주세요")
+    private int recruitmentCount;
+
+    @Schema(example = "2025-07-10", description = "모집 마감일")
+    @FutureOrPresent(message = "모집 마감일은 현재 날짜 이전으로 설정이 불가능 합니다.")
+    private LocalDate expiredDate;
+
+    @Builder
+    private RecruitmentPostCreateRequest(long studyId, String subject, String content,
+                                         int recruitmentCount, LocalDate expiredDate) {
+        this.studyId = studyId;
+        this.subject = subject;
+        this.content = content;
+        this.recruitmentCount = recruitmentCount;
+        this.expiredDate = expiredDate;
+    }
+
+    public RecruitmentPostCreateServiceRequest toServiceRequest() {
+        return RecruitmentPostCreateServiceRequest.builder()
+                .studyId(this.studyId)
+                .subject(this.subject)
+                .content(this.content)
+                .recruitmentCount(this.recruitmentCount)
+                .expiredDate(this.expiredDate)
+                .build();
+    }
+}

src/main/java/grep/neogul_coder/domain/recruitment/post/controller/dto/request/RecruitmentPostEditRequest.java

@@ -0,0 +1,19 @@
+package grep.neogul_coder.domain.recruitment.post.controller.dto.request;
+
+import grep.neogul_coder.domain.recruitment.RecruitmentPostStatus;
+import grep.neogul_coder.domain.recruitment.post.service.request.RecruitmentPostStatusUpdateServiceRequest;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Getter;
+
+@Getter
+public class RecruitmentPostStatusUpdateRequest {
+
+    @Schema(example = "IN_PROGRESS", description = "모집 글 상태")
+    @NotNull
+    private RecruitmentPostStatus status;
+
+    public RecruitmentPostStatusUpdateServiceRequest toServiceRequest() {
+        return new RecruitmentPostStatusUpdateServiceRequest(status);
+    }
+}