feat: 졸업 논문 제출 API

Author: LeeHanEum

aics-api/src/main/java/kgu/developers/api/thesis/presentation/ThesisController.java

@@ -0,0 +1,37 @@
+package kgu.developers.api.thesis.presentation;
+
+import static org.springframework.http.MediaType.MULTIPART_FORM_DATA_VALUE;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.RequestPart;
+import org.springframework.web.multipart.MultipartFile;
+
+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.tags.Tag;
+import kgu.developers.api.thesis.presentation.request.ThesisSubmitRequest;
+import kgu.developers.api.thesis.presentation.response.ThesisPersistResponse;
+
+@Tag(name = "Thesis", description = "졸업 논문 API")
+public interface ThesisController {
+
+	@Operation(
+		summary = "졸업 논문 파일 제출 API", description = """
+		    - Description : 이 API는 졸업 논문 파일을 제출합니다.
+		    - Assignee : 이한음
+		""")
+	@ApiResponse(
+		responseCode = "201",
+		content = @Content(schema = @Schema(implementation = ThesisPersistResponse.class)))
+	ResponseEntity<ThesisPersistResponse> submitThesisAndSaveFile(
+		@Parameter(
+			description = "졸업 논문 첨부 파일",
+			content = @Content(mediaType = MULTIPART_FORM_DATA_VALUE),
+			required = true
+		) @RequestPart(value = "file") MultipartFile file,
+		@RequestPart ThesisSubmitRequest request
+		);
+}

aics-api/src/main/java/kgu/developers/api/thesis/presentation/ThesisControllerImpl.java

@@ -0,0 +1,34 @@
+package kgu.developers.api.thesis.presentation;
+
+import static org.springframework.http.MediaType.MULTIPART_FORM_DATA_VALUE;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestPart;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+import kgu.developers.api.thesis.presentation.request.ThesisSubmitRequest;
+import kgu.developers.api.thesis.presentation.response.ThesisPersistResponse;
+import kgu.developers.domain.thesis.application.command.ThesisCommandService;
+import lombok.RequiredArgsConstructor;
+
+@RestController
+@RequestMapping("/api/v1/thesis")
+@RequiredArgsConstructor
+public class ThesisControllerImpl implements ThesisController {
+	private final ThesisCommandService thesisCommandService;
+
+	@Override
+	@PostMapping(consumes = MULTIPART_FORM_DATA_VALUE)
+	public ResponseEntity<ThesisPersistResponse> submitThesisAndSaveFile(
+		@RequestPart(value = "file") MultipartFile file,
+		@RequestPart ThesisSubmitRequest request
+	) {
+		Long id = thesisCommandService.submitThesis(file, request.scheduleId());
+		return ResponseEntity.ok(
+			ThesisPersistResponse.of(id)
+		);
+	}
+}

aics-api/src/main/java/kgu/developers/api/thesis/presentation/request/ThesisSubmitRequest.java

@@ -0,0 +1,6 @@
+package kgu.developers.api.thesis.presentation.request;
+
+public record ThesisSubmitRequest(
+	Long scheduleId
+) {
+}

aics-api/src/main/java/kgu/developers/api/thesis/presentation/response/ThesisPersistResponse.java

@@ -0,0 +1,16 @@
+package kgu.developers.api.thesis.presentation.response;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+
+@Builder
+public record ThesisPersistResponse(
+	@Schema(description = "졸업 논문 객체 id", example = "1", requiredMode = REQUIRED)
+	Long id
+) {
+	public static ThesisPersistResponse of(Long id) {
+		return ThesisPersistResponse.builder().id(id).build();
+	}
+}

aics-common/src/main/java/kgu/developers/common/config/SecurityConfig.java

@@ -82,6 +82,7 @@ public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
 		"/api/v1/labs",
 		"/api/v1/comments",
 		"/api/v1/carousels",
+		"/api/v1/thesis",
 	};
 
 	CorsConfigurationSource corsConfigurationSource() {

aics-domain/src/main/java/kgu/developers/domain/file/domain/FileDomain.java

@@ -11,6 +11,7 @@ public enum FileDomain {
 	POST("게시글"),
 	LAB("연구실"),
 	CLUB("동아리"),
+	THESIS("논문")
 	;
 
 	private final String description;

aics-domain/src/main/java/kgu/developers/domain/thesis/application/command/ThesisCommandService.java

@@ -0,0 +1,31 @@
+package kgu.developers.domain.thesis.application.command;
+
+import org.springframework.stereotype.Service;
+import org.springframework.web.multipart.MultipartFile;
+
+import kgu.developers.domain.file.application.command.FileCommandService;
+import kgu.developers.domain.file.domain.FileDomain;
+import kgu.developers.domain.file.infrastructure.repository.FileStorageService;
+import kgu.developers.domain.schedule.application.query.ScheduleQueryService;
+import kgu.developers.domain.thesis.domain.Thesis;
+import kgu.developers.domain.thesis.domain.ThesisRepository;
+import lombok.RequiredArgsConstructor;
+
+@Service
+@RequiredArgsConstructor
+public class ThesisCommandService {
+	private final ThesisRepository thesisRepository;
+	private final FileStorageService fileStorageService;
+	private final FileCommandService fileCommandService;
+	private final ScheduleQueryService scheduleQueryService;
+
+	public Long submitThesis(MultipartFile file, Long scheduleId) {
+		String storedPath = fileStorageService.store(file, FileDomain.THESIS);
+		Long fileId = fileCommandService.saveFile(file, storedPath).getId();
+		scheduleQueryService.checkExistsOrThrow(scheduleId);
+
+		Thesis thesis = Thesis.create(scheduleId, fileId);
+		return thesisRepository.save(thesis);
+	}
+
+}

aics-domain/src/main/java/kgu/developers/domain/thesis/domain/Thesis.java

@@ -3,11 +3,15 @@
 import java.time.LocalDateTime;
 
 import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
 @Getter
+@Builder
 @NoArgsConstructor(access = AccessLevel.PRIVATE)
+@AllArgsConstructor(access = AccessLevel.PRIVATE)
 public class Thesis {
 	private Long id;
 	private Long scheduleId;
@@ -17,6 +21,14 @@ public class Thesis {
 	private LocalDateTime updatedAt;
 	private LocalDateTime deletedAt;
 
+	public static Thesis create(Long scheduleId, Long thesisFileId) {
+		return Thesis.builder()
+			.scheduleId(scheduleId)
+			.thesisFileId(thesisFileId)
+			.approval(false)
+			.build();
+	}
+
 	public static Thesis of(
 		Long id,
 		Long scheduleId,

aics-domain/src/main/java/kgu/developers/domain/thesis/domain/ThesisRepository.java

@@ -0,0 +1,5 @@
+package kgu.developers.domain.thesis.domain;
+
+public interface ThesisRepository {
+	Long save(Thesis thesis);
+}

aics-domain/src/main/java/kgu/developers/domain/thesis/infrastructure/entity/ThesisJpaEntity.java

@@ -14,8 +14,10 @@
 import kgu.developers.domain.thesis.domain.Thesis;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
+import lombok.Getter;
 import lombok.NoArgsConstructor;
 
+@Getter
 @Builder
 @Entity
 @Table(