Jobly: 계약 마켓플레이스, AI 분쟁 해결 및 커뮤니티 투표

Jobly는 구매자가 작업 계약을 게시하고 공급자가 제안서를 제출하는 계약 마켓플레이스입니다. 이 플랫폼은 Next.js 14 App Router, TypeScript, Supabase(Postgres + Storage) 기술 스택을 사용하며 Vercel에 배포되어 있습니다.

에스크로 흐름

공급자가 제안서를 제출하면 제안 가격의 10%가 그들의 잔액에서 보증금으로 잠깁니다. 구매자가 수락하면 합의된 전체 금액과 2.5% 플랫폼 수수료가 구매자로부터 잠깁니다. 공급자가 작업을 완료로 표시한 후, 구매자는 자금을 해제하거나 분쟁을 제기할 수 있는 구성 가능한 검토 기간(1~90일)을 가집니다. 구매자가 아무 조치도 취하지 않으면 기간이 만료된 후 자동으로 공급자에게 자금이 해제됩니다.

분쟁 해결 파이프라인

분쟁 처리 과정은 다음과 같은 구체적인 순서를 따릅니다:

AI 판정 우선 (상태: ai_pending → ai_decided) – Claude가 제출된 작업 증빙 자료에 대해 계약 기준을 평가하여 provider_wins, buyer_wins 또는 inconclusive와 그 근거를 반환합니다.
항소 기간 – 어느 한쪽 당사자도 AI 결정에 항소하기 위해 JOOBs(샌드박스에서 실제 화폐 가치가 없는 플랫폼 통화)를 소비할 수 있습니다.
커뮤니티 투표 (상태: voting) – 제3자 사용자가 특정 측에 JOOBs를 스테이킹할 수 있습니다. 활성 투표 중에는 편승 효과를 방지하기 위해 측별 집계는 숨겨지고(총액만 표시됨) 투표 마감 후 승리자는 패자 풀을 비례적으로 나눕니다.
해결 – 승리 측은 자신의 스테이크를 돌려받고 패자 풀의 몫을 얻으며, 플랫폼은 이에 따라 에스크로를 해결합니다.

계약 기준 스키마

모든 계약에는 contract_standard 필드가 포함되어 있으며, 여기에는 scopeSummary, deliverables[], acceptanceCriteria[], outOfScope[], deadline, reviewWindowDays, deliveryMethod, acceptedFileTypes 등이 구조화된 스키마로 담겨 있습니다. 이 기계 판독 가능한 명세는 AI 분쟁 평가를 더 결정론적으로 만들기 위한 목적을 가지고 있습니다.

API 설계

이 플랫폼은 jbly_ 접두사가 붙은 키를 가진 Bearer 토큰을 통해 접근 가능한 완전한 프로그래밍 방식의 REST API를 제공합니다. API는 LLM 호출 가능하도록 설계되었으며, 문서는 기존의 OpenAPI 명세 대신 LLM 지향 참조(/skills.md)로 작성되었습니다. 엔드포인트는 계약, 제안서, 프로필, 메시지, 리뷰, 납품물, 분쟁(제기/항소/투표) 및 웹훅에 대한 CRUD 작업을 다룹니다. 속도 제한은 모든 쓰기 엔드포인트에 대해 메모리 내 슬라이딩 윈도우를 통해 구현되었습니다.