[LNK-67] global common 코틀린 마이그레이션

CLAUDE.md

@@ -88,12 +88,14 @@ refactor: dto validation 수정
 ## Testing
 
 - **Kotest** + **MockK** for unit tests
+- **springmockk** for Spring bean mocking - use `@MockkBean` instead of `@MockBean`
 - **Testcontainers** for integration tests (MySQL, MongoDB)
 - Test both success and failure scenarios
-- Use `@DisplayName` for clear test descriptions
+- Use Kotest's `describe`/`context`/`it` for test structure
+- Controller tests: Use `@WebMvcTest` with `@Import` for Security config testing
 
 ## Notes
 
 - Swagger UI: `/swagger-ui.html`
 - Profiles: `local` (default), `dev`
-- Auth: OAuth2 Resource Server with JWT (Apple via Kakao)
+- Auth: OAuth2 Resource Server with JWT (Apple via Kakao)

build.gradle.kts

@@ -60,6 +60,7 @@ dependencies {
     testImplementation("org.testcontainers:mysql")
     testImplementation("org.testcontainers:mongodb")
     testImplementation("io.mockk:mockk:1.14.7")
+    testImplementation("com.ninja-squad:springmockk:5.0.1")
     testImplementation("org.jetbrains.kotlin:kotlin-test-junit5")
 
     // Kotest

src/main/kotlin/leets/leenk/global/common/controller/StatusCheckController.kt

@@ -0,0 +1,13 @@
+package leets.leenk.global.common.controller
+
+import io.swagger.v3.oas.annotations.Hidden
+import org.springframework.http.ResponseEntity
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.RestController
+
+@Hidden
+@RestController
+class StatusCheckController {
+    @GetMapping("/health-check")
+    fun checkHealthStatus(): ResponseEntity<String> = ResponseEntity.ok<String>("OK")
+}

src/main/kotlin/leets/leenk/global/common/dto/CommonPageableResponse.kt

@@ -0,0 +1,18 @@
+package leets.leenk.global.common.dto
+
+import com.fasterxml.jackson.annotation.JsonInclude
+import io.swagger.v3.oas.annotations.media.Schema
+
+@JsonInclude(JsonInclude.Include.NON_NULL)
+data class CommonPageableResponse(
+    @field:Schema(description = "페이지 번호 (0부터 시작)", example = "0")
+    val pageNumber: Int,
+    @field:Schema(description = "페이지 크기", example = "10")
+    val pageSize: Int,
+    @field:Schema(description = "현재 페이지의 요소 개수", example = "10")
+    val numberOfElements: Int,
+    @field:Schema(description = "다음 페이지 존재 여부", example = "true")
+    val hasNext: Boolean,
+    @field:Schema(description = "현재 페이지의 요소가 비어 있는지의 여부", example = "false")
+    val empty: Boolean,
+)

src/main/kotlin/leets/leenk/global/common/dto/PageableMapperUtil.kt

@@ -0,0 +1,26 @@
+package leets.leenk.global.common.dto
+
+import org.springframework.data.domain.Page
+import org.springframework.data.domain.Slice
+
+object PageableMapperUtil {
+    @JvmStatic
+    fun from(slice: Slice<*>): CommonPageableResponse =
+        CommonPageableResponse(
+            pageNumber = slice.number,
+            pageSize = slice.size,
+            numberOfElements = slice.numberOfElements,
+            hasNext = slice.hasNext(),
+            empty = slice.isEmpty,
+        )
+
+    @JvmStatic
+    fun from(page: Page<*>): CommonPageableResponse =
+        CommonPageableResponse(
+            pageNumber = page.number,
+            pageSize = page.size,
+            numberOfElements = page.numberOfElements,
+            hasNext = page.hasNext(),
+            empty = page.isEmpty,
+        )
+}

src/main/kotlin/leets/leenk/global/common/exception/BaseException.kt

@@ -0,0 +1,8 @@
+package leets.leenk.global.common.exception
+
+abstract class BaseException
+    @JvmOverloads
+    constructor(
+        val errorCode: ErrorCodeInterface,
+        message: String? = null,
+    ) : RuntimeException(message ?: errorCode.message)