baron-sso/docs/trouble-shooting/issue-269-test-scenarios.md

Issue #269 테스트 시나리오

목적

/{locale}/ 라우팅 도입 이후 query parameter 유실 회귀를 방지합니다.

범위

• UserFront locale 경로 보정 (buildLocalizedPath)
• 비로그인 redirect 경로 생성 (buildSigninRedirectPath)
• locale 지원 목록 동기화 (assets/translations/*.toml -> LocaleRegistry)

테스트 시나리오

S1. locale 보정 시 기본 query 보존

• 입력: /signin?redirect_uri=https://example.com
• 기대: /ko/signin?redirect_uri=https://example.com

S2. locale 보정 시 raw query 순서/중복 key 보존

• 입력: /signin?a=1&a=2&redirect_uri=https%3A%2F%2Fexample.com%2Fcb%3Fx%3D1%26y%3D2
• 기대: /ko/signin?a=1&a=2&redirect_uri=https%3A%2F%2Fexample.com%2Fcb%3Fx%3D1%26y%3D2

S3. locale 보정 시 fragment 보존

• 입력: /signin?notice=qr_login_required#auth
• 기대: /ko/signin?notice=qr_login_required#auth

S4. unknown 2-letter prefix 오인 제거

• 입력: /zz/signin
• 기대: /ko/zz/signin

S5. 비로그인 redirect에서 query 없음

• 입력: locale=ko, uri=/ko/profile
• 기대: /ko/signin

S6. 비로그인 redirect에서 query 전체 보존

• 입력: locale=ko, uri=/ko/profile?a=1&a=2&redirect_uri=https%3A%2F%2Fexample.com%2Fcb%3Fx%3D1%26y%3D2&notice=qr_login_required
• 기대: /ko/signin?a=1&a=2&redirect_uri=https%3A%2F%2Fexample.com%2Fcb%3Fx%3D1%26y%3D2&notice=qr_login_required

S7. locale 목록 하드코딩 제거 검증

• 입력: asset 목록 (assets/translations/en.toml, assets/translations/ko.toml, assets/translations/template.toml, 기타 invalid 파일)
• 기대:
  • template.toml 제외
  • 유효 locale 파일(en.toml, ko.toml)만 지원 목록에 반영

S8. 실계정 비밀번호 변경 스모크(E2E)

• 목적: 로그인 상태 플로우가 기존 동작을 깨지 않았는지 확인
• 절차:
  • Kratos Admin API로 임시 계정 생성(초기 비밀번호 포함)
  • 구 비밀번호 로그인 성공 확인
  • Settings API로 비밀번호 변경
  • 구 비밀번호 로그인 실패 확인
  • 신 비밀번호 로그인 성공 확인
  • 테스트 계정 삭제(정리)
• 기대:
  • 비밀번호 변경 전/후 인증 결과가 정확히 반전
  • 테스트 종료 후 identity 삭제 완료(잔존 계정 없음)

실행 방법

cd userfront
flutter test test/locale_utils_test.dart
flutter test test/locale_registry_test.dart
flutter test test/router_redirect_widget_test.dart
flutter test --platform chrome test/locale_utils_test.dart test/locale_registry_test.dart test/router_redirect_widget_test.dart

자동화 매핑

• userfront/test/locale_utils_test.dart
  • S1~S6 전부 커버
• userfront/test/locale_registry_test.dart
  • S7 커버
• userfront/test/router_redirect_widget_test.dart
  • 로그인/비로그인 redirect 동작 검증(redirect_uri, redirect_url)

최근 실행 결과

• 실행일: 2026-02-19
• 결과:
  • Flutter 테스트(VM): 통과
  • Flutter 테스트(Chrome): 통과
  • S8 실계정 E2E: 통과
    • login_old_password=200
    • change_password=200
    • login_old_after_change=400
    • login_new_after_change=200
    • cleanup(delete identity)=204