refactor(onboarding): MVI 전환 파일럿 — ViewModel 3개 + 신호 소비를 Intent 로 #1802

2026-09-08 재작성 방지 순서

실패 사유 모델 #1863(PR #1963)을 먼저 반영한다. PR #1825의 새 reducer가 errorMessage와 hasVerificationError를 다시 고정하면 #1863에서 reducer·ObserveSignal·테스트를 재작성하므로, 단일 OnboardingFailure를 소비하는 MVI로 적응한다.

이 순서는 MVI 구현의 기능적 전제 추가가 아니라 예정된 상태 모델 재작성을 피하기 위한 선행 순서다. PR의 실제 base도 refactor/1863-onboarding-failure로 맞춘다. 기존 화면 이동과 파일럿 대상 ViewModel 3개 범위는 유지한다.

#1829의 다섯 Content 공개 범위 판단도 PR #1825에 함께 반영한다. Screen의 상태 수집·신호 소비와 Content 렌더를 파일로 분리해 실제 프로덕션 호출 범위로 internal을 정하고, 테스트 때문에 남긴 예외 baseline을 제거한다. #1802와 #1829는 같은 PR에서 닫으며 두 이슈 모두 공통 선행 #1863만 기다린다.

작업 유형

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

주 담당 모듈

onboarding — 온보딩

개요

MVI 전환 파일럿. onboarding 의 ViewModel 3개를 MviViewModel 로 옮기고, 여기서 확정된 관용구가 나머지 모듈 전환의 기준이 된다.

왜 onboarding 이 파일럿인가

대상

Consumed 신호 자체는 없애지 않는다. 일회성 이벤트를 UiState 의 nullable 필드로 흡수하는 것은 이 레포의 정본 규약(#228)이고 MVI 와 충돌하지 않는다 — 바뀌는 것은 소비 경로다. onXxxConsumed() public fun 을 따로 두지 않고 Intent.ConsumeXxx 로 접는다.

• LoginViewModel (11 fun) · SignUpViewModel (19 fun, 상태 홀더 3개) · FindIdViewModel (5 fun)
• Screen 9개, on* 콜백 53개 → Screen/Content 2단으로 재편

구현 범위

• 3개 ViewModel 을 MviViewModel<I, S, E, F> 상속으로 전환하고 onIntent 단일 진입점으로 모은다
• onXxxConsumed() public fun 3종을 Intent.ConsumeXxx 로 접는다
• 상태 전이를 reduce 한 함수로 모은다 — 코루틴 안에서 상태를 직접 쓰지 않는다
• 화면을 Screen(stateful) / Content(internal stateless) 로 나눈다
• 테스트를 두 층으로 가른다 — 리듀서 테스트는 코루틴 하네스 없이 순수 함수로, 비동기·부수효과만 ViewModel 테스트로 남긴다

완료 조건

• onboarding ViewModel 3개가 MviViewModel 상속이고 MutableStateFlow 를 직접 선언하지 않는다
• onXxxConsumed() public fun 이 0건이고, 소비가 Intent.ConsumeXxx 로 들어온다 (신호 필드 자체는 UiState 에 남는다)
• 기존 @Test 23개가 초록이거나, 옮겨진 위치에서 같은 단언을 유지한다
• konsist allowlist에서 onboarding ViewModel 3개가 빠진다
• 확정된 관용구를 docs/convention/mvi.md 에 반영한다 — 파일럿의 산출물은 코드만이 아니다

자식 이슈

No response

참고

화면 2단 분리 참조: RuleUp HomeScreen — HomeScreen(modifier, viewModel) 은 콜백 0개이고, internal fun HomeContent(state, onIntent, modifier) 가 테스트·프리뷰 진입점이다.

effect 소비 참조: RuleUp LoginScreen

네비게이션은 이 전환 범위 밖이다. 화면 콜백은 기존 방식을 유지하고 개수를 건드리지 않는다 — 목적지 결정은 Navigation 3 이관 계열이 정한다(#1810 에서 접점 판정). onboarding 은 #1789(비밀번호 찾기 3화면 배선)가 열려 있어 착수 전 충돌 여부를 확인한다.