Feature/#47 대회 팀 상세보기 템플릿 기능 개발

src/main/java/com/opus/opus/docs/asciidoc/contest.adoc

@@ -490,3 +490,58 @@ include::{snippets}/get-vote-statistics-fail-not-found/http-request.adoc[]
 include::{snippets}/get-vote-statistics-fail-not-found/http-response.adoc[]
 
 ====
+
+== 대회 팀 템플릿 설정 관리
+
+=== `GET`: 대회의 템플릿 조회
+
+.Path Parameters
+include::{snippets}/get-contest-template/path-parameters.adoc[]
+
+.HTTP Request
+include::{snippets}/get-contest-template/http-request.adoc[]
+
+.HTTP Response
+include::{snippets}/get-contest-template/http-response.adoc[]
+
+.Response Fields
+include::{snippets}/get-contest-template/response-fields.adoc[]
+
+==== ⚠️ 실패 케이스
+
+.❌ Case 1: 존재하지 않는 대회
+
+[%collapsible]
+====
+include::{snippets}/get-contest-template-fail-not-found/path-parameters.adoc[]
+include::{snippets}/get-contest-template-fail-not-found/http-request.adoc[]
+include::{snippets}/get-contest-template-fail-not-found/http-response.adoc[]
+====
+
+=== `PUT`: 대회의 템플릿 수정
+
+.Path Parameters
+include::{snippets}/update-contest-template/path-parameters.adoc[]
+
+.Request Headers
+include::{snippets}/update-contest-template/request-headers.adoc[]
+
+.Request Fields
+include::{snippets}/update-contest-template/request-fields.adoc[]
+
+.HTTP Request
+include::{snippets}/update-contest-template/http-request.adoc[]
+
+.HTTP Response
+include::{snippets}/update-contest-template/http-response.adoc[]
+
+==== ⚠️ 실패 케이스
+
+.❌ Case 1: 존재하지 않는 대회
+
+[%collapsible]
+====
+include::{snippets}/update-contest-template-fail-not-found/path-parameters.adoc[]
+include::{snippets}/update-contest-template-fail-not-found/http-request.adoc[]
+include::{snippets}/update-contest-template-fail-not-found/http-response.adoc[]
+====

src/main/java/com/opus/opus/modules/contest/api/ContestController.java

@@ -7,21 +7,23 @@
 import com.opus.opus.modules.contest.application.dto.request.ContestRequest;
 import com.opus.opus.modules.contest.application.dto.request.ContestSortCustomRequest;
 import com.opus.opus.modules.contest.application.dto.request.ContestSortRequest;
+import com.opus.opus.modules.contest.application.dto.request.ContestTemplateRequest;
 import com.opus.opus.modules.contest.application.dto.request.ContestVotesLimitRequest;
 import com.opus.opus.modules.contest.application.dto.request.VoteUpdateRequest;
 import com.opus.opus.modules.contest.application.dto.response.ContestCurrentResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestCurrentToggleResponse;
+import com.opus.opus.modules.contest.application.dto.response.ContestRankingResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestSortResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestVoteLogResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestSubmissionResponse;
+import com.opus.opus.modules.contest.application.dto.response.ContestTemplateResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestVoteStatisticsResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestVotesLimitResponse;
 import com.opus.opus.modules.contest.application.dto.response.VotePeriodResponse;
 import com.opus.opus.modules.member.domain.Member;
 import com.opus.opus.modules.team.application.dto.ImageResponse;
 import com.opus.opus.modules.team.application.dto.response.MemberVoteCountResponse;
-import com.opus.opus.modules.contest.application.dto.response.ContestRankingResponse;
 import jakarta.validation.Valid;
 import jakarta.validation.constraints.PositiveOrZero;
 import java.util.List;
@@ -84,8 +86,8 @@ public ResponseEntity<List<ContestResponse>> getAllContests() {
         return ResponseEntity.ok(responses);
     }
 
-    @PostMapping
     @Secured("ROLE_관리자")
+    @PostMapping
     public ResponseEntity<ContestResponse> createContest(@Valid @RequestBody final ContestRequest request) {
         ContestResponse response = contestCommandService.createContest(request);
         return ResponseEntity.ok(response);
@@ -205,4 +207,19 @@ public ResponseEntity<List<ContestSubmissionResponse>> getTeamSubmissions(@PathV
         final List<ContestSubmissionResponse> responses = contestQueryService.getTeamSubmissions(contestId);
         return ResponseEntity.ok(responses);
     }
+
+    @GetMapping("/{contestId}/template")
+    public ResponseEntity<ContestTemplateResponse> getContestTemplate(@PathVariable final Long contestId) {
+        final ContestTemplateResponse response = contestQueryService.getContestTemplate(contestId);
+        return ResponseEntity.ok(response);
+    }
+
+
+    @Secured("ROLE_관리자")
+    @PutMapping("/{contestId}/template")
+    public ResponseEntity<Void> updateContestTemplate(@PathVariable final Long contestId,
+                                                      @Valid @RequestBody final ContestTemplateRequest request) {
+        contestCommandService.updateContestTemplate(contestId, request);
+        return ResponseEntity.noContent().build();
+    }
 }

src/main/java/com/opus/opus/modules/contest/application/ContestCommandService.java

@@ -23,26 +23,30 @@
 import com.opus.opus.modules.contest.application.convenience.ContestCategoryConvenience;
 import com.opus.opus.modules.contest.application.convenience.ContestConvenience;
 import com.opus.opus.modules.contest.application.convenience.ContestSortConvenience;
+import com.opus.opus.modules.contest.application.convenience.ContestTemplateConvenience;
 import com.opus.opus.modules.contest.application.dto.request.ContestRequest;
 import com.opus.opus.modules.contest.application.dto.request.ContestSortCustomRequest;
 import com.opus.opus.modules.contest.application.dto.request.ContestSortRequest;
+import com.opus.opus.modules.contest.application.dto.request.ContestTemplateRequest;
 import com.opus.opus.modules.contest.application.dto.request.VoteUpdateRequest;
 import com.opus.opus.modules.contest.application.dto.response.ContestCurrentToggleResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestResponse;
 import com.opus.opus.modules.contest.domain.Contest;
 import com.opus.opus.modules.contest.domain.ContestCategory;
 import com.opus.opus.modules.contest.domain.ContestSort;
+import com.opus.opus.modules.contest.domain.ContestTemplate;
 import com.opus.opus.modules.contest.domain.dao.ContestRepository;
 import com.opus.opus.modules.contest.domain.dao.ContestSortRepository;
+import com.opus.opus.modules.contest.domain.dao.ContestTemplateRepository;
 import com.opus.opus.modules.contest.exception.ContestException;
 import com.opus.opus.modules.file.domain.File;
 import com.opus.opus.modules.file.domain.dao.FileRepository;
 import com.opus.opus.modules.file.exception.FileException;
 import com.opus.opus.modules.team.application.convenience.TeamConvenience;
-import java.util.Optional;
 import com.opus.opus.modules.team.domain.Team;
 import java.util.List;
 import java.util.Map;
+import java.util.Optional;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
@@ -58,19 +62,21 @@ public class ContestCommandService {
     private final ContestRepository contestRepository;
     private final ContestSortRepository contestSortRepository;
     private final FileRepository fileRepository;
+    private final ContestTemplateRepository contestTemplateRepository;
 
     private final ContestConvenience contestConvenience;
     private final ContestCategoryConvenience contestCategoryConvenience;
     private final ContestSortConvenience contestSortConvenience;
     private final TeamConvenience teamConvenience;
+    private final ContestTemplateConvenience contestTemplateConvenience;
 
     private final FileStorageUtil fileStorageUtil;
 
-
     public void saveBannerImage(final Long contestId, final MultipartFile image) {
         contestConvenience.getValidateExistContest(contestId);
 
-        final Optional<File> existingFile = fileRepository.findByReferenceIdAndReferenceTypeAndImageType(contestId, CONTEST, BANNER);
+        final Optional<File> existingFile = fileRepository.findByReferenceIdAndReferenceTypeAndImageType(contestId,
+                CONTEST, BANNER);
         existingFile.ifPresent(this::checkWebpConverted);
 
         fileStorageUtil.storeFile(image, contestId, CONTEST, BANNER);
@@ -99,6 +105,9 @@ public ContestResponse createContest(final ContestRequest request) {
                 .contest(contest)
                 .build());
 
+        // 템플릿 자동 생성
+        createTemplate(contest, contestCategory.getCategoryName());
+
         return ContestResponse.from(contest, contestCategory.getCategoryName());
     }
 
@@ -242,4 +251,61 @@ private void applyCustomSortToTeams(final List<ContestSortCustomRequest> request
             team.updateItemOrder(r.itemOrder());
         }
     }
+
+    public void createTemplate(final Contest contest, final String categoryName) {
+        final ContestTemplateRequest request = getDefaultTemplateRequest(categoryName);
+
+        final ContestTemplate template = ContestTemplate.builder()
+                .contest(contest)
+                .request(request)
+                .build();
+
+        contestTemplateRepository.save(template);
+    }
+
+    public void updateContestTemplate(final Long contestId, final ContestTemplateRequest request) {
+        contestConvenience.validateExistContest(contestId);
+        final ContestTemplate template = contestTemplateConvenience.getValidateExistTemplate(contestId);
+        template.updateTemplate(request);
+    }
+
+    private ContestTemplateRequest getDefaultTemplateRequest(final String categoryName) {
+        if (categoryName != null && categoryName.contains("창의융합")) {
+            return new ContestTemplateRequest(
+                    true,
+                    true,
+                    true,
+                    true,
+                    true,
+                    false,
+                    true,
+                    false,
+                    false,
+                    true,
+                    true,
+                    true
+            );
+        }
+
+        if (categoryName != null && categoryName.contains("캡스톤")) {
+            return new ContestTemplateRequest(
+                    true,
+                    true,
+                    true,
+                    true,
+                    true,
+                    true,
+                    true,
+                    true,
+                    false,
+                    true,
+                    false,
+                    true
+            );
+        }
+
+        return new ContestTemplateRequest(
+                false, false, false, false, false, false, false, false, false, false, false, false
+        );
+    }
 }

src/main/java/com/opus/opus/modules/contest/application/ContestQueryService.java

@@ -10,18 +10,21 @@
 import com.opus.opus.modules.contest.application.convenience.ContestCategoryConvenience;
 import com.opus.opus.modules.contest.application.convenience.ContestConvenience;
 import com.opus.opus.modules.contest.application.convenience.ContestSortConvenience;
+import com.opus.opus.modules.contest.application.convenience.ContestTemplateConvenience;
 import com.opus.opus.modules.contest.application.dto.response.ContestCurrentResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestRankingResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestSortResponse;
-import com.opus.opus.modules.contest.application.dto.response.ContestVoteLogResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestSubmissionResponse;
+import com.opus.opus.modules.contest.application.dto.response.ContestTemplateResponse;
+import com.opus.opus.modules.contest.application.dto.response.ContestVoteLogResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestVoteStatisticsResponse;
-import com.opus.opus.modules.contest.application.dto.response.VotePeriodResponse;
 import com.opus.opus.modules.contest.application.dto.response.ContestVotesLimitResponse;
+import com.opus.opus.modules.contest.application.dto.response.VotePeriodResponse;
 import com.opus.opus.modules.contest.domain.Contest;
 import com.opus.opus.modules.contest.domain.ContestCategory;
 import com.opus.opus.modules.contest.domain.ContestSort;
+import com.opus.opus.modules.contest.domain.ContestTemplate;
 import com.opus.opus.modules.contest.domain.ContestTrack;
 import com.opus.opus.modules.contest.domain.dao.ContestRepository;
 import com.opus.opus.modules.contest.domain.dao.ContestTrackRepository;
@@ -33,19 +36,17 @@
 import com.opus.opus.modules.team.application.convenience.TeamConvenience;
 import com.opus.opus.modules.team.application.convenience.TeamVoteConvenience;
 import com.opus.opus.modules.team.application.dto.ImageResponse;
+import com.opus.opus.modules.team.application.dto.response.MemberVoteCountResponse;
 import com.opus.opus.modules.team.domain.Team;
 import com.opus.opus.modules.team.domain.TeamVote;
-import java.util.List;
-import java.util.Map;
-import com.opus.opus.modules.team.application.dto.response.MemberVoteCountResponse;
 import com.opus.opus.modules.team.domain.dao.TeamRankingResult;
 import com.opus.opus.modules.team.domain.dao.TeamRepository;
 import com.opus.opus.modules.team.domain.dao.TeamVoteRepository;
 import com.opus.opus.modules.team.domain.dao.VoteStatisticsResult;
 import java.util.ArrayList;
-
+import java.util.List;
+import java.util.Map;
 import java.util.stream.Collectors;
-
 import lombok.RequiredArgsConstructor;
 import org.antlr.v4.runtime.misc.Pair;
 import org.springframework.core.io.Resource;
@@ -71,11 +72,31 @@ public class ContestQueryService {
     private final ContestCategoryConvenience contestCategoryConvenience;
     private final ContestConvenience contestConvenience;
     private final ContestSortConvenience contestSortConvenience;
+    private final ContestTemplateConvenience contestTemplateConvenience;
     private final TeamConvenience teamConvenience;
     private final TeamVoteConvenience teamVoteConvenience;
     private final MemberConvenience memberConvenience;
     private final FileConvenience fileConvenience;
 
+    private static List<ContestRankingResponse> applyDenseRanking(List<TeamRankingResult> votesPerTeam) {
+        List<ContestRankingResponse> responseList = new ArrayList<>();
+        int curRank = 0;     // 현재 순위
+        long prevCount = -1; // 이전 팀 투표 수
+        for (TeamRankingResult result : votesPerTeam) {
+            // 이전 팀과 투표 수가 다르면 순위 증가, 같으면 순위 유지
+            if (prevCount != result.voteCount()) {
+                curRank++;
+            }
+            prevCount = result.voteCount();
+
+            responseList.add(
+                    new ContestRankingResponse(curRank, result.teamId(), result.teamName(), result.projectName(),
+                            result.trackName(), result.voteCount()));
+        }
+
+        return responseList;
+    }
+
     public ImageResponse getContestBanner(final Long contestId) {
         contestConvenience.getValidateExistContest(contestId);
         final File findBanner = fileConvenience.findByReferenceIdAndReferenceTypeAndImageType(contestId, CONTEST,
@@ -200,25 +221,16 @@ public List<ContestSubmissionResponse> getTeamSubmissions(Long contestId) {
                 .toList();
     }
 
-    private static List<ContestRankingResponse> applyDenseRanking(List<TeamRankingResult> votesPerTeam) {
-        List<ContestRankingResponse> responseList = new ArrayList<>();
-        int curRank = 0;     // 현재 순위
-        long prevCount = -1; // 이전 팀 투표 수
-        for (TeamRankingResult result : votesPerTeam) {
-            // 이전 팀과 투표 수가 다르면 순위 증가, 같으면 순위 유지
-            if (prevCount != result.voteCount()) curRank++;
-            prevCount = result.voteCount();
-
-            responseList.add(new ContestRankingResponse(curRank, result.teamId(), result.teamName(), result.projectName(), result.trackName(), result.voteCount()));
-        }
-
-        return responseList;
-    }
-
     private void checkImageConverted(final File findFile) {
         if (!findFile.getIsWebpConverted()) {
             throw new FileException(NOT_WEBP_CONVERTED);
         }
     }
 
+
+    public ContestTemplateResponse getContestTemplate(final Long contestId) {
+        contestConvenience.getValidateExistContest(contestId);
+        final ContestTemplate template = contestTemplateConvenience.getValidateExistTemplate(contestId);
+        return ContestTemplateResponse.from(template);
+    }
 }

src/main/java/com/opus/opus/modules/contest/application/convenience/ContestConvenience.java

@@ -1,12 +1,12 @@
 package com.opus.opus.modules.contest.application.convenience;
 
 
-import static com.opus.opus.modules.contest.exception.ContestExceptionType.NOT_ALLOWED_DURING_VOTING_PERIOD;
 import static com.opus.opus.modules.contest.exception.ContestExceptionType.CATEGORY_HAS_CONTEST;
 import static com.opus.opus.modules.contest.exception.ContestExceptionType.CONTEST_NAME_ALREADY_EXIST;
+import static com.opus.opus.modules.contest.exception.ContestExceptionType.NOT_ALLOWED_DURING_VOTING_PERIOD;
 import static com.opus.opus.modules.contest.exception.ContestExceptionType.NOT_FOUND_CONTEST;
-import static org.springframework.transaction.annotation.Propagation.MANDATORY;
 import static com.opus.opus.modules.contest.exception.ContestExceptionType.NOT_VOTE_PERIOD_NOW;
+import static org.springframework.transaction.annotation.Propagation.MANDATORY;
 
 import com.opus.opus.modules.contest.domain.Contest;
 import com.opus.opus.modules.contest.domain.dao.ContestRepository;
@@ -50,7 +50,7 @@ public long countCurrentContests() {
     public List<Contest> getCurrentContests() {
         return contestRepository.findAllByIsCurrentTrue();
     }
-    
+
     @Transactional(propagation = MANDATORY)
     public Contest getValidateExistContestForUpdate(final Long contestId) {
         return contestRepository.findByIdForUpdate(contestId)