@newpeak/barista-cli 0.1.10 → 0.1.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +1 -1
- package/package.json +7 -3
- package/docs/ARCHITECTURE.md +0 -184
- package/docs/COMMANDS.md +0 -352
- package/docs/COMMAND_DESIGN_SPEC.md +0 -840
- package/docs/INTEGRATION_NOTES.md +0 -270
- package/docs/commands/REFERENCE.md +0 -323
- package/docs/commands/arabica/auth/index.md +0 -296
- package/docs/commands/liberica/auth/index.md +0 -133
- package/docs/commands/liberica/calendar/DESIGN.md +0 -333
- package/docs/commands/liberica/client-contacts/create.md +0 -152
- package/docs/commands/liberica/client-contacts/delete.md +0 -123
- package/docs/commands/liberica/client-contacts/get.md +0 -133
- package/docs/commands/liberica/client-contacts/list.md +0 -143
- package/docs/commands/liberica/client-contacts/update.md +0 -158
- package/docs/commands/liberica/context/index.md +0 -60
- package/docs/commands/liberica/currency/create.md +0 -145
- package/docs/commands/liberica/currency/delete.md +0 -121
- package/docs/commands/liberica/currency/disable.md +0 -119
- package/docs/commands/liberica/currency/enable.md +0 -115
- package/docs/commands/liberica/currency/get.md +0 -118
- package/docs/commands/liberica/currency/list.md +0 -149
- package/docs/commands/liberica/currency/update.md +0 -141
- package/docs/commands/liberica/employees/create.md +0 -185
- package/docs/commands/liberica/employees/disable.md +0 -138
- package/docs/commands/liberica/employees/enable.md +0 -137
- package/docs/commands/liberica/employees/get.md +0 -153
- package/docs/commands/liberica/employees/list.md +0 -168
- package/docs/commands/liberica/employees/update.md +0 -180
- package/docs/commands/liberica/locations/create.md +0 -195
- package/docs/commands/liberica/locations/list.md +0 -171
- package/docs/commands/liberica/materials/create.md +0 -293
- package/docs/commands/liberica/materials/delete.md +0 -240
- package/docs/commands/liberica/materials/disable.md +0 -150
- package/docs/commands/liberica/materials/enable.md +0 -146
- package/docs/commands/liberica/materials/get.md +0 -188
- package/docs/commands/liberica/materials/list.md +0 -198
- package/docs/commands/liberica/materials/update.md +0 -250
- package/docs/commands/liberica/orgs/list.md +0 -62
- package/docs/commands/liberica/positions/list.md +0 -61
- package/docs/commands/liberica/roles/list.md +0 -67
- package/docs/commands/liberica/stock/ledger.md +0 -209
- package/docs/commands/liberica/stock/list.md +0 -165
- package/docs/commands/liberica/supplier-contacts/create.md +0 -152
- package/docs/commands/liberica/supplier-contacts/delete.md +0 -123
- package/docs/commands/liberica/supplier-contacts/get.md +0 -133
- package/docs/commands/liberica/supplier-contacts/list.md +0 -143
- package/docs/commands/liberica/supplier-contacts/update.md +0 -158
- package/docs/commands/liberica/teams/issues/close.md +0 -161
- package/docs/commands/liberica/teams/issues/create.md +0 -212
- package/docs/commands/liberica/teams/issues/delete.md +0 -179
- package/docs/commands/liberica/teams/issues/get.md +0 -167
- package/docs/commands/liberica/teams/issues/list.md +0 -182
- package/docs/commands/liberica/teams/issues/tests-design.md +0 -341
- package/docs/commands/liberica/teams/issues/update.md +0 -202
- package/docs/commands/liberica/teams/projects/create.md +0 -174
- package/docs/commands/liberica/teams/projects/delete.md +0 -180
- package/docs/commands/liberica/teams/projects/get.md +0 -150
- package/docs/commands/liberica/teams/projects/list.md +0 -179
- package/docs/commands/liberica/teams/projects/update.md +0 -175
- package/docs/commands/liberica/teams/tasks/create.md +0 -163
- package/docs/commands/liberica/teams/tasks/delete.md +0 -109
- package/docs/commands/liberica/teams/tasks/get.md +0 -121
- package/docs/commands/liberica/teams/tasks/list.md +0 -148
- package/docs/commands/liberica/teams/tasks/update.md +0 -158
- package/docs/commands/liberica/teams/work-logs/create.md +0 -151
- package/docs/commands/liberica/teams/work-logs/delete.md +0 -130
- package/docs/commands/liberica/teams/work-logs/get.md +0 -131
- package/docs/commands/liberica/teams/work-logs/list.md +0 -153
- package/docs/commands/liberica/teams/work-logs/update.md +0 -150
- package/docs/commands/liberica/transfer-in-forms/batch-delete.md +0 -157
- package/docs/commands/liberica/transfer-in-forms/batch-review.md +0 -157
- package/docs/commands/liberica/transfer-in-forms/batch-unreview.md +0 -157
- package/docs/commands/liberica/transfer-in-forms/create.md +0 -220
- package/docs/commands/liberica/transfer-in-forms/get.md +0 -221
- package/docs/commands/liberica/transfer-in-forms/list.md +0 -242
- package/docs/commands/liberica/transfer-in-forms/update.md +0 -185
- package/docs/commands/liberica/transfer-out-forms/batch-delete.md +0 -187
- package/docs/commands/liberica/transfer-out-forms/batch-review.md +0 -157
- package/docs/commands/liberica/transfer-out-forms/batch-unreview.md +0 -157
- package/docs/commands/liberica/transfer-out-forms/create.md +0 -280
- package/docs/commands/liberica/transfer-out-forms/get.md +0 -211
- package/docs/commands/liberica/transfer-out-forms/list.md +0 -233
- package/docs/commands/liberica/transfer-out-forms/update.md +0 -286
- package/docs/commands/liberica/uoms/create.md +0 -136
- package/docs/commands/liberica/uoms/delete.md +0 -119
- package/docs/commands/liberica/uoms/disable.md +0 -117
- package/docs/commands/liberica/uoms/enable.md +0 -115
- package/docs/commands/liberica/uoms/get.md +0 -119
- package/docs/commands/liberica/uoms/list.md +0 -155
- package/docs/commands/liberica/uoms/update.md +0 -148
- package/docs/commands/liberica/users/create.md +0 -170
- package/docs/commands/liberica/users/get.md +0 -151
- package/docs/commands/liberica/users/list.md +0 -175
- package/docs/commands/liberica/warehouses/create.md +0 -222
- package/docs/commands/liberica/warehouses/list.md +0 -184
- package/src/commands/arabica/auth/index.ts +0 -277
- package/src/commands/arabica/auth/login.ts +0 -5
- package/src/commands/arabica/auth/logout.ts +0 -5
- package/src/commands/arabica/auth/register.ts +0 -5
- package/src/commands/arabica/auth/status.ts +0 -5
- package/src/commands/arabica/index.ts +0 -23
- package/src/commands/auth.ts +0 -107
- package/src/commands/context.ts +0 -60
- package/src/commands/liberica/auth/index.ts +0 -176
- package/src/commands/liberica/calendar/index.ts +0 -13
- package/src/commands/liberica/calendar/list.ts +0 -214
- package/src/commands/liberica/calendar/set.ts +0 -130
- package/src/commands/liberica/client-contacts/create.ts +0 -115
- package/src/commands/liberica/client-contacts/delete.ts +0 -140
- package/src/commands/liberica/client-contacts/get.ts +0 -103
- package/src/commands/liberica/client-contacts/index.ts +0 -19
- package/src/commands/liberica/client-contacts/list.ts +0 -118
- package/src/commands/liberica/client-contacts/update.ts +0 -137
- package/src/commands/liberica/clients/create.ts +0 -122
- package/src/commands/liberica/clients/delete.ts +0 -125
- package/src/commands/liberica/clients/get.ts +0 -88
- package/src/commands/liberica/clients/index.ts +0 -19
- package/src/commands/liberica/clients/list.ts +0 -123
- package/src/commands/liberica/clients/update.ts +0 -103
- package/src/commands/liberica/context/index.ts +0 -43
- package/src/commands/liberica/currency/create.ts +0 -183
- package/src/commands/liberica/currency/delete.ts +0 -124
- package/src/commands/liberica/currency/disable.ts +0 -147
- package/src/commands/liberica/currency/enable.ts +0 -128
- package/src/commands/liberica/currency/get.ts +0 -91
- package/src/commands/liberica/currency/index.ts +0 -23
- package/src/commands/liberica/currency/list.ts +0 -140
- package/src/commands/liberica/currency/update.ts +0 -129
- package/src/commands/liberica/dict-types/get.ts +0 -74
- package/src/commands/liberica/dict-types/index.ts +0 -15
- package/src/commands/liberica/dict-types/list.ts +0 -118
- package/src/commands/liberica/dict-types/update.ts +0 -134
- package/src/commands/liberica/dicts/create.ts +0 -175
- package/src/commands/liberica/dicts/delete.ts +0 -107
- package/src/commands/liberica/dicts/get.ts +0 -80
- package/src/commands/liberica/dicts/index.ts +0 -19
- package/src/commands/liberica/dicts/list.ts +0 -114
- package/src/commands/liberica/dicts/update.ts +0 -116
- package/src/commands/liberica/employees/create.ts +0 -275
- package/src/commands/liberica/employees/delete.ts +0 -122
- package/src/commands/liberica/employees/disable.ts +0 -97
- package/src/commands/liberica/employees/enable.ts +0 -97
- package/src/commands/liberica/employees/get.ts +0 -115
- package/src/commands/liberica/employees/index.ts +0 -23
- package/src/commands/liberica/employees/list.ts +0 -131
- package/src/commands/liberica/employees/update.ts +0 -157
- package/src/commands/liberica/index.ts +0 -81
- package/src/commands/liberica/materials/create.ts +0 -199
- package/src/commands/liberica/materials/delete.ts +0 -105
- package/src/commands/liberica/materials/disable.ts +0 -148
- package/src/commands/liberica/materials/enable.ts +0 -129
- package/src/commands/liberica/materials/get.ts +0 -83
- package/src/commands/liberica/materials/index.ts +0 -23
- package/src/commands/liberica/materials/list.ts +0 -142
- package/src/commands/liberica/materials/update.ts +0 -125
- package/src/commands/liberica/mould/get.ts +0 -111
- package/src/commands/liberica/mould/index.ts +0 -17
- package/src/commands/liberica/mould/list.ts +0 -157
- package/src/commands/liberica/mould/set-status.ts +0 -99
- package/src/commands/liberica/mould/stock-in.ts +0 -165
- package/src/commands/liberica/operations/active.ts +0 -153
- package/src/commands/liberica/operations/batch-delete.ts +0 -131
- package/src/commands/liberica/operations/copy.ts +0 -138
- package/src/commands/liberica/operations/create.ts +0 -223
- package/src/commands/liberica/operations/deactive.ts +0 -152
- package/src/commands/liberica/operations/delete.ts +0 -128
- package/src/commands/liberica/operations/design.md +0 -587
- package/src/commands/liberica/operations/get.ts +0 -112
- package/src/commands/liberica/operations/index.ts +0 -27
- package/src/commands/liberica/operations/list.ts +0 -180
- package/src/commands/liberica/operations/update.ts +0 -218
- package/src/commands/liberica/orgs/index.ts +0 -34
- package/src/commands/liberica/positions/index.ts +0 -30
- package/src/commands/liberica/roles/index.ts +0 -59
- package/src/commands/liberica/stock/index.ts +0 -13
- package/src/commands/liberica/stock/ledger.ts +0 -159
- package/src/commands/liberica/stock/list.ts +0 -128
- package/src/commands/liberica/supplier-contacts/create.ts +0 -120
- package/src/commands/liberica/supplier-contacts/delete.ts +0 -88
- package/src/commands/liberica/supplier-contacts/get.ts +0 -94
- package/src/commands/liberica/supplier-contacts/index.ts +0 -19
- package/src/commands/liberica/supplier-contacts/list.ts +0 -130
- package/src/commands/liberica/supplier-contacts/update.ts +0 -127
- package/src/commands/liberica/suppliers/create.ts +0 -149
- package/src/commands/liberica/suppliers/delete.ts +0 -102
- package/src/commands/liberica/suppliers/disable.ts +0 -145
- package/src/commands/liberica/suppliers/enable.ts +0 -126
- package/src/commands/liberica/suppliers/get.ts +0 -86
- package/src/commands/liberica/suppliers/index.ts +0 -23
- package/src/commands/liberica/suppliers/list.ts +0 -134
- package/src/commands/liberica/suppliers/update.ts +0 -128
- package/src/commands/liberica/teams/index.ts +0 -17
- package/src/commands/liberica/teams/issues/close.ts +0 -104
- package/src/commands/liberica/teams/issues/create.ts +0 -254
- package/src/commands/liberica/teams/issues/delete.ts +0 -58
- package/src/commands/liberica/teams/issues/get.ts +0 -78
- package/src/commands/liberica/teams/issues/index.ts +0 -21
- package/src/commands/liberica/teams/issues/list.ts +0 -144
- package/src/commands/liberica/teams/issues/update.ts +0 -141
- package/src/commands/liberica/teams/projects/create.ts +0 -159
- package/src/commands/liberica/teams/projects/delete.ts +0 -58
- package/src/commands/liberica/teams/projects/get.ts +0 -87
- package/src/commands/liberica/teams/projects/index.ts +0 -19
- package/src/commands/liberica/teams/projects/list.ts +0 -147
- package/src/commands/liberica/teams/projects/update.ts +0 -117
- package/src/commands/liberica/teams/tasks/create.ts +0 -102
- package/src/commands/liberica/teams/tasks/delete.ts +0 -92
- package/src/commands/liberica/teams/tasks/get.ts +0 -64
- package/src/commands/liberica/teams/tasks/index.ts +0 -19
- package/src/commands/liberica/teams/tasks/list.ts +0 -102
- package/src/commands/liberica/teams/tasks/update.ts +0 -122
- package/src/commands/liberica/teams/work-logs/create.ts +0 -204
- package/src/commands/liberica/teams/work-logs/delete.ts +0 -58
- package/src/commands/liberica/teams/work-logs/get.ts +0 -87
- package/src/commands/liberica/teams/work-logs/index.ts +0 -19
- package/src/commands/liberica/teams/work-logs/list.ts +0 -141
- package/src/commands/liberica/teams/work-logs/update.ts +0 -120
- package/src/commands/liberica/transfer-in-forms/batch-delete.ts +0 -152
- package/src/commands/liberica/transfer-in-forms/batch-review.ts +0 -151
- package/src/commands/liberica/transfer-in-forms/batch-unreview.ts +0 -152
- package/src/commands/liberica/transfer-in-forms/create.ts +0 -179
- package/src/commands/liberica/transfer-in-forms/get.ts +0 -107
- package/src/commands/liberica/transfer-in-forms/index.ts +0 -23
- package/src/commands/liberica/transfer-in-forms/list.ts +0 -97
- package/src/commands/liberica/transfer-in-forms/update.ts +0 -213
- package/src/commands/liberica/transfer-out-forms/batch-delete.ts +0 -83
- package/src/commands/liberica/transfer-out-forms/batch-review.ts +0 -148
- package/src/commands/liberica/transfer-out-forms/batch-unreview.ts +0 -56
- package/src/commands/liberica/transfer-out-forms/create.ts +0 -194
- package/src/commands/liberica/transfer-out-forms/get.ts +0 -114
- package/src/commands/liberica/transfer-out-forms/index.ts +0 -23
- package/src/commands/liberica/transfer-out-forms/list.ts +0 -125
- package/src/commands/liberica/transfer-out-forms/update.ts +0 -197
- package/src/commands/liberica/uoms/create.ts +0 -134
- package/src/commands/liberica/uoms/delete.ts +0 -105
- package/src/commands/liberica/uoms/disable.ts +0 -148
- package/src/commands/liberica/uoms/enable.ts +0 -129
- package/src/commands/liberica/uoms/get.ts +0 -83
- package/src/commands/liberica/uoms/index.ts +0 -23
- package/src/commands/liberica/uoms/list.ts +0 -129
- package/src/commands/liberica/uoms/update.ts +0 -124
- package/src/commands/liberica/users/create.ts +0 -133
- package/src/commands/liberica/users/delete.ts +0 -49
- package/src/commands/liberica/users/disable.ts +0 -41
- package/src/commands/liberica/users/enable.ts +0 -30
- package/src/commands/liberica/users/get.ts +0 -46
- package/src/commands/liberica/users/index.ts +0 -27
- package/src/commands/liberica/users/list.ts +0 -68
- package/src/commands/liberica/users/me.ts +0 -42
- package/src/commands/liberica/users/reset-password.ts +0 -42
- package/src/commands/liberica/users/update.ts +0 -48
- package/src/commands/liberica/warehouses/create.ts +0 -204
- package/src/commands/liberica/warehouses/delete.ts +0 -112
- package/src/commands/liberica/warehouses/disable.ts +0 -174
- package/src/commands/liberica/warehouses/enable.ts +0 -174
- package/src/commands/liberica/warehouses/get.ts +0 -101
- package/src/commands/liberica/warehouses/index.ts +0 -25
- package/src/commands/liberica/warehouses/list.ts +0 -136
- package/src/commands/liberica/warehouses/locations/create.ts +0 -209
- package/src/commands/liberica/warehouses/locations/delete.ts +0 -116
- package/src/commands/liberica/warehouses/locations/disable.ts +0 -174
- package/src/commands/liberica/warehouses/locations/enable.ts +0 -174
- package/src/commands/liberica/warehouses/locations/get.ts +0 -84
- package/src/commands/liberica/warehouses/locations/index.ts +0 -23
- package/src/commands/liberica/warehouses/locations/list.ts +0 -140
- package/src/commands/liberica/warehouses/locations/update.ts +0 -135
- package/src/commands/liberica/warehouses/update.ts +0 -142
- package/src/core/api/client.ts +0 -4443
- package/src/core/auth/token-manager.ts +0 -183
- package/src/core/config/manager.ts +0 -164
- package/src/index.ts +0 -35
- package/src/types/calendar.ts +0 -36
- package/src/types/client-contact.ts +0 -78
- package/src/types/client.ts +0 -115
- package/src/types/currency.ts +0 -90
- package/src/types/dict.ts +0 -121
- package/src/types/employee.ts +0 -102
- package/src/types/index.ts +0 -93
- package/src/types/location.ts +0 -66
- package/src/types/material.ts +0 -61
- package/src/types/mould-stock-in.ts +0 -82
- package/src/types/mould.ts +0 -74
- package/src/types/operation.ts +0 -72
- package/src/types/org.ts +0 -25
- package/src/types/position.ts +0 -24
- package/src/types/stock.ts +0 -161
- package/src/types/supplier-contact.ts +0 -78
- package/src/types/supplier.ts +0 -66
- package/src/types/team-issue.ts +0 -94
- package/src/types/team-project.ts +0 -74
- package/src/types/team-task.ts +0 -98
- package/src/types/team-work-log.ts +0 -87
- package/src/types/transfer-in-form.ts +0 -265
- package/src/types/transfer-out-form.ts +0 -290
- package/src/types/uom.ts +0 -60
- package/src/types/user.ts +0 -64
- package/src/types/warehouse.ts +0 -82
|
@@ -1,174 +0,0 @@
|
|
|
1
|
-
# barista liberica teams projects create
|
|
2
|
-
|
|
3
|
-
创建团队项目。
|
|
4
|
-
|
|
5
|
-
## 2.1 命令元数据
|
|
6
|
-
|
|
7
|
-
| 字段 | 值 |
|
|
8
|
-
|------|-----|
|
|
9
|
-
| 完整命令 | `barista liberica teams projects create` |
|
|
10
|
-
| 功能描述 | 创建新的团队项目 |
|
|
11
|
-
| HTTP方法 | POST |
|
|
12
|
-
| 是否需要认证 | ✅ 是 |
|
|
13
|
-
| 是否支持dry-run | ✅ 是 |
|
|
14
|
-
|
|
15
|
-
## 2.2 后端接口引用
|
|
16
|
-
|
|
17
|
-
### Controller位置
|
|
18
|
-
```
|
|
19
|
-
coffee-liberica-end/
|
|
20
|
-
└── facade/liberica-facade-enterprise/
|
|
21
|
-
└── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
|
|
22
|
-
└── EnterpriseTeamProjectController.java
|
|
23
|
-
└── add(@PostResource(path = "/add", requiredPermission = true, requirePermissionCode = TeamProjectPermissionConstants.ADD_TEAM_PROJECT))
|
|
24
|
-
└── public ResponseData<TeamProjectResponse> add(
|
|
25
|
-
@RequestHeader("X-TENANT-ID") Long tenantId,
|
|
26
|
-
@RequestBody @Validated(BaseRequest.add.class) TeamProjectRequest teamProjectRequest
|
|
27
|
-
)
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
### Request DTO位置
|
|
31
|
-
```
|
|
32
|
-
coffee-liberica-end/
|
|
33
|
-
└── business/liberica-business-team/team-api/
|
|
34
|
-
└── src/main/java/com/newpeak/liberica/team/api/pojo/request/
|
|
35
|
-
└── TeamProjectRequest.java
|
|
36
|
-
├── projectCode: String (@NotBlank, max=50)
|
|
37
|
-
├── projectName: String (@NotBlank, max=200)
|
|
38
|
-
├── parentProjectId: Long
|
|
39
|
-
├── projectLevel: Integer
|
|
40
|
-
├── projectDesc: String
|
|
41
|
-
├── teamProjectStatus: String (max=20)
|
|
42
|
-
└── tenantId: Long
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
### Response DTO位置
|
|
46
|
-
```
|
|
47
|
-
coffee-liberica-end/
|
|
48
|
-
└── business/liberica-business-team/team-api/
|
|
49
|
-
└── src/main/java/com/newpeak/liberica/team/api/pojo/response/
|
|
50
|
-
└── TeamProjectResponse.java
|
|
51
|
-
├── teamProjectId: Long
|
|
52
|
-
├── projectCode: String
|
|
53
|
-
├── projectName: String
|
|
54
|
-
├── parentProjectId: Long
|
|
55
|
-
├── projectLevel: Integer
|
|
56
|
-
├── projectDesc: String
|
|
57
|
-
├── teamProjectStatus: String
|
|
58
|
-
├── createTime: String
|
|
59
|
-
└── updateTime: String
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
## 2.3 CLI参数设计
|
|
63
|
-
|
|
64
|
-
### 命令结构
|
|
65
|
-
```
|
|
66
|
-
barista liberica teams projects create [options]
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
### Usage
|
|
70
|
-
```bash
|
|
71
|
-
barista liberica teams projects create --name "示例项目" --code "P001"
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
### 全局选项
|
|
75
|
-
| 选项 | 类型 | 说明 |
|
|
76
|
-
|------|------|------|
|
|
77
|
-
| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
|
|
78
|
-
| `--tenant` | string | 租户代码 |
|
|
79
|
-
| `--dry-run` | boolean | 预览模式(不实际调用API) |
|
|
80
|
-
| `--json` | boolean | JSON输出 |
|
|
81
|
-
|
|
82
|
-
### 命令选项
|
|
83
|
-
| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
|
|
84
|
-
|------|--------|------|------|--------|------|-------------|
|
|
85
|
-
| --name | -n | string | ✅ | - | 项目名称 | projectName |
|
|
86
|
-
| --code | -c | string | ✅ | - | 项目代号 | projectCode |
|
|
87
|
-
| --desc | -d | string | ⬜ | - | 项目描述 | projectDesc |
|
|
88
|
-
| --status | -s | string | ⬜ | ACTIVE | 项目状态 | teamProjectStatus |
|
|
89
|
-
| --parent-id | — | string | ⬜ | - | 父项目ID | parentProjectId |
|
|
90
|
-
| --level | -l | number | ⬜ | 1 | 项目级别 | projectLevel |
|
|
91
|
-
| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
|
|
92
|
-
|
|
93
|
-
## 2.4 字段映射表
|
|
94
|
-
|
|
95
|
-
| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
|
|
96
|
-
|---------|---------|----------|----------|
|
|
97
|
-
| --name / -n | projectName | 直接传递 | @NotBlank, max=200 |
|
|
98
|
-
| --code / -c | projectCode | 直接传递 | @NotBlank, max=50 |
|
|
99
|
-
| --desc / -d | projectDesc | 直接传递 | - |
|
|
100
|
-
| --status / -s | teamProjectStatus | 直接传递 | max=20 |
|
|
101
|
-
| --parent-id | parentProjectId | string→Long | - |
|
|
102
|
-
| --level / -l | projectLevel | number→Integer | - |
|
|
103
|
-
|
|
104
|
-
**自动填充字段(不通过CLI参数):**
|
|
105
|
-
| 字段 | 来源 |
|
|
106
|
-
|------|------|
|
|
107
|
-
| tenantId | 后端从 X-TENANT-ID header 注入 |
|
|
108
|
-
|
|
109
|
-
## 2.5 错误码引用
|
|
110
|
-
|
|
111
|
-
### ExceptionEnum位置
|
|
112
|
-
```
|
|
113
|
-
coffee-liberica-end/
|
|
114
|
-
└── business/liberica-business-team/team-api/
|
|
115
|
-
└── src/main/java/com/newpeak/liberica/team/api/exception/enums/
|
|
116
|
-
└── TeamProjectExceptionEnum.java
|
|
117
|
-
└── TEAM_PROJECT_NOT_EXIST("01001957001", "团队项目不存在")
|
|
118
|
-
```
|
|
119
|
-
|
|
120
|
-
### 已知错误码
|
|
121
|
-
| 错误码 | 错误消息 | 触发条件 |
|
|
122
|
-
|--------|----------|----------|
|
|
123
|
-
| 01001957001 | 团队项目不存在 | copy/edit 时引用的原项目不存在 |
|
|
124
|
-
|
|
125
|
-
## 2.6 权限检查
|
|
126
|
-
|
|
127
|
-
| 检查项 | 位置 | 说明 |
|
|
128
|
-
|--------|------|------|
|
|
129
|
-
| PermissionConstants | `TeamProjectPermissionConstants.ADD_TEAM_PROJECT` | Controller层 `@PostResource(requirePermissionCode = "ADD_TEAM_PROJECT")` |
|
|
130
|
-
|
|
131
|
-
## 2.7 实现要点
|
|
132
|
-
|
|
133
|
-
1. **必填字段**:`--name`、`--code` 必须提供
|
|
134
|
-
2. **默认值**:`--status` 默认 `ACTIVE`,`--level` 默认 `1`
|
|
135
|
-
3. **Dry-run 支持**:使用 `--dry-run` 时构造请求体但不发送,显示预览信息
|
|
136
|
-
4. **tenantId 来源**:来自 X-TENANT-ID header,不通过请求体传递
|
|
137
|
-
5. **无 X-TENANT-ID Header**:CLI 不手动添加该 header,租户信息由后端从 JWT 中提取
|
|
138
|
-
6. **ID 类型处理**:`parentProjectId` 后端使用 Long (BigInteger),CLI 使用 string 避免精度丢失
|
|
139
|
-
|
|
140
|
-
## 2.8 示例用法
|
|
141
|
-
|
|
142
|
-
```bash
|
|
143
|
-
# 最小参数创建
|
|
144
|
-
barista liberica teams projects create \
|
|
145
|
-
--name "ERP系统" \
|
|
146
|
-
--code "ERP"
|
|
147
|
-
|
|
148
|
-
# 完整参数创建
|
|
149
|
-
barista liberica teams projects create \
|
|
150
|
-
--name "ERP系统" \
|
|
151
|
-
--code "ERP" \
|
|
152
|
-
--desc "企业资源计划系统" \
|
|
153
|
-
--status ACTIVE \
|
|
154
|
-
--level 1
|
|
155
|
-
|
|
156
|
-
# 创建子项目
|
|
157
|
-
barista liberica teams projects create \
|
|
158
|
-
--name "销售模块" \
|
|
159
|
-
--code "ERP-SALES" \
|
|
160
|
-
--parent-id 123456789 \
|
|
161
|
-
--level 2
|
|
162
|
-
|
|
163
|
-
# Dry-run 预览
|
|
164
|
-
barista liberica teams projects create \
|
|
165
|
-
--name "测试项目" \
|
|
166
|
-
--code "TEST" \
|
|
167
|
-
--dry-run
|
|
168
|
-
|
|
169
|
-
# JSON 输出
|
|
170
|
-
barista liberica teams projects create \
|
|
171
|
-
--name "测试项目" \
|
|
172
|
-
--code "TEST" \
|
|
173
|
-
--json
|
|
174
|
-
```
|
|
@@ -1,180 +0,0 @@
|
|
|
1
|
-
# barista liberica teams projects delete
|
|
2
|
-
|
|
3
|
-
删除团队项目。
|
|
4
|
-
|
|
5
|
-
## 2.1 命令元数据
|
|
6
|
-
|
|
7
|
-
| 字段 | 值 |
|
|
8
|
-
|------|-----|
|
|
9
|
-
| 完整命令 | `barista liberica teams projects delete <project-id>` |
|
|
10
|
-
| 功能描述 | 删除指定团队项目 |
|
|
11
|
-
| HTTP方法 | POST |
|
|
12
|
-
| 是否需要认证 | ✅ 是 |
|
|
13
|
-
| 是否支持dry-run | ✅ 是(默认行为) |
|
|
14
|
-
|
|
15
|
-
## 2.2 后端接口引用
|
|
16
|
-
|
|
17
|
-
### Controller位置
|
|
18
|
-
```
|
|
19
|
-
coffee-liberica-end/
|
|
20
|
-
└── facade/liberica-facade-enterprise/
|
|
21
|
-
└── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
|
|
22
|
-
└── EnterpriseTeamProjectController.java
|
|
23
|
-
└── delete(@PostResource(path = "/delete", requiredPermission = true, requirePermissionCode = TeamProjectPermissionConstants.DEL_TEAM_PROJECT))
|
|
24
|
-
└── public ResponseData<?> delete(
|
|
25
|
-
@RequestHeader("X-TENANT-ID") Long tenantId,
|
|
26
|
-
@RequestBody @Validated(BaseRequest.delete.class) TeamProjectRequest teamProjectRequest
|
|
27
|
-
)
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
### Request DTO位置
|
|
31
|
-
```
|
|
32
|
-
coffee-liberica-end/
|
|
33
|
-
└── business/liberica-business-team/team-api/
|
|
34
|
-
└── src/main/java/com/newpeak/liberica/team/api/pojo/request/
|
|
35
|
-
└── TeamProjectRequest.java
|
|
36
|
-
├── teamProjectId: Long (@NotNull on delete)
|
|
37
|
-
└── tenantId: Long
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
**删除请求体结构:**
|
|
41
|
-
```json
|
|
42
|
-
{
|
|
43
|
-
"teamProjectId": 123456789
|
|
44
|
-
}
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
### Response DTO位置
|
|
48
|
-
```
|
|
49
|
-
coffee-liberica-end/
|
|
50
|
-
└── business/liberica-business-team/team-api/
|
|
51
|
-
└── src/main/java/com/newpeak/liberica/team/api/pojo/response/
|
|
52
|
-
└── TeamProjectResponse.java
|
|
53
|
-
├── teamProjectId: Long
|
|
54
|
-
├── projectCode: String
|
|
55
|
-
├── projectName: String
|
|
56
|
-
├── teamProjectStatus: String
|
|
57
|
-
└── createTime: String
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
## 2.3 CLI参数设计
|
|
61
|
-
|
|
62
|
-
### 命令结构
|
|
63
|
-
```
|
|
64
|
-
barista liberica teams projects delete <project-id> [options]
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
### Usage
|
|
68
|
-
```bash
|
|
69
|
-
barista liberica teams projects delete 123456789
|
|
70
|
-
barista liberica teams projects delete 123456789 --force
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
### 全局选项
|
|
74
|
-
| 选项 | 类型 | 说明 |
|
|
75
|
-
|------|------|------|
|
|
76
|
-
| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
|
|
77
|
-
| `--tenant` | string | 租户代码 |
|
|
78
|
-
| `--json` | boolean | JSON输出 |
|
|
79
|
-
|
|
80
|
-
### 位置参数
|
|
81
|
-
| 参数 | 类型 | 必填 | 说明 |
|
|
82
|
-
|------|------|------|------|
|
|
83
|
-
| project-id | string | ✅ | 要删除的项目ID |
|
|
84
|
-
|
|
85
|
-
### 命令选项
|
|
86
|
-
| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
|
|
87
|
-
|------|--------|------|------|--------|------|-------------|
|
|
88
|
-
| --force | -f | boolean | ⬜ | false | 跳过确认直接删除 | - |
|
|
89
|
-
| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
|
|
90
|
-
|
|
91
|
-
## 2.4 字段映射表
|
|
92
|
-
|
|
93
|
-
| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
|
|
94
|
-
|---------|---------|----------|----------|
|
|
95
|
-
| project-id (位置参数) | teamProjectId | string→Long | @NotNull |
|
|
96
|
-
|
|
97
|
-
## 2.5 确认流程
|
|
98
|
-
|
|
99
|
-
删除操作默认启用dry-run行为,需要用户显式确认:
|
|
100
|
-
|
|
101
|
-
### 默认行为(无--force)
|
|
102
|
-
```bash
|
|
103
|
-
$ barista liberica teams projects delete 123456789
|
|
104
|
-
|
|
105
|
-
⚠️ Delete Team Project
|
|
106
|
-
|
|
107
|
-
Project ID: 123456789
|
|
108
|
-
Name: ERP系统
|
|
109
|
-
Code: ERP
|
|
110
|
-
|
|
111
|
-
Add --force to confirm deletion
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
### 强制删除(带--force)
|
|
115
|
-
```bash
|
|
116
|
-
$ barista liberica teams projects delete 123456789 --force
|
|
117
|
-
|
|
118
|
-
✓ Project "ERP系统" (ID: 123456789) deleted
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
## 2.6 错误码引用
|
|
122
|
-
|
|
123
|
-
### ExceptionEnum位置
|
|
124
|
-
```
|
|
125
|
-
coffee-liberica-end/
|
|
126
|
-
└── business/liberica-business-team/team-api/
|
|
127
|
-
└── src/main/java/com/newpeak/liberica/team/api/exception/enums/
|
|
128
|
-
└── TeamProjectExceptionEnum.java
|
|
129
|
-
└── TEAM_PROJECT_NOT_EXIST("01001957001", "团队项目不存在")
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
### Service层业务校验
|
|
133
|
-
```
|
|
134
|
-
coffee-liberica-end/
|
|
135
|
-
└── business/liberica-business-team/team-business/
|
|
136
|
-
└── src/main/java/com/newpeak/liberica/team/modular/business/
|
|
137
|
-
└── TeamProjectBusiness.java
|
|
138
|
-
└── del(TeamProjectRequest request)
|
|
139
|
-
└── 检查团队项目是否存在
|
|
140
|
-
└── throw new TeamServiceException(TeamProjectExceptionEnum.TEAM_PROJECT_NOT_EXIST)
|
|
141
|
-
```
|
|
142
|
-
|
|
143
|
-
### 已知错误码
|
|
144
|
-
| 错误码 | 错误消息 | 触发条件 |
|
|
145
|
-
|--------|----------|----------|
|
|
146
|
-
| 01001957001 | 团队项目不存在 | 删除的 project-id 不存在或已被删除 |
|
|
147
|
-
|
|
148
|
-
## 2.7 权限检查
|
|
149
|
-
|
|
150
|
-
| 检查项 | 位置 | 说明 |
|
|
151
|
-
|--------|------|------|
|
|
152
|
-
| PermissionConstants | `TeamProjectPermissionConstants.DEL_TEAM_PROJECT` | Controller层 `@PostResource(requirePermissionCode = "DEL_TEAM_PROJECT")` |
|
|
153
|
-
|
|
154
|
-
## 2.8 实现要点
|
|
155
|
-
|
|
156
|
-
1. **必填参数**:`project-id` 作为位置参数必须提供
|
|
157
|
-
2. **Dry-run 默认开启**:不带 `--force` 时只显示提示信息,不调用删除 API,exit(0)
|
|
158
|
-
3. **强制删除**:添加 `--force` 后调用 `/delete` API 执行实际删除
|
|
159
|
-
4. **ID 类型处理**:后端使用 Long (BigInteger),CLI 使用 string 避免精度丢失
|
|
160
|
-
5. **权限要求**:需要 `DEL_TEAM_PROJECT` 权限
|
|
161
|
-
6. **无 X-TENANT-ID Header**:CLI 不手动添加该 header,租户信息由后端从 JWT 中提取
|
|
162
|
-
|
|
163
|
-
## 2.9 示例用法
|
|
164
|
-
|
|
165
|
-
```bash
|
|
166
|
-
# 预览删除(默认行为,不实际删除)
|
|
167
|
-
barista liberica teams projects delete 123456789
|
|
168
|
-
|
|
169
|
-
# 强制删除
|
|
170
|
-
barista liberica teams projects delete 123456789 --force
|
|
171
|
-
|
|
172
|
-
# 指定环境删除
|
|
173
|
-
barista liberica teams projects delete 123456789 --env test --force
|
|
174
|
-
|
|
175
|
-
# JSON 输出预览
|
|
176
|
-
barista liberica teams projects delete 123456789 --json
|
|
177
|
-
|
|
178
|
-
# JSON 输出并强制删除
|
|
179
|
-
barista liberica teams projects delete 123456789 --force --json
|
|
180
|
-
```
|
|
@@ -1,150 +0,0 @@
|
|
|
1
|
-
# barista liberica teams projects get
|
|
2
|
-
|
|
3
|
-
查询团队项目详情。
|
|
4
|
-
|
|
5
|
-
## 2.1 命令元数据
|
|
6
|
-
|
|
7
|
-
| 字段 | 值 |
|
|
8
|
-
|------|-----|
|
|
9
|
-
| 完整命令 | `barista liberica teams projects get <project-id>` |
|
|
10
|
-
| 功能描述 | 查询单个团队项目详情 |
|
|
11
|
-
| HTTP方法 | GET |
|
|
12
|
-
| 是否需要认证 | ✅ 是 |
|
|
13
|
-
| 是否支持dry-run | ⬜ 否 |
|
|
14
|
-
|
|
15
|
-
## 2.2 后端接口引用
|
|
16
|
-
|
|
17
|
-
### Controller位置
|
|
18
|
-
```
|
|
19
|
-
coffee-liberica-end/
|
|
20
|
-
└── facade/liberica-facade-enterprise/
|
|
21
|
-
└── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
|
|
22
|
-
└── EnterpriseTeamProjectController.java
|
|
23
|
-
└── detail(@GetResource(path = "/detail"))
|
|
24
|
-
└── public ResponseData<TeamProjectResponse> detail(
|
|
25
|
-
@RequestHeader("X-TENANT-ID") Long tenantId,
|
|
26
|
-
@ParameterObject @Validated(BaseRequest.detail.class) TeamProjectRequest teamProjectRequest
|
|
27
|
-
)
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
### Request DTO位置
|
|
31
|
-
```
|
|
32
|
-
coffee-liberica-end/
|
|
33
|
-
└── business/liberica-business-team/team-api/
|
|
34
|
-
└── src/main/java/com/newpeak/liberica/team/api/pojo/request/
|
|
35
|
-
└── TeamProjectRequest.java
|
|
36
|
-
├── teamProjectId: Long (@NotNull on detail)
|
|
37
|
-
└── tenantId: Long
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
**请求参数结构:**
|
|
41
|
-
```
|
|
42
|
-
GET /api/enterprise/team/project/detail?teamProjectId={id}
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
### Response DTO位置
|
|
46
|
-
```
|
|
47
|
-
coffee-liberica-end/
|
|
48
|
-
└── business/liberica-business-team/team-api/
|
|
49
|
-
└── src/main/java/com/newpeak/liberica/team/api/pojo/response/
|
|
50
|
-
└── TeamProjectResponse.java
|
|
51
|
-
├── teamProjectId: Long
|
|
52
|
-
├── projectCode: String
|
|
53
|
-
├── projectName: String
|
|
54
|
-
├── parentProjectId: Long
|
|
55
|
-
├── projectLevel: Integer
|
|
56
|
-
├── projectDesc: String
|
|
57
|
-
├── teamProjectStatus: String
|
|
58
|
-
├── createTime: String
|
|
59
|
-
└── updateTime: String
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
## 2.3 CLI参数设计
|
|
63
|
-
|
|
64
|
-
### 命令结构
|
|
65
|
-
```
|
|
66
|
-
barista liberica teams projects get <project-id> [options]
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
### Usage
|
|
70
|
-
```bash
|
|
71
|
-
barista liberica teams projects get 123456789
|
|
72
|
-
barista liberica teams projects get 123456789 --json
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
### 全局选项
|
|
76
|
-
| 选项 | 类型 | 说明 |
|
|
77
|
-
|------|------|------|
|
|
78
|
-
| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
|
|
79
|
-
| `--tenant` | string | 租户代码 |
|
|
80
|
-
| `--json` | boolean | JSON输出 |
|
|
81
|
-
|
|
82
|
-
### 位置参数
|
|
83
|
-
| 参数 | 类型 | 必填 | 说明 |
|
|
84
|
-
|------|------|------|------|
|
|
85
|
-
| project-id | string | ✅ | 项目ID |
|
|
86
|
-
|
|
87
|
-
### 命令选项
|
|
88
|
-
| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
|
|
89
|
-
|------|--------|------|------|--------|------|-------------|
|
|
90
|
-
| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
|
|
91
|
-
|
|
92
|
-
## 2.4 字段映射表
|
|
93
|
-
|
|
94
|
-
| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
|
|
95
|
-
|---------|---------|----------|----------|
|
|
96
|
-
| project-id (位置参数) | teamProjectId | string→Long | @NotNull |
|
|
97
|
-
|
|
98
|
-
## 2.5 错误码引用
|
|
99
|
-
|
|
100
|
-
### ExceptionEnum位置
|
|
101
|
-
```
|
|
102
|
-
coffee-liberica-end/
|
|
103
|
-
└── business/liberica-business-team/team-api/
|
|
104
|
-
└── src/main/java/com/newpeak/liberica/team/api/exception/enums/
|
|
105
|
-
└── TeamProjectExceptionEnum.java
|
|
106
|
-
└── TEAM_PROJECT_NOT_EXIST("01001957001", "团队项目不存在")
|
|
107
|
-
```
|
|
108
|
-
|
|
109
|
-
### Service层业务校验
|
|
110
|
-
```
|
|
111
|
-
coffee-liberica-end/
|
|
112
|
-
└── business/liberica-business-team/team-business/
|
|
113
|
-
└── src/main/java/com/newpeak/liberica/team/modular/business/
|
|
114
|
-
└── TeamProjectBusiness.java
|
|
115
|
-
└── detail(TeamProjectRequest request)
|
|
116
|
-
└── 检查团队项目是否存在
|
|
117
|
-
└── throw new TeamServiceException(TeamProjectExceptionEnum.TEAM_PROJECT_NOT_EXIST)
|
|
118
|
-
```
|
|
119
|
-
|
|
120
|
-
### 已知错误码
|
|
121
|
-
| 错误码 | 错误消息 | 触发条件 |
|
|
122
|
-
|--------|----------|----------|
|
|
123
|
-
| 01001957001 | 团队项目不存在 | 查询的 project-id 不存在或已被删除 |
|
|
124
|
-
|
|
125
|
-
## 2.6 权限检查
|
|
126
|
-
|
|
127
|
-
| 检查项 | 位置 | 说明 |
|
|
128
|
-
|--------|------|------|
|
|
129
|
-
| 注解 | `@GetResource(path = "/detail")` | 无 requiredPermission(详情查询无需权限码) |
|
|
130
|
-
|
|
131
|
-
## 2.7 实现要点
|
|
132
|
-
|
|
133
|
-
1. **必填参数**:`project-id` 作为位置参数必须提供
|
|
134
|
-
2. **API 调用方式**:通过 URL 查询参数传递 `teamProjectId`,如 `/detail?teamProjectId={id}`
|
|
135
|
-
3. **ID 类型处理**:后端使用 Long (BigInteger),CLI 使用 string 避免精度丢失
|
|
136
|
-
4. **输出格式**:默认以键值对形式展示项目详情;`--json` 时输出完整响应 JSON
|
|
137
|
-
5. **错误处理**:如果返回 `!response.success`,输出错误信息并 `process.exit(1)`
|
|
138
|
-
|
|
139
|
-
## 2.8 示例用法
|
|
140
|
-
|
|
141
|
-
```bash
|
|
142
|
-
# 查询详情
|
|
143
|
-
barista liberica teams projects get 123456789
|
|
144
|
-
|
|
145
|
-
# JSON 输出
|
|
146
|
-
barista liberica teams projects get 123456789 --json
|
|
147
|
-
|
|
148
|
-
# 指定环境
|
|
149
|
-
barista liberica teams projects get 123456789 --env test
|
|
150
|
-
```
|
|
@@ -1,179 +0,0 @@
|
|
|
1
|
-
# barista liberica teams projects list
|
|
2
|
-
|
|
3
|
-
分页查询团队项目列表。
|
|
4
|
-
|
|
5
|
-
## 2.1 命令元数据
|
|
6
|
-
|
|
7
|
-
| 字段 | 值 |
|
|
8
|
-
|------|-----|
|
|
9
|
-
| 完整命令 | `barista liberica teams projects list` |
|
|
10
|
-
| 功能描述 | 分页查询团队项目列表 |
|
|
11
|
-
| HTTP方法 | GET |
|
|
12
|
-
| 是否需要认证 | ✅ 是 |
|
|
13
|
-
| 是否支持dry-run | ⬜ 否 |
|
|
14
|
-
|
|
15
|
-
## 2.2 后端接口引用
|
|
16
|
-
|
|
17
|
-
### Controller位置
|
|
18
|
-
```
|
|
19
|
-
coffee-liberica-end/
|
|
20
|
-
└── facade/liberica-facade-enterprise/
|
|
21
|
-
└── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
|
|
22
|
-
└── EnterpriseTeamProjectController.java
|
|
23
|
-
└── page(@GetResource(path = "/page"))
|
|
24
|
-
└── public ResponseData<PageResult<TeamProjectResponse>> page(
|
|
25
|
-
@RequestHeader("X-TENANT-ID") Long tenantId,
|
|
26
|
-
@ParameterObject TeamProjectQueryRequest teamProjectQueryRequest
|
|
27
|
-
)
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
### Request DTO位置
|
|
31
|
-
```
|
|
32
|
-
coffee-liberica-end/
|
|
33
|
-
└── business/liberica-business-team/team-api/
|
|
34
|
-
└── src/main/java/com/newpeak/liberica/team/api/pojo/request/
|
|
35
|
-
└── TeamProjectQueryRequest.java
|
|
36
|
-
├── pageNo: Long (分页当前页,0-based)
|
|
37
|
-
├── pageSize: Long (分页大小)
|
|
38
|
-
├── teamProjectId: Long (项目ID)
|
|
39
|
-
├── projectCode: String (项目代号,模糊搜索)
|
|
40
|
-
├── projectName: String (项目名称,模糊搜索)
|
|
41
|
-
├── parentProjectId: Long (父项目ID)
|
|
42
|
-
├── projectLevel: Integer (项目级别)
|
|
43
|
-
├── projectDesc: String (项目描述)
|
|
44
|
-
├── teamProjectStatus: String (项目状态)
|
|
45
|
-
└── teamProjectIdList: Set<Long> (项目ID集合)
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
### Response DTO位置
|
|
49
|
-
```
|
|
50
|
-
coffee-liberica-end/
|
|
51
|
-
└── business/liberica-business-team/team-api/
|
|
52
|
-
└── src/main/java/com/newpeak/liberica/team/api/pojo/response/
|
|
53
|
-
└── TeamProjectResponse.java
|
|
54
|
-
├── teamProjectId: Long
|
|
55
|
-
├── projectCode: String
|
|
56
|
-
├── projectName: String
|
|
57
|
-
├── parentProjectId: Long
|
|
58
|
-
├── projectLevel: Integer
|
|
59
|
-
├── projectDesc: String
|
|
60
|
-
├── teamProjectStatus: String
|
|
61
|
-
├── createTime: String
|
|
62
|
-
└── updateTime: String
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
### 分页包装器
|
|
66
|
-
```
|
|
67
|
-
cn.stylefeng.roses.kernel.db.api.pojo.page.PageResult
|
|
68
|
-
├── totalRows: long
|
|
69
|
-
├── pageSize: long
|
|
70
|
-
├── pageNo: long
|
|
71
|
-
└── rows: List<TeamProjectResponse>
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
## 2.3 CLI参数设计
|
|
75
|
-
|
|
76
|
-
### 命令结构
|
|
77
|
-
```
|
|
78
|
-
barista liberica teams projects list [options]
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
### Usage
|
|
82
|
-
```bash
|
|
83
|
-
barista liberica teams projects list
|
|
84
|
-
barista liberica teams projects list --page 2 --size 50
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
### 全局选项
|
|
88
|
-
| 选项 | 类型 | 说明 |
|
|
89
|
-
|------|------|------|
|
|
90
|
-
| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
|
|
91
|
-
| `--tenant` | string | 租户代码 |
|
|
92
|
-
| `--json` | boolean | JSON输出 |
|
|
93
|
-
|
|
94
|
-
### 命令选项
|
|
95
|
-
| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
|
|
96
|
-
|------|--------|------|------|--------|------|-------------|
|
|
97
|
-
| --page | -p | number | ⬜ | 1 | 页码(1-based) | pageNo |
|
|
98
|
-
| --size | -s | number | ⬜ | 20 | 每页条数 | pageSize |
|
|
99
|
-
| --code | -c | string | ⬜ | - | 按项目代号搜索 | projectCode |
|
|
100
|
-
| --name | -n | string | ⬜ | - | 按项目名称模糊搜索 | projectName |
|
|
101
|
-
| --status | — | string | ⬜ | - | 按状态筛选 | teamProjectStatus |
|
|
102
|
-
| --parent-id | — | string | ⬜ | - | 按父项目ID筛选 | parentProjectId |
|
|
103
|
-
| --level | -l | number | ⬜ | - | 按项目级别筛选 | projectLevel |
|
|
104
|
-
|
|
105
|
-
## 2.4 字段映射表
|
|
106
|
-
|
|
107
|
-
| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
|
|
108
|
-
|---------|---------|----------|----------|
|
|
109
|
-
| --page / -p | pageNo | number→Long, CLI page - 1 | >= 0 |
|
|
110
|
-
| --size / -s | pageSize | number→Long | > 0 |
|
|
111
|
-
| --code / -c | projectCode | 直接传递 | max=50 |
|
|
112
|
-
| --name / -n | projectName | 直接传递 | max=200 |
|
|
113
|
-
| --status | teamProjectStatus | 直接传递 | max=20 |
|
|
114
|
-
| --parent-id | parentProjectId | string→Long | - |
|
|
115
|
-
| --level / -l | projectLevel | number→Integer | - |
|
|
116
|
-
|
|
117
|
-
## 2.5 错误码引用
|
|
118
|
-
|
|
119
|
-
### ExceptionEnum位置
|
|
120
|
-
```
|
|
121
|
-
coffee-liberica-end/
|
|
122
|
-
└── business/liberica-business-team/team-api/
|
|
123
|
-
└── src/main/java/com/newpeak/liberica/team/api/exception/enums/
|
|
124
|
-
└── TeamProjectExceptionEnum.java
|
|
125
|
-
└── TEAM_PROJECT_NOT_EXIST("01001957001", "团队项目不存在")
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
### 已知错误码
|
|
129
|
-
| 错误码 | 错误消息 | 触发条件 |
|
|
130
|
-
|--------|----------|----------|
|
|
131
|
-
| 01001957001 | 团队项目不存在 | 详情/编辑/删除时ID不存在 |
|
|
132
|
-
|
|
133
|
-
## 2.6 权限检查
|
|
134
|
-
|
|
135
|
-
| 检查项 | 位置 | 说明 |
|
|
136
|
-
|--------|------|------|
|
|
137
|
-
| 注解 | `@GetResource(path = "/page")` | 无 requiredPermission(列表查询无需权限码) |
|
|
138
|
-
|
|
139
|
-
**注意**:list 和 page 接口在 Controller 层无需权限校验,数据范围通过 tenantId 隔离。
|
|
140
|
-
|
|
141
|
-
## 2.7 实现要点
|
|
142
|
-
|
|
143
|
-
1. **分页默认值**:page=1, size=20
|
|
144
|
-
2. **分页转换**:CLI 使用 1-based 页码,API 使用 0-based,转换公式 `pageNo = options.page - 1`
|
|
145
|
-
3. **响应字段**:后端返回 `rows`、`totalRows`、`pageNo`、`pageSize`,不使用 `records` 或 `total`
|
|
146
|
-
4. **ID 类型处理**:`teamProjectId`、`parentProjectId` 等 ID 字段后端使用 Long (BigInteger),CLI 使用 string 避免精度丢失
|
|
147
|
-
5. **无结果处理**:返回空列表,不抛出异常
|
|
148
|
-
6. **输出格式**:表格形式展示 ID、Code、Name、Level、Status
|
|
149
|
-
|
|
150
|
-
## 2.8 示例用法
|
|
151
|
-
|
|
152
|
-
```bash
|
|
153
|
-
# 默认分页
|
|
154
|
-
barista liberica teams projects list
|
|
155
|
-
|
|
156
|
-
# 指定页码和每页条数
|
|
157
|
-
barista liberica teams projects list --page 2 --size 50
|
|
158
|
-
|
|
159
|
-
# 按状态筛选
|
|
160
|
-
barista liberica teams projects list --status ACTIVE
|
|
161
|
-
|
|
162
|
-
# 按项目代号搜索
|
|
163
|
-
barista liberica teams projects list --code "ERP"
|
|
164
|
-
|
|
165
|
-
# 按项目名称搜索
|
|
166
|
-
barista liberica teams projects list --name "生产系统"
|
|
167
|
-
|
|
168
|
-
# 按父项目ID筛选
|
|
169
|
-
barista liberica teams projects list --parent-id 123456789
|
|
170
|
-
|
|
171
|
-
# 按项目级别筛选
|
|
172
|
-
barista liberica teams projects list --level 1
|
|
173
|
-
|
|
174
|
-
# 组合筛选
|
|
175
|
-
barista liberica teams projects list --status ACTIVE --level 1
|
|
176
|
-
|
|
177
|
-
# JSON 输出
|
|
178
|
-
barista liberica teams projects list --json
|
|
179
|
-
```
|