@newpeak/barista-cli 0.1.10 → 0.1.12

package/docs/commands/liberica/teams/work-logs/get.md

@@ -1,131 +0,0 @@
-# barista liberica teams work-logs get
-
-查询单个团队工作日志详情。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica teams work-logs 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/team/
-        └── EnterpriseTeamWorkLogController.java
-            └── detail(@GetResource(path = "/detail"))
-                └── public ResponseData<TeamWorkLogResponse> detail(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @ParameterObject @Validated(BaseRequest.detail.class) TeamWorkLogRequest teamWorkLogRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
-        └── TeamWorkLogRequest.java
-            ├── workLogId: Long (@NotNull for detail)
-            └── tenantId: Long
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
-        └── TeamWorkLogResponse.java
-            ├── workLogId: Long
-            ├── creator: String
-            ├── creatorName: String
-            ├── logDate: Date
-            ├── logContent: String
-            ├── tags: String
-            ├── refId: String
-            ├── createTime: Date
-            └── updateTime: Date
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica teams work-logs get <id> [options]
-```
-
-### Usage
-```bash
-barista liberica teams work-logs get 123456789
-barista liberica teams work-logs get --id 123456789
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --id | — | string | ✅ | - | 工作日志ID | workLogId |
-| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| `<id>` (位置参数) | workLogId | string→Long | @NotNull |
-| --id | workLogId | string→Long | @NotNull |
-
-**解析优先级**：`--id` 选项参数优先于 `<id>` 位置参数。
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
-        └── TeamWorkLogExceptionEnum.java
-            └── TEAM_WORK_LOG_NOT_EXIST("01001951001", "团队工作日志不存在")
-```
-
-### Service层业务校验
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-business/
-    └── src/main/java/com/newpeak/liberica/team/modular/service/impl/
-        └── TeamWorkLogServiceImpl.java
-            └── queryTeamWorkLog(TeamWorkLogRequest request)
-                └── Line 134: if (ObjectUtil.isEmpty(teamWorkLog))
-                    └── throw new TeamServiceException(TeamWorkLogExceptionEnum.TEAM_WORK_LOG_NOT_EXIST)
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001951001 | 团队工作日志不存在 | ID不存在或已被删除 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 认证 | `@GetResource(path = "/detail")` | detail接口无需显式权限码，但需登录认证 |
-
-## 2.7 实现要点
-
-1. **ID必填**：`get` 命令必须提供 `<id>` 位置参数或 `--id` 选项
-2. **位置参数支持**：同时支持 `barista liberica teams work-logs get 123` 和 `barista liberica teams work-logs get --id 123`
-3. **错误处理**：ID不存在时后端返回 `TEAM_WORK_LOG_NOT_EXIST`，CLI应转换为友好提示
-4. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取
-5. **API路径**：`/api/enterprise/team/workLog/detail`

package/docs/commands/liberica/teams/work-logs/list.md

@@ -1,153 +0,0 @@
-# barista liberica teams work-logs list
-
-查询团队工作日志分页列表。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica teams work-logs list` |
-| 功能描述 | 查询团队工作日志分页列表 |
-| HTTP方法 | GET |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ⬜ 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
-        └── EnterpriseTeamWorkLogController.java
-            └── page(@GetResource(path = "/page"))
-                └── public ResponseData<PageResult<TeamWorkLogResponse>> page(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @ParameterObject TeamWorkLogQueryRequest teamWorkLogQueryRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
-        └── TeamWorkLogQueryRequest.java
-            ├── tenantId: Long
-            ├── workLogId: Long
-            ├── creator: String
-            ├── creatorName: String
-            ├── logDate: Date
-            ├── logDateCriteria: DateRange
-            ├── logContent: String
-            ├── tags: String
-            ├── refId: String
-            ├── workLogIdList: Set<Long>
-            └── searchText: String
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
-        └── TeamWorkLogResponse.java
-            ├── workLogId: Long
-            ├── creator: String
-            ├── creatorName: String
-            ├── logDate: Date
-            ├── logContent: String
-            ├── tags: String
-            ├── refId: String
-            ├── createTime: Date
-            └── updateTime: Date
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica teams work-logs list [options]
-```
-
-### Usage
-```bash
-barista liberica teams work-logs list --page 1 --size 20
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --page | -p | number | ⬜ | 1 | 页码 | pageNo |
-| --size | -s | number | ⬜ | 20 | 每页条数 | pageSize |
-| --creator | -c | string | ⬜ | - | 创建人编码 | creator |
-| --creator-name | -n | string | ⬜ | - | 创建人姓名 | creatorName |
-| --date | -d | string | ⬜ | - | 日志日期(YYYY-MM-DD) | logDate |
-| --content | — | string | ⬜ | - | 日志内容关键字 | logContent |
-| --tags | -t | string | ⬜ | - | 标签 | tags |
-| --ref-id | -r | string | ⬜ | - | 引用ID | refId |
-| --search-text | — | string | ⬜ | - | 全文搜索关键字 | searchText |
-| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| --page / -p | pageNo | number→number | CLI page 1 对应后端 pageNo 0 |
-| --size / -s | pageSize | number→number | 默认20 |
-| --creator / -c | creator | 直接传递 | max=255 |
-| --creator-name / -n | creatorName | 直接传递 | max=255 |
-| --date / -d | logDate | string→Date | yyyy-MM-dd |
-| --content | logContent | 直接传递 | - |
-| --tags / -t | tags | 直接传递 | max=512 |
-| --ref-id / -r | refId | 直接传递 | max=255 |
-| --search-text | searchText | 直接传递 | 匹配logContent/tags/creatorName |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
-        └── TeamWorkLogExceptionEnum.java
-            └── TEAM_WORK_LOG_NOT_EXIST("01001951001", "团队工作日志不存在")
-```
-
-### Service层业务校验
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-business/
-    └── src/main/java/com/newpeak/liberica/team/modular/service/impl/
-        └── TeamWorkLogServiceImpl.java
-            └── queryTeamWorkLog(TeamWorkLogRequest request)
-                └── Line 134: if (ObjectUtil.isEmpty(teamWorkLog))
-                    └── throw new TeamServiceException(TeamWorkLogExceptionEnum.TEAM_WORK_LOG_NOT_EXIST)
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001951001 | 团队工作日志不存在 | get/edit/delete时ID不存在 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 认证 | `@GetResource(path = "/page")` | page接口无需显式权限码，但需登录认证 |
-
-## 2.7 实现要点
-
-1. **分页转换**：CLI `--page` 从1开始，后端 `pageNo` 从0开始，需要自动减1
-2. **日期查询**：支持 `--date` 精确查询；后端 `TeamWorkLogQueryRequest` 也支持 `logDateCriteria` 范围查询
-3. **全文搜索**：`--search-text` 会后端嵌套匹配 `logContent`、`tags`、`creatorName`
-4. **排序**：默认按 `createTime` 倒序排列
-5. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取
-6. **API路径**：`/api/enterprise/team/workLog/page`

package/docs/commands/liberica/teams/work-logs/update.md

@@ -1,150 +0,0 @@
-# barista liberica teams work-logs update
-
-更新团队工作日志。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica teams work-logs update` |
-| 功能描述 | 编辑已有的团队工作日志 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
-        └── EnterpriseTeamWorkLogController.java
-            └── edit(@PostResource(path = "/edit", requiredPermission = true, requirePermissionCode = TeamWorkLogPermissionConstants.EDIT_TEAM_WORK_LOG))
-                └── public ResponseData<? extends TeamWorkLogResponse> edit(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.edit.class) TeamWorkLogRequest teamWorkLogRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
-        └── TeamWorkLogRequest.java
-            ├── workLogId: Long (@NotNull for edit)
-            ├── tenantId: Long
-            ├── creator: String (@NotBlank for edit, max=255)
-            ├── creatorName: String (max=255)
-            ├── logDate: Date (@NotNull for add/edit)
-            ├── logContent: String (@NotNull for add/edit)
-            ├── tags: String (max=512)
-            └── refId: String (max=255)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
-        └── TeamWorkLogResponse.java
-            ├── workLogId: Long
-            ├── creator: String
-            ├── creatorName: String
-            ├── logDate: Date
-            ├── logContent: String
-            ├── tags: String
-            ├── refId: String
-            ├── createTime: Date
-            └── updateTime: Date
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica teams work-logs update <id> [options]
-```
-
-### Usage
-```bash
-barista liberica teams work-logs update 123456789 --content "更新后的日志内容"
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --id | — | string | ✅ | - | 工作日志ID | workLogId |
-| --content | -c | string | ✅ | - | 日志内容 | logContent |
-| --date | -d | string | ✅ | - | 日志日期(YYYY-MM-DD) | logDate |
-| --creator | -u | string | ⬜ | - | 创建人编码 | creator |
-| --creator-name | -n | string | ⬜ | - | 创建人姓名 | creatorName |
-| --tags | -t | string | ⬜ | - | 标签 | tags |
-| --ref-id | -r | string | ⬜ | - | 引用ID | refId |
-| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| `<id>` (位置参数) | workLogId | string→Long | @NotNull for edit |
-| --id | workLogId | string→Long | @NotNull for edit |
-| --content / -c | logContent | 直接传递 | @NotNull for add/edit |
-| --date / -d | logDate | string→Date | @NotNull for add/edit, yyyy-MM-dd |
-| --creator / -u | creator | 直接传递 | max=255 |
-| --creator-name / -n | creatorName | 直接传递 | max=255 |
-| --tags / -t | tags | 直接传递 | max=512 |
-| --ref-id / -r | refId | 直接传递 | max=255 |
-
-**解析优先级**：`--id` 选项参数优先于 `<id>` 位置参数。
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
-        └── TeamWorkLogExceptionEnum.java
-            └── TEAM_WORK_LOG_NOT_EXIST("01001951001", "团队工作日志不存在")
-```
-
-### Service层业务校验
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-business/
-    └── src/main/java/com/newpeak/liberica/team/modular/service/impl/
-        └── TeamWorkLogServiceImpl.java
-            └── edit(TeamWorkLogRequest request)
-                └── Line 99: TeamWorkLog teamWorkLog = this.queryTeamWorkLog(teamWorkLogRequest)
-                    └── 若不存在则 throw new TeamServiceException(TeamWorkLogExceptionEnum.TEAM_WORK_LOG_NOT_EXIST)
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001951001 | 团队工作日志不存在 | 编辑时ID不存在或已被删除 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `TeamWorkLogPermissionConstants.EDIT_TEAM_WORK_LOG` | Controller层 `@PostResource(requirePermissionCode = "EDIT_TEAM_WORK_LOG")` |
-
-## 2.7 实现要点
-
-1. **ID必填**：`update` 命令必须提供 `<id>` 位置参数或 `--id` 选项
-2. **必填字段**：`--content`、`--date` 必须提供（与创建相同，后端 `add`/`edit` 分组都校验 `@NotNull`）
-3. **创建人自动填充**：`--creator` 未提供时，后端通过 `masterEmployeeApi.myEmployee(tenantId)` 自动获取当前登录用户职员信息
-4. **Dry-run支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
-5. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取
-6. **API路径**：`/api/enterprise/team/workLog/edit`

package/docs/commands/liberica/transfer-in-forms/batch-delete.md

@@ -1,157 +0,0 @@
-# barista liberica transfer-in-forms batch-delete
-
-批量删除调整入库单。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica transfer-in-forms batch-delete <ids...>` |
-| 功能描述 | 批量删除调整入库单 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/stock/
-        └── EnterpriseTransferInFormController.java
-            └── batchDelete(@PostResource(path = "/batchDelete", requiredPermission = true, requirePermissionCode = TransferInFormPermissionConstants.DEL_TRANSFER_IN_FORM))
-                └── public ResponseData<?> batchDelete(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.batchDelete.class) TransferInFormRequest transferInFormRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
-        └── TransferInFormRequest.java
-            └── transferInFormIdList: Set<Long> (@NotEmpty on batchDelete)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
-        └── SuccessResponseData (空 data)
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica transfer-in-forms batch-delete <ids...> [options]
-```
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| ids | string... | ✅ | 一个或多个调整入库单ID (transferInFormIdList) |
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 |
-|------|--------|------|------|--------|------|
-| --force | -f | boolean | ⬜ | false | 跳过确认提示，直接执行删除 |
-
-**说明**：
-- `--dry-run` 预览将要删除的入库单信息，不实际调用API
-- `--force` 直接执行删除，不显示确认提示（脚本自动化时使用）
-- 无 `--force` 且无 `--dry-run` 时，交互式提示用户确认
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| <ids...> (位置参数) | transferInFormIdList | string[]→Set<Long> | @NotEmpty |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/exception/enums/
-        └── TransferInFormExceptionEnum.java
-            ├── TRANSFER_IN_FORM_NOT_EXIST("01001xx001", "租户入库单不存在")
-            └── ...
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001xx001 | 租户入库单不存在 | 某个 transferInFormId 不存在或不属于当前租户 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `TransferInFormPermissionConstants.DEL_TRANSFER_IN_FORM` | Controller层 `@PostResource(requirePermissionCode = "DEL_TRANSFER_IN_FORM")` |
-
-## 2.7 实现要点
-
-1. **变长参数**：接受一个或多个 ID 作为位置参数
-2. **BigInteger ID**：所有 ID 必须作为 `string` 处理，避免精度丢失
-3. **安全机制**：默认需要用户确认，只有 `--force` 时才跳过确认
-4. **No X-TENANT-ID**：租户通过 JWT token 传递，不要发送 `X-TENANT-ID` header
-5. **Dry-run模式**：显示将要删除的入库单编码列表，不实际调用API
-6. **已审核限制**：已审核的入库单通常不允许删除，后端会返回业务错误
-
-## 2.8 示例用法
-
-```bash
-# 删除单个入库单（交互确认）
-barista liberica transfer-in-forms batch-delete 1234567890123456789
-
-# 删除多个入库单（交互确认）
-barista liberica transfer-in-forms batch-delete 1234567890123456789 9876543210987654321
-
-# 强制删除，跳过确认
-barista liberica transfer-in-forms batch-delete 1234567890123456789 --force
-
-# Dry-run 预览
-barista liberica transfer-in-forms batch-delete 1234567890123456789 --dry-run
-
-# JSON 输出
-barista liberica transfer-in-forms batch-delete 1234567890123456789 --force --json
-```
-
-## 2.9 输出示例
-
-### 确认提示
-```
-即将删除以下 2 条调整入库单：
-  • TI20250001 (ID: 1234567890123456789)
-  • TI20250002 (ID: 9876543210987654321)
-
-⚠️  此操作不可恢复。确认删除？ [y/N]
-```
-
-### 成功输出
-```
-✓ 成功删除 2 条调整入库单
-```
-
-### JSON输出
-```json
-{
-  "success": true,
-  "data": null,
-  "message": "成功删除 2 条调整入库单"
-}
-```