自定义模块与扩展开发指南

商品综合评价打分系统

支持多维星级评分与图文反馈，自动维护商品的聚合评分指标。

const res = await fetch("/api/store/reviews", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    product_id: "prod_123",
    rating: 5,
    title: "质量极佳",
    comment: "面料非常舒适，车工走线十分工整。",
  }),
});

商品在线问答模块 (Q&A)

允许意向顾客在商品详情页发起售前咨询提问，并由商城运营团队集中回复解答并公开展示。

买家心愿单收藏夹

赋能买家随心加购心仪好物，并自动绑定持久化至 Medusa Customer 账户主体中。

外部 ERP 与第三方仓储库存同步模块

定时或基于事件自动与外部 ERP 财务软件、聚水潭或线下实体总仓进行库存实时对账同步。

事件订阅分发体系 (Event Subscribers)

监听 Medusa 核心抛出的商业事件（下单成功、支付入账、退款取消），自动触发下游异步编排任务。

• order.placed 事件：自动生成 PDF 电子发票邮件发送给客户，并同步推送出货单至仓库作业系统。
• customer.created 事件：自动发送新客欢迎邮件并为其绑定首单专属优惠券。
• order.fulfillment_created 事件：自动通过短信将物流运单号及跟踪链接发送给买家。
• product.updated 事件：即刻触发 Next.js 重新生成该商品的详情页静态缓存。

中间件与严格访问控制 (Middleware)

保护核心商业 API 端点免遭非法嗅探，完善用户 Token 鉴权、会话保护与管理员角色权限隔离。