[0.6.0] SW-128 예약 시간에 특별 미션을 모든 팀에게 배정할 수 있다.

src/main/java/com/github/kmu_shell_we/domain/mission/_season_mission/controller/AdminSeasonMissionController.java

@@ -32,6 +32,15 @@ public ApiResponse<MissionListResponse> getSeasonMissions(
         return ApiResponse.ok(adminSeasonMissionService.getSeasonMissions(season));
     }
 
+    @GetMapping("/special")
+    @Operation(summary = "특정 시즌 스페셜 미션 조회")
+    public ApiResponse<MissionListResponse> getSeasonSpecialMissions(
+            @Parameter(description = "시즌 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable Season season
+    ) {
+
+        return ApiResponse.ok(adminSeasonMissionService.getSeasonSpecialMissions(season));
+    }
+
     @PostMapping("/{mission}")
     @Operation(summary = "시즌 미션 생성")
     public ApiResponse<MissionResponse> createSeasonMission(

src/main/java/com/github/kmu_shell_we/domain/mission/_season_mission/exception/SeasonMissionExceptions.java

@@ -10,6 +10,7 @@ public enum SeasonMissionExceptions implements ApiExceptionCode {
 
     NOT_FOUND_SEASON_MISSION("SEASON_MISSION_001", "시즌 미션을 찾을 수 없습니다."),
     ALREADY_ADDED_SEASON_MISSION("SEASON_MISSION_002", "이미 추가된 시즌 미션입니다."),
+    INVALID_SEASON_MISSION("SEASON_MISSION_003", "현재 시즌의 미션이 아닙니다."),
     ;
 
     private final String code;

src/main/java/com/github/kmu_shell_we/domain/mission/_season_mission/service/AdminSeasonMissionService.java

@@ -3,6 +3,7 @@
 import com.github.kmu_shell_we.domain.mission._season_mission.entity.SeasonMission;
 import com.github.kmu_shell_we.domain.mission._season_mission.exception.SeasonMissionExceptions;
 import com.github.kmu_shell_we.domain.mission._season_mission.repository.SeasonMissionRepository;
+import com.github.kmu_shell_we.domain.mission.constant.MissionType;
 import com.github.kmu_shell_we.domain.mission.dto.response.MissionListResponse;
 import com.github.kmu_shell_we.domain.mission.dto.response.MissionResponse;
 import com.github.kmu_shell_we.domain.mission.entity.Mission;
@@ -23,6 +24,14 @@ public MissionListResponse getSeasonMissions(Season season) {
         return MissionListResponse.fromSeasonMission(seasonMissionRepository.findAllBySeason(season));
     }
 
+    @Transactional(readOnly = true)
+    public MissionListResponse getSeasonSpecialMissions(Season season){
+
+        return MissionListResponse.fromSeasonMission(
+                seasonMissionRepository.findAllBySeasonAndMissionType(season, MissionType.SPECIAL)
+        );
+    }
+
     @Transactional
     public MissionResponse createSeasonMission(Season season, Mission mission) {
 

src/main/java/com/github/kmu_shell_we/domain/mission/entity/Mission.java

@@ -7,6 +7,7 @@
 import jakarta.validation.constraints.NotNull;
 import lombok.*;
 
+import java.util.ArrayList;
 import java.util.List;
 
 @Entity
@@ -36,5 +37,6 @@ public class Mission extends BaseSchema {
 
     @OneToMany(mappedBy = "mission", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
     @Builder.Default
-    List<SeasonMission> seasonMissions = List.of();
+    @Setter(AccessLevel.NONE)
+    List<SeasonMission> seasonMissions = new ArrayList<>();
 }

src/main/java/com/github/kmu_shell_we/domain/mission/exception/MissionExceptions.java

@@ -9,6 +9,7 @@
 public enum MissionExceptions implements ApiExceptionCode {
 
     NOT_FOUND_MISSION("MISSION_001", "미션을 찾을 수 없습니다."),
+    INVALID_SPECIAL_MISSION_TYPE("MISSION_002", "SPECIAL 타입이 아닙니다."),
     ;
 
     private final String code;

src/main/java/com/github/kmu_shell_we/domain/season/_team/_item/controller/ItemController.java

@@ -5,13 +5,15 @@
 import com.github.kmu_shell_we.domain.season._team._item.service.ItemService;
 import com.github.kmu_shell_we.domain.season._team.entity.Team;
 import com.github.kmu_shell_we.domain.season.entity.Season;
+import com.github.kmu_shell_we.domain.user.entity.User;
 import com.github.kmu_shell_we.global.response.ApiResponse;
 import com.github.kmu_shell_we.global.security.guard.MemberGuard;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.Parameter;
 import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
 import org.springframework.web.bind.annotation.*;
 
 @MemberGuard
@@ -26,18 +28,20 @@ public class ItemController {
     @GetMapping
     @Operation(summary = "아이템 조회")
     public ApiResponse<ItemListResponse> getItems(
+            @AuthenticationPrincipal User user,
             @Parameter(description = "시즌 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable Season season,
             @Parameter(description = "팀 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable Team team
     ) {
-        return ApiResponse.ok(itemService.getItems(season, team));
+        return ApiResponse.ok(itemService.getItems(user, season, team));
     }
 
     @PostMapping("/draw")
     @Operation(summary = "아이템 뽑기")
     public ApiResponse<? extends ItemResponse> drawItem(
+            @AuthenticationPrincipal User user,
             @Parameter(description = "시즌 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable Season season,
             @Parameter(description = "팀 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable Team team
     ) {
-        return ApiResponse.ok(itemService.drawItem(season, team));
+        return ApiResponse.ok(itemService.drawItem(user, season, team));
     }
 }

src/main/java/com/github/kmu_shell_we/domain/season/_team/_item/exception/ItemExceptions.java

@@ -9,6 +9,7 @@
 public enum ItemExceptions implements ApiExceptionCode {
 
     FAILED_TO_DRAW("ITEM_001", "아이템을 뽑는데 실패했습니다."),
+    NOT_ENOUGH_POINT("ITEM_002", "포인트가 부족합니다."),
     ;
 
     private final String code;

src/main/java/com/github/kmu_shell_we/domain/season/_team/_item/service/ItemService.java

@@ -11,14 +11,17 @@
 import com.github.kmu_shell_we.domain.season._team._item.dto.response.detail.MissionChangeResponse;
 import com.github.kmu_shell_we.domain.season._team._item.dto.response.detail.ScoreDeductionResponse;
 import com.github.kmu_shell_we.domain.season._team._item.entity.Item;
+import com.github.kmu_shell_we.domain.season._team._item.exception.ItemExceptions;
 import com.github.kmu_shell_we.domain.season._team._item.repository.ItemRepository;
-import com.github.kmu_shell_we.domain.season._team._mission_team.entity.TeamMission;
-import com.github.kmu_shell_we.domain.season._team._mission_team.exceptions.TeamMissionExceptions;
-import com.github.kmu_shell_we.domain.season._team._mission_team.repository.TeamMissionRepository;
+import com.github.kmu_shell_we.domain.season._team._team_mission.entity.TeamMission;
+import com.github.kmu_shell_we.domain.season._team._team_mission.exceptions.TeamMissionExceptions;
+import com.github.kmu_shell_we.domain.season._team._team_mission.repository.TeamMissionRepository;
+import com.github.kmu_shell_we.domain.season._team._user_team.repository.UserTeamRepository;
 import com.github.kmu_shell_we.domain.season._team.entity.Team;
 import com.github.kmu_shell_we.domain.season._team.exception.TeamExceptions;
 import com.github.kmu_shell_we.domain.season._team.repository.TeamRepository;
 import com.github.kmu_shell_we.domain.season.entity.Season;
+import com.github.kmu_shell_we.domain.user.entity.User;
 import lombok.RequiredArgsConstructor;
 import org.springframework.security.access.prepost.PreAuthorize;
 import org.springframework.stereotype.Service;
@@ -31,20 +34,30 @@
 @RequiredArgsConstructor
 public class ItemService {
 
-    private final ItemRepository itemRepository;
     private final TeamRepository teamRepository;
+    private final UserTeamRepository userTeamRepository;
+    private final ItemRepository itemRepository;
     private final TeamMissionRepository teamMissionRepository;
     private final SeasonMissionRepository seasonMissionRepository;
 
     @Transactional(readOnly = true)
-    @PreAuthorize("#season.isCurrentSeason() and #season == #team.season")
-    public ItemListResponse getItems(Season season, Team team) {
+    @PreAuthorize("@itemService.canAccessItem(#user, #season, #team)")
+    public ItemListResponse getItems(User user, Season season, Team team) {
 
         return ItemListResponse.from(itemRepository.findAllByTeam(team));
     }
 
     @Transactional
-    public ItemResponse drawItem(Season season, Team team) {
+    @PreAuthorize("@itemService.canAccessItem(#user, #season, #team)")
+    public ItemResponse drawItem(User user, Season season, Team team) {
+
+        // 0. 포인트 조회 및 차감
+        if (team.getPoint() < 100) {
+
+            throw ItemExceptions.NOT_ENOUGH_POINT.toException();
+        }
+
+        team.setPoint(team.getPoint() - 100);
 
         // 1. 아이템 랜덤 뽑기
         ItemType itemType = drawRandomItem();
@@ -101,4 +114,11 @@ private ItemType drawRandomItem() {
 
         return ItemType.SCORE_DEDUCTION;
     }
+
+    public boolean canAccessItem(User user, Season season, Team team) {
+
+        return userTeamRepository.findByUserAndTeam(user, team).isPresent()
+                && season.isCurrentSeason()
+                && season.equals(team.getSeason());
+    }
 }

src/main/java/com/github/kmu_shell_we/domain/season/_team/_mission_team/dto/request/CreateSpecialTeamMissionRequest.java

@@ -0,0 +1,26 @@
+package com.github.kmu_shell_we.domain.season._team._mission_team.dto.request;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Data
+@Schema(description = "특별 팀 미션 생성 요청")
+public class CreateSpecialTeamMissionRequest {
+
+    @NotNull
+    @Schema(description = "시작 일시")
+    LocalDateTime startedAt;
+
+    @NotNull
+    @Schema(description = "종료 일시")
+    LocalDateTime endedAt;
+
+    @AssertTrue(message = "종료 일시는 시작 일시보다 이후여야 합니다.")
+    public boolean isValidTimeRange() {
+        return startedAt != null && endedAt != null && endedAt.isAfter(startedAt);
+    }
+}

src/main/java/com/github/kmu_shell_we/domain/season/_team/_schedule/controller/TeamScheduleController.java

@@ -9,6 +9,7 @@
 import com.github.kmu_shell_we.global.security.guard.MemberGuard;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.ArraySchema;
 import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
@@ -30,7 +31,7 @@ public class TeamScheduleController {
     public ApiResponse<TeamScheduleResponse> getTeamSchedule(
             @Parameter(description = "시즌 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable Season season,
             @Parameter(description = "팀 ID", schema = @Schema(type = "string", format = "uuid"))  @PathVariable Team team,
-            @RequestParam List<User> users
+            @Parameter(description = "유저 ID 목록", array = @ArraySchema(schema = @Schema(type = "string", format = "uuid"))) @RequestParam List<User> users
     ) {
 
         return ApiResponse.ok(scheduleService.getTeamSchedule(season, team, users));

src/main/java/com/github/kmu_shell_we/domain/season/_team/_mission_team/_submission_mission_team/controller/SubmissionController.java → src/main/java/com/github/kmu_shell_we/domain/season/_team/_team_mission/_submission/controller/SubmissionController.java

@@ -1,13 +1,14 @@
-package com.github.kmu_shell_we.domain.season._team._mission_team._submission_mission_team.controller;
+package com.github.kmu_shell_we.domain.season._team._team_mission._submission.controller;
 
 
-import com.github.kmu_shell_we.domain.mission.entity.Mission;
-import com.github.kmu_shell_we.domain.season._team._mission_team._submission_mission_team.dto.request.CreateSubmissionRequest;
-import com.github.kmu_shell_we.domain.season._team._mission_team._submission_mission_team.dto.response.SubmissionListResponse;
-import com.github.kmu_shell_we.domain.season._team._mission_team._submission_mission_team.dto.response.SubmissionResponse;
-import com.github.kmu_shell_we.domain.season._team._mission_team._submission_mission_team.service.SubmissionService;
+import com.github.kmu_shell_we.domain.season._team._team_mission._submission.dto.request.CreateSubmissionRequest;
+import com.github.kmu_shell_we.domain.season._team._team_mission._submission.dto.response.SubmissionListResponse;
+import com.github.kmu_shell_we.domain.season._team._team_mission._submission.dto.response.SubmissionResponse;
+import com.github.kmu_shell_we.domain.season._team._team_mission._submission.service.SubmissionService;
+import com.github.kmu_shell_we.domain.season._team._team_mission.entity.TeamMission;
 import com.github.kmu_shell_we.domain.season._team.entity.Team;
 import com.github.kmu_shell_we.domain.season.entity.Season;
+import com.github.kmu_shell_we.domain.user.entity.User;
 import com.github.kmu_shell_we.global.response.ApiResponse;
 import com.github.kmu_shell_we.global.security.guard.MemberGuard;
 import io.swagger.v3.oas.annotations.Operation;
@@ -16,6 +17,7 @@
 import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
 import org.springframework.web.bind.annotation.*;
 
 @MemberGuard
@@ -30,33 +32,36 @@ public class SubmissionController {
     @GetMapping("/submissions")
     @Operation(summary = "팀 미션 제출 목록 조회")
     public ApiResponse<SubmissionListResponse> getSubmissions(
+            @AuthenticationPrincipal User user,
             @Parameter(description = "시즌 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable Season season,
             @Parameter(description = "팀 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable Team team
     ) {
 
-        return ApiResponse.ok(submissionService.getSubmissions(season, team));
+        return ApiResponse.ok(submissionService.getSubmissions(user, season, team));
     }
 
-    @GetMapping("/missions/{mission}/submissions")
+    @GetMapping("/team_mission/{teamMission}/submissions")
     @Operation(summary = "팀 미션 제출 조회")
     public ApiResponse<SubmissionResponse> getSubmission(
+            @AuthenticationPrincipal User user,
             @Parameter(description = "시즌 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable Season season,
             @Parameter(description = "팀 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable Team team,
-            @Parameter(description = "미션 ID", schema = @Schema(type = "string", format = "uuid"))@PathVariable Mission mission
+            @Parameter(description = "팀 미션 ID", schema = @Schema(type = "string", format = "uuid"))@PathVariable TeamMission teamMission
     ) {
 
-        return ApiResponse.ok(submissionService.getSubmission(season, team, mission));
+        return ApiResponse.ok(submissionService.getSubmission(user, season, team, teamMission));
     }
 
-    @PostMapping("/missions/{mission}/submissions")
+    @PostMapping("/team_mission/{teamMission}/submissions")
     @Operation(summary = "팀 미션 제출")
     public ApiResponse<SubmissionResponse> submitMission(
+            @AuthenticationPrincipal User user,
             @Parameter(description = "시즌 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable Season season,
             @Parameter(description = "팀 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable Team team,
-            @Parameter(description = "미션 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable Mission mission,
+            @Parameter(description = "팀 미션 ID", schema = @Schema(type = "string", format = "uuid")) @PathVariable TeamMission teamMission,
             @RequestBody @Valid CreateSubmissionRequest request
     ) {
 
-        return ApiResponse.ok(submissionService.submitSubmission(season, team, mission, request));
+        return ApiResponse.ok(submissionService.submitSubmission(user, season, team, teamMission, request));
     }
 }

src/main/java/com/github/kmu_shell_we/domain/season/_team/_mission_team/_submission_mission_team/dto/request/CreateSubmissionRequest.java → src/main/java/com/github/kmu_shell_we/domain/season/_team/_team_mission/_submission/dto/request/CreateSubmissionRequest.java

@@ -1,4 +1,4 @@
-package com.github.kmu_shell_we.domain.season._team._mission_team._submission_mission_team.dto.request;
+package com.github.kmu_shell_we.domain.season._team._team_mission._submission.dto.request;
 
 import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.NotNull;