@newpeak/barista-cli 0.1.9 → 0.1.10

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

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

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

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