@newpeak/barista-cli 0.1.10 → 0.1.12

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

@@ -1,121 +0,0 @@
-# barista liberica currency delete
-
-删除币种。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica currency delete <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
-            └── deleteCurrency(@PostResource(path = "/delete"))
-                └── public ResponseData<Void> deleteCurrency(
-                        @RequestBody 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 }
-```
-
-### Response DTO位置
-```
-- 返回 void 或成功标记（ResponseData<Void>）
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica currency delete <currency-id> [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| currency-id | string | ✅ | 币种ID |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --currency-id | -i | string | ⬜ | - | 币种ID（与位置参数互斥） | currencyId |
-| --force | -f | boolean | ⬜ | false | 强制删除，跳过确认提示 | - |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| currency-id (位置参数) | currencyId | string→String | @NotBlank |
-| --currency-id / -i | currencyId | string→String | @NotBlank |
-
-## 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_IN_USE | 币种已被使用，无法删除 | 币种已被财务单据引用 |
-| CURRENCY_NO_PERMISSION | 无权限删除 | 无权限删除 |
-| CURRENCY_CANNOT_DELETE_BASE | 基础币种不能删除 | 系统预设币种无法删除 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | FinanceCurrencyController.java | 需要 `finance_currency:remove` 权限 |
-
-## 2.7 实现要点
-
-1. **ID必填**：currencyId为必填参数（位置参数或 --currency-id 选项）
-2. **确认提示**：默认会显示确认提示，需要用户确认（除非使用 --force）
-3. **强制删除**：使用 `--force` 或 `-f` 跳过确认提示
-4. **依赖检查**：后端可能会检查币种是否被财务单据引用
-5. **基础币种保护**：系统预设币种（如 CNY）可能无法删除
-6. **不可恢复**：删除操作不可逆，需谨慎操作
-7. **API路径**：POST `/api/enterprise/finance/currency/delete`
-8. **批量删除**：未来可能支持批量删除（通过逗号分隔的ID列表）
-
-## 2.8 示例用法
-
-```bash
-# 删除币种（带确认提示）
-barista liberica currency delete "1234567890123456789"
-
-# 通过选项参数删除
-barista liberica currency delete --currency-id "1234567890123456789"
-barista liberica currency delete -i "1234567890123456789"
-
-# 强制删除（跳过确认）
-barista liberica currency delete "1234567890123456789" --force
-barista liberica currency delete "1234567890123456789" -f
-
-# JSON 输出
-barista liberica currency delete "1234567890123456789" --force --json
-```

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

@@ -1,119 +0,0 @@
-# barista liberica currency disable
-
-禁用币种（批量）。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica currency disable <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
-            └── batchDeActive(@PostResource(path = "/batchDeActive"))
-                └── public ResponseData<Void> batchDeActive(
-                        @RequestBody Map<String, List<String>> request
-                    )
-```
-
-### Request DTO位置
-```
-- 批量禁用请求：{ currencyIdList: List<String> }
-```
-
-### Response DTO位置
-```
-- 返回 void 或成功标记（ResponseData<Void>）
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica currency disable <currency-id...> [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| currency-id... | string | ✅ | 一个或多个币种ID |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --currency-id | -i | string | ⬜ | - | 币种ID（逗号分隔，与位置参数互斥） | currencyIdList |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| currency-id... (位置参数) | currencyIdList | string[]→List<String> | 至少一个ID |
-| --currency-id / -i | currencyIdList | string→List<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 | 币种不存在 | 币种不存在 |
-| CURRENCY_IN_USE | 币种已被使用，无法禁用 | 币种已被财务单据引用 |
-| CURRENCY_NO_PERMISSION | 无权限操作 | 无权限操作 |
-| CURRENCY_CANNOT_DISABLE_BASE | 基础币种不能禁用 | 系统预设币种无法禁用 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | FinanceCurrencyController.java | 需要 `finance_currency:edit` 权限 |
-
-## 2.7 实现要点
-
-1. **批量支持**：支持单个ID或多个ID（空格分隔）
-2. **ID来源**：可通过位置参数或 --currency-id 选项传递
-3. **逗号分隔**：--currency-id 选项支持逗号分隔的多个ID
-4. **状态变更**：将 statusFlag 从 1（启用）改为 2（禁用）
-5. **依赖检查**：后端可能会检查币种是否被财务单据引用
-6. **基础币种保护**：系统预设币种（如 CNY）可能无法禁用
-7. **部分失败**：如果某些ID不存在，后端可能返回错误或仅处理存在的ID
-8. **API路径**：POST `/api/enterprise/finance/currency/batchDeActive`
-9. **请求格式**：{ currencyIdList: ["id1", "id2", ...] }
-
-## 2.8 示例用法
-
-```bash
-# 禁用单个币种
-barista liberica currency disable "1234567890123456789"
-
-# 禁用多个币种
-barista liberica currency disable "1234567890123456789" "9876543210987654321"
-
-# 通过选项参数禁用（逗号分隔）
-barista liberica currency disable --currency-id "1234567890123456789,9876543210987654321"
-barista liberica currency disable -i "1234567890123456789,9876543210987654321"
-
-# JSON 输出
-barista liberica currency disable "1234567890123456789" --json
-```

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

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

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

@@ -1,118 +0,0 @@
-# barista liberica currency get
-
-获取单个币种详情。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica currency get <currency-id>` |
-| 功能描述 | 获取币种详情 |
-| 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
-            └── getCurrency(@GetResource(path = "/detail"))
-                └── public ResponseData<CurrencyResponse> getCurrency(
-                        @RequestParam String currencyId
-                    )
-```
-
-### Request DTO位置
-```
-[无Request DTO]
-- currencyId通过@RequestParam传递
-```
-
-### 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
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica currency get <currency-id> [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| currency-id | string | ✅ | 币种ID |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --currency-id | -i | string | ⬜ | - | 币种ID（与位置参数互斥） | currencyId |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| currency-id (位置参数) | currencyId | string→String | @NotBlank |
-| --currency-id / -i | currencyId | string→String | @NotBlank |
-
-## 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不存在 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | 无需权限 | 登录用户可访问 |
-
-## 2.7 实现要点
-
-1. **参数解析**：支持位置参数 `<currency-id>` 和选项参数 `--currency-id`
-2. **ID必填**：currencyId为必填参数
-3. **输出格式**：格式化展示币种详情，包括基本信息和状态
-4. **错误处理**：币种不存在时显示友好错误提示
-5. **API路径**：GET `/api/enterprise/finance/currency/detail`
-
-## 2.8 示例用法
-
-```bash
-# 通过位置参数获取
-barista liberica currency get "1234567890123456789"
-
-# 通过选项参数获取
-barista liberica currency get --currency-id "1234567890123456789"
-barista liberica currency get -i "1234567890123456789"
-
-# JSON 输出
-barista liberica currency get "1234567890123456789" --json
-```

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

@@ -1,149 +0,0 @@
-# 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
-```