From 3d6f488a70ff0a05576bf50e2d1ded8d1c40de51 Mon Sep 17 00:00:00 2001 From: tikkhun Date: Thu, 8 Jan 2026 21:04:25 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=88=A0=E9=99=A4=E8=BF=87=E6=9C=9F?= =?UTF-8?q?=E7=9A=84=E6=B5=8B=E8=AF=95=E7=AB=99=E7=82=B9SKU=E6=96=B9?= =?UTF-8?q?=E6=B3=95=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- test-site-sku-methods.md | 105 --------------------------------------- 1 file changed, 105 deletions(-) delete mode 100644 test-site-sku-methods.md diff --git a/test-site-sku-methods.md b/test-site-sku-methods.md deleted file mode 100644 index fe5fffb..0000000 --- a/test-site-sku-methods.md +++ /dev/null @@ -1,105 +0,0 @@ -# 产品站点SKU查询方法测试文档 - -## 新增和更新的API接口 - -### 1. 根据产品ID获取站点SKU列表 -**接口**: `GET /product/:id/site-skus` -**功能**: 获取指定产品的所有站点SKU列表 -**返回**: 站点SKU对象数组,按创建时间升序排列 - -### 2. 根据站点SKU查询产品 -**接口**: `GET /product/site-sku/:siteSku` -**功能**: 根据站点SKU代码查询对应的产品信息 -**返回**: 完整的产品对象(包含站点SKU、分类、属性等关联数据) - -### 3. 根据产品ID获取产品详情 -**接口**: `GET /product/:id` -**功能**: 获取产品的完整详情信息 -**返回**: 完整的产品对象(包含站点SKU、分类、属性、组成等关联数据) - -### 4. 现有接口的增强 - -#### 4.1 根据SKU查询产品 -**接口**: `GET /product/sku/:sku` -**增强**: 现在返回的产品信息包含关联的站点SKU数据 - -#### 4.2 搜索产品 -**接口**: `GET /product/search?name=:name` -**增强**: 搜索结果现在包含每个产品的站点SKU数据 - -#### 4.3 获取产品列表 -**接口**: `GET /product/list` -**增强**: 产品列表中的每个产品现在都包含站点SKU数据 - -## 服务层新增方法 - -### ProductService新增方法 - -1. **getProductSiteSkus(productId: number)**: Promise - - 获取指定产品的所有站点SKU - - 包含产品关联信息 - - 按创建时间排序 - -2. **getProductById(id: number)**: Promise - - 根据产品ID获取完整产品信息 - - 包含站点SKU、分类、属性、组成等所有关联数据 - - 自动处理单品和混装商品的组成信息 - -3. **findProductBySiteSku(siteSku: string)**: Promise - - 根据站点SKU查询对应的产品 - - 返回完整的产品信息 - - 如果站点SKU不存在则抛出错误 - -### 现有方法增强 - -1. **findProductsByName(name: string)**: 现在包含站点SKU数据 -2. **findProductBySku(sku: string)**: 现在包含站点SKU数据 -3. **getProductList**: 已经包含站点SKU数据(无需更改) - -## 使用示例 - -### 获取产品的站点SKU列表 -```javascript -// GET /product/123/site-skus -// 返回: -[ - { - "id": 1, - "siteSku": "SITE-SKU-001", - "productId": 123, - "createdAt": "2024-01-01T00:00:00Z", - "updatedAt": "2024-01-01T00:00:00Z" - } -] -``` - -### 根据站点SKU查询产品 -```javascript -// GET /product/site-sku/SITE-SKU-001 -// 返回完整的产品对象,包含: -// - 基本信息(SKU、名称、价格等) -// - 分类信息 -// - 属性信息 -// - 站点SKU列表 -// - 组成信息 -``` - -### 获取产品详情 -```javascript -// GET /product/123 -// 返回完整的产品对象,与站点SKU查询类似 -``` - -## 数据库查询优化 - -所有新增和更新的方法都使用了TypeORM的关联查询,确保: -- 一次查询获取所有需要的数据 -- 避免N+1查询问题 -- 包含必要的关联关系(分类、属性、站点SKU、组成) - -## 错误处理 - -所有方法都包含适当的错误处理: -- 产品不存在时抛出明确的错误信息 -- 站点SKU不存在时抛出明确的错误信息 -- 控制器层统一处理错误并返回适当的HTTP响应 \ No newline at end of file