Skip to content

KKPASII/QuizJam

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

QuizJam 🎯

AI 기반 PDF 퀴즈 생성 & 실시간 퀴즈 서비스


🔥 프로젝트 소개

QuizJam은 PDF 문서를 기반으로 AI가 퀴즈를 자동 생성하고,
사용자가 퀴즈를 풀 수 있는 학습 보조 서비스입니다.

  • PDF → 텍스트 추출
  • AI 기반 문제 생성
  • 퀴즈 데이터 관리

🎥 시연 영상 (Click!)

Demo Video

🧩 아키텍처

img.png

  • Frontend (Vue): 사용자 화면, PDF 업로드, 퀴즈 풀이
  • Backend (Spring Boot): 인증, PDF 처리, 퀴즈 생성, 데이터 관리
  • OpenAI API: PDF 기반 문제 생성
  • MySQL: 사용자/퀴즈/문항/결과 저장

🚀 주요 기능

  • 📄 PDF 업로드 및 텍스트 추출
  • 🤖 OpenAI 기반 퀴즈 자동 생성
  • 🧠 객관식 / 주관식 문제 생성
  • 📊 퀴즈 데이터 저장 및 조회
  • 🔐 JWT 기반 인증 시스템

🛠 기술 스택

  • Backend: Java 17, Spring Boot
  • Database: MySQL, H2(Test)
  • ORM: Spring Data JPA
  • Auth: JWT
  • AI: OpenAI API
  • PDF 처리: Apache PDFBox

🛠 기술 스택

⚙️ Language / Backend

Java Spring Boot

🗄️ Database / ORM

MySQL H2 JPA

🔐 Auth

JWT

🤖 AI / PDF

OpenAI PDFBox


⚡ 트러블슈팅(?)

PDF 입력 길이 제어 문제

  • 문제: 대용량 PDF를 그대로 프롬프트에 포함하면 토큰 수가 과도하게 증가해 응답 지연 또는 요청 실패 가능성이 있었습니다.
  • 해결:
    • PDF 전체 텍스트를 추출한 뒤
    • 프롬프트 지시문 토큰 수를 먼저 계산하고
    • 남은 토큰 한도에 맞춰 PDF 본문을 잘라내는 방식으로 입력 길이를 제어했습니다.

About

"AI 기반 PDF 퀴즈 생성 & 실시간 퀴즈 서비스"

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages