毕业项目：shop-demo 电商后台

第 12 章 · 毕业项目：shop-demo 电商后台 MVP

本章目标：在 ch01～ch11 基础上，独立交付 shop-demo Django 电商后台最小可行产品（MVP）；覆盖商品管理、订单列表、用户登录与 REST API；按 5 天计划实施；通过 100 分验收表自评；完成答辩演示与项目说明文档。

学时建议：5 天 × 6～8 小时（合计 30～40 小时）

前置：完成本模块 ch01～ch11；建议复习 python-dev ch06 OOP 与 ch11 requests；前端联调可参考 frontend-framework ch13 API 章节。

12.1 项目背景与边界

shop-demo 是一家虚构在线书店/杂货铺，面向运营人员提供后台管理能力。C 端商城由独立 SPA 调用 https://api.example.com（或你本地部署的等价 API）——本毕业项目聚焦 Django 后端 + 简易管理界面 + DRF API。

┌──────────────────────────────────────────────────┐
│              shop-demo 后台 MVP（本章）            │
├──────────┬──────────┬──────────┬─────────────────┤
│ 用户登录  │ 商品管理  │ 订单列表  │  REST API      │
│ Session  │ CRUD+封面 │ 分页筛选  │  /api/v1/...   │
└──────────┴──────────┴──────────┴─────────────────┘
                        │
                        ▼
              PostgreSQL / SQLite（教学可用）
              Redis（缓存，ch10）+ Celery（选修）

严禁将真实公司内部域名、数据库连接串、密钥写入仓库或答辩材料。统一使用 shop-demo、user-demo、api.example.com。

12.2 技术栈清单

# 推荐项目初始化（若尚未创建）
cd ~/python-learn
django-admin startproject shopdemo shop-demo
cd shop-demo
python -m venv .venv && source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install "Django>=4.2,<5" djangorestframework Pillow django-redis celery redis \
            pytest pytest-django python-dotenv gunicorn psycopg2-binary

12.3 推荐目录结构

shop-demo/
├── .env.example
├── .github/workflows/test.yml
├── docker-compose.dev.yml      # Redis
├── gunicorn.conf.py
├── manage.py
├── pytest.ini
├── requirements.txt
├── docs/
│   ├── API.md
│   └── SELF_REVIEW.md          # 100 分自评表
├── shopdemo/
│   ├── settings.py
│   ├── settings_prod.py
│   ├── urls.py
│   ├── wsgi.py
│   └── celery.py
├── core/
│   ├── middleware.py
│   ├── models.py               # AuditMixin
│   └── threadlocal.py
├── accounts/                   # 登录视图
├── catalog/                    # 商品
│   ├── models.py
│   ├── serializers.py
│   ├── views.py
│   ├── web_views.py
│   └── tests/
├── orders/                     # 订单
│   ├── models.py
│   ├── serializers.py
│   └── views.py
├── notifications/tasks.py
├── templates/
│   ├── base.html
│   ├── registration/login.html
│   └── catalog/
├── assets/static/...
└── media/                      # .gitignore

12.4 数据模型规格

12.4.1 商品 Product

12.4.2 订单 Order

12.4.3 订单项 OrderLine（沿用 ch05 命名）

种子数据：python manage.py loaddata demo_products.json demo_orders.json（自备 fixture，≥10 商品、≥20 订单）。

12.5 功能规格

12.5.1 用户登录

12.5.2 商品管理（Web）

12.5.3 订单列表（Web）

12.5.4 REST API

基址：/api/v1/（与 api.example.com/v1 文档对齐为选修）

为何这里是 /api/v1/ 而前文章节是 /api/？ ch07～ch15 为教学简洁省略版本段；毕业项目引入 URL 版本化（v1），是企业 API 演进的标准做法。实现时在 shopdemo/urls.py 用 path("api/v1/", include("catalog.api.urls")) 挂载即可，ViewSet 代码不变。

响应格式遵循 ch07 分页结构；错误含 request_id（ch09）。