Feature/update version

.claude/settings.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Read|Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "TOOL_INPUT=$(cat); if echo \"$TOOL_INPUT\" | grep -q 'google-services.json'; then echo 'BLOCK: google-services.json은 민감한 파일이므로 접근할 수 없습니다.' >&2; exit 2; fi"
+          }
+        ]
+      }
+    ]
+  }
+}

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-**ChukChukHaksa** (formerly Suwiki) is a Kotlin Multiplatform Compose project for timetable and course evaluation services for Suwon University students. The project has been simplified from a 40+ module architecture to a single `composeApp` module while maintaining Clean Architecture with MVI pattern.
+**ChukChukHaksa** (formerly Suwiki) is a Kotlin Multiplatform Compose project for timetable and course evaluation services for Suwon University students. The project uses a single `composeApp` module with Clean Architecture and MVI pattern. Supports Android and iOS with platform-specific widgets.
 
 ## Build System and Commands
 
@@ -43,27 +43,31 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ### MVI + Clean Architecture Pattern
 - **Presentation Layer**: MVI with custom `MviStore` implementation using StateFlow/Flow
-- **Domain Layer**: Use cases following single responsibility principle
-- **Data Layer**: Repository pattern with Room database and Firebase integration
+- **Domain Layer**: Use cases with `suspend operator fun invoke()`, returns `Result<T>`
+- **Data Layer**: Repository pattern with local (Room/Datastore) and remote (Firebase) data sources
 
 ### Key Architectural Components
 - **State Management**: Unidirectional Data Flow (UDF) with StateFlow
 - **Dependency Injection**: Koin 4.1.0-Beta10 with feature-based modules
-- **Navigation**: Jetpack Navigation Compose with type-safe routes
-- **Database**: Room 2.7.1 with SQLite for local storage
-- **Remote Data**: Firebase via GitLive KMP wrappers
+- **Navigation**: Jetpack Navigation Compose 2.9.0-beta02 with type-safe routes (kotlinx.serialization for argument passing)
+- **Database**: Room 2.7.1 with SQLite for local storage (schema in `composeApp/schemas`)
+- **Remote Data**: Firebase via GitLive KMP wrappers 2.1.0
+- **Widgets**: Android (Glance 1.1.1) / iOS (Native WidgetKit) timetable widgets
 
 ## Design System
 
 ### Dual Theme System
 The project uses two parallel design systems:
 
 1. **SuwikiTheme**: Legacy design system with NotoSans fonts
-   - 17 text styles (header1-7, body1-7, caption1-7)
+   - 21 text styles (header1-7, body1-7, caption1-7)
 
-2. **CCHaksaTheme**: New design system with Paperlogy + SUIT fonts
-   - Typography: 10 text styles (titleExlg2, titleExlg, titleLg, bodyExlg, bodyLgStrong, bodyLg, bodyMdStrong, bodyMd, bodySm, bodyXs)
-   - Colors: Organized palette with Gray, Purple, Red, Yellow, Green variants (100-600 naming)
+2. **CchTheme**: New design system with Paperlogy + SUIT fonts
+   - Typography: 13 text styles (titleExlg2, titleExlg, titleLg, bodyExlg, bodyLgStrong, bodyLg, bodyMdStrong, bodyMd, bodySmStrong, bodySm, bodyXsStrong, bodyXs, bodyXxs)
+   - Colors: Organized palette with Gray (100-600), Purple (100-600), Red (100-400), Yellow (100-200), Green (100-200)
+
+### Design System Components
+appbar, badge, bottomsheet, button, chip, container, dialog, loading, searchbar, tabbar, textfield, toast
 
 ### Design System Location
 - **Components**: `composeApp/src/commonMain/kotlin/com/chukchukhaksa/mobile/common/designsystem/component/`
@@ -73,50 +77,75 @@ The project uses two parallel design systems:
 ## Project Structure
 
 ### Multiplatform Targets
-- **Android**: Primary target (minSdk 28, targetSdk 35)
-- **iOS**: Framework generation for iOS app (iosX64, iosArm64, iosSimulatorArm64)
+- **Android**: Primary target (minSdk 28, targetSdk 35, compileSdk 35)
+- **iOS**: Framework generation via `iosApp.xcworkspace` (iosX64, iosArm64, iosSimulatorArm64)
 
 ### Key Dependencies
-- **Compose Multiplatform**: 1.8.1
-- **Kotlin**: 2.1.20
+- **Kotlin**: 2.2.21
+- **KSP**: 2.2.21-2.0.4
+- **Compose Multiplatform**: 1.10.0
 - **Koin DI**: 4.1.0-Beta10
 - **Room Database**: 2.7.1
-- **Firebase**: Via GitLive KMP wrappers
+- **Firebase**: GitLive KMP 2.1.0 (Android BOM 33.2.0)
+- **kotlinx-coroutines**: 1.10.1
+- **kotlinx-serialization**: 1.8.1
+- **kotlinx-datetime**: 0.7.1
+- **kotlinx-immutable**: 0.3.8
+- **Datastore Preferences**: 1.1.7
+- **Napier (logging)**: 2.7.1
+- **Glance (Android Widgets)**: 1.1.1
 
 ### Package Organization
 ```
 com.chukchukhaksa.mobile/
 ├── common/
 │   ├── designsystem/         # UI components and themes
-│   ├── model/               # Shared data models
-│   └── util/                # Utility functions
-├── feature/                 # Feature modules (MVI screens)
-├── data/                    # Repository implementations
-├── domain/                  # Use cases and domain models
-└── di/                      # Dependency injection modules
+│   ├── extension/            # Kotlin extensions
+│   ├── kmp/                  # KMP platform-specific code
+│   ├── model/                # Shared data models
+│   ├── provider/             # Platform providers
+│   └── ui/                   # Common UI utilities (MviStore)
+├── data/                     # Repository implementations
+├── di/                       # Dependency injection modules
+├── domain/                   # Use cases and repository interfaces
+├── local/                    # Local data sources
+│   ├── database/             # Room database
+│   ├── datasource/           # Local data source implementations
+│   └── datastore/            # Datastore preferences
+├── presentation/             # Feature screens (MVI pattern)
+├── remote/                   # Remote data sources
+└── widget/                   # Widget support (expect/actual)
 ```
 
 ## Development Workflow
 
 ### Current Project State
 - **Main Branch**: `develop`
 - **Application ID**: `com.kunize.uswtimetable`
-- **Version**: 2.3.7 (versionCode 41)
+- **Version**: 3.0.1 (versionCode 51)
+- **Java Compatibility**: Java 17
 
 ### MVI Implementation Pattern
-Each screen follows this contract:
+Each screen follows this pattern:
 ```kotlin
-interface [Feature]Contract {
-    data class State(...)
-    sealed interface SideEffect
+// State + SideEffect definitions
+data class [Feature]State(...)
+sealed interface [Feature]SideEffect
+
+// ViewModel with MviStore delegate
+class [Feature]ViewModel(
+    private val someUseCase: SomeUseCase
+) : ViewModel(), MviStore<State, SideEffect> by mviStore(initialState) {
+    fun onAction(action: ...) { ... }
 }
-
-class [Feature]Store : MviStore<State, SideEffect>
 ```
 
+Use cases use `runCatchingIgnoreCancelled` for error handling.
+
 ### Navigation Structure
 - Feature-based navigation graphs
-- Type-safe route arguments
+- Type-safe route arguments via kotlinx.serialization (JSON encoding to URI)
+- Route object pattern with constant routes and parameterized functions
 - Nested navigation for complex flows (e.g., timetable → editor → cell editor → lecture search)
 
 ### Resource Management
@@ -132,9 +161,10 @@ class [Feature]Store : MviStore<State, SideEffect>
 ## Development Notes
 
 ### Performance Optimizations
-- Gradle configuration cache enabled
-- 4GB heap allocation for builds
+- Gradle configuration cache and build cache enabled
+- Kotlin daemon: 3GB heap / Gradle JVM: 4GB heap
 - Non-transitive R classes enabled
+- Core library desugaring enabled for Android
 
 ### Code Style
 - Kotlin official code style
@@ -144,8 +174,7 @@ class [Feature]Store : MviStore<State, SideEffect>
 
 ### Design System Usage
 When creating new UI components:
-1. Use `CCHaksaTheme` for new features
+1. Use `CchTheme` for new features
 2. Preview components in `preview/designsystem/` package
 3. Follow existing color naming conventions (100-600 scale)
 4. Prefer typography styles over hardcoded text styles
-```

composeApp/build.gradle.kts

@@ -80,8 +80,6 @@ kotlin {
       implementation(libs.kmp.firebase.crashlytics)
       implementation(libs.kmp.firebase.analytics)
       implementation(libs.napier)
-
-      implementation(libs.accompanist.systemuicontroller)
     }
     commonTest.dependencies {
       implementation(libs.kotlin.test)

composeApp/src/androidMain/kotlin/com/chukchukhaksa/mobile/common/kmp/Platform.android.kt

@@ -1,17 +1,3 @@
 package com.chukchukhaksa.mobile.common.kmp
 
-import androidx.compose.ui.graphics.Color
-import androidx.compose.runtime.Composable
-import androidx.compose.runtime.SideEffect
-import com.google.accompanist.systemuicontroller.rememberSystemUiController
-
 actual fun getPlatform(): Platform = Platform.Android
-
-@Composable
-actual fun SetStatusBarColor(){
-  val sysUiController = rememberSystemUiController()
-
-  SideEffect {
-    sysUiController.setSystemBarsColor(color = Color(0xFFFFFFFF))
-  }
-}

composeApp/src/commonMain/kotlin/com/chukchukhaksa/mobile/App.kt

@@ -1,5 +1,9 @@
 package com.chukchukhaksa.mobile
 
+import androidx.compose.animation.core.FastOutSlowInEasing
+import androidx.compose.animation.core.tween
+import androidx.compose.animation.slideInHorizontally
+import androidx.compose.animation.slideOutHorizontally
 import androidx.compose.foundation.layout.WindowInsets
 import androidx.compose.foundation.layout.asPaddingValues
 import androidx.compose.foundation.layout.navigationBars
@@ -8,6 +12,7 @@ import androidx.compose.runtime.*
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.platform.LocalUriHandler
 import androidx.compose.ui.unit.dp
+import androidx.navigation.NavGraphBuilder
 import androidx.navigation.compose.NavHost
 import chukchukhaksa.composeapp.generated.resources.Res
 import chukchukhaksa.composeapp.generated.resources.dialog_network_body
@@ -20,7 +25,6 @@ import com.chukchukhaksa.mobile.common.designsystem.component.toast.CchToast
 import com.chukchukhaksa.mobile.common.designsystem.theme.CchTheme
 import com.chukchukhaksa.mobile.common.designsystem.theme.White
 import com.chukchukhaksa.mobile.common.kmp.Platform.*
-import com.chukchukhaksa.mobile.common.kmp.SetStatusBarColor
 import com.chukchukhaksa.mobile.common.kmp.getPlatform
 import com.chukchukhaksa.mobile.common.ui.collectWithLifecycle
 import com.chukchukhaksa.mobile.presentation.timetable.navigation.timetableNavGraph
@@ -38,7 +42,6 @@ fun App(
     viewModel: MainViewModel = koinViewModel(),
     navigator: MainNavigator = rememberMainNavigator(),
 ) {
-    SetStatusBarColor()
     CchTheme {
         KoinContext {
             val uiState = viewModel.mviStore.uiState.collectAsState().value
@@ -70,11 +73,7 @@ fun App(
                 contentWindowInsets = WindowInsets(0.dp),
                 modifier = modifier,
                 content = { innerPadding ->
-                    NavHost(
-                        navController = navigator.navController,
-                        startDestination = navigator.startDestination,
-                    ) {
-
+                    val navGraphBuilder: NavGraphBuilder.() -> Unit = {
                         timetableNavGraph(
                             padding = innerPadding,
                             popBackStack = navigator::popBackStackIfNotHome,
@@ -90,6 +89,24 @@ fun App(
                         )
                     }
 
+                    when (getPlatform()) {
+                        Android -> NavHost(
+                            navController = navigator.navController,
+                            startDestination = navigator.startDestination,
+                            enterTransition = { slideInHorizontally(tween(350, easing = FastOutSlowInEasing)) { it } },
+                            exitTransition = { slideOutHorizontally(tween(350, easing = FastOutSlowInEasing)) { -it / 3 } },
+                            popEnterTransition = { slideInHorizontally(tween(350, easing = FastOutSlowInEasing)) { -it / 3 } },
+                            popExitTransition = { slideOutHorizontally(tween(350, easing = FastOutSlowInEasing)) { it } },
+                            builder = navGraphBuilder,
+                        )
+
+                        IOS -> NavHost(
+                            navController = navigator.navController,
+                            startDestination = navigator.startDestination,
+                            builder = navGraphBuilder,
+                        )
+                    }
+
                     if (uiState.showNetworkErrorDialog) {
                         CchDialog(
                             headerText = stringResource(Res.string.dialog_network_header),

composeApp/src/commonMain/kotlin/com/chukchukhaksa/mobile/common/designsystem/component/SuwikiBackground.kt

@@ -2,6 +2,7 @@ package com.chukchukhaksa.mobile.common.designsystem.component
 
 import androidx.compose.foundation.clickable
 import androidx.compose.foundation.interaction.MutableInteractionSource
+import androidx.compose.foundation.layout.Box
 import androidx.compose.foundation.layout.ExperimentalLayoutApi
 import androidx.compose.foundation.layout.MutableWindowInsets
 import androidx.compose.foundation.layout.WindowInsets
@@ -42,14 +43,19 @@ fun SuwikiBackground(
             .onConsumedWindowInsetsChanged { consumedWindowInsets ->
                 safeInsets.insets = contentWindowInsets.exclude(consumedWindowInsets)
             }
-            .padding(safeInsets.insets.asPaddingValues())
             .clickable(
                 interactionSource = remember { MutableInteractionSource() },
                 indication = null
             ) {
                 focusManager.clearFocus()
             },
     ) {
-        content()
+        Box(
+            modifier = Modifier
+                .fillMaxSize()
+                .padding(safeInsets.insets.asPaddingValues())
+        ) {
+            content()
+        }
     }
 }

composeApp/src/commonMain/kotlin/com/chukchukhaksa/mobile/common/kmp/Platform.kt

@@ -1,13 +1,8 @@
 package com.chukchukhaksa.mobile.common.kmp
 
-import androidx.compose.runtime.Composable
-
 enum class Platform {
     Android,
     IOS
 }
 
 expect fun getPlatform(): Platform
-
-@Composable
-expect fun SetStatusBarColor()

composeApp/src/commonMain/kotlin/com/chukchukhaksa/mobile/common/ui/MultipleEventsCutter.kt

@@ -1,6 +1,6 @@
 package com.chukchukhaksa.mobile.common.ui
 
-import kotlinx.datetime.Clock
+import kotlin.time.ExperimentalTime
 
 /**
  * 클릭이 지연될 시간을 정의하는 변수
@@ -17,8 +17,9 @@ internal fun MultipleEventsCutter.Companion.get(): MultipleEventsCutter =
   MultipleEventsCutterImpl()
 
 private class MultipleEventsCutterImpl : MultipleEventsCutter {
+  @OptIn(ExperimentalTime::class)
   private val now: Long
-    get() = Clock.System.now().toEpochMilliseconds()
+    get() = kotlin.time.Clock.System.now().toEpochMilliseconds()
 
   private var lastEventTimeMs: Long = 0
 

composeApp/src/commonMain/kotlin/com/chukchukhaksa/mobile/presentation/timetable/semesterselect/SemesterSelectContract.kt

@@ -3,9 +3,10 @@ package com.chukchukhaksa.mobile.presentation.timetable.semesterselect
 import com.chukchukhaksa.mobile.presentation.timetable.navigation.argument.TimetableEditorArgument
 import kotlinx.collections.immutable.PersistentList
 import kotlinx.collections.immutable.toPersistentList
-import kotlinx.datetime.Clock
 import kotlinx.datetime.TimeZone
 import kotlinx.datetime.toLocalDateTime
+import kotlin.time.Clock
+import kotlin.time.ExperimentalTime
 
 data class SemesterSelectState(
   val selectSemesterIndex: Int? = null,
@@ -17,6 +18,7 @@ sealed interface SemesterSelectSideEffect {
   data class NavigateTimetableNameInput(val semester: TimetableEditorArgument): SemesterSelectSideEffect
 }
 
+@OptIn(ExperimentalTime::class)
 val semesterList: PersistentList<Semester> = run {
   val currentYear = Clock.System.now().toLocalDateTime(TimeZone.currentSystemDefault()).year
   val semesterList = mutableListOf<Semester>()