From 583488baedfa4a6e863aaa84e879a04e9cc6d2cd Mon Sep 17 00:00:00 2001 From: Klaus Date: Wed, 15 Jul 2026 18:30:30 +0900 Subject: [PATCH] =?UTF-8?q?docs(live):=20=EB=9D=BC=EC=9D=B4=EB=B8=8C=20?= =?UTF-8?q?=EC=98=88=EC=95=BD=20lazy=20=EC=98=A4=EB=A5=98=20=EC=88=98?= =?UTF-8?q?=EC=A0=95=20PRD=EB=A5=BC=20=EC=9E=91=EC=84=B1=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../prd.md | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 docs/20260715_라이브_예약_LazyInitializationException_수정/prd.md diff --git a/docs/20260715_라이브_예약_LazyInitializationException_수정/prd.md b/docs/20260715_라이브_예약_LazyInitializationException_수정/prd.md new file mode 100644 index 00000000..ca20d393 --- /dev/null +++ b/docs/20260715_라이브_예약_LazyInitializationException_수정/prd.md @@ -0,0 +1,63 @@ +# PRD: 라이브 예약 LazyInitializationException 수정 + +## 1. Overview +`spring.jpa.open-in-view=false` 환경에서 라이브 예약 생성 시 `LiveRoom.reservations` lazy 컬렉션 접근으로 발생하는 `LazyInitializationException`을 서비스 트랜잭션 경계로 방지한다. + +## 2. Problem +- `LiveReservationService.makeReservation()`에는 쓰기 트랜잭션 경계가 없다. +- `liveRoomRepository.findByIdOrNull()` 호출이 끝난 뒤 반환된 `LiveRoom`은 영속성 컨텍스트에서 분리된다. +- `reservation.room = room`은 `LiveReservation.room`의 사용자 정의 setter를 호출하고, setter는 `room.reservations.add(this)`로 lazy 컬렉션을 초기화한다. +- OSIV가 비활성화된 상태에서는 컬렉션을 초기화할 Session이 없어 `org.hibernate.LazyInitializationException: failed to lazily initialize a collection of role: kr.co.vividnext.sodalive.live.room.LiveRoom.reservations, could not initialize proxy - no Session`이 발생한다. +- 유료 예약에서는 `CanPaymentService.spendCan()`만 자체 트랜잭션으로 먼저 커밋될 수 있어, 이후 예약 저장이 실패하면 결제와 예약 상태가 분리될 위험도 있다. + +## 3. Goals +- OSIV off 환경에서도 라이브 예약 생성이 lazy 초기화 예외 없이 완료된다. +- `makeReservation()`의 라이브방 조회, 결제, 예약 저장을 하나의 트랜잭션 경계에서 처리한다. +- 트랜잭션 없는 테스트 메서드에서 실제 Spring 서비스 프록시를 호출해 기존 오류를 재현하고 회귀를 방지한다. +- 기존 라이브 예약 API URL, 요청 및 응답 스키마를 변경하지 않는다. + +## 4. Non-Goals +- `spring.jpa.open-in-view`를 활성화하지 않는다. +- `LiveRoom.reservations`를 eager fetch로 변경하지 않는다. +- `LiveReservation.room`의 양방향 연관관계 setter를 재설계하지 않는다. +- 예약 중복 방지나 동시성 정책을 새로 도입하지 않는다. +- 결제 및 예약 정책, 응답 문구와 날짜 포맷을 변경하지 않는다. + +## 5. Target Users +- 사용자: 무료 또는 유료 라이브를 오류 없이 예약하려는 회원 +- 운영자: OSIV off 정책을 유지하면서 결제와 예약 저장의 일관성을 보장하려는 운영 담당자 + +## 6. User Stories +- 사용자는 예약 가능한 라이브를 선택했을 때 서버의 lazy 초기화 오류 없이 예약을 완료할 수 있어야 한다. +- 유료 라이브 예약은 결제와 예약 저장 중 하나가 실패하면 전체 작업이 함께 롤백되어야 한다. +- 운영자는 OSIV와 엔티티 fetch 전략을 변경하지 않고 서비스 트랜잭션 경계로 오류를 방지할 수 있어야 한다. + +## 7. Core Features + +### Feature A. 라이브 예약 생성 트랜잭션 보강 + +#### Requirements +- `LiveReservationService.makeReservation()`에 쓰기 `@Transactional`을 적용한다. +- `liveRoomRepository.findByIdOrNull()`로 조회한 `LiveRoom`은 예약 연관관계 설정과 저장이 끝날 때까지 managed 상태를 유지한다. +- `CanPaymentService.spendCan()`의 기본 `REQUIRED` 전파 속성은 외부 예약 트랜잭션에 참여한다. +- 기존 비밀번호 검증, 중복 예약 검증, 보유 캔 검증, 결제, 예약 응답 생성 순서를 유지한다. + +#### Edge Cases +- 가격이 0인 무료 라이브도 `LiveRoom.reservations` lazy 컬렉션 초기화 예외 없이 예약된다. +- 가격이 0보다 큰 라이브는 결제와 예약 저장이 같은 트랜잭션에 참여한다. +- 존재하지 않는 라이브방이나 회원, 잘못된 비밀번호, 중복 예약, 캔 부족에 대한 기존 예외 동작을 유지한다. + +## 8. Technical Constraints +- Kotlin, Java 17, Spring Boot 2.7.14, Spring Data JPA, JUnit 5, Gradle Wrapper를 사용한다. +- 서비스 쓰기 메서드 단위로 `@Transactional` 경계를 명확히 한다. +- 테스트 클래스 자체 트랜잭션은 비활성화해 서비스 프록시의 트랜잭션 경계만 검증한다. +- 실제 JPA 엔티티를 저장하고 영속성 컨텍스트를 비운 뒤 서비스를 호출하는 통합 테스트로 검증한다. +- 변경 범위는 `LiveReservationService.makeReservation()`, 해당 회귀 테스트, PRD와 Plan/TASK 문서로 제한한다. + +## 9. Metrics +- 수정 전 회귀 테스트가 `LazyInitializationException`으로 실패한다. +- 수정 후 같은 회귀 테스트가 통과하고 예약 레코드가 저장된다. +- 관련 테스트, `ktlintCheck`, `tasks --all`, `git diff --check`가 통과한다. + +## 10. Open Questions +- 없음. 승인된 권장안인 서비스 쓰기 트랜잭션 적용과 OSIV off 통합 회귀 테스트로 범위를 확정한다.