[Feat] 진행 중인 투표 목록 조회 API 개발 (#50)

soonge2 · web-flow · commit 2b023013e866 · 2025-05-05T17:56:36.000+09:00
* feat: 진행 중인 카드 목록 조회 API 응답 DTO 생성 (#36) * refactor: 투표 응답 DTO를 기능별로 list/와 result/ 하위 패키지로 분리 (#36) * feat: 커스텀 에러 코드 추가 (#36) * feat: 진행 중 투표 목록용 커서 파서 추가(#36) * feat: QueryDSL 환경 설정 및 Q 클래스 생성 설정 추가 (#36) - querydsl-core, querydsl-jpa(jakarta) 의존성 추가 - annotationProcessor 설정을 통한 Q 클래스 자동 생성 설정 - generated/querydsl 디렉토리 설정 및 sourceSets 등록 - JPAQueryFactory 빈 등록을 위한 QuerydslConfig 생성 - QueryDSL 관련 캐시 및 빌드 이슈 해결 * refactor: config 패키지 구조를 기능별로 분리 (security, querydsl, jpa) (#36) * feat: 진행 중인 투표 목록 조회용 QueryDSL 리포지토리 구현 (#36) - 사용자가 접근 가능한 그룹(공개 그룹 + 참여 그룹)의 진행 중인 투표만 조회 - 커서 기반 페이지네이션 조건 (closedAt, createdAt) - 사용자 참여 여부 필터링 (응답하지 않은 투표만) * chore: Hibernate SQL 디버깅을 위한 trace 로그 레벨 설정 (#36) - org.hibernate.type.descriptor.sql 로그 레벨을 trace로 설정하여 바인딩 값 확인 가능 * feat: 진행 중인 투표 목록 조회 서비스 로직 구현 (#36) - getActiveVotes(): 비로그인/로그인 분기 처리 및 커서 기반 페이지네이션 지원 - getAccessibleGroups(): 공개 그룹 + 사용자 소속 그룹 권한 기반 접근 목록 반환 - VoteListResponse 구성 및 hasNext, nextCursor 처리 포함 * feat: 진행 중인 투표 목록 조회 API 컨트롤러 구현 및 비로그인 접근 허용 설정 (#36) * feat: 미래 시간 커서 사용 시 성공 응답 처리 및 INVALID_CURSOR 예외 삭제(#36)
diff --git a/build.gradle b/build.gradle
@@ -38,8 +38,39 @@ dependencies {
 	testImplementation 'org.springframework.boot:spring-boot-starter-test'
 	testImplementation 'org.springframework.security:spring-security-test'
 	testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+
+	// querydsl 의존성
+	implementation "com.querydsl:querydsl-core:5.1.0"
+	implementation "com.querydsl:querydsl-jpa:5.1.0:jakarta"
+
+	annotationProcessor "com.querydsl:querydsl-apt:5.1.0:jakarta"
+	annotationProcessor 'jakarta.persistence:jakarta.persistence-api'
+	annotationProcessor 'jakarta.annotation:jakarta.annotation-api'
+
+//	testImplementation 'org.springframework.boot:spring-boot-starter-test'
+//	testImplementation 'jakarta.persistence:jakarta.persistence-api'
+//	testImplementation 'com.querydsl:querydsl-jpa:5.1.0:jakarta'
 }
 
 tasks.named('test') {
 	useJUnitPlatform()
 }
+
+// QueryDSL Q파일 생성용
+def querydslDir = layout.buildDirectory.dir("generated/querydsl").get().asFile
+
+sourceSets {
+	main {
+		java {
+			srcDir querydslDir
+		}
+	}
+}
+
+tasks.withType(JavaCompile).configureEach {
+	options.generatedSourceOutputDirectory.set(querydslDir)
+}
+
+compileJava {
+	options.annotationProcessorPath = configurations.annotationProcessor
+}
diff --git a/src/main/java/com/moa/moa_server/config/jpa/JpaAuditingConfig.java b/src/main/java/com/moa/moa_server/config/jpa/JpaAuditingConfig.java
@@ -1,4 +1,4 @@
-package com.moa.moa_server.config;
+package com.moa.moa_server.config.jpa;
 
 import org.springframework.context.annotation.Configuration;
 import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
diff --git a/src/main/java/com/moa/moa_server/config/querydsl/QuerydslConfig.java b/src/main/java/com/moa/moa_server/config/querydsl/QuerydslConfig.java
@@ -0,0 +1,19 @@
+package com.moa.moa_server.config.querydsl;
+
+import com.querydsl.jpa.impl.JPAQueryFactory;
+import jakarta.persistence.EntityManager;
+import jakarta.persistence.PersistenceContext;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+public class QuerydslConfig {
+
+    @PersistenceContext
+    private EntityManager em;
+
+    @Bean
+    public JPAQueryFactory jpaQueryFactory() {
+        return new JPAQueryFactory(em);
+    }
+}
diff --git a/src/main/java/com/moa/moa_server/config/security/DevSecurityConfig.java b/src/main/java/com/moa/moa_server/config/security/DevSecurityConfig.java
@@ -1,12 +1,11 @@
-package com.moa.moa_server.config;
+package com.moa.moa_server.config.security;
 
-import com.moa.moa_server.config.security.CustomAuthenticationEntryPoint;
-import com.moa.moa_server.config.security.JwtAuthenticationFilter;
 import lombok.RequiredArgsConstructor;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.context.annotation.Profile;
+import org.springframework.http.HttpMethod;
 import org.springframework.security.config.annotation.web.builders.HttpSecurity;
 import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
 import org.springframework.security.config.annotation.web.configurers.AbstractHttpConfigurer;
@@ -21,7 +20,7 @@
 
 import java.util.List;
 
-import static com.moa.moa_server.config.SecurityConstants.ALLOWED_URLS;
+import static com.moa.moa_server.config.security.SecurityConstants.ALLOWED_URLS;
 
 @RequiredArgsConstructor
 @EnableWebSecurity
@@ -44,6 +43,7 @@ public SecurityFilterChain securityFilterChain(HttpSecurity http, CorsConfigurat
                 .formLogin(AbstractHttpConfigurer::disable)
                 .exceptionHandling(ex -> ex.authenticationEntryPoint(customAuthenticationEntryPoint))
                 .authorizeHttpRequests(auth -> auth
+                        .requestMatchers(HttpMethod.GET, "/api/v1/votes").permitAll()
                         .requestMatchers(ALLOWED_URLS).permitAll()
                         .anyRequest().authenticated()
                 )
diff --git a/src/main/java/com/moa/moa_server/config/security/LocalSecurityConfig.java b/src/main/java/com/moa/moa_server/config/security/LocalSecurityConfig.java
@@ -1,11 +1,10 @@
-package com.moa.moa_server.config;
+package com.moa.moa_server.config.security;
 
-import com.moa.moa_server.config.security.CustomAuthenticationEntryPoint;
-import com.moa.moa_server.config.security.JwtAuthenticationFilter;
 import lombok.RequiredArgsConstructor;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.context.annotation.Profile;
+import org.springframework.http.HttpMethod;
 import org.springframework.security.config.Customizer;
 import org.springframework.security.config.annotation.web.builders.HttpSecurity;
 import org.springframework.security.config.annotation.web.configurers.AbstractHttpConfigurer;
@@ -15,7 +14,7 @@
 import org.springframework.security.web.SecurityFilterChain;
 import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter;
 
-import static com.moa.moa_server.config.SecurityConstants.ALLOWED_URLS;
+import static com.moa.moa_server.config.security.SecurityConstants.ALLOWED_URLS;
 
 @RequiredArgsConstructor
 @Configuration
@@ -34,6 +33,7 @@ public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Excepti
                 .formLogin(AbstractHttpConfigurer::disable)
                 .exceptionHandling(ex -> ex.authenticationEntryPoint(customAuthenticationEntryPoint))
                 .authorizeHttpRequests(auth -> auth
+                        .requestMatchers(HttpMethod.GET, "/api/v1/votes").permitAll()
                         .requestMatchers(ALLOWED_URLS).permitAll()
                         .anyRequest().authenticated()
                 )
diff --git a/src/main/java/com/moa/moa_server/config/security/ProdSecurityConfig.java b/src/main/java/com/moa/moa_server/config/security/ProdSecurityConfig.java
@@ -1,17 +1,16 @@
-package com.moa.moa_server.config;
+package com.moa.moa_server.config.security;
 
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.context.annotation.Profile;
 import org.springframework.security.config.Customizer;
 import org.springframework.security.config.annotation.web.builders.HttpSecurity;
-import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
 import org.springframework.security.config.annotation.web.configurers.AbstractHttpConfigurer;
 import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
 import org.springframework.security.crypto.password.PasswordEncoder;
 import org.springframework.security.web.SecurityFilterChain;
 
-import static com.moa.moa_server.config.SecurityConstants.ALLOWED_URLS;
+import static com.moa.moa_server.config.security.SecurityConstants.ALLOWED_URLS;
 
 @Configuration
 @Profile("prod")
diff --git a/src/main/java/com/moa/moa_server/config/security/SecurityConstants.java b/src/main/java/com/moa/moa_server/config/security/SecurityConstants.java
@@ -1,4 +1,4 @@
-package com.moa.moa_server.config;
+package com.moa.moa_server.config.security;
 
 public class SecurityConstants {
     public static final String[] ALLOWED_URLS = {
diff --git a/src/main/java/com/moa/moa_server/domain/global/cursor/VoteClosedCursor.java b/src/main/java/com/moa/moa_server/domain/global/cursor/VoteClosedCursor.java
@@ -0,0 +1,37 @@
+package com.moa.moa_server.domain.global.cursor;
+
+import com.moa.moa_server.domain.vote.handler.VoteErrorCode;
+import com.moa.moa_server.domain.vote.handler.VoteException;
+import lombok.extern.slf4j.Slf4j;
+
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+
+@Slf4j
+public record VoteClosedCursor(LocalDateTime closedAt, LocalDateTime createdAt) {
+
+    /**
+     * "closedAt_createdAt" 형식의 커서를 LocalDateTime 쌍으로 파싱
+     */
+    public static VoteClosedCursor parse(String cursor) {
+        try {
+            String[] parts = cursor.split("_");
+            if (parts.length != 2) {
+                log.warn("[VoteClosedCursor#parse] Cursor must contain exactly two parts.");
+                throw new VoteException(VoteErrorCode.INVALID_CURSOR_FORMAT);
+            }
+            return new VoteClosedCursor(
+                    LocalDateTime.parse(parts[0]),
+                    LocalDateTime.parse(parts[1])
+            );
+        } catch (Exception e) {
+            log.warn("[VoteClosedCursor#parse] Failed to parse cursor '{}': {}", cursor, e.toString());
+            throw new VoteException(VoteErrorCode.INVALID_CURSOR_FORMAT);
+        }
+    }
+
+    public String encode() {
+        DateTimeFormatter formatter = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
+        return closedAt.format(formatter) + "_" + createdAt.format(formatter);
+    }
+}
diff --git a/src/main/java/com/moa/moa_server/domain/group/handler/GroupErrorCode.java b/src/main/java/com/moa/moa_server/domain/group/handler/GroupErrorCode.java
@@ -0,0 +1,14 @@
+package com.moa.moa_server.domain.group.handler;
+
+import com.moa.moa_server.domain.global.exception.BaseErrorCode;
+import org.springframework.http.HttpStatus;
+
+public enum GroupErrorCode implements BaseErrorCode {
+    GROUP_NOT_FOUND(HttpStatus.NOT_FOUND),;
+
+    private final HttpStatus status;
+
+    GroupErrorCode(HttpStatus status) { this.status = status; }
+
+    public HttpStatus getStatus() { return status; }
+}
diff --git a/src/main/java/com/moa/moa_server/domain/group/repository/GroupMemberRepository.java b/src/main/java/com/moa/moa_server/domain/group/repository/GroupMemberRepository.java
@@ -5,10 +5,15 @@
 import com.moa.moa_server.domain.user.entity.User;
 import org.springframework.data.jpa.repository.JpaRepository;
 import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
 
+import java.util.List;
 import java.util.Optional;
 
 public interface GroupMemberRepository extends JpaRepository<GroupMember, Long> {
     @Query("SELECT gm FROM GroupMember gm WHERE gm.group = :group AND gm.user = :user")
     Optional<GroupMember> findByGroupAndUserIncludingDeleted(Group group, User user);
+
+    @Query("SELECT gm.group FROM GroupMember gm WHERE gm.user = :user AND gm.deletedAt IS NULL")
+    List<Group> findAllActiveGroupsByUser(@Param("user") User user);
 }
diff --git a/src/main/java/com/moa/moa_server/domain/vote/controller/VoteController.java b/src/main/java/com/moa/moa_server/domain/vote/controller/VoteController.java
@@ -5,7 +5,8 @@
 import com.moa.moa_server.domain.vote.dto.request.VoteSubmitRequest;
 import com.moa.moa_server.domain.vote.dto.response.VoteCreateResponse;
 import com.moa.moa_server.domain.vote.dto.response.VoteDetailResponse;
-import com.moa.moa_server.domain.vote.dto.response.VoteResultResponse;
+import com.moa.moa_server.domain.vote.dto.response.list.VoteListResponse;
+import com.moa.moa_server.domain.vote.dto.response.result.VoteResultResponse;
 import com.moa.moa_server.domain.vote.service.VoteService;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.ResponseEntity;
@@ -59,4 +60,14 @@ public ResponseEntity<ApiResponse> getVoteResult(
         VoteResultResponse response = voteService.getVoteResult(userId, voteId);
         return ResponseEntity.ok(new ApiResponse("SUCCESS", response));
     }
+
+    @GetMapping
+    public VoteListResponse getActiveVotes(
+            @AuthenticationPrincipal Long userId,
+            @RequestParam(required = false) Integer groupId,
+            @RequestParam(required = false) String cursor,
+            @RequestParam(required = false) Integer size
+    ) {
+        return voteService.getActiveVotes(userId, groupId, cursor, size);
+    }
 }
diff --git a/src/main/java/com/moa/moa_server/domain/vote/dto/response/list/VoteListItem.java b/src/main/java/com/moa/moa_server/domain/vote/dto/response/list/VoteListItem.java
@@ -0,0 +1,32 @@
+package com.moa.moa_server.domain.vote.dto.response.list;
+
+import com.moa.moa_server.domain.vote.entity.Vote;
+
+import java.time.LocalDateTime;
+
+public record VoteListItem(
+        Long voteId,
+        Long groupId,
+        String authorNickname,
+        String content,
+        String imageUrl,
+        LocalDateTime createdAt,
+        LocalDateTime closedAt,
+        int adminVote,
+        String voteType
+) {
+
+    public static VoteListItem from(Vote vote) {
+        return new VoteListItem(
+                vote.getId(),
+                vote.getGroup().getId(),
+                vote.getUser().getNickname(),
+                vote.getContent(),
+                vote.getImageUrl(),
+                vote.getCreatedAt(),
+                vote.getClosedAt(),
+                vote.isAdminVote() ? 1 : 0,
+                vote.getVoteType().name()
+        );
+    }
+}
diff --git a/src/main/java/com/moa/moa_server/domain/vote/dto/response/list/VoteListResponse.java b/src/main/java/com/moa/moa_server/domain/vote/dto/response/list/VoteListResponse.java
@@ -0,0 +1,10 @@
+package com.moa.moa_server.domain.vote.dto.response.list;
+
+import java.util.List;
+
+public record VoteListResponse(
+        List<VoteListItem> votes,
+        String nextCursor,
+        boolean hasNext,
+        int size
+) {}
diff --git a/src/main/java/com/moa/moa_server/domain/vote/dto/response/result/VoteOptionResult.java b/src/main/java/com/moa/moa_server/domain/vote/dto/response/result/VoteOptionResult.java
@@ -1,4 +1,4 @@
-package com.moa.moa_server.domain.vote.dto.response;
+package com.moa.moa_server.domain.vote.dto.response.result;
 
 public record VoteOptionResult(
         int optionNumber,
diff --git a/src/main/java/com/moa/moa_server/domain/vote/dto/response/result/VoteResultResponse.java b/src/main/java/com/moa/moa_server/domain/vote/dto/response/result/VoteResultResponse.java
@@ -1,4 +1,4 @@
-package com.moa.moa_server.domain.vote.dto.response;
+package com.moa.moa_server.domain.vote.dto.response.result;
 
 import java.util.List;
 
diff --git a/src/main/java/com/moa/moa_server/domain/vote/handler/VoteErrorCode.java b/src/main/java/com/moa/moa_server/domain/vote/handler/VoteErrorCode.java
@@ -14,7 +14,8 @@ public enum VoteErrorCode implements BaseErrorCode {
     FORBIDDEN(HttpStatus.FORBIDDEN),
     INVALID_OPTION(HttpStatus.BAD_REQUEST),
     ALREADY_VOTED(HttpStatus.CONFLICT),
-    VOTE_NOT_OPENED(HttpStatus.FORBIDDEN),;
+    VOTE_NOT_OPENED(HttpStatus.FORBIDDEN),
+    INVALID_CURSOR_FORMAT(HttpStatus.BAD_REQUEST),;
 
     private final HttpStatus status;
 
diff --git a/src/main/java/com/moa/moa_server/domain/vote/repository/VoteRepository.java b/src/main/java/com/moa/moa_server/domain/vote/repository/VoteRepository.java
@@ -3,5 +3,5 @@
 import com.moa.moa_server.domain.vote.entity.Vote;
 import org.springframework.data.jpa.repository.JpaRepository;
 
-public interface VoteRepository extends JpaRepository<Vote, Long> {
+public interface VoteRepository extends JpaRepository<Vote, Long>, VoteRepositoryCustom {
 }
diff --git a/src/main/java/com/moa/moa_server/domain/vote/repository/VoteRepositoryCustom.java b/src/main/java/com/moa/moa_server/domain/vote/repository/VoteRepositoryCustom.java
@@ -0,0 +1,13 @@
+package com.moa.moa_server.domain.vote.repository;
+
+import com.moa.moa_server.domain.global.cursor.VoteClosedCursor;
+import com.moa.moa_server.domain.group.entity.Group;
+import com.moa.moa_server.domain.user.entity.User;
+import com.moa.moa_server.domain.vote.entity.Vote;
+import jakarta.annotation.Nullable;
+
+import java.util.List;
+
+public interface VoteRepositoryCustom {
+    List<Vote> findActiveVotes(List<Group> accessibleGroups, @Nullable VoteClosedCursor cursor, @Nullable User user, int size);
+}
diff --git a/src/main/java/com/moa/moa_server/domain/vote/repository/impl/VoteRepositoryImpl.java b/src/main/java/com/moa/moa_server/domain/vote/repository/impl/VoteRepositoryImpl.java
diff --git a/src/main/java/com/moa/moa_server/domain/vote/service/VoteService.java b/src/main/java/com/moa/moa_server/domain/vote/service/VoteService.java
diff --git a/src/main/resources/application-local.yaml b/src/main/resources/application-local.yaml

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-package com.moa.moa_server.config;`
	`1`	`+package com.moa.moa_server.config.jpa;`
`2`	`2`
`3`	`3`	`import org.springframework.context.annotation.Configuration;`
`4`	`4`	`import org.springframework.data.jpa.repository.config.EnableJpaAuditing;`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-package com.moa.moa_server.config;`
	`1`	`+package com.moa.moa_server.config.security;`
`2`	`2`
`3`	`3`	`public class SecurityConstants {`
`4`	`4`	`public static final String[] ALLOWED_URLS = {`