@newpeak/barista-cli 0.1.10 → 0.1.12

package/docs/commands/liberica/materials/update.md

@@ -1,250 +0,0 @@
-# barista liberica materials update
-
-更新物料信息。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica materials update <materialId>` |
-| 功能描述 | 更新物料信息 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/master/
-        └── EnterpriseMaterialController.java
-            └── edit(@PostResource(path = "/edit", requiredPermission = true, requirePermissionCode = "EDIT_MASTER_MATERIAL"))
-                └── public ResponseData<?> edit(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.edit.class) MasterMaterialRequest masterMaterialRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-sales/sales-api/
-    └── src/main/java/com/newpeak/liberica/sales/api/pojo/request/
-        └── MasterMaterialRequest.java
-            ├── materialId: Long (@NotNull on edit) — 必须提供
-            ├── materialCode: String
-            ├── materialNo: String
-            ├── materialName: String
-            ├── materialShortName: String
-            ├── materialMaker: String
-            ├── materialClass: String
-            ├── materialType: String
-            ├── materialUomCode: String
-            ├── materialBarCode: String
-            ├── enableSale: String (Y/N)
-            ├── enablePurchase: String (Y/N)
-            ├── enableSubMaterial: String (Y/N)
-            ├── enableOutsourcing: String (Y/N)
-            ├── enableDivision: String (Y/N)
-            ├── productionPeriod: Integer
-            ├── unitPrice: BigDecimal
-            ├── currency: String
-            ├── defaultWarehouse: String
-            ├── defaultSupplier: String
-            ├── defaultClient: String
-            ├── safetyInventory: BigDecimal
-            ├── longX: BigDecimal
-            ├── wideY: BigDecimal
-            ├── highZ: BigDecimal
-            ├── thickness: BigDecimal
-            ├── grossWeight: String
-            ├── netWeight: String
-            ├── color: String
-            └── remark: String
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-sales/sales-api/
-    └── src/main/java/com/newpeak/liberica/sales/api/pojo/response/
-        └── MasterMaterialResponse.java
-            ├── materialId: Long
-            ├── materialCode: String
-            ├── materialNo: String
-            ├── materialName: String
-            ├── materialShortName: String
-            ├── materialClass: String
-            ├── materialType: String
-            ├── materialUomCode: String
-            ├── statusFlag: Integer (1=enable, 2=disable)
-            ├── createTime: String
-            └── updateTime: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica materials update <materialId> [options]
-```
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| materialId | string | ✅ | 物料ID (materialId) |
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --name | -n | string | ⬜ | - | 物料名称 | materialName |
-| --class | -c | string | ⬜ | - | 物料类别 | materialClass |
-| --type | -t | string | ⬜ | - | 规格型号 | materialType |
-| --unit | -u | string | ⬜ | - | 计量单位 | materialUomCode |
-| --short-name | — | string | ⬜ | - | 物料简称 | materialShortName |
-| --maker | — | string | ⬜ | - | 生产厂商 | materialMaker |
-| --barcode | — | string | ⬜ | - | 条形码 | materialBarCode |
-| --enable-sale | — | boolean | ⬜ | - | 可销售 | enableSale |
-| --enable-purchase | — | boolean | ⬜ | - | 可采购 | enablePurchase |
-| --enable-sub-material | — | boolean | ⬜ | - | 可为子件 | enableSubMaterial |
-| --enable-outsourcing | — | boolean | ⬜ | - | 可委外 | enableOutsourcing |
-| --enable-division | — | boolean | ⬜ | - | 可切割 | enableDivision |
-| --production-period | — | number | ⬜ | - | 生产周期(天) | productionPeriod |
-| --unit-price | — | number | ⬜ | - | 单价 | unitPrice |
-| --currency | — | string | ⬜ | - | 币种 | currency |
-| --default-warehouse | — | string | ⬜ | - | 默认仓库 | defaultWarehouse |
-| --default-supplier | — | string | ⬜ | - | 默认供应商 | defaultSupplier |
-| --default-client | — | string | ⬜ | - | 默认客户 | defaultClient |
-| --safety-inventory | — | number | ⬜ | - | 安全库存 | safetyInventory |
-| --long-x | — | number | ⬜ | - | 长 | longX |
-| --wide-y | — | number | ⬜ | - | 宽 | wideY |
-| --high-z | — | number | ⬜ | - | 高 | highZ |
-| --thickness | — | number | ⬜ | - | 厚度 | thickness |
-| --gross-weight | — | string | ⬜ | - | 毛重 | grossWeight |
-| --net-weight | — | string | ⬜ | - | 净重 | netWeight |
-| --color | — | string | ⬜ | - | 颜色 | color |
-| --remark | -r | string | ⬜ | - | 备注 | remark |
-
-**注意**：物料ID(materialId)为必填，通过位置参数 `<materialId>` 传入。后端处理部分更新，未提供的字段保持原值。
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| <materialId> (位置参数) | materialId | string→Long | @NotNull |
-| --name / -n | materialName | 直接传递 | max=255 |
-| --class / -c | materialClass | 直接传递 | max=255 |
-| --type / -t | materialType | 直接传递 | max=255 |
-| --unit / -u | materialUomCode | 直接传递 | max=255 |
-| --short-name | materialShortName | 直接传递 | max=255 |
-| --maker | materialMaker | 直接传递 | max=255 |
-| --barcode | materialBarCode | 直接传递 | max=255 |
-| --enable-sale | enableSale | boolean→String | Y 或 N |
-| --enable-purchase | enablePurchase | boolean→String | Y 或 N |
-| --enable-sub-material | enableSubMaterial | boolean→String | Y 或 N |
-| --enable-outsourcing | enableOutsourcing | boolean→String | Y 或 N |
-| --enable-division | enableDivision | boolean→String | Y 或 N |
-| --production-period | productionPeriod | number→Integer | - |
-| --unit-price | unitPrice | number→BigDecimal | - |
-| --currency | currency | 直接传递 | max=255 |
-| --default-warehouse | defaultWarehouse | 直接传递 | max=255 |
-| --default-supplier | defaultSupplier | 直接传递 | max=255 |
-| --default-client | defaultClient | 直接传递 | max=255 |
-| --safety-inventory | safetyInventory | number→BigDecimal | - |
-| --long-x | longX | number→BigDecimal | - |
-| --wide-y | wideY | number→BigDecimal | - |
-| --high-z | highZ | number→BigDecimal | - |
-| --thickness | thickness | number→BigDecimal | - |
-| --gross-weight | grossWeight | 直接传递 | max=255 |
-| --net-weight | netWeight | 直接传递 | max=255 |
-| --color | color | 直接传递 | max=255 |
-| --remark / -r | remark | 直接传递 | max=255 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-sales/sales-api/
-    └── src/main/java/com/newpeak/liberica/sales/api/exception/enums/
-        └── MasterMaterialExceptionEnum.java
-            ├── MASTER_MATERIAL_NOT_EXIST("01001512001", "租户物料不存在")
-            ├── MASTER_MATERIAL_CODE_VALIDATE_NOT_EXIST_ERROR("01001512006", "指定{}不存在")
-            ├── MASTER_MATERIAL_NAME_VALIDATE_NOT_EXIST_ERROR("01001512010", "指定{}不存在")
-            ├── ENABLE_DIVISION_MATERIAL_NEED_WIDE_AND_LONG("01001512012", "可分割物料必须设置长和宽")
-            └── ENABLE_DIVISION_MATERIAL_NEED_WIDE_AND_LONG_GT_ZERO("01001512013", "可分割物料长和宽必须大于0")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001512001 | 租户物料不存在 | materialId 不存在或不属于当前租户 |
-| 01001512006 | 指定xxx不存在 | 指定关联的物料编码不存在 |
-| 01001512012 | 可分割物料必须设置长和宽 | 设置enableDivision=Y但未提供长宽 |
-| 01001512013 | 可分割物料长和宽必须大于0 | 设置enableDivision=Y且长宽<=0 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `MasterMaterialPermissionConstants.EDIT_MASTER_MATERIAL` | Controller层 `@PostResource(requirePermissionCode = "EDIT_MASTER_MATERIAL")` |
-
-## 2.7 实现要点
-
-1. **materialId位置参数**：`<materialId>` 通过位置参数传入，映射到 `materialId` 字段
-2. **请求体结构**：必须将 `materialId` 包含在请求体中，后端通过此ID定位记录
-3. **部分更新**：只发送需要更新的字段，未提供的字段保持原值
-4. **Dry-run支持**：使用 --dry-run 时构造请求体但不发送，显示预览信息
-5. **后端验证**：edit() 方法调用 `masterMaterialBusiness.edit()`，后端会校验物料是否存在
-
-## 2.8 示例用法
-
-```bash
-# 更新物料名称
-barista liberica materials update 12345 --name "新产品名称"
-
-# 更新物料类别和规格
-barista liberica materials update 12345 \
-  --class "原材料" \
-  --type "ABC-001" \
-  --unit "KG"
-
-# 更新价格信息
-barista liberica materials update 12345 \
-  --unit-price 100.50 \
-  --currency "CNY"
-
-# 启用可销售属性
-barista liberica materials update 12345 --enable-sale true
-
-# 同时更新多个字段
-barista liberica materials update 12345 \
-  --name "新产品" \
-  --class "成品" \
-  --type "XYZ-999" \
-  --unit "PCS" \
-  --unit-price 299.99 \
-  --enable-sale true \
-  --enable-purchase true \
-  --remark "更新备注信息"
-
-# Dry-run 预览
-barista liberica materials update 12345 --name "新产品" --dry-run
-
-# JSON 输出
-barista liberica materials update 12345 --name "新产品" --json
-
-# 物料不存在
-barista liberica materials update 99999 --name "测试"
-# 输出: Error: 租户物料不存在 (01001512001)
-```

package/docs/commands/liberica/orgs/list.md

@@ -1,62 +0,0 @@
-# Orgs Command Design
-
-## Command Structure
-
-```
-barista liberica orgs <subcommand>
-```
-
-## Subcommands
-
-### list
-
-List all organizations (departments) in the system.
-
-**Usage:**
-```bash
-barista liberica orgs list [options]
-```
-
-**Options:**
-- `--json` - Output as JSON format
-
-**Examples:**
-```bash
-# List all organizations
-barista liberica orgs list
-
-# Output as JSON
-barista liberica orgs list --json
-```
-
-**API Endpoint:**
-- `GET /api/enterprise/master/org/all`
-
-**Implementation:**
-```typescript
-// src/commands/liberica/orgs/index.ts
-// src/core/api/client.ts - listOrganizations()
-```
-
-## Output Format
-
-| Field | Description |
-|-------|-------------|
-| id | Organization ID |
-| name | Organization name |
-
-## Known Organizations (Shanghai Tenant)
-
-| ID | Name |
-|----|------|
-| 2006228218445156353 | 人事部 |
-| 1890201570712793090 | 销售部 |
-| 1890201570712793091 | 生产部 |
-| 1890201570712793092 | 采购部 |
-| 1890201570712793093 | 财务部 |
-
-## Notes
-
-- Organizations are company departments
-- Used as reference for user management
-- The `userOrgList.orgId` in user creation maps to these organization IDs

package/docs/commands/liberica/positions/list.md

@@ -1,61 +0,0 @@
-# Positions Command Design
-
-## Command Structure
-
-```
-barista liberica positions <subcommand>
-```
-
-## Subcommands
-
-### list
-
-List all positions in the system.
-
-**Usage:**
-```bash
-barista liberica positions list [options]
-```
-
-**Options:**
-- `--json` - Output as JSON format
-
-**Examples:**
-```bash
-# List all positions
-barista liberica positions list
-
-# Output as JSON
-barista liberica positions list --json
-```
-
-**API Endpoint:**
-- `GET /api/enterprise/master/position/all`
-
-**Implementation:**
-```typescript
-// src/commands/liberica/positions/index.ts
-// src/core/api/client.ts - listPositions()
-```
-
-## Output Format
-
-| Field | Description |
-|-------|-------------|
-| id | Position ID |
-| name | Position name |
-
-## Known Positions (Shanghai Tenant)
-
-| ID | Name |
-|----|------|
-| 2039948606182752257 | 总经理 |
-| 2039948606186946562 | 部门经理 |
-| 2039948606191140865 | 组长 |
-
-## Notes
-
-- Positions represent job titles within the organization
-- The default system position ID is `1671418731163627522`
-- Used as reference for user management
-- The `userOrgList.positionId` in user creation maps to these position IDs

package/docs/commands/liberica/roles/list.md

@@ -1,67 +0,0 @@
-# Roles Command Design
-
-## Command Structure
-
-```
-barista liberica roles <subcommand>
-```
-
-## Subcommands
-
-### list
-
-List all available roles in the system.
-
-**Usage:**
-```bash
-barista liberica roles list [options]
-```
-
-**Options:**
-- `--json` - Output as JSON format
-
-**Examples:**
-```bash
-# List all roles
-barista liberica roles list
-
-# Output as JSON
-barista liberica roles list --json
-```
-
-**API Endpoint:**
-- `GET /api/enterprise/sysRole/list`
-
-**Implementation:**
-```typescript
-// src/commands/liberica/roles/index.ts
-// src/core/api/client.ts - listRoles()
-```
-
-## Output Format
-
-| Field | Description |
-|-------|-------------|
-| ID | Role ID (e.g., 9000, 9001) |
-| Role Code | System code (e.g., tenantAdmin, tenantEmployee) |
-| Role Name | Display name (e.g., 租户管理员, 租户人员) |
-| Status | Enabled or Disabled |
-
-## Known Roles (Shanghai Tenant)
-
-| ID | Code | Name |
-|----|------|------|
-| 9000 | tenantAdmin | 租户管理员 |
-| 9001 | tenantEmployee | 租户人员 |
-| 9100 | tenantKpiParticipant | 租户人事考核参与人 |
-| 9101 | tenantHr | 租户人事 |
-| 9102 | tenantDeptManager | 租户部门负责人 |
-| 9103 | tenantKpiEvaluator | 租户人事考核评价人 |
-| 9104 | tenantCeo | 租户首席执行官 |
-| 9105 | tenantSales | 租户销售 |
-| 9106 | tenantPurchase | 租户采购 |
-
-## Notes
-
-- Roles are used when creating users with `barista liberica users create -r <role-id>`
-- Multiple roles can be specified as comma-separated IDs: `-r 9001,9105`

package/docs/commands/liberica/stock/ledger.md

@@ -1,209 +0,0 @@
-# 命令名称: barista liberica stock ledger
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica stock ledger` |
-| 功能描述 | 查询出入库台账（分页列表+汇总） |
-| HTTP方法 | GET |
-| 是否需要认证 | 是 |
-| 是否支持dry-run | 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/master/
-        └── MasterStockController.java
-            ├── commonStockJourneyPage(@GetResource(path = "/journey/page"))
-            │   └── public ResponseData<PageResult<StockJourneyResponse>> commonStockJourneyPage(
-            │           @RequestHeader("X-TENANT-ID") Long tenantId,
-            │           @ParameterObject StockJourneyQueryRequest stockJourneyQueryRequest
-            │       )
-            └── commonStockJourneyPageSummary(@GetResource(path = "/journey/page/summary"))
-                └── public ResponseData<StockJourneySummaryResponse> commonStockJourneyPageSummary(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @ParameterObject StockJourneyQueryRequest stockJourneyQueryRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
-        └── StockJourneyQueryRequest.java
-            ├── stockId: Long
-            ├── stockFormCode: String
-            ├── stockType: String
-            ├── stockFlag: String
-            ├── warehouseCode: String
-            ├── materialCode: String
-            ├── materialName: String
-            ├── materialType: String
-            ├── color: String
-            ├── lotNo: String
-            ├── lotCode: String
-            ├── sourceType: String
-            ├── sourceCode: String
-            ├── stockDate: Date
-            ├── stockDateCriteria: DateRange
-            └── postingMonth: Date
-```
-
-### Response DTO位置
-
-**列表项 DTO：**
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
-        └── StockJourneyResponse.java
-            ├── stockId: Long
-            ├── stockFormCode: String
-            ├── stockType: String
-            ├── stockFlag: String
-            ├── warehouseCode: String
-            ├── materialCode: String
-            ├── materialNo: String
-            ├── materialName: String
-            ├── materialType: String
-            ├── color: String
-            ├── longX: BigDecimal
-            ├── wideY: BigDecimal
-            ├── highZ: BigDecimal
-            ├── sourceCode: String
-            ├── sourceType: String
-            ├── lotCode: String
-            ├── lotNo: String
-            ├── supplierLotNo: String
-            ├── inboundCount: BigDecimal
-            ├── outboundCount: BigDecimal
-            ├── materialUomCode: String
-            ├── unitPrice: BigDecimal
-            ├── localCurrency: String
-            ├── inboundAmount: BigDecimal
-            ├── outboundAmount: BigDecimal
-            ├── inboundDate: Date
-            ├── stockDate: Date
-            ├── outboundDate: Date
-            ├── postingMonth: Date
-            └── remark: String
-```
-
-**汇总 DTO：**
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
-        └── StockJourneySummaryResponse.java
-            ├── totalInboundCount: BigDecimal
-            ├── totalOutboundCount: BigDecimal
-            ├── totalInboundAmount: BigDecimal
-            └── totalOutboundAmount: BigDecimal
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```bash
-barista liberica stock ledger [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev/test/prod-cn/prod-jp) |
-| `--tenant` | string | 租户代码（仅Liberica） |
-| `--dry-run` | boolean | 预览模式 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| `--stock-id` |  | string | 否 | - | 出入库ID | stockId |
-| `--stock-form-code` |  | string | 否 | - | 出入库单编码 | stockFormCode |
-| `--stock-type` |  | string | 否 | - | 出入库单类型 | stockType |
-| `--stock-flag` |  | string | 否 | - | 出入库标志(inbound/outbound) | stockFlag |
-| `--warehouse-code` | -w | string | 否 | - | 仓库编码 | warehouseCode |
-| `--material-code` | -m | string | 否 | - | 物料编码 | materialCode |
-| `--material-name` |  | string | 否 | - | 物料名称（支持模糊查询） | materialName |
-| `--material-type` | -t | string | 否 | - | 物料规格 | materialType |
-| `--color` | -c | string | 否 | - | 颜色 | color |
-| `--lot-no` | -l | string | 否 | - | 批次号 | lotNo |
-| `--lot-code` |  | string | 否 | - | 系统批次号 | lotCode |
-| `--source-type` |  | string | 否 | - | 源单类型 | sourceType |
-| `--source-code` |  | string | 否 | - | 源单编码 | sourceCode |
-| `--start-date` |  | string | 否 | - | 出入库开始日期(YYYY-MM-DD) | stockDateCriteria.startDate |
-| `--end-date` |  | string | 否 | - | 出入库结束日期(YYYY-MM-DD) | stockDateCriteria.endDate |
-| `--posting-month` |  | string | 否 | - | 记账年月(YYYY-MM) | postingMonth |
-| `--summary` |  | boolean | 否 | false | 仅显示汇总数据 | 控制输出模式 |
-| `--page` | -p | number | 否 | 1 | 页码 | pageNo |
-| `--size` | -s | number | 否 | 20 | 每页条数 | pageSize |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| --stock-id | stockId | string→Long | 后端BigInteger，CLI使用string |
-| --stock-form-code | stockFormCode | 直接传递 | - |
-| --stock-type | stockType | 直接传递 | enum: STOCK_TYPE |
-| --stock-flag | stockFlag | 直接传递 | enum: STOCK_FLAG |
-| --warehouse-code | warehouseCode | 直接传递 | - |
-| --material-code | materialCode | 直接传递 | - |
-| --material-name | materialName | 直接传递 | - |
-| --material-type | materialType | 直接传递 | - |
-| --color | color | 直接传递 | - |
-| --lot-no | lotNo | 直接传递 | - |
-| --lot-code | lotCode | 直接传递 | - |
-| --source-type | sourceType | 直接传递 | enum: source_type |
-| --source-code | sourceCode | 直接传递 | - |
-| --start-date | stockDateCriteria.startDate | string→Date | yyyy-MM-dd |
-| --end-date | stockDateCriteria.endDate | string→Date | yyyy-MM-dd |
-| --posting-month | postingMonth | string→Date | yyyy-MM |
-| --page | pageNo | number-1 | 0-based分页 |
-| --size | pageSize | number | >0 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-stock/stock-api/
-    └── src/main/java/com/newpeak/liberica/stock/api/exception/enums/
-        ├── StockJourneyExceptionEnum.java
-        │   ├── STOCK_JOURNEY_NOT_EXIST("...001", "租户出入库台账不存在")
-        │   └── CAN_NOT_DELETE_MATERIAL_WITH_USED_IN_STOCK("...002", "物料已在库存中使用，不能删除")
-        ├── MasterStockExceptionEnum.java
-        │   ├── MASTER_STOCK_NOT_EXIST("...001", "租户库存不存在")
-        │   └── MASTER_STOCK_OUT_LOT_NOT_ENOUGH("...002", "租户成品出库单{}余量不够")
-        └── MasterWarehouseStockExceptionEnum.java
-            └── MASTER_WAREHOUSE_STOCK_NOT_EXIST("...001", "租户仓库库存不存在")
-```
-
-### 已知错误码示例
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| ...001 | 租户出入库台账不存在 | 查询的台账记录不存在 |
-| ...001 | 租户库存不存在 | 查询的库存记录不存在 |
-| ...002 | 租户成品出库单{}余量不够 | 出库操作余量不足 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 菜单权限 | `MasterStockController` 类上的 `@Menu` 注解 | `stock_journey` 菜单，要求 `tenantStock` 角色 |
-| 接口访问 | Controller方法无单独 `@GetResource(requiredPermission = true)` | 通过菜单角色控制 |
-
-## 2.7 实现要点
-
-1. **双接口调用**：默认模式同时调用 `/journey/page/summary` 和 `/journey/page`，先显示汇总再显示列表
-2. **Summary模式**：当传入 `--summary` 时，仅调用 `/journey/page/summary`，不请求列表数据
-3. **分页转换**：CLI page 1 对应 API pageNo 0
-4. **ID类型**：stockId 后端为 Long/BigInteger，CLI 统一使用 string 类型避免精度丢失
-5. **日期格式**：--posting-month 使用 yyyy-MM 格式，转换为 Date 类型
-6. **stockFlag映射**：inbound 对应入库记录，outbound 对应出库记录；后端 StockJourneyResponse 根据 inboundCount 是否为空自动推断 stockFlag
-7. **输出格式**：默认表格输出，--json 返回结构化 JSON；汇总数据和列表数据在 JSON 中分层返回