@newpeak/barista-cli 0.1.9 → 0.1.11

package/docs/commands/liberica/teams/tasks/list.md

@@ -0,0 +1,148 @@
+# barista liberica teams tasks list
+
+查询团队任务分页列表。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica teams tasks 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/
+        └── EnterpriseTeamTaskController.java
+            └── page(@GetResource(path = "/page"))
+                └── public ResponseData<PageResult<TeamTaskResponse>> page(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @ParameterObject TeamTaskQueryRequest teamTaskQueryRequest
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
+        └── TeamTaskQueryRequest.java
+            ├── taskId: Long
+            ├── taskCode: String
+            ├── taskName: String
+            ├── taskDescription: String
+            ├── priority: String
+            ├── status: String
+            ├── creator: String
+            ├── creatorName: String
+            ├── assignTo: String
+            ├── assignToName: String
+            ├── startTime: Instant
+            ├── endTime: Instant
+            ├── completionRate: BigDecimal
+            ├── tags: String
+            └── taskIdList: Set<Long>
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
+        └── TeamTaskResponse.java
+            ├── taskId: Long
+            ├── taskCode: String
+            ├── taskName: String
+            ├── taskDescription: String
+            ├── priority: String
+            ├── status: String
+            ├── creator: String
+            ├── creatorName: String
+            ├── assignTo: String
+            ├── assignToName: String
+            ├── startTime: Instant
+            ├── endTime: Instant
+            ├── completionRate: BigDecimal
+            ├── tags: String
+            └── refId: String
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica teams tasks list [options]
+```
+
+### Usage
+```bash
+barista liberica teams tasks list --page 1 --size 20 --status OPEN
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --page | -p | number | ⬜ | 1 | 页码 | pageNo (0-based) |
+| --size | -s | number | ⬜ | 20 | 每页条数 | pageSize |
+| --title | -t | string | ⬜ | - | 任务标题 | taskName |
+| --status | — | string | ⬜ | - | 任务状态 | status |
+| --priority | — | string | ⬜ | - | 优先级 | priority |
+| --assign-to | -a | string | ⬜ | - | 负责人 | assignTo |
+| --creator-name | -c | string | ⬜ | - | 创建人姓名 | creatorName |
+| --task-code | — | string | ⬜ | - | 任务编码 | taskCode |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| --page | pageNo | number→number | page - 1 |
+| --size | pageSize | number→number | - |
+| --title | taskName | 直接传递 | - |
+| --status | status | 直接传递 | - |
+| --priority | priority | 直接传递 | - |
+| --assign-to | assignTo | 直接传递 | - |
+| --creator-name | creatorName | 直接传递 | - |
+| --task-code | taskCode | 直接传递 | - |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
+        └── TeamTaskExceptionEnum.java
+            └── TEAM_TASK_NOT_EXIST("01001952001", "团队任务不存在")
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| 01001952001 | 团队任务不存在 | 详情/编辑时引用的任务不存在 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| PermissionConstants | `TeamTaskPermissionConstants` | 分页查询无需显式权限码 |
+
+## 2.7 实现要点
+
+1. **分页转换**：CLI `--page` 从1开始，API `pageNo` 从0开始，需要 `pageNo = page - 1`
+2. **查询参数**：所有查询条件通过 URL query parameters 传递
+3. **响应格式**：后端返回 `PageResult<TeamTaskResponse>`，CLI 中需使用 `rows` / `pageNo` / `pageSize` / `totalRows` 字段
+4. **表格输出**：使用 `cli-table3` 展示任务列表，包含 taskCode、taskName、status、priority、assignToName、creatorName
+5. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取

package/docs/commands/liberica/teams/tasks/update.md

@@ -0,0 +1,158 @@
+# barista liberica teams tasks update
+
+更新团队任务信息。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica teams tasks update <task-id>` |
+| 功能描述 | 更新指定团队任务的信息 |
+| HTTP方法 | POST |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ✅ 是 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
+        └── EnterpriseTeamTaskController.java
+            └── edit(@PostResource(path = "/edit", requiredPermission = true, requirePermissionCode = TeamTaskPermissionConstants.EDIT_TEAM_TASK))
+                └── public ResponseData<? extends TeamTaskResponse> edit(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.edit.class) TeamTaskRequest teamTaskRequest
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
+        └── TeamTaskRequest.java
+            ├── taskId: Long (@NotNull for edit.class)
+            ├── taskCode: String (@NotBlank for edit.class, max=255)
+            ├── taskName: String (@NotBlank, max=255)
+            ├── taskDescription: String
+            ├── priority: String (max=255)
+            ├── status: String (max=255)
+            ├── creator: String (@NotBlank for edit.class, max=255)
+            ├── creatorName: String (@NotBlank for edit.class, max=255)
+            ├── assignTo: String (@NotBlank, max=255)
+            ├── assignToName: String (max=255)
+            ├── startTime: Instant
+            ├── endTime: Instant
+            ├── completionRate: BigDecimal
+            ├── 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/
+        └── TeamTaskResponse.java
+            ├── taskId: Long
+            ├── taskCode: String
+            ├── taskName: String
+            ├── taskDescription: String
+            ├── priority: String
+            ├── status: String
+            ├── creator: String
+            ├── creatorName: String
+            ├── assignTo: String
+            ├── assignToName: String
+            ├── startTime: Instant
+            ├── endTime: Instant
+            ├── completionRate: BigDecimal
+            ├── tags: String
+            └── refId: String
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica teams tasks update <task-id> [options]
+```
+
+### Usage
+```bash
+barista liberica teams tasks update 123456789 --title "新标题" --status IN_PROGRESS
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--dry-run` | boolean | 预览模式（不实际调用API） |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| <task-id> | — | string | ✅ | - | 任务ID（位置参数） | taskId |
+| --task-id | -i | string | ✅ | - | 任务ID（选项参数） | taskId |
+| --title | -t | string | ⬜ | - | 任务标题 | taskName |
+| --desc | -d | string | ⬜ | - | 任务描述 | taskDescription |
+| --priority | -p | string | ⬜ | - | 优先级 | priority |
+| --status | -s | string | ⬜ | - | 任务状态 | status |
+| --assign-to | -a | string | ⬜ | - | 负责人ID或账号 | assignTo |
+| --tags | — | string | ⬜ | - | 标签，逗号分隔 | tags |
+| --task-code | — | string | ⬜ | - | 任务编码 | taskCode |
+| --start-time | — | string | ⬜ | - | 开始时间(ISO-8601) | startTime |
+| --end-time | — | string | ⬜ | - | 结束时间(ISO-8601) | endTime |
+| --completion-rate | — | number | ⬜ | - | 完成率(0-100) | completionRate |
+| --ref-id | — | string | ⬜ | - | 引用ID | refId |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| <task-id> / --task-id | taskId | string→Long | @NotNull |
+| --title / -t | taskName | 直接传递 | @NotBlank, max=255 |
+| --desc / -d | taskDescription | 直接传递 | - |
+| --priority / -p | priority | 直接传递 | max=255 |
+| --status / -s | status | 直接传递 | max=255 |
+| --assign-to / -a | assignTo | 直接传递 | @NotBlank, max=255 |
+| --tags | tags | 直接传递 | max=512 |
+| --task-code | taskCode | 直接传递 | @NotBlank, max=255 |
+| --start-time | startTime | string→Instant | ISO-8601 |
+| --end-time | endTime | string→Instant | ISO-8601 |
+| --completion-rate | completionRate | number→BigDecimal | 0-100 |
+| --ref-id | refId | 直接传递 | max=255 |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
+        └── TeamTaskExceptionEnum.java
+            └── TEAM_TASK_NOT_EXIST("01001952001", "团队任务不存在")
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| 01001952001 | 团队任务不存在 | 任务ID不存在 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| PermissionConstants | `TeamTaskPermissionConstants.EDIT_TEAM_TASK` | Controller层 `@PostResource(requirePermissionCode = "EDIT_TEAM_TASK")` |
+
+## 2.7 实现要点
+
+1. **必填字段**：`task-id` 必须提供（位置参数或选项参数）
+2. **部分更新**：除 task-id 外，其他字段均为可选，仅更新提供的字段
+3. **参数解析优先级**：选项参数 > 位置参数
+4. **Dry-run 支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
+5. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取

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

@@ -0,0 +1,151 @@
+# barista liberica teams work-logs create
+
+创建团队工作日志。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica teams work-logs create` |
+| 功能描述 | 创建新的团队工作日志 |
+| 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
+            └── add(@PostResource(path = "/add", requiredPermission = true, requirePermissionCode = TeamWorkLogPermissionConstants.ADD_TEAM_WORK_LOG))
+                └── public ResponseData<TeamWorkLogResponse> add(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.add.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
+            ├── 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 create [options]
+```
+
+### Usage
+```bash
+barista liberica teams work-logs create --content "今日完成报表模块开发" --date 2025-01-15
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--dry-run` | boolean | 预览模式（不实际调用API） |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --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字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| --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 |
+
+**自动填充字段（不通过CLI参数）：**
+| 字段 | 来源 |
+|------|------|
+| tenantId | 后端从 X-TENANT-ID header 注入 |
+| creator | 未提供时，后端从当前登录用户职员信息自动填充 |
+| 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/business/impl/
+        └── TeamWorkLogBusinessImpl.java
+            └── add(TeamWorkLogRequest request)
+                ├── Line 58: if (StrUtil.isEmpty(creator))
+                │   └── 自动填充当前登录用户职员编码和姓名
+                └── Line 67: 根据creator查询职员信息并填充creatorName
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| 01001951001 | 团队工作日志不存在 | copy/edit时引用的原日志不存在 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| PermissionConstants | `TeamWorkLogPermissionConstants.ADD_TEAM_WORK_LOG` | Controller层 `@PostResource(requirePermissionCode = "ADD_TEAM_WORK_LOG")` |
+
+## 2.7 实现要点
+
+1. **必填字段**：`--content`、`--date` 必须提供
+2. **创建人自动填充**：`--creator` 未提供时，后端通过 `masterEmployeeApi.myEmployee(tenantId)` 自动获取当前登录用户职员信息
+3. **Dry-run支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
+4. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取
+5. **API路径**：`/api/enterprise/team/workLog/add`

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`