@newpeak/barista-cli 0.1.5 → 0.1.7

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

@@ -0,0 +1,149 @@
+# barista liberica currency list
+
+分页查询币种列表。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica currency list` |
+| 功能描述 | 分页查询币种列表 |
+| HTTP方法 | GET |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ⬜ 否 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/finance/
+        └── FinanceCurrencyController.java
+            └── listCurrencies(@GetResource(path = "/page"))
+                └── public ResponseData<PageResult<CurrencyResponse>> listCurrencies(
+                        @ParameterObject CurrencyRequest request
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-finance/finance-api/src/main/java/com/newpeak/liberica/finance/api/pojo/request/CurrencyRequest.java
+    ├── pageNo: Long (分页页码，从0开始)
+    ├── pageSize: Long (分页大小)
+    ├── currencyCode: String (币种编码，如 CNY, USD)
+    ├── currencyName: String (币种名称)
+    └── statusFlag: Integer (状态：1=启用，2=禁用)
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-finance/finance-api/src/main/java/com/newpeak/liberica/finance/api/pojo/response/CurrencyResponse.java
+    ├── currencyId: String
+    ├── currencyCode: String (3位编码，如 CNY)
+    ├── currencyName: String (币种名称)
+    ├── currencySign: String (符号，如 ¥)
+    ├── statusFlag: Integer (1=启用，2=禁用)
+    ├── createTime: String
+    └── updateTime: String
+```
+
+### 分页包装器
+```
+cn.stylefeng.roses.kernel.db.api.pojo.page.PageResult
+    ├── totalRows: long
+    ├── pageSize: long
+    ├── pageNo: long
+    └── rows: List<CurrencyResponse>
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica currency list [options]
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --page | -p | number | ⬜ | 1 | 页码（从1开始） | pageNo (转换：CLI页码-1) |
+| --size | -s | number | ⬜ | 20 | 每页条数 | pageSize |
+| --status | — | string | ⬜ | - | 状态：enable/disable | statusFlag (enable=1, disable=2) |
+| --code | -c | string | ⬜ | - | 币种编码（3位） | currencyCode |
+| --name | -n | string | ⬜ | - | 币种名称 | currencyName |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| --page / -p | pageNo | number→Long，CLI页码-1 | >= 1 |
+| --size / -s | pageSize | number→Long | 1-100 |
+| --status | statusFlag | string→Integer | enable=1, disable=2 |
+| --code / -c | currencyCode | string→String | 3位字母 |
+| --name / -n | currencyName | string→String | - |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-finance/finance-api/src/main/java/com/newpeak/liberica/finance/api/exception/enums/CurrencyExceptionEnum.java
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| CURRENCY_NOT_EXIST | 币种不存在 | 查询/编辑/删除时ID不存在 |
+| CURRENCY_CODE_DUPLICATE | 币种编码重复 | 创建/编辑时编码已存在 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| 注解 | 无需权限 | 登录用户可访问 |
+
+## 2.7 实现要点
+
+1. **分页默认值**：page=1, size=20
+2. **分页转换**：CLI使用1-based页码，API使用0-based页码（调用时需减1）
+3. **编码格式**：currencyCode 为3位字母编码（ISO 4217标准，如 CNY, USD, EUR）
+4. **状态映射**：CLI参数 `enable`/`disable` 映射到 API 值 `1`/`2`
+5. **无结果处理**：返回空列表，不抛出异常
+6. **tenantId来源**：来自 JWT token（无需 X-TENANT-ID header）
+7. **输出格式**：表格形式展示，分页信息在底部显示
+8. **API路径**：GET `/api/enterprise/finance/currency/page`
+
+## 2.8 示例用法
+
+```bash
+# 默认分页
+barista liberica currency list
+
+# 指定页码和每页条数
+barista liberica currency list --page 2 --size 50
+
+# 按状态筛选
+barista liberica currency list --status enable
+
+# 按编码筛选
+barista liberica currency list --code "CNY"
+
+# 按名称搜索
+barista liberica currency list --name "人民币"
+
+# 组合筛选
+barista liberica currency list --page 1 --size 10 --status enable --code "CNY"
+
+# JSON 输出（便于脚本处理）
+barista liberica currency list --page 1 --size 20 --json
+```

package/docs/commands/liberica/currency/update.md

@@ -0,0 +1,141 @@
+# barista liberica currency update
+
+更新币种信息。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica currency update <currency-id>` |
+| 功能描述 | 更新币种信息 |
+| HTTP方法 | POST |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ✅ 是 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/finance/
+        └── FinanceCurrencyController.java
+            └── editCurrency(@PostResource(path = "/edit"))
+                └── public ResponseData<CurrencyResponse> editCurrency(
+                        @RequestBody @Validated CurrencyRequest request
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-finance/finance-api/src/main/java/com/newpeak/liberica/finance/api/pojo/request/CurrencyRequest.java
+    ├── currencyId: String (@NotBlank)
+    ├── currencyCode: String (@NotBlank, 3位编码)
+    ├── currencyName: String (@NotBlank)
+    ├── currencySign: String (符号)
+    └── statusFlag: Integer (1=启用, 2=禁用)
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-finance/finance-api/src/main/java/com/newpeak/liberica/finance/api/pojo/response/CurrencyResponse.java
+    ├── currencyId: String
+    ├── currencyCode: String
+    ├── currencyName: String
+    ├── currencySign: String
+    ├── statusFlag: Integer
+    ├── createTime: String
+    └── updateTime: String
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica currency update <currency-id> [options]
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--dry-run` | boolean | 预览模式 |
+| `--json` | boolean | JSON输出 |
+
+### 位置参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| currency-id | string | ✅ | 币种ID |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --currency-id | -i | string | ⬜ | - | 币种ID（与位置参数互斥） | currencyId |
+| --code | -c | string | ✅ | - | 币种编码（3位） | currencyCode |
+| --name | -n | string | ✅ | - | 币种名称 | currencyName |
+| --sign | -S | string | ⬜ | - | 币种符号 | currencySign |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| currency-id (位置参数) | currencyId | string→String | @NotBlank |
+| --currency-id / -i | currencyId | string→String | @NotBlank |
+| --code / -c | currencyCode | string→String | @NotBlank, 3位字母 |
+| --name / -n | currencyName | string→String | @NotBlank, max=255 |
+| --sign / -S | currencySign | string→String | max=10 |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-finance/finance-api/src/main/java/com/newpeak/liberica/finance/api/exception/enums/CurrencyExceptionEnum.java
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| CURRENCY_NOT_EXIST | 币种不存在 | 币种不存在 |
+| CURRENCY_CODE_DUPLICATE | 币种编码重复 | 编码重复 |
+| CURRENCY_CODE_EMPTY | 币种编码不能为空 | 编码为空 |
+| CURRENCY_NAME_EMPTY | 币种名称不能为空 | 名称为空 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| 注解 | FinanceCurrencyController.java | 需要 `finance_currency:edit` 权限 |
+
+## 2.7 实现要点
+
+1. **ID必填**：currencyId为必填参数（位置参数或 --currency-id 选项）
+2. **必填字段**：currencyCode 和 currencyName 为必填参数（通常需要先获取现有值再修改）
+3. **dry-run 支持**：支持 `--dry-run` 预览模式，显示将要更新的字段变化
+4. **完整更新**：后端可能是完整更新模式，需要提供所有字段值
+5. **建议用法**：先执行 `barista liberica currency get <id>` 获取当前值，再更新指定字段
+6. **API路径**：POST `/api/enterprise/finance/currency/edit`
+7. **成功响应**：返回更新后的币种详情
+
+## 2.8 示例用法
+
+```bash
+# 更新币种（通过位置参数）
+barista liberica currency update "1234567890123456789" --code "CNY" --name "人民币"
+
+# 更新币种（通过选项参数）
+barista liberica currency update --currency-id "1234567890123456789" --code "CNY" --name "人民币"
+barista liberica currency update -i "1234567890123456789" -c "CNY" -n "人民币"
+
+# 更新符号
+barista liberica currency update "1234567890123456789" --code "USD" --name "美元" --sign "$"
+
+# 预览模式（dry-run）
+barista liberica currency update "1234567890123456789" --code "EUR" --name "欧元" --dry-run
+
+# JSON 输出
+barista liberica currency update "1234567890123456789" --code "CNY" --name "人民币" --json
+```

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

@@ -0,0 +1,195 @@
+# barista liberica locations create
+
+Create a new warehouse location.
+
+## 2.1 Command Metadata
+
+| Field | Value |
+|------|-----|
+| Full Command | `barista liberica locations create` |
+| Description | Create a new warehouse location |
+| HTTP Method | POST |
+| Requires Authentication | Yes |
+| Supports Dry-Run | Yes |
+
+## 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
+            └── add(@PostResource(path = "/add", requiredPermission = true, requirePermissionCode = MasterWarehouseLocationPermissionConstants.ADD_MASTER_WAREHOUSE_LOCATION))
+                └── public ResponseData<MasterWarehouseLocationResponse> add(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.add.class) 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 (@NotNull on add)
+            ├── warehouseLocationCode: String (@NotBlank on add, max=255)
+            ├── warehouseLocationName: String (max=255)
+            ├── statusFlag: Integer
+            └── remark: String (max=255)
+```
+
+### 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 create [options]
+```
+
+### Global Options
+| Option | Type | Description |
+|------|------|------|
+| `--env` | string | Target environment (dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | Tenant code |
+| `--dry-run` | boolean | Preview mode (no actual API call) |
+| `--json` | boolean | JSON output |
+
+### Command Options
+| Option | Short | Type | Required | Default | Description | Maps to DTO Field |
+|------|--------|------|------|--------|------|-------------|
+| --warehouse-id | -w | string | Yes | - | Parent warehouse ID | warehouseId |
+| --code | -c | string | Yes | - | Location code | warehouseLocationCode |
+| --name | -n | string | Yes | - | Location name | warehouseLocationName |
+| --status | -s | number | No | 1 | Status (1=enable, 2=disable) | statusFlag |
+| --remark | -r | string | No | - | Remarks | remark |
+
+## 2.4 Field Mapping Table
+
+| CLI Parameter | DTO Field | Type Conversion | Validation Rule |
+|---------|---------|----------|----------|
+| --warehouse-id / -w | warehouseId | string | @NotNull, max=255 |
+| --code / -c | warehouseLocationCode | Direct | @NotBlank, max=255, unique per warehouse |
+| --name / -n | warehouseLocationName | Direct | max=255 |
+| --status / -s | statusFlag | number | 1 or 2 |
+| --remark / -r | remark | Direct | max=255 |
+
+**Auto-Generated Fields:**
+| Field | Value |
+|------|-----|
+| tenantId | From JWT token (do NOT pass X-TENANT-ID header) |
+| statusFlag | Default 1 (enabled) when not provided |
+
+## 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 | Edit/detail with non-existent ID |
+| 01001380002 | Location code format cannot be empty | Auto-generation rule not configured |
+| 01001380003 | Location code format incorrect | Invalid code format pattern |
+
+## 2.6 Permission Check
+
+| Check Item | Location | Description |
+|--------|------|------|
+| PermissionConstants | `MasterWarehouseLocationPermissionConstants.ADD_MASTER_WAREHOUSE_LOCATION` | Controller layer `@PostResource(requirePermissionCode = "ADD_MASTER_WAREHOUSE_LOCATION")` |
+
+## 2.7 Implementation Notes
+
+1. **Required Fields**: `--warehouse-id`, `--code`, and `--name` must be provided.
+2. **Manual Code**: `warehouseLocationCode` is NOT auto-generated. Must be unique within the warehouse.
+3. **Dry-Run Support**: Use `--dry-run` to preview request without calling API.
+4. **Status Default**: `--status` defaults to 1 (enabled).
+5. **No Batch Create**: This command does NOT support batch creation (one location per call). Use `barista liberica locations batch-create` for bulk operations if implemented separately.
+6. **BigInteger IDs**: `warehouseLocationId` and `warehouseId` in response must be parsed as `string` in TypeScript to avoid precision loss.
+
+## 2.8 Example Usage
+
+```bash
+# Create with minimal required fields
+barista liberica locations create \
+  --warehouse-id "1234567890123456789" \
+  --code "A-01-01" \
+  --name "Shelf A-01-01"
+
+# Create with all options
+barista liberica locations create \
+  --warehouse-id "1234567890123456789" \
+  --code "B-02-03" \
+  --name "Bin B-02-03" \
+  --status 1 \
+  --remark "High-priority picking zone"
+
+# Create disabled location
+barista liberica locations create \
+  --warehouse-id "1234567890123456789" \
+  --code "C-99-99" \
+  --name "Reserved" \
+  --status 2
+
+# Dry-run to preview
+barista liberica locations create \
+  --warehouse-id "1234567890123456789" \
+  --code "TEST-01" \
+  --name "Test Location" \
+  --dry-run
+
+# JSON output
+barista liberica locations create \
+  --warehouse-id "1234567890123456789" \
+  --code "D-04-01" \
+  --name "Dock D-04-01" \
+  --json
+```
+
+## 2.9 Request Body Structure
+
+```json
+{
+  "warehouseId": "1234567890123456789",
+  "warehouseLocationCode": "A-01-01",
+  "warehouseLocationName": "Shelf A-01-01",
+  "statusFlag": 1,
+  "remark": "High-priority picking zone"
+}
+```
+
+## 2.10 API Path
+
+```
+POST /api/enterprise/purchases/warehouse/location/add
+```
+
+**Headers:**
+```
+Authorization: <token>  (No "Bearer " prefix)
+Content-Type: application/json
+```
+
+**Note**: Do NOT include `X-TENANT-ID` header. Tenant is extracted from JWT token.

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.