e-commerce

用途：围绕电商应用的购物车、支付处理、库存管理与订单履约提供实现模式。主要内容：1) 购物车：定义 CartItem/Cart 结构，用 Zustand 加 persist 实现加购、改数量、删除、清空与应用折扣码，并由 recalculateCart 计算小计、税费、运费与总额。2) 支付：Stripe 集成，包含 createCheckoutSession 与 createPaymentIntent，webhook 处理 checkout.session.completed、payment_intent.succeeded/payment_failed；React 端使用 Stripe Elements 的 PaymentElement 与 confirmPayment。3) 库存：基于 Prisma 事务与版本号乐观锁做库存预占，支持取消订单时回补库存及低库存告警。4) 订单：定义 OrderStatus 枚举与订单结构，从 checkout session 生成订单并触发确认邮件与履约通知，支持状态更新。5) 商品目录：提供带关键词、分类、价格区间、排序与分页的商品搜索。适用场景：需要搭建含购物车、在线支付、库存与订单流程的电商系统。限制：示例默认 10% 税费与满 100 免运费、货币为美元、仅允许 US/CA/GB 收货，均需按业务调整；收费、价格与平台支持情况暂未提供。