feat: 티켓 QR JWT 토큰 발급 & 검증 & 사용 완료 처리

* feat: Qr 초반 클래스 설정

* feat: QrTokenService 완성

* feat: qr controller 완성

* feat: qr controller 완성

* feat: securityConfig 설정

* refactor: issuedAt 변경

* feat: Transactional

* fix: redis bean 명시

* fix: 테스트코드 수정

* feat: qr url 변경

* feat: api 설명 수정

* feat: redis template 이름 변경

* feat: verfiy api 관리자 변경 고려 TODO 작성

Author: kimeunkyoungg

backend/src/main/java/com/back/api/auth/service/ActiveSessionCache.java

@@ -37,7 +37,7 @@ public class ActiveSessionCache {
 	private final ActiveSessionRepository activeSessionRepository;
 
 	public ActiveSessionCache(
-		@Qualifier("activeSessionRedisTemplate") RedisTemplate<String, String> redisTemplate,
+		@Qualifier("stringTemplate") RedisTemplate<String, String> redisTemplate,
 		ActiveSessionRepository activeSessionRepository
 	) {
 		this.redisTemplate = redisTemplate;

backend/src/main/java/com/back/api/queue/service/QueueEntryReadService.java

@@ -103,7 +103,7 @@ public WaitingQueueResponse buildWaitingQueueResponseFromRank(
 			estimatedWaitTime = 1;
 			progress = 99;
 		} else {
-			estimatedWaitTime = waitingAhead * 3;
+			estimatedWaitTime = waitingAhead * 2;
 			progress = totalWaitingCount > 0
 				? (int)(((totalWaitingCount - waitingAhead) * 100) / totalWaitingCount)
 				: 0;

backend/src/main/java/com/back/api/ticket/controller/QrApi.java

@@ -0,0 +1,46 @@
+package com.back.api.ticket.controller;
+
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import com.back.api.ticket.dto.response.QrTokenResponse;
+import com.back.api.ticket.dto.response.QrValidationResponse;
+import com.back.global.config.swagger.ApiErrorCode;
+import com.back.global.response.ApiResponse;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+@Tag(name = "QR API", description = "티켓 QR 발급 및 검증 API")
+public interface QrApi {
+
+	@Operation(
+		summary = "QR 토큰 발급",
+		description = "티켓에 대한 QR 토큰을 발급합니다. 이벤트 당일부터 발급이 됩니다."
+	)
+	@ApiErrorCode({
+		"TICKET_NOT_FOUND",
+		"UNAUTHORIZED_TICKET_ACCESS",
+		"INVALID_TICKET_STATE",
+		"EVENT_NOT_STARTED"
+	})
+	ApiResponse<QrTokenResponse> generateQrToken(
+		@Parameter(description = "티켓 ID", example = "1")
+		@PathVariable Long ticketId
+	);
+
+	@Operation(
+		summary = "QR 코드 검증",
+		description = "QR을 스캔하고 입장 가능 여부를 검증합니다."
+	)
+	@ApiErrorCode({
+		"INVALID_QR_TOKEN",
+		"QR_TOKEN_EXPIRED",
+		"TICKET_NOT_FOUND"
+	})
+	ApiResponse<QrValidationResponse> validateQrCode(
+		@Parameter(description = "QR 토큰", example = "abc123xyz456")
+		@RequestParam String token
+	);
+}

backend/src/main/java/com/back/api/ticket/controller/QrController.java

@@ -0,0 +1,47 @@
+package com.back.api.ticket.controller;
+
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import com.back.api.ticket.dto.response.QrTokenResponse;
+import com.back.api.ticket.dto.response.QrValidationResponse;
+import com.back.api.ticket.service.QrService;
+import com.back.global.http.HttpRequestContext;
+import com.back.global.response.ApiResponse;
+
+import lombok.RequiredArgsConstructor;
+
+@RestController
+@RequestMapping("/api/v1/tickets")
+@RequiredArgsConstructor
+public class QrController implements QrApi {
+
+	private final QrService qrService;
+	private final HttpRequestContext httpRequestContext;
+
+	@Override
+	@PostMapping("/{ticketId}/qr-token")
+	public ApiResponse<QrTokenResponse> generateQrToken(
+		@PathVariable Long ticketId
+	){
+		Long userId = httpRequestContext.getUserId();
+		QrTokenResponse response = qrService.generateQrTokenResponse(ticketId, userId);
+
+		return ApiResponse.ok("QR 토큰 발급 성공", response);
+	}
+
+	//TODO 관리자 전용 API로 변경 고려
+	@Override
+	@GetMapping("/entry/verify")
+	public ApiResponse<QrValidationResponse> validateQrCode(
+		@RequestParam String token
+	){
+		QrValidationResponse response = qrService.validateAndProcessEntry(token);
+
+		return ApiResponse.ok("QR 코드 검증 & 사용 처리 성공", response);
+	}
+}

backend/src/main/java/com/back/api/ticket/dto/response/QrTokenResponse.java

@@ -0,0 +1,20 @@
+package com.back.api.ticket.dto.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+
+@Schema(description = "QR 토큰 응답 DTO")
+public record QrTokenResponse(
+	@Schema(description = "QR에 포함될 JWT 토큰", example = "abc123xyz456")
+	String qrToken,
+
+	@Schema(description = "토큰 만료 시간(초)", example = "60")
+	int expirationSecond,
+
+	@Schema(description = "QR 코드 갱신 간격(초)", example = "30")
+	int refreshIntervalSecond,
+
+	@Schema(description = "QR 코드 URL", example = "https://www.waitfair.com/tickets/verifiy?token=abc123xyz456")
+	String qrUrl
+
+) {
+}

backend/src/main/java/com/back/api/ticket/dto/response/QrValidationResponse.java

@@ -0,0 +1,38 @@
+package com.back.api.ticket.dto.response;
+
+import java.time.LocalDateTime;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+
+@Schema(description = "QR 검증 응답 DTO")
+public record QrValidationResponse(
+
+	@Schema(description = "QR 유효 여부", example = "true")
+	boolean isValid,
+
+	@Schema(description = "상태 메세지", example = "QR 코드가 유효합니다.")
+	String message,
+
+	@Schema(description = "티켓 ID", example = "1")
+	Long ticketId,
+
+	@Schema(description = "이벤트 ID", example = "1")
+	Long eventId,
+
+	@Schema(description = "이벤트 제목", example = "2024 콘서트")
+	String eventTitle,
+
+	@Schema(description = "좌석 코드", example = "A1")
+	String seatCode,
+
+	@Schema(description = "소유자 닉네임", example = "testnick")
+	String ownerNickname,
+
+	@Schema(description = "이벤트 일시", example = "2026-01-31T20:00:00")
+	LocalDateTime eventDate,
+
+	@Schema(description = "QR 코드 발급 시간", example = "2026-01-31T12:00:00")
+	LocalDateTime qrIssuedAt
+
+) {
+}