Merge pull request #43 from Nexters/feature/42-get-app-version-api

[#42] App 강제 업데이트 지원을 위한 최소 버전 확인 API

Author: jun108059

src/main/kotlin/nexters/weski/app_version/AppVersionCheckController.kt

@@ -0,0 +1,29 @@
+package nexters.weski.app_version
+
+import io.swagger.v3.oas.annotations.Operation
+import io.swagger.v3.oas.annotations.Parameter
+import io.swagger.v3.oas.annotations.tags.Tag
+import org.springframework.web.bind.annotation.*
+
+@Tag(name = "App 최소 버전 check API", description = "App 최소 버전 check API")
+@RestController
+class AppVersionCheckController(
+    private val appVersionCheckService: AppVersionCheckService,
+) {
+    @Operation(summary = "App 버전 조회 API")
+    @GetMapping("/api/app-version")
+    fun getAppVersion(
+        @Parameter(description = "사용자 App platform", example = "iOS")
+        @RequestParam platform: String,
+        @Parameter(description = "사용자 현재 App version", example = "1.0.0")
+        @RequestParam version: String,
+    ): AppVersionResponseDto {
+        if (platform.uppercase() !in Platform.entries.map { it.name }) {
+            throw IllegalArgumentException("platform must be one of ${Platform.entries.joinToString()}")
+        }
+        return appVersionCheckService.getAppVersion(
+            platform = Platform.valueOf(platform.uppercase()),
+            version = version,
+        )
+    }
+}

src/main/kotlin/nexters/weski/app_version/AppVersionCheckService.kt

@@ -0,0 +1,45 @@
+package nexters.weski.app_version
+
+import org.springframework.stereotype.Service
+
+@Service
+class AppVersionCheckService {
+    companion object {
+        const val IOS_MIN_VERSION = "3.0.1"
+        const val ANDROID_MIN_VERSION = "3.0.1"
+    }
+    fun getAppVersion(
+        platform: Platform,
+        version: String,
+    ): AppVersionResponseDto {
+        val minVersion = when (platform) {
+            Platform.IOS -> IOS_MIN_VERSION
+            Platform.ANDROID -> ANDROID_MIN_VERSION
+            else -> throw IllegalArgumentException("Unsupported platform: $platform")
+        }
+        return AppVersionResponseDto(
+            platform = platform,
+            minVersion = minVersion,
+            isForceUpdate = isForceUpdate(platform, version),
+        )
+    }
+
+    private fun isForceUpdate(
+        platform: Platform,
+        version: String,
+    ): Boolean {
+        return when (platform) {
+            Platform.IOS -> isForceUpdateForIOS(version)
+            Platform.ANDROID -> isForceUpdateForAndroid(version)
+            else -> throw IllegalArgumentException("Unsupported platform: $platform")
+        }
+    }
+
+    private fun isForceUpdateForIOS(version: String): Boolean {
+        return version < IOS_MIN_VERSION
+    }
+
+    private fun isForceUpdateForAndroid(version: String): Boolean {
+        return version < ANDROID_MIN_VERSION
+    }
+}

src/main/kotlin/nexters/weski/app_version/AppVersionResponseDto.kt

@@ -0,0 +1,13 @@
+package nexters.weski.app_version
+
+import io.swagger.v3.oas.annotations.media.Schema
+
+@Schema(description = "App 최소 버전, 강제업데이트 flag 데이터")
+data class AppVersionResponseDto(
+    // 예: "android", "ios" 등
+    val platform: Platform,
+    // 클라이언트에서 동작 가능한 최소 버전
+    val minVersion: String,
+    // true = App 강제 업데이트 대상임을 의미
+    val isForceUpdate: Boolean = false,
+)

src/main/kotlin/nexters/weski/app_version/Platform.kt

@@ -0,0 +1,8 @@
+package nexters.weski.app_version
+
+enum class Platform {
+    IOS,
+    ANDROID,
+    WEB,
+    UNKNOWN,
+}