[REFACTOR] 게시글 도메인 리팩터링

backend/src/main/java/com/votogether/domain/member/entity/Member.java

@@ -20,15 +20,13 @@
 import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
-import lombok.ToString;
 import org.apache.commons.lang3.RandomStringUtils;
 
-@Table(indexes = {@Index(columnList = "socialId, socialType")})
-@NoArgsConstructor(access = AccessLevel.PROTECTED)
-@EqualsAndHashCode(of = {"id"})
-@ToString
 @Getter
 @Entity
+@EqualsAndHashCode(of = {"id"}, callSuper = false)
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Table(indexes = {@Index(columnList = "socialId, socialType")})
 public class Member extends BaseEntity {
 
     private static final String INITIAL_NICKNAME_PREFIX = "익명의손님";
@@ -44,7 +42,6 @@ public class Member extends BaseEntity {
     @Column(length = 20)
     private Gender gender;
 
-    @Column
     private Integer birthYear;
 
     @Enumerated(value = EnumType.STRING)

backend/src/main/java/com/votogether/domain/member/entity/vo/AgeRange.java

@@ -8,38 +8,28 @@
 @Getter
 public enum AgeRange {
 
-    UNDER_TEENS("10대 미만", 1, 9),
-    TEENS("10대", 10, 19),
-    TWENTIES("20대", 20, 29),
-    THIRTIES("30대", 30, 39),
-    FORTIES("40대", 40, 49),
-    FIFTIES("50대", 50, 59),
-    OVER_SIXTIES("60대 이상", 60, 999),
+    UNDER_TEENS("10대 미만", 0),
+    TEENS("10대", 1),
+    TWENTIES("20대", 2),
+    THIRTIES("30대", 3),
+    FORTIES("40대", 4),
+    FIFTIES("50대", 5),
+    OVER_SIXTIES("60대 이상", 6),
     ;
 
     private final String name;
-    private final int startAge;
-    private final int endAge;
+    private final int ageGroup;
 
-    AgeRange(
-            final String name,
-            final int startAge,
-            final int endAge
-    ) {
+    AgeRange(final String name, final int ageGroup) {
         this.name = name;
-        this.startAge = startAge;
-        this.endAge = endAge;
+        this.ageGroup = ageGroup;
     }
 
-    public static AgeRange from(final int age) {
+    public static AgeRange from(final int ageGroup) {
         return Arrays.stream(AgeRange.values())
-                .filter(ageRange -> ageRange.isBelong(age))
+                .filter(ageRange -> ageRange.ageGroup == ageGroup)
                 .findAny()
                 .orElseThrow(() -> new BadRequestException(MemberExceptionType.INVALID_AGE));
     }
 
-    private boolean isBelong(final int age) {
-        return this.startAge <= age && this.endAge >= age;
-    }
-
 }

backend/src/main/java/com/votogether/domain/member/entity/vo/Nickname.java

@@ -9,27 +9,28 @@
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
-@NoArgsConstructor(access = AccessLevel.PROTECTED)
 @Getter
 @Embeddable
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
 public class Nickname {
 
     private static final int MINIMUM_NICKNAME_LENGTH = 2;
     private static final int MAXIMUM_NICKNAME_LENGTH = 15;
+    private static final Pattern PATTERN = Pattern.compile("^[가-힣a-zA-Z0-9]+$");
 
     @Column(name = "nickname", length = 20, unique = true, nullable = false)
     private String value;
 
-    public Nickname(final String nickname) {
-        validateNickname(nickname);
-        this.value = nickname;
+    public Nickname(final String value) {
+        validateNickname(value);
+        this.value = value;
     }
 
-    private void validateNickname(final String nickname) {
-        if (nickname.length() < MINIMUM_NICKNAME_LENGTH || nickname.length() > MAXIMUM_NICKNAME_LENGTH) {
+    private void validateNickname(final String value) {
+        if (value.length() < MINIMUM_NICKNAME_LENGTH || value.length() > MAXIMUM_NICKNAME_LENGTH) {
             throw new BadRequestException(MemberExceptionType.INVALID_NICKNAME_LENGTH);
         }
-        if (!Pattern.matches("^[가-힣a-zA-Z0-9]+$", nickname)) {
+        if (!PATTERN.matcher(value).matches()) {
             throw new BadRequestException(MemberExceptionType.INVALID_NICKNAME_LETTER);
         }
     }

backend/src/main/java/com/votogether/domain/member/service/MemberService.java

@@ -114,7 +114,7 @@ private List<Post> deletePosts(final Member member) {
     }
 
     private List<Comment> deleteComments(final Member member) {
-        final List<Comment> comments = commentRepository.findAllByMember(member);
+        final List<Comment> comments = commentRepository.findAllByWriter(member);
         final List<Long> commentIds = comments.stream()
                 .map(Comment::getId)
                 .toList();

backend/src/main/java/com/votogether/domain/post/controller/PostCommandController.java

@@ -0,0 +1,69 @@
+package com.votogether.domain.post.controller;
+
+import com.votogether.domain.member.entity.Member;
+import com.votogether.domain.post.dto.request.post.PostCreateRequest;
+import com.votogether.domain.post.dto.request.post.PostUpdateRequest;
+import com.votogether.domain.post.service.PostCommandService;
+import com.votogether.global.jwt.Auth;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.Positive;
+import java.net.URI;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.ModelAttribute;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@Validated
+@RequiredArgsConstructor
+@RequestMapping("/posts")
+@RestController
+public class PostCommandController {
+
+    private final PostCommandService postCommandService;
+
+    @PostMapping(consumes = {MediaType.MULTIPART_FORM_DATA_VALUE, MediaType.APPLICATION_JSON_VALUE})
+    public ResponseEntity<Void> createPost(
+            @ModelAttribute @Valid final PostCreateRequest postCreateRequest,
+            @Auth final Member loginMember
+    ) {
+        final Long postId = postCommandService.createPost(postCreateRequest, loginMember);
+        return ResponseEntity.created(URI.create("/posts/" + postId)).build();
+    }
+
+    @PutMapping(value = "/{postId}", consumes = {MediaType.MULTIPART_FORM_DATA_VALUE, MediaType.APPLICATION_JSON_VALUE})
+    public ResponseEntity<Void> updatePost(
+            @PathVariable @Positive(message = "게시글 ID는 양의 정수만 가능합니다.") final Long postId,
+            @ModelAttribute @Valid final PostUpdateRequest postUpdateRequest,
+            @Auth final Member loginMember
+    ) {
+        postCommandService.updatePost(postId, postUpdateRequest, loginMember);
+        return ResponseEntity.ok().build();
+    }
+
+    @PatchMapping("/{postId}/close")
+    public ResponseEntity<Void> closePostEarly(
+            @PathVariable @Positive(message = "게시글 ID는 양의 정수만 가능합니다.") final Long postId,
+            @Auth final Member loginMember
+    ) {
+        postCommandService.closePostEarly(postId, loginMember);
+        return ResponseEntity.ok().build();
+    }
+
+    @DeleteMapping("/{postId}")
+    public ResponseEntity<Void> deletePost(
+            @PathVariable @Positive(message = "게시글 ID는 양의 정수만 가능합니다.") final Long postId,
+            @Auth final Member loginMember
+    ) {
+        postCommandService.deletePost(postId, loginMember);
+        return ResponseEntity.noContent().build();
+    }
+
+}

backend/src/main/java/com/votogether/domain/post/controller/PostCommandControllerDocs.java

@@ -0,0 +1,130 @@
+package com.votogether.domain.post.controller;
+
+import com.votogether.domain.member.entity.Member;
+import com.votogether.domain.post.dto.request.post.PostCreateRequest;
+import com.votogether.domain.post.dto.request.post.PostUpdateRequest;
+import com.votogether.global.exception.ExceptionResponse;
+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.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.Positive;
+import org.springframework.http.ResponseEntity;
+
+@Tag(name = "게시글 커맨드", description = "게시글 커맨드 API")
+public interface PostCommandControllerDocs {
+
+    @Operation(summary = "게시글 작성", description = "게시글을 작성한다.")
+    @ApiResponses({
+            @ApiResponse(
+                    responseCode = "201",
+                    description = "게시글 작성 성공"
+            ),
+            @ApiResponse(
+                    responseCode = "400",
+                    description = "정상적이지 않은 요청",
+                    content = @Content(schema = @Schema(implementation = ExceptionResponse.class))
+            )
+    })
+    ResponseEntity<Void> createPost(
+            @Valid final PostCreateRequest postCreateRequest,
+            final Member loginMember
+    );
+
+    @Operation(summary = "게시글 수정", description = "게시글을 수정한다.")
+    @ApiResponses({
+            @ApiResponse(
+                    responseCode = "200",
+                    description = "게시글 수정 성공"
+            ),
+            @ApiResponse(
+                    responseCode = "400",
+                    description = """
+                            1.게시글 ID가 양의 정수가 아닌 경우
+
+                            2.정상적이지 않은 요청
+
+                            3.게시글이 블라인드 처리된 경우
+
+                            4.게시글 작성자가 아닌 경우
+                            """,
+                    content = @Content(schema = @Schema(implementation = ExceptionResponse.class))
+            ),
+            @ApiResponse(
+                    responseCode = "404",
+                    description = "존재하지 않는 게시글",
+                    content = @Content(schema = @Schema(implementation = ExceptionResponse.class))
+            )
+    })
+    ResponseEntity<Void> updatePost(
+            @Parameter(description = "게시글 ID", example = "1")
+            @Positive(message = "게시글 ID는 양의 정수만 가능합니다.") final Long postId,
+            @Valid final PostUpdateRequest postUpdateRequest,
+            final Member loginMember
+    );
+
+    @Operation(summary = "게시글 조기 마감", description = "게시글을 조기 마감한다.")
+    @ApiResponses({
+            @ApiResponse(
+                    responseCode = "200",
+                    description = "게시글 조기 마감 성공"
+            ),
+            @ApiResponse(
+                    responseCode = "400",
+                    description = """
+                            1.게시글 ID가 양의 정수가 아닌 경우
+
+                            2.게시글이 블라인드 처리된 경우
+
+                            3.게시글 작성자가 아닌 경우
+                            """,
+                    content = @Content(schema = @Schema(implementation = ExceptionResponse.class))
+            ),
+            @ApiResponse(
+                    responseCode = "404",
+                    description = "존재하지 않는 게시글",
+                    content = @Content(schema = @Schema(implementation = ExceptionResponse.class))
+            )
+    })
+    ResponseEntity<Void> closePostEarly(
+            @Parameter(description = "게시글 ID", example = "1")
+            @Positive(message = "게시글 ID는 양의 정수만 가능합니다.") final Long postId,
+            final Member loginMember
+    );
+
+    @Operation(summary = "게시글 삭제", description = "게시글을 삭제한다.")
+    @ApiResponses({
+            @ApiResponse(
+                    responseCode = "204",
+                    description = "게시글 삭제 성공"
+            ),
+            @ApiResponse(
+                    responseCode = "400",
+                    description = """
+                            1.게시글 ID가 양의 정수가 아닌 경우
+
+                            2.게시글이 블라인드 처리된 경우
+
+                            3.게시글 작성자가 아닌 경우
+
+                            4.삭제할 수 없는 투표 수가 존재하는 게시글인 경우
+                            """,
+                    content = @Content(schema = @Schema(implementation = ExceptionResponse.class))
+            ),
+            @ApiResponse(
+                    responseCode = "404",
+                    description = "존재하지 않는 게시글",
+                    content = @Content(schema = @Schema(implementation = ExceptionResponse.class))
+            )
+    })
+    ResponseEntity<Void> deletePost(
+            @Parameter(description = "게시글 ID", example = "1")
+            @Positive(message = "게시글 ID는 양의 정수만 가능합니다.") final Long postId,
+            final Member loginMember
+    );
+
+}