温馨提示本人主页置顶文章(点我)开头有 CSDN 平台官方提供的学长联系方式的名片技术栈前端HTML/CSS/JavaScript、Bootstrap框架、jQuery交互增强后端Django框架Python、Django REST frameworkAPI开发数据库MySQL/PostgreSQL关系型数据存储、Redis缓存与会话管理部署Nginx反向代理、GunicornWSGI服务器、Docker容器化其他Celery异步任务如订单处理、支付宝/微信支付SDK支付集成背景与意义背景传统茶叶交易依赖线下渠道存在信息不对称、交易效率低等问题。线上平台可整合供应链提升买卖双方匹配效率。意义为茶农提供直接面向消费者的销售渠道减少中间环节。通过用户评价和溯源系统增强产品可信度。结合Django高开发效率与安全性适合快速迭代的电商场景。核心代码示例用户认证模块Django内置from django.contrib.auth.models import AbstractUser from django.db import models class CustomUser(AbstractUser): phone models.CharField(max_length15, uniqueTrue) is_seller models.BooleanField(defaultFalse) # 区分买家与卖家商品模型与API# models.py class TeaProduct(models.Model): seller models.ForeignKey(CustomUser, on_deletemodels.CASCADE) name models.CharField(max_length100) price models.DecimalField(max_digits10, decimal_places2) origin models.CharField(max_length50) # 产地溯源 stock models.PositiveIntegerField(default0) # serializers.py (DRF) class TeaProductSerializer(serializers.ModelSerializer): class Meta: model TeaProduct fields __all__订单处理逻辑# views.py api_view([POST]) permission_classes([IsAuthenticated]) def create_order(request): cart_items request.data.get(items) total sum(item[price] * item[quantity] for item in cart_items) order Order.objects.create(userrequest.user, total_amounttotal) for item in cart_items: OrderItem.objects.create( orderorder, product_iditem[product_id], quantityitem[quantity] ) return Response({order_id: order.id}, status201)支付回调处理csrf_exempt def alipay_callback(request): data request.POST.dict() if verify_signature(data): # 验证支付宝签名 order Order.objects.get(iddata[out_trade_no]) order.status paid order.save() return HttpResponse(success) return HttpResponse(fail, status400)关键技术与优化性能优化使用Django缓存框架Redis缓存热门商品数据。安全措施CSRF防护、XSS过滤Django模板自动转义、支付接口签名验证。扩展性通过Celery异步处理订单通知和库存同步任务。通过以上技术栈和模块化设计系统可实现高并发交易与易维护性。一、项目背景与意义“山岚间”茶叶交易网站是一个基于Django框架开发的B2C/B2B电子商务平台旨在为茶叶生产者、经销商和消费者提供一个高效、透明、可信赖的在线交易环境。项目背景源于中国茶产业数字化转型的迫切需求。传统茶叶交易存在信息不对称、流通环节多、品质追溯难、地域限制强等问题导致优质茶叶难以触达广大消费者而消费者也难辨真伪、难寻源头。本项目的设计与开发具有以下重要意义推动产业升级通过数字化平台缩短供应链降低交易成本提升茶叶流通效率助力茶农增收和产业现代化。保障品质与溯源建立从茶园到茶杯的数字化溯源体系增强消费者信任打击假冒伪劣保护地理标志产品。优化用户体验为消费者提供丰富的茶叶知识、透明的价格信息、便捷的购买渠道和个性化的推荐服务。技术实践价值作为全栈Web开发项目它完整涵盖了需求分析、系统设计、前后端开发、数据库设计、部署运维等环节是学习与实践Django及现代Web技术的优秀案例。二、技术栈选型“山岚间”项目采用经典且稳健的Python Web技术栈确保开发效率、可维护性与系统性能。1. 后端技术栈核心框架Django 4.x。选择Django因其“开箱即用”的特性内置强大的ORM、Admin后台、用户认证、表单处理和安全中间件能快速构建稳健的后台。数据库PostgreSQL。关系型数据库性能稳定支持JSON字段适合存储结构化的商品、订单、用户信息。缓存Redis。用于会话存储、页面片段缓存和热门商品数据缓存提升系统响应速度。任务队列Celery Redis作为Broker。用于异步处理耗时任务如发送订单确认邮件、生成报表、图片处理等。API开发Django REST framework (DRF)。为未来可能的小程序或移动端App提供清晰、规范的RESTful API接口。文件存储本地存储开发环境与云存储如阿里云OSS生产环境。用于存储商品图片、用户头像等静态资源。2. 前端技术栈模板引擎Django Template Language (DTL)。服务端渲染利于SEO快速构建页面。前端样式与交互Bootstrap 5 原生JavaScript/jQuery。Bootstrap提供响应式布局和基础组件jQuery处理简单的DOM操作和Ajax请求。前端构建可选Webpack。用于管理更复杂的前端资源如SCSS、ES6模块。3. 开发与部署版本控制Git。依赖管理pip requirements.txt。本地开发Django内置开发服务器配合python-dotenv管理环境变量。生产部署Linux (Ubuntu/CentOS) Nginx Gunicorn。Nginx处理静态文件和反向代理Gunicorn作为WSGI服务器运行Django应用。容器化可选Docker Docker Compose。实现环境一致性简化部署流程。三、核心功能模块与代码示例以下展示几个核心模块的设计思路与关键代码片段。1. 数据模型设计 (models.py)核心实体包括用户、商品、订单、购物车等。from django.db import models from django.contrib.auth.models import AbstractUser class User(AbstractUser): 扩展Django默认用户模型 phone models.CharField(max_length11, blankTrue, verbose_name手机号) avatar models.ImageField(upload_toavatars/, blankTrue, verbose_name头像) is_seller models.BooleanField(defaultFalse, verbose_name是否是卖家) class Meta: db_table user verbose_name 用户 verbose_name_plural verbose_name class Category(models.Model): 商品分类 name models.CharField(max_length50, verbose_name分类名称) parent models.ForeignKey(self, on_deletemodels.CASCADE, nullTrue, blankTrue, verbose_name父分类) def __str__(self): return self.name class Product(models.Model): 商品 STATUS_CHOICES ( (draft, 草稿), (published, 已上架), (out_of_stock, 缺货), (archived, 已归档), ) name models.CharField(max_length200, verbose_name商品名称) category models.ForeignKey(Category, on_deletemodels.PROTECT, verbose_name分类) seller models.ForeignKey(User, on_deletemodels.CASCADE, limit_choices_to{is_seller: True}, verbose_name卖家) price models.DecimalField(max_digits10, decimal_places2, verbose_name价格) stock models.PositiveIntegerField(default0, verbose_name库存) description models.TextField(verbose_name商品描述) main_image models.ImageField(upload_toproducts/, verbose_name主图) status models.CharField(max_length20, choicesSTATUS_CHOICES, defaultdraft) created_at models.DateTimeField(auto_now_addTrue) updated_at models.DateTimeField(auto_nowTrue) class Meta: ordering [-created_at] class Order(models.Model): 订单 ORDER_STATUS ( (pending, 待支付), (paid, 已支付), (shipped, 已发货), (completed, 已完成), (cancelled, 已取消), ) user models.ForeignKey(User, on_deletemodels.CASCADE, verbose_name用户) order_number models.CharField(max_length50, uniqueTrue, verbose_name订单号) total_amount models.DecimalField(max_digits12, decimal_places2, verbose_name总金额) status models.CharField(max_length20, choicesORDER_STATUS, defaultpending) shipping_address models.TextField(verbose_name收货地址) created_at models.DateTimeField(auto_now_addTrue) def __str__(self): return self.order_number/code/pre 2. 视图与业务逻辑 (views.py) 以商品列表和详情页为例。 from django.shortcuts import render, get_object_or_404 from django.views.generic import ListView, DetailView from django.db.models import Q from .models import Product, Category class ProductListView(ListView): 商品列表页支持分类筛选和搜索 model Product template_name product/list.html paginate_by 20 context_object_name products def get_queryset(self): queryset Product.objects.filter(statuspublished).select_related(category, seller) category_id self.request.GET.get(category) search_keyword self.request.GET.get(q) if category_id: queryset queryset.filter(category_idcategory_id) if search_keyword: queryset queryset.filter( Q(name__icontainssearch_keyword) | Q(description__icontainssearch_keyword) ) return queryset def get_context_data(self, **kwargs): context super().get_context_data(**kwargs) context[categories] Category.objects.all() return context class ProductDetailView(DetailView): 商品详情页 model Product template_name product/detail.html context_object_name product def get_queryset(self): return Product.objects.filter(statuspublished).select_related(seller) def get_context_data(self, **kwargs): context super().get_context_data(**kwargs) # 获取相关商品同分类 context[related_products] Product.objects.filter( categoryself.object.category, statuspublished ).exclude(pkself.object.pk)[:4] return context/code/pre 3. 购物车与订单创建 使用Session管理购物车下单时创建订单和订单项。 import json from django.http import JsonResponse from django.views.decorators.http import require_POST from django.contrib.auth.decorators import login_required from .models import Product, Order, OrderItem def add_to_cart(request): 添加商品到购物车Session if request.method POST: try: product_id int(request.POST.get(product_id)) quantity int(request.POST.get(quantity, 1)) product Product.objects.get(idproduct_id, statuspublished, stock__gtequantity) cart request.session.get(cart, {}) cart_item cart.get(str(product_id), {quantity: 0}) cart_item[quantity] quantity cart_item[price] float(product.price) # 记录加入时的价格 cart[str(product_id)] cart_item request.session[cart] cart request.session.modified True return JsonResponse({success: True, message: 已加入购物车, cart_total_items: sum(item[quantity] for item in cart.values())}) except (Product.DoesNotExist, ValueError): return JsonResponse({success: False, message: 商品不存在或库存不足}, status400) return JsonResponse({success: False, message: 无效请求}, status400) login_required require_POST def create_order(request): 从购物车创建订单 cart request.session.get(cart, {}) if not cart: return JsonResponse({success: False, message: 购物车为空}, status400) try: # 1. 生成唯一订单号 import time order_number fORD{int(time.time())}{request.user.id:06d} # 2. 计算总金额并验证库存 total_amount 0 order_items [] product_ids [int(pid) for pid in cart.keys()] products {p.id: p for p in Product.objects.filter(id__inproduct_ids, statuspublished)} for product_id_str, item in cart.items(): product_id int(product_id_str) product products.get(product_id) if not product or product.stock lt; item[quantity]: raise ValueError(f商品 {product_id} 库存不足或已下架) total_amount product.price * item[quantity] order_items.append({ product: product, quantity: item[quantity], price: product.price }) 3. 创建订单使用事务确保一致性 from django.db import transaction with transaction.atomic(): order Order.objects.create( userrequest.user, order_numberorder_number, total_amounttotal_amount, shipping_addressrequest.POST.get(shipping_address, ) ) for item in order_items: OrderItem.objects.create( orderorder, productitem[product], quantityitem[quantity], priceitem[price] ) # 扣减库存 item[product].stock - item[quantity] item[product].save() 4. 清空购物车 del request.session[cart] return JsonResponse({success: True, order_number: order_number, message: 订单创建成功}) except Exception as e: return JsonResponse({success: False, message: f创建订单失败: {str(e)}}, status500)/code/pre 四、总结 “山岚间”茶叶交易网站项目展示了如何运用Django全栈技术构建一个功能完备的电子商务平台。从背景意义、技术栈选型到核心代码实现项目涵盖了用户系统、商品管理、购物车、订单处理等电商核心模块。通过此项目开发者可以深入理解Django的MTV模式、ORM操作、表单验证、会话管理、异步任务以及生产环境部署等关键技能为开发更复杂的Web应用打下坚实基础。 未来可扩展的方向包括集成第三方支付支付宝、微信支付、引入Elasticsearch实现商品搜索、使用Celery Beat实现定时任务如库存预警、开发卖家管理中心、以及构建基于DRF的移动端API等。