🗺️ [wayfinder] 백그라운드 잡 UX — TryOn+StyleDNA 장기 실행 (progress·완료·복귀·간섭제약)

[thxforall]

Destination

TryOn(VTON) + StyleDNA 장기 실행을 백그라운드로 돌릴 수 있는 통합 잡 UX의 spec-ready 결정 세트 — 아키텍처 결정(공유 vs per-feature · 잡 소유 · transport · 영속성 · 동시성/간섭 정책) + prototype으로 잠근 progress·완료·복귀 UX. 결정+프로토타입이 서면 /to-spec으로 넘길 수 있는 상태가 destination. (planning — 티켓은 결정/프로토타입, 실제 구현 아님.)

Notes

• 관련 맵(같은 /wayfinder 분리, 2026-07-11): 🗺️ [wayfinder] TryOn 모바일 UX/UI — 진입·모달·카메라/갤러리·아이템노출 (QA-first) #920 TryOn 모바일 UX · 🗺️ [wayfinder] Error page 준수 — 세그먼트 경계·셸 유지·토큰/shared 조합 #918 Error page 준수. 씨앗 이슈 Optimize try-on generation speed and save flow #489(try-on gen 속도+progress)를 이 맵이 흡수 — close는 작성자 확인 후.
• 현재 실태(orientation 2026-07-11): 둘 다 진짜 백엔드 잡이 아님 — 동기 blocking HTTP, job id/폴링/SSE/큐 없음. VTON만 client-only 유사백그라운드: 모듈 zustand 단일 슬롯 vtonStore.backgroundJob + 전역 마운트 VtonBackgroundNotifier(완료 sonner 토스트+재오픈 복원). 단 (1)새로고침 시 소멸(persist 없음·백엔드 기록 없음), (2)단일 슬롯이라 2번째 잡이 조용히 덮어씀. StyleDNA는 전무(라우트 이탈 시 reset()로 폐기, 진행바는 setInterval 가짜). ai-server ARQ 큐(editorial-publish PR feat(editorial): IG 캐러셀 자동 발행 (ai-server ARQ + Meta 캐러셀) #681·raw_posts)는 존재하나 두 기능 모두 우회.
• 아키텍처 비대칭: VTON 잡은 서버측 owner 없음(Next route→Vertex 직접). StyleDNA는 api-server(build_my_style_dna→ai-server gRPC Gemini) 경유라 잡 레코드를 owner로 삼을 수 있음.
• 스킬: 아키텍처 결정=/grilling·/domain-modeling; UX=/prototype; 인프라 조사=/research.
• 경계: 이 맵 = 실행 라이프사이클 UX(cross-feature). capture/진입 표면 = 맵 ①(TryOn UX). save flow 소유권 최종 = 🗺️ [wayfinder] kiyori 프론트 지도 — 4 surface(홈·익스플로어·라이브러리·프로필)+게스트/로그인 · UI/UX·로케일·서치·Style DNA #789 저장/북마크 통합 — Library vs Profile 경계 (posts/catalog/cody looks/tries/likes 4-arm) #798.
• 사실: prod VTON 생성 코드 main 배포(75ccaf8/fix(vton): restore production auth via google-auth-library service-account token #620) — 라이브 확인이 복귀/완료 UX 실검증의 선행.

Decisions so far

• [research] ARQ 큐 재사용 타당성 — tryon/styleDNA 잡 백엔드 #928 (research, CLOSED 07-11) — ARQ 재사용 타당성 = hybrid-recommended. 소유권 비대칭이 결정: VTON=서버 owner 없음(Next→Vertex 직접) / StyleDNA=api-server→ai-server gRPC seam 존재. ARQ 재사용≠저렴(Rust→Python enqueue 비현실적, native Postgres 잡+tokio::spawn이 정답). 하드게이트=max_jobs=1·progress terminal-only(별도 DB 잡레코드 필수). 브리프=PR docs(briefs): #928 ARQ 큐 재사용 타당성 리서치 브리프 #932(docs/superpowers/briefs/928-arq-reuse.md).
• [grilling] 잡 소유·transport·영속성 아키텍처 결정 (공유 vs per-feature) #929 (grilling, 07-13) — 잡 아키텍처 4결정 확정:
  • 영속성: 서버 durable 잡 레코드 + detached 실행. 견딤 범위=같은 브라우저 풀 새로고침(크로스디바이스·푸시는 범위 밖·나중). zustand-persist 단독 불가(잡=request-scoped라 죽음).
  • 소유: api-server가 잡 레코드 통합 소유(generic jobs 테이블, type discriminator), 실행은 네이티브 — StyleDNA=api-server→ai-server gRPC+tokio::spawn, VTON=Next가 Vertex 계속(prod GCP auth 보존)+waitUntil detached→api-server 레코드 기록.
  • transport: 폴링(마운트 GET /jobs?active 재-attach + 각 잡 2–3s 폴). progress=coarse 상태전이/named-stage(매끈한 % 아님).
  • 프론트: 통합 shared shell + per-feature 어댑터(1 jobStore registry + 1 floating dock + 1 notifier + 1 poll loop). vtonStore/VtonBackgroundNotifier 일반화(첫 type=vton)·StyleDNA 수렴. result 렌더·re-open만 type 디스패치.
  • 파생(구현/다운스트림): orphan/timeout reconcile 필요(실행자 사망 시 "running" 고착, ai-server orphan_recovery 선례) · VTON detached=waitUntil(MVP, 60s<300s) vs Vercel Queue(durable, 나중).

Not yet specified

• 완료 알림 표면 상세(sonner 토스트 유지 vs 인앱 알림센터 신설) — 아키텍처 결정 완료(→통합 notifier가 토스트, 인앱 센터는 나중). prototype으로 잠금 → [prototype] floating progress · 완료 알림 · 진행중 복귀 UX #931.
• 다중 동시 잡 registry 스키마(per-feature 한도·글로벌 한도 구조) — 동시성·간섭 정책 결정 대기 → [grilling] 동시성·간섭 정책 + save-seam(#789) 결정 #930.

Out of scope

• StyleDNA 빠른 batch recompute 경로(style_dna_recompute_queue + recompute_user_dna, LLM 없는 로컬 무드 스코어링). 이미 async-by-batch → 백그라운드 UX 불요. (이 맵은 긴 Gemini 합성 build_my_style_dna만.)
• capture/진입 UX(맵 ①). save-to-library flow 소유권(🗺️ [wayfinder] kiyori 프론트 지도 — 4 surface(홈·익스플로어·라이브러리·프로필)+게스트/로그인 · UI/UX·로케일·서치·Style DNA #789 저장/북마크 통합 — Library vs Profile 경계 (posts/catalog/cody looks/tries/likes 4-arm) #798).