[feat] #259 - Booking 엔티티 수정 및 환불/취소 요청 API 구현

src/main/java/com/beat/domain/booking/api/BookingApi.java

@@ -5,6 +5,10 @@
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.RequestBody;
 
+import com.beat.domain.booking.application.dto.BookingCancelRequest;
+import com.beat.domain.booking.application.dto.BookingCancelResponse;
+import com.beat.domain.booking.application.dto.BookingRefundRequest;
+import com.beat.domain.booking.application.dto.BookingRefundResponse;
 import com.beat.domain.booking.application.dto.GuestBookingRequest;
 import com.beat.domain.booking.application.dto.GuestBookingResponse;
 import com.beat.domain.booking.application.dto.GuestBookingRetrieveRequest;
@@ -142,4 +146,42 @@ ResponseEntity<SuccessResponse<GuestBookingResponse>> createGuestBookings(
 	ResponseEntity<SuccessResponse<List<GuestBookingRetrieveResponse>>> getGuestBookings(
 		@RequestBody GuestBookingRetrieveRequest guestBookingRetrieveRequest
 	);
+
+	@Operation(summary = "유료공연 예매 환불 요청 API", description = "유료공연 예매자가 환불 요청하는 PATCH API입니다.")
+	@ApiResponses(
+		value = {
+			@ApiResponse(
+				responseCode = "200",
+				description = "유료공연 예매 환불 요청이 성공적으로 완료되었습니다.",
+				content = @Content(schema = @Schema(implementation = SuccessResponse.class))
+			),
+			@ApiResponse(
+				responseCode = "404",
+				description = "입력하신 정보와 일치하는 예매 내역이 없습니다. 확인 후 다시 조회해주세요.",
+				content = @Content(schema = @Schema(implementation = ErrorResponse.class))
+			)
+		}
+	)
+	ResponseEntity<SuccessResponse<BookingRefundResponse>> refundBookings(
+		@RequestBody BookingRefundRequest bookingRefundRequest
+	);
+
+	@Operation(summary = "무료공연/미입금 예매 취소 요청 API", description = "무료공연/미입금 예매자가 취소 요청하는 PATCH API입니다.")
+	@ApiResponses(
+		value = {
+			@ApiResponse(
+				responseCode = "200",
+				description = "무료공연/미입금 예매 취소 요청이 성공적으로 완료되었습니다.",
+				content = @Content(schema = @Schema(implementation = SuccessResponse.class))
+			),
+			@ApiResponse(
+				responseCode = "404",
+				description = "입력하신 정보와 일치하는 예매 내역이 없습니다. 확인 후 다시 조회해주세요.",
+				content = @Content(schema = @Schema(implementation = ErrorResponse.class))
+			)
+		}
+	)
+	ResponseEntity<SuccessResponse<BookingCancelResponse>> cancelBookings(
+		@RequestBody BookingCancelRequest bookingCancelRequest
+	);
 }

src/main/java/com/beat/domain/booking/api/BookingController.java

@@ -5,15 +5,21 @@
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PatchMapping;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
+import com.beat.domain.booking.application.BookingCancelService;
 import com.beat.domain.booking.application.GuestBookingRetrieveService;
 import com.beat.domain.booking.application.GuestBookingService;
 import com.beat.domain.booking.application.MemberBookingRetrieveService;
 import com.beat.domain.booking.application.MemberBookingService;
+import com.beat.domain.booking.application.dto.BookingCancelRequest;
+import com.beat.domain.booking.application.dto.BookingCancelResponse;
+import com.beat.domain.booking.application.dto.BookingRefundRequest;
+import com.beat.domain.booking.application.dto.BookingRefundResponse;
 import com.beat.domain.booking.application.dto.GuestBookingRequest;
 import com.beat.domain.booking.application.dto.GuestBookingResponse;
 import com.beat.domain.booking.application.dto.GuestBookingRetrieveRequest;
@@ -35,6 +41,7 @@ public class BookingController implements BookingApi {
 	private final MemberBookingRetrieveService memberBookingRetrieveService;
 	private final GuestBookingService guestBookingService;
 	private final GuestBookingRetrieveService guestBookingRetrieveService;
+	private final BookingCancelService bookingCancelService;
 
 	@Override
 	@PostMapping("/member")
@@ -73,4 +80,24 @@ public ResponseEntity<SuccessResponse<List<GuestBookingRetrieveResponse>>> getGu
 		return ResponseEntity.status(HttpStatus.OK)
 			.body(SuccessResponse.of(BookingSuccessCode.GUEST_BOOKING_RETRIEVE_SUCCESS, response));
 	}
+
+	@Override
+	@PatchMapping("/refund")
+	public ResponseEntity<SuccessResponse<BookingRefundResponse>> refundBookings(
+		@RequestBody BookingRefundRequest bookingRefundRequest
+	) {
+		BookingRefundResponse response = bookingCancelService.refundBooking(bookingRefundRequest);
+		return ResponseEntity.status(HttpStatus.OK)
+			.body(SuccessResponse.of(BookingSuccessCode.BOOKING_REFUND_SUCCESS, response));
+	}
+
+	@Override
+	@PatchMapping("/cancel")
+	public ResponseEntity<SuccessResponse<BookingCancelResponse>> cancelBookings(
+		@RequestBody BookingCancelRequest bookingCancelRequest
+	) {
+		BookingCancelResponse response = bookingCancelService.cancelBooking(bookingCancelRequest);
+		return ResponseEntity.status(HttpStatus.OK)
+			.body(SuccessResponse.of(BookingSuccessCode.BOOKING_CANCEL_SUCCESS, response));
+	}
 }

src/main/java/com/beat/domain/booking/application/BookingCancelService.java

@@ -0,0 +1,59 @@
+package com.beat.domain.booking.application;
+
+import org.springframework.stereotype.Service;
+
+import com.beat.domain.booking.application.dto.BookingCancelRequest;
+import com.beat.domain.booking.application.dto.BookingCancelResponse;
+import com.beat.domain.booking.application.dto.BookingRefundRequest;
+import com.beat.domain.booking.application.dto.BookingRefundResponse;
+import com.beat.domain.booking.dao.BookingRepository;
+import com.beat.domain.booking.domain.Booking;
+import com.beat.domain.booking.domain.BookingStatus;
+import com.beat.domain.booking.exception.BookingErrorCode;
+import com.beat.domain.schedule.dao.ScheduleRepository;
+import com.beat.domain.schedule.domain.Schedule;
+import com.beat.global.common.exception.NotFoundException;
+
+import lombok.RequiredArgsConstructor;
+
+@Service
+@RequiredArgsConstructor
+public class BookingCancelService {
+
+	private final BookingRepository bookingRepository;
+	private final ScheduleRepository scheduleRepository;
+
+	public BookingRefundResponse refundBooking(BookingRefundRequest request) {
+		Booking booking = bookingRepository.findById(request.bookingId())
+			.orElseThrow(() -> new NotFoundException(BookingErrorCode.NO_BOOKING_FOUND));
+
+		booking.setRefundInfo(request.bankName(), request.accountNumber(), request.accountHolder());
+		booking.setBookingStatus(BookingStatus.REFUND_REQUESTED);
+		bookingRepository.save(booking);
+
+		return BookingRefundResponse.of(
+			booking.getId(),
+			booking.getBookingStatus(),
+			booking.getBankName(),
+			booking.getAccountNumber(),
+			booking.getAccountHolder()
+		);
+	}
+
+	public BookingCancelResponse cancelBooking(BookingCancelRequest request) {
+		Booking booking = bookingRepository.findById(request.bookingId())
+			.orElseThrow(() -> new NotFoundException(BookingErrorCode.NO_BOOKING_FOUND));
+
+		booking.setBookingStatus(BookingStatus.BOOKING_CANCELLED);
+		bookingRepository.save(booking);
+
+		Schedule schedule = booking.getSchedule();
+		schedule.decreaseSoldTicketCount(booking.getPurchaseTicketCount());
+		scheduleRepository.save(schedule);
+
+		return BookingCancelResponse.of(
+			booking.getId(),
+			booking.getBookingStatus()
+		);
+	}
+}

src/main/java/com/beat/domain/booking/application/GuestBookingService.java

@@ -1,5 +1,8 @@
 package com.beat.domain.booking.application;
 
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
 import com.beat.domain.booking.application.dto.GuestBookingRequest;
 import com.beat.domain.booking.application.dto.GuestBookingResponse;
 import com.beat.domain.booking.dao.BookingRepository;
@@ -15,9 +18,6 @@
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-
 @Slf4j
 @Service
 @RequiredArgsConstructor
@@ -61,6 +61,9 @@ public GuestBookingResponse createGuestBooking(GuestBookingRequest guestBookingR
 			guestBookingRequest.bookingStatus(),
 			guestBookingRequest.birthDate(),
 			guestBookingRequest.password(),
+			null,
+			null,
+			null,
 			schedule,
 			users
 		);

src/main/java/com/beat/domain/booking/application/MemberBookingService.java

@@ -1,5 +1,8 @@
 package com.beat.domain.booking.application;
 
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
 import com.beat.domain.booking.application.dto.MemberBookingRequest;
 import com.beat.domain.booking.application.dto.MemberBookingResponse;
 import com.beat.domain.booking.dao.BookingRepository;
@@ -19,9 +22,6 @@
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-
 @Slf4j
 @Service
 @RequiredArgsConstructor
@@ -57,6 +57,9 @@ public MemberBookingResponse createMemberBooking(Long memberId, MemberBookingReq
 			memberBookingRequest.bookingStatus(),
 			null,
 			null,
+			null,
+			null,
+			null,
 			schedule,
 			user
 		);

src/main/java/com/beat/domain/booking/application/dto/BookingCancelRequest.java

@@ -0,0 +1,6 @@
+package com.beat.domain.booking.application.dto;
+
+public record BookingCancelRequest(
+	long bookingId
+) {
+}

src/main/java/com/beat/domain/booking/application/dto/BookingCancelResponse.java

@@ -0,0 +1,16 @@
+package com.beat.domain.booking.application.dto;
+
+import com.beat.domain.booking.domain.BookingStatus;
+
+public record BookingCancelResponse(
+	long bookingId,
+	BookingStatus bookingStatus
+) {
+	public static BookingCancelResponse of(
+		long bookingId,
+		BookingStatus bookingStatus) {
+		return new BookingCancelResponse(
+			bookingId,
+			bookingStatus);
+	}
+}

src/main/java/com/beat/domain/booking/application/dto/BookingRefundRequest.java

@@ -0,0 +1,11 @@
+package com.beat.domain.booking.application.dto;
+
+import com.beat.domain.performance.domain.BankName;
+
+public record BookingRefundRequest(
+	long bookingId,
+	BankName bankName,
+	String accountNumber,
+	String accountHolder
+) {
+}

src/main/java/com/beat/domain/booking/application/dto/BookingRefundResponse.java

@@ -0,0 +1,26 @@
+package com.beat.domain.booking.application.dto;
+
+import com.beat.domain.booking.domain.BookingStatus;
+import com.beat.domain.performance.domain.BankName;
+
+public record BookingRefundResponse(
+	long bookingId,
+	BookingStatus bookingStatus,
+	BankName bankName,
+	String accountNumber,
+	String accountHolder
+) {
+	public static BookingRefundResponse of(
+		long bookingId,
+		BookingStatus bookingStatus,
+		BankName bankName,
+		String accountNumber,
+		String accountHolder) {
+		return new BookingRefundResponse(
+			bookingId,
+			bookingStatus,
+			bankName,
+			accountNumber,
+			accountHolder);
+	}
+}

src/main/java/com/beat/domain/booking/domain/Booking.java

@@ -1,5 +1,11 @@
 package com.beat.domain.booking.domain;
 
+import java.time.LocalDateTime;
+
+import org.hibernate.annotations.OnDelete;
+import org.hibernate.annotations.OnDeleteAction;
+
+import com.beat.domain.performance.domain.BankName;
 import com.beat.domain.schedule.domain.Schedule;
 import com.beat.domain.user.domain.Users;
 
@@ -18,11 +24,6 @@
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
-import org.hibernate.annotations.OnDelete;
-import org.hibernate.annotations.OnDeleteAction;
-
-import java.time.LocalDateTime;
-
 @Entity
 @Getter
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
@@ -57,6 +58,16 @@ public class Booking {
 	@Column(nullable = true)
 	private String password;
 
+	@Enumerated(EnumType.STRING)
+	@Column(nullable = true)
+	private BankName bankName;
+
+	@Column(nullable = true)
+	private String accountNumber;
+
+	@Column(nullable = true)
+	private String accountHolder;
+
 	@ManyToOne(fetch = FetchType.LAZY)
 	@JoinColumn(name = "schedule_id", nullable = false)
 	@OnDelete(action = OnDeleteAction.CASCADE)
@@ -69,35 +80,49 @@ public class Booking {
 
 	@Builder
 	public Booking(int purchaseTicketCount, String bookerName, String bookerPhoneNumber, BookingStatus bookingStatus,
-		String birthDate, String password, Schedule schedule, Users users) {
+		String birthDate, String password, BankName bankName, String accountNumber, String accountHolder,
+		Schedule schedule, Users users) {
 		this.purchaseTicketCount = purchaseTicketCount;
 		this.bookerName = bookerName;
 		this.bookerPhoneNumber = bookerPhoneNumber;
 		this.bookingStatus = bookingStatus;
 		this.birthDate = birthDate;
 		this.password = password;
+		this.bankName = bankName;
+		this.accountNumber = accountNumber;
+		this.accountHolder = accountHolder;
 		this.schedule = schedule;
 		this.users = users;
 	}
 
 	public static Booking create(int purchaseTicketCount, String bookerName, String bookerPhoneNumber,
-		BookingStatus bookingStatus, String birthDate, String password, Schedule schedule, Users users) {
+		BookingStatus bookingStatus, String birthDate, String password,
+		BankName bankName, String accountNumber, String accountHolder, Schedule schedule, Users users) {
 		return Booking.builder()
 			.purchaseTicketCount(purchaseTicketCount)
 			.bookerName(bookerName)
 			.bookerPhoneNumber(bookerPhoneNumber)
 			.bookingStatus(bookingStatus)
 			.birthDate(birthDate)
 			.password(password)
+			.bankName(bankName)
+			.accountNumber(accountNumber)
+			.accountHolder(accountHolder)
 			.schedule(schedule)
 			.users(users)
 			.build();
 	}
 
 	public void setBookingStatus(BookingStatus bookingStatus) {
 		this.bookingStatus = bookingStatus;
-		if (bookingStatus == BookingStatus.BOOKING_CANCELLED) {
+		if (bookingStatus == BookingStatus.BOOKING_CANCELLED || bookingStatus == BookingStatus.BOOKING_DELETED) {
 			this.cancellationDate = LocalDateTime.now();
 		}
 	}
+
+	public void setRefundInfo(BankName bankName, String accountNumber, String accountHolder) {
+		this.bankName = bankName;
+		this.accountNumber = accountNumber;
+		this.accountHolder = accountHolder;
+	}
 }

src/main/java/com/beat/domain/booking/domain/BookingStatus.java

@@ -8,7 +8,9 @@
 public enum BookingStatus {
 	CHECKING_PAYMENT("입금확인중"),
 	BOOKING_CONFIRMED("예매 확정"),
-	BOOKING_CANCELLED("예매 취소");
+	BOOKING_CANCELLED("예매 취소"),
+	REFUND_REQUESTED("환불 요청"),
+	BOOKING_DELETED("예매 삭제");
 
 	private final String displayname;
 }