선정 (계약서 작성 건너뛰기)

지정한 크리에이터를 제안 → 크레딧 잠금 → 계약 체결까지 한 번에 처리합니다. 계약서 열람·정보입력·OTP 인증·서명은 통째로 건너뛰고 서명 완료 상태를 직접 만듭니다. 크리에이터마다 검수 상태(10가지)를 지정하면 선정 직후 그 상태까지 밀어 넣습니다.

상태를 지정하지 않은 크리에이터는 호출이 끝나면 곧바로 아래 단계에 서 있습니다. 상태를 지정했다면 검수 상태 지정을 보세요.

HTTP 요청

POST /ai/test-setup/campaign/{collabNo}/select
Content-Type: application/json

Path Parameters

Request Body

{
  "creators": [
    { "influenceNo": 2436, "state": "SCRIPT_ADMIN_WAITING" },
    { "influenceNo": 6289, "state": "VIDEO_REVISION_WAITING" },
    { "influenceNo": 6281 }
  ],
  "unitPrice": 100000,
  "skipDelivery": false,
  "enableAdminGate": true,
  "paidScope": "PARTIAL"
}

상태 지정 없이 선정만 할 때는 기존처럼 influenceNos 를 써도 됩니다: { "influenceNos": [6282, 6281] }

처리 순서

크리에이터 한 명당 아래를 순서대로 수행합니다.

1. 신청 생성 — 이미 있으면 재사용. 없으면 SELF_APPLIED 로 새로 만듭니다. 크리에이터 SNS 링크를 같은 SNS 타입의 과거 신청에서 찾아 넣고, 없으면 프리셋을 씁니다
2. 기업 노출 + 단가 — adminVisible = true, 노출가·제안가 설정, 추천사 프리셋 주입
3. 제안 + 크레딧 잠금 — PROPOSAL 로 바꾸고 캠페인 예산에서 잠급니다. 이미 잠겨 있으면 건너뜁니다
4. 계약 체결 — ApplicationContract 를 SIGNED 상태로 직접 생성하고, 단가 수락 뒤 계약서 빈 칸을 더미로 채웁니다(아래 표)
5. 선정 확정 + 검수 라운드 — SELECTED 로 바꾸고 ContentReview 생성 (2회검수 = 1차, 1회검수 = 2차)
6. 일정 트리거 발화 — 아래 표 참고

마지막으로 캠페인 단계를 CONTENT_CREATION 으로 넘기고 신청자 목록을 숨깁니다(운영 서명 흐름과 동일). 여기까지가 한 트랜잭션으로 커밋되고, 상태를 지정한 크리에이터는 그 뒤에 아래 검수 상태 지정이 이어집니다.

검수 상태 지정 (선택)

creators[].state 를 주면 선정이 끝난 직후 그 크리에이터를 지정한 검수 상태까지 밀어 넣습니다. 상태 컬럼을 직접 쓰지 않고 운영 서비스를 순서대로 호출하므로 일정·승인 로그 같은 곁가지까지 운영과 같은 모양으로 남습니다.

스크립트 상태는 2회검수(1차 SCRIPT_VIDEO) 캠페인에서만 됩니다. SCRIPT_SUBMISSION 은 상태를 비운 것과 결과가 같지만 드롭다운에서 고를 수 있게 둔 값입니다. 한 캠페인에 한 크리에이터는 신청 1건이라, 10가지를 한 캠페인에 모두 만들려면 크리에이터 10명이 필요합니다.

진행 경로

크리에이터 한 명은 아래 단계를 목표 상태에서 멈출 때까지 차례로 밟습니다.

영상 상태는 이 앞에 1차 스크립트를 제출하고 피드백 없이 승인(FeedbackApprovalService.approve)하는 단계가 붙습니다. 그러면 2차 라운드가 자동으로 생기고, 거기서 ①부터 진행합니다. VIDEO_SUBMISSION 은 2차 라운드가 열린 직후에서 멈춥니다(1회검수 캠페인이면 선정 직후 그대로).

단계마다 검수 라운드(TB_CONTENT_REVIEW)는 아래 모양이 됩니다. 응답의 reviewState.matchesExpected 가 이 표와의 일치 여부입니다.

수정본 검수 대기의 admin_approval_status 가 APPROVED 인 것은 정상입니다. 재제출은 이 값을 리셋하지 않아 직전 차수의 승인값이 남습니다.

넣는 피드백

관리자 검수 대기 이후 상태에는 한 라운드에 피드백 4건이 들어갑니다. 스크립트는 장면마다 돌려 가며, 영상 라운드는 영상 제출물에 모아 답니다.

관리자 검수 게이트

관리자 검수 대기와 수정본 두 상태는 기업 피드백이 관리자 검수 게이트에 걸려야 만들어집니다. 게이트가 꺼진 채 피드백을 넣으면 관리자를 건너뛰고 바로 크리에이터에게 릴리스돼 상태가 조용히 틀어집니다.

• 스크립트 게이트는 캠페인 설정 admin_feedback_approval_script_enabled 와 Flagsmith script_admin_gate_enabled 가 둘 다 켜져야 걸립니다. Flagsmith 가 꺼져 있으면 스크립트 관리자 검수 이후 상태는 실패로 돌립니다(코드로 켤 수 없습니다).
• 영상 게이트는 캠페인 설정 admin_feedback_approval_enabled 하나로 걸립니다.
• enableAdminGate: true 가 캠페인 게이트를 켜면 그 캠페인의 다른 신청에도 적용됩니다. 응답 reviewStateSummary.gatesEnabled 에 켠 게이트가 남습니다.

이미 진행된 신청

같은 크리에이터가 이 캠페인에 이미 신청해 있으면 선정은 그 신청을 재사용합니다. 그런데 그 신청의 시작 라운드가 이미 제출된 상태라면 되돌리지 않고 그 크리에이터의 상태 세팅만 실패로 돌립니다. 다른 사람의 테스트일 수 있어서입니다. 다시 만들려면 새 캠페인에서 선정하세요.

일정 트리거를 실제로 발화시키는 이유

마감이 trigger_type 없이 임시값(placeholder)으로 남으면, 어드민·크리에이터 화면이 계약자 전원을 연체로 표시합니다. 그래서 상태는 직접 만들되 일정 트리거만은 운영과 같은 서비스를 호출합니다.

배송형에서는 운송장 더미와 배송 완료 시각까지 넣습니다. 택배사는 국내면 kr.cjlogistics, 해외면 OTHER 로 들어갑니다.

응답 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "선정 완료",
  "data": {
    "collabNo": 3201,
    "doubleReview": true,
    "nextStage": "SCRIPT_SUBMISSION",
    "campaignSubStep": "CONTENT_CREATION",
    "selectedCount": 2,
    "selected": [
      {
        "applicationId": 88123,
        "influenceNo": 6282,
        "influenceName": "테스트크리에이터",
        "unitPrice": 100000,
        "lockedAmount": 100000,
        "contractId": 4412,
        "contractStatus": "SIGNED",
        "contractPaperwork": {
          "contractId": 4412,
          "contractInfoFilled": true,
          "variablesFilled": true,
          "documentsAdded": 2,
          "pdfCreated": true,
          "signedPdfUrl": "https://glowb-input.s3.ap-southeast-1.amazonaws.com/contract/pdf/..."
        },
        "reviewRound": 1,
        "deliveryCompleted": true,
        "reviewState": {
          "state": "SCRIPT_ADMIN_WAITING",
          "reached": true,
          "reviewId": 9001,
          "feedbackIds": [5101, 5102, 5103, 5104],
          "review": {
            "status": "REVIEWING",
            "adminApprovalStatus": "PENDING",
            "awaitingRevision": false,
            "currentRevisionNo": 1
          },
          "matchesExpected": true
        }
      }
    ],
    "failed": [],
    "reviewStateSummary": {
      "requested": 1,
      "reached": 1,
      "scriptAdminGateFlag": true,
      "gatesEnabled": ["SCRIPT"],
      "note": "AI 검수 결과는 Python 이 비동기로 채운다(영상 1건 약 5분, 규정검수 병행 시)."
    }
  }
}

존재하지 않는 인플루언서가 섞여 있어도 전체가 실패하지 않고 해당 건만 failed 로 빠집니다. 검수 상태 세팅이 한 명에서 실패해도 선정과 다른 크리에이터의 상태 세팅은 그대로 진행되고, 실패한 사람의 앞 단계는 되돌려지지 않습니다.

재호출 안전성

같은 크리에이터로 다시 호출해도 터지지 않습니다. 신청·계약·배송·매칭 레코드는 있으면 갱신하고, 예산은 이미 잠겨 있으면 건너뜁니다.

에러 응답

에러도 HTTP 는 200 이고, 판정은 body 의 status 필드로 합니다.

계약서 더미

서명 흐름을 건너뛰면 크리에이터가 입력하는 칸이 전부 비어, 크리에이터 화면에 서류 제출 모달이 계속 뜨고 "계약서 보기"도 비어 있습니다. 그래서 아래를 더미로 채웁니다. 사람이 이미 입력하거나 올린 값은 덮어쓰지 않습니다.

정산정보(TB_CONTRACT_PAYMENT_INFO)는 해외 계약 전용이라 만들지 않습니다. 이미 선정된 신청도 같은 크리에이터로 다시 선정하면 빈 칸만 채워집니다.

이 API가 만들지 않는 것

• 배송지(TB_DELIVERY_ADDRESS) — 배송 레코드만 완료 처리합니다
• 알림·메일·문자 — 선정만 할 때는 일절 발송하지 않습니다. 검수 상태를 지정하면 운영 흐름대로 나갑니다

API 테스트