Skip to content

docs(briefs): #928 ARQ 큐 재사용 타당성 리서치 브리프#932

Open
thxforall wants to merge 1 commit into
devfrom
feature/928-arq
Open

docs(briefs): #928 ARQ 큐 재사용 타당성 리서치 브리프#932
thxforall wants to merge 1 commit into
devfrom
feature/928-arq

Conversation

@thxforall

Copy link
Copy Markdown
Contributor

무엇

ai-server ARQ(Async Redis Queue)를 VTON + StyleDNA 장기실행 백그라운드 잡의 큐/워커로 재사용 가능한지 조사한 리서치 브리프. #919 백그라운드 잡 UX wayfinder 맵의 research 티켓(#928) 산출물이며, 다음 단계 #929 아키텍처 결정의 입력 자료.

문서 1개 추가(docs/superpowers/briefs/928-arq-reuse.md). 코드 변경 없음.

Verdict: hybrid-recommended

소유권 비대칭이 결정한다 (잡이 아니라):

  • VTON = 서버사이드 owner 없음 (app/api/v1/vton/route.ts가 Vertex를 직접 동기 호출, ai/api-server에 Vertex 능력 0) → "ARQ 재사용"은 얇은 enqueue가 아니라 그린필드 owner 구축(Python VTON 잡 + Vertex 포팅 + GCP auth).
  • StyleDNA = api-server(Rust, build_my_style_dna)→ai-server gRPC seam 존재 → async 잡 추가는 저렴하나 그 저렴한 길은 ARQ를 안 씀(Rust→Python enqueue 비현실적 → api-server Postgres 잡 + tokio::spawn).
  • 하드 게이트 2: max_jobs=1 글로벌 단일 concurrency(VTON이 10분 editorial 잡 뒤 직렬 대기) · ARQ progress terminal-only(별도 DB 잡-레코드 테이블 필수).
  • 정정: 태스크 전제 "5분 timeout" → 실제 job_timeout=600(10분), max_jobs=1(10 아님). ARQ_MIGRATION.md 문서값 신뢰 금지(코드가 정본).

방법 / 검증

5-agent Workflow — read×3(ARQ 인프라+기존 소비자 ‖ VTON 경로 ‖ StyleDNA 경로) → synthesize → adversarial verify. load-bearing 주장 5개 + 보조 3개 전부 file:line 코드 대조(8/8 성립, 반증 0). origin/dev 재확인 완료(브리프 상단 노트). 미검증 잔여 = prod 실측 latency(브리프에 갭 명시).

리뷰 포인트

  • 문서만 추가 — 리뷰는 결론의 코드 정합성(소유권 비대칭·하드 게이트)이 핵심. 브리프 말미 ## Verification (adversarial) 8개 체크에 각 근거 file:line.
  • 이 브리프의 열린 결정(공유 ARQ vs per-feature 네이티브 잡 · 잡 소유 · transport · progress 영속성)은 #929에서 확정.

Closes #928 · Refs #919 #929

🤖 Generated with Claude Code

ai-server ARQ를 VTON/StyleDNA 백그라운드 잡 백엔드로 재사용 가능한지
5-agent Workflow(read×3 → synth → adversarial verify)로 조사.
핵심 5개 주장 전부 코드 대조 검증(8/8, 반증 0) + origin/dev 재확인.

Verdict=hybrid-recommended: 소유권 비대칭(VTON=서버 owner 없음 /
StyleDNA=api-server(Rust)→ai-server gRPC seam) 때문에 두 기능 모두
네이티브 잡이 저렴. 하드 게이트 2개(max_jobs=1 · progress terminal-only).
태스크 전제 "5분 timeout" 오류 정정 → 실제 job_timeout=600(10분).
#929 아키텍처 결정 입력.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
@vercel

vercel Bot commented Jul 11, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
decoded-app Ready Ready Preview, Comment Jul 11, 2026 2:03pm

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: In Progress

Development

Successfully merging this pull request may close these issues.

1 participant