Merge pull request #68 from KUSITMS-29th-TEAM-B/feat/flight-39

feat: 경험 등록 API 구현(#39)

Api-Module/src/docs/asciidoc/Experience.adoc

@@ -0,0 +1,17 @@
+[[Experience-API]]
+== Experience-API
+
+[[CreateExperienceTest]]
+=== 경험 등록 API
+
+operation::ExperienceControllerTest/createExperienceTest/[snippets='http-request,request-headers,request-body,request-fields,http-response,response-body,response-fields']
+
+[[CreateOverTitleLengthTest]]
+=== 제목 글자 수 제한(50자) 예외
+
+operation::ExperienceControllerTest/createOverTitleLengthTest/[snippets='http-request,request-headers,request-body,request-fields,http-response,response-body,response-fields']
+
+[[CreateOverStrongPointCountTest]]
+=== 역량 키워드 제한(5개) 초과 예외
+
+operation::ExperienceControllerTest/createOverStrongPointCountTest/[snippets='http-request,request-headers,request-body,http-response,response-body,response-fields']

Api-Module/src/docs/asciidoc/index.adoc

@@ -11,5 +11,4 @@ include::User.adoc[]
 include::StrongPoint.adoc[]
 include::Tag.adoc[]
 include::JobDescription.adoc[]
-
-
+include::Experience.adoc[]

Api-Module/src/main/kotlin/com/bamyanggang/apimodule/domain/experience/application/dto/CreateExperience.kt

@@ -0,0 +1,23 @@
+package com.bamyanggang.apimodule.domain.experience.application.dto
+
+import java.time.LocalDateTime
+import java.util.*
+
+class CreateExperience {
+    data class Request(
+        val title: String,
+        val parentTagId: UUID,
+        val childTagId: UUID,
+        val strongPointIds: List<UUID>,
+        val contents: List<ExperienceContentRequest>,
+        val startedAt: LocalDateTime,
+        val endedAt: LocalDateTime,
+    )
+
+    data class Response(val id: UUID)
+
+    data class ExperienceContentRequest(
+        val question: String,
+        val answer: String,
+    )
+}

Api-Module/src/main/kotlin/com/bamyanggang/apimodule/domain/experience/application/service/ExperienceCreateService.kt

@@ -0,0 +1,36 @@
+package com.bamyanggang.apimodule.domain.experience.application.service
+
+import com.bamyanggang.apimodule.common.getAuthenticationPrincipal
+import com.bamyanggang.apimodule.domain.experience.application.dto.CreateExperience
+import com.bamyanggang.domainmodule.domain.experience.service.ExperienceAppender
+import com.bamyanggang.domainmodule.domain.experience.service.ExperienceContentAppender
+import org.springframework.stereotype.Service
+import org.springframework.transaction.annotation.Transactional
+
+@Service
+class ExperienceCreateService(
+    val experienceAppender: ExperienceAppender,
+    val experienceContentAppender: ExperienceContentAppender
+) {
+    @Transactional
+    fun createExperience(request: CreateExperience.Request):CreateExperience.Response {
+        val currentUserId = getAuthenticationPrincipal()
+
+        return request.contents.map {
+                    experienceContentAppender.appendExperienceContent(it.question, it.answer).id
+                }.let {
+                    experienceAppender.appendExperience(
+                        title = request.title,
+                        userId = currentUserId,
+                        parentTagId = request.parentTagId,
+                        childTagId = request.childTagId,
+                        strongPointIds = request.strongPointIds,
+                        contentIds = it,
+                        startedAt = request.startedAt,
+                        endedAt = request.endedAt
+                    )
+                }.let {
+                    CreateExperience.Response(it.id)
+                }
+    }
+}

Api-Module/src/main/kotlin/com/bamyanggang/apimodule/domain/experience/presentation/ExperienceApi.kt

@@ -0,0 +1,5 @@
+package com.bamyanggang.apimodule.domain.experience.presentation
+
+object ExperienceApi {
+    const val BASE_URL = "/api/experiences"
+}

Api-Module/src/main/kotlin/com/bamyanggang/apimodule/domain/experience/presentation/ExperienceController.kt

@@ -0,0 +1,17 @@
+package com.bamyanggang.apimodule.domain.experience.presentation
+
+import com.bamyanggang.apimodule.domain.experience.application.dto.CreateExperience
+import com.bamyanggang.apimodule.domain.experience.application.service.ExperienceCreateService
+import org.springframework.web.bind.annotation.PostMapping
+import org.springframework.web.bind.annotation.RequestBody
+import org.springframework.web.bind.annotation.RestController
+
+@RestController
+class ExperienceController(
+    private val experienceCreateService: ExperienceCreateService
+) {
+    @PostMapping(ExperienceApi.BASE_URL)
+    fun createExperience(@RequestBody request: CreateExperience.Request): CreateExperience.Response {
+        return experienceCreateService.createExperience(request)
+    }
+}

Api-Module/src/main/kotlin/com/bamyanggang/apimodule/domain/jobDescription/application/service/JobDescriptionCreateService.kt

@@ -25,5 +25,4 @@ class JobDescriptionCreateService(
             )
         }.also { return CreateJobDescription.Response(jobDescriptionId = it.id) }
     }
-
 }

Api-Module/src/main/kotlin/com/bamyanggang/apimodule/domain/strongpoint/application/service/StrongPointCreateService.kt

@@ -7,20 +7,22 @@ import com.bamyanggang.domainmodule.domain.strongpoint.exception.StrongPointExce
 import com.bamyanggang.domainmodule.domain.strongpoint.service.StrongPointAppender
 import com.bamyanggang.domainmodule.domain.strongpoint.service.StrongPointReader
 import org.springframework.stereotype.Service
+import org.springframework.transaction.annotation.Transactional
 
 @Service
 class StrongPointCreateService(
     val strongPointAppender: StrongPointAppender,
     val strongPointReader: StrongPointReader,
 ) {
+    @Transactional
     fun createStrongPoint(request: CreateStrongPoint.Request): CreateStrongPoint.Response {
         return getAuthenticationPrincipal()
             .also {
                 val userStrongPoints = strongPointReader.readAllByUserId(it)
                 validateDuplicatedStrongPointName(userStrongPoints, request.name)
             }.let {
-                val newStrongPointId = strongPointAppender.appendStrongPoint(request.name, it)
-                CreateStrongPoint.Response(newStrongPointId)
+                val newStrongPoint = strongPointAppender.appendStrongPoint(request.name, it)
+                CreateStrongPoint.Response(newStrongPoint.id)
             }
     }
 

Api-Module/src/main/kotlin/com/bamyanggang/apimodule/domain/strongpoint/presentation/StrongPointController.kt

@@ -11,7 +11,7 @@ class StrongPointController(
     private val strongPointCreateService: StrongPointCreateService,
 ) {
     @PostMapping(StrongPointApi.BASE_URL)
-    fun createStrongPoint(@RequestBody request: CreateStrongPoint.Request): CreateStrongPoint.Response {
+    fun createStrongPoint(@RequestBody request: CreateStrongPoint.Request): CreateStrongPoint.Response{
         return strongPointCreateService.createStrongPoint(request)
     }
-}
+}

Api-Module/src/main/kotlin/com/bamyanggang/apimodule/domain/tag/application/service/TagCreateService.kt

@@ -7,34 +7,37 @@ import com.bamyanggang.domainmodule.domain.tag.exception.TagException
 import com.bamyanggang.domainmodule.domain.tag.service.TagAppender
 import com.bamyanggang.domainmodule.domain.tag.service.TagReader
 import org.springframework.stereotype.Service
+import org.springframework.transaction.annotation.Transactional
 import java.util.*
 
 @Service
 class TagCreateService(
     private val tagAppender: TagAppender,
     private val tagReader: TagReader,
 ) {
+    @Transactional
     fun createChildTag(request: CreateTag.Request, parentTagId: UUID): CreateTag.Response {
         return getAuthenticationPrincipal()
             .also {
                 val userChildTags = tagReader.readAllChildTagsByUserId(it, parentTagId)
                 validateTagCountLimit(userChildTags.size)
                 validateDuplicatedName(userChildTags, request.name)
             }.let {
-                val newChildTagId = tagAppender.appendChildTag(request.name, parentTagId, it)
-                CreateTag.Response(newChildTagId)
-            }
+                val newTag = tagAppender.appendChildTag(request.name, parentTagId, it)
+                CreateTag.Response(newTag.id)
+        }
     }
 
-    fun createParentTag(request: CreateTag.Request): CreateTag.Response {
+    @Transactional
+    fun createParentTag(request: CreateTag.Request) : CreateTag.Response {
         return getAuthenticationPrincipal()
             .also {
                 val userParentTags = tagReader.readAllParentTagsByUserId(it)
                 validateTagCountLimit(userParentTags.size)
                 validateDuplicatedName(userParentTags, request.name)
             }.let {
-                val newParentTagId = tagAppender.appendParentTag(request.name, it)
-                CreateTag.Response(newParentTagId)
+                val newTag = tagAppender.appendParentTag(request.name, it)
+                CreateTag.Response(newTag.id)
             }
     }
 

Api-Module/src/main/kotlin/com/bamyanggang/apimodule/domain/tag/application/service/TagDeleteService.kt

@@ -2,12 +2,14 @@ package com.bamyanggang.apimodule.domain.tag.application.service
 
 import com.bamyanggang.domainmodule.domain.tag.service.TagRemover
 import org.springframework.stereotype.Service
+import org.springframework.transaction.annotation.Transactional
 import java.util.*
 
 @Service
 class TagDeleteService(
     private val tagRemover: TagRemover
 ) {
+    @Transactional
     fun deleteTag(tagId: UUID) {
         tagRemover.removeTag(tagId)
     }

Api-Module/src/main/kotlin/com/bamyanggang/apimodule/domain/tag/presentation/TagController.kt

@@ -11,15 +11,17 @@ class TagController(
     private val tagCreateService: TagCreateService,
     private val tagDeleteService: TagDeleteService
 ) {
-    @PostMapping(TagApi.BASE_URL, TagApi.TAG_PATH_VARIABLE_URL)
-    fun createTag(
-        @PathVariable("tagId", required = false) parentTagId: UUID?,
+    @PostMapping(TagApi.BASE_URL)
+    fun createParentTag(@RequestBody request: CreateTag.Request): CreateTag.Response {
+        return tagCreateService.createParentTag(request)
+    }
+
+    @PostMapping(TagApi.TAG_PATH_VARIABLE_URL)
+    fun createChildTag(
         @RequestBody request: CreateTag.Request,
+        @PathVariable("tagId") parentTagId : UUID
     ): CreateTag.Response {
-        return when {
-            parentTagId == null -> tagCreateService.createParentTag(request)
-            else -> tagCreateService.createChildTag(request, parentTagId)
-        }
+        return tagCreateService.createChildTag(request, parentTagId)
     }
 
     @DeleteMapping(TagApi.TAG_PATH_VARIABLE_URL)