@newpeak/barista-cli 0.1.11 → 0.1.13

package/docs/commands/liberica/uoms/delete.md

@@ -1,119 +0,0 @@
-# barista liberica uoms delete
-
-删除计量单位。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica uoms delete <uom-id>` |
-| 功能描述 | 删除计量单位 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ⬜ 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/sales/
-        └── MasterUomController.java
-            └── deleteUom(@PostResource(path = "/delete"))
-                └── public ResponseData<Void> deleteUom(
-                        @RequestBody MasterUomRequest request
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/pojo/request/MasterUomRequest.java
-- 删除请求使用：{ uomId: String }
-```
-
-### Response DTO位置
-```
-- 返回 void 或成功标记（ResponseData<Void>）
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica uoms delete <uom-id> [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| uom-id | string | ✅ | 计量单位ID |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --uom-id | -i | string | ⬜ | - | 计量单位ID（与位置参数互斥） | uomId |
-| --force | -f | boolean | ⬜ | false | 强制删除，跳过确认提示 | - |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| uom-id (位置参数) | uomId | string→String | @NotBlank |
-| --uom-id / -i | uomId | string→String | @NotBlank |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/exception/enums/MasterUomExceptionEnum.java
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| UOM_NOT_EXIST | 计量单位不存在 | UOM不存在 |
-| UOM_IN_USE | 计量单位已被使用，无法删除 | UOM已被使用，无法删除 |
-| UOM_NO_PERMISSION | 无权限删除 | 无权限删除 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | MasterUomController.java | 需要 `master_uom:remove` 权限 |
-
-## 2.7 实现要点
-
-1. **ID必填**：uomId为必填参数（位置参数或 --uom-id 选项）
-2. **确认提示**：默认会显示确认提示，需要用户确认（除非使用 --force）
-3. **强制删除**：使用 `--force` 或 `-f` 跳过确认提示
-4. **依赖检查**：后端可能会检查UOM是否被物料或其他数据引用
-5. **不可恢复**：删除操作不可逆，需谨慎操作
-6. **API路径**：POST `/api/enterprise/sales/uom/delete`
-7. **批量删除**：未来可能支持批量删除（通过逗号分隔的ID列表）
-
-## 2.8 示例用法
-
-```bash
-# 删除计量单位（带确认提示）
-barista liberica uoms delete "1234567890123456789"
-
-# 通过选项参数删除
-barista liberica uoms delete --uom-id "1234567890123456789"
-barista liberica uoms delete -i "1234567890123456789"
-
-# 强制删除（跳过确认）
-barista liberica uoms delete "1234567890123456789" --force
-barista liberica uoms delete "1234567890123456789" -f
-
-# JSON 输出
-barista liberica uoms delete "1234567890123456789" --force --json
-```

package/docs/commands/liberica/uoms/disable.md

@@ -1,117 +0,0 @@
-# barista liberica uoms disable
-
-禁用计量单位（批量）。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica uoms disable <uom-id...>` |
-| 功能描述 | 禁用一个或多个计量单位 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ⬜ 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/sales/
-        └── MasterUomController.java
-            └── disableUom(@PostResource(path = "/batchDeActive"))
-                └── public ResponseData<Void> disableUom(
-                        @RequestBody Map<String, List<String>> request
-                    )
-```
-
-### Request DTO位置
-```
-- 批量禁用请求：{ uomIdList: List<String> }
-```
-
-### Response DTO位置
-```
-- 返回 void 或成功标记（ResponseData<Void>）
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica uoms disable <uom-id...> [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| uom-id... | string | ✅ | 一个或多个计量单位ID |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --uom-id | -i | string | ⬜ | - | 计量单位ID（逗号分隔，与位置参数互斥） | uomIdList |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| uom-id... (位置参数) | uomIdList | string[]→List<String> | 至少一个ID |
-| --uom-id / -i | uomIdList | string→List<String> | 逗号分隔 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/exception/enums/MasterUomExceptionEnum.java
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| UOM_NOT_EXIST | 计量单位不存在 | UOM不存在 |
-| UOM_IN_USE | 计量单位已被使用，无法禁用 | UOM已被使用，无法禁用 |
-| UOM_NO_PERMISSION | 无权限操作 | 无权限操作 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | MasterUomController.java | 需要 `master_uom:edit` 权限 |
-
-## 2.7 实现要点
-
-1. **批量支持**：支持单个ID或多个ID（空格分隔）
-2. **ID来源**：可通过位置参数或 --uom-id 选项传递
-3. **逗号分隔**：--uom-id 选项支持逗号分隔的多个ID
-4. **状态变更**：将 statusFlag 从 1（启用）改为 2（禁用）
-5. **依赖检查**：后端可能会检查UOM是否被物料或其他数据引用
-6. **部分失败**：如果某些ID不存在，后端可能返回错误或仅处理存在的ID
-7. **API路径**：POST `/api/enterprise/sales/uom/batchDeActive`
-8. **请求格式**：{ uomIdList: ["id1", "id2", ...] }
-
-## 2.8 示例用法
-
-```bash
-# 禁用单个计量单位
-barista liberica uoms disable "1234567890123456789"
-
-# 禁用多个计量单位
-barista liberica uoms disable "1234567890123456789" "9876543210987654321"
-
-# 通过选项参数禁用（逗号分隔）
-barista liberica uoms disable --uom-id "1234567890123456789,9876543210987654321"
-barista liberica uoms disable -i "1234567890123456789,9876543210987654321"
-
-# JSON 输出
-barista liberica uoms disable "1234567890123456789" --json
-```

package/docs/commands/liberica/uoms/enable.md

@@ -1,115 +0,0 @@
-# barista liberica uoms enable
-
-启用计量单位（批量）。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica uoms enable <uom-id...>` |
-| 功能描述 | 启用一个或多个计量单位 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ⬜ 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/sales/
-        └── MasterUomController.java
-            └── enableUom(@PostResource(path = "/batchActive"))
-                └── public ResponseData<Void> enableUom(
-                        @RequestBody Map<String, List<String>> request
-                    )
-```
-
-### Request DTO位置
-```
-- 批量启用请求：{ uomIdList: List<String> }
-```
-
-### Response DTO位置
-```
-- 返回 void 或成功标记（ResponseData<Void>）
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica uoms enable <uom-id...> [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| uom-id... | string | ✅ | 一个或多个计量单位ID |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --uom-id | -i | string | ⬜ | - | 计量单位ID（逗号分隔，与位置参数互斥） | uomIdList |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| uom-id... (位置参数) | uomIdList | string[]→List<String> | 至少一个ID |
-| --uom-id / -i | uomIdList | string→List<String> | 逗号分隔 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/exception/enums/MasterUomExceptionEnum.java
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| UOM_NOT_EXIST | 计量单位不存在 | UOM不存在 |
-| UOM_NO_PERMISSION | 无权限操作 | 无权限操作 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | MasterUomController.java | 需要 `master_uom:edit` 权限 |
-
-## 2.7 实现要点
-
-1. **批量支持**：支持单个ID或多个ID（空格分隔）
-2. **ID来源**：可通过位置参数或 --uom-id 选项传递
-3. **逗号分隔**：--uom-id 选项支持逗号分隔的多个ID
-4. **状态变更**：将 statusFlag 从 2（禁用）改为 1（启用）
-5. **部分失败**：如果某些ID不存在，后端可能返回错误或仅处理存在的ID
-6. **API路径**：POST `/api/enterprise/sales/uom/batchActive`
-7. **请求格式**：{ uomIdList: ["id1", "id2", ...] }
-
-## 2.8 示例用法
-
-```bash
-# 启用单个计量单位
-barista liberica uoms enable "1234567890123456789"
-
-# 启用多个计量单位
-barista liberica uoms enable "1234567890123456789" "9876543210987654321"
-
-# 通过选项参数启用（逗号分隔）
-barista liberica uoms enable --uom-id "1234567890123456789,9876543210987654321"
-barista liberica uoms enable -i "1234567890123456789,9876543210987654321"
-
-# JSON 输出
-barista liberica uoms enable "1234567890123456789" --json
-```

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

@@ -1,119 +0,0 @@
-# barista liberica uoms get
-
-获取单个计量单位详情。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica uoms get <uom-id>` |
-| 功能描述 | 获取计量单位详情 |
-| HTTP方法 | GET |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ⬜ 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/sales/
-        └── MasterUomController.java
-            └── getUom(@GetResource(path = "/detail"))
-                └── public ResponseData<MasterUomResponse> getUom(
-                        @RequestParam String uomId
-                    )
-```
-
-### Request DTO位置
-```
-[无Request DTO]
-- uomId通过@RequestParam传递
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/pojo/response/MasterUomResponse.java
-    ├── uomId: String
-    ├── uomCode: String
-    ├── uomName: String
-    ├── uomFractionPlaces: Integer
-    ├── statusFlag: Integer (1=启用，2=禁用)
-    ├── remark: String
-    ├── createTime: String
-    └── updateTime: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica uoms get <uom-id> [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| uom-id | string | ✅ | 计量单位ID |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --uom-id | -i | string | ⬜ | - | 计量单位ID（与位置参数互斥） | uomId |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| uom-id (位置参数) | uomId | string→String | @NotBlank |
-| --uom-id / -i | uomId | string→String | @NotBlank |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/exception/enums/MasterUomExceptionEnum.java
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| UOM_NOT_EXIST | 计量单位不存在 | ID不存在 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | 无需权限 | 登录用户可访问 |
-
-## 2.7 实现要点
-
-1. **参数解析**：支持位置参数 `<uom-id>` 和选项参数 `--uom-id`
-2. **ID必填**：uomId为必填参数
-3. **输出格式**：格式化展示UOM详情，包括基本信息和状态
-4. **错误处理**：UOM不存在时显示友好错误提示
-5. **API路径**：GET `/api/enterprise/sales/uom/detail`
-
-## 2.8 示例用法
-
-```bash
-# 通过位置参数获取
-barista liberica uoms get "1234567890123456789"
-
-# 通过选项参数获取
-barista liberica uoms get --uom-id "1234567890123456789"
-barista liberica uoms get -i "1234567890123456789"
-
-# JSON 输出
-barista liberica uoms get "1234567890123456789" --json
-```

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

@@ -1,155 +0,0 @@
-# barista liberica uoms list
-
-分页查询计量单位列表。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica uoms list` |
-| 功能描述 | 分页查询计量单位列表 |
-| HTTP方法 | GET |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ⬜ 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/sales/
-        └── MasterUomController.java
-            └── listUoms(@GetResource(path = "/page"))
-                └── public ResponseData<PageResult<MasterUomResponse>> listUoms(
-                        @ParameterObject MasterUomRequest request
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/pojo/request/MasterUomRequest.java
-    ├── pageNo: Long (分页页码，从0开始)
-    ├── pageSize: Long (分页大小)
-    ├── uomCode: String (计量单位编码)
-    ├── uomName: String (计量单位名称)
-    └── statusFlag: Integer (状态：1=启用，2=禁用)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/pojo/response/MasterUomResponse.java
-    ├── uomId: String
-    ├── uomCode: String
-    ├── uomName: String
-    ├── uomFractionPlaces: Integer
-    ├── statusFlag: Integer (1=启用，2=禁用)
-    ├── remark: String
-    ├── createTime: String
-    └── updateTime: String
-```
-
-### 分页包装器
-```
-cn.stylefeng.roses.kernel.db.api.pojo.page.PageResult
-    ├── totalRows: long
-    ├── pageSize: long
-    ├── pageNo: long
-    └── rows: List<MasterUomResponse>
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica uoms 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 | ⬜ | - | 计量单位编码 | uomCode |
-| --name | -n | string | ⬜ | - | 计量单位名称 | uomName |
-| --keyword | -k | string | ⬜ | - | 搜索关键词（编码/名称） | uomCode/uomName |
-
-## 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 | uomCode | string→String | - |
-| --name / -n | uomName | string→String | - |
-| --keyword / -k | uomCode/uomName | string→String | 模糊查询 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/exception/enums/MasterUomExceptionEnum.java
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| UOM_NOT_EXIST | 计量单位不存在 | 查询/编辑/删除时ID不存在 |
-| UOM_CODE_DUPLICATE | 计量单位编码重复 | 创建/编辑时编码已存在 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | 无需权限 | 登录用户可访问 |
-
-## 2.7 实现要点
-
-1. **分页默认值**：page=1, size=20
-2. **分页转换**：CLI使用1-based页码，API使用0-based页码（调用时需减1）
-3. **搜索行为**：keyword 同时匹配 uomCode 和 uomName（模糊查询）
-4. **状态映射**：CLI参数 `enable`/`disable` 映射到 API 值 `1`/`2`
-5. **无结果处理**：返回空列表，不抛出异常
-6. **tenantId来源**：来自 JWT token（无需 X-TENANT-ID header）
-7. **输出格式**：表格形式展示，分页信息在底部显示
-8. **API路径**：GET `/api/enterprise/sales/uom/page`
-
-## 2.8 示例用法
-
-```bash
-# 默认分页
-barista liberica uoms list
-
-# 指定页码和每页条数
-barista liberica uoms list --page 2 --size 50
-
-# 按状态筛选
-barista liberica uoms list --status enable
-
-# 按编码筛选
-barista liberica uoms list --code "kg"
-
-# 按名称搜索
-barista liberica uoms list --name "千克"
-
-# 关键词搜索
-barista liberica uoms list --keyword "克"
-
-# 组合筛选
-barista liberica uoms list --page 1 --size 10 --status enable --keyword "kg"
-
-# JSON 输出（便于脚本处理）
-barista liberica uoms list --page 1 --size 20 --json
-```