E-Commerce 프로젝트 - Entity 설계(Member, Product, Order, OrderItem)

프로젝트 개요

Spring Boot 기반 이커머스 프로젝트를 진행하면서
핵심 도메인(Entity)을 먼저 설계했다.

단순 CRUD가 아닌 실제 서비스 흐름을 고려하여
회원 → 상품 → 주문 → 주문상품 구조를 설계하였다.

전체 구조 및 관계

Member
Product
Order
OrderItem
Cart(나중에)

Member (1) : (N) Order
Order (1) : (N) OrderItem
Product (1) : (N) OrderItem

MemberEntity

package com.jeongbeom.ecommerce.member.entity;

import com.jeongbeom.ecommerce.common.entity.BaseTimeEntity;
import com.jeongbeom.ecommerce.common.entity.Role;
import jakarta.persistence.*;
import lombok.Getter;
import lombok.NoArgsConstructor;

@Entity
@Getter
@NoArgsConstructor(access = lombok.AccessLevel.PROTECTED) // 기본 생성자 자동 생성, 외부 생성 차단
public class Member extends BaseTimeEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id; //PK

    @Column(nullable = false, unique = true)
    private String email;

    @Column(nullable = false)
    private String password;

    @Column(nullable = false)
    private String phone;

    @Enumerated(EnumType.STRING)
    @Column(nullable = false)
    private Role role;

    public Member(String email, String password, String phone, Role role) {
        this.email = email;
        this.password = password;
        this.phone = phone;
        this.role = role;
    }
}

• Member 엔티티는 사용자 정보를 관리하며, email에 unique 제약조건을 설정하여 중복 데이터를 방지하였다.
• Role을 Enum 타입으로 관리하여 사용자 권한을 명확하게 구분할 수 있도록 설계하였다.

MemberRepository

package com.jeongbeom.ecommerce.member.repository;

import com.jeongbeom.ecommerce.member.entity.Member;
import org.springframework.data.jpa.repository.JpaRepository;

import java.util.Optional;

public interface MemberRepository extends JpaRepository<Member, Long> {
    Optional<Member> findByEmail(String email);
}

OrderEntity

package com.jeongbeom.ecommerce.order.entity;

import com.jeongbeom.ecommerce.common.entity.BaseTimeEntity;
import com.jeongbeom.ecommerce.member.entity.Member;
import jakarta.persistence.*;
import lombok.Getter;
import lombok.NoArgsConstructor;

@Entity
@Getter
@Table(name = "orders")
@NoArgsConstructor(access = lombok.AccessLevel.PROTECTED)
public class Order extends BaseTimeEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id; //PK

    //Member 연결
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "member_id", nullable = false)
    private Member member;

    @Column(nullable = false)
    private String orderNumber;

    @Column(nullable = false)
    private int totalPrice;

    @Enumerated(EnumType.STRING)
    @Column(nullable = false)
    private OrderStatus status;

    @Column(nullable = false)
    private String name;

    @Column(nullable = false)
    private String phone;

    @Column(nullable = false)
    private String address;

    public Order(Member member, String orderNumber, int totalPrice, OrderStatus status, String name, String phone, String address) {
        this.member = member;
        this.orderNumber = orderNumber;
        this.totalPrice = totalPrice;
        this.status = status;
        this.name = name;
        this.phone = phone;
        this.address = address;
    }
}

• Order 엔티티는 주문 상태를 OrderStatus Enum으로 관리하여
  주문의 lifecycle을 명확하게 표현할 수 있도록 설계하였다.
• 배송 정보를 별도로 저장하여 회원 정보 변경과 관계없이 주문 시점의 배송 정보를 유지할 수 있도록 하였다.
• Member와의 연관관계를 통해 주문 주체를 명확히 하고 데이터 정합성을 유지하도록 설계하였다.

OrderRepository

package com.jeongbeom.ecommerce.order.entity.repository;

import com.jeongbeom.ecommerce.order.entity.Order;
import org.springframework.data.jpa.repository.JpaRepository;

public interface OrderRepository extends JpaRepository<Order, Long> {
}

OrderStarus

package com.jeongbeom.ecommerce.order.entity;

public enum OrderStatus {
    CREATED,    //주문 생성됨 (결제전)
    PAID,       //결제 완료
    PREPARING,  //상품 준비중
    SHIPPED,    //배송 시작
    DELIVERED,  //배송 완료
    CANCELLED   //주문 취소
}

OrderItemEntity

package com.jeongbeom.ecommerce.order.entity;

import com.jeongbeom.ecommerce.common.entity.BaseTimeEntity;
import com.jeongbeom.ecommerce.product.entity.Product;
import jakarta.persistence.*;
import lombok.Getter;
import lombok.NoArgsConstructor;

@Entity
@Getter
@NoArgsConstructor(access = lombok.AccessLevel.PROTECTED)
public class OrderItem extends BaseTimeEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id; //PK

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "product_id", nullable = false)
    private Product product;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "order_id", nullable = false)
    private Order order;

    @Column(nullable = false)
    private int orderPrice;

    @Column(nullable = false)
    private int orderQuantity;

    public OrderItem(Product product, Order order, int orderPrice, int orderQuantity) {
        this.product = product;
        this.order = order;
        this.orderPrice = orderPrice;
        this.orderQuantity = orderQuantity;
    }
}

• OrderItem은 주문(Order)과 상품(Product)을 연결하는 핵심 엔티티로 설계하였다.
• 상품 가격은 변동될 수 있기 때문에 주문 시점의 가격(orderPrice)을 별도로 저장하여, 이후 상품 가격이 변경되더라도 주문 당시의 정보를 유지할 수 있도록 하였다.
• 주문 수량(quantity)을 함께 저장하여 주문 상세 정보를 구성할 수 있도록 설계하였다.

OrderItemRepository

package com.jeongbeom.ecommerce.order.entity.repository;

import com.jeongbeom.ecommerce.order.entity.OrderItem;
import org.springframework.data.jpa.repository.JpaRepository;

public interface OrderItemRepository extends JpaRepository<OrderItem, Long> {
}

ProductEntity

package com.jeongbeom.ecommerce.product.entity;

import com.jeongbeom.ecommerce.common.entity.BaseTimeEntity;
import jakarta.persistence.*;
import lombok.Getter;
import lombok.NoArgsConstructor;

@Entity
@Getter
@NoArgsConstructor(access = lombok.AccessLevel.PROTECTED)
public class Product extends BaseTimeEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id; //PK

    @Column(nullable = false)
    private String name; //상품 이름

    @Column(nullable = false)
    private String description; //상품 상세 설명

    @Column(nullable = false)
    private int price;  //상품 가격

    @Column(nullable = false)
    private int stock;  //상품 재고 수량

    @Enumerated(EnumType.STRING)
    @Column(nullable = false)
    private ProductStatus status;  //상품 상태

    // 생성자
    public Product(String name, String description, int price, int stock, ProductStatus status) {
        this.name = name;
        this.description = description;
        this.price = price;
        this.stock = stock;
        this.status = status;
    }

    // 재고 감소
    public void decreaseStock(int quantity){
        if(stock < quantity){
            throw new IllegalArgumentException("재고 부족");
        }
        this.stock -= quantity;
    }

    // 재고 증가
    public void increaseStock(int quantity){
        this.stock += quantity;
    }
}

• 재고 감소 및 증가 로직을 Entity 내부에 포함시켜 비즈니스 로직이 도메인에 집중되도록 설계하였다. 이를 통해 도메인 중심 설계(Domain-driven design)를 적용하였다.

ProductRepository

package com.jeongbeom.ecommerce.product.entity.repository;

import com.jeongbeom.ecommerce.product.entity.Product;
import org.springframework.data.jpa.repository.JpaRepository;

public interface ProductRepository extends JpaRepository<Product, Long> {
}

ProductStatus

package com.jeongbeom.ecommerce.product.entity;

public enum ProductStatus {
    ON_SALE, SOLD_OUT, HIDDEN
}