Wabifair 独立站首页真实截图:多币种切换、热门商品陈列

At a glance

案例速览

要解决的问题
海外独立站要同时接三家支付渠道、五种语言与多币种;支付回调会重复到达,金额计算不能有一分钱误差,支付成功后的履约与通知要跨服务最终一致。
约束条件
团队协作的 9 服务架构,业务写与事件写要落在同一事务;各服务只能用最小权限账号访问自己的 schema;前端禁止直连内部服务。
我的职责边界
参与支付、订单与国际化相关开发与联调;负责部分 React 19 页面与 ECharts 看板;协助可观测性接入。架构由团队设计。
结果
重复回调不会导致重复发货 / 重复到账;对账与退款不出现浮点误差;前台支持五语切换与各国手机号校验。

Overview

项目说明

Wabifair 是 RippleClio × Wabifair 双轮生态里的「物质家园」线——以「Truth · Aesthetics · Future」为价值锚,做文化美学驱动的跨境电商独立站。平台核心机制是金票投票与共创分账:用户购买即投票,每笔销售按共创契约分账给摄影 / 编剧 / 音乐 / 剪辑等参与方;商品与 RippleClio 上的内容共享同一套标签语言。

平台架构(团队)

9 个 Go 微服务围绕 catalog → order → payment → fulfillment 的写链路 + Outbox 异步投递组织;单 PostgreSQL 多 schema,每个服务一个最小权限账号;Stripe / PayPal / Alipay 三栈支付统一适配;可观测性走 OpenTelemetry → Jaeger、Prometheus + Grafana、Zap 结构化日志。

我的职责

  • 参与统一支付模块:三方渠道接入、Webhook provider:event_id 幂等、decimal 金额计算;
  • 参与订单服务与 Outbox 事件:同事务落库、轮询投递 + 重试 + 幂等消费,订单超时取消与对账;
  • 参与海外独立站国际化:五语切换、各国手机号校验、多币种展示;
  • 参与 catalog / cart 等服务的接口开发与联调;
  • 负责部分 React 19 + Vite 前端页面与 ECharts 看板,协助接入链路追踪与指标。

姊妹平台:RippleClio · 视频社交与 AI 创作平台。

Stack

技术栈与工具

  • Go 微服务 + API Gateway
  • PostgreSQL 单库多 schema
  • Transactional Outbox
  • shopspring/decimal
  • Stripe / PayPal / Alipay
  • React 19 + Vite + TypeScript
  • i18next
  • libphonenumber-js
  • ECharts
  • MSW
  • OpenTelemetry + Jaeger
  • Prometheus + Grafana

Build

实现过程

按实现顺序拆开关键模块:每一步解决什么问题、为什么这样做。

  1. 平台背景(团队):写链路极短,慢任务全部异步

    9 个 Go 服务(catalog / order / payment-adapter / supplier / costing / cart / admin / commerce-worker / fulfillment)围绕 catalog → order → payment → fulfillment 的写链路组织;所有路由统一经 API Gateway 治理(JWT → X-User-* 注入 → 限流 → 只读降级 → CORS),前端禁止直连内部服务。

  2. 参与:三方支付与 Webhook 幂等

    payment-adapter 抽象统一的支付意图与回调事件模型,三家渠道各走自己的 SDK。支付回调可能重复到达,所以以 provider:event_id 作为幂等键落库,同一事件重复触发也只生效一次;金额计算全部使用 shopspring/decimal。

  3. 参与:订单 Outbox 与最终一致

    订单状态变化和待发布事件写在同一个数据库事务里(outbox 表),由 commerce-worker 轮询投递、失败重试,消费端幂等处理——支付成功后的履约、通知等跨服务动作最终一致;同时处理订单超时取消与对账。

  4. 参与:国际化与多币种

    用 i18next 做中 / 日 / 韩 / 泰 / 英五语切换,libphonenumber-js 按国家校验手机号格式,配合多币种价格展示。前端用 MSW 在本地 mock 接口,页面开发不必等后端。

  5. 负责:部分前端页面与数据看板

    用 React 19 + Vite + TypeScript 开发部分页面与 ECharts 数据看板;协助接入 OpenTelemetry + Jaeger 链路追踪、Prometheus + Grafana 指标,用于排查接口性能问题。

Decisions

关键决策

说明为什么这样做,而不只是列出做了哪些动作。

Q1

Outbox + 同事务写入是最便宜的可靠投递

不用 Kafka,也不用分布式事务。业务表和 outbox 表同事务写入、worker 轮询投递、消费端幂等——「分布式事务」被压回单库本地事务,对小团队和 MVP 阶段刚刚好,不会被运维负担反噬。

Q2

金融路径上,float 就是错误

每个金额字段、每次汇率折算、每次分账比例都用 decimal。这条规则成本极低(多导一个包),但避免的是上线后要做账面对账的事故,越晚修代价越高。

Q3

单库多 schema 配最小权限账号:权限即契约

一个 PostgreSQL 实例、多个 schema、每个服务一个最小权限账号。跨服务直读他人 schema 在数据库授权阶段就被禁止——比口头约定可靠。

Result

交付与结果

交付内容

  • 统一支付模块(参与):接入 Stripe / PayPal / Alipay,用 provider:event_id 对 Webhook 做幂等去重;金额统一用 shopspring/decimal 计算,金融路径禁用 float
  • 订单服务与 Outbox(参与):业务写与事件写同事务落库,commerce-worker 轮询投递 + 失败重试 + 幂等消费;处理订单超时取消与对账
  • 国际化(参与):i18next 中 / 日 / 韩 / 泰 / 英五语切换,libphonenumber-js 校验各国手机号,配合多币种展示
  • catalog / cart 等服务接口开发与联调,经 API Gateway 统一鉴权与路由
  • 部分 React 19 + Vite 前端页面与 ECharts 数据看板;协助接入 OpenTelemetry + Jaeger、Prometheus + Grafana,辅助排查接口性能

项目结果

  • 支付回调幂等:同一事件重复到达只生效一次,杜绝重复发货与重复到账
  • 金额全链路 decimal:对账与退款不出现 100.30 被记成 100.2999… 这类浮点误差
  • 履约、通知等跨服务动作靠 Outbox 实现最终一致,不引入分布式事务

Retrospective

复盘

参与支付与订单链路之后,我对「幂等」的理解从「防重复点击」变成了系统在任何重试下都给出同一个结果:回调会重放、网络会超时、worker 会重投,每一个写入口都得能安全地被执行第二次。

References

方法与参考

本案例用到的工程模式与模型能力,附权威出处,方便核对。