Home

⚙️ Backend Wiki — 크누피(QuizFlow)

크누피 백엔드(Spring Boot 3.5 · Java 21)의 개발 위키입니다.

빠른 링크

• 📚 API Reference — REST + WebSocket 전수 명세
• 🗺️ Roadmap — 스프린트 · 백로그 (Gantt)
• 📐 구현 아키텍처
• 🤝 기여 가이드

한눈에

• 인증: Spring Security 미사용 — AuthInterceptor + HttpSession + @LoginUser
• 실시간: STOMP over WebSocket(/ws, SockJS), /topic/session/{id}/…
• AI: Google Gemini gemini-2.5-flash-lite (텍스트/PDF → 퀴즈, 해설)
• 관측: Actuator + Micrometer Prometheus (관리 포트 8081)

로컬 실행

./gradlew build      # 빌드 + 테스트
./gradlew bootRun    # 실행 (기본 H2)

도메인 모델

User 1─N Quiz 1─N Question
GameSession N─1 Quiz · 1─N Participant 1─N Answer N─1 Question