@newpeak/barista-cli 0.1.10 → 0.1.12

package/docs/commands/liberica/supplier-contacts/list.md

@@ -1,143 +0,0 @@
-# barista liberica supplier-contacts list
-
-查询供应商联系人列表。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica supplier-contacts list` |
-| 功能描述 | 查询指定供应商的联系人列表 |
-| HTTP方法 | GET |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ⬜ 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/purchases/
-        └── EnterpriseSupplierContactController.java
-            └── list(@GetResource(path = "/list"))
-                └── public ResponseData<List<MasterSupplierContactResponse>> list(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        MasterSupplierContactRequest masterSupplierContactRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/pojo/request/
-        └── MasterSupplierContactRequest.java
-            ├── supplierId: Long (@NotNull)
-            ├── supplierContactName: String (搜索关键词)
-            ├── pageNo: Long (分页页码)
-            └── pageSize: Long (分页大小)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/pojo/response/
-        └── MasterSupplierContactResponse.java
-            ├── supplierContactId: Long
-            ├── supplierId: Long
-            ├── supplierContactName: String
-            ├── supplierContactPhone: String
-            ├── supplierContactTelephone: String
-            ├── supplierContactEmail: String
-            ├── supplierContactSex: String
-            ├── supplierContactBirthday: Date
-            ├── supplierContactQq: String
-            ├── supplierContactWechat: String
-            ├── supplierContactAddress: String
-            ├── defaultFlag: String (Y/N)
-            ├── remark: String
-            ├── createTime: String
-            └── updateTime: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica supplier-contacts list [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --supplier-id | -s | string | ✅ | - | 供应商ID | supplierId |
-| --page | -p | number | ⬜ | 1 | 页码 | pageNo |
-| --size | -z | number | ⬜ | 20 | 每页条数 | pageSize |
-| --search | -S | string | ⬜ | - | 搜索关键词(姓名) | supplierContactName |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| --supplier-id / -s | supplierId | string→Long | @NotNull |
-| --page / -p | pageNo | number→Long | >= 1 |
-| --size / -z | pageSize | number→Long | 1-100 |
-| --search / -S | supplierContactName | 直接传递 | 模糊查询 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/exception/enums/
-        └── MasterSupplierContactExceptionEnum.java
-            └── MASTER_SUPPLIER_CONTACT_NOT_EXIST("01001XXX001", "租户供应商联系人不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001XXX001 | 租户供应商联系人不存在 | 供应商ID不存在时 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | `@GetResource(path = "/list")` | 无 requiredPermission（无需权限码） |
-
-**注意**：list 接口在 Controller 层无需权限校验，数据范围通过 tenantId 隔离。
-
-## 2.7 实现要点
-
-1. **必填参数**：--supplier-id 必须指定
-2. **分页默认值**：page=1, size=20
-3. **搜索行为**：supplierContactName 支持模糊查询
-4. **无结果处理**：返回空列表，不抛出异常
-5. **tenantId来源**：来自 X-TENANT-ID header
-6. **输出格式**：表格形式展示联系人列表
-
-## 2.8 示例用法
-
-```bash
-# 列出供应商的所有联系人
-barista liberica supplier-contacts list --supplier-id 12345
-
-# 指定页码和每页条数
-barista liberica supplier-contacts list --supplier-id 12345 --page 2 --size 50
-
-# 搜索联系人
-barista liberica supplier-contacts list --supplier-id 12345 --search "张"
-
-# JSON 输出（便于脚本处理）
-barista liberica supplier-contacts list --supplier-id 12345 --json
-```

package/docs/commands/liberica/supplier-contacts/update.md

@@ -1,158 +0,0 @@
-# barista liberica supplier-contacts update
-
-更新供应商联系人信息。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica supplier-contacts update <contact-id>` |
-| 功能描述 | 修改供应商联系人信息 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/purchases/
-        └── EnterpriseSupplierContactController.java
-            └── edit(@PostResource(path = "/edit", requiredPermission = true, requirePermissionCode = "EDIT_MASTER_SUPPLIER_CONTACT"))
-                └── public ResponseData<?> edit(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.edit.class) MasterSupplierContactRequest masterSupplierContactRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/pojo/request/
-        └── MasterSupplierContactRequest.java
-            ├── supplierContactId: Long (@NotNull on edit)
-            ├── supplierContactName: String (@NotBlank, max=255)
-            ├── supplierContactPhone: String (max=256)
-            ├── supplierContactTelephone: String (max=256)
-            ├── supplierContactEmail: String (max=512)
-            ├── supplierContactSex: String (max=255)
-            ├── supplierContactBirthday: Date
-            ├── supplierContactQq: String (max=512)
-            ├── supplierContactWechat: String (max=512)
-            ├── supplierContactAddress: String (max=512)
-            ├── defaultFlag: String (max=1)
-            └── remark: String (max=255)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/pojo/response/
-        └── MasterSupplierContactResponse.java
-            └── (同 get 接口)
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica supplier-contacts update <contact-id> [options]
-```
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| contact-id | string | ✅ | 供应商联系人ID |
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --name | -n | string | ⬜ | - | 姓名 | supplierContactName |
-| --phone | -p | string | ⬜ | - | 手机号 | supplierContactPhone |
-| --telephone | -t | string | ⬜ | - | 座机号 | supplierContactTelephone |
-| --email | -e | string | ⬜ | - | 电子邮箱 | supplierContactEmail |
-| --sex | -x | string | ⬜ | - | 性别 | supplierContactSex |
-| --birthday | -b | string | ⬜ | - | 生日(YYYY-MM-DD) | supplierContactBirthday |
-| --qq | -q | string | ⬜ | - | QQ号 | supplierContactQq |
-| --wechat | -w | string | ⬜ | - | 微信号 | supplierContactWechat |
-| --address | -a | string | ⬜ | - | 详细地址 | supplierContactAddress |
-| --default | -d | boolean | ⬜ | - | 是否默认联系人 | defaultFlag |
-| --remark | -r | string | ⬜ | - | 备注 | remark |
-
-**注意**：所有字段在 update 时都是可选的，至少需要提供一个要更新的字段。
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| <contact-id> | supplierContactId | string→Long | @NotNull |
-| --name / -n | supplierContactName | 直接传递 | max=255 |
-| --phone / -p | supplierContactPhone | 直接传递 | max=256 |
-| --telephone / -t | supplierContactTelephone | 直接传递 | max=256 |
-| --email / -e | supplierContactEmail | 直接传递 | max=512 |
-| --sex / -x | supplierContactSex | 直接传递 | max=255 |
-| --birthday / -b | supplierContactBirthday | string→Date | yyyy-MM-dd |
-| --qq / -q | supplierContactQq | 直接传递 | max=512 |
-| --wechat / -w | supplierContactWechat | 直接传递 | max=512 |
-| --address / -a | supplierContactAddress | 直接传递 | max=512 |
-| --default / -d | defaultFlag | boolean→Y/N | max=1 |
-| --remark / -r | remark | 直接传递 | max=255 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-master/master-api/
-    └── src/main/java/com/newpeak/liberica/master/api/exception/enums/
-        └── MasterSupplierContactExceptionEnum.java
-            └── MASTER_SUPPLIER_CONTACT_NOT_EXIST("01001XXX001", "租户供应商联系人不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001XXX001 | 租户供应商联系人不存在 | contact-id 不存在或不属于当前租户 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `EDIT_MASTER_SUPPLIER_CONTACT` | 编辑供应商联系人需要此权限 |
-| 注解 | `@PostResource(requirePermissionCode = "EDIT_MASTER_SUPPLIER_CONTACT")` | Controller方法上 |
-
-## 2.7 实现要点
-
-1. **位置参数**：contact-id 必须指定
-2. **可选字段**：所有业务字段都是可选的，至少提供一个
-3. **dry-run 模式**：预览模式下只显示将要更新的数据，不实际调用 API
-4. **输出格式**：成功后显示更新后的联系人信息
-5. **错误处理**：联系人不存在时显示友好错误信息
-
-## 2.8 示例用法
-
-```bash
-# 更新联系人姓名（dry-run 预览）
-barista liberica supplier-contacts update 12345 --name "新姓名" --dry-run
-
-# 实际更新
-barista liberica supplier-contacts update 12345 --name "新姓名" --phone "13900139000"
-
-# 更新多个字段
-barista liberica supplier-contacts update 12345 --email "new@example.com" --address "新地址"
-
-# JSON 输出
-barista liberica supplier-contacts update 12345 --name "新姓名" --json
-```

package/docs/commands/liberica/teams/issues/close.md

@@ -1,161 +0,0 @@
-# barista liberica teams issues close
-
-关闭团队问题。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica teams issues close <issue-id>` |
-| 功能描述 | 将团队问题状态设置为已关闭（CLOSED） |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
-        └── EnterpriseTeamIssueController.java
-            └── edit(@PostResource(path = "/edit", requiredPermission = true, requirePermissionCode = TeamIssuePermissionConstants.EDIT_TEAM_ISSUE))
-                └── public ResponseData<? extends TeamIssueResponse> edit(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.edit.class) TeamIssueRequest teamIssueRequest
-                    )
-```
-
-**注意**：后端没有独立的 `close` 端点。close 命令内部调用 `POST /edit` API，仅更新 `teamIssueId` 和 `teamIssueStatus` 两个字段。
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
-        └── TeamIssueRequest.java
-            ├── teamIssueId: Long (@NotNull on edit)
-            ├── teamIssueStatus: String (@NotBlank, max=20)
-            └── tenantId: Long
-```
-
-**Close 请求体结构：**
-```json
-{
-  "teamIssueId": 123456789,
-  "teamIssueStatus": "CLOSED"
-}
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
-        └── TeamIssueResponse.java
-            ├── teamIssueId: Long
-            ├── teamIssueCode: String
-            ├── issueTitle: String
-            ├── teamIssueStatus: String
-            ├── priority: String
-            ├── reporterName: String
-            ├── projectId: Long
-            └── closeTime: Instant
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica teams issues close <issue-id> [options]
-```
-
-### Usage
-```bash
-barista liberica teams issues close 123456789
-barista liberica teams issues close 123456789 --json
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| issue-id | string | ✅ | 要关闭的问题ID |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| issue-id (位置参数) | teamIssueId | string→Long | @NotNull |
-| (固定值) | teamIssueStatus | 直接传递 | 固定值为 "CLOSED" |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
-        └── TeamIssueExceptionEnum.java
-            └── TEAM_ISSUE_NOT_EXIST("01001958001", "团队问题不存在")
-```
-
-### Service层业务校验
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-business/
-    └── src/main/java/com/newpeak/liberica/team/modular/business/
-        └── TeamIssueBusiness.java
-            └── edit(TeamIssueRequest request)
-                └── 检查团队问题是否存在
-                    └── throw new TeamServiceException(TeamIssueExceptionEnum.TEAM_ISSUE_NOT_EXIST)
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001958001 | 团队问题不存在 | 关闭的 issue-id 不存在或已被删除 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `TeamIssuePermissionConstants.EDIT_TEAM_ISSUE` | Controller层 `@PostResource(requirePermissionCode = "EDIT_TEAM_ISSUE")` |
-
-## 2.7 实现要点
-
-1. **必填参数**：`issue-id` 作为位置参数必须提供
-2. **内部调用 update API**：close 命令没有独立后端端点，内部构造 `{ teamIssueId, teamIssueStatus: "CLOSED" }` 并调用 `apiClient.updateTeamIssue()`
-3. **不校验前置状态**：不在 CLI 层校验当前状态是否允许关闭，直接透传给后端处理
-4. **Dry-run 支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
-5. **ID 类型处理**：后端使用 Long (BigInteger)，CLI 使用 string 避免精度丢失
-6. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取
-
-## 2.8 示例用法
-
-```bash
-# 关闭问题
-barista liberica teams issues close 123456789
-
-# Dry-run 预览
-barista liberica teams issues close 123456789 --dry-run
-
-# JSON 输出
-barista liberica teams issues close 123456789 --json
-
-# 指定环境
-barista liberica teams issues close 123456789 --env test
-```

package/docs/commands/liberica/teams/issues/create.md

@@ -1,212 +0,0 @@
-# barista liberica teams issues create
-
-创建团队问题。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica teams issues create` |
-| 功能描述 | 创建新的团队问题（Bug、需求或问题） |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
-        └── EnterpriseTeamIssueController.java
-            └── add(@PostResource(path = "/add", requiredPermission = true, requirePermissionCode = TeamIssuePermissionConstants.ADD_TEAM_ISSUE))
-                └── public ResponseData<TeamIssueResponse> add(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.add.class) TeamIssueRequest teamIssueRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
-        └── TeamIssueRequest.java
-            ├── teamIssueCode: String (max=255, 可选，为空则后端自动生成)
-            ├── issueTitle: String (@NotBlank, max=500)
-            ├── issueType: String (max=20)
-            ├── issueDesc: String (@NotNull)
-            ├── projectId: Long (@NotNull)
-            ├── projectCode: String (@NotBlank, max=50)
-            ├── projectName: String (@NotBlank, max=200)
-            ├── reporterAccount: String (max=255)
-            ├── reporterName: String (@NotBlank, max=100)
-            ├── reporterEmail: String (@NotBlank, max=200)
-            ├── reporterTenantId: Long
-            ├── reportDate: Date
-            ├── assignTo: JSON (@NotNull)
-            ├── teamIssueStatus: String (@NotBlank, max=20)
-            ├── priority: String (@NotBlank, max=20)
-            ├── solution: String
-            ├── tags: JSON
-            └── 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/
-        └── TeamIssueResponse.java
-            ├── teamIssueId: Long
-            ├── teamIssueCode: String
-            ├── issueTitle: String
-            ├── issueType: String
-            ├── teamIssueStatus: String
-            ├── priority: String
-            ├── reporterName: String
-            ├── projectId: Long
-            ├── projectCode: String
-            ├── projectName: String
-            └── createTime: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica teams issues create [options]
-```
-
-### Usage
-```bash
-barista liberica teams issues create --title "示例" --desc "描述" --type BUG --project-id 1 --project-code "P1" --project-name "项目"
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --title | -t | string | ✅ | - | 问题标题 | issueTitle |
-| --desc | -d | string | ✅ | - | 问题描述 | issueDesc |
-| --type | -y | string | ✅ | - | 问题类型（BUG/REQUIREMENT/QUESTION） | issueType |
-| --project-id | — | string | ✅ | - | 所属项目ID | projectId |
-| --project-code | — | string | ✅ | - | 所属项目代号 | projectCode |
-| --project-name | — | string | ✅ | - | 所属项目名称 | projectName |
-| --priority | -p | string | ⬜ | MEDIUM | 优先级（LOW/MEDIUM/HIGH/URGENT） | priority |
-| --status | -s | string | ⬜ | OPEN | 问题状态（OPEN/IN_PROGRESS/RESOLVED/CLOSED） | teamIssueStatus |
-| --assign-to | -a | string | ⬜ | - | 负责人ID列表，逗号分隔 | assignTo |
-| --tags | — | string | ⬜ | - | 标签列表，逗号分隔 | tags |
-| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| --title / -t | issueTitle | 直接传递 | @NotBlank, max=500 |
-| --desc / -d | issueDesc | 直接传递 | @NotNull |
-| --type / -y | issueType | 直接传递 | BUG, REQUIREMENT, QUESTION |
-| --project-id | projectId | string→Long | @NotNull |
-| --project-code | projectCode | 直接传递 | @NotBlank, max=50 |
-| --project-name | projectName | 直接传递 | @NotBlank, max=200 |
-| --priority / -p | priority | 直接传递 | LOW, MEDIUM, HIGH, URGENT |
-| --status / -s | teamIssueStatus | 直接传递 | OPEN, IN_PROGRESS, RESOLVED, CLOSED |
-| --assign-to / -a | assignTo | string→JSON数组 | @NotNull，逗号分隔用户ID |
-| --tags | tags | string→JSON数组 | 逗号分隔标签 |
-
-**自动填充字段（不通过CLI参数）：**
-| 字段 | 来源 |
-|------|------|
-| tenantId | 后端从 X-TENANT-ID header 注入 |
-| reporterAccount | 当前认证用户上下文自动填充 |
-| reporterName | 当前认证用户上下文自动填充 |
-| reporterEmail | 当前认证用户上下文自动填充 |
-| reporterTenantId | 当前认证用户上下文自动填充 |
-| reportDate | 自动填充当前系统日期 |
-| teamIssueCode | 为空时后端自动生成编码 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
-        └── TeamIssueExceptionEnum.java
-            └── TEAM_ISSUE_NOT_EXIST("01001958001", "团队问题不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001958001 | 团队问题不存在 | copy/edit 时引用的原问题不存在 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `TeamIssuePermissionConstants.ADD_TEAM_ISSUE` | Controller层 `@PostResource(requirePermissionCode = "ADD_TEAM_ISSUE")` |
-
-## 2.7 实现要点
-
-1. **必填字段**：`--title`、`--desc`、`--type`、`--project-id`、`--project-code`、`--project-name` 必须提供
-2. **默认值**：`--priority` 默认 `MEDIUM`，`--status` 默认 `OPEN`，`--reportDate` 自动填充当前日期
-3. **Reporter 自动填充**：`reporterAccount`、`reporterName`、`reporterEmail` 从当前认证用户上下文获取
-4. **assignTo / tags 序列化**：逗号分隔的字符串需要在 CLI 内部转换为 JSON 数组格式再发送到后端
-5. **Dry-run 支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
-6. **tenantId 来源**：来自 X-TENANT-ID header，不通过请求体传递
-7. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取
-
-## 2.8 示例用法
-
-```bash
-# 最小参数创建
-barista liberica teams issues create \
-  --title "登录页面样式异常" \
-  --desc "在移动端浏览器中，登录按钮被遮挡" \
-  --type BUG \
-  --project-id 123456789 \
-  --project-code "ERP" \
-  --project-name "ERP系统"
-
-# 完整参数创建
-barista liberica teams issues create \
-  --title "新增报表导出功能" \
-  --desc "支持将销售报表导出为 Excel 格式" \
-  --type REQUIREMENT \
-  --project-id 123456789 \
-  --project-code "ERP" \
-  --project-name "ERP系统" \
-  --priority HIGH \
-  --status OPEN \
-  --assign-to "111,222,333" \
-  --tags "销售,报表,高优先级"
-
-# Dry-run 预览
-barista liberica teams issues create \
-  --title "测试问题" \
-  --desc "测试描述" \
-  --type QUESTION \
-  --project-id 123456789 \
-  --project-code "TEST" \
-  --project-name "测试项目" \
-  --dry-run
-
-# JSON 输出
-barista liberica teams issues create \
-  --title "测试问题" \
-  --desc "测试描述" \
-  --type BUG \
-  --project-id 123456789 \
-  --project-code "TEST" \
-  --project-name "测试项目" \
-  --json
-```