feat: 역량 키워드 등록 API 구현(#46)

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

@@ -0,0 +1,7 @@
+[[StrongPoint-API]]
+== Strong Point-API
+
+[[CreateStrongPoint]]
+=== 역량 키워드 등록 API
+
+operation::StrongPointControllerTest/createStrongPointTest/[snippets='http-request,request-fields,http-response,response-fields']

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

@@ -8,5 +8,6 @@
 
 include::Auth.adoc[]
 include::User.adoc[]
+include::StrongPoint.adoc[]
 
 

Api-Module/src/main/kotlin/com/bamyanggang/apimodule/common/UserSecurityUtil.kt

@@ -3,6 +3,6 @@ package com.bamyanggang.apimodule.common
 import org.springframework.security.core.context.SecurityContextHolder
 import java.util.UUID
 
- fun getAuthenticationPrincipal(): UUID {
-        return SecurityContextHolder.getContext().authentication.principal as UUID
+fun getAuthenticationPrincipal(): UUID {
+    return SecurityContextHolder.getContext().authentication.principal as UUID
 }

Api-Module/src/main/kotlin/com/bamyanggang/apimodule/domain/strongpoint/application/dto/CreateStrongPoint.kt

@@ -0,0 +1,13 @@
+package com.bamyanggang.apimodule.domain.strongpoint.application.dto
+
+import java.util.*
+
+class CreateStrongPoint {
+    data class Request(
+        val name: String,
+    )
+
+    data class Response(
+        val id: UUID,
+    )
+}

Api-Module/src/main/kotlin/com/bamyanggang/apimodule/domain/strongpoint/application/exception/StrongPointException.kt

@@ -0,0 +1,19 @@
+package com.bamyanggang.apimodule.domain.strongpoint.application.exception
+
+import com.bamyanggang.commonmodule.exception.CustomException
+import org.springframework.http.HttpStatus
+import org.springframework.http.HttpStatusCode
+
+sealed class StrongPointException(
+    errorCode: Int,
+    httpStatusCode: HttpStatusCode,
+    message: String,
+) : CustomException(CODE_PREFIX, errorCode, httpStatusCode , message) {
+
+    class DuplicatedStrongPointName(message: String = "역량 키워드 이름이 중복됩니다.") :
+        StrongPointException(errorCode = 1, httpStatusCode = HttpStatus.BAD_REQUEST, message = message)
+
+    companion object {
+        const val CODE_PREFIX = "STRONG_POINT"
+    }
+}

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

@@ -0,0 +1,34 @@
+package com.bamyanggang.apimodule.domain.strongpoint.application.service
+
+import com.bamyanggang.apimodule.common.getAuthenticationPrincipal
+import com.bamyanggang.apimodule.domain.strongpoint.application.dto.CreateStrongPoint
+import com.bamyanggang.apimodule.domain.strongpoint.application.exception.StrongPointException
+import com.bamyanggang.domainmodule.domain.strongpoint.aggregate.StrongPoint
+import com.bamyanggang.domainmodule.domain.strongpoint.service.StrongPointAppender
+import com.bamyanggang.domainmodule.domain.strongpoint.service.StrongPointReader
+import org.springframework.stereotype.Service
+
+@Service
+class StrongPointCreateService(
+    val strongPointAppender: StrongPointAppender,
+    val strongPointReader: StrongPointReader,
+) {
+    fun createStrongPoint(request: CreateStrongPoint.Request): CreateStrongPoint.Response {
+        return getAuthenticationPrincipal()
+            .also {
+                val userStrongPoints = strongPointReader.findAllByUserId(it)
+                validateDuplicatedName(userStrongPoints, request.name)
+            }.let {
+                val newStrongPointId = strongPointAppender.appendStrongPoint(request.name, it)
+                CreateStrongPoint.Response(newStrongPointId)
+            }
+    }
+
+    private fun validateDuplicatedName(userStrongPoints: List<StrongPoint>, name: String) {
+        userStrongPoints.forEach {
+            if (name == it.name) {
+                throw StrongPointException.DuplicatedStrongPointName()
+            }
+        }
+    }
+}

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

@@ -0,0 +1,5 @@
+package com.bamyanggang.apimodule.domain.strongpoint.presentation
+
+object StrongPointApi {
+    const val BASE_URL = "/api/strong-points"
+}

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

@@ -0,0 +1,17 @@
+package com.bamyanggang.apimodule.domain.strongpoint.presentation
+
+import com.bamyanggang.apimodule.domain.strongpoint.application.dto.CreateStrongPoint
+import com.bamyanggang.apimodule.domain.strongpoint.application.service.StrongPointCreateService
+import org.springframework.web.bind.annotation.PostMapping
+import org.springframework.web.bind.annotation.RequestBody
+import org.springframework.web.bind.annotation.RestController
+
+@RestController
+class StrongPointController(
+    private val strongPointCreateService: StrongPointCreateService,
+) {
+    @PostMapping(StrongPointApi.BASE_URL)
+    fun createStrongPoint(@RequestBody request: CreateStrongPoint.Request): CreateStrongPoint.Response {
+        return strongPointCreateService.createStrongPoint(request)
+    }
+}

Api-Module/src/test/kotlin/com/bamyanggang/apimodule/domain/strongpoint/presentation/StrongPointControllerTest.kt

@@ -0,0 +1,48 @@
+package com.bamyanggang.apimodule.domain.strongpoint.presentation
+
+import com.bamyanggang.apimodule.BaseRestDocsTest
+import com.bamyanggang.apimodule.domain.strongpoint.application.dto.CreateStrongPoint
+import com.bamyanggang.commonmodule.fixture.generateFixture
+import org.junit.jupiter.api.DisplayName
+import org.junit.jupiter.api.Test
+import org.mockito.BDDMockito.given
+import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest
+import org.springframework.boot.test.mock.mockito.MockBean
+import org.springframework.http.MediaType
+import org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders
+import org.springframework.restdocs.payload.PayloadDocumentation.*
+import org.springframework.test.web.servlet.result.MockMvcResultMatchers.status
+
+@WebMvcTest(StrongPointController::class)
+class StrongPointControllerTest : BaseRestDocsTest() {
+
+    @MockBean
+    private lateinit var strongPointController: StrongPointController
+
+    @Test
+    @DisplayName("역량 키워드를 저장한 뒤 생성된 역량 키워드 ID를 반환한다.")
+    fun createStrongPointTest() {
+        val createStrongPoint: CreateStrongPoint.Request = generateFixture()
+        val createStrongPointResponse: CreateStrongPoint.Response = generateFixture()
+
+        given(strongPointController.createStrongPoint(createStrongPoint)).willReturn(createStrongPointResponse)
+
+        val request = RestDocumentationRequestBuilders.post(StrongPointApi.BASE_URL)
+            .contentType(MediaType.APPLICATION_JSON_VALUE)
+            .content(objectMapper.writeValueAsString(createStrongPoint))
+
+        val result = mockMvc.perform(request)
+
+        result.andExpect(status().isOk)
+            .andDo(
+                resultHandler.document(
+                    requestFields(
+                        fieldWithPath("name").description("역량 키워드 이름"),
+                    ),
+                    responseFields(
+                        fieldWithPath("id").description("생성된 역량 키워드 id"),
+                    )
+                )
+            )
+    }
+}

Domain-Module/src/main/kotlin/com/bamyanggang/domainmodule/domain/experience/repository/StrongPointRepository.kt

@@ -0,0 +1,9 @@
+package com.bamyanggang.domainmodule.domain.experience.repository
+
+import com.bamyanggang.domainmodule.domain.strongpoint.aggregate.StrongPoint
+import java.util.*
+
+interface StrongPointRepository {
+    fun save(newStrongPoint: StrongPoint): UUID
+    fun findAllByUserId(userId: UUID): List<StrongPoint>
+}

Domain-Module/src/main/kotlin/com/bamyanggang/domainmodule/domain/experience/aggregate/StrongPoint.kt → Domain-Module/src/main/kotlin/com/bamyanggang/domainmodule/domain/strongpoint/aggregate/StrongPoint.kt

@@ -1,14 +1,14 @@
-package com.bamyanggang.domainmodule.domain.experience.aggregate
+package com.bamyanggang.domainmodule.domain.strongpoint.aggregate
 
-import com.bamyanggang.domainmodule.common.entity.AggregateRoot
+import com.bamyanggang.domainmodule.common.entity.DomainEntity
 import com.example.uuid.UuidCreator
 import java.util.*
 
 data class StrongPoint(
     override val id: UUID = UuidCreator.create(),
     val name : String,
     val userId : UUID?,
-) : AggregateRoot{
+) : DomainEntity{
     companion object {
         fun create(name: String, userId: UUID?): StrongPoint {
             return StrongPoint(UuidCreator.create(), name, userId)

Domain-Module/src/main/kotlin/com/bamyanggang/domainmodule/domain/strongpoint/repository/StrongPointRepository.kt

@@ -0,0 +1,4 @@
+package com.bamyanggang.domainmodule.domain.strongpoint.repository
+
+interface StrongPointRepository {
+}

Domain-Module/src/main/kotlin/com/bamyanggang/domainmodule/domain/strongpoint/service/StrongPointAppender.kt

@@ -0,0 +1,17 @@
+package com.bamyanggang.domainmodule.domain.strongpoint.service
+
+import com.bamyanggang.domainmodule.domain.experience.repository.StrongPointRepository
+import com.bamyanggang.domainmodule.domain.strongpoint.aggregate.StrongPoint
+import org.springframework.stereotype.Service
+import java.util.*
+
+@Service
+class StrongPointAppender(
+    private val strongPointRepository: StrongPointRepository
+) {
+    fun appendStrongPoint(name: String, userId: UUID): UUID {
+        return StrongPoint.create(name, userId).let {
+            strongPointRepository.save(it)
+        }
+    }
+}

Domain-Module/src/main/kotlin/com/bamyanggang/domainmodule/domain/strongpoint/service/StrongPointReader.kt

@@ -0,0 +1,15 @@
+package com.bamyanggang.domainmodule.domain.strongpoint.service
+
+import com.bamyanggang.domainmodule.domain.experience.repository.StrongPointRepository
+import com.bamyanggang.domainmodule.domain.strongpoint.aggregate.StrongPoint
+import org.springframework.stereotype.Service
+import java.util.*
+
+@Service
+class StrongPointReader(
+    private val strongPointRepository: StrongPointRepository
+) {
+    fun findAllByUserId(userId: UUID): List<StrongPoint> {
+        return strongPointRepository.findAllByUserId(userId)
+    }
+}

Domain-Module/src/main/kotlin/com/bamyanggang/domainmodule/domain/experience/aggregate/Tag.kt → Domain-Module/src/main/kotlin/com/bamyanggang/domainmodule/domain/tag/aggregate/Tag.kt

@@ -1,4 +1,4 @@
-package com.bamyanggang.domainmodule.domain.experience.aggregate
+package com.bamyanggang.domainmodule.domain.tag.aggregate
 
 import com.bamyanggang.domainmodule.common.entity.DomainEntity
 import com.example.uuid.UuidCreator

Infrastructure-Module/persistence/src/main/java/com/bamyanggang/persistence/experience/ExperienceRepositoryImpl.java

@@ -0,0 +1,13 @@
+package com.bamyanggang.persistence.experience;
+
+import com.bamyanggang.persistence.experience.jpa.repository.ExperienceJpaRepository;
+import com.bamyanggang.persistence.experience.mapper.ExperienceMapper;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Repository;
+
+@Repository
+@RequiredArgsConstructor
+public class ExperienceRepositoryImpl {
+    private final ExperienceJpaRepository experienceJpaRepository;
+    private final ExperienceMapper experienceMapper;
+}

Infrastructure-Module/persistence/src/main/java/com/bamyanggang/persistence/experience/jpa/entity/ExperienceContentJpaEntity.java

@@ -18,7 +18,7 @@
 public class ExperienceContentJpaEntity {
     @Id
     @Column(name = "experience_content_id")
-    private UUID id;
+    private UUID experienceContentId;
 
     @Column(columnDefinition = "TEXT")
     private String question;

Infrastructure-Module/persistence/src/main/java/com/bamyanggang/persistence/experience/jpa/entity/ExperienceJpaEntity.java

@@ -19,7 +19,7 @@
 public class ExperienceJpaEntity{
     @Id
     @Column(name = "experience_id")
-    private UUID id;
+    private UUID experienceId;
 
     private String title;
 

Infrastructure-Module/persistence/src/main/java/com/bamyanggang/persistence/experience/jpa/entity/ExperienceStrongPointJpaEntity.java

@@ -1,5 +1,6 @@
 package com.bamyanggang.persistence.experience.jpa.entity;
 
+import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
 import jakarta.persistence.Id;
 import jakarta.persistence.Table;
@@ -11,7 +12,8 @@
 @Table(name = "experience_strong_point")
 public class ExperienceStrongPointJpaEntity {
     @Id
-    private UUID id;
+    @Column(name = "experience_strong_point_id")
+    private UUID experienceStrongPointId;
 
     private UUID experienceId;
 

Infrastructure-Module/persistence/src/main/java/com/bamyanggang/persistence/experience/jpa/entity/ExperienceTagJpaEntity.java

@@ -18,7 +18,7 @@
 public class ExperienceTagJpaEntity {
     @Id
     @Column(name = "experience_tag_id")
-    private UUID id;
+    private UUID experienceTagId;
 
     private UUID experienceId;
 

Infrastructure-Module/persistence/src/main/java/com/bamyanggang/persistence/experience/mapper/ExperienceContentMapper.java

@@ -0,0 +1,24 @@
+package com.bamyanggang.persistence.experience.mapper;
+
+import com.bamyanggang.domainmodule.domain.experience.aggregate.ExperienceContent;
+import com.bamyanggang.persistence.experience.jpa.entity.ExperienceContentJpaEntity;
+import org.springframework.stereotype.Component;
+
+@Component
+class ExperienceContentMapper {
+    public ExperienceContentJpaEntity toJpaEntity(ExperienceContent experienceContent) {
+        return ExperienceContentJpaEntity.of(
+                experienceContent.getId(),
+                experienceContent.getQuestion(),
+                experienceContent.getAnswer(),
+                experienceContent.getExperienceId());
+    }
+
+    public ExperienceContent toDomainEntity(ExperienceContentJpaEntity experienceContentJpaEntity) {
+        return ExperienceContent.Companion.toDomain(
+                experienceContentJpaEntity.getExperienceContentId(),
+                experienceContentJpaEntity.getQuestion(),
+                experienceContentJpaEntity.getAnswer(),
+                experienceContentJpaEntity.getExperienceId());
+    }
+}