feat(snackgame): 스낵게임 Biz를 추가한다

src/main/java/com/snackgame/server/game/metadata/Metadata.kt

@@ -5,7 +5,8 @@ enum class Metadata(
     val localizedName: String
 ) {
 
-    APPLE_GAME(1L, "사과게임"),
-    SNACK_GAME(2L, "스낵게임"),
-    SNACK_GAME_INFINITE(3L, "스낵게임 무한모드")
+    APPLE_GAME(1, "사과게임"),
+    SNACK_GAME(2, "스낵게임"),
+    SNACK_GAME_INFINITE(3, "스낵게임 무한모드"),
+    SNACK_GAME_BIZ(4, "스낵게임 Biz"),
 }

src/main/java/com/snackgame/server/game/session/domain/Session.kt

@@ -33,7 +33,7 @@ abstract class Session(
     val currentState: SessionStateType
         get() = sessionState.current
 
-    abstract fun getMetadata(): Metadata
+    abstract val metadata: Metadata
 
     fun pause() = sessionState.pause()
     fun resume() = sessionState.resume()

src/main/java/com/snackgame/server/game/session/event/SessionEndEvent.kt

@@ -13,7 +13,7 @@ data class SessionEndEvent(
     companion object {
         fun of(session: Session): SessionEndEvent {
             return SessionEndEvent(
-                session.getMetadata(),
+                session.metadata,
                 session.ownerId,
                 session.sessionId,
                 session.score

src/main/java/com/snackgame/server/game/session/service/dto/SessionResponse.kt

@@ -8,7 +8,7 @@ abstract class SessionResponse(
     session: Session
 ) : Serializable {
 
-    val metadata = MetadataResponse.of(session.getMetadata())
+    val metadata = MetadataResponse.of(session.metadata)
     val ownerId = session.ownerId
     val sessionId = session.sessionId
     val state = session.currentState

src/main/java/com/snackgame/server/game/snackgame/biz/controller/SnackgameBizController.kt

@@ -0,0 +1,95 @@
+package com.snackgame.server.game.snackgame.biz.controller
+
+import com.snackgame.server.auth.token.support.Authenticated
+import com.snackgame.server.game.snackgame.biz.service.SnackgameBizService
+import com.snackgame.server.game.snackgame.core.service.dto.SnackgameEndResponse
+import com.snackgame.server.game.snackgame.core.service.dto.SnackgameResponse
+import com.snackgame.server.game.snackgame.core.service.dto.SnackgameUpdateRequest
+import com.snackgame.server.game.snackgame.core.service.dto.StreaksRequest
+import com.snackgame.server.member.domain.Member
+import io.swagger.v3.oas.annotations.Operation
+import io.swagger.v3.oas.annotations.tags.Tag
+import org.springframework.http.HttpStatus
+import org.springframework.http.ResponseEntity
+import org.springframework.web.bind.annotation.PathVariable
+import org.springframework.web.bind.annotation.PostMapping
+import org.springframework.web.bind.annotation.PutMapping
+import org.springframework.web.bind.annotation.RequestBody
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+import javax.validation.Valid
+
+@Tag(name = "🍿 스낵게임 Biz")
+@RequestMapping("/games/4")
+@RestController
+class SnackgameBizController(
+    private val snackgameBizService: SnackgameBizService
+) {
+
+    @Operation(
+        summary = "스낵게임 세션 시작",
+        description = """
+스낵게임 세션을 시작한다. 
+
+게임 보드는 추후 제공 예정"""
+    )
+    @PostMapping
+    fun startSessionFor(@Authenticated member: Member): SnackgameResponse =
+        snackgameBizService.startSessionFor(member.id)
+
+    @Operation(
+        summary = "[임시] 스낵게임 세션 수정",
+        description = """
+세션을 수정한다.
+
+현재는 점수 수정만 가능하며, 기존 점수가 덮어쓰기된다."""
+    )
+    @PutMapping("/{sessionId}")
+    fun update(
+        @Authenticated member: Member,
+        @PathVariable sessionId: Long,
+        @RequestBody @Valid request: SnackgameUpdateRequest,
+    ): SnackgameResponse = snackgameBizService.update(member.id, sessionId, request)
+
+    @Operation(
+        summary = "스트릭 추가",
+        description = """
+스트릭을 순서대로 전달하여 게임을 검증한다.  
+황금 스낵을 제거한 경우 세션 정보가 함께 응답된다.
+"""
+    )
+    @PostMapping("/{sessionId}/streaks")
+    fun removeStreaks(
+        @Authenticated member: Member,
+        @PathVariable sessionId: Long,
+        @RequestBody streaksRequest: StreaksRequest
+    ): ResponseEntity<SnackgameResponse?> {
+        val game = snackgameBizService.removeStreaks(member.id, sessionId, streaksRequest)
+        return game.let {
+            ResponseEntity
+                .status(HttpStatus.CREATED)
+                .body(it)
+        } ?: ResponseEntity.ok().build()
+    }
+
+    @Operation(
+        summary = "스낵게임 세션 일시정지",
+        description = """
+해당 세션이 일시정지된다.
+
+일시정지된 세션은 별도로 종료하지 않아도 **7일** 후 자동으로 만료된다."""
+    )
+    @PostMapping("/{sessionId}/pause")
+    fun pause(@Authenticated member: Member, @PathVariable sessionId: Long): SnackgameResponse =
+        snackgameBizService.pause(member.id, sessionId)
+
+    @Operation(summary = "스낵게임 세션 재개", description = "해당 세션을 재개한다")
+    @PostMapping("/{sessionId}/resume")
+    fun resume(@Authenticated member: Member, @PathVariable sessionId: Long): SnackgameResponse =
+        snackgameBizService.resume(member.id, sessionId)
+
+    @Operation(summary = "스낵게임 세션 종료", description = "세션을 종료한다")
+    @PostMapping("/{sessionId}/end")
+    fun end(@Authenticated member: Member, @PathVariable sessionId: Long): SnackgameEndResponse =
+        snackgameBizService.end(member.id, sessionId)
+}

src/main/java/com/snackgame/server/game/snackgame/biz/domain/SnackgameBiz.kt

@@ -0,0 +1,45 @@
+package com.snackgame.server.game.snackgame.biz.domain
+
+import com.snackgame.server.game.metadata.Metadata.SNACK_GAME_BIZ
+import com.snackgame.server.game.session.domain.Session
+import com.snackgame.server.game.snackgame.core.domain.Board
+import com.snackgame.server.game.snackgame.core.domain.BoardConverter
+import com.snackgame.server.game.snackgame.core.domain.Snackgame.Companion.DEFAULT_HEIGHT
+import com.snackgame.server.game.snackgame.core.domain.Snackgame.Companion.DEFAULT_WIDTH
+import com.snackgame.server.game.snackgame.core.domain.Snackgame.Companion.SESSION_TIME
+import com.snackgame.server.game.snackgame.core.domain.Snackgame.Companion.SPARE_TIME
+import com.snackgame.server.game.snackgame.core.domain.Streak
+import com.snackgame.server.game.snackgame.core.domain.snack.Snack
+import java.time.Duration
+import javax.persistence.Convert
+import javax.persistence.Entity
+import javax.persistence.Lob
+
+@Entity
+open class SnackgameBiz(
+    ownerId: Long,
+    board: Board = Board(DEFAULT_HEIGHT, DEFAULT_WIDTH),
+    timeLimit: Duration = SESSION_TIME + SPARE_TIME,
+    score: Int = 0
+) : Session(ownerId, timeLimit, score) {
+
+    @Lob
+    @Convert(converter = BoardConverter::class)
+    var board = board
+        private set
+
+    @Deprecated("스트릭 구현 시 제거 예정")
+    fun setScoreUnsafely(score: Int) {
+        this.score = score
+    }
+
+    fun remove(streak: Streak) {
+        val removedSnacks = board.removeSnacksIn(streak)
+        this.score += removedSnacks.size
+        if (removedSnacks.any(Snack::isGolden)) {
+            this.board = board.reset()
+        }
+    }
+
+    override val metadata = SNACK_GAME_BIZ
+}

src/main/java/com/snackgame/server/game/snackgame/biz/domain/SnackgameBizRepository.kt

@@ -0,0 +1,41 @@
+package com.snackgame.server.game.snackgame.biz.domain
+
+import com.snackgame.server.game.session.exception.NoSuchSessionException
+import com.snackgame.server.game.snackgame.core.domain.Percentile
+import org.springframework.data.jpa.repository.JpaRepository
+import org.springframework.data.jpa.repository.Modifying
+import org.springframework.data.jpa.repository.Query
+import org.springframework.stereotype.Repository
+
+@Repository
+interface SnackgameBizRepository : JpaRepository<SnackgameBiz, Long> {
+
+    fun findByOwnerIdAndSessionId(ownerId: Long, sessionId: Long): SnackgameBiz?
+
+    @Query(
+        value = """
+            with scores as (
+                select percent_rank() over (order by score desc) as percentile, session_id, score 
+                from snackgame_biz where TIMESTAMPDIFF(SECOND, now(), expires_at) <=0
+            )
+            select percentile from scores where session_id = :sessionId""",
+        nativeQuery = true
+    )
+    fun findPercentileOf(sessionId: Long): Double?
+
+    @Modifying
+    @Query("update SnackgameBiz set ownerId = :toMemberId where ownerId = :fromMemberId")
+    fun transferSessions(fromMemberId: Long, toMemberId: Long): Int
+
+    fun deleteAllByOwnerId(memberId: Long)
+}
+
+fun SnackgameBizRepository.getBy(ownerId: Long, sessionId: Long): SnackgameBiz =
+    findByOwnerIdAndSessionId(ownerId, sessionId) ?: throw NoSuchSessionException()
+
+fun SnackgameBizRepository.ratePercentileOf(sessionId: Long): Percentile {
+    with(findPercentileOf(sessionId)) {
+        this ?: throw NoSuchSessionException()
+        return Percentile(this)
+    }
+}