> ## Documentation Index
> Fetch the complete documentation index at: https://docs.checkable.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 기본 용어

> 체커블을 이용하는데 기본적으로 알아두어야 하는 개념들

워크스페이스, 챌린지, 인증, 멤버는 체커블을 이용하는데 기본적으로 알아두어야 하는 개념입니다. 이것들이 각각 어떤 것인지 어떻게 활용할 수 있는지 알 수 있습니다.

## 🏢 워크스페이스

체커블에서 "워크스페이스"는 하나의 프로젝트 공간과 같습니다. 하나의 계정으로 여러 개의 워크스페이스를 만들 수 있으며 각각은 독립적으로 관리됩니다. 처음 워크스페이스를 만들면 챌린지가 없지만 필요에 따라 여러 개의 챌린지를 추가할 수 있습니다. 워크스페이스는 생성 즉시 사용할 수 있으며 Discord 서버와 연동하여 챌린지를 운영할 수 있습니다. 다른 서비스를 연동하지 않고도 쉽게 운영할 수 있도록, 실시간 인증 현황, 멤버 관리, 통계 분석, 자동 알림 등을 기본으로 제공합니다.

## 🏆 챌린지

챌린지는 특정 목표를 달성하기 위해 정해진 기간 동안 규칙적으로 인증을 제출하는 활동입니다. Discord 스레드와 연동하여 자동으로 인증을 체크하고 실시간으로 현황을 업데이트합니다.

### 챌린지 종류

* **운동 챌린지**: 매일 운동 사진을 올려서 인증
* **공부 챌린지**: 매일 공부한 내용을 정리해서 인증
* **습관 형성 챌린지**: 원하는 습관을 실천하고 인증
* **독서 챌린지**: 매일 독서한 내용을 정리해서 인증

## ✅ 인증

인증은 챌린지 참여자가 목표를 달성했음을 증명하는 활동입니다. Discord 스레드에 이미지나 텍스트를 올려서 인증을 제출하며, 체커블 봇이 자동으로 인증을 확인하고 현황을 업데이트합니다.

### 인증 방식

* **이미지 인증**: 사진이나 스크린샷을 첨부하여 인증 (기본)
* **텍스트 인증**: 텍스트로 활동 내용을 작성하여 인증 (선택사항)

### 인증 상태

* **완료**: 인증이 성공적으로 제출된 상태
* **대기**: 인증이 제출되었지만 아직 확인되지 않은 상태
* **거절**: 인증이 기준에 맞지 않아 거절된 상태

## 👥 멤버

멤버는 챌린지에 참여하는 사용자입니다. Discord 서버의 멤버와 자동으로 동기화되며, 챌린지에 참여 신청을 하면 멤버로 추가됩니다. 멤버는 개별적으로 인증 현황, 진행률, 완료 여부 등을 확인할 수 있습니다.

### 멤버 역할

* **관리자**: 챌린지를 생성하고 관리할 수 있는 권한
* **참여자**: 챌린지에 참여하여 인증을 제출하는 권한

### 멤버 상태

* **활성**: 현재 챌린지에 참여 중인 멤버
* **비활성**: 챌린지에 참여하지 않는 멤버
* **완료**: 챌린지를 성공적으로 완료한 멤버

## 🤖 Discord 봇

Discord 봇은 체커블과 Discord 서버를 연결하는 자동화 도구입니다. Discord 서버에 설치되어 인증 메시지를 자동으로 체크하고, 실시간으로 현황을 업데이트하며, 알림 메시지를 전송합니다.

### 봇 기능

* **자동 인증 체크**: Discord 스레드의 메시지를 실시간으로 모니터링
* **실시간 알림**: 마감 시간, 진행 상황 등 자동 알림
* **데이터 동기화**: Discord 멤버 정보와 채널 정보 자동 동기화
* **권한 관리**: 필요한 최소 권한만 요청하여 보안 강화

## 📊 인증 현황

인증 현황은 챌린지의 진행 상황을 보여주는 실시간 데이터입니다. 전체 멤버 수, 활성 멤버 수, 완료 멤버 수, 인증률 등을 포함합니다.

### 현황 지표

* **전체 멤버 수**: 챌린지에 참여한 모든 멤버 수
* **활성 멤버 수**: 현재 인증을 제출하고 있는 멤버 수
* **완료 멤버 수**: 챌린지를 성공적으로 완료한 멤버 수
* **인증률**: 전체 멤버 중 인증을 완료한 비율

## 📅 운영 요일

운영 요일은 챌린지가 진행되는 요일을 설정하는 기능입니다. 봇이 메시지를 발송하는 요일에만 인증이 가능합니다.

### 운영 요일 특징

* **요일 선택**: 월요일부터 일요일까지 선택 가능
* **자동 연동**: 주간 목표 인증 횟수와 연동되어 자동 조정
* **인증 제한**: 선택된 요일에만 인증 가능

## 🎯 주별 인증 횟수

주별 인증 횟수는 한 주에 몇 번 인증을 해야 하는지를 설정하는 기능입니다. 운영 요일과 함께 설정하여 챌린지의 목표를 정의합니다.

### 인증 횟수 예시

* **주 5회**: 한 주에 5번 인증
* **주 7회**: 한 주에 7번 인증 (매일)
* **주 3회**: 한 주에 3번 인증

## 🔔 알림

알림은 챌린지 진행 상황을 자동으로 알려주는 기능입니다. Discord를 통해 실시간으로 전송되며, 챌린지의 상태 변화를 즉시 확인할 수 있습니다.

### 알림 종류

* **마감 메시지 알림**: 인증 마감 시 알림
* **진행 상황 알림**: 주간 진행 상황 요약
* **완료 알림**: 챌린지 종료 시 최종 결과
* **참여자 알림**: 새 멤버 참여 알림

## 📈 통계

통계는 챌린지의 성과를 분석하는 기능입니다. 인증률, 참여율, 완료율 등을 차트와 그래프로 시각화하여 제공합니다.

### 통계 지표

* **인증률**: 전체 목표 대비 인증 완료 비율
* **참여율**: 전체 멤버 중 활성 참여 비율
* **완료율**: 전체 멤버 중 완료 비율
* **평균 인증 횟수**: 멤버별 평균 인증 횟수

## 🔗 연동

연동은 체커블과 다른 서비스를 연결하는 기능입니다. Discord 외에도 다양한 서비스와 연동하여 챌린지 운영을 더욱 효율적으로 할 수 있습니다.

### 연동 서비스

* **Discord**: 기본 연동 서비스
* **API**: 개발자를 위한 프로그래밍 인터페이스
* **웹훅**: 실시간 이벤트 알림
* **OAuth2**: 표준 인증 프로토콜

## 💰 플랜

플랜은 체커블의 사용 제한을 정의하는 서비스 등급입니다. Free, Basic, Premium 플랜이 있으며 각각 다른 기능과 제한을 제공합니다.

### 플랜 종류

* **Free 플랜**: 기본 기능을 무료로 사용
* **Basic 플랜**: 고급 기능을 월 구독으로 사용
* **Premium 플랜**: 모든 기능을 월 구독으로 사용

### 플랜별 제한

* **챌린지 수**: 플랜별로 만들 수 있는 챌린지 수 제한
* **멤버 수**: 플랜별로 참여할 수 있는 멤버 수 제한
* **기간**: 플랜별로 챌린지 운영 기간 제한
* **관리자**: 플랜별로 설정할 수 있는 관리자 수 제한 (Basic 플랜 이상은 무제한)