---

템플릿 개요

Blue는 두 가지 유형의 템플릿을 지원합니다:

• 회사 템플릿: 내부 사용을 위해 귀하의 조직에서 생성한 템플릿
• 공식 템플릿: 모든 사용자를 위해 Blue에서 생성한 템플릿 (산업 표준 템플릿)

템플릿은 todos, 목록, 사용자 정의 필드, 자동화 등을 포함한 전체 프로젝트 구조를 보존합니다.

목록 템플릿

템플릿 쿼리 사용

query GetTemplates {
  templates(
    companyId: "company-123"
    isOfficialTemplate: false
    category: MARKETING
  ) {
    id
    name
    description
    category
    isOfficialTemplate
    icon
    color
    image {
      thumbnail
      small
    }
  }
}

템플릿 필터와 함께 projectList 사용

query ListTemplates {
  projectList(
    filter: {
      companyIds: ["company-id"]
      isTemplate: true
    }
    sort: [updatedAt_DESC]
    take: 20
    skip: 0
  ) {
    items {
      id
      slug
      name
      description
      category
      isTemplate
      isOfficialTemplate
      color
      icon
      createdAt
      updatedAt
    }
    pageInfo {
      hasNextPage
      totalItems
    }
    totalCount
  }
}

템플릿에서 프로젝트 생성

기존 템플릿에서 새 프로젝트를 생성하려면:

mutation CreateFromTemplate {
  createProject(
    input: {
      templateId: "template-id-or-slug"
      name: "Q1 Marketing Campaign"
      companyId: "company-id"
      description: "Marketing initiatives for Q1"
      color: "#10B981"
    }
  ) {
    id
    name
    slug
  }
}

프로젝트를 템플릿으로 변환

기존 프로젝트를 재사용 가능한 템플릿으로 변환합니다:

mutation ConvertToTemplate {
  convertProjectToTemplate(
    input: {
      projectId: "project-123"
      isOfficialTemplate: false
    }
  ) {
    id
    name
    isTemplate
    isOfficialTemplate
  }
}

템플릿 상태 제거

템플릿을 일반 프로젝트로 다시 변환합니다:

mutation RemoveTemplateStatus {
  removeProjectFromTemplates(projectId: "template-123") {
    id
    name
    isTemplate
  }
}

단일 템플릿 가져오기

특정 템플릿에 대한 세부정보를 검색합니다:

query GetTemplate {
  template(templateId: "template-123") {
    id
    name
    description
    category
    isOfficialTemplate
    todoLists {
      name
      todos {
        title
      }
    }
  }
}

쿼리 매개변수

templates 쿼리

매개변수	유형	필수	설명
companyId	String	아니요	회사별로 템플릿을 필터링합니다. 생략하면 공식 템플릿을 볼 수 있습니다.
isOfficialTemplate	Boolean	아니요	공식 Blue 템플릿만 표시
category	ProjectCategory	아니요	프로젝트 카테고리로 필터링

convertProjectToTemplate 입력

매개변수	유형	필수	설명
projectId	String!	✅ 예	템플릿으로 변환할 프로젝트
isOfficialTemplate	Boolean!	✅ 예	공식 템플릿으로 표시 (Blue 직원 전용)

템플릿 카테고리

값	설명
CRM	고객 관계 관리
CROSS_FUNCTIONAL	교차 기능 팀 프로젝트
CUSTOMER_SUCCESS	고객 성공 이니셔티브
DESIGN	디자인 및 창의적 프로젝트
ENGINEERING	엔지니어링 및 개발
GENERAL	일반 프로젝트 (기본값)
HR	인사 관리
IT	정보 기술
MARKETING	마케팅 캠페인
OPERATIONS	운영 및 물류
PRODUCT	제품 관리
SALES	영업 및 비즈니스 개발

템플릿에서 복사되는 내용

템플릿에서 프로젝트를 생성할 때 다음 내용이 복사됩니다:

• ✅ 구조: 모든 todo 목록 및 해당 위치의 todos
• ✅ 내용: 설명, 댓글 및 첨부 파일
• ✅ 조직: 태그, 레이블 및 사용자 정의 필드
• ✅ 자동화: 모든 자동화 규칙 및 워크플로우
• ✅ 양식: 프로젝트 양식 및 해당 구성
• ✅ 문서: 위키 페이지 및 문서
• ✅ 설정: 커버 구성 및 표시 기본 설정
• ✅ 역할: 사용자 역할 정의 (단, 사용자 할당은 제외)

복사되지 않는 내용:

• ❌ 사용자 할당 (생성자 제외)
• ❌ 활동 기록
• ❌ 시간 추적 데이터
• ❌ todos의 완료 상태

필수 권한

템플릿 생성

작업	필수 역할
Convert project to template	Project OWNER or ADMIN
Create official template	Blue employee only
Remove template status	Project OWNER or ADMIN

템플릿 사용

템플릿 유형	사용 가능한 사람
Company templates	Users in the same company
Official templates	All Blue users

오류 응답

템플릿을 찾을 수 없음

{
  "errors": [{
    "message": "Template not found",
    "extensions": {
      "code": "TEMPLATE_NOT_FOUND"
    }
  }]
}

너무 많은 todos

{
  "errors": [{
    "message": "This project has more than 250,000 todos and cannot be used as a template",
    "extensions": {
      "code": "TOO_MANY_TODOS"
    }
  }]
}

중요 사항

• 크기 제한: 250,000개 이상의 todos가 있는 프로젝트는 템플릿으로 사용할 수 없습니다.
• 비동기 복사: 템플릿 콘텐츠는 작업 큐를 통해 백그라운드에서 복사됩니다.
• 아카이브 상태: 템플릿으로 변환하면 프로젝트가 자동으로 아카이브 해제됩니다.
• 폴더 제거: 템플릿은 변환 시 폴더에서 제거됩니다.
• 액세스 제어: 공식 템플릿은 모두에게 표시되며, 회사 템플릿은 구성원에게만 표시됩니다.
• 실시간 업데이트: subscribeToProject 구독을 사용하여 템플릿 변경 사항을 구독하세요.