Skip to content
Datamaker Frontend Docs

5단계 - 사용자 및 역할

Raw

프로젝트에 참여할 멤버를 추가하고 역할을 할당하는 마지막 단계입니다.

멤버 추가

Section titled “멤버 추가”

워크스페이스 멤버 중 프로젝트에 참여할 사용자를 선택하여 추가합니다.

역할 할당

Section titled “역할 할당”

추가된 각 멤버에게 역할을 할당합니다.

역할설명
리더(Leader)프로젝트를 총괄하는 리더 역할
매니저(Manager)프로젝트 운영을 관리하는 매니저 역할

프로젝트 생성

Section titled “프로젝트 생성”

모든 설정이 완료되면 “생성” 버튼을 클릭하여 프로젝트를 생성합니다.

graph LR
  A["생성 클릭"] --> B{결과}
  B -->|성공| C["태스크 관리 화면으로 이동"]
  B -->|실패| D["오류 단계로 이동 + 오류 메시지 표시"]

  style C fill:#ecfdf5,stroke:#10b981
  style D fill:#fef2f2,stroke:#ef4444

API 흐름

Section titled “API 흐름”

5단계는 다른 단계와 달리 Draft 임시 저장이 아닌 최종 프로젝트 생성을 수행합니다. “생성” 버튼을 클릭하면 아래 순서로 API가 호출됩니다.

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

Section titled “1. 단계별 데이터 검증 — POST /projects/”

멤버-역할 데이터를 phase: 5와 함께 전송하여 검증합니다.

Request

POST /projects/

{
  "phase": 5,
  "member_roles": [
    { "member": 12, "role": "leader" },
    { "member": 34, "role": "manager" },
    { "member": 56, "role": "manager" }
  ]
}
필드타입필수설명
phaseinteger필수현재 단계 번호 (5)
member_rolesarray필수멤버-역할 매핑 목록
member_roles[].memberinteger필수워크스페이스 멤버 ID
member_roles[].rolestring필수할당할 역할 코드

Response (201 Created)

{
  "member_roles": [
    { "member": 12, "role": "leader" },
    { "member": 34, "role": "manager" }
  ]
}

2. 기본 역할 목록 조회 — GET /projects/default_roles/

Section titled “2. 기본 역할 목록 조회 — GET /projects/default_roles/”

멤버 설정 화면 진입 시 프로젝트에서 사용 가능한 기본 역할 목록을 조회합니다.

Request

GET /projects/default_roles/

Response (200 OK)

[
  { "id": 1, "display_name": "리더", "code": "leader" },
  { "id": 2, "display_name": "매니저", "code": "manager" }
]

3. 최종 프로젝트 생성 — POST /projects/

Section titled “3. 최종 프로젝트 생성 — POST /projects/”

5단계 검증이 성공하면 Draft에서 1~4단계의 모든 누적 데이터를 조회한 뒤, 5단계 데이터와 병합하여 phase 필드 없이 최종 프로젝트 생성 API를 호출합니다.

Request

POST /projects/

{
  "title": "자동차 객체 검출 프로젝트",
  "description": "COCO 데이터셋을 사용한 자동차 객체 검출 어노테이션",
  "category": "image",
  "access_level": "public",
  "caution": "sensitive_content",
  "image": "https://storage.example.com/thumbnails/abc123.png",
  "data_collection": 1,
  "configuration": {
    "schema_type": "dm_schema",
    "classification": { ... }
  },
  "can_discard": false,
  "count_max_assignments_per_task": 3,
  "project_plugins": [],
  "member_roles": [
    { "member": 12, "role": "leader" },
    { "member": 34, "role": "manager" }
  ]
}

Response (201 Created)

프로젝트가 성공적으로 생성되면 생성된 프로젝트 정보가 반환됩니다.

{
  "id": 42,
  "title": "자동차 객체 검출 프로젝트",
  "description": "COCO 데이터셋을 사용한 자동차 객체 검출 어노테이션",
  "category": "image",
  "access_level": "public",
  "data_collection": 1,
  "configuration": { ... },
  "can_discard": false,
  "count_max_assignments_per_task": 3,
  "project_plugins": [],
  "member_roles": [...]
}

성공 시 반환된 id를 사용하여 태스크 관리 화면 (/projects/{id}/task/manage/tasks)으로 자동 이동합니다.

Error Response (400 Bad Request)

최종 생성 시 여러 단계에 걸친 오류가 반환될 수 있습니다. 시스템은 첫 번째 오류가 있는 단계로 자동 이동합니다.

{
  "title": ["이 필드는 필수 항목입니다."],
  "data_collection": ["유효하지 않은 pk \"999\" - 객체가 존재하지 않습니다."],
  "configuration": ["유효하지 않은 설정입니다."]
}

전체 API 흐름 요약

Section titled “전체 API 흐름 요약”
graph TD
  A["생성 클릭"] --> B["POST /projects/ (phase: 5)\n멤버-역할 검증"]
  B -->|성공| C["GET /drafts/CREATE/\n1~4단계 Draft 조회"]
  C --> D["POST /projects/ (phase 없음)\nDraft + 5단계 병합하여 최종 생성"]
  D -->|201 Created| E["태스크 관리 화면으로 이동\n/projects/{id}/task/manage/tasks"]
  D -->|400 Error| F["오류 발생 단계로 이동\n필드별 오류 메시지 표시"]
  B -->|실패| G["5단계에서 오류 표시"]

  style E fill:#ecfdf5,stroke:#10b981
  style F fill:#fef2f2,stroke:#ef4444
  style G fill:#fef2f2,stroke:#ef4444