Feat/#11

build.gradle.kts

@@ -78,6 +78,7 @@ dependencies {
 
     // JPA
     implementation("org.springframework.boot:spring-boot-starter-data-jpa")
+    runtimeOnly("org.postgresql:postgresql")
 
     // flyway (DB schema migration)
     implementation("org.flywaydb:flyway-core")
@@ -90,7 +91,7 @@ dependencies {
     testImplementation("io.kotest.extensions:kotest-extensions-spring:$kotestExtensionsVersion")
     testImplementation("io.mockk:mockk:$mockkVersion")
     testRuntimeOnly("com.h2database:h2")
-    runtimeOnly("org.postgresql:postgresql")
+    testImplementation("io.rest-assured:rest-assured")
 }
 
 spotless {

src/main/kotlin/com/yapp2app/common/annotation/UseCase.kt

@@ -0,0 +1,14 @@
+package com.yapp2app.common.annotation
+
+import org.springframework.stereotype.Component
+
+/**
+ * fileName       : UseCase
+ * author         : koo
+ * date           : 2025. 12. 23. 오후 6:51
+ * description    : usecase annotation
+ */
+@Component
+@Target(AnnotationTarget.CLASS)
+@Retention(AnnotationRetention.RUNTIME)
+annotation class UseCase

src/main/kotlin/com/yapp2app/common/api/dto/ResultCode.kt

@@ -17,6 +17,8 @@ enum class ResultCode(val code: String, var message: String) {
     NOT_FOUND("D-04", "데이터를 찾을 수 없습니다."),
     ALREADY_REQUEST("D-05", "이미 처리된 요청입니다."),
 
+    CONFLICT_FOLDER("D-06", message = "해당하는 폴더가 존재합니다."),
+
     EXPIRED_TOKEN_ERROR("D-997", "토큰이 만료되었습니다."),
     INVALID_TOKEN_ERROR("D-998", "토큰이 올바르지 않습니다."),
     SECURITY_ERROR("D-999", "인증에 실패하였습니다."),

src/main/kotlin/com/yapp2app/common/config/JasyptConfig.kt

@@ -6,13 +6,15 @@ import org.jasypt.encryption.pbe.config.SimpleStringPBEConfig
 import org.springframework.beans.factory.annotation.Value
 import org.springframework.context.annotation.Bean
 import org.springframework.context.annotation.Configuration
+import org.springframework.context.annotation.Profile
 
 /**
  * fileName       : JasyptConfig
  * author         : darren
  * date           : 2025. 12. 24.
  * description    : Jasypt 암호화 설정
  */
+@Profile("!test")
 @Configuration
 class JasyptConfig {
 

src/main/kotlin/com/yapp2app/common/domain/BaseTimeEntity.kt

@@ -0,0 +1,27 @@
+package com.yapp2app.common.domain
+
+import jakarta.persistence.Column
+import jakarta.persistence.EntityListeners
+import jakarta.persistence.MappedSuperclass
+import org.springframework.data.annotation.CreatedDate
+import org.springframework.data.annotation.LastModifiedDate
+import org.springframework.data.jpa.domain.support.AuditingEntityListener
+import java.time.LocalDateTime
+
+/**
+ * fileName       : BaseTimeEntity
+ * author         : koo
+ * date           : 2025. 12. 23. 오후 7:09
+ * description    : 생성일, 수정일 base entity
+ */
+@MappedSuperclass
+@EntityListeners(AuditingEntityListener::class)
+abstract class BaseTimeEntity(
+    @CreatedDate
+    @Column(name = "created_at", nullable = false, updatable = false)
+    var createdAt: LocalDateTime? = null,
+
+    @LastModifiedDate
+    @Column(name = "updated_at", nullable = false)
+    var updatedAt: LocalDateTime? = null,
+)

src/main/kotlin/com/yapp2app/common/exception/dto/ExceptionDto.kt

@@ -12,7 +12,7 @@ data class FieldErrorDetail(var field: String, var message: String)
 
 data class ExceptionMsg(
     val message: String,
-    val code: String,
+    val resultCode: String,
     val success: Boolean,
     val errors: List<FieldErrorDetail>? = null,
 ) : Serializable

src/main/kotlin/com/yapp2app/common/exception/handler/ExceptionHandler.kt

@@ -33,7 +33,7 @@ class ExceptionHandler {
     fun businessExceptionHandler(ex: BusinessException): ResponseEntity<ExceptionMsg> {
         val temp = ResponseEntity(
             ExceptionMsg(
-                code = ex.resultCode.code,
+                resultCode = ex.resultCode.code,
                 message = ex.resultCode.message,
                 success = false,
                 errors = emptyList(),
@@ -59,7 +59,7 @@ class ExceptionHandler {
 
         return ResponseEntity(
             ExceptionMsg(
-                code = ResultCode.INVALID_PARAMETER.code,
+                resultCode = ResultCode.INVALID_PARAMETER.code,
                 message = errors.get(0).message,
                 success = false,
                 errors = errors,
@@ -104,7 +104,7 @@ class ExceptionHandler {
         }
         return ResponseEntity(
             ExceptionMsg(
-                code = ResultCode.INVALID_PARAMETER.code,
+                resultCode = ResultCode.INVALID_PARAMETER.code,
                 message = ResultCode.INVALID_PARAMETER.message,
                 success = false,
                 errors = errors,
@@ -119,7 +119,7 @@ class ExceptionHandler {
         request: WebRequest,
     ): ResponseEntity<ExceptionMsg> = ResponseEntity(
         ExceptionMsg(
-            code = ResultCode.INVALID_PARAMETER.code,
+            resultCode = ResultCode.INVALID_PARAMETER.code,
             message = ResultCode.INVALID_PARAMETER.message,
             success = false,
             errors = listOf(
@@ -139,7 +139,7 @@ class ExceptionHandler {
             val enumValues = ex.requiredType!!.enumConstants?.joinToString(", ")
             ResponseEntity(
                 ExceptionMsg(
-                    code = ResultCode.INVALID_PARAMETER.code,
+                    resultCode = ResultCode.INVALID_PARAMETER.code,
                     message = ResultCode.INVALID_PARAMETER.message,
                     success = false,
                     errors = listOf(
@@ -154,7 +154,7 @@ class ExceptionHandler {
         } else {
             ResponseEntity(
                 ExceptionMsg(
-                    code = ResultCode.INVALID_PARAMETER.code,
+                    resultCode = ResultCode.INVALID_PARAMETER.code,
                     message = ResultCode.INVALID_PARAMETER.message,
                     success = false,
                     errors = listOf(

src/main/kotlin/com/yapp2app/common/infra/config/JpaAuditingConfig.kt

@@ -0,0 +1,14 @@
+package com.yapp2app.common.infra.config
+
+import org.springframework.context.annotation.Configuration
+import org.springframework.data.jpa.repository.config.EnableJpaAuditing
+
+/**
+ * fileName       : JpaAuditingConfig
+ * author         : koo
+ * date           : 2025. 12. 23. 오후 7:10
+ * description    : Jpa Auditing Config
+ */
+@Configuration
+@EnableJpaAuditing
+class JpaAuditingConfig

src/main/kotlin/com/yapp2app/common/infra/media/fake/FakeS3MediaStorage.kt

@@ -0,0 +1,14 @@
+package com.yapp2app.common.infra.media.fake
+
+import org.springframework.context.annotation.Configuration
+import org.springframework.context.annotation.Profile
+
+/**
+ * fileName       : FakeS3MediaStorage
+ * author         : koo
+ * date           : 2025. 12. 28. 오후 10:30
+ * description    :
+ */
+@Profile("test")
+@Configuration
+class FakeS3MediaStorage

src/main/kotlin/com/yapp2app/common/infra/media/s3/S3MediaStorageConfig.kt

@@ -3,6 +3,7 @@ package com.yapp2app.common.infra.media.s3
 import com.yapp2app.common.media.MediaStorage
 import org.springframework.context.annotation.Bean
 import org.springframework.context.annotation.Configuration
+import org.springframework.context.annotation.Profile
 import software.amazon.awssdk.auth.credentials.AwsBasicCredentials
 import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider
 import software.amazon.awssdk.regions.Region
@@ -17,6 +18,7 @@ import java.net.URI
  * date           : 2025. 12. 19. 오전 2:40
  * description    : S3 설정
  */
+@Profile("!test")
 @Configuration
 class S3MediaStorageConfig(private val props: S3Properties) {
 

src/main/kotlin/com/yapp2app/photo/api/controller/FolderController.kt

@@ -0,0 +1,127 @@
+package com.yapp2app.photo.api.controller
+
+import com.yapp2app.common.api.dto.BaseResponse
+import com.yapp2app.photo.api.converter.FolderCommandConverter
+import com.yapp2app.photo.api.converter.FolderResultConverter
+import com.yapp2app.photo.api.dto.CreateFolderRequest
+import com.yapp2app.photo.api.dto.CreateFolderResponse
+import com.yapp2app.photo.api.dto.DeleteFoldersRequest
+import com.yapp2app.photo.api.dto.GetAllFolderResponse
+import com.yapp2app.photo.api.dto.UpdateFolderRequest
+import com.yapp2app.photo.application.usecase.CreateFolderUseCase
+import com.yapp2app.photo.application.usecase.DeleteFolderUseCase
+import com.yapp2app.photo.application.usecase.GetFoldersUseCase
+import com.yapp2app.photo.application.usecase.UpdateFolderUseCase
+import io.swagger.v3.oas.annotations.Operation
+import io.swagger.v3.oas.annotations.tags.Tag
+import jakarta.validation.Valid
+import org.springframework.security.core.annotation.AuthenticationPrincipal
+import org.springframework.web.bind.annotation.DeleteMapping
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.PatchMapping
+import org.springframework.web.bind.annotation.PathVariable
+import org.springframework.web.bind.annotation.PostMapping
+import org.springframework.web.bind.annotation.RequestBody
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+/**
+ * fileName       : FolderController
+ * author         : koo
+ * date           : 2025. 12. 23. 오후 7:58
+ * description    : Folder aggregate에 대한 api endpoint
+ */
+@Tag(name = "folder", description = "폴더 API")
+@RestController
+@RequestMapping("/api/folders")
+class FolderController(
+    private val createFolderUseCase: CreateFolderUseCase,
+    private val getFoldersUseCase: GetFoldersUseCase,
+    private val deleteFolderUseCase: DeleteFolderUseCase,
+    private val updateFolderUseCase: UpdateFolderUseCase,
+    private val commandConverter: FolderCommandConverter,
+    private val resultConverter: FolderResultConverter,
+) {
+
+    @Operation(
+        summary = "폴더 생성 API",
+        description = "폴더를 생성합니다.",
+    )
+    @PostMapping
+    fun createFolder(
+        @AuthenticationPrincipal(expression = "id") userId: Long,
+        @Valid @RequestBody request: CreateFolderRequest,
+    ): BaseResponse<CreateFolderResponse> {
+        val command = commandConverter.toCreateFolderCommand(request, userId)
+
+        val result = createFolderUseCase.execute(command)
+
+        val response = resultConverter.toCreateFolderResponse(result)
+
+        return BaseResponse(data = response)
+    }
+
+    @Operation(
+        summary = "폴더 목록 조회 API",
+        description = "폴더 목록을 조회합니다.",
+    )
+    @GetMapping
+    fun getAllFolder(@AuthenticationPrincipal(expression = "id") userId: Long): BaseResponse<GetAllFolderResponse> {
+        val command = commandConverter.toGetFoldersCommand(userId)
+
+        val result = getFoldersUseCase.execute(command)
+
+        val response = resultConverter.toGetAllFoldersResponse(result)
+
+        return BaseResponse(data = response)
+    }
+
+    @Operation(
+        summary = "폴더 삭제 API",
+        description = "단건 폴더 삭제를 합니다.",
+    )
+    @DeleteMapping("/{folderId}")
+    fun deleteFolder(
+        @AuthenticationPrincipal(expression = "id") userId: Long,
+        @PathVariable folderId: Long,
+    ): BaseResponse<Any> {
+        val command = commandConverter.toDeleteFolderCommand(userId, folderId)
+
+        deleteFolderUseCase.execute(command)
+
+        return BaseResponse()
+    }
+
+    @Operation(
+        summary = "폴더 선택 삭제 API",
+        description = "여러 개의 폴더를 선택하여 삭제합니다.",
+    )
+    @DeleteMapping
+    fun deleteFolders(
+        @AuthenticationPrincipal(expression = "id") userId: Long,
+        @Valid @RequestBody request: DeleteFoldersRequest,
+    ): BaseResponse<Any> {
+        val command = commandConverter.toDeleteFoldersCommand(request, userId)
+
+        deleteFolderUseCase.execute(command)
+
+        return BaseResponse()
+    }
+
+    @Operation(
+        summary = "폴더 갱신 API",
+        description = "폴더 정보를 갱신합니다.",
+    )
+    @PatchMapping("/{folderId}")
+    fun updateFolder(
+        @AuthenticationPrincipal(expression = "id") userId: Long,
+        @PathVariable folderId: Long,
+        @Valid @RequestBody request: UpdateFolderRequest,
+    ): BaseResponse<Any> {
+        val command = commandConverter.toUpdateFolderCommand(request, folderId, userId)
+
+        updateFolderUseCase.execute(command)
+
+        return BaseResponse()
+    }
+}

src/main/kotlin/com/yapp2app/photo/api/converter/FolderCommandConverter.kt

@@ -0,0 +1,34 @@
+package com.yapp2app.photo.api.converter
+
+import com.yapp2app.photo.api.dto.CreateFolderRequest
+import com.yapp2app.photo.api.dto.DeleteFoldersRequest
+import com.yapp2app.photo.api.dto.UpdateFolderRequest
+import com.yapp2app.photo.application.command.CreateFolderCommand
+import com.yapp2app.photo.application.command.DeleteFolderCommand
+import com.yapp2app.photo.application.command.DeleteFoldersCommand
+import com.yapp2app.photo.application.command.GetFoldersCommand
+import com.yapp2app.photo.application.command.UpdateFolderCommand
+import org.springframework.stereotype.Component
+
+/**
+ * fileName       : FolderCommandConverter
+ * author         : koo
+ * date           : 2025. 12. 28. 오후 9:44
+ * description    :
+ */
+@Component
+class FolderCommandConverter {
+
+    fun toCreateFolderCommand(request: CreateFolderRequest, userId: Long): CreateFolderCommand =
+        CreateFolderCommand(userId, request.name)
+
+    fun toGetFoldersCommand(userId: Long): GetFoldersCommand = GetFoldersCommand(userId)
+
+    fun toDeleteFolderCommand(userId: Long, folderId: Long) = DeleteFolderCommand(userId, folderId)
+
+    fun toDeleteFoldersCommand(request: DeleteFoldersRequest, userId: Long) =
+        DeleteFoldersCommand(userId, request.folderIds)
+
+    fun toUpdateFolderCommand(request: UpdateFolderRequest, folderId: Long, userId: Long) =
+        UpdateFolderCommand(userId, folderId, request.name)
+}

src/main/kotlin/com/yapp2app/photo/api/converter/FolderResultConverter.kt

@@ -0,0 +1,28 @@
+package com.yapp2app.photo.api.converter
+
+import com.yapp2app.photo.api.dto.CreateFolderResponse
+import com.yapp2app.photo.api.dto.GetAllFolderResponse
+import com.yapp2app.photo.application.result.CreateFolderResult
+import com.yapp2app.photo.application.result.GetFoldersResult
+import org.springframework.stereotype.Component
+
+/**
+ * fileName       : FolderDtoMapper
+ * author         : koo
+ * date           : 2025. 12. 28. 오후 9:41
+ * description    :
+ */
+@Component
+class FolderResultConverter {
+
+    fun toGetAllFoldersResponse(result: GetFoldersResult): GetAllFolderResponse = GetAllFolderResponse(
+        result.items.map {
+            GetAllFolderResponse.FolderInfo(
+                it.folderId,
+                it.name,
+            )
+        },
+    )
+
+    fun toCreateFolderResponse(result: CreateFolderResult): CreateFolderResponse = CreateFolderResponse(result.folderId)
+}