merge: 도어용 유저 티켓 검증 API 구현 - #135

sjk4618 · web-flow · commit a9db90260aa3 · 2025-09-26T10:46:07.000+09:00
feat: 도어용 유저 티켓 검증 API 구현 - #135
diff --git a/src/main/java/com/permitseoul/permitserver/domain/ticket/api/controller/TicketController.java b/src/main/java/com/permitseoul/permitserver/domain/ticket/api/controller/TicketController.java
@@ -1,5 +1,6 @@
 package com.permitseoul.permitserver.domain.ticket.api.controller;
 
+import com.permitseoul.permitserver.domain.ticket.api.dto.req.TicketConfirmRequest;
 import com.permitseoul.permitserver.domain.ticket.api.service.TicketService;
 import com.permitseoul.permitserver.domain.ticket.core.domain.TicketStatus;
 import com.permitseoul.permitserver.domain.ticket.core.domain.TicketUsability;
@@ -8,12 +9,11 @@
 import com.permitseoul.permitserver.global.response.ApiResponseUtil;
 import com.permitseoul.permitserver.global.response.BaseResponse;
 import com.permitseoul.permitserver.global.response.code.SuccessCode;
+import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import org.springframework.data.repository.query.Param;
 import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.bind.annotation.*;
 
 import java.time.LocalDateTime;
 
@@ -31,11 +31,20 @@ public ResponseEntity<BaseResponse<?>> getEventTicketInfo(
         return ApiResponseUtil.success(SuccessCode.OK, ticketService.getEventTicketInfo(eventId, LocalDateTime.now()));
     }
 
-    //구매한 티켓 정보 조회
+    //구매한 티켓 정보 조회 api
     @GetMapping("/user")
     public ResponseEntity<BaseResponse<?>> getUserBuyTicketInfo(
             @UserIdHeader final Long userId
     ) {
         return ApiResponseUtil.success(SuccessCode.OK, ticketService.getUserBuyTicketInfo(userId));
     }
+
+    //도어용 티켓 검증 api
+    @PostMapping("/confirm")
+    public ResponseEntity<BaseResponse<?>> getUserBuyTicketInfo(
+            @RequestBody @Valid TicketConfirmRequest ticketConfirmRequest
+    ) {
+        ticketService.confirmTicket(ticketConfirmRequest.ticketCode(), ticketConfirmRequest.checkCode());
+        return ApiResponseUtil.success(SuccessCode.OK);
+    }
 }
diff --git a/src/main/java/com/permitseoul/permitserver/domain/ticket/api/dto/req/TicketConfirmRequest.java b/src/main/java/com/permitseoul/permitserver/domain/ticket/api/dto/req/TicketConfirmRequest.java
@@ -0,0 +1,12 @@
+package com.permitseoul.permitserver.domain.ticket.api.dto.req;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record TicketConfirmRequest(
+        @NotBlank(message = "ticketCode가 비어있습니다.")
+        String ticketCode,
+
+        @NotBlank(message = "checkCode가 비어있습니다.")
+        String checkCode
+) {
+}
diff --git a/src/main/java/com/permitseoul/permitserver/domain/ticket/api/dto/res/EventTicketInfoResponse.java b/src/main/java/com/permitseoul/permitserver/domain/ticket/api/dto/res/EventTicketInfoResponse.java
@@ -1,4 +1,4 @@
-package com.permitseoul.permitserver.domain.ticket.api.dto;
+package com.permitseoul.permitserver.domain.ticket.api.dto.res;
 
 import java.util.List;
 
diff --git a/src/main/java/com/permitseoul/permitserver/domain/ticket/api/dto/res/UserBuyTicketInfoResponse.java b/src/main/java/com/permitseoul/permitserver/domain/ticket/api/dto/res/UserBuyTicketInfoResponse.java
@@ -1,9 +1,9 @@
-package com.permitseoul.permitserver.domain.ticket.api.dto;
+package com.permitseoul.permitserver.domain.ticket.api.dto.res;
 
 
 import java.util.List;
 
-public record UserBuyTicketInfo(
+public record UserBuyTicketInfoResponse(
         List<Order> orders
 ) {
     public record Order(
diff --git a/src/main/java/com/permitseoul/permitserver/domain/ticket/api/exception/ConflictTicketException.java b/src/main/java/com/permitseoul/permitserver/domain/ticket/api/exception/ConflictTicketException.java
@@ -0,0 +1,9 @@
+package com.permitseoul.permitserver.domain.ticket.api.exception;
+
+import com.permitseoul.permitserver.global.response.code.ErrorCode;
+
+public class ConflictTicketException extends TicketApiException {
+  public ConflictTicketException(ErrorCode errorCode) {
+    super(errorCode);
+  }
+}
diff --git a/src/main/java/com/permitseoul/permitserver/domain/ticket/api/exception/DateTicketException.java b/src/main/java/com/permitseoul/permitserver/domain/ticket/api/exception/DateTicketException.java
@@ -0,0 +1,9 @@
+package com.permitseoul.permitserver.domain.ticket.api.exception;
+
+import com.permitseoul.permitserver.global.response.code.ErrorCode;
+
+public class DateTicketException extends TicketApiException {
+    public DateTicketException(ErrorCode errorCode) {
+        super(errorCode);
+    }
+}
diff --git a/src/main/java/com/permitseoul/permitserver/domain/ticket/api/exception/IllegalTicketException.java b/src/main/java/com/permitseoul/permitserver/domain/ticket/api/exception/IllegalTicketException.java
@@ -0,0 +1,9 @@
+package com.permitseoul.permitserver.domain.ticket.api.exception;
+
+import com.permitseoul.permitserver.global.response.code.ErrorCode;
+
+public class IllegalTicketException extends TicketApiException {
+    public IllegalTicketException(ErrorCode errorCode) {
+        super(errorCode);
+    }
+}
diff --git a/src/main/java/com/permitseoul/permitserver/domain/ticket/api/service/TicketService.java b/src/main/java/com/permitseoul/permitserver/domain/ticket/api/service/TicketService.java
@@ -2,14 +2,21 @@
 
 import com.permitseoul.permitserver.domain.event.core.component.EventRetriever;
 import com.permitseoul.permitserver.domain.event.core.domain.Event;
+import com.permitseoul.permitserver.domain.event.core.exception.EventNotfoundException;
 import com.permitseoul.permitserver.domain.payment.core.component.PaymentRetriever;
 import com.permitseoul.permitserver.domain.payment.core.domain.Payment;
-import com.permitseoul.permitserver.domain.ticket.api.dto.EventTicketInfoResponse;
-import com.permitseoul.permitserver.domain.ticket.api.dto.UserBuyTicketInfo;
+import com.permitseoul.permitserver.domain.ticket.api.dto.res.EventTicketInfoResponse;
+import com.permitseoul.permitserver.domain.ticket.api.dto.res.UserBuyTicketInfoResponse;
+import com.permitseoul.permitserver.domain.ticket.api.exception.ConflictTicketException;
+import com.permitseoul.permitserver.domain.ticket.api.exception.DateTicketException;
+import com.permitseoul.permitserver.domain.ticket.api.exception.IllegalTicketException;
 import com.permitseoul.permitserver.domain.ticket.api.exception.NotFoundTicketException;
 import com.permitseoul.permitserver.domain.ticket.core.component.TicketRetriever;
+import com.permitseoul.permitserver.domain.ticket.core.component.TicketUpdater;
 import com.permitseoul.permitserver.domain.ticket.core.domain.Ticket;
 import com.permitseoul.permitserver.domain.ticket.core.domain.TicketStatus;
+import com.permitseoul.permitserver.domain.ticket.core.domain.entity.TicketEntity;
+import com.permitseoul.permitserver.domain.ticket.core.exception.TicketNotFoundException;
 import com.permitseoul.permitserver.domain.ticketround.core.component.TicketRoundRetriever;
 import com.permitseoul.permitserver.domain.ticketround.core.domain.TicketRound;
 import com.permitseoul.permitserver.domain.tickettype.core.component.TicketTypeRetriever;
@@ -41,6 +48,7 @@ public class TicketService {
     private final PaymentRetriever paymentRetriever;
 
     private static final String ORDER_DATE_FORMAT = "yyyy-MM-dd";
+    private final TicketUpdater ticketUpdater;
 
     @Transactional(readOnly = true)
     public EventTicketInfoResponse getEventTicketInfo(final long eventId, final LocalDateTime now) {
@@ -75,14 +83,14 @@ public EventTicketInfoResponse getEventTicketInfo(final long eventId, final Loca
     }
 
     @Transactional(readOnly = true)
-    public UserBuyTicketInfo getUserBuyTicketInfo(final Long userId) {
+    public UserBuyTicketInfoResponse getUserBuyTicketInfo(final Long userId) {
         if (userId == null) {
-            return new UserBuyTicketInfo(List.of());
+            return new UserBuyTicketInfoResponse(List.of());
         }
         try {
             final List<Ticket> ticketList = ticketRetriever.findAllTicketsByUserId(userId);
             if (ticketList.isEmpty()) {
-                return new UserBuyTicketInfo(List.of());
+                return new UserBuyTicketInfoResponse(List.of());
             }
 
             final Map<Long, TicketType> ticketTypeMap = getTicketTypeMap(ticketList);
@@ -93,19 +101,61 @@ public UserBuyTicketInfo getUserBuyTicketInfo(final Long userId) {
 
             final Map<String, BigDecimal> refundAmountByOrderId = findRefundAmountsFromPaymentIfAllTicketsCanceled(TicketListGroupedByOrderIdMap);
 
-            final List<UserBuyTicketInfo.Order> orders = convertToOrderList(TicketListGroupedByOrderIdMap, eventMap, ticketTypeMap, refundAmountByOrderId);
+            final List<UserBuyTicketInfoResponse.Order> orders = convertToOrderList(TicketListGroupedByOrderIdMap, eventMap, ticketTypeMap, refundAmountByOrderId);
 
-            return new UserBuyTicketInfo(orders);
+            return new UserBuyTicketInfoResponse(orders);
         } catch (TicketTypeNotfoundException e) {
             throw new NotFoundTicketException(ErrorCode.NOT_FOUND_TICKET_TYPE);
         }
+    }
+
+    @Transactional
+    public void confirmTicket(final String ticketCode, final String checkCodeFromTicket) {
+        try {
+            final TicketEntity ticketEntity = ticketRetriever.findTicketEntityByTicketCode(ticketCode);
+            verifyTicketStatus(ticketEntity.getStatus());
+
+            final TicketType ticketType = ticketTypeRetriever.findTicketTypeById(ticketEntity.getTicketTypeId());
+            verifyTicketDate(ticketType.getTicketStartAt(), ticketType.getTicketEndAt());
+
+            final Event event = eventRetriever.findEventById(ticketEntity.getEventId());
+            verifyTicketCheckCode(event.getTicketCheckCode(), checkCodeFromTicket);
+
+            ticketUpdater.updateTicketStatus(ticketEntity, TicketStatus.USED);
+        } catch (TicketNotFoundException  e) {
+            throw new NotFoundTicketException(ErrorCode.NOT_FOUND_TICKET);
+        } catch (TicketTypeNotfoundException e) {
+            throw new NotFoundTicketException(ErrorCode.NOT_FOUND_TICKET_TYPE);
+        } catch (EventNotfoundException e) {
+            throw new NotFoundTicketException(ErrorCode.NOT_FOUND_EVENT);
+        }
+    }
+
+    private void verifyTicketStatus(final TicketStatus ticketStatus) {
+        if(ticketStatus == TicketStatus.USED)  {
+            throw new ConflictTicketException(ErrorCode.CONFLICT_ALREADY_USED_TICKET);
+        } else if(ticketStatus == TicketStatus.CANCELED) {
+            throw new IllegalTicketException(ErrorCode.BAD_REQUEST_CANCELED_TICKET);
+        }
+    }
 
+    private void verifyTicketCheckCode(final String ticketCheckCode, final String checkCodeFromTicket) {
+        if(!Objects.equals(ticketCheckCode, checkCodeFromTicket)) {
+            throw new IllegalTicketException(ErrorCode.BAD_REQUEST_TICKET_CHECK_CODE_ERROR);
+        }
+    }
+
+    private void verifyTicketDate(final LocalDateTime ticketStartAt, final LocalDateTime ticketEndAt) {
+        final LocalDateTime now = LocalDateTime.now();
+        if(now.isBefore(ticketStartAt) || now.isAfter(ticketEndAt)) {
+            throw new DateTicketException(ErrorCode.BAD_REQUEST_DATE_TIME_ERROR);
+        }
     }
 
-    private List<UserBuyTicketInfo.Order> convertToOrderList(final Map<String, List<Ticket>> ticketsGroupedByOrderId,
-                                                             final Map<Long, Event> eventMap,
-                                                             final Map<Long, TicketType> ticketTypeMap,
-                                                             final Map<String, BigDecimal> refundAmountByOrderId) {
+    private List<UserBuyTicketInfoResponse.Order> convertToOrderList(final Map<String, List<Ticket>> ticketsGroupedByOrderId,
+                                                                     final Map<Long, Event> eventMap,
+                                                                     final Map<Long, TicketType> ticketTypeMap,
+                                                                     final Map<String, BigDecimal> refundAmountByOrderId) {
         return ticketsGroupedByOrderId.entrySet().stream()
                 .map(entry -> {
                     final String orderId = entry.getKey();
@@ -117,12 +167,12 @@ private List<UserBuyTicketInfo.Order> convertToOrderList(final Map<String, List<
                     final String eventName = eventMap.get(eventId).getName();
                     final String eventVenue = eventMap.get(eventId).getVenue();
 
-                    final List<UserBuyTicketInfo.TicketInfo> ticketInfos = ticketsInOrder.stream()
+                    final List<UserBuyTicketInfoResponse.TicketInfo> ticketInfos = ticketsInOrder.stream()
                             .map(ticket -> {
                                 final TicketType ticketType = ticketTypeMap.get(ticket.getTicketTypeId());
                                 final boolean expired = isTicketDateExpired(ticketType.getTicketEndAt());
 
-                                return new UserBuyTicketInfo.TicketInfo(
+                                return new UserBuyTicketInfoResponse.TicketInfo(
                                         ticket.getTicketCode(),
                                         ticketType.getTicketTypeName(),
                                         toUiStatus(ticket.getStatus(), expired),
@@ -133,30 +183,30 @@ private List<UserBuyTicketInfo.Order> convertToOrderList(final Map<String, List<
 
                     // 한 오더내에서 모든 티켓이 USABLE 상태일 때만 취소 가능함
                     final boolean canCancel = ticketInfos.stream()
-                            .allMatch(info -> info.ticketStatus() == UserBuyTicketInfo.TicketStatusForUi.USABLE);
+                            .allMatch(info -> info.ticketStatus() == UserBuyTicketInfoResponse.TicketStatusForUi.USABLE);
 
                     final BigDecimal refundAmount = refundAmountByOrderId.get(orderId);
                     final String formattedRefund = refundAmount != null ? PriceFormatterUtil.formatPrice(refundAmount) : null;
 
-                    return new UserBuyTicketInfo.Order(orderDate, orderId, eventName, eventVenue, formattedRefund,canCancel, ticketInfos);
+                    return new UserBuyTicketInfoResponse.Order(orderDate, orderId, eventName, eventVenue, formattedRefund,canCancel, ticketInfos);
                 })
-                .sorted(Comparator.comparing(UserBuyTicketInfo.Order::orderDate).reversed())
+                .sorted(Comparator.comparing(UserBuyTicketInfoResponse.Order::orderDate).reversed())
                 .toList();
     }
 
     private boolean isTicketDateExpired(final LocalDateTime endDate) {
         return LocalDateTime.now().isAfter(endDate);
     }
 
-    private UserBuyTicketInfo.TicketStatusForUi toUiStatus(final TicketStatus status, final boolean expired) {
+    private UserBuyTicketInfoResponse.TicketStatusForUi toUiStatus(final TicketStatus status, final boolean expired) {
         if (expired && status == TicketStatus.RESERVED) {
-            return UserBuyTicketInfo.TicketStatusForUi.EXPIRED;
+            return UserBuyTicketInfoResponse.TicketStatusForUi.EXPIRED;
         }
 
         return switch (status) {
-            case RESERVED -> UserBuyTicketInfo.TicketStatusForUi.USABLE;
-            case USED -> UserBuyTicketInfo.TicketStatusForUi.USED;
-            case CANCELED -> UserBuyTicketInfo.TicketStatusForUi.REFUNDED;
+            case RESERVED -> UserBuyTicketInfoResponse.TicketStatusForUi.USABLE;
+            case USED -> UserBuyTicketInfoResponse.TicketStatusForUi.USED;
+            case CANCELED -> UserBuyTicketInfoResponse.TicketStatusForUi.REFUNDED;
         };
     }
 
diff --git a/src/main/java/com/permitseoul/permitserver/domain/ticket/core/component/TicketRetriever.java b/src/main/java/com/permitseoul/permitserver/domain/ticket/core/component/TicketRetriever.java
@@ -16,6 +16,11 @@
 public class TicketRetriever {
     private final TicketRepository ticketRepository;
 
+    @Transactional(readOnly = true)
+    public TicketEntity findTicketEntityByTicketCode(final String ticketCode) {
+        return ticketRepository.findByTicketCode(ticketCode).orElseThrow(TicketNotFoundException::new);
+    }
+
     @Transactional(readOnly = true)
     public List<Ticket> findAllTicketsByOrderIdAndUserId(final String orderId, final long userId) {
         final List<TicketEntity> ticketEntityList = ticketRepository.findAllByOrderIdAndUserId(orderId, userId);
diff --git a/src/main/java/com/permitseoul/permitserver/domain/ticket/core/domain/entity/TicketEntity.java b/src/main/java/com/permitseoul/permitserver/domain/ticket/core/domain/entity/TicketEntity.java
@@ -59,6 +59,9 @@ public static TicketEntity create(final long userId, final String orderId, final
 
     public void updateTicketStatus(final TicketStatus status) {
         this.status = status;
+        if(status == TicketStatus.USED) {
+            this.usedTime = LocalDateTime.now();
+        }
     }
 }
 
diff --git a/src/main/java/com/permitseoul/permitserver/domain/ticket/core/repository/TicketRepository.java b/src/main/java/com/permitseoul/permitserver/domain/ticket/core/repository/TicketRepository.java
@@ -5,10 +5,13 @@
 import org.springframework.stereotype.Repository;
 
 import java.util.List;
+import java.util.Optional;
 
 @Repository
 public interface TicketRepository extends JpaRepository<TicketEntity, Long> {
     List<TicketEntity> findAllByOrderIdAndUserId(final String orderId, final long userId);
 
     List<TicketEntity> findAllByUserId(final long userId);
+
+    Optional<TicketEntity> findByTicketCode(final String ticketCode);
 }
diff --git a/src/main/java/com/permitseoul/permitserver/domain/tickettype/core/component/TicketTypeRetriever.java b/src/main/java/com/permitseoul/permitserver/domain/tickettype/core/component/TicketTypeRetriever.java
@@ -21,6 +21,11 @@ public TicketTypeEntity findTicketTypeEntityById(final long ticketTypeId) {
         return ticketTypeRepository.findById(ticketTypeId).orElseThrow(TicketTypeNotfoundException::new);
     }
 
+    @Transactional(readOnly = true)
+    public TicketType findTicketTypeById(final long ticketTypeId) {
+        return TicketType.fromEntity(ticketTypeRepository.findById(ticketTypeId).orElseThrow(TicketTypeNotfoundException::new));
+    }
+
     @Transactional(readOnly = true)
     public void validExistTicketType(final long ticketTypeId) {
         if(!ticketTypeRepository.existsById(ticketTypeId)) {
diff --git a/src/main/java/com/permitseoul/permitserver/global/response/code/ErrorCode.java b/src/main/java/com/permitseoul/permitserver/global/response/code/ErrorCode.java
@@ -25,6 +25,10 @@ public enum ErrorCode implements ApiCode {
     BAD_REQUEST_AMOUNT_MISMATCH(HttpStatus.BAD_REQUEST, 40011, "구매하려는 티켓들의 가격과 totalAmount가 다릅니다."),
     BAD_REQUEST_ID_DECODE_ERROR(HttpStatus.BAD_REQUEST, 40012, "해당 객체 id를 decode 할 수 없습니다."),
     BAD_REQUEST_DATE_TIME_ERROR(HttpStatus.BAD_REQUEST, 40013, "잘못된 date, time입니다."),
+    BAD_REQUEST_TICKET_CHECK_CODE_ERROR(HttpStatus.BAD_REQUEST, 40014, "잘못된 ticket check code 입니다."),
+    BAD_REQUEST_CANCELED_TICKET(HttpStatus.BAD_REQUEST, 40015, "취소된 ticket 입니다."),
+
+
 
 
     /**
@@ -97,6 +101,8 @@ public enum ErrorCode implements ApiCode {
     CONFLICT_ALREADY_USED_COUPON_CODE(HttpStatus.CONFLICT, 40903, "이미 사용한 쿠폰코드입니다."),
     CONFLICT_USER_EMAIL(HttpStatus.CONFLICT, 40904, "이미 존재하는 이메일입니다."),
     CONFLICT_TIMETABLE_USER_LIKE(HttpStatus.CONFLICT, 40905, "이미 존재하는 타임테이블 유저 좋아요입니다."),
+    CONFLICT_ALREADY_USED_TICKET(HttpStatus.CONFLICT, 40906, "이미 사용한 티켓입니다."),
+
 
 
     /**

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-package com.permitseoul.permitserver.domain.ticket.api.dto;`
	`1`	`+package com.permitseoul.permitserver.domain.ticket.api.dto.res;`
`2`	`2`
`3`	`3`	`import java.util.List;`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -59,6 +59,9 @@ public static TicketEntity create(final long userId, final String orderId, final`
`59`	`59`
`60`	`60`	`public void updateTicketStatus(final TicketStatus status) {`
`61`	`61`	`this.status = status;`
	`62`	`+ if(status == TicketStatus.USED) {`
	`63`	`+ this.usedTime = LocalDateTime.now();`
	`64`	`+ }`
`62`	`65`	`}`
`63`	`66`	`}`
`64`	`67`