⚙️ 묶음 배송 로직의 핵심 알고리즘

자, 이제 본격적으로 로직을 구현해볼 시간이야! 묶음 배송 로직의 핵심은 그룹핑(Grouping)과 우선순위 결정(Priority)이야. 쉽게 말하면, 어떤 상품들을 묶을 수 있는지 판단하고, 그중에서 어떤 배송비를 적용할지 결정하는 거지.

📌 1단계: 배송 그룹 분류

먼저 장바구니에 담긴 상품들을 배송 그룹별로 분류해야 해. 같은 그룹에 속한 상품들만 묶음 배송이 가능하거든!

📌 2단계: 배송비 계산 로직

그룹이 나뉘었으면 이제 각 그룹의 배송비를 계산할 차례야. 여기서 여러 가지 방식을 적용할 수 있어.

// 기본 배송비 계산 로직 예시 (PHP)
function calculateShippingFee($cartItems) {
    $shippingGroups = [];
    
    // 1단계: 배송 그룹 분류
    foreach ($cartItems as $item) {
        $groupKey = $item['delivery_sno'] . '_' . $item['warehouse_code'];
        
        if (!isset($shippingGroups[$groupKey])) {
            $shippingGroups[$groupKey] = [
                'items' => [],
                'total_price' => 0,
                'base_fee' => $item['delivery_fee'],
                'free_condition' => $item['free_delivery_price']
            ];
        }
        
        $shippingGroups[$groupKey]['items'][] = $item;
        $shippingGroups[$groupKey]['total_price'] += $item['price'] * $item['quantity'];
    }
    
    // 2단계: 각 그룹별 배송비 계산
    $totalShippingFee = 0;
    
    foreach ($shippingGroups as $group) {
        // 무료배송 조건 확인
        if ($group['total_price'] >= $group['free_condition']) {
            continue; // 무료배송
        }
        
        // 배송비 합산 방식에 따라 처리
        $totalShippingFee += $group['base_fee'];
    }
    
    return $totalShippingFee;
}

🛠️ 고도몰 실전 구현 가이드

이론은 충분히 알아봤으니, 이제 고도몰에서 실제로 어떻게 구현하는지 단계별로 살펴볼게. 고도몰은 자체 프레임워크를 사용하기 때문에 특정 파일들을 수정해야 해. 😎

🔧 Step 1: 배송비 계산 모듈 수정

고도몰의 배송비 계산은 주로 module/Order/OrderCalculation.php 파일에서 처리돼. 이 파일을 열어서 배송비 계산 메서드를 찾아야 해.

// module/Order/OrderCalculation.php 내부

class OrderCalculation {
    
    /**
     * 묶음 배송비 계산
     * @param array $cartData 장바구니 데이터
     * @return array 배송비 정보
     */
    public function getDeliveryGroupCharge($cartData) {
        $deliveryGroup = [];
        $deliveryCharge = [];
        
        // 배송비 그룹 생성
        foreach ($cartData as $key => $val) {
            // 배송 정책별 그룹핑
            $groupKey = $val['deliverySno'] . '_' . $val['scmNo'];
            
            if (!isset($deliveryGroup[$groupKey])) {
                $deliveryGroup[$groupKey] = [
                    'deliverySno' => $val['deliverySno'],
                    'scmNo' => $val['scmNo'],
                    'goodsPrice' => 0,
                    'deliveryFee' => $val['deliveryFee'],
                    'deliveryFreePrice' => $val['deliveryFreePrice'],
                    'deliveryMethod' => $val['deliveryMethod'],
                    'goods' => []
                ];
            }
            
            // 상품 정보 추가
            $deliveryGroup[$groupKey]['goods'][] = $val;
            $deliveryGroup[$groupKey]['goodsPrice'] += $val['price'] * $val['goodsCnt'];
        }
        
        // 각 그룹별 배송비 계산
        foreach ($deliveryGroup as $groupKey => $group) {
            $fee = 0;
            
            // 배송비 계산 방식에 따라 분기
            switch ($group['deliveryMethod']) {
                case 'fixed': // 고정 배송비
                    if ($group['goodsPrice'] < $group['deliveryFreePrice']) {
                        $fee = $group['deliveryFee'];
                    }
                    break;
                    
                case 'quantity': // 수량별 배송비
                    $totalQty = 0;
                    foreach ($group['goods'] as $goods) {
                        $totalQty += $goods['goodsCnt'];
                    }
                    $fee = $this->calculateQuantityBasedFee($totalQty, $group);
                    break;
                    
                case 'weight': // 무게별 배송비
                    $totalWeight = 0;
                    foreach ($group['goods'] as $goods) {
                        $totalWeight += $goods['weight'] * $goods['goodsCnt'];
                    }
                    $fee = $this->calculateWeightBasedFee($totalWeight, $group);
                    break;
            }
            
            // 지역별 추가 배송비 계산
            $fee += $this->getRegionalExtraFee($group);
            
            $deliveryCharge[$groupKey] = [
                'fee' => $fee,
                'group' => $group
            ];
        }
        
        return $deliveryCharge;
    }
    
    /**
     * 수량별 배송비 계산
     */
    private function calculateQuantityBasedFee($quantity, $group) {
        // 수량 구간별 배송비 설정 조회
        $feeConfig = $this->getQuantityFeeConfig($group['deliverySno']);
        
        foreach ($feeConfig as $config) {
            if ($quantity >= $config['minQty'] && $quantity <= $config['maxQty']) {
                return $config['fee'];
            }
        }
        
        return $group['deliveryFee']; // 기본 배송비
    }
    
    /**
     * 무게별 배송비 계산
     */
    private function calculateWeightBasedFee($weight, $group) {
        // 무게 구간별 배송비 설정 조회
        $feeConfig = $this->getWeightFeeConfig($group['deliverySno']);
        
        foreach ($feeConfig as $config) {
            if ($weight >= $config['minWeight'] && $weight <= $config['maxWeight']) {
                return $config['fee'];
            }
        }
        
        return $group['deliveryFee']; // 기본 배송비
    }
    
    /**
     * 지역별 추가 배송비
     */
    private function getRegionalExtraFee($group) {
        // 배송지 주소 정보 가져오기
        $address = $this->getDeliveryAddress();
        
        // 제주/도서산간 체크
        if ($this->isRemoteArea($address)) {
            return $group['remoteAreaFee'] ?? 3000; // 기본 3,000원
        }
        
        return 0;
    }
}

🔧 Step 2: 장바구니 페이지 연동

배송비 계산 로직을 만들었으면, 이제 장바구니 페이지에서 이를 호출해야 해. 고도몰의 장바구니는 module/Order/Cart.php에서 처리돼.

// module/Order/Cart.php 내부

class Cart extends OrderCalculation {
    
    /**
     * 장바구니 정보 조회 (배송비 포함)
     */
    public function getCartInfo() {
        // 장바구니 상품 조회
        $cartData = $this->getCartData();
        
        if (empty($cartData)) {
            return [];
        }
        
        // 배송비 계산
        $deliveryCharge = $this->getDeliveryGroupCharge($cartData);
        
        // 총 주문 금액 계산
        $totalGoodsPrice = 0;
        $totalDeliveryFee = 0;
        
        foreach ($cartData as $item) {
            $totalGoodsPrice += $item['price'] * $item['goodsCnt'];
        }
        
        foreach ($deliveryCharge as $charge) {
            $totalDeliveryFee += $charge['fee'];
        }
        
        return [
            'cartData' => $cartData,
            'deliveryCharge' => $deliveryCharge,
            'totalGoodsPrice' => $totalGoodsPrice,
            'totalDeliveryFee' => $totalDeliveryFee,
            'totalOrderPrice' => $totalGoodsPrice + $totalDeliveryFee
        ];
    }
    
    /**
     * 장바구니 배송비 그룹 표시용 데이터
     */
    public function getDeliveryGroupDisplay() {
        $cartInfo = $this->getCartInfo();
        $displayData = [];
        
        foreach ($cartInfo['deliveryCharge'] as $groupKey => $charge) {
            $group = $charge['group'];
            
            $displayData[] = [
                'groupName' => $this->getDeliveryPolicyName($group['deliverySno']),
                'goodsList' => $group['goods'],
                'goodsPrice' => number_format($group['goodsPrice']),
                'deliveryFee' => number_format($charge['fee']),
                'freeCondition' => number_format($group['deliveryFreePrice']),
                'remainForFree' => max(0, $group['deliveryFreePrice'] - $group['goodsPrice'])
            ];
        }
        
        return $displayData;
    }
}

🔧 Step 3: 프론트엔드 화면 구성

백엔드 로직이 완성되었으면, 이제 사용자에게 보여줄 화면을 만들어야 해. 고도몰의 템플릿 파일은 skin/ 폴더 아래에 있어.

<!-- skin/front/[스킨명]/order/cart.html -->

<div class="cart-delivery-group">
    <h3>배송비 안내</h3>
    
    <!--{ @deliveryGroup }-->
    <div class="delivery-group-item">
        <div class="group-header">
            <strong>{=groupName}</strong>
            <span class="delivery-fee">배송비: {=deliveryFee}원</span>
        </div>
        
        <div class="group-goods">
            <!--{ @goodsList }-->
            <div class="goods-item">
                <img src="{=imageUrl}" alt="{=goodsNm}">
                <span>{=goodsNm}</span>
                <span>{=price}원 x {=goodsCnt}개</span>
            </div>
            <!--{ / }-->
        </div>
        
        <!--{ @if remainForFree > 0 }-->
        <div class="free-delivery-guide">
            <p>{=remainForFree}원 더 구매하시면 무료배송!</p>
            <div class="progress-bar">
                <div class="progress" style="width: {=progressPercent}%"></div>
            </div>
        </div>
        <!--{ / }-->
    </div>
    <!--{ / }-->
    
    <div class="total-delivery-fee">
        <strong>총 배송비</strong>
        <span>{=totalDeliveryFee}원</span>
    </div>
</div>

이렇게 하면 사용자가 장바구니에서 배송 그룹별로 묶인 상품들과 각 그룹의 배송비를 한눈에 볼 수 있어! 🎨

🎨 고급 기능 구현하기

기본적인 묶음 배송 로직을 구현했다면, 이제 좀 더 고급 기능들을 추가해볼 차례야. 실제 쇼핑몰에서는 다양한 예외 상황과 특수 케이스들이 있거든! 💪

🌟 기능 1: 스마트 배송비 최적화

고객이 여러 배송 그룹의 상품을 담았을 때, 어떤 조합이 가장 저렴한지 자동으로 계산해주는 기능이야. 예를 들어 A그룹 상품 2개와 B그룹 상품 1개를 담았는데, A그룹에서 1개만 더 사면 무료배송이 된다면 이를 알려주는 거지!

/**
 * 배송비 최적화 제안
 */
public function suggestOptimalDelivery($cartData) {
    $suggestions = [];
    $deliveryGroups = $this->getDeliveryGroupCharge($cartData);
    
    foreach ($deliveryGroups as $groupKey => $charge) {
        $group = $charge['group'];
        
        // 무료배송까지 남은 금액 계산
        if ($group['goodsPrice'] < $group['deliveryFreePrice']) {
            $remainAmount = $group['deliveryFreePrice'] - $group['goodsPrice'];
            
            // 해당 그룹의 추천 상품 조회
            $recommendGoods = $this->getRecommendGoodsByPrice(
                $group['deliverySno'],
                $remainAmount
            );
            
            if (!empty($recommendGoods)) {
                $suggestions[] = [
                    'groupName' => $this->getDeliveryPolicyName($group['deliverySno']),
                    'currentFee' => $charge['fee'],
                    'remainAmount' => $remainAmount,
                    'recommendGoods' => $recommendGoods,
                    'message' => number_format($remainAmount) . '원만 더 구매하시면 배송비 ' . 
                                 number_format($charge['fee']) . '원이 무료!'
                ];
            }
        }
    }
    
    return $suggestions;
}

/**
 * 가격대별 추천 상품 조회
 */
private function getRecommendGoodsByPrice($deliverySno, $targetPrice) {
    // 해당 배송 정책을 사용하는 상품 중
    // 목표 가격 이하의 인기 상품 조회
    $db = \App::load('DB');
    
    $sql = "SELECT goodsNo, goodsNm, goodsPrice, goodsImage 
            FROM es_goods 
            WHERE deliverySno = ? 
            AND goodsPrice <= ? 
            AND goodsSellFl = 'y'
            ORDER BY orderCnt DESC 
            LIMIT 5";
    
    return $db->query_fetch($sql, [$deliverySno, $targetPrice]);
}

🌟 기능 2: 실시간 배송비 미리보기

고객이 장바구니에 상품을 추가하거나 수량을 변경할 때마다 실시간으로 배송비가 어떻게 변하는지 보여주는 기능이야. AJAX를 활용해서 구현할 수 있어!

// JavaScript (jQuery 사용)
function updateDeliveryFeePreview() {
    var cartItems = [];
    
    // 장바구니 상품 정보 수집
    $('.cart-item').each(function() {
        cartItems.push({
            goodsNo: $(this).data('goods-no'),
            goodsCnt: $(this).find('.quantity-input').val(),
            deliverySno: $(this).data('delivery-sno')
        });
    });
    
    // AJAX 요청
    $.ajax({
        url: '/order/ajax_calculate_delivery',
        type: 'POST',
        data: {
            cartItems: JSON.stringify(cartItems)
        },
        success: function(response) {
            if (response.success) {
                // 배송비 정보 업데이트
                updateDeliveryDisplay(response.deliveryCharge);
                
                // 무료배송까지 남은 금액 표시
                updateFreeDeliveryProgress(response.deliveryCharge);
                
                // 총 주문금액 업데이트
                $('#total-order-price').text(
                    number_format(response.totalOrderPrice) + '원'
                );
            }
        }
    });
}

// 배송비 정보 화면 업데이트
function updateDeliveryDisplay(deliveryCharge) {
    $('.delivery-group-item').each(function(index) {
        var groupKey = $(this).data('group-key');
        var charge = deliveryCharge[groupKey];
        
        if (charge) {
            $(this).find('.delivery-fee').text(
                '배송비: ' + number_format(charge.fee) + '원'
            );
            
            // 무료배송 달성 시 표시
            if (charge.fee === 0) {
                $(this).find('.free-badge').show();
            } else {
                $(this).find('.free-badge').hide();
            }
        }
    });
}

// 무료배송 진행률 업데이트
function updateFreeDeliveryProgress(deliveryCharge) {
    $('.delivery-group-item').each(function() {
        var groupKey = $(this).data('group-key');
        var charge = deliveryCharge[groupKey];
        
        if (charge && charge.group.deliveryFreePrice > 0) {
            var percent = Math.min(100, 
                (charge.group.goodsPrice / charge.group.deliveryFreePrice) * 100
            );
            
            $(this).find('.progress').css('width', percent + '%');
            
            var remainAmount = Math.max(0, 
                charge.group.deliveryFreePrice - charge.group.goodsPrice
            );
            
            if (remainAmount > 0) {
                $(this).find('.remain-amount').text(
                    number_format(remainAmount) + '원'
                );
            } else {
                $(this).find('.free-delivery-guide').html(
                    '<strong>🎉 무료배송 달성!</strong>'
                );
            }
        }
    });
}

// 수량 변경 시 이벤트 바인딩
$(document).on('change', '.quantity-input', function() {
    updateDeliveryFeePreview();
});

// 상품 삭제 시 이벤트 바인딩
$(document).on('click', '.btn-delete-item', function() {
    // 상품 삭제 후
    updateDeliveryFeePreview();
});

🌟 기능 3: 배송지 분리 주문

하나의 주문에서 여러 배송지로 보내야 하는 경우도 있어. 예를 들어 선물용으로 각각 다른 사람에게 보내는 경우지. 이때는 배송지별로 배송비를 따로 계산해야 해!

/**
 * 배송지 분리 주문 처리
 */
public function processMultipleDeliveryAddress($orderData) {
    $deliveryAddresses = $orderData['deliveryAddresses']; // 배송지 목록
    $cartItems = $orderData['cartItems'];
    
    $deliveryGroups = [];
    
    // 배송지별로 상품 그룹핑
    foreach ($cartItems as $item) {
        $addressKey = $item['deliveryAddressKey'];
        $deliveryKey = $item['deliverySno'] . '_' . $addressKey;
        
        if (!isset($deliveryGroups[$deliveryKey])) {
            $deliveryGroups[$deliveryKey] = [
                'address' => $deliveryAddresses[$addressKey],
                'deliverySno' => $item['deliverySno'],
                'items' => [],
                'goodsPrice' => 0
            ];
        }
        
        $deliveryGroups[$deliveryKey]['items'][] = $item;
        $deliveryGroups[$deliveryKey]['goodsPrice'] += $item['price'] * $item['goodsCnt'];
    }
    
    // 각 배송지별 배송비 계산
    $totalDeliveryFee = 0;
    $deliveryCharges = [];
    
    foreach ($deliveryGroups as $deliveryKey => $group) {
        // 기본 배송비 계산
        $baseFee = $this->calculateBasicDeliveryFee($group);
        
        // 지역별 추가 배송비
        $extraFee = $this->calculateRegionalExtraFee($group['address']);
        
        $totalFee = $baseFee + $extraFee;
        
        $deliveryCharges[$deliveryKey] = [
            'baseFee' => $baseFee,
            'extraFee' => $extraFee,
            'totalFee' => $totalFee,
            'address' => $group['address']
        ];
        
        $totalDeliveryFee += $totalFee;
    }
    
    return [
        'deliveryGroups' => $deliveryGroups,
        'deliveryCharges' => $deliveryCharges,
        'totalDeliveryFee' => $totalDeliveryFee
    ];
}

/**
 * 지역별 추가 배송비 계산 (상세)
 */
private function calculateRegionalExtraFee($address) {
    $extraFee = 0;
    
    // 제주도 체크
    if (strpos($address['address1'], '제주') !== false) {
        $extraFee += 3000;
    }
    
    // 도서산간 체크 (우편번호 기반)
    $remoteAreaZipCodes = $this->getRemoteAreaZipCodes();
    if (in_array($address['zipcode'], $remoteAreaZipCodes)) {
        $extraFee += 5000;
    }
    
    // 산간지역 추가 체크
    $mountainKeywords = ['산', '면', '리'];
    foreach ($mountainKeywords as $keyword) {
        if (strpos($address['address2'], $keyword) !== false) {
            $extraFee += 2000;
            break;
        }
    }
    
    return $extraFee;
}

🐛 자주 발생하는 문제와 해결 방법

묶음 배송 로직을 구현하다 보면 여러 가지 문제에 부딪히게 돼. 내가 실제로 겪었던 문제들과 해결 방법을 공유할게! 😅

❌ 문제 1: 배송비가 중복으로 계산되는 경우

원인: 배송 그룹 키(groupKey)를 생성할 때 고유하지 않은 값을 사용했거나, 그룹핑 로직에서 조건 체크가 누락됨.

해결 방법:

// 잘못된 예시
$groupKey = $item['deliverySno']; // 배송 정책 ID만 사용

// 올바른 예시
$groupKey = $item['deliverySno'] . '_' . 
            $item['scmNo'] . '_' . 
            $item['warehouseCode'] . '_' .
            ($item['separateDelivery'] ? uniqid() : ''); // 개별 배송 상품은 별도 그룹

// 추가로 배송 불가 조합 체크
if ($this->isNonMixableGoods($item)) {
    $groupKey .= '_' . $item['goodsNo']; // 상품별로 별도 그룹
}

❌ 문제 2: 무료배송 조건이 제대로 적용되지 않음

원인: 상품 금액 합산 시 할인이나 쿠폰을 고려하지 않았거나, 그룹별 금액 계산이 잘못됨.

해결 방법:

/**
 * 무료배송 조건 체크 (할인 적용 후 금액 기준)
 */
private function checkFreeDeliveryCondition($group, $discountInfo) {
    // 상품 금액 합산
    $totalGoodsPrice = 0;
    
    foreach ($group['items'] as $item) {
        $itemPrice = $item['price'] * $item['goodsCnt'];
        
        // 상품별 할인 적용
        if (isset($discountInfo[$item['goodsNo']])) {
            $itemPrice -= $discountInfo[$item['goodsNo']]['discountAmount'];
        }
        
        $totalGoodsPrice += $itemPrice;
    }
    
    // 그룹 전체 할인 적용 (장바구니 쿠폰 등)
    if (isset($discountInfo['groupDiscount'][$group['deliverySno']])) {
        $totalGoodsPrice -= $discountInfo['groupDiscount'][$group['deliverySno']];
    }
    
    // 무료배송 조건 체크
    $freeDeliveryPrice = $group['deliveryFreePrice'];
    
    // 무료배송 조건이 0이면 항상 유료
    if ($freeDeliveryPrice == 0) {
        return false;
    }
    
    // 조건 금액 이상이면 무료배송
    return ($totalGoodsPrice >= $freeDeliveryPrice);
}

❌ 문제 3: 수량 변경 시 배송비가 실시간으로 업데이트되지 않음

원인: 프론트엔드에서 수량 변경 이벤트를 제대로 감지하지 못하거나, AJAX 요청이 실패함.

해결 방법:

// 디바운싱을 적용한 실시간 업데이트
var deliveryUpdateTimer;

function scheduleDeliveryUpdate() {
    // 기존 타이머 취소
    clearTimeout(deliveryUpdateTimer);
    
    // 0.5초 후 업데이트 (연속 입력 방지)
    deliveryUpdateTimer = setTimeout(function() {
        updateDeliveryFeePreview();
    }, 500);
}

// 수량 입력 이벤트
$(document).on('input', '.quantity-input', function() {
    // 입력값 검증
    var value = parseInt($(this).val());
    if (isNaN(value) || value < 1) {
        $(this).val(1);
    }
    
    scheduleDeliveryUpdate();
});

// +/- 버튼 클릭 이벤트
$(document).on('click', '.btn-quantity-plus, .btn-quantity-minus', function() {
    var $input = $(this).siblings('.quantity-input');
    var currentValue = parseInt($input.val());
    var newValue;
    
    if ($(this).hasClass('btn-quantity-plus')) {
        newValue = currentValue + 1;
    } else {
        newValue = Math.max(1, currentValue - 1);
    }
    
    $input.val(newValue);
    scheduleDeliveryUpdate();
});

// AJAX 에러 처리
function updateDeliveryFeePreview() {
    $.ajax({
        url: '/order/ajax_calculate_delivery',
        type: 'POST',
        data: {
            cartItems: getCartItemsData()
        },
        success: function(response) {
            if (response.success) {
                updateDeliveryDisplay(response.deliveryCharge);
            } else {
                console.error('배송비 계산 실패:', response.message);
                showErrorMessage('배송비를 계산할 수 없습니다.');
            }
        },
        error: function(xhr, status, error) {
            console.error('AJAX 요청 실패:', error);
            showErrorMessage('일시적인 오류가 발생했습니다. 다시 시도해주세요.');
        }
    });
}

❌ 문제 4: 모바일에서 배송비 정보가 제대로 표시되지 않음

원인: 반응형 CSS가 제대로 적용되지 않았거나, 테이블 형태의 레이아웃을 사용해서 모바일에서 가로 스크롤이 발생함.

해결 방법:

/* 반응형 배송비 표시 CSS */
.delivery-group-item {
    background: #f8f9fa;
    border-radius: 8px;
    padding: 15px;
    margin-bottom: 15px;
}

.group-header {
    display: flex;
    justify-content: space-between;
    align-items: center;
    margin-bottom: 10px;
    flex-wrap: wrap; /* 모바일에서 줄바꿈 */
}

.delivery-fee {
    color: #e74c3c;
    font-weight: bold;
    font-size: 1.1em;
}

/* 모바일 최적화 */
@media (max-width: 768px) {
    .group-header {
        flex-direction: column;
        align-items: flex-start;
    }
    
    .delivery-fee {
        margin-top: 5px;
        font-size: 1em;
    }
    
    .group-goods {
        display: flex;
        flex-direction: column;
        gap: 10px;
    }
    
    .goods-item {
        display: flex;
        align-items: center;
        gap: 10px;
        padding: 10px;
        background: white;
        border-radius: 5px;
    }
    
    .goods-item img {
        width: 60px;
        height: 60px;
        object-fit: cover;
        border-radius: 5px;
    }
    
    .free-delivery-guide {
        padding: 10px;
        background: #e8f5e9;
        border-radius: 5px;
        margin-top: 10px;
    }
    
    .progress-bar {
        width: 100%;
        height: 8px;
        background: #ddd;
        border-radius: 4px;
        overflow: hidden;
        margin-top: 8px;
    }
    
    .progress {
        height: 100%;
        background: linear-gradient(90deg, #66bb6a, #4caf50);
        transition: width 0.3s ease;
    }
}

📊 성능 최적화 전략

배송비 계산은 주문 프로세스에서 매우 빈번하게 일어나는 작업이야. 특히 장바구니 페이지에서는 사용자가 수량을 변경할 때마다 계산이 이루어지기 때문에 성능 최적화가 정말 중요해! ⚡

🚀 최적화 기법 1: 배송 정책 캐싱

배송 정책 정보는 자주 변경되지 않으니까 캐시에 저장해두고 사용하면 DB 조회를 크게 줄일 수 있어.

/**
 * 배송 정책 캐싱 (Redis 사용)
 */
class DeliveryPolicyCache {
    
    private $redis;
    private $cachePrefix = 'delivery_policy:';
    private $cacheTTL = 3600; // 1시간
    
    public function __construct() {
        $this->redis = new Redis();
        $this->redis->connect('127.0.0.1', 6379);
    }
    
    /**
     * 배송 정책 조회 (캐시 우선)
     */
    public function getDeliveryPolicy($deliverySno) {
        $cacheKey = $this->cachePrefix . $deliverySno;
        
        // 캐시에서 조회
        $cached = $this->redis->get($cacheKey);
        if ($cached !== false) {
            return json_decode($cached, true);
        }
        
        // DB에서 조회
        $policy = $this->fetchFromDatabase($deliverySno);
        
        // 캐시에 저장
        $this->redis->setex(
            $cacheKey,
            $this->cacheTTL,
            json_encode($policy)
        );
        
        return $policy;
    }
    
    /**
     * 배송 정책 일괄 조회
     */
    public function getMultipleDeliveryPolicies($deliverySnoList) {
        $policies = [];
        $missingKeys = [];
        
        // 캐시에서 일괄 조회
        $cacheKeys = array_map(function($sno) {
            return $this->cachePrefix . $sno;
        }, $deliverySnoList);
        
        $cachedData = $this->redis->mget($cacheKeys);
        
        foreach ($deliverySnoList as $index => $sno) {
            if ($cachedData[$index] !== false) {
                $policies[$sno] = json_decode($cachedData[$index], true);
            } else {
                $missingKeys[] = $sno;
            }
        }
        
        // 캐시에 없는 것만 DB 조회
        if (!empty($missingKeys)) {
            $dbPolicies = $this->fetchMultipleFromDatabase($missingKeys);
            
            foreach ($dbPolicies as $sno => $policy) {
                $policies[$sno] = $policy;
                
                // 캐시에 저장
                $this->redis->setex(
                    $this->cachePrefix . $sno,
                    $this->cacheTTL,
                    json_encode($policy)
                );
            }
        }
        
        return $policies;
    }
    
    /**
     * 캐시 무효화
     */
    public function invalidateCache($deliverySno) {
        $cacheKey = $this->cachePrefix . $deliverySno;
        $this->redis->del($cacheKey);
    }
}

🚀 최적화 기법 2: 쿼리 최적화

배송비 계산에 필요한 데이터를 한 번의 쿼리로 가져오도록 최적화해야 해.

/**
 * 최적화된 장바구니 데이터 조회
 */
public function getOptimizedCartData($memNo) {
    $db = \App::load('DB');
    
    // JOIN을 활용한 단일 쿼리로 모든 정보 조회
    $sql = "
        SELECT 
            c.cartSno,
            c.goodsNo,
            c.goodsCnt,
            g.goodsNm,
            g.goodsPrice as price,
            g.goodsWeight as weight,
            d.sno as deliverySno,
            d.deliveryFee,
            d.deliveryFreePrice,
            d.deliveryMethod,
            d.scmNo,
            d.warehouseCode,
            s.companyNm as scmName,
            CASE 
                WHEN g.goodsSellFl = 'n' THEN 'soldout'
                WHEN g.stockFl = 'y' AND g.totalStock < c.goodsCnt THEN 'shortage'
                ELSE 'available'
            END as stockStatus
        FROM es_cart c
        INNER JOIN es_goods g ON c.goodsNo = g.goodsNo
        INNER JOIN es_delivery d ON g.deliverySno = d.sno
        LEFT JOIN es_scm s ON d.scmNo = s.sno
        WHERE c.memNo = ?
        AND c.cartSno > 0
        ORDER BY d.sno, d.scmNo
    ";
    
    $cartData = $db->query_fetch($sql, [$memNo]);
    
    return $cartData;
}

🚀 최적화 기법 3: 프론트엔드 최적화

불필요한 AJAX 요청을 줄이고, 사용자 경험을 개선하는 방법이야.

// 디바운싱과 쓰로틀링을 활용한 최적화
class DeliveryFeeUpdater {
    constructor() {
        this.updateTimer = null;
        this.lastUpdateTime = 0;
        this.minUpdateInterval = 1000; // 최소 1초 간격
        this.debounceDelay = 500; // 0.5초 디바운스
    }
    
    /**
     * 디바운싱 적용 업데이트
     */
    scheduleUpdate() {
        clearTimeout(this.updateTimer);
        
        this.updateTimer = setTimeout(() => {
            this.performUpdate();
        }, this.debounceDelay);
    }
    
    /**
     * 쓰로틀링 체크 후 업데이트
     */
    performUpdate() {
        const now = Date.now();
        const timeSinceLastUpdate = now - this.lastUpdateTime;
        
        if (timeSinceLastUpdate < this.minUpdateInterval) {
            // 너무 빠른 요청은 지연
            setTimeout(() => {
                this.performUpdate();
            }, this.minUpdateInterval - timeSinceLastUpdate);
            return;
        }
        
        this.lastUpdateTime = now;
        this.updateDeliveryFee();
    }
    
    /**
     * 실제 배송비 업데이트
     */
    updateDeliveryFee() {
        const cartData = this.getCartData();
        
        // 로컬 캐시 체크
        const cacheKey = this.generateCacheKey(cartData);
        const cached = this.getFromLocalCache(cacheKey);
        
        if (cached && !this.isCacheExpired(cached)) {
            this.updateUI(cached.data);
            return;
        }
        
        // AJAX 요청
        $.ajax({
            url: '/order/ajax_calculate_delivery',
            type: 'POST',
            data: { cartData: JSON.stringify(cartData) },
            success: (response) => {
                if (response.success) {
                    // 로컬 캐시에 저장
                    this.saveToLocalCache(cacheKey, response, 60); // 60초 캐시
                    this.updateUI(response);
                }
            }
        });
    }
    
    /**
     * 로컬 스토리지 캐시
     */
    getFromLocalCache(key) {
        try {
            const cached = localStorage.getItem('delivery_' + key);
            return cached ? JSON.parse(cached) : null;
        } catch (e) {
            return null;
        }
    }
    
    saveToLocalCache(key, data, ttl) {
        try {
            const cacheData = {
                data: data,
                timestamp: Date.now(),
                ttl: ttl * 1000
            };
            localStorage.setItem('delivery_' + key, JSON.stringify(cacheData));
        } catch (e) {
            // 스토리지 용량 초과 시 오래된 캐시 삭제
            this.clearOldCache();
        }
    }
    
    isCacheExpired(cached) {
        return (Date.now() - cached.timestamp) > cached.ttl;
    }
    
    /**
     * 캐시 키 생성
     */
    generateCacheKey(cartData) {
        const keyData = cartData.map(item => 
            `${item.goodsNo}_${item.goodsCnt}`
        ).join('|');
        
        // 간단한 해시 생성
        let hash = 0;
        for (let i = 0; i < keyData.length; i++) {
            hash = ((hash << 5) - hash) + keyData.charCodeAt(i);
            hash = hash & hash;
        }
        return Math.abs(hash).toString(36);
    }
}

🎓 실전 활용 사례

이론과 코드만 봐서는 감이 안 올 수 있으니, 실제 쇼핑몰에서 어떻게 활용되는지 사례를 들어볼게! 🏪

📱 사례 1: 패션 쇼핑몰 - 브랜드별 묶음 배송

여러 브랜드를 입점시킨 패션 쇼핑몰에서는 브랜드(공급사)별로 배송비를 다르게 책정하는 경우가 많아. 예를 들어 A브랜드는 3만원 이상 무료배송, B브랜드는 5만원 이상 무료배송 이런 식으로 말이야.

/**
 * 브랜드별 배송비 정책 적용
 */
public function calculateBrandBasedDelivery($cartData) {
    $brandGroups = [];
    
    // 브랜드(SCM)별로 그룹핑
    foreach ($cartData as $item) {
        $brandKey = $item['scmNo'];
        
        if (!isset($brandGroups[$brandKey])) {
            $brandGroups[$brandKey] = [
                'brandName' => $item['scmName'],
                'items' => [],
                'totalPrice' => 0,
                'deliveryPolicy' => $this->getBrandDeliveryPolicy($item['scmNo'])
            ];
        }
        
        $brandGroups[$brandKey]['items'][] = $item;
        $brandGroups[$brandKey]['totalPrice'] += $item['price'] * $item['goodsCnt'];
    }
    
    // 각 브랜드별 배송비 계산
    $deliveryCharges = [];
    
    foreach ($brandGroups as $brandKey => $group) {
        $policy = $group['deliveryPolicy'];
        $fee = 0;
        
        // 브랜드별 무료배송 조건 체크
        if ($group['totalPrice'] < $policy['freeDeliveryPrice']) {
            $fee = $policy['deliveryFee'];
        }
        
        // 브랜드별 특별 프로모션 체크
        if ($this->hasSpecialPromotion($brandKey)) {
            $fee = 0; // 프로모션 기간 무료배송
        }
        
        $deliveryCharges[$brandKey] = [
            'brandName' => $group['brandName'],
            'fee' => $fee,
            'freeCondition' => $policy['freeDeliveryPrice'],
            'remainAmount' => max(0, $policy['freeDeliveryPrice'] - $group['totalPrice'])
        ];
    }
    
    return $deliveryCharges;
}

🍎 사례 2: 식품 쇼핑몰 - 온도대별 배송 분리

신선식품을 판매하는 쇼핑몰에서는 상온/냉장/냉동 상품을 각각 다른 배송으로 보내야 해. 이때 온도대별로 배송비를 계산해야 하지.

/**
 * 온도대별 배송비 계산
 */
public function calculateTemperatureBasedDelivery($cartData) {
    $tempGroups = [
        'normal' => ['name' => '상온', 'items' => [], 'fee' => 3000],
        'cold' => ['name' => '냉장', 'items' => [], 'fee' => 5000],
        'frozen' => ['name' => '냉동', 'items' => [], 'fee' => 5000]
    ];
    
    // 온도대별 분류
    foreach ($cartData as $item) {
        $tempType = $this->getGoodsTemperatureType($item['goodsNo']);
        
        if (isset($tempGroups[$tempType])) {
            $tempGroups[$tempType]['items'][] = $item;
        }
    }
    
    // 각 온도대별 배송비 계산
    $deliveryCharges = [];
    
    foreach ($tempGroups as $tempType => $group) {
        if (empty($group['items'])) {
            continue; // 해당 온도대 상품이 없으면 스킵
        }
        
        $totalPrice = 0;
        foreach ($group['items'] as $item) {
            $totalPrice += $item['price'] * $item['goodsCnt'];
        }
        
        $fee = $group['fee'];
        
        // 온도대별 무료배송 조건 (예: 5만원 이상)
        if ($totalPrice >= 50000) {
            $fee = 0;
        }
        
        $deliveryCharges[$tempType] = [
            'name' => $group['name'],
            'fee' => $fee,
            'itemCount' => count($group['items']),
            'totalPrice' => $totalPrice
        ];
    }
    
    return $deliveryCharges;
}

/**
 * 상품의 온도대 조회
 */
private function getGoodsTemperatureType($goodsNo) {
    // 상품 정보에서 온도대 정보 조회
    $db = \App::load('DB');
    
    $sql = "SELECT temperatureType FROM es_goods WHERE goodsNo = ?";
    $result = $db->query_fetch($sql, [$goodsNo], false);
    
    return $result['temperatureType'] ?? 'normal';
}

🪑 사례 3: 가구 쇼핑몰 - 부피/무게 기반 배송비

대형 가구를 판매하는 쇼핑몰에서는 상품의 부피와 무게에 따라 배송비를 차등 적용해야 해.

/**
 * 부피/무게 기반 배송비 계산
 */
public function calculateVolumeWeightBasedDelivery($cartData) {
    $deliveryGroups = [];
    
    foreach ($cartData as $item) {
        // 상품의 부피 무게 계산
        $volumeWeight = $this->calculateVolumeWeight($item);
        $actualWeight = $item['weight'] * $item['goodsCnt'];
        
        // 부피 무게와 실제 무게 중 큰 값 적용
        $chargeableWeight = max($volumeWeight, $actualWeight);
        
        // 무게 구간별 배송비 결정
        $deliveryFee = $this->getDeliveryFeeByWeight($chargeableWeight);
        
        // 설치 서비스 필요 여부 체크
        if ($item['needInstallation']) {
            $deliveryFee += $item['installationFee'];
        }
        
        $deliveryGroups[] = [
            'goodsNo' => $item['goodsNo'],
            'goodsNm' => $item['goodsNm'],
            'chargeableWeight' => $chargeableWeight,
            'deliveryFee' => $deliveryFee,
            'installationFee' => $item['needInstallation'] ? $item['installationFee'] : 0
        ];
    }
    
    return $deliveryGroups;
}

/**
 * 부피 무게 계산 (가로 x 세로 x 높이 / 5000)
 */
private function calculateVolumeWeight($item) {
    $volume = $item['width'] * $item['length'] * $item['height'];
    return $volume / 5000; // 택배사 기준
}

/**
 * 무게 구간별 배송비
 */
private function getDeliveryFeeByWeight($weight) {
    $weightRanges = [
        ['max' => 5, 'fee' => 5000],
        ['max' => 10, 'fee' => 8000],
        ['max' => 20, 'fee' => 12000],
        ['max' => 30, 'fee' => 18000],
        ['max' => PHP_INT_MAX, 'fee' => 25000]
    ];
    
    foreach ($weightRanges as $range) {
        if ($weight <= $range['max']) {
            return $range['fee'];
        }
    }
    
    return 25000; // 기본값
}

이런 식으로 업종과 상품 특성에 맞게 배송비 로직을 커스터마이징할 수 있어! 실제로 재능넷에서도 이런 맞춤형 배송 로직 개발 의뢰가 정말 많이 들어와. 각 쇼핑몰마다 특수한 요구사항이 있기 마련이거든! 😊

📝 마무리하며

여기까지 고도몰에서 상품 묶음 배송 로직을 구현하는 방법에 대해 자세히 알아봤어! 처음에는 복잡해 보일 수 있지만, 단계별로 차근차근 구현하다 보면 생각보다 어렵지 않아. 🎉

핵심을 정리하자면:

배송비 로직은 한 번 제대로 구현해두면 쇼핑몰 운영이 정말 편해져. 고객들도 명확한 배송비 안내를 받으면 신뢰도가 높아지고, 결과적으로 구매 전환율도 올라가거든! 💪

혹시 구현하다가 막히는 부분이 있거나, 특수한 요구사항이 있다면 전문가의 도움을 받는 것도 좋은 방법이야. 재능넷 같은 플랫폼에서 쇼핑몰 개발 전문가를 찾아보는 것도 추천해!

자, 이제 당신의 쇼핑몰에 완벽한 묶음 배송 시스템을 구축해보자! 화이팅! 🚀✨