feat[poll] 투표기ë �¥ 추가

Author: GarakChoi

backend/src/main/java/com/ai/lawyer/domain/poll/controller/PollController.java

@@ -1,18 +1,24 @@
 package com.ai.lawyer.domain.poll.controller;
 
+import com.ai.lawyer.domain.poll.dto.PollCreateDto;
 import com.ai.lawyer.domain.poll.dto.PollDto;
-import com.ai.lawyer.domain.poll.dto.PollWithPostDto;
+import com.ai.lawyer.domain.poll.dto.PollVoteDto;
 import com.ai.lawyer.domain.poll.entity.PollVote;
 import com.ai.lawyer.domain.poll.entity.PollOptions;
 import com.ai.lawyer.domain.poll.entity.PollStatics;
 import com.ai.lawyer.domain.poll.service.PollService;
 import com.ai.lawyer.domain.post.dto.PostDetailDto;
 import com.ai.lawyer.domain.post.service.PostService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
+import org.springframework.security.core.Authentication;
+import org.springframework.security.core.context.SecurityContextHolder;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 
+@Tag(name = "Poll API", description = "투표 관련 API")
 @RestController
 @RequestMapping("/api/polls")
 @RequiredArgsConstructor
@@ -21,55 +27,81 @@ public class PollController {
     private final PollService pollService;
     private final PostService postService;
 
+    @Operation(summary = "투표 단일 조회")
     @GetMapping("/{pollId}")
     public PollDto getPoll(@PathVariable Long pollId) {
         return pollService.getPoll(pollId);
     }
 
+    @Operation(summary = "투표 옵션 목록 조회")
     @GetMapping("/{pollId}/options")
     public List<PollOptions> getPollOptions(@PathVariable Long pollId) {
         return pollService.getPollOptions(pollId);
     }
 
+    @Operation(summary = "투표하기")
     @PostMapping("/{pollId}/vote")
-    public PollVote vote(@PathVariable Long pollId, @RequestParam Long pollItemsId, @RequestParam Long memberId) {
+    public PollVoteDto vote(@PathVariable Long pollId, @RequestParam Long pollItemsId) {
+        Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
+        Long memberId = (Long) authentication.getPrincipal();
         return pollService.vote(pollId, pollItemsId, memberId);
     }
 
+    @Operation(summary = "투표 통계 조회")
     @GetMapping("/{pollId}/statics")
     public List<PollStatics> getPollStatics(@PathVariable Long pollId) {
         return pollService.getPollStatics(pollId);
     }
 
+    @Operation(summary = "투표 종료")
     @PutMapping("/{pollId}/close")
     public void closePoll(@PathVariable Long pollId) {
         pollService.closePoll(pollId);
     }
 
+    @Operation(summary = "투표 삭제")
     @DeleteMapping("/{pollId}")
     public void deletePoll(@PathVariable Long pollId) {
         pollService.deletePoll(pollId);
     }
 
+    @Operation(summary = "진행중인 투표 Top 1 조회")
     @GetMapping("/top/ongoing")
     public PollDto getTopOngoingPoll() {
         return pollService.getTopPollByStatus(PollDto.PollStatus.ONGOING);
     }
 
+    @Operation(summary = "종료된 투표 Top 1 조회")
     @GetMapping("/top/closed")
     public PollDto getTopClosedPoll() {
         return pollService.getTopPollByStatus(PollDto.PollStatus.CLOSED);
     }
 
+    @Operation(summary = "진행중인 투표 상세 조회")
     @GetMapping("/top/ongoing-detail")
     public PostDetailDto getTopOngoingPollDetail() {
         PollDto pollDto = pollService.getTopPollByStatus(PollDto.PollStatus.ONGOING);
         return postService.getPostDetailById(pollDto.getPostId());
     }
 
+    @Operation(summary = "종료된 투표 상세 조회")
     @GetMapping("/top/closed-detail")
     public PostDetailDto getTopClosedPollDetail() {
         PollDto pollDto = pollService.getTopPollByStatus(PollDto.PollStatus.CLOSED);
         return postService.getPostDetailById(pollDto.getPostId());
     }
-}
+
+    @Operation(summary = "투표 생성")
+    @PostMapping("")
+    public PollDto createPoll(@RequestBody PollCreateDto request) {
+        Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
+        Long memberId = (Long) authentication.getPrincipal();
+        return pollService.createPoll(request, memberId);
+    }
+
+    @Operation(summary = "투표 수정")
+    @PutMapping("/{pollId}")
+    public PollDto updatePoll(@PathVariable Long pollId, @RequestBody com.ai.lawyer.domain.poll.dto.PollUpdateDto pollUpdateDto) {
+        return pollService.updatePoll(pollId, pollUpdateDto);
+    }
+}

backend/src/main/java/com/ai/lawyer/domain/poll/dto/PollCreateDto.java

@@ -0,0 +1,21 @@
+package com.ai.lawyer.domain.poll.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import java.util.List;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class PollCreateDto {
+    @Schema(description = "게시글 ID", example = "123")
+    private Long postId;
+    @Schema(description = "투표 제목", example = "당신의 선택은?")
+    private String voteTitle;
+    @Schema(description = "투표 항목(2개 필수)", example = "[{\"content\": \"항목1 내용\"}, {\"content\": \"항목2 내용\"}]")
+    private List<PollOptionCreateDto> pollOptions;
+}

backend/src/main/java/com/ai/lawyer/domain/poll/dto/PollDto.java

@@ -16,6 +16,7 @@ public class PollDto {
     private LocalDateTime createdAt;
     private LocalDateTime closedAt;
     private List<PollOptionDto> pollOptions;
+    private Long totalVoteCount;
 
     public enum PollStatus {
         ONGOING, CLOSED

backend/src/main/java/com/ai/lawyer/domain/poll/dto/PollOptionCreateDto.java

@@ -0,0 +1,16 @@
+package com.ai.lawyer.domain.poll.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class PollOptionCreateDto {
+    @Schema(description = "투표 항목 내용", example = "항목1 내용")
+    private String content;
+}

backend/src/main/java/com/ai/lawyer/domain/poll/dto/PollOptionDto.java

@@ -7,7 +7,9 @@
 @AllArgsConstructor
 @Builder
 public class PollOptionDto {
-    private Long pollOptionId;
+    private Long pollItemsId; // PK
     private String content;
+    private Long voteCount;
+    private java.util.List<PollStaticsDto> statics;
+    private int pollOptionIndex;
 }
-

backend/src/main/java/com/ai/lawyer/domain/poll/dto/PollOptionUpdateDto.java

@@ -0,0 +1,16 @@
+package com.ai.lawyer.domain.poll.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class PollOptionUpdateDto {
+    @Schema(description = "투표 항목 내용", example = "항목1 내용")
+    private String content;
+}

backend/src/main/java/com/ai/lawyer/domain/poll/dto/PollStaticsDto.java

@@ -0,0 +1,14 @@
+package com.ai.lawyer.domain.poll.dto;
+
+import lombok.*;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class PollStaticsDto {
+    private String gender;
+    private String ageGroup;
+    private Long voteCount;
+}
+

backend/src/main/java/com/ai/lawyer/domain/poll/dto/PollUpdateDto.java

@@ -0,0 +1,19 @@
+package com.ai.lawyer.domain.poll.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import java.util.List;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class PollUpdateDto {
+    @Schema(description = "투표 제목", example = "당신의 선택은?")
+    private String voteTitle;
+    @Schema(description = "투표 항목(2개 필수)", example = "[{\"content\": \"항목1 내용\"}, {\"content\": \"항목2 내용\"}]")
+    private List<PollOptionUpdateDto> pollOptions;
+}

backend/src/main/java/com/ai/lawyer/domain/poll/dto/PollVoteDto.java

@@ -0,0 +1,19 @@
+package com.ai.lawyer.domain.poll.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class PollVoteDto {
+    private Long pollVoteId;
+    private Long pollId;
+    private Long pollItemsId;
+    private Long memberId;
+    private Long voteCount;
+}
+

backend/src/main/java/com/ai/lawyer/domain/poll/entity/Poll.java

@@ -19,7 +19,7 @@ public class Poll {
     @Column(name = "poll_id")
     private Long pollId;
 
-    @OneToOne(fetch = FetchType.LAZY, cascade = CascadeType.ALL, orphanRemoval = true)
+    @OneToOne(fetch = FetchType.LAZY)
     @JoinColumn(name = "post_id", nullable = true)
     private Post post;
 
@@ -36,6 +36,9 @@ public class Poll {
     @Column(name = "closed_at")
     private LocalDateTime closedAt;
 
+    @OneToMany(mappedBy = "poll", cascade = CascadeType.REMOVE, orphanRemoval = true)
+    private java.util.List<PollOptions> pollOptions;
+
     // 투표 상태 Enum 타입
     public enum PollStatus {
         ONGOING, CLOSED