القائمة
Toss Sandbox 실기기 테스트에서 Metro 서버 연결, 진입 스킴 입력, authorizationCode 기반 로그인 검증을 수행한다. 사용자가 "Sandbox에서 스킴 뭐 입력해", "Metro 어떻게 연결해", "실기기 로그인 테스트 절차"를 물을 때 사용한다.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Toss Mock 인증 스킬 — stable userKey 설정, survey 루프 근본 원인 진단, adb 기반 진단 순서를 표준화한 스킬.
Toss IAP 검증 스킬 — Edge Function 404 우회, Service Role 감지, mTLS mock 설정, 토큰 헬퍼 분리, subscriptions 활성화 E2E.
Toss 수익화 운영 스킬 — Ads/IAP/TossPay 콘솔 설정, 샌드박스 시나리오, QA 증적 수집을 표준화.
AIT .ait 번들 빌드 → 콘솔 업로드 → 테스트 진입 성공 패턴. env var 인라인 실패(supabase url is required), babel/esbuild 충돌, __dirname 경로 문제 해결책 포함.
FastAPI + SQLAlchemy + Supabase 모델 작성 규칙 — DB 타입 불일치 방지, async cascade 패턴, Pydantic enum 검증. 2026-05-19 E2E 테스트(Wave 1~9)에서 발견한 BUG-01~05 재발 방지 지침.
TaillogToss 로컬 개발 서버(Metro + FastAPI) 시작/재시작 절차. "서버 켜줘", "서버 재시작", "앱 안됨", "번들 안됨" 등 서버 기동 관련 모든 상황에 사용한다.
| name | toss-sandbox-metro |
| description | Toss Sandbox 실기기 테스트에서 Metro 서버 연결, 진입 스킴 입력, authorizationCode 기반 로그인 검증을 수행한다. 사용자가 "Sandbox에서 스킴 뭐 입력해", "Metro 어떻게 연결해", "실기기 로그인 테스트 절차"를 물을 때 사용한다. |
intoss://{serviceName}serviceName: taillog-appintoss://taillog-app근거:
intoss://{serviceName} 형식taillog-app (granite.config.ts, src/_app.tsx)npm run dev 실행.adb reverse tcp:8081 tcp:8081adb reverse tcp:5173 tcp:5173intoss://taillog-app 입력 후 진입.intoss-private:// 방식 사용.login-with-toss 200 + 앱 내 온보딩/대시보드 가드 진입sb-request-id, edge log 200toss-disconnect 200login-with-toss가 WORKER_ERROR(500):
TOSS_MTLS_MODE=real일 때 TOSS_CLIENT_CERT_BASE64, TOSS_CLIENT_KEY_BASE64 누락 여부 확인[Apps In Toss Plugin] 플러그인 옵션이 올바르지 않습니다:
granite.config.ts의 appsInToss({ brand }) 값 점검brand.icon은 null 불가, 문자열이어야 함 ('' 가능)intoss://taillog-app 오탈자 확인{serviceName}도 동일하게 변경GraniteModule could not be found:
granite.config.ts에 appsInToss() 플러그인 포함 여부 확인src/_app.tsx가 AppsInToss.registerApp(...)를 사용하는지 확인/_404::screen만 반복:
/_404를 /login으로 normalize)pages/_404.tsx에서 /login 리다이렉트 처리 여부 확인adb reverse tcp:8081 tcp:8081 재실행 (Metro 번들링)@router.get("/") 형태면 FE 경로에 trailing slash 필수/api/v1/subscription → /api/v1/subscription/[FE-BE] backend fallback to supabase [TypeError: Network request failed]:
0.0.0.0:8000으로 열었는지 확인 (uvicorn app.main:app --host 0.0.0.0 --port 8000)0.0.0.0으로 바인딩 → resolveBackendUrl()이 127.0.0.1:8000 반환 → 실기기에서 127.0.0.1은 기기 자신 → 연결 실패adb reverse tcp:8000 tcp:8000 → Address already in use 빈발로 불안정adb reverse tcp:18000 tcp:8000 우회 + EXPO_PUBLIC_BACKEND_URL env → Granite이 EXPO_PUBLIC_* env를 번들에 인라인하지 않아 실패backend.ts resolveBackendUrl()에서 __DEV__ + loopback 감지 시 DEV_LAN_BACKEND_URL(PC Wi-Fi LAN IP + :8000)로 직접 연결ipconfig | grep IPv4 → Wi-Fi 어댑터 IP 사용 (WSL/Hyper-V IP 제외)backend.ts의 DEV_LAN_BACKEND_URL 상수만 수정netsh advfirewall firewall add rule name="FastAPI 8000" dir=in action=allow protocol=tcp localport=8000)[FE-BE] backend fallback 미발생 + Uvicorn에 기기 IP(172.30.1.x)에서 /api/v1/... 요청 로그 유입아래 순서를 만족하면 Sandbox 실기기 로그인 성공 패턴으로 본다.
/login::screen 노출LOG [AUTH-001] appLogin referrer SANDBOX/onboarding/welcome::screen 이동login-with-tossv11POST 200f52019d7-0162-48bf-b021-de8bc80539de92de76c2-abaa-4d8c-81cc-3e7329fe6d21FunctionsFetchError: 클라이언트 환경변수/네트워크 점검FunctionsHttpError + AUTH_LOGIN_FAILED: Edge 내부 원인 파싱(upstreamMessage) 확인TypeError ... split of undefined: Edge 응답 래퍼({ ok, data }) 언랩 누락 여부 확인referrer는 대문자/소문자 변환 없이 appLogin() 반환값을 그대로 전달login-with-toss는 verify_jwt=false 유지Deno.createHttpClient({ cert, key }) 우선, 필요 시 certChain/privateKey 폴백