@newpeak/barista-cli 0.1.11 → 0.1.13

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

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

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

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

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