# @fayz-ai/shop 中文文档

规范地址：https://npmcn.com/package/%40fayz-ai/shop/

版本：0\.95\.1
npm 元数据更新时间：2026-11-11T22:42:42.380Z
中文译文更新时间：2026-11-14T12:08:52.887Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fayz-ai/shop
原文对照：https://npmcn.com/package/%40fayz-ai/shop/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.6 MB，149 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：react ^18\.0\.0 \|\| ^19\.0\.0，zustand ^4\.5\.0 \|\| ^5\.0\.0，react-dom ^18\.0\.0 \|\| ^19\.0\.0，lucide-react \>=0\.400\.0 \<1\.0\.0，@supabase/supabase-js ^2\.45\.0
- 首次发布：2026-06-19T20:20:32.072Z
- 最新版本发布：2026-11-11T22:42:42.203Z
- 近 30 天下载量：12751（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：106（近 12 个月 106 个）

## 中文简介

Fayz SDK电子商务层——产品、订单、客户、折扣、航运

## 安装

```sh
npm install @fayz-ai/shop
```

也可以使用：`pnpm add @fayz-ai/shop`、`yarn add @fayz-ai/shop`、`bun add @fayz-ai/shop`

## README

# @fayz-ai/ shop (中文(简体) )

> 每个费兹店面背后的商业层——产品,订单,顾客,折扣,航运.

[![npm](https://img.shields.io/npm/v/@fayz-ai/shop.svg)](https://www.npmjs.com/package/@fayz-ai/shop) [![license](https://img.shields.io/npm/l/@fayz-ai/shop.svg)](https://github.com/FayaLabs/fayz-sdk/blob/main/LICENSE)

**状态 :** β-发布至npm并在整个法伊兹狗食应用. 事前1.0:小API在1.0之前可能会有变化.

`@fayz-ai/shop` 是无头电子商务引擎: a `ShopProvider` 合同加上产品、推车、订单、客户、折扣和货运的域名。 它拥有 _商业意味着什么_ 故取库前`@fayz-ai/storefront`),而管理员表面只须使出.

提供商优先设计. 运送演示 `createMockShopProvider`输入 `createSupabaseShopProvider` (或你自己的) `ShopProvider`) 对于真实数据——UI没有变化. 租房是通过可插接的解决器解决的,所以同一个引擎为一商店或上千个市场服务.

## 里面的东西

-   **`ShopProvider` 合同** – 每个后端执行器都有一个接口
-   **供应商** —— 说 `createMockShopProvider` (下行)和 `createSupabaseShopProvider` (实数)
-   **运行时间** —— 说 `getShopProvider` 编号 : `setShopProvider` 单通线
-   **租赁** —— 说 `setShopTenantResolver` 编号 : `getShopTenantId` 多层隔离
-   **公有领域类型** - 产品、订单、客户、折扣、运输
-   **`StockStore` 合同** (单位:千美元)`@fayz-ai/shop/inventory`)——库存作为仅作为附件的分类账,而不是一个分级账,一个Supabase和一个共用合同套房的内存执行

## 安装

```bash
npm install @fayz-ai/shop
```

端点 : `@fayz-ai/core`, (中文(简体) ), `@fayz-ai/ui`, (中文(简体) ), `@fayz-ai/auth` (+反应,反应-度).

## 使用量

```ts
import { setShopProvider, createSupabaseShopProvider } from '@fayz-ai/shop'

setShopProvider(createSupabaseShopProvider({ /* supabase + storeId */ }))
```

库存为分类账:变动情况随附,结余来源于这些分类账 `available = on_hand − reserved`同一守则与执行两者都背道而驰.

```ts
import { createSupabaseStockStore } from '@fayz-ai/shop/inventory'

const stock = createSupabaseStockStore()
await stock.recordMovement({
  variantId,
  kind: 'receipt',            // vocabulary rows, not a hardcoded enum
  reasonCode: 'purchase',
  quantity: 12,               // signed; the kind's direction decides the sign
  idempotencyKey: `po-1180:${variantId}`, // a retry returns the same movement
})
await stock.getAvailable(variantId)
```

## 费兹SDK的一部分

商业引擎 `@fayz-ai/storefront` 建立和建立 `@fayz-ai/plugin-shop` 管理者。 与 `@fayz-ai/sdk`用于生成商店前端的商店客户端 .

## 路线图贡献( I)

建设并不断发展于开阔. 见 [费兹SDK路线图](https://npmcn.com/package/docs/platform/ROADMAP.md)。 。 。 .

## 常见问题

### @fayz-ai/shop 是什么？

Fayz SDK电子商务层——产品、订单、客户、折扣、航运

### 如何安装 @fayz-ai/shop？

在项目目录运行 npm install @fayz-ai/shop，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.0\.0 \|\| ^19\.0\.0）、zustand（^4\.5\.0 \|\| ^5\.0\.0）、react-dom（^18\.0\.0 \|\| ^19\.0\.0）、lucide-react（\>=0\.400\.0 \<1\.0\.0）、@supabase/supabase-js（^2\.45\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fayz-ai/shop 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fayz-ai/shop 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @fayz-ai/shop 可以商用吗？

@fayz-ai/shop 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fayz-ai/shop 的下载量有多少？

根据 npm 官方下载统计，@fayz-ai/shop 在 2026/10/15 – 2026/11/13 这 30 天内被下载 12,751 次，日均约 425 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fayz-ai/shop 还在维护吗？

最新版本 0\.95\.1 发布于 2026/11/12（2 天前）；至今共发布 106 个版本，其中过去 12 个月发布了 106 个；首次发布于 2026/06/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。