기록일: October 26, 2026 · 담당: 이상재(P2) · 상태: 2단계 구현·단위 테스트 완료

무엇을 어떻게 했나

P3 주문·결제와 P4 관리자 재고 조정이 같은 재고 규칙을 재사용하도록 순수 Python 상품 옵션 도메인을 구현했다. 재고 증가·차감, 잘못된 수량과 재고 부족 처리, 실패 시 기존 재고 유지까지 2단계 범위에서 검증했다.

이번 기록은 인수인계 문서 11장의 **2단계 ‘순수 재고 도메인 만들기’**에 해당한다. DB 잠금·Repository는 3단계이며, 실제 P3/P4 연결·화면·배포 완료와 구분한다.

구현 파일

옵션 엔티티

ProductVariant는 옵션 ID와 소속 상품 ID, 현재 재고 및 옵션 정보를 표현한다.

구매 제한 정보는 P3가 사용할 수 있도록 표현했다. 사용자별 구매 내역 집계·결제 가능 여부 판단까지 이 엔티티에 구현한 것은 아니다.

재고 증감 규칙