@newpeak/barista-cli 0.1.11 → 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.
Files changed (298) hide show
  1. package/dist/index.js +1 -1
  2. package/package.json +7 -3
  3. package/docs/ARCHITECTURE.md +0 -184
  4. package/docs/COMMANDS.md +0 -352
  5. package/docs/COMMAND_DESIGN_SPEC.md +0 -840
  6. package/docs/INTEGRATION_NOTES.md +0 -270
  7. package/docs/commands/REFERENCE.md +0 -323
  8. package/docs/commands/arabica/auth/index.md +0 -296
  9. package/docs/commands/liberica/auth/index.md +0 -133
  10. package/docs/commands/liberica/calendar/DESIGN.md +0 -333
  11. package/docs/commands/liberica/client-contacts/create.md +0 -152
  12. package/docs/commands/liberica/client-contacts/delete.md +0 -123
  13. package/docs/commands/liberica/client-contacts/get.md +0 -133
  14. package/docs/commands/liberica/client-contacts/list.md +0 -143
  15. package/docs/commands/liberica/client-contacts/update.md +0 -158
  16. package/docs/commands/liberica/context/index.md +0 -60
  17. package/docs/commands/liberica/currency/create.md +0 -145
  18. package/docs/commands/liberica/currency/delete.md +0 -121
  19. package/docs/commands/liberica/currency/disable.md +0 -119
  20. package/docs/commands/liberica/currency/enable.md +0 -115
  21. package/docs/commands/liberica/currency/get.md +0 -118
  22. package/docs/commands/liberica/currency/list.md +0 -149
  23. package/docs/commands/liberica/currency/update.md +0 -141
  24. package/docs/commands/liberica/employees/create.md +0 -185
  25. package/docs/commands/liberica/employees/disable.md +0 -138
  26. package/docs/commands/liberica/employees/enable.md +0 -137
  27. package/docs/commands/liberica/employees/get.md +0 -153
  28. package/docs/commands/liberica/employees/list.md +0 -168
  29. package/docs/commands/liberica/employees/update.md +0 -180
  30. package/docs/commands/liberica/locations/create.md +0 -195
  31. package/docs/commands/liberica/locations/list.md +0 -171
  32. package/docs/commands/liberica/materials/create.md +0 -293
  33. package/docs/commands/liberica/materials/delete.md +0 -240
  34. package/docs/commands/liberica/materials/disable.md +0 -150
  35. package/docs/commands/liberica/materials/enable.md +0 -146
  36. package/docs/commands/liberica/materials/get.md +0 -188
  37. package/docs/commands/liberica/materials/list.md +0 -198
  38. package/docs/commands/liberica/materials/update.md +0 -250
  39. package/docs/commands/liberica/orgs/list.md +0 -62
  40. package/docs/commands/liberica/positions/list.md +0 -61
  41. package/docs/commands/liberica/roles/list.md +0 -67
  42. package/docs/commands/liberica/stock/ledger.md +0 -209
  43. package/docs/commands/liberica/stock/list.md +0 -165
  44. package/docs/commands/liberica/supplier-contacts/create.md +0 -152
  45. package/docs/commands/liberica/supplier-contacts/delete.md +0 -123
  46. package/docs/commands/liberica/supplier-contacts/get.md +0 -133
  47. package/docs/commands/liberica/supplier-contacts/list.md +0 -143
  48. package/docs/commands/liberica/supplier-contacts/update.md +0 -158
  49. package/docs/commands/liberica/teams/issues/close.md +0 -161
  50. package/docs/commands/liberica/teams/issues/create.md +0 -212
  51. package/docs/commands/liberica/teams/issues/delete.md +0 -179
  52. package/docs/commands/liberica/teams/issues/get.md +0 -167
  53. package/docs/commands/liberica/teams/issues/list.md +0 -182
  54. package/docs/commands/liberica/teams/issues/tests-design.md +0 -341
  55. package/docs/commands/liberica/teams/issues/update.md +0 -202
  56. package/docs/commands/liberica/teams/projects/create.md +0 -174
  57. package/docs/commands/liberica/teams/projects/delete.md +0 -180
  58. package/docs/commands/liberica/teams/projects/get.md +0 -150
  59. package/docs/commands/liberica/teams/projects/list.md +0 -179
  60. package/docs/commands/liberica/teams/projects/update.md +0 -175
  61. package/docs/commands/liberica/teams/tasks/create.md +0 -163
  62. package/docs/commands/liberica/teams/tasks/delete.md +0 -109
  63. package/docs/commands/liberica/teams/tasks/get.md +0 -121
  64. package/docs/commands/liberica/teams/tasks/list.md +0 -148
  65. package/docs/commands/liberica/teams/tasks/update.md +0 -158
  66. package/docs/commands/liberica/teams/work-logs/create.md +0 -151
  67. package/docs/commands/liberica/teams/work-logs/delete.md +0 -130
  68. package/docs/commands/liberica/teams/work-logs/get.md +0 -131
  69. package/docs/commands/liberica/teams/work-logs/list.md +0 -153
  70. package/docs/commands/liberica/teams/work-logs/update.md +0 -150
  71. package/docs/commands/liberica/transfer-in-forms/batch-delete.md +0 -157
  72. package/docs/commands/liberica/transfer-in-forms/batch-review.md +0 -157
  73. package/docs/commands/liberica/transfer-in-forms/batch-unreview.md +0 -157
  74. package/docs/commands/liberica/transfer-in-forms/create.md +0 -220
  75. package/docs/commands/liberica/transfer-in-forms/get.md +0 -221
  76. package/docs/commands/liberica/transfer-in-forms/list.md +0 -242
  77. package/docs/commands/liberica/transfer-in-forms/update.md +0 -185
  78. package/docs/commands/liberica/transfer-out-forms/batch-delete.md +0 -187
  79. package/docs/commands/liberica/transfer-out-forms/batch-review.md +0 -157
  80. package/docs/commands/liberica/transfer-out-forms/batch-unreview.md +0 -157
  81. package/docs/commands/liberica/transfer-out-forms/create.md +0 -280
  82. package/docs/commands/liberica/transfer-out-forms/get.md +0 -211
  83. package/docs/commands/liberica/transfer-out-forms/list.md +0 -233
  84. package/docs/commands/liberica/transfer-out-forms/update.md +0 -286
  85. package/docs/commands/liberica/uoms/create.md +0 -136
  86. package/docs/commands/liberica/uoms/delete.md +0 -119
  87. package/docs/commands/liberica/uoms/disable.md +0 -117
  88. package/docs/commands/liberica/uoms/enable.md +0 -115
  89. package/docs/commands/liberica/uoms/get.md +0 -119
  90. package/docs/commands/liberica/uoms/list.md +0 -155
  91. package/docs/commands/liberica/uoms/update.md +0 -148
  92. package/docs/commands/liberica/users/create.md +0 -170
  93. package/docs/commands/liberica/users/get.md +0 -151
  94. package/docs/commands/liberica/users/list.md +0 -175
  95. package/docs/commands/liberica/warehouses/create.md +0 -222
  96. package/docs/commands/liberica/warehouses/list.md +0 -184
  97. package/src/commands/arabica/auth/index.ts +0 -277
  98. package/src/commands/arabica/auth/login.ts +0 -5
  99. package/src/commands/arabica/auth/logout.ts +0 -5
  100. package/src/commands/arabica/auth/register.ts +0 -5
  101. package/src/commands/arabica/auth/status.ts +0 -5
  102. package/src/commands/arabica/index.ts +0 -23
  103. package/src/commands/auth.ts +0 -107
  104. package/src/commands/context.ts +0 -60
  105. package/src/commands/liberica/auth/index.ts +0 -176
  106. package/src/commands/liberica/calendar/index.ts +0 -13
  107. package/src/commands/liberica/calendar/list.ts +0 -214
  108. package/src/commands/liberica/calendar/set.ts +0 -130
  109. package/src/commands/liberica/client-contacts/create.ts +0 -115
  110. package/src/commands/liberica/client-contacts/delete.ts +0 -140
  111. package/src/commands/liberica/client-contacts/get.ts +0 -103
  112. package/src/commands/liberica/client-contacts/index.ts +0 -19
  113. package/src/commands/liberica/client-contacts/list.ts +0 -118
  114. package/src/commands/liberica/client-contacts/update.ts +0 -137
  115. package/src/commands/liberica/clients/create.ts +0 -122
  116. package/src/commands/liberica/clients/delete.ts +0 -125
  117. package/src/commands/liberica/clients/get.ts +0 -88
  118. package/src/commands/liberica/clients/index.ts +0 -19
  119. package/src/commands/liberica/clients/list.ts +0 -123
  120. package/src/commands/liberica/clients/update.ts +0 -103
  121. package/src/commands/liberica/context/index.ts +0 -43
  122. package/src/commands/liberica/currency/create.ts +0 -183
  123. package/src/commands/liberica/currency/delete.ts +0 -124
  124. package/src/commands/liberica/currency/disable.ts +0 -147
  125. package/src/commands/liberica/currency/enable.ts +0 -128
  126. package/src/commands/liberica/currency/get.ts +0 -91
  127. package/src/commands/liberica/currency/index.ts +0 -23
  128. package/src/commands/liberica/currency/list.ts +0 -140
  129. package/src/commands/liberica/currency/update.ts +0 -129
  130. package/src/commands/liberica/dict-types/get.ts +0 -74
  131. package/src/commands/liberica/dict-types/index.ts +0 -15
  132. package/src/commands/liberica/dict-types/list.ts +0 -118
  133. package/src/commands/liberica/dict-types/update.ts +0 -134
  134. package/src/commands/liberica/dicts/create.ts +0 -175
  135. package/src/commands/liberica/dicts/delete.ts +0 -107
  136. package/src/commands/liberica/dicts/get.ts +0 -80
  137. package/src/commands/liberica/dicts/index.ts +0 -19
  138. package/src/commands/liberica/dicts/list.ts +0 -114
  139. package/src/commands/liberica/dicts/update.ts +0 -116
  140. package/src/commands/liberica/employees/create.ts +0 -275
  141. package/src/commands/liberica/employees/delete.ts +0 -122
  142. package/src/commands/liberica/employees/disable.ts +0 -97
  143. package/src/commands/liberica/employees/enable.ts +0 -97
  144. package/src/commands/liberica/employees/get.ts +0 -115
  145. package/src/commands/liberica/employees/index.ts +0 -23
  146. package/src/commands/liberica/employees/list.ts +0 -131
  147. package/src/commands/liberica/employees/update.ts +0 -157
  148. package/src/commands/liberica/index.ts +0 -81
  149. package/src/commands/liberica/materials/create.ts +0 -199
  150. package/src/commands/liberica/materials/delete.ts +0 -105
  151. package/src/commands/liberica/materials/disable.ts +0 -148
  152. package/src/commands/liberica/materials/enable.ts +0 -129
  153. package/src/commands/liberica/materials/get.ts +0 -83
  154. package/src/commands/liberica/materials/index.ts +0 -23
  155. package/src/commands/liberica/materials/list.ts +0 -142
  156. package/src/commands/liberica/materials/update.ts +0 -125
  157. package/src/commands/liberica/mould/get.ts +0 -111
  158. package/src/commands/liberica/mould/index.ts +0 -17
  159. package/src/commands/liberica/mould/list.ts +0 -157
  160. package/src/commands/liberica/mould/set-status.ts +0 -99
  161. package/src/commands/liberica/mould/stock-in.ts +0 -165
  162. package/src/commands/liberica/operations/active.ts +0 -153
  163. package/src/commands/liberica/operations/batch-delete.ts +0 -131
  164. package/src/commands/liberica/operations/copy.ts +0 -138
  165. package/src/commands/liberica/operations/create.ts +0 -223
  166. package/src/commands/liberica/operations/deactive.ts +0 -152
  167. package/src/commands/liberica/operations/delete.ts +0 -128
  168. package/src/commands/liberica/operations/design.md +0 -587
  169. package/src/commands/liberica/operations/get.ts +0 -112
  170. package/src/commands/liberica/operations/index.ts +0 -27
  171. package/src/commands/liberica/operations/list.ts +0 -180
  172. package/src/commands/liberica/operations/update.ts +0 -218
  173. package/src/commands/liberica/orgs/index.ts +0 -34
  174. package/src/commands/liberica/positions/index.ts +0 -30
  175. package/src/commands/liberica/roles/index.ts +0 -59
  176. package/src/commands/liberica/stock/index.ts +0 -13
  177. package/src/commands/liberica/stock/ledger.ts +0 -159
  178. package/src/commands/liberica/stock/list.ts +0 -128
  179. package/src/commands/liberica/supplier-contacts/create.ts +0 -120
  180. package/src/commands/liberica/supplier-contacts/delete.ts +0 -88
  181. package/src/commands/liberica/supplier-contacts/get.ts +0 -94
  182. package/src/commands/liberica/supplier-contacts/index.ts +0 -19
  183. package/src/commands/liberica/supplier-contacts/list.ts +0 -130
  184. package/src/commands/liberica/supplier-contacts/update.ts +0 -127
  185. package/src/commands/liberica/suppliers/create.ts +0 -149
  186. package/src/commands/liberica/suppliers/delete.ts +0 -102
  187. package/src/commands/liberica/suppliers/disable.ts +0 -145
  188. package/src/commands/liberica/suppliers/enable.ts +0 -126
  189. package/src/commands/liberica/suppliers/get.ts +0 -86
  190. package/src/commands/liberica/suppliers/index.ts +0 -23
  191. package/src/commands/liberica/suppliers/list.ts +0 -134
  192. package/src/commands/liberica/suppliers/update.ts +0 -128
  193. package/src/commands/liberica/teams/index.ts +0 -17
  194. package/src/commands/liberica/teams/issues/close.ts +0 -104
  195. package/src/commands/liberica/teams/issues/create.ts +0 -254
  196. package/src/commands/liberica/teams/issues/delete.ts +0 -58
  197. package/src/commands/liberica/teams/issues/get.ts +0 -78
  198. package/src/commands/liberica/teams/issues/index.ts +0 -21
  199. package/src/commands/liberica/teams/issues/list.ts +0 -144
  200. package/src/commands/liberica/teams/issues/update.ts +0 -141
  201. package/src/commands/liberica/teams/projects/create.ts +0 -159
  202. package/src/commands/liberica/teams/projects/delete.ts +0 -58
  203. package/src/commands/liberica/teams/projects/get.ts +0 -87
  204. package/src/commands/liberica/teams/projects/index.ts +0 -19
  205. package/src/commands/liberica/teams/projects/list.ts +0 -147
  206. package/src/commands/liberica/teams/projects/update.ts +0 -117
  207. package/src/commands/liberica/teams/tasks/create.ts +0 -102
  208. package/src/commands/liberica/teams/tasks/delete.ts +0 -92
  209. package/src/commands/liberica/teams/tasks/get.ts +0 -64
  210. package/src/commands/liberica/teams/tasks/index.ts +0 -19
  211. package/src/commands/liberica/teams/tasks/list.ts +0 -102
  212. package/src/commands/liberica/teams/tasks/update.ts +0 -122
  213. package/src/commands/liberica/teams/work-logs/create.ts +0 -204
  214. package/src/commands/liberica/teams/work-logs/delete.ts +0 -58
  215. package/src/commands/liberica/teams/work-logs/get.ts +0 -87
  216. package/src/commands/liberica/teams/work-logs/index.ts +0 -19
  217. package/src/commands/liberica/teams/work-logs/list.ts +0 -141
  218. package/src/commands/liberica/teams/work-logs/update.ts +0 -120
  219. package/src/commands/liberica/transfer-in-forms/batch-delete.ts +0 -152
  220. package/src/commands/liberica/transfer-in-forms/batch-review.ts +0 -151
  221. package/src/commands/liberica/transfer-in-forms/batch-unreview.ts +0 -152
  222. package/src/commands/liberica/transfer-in-forms/create.ts +0 -179
  223. package/src/commands/liberica/transfer-in-forms/get.ts +0 -107
  224. package/src/commands/liberica/transfer-in-forms/index.ts +0 -23
  225. package/src/commands/liberica/transfer-in-forms/list.ts +0 -97
  226. package/src/commands/liberica/transfer-in-forms/update.ts +0 -213
  227. package/src/commands/liberica/transfer-out-forms/batch-delete.ts +0 -83
  228. package/src/commands/liberica/transfer-out-forms/batch-review.ts +0 -148
  229. package/src/commands/liberica/transfer-out-forms/batch-unreview.ts +0 -56
  230. package/src/commands/liberica/transfer-out-forms/create.ts +0 -194
  231. package/src/commands/liberica/transfer-out-forms/get.ts +0 -114
  232. package/src/commands/liberica/transfer-out-forms/index.ts +0 -23
  233. package/src/commands/liberica/transfer-out-forms/list.ts +0 -125
  234. package/src/commands/liberica/transfer-out-forms/update.ts +0 -197
  235. package/src/commands/liberica/uoms/create.ts +0 -134
  236. package/src/commands/liberica/uoms/delete.ts +0 -105
  237. package/src/commands/liberica/uoms/disable.ts +0 -148
  238. package/src/commands/liberica/uoms/enable.ts +0 -129
  239. package/src/commands/liberica/uoms/get.ts +0 -83
  240. package/src/commands/liberica/uoms/index.ts +0 -23
  241. package/src/commands/liberica/uoms/list.ts +0 -129
  242. package/src/commands/liberica/uoms/update.ts +0 -124
  243. package/src/commands/liberica/users/create.ts +0 -133
  244. package/src/commands/liberica/users/delete.ts +0 -49
  245. package/src/commands/liberica/users/disable.ts +0 -41
  246. package/src/commands/liberica/users/enable.ts +0 -30
  247. package/src/commands/liberica/users/get.ts +0 -46
  248. package/src/commands/liberica/users/index.ts +0 -27
  249. package/src/commands/liberica/users/list.ts +0 -68
  250. package/src/commands/liberica/users/me.ts +0 -42
  251. package/src/commands/liberica/users/reset-password.ts +0 -42
  252. package/src/commands/liberica/users/update.ts +0 -48
  253. package/src/commands/liberica/warehouses/create.ts +0 -204
  254. package/src/commands/liberica/warehouses/delete.ts +0 -112
  255. package/src/commands/liberica/warehouses/disable.ts +0 -174
  256. package/src/commands/liberica/warehouses/enable.ts +0 -174
  257. package/src/commands/liberica/warehouses/get.ts +0 -101
  258. package/src/commands/liberica/warehouses/index.ts +0 -25
  259. package/src/commands/liberica/warehouses/list.ts +0 -136
  260. package/src/commands/liberica/warehouses/locations/create.ts +0 -209
  261. package/src/commands/liberica/warehouses/locations/delete.ts +0 -116
  262. package/src/commands/liberica/warehouses/locations/disable.ts +0 -174
  263. package/src/commands/liberica/warehouses/locations/enable.ts +0 -174
  264. package/src/commands/liberica/warehouses/locations/get.ts +0 -84
  265. package/src/commands/liberica/warehouses/locations/index.ts +0 -23
  266. package/src/commands/liberica/warehouses/locations/list.ts +0 -140
  267. package/src/commands/liberica/warehouses/locations/update.ts +0 -135
  268. package/src/commands/liberica/warehouses/update.ts +0 -142
  269. package/src/core/api/client.ts +0 -4443
  270. package/src/core/auth/token-manager.ts +0 -183
  271. package/src/core/config/manager.ts +0 -164
  272. package/src/index.ts +0 -35
  273. package/src/types/calendar.ts +0 -36
  274. package/src/types/client-contact.ts +0 -78
  275. package/src/types/client.ts +0 -115
  276. package/src/types/currency.ts +0 -90
  277. package/src/types/dict.ts +0 -121
  278. package/src/types/employee.ts +0 -102
  279. package/src/types/index.ts +0 -93
  280. package/src/types/location.ts +0 -66
  281. package/src/types/material.ts +0 -61
  282. package/src/types/mould-stock-in.ts +0 -82
  283. package/src/types/mould.ts +0 -74
  284. package/src/types/operation.ts +0 -72
  285. package/src/types/org.ts +0 -25
  286. package/src/types/position.ts +0 -24
  287. package/src/types/stock.ts +0 -161
  288. package/src/types/supplier-contact.ts +0 -78
  289. package/src/types/supplier.ts +0 -66
  290. package/src/types/team-issue.ts +0 -94
  291. package/src/types/team-project.ts +0 -74
  292. package/src/types/team-task.ts +0 -98
  293. package/src/types/team-work-log.ts +0 -87
  294. package/src/types/transfer-in-form.ts +0 -265
  295. package/src/types/transfer-out-form.ts +0 -290
  296. package/src/types/uom.ts +0 -60
  297. package/src/types/user.ts +0 -64
  298. 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
- ```