Merge pull request #10 from taetae98coding/develop

1.8.2

Author: taetae98coding

.claude/docs/clock-convention.md

@@ -8,6 +8,12 @@
 - UseCase, Repository, DataSource 등 시간을 다루는 모든 레이어에 적용된다.
 - 타임스탬프가 필요한 경우: `clock.now().toEpochMilliseconds()`.
 
+### 예외: Compose 레이어
+
+- Composable, `remember*` 함수, ScaffoldState 등 **Compose 레이어**에서는 `Clock.System` 직접 사용을 허용한다.
+- 이유: Composable/`remember*` 시그니처에 `Clock`을 강제 주입하면 호출부 부담이 커지고, UI 상태 초기값에 사용되는 현재 시각은 테스트 결정성보다 호출 시점의 자연스러운 사용성이 더 중요하다.
+- 대신 Compose 레이어가 호출하는 ViewModel/UseCase/Repository는 컨벤션을 지킨다.
+
 ### 이유
 
 - 테스트에서 시간을 고정할 수 있어야 TC가 결정론적으로 동작한다.

.gitignore

@@ -22,4 +22,7 @@ xcuserdata/
 
 # Google
 google-services.json
-GoogleService-Info.plist
+GoogleService-Info.plist
+
+# SPM
+exportedKMP*/

CLAUDE.md

@@ -17,6 +17,13 @@ Kotlin Multiplatform 일기/메모 앱 (Android, iOS, JVM, WASM).
 
 ProjectGuard로 강제한다. domain은 data/feature를 알 수 없고, feature는 data를 직접 참조할 수 없다.
 
+## 의존성 추가 규칙
+
+- **코드 최소화**: 상위 의존성으로 transitively 포함되는 의존성은 명시적으로 추가하지 않는다.
+  - 예: `compose-material3` 추가 시 `compose-foundation`, `compose-ui`는 transitive로 함께 적용되므로 별도로 추가하지 않는다.
+- **범위 최소화**: 실제 사용하는 최소 범위의 의존성만 추가한다.
+  - 예: `compose-runtime`만 필요하면 `compose-runtime`만 추가한다. `compose-ui`, `compose-foundation` 등 상위 의존성은 추가하지 않는다.
+
 ## 공통 컨벤션
 
 - Clock 주입: @.claude/docs/clock-convention.md

Diary/Diary.xcodeproj/project.pbxproj

@@ -315,7 +315,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 1.8.1;
+				MARKETING_VERSION = 1.8.2;
 				OTHER_LDFLAGS = "";
 				PRODUCT_BUNDLE_IDENTIFIER = io.github.taetae98coding.diary.dev;
 				PRODUCT_NAME = "$(TARGET_NAME)";
@@ -413,7 +413,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 1.8.1;
+				MARKETING_VERSION = 1.8.2;
 				OTHER_LDFLAGS = "";
 				PRODUCT_BUNDLE_IDENTIFIER = io.github.taetae98coding.diary;
 				PRODUCT_NAME = "$(TARGET_NAME)";
@@ -518,7 +518,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 1.8.1;
+				MARKETING_VERSION = 1.8.2;
 				OTHER_LDFLAGS = "";
 				PRODUCT_BUNDLE_IDENTIFIER = io.github.taetae98coding.diary;
 				PRODUCT_NAME = "$(TARGET_NAME)";

app/android/dependencies/realReleaseRuntimeClasspath.txt

@@ -50,6 +50,7 @@ kotlin {
                 implementation(projects.feature.routine)
                 implementation(projects.feature.tag)
                 implementation(projects.library.navigation3Runtime)
+                implementation(projects.logger.analytics.api)
                 implementation(libs.jetbrains.compose.material3.navigation.suite)
                 implementation(libs.jetbrains.navigation3.ui)
                 implementation(libs.coil.compose)

app/shared/build.gradle.kts

@@ -12,6 +12,7 @@ import androidx.navigation3.scene.Scene
 import androidx.navigation3.scene.SinglePaneSceneStrategy
 import androidx.navigation3.ui.NavDisplay
 import androidx.navigationevent.NavigationEvent
+import io.github.taetae98coding.diary.app.shared.navigation3.rememberAnalyticsNavEntryDecorator
 import io.github.taetae98coding.diary.app.shared.navigation3.rememberRetainedValuesStoreNavEntryDecorator
 import io.github.taetae98coding.diary.feature.calendar.calendarEntry
 import io.github.taetae98coding.diary.feature.login.loginEntry
@@ -32,6 +33,7 @@ internal fun AppNavigation(
             rememberSaveableStateHolderNavEntryDecorator(),
             rememberRetainedValuesStoreNavEntryDecorator(),
             rememberViewModelStoreNavEntryDecorator(),
+            rememberAnalyticsNavEntryDecorator(),
         ),
         sceneStrategies = listOf(
             DialogSceneStrategy(),

app/shared/src/commonMain/kotlin/io/github/taetae98coding/diary/app/shared/AppNavigation.kt

@@ -0,0 +1,32 @@
+package io.github.taetae98coding.diary.app.shared.navigation3
+
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.remember
+import androidx.lifecycle.Lifecycle
+import androidx.lifecycle.compose.LifecycleEventEffect
+import androidx.navigation3.runtime.NavEntryDecorator
+import io.github.taetae98coding.diary.logger.analytics.api.AnalyticsLogEntry
+import io.github.taetae98coding.diary.logger.core.DiaryLogger
+
+internal class AnalyticsNavEntryDecorator<T : Any> :
+    NavEntryDecorator<T>(
+        decorate = { entry ->
+            val screenName = entry.contentKey::class.simpleName.orEmpty()
+
+            LifecycleEventEffect(Lifecycle.Event.ON_RESUME) {
+                DiaryLogger.log(
+                    AnalyticsLogEntry(
+                        name = "screen_view",
+                        params = mapOf("screen_name" to screenName),
+                    ),
+                )
+            }
+
+            entry.Content()
+        },
+    )
+
+@Composable
+internal fun <T : Any> rememberAnalyticsNavEntryDecorator(): AnalyticsNavEntryDecorator<T> {
+    return remember { AnalyticsNavEntryDecorator() }
+}

app/shared/src/commonMain/kotlin/io/github/taetae98coding/diary/app/shared/navigation3/AnalyticsNavEntryDecorator.kt

@@ -8,7 +8,7 @@ import androidx.navigation3.ui.defaultPredictivePopTransitionSpec
 import androidx.navigation3.ui.defaultTransitionSpec
 import androidx.navigationevent.NavigationEvent
 
-internal actual fun <T : Any> platformTransitionSpec(state: io.github.taetae98coding.diary.app.shared.AppState): androidx.compose.animation.AnimatedContentTransitionScope<androidx.navigation3.scene.Scene<T>>.() -> androidx.compose.animation.ContentTransform {
+internal actual fun <T : Any> platformTransitionSpec(state: AppState): AnimatedContentTransitionScope<Scene<T>>.() -> ContentTransform {
     return defaultTransitionSpec()
 }
 

app/shared/src/nonAppleMain/kotlin/io/github/taetae98coding/diary/app/shared/AppNavigation.nonApple.kt

@@ -18,7 +18,6 @@ kotlin {
             dependencies {
                 implementation(projects.app.shared)
                 implementation(libs.jetbrains.compose.components.resources)
-                implementation(libs.jetbrains.compose.ui)
                 implementation(libs.jetbrains.compose.material3)
             }
         }