Discord Study Bot

스터디 그룹을 위한 간단한 디스코드 봇입니다. Todo 관리와 공부 시간 추적을 통해 스터디 동기부여를 도와줍니다.

주요 기능

Todo 관리

• /study add - 할일 추가
• /study list - 할일 목록 확인
• 완료/미완료 상태 구분

공부 시간 추적

• /study start - 공부 시작 (Todo 목록에서 선택)
• /study done - 공부 완료 및 시간 기록 (Todo 완료 처리 옵션)
• /study status - 현재 상태 및 오늘 통계

스마트 기능

• Todo 목록 기반 과목 선택 및 검증
• 공부 완료 시 Todo 자동 완료 또는 미완료 유지 선택
• 30분 이상 공부 시 자동 회고 유도
• 일일 공부시간 및 세션 수 통계
• 에러 처리 및 사용자 친화적 메시지

설치 및 실행

1. 프로젝트 클론

git clone https://github.com/your-username/discord-study-bot.git
cd discord-study-bot

2. Python 환경 설정

# uv 설치 (없는 경우)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 프로젝트 의존성 설치 및 가상환경 자동 생성
uv sync

# 가상환경 활성화 (선택사항, uv run으로 직접 실행 가능)
source .venv/bin/activate  # Windows: .venv\Scripts\activate

3. 디스코드 봇 설정

1. Discord Developer Portal 접속
2. 새 애플리케이션 생성 후 봇 생성
3. Bot 탭에서 토큰 복사
4. Privileged Gateway Intents에서 Message Content Intent 활성화
5. OAuth2 → URL Generator에서 권한 설정:
   • Scopes: bot, applications.commands
   • Bot Permissions: Send Messages, Use Slash Commands

4. 환경변수 설정

.env 파일 생성:

DISCORD_BOT_TOKEN=your_bot_token_here

5. 실행

# 가상환경 활성화 후 실행
python main.py

# 또는 uv로 직접 실행 (권장)
uv run main.py

사용법

기본 워크플로우

1. 할일 추가: /study add content:"알고리즘 문제 풀기"
2. 공부 시작: /study start content:"알고리즘 문제 풀기" (Todo 목록에서 선택)
3. 공부 완료: /study done complete:True (Todo 자동 완료)
4. 진행 확인: /study status

명령어 상세

할일 관리

/study add content:"할일 내용"     # 새 할일 추가
/study list                      # 할일 목록 보기

공부 관리

/study start content:"과목"      # 공부 시작 (Todo 목록에서 과목 선택)
/study done complete:True        # 공부 완료 및 Todo 완료 처리
/study done complete:False       # 공부 완료하지만 Todo는 미완료 유지
/study status                    # 현재 상태 확인

기술 스택

• Python 3.13 - 최신 타입 힌트 지원
• discord.py 2.6+ - 디스코드 API 래퍼
• dataclasses - 타입 안전한 데이터 구조
• python-dotenv - 환경변수 관리

향후 계획

• 휴식 기능 추가
• 그룹 스터디 기능 확장
• 통계 대시보드
• 데이터 백업/복원
• 웹 인터페이스