feat: 연차별 탭(TaskPeriod)에 파일 업로드 및 조회 기능 추가

src/main/java/com/bmilab/backend/domain/file/enums/FileDomainType.java

@@ -18,5 +18,6 @@ public enum FileDomainType {
     TASK_DRAFT_PRESENTATION,
     TASK_AGREEMENT_FINAL_PROPOSAL,
     TASK_AGREEMENT_FINAL_SUBMISSION,
+    TASK_PERIOD,
     TEMP
 }

src/main/java/com/bmilab/backend/domain/task/dto/request/TaskPeriodUpdateRequest.java

@@ -5,6 +5,7 @@
 
 import java.time.LocalDate;
 import java.util.List;
+import java.util.UUID;
 
 public record TaskPeriodUpdateRequest(
         @Schema(description = "시작일", example = "2025-03-01")
@@ -19,6 +20,9 @@ public record TaskPeriodUpdateRequest(
         Long managerId,
 
         @Schema(description = "과제 참여자 ID 목록")
-        List<Long> memberIds
+        List<Long> memberIds,
+
+        @Schema(description = "연차별 첨부파일 ID 목록")
+        List<UUID> fileIds
 ) {
 }

src/main/java/com/bmilab/backend/domain/task/dto/response/TaskPeriodResponse.java

@@ -1,5 +1,6 @@
 package com.bmilab.backend.domain.task.dto.response;
 
+import com.bmilab.backend.domain.file.dto.response.FileSummary;
 import com.bmilab.backend.domain.task.entity.TaskPeriod;
 import io.swagger.v3.oas.annotations.media.Schema;
 
@@ -27,7 +28,10 @@ public record TaskPeriodResponse(
         String managerName,
 
         @Schema(description = "과제 참여자 목록")
-        List<TaskMemberSummary> members
+        List<TaskMemberSummary> members,
+
+        @Schema(description = "연차별 첨부파일 목록")
+        List<FileSummary> files
 ) {
     public static TaskPeriodResponse from(TaskPeriod period) {
         List<TaskMemberSummary> members = period.getMembers().stream()
@@ -41,7 +45,25 @@ public static TaskPeriodResponse from(TaskPeriod period) {
                 period.getEndDate(),
                 period.getManager() != null ? period.getManager().getId() : null,
                 period.getManager() != null ? period.getManager().getName() : null,
-                members
+                members,
+                List.of()
+        );
+    }
+
+    public static TaskPeriodResponse from(TaskPeriod period, List<FileSummary> files) {
+        List<TaskMemberSummary> members = period.getMembers().stream()
+                .map(user -> new TaskMemberSummary(user.getId(), user.getName(), user.getEmail()))
+                .collect(Collectors.toList());
+
+        return new TaskPeriodResponse(
+                period.getId(),
+                period.getYearNumber(),
+                period.getStartDate(),
+                period.getEndDate(),
+                period.getManager() != null ? period.getManager().getId() : null,
+                period.getManager() != null ? period.getManager().getName() : null,
+                members,
+                files
         );
     }
 }

src/main/java/com/bmilab/backend/domain/task/service/TaskService.java

@@ -541,7 +541,12 @@ public TaskPeriodResponse getTaskPeriod(Long userId, Long taskId, Long periodId)
         TaskPeriod period = taskPeriodRepository.findById(periodId)
                 .orElseThrow(() -> new ApiException(TaskErrorCode.TASK_NOT_FOUND));
 
-        return TaskPeriodResponse.from(period);
+        List<FileSummary> files = fileService.findAllByDomainTypeAndEntityId(FileDomainType.TASK_PERIOD, periodId)
+                .stream()
+                .map(FileSummary::from)
+                .collect(Collectors.toList());
+
+        return TaskPeriodResponse.from(period, files);
     }
 
     @Transactional
@@ -565,6 +570,10 @@ public void updateTaskPeriod(Long userId, Long taskId, Long periodId, TaskPeriod
         period.update(manager, members, request.startDate(), request.endDate());
 
         taskPeriodRepository.save(period);
+
+        if (request.fileIds() != null) {
+            fileService.syncFiles(request.fileIds(), FileDomainType.TASK_PERIOD, periodId);
+        }
     }
 
     @Transactional