@newpeak/barista-cli 0.1.9 → 0.1.10

package/docs/commands/liberica/transfer-out-forms/batch-delete.md

@@ -0,0 +1,187 @@
+# barista liberica transfer-out-forms batch-delete
+
+Batch delete transfer-out forms.
+
+## 2.1 Command Metadata
+
+| Field | Value |
+|------|-----|
+| Full Command | `barista liberica transfer-out-forms batch-delete <ids...>` |
+| Description | Batch delete transfer-out forms |
+| HTTP Method | POST |
+| Requires Authentication | Yes |
+| Supports Dry-Run | Yes (default behavior) |
+
+## 2.2 Backend API Reference
+
+### Controller Location
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/stock/
+        └── EnterpriseTransferOutFormController.java
+            └── batchDelete(@PostResource(path = "/batchDelete", requiredPermission = true, requirePermissionCode = TransferOutFormPermissionConstants.DEL_TRANSFER_OUT_FORM))
+                └── public ResponseData<?> batchDelete(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.batchDelete.class) TransferOutFormRequest transferOutFormRequest
+                    )
+```
+
+### Request DTO Location
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
+        └── TransferOutFormRequest.java
+            └── transferOutFormIdList: Set<Long> (@NotEmpty on batchDelete)
+```
+
+**Batch delete request body structure:**
+```json
+{
+  "transferOutFormIdList": [123456789, 123456790]
+}
+```
+
+### Response DTO Location
+Success response returns empty data (`SuccessResponseData<?>`).
+
+## 2.3 CLI Parameter Design
+
+### Command Structure
+```
+barista liberica transfer-out-forms batch-delete <ids...> [options]
+```
+
+### Positional Arguments
+| Argument | Type | Required | Description |
+|------|------|------|------|
+| ids | string... | Yes | One or more transfer-out form IDs (variadic) |
+
+### Global Options
+| Option | Type | Description |
+|------|------|------|
+| `--env` | string | Target environment (dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | Tenant code |
+| `--dry-run` | boolean | Preview mode (default behavior) |
+| `--json` | boolean | JSON output |
+
+### Command Options
+| Option | Short | Type | Required | Default | Description |
+|------|--------|------|------|--------|------|
+| --force | -f | boolean | No | false | Skip confirmation and execute deletion |
+
+## 2.4 Field Mapping Table
+
+| CLI Parameter | DTO Field | Type Conversion | Validation Rule |
+|---------|---------|----------|----------|
+| <ids...> (positional) | transferOutFormIdList | string[]→Set<Long> | @NotEmpty |
+
+## 2.5 Confirmation Flow
+
+Batch delete defaults to dry-run mode and requires explicit confirmation via `--force`:
+
+### Default behavior (no --force)
+```bash
+$ barista liberica transfer-out-forms batch-delete 123456789 123456790
+
+🗑️  Batch Delete Transfer-Out Forms (dev)
+
+  Form IDs: 123456789, 123456790
+  Count: 2
+
+🔍 Dry-Run Mode: No actual deletion will be made
+
+  To delete, add: --force
+```
+
+### Force delete (with --force)
+```bash
+$ barista liberica transfer-out-forms batch-delete 123456789 123456790 --force
+
+🗑️  Batch Delete Transfer-Out Forms (dev)
+
+  Form IDs: 123456789, 123456790
+  Count: 2
+
+✓ 2 transfer-out forms deleted successfully
+```
+
+### JSON output mode
+```bash
+$ barista liberica transfer-out-forms batch-delete 123456789 123456790 --json
+{
+  "success": true,
+  "dryRun": true,
+  "ids": ["123456789", "123456790"],
+  "count": 2
+}
+
+$ barista liberica transfer-out-forms batch-delete 123456789 123456790 --force --json
+{
+  "success": true,
+  "ids": ["123456789", "123456790"],
+  "count": 2
+}
+```
+
+## 2.6 Error Code Reference
+
+### ExceptionEnum Location
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/exception/enums/
+        └── TransferOutFormExceptionEnum.java
+            ├── TRANSFER_OUT_FORM_NOT_EXIST("01001190001", "租户出库单不存在")
+```
+
+### Known Error Codes
+| Error Code | Error Message | Trigger Condition |
+|--------|----------|----------|
+| 01001190001 | Transfer-out form does not exist | One or more IDs do not exist or do not belong to current tenant |
+
+## 2.7 Permission Check
+
+| Check Item | Location | Description |
+|--------|------|------|
+| PermissionConstants | `TransferOutFormPermissionConstants.DEL_TRANSFER_OUT_FORM` | Controller layer `@PostResource(requirePermissionCode = "DEL_TRANSFER_OUT_FORM")` |
+
+## 2.8 Implementation Notes
+
+1. **Variadic IDs**: Accepts one or more form IDs as positional arguments.
+2. **Dry-run default**: Without `--force`, only preview information is displayed.
+3. **Safety mechanism**: `--force` is required to execute the actual deletion.
+4. **BigInteger ID handling**: All IDs must be kept as `string` in TypeScript and sent as numbers in the request body.
+5. **Batch request**: All IDs are collected into `transferOutFormIdList` and sent in a single API call.
+6. **Partial failures**: If any ID does not exist, the backend may reject the entire batch. Surface the error message to the user.
+
+## 2.9 Example Usage
+
+```bash
+# Preview deletion (dry-run, default)
+barista liberica transfer-out-forms batch-delete 123456789
+
+# Delete multiple forms
+barista liberica transfer-out-forms batch-delete 123456789 123456790 123456791 --force
+
+# JSON output preview
+barista liberica transfer-out-forms batch-delete 123456789 --json
+
+# JSON output force delete
+barista liberica transfer-out-forms batch-delete 123456789 123456790 --force --json
+```
+
+## 2.10 API Path
+
+```
+POST /api/enterprise/stock/transferOut/batchDelete
+```
+
+**Headers:**
+```
+Authorization: <token>  (No "Bearer " prefix)
+Content-Type: application/json
+```
+
+**Note**: Do NOT include `X-TENANT-ID` header. Tenant is extracted from JWT token.

package/docs/commands/liberica/transfer-out-forms/batch-review.md

@@ -0,0 +1,157 @@
+# barista liberica transfer-out-forms batch-review
+
+Batch review (approve) transfer-out forms.
+
+## 2.1 Command Metadata
+
+| Field | Value |
+|------|-----|
+| Full Command | `barista liberica transfer-out-forms batch-review <ids...>` |
+| Description | Batch review (approve) transfer-out forms |
+| HTTP Method | POST |
+| Requires Authentication | Yes |
+| Supports Dry-Run | No |
+
+## 2.2 Backend API Reference
+
+### Controller Location
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/stock/
+        └── EnterpriseTransferOutFormController.java
+            └── batchReview(@PostResource(path = "/batchReview", requiredPermission = true, requirePermissionCode = TransferOutFormPermissionConstants.REVIEW_TRANSFER_OUT_FORM))
+                └── public ResponseData<?> batchReview(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.batchDelete.class) TransferOutFormRequest transferOutFormRequest
+                    )
+```
+
+### Request DTO Location
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
+        └── TransferOutFormRequest.java
+            └── transferOutFormIdList: Set<Long> (@NotEmpty on batchDelete class)
+```
+
+**Batch review request body structure:**
+```json
+{
+  "transferOutFormIdList": [123456789, 123456790]
+}
+```
+
+### Response DTO Location
+Success response returns empty data (`SuccessResponseData<?>`).
+
+## 2.3 CLI Parameter Design
+
+### Command Structure
+```
+barista liberica transfer-out-forms batch-review <ids...> [options]
+```
+
+### Positional Arguments
+| Argument | Type | Required | Description |
+|------|------|------|------|
+| ids | string... | Yes | One or more transfer-out form IDs (variadic) |
+
+### Global Options
+| Option | Type | Description |
+|------|------|------|
+| `--env` | string | Target environment (dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | Tenant code |
+| `--json` | boolean | JSON output |
+
+### Command Options
+| Option | Short | Type | Required | Default | Description |
+|------|--------|------|------|--------|------|
+| — | — | — | — | — | No additional options |
+
+## 2.4 Field Mapping Table
+
+| CLI Parameter | DTO Field | Type Conversion | Validation Rule |
+|---------|---------|----------|----------|
+| <ids...> (positional) | transferOutFormIdList | string[]→Set<Long> | @NotEmpty |
+
+## 2.5 Error Code Reference
+
+### ExceptionEnum Location
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/exception/enums/
+        └── TransferOutFormExceptionEnum.java
+            ├── TRANSFER_OUT_FORM_NOT_EXIST("01001190001", "租户出库单不存在")
+```
+
+### Known Error Codes
+| Error Code | Error Message | Trigger Condition |
+|--------|----------|----------|
+| 01001190001 | Transfer-out form does not exist | One or more IDs do not exist or do not belong to current tenant |
+
+## 2.6 Permission Check
+
+| Check Item | Location | Description |
+|--------|------|------|
+| PermissionConstants | `TransferOutFormPermissionConstants.REVIEW_TRANSFER_OUT_FORM` | Controller layer `@PostResource(requirePermissionCode = "REVIEW_TRANSFER_OUT_FORM")` |
+
+## 2.7 Implementation Notes
+
+1. **Variadic IDs**: Accepts one or more form IDs as positional arguments.
+2. **BigInteger ID handling**: All IDs must be kept as `string` in TypeScript and sent as numbers in the request body.
+3. **Batch request**: All IDs are collected into `transferOutFormIdList` and sent in a single API call.
+4. **No dry-run**: This command does not support dry-run because review is a non-destructive state change.
+5. **State validation**: The backend validates that forms are in a reviewable state. Already reviewed forms may be silently skipped or cause an error depending on backend implementation.
+
+## 2.8 Example Usage
+
+```bash
+# Review a single form
+barista liberica transfer-out-forms batch-review 123456789
+
+# Review multiple forms
+barista liberica transfer-out-forms batch-review 123456789 123456790 123456791
+
+# JSON output
+barista liberica transfer-out-forms batch-review 123456789 123456790 --json
+```
+
+## 2.9 Output Examples
+
+### Table Output
+```bash
+$ barista liberica transfer-out-forms batch-review 123456789 123456790
+
+✓ Batch Review Transfer-Out Forms (dev)
+
+  Form IDs: 123456789, 123456790
+  Count: 2
+  Status: Reviewed successfully
+```
+
+### JSON Output
+```json
+{
+  "success": true,
+  "ids": ["123456789", "123456790"],
+  "count": 2,
+  "message": "Reviewed successfully"
+}
+```
+
+## 2.10 API Path
+
+```
+POST /api/enterprise/stock/transferOut/batchReview
+```
+
+**Headers:**
+```
+Authorization: <token>  (No "Bearer " prefix)
+Content-Type: application/json
+```
+
+**Note**: Do NOT include `X-TENANT-ID` header. Tenant is extracted from JWT token.

package/docs/commands/liberica/transfer-out-forms/batch-unreview.md

@@ -0,0 +1,157 @@
+# barista liberica transfer-out-forms batch-unreview
+
+Batch unreview (unapprove) transfer-out forms.
+
+## 2.1 Command Metadata
+
+| Field | Value |
+|------|-----|
+| Full Command | `barista liberica transfer-out-forms batch-unreview <ids...>` |
+| Description | Batch unreview (unapprove) transfer-out forms |
+| HTTP Method | POST |
+| Requires Authentication | Yes |
+| Supports Dry-Run | No |
+
+## 2.2 Backend API Reference
+
+### Controller Location
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/stock/
+        └── EnterpriseTransferOutFormController.java
+            └── batchUnReview(@PostResource(path = "/batchUnReview", requiredPermission = true, requirePermissionCode = TransferOutFormPermissionConstants.UN_REVIEW_TRANSFER_OUT_FORM))
+                └── public ResponseData<?> batchUnReview(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.batchDelete.class) TransferOutFormRequest transferOutFormRequest
+                    )
+```
+
+### Request DTO Location
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
+        └── TransferOutFormRequest.java
+            └── transferOutFormIdList: Set<Long> (@NotEmpty on batchDelete class)
+```
+
+**Batch unreview request body structure:**
+```json
+{
+  "transferOutFormIdList": [123456789, 123456790]
+}
+```
+
+### Response DTO Location
+Success response returns empty data (`SuccessResponseData<?>`).
+
+## 2.3 CLI Parameter Design
+
+### Command Structure
+```
+barista liberica transfer-out-forms batch-unreview <ids...> [options]
+```
+
+### Positional Arguments
+| Argument | Type | Required | Description |
+|------|------|------|------|
+| ids | string... | Yes | One or more transfer-out form IDs (variadic) |
+
+### Global Options
+| Option | Type | Description |
+|------|------|------|
+| `--env` | string | Target environment (dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | Tenant code |
+| `--json` | boolean | JSON output |
+
+### Command Options
+| Option | Short | Type | Required | Default | Description |
+|------|--------|------|------|--------|------|
+| — | — | — | — | — | No additional options |
+
+## 2.4 Field Mapping Table
+
+| CLI Parameter | DTO Field | Type Conversion | Validation Rule |
+|---------|---------|----------|----------|
+| <ids...> (positional) | transferOutFormIdList | string[]→Set<Long> | @NotEmpty |
+
+## 2.5 Error Code Reference
+
+### ExceptionEnum Location
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/exception/enums/
+        └── TransferOutFormExceptionEnum.java
+            ├── TRANSFER_OUT_FORM_NOT_EXIST("01001190001", "租户出库单不存在")
+```
+
+### Known Error Codes
+| Error Code | Error Message | Trigger Condition |
+|--------|----------|----------|
+| 01001190001 | Transfer-out form does not exist | One or more IDs do not exist or do not belong to current tenant |
+
+## 2.6 Permission Check
+
+| Check Item | Location | Description |
+|--------|------|------|
+| PermissionConstants | `TransferOutFormPermissionConstants.UN_REVIEW_TRANSFER_OUT_FORM` | Controller layer `@PostResource(requirePermissionCode = "UN_REVIEW_TRANSFER_OUT_FORM")` |
+
+## 2.7 Implementation Notes
+
+1. **Variadic IDs**: Accepts one or more form IDs as positional arguments.
+2. **BigInteger ID handling**: All IDs must be kept as `string` in TypeScript and sent as numbers in the request body.
+3. **Batch request**: All IDs are collected into `transferOutFormIdList` and sent in a single API call.
+4. **No dry-run**: This command does not support dry-run because unreview is a non-destructive state change.
+5. **State validation**: The backend validates that forms are in an unreviewable state. Forms that are not reviewed may be silently skipped or cause an error depending on backend implementation.
+
+## 2.8 Example Usage
+
+```bash
+# Unreview a single form
+barista liberica transfer-out-forms batch-unreview 123456789
+
+# Unreview multiple forms
+barista liberica transfer-out-forms batch-unreview 123456789 123456790 123456791
+
+# JSON output
+barista liberica transfer-out-forms batch-unreview 123456789 123456790 --json
+```
+
+## 2.9 Output Examples
+
+### Table Output
+```bash
+$ barista liberica transfer-out-forms batch-unreview 123456789 123456790
+
+↩ Batch Unreview Transfer-Out Forms (dev)
+
+  Form IDs: 123456789, 123456790
+  Count: 2
+  Status: Unreviewed successfully
+```
+
+### JSON Output
+```json
+{
+  "success": true,
+  "ids": ["123456789", "123456790"],
+  "count": 2,
+  "message": "Unreviewed successfully"
+}
+```
+
+## 2.10 API Path
+
+```
+POST /api/enterprise/stock/transferOut/batchUnReview
+```
+
+**Headers:**
+```
+Authorization: <token>  (No "Bearer " prefix)
+Content-Type: application/json
+```
+
+**Note**: Do NOT include `X-TENANT-ID` header. Tenant is extracted from JWT token.