Merge branch 'develop' into feature/user

common/src/main/java/com/kt/event/common/exception/ErrorCode.java

@@ -18,6 +18,10 @@ public enum ErrorCode {
     COMMON_004("COMMON_004", "서버 내부 오류가 발생했습니다"),
     COMMON_005("COMMON_005", "지원하지 않는 작업입니다"),
 
+    // 일반 에러 상수 (Legacy 호환용)
+    NOT_FOUND("NOT_FOUND", "요청한 리소스를 찾을 수 없습니다"),
+    INVALID_INPUT_VALUE("INVALID_INPUT_VALUE", "유효하지 않은 입력값입니다"),
+
     // 인증/인가 에러 (AUTH_XXX)
     AUTH_001("AUTH_001", "인증에 실패했습니다"),
     AUTH_002("AUTH_002", "유효하지 않은 토큰입니다"),
@@ -64,11 +68,14 @@ public enum ErrorCode {
     DIST_004("DIST_004", "배포 상태를 찾을 수 없습니다"),
 
     // 참여 에러 (PART_XXX)
-    PART_001("PART_001", "이미 참여한 이벤트입니다"),
-    PART_002("PART_002", "이벤트 참여 기간이 아닙니다"),
-    PART_003("PART_003", "참여자를 찾을 수 없습니다"),
-    PART_004("PART_004", "당첨자 추첨에 실패했습니다"),
-    PART_005("PART_005", "이벤트가 종료되었습니다"),
+    DUPLICATE_PARTICIPATION("PART_001", "이미 참여한 이벤트입니다"),
+    EVENT_NOT_ACTIVE("PART_002", "이벤트 참여 기간이 아닙니다"),
+    PARTICIPANT_NOT_FOUND("PART_003", "참여자를 찾을 수 없습니다"),
+    DRAW_FAILED("PART_004", "당첨자 추첨에 실패했습니다"),
+    EVENT_ENDED("PART_005", "이벤트가 종료되었습니다"),
+    ALREADY_DRAWN("PART_006", "이미 당첨자 추첨이 완료되었습니다"),
+    INSUFFICIENT_PARTICIPANTS("PART_007", "참여자 수가 당첨자 수보다 적습니다"),
+    NO_WINNERS_YET("PART_008", "아직 당첨자 추첨이 진행되지 않았습니다"),
 
     // 분석 에러 (ANALYTICS_XXX)
     ANALYTICS_001("ANALYTICS_001", "분석 데이터를 찾을 수 없습니다"),

common/src/main/java/com/kt/event/common/exception/GlobalExceptionHandler.java

@@ -2,6 +2,8 @@ package com.kt.event.common.exception;
 
 import com.kt.event.common.dto.ErrorResponse;
 import lombok.extern.slf4j.Slf4j;
+import org.springframework.dao.DataIntegrityViolationException;
+import org.springframework.data.mapping.PropertyReferenceException;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
 import org.springframework.security.access.AccessDeniedException;
@@ -161,6 +163,66 @@ public class GlobalExceptionHandler {
                 .body(errorResponse);
     }
 
+    /**
+     * 데이터 무결성 제약 위반 예외 처리
+     *
+     * @param ex 데이터 무결성 예외
+     * @return 에러 응답
+     */
+    @ExceptionHandler(DataIntegrityViolationException.class)
+    public ResponseEntity<ErrorResponse> handleDataIntegrityViolationException(DataIntegrityViolationException ex) {
+        log.warn("Data integrity violation: {}", ex.getMessage());
+
+        String message = "데이터 중복 또는 무결성 제약 위반이 발생했습니다";
+        String details = ex.getMessage();
+
+        // 중복 키 에러인 경우 메시지 개선
+        if (ex.getMessage() != null) {
+            if (ex.getMessage().contains("uk_event_phone") || ex.getMessage().contains("phone_number")) {
+                message = "이미 참여하신 이벤트입니다";
+                details = "동일한 전화번호로 이미 참여 기록이 있습니다";
+            } else if (ex.getMessage().contains("participant_id")) {
+                message = "참여 처리 중 오류가 발생했습니다";
+                details = "잠시 후 다시 시도해주세요";
+            }
+        }
+
+        ErrorResponse errorResponse = ErrorResponse.of(
+                ErrorCode.DUPLICATE_PARTICIPATION.getCode(),
+                message,
+                details
+        );
+
+        return ResponseEntity
+                .status(HttpStatus.CONFLICT)
+                .body(errorResponse);
+    }
+
+    /**
+     * 잘못된 정렬 필드 예외 처리
+     *
+     * @param ex 속성 참조 예외
+     * @return 에러 응답
+     */
+    @ExceptionHandler(PropertyReferenceException.class)
+    public ResponseEntity<ErrorResponse> handlePropertyReferenceException(PropertyReferenceException ex) {
+        log.warn("Invalid sort property: {}", ex.getMessage());
+
+        String message = "잘못된 정렬 필드입니다";
+        String details = String.format("'%s' 필드는 존재하지 않습니다. 사용 가능한 필드: id, participantId, eventId, name, phoneNumber, email, storeVisited, bonusEntries, agreeMarketing, agreePrivacy, isWinner, winnerRank, wonAt, createdAt, updatedAt",
+                ex.getPropertyName());
+
+        ErrorResponse errorResponse = ErrorResponse.of(
+                ErrorCode.COMMON_003.getCode(),
+                message,
+                details
+        );
+
+        return ResponseEntity
+                .status(HttpStatus.BAD_REQUEST)
+                .body(errorResponse);
+    }
+
     /**
      * 일반 예외 처리
      *

common/src/main/java/com/kt/event/common/security/JwtTokenProvider.java

@@ -12,6 +12,7 @@ import javax.crypto.SecretKey;
 import java.nio.charset.StandardCharsets;
 import java.util.Date;
 import java.util.List;
+import java.util.UUID;
 
 /**
  * JWT 토큰 생성 및 검증 제공자
@@ -55,6 +56,7 @@ public class JwtTokenProvider {
      * @param roles  역할 목록
      * @return Access Token
      */
+
     public String createAccessToken(Long userId, Long storeId, String email, String name, List<String> roles) {
         Date now = new Date();
         Date expiryDate = new Date(now.getTime() + accessTokenValidityMs);
@@ -78,7 +80,7 @@ public class JwtTokenProvider {
      * @param userId 사용자 ID
      * @return Refresh Token
      */
-    public String createRefreshToken(Long userId) {
+    public String createRefreshToken(UUID userId) {
         Date now = new Date();
         Date expiryDate = new Date(now.getTime() + refreshTokenValidityMs);
 
@@ -97,9 +99,9 @@ public class JwtTokenProvider {
      * @param token JWT 토큰
      * @return 사용자 ID
      */
-    public Long getUserIdFromToken(String token) {
+    public UUID getUserIdFromToken(String token) {
         Claims claims = parseToken(token);
-        return Long.parseLong(claims.getSubject());
+        return UUID.fromString(claims.getSubject());
     }
 
     /**

common/src/main/java/com/kt/event/common/security/UserPrincipal.java

@@ -1,6 +1,7 @@
 package com.kt.event.common.security;
 
 import lombok.AllArgsConstructor;
+import lombok.Builder;
 import lombok.Getter;
 import org.springframework.security.core.GrantedAuthority;
 import org.springframework.security.core.authority.SimpleGrantedAuthority;
@@ -8,6 +9,7 @@ import org.springframework.security.core.userdetails.UserDetails;
 
 import java.util.Collection;
 import java.util.List;
+import java.util.UUID;
 import java.util.stream.Collectors;
 
 /**
@@ -15,13 +17,19 @@ import java.util.stream.Collectors;
  * JWT 토큰에서 추출한 사용자 정보를 담는 객체
  */
 @Getter
+@Builder
 @AllArgsConstructor
 public class UserPrincipal implements UserDetails {
 
     /**
      * 사용자 ID
      */
-    private final Long userId;
+    private final UUID userId;
+
+    /**
+     * 매장 ID
+     */
+    private final UUID storeId;
 
     /**
      * 매장 ID