데이터 워크벤치

Q: 커스텀 컬렉션의 키로 `products`나 `orders`를 사용할 수 있나요?

아니요. 시스템 테이블 경로(/data/:key)와의 충돌을 방지하기 위해 contacts, products, orders, deliverables와 같은 시스템 테이블 이름은 예약되어 있습니다. 커스텀 컬렉션 생성 시 예약어를 사용하려고 하면 시스템에서 KEY_TAKEN 오류가 발생하며 다른 이름을 선택하라는 메시지가 표시됩니다.

약 6분입문

웹사이트에서 컬렉션, 블로그, 스토어 상품, 고객, 디지털 상품 및 온라인 강의를 사용하는 경우, 모든 구조화된 데이터는 대시보드의 "데이터 및 레코드 › 데이터 워크벤치"(https://app.kanorio.com/data)에 집계됩니다.

대시보드에서 수동으로 관리하든, MCP를 통해 AI 어시스턴트가 자동으로 구축하든, 또는 당사의 API를 호출하는 외부 헤드리스 프론트엔드에서 구동되든, 이 통합 워크벤치에서 모든 테이블의 데이터, 필드 구조 및 API 엔드포인트를 확인할 수 있습니다.

이 가이드로 무엇을 할 수 있나요?

워크벤치의 세 가지 주요 그룹인 "컬렉션", "블로그", 비즈니스 도메인(고객, 상품 및 프로모션, 주문 및 폼, 제공물)의 목적과 권한을 구분합니다.
툴바를 활용하여 조건부 필터링, 다중 열 정렬, 필드 표시 제어 및 URL 상태 공유를 수행합니다.
시스템 테이블이 읽기 전용인 이유를 이해하고, 레코드 패널에서 해당 관리 페이지로 이동하거나 AI 수정을 요청하는 방법을 알아봅니다.

세 가지 주요 데이터 테이블 그룹

"데이터 및 레코드 › 데이터 워크벤치"에 접속하면 사이드바에서 모든 사이트 데이터를 세 개의 블록으로 분류합니다.

그룹	포함된 테이블	대시보드에서 편집 가능 여부	설명
컬렉션	사용자 및 AI가 생성한 사용자 지정 컬렉션 (예: `teachers`, `stores`)	편집 가능 (셀 더블 클릭, 추가, 삭제, CSV 가져오기 가능)	웹사이트를 위한 사용자 지정 구조화 데이터베이스입니다. 플랜의 컬렉션 항목 제한에 포함됩니다 ( 참조)
블로그	`blog`、`blog_categories`、`blog_tags`、`blog_authors`	읽기 전용 ("콘텐츠 › 블로그"에서 동기화됨)	블로그 게시물과 카테고리를 표준 컬렉션 구조로 자동 투영합니다. 사용자 지정 컬렉션 제한을 소모하지 않고 외부 프론트엔드를 위한 동일한 API를 통해 액세스할 수 있습니다
시스템 테이블 (고객 / 상품 및 프로모션 / 주문 및 폼 / 결과물)	비즈니스 도메인별 그룹화: `contacts`、`segments`、`entitlements`、`products`、`product_variants`、`product_categories`、`promotions`、`orders`、、、、

자동 권한 필터링: 시스템 테이블은 사용자의 역할 권한에 따라 자동으로 표시됩니다. 예를 들어, "스토어 보기" 권한이 있는 멤버는 products와 deliverables를 볼 수 있지만, contacts, entitlements, progress와 같이 민감한 고객 데이터가 포함된 테이블은 "고객 보기" 권한이 있는 멤버에게만 표시됩니다.

툴바 및 세 가지 뷰 탭

사이드바에서 테이블을 선택하면 상단 툴바에서 "데이터", "구조", "API" 세 가지 탭을 전환할 수 있습니다.

"데이터" 탭:
- 필터링 및 정렬: "필터"를 클릭하여 최대 10개의 AND 조건(예: 같음, 포함, 크거나 같음, 값 있음)을 설정합니다. "정렬"을 클릭하거나 테이블 헤더를 클릭하여 필드별로 정렬하고, "필드"를 클릭하여 불필요한 열을 숨길 수 있습니다.
- 테이블 간 참조 해결: 다른 테이블을 가리키는 참조 필드(예: entitlements의 contactId 및 deliverableId, 또는 product_variants의 productId)의 경우, 테이블 및 레코드 패널이 자동으로 참조된 이름을 확인하여 표시하므로 ID를 수동으로 대조할 필요가 없습니다.
- URL 상태 공유: 현재 필터, 정렬, 페이지네이션 및 확장된 레코드는 브라우저 URL에 반영됩니다. 링크를 복사하여 동료와 공유하기만 하면 정확히 동일한 뷰를 보여줄 수 있습니다.
"구조" 탭:
- 테이블의 모든 필드에 대한 표시 이름, 식별자(id), 데이터 유형 및 제약 조건을 나열합니다.
- 커스텀 컬렉션의 경우, 우측 상단의 "AI로 구조 수정"을 클릭하여 사이트 ID와 컬렉션 키가 포함된 프롬프트를 복사한 후, Cursor나 Claude에 붙여넣어 필드 조정을 요청할 수 있습니다.
"API" 탭:
- 테이블에 대한 공개 읽기 엔드포인트(콘텐츠 전달 API 또는 고객 API), 실행 가능한 fetch 예제, AI 어시스턴트 및 백엔드에서 사용할 수 있는 관리 API 도구 이름을 자동으로 나열하며, 개발자 참조로 바로 연결되는 링크를 제공합니다.

시스템 테이블이 읽기 전용인 이유는 무엇인가요?

"블로그" 및 비즈니스 도메인 그룹의 테이블에는 "읽기 전용" 잠금 아이콘이 표시됩니다. 이는 주문 환불, 상품 사양 동기화, 고객 액세스 제공, 블로그 게시물 게시와 같은 작업에는 금융 거래, 재고, 알림, 권한 확인 등 단일 셀을 수정하는 것만으로는 처리할 수 없는 복잡한 로직이 포함되어 있기 때문입니다.

시스템 테이블의 레코드에 대해 작업을 수행해야 할 경우, 다음 두 가지 옵션을 사용할 수 있습니다.

전용 관리 페이지로 이동: 행을 클릭하여 레코드 패널을 열고 우측 상단의 "외부 링크" 아이콘을 클릭하면 해당 관리 페이지로 바로 이동할 수 있습니다(예: orders에서 주문 상세 정보로, contacts에서 고객 프로필로, 또는 deliverables에서 배송 관리 페이지로 이동하여 수동으로 액세스 권한 부여 등).
AI 어시스턴트 도구 사용: 를 통해 연결된 AI 어시스턴트 채팅에서 AI에게 해당 도메인 도구(예: products.*, deliverables.*, entitlements.*, posts.*)를 호출하여 일괄 생성이나 업데이트를 수행하도록 요청합니다.

자주 묻는 질문

전혀 그렇지 않습니다. 플랜의 레코드 할당량(무료 플랜: 50개, 프로 플랜: 1,000개, 비즈니스 플랜: 10,000개)에는 귀하 또는 AI가 생성한 "커스텀 컬렉션"만 포함됩니다. 블로그 및 모든 시스템 테이블은 이 제한에서 제외됩니다.

아니요. 시스템 테이블 경로(/data/:key)와의 충돌을 방지하기 위해 contacts, products, orders, deliverables와 같은 시스템 테이블 이름은 예약되어 있습니다. 커스텀 컬렉션 생성 시 예약어를 사용하려고 하면 시스템에서 KEY_TAKEN 오류가 발생하며 다른 이름을 선택하라는 메시지가 표시됩니다.