@newpeak/barista-cli 0.1.11 → 0.1.12

package/docs/commands/liberica/employees/get.md

@@ -1,153 +0,0 @@
-# barista liberica employees get
-
-获取单个员工详情。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica employees get <id>` |
-| 功能描述 | 获取单个员工详情 |
-| HTTP方法 | GET |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ⬜ 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/master/
-        └── EnterpriseEmployeeController.java
-            └── detail(@GetResource(path = "/detail"))
-                └── public ResponseData<MasterEmployeeResponse> detail(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestParam("employeeId") Long employeeId
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/pojo/request/
-        └── MasterEmployeeRequest.java
-            └── employeeId: Long (@NotNull on detail)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/pojo/response/
-        └── MasterEmployeeResponse.java
-            ├── employeeId: Long
-            ├── employeeCode: String
-            ├── employeeName: String
-            ├── employeeNo: String
-            ├── employeePhone: String
-            ├── employeeEmail: String
-            ├── employeeSex: SexEnum
-            ├── employeeIdType: String
-            ├── employeeIdNo: String
-            ├── employeeJoinedDate: Date
-            ├── employeeLeaveDate: Date
-            ├── employeeBirthday: Date
-            ├── organizationId: Long
-            ├── orgCode: String
-            ├── orgName: String
-            ├── organizationManagerFlag: String
-            ├── positionId: String
-            ├── positionName: String
-            ├── jobType: String
-            ├── jobLevelNo: String
-            ├── evaluator1: String (员工编码)
-            ├── evaluator2: String (员工编码)
-            ├── coach: String (员工编码)
-            ├── employeeStatus: String
-            ├── statusFlag: Integer (1=enable, 2=disable)
-            ├── employeeBankAccount: String
-            ├── employeeDepositBank: String
-            ├── account: String
-            ├── encryptPassword: String
-            ├── showQrCode: boolean
-            ├── qrCode: String (SVG)
-            ├── createTime: String
-            └── updateTime: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica employees get <id> [options]
-```
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| id | number | ✅ | 员工ID (employeeId) |
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 |
-|------|--------|------|------|--------|------|
-| — | — | — | — | — | 此命令无额外选项，ID 通过位置参数传入 |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| <id> (位置参数) | employeeId | string→Long | @NotNull, 必须为正整数 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/exception/enums/
-        └── EmployeeExceptionEnum.java
-            ├── MASTER_EMPLOYEE_NOT_EXISTED("01001150001", "查询结果不存在")
-            ├── MASTER_EMPLOYEE_CODE_VALIDATE_NOT_EXIST_ERROR("01001150007", "指定{}不存在")
-            └── MASTER_EMPLOYEE_NAME_VALIDATE_NOT_EXIST_ERROR("01001150009", "指定{}不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001150001 | 查询结果不存在 | employeeId 不存在或不属于当前租户 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | `@GetResource(path = "/detail")` | 无 requiredPermission |
-
-## 2.7 实现要点
-
-1. **位置参数**：`get` 命令使用 `<id>` 位置参数指定员工ID
-2. **错误处理**：员工不存在时抛出 `MASTER_EMPLOYEE_NOT_EXISTED`，CLI 显示友好错误信息
-3. **tenantId来源**：来自 X-TENANT-ID header，后端自动按租户隔离数据
-4. **QR Code**：响应中包含 qrCode (SVG)，可在需要时通过 --json 输出展示
-
-## 2.8 示例用法
-
-```bash
-# 获取员工详情
-barista liberica employees get 12345
-
-# JSON 输出
-barista liberica employees get 12345 --json
-
-# 员工不存在
-barista liberica employees get 99999
-# 输出: Error: 员工不存在 (01001150001)
-```

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

@@ -1,168 +0,0 @@
-# barista liberica employees list
-
-分页查询员工列表。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica employees 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/
-        └── EnterpriseEmployeeController.java
-            └── page(@GetResource(path = "/page"))
-                └── public ResponseData<PageResult<MasterEmployeeResponse>> page(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        MasterEmployeeRequest request
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/pojo/request/
-        └── MasterEmployeeRequest.java
-            ├── current: Long (分页当前页)
-            ├── size: Long (分页大小)
-            ├── searchText: String (搜索: 姓名/编码)
-            ├── employeeStatus: String (在职状态)
-            ├── organizationId: Long (部门ID)
-            ├── excludeEmployeeCodeList: Set<String>
-            ├── excludeEmployeeIdList: Set<Long>
-            ├── searchBeginTime: String
-            └── searchEndTime: String
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/pojo/response/
-        └── MasterEmployeeResponse.java
-            ├── employeeId: Long
-            ├── employeeCode: String
-            ├── employeeName: String
-            ├── employeeNo: String
-            ├── employeePhone: String
-            ├── employeeEmail: String
-            ├── employeeSex: SexEnum
-            ├── organizationId: Long
-            ├── orgName: String
-            ├── positionId: String
-            ├── positionName: String
-            ├── statusFlag: Integer (1=enable, 2=disable)
-            ├── createTime: String
-            └── updateTime: String
-```
-
-### 分页包装器
-```
-cn.stylefeng.roses.kernel.db.api.pojo.page.PageResult
-    ├── total: long
-    ├── size: long
-    ├── current: long
-    └── records: List<MasterEmployeeResponse>
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica employees list [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --page | -p | number | ⬜ | 1 | 页码 | current |
-| --size | -s | number | ⬜ | 20 | 每页条数 | size |
-| --status | — | string | ⬜ | - | 在职状态 | employeeStatus |
-| --org-id | — | number | ⬜ | - | 部门ID | organizationId |
-| --search | — | string | ⬜ | - | 搜索关键词(姓名/编码) | searchText |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| --page / -p | current | number→Long | >= 1 |
-| --size / -s | size | number→Long | 1-100 |
-| --status | employeeStatus | 直接传递 | 枚举验证 |
-| --org-id | organizationId | string→Long | - |
-| --search | searchText | 直接传递 | - |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/exception/enums/
-        └── EmployeeExceptionEnum.java
-            ├── MASTER_EMPLOYEE_NOT_EXISTED("01001150001", "查询结果不存在")
-            ├── MASTER_EMPLOYEE_NAME_VALIDATE_NOT_EXIST_ERROR("01001150009", "指定{}不存在")
-            └── MASTER_EMPLOYEE_IMPORT_DATA_EMPTY("01001150010", "职员导入数据为空")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001150001 | 查询结果不存在 | 条件查询无匹配结果（通常返回空列表而非报错） |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | `@GetResource(path = "/page")` | 无 requiredPermission（无需权限码） |
-
-**注意**：list 和 page 接口在 Controller 层无需权限校验，数据范围通过 tenantId 隔离。
-
-## 2.7 实现要点
-
-1. **分页默认值**：page=1, size=20
-2. **搜索行为**：searchText 同时匹配 employeeName 和 employeeCode（模糊查询）
-3. **无结果处理**：返回空列表，不抛出异常
-4. **tenantId来源**：来自 X-TENANT-ID header
-5. **输出格式**：表格形式展示，分页信息在底部显示
-
-## 2.8 示例用法
-
-```bash
-# 默认分页
-barista liberica employees list
-
-# 指定页码和每页条数
-barista liberica employees list --page 2 --size 50
-
-# 按部门筛选
-barista liberica employees list --org-id 1001
-
-# 按在职状态筛选
-barista liberica employees list --status IN_SERVICE
-
-# 关键词搜索
-barista liberica employees list --search "张三"
-
-# 组合筛选
-barista liberica employees list --page 1 --size 10 --org-id 1001 --status IN_SERVICE
-
-# JSON 输出（便于脚本处理）
-barista liberica employees list --page 1 --size 20 --json
-```

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

@@ -1,180 +0,0 @@
-# barista liberica employees update
-
-更新员工信息。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica employees update <id>` |
-| 功能描述 | 更新员工信息 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/master/
-        └── EnterpriseEmployeeController.java
-            └── edit(@PostResource(path = "/edit", requiredPermission = true, requirePermissionCode = "EDIT_EMPLOYEE"))
-                └── public ResponseData<MasterEmployeeResponse> edit(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.edit.class) MasterEmployeeRequest request
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/pojo/request/
-        └── MasterEmployeeRequest.java
-            ├── employeeId: Long (@NotNull on edit) — 必须提供
-            ├── employeeCode: String (@NotBlank on edit)
-            ├── employeeName: String
-            ├── employeePhone: String
-            ├── employeeEmail: String
-            ├── employeeSex: SexEnum
-            ├── employeeIdType: String
-            ├── employeeIdNo: String
-            ├── employeeJoinedDate: Date
-            ├── employeeBirthday: Date
-            ├── organizationId: Long
-            ├── organizationManagerFlag: String
-            ├── positionId: String
-            ├── jobType: String
-            ├── jobLevelNo: Integer
-            ├── evaluator1: String
-            ├── evaluator2: String
-            ├── coach: String
-            ├── employeeBankAccount: String
-            └── employeeDepositBank: String
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/pojo/response/
-        └── MasterEmployeeResponse.java
-            ├── employeeId: Long
-            ├── employeeCode: String
-            ├── employeeName: String
-            ├── employeeNo: String
-            ├── employeePhone: String
-            ├── employeeEmail: String
-            ├── employeeSex: SexEnum
-            ├── organizationId: Long
-            ├── orgName: String
-            ├── positionId: String
-            ├── positionName: String
-            ├── statusFlag: Integer (1=enable, 2=disable)
-            ├── createTime: String
-            └── updateTime: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica employees update <id> [options]
-```
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| id | number | ✅ | 员工ID (employeeId) |
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --name | -n | string | ⬜ | - | 员工姓名 | employeeName |
-| --phone | -p | string | ⬜ | - | 手机号码 | employeePhone |
-| --email | -e | string | ⬜ | - | 电子邮箱 | employeeEmail |
-| --sex | -s | string | ⬜ | - | 性别 (M/F) | employeeSex |
-| --position-id | — | string | ⬜ | - | 岗位ID | positionId |
-| --joined-date | -d | string | ⬜ | - | 入职日期 (YYYY-MM-DD) | employeeJoinedDate |
-| --org-id | — | number | ⬜ | - | 部门ID | organizationId |
-
-**注意**：员工ID(employeeId)为必填，通过位置参数 `<id>` 传入。更新操作只发送变更的字段（部分更新）。
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| <id> (位置参数) | employeeId | string→Long | @NotNull |
-| --name / -n | employeeName | 直接传递 | max=255 |
-| --phone / -p | employeePhone | 直接传递 | 手机号格式 |
-| --email / -e | employeeEmail | 直接传递 | 邮箱格式 |
-| --sex / -s | employeeSex | 直接传递 | M 或 F |
-| --position-id | positionId | 直接传递 | - |
-| --joined-date / -d | employeeJoinedDate | string→Date | yyyy-MM-dd |
-| --org-id | organizationId | string→Long | - |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/exception/enums/
-        └── EmployeeExceptionEnum.java
-            ├── MASTER_EMPLOYEE_NOT_EXISTED("01001150001", "查询结果不存在")
-            ├── MASTER_EMPLOYEE_CODE_VALIDATE_NOT_EXIST_ERROR("01001150007", "指定{}不存在")
-            └── MASTER_EMPLOYEE_NAME_VALIDATE_NOT_EXIST_ERROR("01001150009", "指定{}不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001150001 | 查询结果不存在 | employeeId 不存在或不属于当前租户 |
-| 01001150007 | 指定xxx不存在 | 指定关联的员工编码不存在 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `LibericaPermissionCodeConstants.EDIT_EMPLOYEE` | Controller层 `@PostResource(requirePermissionCode = "EDIT_EMPLOYEE")` |
-
-## 2.7 实现要点
-
-1. **部分更新**：只发送需要更新的字段，未提供的字段保持原值
-2. **必填位置参数**：`<id>` 必须指定，后端根据此ID定位记录
-3. **Dry-run支持**：使用 --dry-run 时构造请求体但不发送，显示预览信息
-4. **后端无预检**：edit() 方法直接调用 `updateById()`，不检查员工是否存在（由DB约束保证）
-
-## 2.8 示例用法
-
-```bash
-# 更新员工姓名
-barista liberica employees update 12345 --name "李四"
-
-# 更新多个字段
-barista liberica employees update 12345 \
-  --name "李四" \
-  --phone "13900139000" \
-  --email "lisi@example.com" \
-  --position-id "SENIOR_ENGINEER"
-
-# Dry-run 预览
-barista liberica employees update 12345 --name "李四" --dry-run
-
-# JSON 输出
-barista liberica employees update 12345 --name "李四" --json
-
-# 员工不存在
-barista liberica employees update 99999 --name "测试"
-# 输出: Error: 员工不存在 (01001150001)
-```

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

@@ -1,195 +0,0 @@
-# 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.