---

프로젝트 삭제

deleteProject 변환은 프로젝트와 그에 연결된 모든 데이터를 Blue에서 영구적으로 제거합니다.

기본 예제

mutation {
  deleteProject(id: "{project-id}") {
    success
  }
}

변수 사용

mutation DeleteProject($projectId: String!) {
  deleteProject(id: $projectId) {
    success
  }
}

변수:

{
  "projectId": "abc123-project-id"
}

변환 매개변수

매개변수	유형	필수	설명
id	String!	✅ 예	삭제할 프로젝트의 고유 식별자

응답 필드

필드	유형	설명
success	Boolean!	삭제가 성공했는지 여부를 나타냅니다

필수 권한

프로젝트를 삭제하려면 다음 권한이 있어야 합니다:

1. 회사 수준 접근: OWNER, ADMIN, 또는 MEMBER 역할
2. 프로젝트 수준 접근: OWNER 또는 ADMIN 역할

프로젝트 역할 권한

프로젝트 역할	프로젝트 삭제 가능
OWNER	✅ 예
ADMIN	✅ 예
MEMBER	❌ 아니오
CLIENT	❌ 아니오
COMMENT_ONLY	❌ 아니오
VIEW_ONLY	❌ 아니오

삭제 프로세스

프로젝트를 삭제하면 Blue는 다음 단계를 수행합니다:

1. 검증: 프로젝트가 존재하는지 및 삭제할 권한이 있는지 확인
2. 백업: 프로젝트 데이터를 복구를 위해 쓰레기 테이블에 저장 (내부 사용 전용)
3. 즉시 삭제: 활성 데이터베이스에서 프로젝트 제거
4. 알림: 관련 시스템을 업데이트하고 관련 서비스에 알림
5. 백그라운드 정리: 비동기적으로 모든 관련 데이터 제거

오류 응답

프로젝트를 찾을 수 없음

{
  "errors": [{
    "message": "Project not found",
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

권한 부족

{
  "errors": [{
    "message": "You are not authorized to delete this project",
    "extensions": {
      "code": "UNAUTHORIZED"
    }
  }]
}

중요 사항

• 삭제는 계단식입니다 - 모든 프로젝트 데이터가 제거됩니다.
• 프로세스는 비동기적입니다 - 대규모 프로젝트는 완전히 정리하는 데 시간이 걸릴 수 있습니다.
• 나중에 프로젝트가 필요할 수 있는 경우 삭제 대신 아카이브를 사용하는 것을 고려하십시오.
• 삭제된 프로젝트는 복구 목적으로 내부적으로 저장되지만 API를 통해 접근할 수 없습니다.