QR Manager

QR 코드를 통한 다양한 컨텐츠 관리 시스템

프로젝트 소개

QR Manager는 다양한 형태의 컨텐츠를 QR 코드로 손쉽게 관리할 수 있는 웹 기반 시스템입니다.

사용자는 텍스트, 이미지, 비디오, 주소, 연락처, 미니게임, 현재위치 등 다양한 형태의 컨텐츠를 업로드하고 이에 대한 고유한 QR 코드를 자동으로 생성받을 수 있습니다.

특히 미니게임(퀴즈) 기능을 통해 교육용 컨텐츠 제작이 가능하며 실시간 랭킹 시스템으로 사용자들의 참여를 유도할 수 있습니다.

목차

• 주요 기능
• 기술 스택
• 기능 미리보기
• 시작하기
• 주요 API
• 보안 기능
• 지원

주요 기능

1. 다양한 컨텐츠 타입 지원

• 텍스트
• 이미지
• 비디오
• 주소/URL
• 연락처(vCard)
• 위치 정보
• 미니게임(퀴즈)

2. QR 코드 생성

• 각 컨텐츠에 대한 고유 QR 코드 자동 생성
• Base64 인코딩 지원
• 안전한 파일명 처리

3. 미니게임(퀴즈) 기능

• 다양한 주제의 퀴즈 제공
• 실시간 점수 계산
• 상위 10위까지 랭킹 시스템
• 모바일 친화적 UI

기술 스택

Backend

Frontend

기능 미리보기

1. QR 생성

• 주소 QR 생성

• 텍스트 QR 생성

• 이미지 QR 생성

• 동영상 QR 생성

• 연락처 QR 생성

• 미니게임 QR 생성

• 현재 위치 QR 생성

2. QR 스캔

주소	텍스트	연락처

이미지	동영상

미니게임	현재 위치

시작하기

요구사항

• JDK 17 이상
• Maven
• H2 Database

설치 및 실행

1. 저장소 클론

git clone https://github.com/kjunh972/QRManager.git

2. 프로젝트 디렉토리로 이동

cd QRManager

3. Maven으로 빌드

./mvnw clean package

4. 애플리케이션 실행

java -jar target/QRManager-0.0.1-SNAPSHOT.jar

5. 브라우저에서 접속

http://localhost:8056

주요 API

컨텐츠 관리

• POST /upload - 새로운 컨텐츠 업로드 및 QR 코드 생성
• GET /view/{id} - 컨텐츠 조회
• GET /uploads/{filename} - 업로드된 파일 조회

퀴즈 게임

• GET /QuizJun - 퀴즈 게임 페이지
• POST /api/quiz/score - 퀴즈 점수 저장
• GET /api/quiz/leaderboard - 랭킹 조회

보안 기능

• 파일 업로드 크기 제한 (최대 50MB)
• 안전한 파일명 처리
• MIME 타입 검증
• XSS 방지

지원