@newpeak/barista-cli 0.1.10 → 0.1.12

package/docs/commands/liberica/client-contacts/get.md

@@ -1,133 +0,0 @@
-# barista liberica client-contacts get
-
-获取单个客户联系人详情。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica client-contacts get <contact-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/
-        └── EnterpriseClientContactController.java
-            └── detail(@GetResource(path = "/detail"))
-                └── public ResponseData<MasterClientContactResponse> detail(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        MasterClientContactRequest masterClientContactRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-sales/sales-api/
-    └── src/main/java/com/newpeak/liberica/sales/api/pojo/request/
-        └── MasterClientContactRequest.java
-            └── clientContactId: Long (@NotNull on detail)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-sales/sales-api/
-    └── src/main/java/com/newpeak/liberica/sales/api/pojo/response/
-        └── MasterClientContactResponse.java
-            ├── clientContactId: Long
-            ├── clientId: Long
-            ├── clientContactName: String
-            ├── clientContactPhone: String
-            ├── clientContactTelephone: String
-            ├── clientContactEmail: String
-            ├── clientContactSex: String
-            ├── clientContactBirthday: Date
-            ├── clientContactQq: String
-            ├── clientContactWechat: String
-            ├── clientContactAddress: String
-            ├── defaultFlag: String (Y/N)
-            ├── remark: String
-            ├── createTime: String
-            └── updateTime: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica client-contacts get <contact-id> [options]
-```
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| contact-id | string | ✅ | 客户联系人ID (clientContactId) |
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 |
-|------|--------|------|------|--------|------|
-| — | — | — | — | — | 此命令无额外选项，ID 通过位置参数传入 |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| <contact-id> (位置参数) | clientContactId | string→Long | @NotNull, 必须为正整数 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-sales/sales-api/
-    └── src/main/java/com/newpeak/liberica/sales/api/pojo/response/
-        └── MasterClientContactResponse.java
-            └── MASTER_CLIENT_CONTACT_NOT_EXIST("01001207001", "租户客户联系人不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001207001 | 租户客户联系人不存在 | contact-id 不存在或不属于当前租户 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | `@GetResource(path = "/detail")` | 无 requiredPermission |
-
-## 2.7 实现要点
-
-1. **位置参数**：`get` 命令使用 `<contact-id>` 位置参数指定联系人ID
-2. **错误处理**：联系人不存在时抛出 `MASTER_CLIENT_CONTACT_NOT_EXIST`，CLI 显示友好错误信息
-3. **tenantId来源**：来自 X-TENANT-ID header，后端自动按租户隔离数据
-4. **输出格式**：表格形式展示联系人详情，或 JSON 格式
-
-## 2.8 示例用法
-
-```bash
-# 获取联系人详情
-barista liberica client-contacts get 12345
-
-# JSON 输出
-barista liberica client-contacts get 12345 --json
-
-# 联系人不存在
-barista liberica client-contacts get 99999
-# 输出: Error: 租户客户联系人不存在 (01001207001)
-```

package/docs/commands/liberica/client-contacts/list.md

@@ -1,143 +0,0 @@
-# barista liberica client-contacts list
-
-查询客户联系人列表。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica client-contacts 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/
-        └── EnterpriseClientContactController.java
-            └── list(@GetResource(path = "/list"))
-                └── public ResponseData<List<MasterClientContactResponse>> list(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        MasterClientContactRequest masterClientContactRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-sales/sales-api/
-    └── src/main/java/com/newpeak/liberica/sales/api/pojo/request/
-        └── MasterClientContactRequest.java
-            ├── clientId: Long (@NotNull)
-            ├── clientContactName: String (搜索关键词)
-            ├── pageNo: Long (分页页码)
-            └── pageSize: Long (分页大小)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-sales/sales-api/
-    └── src/main/java/com/newpeak/liberica/sales/api/pojo/response/
-        └── MasterClientContactResponse.java
-            ├── clientContactId: Long
-            ├── clientId: Long
-            ├── clientContactName: String
-            ├── clientContactPhone: String
-            ├── clientContactTelephone: String
-            ├── clientContactEmail: String
-            ├── clientContactSex: String
-            ├── clientContactBirthday: Date
-            ├── clientContactQq: String
-            ├── clientContactWechat: String
-            ├── clientContactAddress: String
-            ├── defaultFlag: String (Y/N)
-            ├── remark: String
-            ├── createTime: String
-            └── updateTime: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica client-contacts list [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --client-id | -c | string | ✅ | - | 客户ID | clientId |
-| --page | -p | number | ⬜ | 1 | 页码 | pageNo |
-| --size | -s | number | ⬜ | 20 | 每页条数 | pageSize |
-| --search | -S | string | ⬜ | - | 搜索关键词(姓名) | clientContactName |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| --client-id / -c | clientId | string→Long | @NotNull |
-| --page / -p | pageNo | number→Long | >= 1 |
-| --size / -s | pageSize | number→Long | 1-100 |
-| --search / -S | clientContactName | 直接传递 | 模糊查询 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-sales/sales-api/
-    └── src/main/java/com/newpeak/liberica/sales/api/exception/enums/
-        └── MasterClientContactExceptionEnum.java
-            └── MASTER_CLIENT_CONTACT_NOT_EXIST("01001207001", "租户客户联系人不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001207001 | 租户客户联系人不存在 | 客户ID不存在时 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | `@GetResource(path = "/list")` | 无 requiredPermission（无需权限码） |
-
-**注意**：list 接口在 Controller 层无需权限校验，数据范围通过 tenantId 隔离。
-
-## 2.7 实现要点
-
-1. **必填参数**：--client-id 必须指定
-2. **分页默认值**：page=1, size=20
-3. **搜索行为**：clientContactName 支持模糊查询
-4. **无结果处理**：返回空列表，不抛出异常
-5. **tenantId来源**：来自 X-TENANT-ID header
-6. **输出格式**：表格形式展示联系人列表
-
-## 2.8 示例用法
-
-```bash
-# 列出客户的所有联系人
-barista liberica client-contacts list --client-id 12345
-
-# 指定页码和每页条数
-barista liberica client-contacts list --client-id 12345 --page 2 --size 50
-
-# 搜索联系人
-barista liberica client-contacts list --client-id 12345 --search "张"
-
-# JSON 输出（便于脚本处理）
-barista liberica client-contacts list --client-id 12345 --json
-```

package/docs/commands/liberica/client-contacts/update.md

@@ -1,158 +0,0 @@
-# barista liberica client-contacts update
-
-更新客户联系人信息。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica client-contacts update <contact-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/
-        └── EnterpriseClientContactController.java
-            └── edit(@PostResource(path = "/edit", requiredPermission = true, requirePermissionCode = "EDIT_MASTER_CLIENT_CONTACT"))
-                └── public ResponseData<?> edit(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.edit.class) MasterClientContactRequest masterClientContactRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-sales/sales-api/
-    └── src/main/java/com/newpeak/liberica/sales/api/pojo/request/
-        └── MasterClientContactRequest.java
-            ├── clientContactId: Long (@NotNull on edit)
-            ├── clientContactName: String (@NotBlank, max=255)
-            ├── clientContactPhone: String (max=256)
-            ├── clientContactTelephone: String (max=256)
-            ├── clientContactEmail: String (max=512)
-            ├── clientContactSex: String (max=255)
-            ├── clientContactBirthday: Date
-            ├── clientContactQq: String (max=512)
-            ├── clientContactWechat: String (max=512)
-            ├── clientContactAddress: String (max=512)
-            ├── defaultFlag: String (max=1)
-            └── remark: String (max=255)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-sales/sales-api/
-    └── src/main/java/com/newpeak/liberica/sales/api/pojo/response/
-        └── MasterClientContactResponse.java
-            └── (同 get 接口)
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica client-contacts update <contact-id> [options]
-```
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| contact-id | string | ✅ | 客户联系人ID |
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --name | -n | string | ⬜ | - | 姓名 | clientContactName |
-| --phone | -p | string | ⬜ | - | 手机号 | clientContactPhone |
-| --telephone | -t | string | ⬜ | - | 座机号 | clientContactTelephone |
-| --email | -e | string | ⬜ | - | 电子邮箱 | clientContactEmail |
-| --sex | -s | string | ⬜ | - | 性别 | clientContactSex |
-| --birthday | -b | string | ⬜ | - | 生日(YYYY-MM-DD) | clientContactBirthday |
-| --qq | -q | string | ⬜ | - | QQ号 | clientContactQq |
-| --wechat | -w | string | ⬜ | - | 微信号 | clientContactWechat |
-| --address | -a | string | ⬜ | - | 详细地址 | clientContactAddress |
-| --default | -d | boolean | ⬜ | - | 是否默认联系人 | defaultFlag |
-| --remark | -r | string | ⬜ | - | 备注 | remark |
-
-**注意**：所有字段在 update 时都是可选的，至少需要提供一个要更新的字段。
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| <contact-id> | clientContactId | string→Long | @NotNull |
-| --name / -n | clientContactName | 直接传递 | max=255 |
-| --phone / -p | clientContactPhone | 直接传递 | max=256 |
-| --telephone / -t | clientContactTelephone | 直接传递 | max=256 |
-| --email / -e | clientContactEmail | 直接传递 | max=512 |
-| --sex / -s | clientContactSex | 直接传递 | max=255 |
-| --birthday / -b | clientContactBirthday | string→Date | yyyy-MM-dd |
-| --qq / -q | clientContactQq | 直接传递 | max=512 |
-| --wechat / -w | clientContactWechat | 直接传递 | max=512 |
-| --address / -a | clientContactAddress | 直接传递 | max=512 |
-| --default / -d | defaultFlag | boolean→Y/N | max=1 |
-| --remark / -r | remark | 直接传递 | max=255 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-sales/sales-api/
-    └── src/main/java/com/newpeak/liberica/sales/api/exception/enums/
-        └── MasterClientContactExceptionEnum.java
-            └── MASTER_CLIENT_CONTACT_NOT_EXIST("01001207001", "租户客户联系人不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001207001 | 租户客户联系人不存在 | contact-id 不存在或不属于当前租户 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `EDIT_MASTER_CLIENT_CONTACT` | 编辑客户联系人需要此权限 |
-| 注解 | `@PostResource(requirePermissionCode = "EDIT_MASTER_CLIENT_CONTACT")` | Controller方法上 |
-
-## 2.7 实现要点
-
-1. **位置参数**：contact-id 必须指定
-2. **可选字段**：所有业务字段都是可选的，至少提供一个
-3. **dry-run 模式**：预览模式下只显示将要更新的数据，不实际调用 API
-4. **输出格式**：成功后显示更新后的联系人信息
-5. **错误处理**：联系人不存在时显示友好错误信息
-
-## 2.8 示例用法
-
-```bash
-# 更新联系人姓名（dry-run 预览）
-barista liberica client-contacts update 12345 --name "新姓名" --dry-run
-
-# 实际更新
-barista liberica client-contacts update 12345 --name "新姓名" --phone "13900139000"
-
-# 更新多个字段
-barista liberica client-contacts update 12345 --email "new@example.com" --address "新地址"
-
-# JSON 输出
-barista liberica client-contacts update 12345 --name "新姓名" --json
-```

package/docs/commands/liberica/context/index.md

@@ -1,60 +0,0 @@
-# liberica context
-
-管理 Liberica 上下文（租户、环境）。
-
-## Commands
-
-### show
-
-显示当前 Liberica 上下文。
-
-**Usage:**
-```
-barista liberica context show
-```
-
-**Output:**
-```
-📋 Liberica Context
-
-  Environment: dev
-  Tenant: electionjp
-  Auth Status: ✓ Logged in
-```
-
-**Implementation Notes:**
-- 无 API 调用，仅读取本地配置
-- 使用 `configManager.getCurrentContext()` 获取当前上下文
-- 使用 `tokenManager.getToken()` 检查认证状态
-
----
-
-### use-enterprise
-
-切换 Liberica 租户。
-
-**Usage:**
-```
-barista liberica context use-enterprise <tenant>
-```
-
-**Arguments:**
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| tenant | string | ✅ | 租户名称 |
-
-**Examples:**
-```bash
-barista liberica context use-enterprise electionjp
-barista liberica context use-enterprise newtenant
-```
-
-**Implementation Notes:**
-- 使用 `configManager.setTenant()` 更新默认租户
-- 租户变更后不影响当前已存储的 Token
-
----
-
-## Design Reference
-
-完整设计文档见：[命令设计规范](../../COMMAND_DESIGN_SPEC.md#62-示例liberica-context-show-命令)

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

@@ -1,145 +0,0 @@
-# barista liberica currency create
-
-创建新的币种。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica currency create` |
-| 功能描述 | 创建新的币种 |
-| 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
-            └── addCurrency(@PostResource(path = "/add"))
-                └── public ResponseData<CurrencyResponse> addCurrency(
-                        @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
-    ├── currencyCode: String (@NotBlank, 3位编码)
-    ├── currencyName: String (@NotBlank)
-    └── currencySign: String (符号，如 ¥, $)
-```
-
-### 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位编码)
-    ├── currencyName: String
-    ├── currencySign: String
-    ├── statusFlag: Integer (1=启用)
-    ├── createTime: String
-    └── updateTime: String
-```
-
-### 辅助接口（创建流程内部使用）
-```
-coffee-liberica-end/
-└── facade/liberica-facade-platform/
-    └── src/main/java/com/newpeak/liberica/facade/platform/controller/
-        └── MasterCurrencyController.java
-            └── getAvailableList(@GetResource(path = "/available/list"))
-                └── 获取可用币种列表（用于选择currencyCode）
-            └── getCurrencyDefault(@GetResource(path = "/currency/default"))
-                └── 获取币种默认值（根据currencyCode自动填充名称和符号）
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica currency create [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --code | -c | string | ✅ | - | 币种编码（3位，如 CNY） | currencyCode |
-| --name | -n | string | ⬜ | - | 币种名称（可自动填充） | currencyName |
-| --sign | -S | string | ⬜ | - | 币种符号（可自动填充，如 ¥） | currencySign |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| --code / -c | currencyCode | string→String | @NotBlank, 3位字母, ISO 4217 |
-| --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_CODE_DUPLICATE | 币种编码重复 | 编码重复 |
-| CURRENCY_CODE_EMPTY | 币种编码不能为空 | 编码为空 |
-| CURRENCY_NAME_EMPTY | 币种名称不能为空 | 名称为空 |
-| CURRENCY_CODE_INVALID | 币种编码无效 | 非标准3位编码 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | FinanceCurrencyController.java | 需要 `finance_currency:add` 权限 |
-
-## 2.7 实现要点
-
-1. **必填参数**：currencyCode 为必填参数，currencyName 和 currencySign 可自动填充
-2. **自动填充流程**：
-   - 用户输入 currencyCode（如 CNY）
-   - 调用 `/master/currency/currency/default` 获取默认值
-   - 自动填充 currencyName（人民币）和 currencySign（¥）
-3. **编码规范**：currencyCode 必须为3位字母，符合ISO 4217标准
-4. **dry-run 支持**：支持 `--dry-run` 预览模式，显示将要创建的币种信息
-5. **编码唯一性**：后端会校验 currencyCode 是否已存在
-6. **状态默认**：新创建币种默认状态为启用（statusFlag=1）
-7. **API路径**：POST `/api/enterprise/finance/currency/add`
-8. **成功响应**：返回创建的币种详情，包括生成的 currencyId
-
-## 2.8 示例用法
-
-```bash
-# 创建币种（自动填充名称和符号）
-barista liberica currency create --code "CNY"
-barista liberica currency create -c "USD"
-
-# 创建并指定完整信息
-barista liberica currency create --code "EUR" --name "欧元" --sign "€"
-barista liberica currency create -c "JPY" -n "日元" -S "¥"
-
-# 预览模式（dry-run）
-barista liberica currency create --code "GBP" --dry-run
-
-# JSON 输出
-barista liberica currency create --code "CNY" --json
-```