> ## 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를 기반으로 한 자동화된 챌린지 운영을 제공합니다.

### 챌린지 예시

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

## 🚀 챌린지 생성하기

### 1. 기본 정보 설정

* **챌린지 제목**: 명확하고 구체적인 제목 설정
* **챌린지 설명**: 참여자들이 이해할 수 있는 상세한 설명
* **시작일**: 챌린지 시작 날짜
* **종료일**: 챌린지 종료 날짜
* **주별 인증 횟수**: 한 주에 몇 번 인증할지 설정

### 2. Discord 채널 설정

* **채널 선택**: 인증을 받을 Discord 채널 선택
* **봇 권한 확인**: 봇이 채널에 접근할 수 있는지 확인
* **스레드 생성**: 인증용 스레드는 시스템이 자동 생성하며, 별도 토글은 없습니다

### 3. 운영 요일 설정

* **요일별 설정**: 월요일부터 일요일까지 각 요일별로 봇이 메시지를 발송할지 설정할 수 있습니다
* **주간 목표와 연동**: 주간 목표 인증 횟수에 따라 자동으로 요일이 선택됩니다
* **인증 가능**: 봇이 메시지를 발송하는 요일에만 인증이 가능합니다

### 4. 고급 설정

* **텍스트 인증 허용**: 이미지 없이 텍스트만으로 인증 허용 (기본값: 이미지 인증만)
* **마감 메시지 전송**: 마감 시간에 알림 메시지 발송 여부
* **마감 메시지 내용**: 발송할 마감 메시지 내용
* **마감 후 스레드 잠금**: 마감 후 스레드 자동 잠금 여부
* **인증 표시 모드**: 간단 모드 또는 주간 모드 선택
* **늦제출 허용**: 마감 후 지정 시간까지 늦제출 인정 (Premium 전용)
* **인증 시간 제한**: 하루 내 인증 가능 시간대 지정 (Premium 전용)

## 👥 참여자 관리

### 멤버 추가

1. **Discord 멤버 동기화**: Discord 서버의 멤버 목록 자동 동기화
2. **수동 추가**: 특정 멤버만 선택적으로 추가
3. **권한 관리**: 관리자와 일반 참여자 구분

### 멤버 제거

* **자동 제거**: Discord 서버에서 나간 멤버 자동 제거
* **수동 제거**: 관리자가 직접 멤버 제거
* **데이터 보존**: 제거된 멤버의 인증 기록 보존

## 📊 인증 현황 관리

### 실시간 현황

* **전체 참여자 수**: 챌린지에 참여한 전체 멤버 수
* **활성 참여자 수**: 현재 활발히 참여하는 멤버 수
* **완료 참여자 수**: 목표를 달성한 멤버 수
* **현재 주차**: 현재 진행 중인 주차
* **전체 주차**: 챌린지 전체 주차 수

### 주별 인증 현황

* **주차**: 현재 주차 번호
* **시작일**: 해당 주차 시작일
* **종료일**: 해당 주차 종료일
* **필요 인증 수**: 해당 주차에 필요한 인증 수
* **완료 인증 수**: 해당 주차에 완료된 인증 수
* **멤버별 현황**: 각 멤버의 인증 현황

### 멤버별 현황

* **Discord 사용자 ID**: Discord 사용자 식별자
* **사용자명**: Discord 사용자명
* **프로필 이미지**: Discord 프로필 이미지
* **인증 횟수**: 현재까지 완료한 인증 횟수
* **완료 여부**: 목표 달성 여부
* **마지막 인증 시간**: 가장 최근 인증 시간

### 관리자 체크 처리

참여자가 개인 사정으로 인증을 제출하지 못한 경우, 관리자가 수동으로 체크를 처리할 수 있습니다. 자세한 내용은 [관리자 체크 처리 가이드](/features/admin-check)를 참고하세요.

* **관리자 승인**: 관리자가 참여자를 대신해 체크 처리
* **시각적 구분**: 일반 체크와 관리자 체크를 명확히 구분
* **간편한 토글**: 셀 클릭만으로 관리자 승인/복원 가능

## 🔄 챌린지 상태 관리

### 챌린지 상태

* **대기 중**: 챌린지 시작 전 상태
* **진행 중**: 챌린지 진행 중 상태
* **완료**: 챌린지 완료 상태

### 상태별 기능 제한

#### 대기 중

* ✅ 모든 설정 변경 가능
* ✅ 멤버 추가/제거 가능
* ✅ Discord 채널 변경 가능

#### 진행 중

* ❌ 시작일 변경 불가
* ❌ 인증 시작/마감 시간 변경 불가
* ❌ 운영 요일 변경 불가
* ❌ 인증 횟수 변경 불가
* ❌ 텍스트 인증 허용 변경 불가
* ❌ Discord 채널 변경 불가
* ❌ 늦제출 허용/이모지 설정 변경 불가
* ✅ 종료일 변경 가능
* ✅ 마감 메시지 내용 변경 가능
* ✅ 멤버 추가/제거 가능

#### 완료

* ❌ 모든 설정 변경 불가
* ❌ 멤버 추가/제거 불가
* ✅ 데이터 조회만 가능

## 📈 인증 현황 표시 방식

### 주별 체크

* 각 주차별로 인증 현황 표시
* 주차별 완료 여부 확인
* 전체 진행률 파악

### 일별 체크

* 각 날짜별로 인증 현황 표시
* 세부적인 인증 패턴 확인
* 개별 날짜 인증 여부 확인

## 🔔 자동 알림 시스템

### 마감 메시지 알림

* **마감 메시지 발송 여부**: 인증 마감 시 알림 발송할지 설정
* **마감 메시지 내용**: 발송할 마감 메시지 내용

### 알림 메시지 예시

```
🔔 [챌린지명] 오늘 인증이 마감되었습니다!

📅 오늘 인증 현황:
✅ 완료: 5명
❌ 미완료: 3명

⏰ 마감 시간: 자정 (00:00)
```

## 🛠️ 챌린지 수정

### 수정 가능한 항목

#### 진행 중인 챌린지

* ✅ 챌린지 제목
* ✅ 챌린지 설명
* ✅ 인증 횟수
* ✅ 마감 메시지 설정
* ✅ 멤버 관리

#### 완료된 챌린지

* ❌ 모든 설정 변경 불가
* ✅ 데이터 조회만 가능

### 수정 방법

1. **챌린지 목록에서 수정**: 챌린지 카드의 수정 버튼 클릭
2. **상세 페이지에서 수정**: 챌린지 상세 페이지의 수정 버튼 클릭
3. **실시간 반영**: 수정사항이 즉시 반영됨

## 🗑️ 챌린지 삭제

### 삭제 시 주의사항

* ⚠️ **영구 삭제**: 삭제된 챌린지는 복구할 수 없음
* ⚠️ **데이터 손실**: 모든 인증 기록이 삭제됨
* ⚠️ **멤버 데이터**: 멤버별 진행 상황도 삭제됨

### 삭제 방법

1. **챌린지 목록에서 삭제**: 챌린지 카드의 삭제 버튼 클릭
2. **상세 페이지에서 삭제**: 챌린지 상세 페이지의 삭제 버튼 클릭
3. **확인 대화상자**: 삭제 확인 후 최종 삭제

## 📊 데이터 내보내기

### 내보내기 가능한 데이터

* **챌린지 기본 정보**: 제목, 설명, 기간, 설정 등
* **멤버 목록**: 참여자 정보 및 역할
* **인증 기록**: 각 멤버의 인증 이력
* **통계 데이터**: 주별/일별 인증 현황

### 내보내기 형식

* **CSV**: 스프레드시트 호환 형식
* **JSON**: 프로그래밍용 데이터 형식
* **PDF**: 보고서 형식

## 🔐 권한 관리

### 관리자 권한

* **챌린지 생성/수정/삭제**: 모든 챌린지 관리
* **멤버 관리**: 참여자 추가/제거
* **설정 변경**: 모든 설정 변경
* **데이터 조회**: 모든 데이터 조회

### 일반 참여자 권한

* **인증 제출**: Discord 스레드에 인증 제출
* **현황 확인**: 개인 진행 상황 확인
* **데이터 조회**: 제한된 데이터 조회

## 🎯 모범 사례

### 효과적인 챌린지 설계

1. **명확한 목표 설정**: 구체적이고 측정 가능한 목표
2. **적절한 기간 설정**: 너무 길거나 짧지 않은 기간
3. **현실적인 인증 횟수**: 참여자들이 달성 가능한 횟수
4. **명확한 인증 기준**: 무엇을 인증으로 인정할지 명확히

### 참여율 향상 팁

1. **정기적인 알림**: 마감 메시지 알림 활용
2. **진행 상황 공유**: 전체 현황을 정기적으로 공유
3. **격려 메시지**: 성취한 멤버들을 격려
4. **유연한 운영**: 상황에 따라 적절히 조정

## 🆘 문제 해결

### 자주 묻는 질문

**Q: 챌린지 중간에 설정을 변경할 수 있나요?**
A: 진행 중인 챌린지의 경우 제한적으로만 변경 가능합니다. 시작일, 종료일, 운영 요일은 변경할 수 없습니다.

**Q: 참여자가 중간에 나가면 어떻게 되나요?**
A: 참여자가 나가도 기존 인증 기록은 보존됩니다. 새로운 참여자는 중간에 추가할 수 있습니다.

**Q: 인증 횟수를 중간에 변경할 수 있나요?**
A: 네, 진행 중인 챌린지에서도 인증 횟수는 변경할 수 있습니다.

### 기술적 문제

**Discord 봇 연결 문제**

* 봇 권한 확인
* 채널 접근 권한 확인
* 봇 재설치

**인증이 자동으로 체크되지 않는 경우**

* 스레드 설정 확인
* 봇 권한 확인
* 수동 동기화 실행

챌린지 관리 시스템은 체커블의 핵심 기능으로, 사용자가 쉽고 효율적으로 챌린지를 운영할 수 있도록 설계되었습니다. 지속적인 개선을 통해 더 나은 사용자 경험을 제공하고 있습니다.

## 📞 지원

### 도움말

* **이메일**: [help@checkable.app](mailto:help@checkable.app)
* **Discord 커뮤니티**: [체커블 Discord](https://discord.gg/x8Qtt2aasJ)

### 다음 단계

* [챌린지 옵션 가이드](/features/challenge-options)
* [늦제출 허용 기능](/features/late-submission)
* [시간 제한 기능](/features/time-restriction)
* [관리자 체크 처리](/features/admin-check)
