[Refactor] SwiftUI기반 네비게이션 마이그레이션

[JinUng41]

PULL REQUEST

📄 작업 내용

• Login/User/Home/Search/Concert/Setlist/Song 7개 Feature의 화면 전환을 UIKit Coordinator에서 SwiftUI NavigationStack + Router로 전환
• 다른 Feature로 진입(Home/Search → Concert) 시 화면 stack 하나로 통합
• 구 *Coordinator 클래스 5개, EnvironmentValues 5개, *ContentView 래퍼 4개, 자식 ConcertCoordinator 1개 제거
• *CoordinatorView 5개 새로 선언 (Login/User/Home/Search/Concert는 stack 없이 부모와 공유)
• 모달은 각 화면에서 .sheet(isPresented:) / .fullScreenCover(isPresented:)로 자체 처리
• docs/rules/architecture.md의 화면 전환 규칙을 새 패턴으로 갱신

💻 주요 개선 사항

1. UIKit 의존성 제거

• SwiftUI 화면을 UIKit에 감싸던 UIViewControllerRepresentable 래퍼 5개와 UINavigationControllerDelegate 기반 tab bar 숨김 로직을 모두 제거.
• ConcertCoordinator에서 SwiftUI 화면을 UIHostingController로 감싸던 코드(buildViewController)도 제거. SwiftUI 네이티브 API만 사용.

2. 코드 감소

• 화면 전환 인프라(UIKit Coordinator + EnvironmentValues + ContentView) 일괄 제거로 UIKit → SwiftUI 전환에도 코드 양이 감소.
• navigation 인프라 변경: -993줄 / +581줄 = 약 -412줄 순감. 예: HomeContentView(105줄), HomeCoordinator(133줄), ConcertCoordinator(118줄), UserCoordinator(97줄) 등 UIKit 의존 클래스가 통째로 삭제됨.

3. 자식 화면 (Concert) 패턴

Concert 6개 view에서 concertCoordinator 환경 의존 제거. onTicketSiteReturn 메커니즘을 init 클로저로 변경하여 3개 자식 view에 전달.

3-1. 왜 자식 화면(Concert)은 stack 없이 CoordinatorView + 선언형 NavigationLink인가

WWDC22 "The SwiftUI cookbook for navigation" 세션을 통해 NavigationLink(value:)로 넘긴 값이 가장 가까운 NavigationStack의 path에 추가된다는 것을 학습. 별도 stack 없이 부모의 NavigationStack에 자연스럽게 push됨.

해결

stack 없이 ConcertCoordinatorView만 두고, 선언형 NavigationLink(value:) 채택.

장점:

1. 중첩 회피: stack 하나로 통일. 뒤로 가기가 한 stack에서 자연스럽게 동작.
2. 하나의 뒤로 가기 흐름: Home → Concert → Setlist → Song 의 back이 부모 stack의 단계별 pop으로 이어짐.
3. 모듈 간 연결 (SetlistDetailContainerView): SetlistFeature는 ConcertRoute를 import하지 못하므로 closure 인터페이스(onPlaySong) 유지. ConcertFeature의 wrapper가 @State pendingSong + .navigationDestination(item:)로 부모 stack에 push. 모듈 독립성 유지.
4. 선언형 navigation: NavigationLink(value:)가 view body에 선언되어 화면 전환 관계가 한눈에 보임.

7. 화면 전환 흐름 (Concert 진입)

sequenceDiagram
    actor User
    participant HomeView
    participant HomeRouter
    participant NavStack as Home NavigationStack
    participant ConcertCoord as ConcertCoordinatorView (view-only)
    participant ConcertView
    participant SetlistContainer as SetlistDetailContainerView
    participant SetlistView

    User->>HomeView: 콘서트 카드 탭
    HomeView->>HomeRouter: homeRouter.push(.concertDetail(id:1))
    HomeRouter->>NavStack: path.append(.concertDetail)
    NavStack->>ConcertCoord: navigationDestination(for: HomeRoute) → case .concertDetail
    ConcertCoord->>ConcertView: root view 렌더링

    Note over ConcertCoord: Router 없음, NavigationStack 없음<br/>navigationDestination(for: ConcertRoute) 등록

    User->>ConcertView: setlist 카드 탭
    ConcertView->>NavStack: NavigationLink(value: .setlistDetail)
    NavStack->>ConcertCoord: case .setlistDetail 매칭
    ConcertCoord->>SetlistContainer: 렌더링
    SetlistContainer->>SetlistView: onPlaySong 클로저 전달

    User->>SetlistView: 곡 탭
    SetlistView->>SetlistContainer: onPlaySong(song) → pendingSong = song
    SetlistContainer->>NavStack: .navigationDestination(item: $pendingSong) → SongLyricsView
    NavStack->>SetlistView: pop (back)
    User->>ConcertView: back → NavStack: pop → HomeView

Loading

📚 참고자료

• Apple Developer — The SwiftUI cookbook for navigation (WWDC22)
• 이번 브랜치에서 작성/보관된 문서
  • docs/archives/adr-001-navigationstack-migration.md
  • docs/archives/LIVD-425-login-navigationstack-migration.md
  • docs/archives/LIVD-425-user-navigationstack-migration.md
  • docs/archives/LIVD-425-concert-setlist-song-navigationstack-migration.md
  • docs/archives/LIVD-425-home-navigationstack-migration.md
  • docs/archives/LIVD-425-search-navigationstack-migration.md

👀 기타 더 이야기해볼 점

• 알림 수신 후 특정 화면으로 진입하는 시나리오만 점검부탁드립니다. (딥링크 처리)

🔗 연결된 이슈

• Resolved: LIVD-425

[linear]

LIVD-425