实战项目九：构建电商平台（一）：商品管理-Django框架入门指南

当前位置:　首页>> 技术小册>> Django框架入门指南

### 实战项目九：构建电商平台（一）：商品管理

#### 引言

在Django框架的广阔应用领域中，构建电商平台无疑是一个既具挑战性又极具实用价值的项目。电商平台不仅要求系统能够高效地处理大量商品数据，还需要提供用户友好的界面来展示这些商品，并支持复杂的交易流程。本章节将带领读者从零开始，通过实战的方式逐步构建电商平台的商品管理模块。这将是电商平台系列项目中的第一部分，为后续章节（如用户管理、订单处理、支付集成等）奠定坚实基础。

#### 1. 项目规划

在正式编码之前，我们需要对商品管理模块进行详细的规划。商品管理模块通常包含以下几个核心功能：

- **商品信息的添加、编辑与删除**：管理员能够轻松地上传新商品信息，包括名称、描述、价格、库存、图片等，并能对已有商品信息进行修改或删除。
- **商品分类管理**：支持多级分类体系，便于用户快速定位所需商品。
- **商品搜索与筛选**：提供灵活的搜索功能，允许用户按名称、价格、分类等条件筛选商品。
- **商品状态管理**：如上架、下架、库存预警等状态控制。
- **商品数据统计与分析**：为运营人员提供销售数据、库存状况等关键指标的统计报表。

#### 2. 数据库设计

基于上述功能需求，我们需要设计合理的数据库模型。在Django中，这通常通过定义`models.py`中的模型类来实现。

**模型定义示例**：

```python
from django.db import models

class Category(models.Model):
    name = models.CharField(max_length=100, verbose_name="分类名称")
    parent = models.ForeignKey('self', on_delete=models.CASCADE, null=True, blank=True, related_name='subcategories', verbose_name="父分类")

def __str__(self):
        return self.name

class Meta:
        verbose_name = "商品分类"
        verbose_name_plural = "商品分类"

class Product(models.Model):
    name = models.CharField(max_length=200, verbose_name="商品名称")
    description = models.TextField(verbose_name="商品描述")
    price = models.DecimalField(max_digits=10, decimal_places=2, verbose_name="商品价格")
    stock = models.IntegerField(default=0, verbose_name="库存数量")
    category = models.ForeignKey(Category, on_delete=models.CASCADE, verbose_name="分类")
    is_active = models.BooleanField(default=True, verbose_name="是否上架")

def __str__(self):
        return self.name

class Meta:
        verbose_name = "商品"
        verbose_name_plural = "商品"
```

这里，我们定义了两个主要的模型：`Category`用于表示商品分类，支持自关联以形成多级分类；`Product`则代表商品本身，包含了名称、描述、价格、库存、分类以及是否上架等关键信息。

#### 3. 后台管理界面

Django自带了一个强大的后台管理系统（Django Admin），可以极大地简化CRUD（创建、读取、更新、删除）操作的实现。我们将利用Django Admin来管理商品和分类。

**注册模型到Admin**：

在`admin.py`文件中，将`Category`和`Product`模型注册到Admin站点。

```python
from django.contrib import admin
from .models import Category, Product

admin.site.register(Category)
admin.site.register(Product)
```

此时，运行Django项目并访问`/admin/`路径，即可看到商品和分类的管理界面。你可以通过这个界面来添加、编辑或删除商品及分类信息。

#### 4. 前端页面设计

虽然Django Admin提供了强大的后台管理功能，但电商平台通常需要更专业的前端界面来展示商品信息。我们可以使用Django的模板系统来构建前端页面。

**商品列表页面（products_list.html）**：

```html
{% extends "base.html" %}
{% block content %}
<h1>商品列表</h1>
<ul>
    {% for product in product_list %}
    <li>
        <a href="{% url 'product_detail' product.id %}">{{ product.name }}</a>
        - ${{ product.price }}
        - 库存: {{ product.stock }}
        {% if product.is_active %}
        <span class="label label-success">上架</span>
        {% else %}
        <span class="label label-danger">下架</span>
        {% endif %}
    </li>
    {% empty %}
    <li>暂无商品。</li>
    {% endfor %}
</ul>
{% endblock %}
```

在视图中，我们需要传递一个包含商品信息的`product_list`到模板中。

**视图函数示例（views.py）**：

```python
from django.shortcuts import render
from .models import Product

def product_list(request):
    product_list = Product.objects.all()
    return render(request, 'products/products_list.html', {'product_list': product_list})
```

#### 5. 路由配置

在Django中，路由是通过URLconf（URL configuration）来配置的。我们需要为商品列表页面配置一个URL。

**urls.py配置**：

```python
from django.urls import path
from . import views

urlpatterns = [
    path('', views.product_list, name='product_list'),
    # 其他URL配置...
]
```

确保这个`urls.py`文件被包含在你的项目的主`urls.py`文件中，以便Django能够识别并处理这些URL。

#### 6. 搜索与筛选功能

为了实现搜索与筛选功能，你可能需要在视图中添加额外的逻辑来处理查询参数，并使用这些参数来过滤商品列表。这通常涉及到对Django的QuerySet进行复杂的查询操作。

**示例代码片段**：

```python
from django.shortcuts import render
from .models import Product

def product_list_filtered(request):
    query = request.GET.get('q')
    category_id = request.GET.get('category')

products = Product.objects.all()
    if query:
        products = products.filter(name__icontains=query)
    if category_id:
        products = products.filter(category_id=category_id)

return render(request, 'products/products_list.html', {'product_list': products})
```

然后，在`urls.py`中添加对应的URL路径。

#### 7. 总结与扩展

至此，我们已经完成了电商平台商品管理模块的基础构建，包括数据库设计、后台管理界面、前端页面展示以及基本的搜索与筛选功能。然而，一个完整的电商平台还需要更多的功能，如用户评论、购物车、订单管理、支付集成等。这些将在后续章节中逐一介绍。

在继续开发之前，不妨回顾一下当前模块的实现，思考是否有可以优化或改进的地方。同时，也要注意代码的可维护性和可扩展性，为未来的功能扩展做好准备。

通过本章节的学习，希望读者能够掌握使用Django构建电商平台商品管理模块的基本流程和方法，为后续的深入学习和实践打下坚实的基础。

该分类下的相关小册推荐：

Django快速开发实战

Django零基础入门