🏆 IBM AI Hackathon 최우수상 수상

대학생이 자연어로 입력한 할 일(과제, 시험, 팀플, 대외활동 등)을 AI가 자동으로 분석·분류하고, 중요도와 마감기한을 고려해 우선순위를 추천하는 스마트 학습 도우미입니다.

본 프로젝트는 IBM AI Hackathon에서 시작되었으며, 이후 별도의 레포지토리에서 기능 고도화 및 구조 개선을 지속하고 있습니다.

• 자연어 일정 추가: "다음 주 수요일까지 자료구조 과제" → AI가 자동 파싱하여 일정 등록
• 다중 일정 처리: 여러 일정을 한 번에 인식하고 개별 확인/취소 가능
• 알림 예약: "회의 10분 전에 알림 예약해줘" → 일정 선택 후 푸시 알림 자동 예약
• 우선순위 추천: "우선순위 높은 일정 추천해줘" → 중요 일정 목록 표시
• 일정 검색/조회: "이번 주 일정 알려줘", "오늘 할 일 뭐야?"

• 일일 브리핑: "오늘 일정 요약해줘" → AI가 오늘 일정을 분석하여 브리핑
• 주간 요약: "이번 주 어땠어?" → 완료율, 카테고리별 통계, 가장 바쁜 날 분석
• 일정 충돌 감지: "겹치는 일정 있어?" → 향후 2주간 시간이 겹치는 일정 자동 탐지
• 스마트 시간 추천: "과제 언제 하면 좋을까?" → 사용자 패턴 기반 최적 시간 제안
• 다중 일정 일괄 생성: "내일 10시 회의, 2시 발표, 5시 스터디" → 충돌 자동 조정
• 우선순위 자동 조정: "우선순위 자동 조정해줘" → 마감일 기반 우선순위 재계산
• 빈 시간대 채우기: "빈 시간 채워줘" → 공강 분석 후 맞춤 할 일 추천
• 할 일 추천/세분화: "중간고사 준비 할 일 추천해줘" → AI 기반 세부 작업 제안

• 시간표 인식: "시간표 사진에 있는 강의 추가해줘" → 대학 시간표 이미지에서 강의 자동 추출
• 시험/과제 일정표 자동 추출: 이미지에서 일정을 인식하여 자동 등록
• 공모전 포스터 분석: 대회 일정, 마감기한, 세부 일정(Sub-task) 자동 생성
• 📚 Syllabus OCR: 강의계획서 PDF/이미지에서 한 학기 과제/시험 일정 일괄 추출

• 월간 캘린더: 전체 일정 한눈에 확인, 날짜별 일정 표시
• 주간 시간표: 강의 시간표 관리, 드래그 앤 드롭으로 시간 수정
• Google Calendar 연동: 외부 캘린더와 동기화 (설정에서 연결)

• 백엔드 알림 API: 알림 예약, 조회, 확인 처리
• 실시간 SSE 스트리밍: Server-Sent Events로 실시간 알림 푸시
• 브라우저 푸시 알림: Web Notification API 활용
• 마감 임박 알림: D-day 기반 자동 리마인더
• 토스 스타일 알림 페이지: 깔끔한 알림 목록 UI

• AI 기반 우선순위 추천: 마감기한, 소요 시간, 중요도 분석
• 🎯 공강 시간 학습 챌린지: 빈 시간대 분석 후 맞춤 학습 활동 추천
• 📈 학습 리포트 대시보드: 주간/월간 통계, 예상 vs 실제 시간 비교, AI 피드백
• 카테고리 분류: 수업, 과제, 시험, 팀플, 대외활동 자동 분류
• Sub-task 관리: 큰 일정을 세부 작업으로 분할

• Slack 연동: 일정 알림을 Slack 채널로 전송
• Discord 연동: 일정 알림을 Discord 서버로 전송
• Notion 연동: 일정을 Notion 데이터베이스와 동기화
• 학교 공지사항 크롤링: 대학 공지사항 자동 수집 및 AI 중요도 분류

• JWT 기반 인증: 액세스/리프레시 토큰 관리
• OAuth 2.0 소셜 로그인: Google, Kakao 계정 연동
• RBAC 권한 관리: 역할 기반 접근 제어 (admin, user)

• Prometheus: 서버 메트릭 수집 (HTTP 요청, 응답 시간, DB 쿼리)
• Grafana: 실시간 시각화 대시보드
• 헬스체크: 시스템 상태 모니터링

• React 18.2: UI 라이브러리
• Vite 5.0: 빌드 도구 및 개발 서버
• Axios: HTTP 클라이언트
• React Router: 클라이언트 라우팅
• Web Notification API: 브라우저 푸시 알림

• FastAPI: Python 웹 프레임워크
• MySQL 8.0: 관계형 데이터베이스
• Redis: 캐싱 및 메시지 브로커
• Celery: 비동기 작업 큐
• Alembic: 데이터베이스 마이그레이션
• SQLAlchemy: ORM
• Pydantic: 데이터 검증

• Google Gemini AI: 자연어 처리, 이미지 분석, 일정 추천
• Google Calendar API: 캘린더 연동
• OAuth 2.0: Google, Kakao 소셜 로그인

• Docker & Docker Compose: 컨테이너화
• Prometheus: 메트릭 수집
• Grafana: 시각화 대시보드
• GitHub: 버전 관리

• IBM AI Hackathon에서 팀 단위로 참여하여 초기 아이디어 도출 및 MVP 구현

• 손민주, 조하영
• Frontend / Backend / AI 연동을 포함한 Full-Stack 전반을 공동으로 작업
• 역할 구분 없이 기능 설계, 구현, 리팩토링을 함께 진행

# 프로젝트 클론
git clone https://github.com/OurInvestory/today-schedule.git
cd today-schedule

# .env 파일 설정 (아래 환경 변수 참고)

# Docker Compose로 실행
docker-compose up -d --build

# 접속
# Frontend: http://localhost:5173
# Backend API: http://localhost:8000
# API 문서: http://localhost:8000/docs
# Prometheus: http://localhost:9090
# Grafana: http://localhost:3000 (admin/admin123)

# MySQL Database
MYSQL_ROOT_PASSWORD=root_password_change_this
MYSQL_DATABASE=five_schedule_db
MYSQL_USER=five_user
MYSQL_PASSWORD=five_password_change_this
DATABASE_URL=mysql+pymysql://five_user:five_password_change_this@db:3306/five_schedule_db

# Redis (캐싱 및 Celery 브로커)
REDIS_URL=redis://redis:6379/0
CELERY_BROKER_URL=redis://redis:6379/1
CELERY_RESULT_BACKEND=redis://redis:6379/2

# JWT Authentication
SECRET_KEY=your-secret-key-change-in-production-very-long-and-secure
JWT_SECRET_KEY=your-jwt-secret-key-change-in-production

# Google Gemini API
GOOGLE_API_KEY=your_google_api_key_here
GEMINI_MODEL_NAME=gemini-2.5-flash

# Google OAuth (소셜 로그인)
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret

# Kakao OAuth (소셜 로그인)
KAKAO_CLIENT_ID=your_kakao_client_id
KAKAO_CLIENT_SECRET=your_kakao_client_secret

# Google Calendar API (선택)
GOOGLE_CALENDAR_CLIENT_ID=
GOOGLE_CALENDAR_CLIENT_SECRET=

# Frontend
VITE_API_URL=http://localhost:8000
FRONTEND_URL=http://localhost:5173

# External Integrations (외부 서비스 연동)
SLACK_WEBHOOK_URL=
DISCORD_WEBHOOK_URL=
NOTION_API_KEY=
NOTION_DATABASE_ID=

# Grafana (모니터링 대시보드)
GF_SECURITY_ADMIN_USER=admin
GF_SECURITY_ADMIN_PASSWORD=admin123

cd frontend
npm install
npm run dev
# http://localhost:5173 에서 확인

cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload
# http://localhost:8000 에서 확인

today-schedule/
├── frontend/               # React 프론트엔드
│   ├── src/
│   │   ├── components/     # 재사용 컴포넌트
│   │   │   ├── calendar/   # 캘린더 관련
│   │   │   ├── chatbot/    # AI 챗봇
│   │   │   ├── common/     # 공통 컴포넌트
│   │   │   ├── layout/     # 레이아웃
│   │   │   └── todo/       # 할 일 관리
│   │   ├── pages/          # 페이지 컴포넌트
│   │   ├── hooks/          # 커스텀 훅
│   │   ├── services/       # API 서비스
│   │   ├── context/        # React Context
│   │   └── utils/          # 유틸리티 함수
│   └── ...
├── backend/                # FastAPI 백엔드
│   ├── app/
│   │   ├── api/            # API 라우터
│   │   ├── core/           # 핵심 기능 (인증, 캐시, Celery, 이벤트버스, 모니터링)
│   │   ├── models/         # SQLAlchemy 모델
│   │   ├── schemas/        # Pydantic 스키마
│   │   ├── services/       # 비즈니스 로직 (챌린지, 리포트, OCR, 크롤러, 연동)
│   │   └── db/             # 데이터베이스 설정
│   ├── alembic/            # DB 마이그레이션
│   └── ...
├── monitoring/             # 모니터링 설정
│   ├── prometheus.yml      # Prometheus 설정
│   └── grafana/
│       └── provisioning/   # Grafana 자동 프로비저닝
│           ├── datasources/
│           └── dashboards/
└── docker-compose.yml      # Docker 설정

This project is licensed under the MIT License.