feat: 진화가능한 펫인지 확인하는 API를 추가한다

Author: devxb

src/main/kotlin/org/gitanimals/render/app/PersonaEvolutionFacade.kt

@@ -18,4 +18,13 @@ class PersonaEvolutionFacade(
             personaId = personaId,
         )
     }
+
+    fun isEvoluationable(token: String, personaId: Long): Boolean {
+        val user = identityApi.getUserByToken(token)
+
+        return userService.isEvoluationable(
+            name = user.username,
+            personaId = personaId,
+        )
+    }
 }

src/main/kotlin/org/gitanimals/render/controller/PersonaEvolutionController.kt

@@ -3,6 +3,7 @@ package org.gitanimals.render.controller
 import org.gitanimals.core.auth.RequiredUserEntryPoints
 import org.gitanimals.core.auth.UserEntryPoint
 import org.gitanimals.render.app.PersonaEvolutionFacade
+import org.gitanimals.render.controller.response.PersonaEvolutionableResponse
 import org.gitanimals.render.controller.response.PersonaResponse
 import org.springframework.http.HttpHeaders
 import org.springframework.http.HttpStatus
@@ -27,4 +28,19 @@ class PersonaEvolutionController(
             )
         )
     }
+
+    @GetMapping("/personas/{personaId}/evolution")
+    @ResponseStatus(HttpStatus.OK)
+    @RequiredUserEntryPoints([UserEntryPoint.GITHUB])
+    fun isEvolutionablePersona(
+        @RequestHeader(HttpHeaders.AUTHORIZATION) token: String,
+        @PathVariable personaId: Long,
+    ): PersonaEvolutionableResponse {
+        return PersonaEvolutionableResponse(
+            evolutionAble = personaEvolutionFacade.isEvoluationable(
+                token = token,
+                personaId = personaId,
+            )
+        )
+    }
 }

src/main/kotlin/org/gitanimals/render/controller/response/PersonaEvolutionableResponse.kt

@@ -0,0 +1,5 @@
+package org.gitanimals.render.controller.response
+
+data class PersonaEvolutionableResponse(
+    val evolutionAble: Boolean
+)

src/main/kotlin/org/gitanimals/render/domain/User.kt

@@ -345,16 +345,30 @@ class User(
             it.id == personaId
         } ?: throw IllegalArgumentException("Cannot evolution persona cause cannot find matched persona by id: \"$personaId\"")
 
+        require(persona.level() >= EVOLUTION_REQUIRED_LEVEL) {
+            "Cannot evolution persona cause, ${persona.level()} is not enough level for evolution."
+        }
+
         persona.evolution()
         return persona
     }
 
+    fun isEvolutionable(personaId: Long): Boolean {
+        val persona = personas.firstOrNull {
+            it.id == personaId
+        } ?: throw IllegalArgumentException("Cannot evolution persona cause cannot find matched persona by id: \"$personaId\"")
+
+        return persona.level() >= EVOLUTION_REQUIRED_LEVEL && persona.getType().personaEvolution != PersonaEvolution.nothing
+    }
+
     companion object {
         private const val MAX_PERSONA_COUNT = 30L
         private const val MAX_INIT_PERSONA_COUNT = 10L
         private const val FOR_NEW_PERSONA_COUNT = 30L
         private const val FOR_INIT_PERSONA_COUNT = 100L
 
+        private const val EVOLUTION_REQUIRED_LEVEL = 100L
+
         private val nameConvention = Regex("[^a-zA-Z0-9-]")
 
         private val logger = LoggerFactory.getLogger(this::class.simpleName)

src/main/kotlin/org/gitanimals/render/domain/UserService.kt

@@ -214,6 +214,15 @@ class UserService(
         return PersonaResponse.from(persona = evolutionedPersona)
     }
 
+    @Transactional(readOnly = true)
+    fun isEvoluationable(name: String, personaId: Long): Boolean {
+        val user = getUserByName(name)
+
+        return user.isEvolutionable(
+            personaId = personaId
+        )
+    }
+
     private fun getUserById(id: Long): User {
         return userRepository.findByIdOrNull(id)
             ?: throw IllegalArgumentException("Cannot find user by id : \"$id\"")

src/test/kotlin/org/gitanimals/render/domain/UserServiceTest.kt

@@ -52,7 +52,7 @@ internal class UserServiceTest(
                 id = personaId,
                 idempotencyKey = IdGenerator.generate().toString(),
                 personaType = PersonaType.RABBIT.name,
-                level = 0,
+                level = 100,
             )
 
             it("진화를 성공한다.") {
@@ -73,7 +73,7 @@ internal class UserServiceTest(
                 id = personaId,
                 idempotencyKey = IdGenerator.generate().toString(),
                 personaType = PersonaType.CAT.name,
-                level = 0,
+                level = 100,
             )
 
             it("진화를 실패한다.") {
@@ -87,6 +87,29 @@ internal class UserServiceTest(
                 result.message!!.contains("Evolution fail cause, not support evolution type") shouldBe true
             }
         }
+
+        context("name과, 진화타입이 nothing이 아니지만, 레벨이 부족한 펫의 personaId를 받으면,") {
+            val user = userRepository.save(user)
+            val personaId = IdGenerator.generate()
+            userService.addPersona(
+                name = user.getName(),
+                id = personaId,
+                idempotencyKey = IdGenerator.generate().toString(),
+                personaType = PersonaType.CAT.name,
+                level = 99,
+            )
+
+            it("진화를 실패한다.") {
+                val result = shouldThrowExactly<IllegalArgumentException> {
+                    userService.evolutionPersona(
+                        name = user.getName(),
+                        personaId = personaId,
+                    )
+                }
+
+                result.message!!.contains("Cannot evolution persona cause") shouldBe true
+            }
+        }
     }
 }) {