[DDING-game] 로고 짝 맞추기 게임 관련 API 구현

src/main/java/ddingdong/ddingdongBE/common/config/SecurityConfig.java

@@ -51,11 +51,13 @@ public SecurityFilterChain filterChain(HttpSecurity http, JwtAuthService authSer
                                 API_PREFIX + "/questions/**",
                                 API_PREFIX + "/feeds/**",
                                 API_PREFIX + "/forms/**",
-                                API_PREFIX + "/file/upload-url/form-application"
+                                API_PREFIX + "/file/upload-url/form-application",
+                                API_PREFIX + "/pair-game/**"
                                 )
                         .permitAll()
                         .requestMatchers(POST,
-                                API_PREFIX + "/forms/{formId}/applications"
+                                API_PREFIX + "/forms/{formId}/applications",
+                                API_PREFIX + "/pair-game/appliers"
                                 )
                         .permitAll()
                         .requestMatchers(API_PREFIX + "/internal/**")

src/main/java/ddingdong/ddingdongBE/common/exception/FileException.java

@@ -0,0 +1,25 @@
+package ddingdong.ddingdongBE.common.exception;
+
+import static org.springframework.http.HttpStatus.BAD_REQUEST;
+
+public class FileException extends CustomException {
+
+    private static final String UPLOADED_FILE_NOT_FOUND_MESSAGE = "업로드 할 파일이 없습니다.";
+    private static final String FILE_READING_ERROR_MESSAGE = "파일을 읽을 수 없습니다.";
+
+    public FileException(String message, int errorCode) { super(message, errorCode); }
+
+    public static final class UploadedFileNotFoundException extends FileException {
+
+        public UploadedFileNotFoundException() {
+            super(UPLOADED_FILE_NOT_FOUND_MESSAGE, BAD_REQUEST.value());
+        }
+    }
+
+    public static final class FileReadingException extends FileException {
+
+      public FileReadingException() {
+        super(FILE_READING_ERROR_MESSAGE, BAD_REQUEST.value());
+      }
+    }
+}

src/main/java/ddingdong/ddingdongBE/common/exception/PairGameApplierException.java

@@ -0,0 +1,17 @@
+package ddingdong.ddingdongBE.common.exception;
+
+import static org.springframework.http.HttpStatus.BAD_REQUEST;
+
+public class PairGameApplierException extends CustomException {
+
+    private static final String DUPLICATED_PAIR_GAME_APPLIER_MESSAGE = "이미 존재하는 응모자입니다.";
+    public PairGameApplierException(String message, int errorCode) {
+        super(message, errorCode);
+    }
+
+    public static final class DuplicatedPairGameApplierException extends PairGameApplierException {
+        public DuplicatedPairGameApplierException() {
+            super(DUPLICATED_PAIR_GAME_APPLIER_MESSAGE, BAD_REQUEST.value());
+        }
+    }
+}

src/main/java/ddingdong/ddingdongBE/domain/club/service/ClubService.java

@@ -12,13 +12,15 @@ public interface ClubService {
 
     Club getByUserId(Long userId);
 
-    List<Club> findAll();
+    List<Club> getAll();
+
+    List<Club> getAllByIds(List<Long> clubIds);
 
     void update(Club club, Club updatedClub);
 
     void delete(Long clubId);
 
     Club getByUserIdWithFetch(Long userId);
 
-    List<UserClubListInfo> findAllClubListInfo();
+    List<UserClubListInfo> getAllClubListInfo();
 }

src/main/java/ddingdong/ddingdongBE/domain/club/service/FacadeAdminClubServiceImpl.java

@@ -38,7 +38,7 @@ public Long create(CreateClubCommand command) {
 
     @Override
     public List<AdminClubListQuery> findAll() {
-        return clubService.findAll().stream()
+        return clubService.getAll().stream()
                 .map(club -> {
                     UploadedFileUrlAndNameQuery clubProfileImageQuery = fileMetaDataService.getCoupledAllByDomainTypeAndEntityId(
                                     DomainType.CLUB_PROFILE, club.getId())

src/main/java/ddingdong/ddingdongBE/domain/club/service/FacadeUserClubServiceImpl.java

@@ -34,7 +34,7 @@ public class FacadeUserClubServiceImpl implements FacadeUserClubService {
 
     @Override
     public List<UserClubListQuery> findAllWithRecruitTimeCheckPoint(LocalDate now) {
-        List<UserClubListInfo> userClubListInfos = clubService.findAllClubListInfo();
+        List<UserClubListInfo> userClubListInfos = clubService.getAllClubListInfo();
         return userClubListInfos.stream()
                 .map(info -> UserClubListQuery.of(info, checkRecruit(now, info.getStart(), info.getEnd()).getText()))
                 .toList();

src/main/java/ddingdong/ddingdongBE/domain/club/service/GeneralClubService.java

@@ -47,15 +47,20 @@ public Club getByUserIdWithFetch(Long userId) {
     }
 
     @Override
-    public List<UserClubListInfo> findAllClubListInfo() {
+    public List<UserClubListInfo> getAllClubListInfo() {
         return clubRepository.findAllClubListInfo(LocalDate.now());
     }
 
     @Override
-    public List<Club> findAll() {
+    public List<Club> getAll() {
         return clubRepository.findAll();
     }
 
+    @Override
+    public List<Club> getAllByIds(List<Long> clubIds) {
+        return clubRepository.findAllById(clubIds);
+    }
+
     @Override
     @Transactional
     public void update(Club club, Club updatedClub) {

src/main/java/ddingdong/ddingdongBE/domain/filemetadata/repository/FileMetaDataRepository.java

@@ -23,6 +23,16 @@ List<FileMetaData> findAllByDomainTypeAndEntityIdWithFileStatus(
             @Param("fileStatus") FileStatus fileStatus
     );
 
+    @Query("""
+    select fmd from FileMetaData fmd
+    where fmd.domainType = :domainType
+    and fmd.fileStatus = :fileStatus
+    """)
+    List<FileMetaData> findAllByDomainTypeWithFileStatus(
+            @Param("domainType") DomainType domainType,
+            @Param("fileStatus") FileStatus fileStatus
+    );
+
     @Query("select fmd from FileMetaData fmd where fmd.entityId = :entityId and fmd.fileStatus = :fileStatus")
     List<FileMetaData> findAllByEntityIdWithFileStatus(
             @Param("entityId") Long entityId,

src/main/java/ddingdong/ddingdongBE/domain/filemetadata/service/FileMetaDataService.java

@@ -16,6 +16,8 @@ public interface FileMetaDataService {
 
     List<FileMetaData> getCoupledAllByDomainTypeAndEntityId(DomainType domainType, Long entityId);
 
+    List<FileMetaData> getCoupledAllByDomainType(DomainType domainType);
+
     List<FileMetaData> getCoupledAllByEntityId(Long entityId);
 
     List<FileMetaData> getCoupledAllByDomainTypeAndEntityIdOrderedAsc(DomainType domainType,

src/main/java/ddingdong/ddingdongBE/domain/filemetadata/service/FileMetaDataServiceImpl.java

@@ -50,6 +50,11 @@ public List<FileMetaData> getCoupledAllByDomainTypeAndEntityId(DomainType domain
         return fileMetaDataRepository.findAllByDomainTypeAndEntityIdWithFileStatus(domainType, entityId, COUPLED);
     }
 
+    @Override
+    public List<FileMetaData> getCoupledAllByDomainType(DomainType domainType) {
+        return fileMetaDataRepository.findAllByDomainTypeWithFileStatus(domainType, COUPLED);
+    }
+
     @Override
     public List<FileMetaData> getCoupledAllByEntityId(Long entityId) {
         return fileMetaDataRepository.findAllByEntityIdWithFileStatus(entityId, COUPLED);

src/main/java/ddingdong/ddingdongBE/domain/pairgame/api/UserPairGameApi.java

@@ -0,0 +1,38 @@
+package ddingdong.ddingdongBE.domain.pairgame.api;
+
+import ddingdong.ddingdongBE.domain.pairgame.controller.dto.request.CreatePairGameApplierRequest;
+import ddingdong.ddingdongBE.domain.pairgame.controller.dto.response.PairGameApplierAmountResponse;
+import ddingdong.ddingdongBE.domain.pairgame.controller.dto.response.PairGameMetaDataResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import org.springframework.http.HttpStatus;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
+
+@Tag(name = "PairGame - User", description = "User PairGame API")
+@RequestMapping("/server")
+public interface UserPairGameApi {
+
+    @Operation(summary = "응모자 생성 API")
+    @ApiResponse(responseCode = "201", description = "응모자 생성 성공")
+    @ResponseStatus(HttpStatus.CREATED)
+    @PostMapping("/pair-game/appliers")
+    void createPairGameApplier(
+            @Valid @RequestPart("request") CreatePairGameApplierRequest request,
+            @RequestPart("file") MultipartFile file
+    );
+
+    @Operation(summary = "응모자 현황 조회 API")
+    @ApiResponse(responseCode = "200", description = "응모자 현황 조회 성공")
+    @ResponseStatus(HttpStatus.OK)
+    @GetMapping("/pair-game/appliers/amount")
+    PairGameApplierAmountResponse getPairGameApplierAmount();
+
+    @Operation(summary = "게임 메타데이터 조회 API")
+    @ApiResponse(responseCode = "200", description = "게임 메타데이터 조회 성공")
+    @ResponseStatus(HttpStatus.OK)
+    @GetMapping("/pair-game/metadata")
+    PairGameMetaDataResponse getPairGameMetaData();
+}

src/main/java/ddingdong/ddingdongBE/domain/pairgame/controller/UserPairGameController.java

@@ -0,0 +1,36 @@
+package ddingdong.ddingdongBE.domain.pairgame.controller;
+
+import ddingdong.ddingdongBE.domain.pairgame.api.UserPairGameApi;
+import ddingdong.ddingdongBE.domain.pairgame.controller.dto.request.CreatePairGameApplierRequest;
+import ddingdong.ddingdongBE.domain.pairgame.controller.dto.response.PairGameApplierAmountResponse;
+import ddingdong.ddingdongBE.domain.pairgame.controller.dto.response.PairGameMetaDataResponse;
+import ddingdong.ddingdongBE.domain.pairgame.service.FacadeUserPairGameService;
+import ddingdong.ddingdongBE.domain.pairgame.service.dto.query.PairGameApplierAmountQuery;
+import ddingdong.ddingdongBE.domain.pairgame.service.dto.query.PairGameMetaDataQuery;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+@RestController
+@RequiredArgsConstructor
+public class UserPairGameController implements UserPairGameApi {
+
+    private final FacadeUserPairGameService facadeUserPairGameService;
+
+    @Override
+    public void createPairGameApplier(CreatePairGameApplierRequest createPairGameApplierRequest, MultipartFile studentFeeImageFile) {
+        facadeUserPairGameService.createPairGameApplier(createPairGameApplierRequest.toCommand(studentFeeImageFile));
+    }
+
+    @Override
+    public PairGameApplierAmountResponse getPairGameApplierAmount() {
+        PairGameApplierAmountQuery query = facadeUserPairGameService.getPairGameApplierAmount();
+        return PairGameApplierAmountResponse.from(query);
+    }
+
+    @Override
+    public PairGameMetaDataResponse getPairGameMetaData() {
+        PairGameMetaDataQuery query = facadeUserPairGameService.getPairGameMetaData();
+        return PairGameMetaDataResponse.from(query);
+    }
+}

src/main/java/ddingdong/ddingdongBE/domain/pairgame/controller/dto/request/CreatePairGameApplierRequest.java

@@ -0,0 +1,35 @@
+package ddingdong.ddingdongBE.domain.pairgame.controller.dto.request;
+
+import ddingdong.ddingdongBE.domain.pairgame.service.dto.command.CreatePairGameApplierCommand;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.web.multipart.MultipartFile;
+
+public record CreatePairGameApplierRequest (
+
+    @NotNull(message = "응모자 이름은 필수 입력 사항입니다.")
+    @Schema(description = "응모자 이름", example = "김띵동")
+    String name,
+
+    @NotNull(message = "응모자 학과는 필수 입력 사항입니다.")
+    @Schema(description = "응모자 학과", example = "융합소프트웨어학부")
+    String department,
+
+    @NotNull(message = "응모자 학번은 필수 입력 사항입니다.")
+    @Schema(description = "응모자 학번", example = "60000000")
+    String studentNumber,
+
+    @NotNull(message = "응모자 전화번호는 필수 입력 사항입니다.")
+    @Schema(description = "응모자 전화번호", example = "010-0000-0000")
+    String phoneNumber
+    ) {
+    public CreatePairGameApplierCommand toCommand(MultipartFile studentFeeImageFile) {
+        return CreatePairGameApplierCommand.builder()
+                .name(name)
+                .department(department)
+                .studentNumber(studentNumber)
+                .phoneNumber(phoneNumber)
+                .studentFeeImageFile(studentFeeImageFile)
+                .build();
+    }
+}

src/main/java/ddingdong/ddingdongBE/domain/pairgame/controller/dto/response/PairGameApplierAmountResponse.java

@@ -0,0 +1,17 @@
+package ddingdong.ddingdongBE.domain.pairgame.controller.dto.response;
+
+import ddingdong.ddingdongBE.domain.pairgame.service.dto.query.PairGameApplierAmountQuery;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+
+@Builder
+public record PairGameApplierAmountResponse(
+        @Schema(description = "총 응모자 수", example = "200")
+        int amount
+) {
+   public static PairGameApplierAmountResponse from(PairGameApplierAmountQuery query) {
+       return PairGameApplierAmountResponse.builder()
+               .amount(query.amount())
+               .build();
+   }
+}

src/main/java/ddingdong/ddingdongBE/domain/pairgame/controller/dto/response/PairGameMetaDataResponse.java

@@ -0,0 +1,42 @@
+package ddingdong.ddingdongBE.domain.pairgame.controller.dto.response;
+
+import ddingdong.ddingdongBE.domain.pairgame.service.dto.query.PairGameMetaDataQuery.PairGameClubAndImageQuery;
+import ddingdong.ddingdongBE.domain.pairgame.service.dto.query.PairGameMetaDataQuery;
+import io.swagger.v3.oas.annotations.media.ArraySchema;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+
+import java.util.List;
+
+@Builder
+public record PairGameMetaDataResponse(
+        @ArraySchema(schema = @Schema(implementation = PairGameMetaDataResponse.PairGameClubAndImageResponse.class))
+        List<PairGameClubAndImageResponse> metaData
+) {
+    @Builder
+    public record PairGameClubAndImageResponse(
+            @Schema(description = "동아리 이름", example = "COW")
+            String clubName,
+            @Schema(description = "동아리 분과", example = "사회연구")
+            String category,
+            @Schema(description = "동아리 로고 이미지 CDN URL", example = "https://cdn.com")
+            String imageUrl
+    ) {
+        public static PairGameClubAndImageResponse from(PairGameClubAndImageQuery query) {
+            return PairGameClubAndImageResponse.builder()
+                    .clubName(query.clubName())
+                    .category(query.category())
+                    .imageUrl(query.imageUrl())
+                    .build();
+        }
+    }
+    public static PairGameMetaDataResponse from(PairGameMetaDataQuery query) {
+        List<PairGameClubAndImageResponse> responses = query.metaData().stream()
+                .map(PairGameClubAndImageResponse::from)
+                .toList();
+
+        return PairGameMetaDataResponse.builder()
+                .metaData(responses)
+                .build();
+    }
+}

src/main/java/ddingdong/ddingdongBE/domain/pairgame/entity/PairGameApplier.java

@@ -0,0 +1,52 @@
+package ddingdong.ddingdongBE.domain.pairgame.entity;
+
+import ddingdong.ddingdongBE.common.BaseEntity;
+import jakarta.persistence.*;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import org.hibernate.annotations.SQLDelete;
+import org.hibernate.annotations.SQLRestriction;
+
+import java.time.LocalDateTime;
+
+@Entity
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Getter
+@SQLDelete(sql = "update pair_game_applier set deleted_at = CURRENT_TIMESTAMP where id=?")
+@SQLRestriction("deleted_at IS NULL")
+public class PairGameApplier extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(nullable = false, length = 50)
+    private String name;
+
+    @Column(nullable = false, length = 50)
+    private String department;
+
+    @Column(unique = true, nullable = false, length = 50)
+    private String studentNumber;
+
+    @Column(nullable = false, length = 50)
+    private String phoneNumber;
+
+    @Column(nullable = false)
+    private String studentFeeImageUrl;
+
+    @Column(columnDefinition = "TIMESTAMP")
+    private LocalDateTime deletedAt;
+
+    @Builder
+    private PairGameApplier(String name, String department, String studentNumber, String phoneNumber, String studentFeeImageUrl) {
+        this.name = name;
+        this.department = department;
+        this.studentNumber = studentNumber;
+        this.phoneNumber = phoneNumber;
+        this.studentFeeImageUrl = studentFeeImageUrl;
+    }
+
+}

src/main/java/ddingdong/ddingdongBE/domain/pairgame/repository/PairGameRepository.java

@@ -0,0 +1,9 @@
+package ddingdong.ddingdongBE.domain.pairgame.repository;
+
+import ddingdong.ddingdongBE.domain.pairgame.entity.PairGameApplier;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+
+public interface PairGameRepository extends JpaRepository<PairGameApplier, Long> {
+    boolean existsByStudentNumber(String studentNumber);
+}