feat: 자격증 제출 API

Author: LeeHanEum

aics-api/src/main/java/kgu/developers/api/certificate/presentation/CertificateController.java

@@ -0,0 +1,38 @@
+package kgu.developers.api.certificate.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.certificate.presentation.request.CertificateSubmitRequest;
+import kgu.developers.api.certificate.presentation.response.CertificatePersistResponse;
+
+@Tag(name = "Certificate", description = "자격증 관련 API")
+public interface CertificateController {
+
+	@Operation(
+		summary = "자격증 파일 제출 API", description = """
+		    - Description : 이 API는 자격증 파일을 제출합니다.
+		    - Assignee : 이한음
+		"""
+	)
+	@ApiResponse(
+		responseCode = "201", content = @Content(schema = @Schema(implementation = CertificatePersistResponse.class))
+	)
+	ResponseEntity<CertificatePersistResponse> submitCertificateAndSaveFile(
+		@Parameter(
+			description = "자격증 첨부 파일",
+			content = @Content(mediaType = MULTIPART_FORM_DATA_VALUE),
+			required = true
+		) @RequestPart(value = "file") MultipartFile file,
+		@RequestPart CertificateSubmitRequest request
+	);
+}

aics-api/src/main/java/kgu/developers/api/certificate/presentation/CertificateControllerImpl.java

@@ -0,0 +1,36 @@
+package kgu.developers.api.certificate.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.certificate.presentation.request.CertificateSubmitRequest;
+import kgu.developers.api.certificate.presentation.response.CertificatePersistResponse;
+import kgu.developers.domain.certificate.application.command.CertificateCommandService;
+import lombok.RequiredArgsConstructor;
+
+@RestController
+@RequestMapping("/api/v1/certificate")
+@RequiredArgsConstructor
+public class CertificateControllerImpl implements CertificateController {
+	private final CertificateCommandService certificateCommandService;
+
+	@Override
+	@PostMapping(consumes = MULTIPART_FORM_DATA_VALUE)
+	public ResponseEntity<CertificatePersistResponse> submitCertificateAndSaveFile(
+		@RequestPart(value = "file") MultipartFile file,
+		@RequestPart CertificateSubmitRequest request
+	) {
+		Long id = certificateCommandService.submitCertificate(file, request.scheduleId());
+		return ResponseEntity.ok(
+			CertificatePersistResponse.of(id)
+		);
+	}
+
+
+}

aics-api/src/main/java/kgu/developers/api/certificate/presentation/request/CertificateSubmitRequest.java

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

aics-api/src/main/java/kgu/developers/api/certificate/presentation/response/CertificatePersistResponse.java

@@ -0,0 +1,16 @@
+package kgu.developers.api.certificate.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 CertificatePersistResponse(
+	@Schema(description = "자격증 객체 id", example = "1", requiredMode = REQUIRED)
+	Long id
+) {
+	public static CertificatePersistResponse of(Long id) {
+		return CertificatePersistResponse.builder().id(id).build();
+	}
+}

aics-domain/src/main/java/kgu/developers/domain/certificate/application/command/CertificateCommandService.java

@@ -0,0 +1,31 @@
+package kgu.developers.domain.certificate.application.command;
+
+import org.springframework.stereotype.Service;
+import org.springframework.web.multipart.MultipartFile;
+
+import kgu.developers.domain.certificate.domain.Certificate;
+import kgu.developers.domain.certificate.domain.CertificateRepository;
+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 lombok.RequiredArgsConstructor;
+
+@Service
+@RequiredArgsConstructor
+public class CertificateCommandService {
+	private final CertificateRepository certificateRepository;
+	private final FileStorageService fileStorageService;
+	private final FileCommandService fileCommandService;
+	private final ScheduleQueryService scheduleQueryService;
+
+	public Long submitCertificate(MultipartFile file, Long scheduleId) {
+		String storedPath = fileStorageService.store(file, FileDomain.CERTIFICATE);
+		Long fileId = fileCommandService.saveFile(file, storedPath).getId();
+		scheduleQueryService.checkExistsOrThrow(scheduleId);
+
+		Certificate certificate = Certificate.create(scheduleId, fileId);
+		return certificateRepository.save(certificate);
+	}
+
+}

aics-domain/src/main/java/kgu/developers/domain/certificate/domain/Certificate.java

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

aics-domain/src/main/java/kgu/developers/domain/certificate/domain/CertificateRepository.java

@@ -0,0 +1,5 @@
+package kgu.developers.domain.certificate.domain;
+
+public interface CertificateRepository {
+	Long save(Certificate certificate);
+}

aics-domain/src/main/java/kgu/developers/domain/certificate/infrastructure/entity/CertificateJpaEntity.java

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

aics-domain/src/main/java/kgu/developers/domain/certificate/infrastructure/repository/CertificateRepositoryImpl.java

@@ -0,0 +1,19 @@
+package kgu.developers.domain.certificate.infrastructure.repository;
+
+import org.springframework.stereotype.Repository;
+
+import kgu.developers.domain.certificate.domain.Certificate;
+import kgu.developers.domain.certificate.domain.CertificateRepository;
+import kgu.developers.domain.certificate.infrastructure.entity.CertificateJpaEntity;
+import lombok.RequiredArgsConstructor;
+
+@Repository
+@RequiredArgsConstructor
+public class CertificateRepositoryImpl implements CertificateRepository {
+	private final JpaCertificateRepository jpaCertificateRepository;
+
+	@Override
+	public Long save(Certificate certificate) {
+		return jpaCertificateRepository.save(CertificateJpaEntity.toEntity(certificate)).getId();
+	}
+}

aics-domain/src/main/java/kgu/developers/domain/certificate/infrastructure/repository/JpaCertificateRepository.java

@@ -0,0 +1,8 @@
+package kgu.developers.domain.certificate.infrastructure.repository;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import kgu.developers.domain.certificate.infrastructure.entity.CertificateJpaEntity;
+
+public interface JpaCertificateRepository extends JpaRepository<CertificateJpaEntity, Long> {
+}