Skip to content

README.md

Latest commit

 

History

History
93 lines (78 loc) · 3.36 KB

README.md

File metadata and controls

93 lines (78 loc) · 3.36 KB

CS Study Platform

CS 공부를 웹 사이트, 카테고리별 학습, AI 채점, AI 챗봇, Slack 리마인드 봇을 제공합니다. image

주요 기능

웹 플랫폼

  • 카테고리별 학습 - DB, 자료구조, 운영체제, 네트워크, 알고리즘, 소프트웨어공학, Spring, Java 등 11개 카테고리
  • 질문 & 답변 - 마크다운 기반 CS 면접 질문과 모범 답안 (109문항)
  • AI 채점 - 직접 답변을 작성하면 키워드 기반으로 채점 및 피드백
  • 카오스 고양이 AI 챗봇 - Gemini 2.0 Flash 기반 CS 면접 Q&A 챗봇. DB의 학습 자료를 컨텍스트로 활용하여 정확한 답변 제공
  • 학습 통계 - 진행률, 카테고리별 학습 현황, 점수 분포 등
  • 검색 - 질문 제목/내용 통합 검색
  • 북마크 - 중요한 질문 저장
  • 면접 연습 - 웹캠/마이크를 활용한 실전 면접 연습
  • 오프라인 대응 - 백엔드 서버가 다운되어도 하드코딩된 콘텐츠로 학습 가능

Slack 리마인드 봇

  • 하루 2회 알림
  • 요일별 카테고리 스케줄
요일 카테고리
월 운영체제
화 네트워크
수 소프트웨어공학
목 DB
금 DB
토 Java
일 Java
  • 가장 덜 학습한 질문 3개 + 정답 미리보기 전송
  • 매주 월요일 주간 학습 리포트 전송

기술 스택

구분 기술
Frontend React 19, Vite 8, Axios
Backend Spring Boot 3.2, Spring Data JPA
Database PostgreSQL
AI Google Gemini 2.0 Flash
배포 Vercel (Frontend), Render (Backend + DB)
알림 Slack Incoming Webhooks

프로젝트 구조

cs-study-platform/
├── frontend/          # React + Vite 프론트엔드
│   └── src/
│       ├── pages/     # Home, Category, Question, Stats, InterviewPractice
│       ├── components/# Layout, ChaosChat (AI 챗봇)
│       ├── hardcodedData.js  # 오프라인 fallback 데이터
│       └── api.js     # Axios 설정
├── backend/           # Spring Boot 백엔드
│   └── src/main/java/com/csstudy/backend/
│       ├── config/    # CORS, 캐시, 데이터 초기화
│       ├── controller/# REST API + Chat 컨트롤러
│       ├── service/   # 비즈니스 로직, ChatService, Slack 서비스
│       ├── entity/    # JPA 엔티티
│       ├── repository/# Spring Data JPA
│       └── scheduler/ # Slack 스케줄러
├── content/           # 마크다운 CS 질문 콘텐츠 (109문항)
├── review/            # 복습용 개념 정리 노트
└── render.yaml        # Render 배포 설정

로컬 실행

Backend

cd backend
./gradlew bootRun

Frontend

cd frontend
npm install
npm run dev

환경변수

변수 설명 필수
VITE_API_URL 백엔드 API URL (프론트엔드) X (기본값 있음)
GEMINI_API_KEY Google Gemini API 키 (백엔드) X (없으면 fallback)
JDBC_DATABASE_URL PostgreSQL 접속 URL O
SLACK_WEBHOOK_URL Slack 웹훅 URL X
SLACK_ENABLED Slack 알림 활성화 X (기본 false)