@newpeak/barista-cli 0.1.11 → 0.1.13

package/docs/commands/liberica/transfer-in-forms/get.md

@@ -1,221 +0,0 @@
-# barista liberica transfer-in-forms get
-
-获取单个调整入库单详情。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica transfer-in-forms get <id>` |
-| 功能描述 | 获取单个调整入库单详情 |
-| HTTP方法 | GET |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ⬜ 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/stock/
-        └── EnterpriseTransferInFormController.java
-            └── detail(@GetResource(path = "/detail"))
-                └── public ResponseData<TransferInFormResponse> detail(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @ParameterObject @Validated(BaseRequest.detail.class) TransferInFormRequest transferInFormRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
-        └── TransferInFormRequest.java
-            └── transferInFormId: Long (@NotNull on detail)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
-        └── TransferInFormResponse.java
-            ├── transferInFormId: Long
-            ├── transferInFormCode: String
-            ├── mainWarehouseCode: String
-            ├── stockDate: Date
-            ├── transferInType: String
-            ├── follower: String
-            ├── followerName: String
-            ├── reviewFlag: String
-            ├── reviewer: String
-            ├── reviewerName: String
-            ├── reviewTime: Instant
-            ├── remark: String
-            ├── createTime: String
-            ├── updateTime: String
-            └── itemList: List<TransferInFormItemResponse>
-```
-
-### Item Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
-        └── TransferInFormItemResponse.java
-            ├── transferInFormItemId: Long
-            ├── transferInFormItemCode: String
-            ├── transferInFormId: Long
-            ├── warehouseCode: String
-            ├── materialCode: String
-            ├── materialNo: String
-            ├── materialName: String
-            ├── materialType: String
-            ├── materialUomCode: String
-            ├── formQuantity: BigDecimal
-            ├── formMaterialUomCode: String
-            ├── formUnitPrice: BigDecimal
-            ├── stockQuantity: BigDecimal
-            ├── unitPrice: BigDecimal
-            ├── localCurrency: String
-            ├── stockAmount: BigDecimal
-            ├── lotCode: String
-            ├── lotNo: String
-            ├── supplierLotNo: String
-            ├── producedDate: Date
-            └── remark: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica transfer-in-forms get <id> [options]
-```
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| id | string | ✅ | 调整入库单ID (transferInFormId) |
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 |
-|------|--------|------|------|--------|------|
-| — | — | — | — | — | 此命令无额外选项，ID 通过位置参数传入 |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| <id> (位置参数) | transferInFormId | string→Long | @NotNull |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/exception/enums/
-        └── TransferInFormExceptionEnum.java
-            ├── TRANSFER_IN_FORM_NOT_EXIST(RuleConstants.USER_OPERATION_ERROR_TYPE_CODE + StockConstants.TRANSFER_IN_FORM_EXCEPTION_STEP_CODE + "001", "租户入库单不存在")
-            └── ...
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001xx001 | 租户入库单不存在 | transferInFormId 不存在或不属于当前租户 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | `@GetResource(path = "/detail")` | 无 requiredPermission |
-
-## 2.7 实现要点
-
-1. **位置参数**：`get` 命令使用 `<id>` 位置参数指定调整入库单ID
-2. **BigInteger ID**：`transferInFormId` 必须作为 `string` 处理，避免精度丢失
-3. **No X-TENANT-ID**：租户通过 JWT token 传递，不要发送 `X-TENANT-ID` header
-4. **明细输出**：详情包含主单信息和 `itemList` 明细列表
-5. **错误处理**：入库单不存在时显示友好错误信息
-
-## 2.8 示例用法
-
-```bash
-# 获取入库单详情
-barista liberica transfer-in-forms get 1234567890123456789
-
-# JSON 输出
-barista liberica transfer-in-forms get 1234567890123456789 --json
-
-# 入库单不存在
-barista liberica transfer-in-forms get 9999999999999999999
-# 输出: Error: 租户入库单不存在 (01001xx001)
-```
-
-## 2.9 输出示例
-
-### 表格输出
-```
-┌─────────────────┬────────────────────────────┐
-│ 属性            │ 值                         │
-├─────────────────┼────────────────────────────┤
-│ 入库单ID        │ 1234567890123456789        │
-│ 入库单编码      │ TI20250001                 │
-│ 仓库编码        │ WH001                      │
-│ 入库日期        │ 2025-05-13                 │
-│ 调整入库类型    │ 借入                        │
-│ 入库人          │ 张三                        │
-│ 审核标记        │ 已审核                      │
-│ 审核人          │ 李四                        │
-│ 审核时间        │ 2025-05-13 14:30:00        │
-│ 备注            │ 紧急调拨入库                │
-└─────────────────┴────────────────────────────┘
-
-明细 (2 条):
-┌──────────┬────────────┬────────────┬─────────────┬────────────┬────────────┐
-│ 物料编码 │ 物料名称   │ 入库数量   │ 计量单位    │ 单价       │ 金额       │
-├──────────┼────────────┼────────────┼─────────────┼────────────┼────────────┤
-│ MAT001   │ 钢板       │ 100.00     │ KG          │ 5.00       │ 500.00     │
-│ MAT002   │ 铝材       │ 50.00      │ KG          │ 8.00       │ 400.00     │
-└──────────┴────────────┴────────────┴─────────────┴────────────┴────────────┘
-```
-
-### JSON输出
-```json
-{
-  "success": true,
-  "data": {
-    "transferInFormId": "1234567890123456789",
-    "transferInFormCode": "TI20250001",
-    "mainWarehouseCode": "WH001",
-    "stockDate": "2025-05-13",
-    "transferInType": "BORROW_IN",
-    "followerName": "张三",
-    "reviewFlag": "REVIEWED",
-    "reviewerName": "李四",
-    "remark": "紧急调拨入库",
-    "itemList": [
-      {
-        "transferInFormItemId": "9876543210987654321",
-        "materialCode": "MAT001",
-        "materialName": "钢板",
-        "stockQuantity": "100.00",
-        "materialUomCode": "KG",
-        "unitPrice": "5.00",
-        "stockAmount": "500.00"
-      }
-    ]
-  }
-}
-```

package/docs/commands/liberica/transfer-in-forms/list.md

@@ -1,242 +0,0 @@
-# barista liberica transfer-in-forms list
-
-分页查询调整入库单列表。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica transfer-in-forms list` |
-| 功能描述 | 分页查询调整入库单列表 |
-| HTTP方法 | GET |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ⬜ 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/stock/
-        └── EnterpriseTransferInFormController.java
-            └── page(@GetResource(path = "/page"))
-                └── public ResponseData<PageResult<TransferInFormCompactResponse>> page(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @ParameterObject TransferInFormCompactQueryRequest transferInFormCompactQueryRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
-        └── TransferInFormCompactQueryRequest.java
-            ├── pageNo: Long (分页当前页，从0开始)
-            ├── pageSize: Long (分页大小)
-            ├── transferInFormCode: String (入库单编码)
-            ├── warehouseCode: String (入库仓库编码)
-            ├── transferInType: String (调整入库类型)
-            ├── reviewFlag: String (审核标记)
-            ├── stockDate: Date (入库日期)
-            ├── stockDateCriteria: DateRange (入库日期范围)
-            ├── materialCode: String (物料编码)
-            ├── materialName: String (物料名称)
-            ├── follower: String (入库人)
-            └── reviewer: String (审核人)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
-        └── TransferInFormCompactResponse.java
-            ├── transferInFormItemId: Long
-            ├── transferInFormItemCode: String
-            ├── transferInFormId: Long
-            ├── transferInFormCode: String
-            ├── sourceType: String
-            ├── sourceCode: String
-            ├── warehouseCode: String
-            ├── materialCode: String
-            ├── materialNo: String
-            ├── materialName: String
-            ├── materialType: String
-            ├── materialUomCode: String
-            ├── formQuantity: BigDecimal
-            ├── formMaterialUomCode: String
-            ├── formUnitPrice: BigDecimal
-            ├── stockQuantity: BigDecimal
-            ├── unitPrice: BigDecimal
-            ├── localCurrency: String
-            ├── stockAmount: BigDecimal
-            ├── lotCode: String
-            ├── lotNo: String
-            ├── supplierLotNo: String
-            ├── remark: String
-            ├── stockDate: Date
-            ├── transferInType: String
-            ├── reviewFlag: String
-            ├── reviewer: String
-            ├── reviewerName: String
-            ├── reviewTime: Instant
-            ├── follower: String
-            ├── followerName: String
-            ├── createTime: String
-            └── updateTime: String
-```
-
-### 分页包装器
-```
-cn.stylefeng.roses.kernel.db.api.pojo.page.PageResult
-    ├── totalRows: long
-    ├── pageSize: long
-    ├── pageNo: long
-    └── rows: List<TransferInFormCompactResponse>
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica transfer-in-forms list [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --page | -p | number | ⬜ | 1 | 页码 | pageNo |
-| --size | -s | number | ⬜ | 20 | 每页条数 | pageSize |
-| --code | -c | string | ⬜ | - | 入库单编码 | transferInFormCode |
-| --warehouse-code | -w | string | ⬜ | - | 入库仓库编码 | warehouseCode |
-| --type | -t | string | ⬜ | - | 调整入库类型 | transferInType |
-| --review-flag | -r | string | ⬜ | - | 审核标记 | reviewFlag |
-| --stock-date | -d | string | ⬜ | - | 入库日期(YYYY-MM-DD) | stockDate |
-| --stock-date-from | — | string | ⬜ | - | 入库日期开始 | stockDateCriteria.from |
-| --stock-date-to | — | string | ⬜ | - | 入库日期结束 | stockDateCriteria.to |
-| --material-code | -m | string | ⬜ | - | 物料编码 | materialCode |
-| --material-name | -n | string | ⬜ | - | 物料名称 | materialName |
-| --follower | -f | string | ⬜ | - | 入库人 | follower |
-| --reviewer | — | string | ⬜ | - | 审核人 | reviewer |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| --page / -p | pageNo | number→Long | >= 1，API调用时减1 |
-| --size / -s | pageSize | number→Long | 1-100 |
-| --code / -c | transferInFormCode | 直接传递 | max=255 |
-| --warehouse-code / -w | warehouseCode | 直接传递 | max=255 |
-| --type / -t | transferInType | 直接传递 | 字典值: BORROW_IN, RETURN_IN, BALANCE_IN, OVERSEA_TRADE, MATERIAL_RET_IN, POOR_SUBSTITUTE, OTHER |
-| --review-flag / -r | reviewFlag | 直接传递 | 字典值: REVIEWED, UN_REVIEWED |
-| --stock-date / -d | stockDate | string→Date | yyyy-MM-dd |
-| --stock-date-from | stockDateCriteria.from | string→Date | yyyy-MM-dd |
-| --stock-date-to | stockDateCriteria.to | string→Date | yyyy-MM-dd |
-| --material-code / -m | materialCode | 直接传递 | max=255 |
-| --material-name / -n | materialName | 直接传递 | max=255 |
-| --follower / -f | follower | 直接传递 | max=255 |
-| --reviewer | reviewer | 直接传递 | max=255 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/exception/enums/
-        └── TransferInFormExceptionEnum.java
-            ├── TRANSFER_IN_FORM_NOT_EXIST("01001xx001", "租户入库单不存在")
-            └── ...
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001xx001 | 租户入库单不存在 | 查询详情时ID不存在 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | `@GetResource(path = "/page")` | 无 requiredPermission（无需权限码） |
-
-**注意**：page 接口在 Controller 层无需权限校验，数据范围通过 tenantId 隔离。
-
-## 2.7 实现要点
-
-1. **分页转换**：CLI page=1 → API pageNo=0
-2. **BigInteger ID**：`transferInFormId`、`transferInFormItemId` 等 ID 字段必须作为 `string` 处理，避免精度丢失
-3. **No X-TENANT-ID**：租户通过 JWT token 传递，不要发送 `X-TENANT-ID` header
-4. **表格输出**：默认表格展示，包含 transferInFormCode, warehouseCode, materialName, stockQuantity, reviewFlag, stockDate
-5. **JSON输出**：使用 `--json` 输出完整 `PageResult` 结构
-
-## 2.8 示例用法
-
-```bash
-# 默认分页
-barista liberica transfer-in-forms list
-
-# 指定页码和每页条数
-barista liberica transfer-in-forms list --page 2 --size 50
-
-# 按入库单编码筛选
-barista liberica transfer-in-forms list --code "TI20250001"
-
-# 按仓库和审核状态筛选
-barista liberica transfer-in-forms list --warehouse-code "WH001" --review-flag REVIEWED
-
-# 按入库日期范围筛选
-barista liberica transfer-in-forms list --stock-date-from 2025-01-01 --stock-date-to 2025-01-31
-
-# 按物料搜索
-barista liberica transfer-in-forms list --material-name "钢板"
-
-# JSON 输出
-barista liberica transfer-in-forms list --page 1 --size 20 --json
-```
-
-## 2.9 输出示例
-
-### 表格输出
-```
-┌─────────────────┬─────────────┬────────────┬─────────────┬────────────┬────────────┐
-│ 入库单编码      │ 仓库编码    │ 物料名称   │ 入库数量    │ 审核状态   │ 入库日期   │
-├─────────────────┼─────────────┼────────────┼─────────────┼────────────┼────────────┤
-│ TI20250001      │ WH001       │ 钢板       │ 100.00      │ 已审核     │ 2025-05-13 │
-│ TI20250002      │ WH002       │ 铝材       │ 50.00       │ 未审核     │ 2025-05-14 │
-└─────────────────┴─────────────┴────────────┴─────────────┴────────────┴────────────┘
-共 2 条，第 1/1 页
-```
-
-### JSON输出
-```json
-{
-  "success": true,
-  "data": {
-    "totalRows": 2,
-    "pageSize": 20,
-    "pageNo": 0,
-    "rows": [
-      {
-        "transferInFormId": "1234567890123456789",
-        "transferInFormCode": "TI20250001",
-        "warehouseCode": "WH001",
-        "materialName": "钢板",
-        "stockQuantity": "100.00",
-        "reviewFlag": "REVIEWED",
-        "stockDate": "2025-05-13",
-        "followerName": "张三"
-      }
-    ]
-  }
-}
-```

package/docs/commands/liberica/transfer-in-forms/update.md

@@ -1,185 +0,0 @@
-# barista liberica transfer-in-forms update
-
-编辑现有调整入库单。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica transfer-in-forms update <id>` |
-| 功能描述 | 编辑现有调整入库单 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/stock/
-        └── EnterpriseTransferInFormController.java
-            └── edit(@PostResource(path = "/edit", requiredPermission = true, requirePermissionCode = TransferInFormPermissionConstants.EDIT_TRANSFER_IN_FORM))
-                └── public ResponseData<?> edit(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.edit.class) TransferInFormRequest transferInFormRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
-        └── TransferInFormRequest.java
-            ├── transferInFormId: Long (@NotNull on edit)
-            ├── transferInFormCode: String (max=255)
-            ├── mainWarehouseCode: String (@NotBlank on edit, max=255)
-            ├── stockDate: Date (@NotNull on edit)
-            ├── transferInType: String (@NotBlank on edit, max=255)
-            ├── follower: String (@NotBlank on edit, max=255)
-            ├── followerName: String (max=255)
-            ├── remark: String (max=255)
-            └── itemList: List<TransferInFormItemRequest> (@NotEmpty on edit, @Valid)
-```
-
-### Item Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
-        └── TransferInFormItemRequest.java
-            ├── transferInFormItemId: Long
-            ├── warehouseCode: String (@NotBlank on edit, max=255)
-            ├── materialCode: String (@NotBlank on edit, max=255)
-            ├── materialName: String (max=255)
-            ├── materialUomCode: String (max=255)
-            ├── formQuantity: BigDecimal (@NotNull on edit)
-            ├── formMaterialUomCode: String (@NotBlank on edit, max=255)
-            ├── formUnitPrice: BigDecimal (@NotNull on edit)
-            ├── stockQuantity: BigDecimal
-            ├── unitPrice: BigDecimal
-            ├── localCurrency: String (max=255)
-            ├── stockAmount: BigDecimal
-            ├── producedDate: Date
-            ├── lotCode: String (max=255)
-            ├── lotNo: String (max=255)
-            ├── supplierLotNo: String (max=255)
-            └── remark: String (max=255)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
-        └── SuccessResponseData (空 data)
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica transfer-in-forms update <id> [options]
-```
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| id | string | ✅ | 调整入库单ID (transferInFormId) |
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --warehouse-code | -w | string | ✅ | - | 主仓库编码 | mainWarehouseCode |
-| --stock-date | -d | string | ✅ | - | 入库日期(YYYY-MM-DD) | stockDate |
-| --type | -t | string | ✅ | - | 调整入库类型 | transferInType |
-| --follower | -f | string | ✅ | - | 入库人编码 | follower |
-| --follower-name | — | string | ⬜ | - | 入库人姓名 | followerName |
-| --remark | -r | string | ⬜ | - | 备注 | remark |
-| --items | -i | string | ✅ | - | 明细项JSON数组 | itemList |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| <id> (位置参数) | transferInFormId | string→Long | @NotNull |
-| --warehouse-code / -w | mainWarehouseCode | 直接传递 | @NotBlank, max=255 |
-| --stock-date / -d | stockDate | string→Date | @NotNull, yyyy-MM-dd |
-| --type / -t | transferInType | 直接传递 | @NotBlank, max=255 |
-| --follower / -f | follower | 直接传递 | @NotBlank, max=255 |
-| --follower-name | followerName | 直接传递 | max=255 |
-| --remark / -r | remark | 直接传递 | max=255 |
-| --items / -i | itemList | string(JSON)→List | @NotEmpty, @Valid |
-
-**自动填充字段（不通过CLI参数）：**
-| 字段 | 值 |
-|------|-----|
-| tenantId | 来自 JWT token（不要传递 X-TENANT-ID header） |
-| transferInFormCode | 保持原值不变 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/exception/enums/
-        └── TransferInFormExceptionEnum.java
-            ├── TRANSFER_IN_FORM_NOT_EXIST("01001xx001", "租户入库单不存在")
-            └── ...
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001xx001 | 租户入库单不存在 | transferInFormId 不存在或不属于当前租户 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `TransferInFormPermissionConstants.EDIT_TRANSFER_IN_FORM` | Controller层 `@PostResource(requirePermissionCode = "EDIT_TRANSFER_IN_FORM")` |
-
-## 2.7 实现要点
-
-1. **ID必填**：通过 `<id>` 位置参数传入 `transferInFormId`
-2. **BigInteger ID**：`transferInFormId` 必须作为 `string` 处理，避免精度丢失
-3. **No X-TENANT-ID**：租户通过 JWT token 传递，不要发送 `X-TENANT-ID` header
-4. **Dry-run支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
-5. **item编辑**：编辑时明细项中的 `transferInFormItemId` 用于标识已有明细（新增明细不传此字段）
-6. **已审核限制**：已审核的入库单通常不允许编辑，后端会返回业务错误
-
-## 2.8 示例用法
-
-```bash
-# 编辑入库单
-barista liberica transfer-in-forms update 1234567890123456789 \
-  --warehouse-code "WH001" \
-  --stock-date 2025-05-14 \
-  --type "BORROW_IN" \
-  --follower "EMP001" \
-  --remark "更新备注" \
-  --items '[
-    {"transferInFormItemId":"9876543210987654321","warehouseCode":"WH001","materialCode":"MAT001","formQuantity":120,"formMaterialUomCode":"KG","formUnitPrice":5.50},
-    {"warehouseCode":"WH001","materialCode":"MAT003","formQuantity":30,"formMaterialUomCode":"KG","formUnitPrice":10.00}
-  ]'
-
-# Dry-run 预览
-barista liberica transfer-in-forms update 1234567890123456789 \
-  --warehouse-code "WH001" \
-  --stock-date 2025-05-14 \
-  --type "BORROW_IN" \
-  --follower "EMP001" \
-  --items '[...]' \
-  --dry-run
-```