@newpeak/barista-cli 0.1.11 → 0.1.12

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

@@ -1,233 +0,0 @@
-# barista liberica transfer-out-forms list
-
-Paginated query of transfer-out form line items.
-
-## 2.1 Command Metadata
-
-| Field | Value |
-|------|-----|
-| Full Command | `barista liberica transfer-out-forms list` |
-| Description | Paginated query of transfer-out form line items |
-| HTTP Method | GET |
-| 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
-            └── page(@GetResource(path = "/page"))
-                └── public ResponseData<PageResult<TransferOutFormCompactResponse>> page(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @ParameterObject TransferOutFormCompactQueryRequest transferOutFormCompactQueryRequest
-                    )
-```
-
-### Request DTO Location
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
-        └── TransferOutFormCompactQueryRequest.java
-            ├── current: Long (page number, 0-based)
-            ├── size: Long (page size)
-            ├── transferOutFormCode: String
-            ├── warehouseCode: String
-            ├── materialCode: String
-            ├── materialName: String
-            ├── stockDate: Date
-            ├── stockDateCriteria: DateRange
-            ├── transferOutType: String
-            ├── reviewFlag: String
-            ├── reviewerName: String
-            ├── followerName: String
-            └── sourceCode: String
-```
-
-### Response DTO Location
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
-        └── TransferOutFormCompactResponse.java
-            ├── transferOutFormItemId: Long
-            ├── transferOutFormItemCode: String
-            ├── transferOutFormId: Long
-            ├── transferOutFormCode: String
-            ├── warehouseCode: String
-            ├── materialCode: String
-            ├── materialName: String
-            ├── materialType: String
-            ├── materialUomCode: String
-            ├── formQuantity: BigDecimal
-            ├── formMaterialUomCode: String
-            ├── stockQuantity: BigDecimal
-            ├── unitPrice: BigDecimal
-            ├── stockAmount: BigDecimal
-            ├── stockDate: Date
-            ├── transferOutType: String
-            ├── reviewFlag: String
-            ├── reviewerName: String
-            ├── followerName: String
-            ├── createTime: String
-            └── updateTime: String
-```
-
-### Pagination Wrapper
-```
-cn.stylefeng.roses.kernel.db.api.pojo.page.PageResult
-    ├── total: long
-    ├── size: long
-    ├── current: long
-    └── records: List<TransferOutFormCompactResponse>
-```
-
-## 2.3 CLI Parameter Design
-
-### Command Structure
-```
-barista liberica transfer-out-forms list [options]
-```
-
-### 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 | Maps to DTO Field |
-|------|--------|------|------|--------|------|-------------|
-| --page | -p | number | No | 1 | Page number (1-based) | current |
-| --size | -s | number | No | 20 | Page size | size |
-| --code | -c | string | No | - | Transfer-out form code | transferOutFormCode |
-| --warehouse-code | -w | string | No | - | Warehouse code | warehouseCode |
-| --material-code | -m | string | No | - | Material code | materialCode |
-| --material-name | -n | string | No | - | Material name (fuzzy) | materialName |
-| --review-flag | -r | string | No | - | Review flag | reviewFlag |
-| --stock-date-start | — | string | No | - | Stock date start (YYYY-MM-DD) | stockDateCriteria.start |
-| --stock-date-end | — | string | No | - | Stock date end (YYYY-MM-DD) | stockDateCriteria.end |
-| --follower-name | -f | string | No | - | Follower name | followerName |
-
-## 2.4 Field Mapping Table
-
-| CLI Parameter | DTO Field | Type Conversion | Validation Rule |
-|---------|---------|----------|----------|
-| --page / -p | current | number→Long | >= 1, CLI page 1 maps to API page 0 |
-| --size / -s | size | number→Long | 1-100 |
-| --code / -c | transferOutFormCode | Direct | max=255 |
-| --warehouse-code / -w | warehouseCode | Direct | max=255 |
-| --material-code / -m | materialCode | Direct | max=255 |
-| --material-name / -n | materialName | Direct | fuzzy match |
-| --review-flag / -r | reviewFlag | Direct | enum validation |
-| --stock-date-start | stockDateCriteria.start | string→Date | yyyy-MM-dd |
-| --stock-date-end | stockDateCriteria.end | string→Date | yyyy-MM-dd |
-| --follower-name / -f | followerName | Direct | max=255 |
-
-## 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 | Detail with non-existent ID |
-
-## 2.6 Permission Check
-
-| Check Item | Location | Description |
-|--------|------|------|
-| Annotation | `@GetResource(path = "/page")` | No requiredPermission |
-
-## 2.7 Implementation Notes
-
-1. **Pagination conversion**: CLI page is 1-based, API page is 0-based. `apiPage = cliPage - 1`.
-2. **No X-TENANT-ID header**: Tenant is extracted from JWT token.
-3. **BigInteger ID handling**: All ID fields (`transferOutFormId`, `transferOutFormItemId`) must be parsed as `string` in TypeScript to avoid precision loss.
-4. **Date range**: When only start or only end is provided, send it as a single `stockDate` instead of `stockDateCriteria`.
-5. **Output format**: Table output with pagination summary at the bottom.
-
-## 2.8 Example Usage
-
-```bash
-# Default pagination
-barista liberica transfer-out-forms list
-
-# Page 2 with 50 items per page
-barista liberica transfer-out-forms list --page 2 --size 50
-
-# Filter by warehouse and review flag
-barista liberica transfer-out-forms list --warehouse-code WH001 --review-flag reviewed
-
-# Filter by date range
-barista liberica transfer-out-forms list --stock-date-start 2025-01-01 --stock-date-end 2025-01-31
-
-# JSON output
-barista liberica transfer-out-forms list --page 1 --size 10 --json
-```
-
-## 2.9 Output Examples
-
-### Table Output
-```
-┌─────────────┬─────────────────────┬──────────────┬──────────────────┬───────────────┬─────────────┬──────────────┐
-│ Item ID     │ Form Code           │ Warehouse    │ Material Name    │ Stock Qty     │ Review Flag │ Follower     │
-├─────────────┼─────────────────────┼──────────────┼──────────────────┼───────────────┼─────────────┼──────────────┤
-│ 1000001     │ TO-2025-0001        │ WH001        │ Coffee Beans A   │ 500.00        │ reviewed    │ Zhang San    │
-│ 1000002     │ TO-2025-0001        │ WH001        │ Coffee Beans B   │ 300.00        │ reviewed    │ Zhang San    │
-│ 1000003     │ TO-2025-0002        │ WH002        │ Filter Paper     │ 1000.00       │ pending     │ Li Si        │
-└─────────────┴─────────────────────┴──────────────┴──────────────────┴───────────────┴─────────────┴──────────────┘
-Total: 3 | Page 1/1 | Size 20
-```
-
-### JSON Output
-```json
-{
-  "success": true,
-  "data": {
-    "items": [
-      {
-        "transferOutFormItemId": "1000001",
-        "transferOutFormCode": "TO-2025-0001",
-        "warehouseCode": "WH001",
-        "materialName": "Coffee Beans A",
-        "stockQuantity": "500.00",
-        "materialUomCode": "kg",
-        "reviewFlag": "reviewed",
-        "followerName": "Zhang San",
-        "stockDate": "2025-05-15"
-      }
-    ],
-    "pagination": {
-      "page": 1,
-      "size": 20,
-      "total": 3
-    }
-  }
-}
-```
-
-## 2.10 API Path
-
-```
-GET /api/enterprise/stock/transferOut/page?pageNo=0&pageSize=20
-```
-
-**Headers:**
-```
-Authorization: <token>  (No "Bearer " prefix)
-```
-
-**Note**: Do NOT include `X-TENANT-ID` header. Tenant is extracted from JWT token.

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

@@ -1,286 +0,0 @@
-# barista liberica transfer-out-forms update
-
-Update an existing transfer-out form.
-
-## 2.1 Command Metadata
-
-| Field | Value |
-|------|-----|
-| Full Command | `barista liberica transfer-out-forms update <id>` |
-| Description | Update an existing transfer-out form |
-| HTTP Method | POST |
-| Requires Authentication | Yes |
-| Supports Dry-Run | Yes |
-
-## 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
-            └── edit(@PostResource(path = "/edit", requiredPermission = true, requirePermissionCode = TransferOutFormPermissionConstants.EDIT_TRANSFER_OUT_FORM))
-                └── public ResponseData<? extends TransferOutFormResponse> edit(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.edit.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
-            ├── transferOutFormId: Long (@NotNull on edit)
-            ├── warehouseCode: String (@NotBlank on edit, max=255)
-            ├── stockDate: Date (@NotNull on edit)
-            ├── transferOutType: String (@NotBlank on edit, max=255)
-            ├── transferOutFormCode: String (max=255)
-            ├── follower: String (max=255)
-            ├── followerName: String (max=255)
-            ├── remark: String (max=255)
-            ├── itemList: List<TransferOutFormItemRequest> (@NotEmpty on edit)
-            └── lotList: List<TransferOutFormLotRequest>
-```
-
-**TransferOutFormItemRequest (required fields on edit):**
-```
-├── materialCode: String (@NotBlank, max=255)
-├── materialUomCode: String (@NotBlank, max=255)
-├── formQuantity: BigDecimal (@NotNull)
-├── formMaterialUomCode: String (@NotBlank, max=255)
-├── stockQuantity: BigDecimal (@NotNull)
-├── transferOutFormItemId: Long (required for existing items)
-├── sourceType: String (max=255)
-├── sourceCode: String (max=255)
-├── materialName: String (max=255)
-├── materialType: String (max=255)
-├── materialCharacteristicCode: String (max=255)
-├── color: String (max=255)
-├── longX: BigDecimal
-├── wideY: BigDecimal
-├── highZ: BigDecimal
-├── lotNoList: List<String>
-├── unitPrice: BigDecimal
-├── localCurrency: String (max=255)
-├── stockAmount: BigDecimal
-└── remark: String (max=255)
-```
-
-**TransferOutFormLotRequest (required fields on edit):**
-```
-├── transferOutFormLotId: Long (required for existing lots)
-├── warehouseCode: String (@NotBlank, max=255)
-├── materialCode: String (@NotBlank, max=255)
-├── materialUomCode: String (@NotBlank, max=255)
-├── lotNo: String (max=255)
-├── stockQuantity: BigDecimal (@NotNull)
-├── materialName: String (max=255)
-├── materialType: String (max=255)
-├── materialCharacteristicCode: String (max=255)
-├── color: String (max=255)
-├── longX: BigDecimal
-├── wideY: BigDecimal
-├── highZ: BigDecimal
-├── unitPrice: BigDecimal
-├── localCurrency: String (max=255)
-├── stockAmount: BigDecimal
-└── remark: String (max=255)
-```
-
-### Response DTO Location
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
-        └── TransferOutFormResponse.java
-            ├── transferOutFormId: Long
-            ├── transferOutFormCode: String
-            ├── warehouseCode: String
-            ├── stockDate: Date
-            ├── transferOutType: String
-            ├── follower: String
-            ├── followerName: String
-            ├── reviewFlag: String
-            ├── reviewer: String
-            ├── reviewerName: String
-            ├── reviewTime: Instant
-            ├── remark: String
-            ├── enough: boolean
-            ├── itemList: List<TransferOutFormItemResponse>
-            ├── lotList: List<TransferOutFormLotResponse>
-            ├── createTime: String
-            └── updateTime: String
-```
-
-## 2.3 CLI Parameter Design
-
-### Command Structure
-```
-barista liberica transfer-out-forms update <id> [options]
-```
-
-### Positional Arguments
-| Argument | Type | Required | Description |
-|------|------|------|------|
-| id | string | Yes | Transfer-out form ID (transferOutFormId) |
-
-### Global Options
-| Option | Type | Description |
-|------|------|------|
-| `--env` | string | Target environment (dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | Tenant code |
-| `--dry-run` | boolean | Preview mode (no actual API call) |
-| `--json` | boolean | JSON output |
-
-### Command Options
-| Option | Short | Type | Required | Default | Description | Maps to DTO Field |
-|------|--------|------|------|--------|------|-------------|
-| --warehouse-code | -w | string | Yes | - | Warehouse code | warehouseCode |
-| --stock-date | -d | string | Yes | - | Stock date (YYYY-MM-DD) | stockDate |
-| --transfer-out-type | -t | string | Yes | - | Transfer-out type | transferOutType |
-| --code | -c | string | No | - | Transfer-out form code | transferOutFormCode |
-| --follower | -f | string | No | - | Follower code | follower |
-| --follower-name | -n | string | No | - | Follower name | followerName |
-| --remark | -r | string | No | - | Remark | remark |
-| --items | -i | string | Yes | - | Item list as JSON array | itemList |
-| --lots | -l | string | No | - | Lot list as JSON array | lotList |
-
-## 2.4 Field Mapping Table
-
-| CLI Parameter | DTO Field | Type Conversion | Validation Rule |
-|---------|---------|----------|----------|
-| <id> (positional) | transferOutFormId | string→Long | @NotNull |
-| --warehouse-code / -w | warehouseCode | Direct | @NotBlank, max=255 |
-| --stock-date / -d | stockDate | string→Date | @NotNull, yyyy-MM-dd |
-| --transfer-out-type / -t | transferOutType | Direct | @NotBlank, max=255 |
-| --code / -c | transferOutFormCode | Direct | max=255 |
-| --follower / -f | follower | Direct | max=255 |
-| --follower-name / -n | followerName | Direct | max=255 |
-| --remark / -r | remark | Direct | max=255 |
-| --items / -i | itemList | string→JSON Array | @NotEmpty |
-| --lots / -l | lotList | string→JSON Array | - |
-
-## 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 | Update with non-existent ID |
-
-## 2.6 Permission Check
-
-| Check Item | Location | Description |
-|--------|------|------|
-| PermissionConstants | `TransferOutFormPermissionConstants.EDIT_TRANSFER_OUT_FORM` | Controller layer `@PostResource(requirePermissionCode = "EDIT_TRANSFER_OUT_FORM")` |
-
-## 2.7 Implementation Notes
-
-1. **Required fields**: `id` (positional), `--warehouse-code`, `--stock-date`, `--transfer-out-type`, and `--items` must be provided.
-2. **Item ID handling**: Existing items must include `transferOutFormItemId` in the JSON array. New items should omit this field.
-3. **Lot ID handling**: Existing lots must include `transferOutFormLotId` in the JSON array. New lots should omit this field.
-4. **Dry-run support**: Use `--dry-run` to preview the request body without calling the API.
-5. **BigInteger ID handling**: `transferOutFormId` and nested IDs must be parsed as `string` in TypeScript to avoid precision loss.
-6. **Pre-population**: For CLI convenience, consider fetching the current form detail first and merging unchanged fields with the provided options.
-
-## 2.8 Example Usage
-
-```bash
-# Update with minimal required fields
-barista liberica transfer-out-forms update 123456789 \
-  --warehouse-code WH001 \
-  --stock-date 2025-05-15 \
-  --transfer-out-type adjustment \
-  --items '[{"transferOutFormItemId":"1000001","materialCode":"MAT001","materialUomCode":"kg","formQuantity":600,"formMaterialUomCode":"kg","stockQuantity":600}]'
-
-# Update with all options
-barista liberica transfer-out-forms update 123456789 \
-  --warehouse-code WH001 \
-  --stock-date 2025-05-15 \
-  --transfer-out-type adjustment \
-  --code "TO-2025-0001" \
-  --follower "EMP001" \
-  --follower-name "Zhang San" \
-  --remark "Updated adjustment" \
-  --items '[{"transferOutFormItemId":"1000001","materialCode":"MAT001","materialName":"Coffee Beans A","materialUomCode":"kg","formQuantity":600,"formMaterialUomCode":"kg","stockQuantity":600,"unitPrice":50,"stockAmount":30000}]' \
-  --lots '[{"transferOutFormLotId":"2000001","warehouseCode":"WH001","materialCode":"MAT001","materialUomCode":"kg","lotNo":"LOT202501","stockQuantity":600}]'
-
-# Dry-run preview
-barista liberica transfer-out-forms update 123456789 \
-  --warehouse-code WH001 \
-  --stock-date 2025-05-15 \
-  --transfer-out-type adjustment \
-  --items '[...]' \
-  --dry-run
-
-# JSON output
-barista liberica transfer-out-forms update 123456789 \
-  --warehouse-code WH001 \
-  --stock-date 2025-05-15 \
-  --transfer-out-type adjustment \
-  --items '[...]' \
-  --json
-```
-
-## 2.9 Request Body Structure
-
-```json
-{
-  "transferOutFormId": 123456789,
-  "warehouseCode": "WH001",
-  "stockDate": "2025-05-15",
-  "transferOutType": "adjustment",
-  "transferOutFormCode": "TO-2025-0001",
-  "follower": "EMP001",
-  "followerName": "Zhang San",
-  "remark": "Updated adjustment",
-  "itemList": [
-    {
-      "transferOutFormItemId": 1000001,
-      "materialCode": "MAT001",
-      "materialName": "Coffee Beans A",
-      "materialUomCode": "kg",
-      "formQuantity": 600,
-      "formMaterialUomCode": "kg",
-      "stockQuantity": 600,
-      "unitPrice": 50,
-      "stockAmount": 30000
-    }
-  ],
-  "lotList": [
-    {
-      "transferOutFormLotId": 2000001,
-      "warehouseCode": "WH001",
-      "materialCode": "MAT001",
-      "materialUomCode": "kg",
-      "lotNo": "LOT202501",
-      "stockQuantity": 600
-    }
-  ]
-}
-```
-
-## 2.10 API Path
-
-```
-POST /api/enterprise/stock/transferOut/edit
-```
-
-**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/uoms/create.md

@@ -1,136 +0,0 @@
-# barista liberica uoms create
-
-创建新的计量单位。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica uoms create` |
-| 功能描述 | 创建新的计量单位 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/sales/
-        └── MasterUomController.java
-            └── createUom(@PostResource(path = "/add"))
-                └── public ResponseData<MasterUomResponse> createUom(
-                        @RequestBody @Validated MasterUomRequest request
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/pojo/request/MasterUomRequest.java
-    ├── uomCode: String (@NotBlank)
-    ├── uomName: String (@NotBlank)
-    ├── uomFractionPlaces: Integer (default: 2)
-    └── remark: String (optional)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/pojo/response/MasterUomResponse.java
-    ├── uomId: String
-    ├── uomCode: String
-    ├── uomName: String
-    ├── uomFractionPlaces: Integer
-    ├── statusFlag: Integer (1=启用)
-    ├── remark: String
-    ├── createTime: String
-    └── updateTime: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica uoms create [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --code | -c | string | ✅ | - | 计量单位编码 | uomCode |
-| --name | -n | string | ✅ | - | 计量单位名称 | uomName |
-| --fraction-places | -f | number | ⬜ | 2 | 小数位数 | uomFractionPlaces |
-| --remark | -r | string | ⬜ | - | 备注 | remark |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| --code / -c | uomCode | string→String | @NotBlank, max=255 |
-| --name / -n | uomName | string→String | @NotBlank, max=255 |
-| --fraction-places / -f | uomFractionPlaces | number→Integer | >= 0, <= 10 |
-| --remark / -r | remark | string→String | max=500 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/exception/enums/MasterUomExceptionEnum.java
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| UOM_CODE_DUPLICATE | 计量单位编码重复 | 编码重复 |
-| UOM_CODE_EMPTY | 计量单位编码不能为空 | 编码为空 |
-| UOM_NAME_EMPTY | 计量单位名称不能为空 | 名称为空 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | MasterUomController.java | 需要 `master_uom:add` 权限 |
-
-## 2.7 实现要点
-
-1. **必填参数**：uomCode 和 uomName 为必填参数
-2. **默认值**：fraction-places 默认为 2
-3. **dry-run 支持**：支持 `--dry-run` 预览模式，显示将要创建的UOM信息
-4. **编码唯一性**：后端会校验 uomCode 是否已存在
-5. **状态默认**：新创建UOM默认状态为启用（statusFlag=1）
-6. **API路径**：POST `/api/enterprise/sales/uom/add`
-7. **成功响应**：返回创建的UOM详情，包括生成的 uomId
-
-## 2.8 示例用法
-
-```bash
-# 创建基本计量单位
-barista liberica uoms create --code "kg" --name "千克"
-barista liberica uoms create -c "kg" -n "千克"
-
-# 创建并指定小数位数
-barista liberica uoms create --code "m" --name "米" --fraction-places 3
-barista liberica uoms create -c "m" -n "米" -f 3
-
-# 创建并添加备注
-barista liberica uoms create --code "pcs" --name "件" --remark "计量件数"
-barista liberica uoms create -c "pcs" -n "件" -r "计量件数"
-
-# 预览模式（dry-run）
-barista liberica uoms create --code "box" --name "箱" --dry-run
-
-# JSON 输出
-barista liberica uoms create --code "kg" --name "千克" --json
-```