Django-Shop 教程：智能卡产品模型详解-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00732/article/details/148578998

Django-Shop 教程：智能卡产品模型详解

前言

在电子商务系统开发中，产品模型的设计是核心环节之一。本文将深入讲解如何在 Django-Shop 框架中实现智能卡(Smart Card)产品模型，包括基础模型构建、国际化支持以及后台管理配置。

产品模型基础设计

Django-Shop 采用灵活的产品模型设计理念，不预设产品属性，而是由开发者根据实际业务需求定义。这种设计使得框架能够适应各种不同类型的产品。

智能卡模型示例

from django.db import models
from shop.models.product import BaseProduct, BaseProductManager, CMSPageReferenceMixin
from shop.money.fields import MoneyField

class SmartCard(CMSPageReferenceMixin, BaseProduct):
    product_name = models.CharField(max_length=255, verbose_name="产品名称")
    slug = models.SlugField(verbose_name="URL标识")
    caption = models.TextField("简短描述", help_text="用于产品列表视图的简短描述")
    description = models.TextField("详细描述", help_text="用于产品详情页的长描述")
    order = models.PositiveIntegerField("排序", db_index=True)
    unit_price = MoneyField("单价", decimal_places=3, help_text="产品净价")
    card_type = models.CharField("卡类型", choices=[(t, t) for t in ('SD', 'SDXC', 'SDHC', 'SDHC II')], max_length=9)
    product_code = models.CharField("产品编码", max_length=255, unique=True)
    storage = models.PositiveIntegerField("存储容量(GB)", help_text="以GB为单位的存储容量")

    class Meta:
        verbose_name = "智能卡"
        verbose_name_plural = "智能卡"
        ordering = ['order']

    lookup_fields = ['product_code__startswith', 'product_name__icontains']
    objects = BaseProductManager()

    def get_price(self, request):
        return self.unit_price

    def __str__(self):
        return self.product_name

    @property
    def sample_image(self):
        return self.images.first()

关键设计要点

继承结构：
- BaseProduct：所有产品模型的基类
- CMSPageReferenceMixin：提供CMS页面关联功能
核心字段：
- 产品特有属性：卡类型、存储容量等
- 电商通用字段：价格、产品编码等
- CMS相关字段：slug、排序等
价格处理：
- 使用get_price()方法而非固定字段，便于实现动态定价
- MoneyField专门处理货币金额
搜索优化：
- lookup_fields定义搜索字段
- 支持产品编码前缀和产品名称模糊搜索

国际化支持

对于多语言电商平台，产品模型的国际化至关重要。Django-Shop 结合 django-parler 实现多语言支持。

国际化模型实现

from parler.managers import TranslatableManager, TranslatableQuerySet
from polymorphic.query import PolymorphicQuerySet

class ProductQuerySet(TranslatableQuerySet, PolymorphicQuerySet):
    pass

class ProductManager(BaseProductManager, TranslatableManager):
    queryset_class = ProductQuerySet
    def get_queryset(self):
        qs = self.queryset_class(self.model, using=self._db)
        return qs.prefetch_related('translations')

class SmartCard(CMSPageReferenceMixin, TranslatableModelMixin, BaseProduct):
    caption = TranslatedField()
    description = TranslatedField()

class SmartCardTranslation(TranslatedFieldsModel):
    master = models.ForeignKey(SmartCard, related_name='translations', null=True)
    caption = models.TextField("简短描述", help_text="用于产品列表视图的简短描述")
    description = models.TextField("详细描述", help_text="用于产品详情页的长描述")
    
    class Meta:
        unique_together = [('language_code', 'master')]

国际化设计要点

翻译字段选择：
- 通常翻译产品描述等文本内容
- 产品编码等唯一标识不需翻译
性能优化：
- 使用prefetch_related预加载翻译
- 确保查询效率
灵活性：
- 可根据需要选择翻译字段
- 保留非翻译字段的原始值

后台管理配置

完善的后台管理是电商系统的重要组成部分。Django-Shop 提供了丰富的Admin扩展功能。

基础Admin配置

from django.contrib import admin
from adminsortable2.admin import SortableAdminMixin
from shop.admin.product import CMSPageAsCategoryMixin, ProductImageInline, InvalidateProductCacheMixin

@admin.register(SmartCard)
class SmartCardAdmin(InvalidateProductCacheMixin, SortableAdminMixin, CMSPageAsCategoryMixin, admin.ModelAdmin):
    fields = ['product_name', 'slug', 'product_code', 'unit_price', 'active', 'caption', 'description', 'storage', 'card_type']
    inlines = [ProductImageInline]
    prepopulated_fields = {'slug': ['product_name']}
    list_display = ['product_name', 'product_code', 'unit_price', 'active']

国际化Admin配置

from parler.admin import TranslatableAdmin

class SmartCardAdmin(InvalidateProductCacheMixin, SortableAdminMixin, TranslatableAdmin, CMSPageAsCategoryMixin, admin.ModelAdmin):
    # 配置同上，增加翻译支持
    pass