Django-SHOP项目中的费用处理机制详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00223/article/details/148578986

Django-SHOP项目中的费用处理机制详解

django-shop A Django based shop system 项目地址: https://gitcode.com/gh_mirrors/dj/django-shop

费用处理的基本原理

在电子商务系统中，费用处理是一个关键且复杂的环节。Django-SHOP作为一个灵活的电商框架，采用了高度可定制的费用处理方案。核心原则是：商品单价始终以净价存储，而费用计算则通过可插拔的模块实现。

这种设计理念源于不同地区、不同产品可能适用不同的费用模型。例如：

美国模式：价格显示为净价，费用在结算时额外计算
欧洲模式：价格显示为含费价，但需要单独列出费用明细

费用计算器的实现方式

Django-SHOP通过"购物车修饰器"(Cart Modifier)机制实现费用计算。这种设计允许开发者根据业务需求灵活定制费用逻辑。

美国费用模型实现

典型的美国模式实现示例：

from shop.serializers.cart import ExtraCartRow
from shop.modifiers.base import BaseCartModifier

VALUE_ADDED_FEE = 9.0

class CartIncludeFeeModifier(BaseCartModifier):
    fees = VALUE_ADDED_FEE / 100

    def add_extra_cart_row(self, cart, request):
        amount = cart.subtotal * self.fees
        instance = {
            'label': "plus {}% additional fee".format(VALUE_ADDED_FEE),
            'amount': amount,
        }
        cart.extra_rows[self.identifier] = ExtraCartRow(instance)
        cart.total += amount

关键点：

基于购物车小计计算费用
将费用作为额外行项添加到购物车
调整购物车总金额

欧洲费用模型实现

欧洲模式需要从含费价中反向计算费用：

from shop.serializers.cart import ExtraCartRow
from shop.modifiers.base import BaseCartModifier

VALUE_ADDED_FEE = 19.0

class CartExcludedFeeModifier(BaseCartModifier):
    fees = 1 - 1 / (1 + VALUE_ADDED_FEE / 100)

    def add_extra_cart_row(self, cart, request):
        amount = cart.subtotal * self.fees
        instance = {
            'label': "{}% fee incl.".format(VALUE_ADDED_FEE),
            'amount': amount,
        }
        cart.extra_rows[self.identifier] = ExtraCartRow(instance)

区别在于：

使用不同的计算公式从含费价中提取费用
不修改购物车总金额（因为价格已含费）

混合费用模型处理

实际业务中常需要处理混合场景，例如：

B2C业务使用欧洲模式
B2B业务使用美国模式

解决方案是通过请求中的用户信息判断适用哪种模式：

def add_extra_cart_row(self, cart, request):
    if request.customer.is_business:
        # 应用美国模式
    else:
        # 应用欧洲模式

商品差异化费率处理

某些电商平台需要处理不同费率的商品组合。Django-SHOP提供了灵活的解决方案：

在商品模型中添加费率字段
实现能够处理多种费率的修饰器

示例实现：

class FeeModifier(BaseCartModifier):
    def __init__(self):
        super().__init__()
        self.fee_rates = Product.objects.order_by('fee')
                          .values('fee').annotate(count=Count('fee'))

    def pre_process_cart(self, cart, request):
        # 为每种费率初始化累加器
        for rate in self.fee_rates:
            fee_attr = '_{}_fee_{fee}'.format(self.identifier, **rate)
            setattr(cart, fee_attr, Money(0))

    # 其他方法实现...

这种实现的关键在于：