客户

管理应用中的计费用户。在 Admin > Commerce > Customers 标签页中浏览客户。

客户是应用中被收费的主体——通常是一个用户、一个组织或一个项目。只要对应的实体在你自己的数据库中存在，就可以在 Proyecta 中创建一个客户，然后保存返回的 id 以备后续引用。

Customers 标签页

打开 Admin > Commerce，切换到 Customers 标签页，即可查看当前应用的所有计费客户。每行显示：

• 邮箱
• 全名
• 创建时间

面板中更丰富的搜索和筛选功能即将推出。

通常情况下，你无需手动创建客户——当有人完成结账时，系统会自动写入一条记录。使用 Customers 标签页可以查找客户、编辑其详情并授予访问权限。

常见用法

以下是提示词示例，而非代码——描述你想要的功能，AI 会自动构建：

Add an account page where a signed-in customer can see their past orders
and the details we hold on them.

On the order confirmation page, show the customer their order number and
email them a copy of the receipt.

常见问题

我应该为每个用户创建一个 Proyecta 客户，还是只为付费用户创建？

为每个用户都创建一个。这是免费的，且具有幂等性（使用相同邮箱调用会返回同一个客户），这样当用户升级时你可以立刻准备就绪——无需手忙脚乱地补录数据。

一个客户可以有多个订阅吗？

可以。订阅归属于客户，而不是反过来——再次发起结账即可创建新的订阅。

如何查看某个客户订阅了哪些内容？

目前：通过嵌入的 Stripe 控制台查看，或使用 useEntitlement() 逐一检查你关心的功能项。面板中的订阅历史视图已列入路线图。