feat: ticket api 문서 작성, 티켓 테스트 데이터 수정

Author: gksdud1109

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

@@ -2,49 +2,35 @@
 
 import java.util.List;
 
+import org.springframework.web.bind.annotation.PathVariable;
+
 import com.back.api.ticket.dto.response.TicketResponse;
+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 = "Ticket API", description = "티켓 결제 및 조회 API")
 public interface TicketApi {
 
-	/*
 	@Operation(
-		summary = "결제 성공",
-		description = "Draft Ticket을 ISSUED 상태로 변경합니다. 내부 로직 또는 PG webhook 호출용 엔드포인트입니다."
+		summary = "내 티켓 목록 조회",
+		description = "현재 로그인한 사용자의 모든 티켓 목록을 조회합니다."
 	)
-	@ApiErrorCode({
-		"TICKET_NOT_FOUND",
-		"UNAUTHORIZED_TICKET_ACCESS",
-		"INVALID_TICKET_STATE"
-	})
-	ApiResponse<TicketResponse> confirmPayment(
-		@Parameter(description = "티켓 ID", example = "1")
-		@PathVariable Long ticketId
-	);
+	ApiResponse<List<TicketResponse>> getMyTickets();
 
 	@Operation(
-		summary = "결제 실패",
-		description = "Draft Ticket을 FAILED로 변경하고 좌석을 AVAILABLE로 복구합니다. 내부 로직 또는 PG webhook 호출용 엔드포인트입니다."
+		summary = "내 티켓 상세 조회",
+		description = "현재 로그인한 사용자의 특정 티켓 상세 정보를 조회합니다. 티켓 ID로 조회하며, 본인의 티켓만 조회 가능합니다."
 	)
 	@ApiErrorCode({
 		"TICKET_NOT_FOUND",
-		"INVALID_TICKET_STATE"
+		"UNAUTHORIZED_TICKET_ACCESS"
 	})
-	ApiResponse<Void> failPayment(
-		@Parameter(description = "티켓 ID", example = "1")
+	ApiResponse<TicketResponse> getMyTicketDetails(
+		@Parameter(description = "조회할 티켓 ID", example = "1")
 		@PathVariable Long ticketId
 	);
-	*/
-
-	@Operation(
-		summary = "내 티켓 목록 조회",
-		description = "현재 로그인한 사용자의 모든 티켓 목록을 조회합니다."
-	)
-	ApiResponse<List<TicketResponse>> getMyTickets();
-
-	// TODO: API 설명츄가
 }

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

@@ -36,6 +36,7 @@ public ApiResponse<List<TicketResponse>> getMyTickets() {
 		);
 	}
 
+	@Override
 	@GetMapping("/my/{ticketId}/details")
 	public ApiResponse<TicketResponse> getMyTicketDetails(
 		@PathVariable Long ticketId
@@ -49,30 +50,4 @@ public ApiResponse<TicketResponse> getMyTicketDetails(
 			TicketResponse.from(ticket)
 		);
 	}
-
-	/* 외부 노출이 필요 없는 엔드포인트, 보관 차원에서 주석 처리
-	@Override
-	@PostMapping("/{ticketId}/payment/success")
-	public ApiResponse<TicketResponse> confirmPayment(
-		@PathVariable Long ticketId
-	) {
-		Long userId = httpRequestContext.getUser().getId();
-
-		Ticket ticket = ticketService.confirmPayment(ticketId, userId);
-
-		return ApiResponse.ok(
-			"결제가 완료되었습니다.",
-			TicketResponse.from(ticket)
-		);
-	}
-
-	@Override
-	@PostMapping("/{ticketId}/payment/fail")
-	public ApiResponse<Void> failPayment(
-		@PathVariable Long ticketId
-	) {
-		ticketService.failPayment(ticketId);
-		return ApiResponse.noContent("결제 실패 처리 완료");
-	}
-	*/
-}
+}

backend/src/main/java/com/back/global/init/perf/PerfSeatDataInitializer.java

@@ -40,7 +40,7 @@ public void init() {
 			log.info("Seat 초기 데이터 생성 중: Event #3 ({}) - 500석 (VIP-A 50석, R-C 100석, S-B 150석, A-D 200석)",
 				event3.getTitle());
 
-			List<Seat> seats3 = createSeatsForEvent3(event3);
+			List<Seat> seats3 = createSeatsForEvent3and4(event3);
 			seatRepository.saveAll(seats3);
 			totalSeats += seats3.size();
 
@@ -55,7 +55,7 @@ public void init() {
 			log.info("Seat 초기 데이터 생성 중: Event #4 ({}) - 100석 (VIP-E 20석, R-G 30석, S-F 30석, A-H 20석)",
 				event4.getTitle());
 
-			List<Seat> seats4 = createSeatsForEvent4(event4);
+			List<Seat> seats4 = createSeatsForEvent3and4(event4);
 			seatRepository.saveAll(seats4);
 			totalSeats += seats4.size();
 
@@ -73,7 +73,7 @@ public void init() {
 	 * - S: B1~B150 (150석)
 	 * - A: D1~D200 (200석)
 	 */
-	private List<Seat> createSeatsForEvent3(Event event) {
+	private List<Seat> createSeatsForEvent3and4(Event event) {
 		List<Seat> seats = new ArrayList<>();
 
 		// VIP: A1 ~ A50 (50석)
@@ -98,38 +98,4 @@ private List<Seat> createSeatsForEvent3(Event event) {
 
 		return seats;
 	}
-
-	/**
-	 * Event #4용 좌석 생성
-	 * - 총 100석
-	 * - VIP: E1~E20 (20석)
-	 * - R: G1~G30 (30석)
-	 * - S: F1~F30 (30석)
-	 * - A: H1~H20 (20석)
-	 */
-	private List<Seat> createSeatsForEvent4(Event event) {
-		List<Seat> seats = new ArrayList<>();
-
-		// VIP: E1 ~ E20 (20석)
-		for (int i = 1; i <= 20; i++) {
-			seats.add(Seat.createSeat(event, "E" + i, SeatGrade.VIP, event.getMaxPrice()));
-		}
-
-		// R: G1 ~ G30 (30석)
-		for (int i = 1; i <= 30; i++) {
-			seats.add(Seat.createSeat(event, "G" + i, SeatGrade.R, event.getMaxPrice() - 20000));
-		}
-
-		// S: F1 ~ F30 (30석)
-		for (int i = 1; i <= 30; i++) {
-			seats.add(Seat.createSeat(event, "F" + i, SeatGrade.S, event.getMinPrice() + 30000));
-		}
-
-		// A: H1 ~ H20 (20석)
-		for (int i = 1; i <= 20; i++) {
-			seats.add(Seat.createSeat(event, "H" + i, SeatGrade.A, event.getMinPrice()));
-		}
-
-		return seats;
-	}
 }

perf/k6-scripts/scenarios/getTicketDetail.js

@@ -78,4 +78,4 @@ export function getTicketDetail(baseUrl, jwt, testId, ticketId) {
   }
 
   return res;
-}
+}

perf/k6-scripts/tests/getTicketDetail.test.js

@@ -22,15 +22,15 @@ export const options = {
  *
  * 테스트 데이터 구조 (Event #4 기준):
  * - 총 사용자: 500명 (test1@test.com ~ test500@test.com)
- * - Event #4: CLOSED 상태, 100석 (모두 ISSUED 티켓)
+ * - Event #4: CLOSED 상태, 500석 (모두 ISSUED 티켓)
  * - 티켓 배정: 순환 배정
  *   → ticketId 1: userId 1
  *   → ticketId 2: userId 2
  *   → ...
- *   → ticketId 100: userId 100
+ *   → ticketId 500: userId 500
  *
  * 시나리오:
- * - VU 1~100만 활성화 (티켓을 가진 사용자만 테스트)
+ * - VU 1~500만 활성화 (티켓을 가진 사용자만 테스트)
  * - 각 VU는 자신의 티켓 ID로 상세 조회
  * - VU 1 → ticketId 1, VU 2 → ticketId 2, ...
  *
@@ -40,8 +40,8 @@ export const options = {
  * - DB 단건 조회 성능 확인
  *
  * 주의:
- * - PEAK_VUS는 100 이하로 설정 권장 (티켓이 100장만 존재)
- * - 100 초과 시 존재하지 않는 ticketId 조회로 404 에러 발생
+ * - PEAK_VUS는 500 이하로 설정 권장 (티켓이 500장만 존재)
+ * - 500 초과 시 존재하지 않는 ticketId 조회로 404 에러 발생
  */
 export function setup() {
   const secret = __ENV.JWT_SECRET;
@@ -54,13 +54,13 @@ export function setup() {
     parseInt(__ENV.PEAK_VUS || "100", 10)
   );
 
-  // 티켓이 있는 사용자(1~100)만 토큰 생성
-  const ticketOwnerCount = 100;
+  // 티켓이 있는 사용자(1~500)만 토큰 생성
+  const ticketOwnerCount = 500;
   const effectiveVus = Math.min(maxVus, ticketOwnerCount);
 
   // VU당 JWT 토큰 생성
   const tokens = Array.from({ length: effectiveVus }, (_, i) => {
-    const userId = i + 1; // userId 1~100
+    const userId = i + 1; // userId 1~500
     return generateJWT(
       {
         id: userId,
@@ -102,4 +102,4 @@ export default function (data) {
 
   // 사용자가 티켓 상세를 확인하는 시간 (0.5~2.0초)
   sleep(Math.random() * 1.5 + 0.5);
-}
+}