feat: P6 모바일 셀프 조회 PWA 스캐폴드 (ga-mobile-pwa)

설계사 본인 정산명세서/출금/공지를 모바일에서 조회하는 PWA 신규 모듈.
데스크탑 admin UI(ga-frontend)와 별도. 백엔드 무변경 — 기존 ga-api(8082)
재사용. 토큰 키도 mobile.accessToken 으로 분리.

스택:
- Vite + React 18 + TS + antd-mobile@5
- vite-plugin-pwa (manifest + service worker autoUpdate)
- React Query + Zustand (persist) + react-router-dom
- 포트 3001, /api → 8082 dev 프록시

화면 5종 (NavBar + List + PullToRefresh + TabBar):
- /login         — POST /api/auth/login + GET /api/auth/me
- /              — 홈 (요약 카드 + 메뉴, 로그아웃)
- /statement     — GET /api/statements?agentId=…  (본인 명세서)
- /withdraw      — GET /api/withdraw-requests?agentId=…  (본인 출금이력)
- /notice        — GET /api/notices/active

PWA:
- manifest: name/icon/theme/standalone, ko, /
- /api/** NetworkFirst 5s 타임아웃 / 5분 캐시 (오프라인 시 직전 응답)
- 아이콘은 SVG placeholder (192/512) — 본 배포 시 PNG 권장

검증:
- npm install 407 packages
- tsc --noEmit PASS
- npm run build PASS — manifest.webmanifest + sw.js + workbox-*.js
  자동 생성, precache 8 entries 528KB, 번들 gzip 173KB
- vite dev :3001 LISTENING + ga-api :8082 정상
- /api/statements total=112, /api/withdraw-requests total=3,
  /api/notices/active 0건, /api/auth/me 정상

잔여 (스캐폴드 이후):
- 백엔드 /api/mobile/me/* 전용 endpoint (서버측 본인 필터 강제)
- 출금 신청 작성 폼, 명세서 상세, 본인 알림(user_notification)
- 토큰 만료 자동 refresh, 푸시 알림 (FCM)
- 실 아이콘 PNG, manualChunks 분리

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

HANDOFF.md

@@ -297,6 +297,61 @@ P5 전체 + P6 PoC(어댑터 모듈 + Mock 구현 + SDK 분기 + 재시도 배
 | 펌뱅킹 SETTLED 동기화 | ACCEPTED→SETTLED 폴링 스케줄 (queryStatus 사용) | 실 SDK 통합 이후 |
 | 모바일 셀프 조회 PWA | 설계사 전용. 정산 명세서/출금 신청/공지 등 | 화면 우선순위 협의 |
 
+## 3-13. P6 — 모바일 셀프 조회 PWA 스캐폴드 (ga-mobile-pwa, 2026-05-24)
+
+설계사 본인 정산명세서·출금·공지를 모바일에서 조회하는 PWA 신규 모듈. 데스크탑 admin UI(`ga-frontend`)와 별도. **백엔드 무변경** — 기존 `ga-api`(8082) 그대로 재사용.
+
+### 구성
+| 항목 | 위치 | 비고 |
+|---|---|---|
+| 신규 모듈 | `ga-mobile-pwa/` | Vite + React 18 + TS + antd-mobile@5 |
+| PWA 인프라 | `vite-plugin-pwa` | manifest + service worker autoUpdate, `/api/**` NetworkFirst(5s/5min) |
+| 인증 | `src/stores/authStore.ts` (zustand persist) | 토큰 키: `mobile.accessToken` (`ga-frontend` 와 분리) |
+| API 클라이언트 | `src/api/{request,auth,statement,withdraw,notice}.ts` | axios + 401 자동 리다이렉트 |
+| 화면 5종 | `src/pages/{Login,Home,StatementList,WithdrawList,NoticeList}.tsx` | NavBar + List/Card + PullToRefresh + TabBar |
+| 라우팅 | `src/App.tsx` + `RequireAuth` 가드 + `MobileTabBar` | `/login` 외 모두 보호 |
+
+### 화면 ↔ 백엔드 API
+| 경로 | 백엔드 |
+|---|---|
+| `/login` | POST `/api/auth/login` + GET `/api/auth/me` |
+| `/` (홈) | 세 도메인 카운트 조회 |
+| `/statement` | GET `/api/statements?agentId={me.agentId}` |
+| `/withdraw`  | GET `/api/withdraw-requests?agentId={me.agentId}` |
+| `/notice`    | GET `/api/notices/active` |
+
+본인 데이터 필터: 클라이언트에서 `profile.agentId` 를 쿼리 파라미터로 전달. 본격 운영에는 **백엔드 `/api/mobile/me/*` 전용 endpoint** (토큰 → agentId 서버측 강제 필터) 권장 — 잔여 항목.
+
+### 빌드 / 실행
+```bash
+cd ga-mobile-pwa
+npm install
+npm run dev      # http://localhost:3001 (vite dev — /api → 8082 proxy)
+npm run build    # tsc --noEmit + vite build → dist/ (manifest + sw 자동 생성)
+npm run preview  # 3001 에서 production 번들 서빙
+```
+
+### 통합 검증 (2026-05-24)
+- `npm install` 407 packages 성공
+- `tsc --noEmit` PASS (`@types/node` 추가)
+- `npm run build` PASS — `manifest.webmanifest` + `sw.js` + `workbox-*.js` 자동 생성, precache 8 entries (528 KiB), 번들 516KB(gzip 173KB)
+- 라이브: vite dev :3001 LISTENING, ga-api :8082 정상
+- API 응답 확인: `/api/statements` total=112, `/api/withdraw-requests` total=3, `/api/notices/active` 0건(정상), `/api/auth/me` 정상
+
+### 잔여 (스캐폴드 이후)
+- 백엔드 `/api/mobile/me/*` 전용 endpoint (서버측 본인 필터 강제)
+- 출금 신청 작성 폼 (현재 이력 조회만)
+- 정산 명세서 상세 + PDF 다운로드
+- 본인 알림(`user_notification`) 표시 + 토큰 만료 자동 refresh
+- 푸시 알림 (FCM 등) — 외부 채널 결정 후
+- 실 아이콘 PNG (192/512/512 maskable)
+- 번들 코드 스플리팅 (manualChunks)
+
+## 4. 잔여 작업 (P6 실연동)
+
+P5 전체 + P6 PoC(어댑터 모듈 + Mock + SDK 분기 + 재시도 + 추적 컬럼 + 호출 감사 이력 + **모바일 PWA 스캐폴드**) 완료.
+잔여는 **외부 스펙 확정** 후 적용 가능한 항목.
+
 ### 운영 DB 마이그레이션 상태
 운영 DB `192.168.0.60:55432/trading_ai/ga` 현재 **V85 적용 완료** (2026-05-24).
 V79~V85 Flyway 자동 적용 확인. ga-api 8082 가동 중.
@@ -354,7 +409,7 @@ V79~V85 Flyway 자동 적용 확인. ga-api 8082 가동 중.
 3. **HANDOFF.md 읽기**: 본 문서 + 최근 git log로 컨텍스트 확보
 4. **운영 DB 상태**: **V85 적용 완료**. ga-api 8082 가동 중 (필요 시 `python verify_v74.py` / `smoke_v78.py` 재실행)
 5. **권장 시작 지점 (외부 스펙 미정 시)**:
-   - 모바일 셀프 조회 PWA 스캐폴드 (화면 우선순위 협의)
+   - 모바일 PWA 후속: 백엔드 `/api/mobile/me/*` 전용 endpoint, 출금 신청 폼, 명세서 상세
    - 펌뱅킹 SETTLED 동기화 폴러 (Mock 검증 → 실 SDK 통합 시 가치)
    - 알림 채널 SMS phone 매핑 보강 (현재 user.phone 미설정 시 SMS skip — phone 등록 화면)
 6. **사용자 결정 필요 항목 (P6 실연동 차단 사유)**: