[DDING-92] 지원자 전체조회 API 구현 (#239)

Author: Seooooo24

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/entity/FormApplicationStatus.java

@@ -0,0 +1,34 @@
+package ddingdong.ddingdongBE.domain.formapplication.api;
+
+import ddingdong.ddingdongBE.auth.PrincipalDetails;
+import ddingdong.ddingdongBE.domain.formapplication.controller.dto.response.MyFormApplicationPageResponse;
+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.security.SecurityRequirement;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.http.HttpStatus;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.*;
+
+@Tag(name = "Form - Club", description = "Form API")
+@RequestMapping("/server/central")
+public interface CentralFormApplicationApi {
+    @Operation(summary = "지원자 전체 조회 API")
+    @Parameter(name = "size", description = "한 페이지당 조회할 지원자 수 (기본값: 15)")
+    @Parameter(name = "currentCursorId", description = "현재 커서 위치 (첫 페이지: -1)")
+    @ApiResponse(responseCode = "200", description = "지원자 전체 조회 성공",
+            content = @Content(schema = @Schema(implementation = MyFormApplicationPageResponse.class)))
+    @ResponseStatus(HttpStatus.OK)
+    @SecurityRequirement(name = "AccessToken")
+    @GetMapping("/my/forms/{formId}/applications")
+    MyFormApplicationPageResponse getMyFormApplicationPage(
+            @PathVariable("formId") Long formId,
+            @RequestParam(value = "size", defaultValue = "15") int size,
+            @RequestParam(value = "currentCursorId", defaultValue = "-1") Long currentCursorId,
+            @AuthenticationPrincipal PrincipalDetails principalDetails
+    );
+
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/repository/FormApplicationRepository.java

@@ -1,6 +1,6 @@
-package ddingdong.ddingdongBE.domain.formapplicaion.api;
+package ddingdong.ddingdongBE.domain.formapplication.api;
 
-import ddingdong.ddingdongBE.domain.formapplicaion.controller.dto.request.CreateFormApplicationRequest;
+import ddingdong.ddingdongBE.domain.formapplication.controller.dto.request.CreateFormApplicationRequest;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.responses.ApiResponse;
 import io.swagger.v3.oas.annotations.tags.Tag;
@@ -10,7 +10,7 @@
 
 @Tag(name = "Form - User", description = "User Form API")
 @RequestMapping("/server")
-public interface UserFormApi {
+public interface UserFormApplicationApi {
 
     @Operation(summary = "지원하기 API")
     @ApiResponse(responseCode = "201", description = "지원하기 성공")

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/service/FacadeUserFormService.java

@@ -0,0 +1,24 @@
+package ddingdong.ddingdongBE.domain.formapplication.controller;
+
+import ddingdong.ddingdongBE.auth.PrincipalDetails;
+import ddingdong.ddingdongBE.domain.formapplication.service.FacadeCentralFormApplicationService;
+import ddingdong.ddingdongBE.domain.formapplication.api.CentralFormApplicationApi;
+import ddingdong.ddingdongBE.domain.formapplication.controller.dto.response.MyFormApplicationPageResponse;
+import ddingdong.ddingdongBE.domain.formapplication.service.dto.query.MyFormApplicationPageQuery;
+import ddingdong.ddingdongBE.domain.user.entity.User;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+public class CentralFormApplicationController implements CentralFormApplicationApi {
+
+    private final FacadeCentralFormApplicationService facadeCentralFormService;
+
+    @Override
+    public MyFormApplicationPageResponse getMyFormApplicationPage(Long formId, int size, Long currentCursorId, PrincipalDetails principalDetails) {
+        User user = principalDetails.getUser();
+        MyFormApplicationPageQuery query = facadeCentralFormService.getMyFormApplicationPage(formId, user, size, currentCursorId);
+        return MyFormApplicationPageResponse.from(query);
+    }
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/service/FormAnswerService.java

@@ -1,14 +1,14 @@
-package ddingdong.ddingdongBE.domain.formapplicaion.controller;
+package ddingdong.ddingdongBE.domain.formapplication.controller;
 
-import ddingdong.ddingdongBE.domain.formapplicaion.api.UserFormApi;
-import ddingdong.ddingdongBE.domain.formapplicaion.controller.dto.request.CreateFormApplicationRequest;
-import ddingdong.ddingdongBE.domain.formapplicaion.service.FacadeUserFormService;
+import ddingdong.ddingdongBE.domain.formapplication.api.UserFormApplicationApi;
+import ddingdong.ddingdongBE.domain.formapplication.controller.dto.request.CreateFormApplicationRequest;
+import ddingdong.ddingdongBE.domain.formapplication.service.FacadeUserFormService;
 import lombok.RequiredArgsConstructor;
 import org.springframework.web.bind.annotation.RestController;
 
 @RestController
 @RequiredArgsConstructor
-public class UserFormController implements UserFormApi {
+public class UserFormApplicationController implements UserFormApplicationApi {
 
     private final FacadeUserFormService facadeUserFormService;
 

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/service/FormApplicationService.java

@@ -1,8 +1,8 @@
-package ddingdong.ddingdongBE.domain.formapplicaion.controller.dto.request;
+package ddingdong.ddingdongBE.domain.formapplication.controller.dto.request;
 
-import ddingdong.ddingdongBE.domain.formapplicaion.entity.FormApplicationStatus;
-import ddingdong.ddingdongBE.domain.formapplicaion.service.dto.CreateFormApplicationCommand;
-import ddingdong.ddingdongBE.domain.formapplicaion.service.dto.CreateFormApplicationCommand.CreateFormAnswerCommand;
+import ddingdong.ddingdongBE.domain.formapplication.entity.FormApplicationStatus;
+import ddingdong.ddingdongBE.domain.formapplication.service.dto.command.CreateFormApplicationCommand;
+import ddingdong.ddingdongBE.domain.formapplication.service.dto.command.CreateFormApplicationCommand.CreateFormAnswerCommand;
 import io.swagger.v3.oas.annotations.media.ArraySchema;
 import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.NotNull;

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/service/GeneralFormApplicationService.java

@@ -0,0 +1,57 @@
+package ddingdong.ddingdongBE.domain.formapplication.controller.dto.response;
+
+import ddingdong.ddingdongBE.domain.formapplication.service.dto.query.MyFormApplicationPageQuery;
+import ddingdong.ddingdongBE.domain.formapplication.service.dto.query.MyFormApplicationPageQuery.FormApplicationListQuery;
+import io.swagger.v3.oas.annotations.media.ArraySchema;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+public record MyFormApplicationPageResponse (
+        @ArraySchema(schema = @Schema(name = "지원자 전체 조회 페이지", implementation = MyFormApplicationPageResponse.MyFormApplicationListResponse.class))
+        List<MyFormApplicationListResponse> formApplications,
+        @Schema(name = "지원자 전체 조회 페이지 정보", implementation = PagingResponse.class)
+        PagingResponse pagingInfo
+) {
+    public static MyFormApplicationPageResponse from(MyFormApplicationPageQuery myFormApplicationPageQuery) {
+        List<MyFormApplicationListResponse> formApplications = myFormApplicationPageQuery.formApplicationListQueries().stream()
+                .map(MyFormApplicationListResponse::from)
+                .toList();
+        return new MyFormApplicationPageResponse(formApplications, PagingResponse.from(myFormApplicationPageQuery.pagingQuery()));
+    }
+
+    @Builder
+    record MyFormApplicationListResponse(
+            @Schema(description = "지원자 id", example = "1")
+            Long id,
+
+            @Schema(description = "폼 id", example = "1")
+            Long formId,
+
+            @Schema(description = "지원 시각", example = "2025-01-01T00:00")
+            LocalDateTime submittedAt,
+
+            @Schema(description = "지원자 이름", example = "김띵동")
+            String name,
+
+            @Schema(description = "지원자 학번", example = "60200000")
+            String studentNumber,
+
+            @Schema(description = "지원자 상태", example = "SUBMITTED")
+            String status
+    ) {
+
+        public static MyFormApplicationListResponse from(FormApplicationListQuery formApplicationListQuery) {
+            return MyFormApplicationListResponse.builder()
+                    .id(formApplicationListQuery.id())
+                    .formId(formApplicationListQuery.formId())
+                    .submittedAt(formApplicationListQuery.submittedAt())
+                    .name(formApplicationListQuery.name())
+                    .studentNumber(formApplicationListQuery.studentNumber())
+                    .status(formApplicationListQuery.status())
+                    .build();
+        }
+    }
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplication/api/CentralFormApplicationApi.java

@@ -0,0 +1,19 @@
+package ddingdong.ddingdongBE.domain.formapplication.controller.dto.response;
+
+import ddingdong.ddingdongBE.domain.formapplication.service.dto.query.PagingQuery;
+import io.swagger.v3.oas.annotations.media.Schema;
+
+public record PagingResponse(
+    @Schema(name = "현재 커서 id", description = "9")
+    Long currentCursorId,
+    @Schema(name = "다음 커서 id", description = "10")
+    Long nextCursorId,
+    @Schema(name = "다음 커서 존재 여부", description = "true")
+    boolean hasNext
+) {
+
+    public static PagingResponse from(PagingQuery pagingQuery) {
+        return new PagingResponse(pagingQuery.currentCursorId(), pagingQuery.nextCursorId(), pagingQuery.hasNext());
+    }
+
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/api/UserFormApi.java renamed to src/main/java/ddingdong/ddingdongBE/domain/formapplication/api/UserFormApplicationApi.java

@@ -1,4 +1,4 @@
-package ddingdong.ddingdongBE.domain.formapplicaion.entity;
+package ddingdong.ddingdongBE.domain.formapplication.entity;
 
 import ddingdong.ddingdongBE.common.BaseEntity;
 import ddingdong.ddingdongBE.common.converter.StringListConverter;

src/main/java/ddingdong/ddingdongBE/domain/formapplication/controller/CentralFormApplicationController.java

@@ -1,4 +1,4 @@
-package ddingdong.ddingdongBE.domain.formapplicaion.entity;
+package ddingdong.ddingdongBE.domain.formapplication.entity;
 
 import ddingdong.ddingdongBE.common.BaseEntity;
 import ddingdong.ddingdongBE.domain.form.entity.Form;

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/controller/UserFormController.java renamed to src/main/java/ddingdong/ddingdongBE/domain/formapplication/controller/UserFormApplicationController.java

@@ -0,0 +1,9 @@
+package ddingdong.ddingdongBE.domain.formapplication.entity;
+
+public enum FormApplicationStatus {
+    SUBMITTED,
+    FIRST_PASS,
+    FINAL_PASS,
+    FIRST_FAIL,
+    FINAL_FAIL
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/controller/dto/request/CreateFormApplicationRequest.java renamed to src/main/java/ddingdong/ddingdongBE/domain/formapplication/controller/dto/request/CreateFormApplicationRequest.java

@@ -1,6 +1,6 @@
-package ddingdong.ddingdongBE.domain.formapplicaion.repository;
+package ddingdong.ddingdongBE.domain.formapplication.repository;
 
-import ddingdong.ddingdongBE.domain.formapplicaion.entity.FormAnswer;
+import ddingdong.ddingdongBE.domain.formapplication.entity.FormAnswer;
 import org.springframework.data.jpa.repository.JpaRepository;
 
 public interface FormAnswerRepository extends JpaRepository<FormAnswer, Long> {

src/main/java/ddingdong/ddingdongBE/domain/formapplication/controller/dto/response/MyFormApplicationPageResponse.java

@@ -0,0 +1,24 @@
+package ddingdong.ddingdongBE.domain.formapplication.repository;
+
+import ddingdong.ddingdongBE.domain.formapplication.entity.FormApplication;
+import org.springframework.data.domain.Slice;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+
+public interface FormApplicationRepository extends JpaRepository<FormApplication, Long> {
+    @Query(value = """
+            select *
+              from form_application f
+              where (:currentCursorId = -1 or id < :currentCursorId)
+              and f.form_id = :formId
+              order by f.id DESC
+              limit :size
+            """, nativeQuery = true)
+    Slice<FormApplication> findPageByFormIdOrderById(
+            @Param("formId") Long formId,
+            @Param("size") int size,
+            @Param("currentCursorId") Long currentCursorId
+    );
+
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplication/controller/dto/response/PagingResponse.java

@@ -0,0 +1,10 @@
+package ddingdong.ddingdongBE.domain.formapplication.service;
+
+import ddingdong.ddingdongBE.domain.formapplication.service.dto.query.MyFormApplicationPageQuery;
+import ddingdong.ddingdongBE.domain.user.entity.User;
+
+public interface FacadeCentralFormApplicationService {
+
+    MyFormApplicationPageQuery getMyFormApplicationPage(Long formId, User user, int size, Long currentCursorId);
+
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/entity/FormAnswer.java renamed to src/main/java/ddingdong/ddingdongBE/domain/formapplication/entity/FormAnswer.java

@@ -0,0 +1,49 @@
+package ddingdong.ddingdongBE.domain.formapplication.service;
+
+import ddingdong.ddingdongBE.domain.club.entity.Club;
+import ddingdong.ddingdongBE.domain.club.service.ClubService;
+import ddingdong.ddingdongBE.domain.formapplication.service.dto.query.PagingQuery;
+import ddingdong.ddingdongBE.domain.form.entity.Form;
+import ddingdong.ddingdongBE.domain.form.service.FormService;
+import ddingdong.ddingdongBE.domain.formapplication.entity.FormApplication;
+import ddingdong.ddingdongBE.domain.formapplication.service.dto.query.MyFormApplicationPageQuery;
+import ddingdong.ddingdongBE.domain.formapplication.service.dto.query.MyFormApplicationPageQuery.FormApplicationListQuery;
+import ddingdong.ddingdongBE.domain.user.entity.User;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Slice;
+import org.springframework.security.access.AccessDeniedException;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Service
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+public class FacadeCentralFormApplicationServiceImpl implements FacadeCentralFormApplicationService {
+
+    private final ClubService clubService;
+    private final FormService formService;
+    private final FormApplicationService formApplicationService;
+
+    @Override
+    public MyFormApplicationPageQuery getMyFormApplicationPage(Long formId, User user, int size, Long currentCursorId) {
+        Club club = clubService.getByUserId(user.getId());
+        Form form = formService.getById(formId);
+        if (!form.getClub().equals(club)) {
+            throw new AccessDeniedException("권한이 없습니다.");
+        }
+        Slice<FormApplication> formApplicationPage = formApplicationService.getFormApplicationPageByFormId(formId, size, currentCursorId);
+        if (formApplicationPage == null) {
+            return MyFormApplicationPageQuery.createEmpty();
+        }
+        List<FormApplication> completeFormApplications = formApplicationPage.getContent();
+        List<FormApplicationListQuery> formApplicationListQueries = completeFormApplications.stream()
+                .map(FormApplicationListQuery::of)
+                .toList();
+        PagingQuery pagingQuery = PagingQuery.of(currentCursorId, completeFormApplications, formApplicationPage.hasNext());
+
+        return MyFormApplicationPageQuery.of(formApplicationListQueries, pagingQuery);
+
+    }
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/entity/FormApplication.java renamed to src/main/java/ddingdong/ddingdongBE/domain/formapplication/entity/FormApplication.java

@@ -0,0 +1,9 @@
+package ddingdong.ddingdongBE.domain.formapplication.service;
+
+import ddingdong.ddingdongBE.domain.formapplication.service.dto.command.CreateFormApplicationCommand;
+
+public interface FacadeUserFormService {
+
+    void createFormApplication(CreateFormApplicationCommand createFormApplicationCommand);
+
+}