Glowb Dev Docs
테스트 데이터 세팅

테스트 데이터 세팅 API

테스트 서버에서 캠페인을 만들어 크리에이터가 제출할 수 있는 단계까지 한 번에 세우는 개발 전용 API입니다.

테스트 데이터 세팅 API

캠페인을 처음부터 만들어 크리에이터가 스크립트/영상을 제출할 수 있는 단계까지 세우려면, 원래는 어드민·기업·크리에이터 화면을 오가며 계약서 서명까지 전부 태워야 합니다. 계약 서명은 OTP 문자가 실제로 발송되고 과금되기 때문에 반복 테스트에 쓸 수 없습니다.

이 API들은 그 과정을 걷어내고 결과 상태를 직접 만듭니다.

staging-saas 환경 전용입니다. 컨트롤러에 @Profile("staging-saas") 가 걸려 있어 운영(prod)에서는 Bean 자체가 로드되지 않습니다. 경로는 permitAll 이라 인증 토큰이 필요 없습니다 — 프로파일이 유일한 방어선입니다.

엔드포인트

메서드경로설명
POST/ai/test-setup/campaign캠페인 생성
POST/ai/test-setup/campaign-with-guideline캠페인 + 가이드라인 생성
POST/ai/test-setup/campaign/{collabNo}/select선정 (계약서 작성 건너뛰기)
DELETE/ai/test-setup/cleanup테스트 데이터 일괄 삭제

기본 사용 흐름

# 1. 캠페인 + 가이드라인 생성
curl -X POST {BASE_URL}/ai/test-setup/campaign-with-guideline \
  -H 'Content-Type: application/json' \
  -d '{"snsType":"INSTAGRAM"}'
# → { "data": { "collabNo": 3201, "title": "자동생성-3201", ... } }

# 2. 크리에이터 선정 (계약 체결까지 끝남)
curl -X POST {BASE_URL}/ai/test-setup/campaign/3201/select \
  -H 'Content-Type: application/json' \
  -d '{"influenceNos":[6282,6281]}'
# → { "data": { "nextStage": "SCRIPT_SUBMISSION", "selectedCount": 2, ... } }

# 3. 테스트 끝나면 정리
curl -X DELETE {BASE_URL}/ai/test-setup/cleanup

2번 호출이 끝나면 지정한 크리에이터는 스크립트 제출 단계(2회검수) 또는 영상 제출 단계(1회검수)에 서 있습니다. 이후는 실제 화면에서 제출·검수를 진행하면 됩니다.

캠페인 기본값의 출처

캠페인 생성 시 고를 수 있는 값은 채널·국가·검수 회차·배송 유형 정도이고, 나머지는 운영 뷰티 캠페인 스냅샷 고정값입니다. 선택지를 늘리는 대신 실제 운영 캠페인과 같은 형태를 보장하는 쪽을 택했습니다.

항목고정값
카테고리BEAUTY
캠페인 유형BOTH (제품 + 현금)
모델 타입 / 리스트 모드STANDARD / SELECT
1차 검수 제출물SCRIPT_VIDEO (2회검수일 때)
2차 검수 제출물VIDEO, CAPTION, HASHTAG
최종 제출물CONTENT_LINK, PARTNERSHIP_CODE, CLEAN_FILE, FINAL_FILE
수수료 정책COST_PLUS_FEE / PERCENT / 15
2차 활용4종 / 3개월
가이드라인 버전4
썸네일 / 상세페이지 이미지test 서버에 이미 올라가 있는 CDN 이미지 (1장 / 4장)

AI 데이터를 실제로 생성하지 않는 이유

가이드라인 본문·추천사·상세이미지 분석은 원래 Python(AI)이 만들어 주는 값입니다. 다만 실제 생성은 수 분이 걸리고, 트렌드 컨셉이 3개 미만이면 폴백 없이 502로 실패합니다. 테스트 데이터를 찍을 때마다 이걸 태우면 쓸 수가 없습니다.

그래서 세 가지 모두 운영 데이터에서 뜬 프리셋을 고정값으로 주입합니다.

데이터저장 위치단위
가이드라인 본문MongoDB guidelines캠페인
상세이미지 분석TB_COLLAB.product_details캠페인
추천사TB_APPLICATION_MATCHING.recommend_reason신청자

상세이미지 분석이 비어 있으면 추천사 재생성이 422로 떨어집니다. 캠페인 생성 시점에 미리 채워 두는 이유입니다.

알림을 보내지 않습니다

실제 서비스 흐름 대신 상태를 직접 만들기 때문에 메일·문자·알림이 일절 발송되지 않습니다. 테스트 계정에 스팸이 쌓이지 않는다는 장점이 있는 반면, 발송 여부 검증에는 쓸 수 없습니다. 알림을 확인해야 한다면 실제 화면 조작으로 진행해야 합니다.

알려진 한계

  • 계약서 PDF를 만들지 않습니다. 상태만 SIGNED 라 "계약서 보기" 화면은 비어 있습니다.
  • 배송지(TB_DELIVERY_ADDRESS)를 만들지 않습니다. 배송 레코드만 완료 처리합니다.
  • 알림·메일·문자 미발송 (위 참고).

참고: 기존 시나리오 API

아래 두 개는 고인물(반복 신청자) 알림 테스트용으로 먼저 만들어진 API이며 그대로 남아 있습니다.

메서드경로설명
POST/ai/test-setup/recruiting-campaign모집 중 캠페인 생성 (제목 [TEST] ...)
POST/ai/test-setup/campaign-with-applicants캠페인 + 신청자 N명 + 고인물 조건 세팅

On this page