产品与功能

定义您的销售内容。创建包含一个或多个变体的产品，并附加可复用的功能以实现基于权限的访问控制。

Proyecta Commerce 使用三个核心概念：产品、变体和功能。

产品 — 您销售的东西（例如“Pro 计划”、“T恤”、“战略咨询”）
变体 — 产品的定价层级或配置（例如“Pro 月付 $29”、“Pro 年付 $290”、“T恤 – 大号”）
功能 — 一个可复用的权限 key，您的应用在运行时会对其进行检查（例如 pro_features、unlimited_projects、api_access）

一个产品可以拥有多个变体。产品还可以附加一个或多个资源——通常是功能——当客户订阅时即可获得相应访问权限。

两种销售内容的建模方式

Commerce 与平台的其他部分相互协作，因此“您所销售的东西”有两种形态——Proyecta 会自动为您选择合适的那种：

Commerce 原生产品 — 订阅、计划、一次性升级以及功能/权限。直接在 Admin > Commerce > Products 中定义。本页其余内容所描述的正是这种模型。
内容驱动的店面目录 — 包含图片、价格和描述、由业务负责人日常编辑的商品。这些内容以可售集合的形式存储在 CMS 中：每一条条目本身_就是_产品。当条目发布时，Proyecta 会自动将其整合到 Commerce 中，成为一个真实可购买的产品——为您创建产品及其定价变体，并直接从内容字段中同步价格。店面展示内容中的价格，结账时则向关联的变体收费，由于两者共享同一数据源，价格永远不会出现偏差。您需要以内容的方式（在您应用的 Admin 中、在 builder 里或在已发布的站点上）管理这些条目，而非在 Commerce > Products 下进行管理。请参阅内容管理。

一个不接受银行卡支付的普通目录——仅供浏览的菜单，或“购买”按钮跳转到 WhatsApp 下单链接的店铺——只是普通内容，即一个普通的目录集合，不涉及 Commerce 整合。银行卡结账功能才是让集合变得_可售_的关键。

创建产品

在 Admin > Commerce > Products 中，点击 Create product（或直接告诉 AI："Create a Pro plan at $29/month and a Business plan at $99/month."）。每个产品需要：

一个显示名称（例如“Pro”）
至少一个变体

变体

每个变体都有其独立的定价：

字段	说明
`name`	变体的显示标签（“Monthly”、“Annual”、“Large”）
`currency`	三位 ISO 货币代码——USD、EUR、GBP、JPY、BRL、MXN、INR……（支持 130+ 种货币）
`unit_amount`	以最小货币单位（分）表示的价格。`2900` = $29.00
`recurring`	可选——`{ interval: 'week' \| 'month' \| 'year' }`。一次性价格可省略此字段。目前不支持按天计费。
`is_default`	已接受但尚未生效——默认变体选择功能目前尚未实现。
`media`	通过 CDN 文件 ID 附加图片或视频（参阅文件）

价格不可修改。 变体一旦创建，其价格便无法更改——请改为创建新变体。这可以防止现有订阅者因价格意外变动而受到影响。

功能（权限）

功能是访问控制的基本单元。在 Admin > Commerce > Products 中创建一次功能，然后将其附加到一个或多个产品上。每个功能包含名称、可选描述以及一个 key——由小写字母、数字和下划线组成（例如 pro_features）——这正是您的应用进行检查时所使用的标识符。

创建产品时，您可以通过“resources”将功能附加到产品上。订阅了该产品的客户将获得其所有附加功能的访问权限。

然后，在您的应用中，通过该 key 进行访问控制：

const { hasAccess, isLoading } = useEntitlement('pro_features');

if (isLoading) return <Spinner />;
if (!hasAccess) return <UpgradePrompt />;
return <ProOnlyThing />;

此检查在服务端针对已登录的 session 运行，因此无法从浏览器伪造。完整使用模式请参阅将 Commerce 集成到我的应用中。

注意： 请始终通过功能的 key（即从功能名称派生的 slug，例如 pro_features）进行访问控制，而非功能的内部 id。

这就是您在应用代码中对 Pro 专属页面、API endpoint 或功能进行访问控制的方式。

常见产品形态

SaaS 订阅

Create products: Free ($0/month), Pro ($29/month, $290/year), Business ($99/month, $990/year).
Attach a 'pro_features' feature to Pro and Business so I can gate access in my code.

实体商品

Create a T-shirt product with three variants: Small, Medium, Large at $25 each.

数字商品

Create a course product with a single one-time variant at $149.

捐款

Create a donation product with three variants: $25, $50, $100 — all one-time.

库存

Proyecta Commerce 目前不支持实体产品的库存追踪。如果您销售有库存限制的商品，请在应用的数据库中自行管理库存数量，并在结账流程中进行相应检查。

即将推出

结账字段自定义 — 向买家收集额外信息
随意定价
实体产品内置库存追踪