기록일: October 26, 2026 · 담당: 이상재(P2) · 상태: 2단계 구현·단위 테스트 완료
P3 주문·결제와 P4 관리자 재고 조정이 같은 재고 규칙을 재사용하도록 순수 Python 상품 옵션 도메인을 구현했다. 재고 증가·차감, 잘못된 수량과 재고 부족 처리, 실패 시 기존 재고 유지까지 2단계 범위에서 검증했다.
이번 기록은 인수인계 문서 11장의 **2단계 ‘순수 재고 도메인 만들기’**에 해당한다. DB 잠금·Repository는 3단계이며, 실제 P3/P4 연결·화면·배포 완료와 구분한다.
backend/src/products/domain/variant.py: ProductVariant, 재고 증감 규칙, 도메인 예외backend/src/products/domain/__init__.py: 순수 도메인 패키지backend/tests/products/test_variant.py: DB 없는 단위 테스트ProductVariant는 옵션 ID와 소속 상품 ID, 현재 재고 및 옵션 정보를 표현한다.
id: 옵션 IDproduct_id: 상품 IDstock: 현재 재고option_name: 옵션명, 기본값 ‘기본’extra_price: 추가금, 기본값 0max_per_user: 구매 제한 정보, 기본값 4, None은 무제한sort_order: 옵션 표시 순서구매 제한 정보는 P3가 사용할 수 있도록 표현했다. 사용자별 구매 내역 집계·결제 가능 여부 판단까지 이 엔티티에 구현한 것은 아니다.
increase_stock(quantity): 재고를 늘리고 변경한 재고 정수를 반환한다.