[research] ARQ 큐 재사용 타당성 — tryon/styleDNA 잡 백엔드

[thxforall]

Question

ai-server ARQ(editorial-publish PR #681·raw_posts에서 사용 중)를 tryon/styleDNA 백그라운드 잡의 큐/워커로 재사용 가능한가? 조사:

• ARQ job record·status 조회·워커 패턴, enqueue→진행률→완료 신호 표현.
• VTON(현재 Next→Vertex 직접, 서버 owner 없음)을 ARQ로 옮길 때의 배선 비용 vs StyleDNA(이미 api-server 경유)의 배선.
• 신규 잡 인프라 구축 vs ARQ 재사용 트레이드오프 요약.
  산출: markdown asset을 이 이슈에 링크.

Parent

#919 — 🗺️ [wayfinder] 백그라운드 잡 UX

Blocked by

None - can start immediately

[thxforall]

🔬 Research 완료 — ARQ 재사용 타당성

Verdict: hybrid-recommended — ARQ 재사용은 기술적으로 가능하나 소유권 비대칭 때문에 두 기능 모두 네이티브(api-server) 잡이 저렴.

핵심 (전부 코드 대조 검증 — 8/8 성립, 반증 0)

• 소유권이 결정한다(잡이 아니라): VTON=서버사이드 owner 없음 — Next.js route가 Vertex를 직접 동기 호출(app/api/v1/vton/route.ts), ai-server·api-server 어디에도 Vertex 능력 ZERO. StyleDNA=api-server(Rust, build_my_style_dna users/handlers.rs:132)→ai-server gRPC seam 존재.
• ARQ 재사용 ≠ 저렴한 길: StyleDNA의 저렴한 경로는 ARQ를 안 쓴다 — api-server가 Rust라 ARQ(Python/Redis)에 enqueue 불가 → api-server-owned Postgres 잡 + tokio::spawn이 정답. VTON의 "ARQ 재사용"은 얇은 enqueue가 아니라 그린필드 owner 구축(Python VTON 잡 함수 + Vertex 포팅 + GCP auth + status/result 표면 신설).
• 하드 게이트 2: (1) max_jobs=1 글로벌 단일 concurrency(worker.py:73) — user-facing VTON이 10분짜리 editorial 잡 뒤에 직렬 대기, (2) ARQ progress terminal-only(+wrapper get_job_status는 dead code) → progress bar는 별도 DB 잡-레코드 테이블 필수.
• 정정: 태스크 전제 "5분 timeout" → 실제 job_timeout=600(10분, worker.py:74). max_jobs=1(10 아님). ARQ_MIGRATION.md 문서값(10/5분)은 코드와 불일치 → 코드가 정본.

재사용 템플릿 (검증됨 — 새 job type 3곳 변경)

새 async 잡 함수(publish_service.py:138 선례) + WorkerSettings._get_functions() 등록(worker.py:30-58) + enqueue_job() 호출(queue_manager.py:64, idempotent _job_id 공짜). backbone 무수정. 단, 잡 함수가 이미 Python ai-server에 있을 때만 저렴.

산출물

📄 브리프: docs/superpowers/briefs/928-arq-reuse.md — branch feature/928-arq (commit 38da3e55, 미push). 전체 표·file:line·## Verification (adversarial) 8개 체크 + origin/dev 재검증 노트 포함.

#929로 넘길 열린 결정

공유 ARQ vs per-feature 네이티브 잡 · 잡 소유(어느 서버) · transport(poll/SSE) · progress 영속성 스키마 — 이 브리프가 입력 자료.

_{방법: 5-agent Workflow (read×3[ARQ 인프라+소비자 ‖ VTON ‖ StyleDNA] → synthesize → adversarial verify), 전 주장 file:line 대조. 미검증 잔여=prod 실측 latency(브리프에도 갭 명시).}

[thxforall]

리서치 완료 — 브리프가 PR #932(→dev)로 안착. Verdict=hybrid-recommended(소유권 비대칭·하드 게이트 2개, 8/8 코드검증). 다음 단계 #929 아키텍처 결정(이 브리프가 입력) unblock.