@newpeak/barista-cli 0.1.8 → 0.1.10

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

@@ -0,0 +1,130 @@
+# barista liberica teams work-logs delete
+
+删除团队工作日志。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica teams work-logs delete` |
+| 功能描述 | 删除指定的团队工作日志 |
+| HTTP方法 | POST |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ✅ 是（默认Dry-Run，需 --force 确认） |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
+        └── EnterpriseTeamWorkLogController.java
+            └── delete(@PostResource(path = "/delete", requiredPermission = true, requirePermissionCode = TeamWorkLogPermissionConstants.DEL_TEAM_WORK_LOG))
+                └── public ResponseData<?> delete(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.delete.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 delete)
+            └── 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
+            └── (delete 返回空 SuccessResponseData)
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica teams work-logs delete <id> [options]
+```
+
+### Usage
+```bash
+# Dry-run 预览（默认）
+barista liberica teams work-logs delete 123456789
+
+# 强制删除
+barista liberica teams work-logs delete 123456789 --force
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--dry-run` | boolean | 预览模式 |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --id | — | string | ✅ | - | 工作日志ID | workLogId |
+| --force | -f | boolean | ⬜ | false | 跳过确认直接删除 | - |
+| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| `<id>` (位置参数) | workLogId | string→Long | @NotNull for delete |
+| --id | workLogId | string→Long | @NotNull for delete |
+| --force / -f | - | - | 确认执行删除操作 |
+
+**解析优先级**：`--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
+            └── del(TeamWorkLogRequest request)
+                └── Line 79: TeamWorkLog teamWorkLog = this.queryTeamWorkLog(teamWorkLogRequest)
+                    └── 若不存在则 throw new TeamServiceException(TeamWorkLogExceptionEnum.TEAM_WORK_LOG_NOT_EXIST)
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| 01001951001 | 团队工作日志不存在 | 删除时ID不存在或已被删除 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| PermissionConstants | `TeamWorkLogPermissionConstants.DEL_TEAM_WORK_LOG` | Controller层 `@PostResource(requirePermissionCode = "DEL_TEAM_WORK_LOG")` |
+
+## 2.7 实现要点
+
+1. **ID必填**：`delete` 命令必须提供 `<id>` 位置参数或 `--id` 选项
+2. **默认Dry-Run**：未提供 `--force` 时仅预览删除影响，不实际调用API
+3. **确认提示**：非 `--force` 模式应显示待删除日志的关键信息并要求用户确认
+4. **位置参数支持**：同时支持 `barista liberica teams work-logs delete 123` 和 `barista liberica teams work-logs delete --id 123`
+5. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取
+6. **API路径**：`/api/enterprise/team/workLog/delete`

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

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

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

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