refactor(mindrecord): Navigation 3 파일럿을 전체 entry 계약으로 확장 #1697

작업 유형

refactor — 동작 변경 없는 구조·책임·경계 개선

주 담당 모듈

mindrecord — 마음의 기록

개요

배경

#959는 마음의 기록 허브 안의 단순 push/pop을 Navigation 3 로컬 스택으로 옮기는 파일럿이다. 하지만 루트 Nav3 전환 준비로는 범위가 부족하다. #959가 명시적으로 Nav2에 남긴 Route.MemorySpace·Route.ReceiverMindRecord와 이후 추가된 RecordDetailRoute, 외부 진입 초기 스택 계약까지 Nav3 entry 경계로 완성해야 한다.

현재 전체 destination은 MindRecordNavGraph에 함께 등록되어 있다. 이 이슈는 파일럿 결과를 폐기하지 않고 전체 마음의 기록 진입 계약으로 확장한다.

범위

• #959에서 만든 허브 로컬 NavDisplay·entry·decorator 계약을 기준으로 삼는다.
• Route.MemorySpace, Route.ReceiverMindRecord, MindRecordRoute.RecordDetailRoute를 포함해 마음의 기록 소유 destination 전체를 Nav3 entry 계약으로 옮긴다.
• 홈 CTA, 수신자 경로 등 허브를 거치지 않는 외부 진입은 필요한 초기 Nav3 back stack을 명시적으로 구성한다.
• 작성·상세·임시저장 사이의 route 인자와 ViewModel 생성 경로를 key 직접 주입 방식으로 통일한다.
• 로컬 스택 바닥의 back, 외부 진입의 종료 목적지, 바텀바 표시 상태를 앱 셸과의 최소 boundary 계약으로 노출한다.
• 탭 이탈·복귀, 프로세스 재생성, entry 제거 시 ViewModel clear, predictive back을 검증한다.

완료 조건

1. #959의 완료 조건과 predictive back 실기기 검증이 먼저 충족된다.
2. 마음의 기록 소유 destination이 더 이상 루트 Nav2의 개별 composable 등록에 의존하지 않는다.
3. 허브 내부 진입과 MemorySpace·ReceiverMindRecord 직접 진입이 각각 올바른 초기 스택과 back 종료 동작을 가진다.
4. RecordDetailRoute를 포함한 route 인자와 ViewModel 주입이 타입 안전한 Nav3 key 계약으로 동작한다.
5. 탭 복원·프로세스 재생성·ViewModel 수명·predictive back 기준을 자동 테스트와 필요한 수동 QA로 통과한다.
6. 관련 유닛·Robolectric·androidTest 및 :app:compileDebugUnitTestKotlin이 통과한다.
7. #1702가 소비할 entry/boundary 계약을 이슈 또는 코드 문서에 남긴다.

의존성과 경계

• blocked_by #959 — 파일럿 결과와 구현 함정을 먼저 확정한다.
• 앱 루트 NavHost → NavDisplay 교체와 다른 피처 이관은 이 이슈 범위가 아니다.
• #1087의 presentation 패키지 이관과 파일 이동이 겹칠 수 있으므로 착수 시 최신 head와 경로를 기준으로 조정한다.
• #1311의 단순 back 명령 통합은 이미 완료된 선행 상태로 취급한다.
• 앱링크·FCM 목적지 처리는 각각 #924·#1111에서 계속 추적한다.

자식 이슈

No response

참고

• #1702가 소비하는 마음의 기록 entry·boundary 계약이다.
• 파일럿: 마음의 기록 허브를 Navigation 3 로컬 스택으로 — #1697 파일럿 #959
• 공식 마이그레이션 가이드: https://developer.android.com/guide/navigation/navigation-3/migration-guide