E · 애플리케이션 데이터 설계
주문 기록을 이력·증가량·원자성에 맞게 모델링하기
“내장할까 참조할까?”에는 정답 하나가 없습니다. 주문서는 구매 당시 내용을 보존해야 하고 상품 카탈로그는 최신 상태를 공유해야 합니다. 접근 패턴과 이력 요구를 기준으로 설계해 봅니다.
애플리케이션이 묻는 질문부터 정리하기
주문 화면에는 항목, 수량, 결제 당시 가격이 필요합니다. 상품 페이지에는 현재 카탈로그 가격과 설명이 필요합니다. 고객 지원 담당자는 고객의 주문 목록도 찾아야 합니다. 서로 관련 있는 데이터지만 변경 시점과 조회 경로는 다릅니다.
{
_id: ObjectId("..."),
customerId: ObjectId("..."),
status: "paid",
placedAt: ISODate("2026-11-17T09:00:00Z"),
items: [
{
productId: ObjectId("..."),
sku: "book-1",
titleAtPurchase: "MongoDB Basics",
quantity: 2,
unitPriceAtPurchase: Decimal128("18.00")
}
],
totalAtPurchase: Decimal128("36.00")
}
크기가 제한된 주문 항목은 주문 문서 안에 두고, 과거에도 그대로여야 하는 값을 스냅샷으로 보존합니다. 고객과 상품은 ID로 참조해 현재 계정이나 카탈로그를 열 수 있게 합니다. 스냅샷 가격은 현재 상품 가격의 두 번째 원본이 아니라 해당 주문에서 합의한 가격의 기록입니다.
하위 데이터 크기가 제한적일 때 내장하기
작은 주문의 항목을 함께 저장하면 영수증 화면을 한 문서 조회로 만들 수 있습니다. 해당 주문 문서의 수정은 문서 단위로 원자적입니다. 별도로 조회할 이유가 없는 소량의 주문 항목을 읽기 위해 두 번째 쿼리를 할 필요가 없습니다.
이 논리를 고객 문서 안에 모든 주문을 쌓는 데 적용해서는 안 됩니다. 배열의 크기가 계속 늘고 고객 문서가 커지며, 자주 조회되는 고객 정보가 높은 빈도의 주문 이력 쓰기와 결합됩니다. 주문은 별도 컬렉션에 저장하고 customerId 인덱스로 고객의 이력을 조회하세요.
필드마다 원본을 정하기
상품명이 바뀌어도 이전 영수증에 표시되는 내용은 바뀌지 않아야 합니다. titleAtPurchase와 unitPriceAtPurchase는 스냅샷이고 productId는 최신 재고나 최신 설명을 확인할 정본 상품 문서를 가리킵니다. 화면마다 어떤 값을 보여줄지 정하지 않으면 개발자가 의도치 않게 과거 주문 스냅샷을 오늘의 카탈로그 값으로 덮을 수 있습니다.
필요한 필드를 모두 주문마다 복사할 필요는 없습니다. 과거 기록에 필요한 값만 고정하고, 계속 동기화되어야 하는 중복 필드는 언제 어떻게 새로고침할지 정의하세요.
그럴듯하지만 잘못된 선택
productId만 저장하고 영수증에서 현재 가격을 조회하면 카탈로그가 바뀔 때 과거 결제 금액을 알 수 없습니다. 고객 문서에 전체 주문 이력을 넣으면 조회 한 번은 줄어들어도 무한히 증가하는 배열과 변경이 잦은 부모 문서가 생깁니다. 모든 필드를 각각의 컬렉션으로 나누면 함께 읽는 화면에 여러 조회와 조정이 추가될 수 있습니다.
별도 문서 또는 컬렉션에 저장된 결제와 재고 변경을 하나의 논리 작업으로 처리해야 하는 경우 트랜잭션이 유용합니다. 그렇다고 모든 작업을 트랜잭션으로 감싸는 것이 좋은 모델은 아닙니다. 단일 문서 수정으로 가능한 구조를 먼저 검토하고, 여러 문서 사이에서 지켜야 하는 불변 조건이 있을 때 경계를 정해 트랜잭션을 사용하세요.
이해 확인
질문: 상품 카탈로그 가격을 바꾼 뒤 과거 주문 영수증에는 어떤 가격이 보여야 하나요?
답: 주문의 unitPriceAtPurchase를 보여야 합니다. 최신 가격은 상품 문서에 있고 현재 상품 화면에서 사용합니다. 주문 이력은 결제 당시 사실을 보존합니다.