Skip to content

Feat/ject 179 session restore - #6

Open
bess-cater wants to merge 2 commits into
developfrom
feat/JECT-179-session-restore
Open

bess-cater wants to merge 2 commits into
developfrom
feat/JECT-179-session-restore

Conversation

@bess-cater

Copy link
Copy Markdown
Collaborator

변경

Jira: JECT-179 로그인 정보 저장·앱 재시작 시 로그인 복원하기 (공통 준비)

로그인 세션을 secure storage에 저장·복원하고, 앱을 다시 켰을 때 로그인 상태에 맞는 화면으로 보낸다. 로그인 API가 아직 없어 로그인은 임시 토큰으로 한다 (workflow 3절 "서버가 아직 없을 때").

흐름

  • 앱 시작 → /splash → 저장된 세션 복원 → 있으면 /home, 없거나 읽기 실패면 /login
  • 로그인 화면 "임시 로그인" → 세션 저장 → /home
  • 마이페이지 "로그아웃" → 세션 삭제 → /login
  • 앱 재시작 후에도 마지막 상태(로그인/로그아웃) 유지

추가

  • core/storage/secure_store.dart: FlutterSecureStorage 래퍼 + 토큰 키 상수
  • features/auth/models/session.dart: 세션 모델 (freezed, 토큰이 로그에 안 찍히게 toString 생성 안 함)
  • features/auth/data/repositories/session_repository.dart: 저장·복원·삭제
  • features/auth/data/services/auth_service.dart: 임시 고정 토큰. 로그인 API가 나오면 이 파일만 실제 호출로 교체
  • features/auth/data/dto/token_dto.dart, data/repositories/auth_repository.dart: 로그인 응답 → 세션
  • features/auth/presentation/view_models/session_view_model.dart: sessionProvider (keepAlive) — 시작 시 복원, signIn(), signOut()
  • features/auth/presentation/view_models/login_view_model.dart: 로그인 명령, 중복 실행 방지
  • /splash 경로 + SplashView
  • app/router.dart: sessionRedirect + refreshListenable(세션 ref.listen)
  • app/di.dart: SecureStore, SessionRepository, AuthService, AuthRepository 등록 (lazy singleton)
  • 마이페이지 "로그아웃": 다른 기능 presentation을 import하지 않도록 라우터가 onSignOut으로 연결
  • 디버그 로그(디버그 빌드만, 토큰 없음): [session] 복원·로그인·로그아웃, [login] 버튼·실패, [router] 이동
  • 문서: mobile-architecture.md (redirect 규칙, /splash, 임시 로그인), AGENTS.md·overview.md "아직 안 한 것"에서 세션 복원 제거

검증

  • 앱 (apps/mobile): dart format · flutter analyze · check_imports · flutter test (56개) · build_runner 생성 파일 최신 — 통과
  • 새 테스트
    • 저장소: 없음 → null / 저장 → 그대로 복원 / refresh 없이 저장하면 이전 refresh 삭제 / 삭제 → null
    • 세션 상태: 시작 시 복원 / 없음 → null / 로그인 → 상태·저장소 반영 / 로그아웃 → 상태·저장소 삭제
    • 로그인 명령: 성공 → 세션 생김 / 로그인 중 재탭 무시 / 실패 → 오류 상태, 세션 없음
    • redirect 규칙: 읽는 중 → 스플래시 / 로그인 안 됨 → 로그인 / 복원 실패 → 로그인 / 로그인 됨 → 홈
    • 앱 전체: 세션 있음 + 재시작 → 홈 / 없음 + 재시작 → 로그인 / 로그인 버튼 → 홈, 재시작해도 홈 / 로그아웃 → 로그인, 재시작해도 로그인
  • 기존 app_test·main_shell_test는 빈/로그인된 가짜 저장소를 넣도록 수정
  • 시뮬레이터·실기기 수동 확인 및 디버그 로그 확인은 아직

UI 캡처

로그인 화면에 "임시 로그인" 버튼, 마이페이지에 "로그아웃" 버튼 추가 (임시 UI). 캡처 첨부 예정

호환성·주의

  • 공통 변경: DI 등록 추가, 라우팅(첫 화면이 /login → /splash, 인증 redirect), 모델(Session) — 사전 공유 필요
  • 로그인은 임시: 누구나 "임시 로그인"으로 들어간다. 로그인 API 연동 전까지 스토어 배포 빌드에 나가면 안 된다
  • 로그아웃 버튼은 임시 위치(마이페이지). 설정 화면이 생기면 그쪽으로 옮긴다
  • 아직 없는 것: 실제 소셜 로그인, 토큰 유효성 확인·401 갱신, API 요청에 토큰 붙이기, 온보딩 미완료 → 온보딩 분기
  • 첫 커밋에 Flutter가 만든 iOS CocoaPods 파일(Podfile, Debug/Release.xcconfig의 #include?)이 같이 들어갔다. 플러그인(secure storage 등) iOS 빌드에 필요한 파일이지만 이 Task와는 별개라 확인 부탁

리뷰 순서

  1. 진입점: apps/mobile/lib/app/router.dart (sessionRedirect, refreshListenable), app/routes.dart (/splash)
  2. 상태·요청: features/auth/presentation/view_models/session_view_model.dart → login_view_model.dart → data/repositories/session_repository.dart → auth_repository.dart → data/services/auth_service.dart → core/storage/secure_store.dart
  3. 실패 방어: 복원 실패 → 로그인 처리(sessionRedirect), 로그인 중복 탭 무시·실패 상태(login_view_model.dart)
  4. 화면: features/auth/presentation/views/login_view.dart, splash_view.dart, features/my_page/presentation/views/my_page_view.dart
  5. 테스트: test/app/router_test.dart, test/features/auth/**, test/app/app_test.dart, test/app/main_shell_test.dart

새 문구

  • 로그인 화면 버튼: 임시 로그인 (임시)
  • 마이페이지 버튼: 로그아웃
  • 로그인 화면 제목: 로그인

작성자 체크 (docs/pr-checklist.md A절)

  • A1 형식: 브랜치·커밋·PR 제목 규칙, PR 하나 = Task 하나
  • A2 자동 검증: 앱 format·analyze·check_imports·test / 웹 format·lint·typecheck·test·build·build:dev 전부 통과 (앱·웹 파일이 바뀐 PR이면 CI도 같은 검사) — 웹 변경 없음
  • A3 구조: 파일이 규칙 위치에 있고, features→app·다른 기능 내부 import 없음, 미래용 코드 없음
  • A4 명령: 쓰기 요청은 버튼→ViewModel, 중복 실행 방지, 서버 판단을 화면에서 확정하지 않음 (해당 시)
  • A5 화면 상태: 로딩·빈·실패·정상 전부 있고 공통 위젯 사용 (해당 시) — 로그인 실패 문구 UI 없음 (임시 로그인은 실패하지 않음, 실제 로그인 때 추가)
  • A6 토큰: hex·Colors.*·숫자 크기 없음. 토큰 변경은 앱·웹·문서 함께
  • A7 재사용: 공통 위젯이 있으면 그것을 씀 — 공통 버튼 위젯(AppButton) 아직 없어 Material 버튼 사용
  • A8 문구: 오류 문구 "무엇이+어떻게", 버튼은 동사, 용어 통일, 탭 영역 44
  • A9 데이터: 토큰·개인정보가 로그·URL·분석·prefs에 없음. env·routes 한 곳 — 토큰은 secure storage만, 로그에 토큰 없음
  • A10 테스트: 같은 경로, 4케이스, 뒤집으면 실패, 문구 고정·고정 sleep 없음 — 흐름 테스트 일부가 버튼 문구(임시 로그인·로그아웃)로 찾는다. 문구 고정 규칙에 어긋나 Key로 바꿀 예정
  • A11 생성 파일·lock 같이 커밋 (해당 시) — session.freezed.dart, token_dto.g.dart
  • A12 수동 확인: 시나리오 실행, 캡처 첨부 — 캡처 첨부 예정
  • A13 사전 공유 (공통 변경 시) — DI·라우팅·모델 변경 공유 필요

리뷰어 체크 (docs/pr-checklist.md B절)

  • B1 진입점 → B2 상태·요청 → B3 실패 방어 → B4 테스트 순으로 읽음
  • B5 일관성: 기존 비슷한 화면과 여백·빈 화면·문구 톤이 같음
  • B6 범위: 관계없는 변경이 섞이지 않음
  • 코멘트는 [must]/[nit] 접두사와 근거 절 번호

@bess-cater
bess-cater requested a review from beomq November 17, 2026 11:52
@coderabbitai

coderabbitai Bot commented Nov 17, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 99273132-479e-4aae-a739-e75cdab25aa5

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant