@newpeak/barista-cli 0.1.10 → 0.1.12

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

@@ -1,187 +0,0 @@
-# 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

@@ -1,157 +0,0 @@
-# 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

@@ -1,157 +0,0 @@
-# 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.