# task-2251 완료 보고서: InsuRo 인앱 브라우저 감지 + 외부 브라우저 유도

## SCQA

**S**: InsuRo 로그인 페이지에서 Google OAuth를 통한 인증이 주요 로그인 수단으로 사용 중이다.

**C**: 카카오톡/네이버앱 등 인앱 브라우저(WebView)에서 Google 로그인 시도 시 `403 오류: disallowed_useragent`가 발생하며, 사용자는 원인을 알 수 없어 이탈한다.

**Q**: 인앱 브라우저를 감지하여 사용자를 외부 브라우저로 유도할 수 있는가?

**A**: `isInAppBrowser()` 유틸 함수로 8개 인앱 브라우저 패턴(카카오톡, 네이버, 인스타그램, 페이스북, 라인, 트위터, Android WebView)을 감지하고, 감지 시 로그인 폼 대신 "외부 브라우저에서 열어주세요" 안내 UI를 표시하도록 구현했다. Android는 Chrome intent 스킴, iOS는 클립보드 복사 방식으로 외부 브라우저 전환을 유도한다. npm run build 성공, 콘솔 에러 0건.

## 수정 파일

| 파일 | 변경 내용 | grep 검증 | 상태 |
|------|-----------|-----------|------|
| src/utils/detectInAppBrowser.ts (신규) | 인앱 브라우저 감지 유틸 함수 | grep "isInAppBrowser" OK (line 1) | verified |
| src/pages/Login.tsx | import 추가 + isInApp state + 조건부 렌더링 | grep "isInAppBrowser" OK (line 11), grep "외부 브라우저" OK (line 335) | verified |

## 산출물 파일
- /home/jay/projects/InsuRo/src/utils/detectInAppBrowser.ts
- /home/jay/projects/InsuRo/src/pages/Login.tsx

## 발견 이슈 및 해결

### 자체 해결 (1건)
1. **navigator.vendor deprecated 경고** — `detectInAppBrowser.ts`에서 `navigator.vendor` 참조 제거. userAgent만으로 인앱 브라우저 감지 충분.

## L1 스모크테스트 결과
- 서버 재시작: 성공 (Vite dev server, port 5173)
- 정상 브라우저 확인: 기존 로그인 화면 정상 표시 (스크린샷: task-2251-login-normal.png)
- 인앱 브라우저 시뮬레이션: KakaoTalk UA 설정 후 리로드 → "외부 브라우저에서 열어주세요" 안내 UI 정상 표시 (스크린샷: task-2251-login-inapp.png)
- 콘솔 에러: 0건
- 빌드 결과: 성공 (dist/ 타임스탬프 2026-04-27 19:30)
- 스크린샷:
  - /home/jay/workspace/memory/reports/task-2251-login-normal.png
  - /home/jay/workspace/memory/reports/task-2251-login-inapp.png

## 빌드 결과
- `npm run build`: 성공 (12.92s)
- dist 타임스탬프: 2026-04-27 19:30

## 검증 시나리오 결과
1. Chrome/Safari에서 접속 → 기존 로그인 화면 정상 표시 (통과)
2. 인앱 브라우저 감지 → "외부 브라우저로 열기" 안내 표시 (통과)
3. "Chrome으로 열기" 버튼 표시 확인 (Android UA 시뮬레이션) (통과)
4. "주소 복사하기" 버튼 표시 확인 (통과)
5. npm run build 성공 (통과)

## 모델 사용 기록
- 팀원: 이리스 / 작업 내용: detectInAppBrowser.ts 생성 + Login.tsx 수정 / 사용 모델: sonnet / 정당성: -

## 셀프 QC 체크리스트
- [x] 1. 영향 파일: Login.tsx, detectInAppBrowser.ts (신규) — 다른 파일 영향 없음
- [x] 2. 엣지 케이스: navigator.userAgent 빈 값 시 빈 문자열 폴백, clipboard API 미지원 시 toast 안내
- [x] 3. 작업 지시와 정확히 일치
- [x] 4. 에러 처리: try-catch 불필요 (동기 함수), clipboard는 onClick 내부에서 안전
- [x] 5. 프론트엔드 전용 — Playwright 스크린샷으로 커버
- [x] 6. 발견 이슈 1건 자체 해결 (vendor deprecated)
- [x] 7. SOLID/DRY 위반 없음 — 감지 로직은 별도 유틸로 분리
- [x] 8. 인터페이스 변경 없음 (신규 유틸 + 기존 컴포넌트 조건부 렌더링)
- [x] 13. L1 스모크테스트: Playwright 스크린샷 2장 + 콘솔 에러 0건
- [x] 14. 듀얼 MCP 검증: Playwright 스크린샷 완료

## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회