refactor: allure 문서화를 위한 어노테이션 추가

YAPP-Github · Dec 20, 2024 · db94f22 · db94f22
1 parent ac4d81d
commit db94f22
Show file tree

Hide file tree

Showing 24 changed files with 138 additions and 0 deletions.
diff --git a/api/src/test/kotlin/com/few/api/config/web/controller/ApiControllerTestSpec.kt b/api/src/test/kotlin/com/few/api/config/web/controller/ApiControllerTestSpec.kt
@@ -26,6 +26,7 @@ import com.few.api.domain.workbook.article.usecase.ReadWorkBookArticleUseCase
 import com.few.api.domain.workbook.controller.WorkBookController
 import com.few.api.domain.workbook.usecase.BrowseWorkbooksUseCase
 import com.few.api.domain.workbook.usecase.ReadWorkbookUseCase
+import io.qameta.allure.Epic
 import org.junit.jupiter.api.extension.ExtendWith
 import org.springframework.beans.factory.annotation.Autowired
 import org.springframework.boot.test.autoconfigure.restdocs.AutoConfigureRestDocs
@@ -41,6 +42,7 @@ import security.TokenResolver
 import security.config.SecurityConfig
 import web.config.WebConfig
 
+@Epic("V1.0 API")
 @ActiveProfiles(value = ["test", "new"])
 @AutoConfigureRestDocs
 @AutoConfigureMockMvc(addFilters = false)

diff --git a/api/src/test/kotlin/com/few/api/domain/admin/controller/AdminApiControllerTest.kt b/api/src/test/kotlin/com/few/api/domain/admin/controller/AdminApiControllerTest.kt
@@ -7,6 +7,8 @@ import com.few.api.config.web.controller.ApiControllerTestSpec
 import com.few.api.domain.admin.controller.request.*
 import com.few.api.domain.admin.usecase.dto.*
 import com.few.api.domain.common.vo.CategoryType
+import io.qameta.allure.Feature
+import io.qameta.allure.Story
 import org.junit.jupiter.api.DisplayName
 import org.junit.jupiter.api.Test
 import org.mockito.Mockito.doNothing
@@ -23,6 +25,7 @@ import web.helper.*
 import java.net.URL
 import java.util.stream.IntStream
 
+@Feature("Admin API")
 class AdminApiControllerTest : ApiControllerTestSpec() {
     companion object {
         private const val BASE_URL = "/api/v1/admin"
@@ -31,6 +34,7 @@ class AdminApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[POST] /api/v1/admin/workbooks")
+    @Story("[POST] /api/v1/admin/workbooks")
     fun addWorkbook() {
         // given
         val api = "AddWorkbook"
@@ -85,6 +89,7 @@ class AdminApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[POST] /api/v1/admin/articles")
+    @Story("[POST] /api/v1/admin/articles")
     fun addArticle() {
         // given
         val api = "AddArticle"
@@ -182,6 +187,7 @@ class AdminApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[POST] /api/v1/admin/relations/articles")
+    @Story("[POST] /api/v1/admin/relations/articles")
     fun mapArticle() {
         // given
         val api = "MapArticle"
@@ -230,6 +236,7 @@ class AdminApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[POST] /api/v1/admin/utilities/conversion/content")
+    @Story("[POST] /api/v1/admin/utilities/conversion/content")
     fun convertContent() {
         // given
         val api = "ConvertContent"
@@ -281,6 +288,7 @@ class AdminApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[POST] /api/v1/utilities/conversion/image")
+    @Story("[POST] /api/v1/utilities/conversion/image")
     fun putImage() {
         // given
         val api = "PutImage"

diff --git a/api/src/test/kotlin/com/few/api/domain/article/controller/ArticleApiControllerTest.kt b/api/src/test/kotlin/com/few/api/domain/article/controller/ArticleApiControllerTest.kt
@@ -7,6 +7,8 @@ import com.epages.restdocs.apispec.Schema
 import com.few.api.config.web.controller.ApiControllerTestSpec
 import com.few.api.domain.article.usecase.dto.*
 import com.few.api.domain.common.vo.CategoryType
+import io.qameta.allure.Feature
+import io.qameta.allure.Story
 import org.junit.jupiter.api.DisplayName
 import org.junit.jupiter.api.Test
 import org.mockito.Mockito.`when`
@@ -21,6 +23,7 @@ import java.net.URL
 import java.time.LocalDateTime
 import java.util.stream.IntStream
 
+@Feature("Article API")
 class ArticleApiControllerTest : ApiControllerTestSpec() {
     companion object {
         private const val BASE_URL = "/api/v1/articles"
@@ -32,6 +35,7 @@ class ArticleApiControllerTest : ApiControllerTestSpec() {
      */
     @Test
     @DisplayName("[GET] /api/v1/articles/{articleId}")
+    @Story("[GET] /api/v1/articles/{articleId}")
     fun readArticle() {
         // given
         val api = "ReadArticle"
@@ -122,6 +126,7 @@ class ArticleApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[GET] /api/v1/articles?prevArticleId={optional}?categoryCd={optional}")
+    @Story("[GET] /api/v1/articles?prevArticleId={optional}?categoryCd={optional}")
     fun readArticles() {
         // given
         val api = "ReadArticles"
@@ -224,6 +229,7 @@ class ArticleApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[GET] /api/v1/articles/categories")
+    @Story("[GET] /api/v1/articles/categories")
     fun browseArticleCategories() {
         // given
         val api = "browseArticleCategories"

diff --git a/api/src/test/kotlin/com/few/api/domain/article/usecase/ReadArticleUseCaseTest.kt b/api/src/test/kotlin/com/few/api/domain/article/usecase/ReadArticleUseCaseTest.kt
@@ -15,10 +15,16 @@ import io.kotest.assertions.throwables.shouldThrow
 import io.kotest.core.spec.style.BehaviorSpec
 import io.kotest.matchers.shouldBe
 import io.mockk.*
+import io.qameta.allure.Epic
+import io.qameta.allure.Feature
+import io.qameta.allure.Story
 import org.springframework.context.ApplicationEventPublisher
 import java.net.URL
 import java.time.LocalDateTime
 
+@Epic("V1.0 UseCase")
+@Feature("Article")
+@Story("ReadArticle")
 class ReadArticleUseCaseTest :
     BehaviorSpec({
         val log = KotlinLogging.logger {}

diff --git a/api/src/test/kotlin/com/few/api/domain/log/controller/ApiLogApiControllerTest.kt b/api/src/test/kotlin/com/few/api/domain/log/controller/ApiLogApiControllerTest.kt
@@ -6,6 +6,8 @@ import com.epages.restdocs.apispec.Schema
 import com.few.api.config.web.controller.ApiControllerTestSpec
 import com.few.api.domain.log.controller.request.ApiLogRequest
 import com.few.api.domain.log.dto.AddApiLogUseCaseIn
+import io.qameta.allure.Feature
+import io.qameta.allure.Story
 import org.junit.jupiter.api.DisplayName
 import org.junit.jupiter.api.Test
 import org.mockito.Mockito
@@ -18,6 +20,7 @@ import web.helper.toIdentifier
 import web.helper.toRequestSchema
 import web.helper.toResponseSchema
 
+@Feature("API Log API")
 class ApiLogApiControllerTest : ApiControllerTestSpec() {
     companion object {
         private const val BASE_URL = "/api/v1/logs"
@@ -26,6 +29,7 @@ class ApiLogApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[POST] /api/v1/logs")
+    @Story("[POST] /api/v1/logs")
     fun addApiLog() {
         // Given
         val api = "addApiLog"

diff --git a/api/src/test/kotlin/com/few/api/domain/member/controller/MemberApiControllerTest.kt b/api/src/test/kotlin/com/few/api/domain/member/controller/MemberApiControllerTest.kt
@@ -11,6 +11,8 @@ import com.few.api.domain.member.usecase.dto.SaveMemberUseCaseIn
 import com.few.api.domain.member.usecase.dto.SaveMemberUseCaseOut
 import com.few.api.domain.member.usecase.dto.TokenUseCaseIn
 import com.few.api.domain.member.usecase.dto.TokenUseCaseOut
+import io.qameta.allure.Feature
+import io.qameta.allure.Story
 import org.junit.jupiter.api.DisplayName
 import org.junit.jupiter.api.Test
 import org.mockito.Mockito.`when`
@@ -23,6 +25,7 @@ import web.description.Description
 import web.helper.*
 
 @Suppress("ktlint:standard:property-naming", "ktlint:standard:max-line-length")
+@Feature("Member API")
 class MemberApiControllerTest : ApiControllerTestSpec() {
     companion object {
         private const val BASE_URL = "/api/v1/members"
@@ -31,6 +34,7 @@ class MemberApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[POST] /api/v1/members")
+    @Story("[POST] /api/v1/members")
     fun saveMember() {
         // given
         val api = "SaveMember"
@@ -80,6 +84,7 @@ class MemberApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[POST] /api/v1/members/token")
+    @Story("[POST] /api/v1/members/token")
     fun token() {
         // given
         val api = "Token"

diff --git a/api/src/test/kotlin/com/few/api/domain/member/usecase/SaveMemberUseCaseTest.kt b/api/src/test/kotlin/com/few/api/domain/member/usecase/SaveMemberUseCaseTest.kt
@@ -13,9 +13,15 @@ import io.kotest.matchers.shouldBe
 import io.mockk.every
 import io.mockk.mockk
 import io.mockk.verify
+import io.qameta.allure.Epic
+import io.qameta.allure.Feature
+import io.qameta.allure.Story
 import org.mockito.ArgumentMatchers.any
 import security.encryptor.IdEncryptor
 
+@Epic("V1.0 UseCase")
+@Feature("Member")
+@Story("SaveMember")
 class SaveMemberUseCaseTest :
     BehaviorSpec({
         lateinit var memberDao: MemberDao

diff --git a/api/src/test/kotlin/com/few/api/domain/member/usecase/TokenUseCaseTest.kt b/api/src/test/kotlin/com/few/api/domain/member/usecase/TokenUseCaseTest.kt
@@ -11,11 +11,17 @@ import io.kotest.matchers.shouldBe
 import io.mockk.every
 import io.mockk.mockk
 import io.mockk.verify
+import io.qameta.allure.Epic
+import io.qameta.allure.Feature
+import io.qameta.allure.Story
 import security.AuthToken
 import security.TokenGenerator
 import security.TokenResolver
 import security.encryptor.IdEncryptor
 
+@Epic("V1.0 UseCase")
+@Feature("Member")
+@Story("Token")
 class TokenUseCaseTest :
     BehaviorSpec({
         lateinit var tokenGenerator: TokenGenerator

diff --git a/api/src/test/kotlin/com/few/api/domain/problem/controller/ProblemApiControllerTest.kt b/api/src/test/kotlin/com/few/api/domain/problem/controller/ProblemApiControllerTest.kt
@@ -7,6 +7,8 @@ import com.epages.restdocs.apispec.Schema
 import com.few.api.config.web.controller.ApiControllerTestSpec
 import com.few.api.domain.problem.controller.request.CheckProblemRequest
 import com.few.api.domain.problem.usecase.dto.*
+import io.qameta.allure.Feature
+import io.qameta.allure.Story
 import org.junit.jupiter.api.DisplayName
 import org.junit.jupiter.api.Test
 import org.mockito.Mockito.`when`
@@ -20,6 +22,7 @@ import web.description.Description
 import web.helper.*
 
 @Suppress("ktlint:standard:max-line-length")
+@Feature("Problem API")
 class ProblemApiControllerTest : ApiControllerTestSpec() {
     companion object {
         private const val BASE_URL = "/api/v1/problems"
@@ -28,6 +31,7 @@ class ProblemApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[GET] /api/v1/problems?articleId=")
+    @Story("[GET] /api/v1/problems?articleId=")
     fun browseProblems() {
         // given
         val api = "BrowseProblems"
@@ -78,6 +82,7 @@ class ProblemApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[GET] /api/v1/problems/{problemId}")
+    @Story("[GET] /api/v1/problems/{problemId}")
     fun readProblem() {
         // given
         val api = "ReadProblem"
@@ -144,6 +149,7 @@ class ProblemApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[POST] /api/v1/problems/{problemId}")
+    @Story("[POST] /api/v1/problems/{problemId}")
     fun checkProblem() {
         // given
         val api = "CheckProblem"
@@ -203,6 +209,7 @@ class ProblemApiControllerTest : ApiControllerTestSpec() {
 
     @Test
     @DisplayName("[GET] /api/v1/problems/unsubmitted")
+    @Story("[GET] /api/v1/problems/unsubmitted")
     fun browseUndoneProblems() {
         // given
         val api = "BrowseUndoneProblems"

diff --git a/api/src/test/kotlin/com/few/api/domain/problem/usecase/BrowseProblemsUseCaseTest.kt b/api/src/test/kotlin/com/few/api/domain/problem/usecase/BrowseProblemsUseCaseTest.kt
@@ -9,7 +9,13 @@ import io.kotest.matchers.shouldBe
 import io.mockk.every
 import io.mockk.mockk
 import io.mockk.verify
+import io.qameta.allure.Epic
+import io.qameta.allure.Feature
+import io.qameta.allure.Story
 
+@Epic("V1.0 UseCase")
+@Feature("Problem")
+@Story("BrowseProblems")
 class BrowseProblemsUseCaseTest :
     BehaviorSpec({
 

diff --git a/api/src/test/kotlin/com/few/api/domain/problem/usecase/BrowseUndoneProblemsUseCaseTest.kt b/api/src/test/kotlin/com/few/api/domain/problem/usecase/BrowseUndoneProblemsUseCaseTest.kt
@@ -13,7 +13,13 @@ import io.kotest.core.spec.style.BehaviorSpec
 import io.mockk.every
 import io.mockk.mockk
 import io.mockk.verify
+import io.qameta.allure.Epic
+import io.qameta.allure.Feature
+import io.qameta.allure.Story
 
+@Epic("V1.0 UseCase")
+@Feature("Problem")
+@Story("BrowseUndoneProblems")
 class BrowseUndoneProblemsUseCaseTest :
     BehaviorSpec({
         lateinit var problemDao: ProblemDao

diff --git a/api/src/test/kotlin/com/few/api/domain/problem/usecase/CheckProblemUseCaseTest.kt b/api/src/test/kotlin/com/few/api/domain/problem/usecase/CheckProblemUseCaseTest.kt
@@ -10,7 +10,13 @@ import io.kotest.matchers.shouldBe
 import io.mockk.every
 import io.mockk.mockk
 import io.mockk.verify
+import io.qameta.allure.Epic
+import io.qameta.allure.Feature
+import io.qameta.allure.Story
 
+@Epic("V1.0 UseCase")
+@Feature("Problem")
+@Story("CheckProblem")
 class CheckProblemUseCaseTest :
     BehaviorSpec({
 

diff --git a/api/src/test/kotlin/com/few/api/domain/problem/usecase/ReadProblemUseCaseTest.kt b/api/src/test/kotlin/com/few/api/domain/problem/usecase/ReadProblemUseCaseTest.kt
@@ -12,8 +12,14 @@ import io.kotest.matchers.shouldBe
 import io.mockk.every
 import io.mockk.mockk
 import io.mockk.verify
+import io.qameta.allure.Epic
+import io.qameta.allure.Feature
+import io.qameta.allure.Story
 import java.util.stream.IntStream
 
+@Epic("V1.0 UseCase")
+@Feature("Problem")
+@Story("ReadProblem")
 class ReadProblemUseCaseTest :
     BehaviorSpec({