✨ [STMT-62] 스터디 생성 기능 구현

src/docs/asciidoc/index.adoc

@@ -225,6 +225,34 @@ include::{snippets}/get-study-detail/fail/not-found/response-body.adoc[]
 include::{snippets}/get-study-detail/fail/not-found/response-fields.adoc[]
 
 
+=== 스터디 생성
+
+스터디를 생성하는 API 입니다.
+
+==== POST /api/v1/studies
+
+===== 요청
+include::{snippets}/create-study/success/http-request.adoc[]
+include::{snippets}/create-study/success/request-headers.adoc[]
+
+===== 응답 성공 (200)
+
+include::{snippets}/create-study/success/response-body.adoc[]
+include::{snippets}/create-study/success/response-fields.adoc[]
+
+===== 응답 실패 (404)
+
+.존재하지 않는 스터디 분야 ID를 요청한 경우
+
+include::{snippets}/create-study/fail/study-field-not-found/response-body.adoc[]
+include::{snippets}/create-study/fail/study-field-not-found/response-fields.adoc[]
+
+.일정 반복 유형 DAILY일 때를 제외하고 반복일을 null 값으로 요청한 경우
+
+include::{snippets}/create-study/fail/invalid-study-meeting-schedule/response-body.adoc[]
+include::{snippets}/create-study/fail/invalid-study-meeting-schedule/response-fields.adoc[]
+
+
 == 스터디 멤버 관리
 
 === 스터디 멤버 조회

src/main/java/com/stumeet/server/common/exception/model/BadRequestException.java

@@ -0,0 +1,13 @@
+package com.stumeet.server.common.exception.model;
+
+import com.stumeet.server.common.response.ErrorCode;
+
+public class BadRequestException extends BusinessException{
+	public BadRequestException(ErrorCode errorCode) {
+		super(errorCode);
+	}
+
+	public BadRequestException(String message, ErrorCode errorCode) {
+		super(message, errorCode);
+	}
+}

src/main/java/com/stumeet/server/common/exception/model/InvalidFileException.java → src/main/java/com/stumeet/server/common/exception/model/InvalidResourceException.java

@@ -2,8 +2,8 @@
 
 import com.stumeet.server.common.response.ErrorCode;
 
-public class InvalidFileException extends BusinessException {
-	public InvalidFileException(ErrorCode errorCode) {
+public class InvalidResourceException extends BusinessException {
+	public InvalidResourceException(ErrorCode errorCode) {
 		super(errorCode);
 	}
 }

src/main/java/com/stumeet/server/common/response/ErrorCode.java

@@ -47,6 +47,7 @@ public enum ErrorCode {
     */
     STUDY_NOT_FOUND(HttpStatus.NOT_FOUND, "존재하지 않는 스터디 입니다."),
     MEMBER_NOT_FOUND(HttpStatus.NOT_FOUND, "존재하지 않는 멤버 입니다."),
+    STUDY_FIELD_NOT_FOUND(HttpStatus.NOT_FOUND, "존재하지 않는 스터디 분야 입니다."),
 
     /*
         500 - INTERNAL SERVER ERROR

src/main/java/com/stumeet/server/common/util/FileValidator.java

@@ -2,9 +2,9 @@
 
 import org.springframework.web.multipart.MultipartFile;
 
-import com.stumeet.server.common.exception.model.InvalidFileException;
 import com.stumeet.server.common.response.ErrorCode;
 import com.stumeet.server.file.domain.ImageContentType;
+import com.stumeet.server.file.domain.exception.InvalidFileException;
 
 import lombok.AccessLevel;
 import lombok.NoArgsConstructor;

src/main/java/com/stumeet/server/file/application/port/in/FileUploadUseCase.java

@@ -9,5 +9,7 @@ public interface FileUploadUseCase {
 
 	FileUrl uploadUserProfileImage(Long userId, MultipartFile multipartFile);
 
+	FileUrl uploadStudyMainImage(MultipartFile multipartFile);
+
 	List<FileUrl> uploadStudyActivityImage(Long studyId, List<MultipartFile> multipartFile);
 }

src/main/java/com/stumeet/server/file/application/service/FileUploadService.java

@@ -16,6 +16,7 @@
 public class FileUploadService implements FileUploadUseCase {
 
 	private static final String USER_PROFILE_IMAGE_DIRECTORY_PATH = "user/%d/profile";
+	private static final String STUDY_MAIN_IMAGE_DIRECTORY_PATH = "study/main";
 	private static final String STUDY_ACTIVITY_IMAGE_DIRECTORY_PATH = "study/%d/activity";
 
 	private final FileCommandPort fileCommandPort;
@@ -27,6 +28,11 @@ public FileUrl uploadUserProfileImage(Long userId, MultipartFile multipartFile)
 		return fileCommandPort.uploadImageFile(multipartFile, path);
 	}
 
+	@Override
+	public FileUrl uploadStudyMainImage(MultipartFile multipartFile) {
+		return fileCommandPort.uploadImageFile(multipartFile, STUDY_MAIN_IMAGE_DIRECTORY_PATH);
+	}
+
 	@Override
 	public List<FileUrl> uploadStudyActivityImage(Long studyId, List<MultipartFile> multipartFiles) {
 		String path = String.format(STUDY_ACTIVITY_IMAGE_DIRECTORY_PATH, studyId);

src/main/java/com/stumeet/server/file/domain/exception/InvalidFileException.java

@@ -0,0 +1,10 @@
+package com.stumeet.server.file.domain.exception;
+
+import com.stumeet.server.common.exception.model.InvalidResourceException;
+import com.stumeet.server.common.response.ErrorCode;
+
+public class InvalidFileException extends InvalidResourceException {
+	public InvalidFileException(ErrorCode errorCode) {
+		super(errorCode);
+	}
+}

src/main/java/com/stumeet/server/study/adapter/in/web/StudyCreateApi.java

@@ -0,0 +1,40 @@
+package com.stumeet.server.study.adapter.in.web;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+
+import com.stumeet.server.common.annotation.WebAdapter;
+import com.stumeet.server.common.auth.model.LoginMember;
+import com.stumeet.server.common.model.ApiResponse;
+import com.stumeet.server.study.application.port.in.StudyCreateUseCase;
+import com.stumeet.server.study.application.port.in.StudyQueryUseCase;
+import com.stumeet.server.study.application.port.in.command.StudyCreateCommand;
+import com.stumeet.server.study.application.port.in.response.StudyDetailResponse;
+
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+
+@WebAdapter
+@RequestMapping("/api/v1/studies")
+@RequiredArgsConstructor
+public class StudyCreateApi {
+
+	private final StudyCreateUseCase studyCreateUseCase;
+	private final StudyQueryUseCase studyQueryUseCase;
+
+	@PostMapping(consumes = "multipart/form-data", produces = "application/json")
+	public ResponseEntity<ApiResponse<StudyDetailResponse>> create(
+			@AuthenticationPrincipal LoginMember member,
+			@Valid StudyCreateCommand request
+	) {
+		Long createdStudyId = studyCreateUseCase.create(request, member.getMember());
+		StudyDetailResponse response = studyQueryUseCase.getStudyDetailById(createdStudyId);
+
+		return new ResponseEntity<>(
+				ApiResponse.success(HttpStatus.CREATED.value(), "스터디 그룹 생성에 성공했습니다.", response),
+				HttpStatus.CREATED);
+	}
+}

src/main/java/com/stumeet/server/study/adapter/in/web/StudyQueryApi.java

@@ -8,7 +8,7 @@
 import com.stumeet.server.common.annotation.WebAdapter;
 import com.stumeet.server.common.model.ApiResponse;
 import com.stumeet.server.common.response.SuccessCode;
-import com.stumeet.server.study.adapter.in.web.response.StudyDetailResponse;
+import com.stumeet.server.study.application.port.in.response.StudyDetailResponse;
 import com.stumeet.server.study.application.port.in.StudyQueryUseCase;
 
 import lombok.RequiredArgsConstructor;
@@ -20,11 +20,11 @@ public class StudyQueryApi {
 
 	private final StudyQueryUseCase studyQueryUseCase;
 
-	@GetMapping("/{id}")
-	public ResponseEntity<ApiResponse<StudyDetailResponse>> getStudy(
-		@PathVariable(name = "id") Long id
+	@GetMapping("/{studyId}")
+	public ResponseEntity<ApiResponse<StudyDetailResponse>> getStudyDetail(
+			@PathVariable(name = "studyId") java.lang.Long studyId
 	) {
-		StudyDetailResponse response = studyQueryUseCase.getStudyDetailById(id);
+		StudyDetailResponse response = studyQueryUseCase.getStudyDetailById(studyId);
 		return ResponseEntity.ok(ApiResponse.success(SuccessCode.GET_SUCCESS, response));
 	}
 }

src/main/java/com/stumeet/server/study/adapter/out/persistance/JpaStudyDomainRepository.java

@@ -0,0 +1,8 @@
+package com.stumeet.server.study.adapter.out.persistance;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import com.stumeet.server.study.adapter.out.persistance.entity.StudyDomainJpaEntity;
+
+public interface JpaStudyDomainRepository extends JpaRepository<StudyDomainJpaEntity, Long> {
+}

src/main/java/com/stumeet/server/study/adapter/out/persistance/JpaStudyFieldRepository.java

@@ -0,0 +1,8 @@
+package com.stumeet.server.study.adapter.out.persistance;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import com.stumeet.server.study.adapter.out.persistance.entity.StudyFieldJpaEntity;
+
+public interface JpaStudyFieldRepository extends JpaRepository<StudyFieldJpaEntity, Long> {
+}

src/main/java/com/stumeet/server/study/adapter/out/persistance/JpaStudyTagRepository.java

@@ -0,0 +1,8 @@
+package com.stumeet.server.study.adapter.out.persistance;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import com.stumeet.server.study.adapter.out.persistance.entity.StudyTagJpaEntity;
+
+public interface JpaStudyTagRepository extends JpaRepository<StudyTagJpaEntity, Long> {
+}

src/main/java/com/stumeet/server/study/adapter/out/persistance/StudyDomainPersistenceAdapter.java

@@ -0,0 +1,24 @@
+package com.stumeet.server.study.adapter.out.persistance;
+
+import com.stumeet.server.common.annotation.PersistenceAdapter;
+import com.stumeet.server.study.adapter.out.persistance.entity.StudyDomainJpaEntity;
+import com.stumeet.server.study.adapter.out.persistance.mapper.StudyDomainPersistenceMapper;
+import com.stumeet.server.study.application.port.out.StudyDomainCommandPort;
+import com.stumeet.server.study.domain.StudyDomain;
+
+import lombok.RequiredArgsConstructor;
+
+@PersistenceAdapter
+@RequiredArgsConstructor
+public class StudyDomainPersistenceAdapter implements StudyDomainCommandPort {
+
+	private final JpaStudyDomainRepository studyDomainRepository;
+	private final StudyDomainPersistenceMapper studyDomainPersistenceMapper;
+
+	@Override
+	public StudyDomain save(StudyDomain studyDomain) {
+		StudyDomainJpaEntity entity = studyDomainRepository.save(studyDomainPersistenceMapper.toEntity(studyDomain));
+
+		return studyDomainPersistenceMapper.toDomain(entity);
+	}
+}

src/main/java/com/stumeet/server/study/adapter/out/persistance/StudyFieldPersistenceAdapter.java

@@ -0,0 +1,34 @@
+package com.stumeet.server.study.adapter.out.persistance;
+
+import com.stumeet.server.common.annotation.PersistenceAdapter;
+import com.stumeet.server.study.adapter.out.persistance.entity.StudyFieldJpaEntity;
+import com.stumeet.server.study.adapter.out.persistance.mapper.StudyFieldPersistenceMapper;
+import com.stumeet.server.study.application.port.out.StudyFieldQueryPort;
+import com.stumeet.server.study.domain.StudyField;
+import com.stumeet.server.study.domain.exception.StudyFieldNotExistsException;
+
+import lombok.AccessLevel;
+import lombok.RequiredArgsConstructor;
+
+@PersistenceAdapter
+@RequiredArgsConstructor(access = AccessLevel.PRIVATE)
+public class StudyFieldPersistenceAdapter implements StudyFieldQueryPort {
+
+	private final JpaStudyFieldRepository studyFieldRepository;
+	private final StudyFieldPersistenceMapper studyFieldPersistenceMapper;
+
+	@Override
+	public void checkById(Long id) {
+		if (!studyFieldRepository.existsById(id)) {
+			throw new StudyFieldNotExistsException(id);
+		}
+	}
+
+	@Override
+	public StudyField getById(Long id) {
+		StudyFieldJpaEntity entity = studyFieldRepository.findById(id)
+				.orElseThrow(() -> new StudyFieldNotExistsException(id));
+
+		return studyFieldPersistenceMapper.toDomain(entity);
+	}
+}

src/main/java/com/stumeet/server/study/adapter/out/persistance/StudyPersistenceAdapter.java

@@ -3,27 +3,38 @@
 import com.stumeet.server.common.annotation.PersistenceAdapter;
 import com.stumeet.server.study.adapter.out.persistance.entity.StudyJpaEntity;
 import com.stumeet.server.study.adapter.out.persistance.mapper.StudyPersistenceMapper;
+import com.stumeet.server.study.application.port.out.StudyCommandPort;
 import com.stumeet.server.study.application.port.out.StudyQueryPort;
 import com.stumeet.server.study.application.port.out.StudyValidationPort;
 import com.stumeet.server.study.domain.Study;
+import com.stumeet.server.study.domain.exception.StudyNotExistsException;
 
 import lombok.RequiredArgsConstructor;
 
 @PersistenceAdapter
 @RequiredArgsConstructor
-public class StudyPersistenceAdapter implements StudyQueryPort, StudyValidationPort {
+public class StudyPersistenceAdapter implements StudyQueryPort, StudyValidationPort, StudyCommandPort {
 
-	private final StudyRepository studyRepository;
+	private final JpaStudyRepository studyRepository;
 	private final StudyPersistenceMapper studyPersistenceMapper;
 
 	@Override
 	public Study getById(Long id) {
-		StudyJpaEntity entity = studyRepository.findById(id);
+		StudyJpaEntity entity = studyRepository.findById(id)
+				.orElseThrow(() -> new StudyNotExistsException(id));
+
 		return studyPersistenceMapper.toDomain(entity);
 	}
 
 	@Override
 	public boolean existsById(Long id) {
 		return studyRepository.existsById(id);
 	}
+
+	@Override
+	public Study save(Study study) {
+		StudyJpaEntity entity = studyRepository.save(studyPersistenceMapper.toEntity(study));
+
+		return studyPersistenceMapper.toDomain(entity);
+	}
 }

src/main/java/com/stumeet/server/study/adapter/out/persistance/StudyTagPersistenceAdapter.java

@@ -0,0 +1,27 @@
+package com.stumeet.server.study.adapter.out.persistance;
+
+import java.util.List;
+
+import com.stumeet.server.common.annotation.PersistenceAdapter;
+import com.stumeet.server.study.adapter.out.persistance.entity.StudyTagJpaEntity;
+import com.stumeet.server.study.adapter.out.persistance.mapper.StudyTagPersistenceMapper;
+import com.stumeet.server.study.application.port.out.StudyTagCommandPort;
+import com.stumeet.server.study.domain.StudyTag;
+
+import lombok.RequiredArgsConstructor;
+
+@PersistenceAdapter
+@RequiredArgsConstructor
+public class StudyTagPersistenceAdapter implements StudyTagCommandPort {
+
+	private final JpaStudyTagRepository studyTagRepository;
+	private final StudyTagPersistenceMapper studyTagPersistenceMapper;
+
+	@Override
+	public List<StudyTag> saveAll(List<StudyTag> studyTags, Long studyDomainId) {
+		List<StudyTagJpaEntity> entities =
+				studyTagRepository.saveAll(studyTagPersistenceMapper.toEntities(studyTags, studyDomainId));
+
+		return studyTagPersistenceMapper.toDomains(entities);
+	}
+}

src/main/java/com/stumeet/server/study/adapter/out/persistance/entity/StudyDomainJpaEntity.java

@@ -4,7 +4,6 @@
 
 import org.hibernate.annotations.Comment;
 
-import jakarta.persistence.CascadeType;
 import jakarta.persistence.Entity;
 import jakarta.persistence.GeneratedValue;
 import jakarta.persistence.GenerationType;
@@ -37,7 +36,7 @@ public class StudyDomainJpaEntity {
 	@Comment("분야")
 	private StudyFieldJpaEntity studyField;
 
-	@OneToMany(cascade = CascadeType.ALL, orphanRemoval = true)
+	@OneToMany(orphanRemoval = true)
 	@JoinColumn(name = "study_domain_id")
 	private List<StudyTagJpaEntity> studyTags;
 }