@newpeak/barista-cli 0.1.6 → 0.1.8

package/docs/commands/liberica/locations/list.md

@@ -0,0 +1,171 @@
+# barista liberica locations list
+
+List warehouse locations with pagination.
+
+## 2.1 Command Metadata
+
+| Field | Value |
+|------|-----|
+| Full Command | `barista liberica locations list` |
+| Description | List warehouse locations with pagination |
+| HTTP Method | GET |
+| Requires Authentication | Yes |
+| Supports Dry-Run | No |
+
+## 2.2 Backend API Reference
+
+### Controller Location
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/stock/
+        └── EnterpriseWarehouseLocationController.java
+            └── page(@GetResource(path = "/page"))
+                └── public ResponseData<PageResult<MasterWarehouseLocationResponse>> page(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @ParameterObject MasterWarehouseLocationRequest masterWarehouseLocationRequest
+                    )
+```
+
+### Request DTO Location
+```
+coffee-liberica-end/
+└── business/liberica-business-master/master-api/
+    └── src/main/java/com/newpeak/liberica/master/api/pojo/request/
+        └── MasterWarehouseLocationRequest.java
+            ├── warehouseId: Long
+            ├── warehouseLocationCode: String
+            ├── warehouseLocationName: String
+            ├── statusFlag: Integer
+            └── remark: String
+```
+
+### Response DTO Location
+```
+coffee-liberica-end/
+└── business/liberica-business-master/master-api/
+    └── src/main/java/com/newpeak/liberica/master/api/pojo/response/
+        └── MasterWarehouseLocationResponse.java
+            ├── warehouseLocationId: Long
+            ├── warehouseId: Long
+            ├── warehouseLocationCode: String
+            ├── warehouseLocationName: String
+            ├── statusFlag: Integer (1=enable, 2=disable)
+            └── remark: String
+```
+
+## 2.3 CLI Parameter Design
+
+### Command Structure
+```
+barista liberica locations list [options]
+```
+
+### Global Options
+| Option | Type | Description |
+|------|------|------|
+| `--env` | string | Target environment (dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | Tenant code |
+| `--json` | boolean | JSON output |
+
+### Command Options
+| Option | Short | Type | Required | Default | Description | Maps to Query Param |
+|------|--------|------|------|--------|------|-------------|
+| --page | -p | number | No | 1 | Page number (CLI 1-based) | pageNo (0-based) |
+| --size | -s | number | No | 20 | Page size | pageSize |
+| --warehouse-id | -w | string | No | - | Filter by parent warehouse ID | warehouseId |
+| --status | — | number | No | - | Status filter (1=enable, 2=disable) | statusFlag |
+| --keyword | -k | string | No | - | Keyword search (warehouseLocationName and warehouseLocationCode) | warehouseLocationName / warehouseLocationCode |
+
+## 2.4 Field Mapping Table
+
+| CLI Parameter | Query Param / DTO Field | Type Conversion | Validation Rule |
+|---------|---------|----------|----------|
+| --page / -p | pageNo | number, CLI page - 1 | >= 0 |
+| --size / -s | pageSize | number | > 0 |
+| --warehouse-id / -w | warehouseId | string | - |
+| --status | statusFlag | number | 1 or 2 |
+| --keyword / -k | warehouseLocationName / warehouseLocationCode | Direct | max=255 |
+
+## 2.5 Error Code Reference
+
+### ExceptionEnum Location
+```
+coffee-liberica-end/
+└── business/liberica-business-master/master-api/
+    └── src/main/java/com/newpeak/liberica/master/api/exception/enums/
+        └── MasterWarehouseLocationExceptionEnum.java
+            ├── MASTER_WAREHOUSE_LOCATION_NOT_EXIST("01001380001", "租户仓位不存在")
+            ├── MASTER_WAREHOUSE_LOCATION_CODE_FORMAT_CANNOT_EMPTY("01001380002", "仓位编码规则不能为空")
+            └── MASTER_WAREHOUSE_LOCATION_CODE_FORMAT_NOT_CORRECT("01001380003", "仓位编码规则格式不正确")
+```
+
+### Known Error Codes
+| Error Code | Error Message | Trigger Condition |
+|--------|----------|----------|
+| 01001380001 | Location does not exist | Detail query with non-existent ID |
+
+## 2.6 Permission Check
+
+| Check Item | Location | Description |
+|--------|------|------|
+| Page Query | No specific permission code on `@GetResource(path = "/page")` | Available to authenticated users |
+
+## 2.7 Implementation Notes
+
+1. **Pagination**: CLI uses 1-based page numbers. API uses 0-based. Convert: `pageNo = options.page - 1`.
+2. **Response Fields**: Backend returns `rows`, `pageNo`, `pageSize`, `totalRows`. Do NOT use `records` or `total`.
+3. **Warehouse Filter**: `--warehouse-id` is optional but commonly used to list locations within a specific warehouse.
+4. **Keyword Search**: When `--keyword` is provided, send it as both `warehouseLocationName` and `warehouseLocationCode` query params.
+5. **BigInteger IDs**: `warehouseLocationId` and `warehouseId` in response rows must be kept as `string` in TypeScript.
+6. **Table Output**: Default columns: Location ID, Warehouse ID, Code, Name, Status.
+7. **JSON Output**: When `--json` is used, wrap response with standardized pagination object.
+
+## 2.8 Example Usage
+
+```bash
+# List all locations (first page, 20 per page)
+barista liberica locations list
+
+# List locations for a specific warehouse
+barista liberica locations list --warehouse-id "1234567890123456789"
+
+# List with pagination
+barista liberica locations list --warehouse-id "1234567890123456789" --page 2 --size 50
+
+# Filter by status
+barista liberica locations list --status 1
+
+# Keyword search
+barista liberica locations list --keyword "A-01"
+
+# JSON output
+barista liberica locations list --json
+
+# Combine filters
+barista liberica locations list \
+  --warehouse-id "1234567890123456789" \
+  --page 1 \
+  --size 10 \
+  --status 1 \
+  --keyword "Shelf" \
+  --json
+```
+
+## 2.9 API Path
+
+```
+GET /api/enterprise/purchases/warehouse/location/page
+```
+
+**Query Parameters:**
+```
+?pageNo=0&pageSize=20&warehouseId=1234567890123456789&statusFlag=1&warehouseLocationCode=Shelf&warehouseLocationName=Shelf
+```
+
+**Headers:**
+```
+Authorization: <token>  (No "Bearer " prefix)
+```
+
+**Note**: Do NOT include `X-TENANT-ID` header. Tenant is extracted from JWT token.

package/docs/commands/liberica/stock/ledger.md

@@ -0,0 +1,209 @@
+# 命令名称: barista liberica stock ledger
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica stock ledger` |
+| 功能描述 | 查询出入库台账（分页列表+汇总） |
+| HTTP方法 | GET |
+| 是否需要认证 | 是 |
+| 是否支持dry-run | 否 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/master/
+        └── MasterStockController.java
+            ├── commonStockJourneyPage(@GetResource(path = "/journey/page"))
+            │   └── public ResponseData<PageResult<StockJourneyResponse>> commonStockJourneyPage(
+            │           @RequestHeader("X-TENANT-ID") Long tenantId,
+            │           @ParameterObject StockJourneyQueryRequest stockJourneyQueryRequest
+            │       )
+            └── commonStockJourneyPageSummary(@GetResource(path = "/journey/page/summary"))
+                └── public ResponseData<StockJourneySummaryResponse> commonStockJourneyPageSummary(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @ParameterObject StockJourneyQueryRequest stockJourneyQueryRequest
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
+        └── StockJourneyQueryRequest.java
+            ├── stockId: Long
+            ├── stockFormCode: String
+            ├── stockType: String
+            ├── stockFlag: String
+            ├── warehouseCode: String
+            ├── materialCode: String
+            ├── materialName: String
+            ├── materialType: String
+            ├── color: String
+            ├── lotNo: String
+            ├── lotCode: String
+            ├── sourceType: String
+            ├── sourceCode: String
+            ├── stockDate: Date
+            ├── stockDateCriteria: DateRange
+            └── postingMonth: Date
+```
+
+### Response DTO位置
+
+**列表项 DTO：**
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
+        └── StockJourneyResponse.java
+            ├── stockId: Long
+            ├── stockFormCode: String
+            ├── stockType: String
+            ├── stockFlag: String
+            ├── warehouseCode: String
+            ├── materialCode: String
+            ├── materialNo: String
+            ├── materialName: String
+            ├── materialType: String
+            ├── color: String
+            ├── longX: BigDecimal
+            ├── wideY: BigDecimal
+            ├── highZ: BigDecimal
+            ├── sourceCode: String
+            ├── sourceType: String
+            ├── lotCode: String
+            ├── lotNo: String
+            ├── supplierLotNo: String
+            ├── inboundCount: BigDecimal
+            ├── outboundCount: BigDecimal
+            ├── materialUomCode: String
+            ├── unitPrice: BigDecimal
+            ├── localCurrency: String
+            ├── inboundAmount: BigDecimal
+            ├── outboundAmount: BigDecimal
+            ├── inboundDate: Date
+            ├── stockDate: Date
+            ├── outboundDate: Date
+            ├── postingMonth: Date
+            └── remark: String
+```
+
+**汇总 DTO：**
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
+        └── StockJourneySummaryResponse.java
+            ├── totalInboundCount: BigDecimal
+            ├── totalOutboundCount: BigDecimal
+            ├── totalInboundAmount: BigDecimal
+            └── totalOutboundAmount: BigDecimal
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```bash
+barista liberica stock ledger [options]
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev/test/prod-cn/prod-jp) |
+| `--tenant` | string | 租户代码（仅Liberica） |
+| `--dry-run` | boolean | 预览模式 |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| `--stock-id` |  | string | 否 | - | 出入库ID | stockId |
+| `--stock-form-code` |  | string | 否 | - | 出入库单编码 | stockFormCode |
+| `--stock-type` |  | string | 否 | - | 出入库单类型 | stockType |
+| `--stock-flag` |  | string | 否 | - | 出入库标志(inbound/outbound) | stockFlag |
+| `--warehouse-code` | -w | string | 否 | - | 仓库编码 | warehouseCode |
+| `--material-code` | -m | string | 否 | - | 物料编码 | materialCode |
+| `--material-name` |  | string | 否 | - | 物料名称（支持模糊查询） | materialName |
+| `--material-type` | -t | string | 否 | - | 物料规格 | materialType |
+| `--color` | -c | string | 否 | - | 颜色 | color |
+| `--lot-no` | -l | string | 否 | - | 批次号 | lotNo |
+| `--lot-code` |  | string | 否 | - | 系统批次号 | lotCode |
+| `--source-type` |  | string | 否 | - | 源单类型 | sourceType |
+| `--source-code` |  | string | 否 | - | 源单编码 | sourceCode |
+| `--start-date` |  | string | 否 | - | 出入库开始日期(YYYY-MM-DD) | stockDateCriteria.startDate |
+| `--end-date` |  | string | 否 | - | 出入库结束日期(YYYY-MM-DD) | stockDateCriteria.endDate |
+| `--posting-month` |  | string | 否 | - | 记账年月(YYYY-MM) | postingMonth |
+| `--summary` |  | boolean | 否 | false | 仅显示汇总数据 | 控制输出模式 |
+| `--page` | -p | number | 否 | 1 | 页码 | pageNo |
+| `--size` | -s | number | 否 | 20 | 每页条数 | pageSize |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| --stock-id | stockId | string→Long | 后端BigInteger，CLI使用string |
+| --stock-form-code | stockFormCode | 直接传递 | - |
+| --stock-type | stockType | 直接传递 | enum: STOCK_TYPE |
+| --stock-flag | stockFlag | 直接传递 | enum: STOCK_FLAG |
+| --warehouse-code | warehouseCode | 直接传递 | - |
+| --material-code | materialCode | 直接传递 | - |
+| --material-name | materialName | 直接传递 | - |
+| --material-type | materialType | 直接传递 | - |
+| --color | color | 直接传递 | - |
+| --lot-no | lotNo | 直接传递 | - |
+| --lot-code | lotCode | 直接传递 | - |
+| --source-type | sourceType | 直接传递 | enum: source_type |
+| --source-code | sourceCode | 直接传递 | - |
+| --start-date | stockDateCriteria.startDate | string→Date | yyyy-MM-dd |
+| --end-date | stockDateCriteria.endDate | string→Date | yyyy-MM-dd |
+| --posting-month | postingMonth | string→Date | yyyy-MM |
+| --page | pageNo | number-1 | 0-based分页 |
+| --size | pageSize | number | >0 |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/exception/enums/
+        ├── StockJourneyExceptionEnum.java
+        │   ├── STOCK_JOURNEY_NOT_EXIST("...001", "租户出入库台账不存在")
+        │   └── CAN_NOT_DELETE_MATERIAL_WITH_USED_IN_STOCK("...002", "物料已在库存中使用，不能删除")
+        ├── MasterStockExceptionEnum.java
+        │   ├── MASTER_STOCK_NOT_EXIST("...001", "租户库存不存在")
+        │   └── MASTER_STOCK_OUT_LOT_NOT_ENOUGH("...002", "租户成品出库单{}余量不够")
+        └── MasterWarehouseStockExceptionEnum.java
+            └── MASTER_WAREHOUSE_STOCK_NOT_EXIST("...001", "租户仓库库存不存在")
+```
+
+### 已知错误码示例
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| ...001 | 租户出入库台账不存在 | 查询的台账记录不存在 |
+| ...001 | 租户库存不存在 | 查询的库存记录不存在 |
+| ...002 | 租户成品出库单{}余量不够 | 出库操作余量不足 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| 菜单权限 | `MasterStockController` 类上的 `@Menu` 注解 | `stock_journey` 菜单，要求 `tenantStock` 角色 |
+| 接口访问 | Controller方法无单独 `@GetResource(requiredPermission = true)` | 通过菜单角色控制 |
+
+## 2.7 实现要点
+
+1. **双接口调用**：默认模式同时调用 `/journey/page/summary` 和 `/journey/page`，先显示汇总再显示列表
+2. **Summary模式**：当传入 `--summary` 时，仅调用 `/journey/page/summary`，不请求列表数据
+3. **分页转换**：CLI page 1 对应 API pageNo 0
+4. **ID类型**：stockId 后端为 Long/BigInteger，CLI 统一使用 string 类型避免精度丢失
+5. **日期格式**：--posting-month 使用 yyyy-MM 格式，转换为 Date 类型
+6. **stockFlag映射**：inbound 对应入库记录，outbound 对应出库记录；后端 StockJourneyResponse 根据 inboundCount 是否为空自动推断 stockFlag
+7. **输出格式**：默认表格输出，--json 返回结构化 JSON；汇总数据和列表数据在 JSON 中分层返回

package/docs/commands/liberica/stock/list.md

@@ -0,0 +1,165 @@
+# 命令名称: barista liberica stock list
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica stock list` |
+| 功能描述 | 查询带仓库的库存列表（分页） |
+| HTTP方法 | GET |
+| 是否需要认证 | 是 |
+| 是否支持dry-run | 否 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/master/
+        └── MasterStockController.java
+            └── commonStockWithWarehousePage(@GetResource(path = "/page/withWarehouse"))
+                └── public ResponseData<PageResult<MasterWarehouseStockResponse>> commonStockWithWarehousePage(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @ParameterObject MasterStockQueryRequest masterStockQueryRequest
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
+        └── MasterStockQueryRequest.java
+            ├── warehouseCode: String
+            ├── materialCode: String
+            ├── materialNo: String
+            ├── materialName: String
+            ├── materialType: String
+            ├── lotNo: String
+            ├── color: String
+            ├── longX: BigDecimal
+            ├── wideY: BigDecimal
+            ├── highZ: BigDecimal
+            ├── sourceType: String
+            ├── sourceCode: String
+            ├── stockId: Long
+            ├── excludeZeroStock: boolean (default = false)
+            └── stockDateCriteria: DateRange
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
+        └── MasterWarehouseStockResponse.java
+            ├── warehouseCode: String
+            ├── materialCode: String
+            ├── materialName: String
+            ├── materialType: String
+            ├── color: String
+            ├── stockCount: BigDecimal
+            ├── unitPrice: BigDecimal
+            ├── stockAmount: BigDecimal
+            └── lastStockDate: Date
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```bash
+barista liberica stock list [options]
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev/test/prod-cn/prod-jp) |
+| `--tenant` | string | 租户代码（仅Liberica） |
+| `--dry-run` | boolean | 预览模式 |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| `--warehouse-code` | -w | string | 否 | - | 仓库编码 | warehouseCode |
+| `--material-code` | -m | string | 否 | - | 物料编码 | materialCode |
+| `--material-no` | -n | string | 否 | - | 物料号码 | materialNo |
+| `--material-name` |  | string | 否 | - | 物料名称（支持模糊查询） | materialName |
+| `--material-type` | -t | string | 否 | - | 规格型号 | materialType |
+| `--lot-no` | -l | string | 否 | - | 批次号 | lotNo |
+| `--color` | -c | string | 否 | - | 颜色 | color |
+| `--long-x` |  | number | 否 | - | 长 | longX |
+| `--wide-y` |  | number | 否 | - | 宽 | wideY |
+| `--high-z` |  | number | 否 | - | 高 | highZ |
+| `--source-type` |  | string | 否 | - | 源单类型 | sourceType |
+| `--source-code` |  | string | 否 | - | 源单编码 | sourceCode |
+| `--stock-id` |  | string | 否 | - | 库存ID | stockId |
+| `--exclude-zero-stock` |  | boolean | 否 | false | 不包含零库存 | excludeZeroStock |
+| `--start-date` |  | string | 否 | - | 出入库开始日期(YYYY-MM-DD) | stockDateCriteria.startDate |
+| `--end-date` |  | string | 否 | - | 出入库结束日期(YYYY-MM-DD) | stockDateCriteria.endDate |
+| `--page` | -p | number | 否 | 1 | 页码 | pageNo |
+| `--size` | -s | number | 否 | 20 | 每页条数 | pageSize |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| --warehouse-code | warehouseCode | 直接传递 | - |
+| --material-code | materialCode | 直接传递 | - |
+| --material-no | materialNo | 直接传递 | - |
+| --material-name | materialName | 直接传递 | - |
+| --material-type | materialType | 直接传递 | - |
+| --lot-no | lotNo | 直接传递 | - |
+| --color | color | 直接传递 | - |
+| --long-x | longX | string→BigDecimal | - |
+| --wide-y | wideY | string→BigDecimal | - |
+| --high-z | highZ | string→BigDecimal | - |
+| --source-type | sourceType | 直接传递 | - |
+| --source-code | sourceCode | 直接传递 | - |
+| --stock-id | stockId | string→Long | 后端BigInteger，CLI使用string |
+| --exclude-zero-stock | excludeZeroStock | 直接传递 | boolean |
+| --start-date | stockDateCriteria.startDate | string→Date | yyyy-MM-dd |
+| --end-date | stockDateCriteria.endDate | string→Date | yyyy-MM-dd |
+| --page | pageNo | number-1 | 0-based分页 |
+| --size | pageSize | number | >0 |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/exception/enums/
+        ├── MasterStockExceptionEnum.java
+        │   ├── MASTER_STOCK_NOT_EXIST("...001", "租户库存不存在")
+        │   └── MASTER_STOCK_OUT_LOT_NOT_ENOUGH("...002", "租户成品出库单{}余量不够")
+        ├── MasterWarehouseStockExceptionEnum.java
+        │   └── MASTER_WAREHOUSE_STOCK_NOT_EXIST("...001", "租户仓库库存不存在")
+        └── StockJourneyExceptionEnum.java
+            ├── STOCK_JOURNEY_NOT_EXIST("...001", "租户出入库台账不存在")
+            └── CAN_NOT_DELETE_MATERIAL_WITH_USED_IN_STOCK("...002", "物料已在库存中使用，不能删除")
+```
+
+### 已知错误码示例
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| ...001 | 租户库存不存在 | 查询的库存记录不存在 |
+| ...001 | 租户仓库库存不存在 | 查询的仓库库存记录不存在 |
+| ...002 | 租户成品出库单{}余量不够 | 出库操作余量不足 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| 菜单权限 | `MasterStockController` 类上的 `@Menu` 注解 | `inventory_query` 菜单，要求 `tenantStock` 角色 |
+| 接口访问 | Controller方法无单独 `@GetResource(requiredPermission = true)` | 通过菜单角色控制 |
+
+## 2.7 实现要点
+
+1. **分页转换**：CLI page 1 对应 API pageNo 0
+2. **ID类型**：stockId 后端为 Long/BigInteger，CLI 统一使用 string 类型避免精度丢失
+3. **日期范围**：--start-date 和 --end-date 组合为 DateRange 对象传递
+4. **输出格式**：默认表格输出（cli-table3），--json 返回结构化 JSON
+5. **零库存过滤**：excludeZeroStock 默认为 false，传入 true 时过滤掉 stockCount=0 的记录