5.7 购物车 + 订单模块

本节目标:实现电商的核心交易流程

演示的 Claude Code 功能:Task 任务列表、复杂业务逻辑处理

5.7.1 用 Task 管理复杂模块

购物车和订单模块涉及多个子任务。告诉 AI:

请创建任务列表,跟踪购物车和订单模块的开发进度。

AI 会帮你拆分成:

□ 购物车 API(GET、POST、PUT、DELETE)
□ 购物车页面(展示、修改数量、删除、提交订单)
□ 订单 API(GET 列表、GET 详情、POST 下单)
□ 订单页面(列表页、详情页)
□ 订单状态机(PENDING → PAID → SHIPPED → COMPLETED)

每完成一项,AI 会自动标记为完成,你随时知道进度。

图片[1]-5.7 购物车 + 订单模块-大赛人网

5.7.2 实现购物车

在 Claude Code 中输入:

请实现购物车功能:

API:
- GET /api/cart — 获取当前用户的购物车(需登录)
- POST /api/cart — 加入购物车(productId + quantity)
  - 如果购物车已有该商品,增加数量
  - 检查库存,库存不足返回错误
- PUT /api/cart/[id] — 修改数量
- DELETE /api/cart/[id] — 删除某项

前端页面 /cart:
- 列表展示购物车商品(图片、名称、单价、数量、小计)
- 每项可以 + / - 调整数量,或删除
- 底部显示总价,"提交订单"按钮
- 未登录时跳转到登录页

5.7.3 实现订单和”模拟支付”

请实现订单功能:

API:
- POST /api/orders — 从购物车创建订单
  - 在数据库事务中:创建订单 → 扣减库存 → 清空购物车
  - 如果库存不足,返回具体哪个商品缺货
- GET /api/orders — 我的订单列表
- GET /api/orders/[id] — 订单详情
- PUT /api/orders/[id] — 模拟支付(PENDING → PAID)

前端页面:
- /orders — 订单列表(订单号、金额、状态标签、时间)
- /orders/[id] — 订单详情(商品明细、合计、状态、模拟支付按钮)

订单状态流转:
PENDING(待付款)→ PAID(已支付)→ SHIPPED(已发货)→ COMPLETED(已完成)
                                               CANCELLED(已取消)← 可从任意状态取消

5.7.4 核心业务逻辑解析

为什么下单要用数据库事务?

下单涉及三个操作:创建订单 + 扣减库存 + 清空购物车。这三个操作必须要么全做,要么全不做。如果创建了订单但库存扣减失败了——用户付了钱但库存没减,后续会超卖。

Prisma 的事务写法:

const order = await prisma.$transaction(async (tx) => {
  // 1. 创建订单
  const newOrder = await tx.order.create({ data: { ... } });
  // 2. 扣减库存
  await tx.product.update({ where: { id }, data: { stock: { decrement: qty } } });
  // 3. 清空购物车
  await tx.cartItem.deleteMany({ where: { userId } });
  return newOrder;
});
// 如果任何一步失败,前面已执行的操作会自动回滚

为什么订单明细要存 productName 和 price?

历史订单不应该受后续商品修改影响。如果一个月后商品改名或涨价,你的历史订单不应该跟着变。所以下单时把商品名和价格”快照”到 OrderItem 表里。

5.7.5 你学到了什么

概念说明
数据库事务保证多个操作要么全成功要么全失败
库存扣减时机下单时扣减,防止超卖
数据快照历史数据不应该受后续修改影响
Task 管理复杂模块拆成小任务,逐个跟踪
© 版权声明
THE END
喜欢就支持一下吧
点赞13 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容