docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거

Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를 Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류. - 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로 자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거, 동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거. - 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming, Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business, Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로, 나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는 title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백). 원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지. - 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서. - 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는 지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지. - Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경. - 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
2026-07-05 00:33:48 +09:00
parent 1cfd3bbb56
commit 9148c358d0
6455 changed files with 1 additions and 86875 deletions
@@ -0,0 +1,125 @@
+---
+id: android-navigation-compose
+title: Android Navigation (Compose) — 타입 안전 라우팅
+category: Coding
+status: draft
+source_trust_level: B
+verification_status: conceptual
+created_at: 2026-05-09
+updated_at: 2026-05-09
+tags: [android, navigation, compose, vibe-coding]
+tech_stack: { language: "Kotlin / Navigation-Compose 2.8+", applicable_to: ["Android"] }
+applied_in: []
+aliases: [NavController, NavGraph, type-safe routes, deep link]
+---
+
+# Android Navigation (Compose)
+
+> Navigation-Compose 2.8+ 의 **타입 안전 routes** (Kotlin Serialization). 옛 string route 시대는 끝. **NavGraph 분할 + 단방향 dependency** 가 modular 앱의 표준.
+
+## 📖 핵심 개념
+- 각 destination = `@Serializable` data class.
+- NavController.navigate(Object) — 타입 안전.
+- 인자 자동 SavedStateHandle 주입.
+- Deep link, animation, nested graph 모두 지원.
+
+## 💻 코드 패턴
+
+### 타입 안전 destination
+```kotlin
+@Serializable data object HomeRoute
+@Serializable data class ProfileRoute(val userId: String)
+@Serializable data class OrderRoute(val orderId: String, val highlight: Boolean = false)
+```
+
+### NavHost + composable
+```kotlin
+@Composable
+fun AppNav(nav: NavHostController) {
+    NavHost(navController = nav, startDestination = HomeRoute) {
+        composable<HomeRoute> {
+            HomeScreen(onUserClick = { id -> nav.navigate(ProfileRoute(id)) })
+        }
+        composable<ProfileRoute> { entry ->
+            val args = entry.toRoute<ProfileRoute>()
+            ProfileScreen(userId = args.userId, onBack = { nav.popBackStack() })
+        }
+        composable<OrderRoute> { entry ->
+            val args = entry.toRoute<OrderRoute>()
+            OrderScreen(args.orderId, args.highlight)
+        }
+    }
+}
+```
+
+### ViewModel 자동 인자 주입
+```kotlin
+@HiltViewModel
+class ProfileViewModel @Inject constructor(
+    savedState: SavedStateHandle,
+    private val repo: UserRepo,
+) : ViewModel() {
+    private val args: ProfileRoute = savedState.toRoute()
+    val userFlow = repo.observe(args.userId)
+}
+```
+
+### Nested graph (모듈)
+```kotlin
+fun NavGraphBuilder.authGraph(nav: NavController) {
+    navigation<AuthGraph>(startDestination = LoginRoute) {
+        composable<LoginRoute> { LoginScreen(onSuccess = { nav.navigate(HomeRoute) { popUpTo<AuthGraph> { inclusive = true } } }) }
+        composable<SignupRoute> { SignupScreen() }
+    }
+}
+
+@Serializable data object AuthGraph
+@Serializable data object LoginRoute
+@Serializable data object SignupRoute
+```
+
+### Deep link
+```kotlin
+composable<OrderRoute>(
+    deepLinks = listOf(navDeepLink<OrderRoute>(basePath = "https://example.com/orders"))
+) { ... }
+```
+
+URL `https://example.com/orders/123?highlight=true` → OrderRoute(orderId="123", highlight=true).
+
+### Pop / 백스택 관리
+```kotlin
+nav.navigate(HomeRoute) {
+    popUpTo<AuthGraph> { inclusive = true } // login graph 모두 pop
+    launchSingleTop = true                   // 같은 destination 재진입 안 함
+}
+
+nav.popBackStack()
+nav.popBackStack(route = HomeRoute, inclusive = false) // 특정 destination 까지 pop
+```
+
+## 🤔 의사결정 기준
+| 상황 | 권장 |
+|---|---|
+| 신규 Android Compose | navigation-compose 2.8+ + 타입 안전 routes |
+| 큰 앱 모듈화 | nested graph per feature module |
+| Deep link / 외부 호출 | deepLinks block |
+| Multi-platform (KMM) | Decompose / Voyager |
+| Tab + per-tab back stack | rememberNavController 별 또는 BottomNav + saveState |
+
+## ❌ 안티패턴
+- **String route + manual encoding**: 옛 패턴. 2.8+ 의 typed routes.
+- **모든 destination 한 NavGraphBuilder**: 거대 파일. nested graph 로 모듈 분리.
+- **navigate 후 popBackStack 잊음**: 백스택 누적.
+- **ViewModel 에 NavController 주입**: lifecycle 불일치 + 테스트 어려움. Composable 에서 callback.
+- **Activity 가 NavController 보유 + Fragment 가 별도**: 동기화 깨짐.
+- **deeplink path 안에 user id**: 인증 안 된 사용자가 직접 호출 → 권한 검증 필수.
+- **animation 무시**: 기본 fade 만 — UX 평범. enterTransition / exitTransition.
+
+## 🤖 LLM 활용 힌트
+- @Serializable data class destination + composable<Route> + entry.toRoute().
+- ViewModel 은 SavedStateHandle.toRoute() 로 인자.
+
+## 🔗 관련 문서
+- [[Android_Compose_State_Hoisting]]
+- [[Android_Modularization]]