ADR-U-011

1. 기본 정보

• ADR ID: ADR-U-011
• 제목: 모드 구분 및 초기 진입 화면 규칙
• 상태: Accepted
• 작성일: 2026-03-08
• 작성자: YSY
• 관련 ADR: ADR-P-005, ADR-U-010

2. 배경 (Context)

• 앱은 사용자 모드와 파트너 모드를 모두 제공한다.
• 모드 구분은 필요하지만, 최초 실행에서 진입 장벽을 만들면 탐색 전환이 저하된다.
• 마지막 화면 복원 정책이 없으면 진입 경험이 매번 달라지고 UX 일관성이 깨진다.

3. 결정 (Decision)

• 앱은 사용자 모드와 파트너 모드를 구분해 유지한다.
• 내비게이션 상태에 마지막 모드/마지막 화면 정보를 저장한다.
• 마지막 화면 정보가 없는 경우(최초 실행 또는 저장값 없음), 기본 진입 화면은 탐색 화면으로 고정한다.
• 파트너 라우트 접근 시 권한이 없으면 파트너 등록 흐름으로 리다이렉트한다.
• 비로그인 상태에서도 탐색 화면 진입은 허용한다.

4. 대안 (Alternatives Considered)

대안 A: 최초 실행 시 프로필(로그인) 화면 고정 진입

• 장점: 인증 유도 단순화
• 단점: 탐색 전 이탈 증가, ADR-P-005와 충돌
• 미채택 이유: 지연 인증 정책 위반

대안 B: 모드 구분 없이 단일 라우팅 구조 유지

• 장점: 구현 단순
• 단점: 파트너 기능 경계 불명확, 권한 처리 혼선
• 미채택 이유: 운영/권한 정책과 맞지 않음

5. 결과 (Consequences)

긍정적 결과

• 최초 실행 UX가 단순해지고 탐색 진입이 빨라진다.
• 모드 구분과 권한 경계가 명확해진다.
• 마지막 화면 복원 규칙으로 재진입 일관성이 높아진다.

부정적 결과

• 내비게이션 상태 저장/복원 로직 유지 비용이 발생한다.
• 잘못된 저장값 대응(무효 경로, 권한 변경) 처리 필요성이 생긴다.

6. 영향 범위 (Impact)

• 앱 루트 라우팅(app/_layout.tsx)의 초기 진입/리다이렉트 로직
• 모드 전환 UX(사용자 ↔ 파트너)
• 인증 게이팅과 결합된 라우팅 분기

7. 재검토 조건 (Revisit Conditions)

• 최초 실행 후 탐색 진입률이 목표 대비 하락할 때
• 파트너 모드 진입 실패/오진입 비율이 증가할 때
• 라우팅 복원 오류(무한 리다이렉트, 잘못된 화면 진입)가 반복될 때

Buy me a coffee