1단계 - 기본정보

프로젝트의 기본 정보를 입력하는 첫 번째 단계입니다.

입력 필드

필드	필수	제한	설명
프로젝트 명	필수	최대 50자	프로젝트를 식별하는 이름
설명	선택	최대 200자	프로젝트에 대한 간단한 설명
썸네일 이미지	선택	2MB 이하, jpg/jpeg/png/bmp	프로젝트 목록에서 표시되는 대표 이미지
민감한 컨텐츠	선택	체크박스	민감한 컨텐츠가 포함되어 있는지 표시
공개여부	필수	3가지 옵션	프로젝트의 접근 권한 수준 설정

프로젝트 명

프로젝트를 식별하는 이름을 입력합니다.

설명

프로젝트에 대한 간단한 설명을 입력합니다. 최대 200자까지 입력 가능하며, 선택 사항입니다.

썸네일 이미지

프로젝트 목록에서 표시되는 대표 이미지를 업로드합니다.

항목	제한
파일 형식	jpg, jpeg, png, bmp
파일 크기	2MB 이하

민감한 컨텐츠

프로젝트에 민감한 컨텐츠가 포함된 경우 체크박스를 선택합니다. 이 설정은 프로젝트 목록에서 필터링 조건으로 사용됩니다.

공개여부

프로젝트의 접근 권한 수준을 설정합니다.

옵션	설명
전체 공개	워크스페이스에 포함된 모든 사용자가 내용을 볼 수 있습니다.
부분 공개	목록에서 볼 수 있고 초대된 사용자만 내용을 볼 수 있습니다.
비공개	초대되지 않은 사용자의 목록에 노출되지 않습니다.

API 흐름

“다음 단계” 버튼을 클릭하면 아래 순서로 API가 호출됩니다.

1. 단계별 데이터 검증 — `POST /projects/`

기본정보 데이터를 phase: 1과 함께 프로젝트 생성 API로 전송하여 서버 측 유효성 검증을 수행합니다.

Request

POST /projects/

{
  "phase": 1,
  "title": "자동차 객체 검출 프로젝트",
  "description": "COCO 데이터셋을 사용한 자동차 객체 검출 어노테이션",
  "image": "data:image/png;base64,iVBOR...",
  "caution": "sensitive_content",
  "access_level": "public",
  "category": "image"
}

필드	타입	필수	설명
`phase`	`integer`	필수	현재 단계 번호 (`1`)
`title`	`string`	필수	프로젝트 명 (최대 200자)
`description`	`string`	선택	프로젝트 설명
`image`	`string`	선택	썸네일 이미지 (Base64 인코딩)
`caution`	`string`	선택	주의사항. `"sensitive_content"` 또는 빈 문자열
`access_level`	`string`	필수	공개여부. `"public"` \| `"partially_public"` \| `"private"`
`category`	`string`	필수	어노테이터 카테고리. `"image"` \| `"video"` \| `"audio"` \| `"text"` \| `"pcd"` \| `"prompt"`

Response (201 Created)

검증 성공 시 입력 데이터가 그대로 반환됩니다.

{
  "id": null,
  "title": "자동차 객체 검출 프로젝트",
  "description": "COCO 데이터셋을 사용한 자동차 객체 검출 어노테이션",
  "image": "https://storage.example.com/thumbnails/abc123.png",
  "caution": "sensitive_content",
  "access_level": "public",
  "category": "image"
}

Error Response (400 Bad Request)

유효성 검증 실패 시 필드별 오류 메시지가 반환됩니다.

{
  "title": ["이 필드는 필수 항목입니다."],
  "access_level": ["유효하지 않은 선택입니다."]
}

2. 임시 저장 — `POST /drafts/`

단계별 검증이 성공하면 Draft API를 호출하여 현재까지의 데이터를 임시 저장합니다.