工程

我们如何做工程

标准，而非承诺。这是我们对每个项目坚持的内部水准——也是我们的工作能超越上线日期的原因。

//架构

工程原则

塑造每个主题、App 与集成形态的规则。

/01

每个决策都有记录

架构选择附带书面理由：约束、备选方案、决策与取舍。没有魔法，没有感觉。

/02

商家保持自主

主题系统的设计目标是让运营无需开发即可配置内容。软件应通过节省的请求数为自己买单。

/03

App 集成，而非修补

用 Theme App Extensions 与稳定契约取代向主题文件注入脚本。主题与 App 保持独立。

/04

性能是预算，不是期望

LCP、INP 与 CLS 有明确的预算并在 CI 中强制执行。打破预算的新功能不会上线。

/05

迁移是渐进式的

从主题到无头，从一个 ERP 到另一个：分阶段上线 + 回滚路径，绝不做推倒重来。

/06

代码像文章一样被评审

评审是标准流程而非负担。评审门禁是质量定义的一部分。

//技术栈

绑定问题的工具

下面的每项技术都存在，是因为某个具体的业务问题需要它。

领域	技术	解决什么	优先级
主题	Liquid / Sections / Blocks / Metaobjects	商家可编辑的可复用内容系统	★★★★★
前端	React / Next.js / Hydrogen / TypeScript	随品牌扩展的商务前端	★★★★★
商务 API	Storefront API / Admin API / Customer Account API	把 Shopify 变成可靠的商务后端	★★★★★
商务逻辑	Shopify Functions / Checkout Extensions	用代码表达订单、折扣与配送规则	★★★★★
集成	Webhooks / Queue / Retry / ERP / OMS / PIM	系统间保持同步的数据流	★★★★☆
质量	Performance / Core Web Vitals / Testing / CI	持续快速且可安全变更的站点	★★★★☆

//集成

我们连接的系统

商务很少是单一系统。这些是我们工程化的接缝。

ERP

↔ Shopify

Webhooks · 队列 · 重试 · 对账

订单、商品与库存数据双向保持同步。

OMS

↔ Shopify

Admin API · 履约变更

履约与发货状态无需手动操作即可流转。

PIM

↔ Shopify

商品变更 · Metaobjects

富商品数据映射进 Shopify 内容模型。

CRM

↔ Shopify

Customer Account API · Webhooks

客户事件流入营销与服务系统。

搜索

↔ Shopify

Storefront API · 边缘缓存

自定义搜索体验且不拖慢店铺前端。

CMS

↔ Shopify

无头内容 · Storefront API

编辑内容渲染进商务前端。

//交付

流程

从发现到长期维护的六个步骤，每一步都降低下一步的风险。

需求发现

审计现有系统，捕获真实业务问题，定义成功指标。

架构设计

决定形态：主题系统、无头、App 还是集成。记录每一个关键决策。

构建

用版本控制、评审与设计系统进行工程化开发。没有一次性 hack。

质量验证

性能预算、可访问性、Theme Check 与自动化回归，上线前全部通过。

上线

边缘缓存、重定向、监控，以及经得起推敲的性能基线。

长期维护

版本升级、技术债治理与上线后的持续迭代。

//性能

预算，在 CI 中强制执行

Core Web Vitals 是产品需求，而不是项目结束时的报告。

LCP

< 2.5s

App 影响、图片管线、边缘缓存

INP

< 200ms

JS 体积、水合边界、第三方脚本

CLS

< 0.1

预留布局空间、字体加载策略

JS 预算

< 100KB

懒加载、islands、代码分割

本网站也遵循同一标准：在 Cloudflare 边缘网络上的静态优先架构、构建期强制执行的 JS 预算，性能数据发布在我们的工程笔记.

Next step

想让这套标准用在你店铺上？

从 Commerce Architecture Review 开始。如果你的系统不需要我们，我们会直说。

预约 Commerce Architecture Review 查看案例