Medusa 独立站后台实战:商品变体、分类与询盘

这次给 Myzosen 做独立站,我用了 Medusa 管商品和客户,前台按自己的需求做。商品管理这些基础功能已经有现成的模块,询盘再单独接进去,后台就不用从头写一遍了。

一款商品可以有多个规格

比如一件衣服有黑、白两色,每色有 S、M、L 三个尺码。顾客看到的是一款衣服,后台需要六个变体。Medusa 已经有商品、选项和变体的关系,颜色和尺码放进选项,具体组合对应变体,导入时就按这层关系整理。

这次有 400 多款商品,2000 多个尺码变体。表格里重复的款式和颜色,经常只是尺码不同,不能看着重复就删。一个款式也可以放进几个分类,仍然是同一件商品,没必要为了分类再复制一份,给以后改价格和库存添麻烦。

图片就更直接了。选了黑色,看到的也得是黑色,别翻着翻着突然冒出白色。照片里的搭配也要交代清楚,模特穿了内裤,不代表下单就包含内裤。AI 能帮忙整理、出图,具体卖什么、包含什么,还得按原来的商品资料来。

前台的数据先筛一遍

商品页要的是名称、图片、颜色尺码和零售价。供应商成本和后台管理字段,不需要一起送给顾客。我这里让请求先经过 Pages Functions,再去找 Medusa,只开放要用的接口,也只返回页面需要的字段。

账户也是一样。浏览器使用受保护的会话 Cookie,认证令牌和私有网关密钥放在服务端。这层接口还负责把后台数据整理成前台好用的样子,页面拿到后直接展示,不用每个页面都重新处理一遍。

本次独立站与 Medusa 后台的主要连接关系
本项目结构示意。前台与后端独立部署,Server 和 Worker 共享数据库与 Redis。

客户留了消息 邮件再通知我

询盘先保存到 Medusa,后台就有了一条可以跟进的记录。邮件通知单独处理,D1 记录待发送任务,再交给独立的 Cloudflare 邮件 Worker 投递。通知服务收下任务后,网页才显示提交成功,发邮件这件事继续在后台处理。

网络慢的时候,顾客可能再点一次提交,所以每次提交都有一个固定编号。重试仍用这个编号,内容没变就返回原记录;同一个编号换了内容,就拒绝。总不能顾客点了几下,后台就多出几条一样的询盘。

询盘从网页提交到后台保存和邮件通知的顺序
本项目询盘流程示意。先保存消息,再安排通知;网页回执、邮件投递和收件箱到达分别核验。

邮件没发出去,消息仍然在后台,之后可以继续跟进。如果发送超时,暂时不知道到底发没发出去,也不能直接再发一遍,先保留状态再查。这样需要多管一点发送状态,但客户的消息有地方可查,不用全靠一封邮件。

表单对外开放,还加了 Turnstile 服务端校验、请求限流和邮件发送预算。入口要方便顾客联系,也得防着有人拿它刷邮件额度。

部署以后还得自己维护

Medusa 后台分成 Server 和 Worker。Server 接 API 和管理界面,Worker 做事件和后台任务,两边用同一份代码、数据库和 Redis,这是官方建议的生产部署方式。这里的 Medusa Worker 和前面发邮件的 Cloudflare Worker 是两回事。

我用 systemd 管这两个进程,沿用服务器上的 Nginx,数据库、Redis 数据目录和端口给这个项目单独划出来。服务器还有其他网站,新后台放上去,原来的站点也得照常运行。

还有个容易漏的地方。Medusa 编译后的生产目录是 .medusa/server,要在里面装生产依赖,再从这里启动,部署文档也写了。我们就碰到过本地编译通过,服务器却因为缺少可写目录起不来的情况。依赖、目录和权限,要在实际运行的机器上一起确认。

更新程序时,数据库迁移单独跑一次,别让两个进程一起改库。备份也不能只靠 Git,客户和询盘在数据库里,图片放在 R2,这些得分别备份。恢复旧代码之前,先看看数据库已经改到哪一步,不能以为换回代码就全回去了。

总结

这次用下来,我觉得 Medusa 挺适合我这个独立站。商品和客户管理用现成的模块,前台又能照自己的想法做,省得这两部分都从头写一遍。

商品资料、询盘通知和服务器维护,还是得自己管。Myzosen 这次先把商品展示和询盘接好,支付后面再做。商品能在后台改,询盘有记录可跟进,对我来说,这套后台就已经派上用场了。

相关文章

评论

正在加载评论…

听歌