@newpeak/barista-cli 0.1.8 → 0.1.10

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

@@ -0,0 +1,202 @@
+# barista liberica teams issues update
+
+更新团队问题。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica teams issues update <issue-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/
+        └── 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
+                    )
+```
+
+### 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)
+            ├── 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)
+            ├── 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
+            └── updateTime: String
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica teams issues update <issue-id> [options]
+```
+
+### Usage
+```bash
+barista liberica teams issues update 123456789 --title "新标题"
+barista liberica teams issues update 123456789 --status CLOSED
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--dry-run` | boolean | 预览模式（不实际调用API） |
+| `--json` | boolean | JSON输出 |
+
+### 位置参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| issue-id | string | ✅ | 要更新的问题ID |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --title | -t | string | ⬜ | - | 问题标题 | issueTitle |
+| --desc | -d | string | ⬜ | - | 问题描述 | issueDesc |
+| --type | -y | string | ⬜ | - | 问题类型（BUG/REQUIREMENT/QUESTION） | issueType |
+| --status | -s | string | ⬜ | - | 问题状态（OPEN/IN_PROGRESS/RESOLVED/CLOSED） | teamIssueStatus |
+| --priority | -p | string | ⬜ | - | 优先级（LOW/MEDIUM/HIGH/URGENT） | priority |
+| --project-id | — | string | ⬜ | - | 所属项目ID | projectId |
+| --project-code | — | string | ⬜ | - | 所属项目代号 | projectCode |
+| --project-name | — | string | ⬜ | - | 所属项目名称 | projectName |
+| --assign-to | -a | string | ⬜ | - | 负责人ID列表，逗号分隔 | assignTo |
+| --tags | — | string | ⬜ | - | 标签列表，逗号分隔 | tags |
+| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| issue-id (位置参数) | teamIssueId | string→Long | @NotNull |
+| --title / -t | issueTitle | 直接传递 | @NotBlank, max=500 |
+| --desc / -d | issueDesc | 直接传递 | @NotNull |
+| --type / -y | issueType | 直接传递 | BUG, REQUIREMENT, QUESTION |
+| --status / -s | teamIssueStatus | 直接传递 | OPEN, IN_PROGRESS, RESOLVED, CLOSED |
+| --priority / -p | priority | 直接传递 | LOW, MEDIUM, HIGH, URGENT |
+| --project-id | projectId | string→Long | @NotNull |
+| --project-code | projectCode | 直接传递 | @NotBlank, max=50 |
+| --project-name | projectName | 直接传递 | @NotBlank, max=200 |
+| --assign-to / -a | assignTo | string→JSON数组 | @NotNull |
+| --tags | tags | string→JSON数组 | 逗号分隔标签 |
+
+## 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. **部分更新**：只传入的选项才会被包含在请求体中，未传入的字段保持原值
+3. **assignTo / tags 序列化**：逗号分隔的字符串需要在 CLI 内部转换为 JSON 数组格式
+4. **Dry-run 支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
+5. **状态流转**：不在 CLI 层做状态机校验，直接透传给后端
+6. **ID 类型处理**：`teamIssueId`、`projectId` 后端使用 Long (BigInteger)，CLI 使用 string 避免精度丢失
+7. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取
+
+## 2.8 示例用法
+
+```bash
+# 更新标题
+barista liberica teams issues update 123456789 --title "修正后的标题"
+
+# 更新状态和优先级
+barista liberica teams issues update 123456789 \
+  --status IN_PROGRESS \
+  --priority HIGH
+
+# 更新指派人和标签
+barista liberica teams issues update 123456789 \
+  --assign-to "111,222" \
+  --tags "前端,紧急"
+
+# 更新项目信息
+barista liberica teams issues update 123456789 \
+  --project-id 987654321 \
+  --project-code "CRM" \
+  --project-name "CRM系统"
+
+# Dry-run 预览
+barista liberica teams issues update 123456789 --title "测试更新" --dry-run
+
+# JSON 输出
+barista liberica teams issues update 123456789 --title "测试更新" --json
+```

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

@@ -0,0 +1,174 @@
+# barista liberica teams projects create
+
+创建团队项目。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica teams projects 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/
+        └── EnterpriseTeamProjectController.java
+            └── add(@PostResource(path = "/add", requiredPermission = true, requirePermissionCode = TeamProjectPermissionConstants.ADD_TEAM_PROJECT))
+                └── public ResponseData<TeamProjectResponse> add(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.add.class) TeamProjectRequest teamProjectRequest
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
+        └── TeamProjectRequest.java
+            ├── projectCode: String (@NotBlank, max=50)
+            ├── projectName: String (@NotBlank, max=200)
+            ├── parentProjectId: Long
+            ├── projectLevel: Integer
+            ├── projectDesc: String
+            ├── teamProjectStatus: String (max=20)
+            └── tenantId: Long
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
+        └── TeamProjectResponse.java
+            ├── teamProjectId: Long
+            ├── projectCode: String
+            ├── projectName: String
+            ├── parentProjectId: Long
+            ├── projectLevel: Integer
+            ├── projectDesc: String
+            ├── teamProjectStatus: String
+            ├── createTime: String
+            └── updateTime: String
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica teams projects create [options]
+```
+
+### Usage
+```bash
+barista liberica teams projects create --name "示例项目" --code "P001"
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--dry-run` | boolean | 预览模式（不实际调用API） |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --name | -n | string | ✅ | - | 项目名称 | projectName |
+| --code | -c | string | ✅ | - | 项目代号 | projectCode |
+| --desc | -d | string | ⬜ | - | 项目描述 | projectDesc |
+| --status | -s | string | ⬜ | ACTIVE | 项目状态 | teamProjectStatus |
+| --parent-id | — | string | ⬜ | - | 父项目ID | parentProjectId |
+| --level | -l | number | ⬜ | 1 | 项目级别 | projectLevel |
+| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| --name / -n | projectName | 直接传递 | @NotBlank, max=200 |
+| --code / -c | projectCode | 直接传递 | @NotBlank, max=50 |
+| --desc / -d | projectDesc | 直接传递 | - |
+| --status / -s | teamProjectStatus | 直接传递 | max=20 |
+| --parent-id | parentProjectId | string→Long | - |
+| --level / -l | projectLevel | number→Integer | - |
+
+**自动填充字段（不通过CLI参数）：**
+| 字段 | 来源 |
+|------|------|
+| tenantId | 后端从 X-TENANT-ID header 注入 |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
+        └── TeamProjectExceptionEnum.java
+            └── TEAM_PROJECT_NOT_EXIST("01001957001", "团队项目不存在")
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| 01001957001 | 团队项目不存在 | copy/edit 时引用的原项目不存在 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| PermissionConstants | `TeamProjectPermissionConstants.ADD_TEAM_PROJECT` | Controller层 `@PostResource(requirePermissionCode = "ADD_TEAM_PROJECT")` |
+
+## 2.7 实现要点
+
+1. **必填字段**：`--name`、`--code` 必须提供
+2. **默认值**：`--status` 默认 `ACTIVE`，`--level` 默认 `1`
+3. **Dry-run 支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
+4. **tenantId 来源**：来自 X-TENANT-ID header，不通过请求体传递
+5. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取
+6. **ID 类型处理**：`parentProjectId` 后端使用 Long (BigInteger)，CLI 使用 string 避免精度丢失
+
+## 2.8 示例用法
+
+```bash
+# 最小参数创建
+barista liberica teams projects create \
+  --name "ERP系统" \
+  --code "ERP"
+
+# 完整参数创建
+barista liberica teams projects create \
+  --name "ERP系统" \
+  --code "ERP" \
+  --desc "企业资源计划系统" \
+  --status ACTIVE \
+  --level 1
+
+# 创建子项目
+barista liberica teams projects create \
+  --name "销售模块" \
+  --code "ERP-SALES" \
+  --parent-id 123456789 \
+  --level 2
+
+# Dry-run 预览
+barista liberica teams projects create \
+  --name "测试项目" \
+  --code "TEST" \
+  --dry-run
+
+# JSON 输出
+barista liberica teams projects create \
+  --name "测试项目" \
+  --code "TEST" \
+  --json
+```

package/docs/commands/liberica/teams/projects/delete.md

@@ -0,0 +1,180 @@
+# barista liberica teams projects delete
+
+删除团队项目。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica teams projects delete <project-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/
+        └── EnterpriseTeamProjectController.java
+            └── delete(@PostResource(path = "/delete", requiredPermission = true, requirePermissionCode = TeamProjectPermissionConstants.DEL_TEAM_PROJECT))
+                └── public ResponseData<?> delete(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.delete.class) TeamProjectRequest teamProjectRequest
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
+        └── TeamProjectRequest.java
+            ├── teamProjectId: Long (@NotNull on delete)
+            └── tenantId: Long
+```
+
+**删除请求体结构：**
+```json
+{
+  "teamProjectId": 123456789
+}
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
+        └── TeamProjectResponse.java
+            ├── teamProjectId: Long
+            ├── projectCode: String
+            ├── projectName: String
+            ├── teamProjectStatus: String
+            └── createTime: String
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica teams projects delete <project-id> [options]
+```
+
+### Usage
+```bash
+barista liberica teams projects delete 123456789
+barista liberica teams projects delete 123456789 --force
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--json` | boolean | JSON输出 |
+
+### 位置参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| project-id | string | ✅ | 要删除的项目ID |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --force | -f | boolean | ⬜ | false | 跳过确认直接删除 | - |
+| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| project-id (位置参数) | teamProjectId | string→Long | @NotNull |
+
+## 2.5 确认流程
+
+删除操作默认启用dry-run行为，需要用户显式确认：
+
+### 默认行为（无--force）
+```bash
+$ barista liberica teams projects delete 123456789
+
+⚠️  Delete Team Project
+
+  Project ID: 123456789
+  Name: ERP系统
+  Code: ERP
+
+Add --force to confirm deletion
+```
+
+### 强制删除（带--force）
+```bash
+$ barista liberica teams projects delete 123456789 --force
+
+✓ Project "ERP系统" (ID: 123456789) deleted
+```
+
+## 2.6 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
+        └── TeamProjectExceptionEnum.java
+            └── TEAM_PROJECT_NOT_EXIST("01001957001", "团队项目不存在")
+```
+
+### Service层业务校验
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-business/
+    └── src/main/java/com/newpeak/liberica/team/modular/business/
+        └── TeamProjectBusiness.java
+            └── del(TeamProjectRequest request)
+                └── 检查团队项目是否存在
+                    └── throw new TeamServiceException(TeamProjectExceptionEnum.TEAM_PROJECT_NOT_EXIST)
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| 01001957001 | 团队项目不存在 | 删除的 project-id 不存在或已被删除 |
+
+## 2.7 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| PermissionConstants | `TeamProjectPermissionConstants.DEL_TEAM_PROJECT` | Controller层 `@PostResource(requirePermissionCode = "DEL_TEAM_PROJECT")` |
+
+## 2.8 实现要点
+
+1. **必填参数**：`project-id` 作为位置参数必须提供
+2. **Dry-run 默认开启**：不带 `--force` 时只显示提示信息，不调用删除 API，exit(0)
+3. **强制删除**：添加 `--force` 后调用 `/delete` API 执行实际删除
+4. **ID 类型处理**：后端使用 Long (BigInteger)，CLI 使用 string 避免精度丢失
+5. **权限要求**：需要 `DEL_TEAM_PROJECT` 权限
+6. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取
+
+## 2.9 示例用法
+
+```bash
+# 预览删除（默认行为，不实际删除）
+barista liberica teams projects delete 123456789
+
+# 强制删除
+barista liberica teams projects delete 123456789 --force
+
+# 指定环境删除
+barista liberica teams projects delete 123456789 --env test --force
+
+# JSON 输出预览
+barista liberica teams projects delete 123456789 --json
+
+# JSON 输出并强制删除
+barista liberica teams projects delete 123456789 --force --json
+```

package/docs/commands/liberica/teams/projects/get.md

@@ -0,0 +1,150 @@
+# barista liberica teams projects get
+
+查询团队项目详情。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica teams projects get <project-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/
+        └── EnterpriseTeamProjectController.java
+            └── detail(@GetResource(path = "/detail"))
+                └── public ResponseData<TeamProjectResponse> detail(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @ParameterObject @Validated(BaseRequest.detail.class) TeamProjectRequest teamProjectRequest
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
+        └── TeamProjectRequest.java
+            ├── teamProjectId: Long (@NotNull on detail)
+            └── tenantId: Long
+```
+
+**请求参数结构：**
+```
+GET /api/enterprise/team/project/detail?teamProjectId={id}
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
+        └── TeamProjectResponse.java
+            ├── teamProjectId: Long
+            ├── projectCode: String
+            ├── projectName: String
+            ├── parentProjectId: Long
+            ├── projectLevel: Integer
+            ├── projectDesc: String
+            ├── teamProjectStatus: String
+            ├── createTime: String
+            └── updateTime: String
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica teams projects get <project-id> [options]
+```
+
+### Usage
+```bash
+barista liberica teams projects get 123456789
+barista liberica teams projects get 123456789 --json
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--json` | boolean | JSON输出 |
+
+### 位置参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| project-id | string | ✅ | 项目ID |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| project-id (位置参数) | teamProjectId | string→Long | @NotNull |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
+        └── TeamProjectExceptionEnum.java
+            └── TEAM_PROJECT_NOT_EXIST("01001957001", "团队项目不存在")
+```
+
+### Service层业务校验
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-business/
+    └── src/main/java/com/newpeak/liberica/team/modular/business/
+        └── TeamProjectBusiness.java
+            └── detail(TeamProjectRequest request)
+                └── 检查团队项目是否存在
+                    └── throw new TeamServiceException(TeamProjectExceptionEnum.TEAM_PROJECT_NOT_EXIST)
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| 01001957001 | 团队项目不存在 | 查询的 project-id 不存在或已被删除 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| 注解 | `@GetResource(path = "/detail")` | 无 requiredPermission（详情查询无需权限码） |
+
+## 2.7 实现要点
+
+1. **必填参数**：`project-id` 作为位置参数必须提供
+2. **API 调用方式**：通过 URL 查询参数传递 `teamProjectId`，如 `/detail?teamProjectId={id}`
+3. **ID 类型处理**：后端使用 Long (BigInteger)，CLI 使用 string 避免精度丢失
+4. **输出格式**：默认以键值对形式展示项目详情；`--json` 时输出完整响应 JSON
+5. **错误处理**：如果返回 `!response.success`，输出错误信息并 `process.exit(1)`
+
+## 2.8 示例用法
+
+```bash
+# 查询详情
+barista liberica teams projects get 123456789
+
+# JSON 输出
+barista liberica teams projects get 123456789 --json
+
+# 指定环境
+barista liberica teams projects get 123456789 --env test
+```