@newpeak/barista-cli 0.1.11 → 0.1.12

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

@@ -1,141 +0,0 @@
-# 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/employees/create.md

@@ -1,185 +0,0 @@
-# barista liberica employees create
-
-创建新员工。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica employees create` |
-| 功能描述 | 创建新员工 |
-| 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
-            └── add(@PostResource(path = "/add", requiredPermission = true, requirePermissionCode = "ADD_EMPLOYEE"))
-                └── public ResponseData<MasterEmployeeResponse> add(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.add.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
-            ├── employeeCode: String (@NotBlank on add)
-            ├── employeeName: String (@NotBlank on add)
-            ├── employeeNo: String (@NotBlank on add)
-            ├── employeePhone: String
-            ├── employeeEmail: String
-            ├── employeeSex: SexEnum (M/F)
-            ├── 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
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica employees create [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --name | -n | string | ✅ | - | 员工姓名 | employeeName |
-| --code | -c | string | ⬜ | 空（自动生成） | 员工编码 | employeeCode |
-| --phone | -p | string | ⬜ | - | 手机号码 | employeePhone |
-| --email | -e | string | ⬜ | - | 电子邮箱 | employeeEmail |
-| --sex | -s | string | ⬜ | - | 性别 (M/F) | employeeSex |
-| --org-id | — | number | ⬜ | - | 部门ID | organizationId |
-| --position-id | — | string | ⬜ | - | 岗位ID | positionId |
-| --joined-date | -d | string | ⬜ | - | 入职日期 (YYYY-MM-DD) | employeeJoinedDate |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| --name / -n | employeeName | 直接传递 | @NotBlank, max=255 |
-| --code / -c | employeeCode | 直接传递 | 可选，为空则自动生成 |
-| --phone / -p | employeePhone | 直接传递 | 手机号格式 |
-| --email / -e | employeeEmail | 直接传递 | 邮箱格式 |
-| --sex / -s | employeeSex | 直接传递 | M 或 F |
-| --org-id | organizationId | string→Long | - |
-| --position-id | positionId | 直接传递 | - |
-| --joined-date / -d | employeeJoinedDate | string→Date | yyyy-MM-dd |
-
-**自动填充字段（不通过CLI参数）：**
-| 字段 | 值 |
-|------|-----|
-| tenantId | 来自 X-TENANT-ID header |
-| statusFlag | 默认 1 (启用) |
-| employeeNo | 必填，从 --no 参数获取或交互输入 |
-
-## 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_CODE_FORMAT_CANNOT_EMPTY("01001150003", "职员编码规则不能为空")
-            ├── MASTER_EMPLOYEE_CODE_FORMAT_NOT_CORRECT("01001150004", "职员编码规则格式不正确")
-            ├── MASTER_EMPLOYEE_CODE_VALIDATE_EMPTY_ERROR("01001150006", "{}不能为空")
-            └── MASTER_EMPLOYEE_CODE_VALIDATE_NOT_EXIST_ERROR("01001150007", "指定{}不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001150003 | 职员编码规则不能为空 | employeeCode 为空且系统未配置自动生成规则 |
-| 01001150006 | xxx不能为空 | 必填字段缺失 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `LibericaPermissionCodeConstants.ADD_EMPLOYEE` | Controller层 `@PostResource(requirePermissionCode = "ADD_EMPLOYEE")` |
-
-## 2.7 实现要点
-
-1. **必填字段**：--name 必须提供；employeeNo 通过位置参数或交互输入获取
-2. **自动生成编码**：employeeCode 为空时后端自动生成
-3. **Dry-run支持**：使用 --dry-run 时构造请求体但不发送，显示预览信息
-4. **默认statusFlag**：新建员工默认为启用状态(statusFlag=1)
-5. **tenantId来源**：来自 X-TENANT-ID header，不通过请求体传递
-
-## 2.8 示例用法
-
-```bash
-# 交互式创建（引导输入必填字段）
-barista liberica employees create
-
-# 指定姓名和必填字段
-barista liberica employees create --name "张三" --no "EMP001"
-
-# 完整选项
-barista liberica employees create \
-  --name "张三" \
-  --code "EMP001" \
-  --phone "13800138000" \
-  --email "zhangsan@example.com" \
-  --sex M \
-  --org-id 1001 \
-  --position-id "MANAGER" \
-  --joined-date 2024-01-15
-
-# Dry-run 预览
-barista liberica employees create --name "张三" --no "EMP001" --dry-run
-
-# JSON 输出
-barista liberica employees create --name "张三" --no "EMP001" --json
-```

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

@@ -1,138 +0,0 @@
-# barista liberica employees disable
-
-禁用（停用）员工账号。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica employees disable <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
-            └── deActive(@PostResource(path = "/deActive", requiredPermission = true, requirePermissionCode = "DE_ACTIVE_EMPLOYEE"))
-                └── public ResponseData<String> deActive(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody 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
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/pojo/response/
-        └── MasterEmployeeResponse.java
-            └── 返回更新后的员工详情（同 create/update）
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica employees disable <id> [options]
-```
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| id | number | ✅ | 员工ID (employeeId) |
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 |
-|------|--------|------|------|--------|------|
-| --force | -f | boolean | ⬜ | false | 跳过确认提示 |
-
-**说明**：
-- `--dry-run` 预览禁用操作的影响（显示将禁用的员工信息）
-- `--force` 直接执行，不显示确认提示（适用于脚本自动化）
-
-## 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", "查询结果不存在")
-            ├── DELETE_EMPLOYEE_ERROR("01001150002", "删除职员失败，该职员下有绑定数据")
-            └── MASTER_EMPLOYEE_NAME_VALIDATE_NOT_EXIST_ERROR("01001150009", "指定{}不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001150001 | 查询结果不存在 | employeeId 不存在或不属于当前租户 |
-| 01001150002 | 删除职员失败，该职员下有绑定数据 | 禁用时该员工存在绑定数据 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `LibericaPermissionCodeConstants.DE_ACTIVE_EMPLOYEE` | Controller层 `@PostResource(requirePermissionCode = "DE_ACTIVE_EMPLOYEE")` |
-
-## 2.7 实现要点
-
-1. **幂等性**：deActive 操作是幂等的——对已禁用的员工再次调用效果相同（直接 set statusFlag=DISABLE）
-2. **幂等性原理**：后端直接 `LambdaUpdateWrapper.set(MasterEmployee::getStatusFlag, DISABLE)`，不检查当前状态
-3. **Dry-run模式**：预览显示将禁用的员工信息，但不实际发送请求
-4. **无强制选项**：--force 跳过确认提示，但不绕过后端权限检查
-5. **Error 01001150002**：如果禁用失败（存在绑定数据），显示后端错误消息
-
-## 2.8 示例用法
-
-```bash
-# 禁用员工（交互确认）
-barista liberica employees disable 12345
-
-# 跳过确认直接禁用
-barista liberica employees disable 12345 --force
-
-# Dry-run 预览
-barista liberica employees disable 12345 --dry-run
-
-# JSON 输出
-barista liberica employees disable 12345 --force --json
-
-# 员工不存在
-barista liberica employees disable 99999
-# 输出: Error: 员工不存在 (01001150001)
-
-# 员工有绑定数据
-barista liberica employees disable 12345 --force
-# 输出: Error: 删除职员失败，该职员下有绑定数据 (01001150002)
-```

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

@@ -1,137 +0,0 @@
-# barista liberica employees enable
-
-启用（激活）员工账号。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica employees enable <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
-            └── active(@PostResource(path = "/active", requiredPermission = true, requirePermissionCode = "ACTIVE_EMPLOYEE"))
-                └── public ResponseData<String> active(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody 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
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/pojo/response/
-        └── MasterEmployeeResponse.java
-            └── 返回更新后的员工详情（同 create/update）
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica employees enable <id> [options]
-```
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| id | number | ✅ | 员工ID (employeeId) |
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 |
-|------|--------|------|------|--------|------|
-| --force | -f | boolean | ⬜ | false | 跳过确认提示 |
-
-**说明**：
-- `--dry-run` 预览启用操作的影响（显示将启用的员工信息）
-- `--force` 直接执行，不显示确认提示（适用于脚本自动化）
-
-## 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/pojo/request/
-        └── MasterEmployeeRequest.java
-            ├── MASTER_EMPLOYEE_NOT_EXISTED("01001150001", "查询结果不存在")
-            └── MASTER_EMPLOYEE_NAME_VALIDATE_NOT_EXIST_ERROR("01001150009", "指定{}不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001150001 | 查询结果不存在 | employeeId 不存在或不属于当前租户 |
-| 01001150009 | 指定xxx不存在 | 指定关联的员工编码不存在 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `LibericaPermissionCodeConstants.ACTIVE_EMPLOYEE` | Controller层 `@PostResource(requirePermissionCode = "ACTIVE_EMPLOYEE")` |
-
-## 2.7 实现要点
-
-1. **幂等性**：active 操作是幂等的——对已启用的员工再次调用效果相同（直接 set statusFlag=ENABLE）
-2. **幂等性原理**：后端直接 `LambdaUpdateWrapper.set(MasterEmployee::getStatusFlag, ENABLE)`，不检查当前状态
-3. **Dry-run模式**：预览显示将启用的员工信息，但不实际发送请求
-4. **无强制选项**：--force 跳过确认提示，但不绕过后端权限检查
-5. **与disable对称**：enable 与 disable 互为逆操作，使用相同的 employeeId 参数结构
-
-## 2.8 示例用法
-
-```bash
-# 启用员工（交互确认）
-barista liberica employees enable 12345
-
-# 跳过确认直接启用
-barista liberica employees enable 12345 --force
-
-# Dry-run 预览
-barista liberica employees enable 12345 --dry-run
-
-# JSON 输出
-barista liberica employees enable 12345 --force --json
-
-# 员工不存在
-barista liberica employees enable 99999
-# 输出: Error: 员工不存在 (01001150001)
-
-# 对已启用员工重复启用（幂等，无报错）
-barista liberica employees enable 12345 --force
-# 输出: ✓ 员工启用成功
-```