npm - @qinsilk/scm-agent-tools - Versions diffs - 0.1.0 → 0.2.0 - Mend

@qinsilk/scm-agent-tools 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/README.md +1 -1
package/cli/commands/data.js +112 -0
package/cli/commands/docs.js +121 -0
package/cli/commands/query.js +58 -2
package/cli/datasets.js +541 -0
package/cli/scm-agent.js +6 -1
package/docs/api.md +2067 -0
package/docs/cli.md +72 -0
package/package.json +2 -2
package/skills/qinsilk-scm/SKILL.md +32 -1

package/docs/api.md ADDED Viewed

@@ -0,0 +1,2067 @@
+# scm-agent 接口返回字段说明
+本文档回答一个问题：**命令加 `--json` 之后，返回的每个字段是什么意思、取什么值、单位与精度是什么、为空代表什么。**
+什么时候需要它：官方报表之外，用户希望自己设计报表或统计口径时。只靠字段名猜含义容易算错，
+尤其是下面三类字段——取值是数字代码（需要查表才知道 1 和 2 各代表什么）、
+单位不同（采购单位与基础单位、件与公斤）、
+为空（可能是权限看不到，也可能是本来就没有数据）。
+命令怎么用、参数怎么传，看 [cli.md](cli.md)；本文件只讲字段。
+本文档由开发仓库的生成脚本从 is-scm-server 的 agent DTO 源码生成
+（字段含义取自源码里的 `@ApiModelProperty`），随包发布，请不要手工编辑。
+## 通用约定
+**返回外壳**：所有接口返回 `{ status, message, data }`。`status` 为 200 表示成功，`data` 才是业务数据；
+其余状态码见 [cli.md](cli.md) 的「错误码」一节。
+**分页结构**：列表类接口的 `data` 是 `{ page, limit, total, list }`，
+`total` 是符合条件的总条数，`list` 是本页的行。单页最多 100 条。
+**不适用分页的接口**：`log db-change` 用游标续查（`hasMore`、`lineNum`、`scrollId`），
+`log api` 与 `permission list` 一次返回数组。
+**日期与时间**：字段说明里写了格式的都按该格式原样理解。只到日的字段是 `yyyy-MM-dd` 字符串，
+别人的报表按字符串比较日期即可；`Timestamp` 类型（版单、IE 核价的日期字段）由 Node 序列化成 ISO 字符串，
+如 `2026-10-24T00:00:00.000Z`。
+**金额与数量**：`BigDecimal` 类型在 JSON 里是数字。金额精度要看企业配置的物料小数位
+（官方报表读取 company-config 的 materialDecimal），自己做报表时如果要与网页显示一致，
+不要默认只有两位小数。
+**空值的三种含义**，看到 `null` 或缺失时先分清是哪一种，不要一律当成 0：
+1. **没有权限看不到**：字段说明里写明「无某某权限时为空」的字段。
+   含义是当前 AI Key 对应的用户没有这项数据权限，不是数据本身为空。
+2. **该接口不返回**：字段说明里写明「仅详情接口返回」的字段，在列表接口里恒为 `null`。
+3. **业务上确实没有数据**：未填写、未发生。这种情况才可以在统计里当 0 处理，但要在报表里说明。
+**同名不同义**：同一个 JSON 里不同层级会出现同名字段（例如生产单详情顶层的 `state` 与
+工序行里的 `state`）。读字段时一定要带上层级，不要只按字段名判断。
+## 商品列表与详情（goods search / goods detail）
+- 命令：`scm-agent goods search --name A123 --json ｜ scm-agent goods detail --id 12345 --json`
+- 接口：`GET /api/agent/v1/goods/search ｜ GET /api/agent/v1/goods/detail`
+> search 返回分页结构，每行是本节的字段；detail 返回单个对象，其中 skus（颜色尺码单品）与 workProcesses（工序模板）只有 detail 才填充，search 中为空。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 商品id |
+| `goodsSn` | String | 否 | 款号 |
+| `designSn` | String | 否 | 设计款号 |
+| `name` | String | 否 | 名称 |
+| `isOnSale` | Integer | 否 | 是否上架：1是 0否 |
+| `reviewState` | Integer | 否 | 评审状态：0待评审 1通过 2未通过 |
+| `makeSampleState` | Integer | 否 | 打样状态：0无 1已纸样 2已打样 3封样 |
+| `tagPrice` | BigDecimal | 否 | 吊牌价 |
+| `costPrice` | BigDecimal | 否 | 成本价 |
+| `devTime` | String | 否 | 开发时间（yyyy-MM-dd） |
+| `produceOrderNumber` | Integer | 否 | 生产单数 |
+| `storedNumber` | Integer | 否 | 库存数 |
+| `availableNumber` | Integer | 否 | 可用库存 |
+| `produceNumber` | BigDecimal | 否 | 生产中数量 |
+| `brandName` | String | 否 | 品牌 |
+| `goodsImgUrl` | String | 否 | 主图 |
+| `skus` | List<SkuRow> | 否 | 颜色尺码单品（详情接口） |
+| `workProcesses` | List<ProcessRow> | 否 | 工序模板（详情接口） |
+**skus[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `skus[].colorName` | String | 否 | 颜色 |
+| `skus[].sizeName` | String | 否 | 尺码 |
+| `skus[].skuCode` | String | 否 | 单品编码 |
+| `skus[].barCode` | String | 否 | 条码 |
+| `skus[].tagPrice` | BigDecimal | 否 | 吊牌价 |
+| `skus[].storedNumber` | Integer | 否 | 库存 |
+| `skus[].availableNumber` | Integer | 否 | 可用库存 |
+**workProcesses[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `workProcesses[].workProcessName` | String | 否 | 工序名称 |
+| `workProcesses[].core` | Integer | 否 | 是否关键工序：1无 2裁床 3生产完成 4车间生产 5尾部 6纸样 |
+| `workProcesses[].factoryName` | String | 否 | 加工厂 |
+## 物料列表与详情（material search / material detail）
+- 命令：`scm-agent material search --name 华达呢 --json ｜ scm-agent material detail --id 12345 --json`
+- 接口：`GET /api/agent/v1/material/search ｜ GET /api/agent/v1/material/detail`
+> detail 才填充 skus（物料单品）；type 与 state 是两个不同的枚举，注意区分（见字段说明）。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 物料id |
+| `sn` | String | 否 | 物料货号 |
+| `name` | String | 否 | 物料名称 |
+| `type` | Integer | 否 | 类型：1面料 0辅料 |
+| `state` | Integer | 否 | 启用状态：1启用 2关闭 |
+| `price` | BigDecimal | 否 | 价格 |
+| `defaultSupplierName` | String | 否 | 默认供应商 |
+| `unitName` | String | 否 | 单位 |
+| `categoryName` | String | 否 | 分类 |
+| `stockNumber` | BigDecimal | 否 | 库存量 |
+| `sumAvailableNumber` | BigDecimal | 否 | 可用库存 |
+| `totalStoredNumber` | BigDecimal | 否 | 总库存（详情接口） |
+| `composition` | String | 否 | 成分 |
+| `gramWeight` | BigDecimal | 否 | 克重 |
+| `skus` | List<SkuRow> | 否 | 物料单品（详情接口） |
+**skus[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `skus[].colorName` | String | 否 | 颜色 |
+| `skus[].spec` | String | 否 | 规格（属性名=属性值，逗号分隔） |
+| `skus[].price` | BigDecimal | 否 | 价格 |
+| `skus[].storedNumber` | BigDecimal | 否 | 库存 |
+## 生产单列表与详情（produce list / produce detail）
+- 命令：`scm-agent produce list --sn A123 --json ｜ scm-agent produce detail --sn SC202610240001 --json`
+- 接口：`GET /api/agent/v1/produce/list ｜ GET /api/agent/v1/produce/detail`
+> 列表与详情返回同一组基础字段；orderGoods、materialList、bomList 只有 detail 填充，列表里为 null。workProcesses 两边都有，列表里也有，供工序看板类报表按工序分列使用。注意本结构在不同层级有同名不同义字段：顶层 state 是生产单状态，workProcesses[].state 是工序状态；orderGoods[].number 是生产数量，bomList[].number 是单件用量。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `ordersSn` | String | 否 | 生产单号 |
+| `produceBatchSn` | String | 否 | 生产批次号（未分批时为空） |
+| `goodsSn` | String | 否 | 款号 |
+| `goodsName` | String | 否 | 商品名称 |
+| `goodsImgUrl` | String | 否 | 款式图 URL（无图片时为空） |
+| `state` | Integer | 否 | 状态值：1草稿 2生产中 3生产完成 4待生产 9已撤销 |
+| `stateName` | String | 否 | 状态名称 |
+| `type` | Integer | 否 | 生产类型：1自主生产 2单工序外发 3委外加工 4成品采购 |
+| `sumNumber` | Integer | 否 | 总下单数量 |
+| `sumInNumber` | Integer | 否 | 已入库数量 |
+| `businessTime` | String | 否 | 业务日期（yyyy-MM-dd） |
+| `deliveryTime` | String | 否 | 计划交货日期（yyyy-MM-dd） |
+| `isUrgent` | Integer | 否 | 是否加急：0否 1是 |
+| `produceProgress` | BigDecimal | 否 | 生产进度百分比 |
+| `latestProcessName` | String | 否 | 最新节点名称 |
+| `latestProcessProgress` | BigDecimal | 否 | 最新节点进度百分比 |
+| `cutBedState` | Integer | 否 | 裁床状态：1不含裁床 2待裁床 3裁床中 4已完成 |
+| `sumCutBedNumber` | BigDecimal | 否 | 总裁床数量 |
+| `materialPurchaseState` | Integer | 否 | 物料采购进度：1库存充足 2未采购 3待入库 4部分入库 5采购完成 |
+| `issueNotCompleteNumber` | Long | 否 | 未齐料数（物料未发齐的数量，未计算发料数据时为空） |
+| `supplierName` | String | 否 | 加工厂（无查看权限时为空） |
+| `clientName` | String | 否 | 客户名称 |
+| `orderGoods` | List<GoodsRow> | 否 | 颜色尺码明细（详情接口） |
+| `materialList` | List<MaterialRow> | 否 | 生产单物料行（仅详情接口返回，列表为 null；漏料检测日报、物料在途状态报表使用） |
+| `bomList` | List<BomRow> | 否 | 生产单商品物料 BOM 映射行（仅详情接口返回，列表为 null；漏料检测日报、物料在途状态报表使用） |
+| `workProcesses` | List<WorkProcessRow> | 否 | 工序进度（列表与详情接口均返回；列表返回供工序看板类报表分列使用） |
+**orderGoods[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `orderGoods[].goodsSn` | String | 否 | 款号 |
+| `orderGoods[].goodsSkuId` | Long | 否 | 商品单品id（BOM 映射按物料单品与商品单品关联） |
+| `orderGoods[].colorName` | String | 否 | 颜色 |
+| `orderGoods[].sizeName` | String | 否 | 尺码 |
+| `orderGoods[].number` | Integer | 否 | 生产数量 |
+| `orderGoods[].cutBedNumber` | BigDecimal | 否 | 裁床数量 |
+| `orderGoods[].storeInNumber` | Integer | 否 | 已入库数量 |
+**workProcesses[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `workProcesses[].workProcessName` | String | 否 | 工序名称 |
+| `workProcesses[].showOrder` | Integer | 否 | 显示顺序（同生产单内工序的先后次序） |
+| `workProcesses[].core` | Integer | 否 | 关键工序标识：1无 2裁床 3生产完成 4车间生产 5尾部 6纸样 |
+| `workProcesses[].state` | Integer | 否 | 工序状态：1未完成 2完成 |
+| `workProcesses[].actualState` | Integer | 否 | 工序实际状态：3进行中 |
+| `workProcesses[].progress` | BigDecimal | 否 | 进度百分比 |
+| `workProcesses[].produceNumber` | Integer | 否 | 目标生产数量 |
+| `workProcesses[].reportNumber` | BigDecimal | 否 | 已汇报数量 |
+| `workProcesses[].estimateFinishTime` | String | 否 | 预计完成时间（yyyy-MM-dd） |
+| `workProcesses[].beginTime` | String | 否 | 实际开始时间（yyyy-MM-dd） |
+| `workProcesses[].factoryName` | String | 否 | 加工厂 |
+**materialList[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `materialList[].materialId` | Long | 否 | 物料id |
+| `materialList[].materialSkuId` | Long | 否 | 物料单品id |
+| `materialList[].materialType` | Integer | 否 | 物料类型：0-辅料 1-面料 |
+| `materialList[].materialTypeId` | Long | 否 | 物料类型id |
+| `materialList[].materialTypeName` | String | 否 | 物料类型名 |
+| `materialList[].name` | String | 否 | 物料名称 |
+| `materialList[].sn` | String | 否 | 物料货号 |
+| `materialList[].colorName` | String | 否 | 物料颜色 |
+| `materialList[].spec` | String | 否 | 物料规格文本，多个规格用;连接，每个格式为 规格名:规格值 |
+| `materialList[].number` | BigDecimal | 否 | 数量 |
+| `materialList[].price` | BigDecimal | 否 | 单价 |
+| `materialList[].amount` | BigDecimal | 否 | 成本 |
+| `materialList[].purchaseNumber` | BigDecimal | 否 | 采购数 |
+| `materialList[].issueInNumber` | BigDecimal | 否 | 发料已入库数 |
+| `materialList[].predictNumber` | BigDecimal | 否 | 预计总用量（裁床数） |
+| `materialList[].isComplete` | Integer | 否 | 是否齐料：0否 1是 |
+| `materialList[].isHideByPurchaseUser` | Boolean | 否 | 根据采购员判断是否隐藏 |
+| `materialList[].purchaseUserNames` | String | 否 | 物料采购员名称，多个用,连接 |
+| `materialList[].supplierProvinceId` | Integer | 否 | 供应商省ID |
+| `materialList[].supplierCityId` | Integer | 否 | 供应商市ID |
+| `materialList[].supplierCountyId` | Integer | 否 | 供应商县ID |
+| `materialList[].supplierAddress` | String | 否 | 供应商详细地址 |
+| `materialList[].materialSkuUnitConvertList` | List<UnitConvertRow> | 否 | 单位换算列表（漏料检测/物料在途报表使用） |
+| `materialList[].issueState` | Integer | 否 | 发料状态：0空 1发料中 2无需发料 3发料结束 |
+| `materialList[].supplierName` | String | 否 | 供应商名称（无供应商资料查看权限时为空） |
+| `materialList[].supplierCellphone` | String | 否 | 供应商电话（无供应商资料查看权限时为空） |
+| `materialList[].fabricType` | Integer | 否 | 面料属性：1针织 2梭织（物料类型未启用面料属性时为-1） |
+| `materialList[].bomSupplierColor` | String | 否 | BOM色号/生产单色号 |
+| `materialList[].materialSkuSupplierColor` | String | 否 | 物料单品供应商色号 |
+| `materialList[].materialFabricWidth` | BigDecimal | 否 | 物料幅宽(cm) |
+| `materialList[].materialGramWeight` | BigDecimal | 否 | 物料克重(g/㎡) |
+| `materialList[].materialQunce` | BigDecimal | 否 | 物料安数 |
+| `materialList[].shrinkRates` | String | 否 | 缩水率（按 BOM 行聚合的文本，多个用，隔开） |
+| `materialList[].materialLossRates` | String | 否 | 损耗率（按 BOM 行聚合的文本，多个用，隔开） |
+| `materialList[].materialComposition` | String | 否 | 物料成分 |
+| `materialList[].materialParts` | String | 否 | 物料部位（按 BOM 行聚合的文本，多个用，隔开） |
+| `materialList[].materialPostProcesses` | String | 否 | 物料后处理（按 BOM 行聚合的文本，多个用，隔开） |
+| `materialList[].materialUnit` | String | 否 | 物料基础单位名 |
+| `materialList[].convertRate` | BigDecimal | 否 | 转换系数 |
+| `materialList[].purchasePrice` | BigDecimal | 否 | 采购单价 |
+| `materialList[].materialImgUrl` | String | 否 | 物料主图 URL |
+| `materialList[].materialSkuImgUrl` | String | 否 | 物料单品首图 URL |
+| `materialList[].predictWeight` | BigDecimal | 否 | 预计重量(kg) |
+| `materialList[].materialNetWeight` | BigDecimal | 否 | 物料净重(kg) |
+| `materialList[].predictPower` | BigDecimal | 否 | 预计匹数 |
+| `materialList[].materialMeterOutput` | BigDecimal | 否 | 物料出米数 |
+| `materialList[].materialAvailableNumber` | BigDecimal | 否 | 物料可用库存 |
+| `materialList[].factoryMaterialAvailableNumber` | BigDecimal | 否 | 加工厂可用库存 |
+| `materialList[].factoryMaterialStoredNumber` | BigDecimal | 否 | 加工厂当前库存 |
+| `materialList[].purchaseWinNumber` | BigDecimal | 否 | 采购待入库数 |
+| `materialList[].issueNumber` | BigDecimal | 否 | 发料数 |
+| `materialList[].issuedPreCutNumber` | BigDecimal | 否 | 发料预裁数 |
+| `materialList[].waitIssueNumber` | BigDecimal | 否 | 待发数 |
+| `materialList[].ableIssueNumber` | BigDecimal | 否 | 可发数 |
+| `materialList[].issueWoutNumber` | BigDecimal | 否 | 发料待出库数 |
+| `materialList[].issueWinNumber` | BigDecimal | 否 | 发料待入库数 |
+| `materialList[].transferNumber` | BigDecimal | 否 | 调拨数 |
+| `materialList[].transferWoutNumber` | BigDecimal | 否 | 调拨待出库数 |
+| `materialList[].transferWinNumber` | BigDecimal | 否 | 调拨待入库数 |
+| `materialList[].pickNumber` | BigDecimal | 否 | 已领料数 |
+| `materialList[].pickedPreCutNumber` | BigDecimal | 否 | 领料预裁数 |
+| `materialList[].pickOutNumber` | BigDecimal | 否 | 领料已出库数 |
+| `materialList[].pickWoutNumber` | BigDecimal | 否 | 领料待出库数 |
+| `materialList[].pickRefundNumber` | BigDecimal | 否 | 已退料数 |
+| `materialList[].pickRefundInNumber` | BigDecimal | 否 | 退料已入库数 |
+| `materialList[].pickRefundWinNumber` | BigDecimal | 否 | 退料待入库数 |
+| `materialList[].practicalNumber` | BigDecimal | 否 | 实用量 |
+| `materialList[].cuttingLoss` | BigDecimal | 否 | 裁床等损耗 |
+| `materialList[].lackPickNumber` | BigDecimal | 否 | 本单缺料数 |
+| `materialList[].surplusPickNumber` | BigDecimal | 否 | 本单余料数 |
+| `materialList[].recoveryNumber` | BigDecimal | 否 | 回料数 |
+| `materialList[].recoveryWoutNumber` | BigDecimal | 否 | 回料待出库数 |
+| `materialList[].recoveryWinNumber` | BigDecimal | 否 | 回料待入库数 |
+| `materialList[].remark` | String | 否 | 备注 |
+| `materialList[].materialCategoryName` | String | 否 | 物料分类名 |
+**materialSkuUnitConvertList[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `materialSkuUnitConvertList[].convertRate` | BigDecimal | 否 | 转换系数 |
+| `materialSkuUnitConvertList[].purchasePrice` | BigDecimal | 否 | 采购价格 |
+| `materialSkuUnitConvertList[].purchaseUnitName` | String | 否 | 采购单位名 |
+**bomList[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `bomList[].materialId` | Long | 否 | 物料id |
+| `bomList[].materialSkuId` | Long | 否 | 物料单品id |
+| `bomList[].goodsSkuId` | Long | 否 | 商品单品id |
+| `bomList[].number` | BigDecimal | 否 | 数量（单件用量） |
+| `bomList[].amount` | BigDecimal | 否 | 总价 |
+| `bomList[].materialLossRate` | BigDecimal | 否 | 损耗率 |
+| `bomList[].shrinkRate` | BigDecimal | 否 | 缩水率 |
+## 物料采购单列表与详情（material-purchase list / material-purchase detail）
+- 命令：`scm-agent material-purchase list --from 2026-10-01 --to 2026-10-24 --json ｜ scm-agent material-purchase detail --sn CG202610240001 --json`
+- 接口：`GET /api/agent/v1/material-purchase/list ｜ GET /api/agent/v1/material-purchase/detail`
+> 顶层数量字段是采购单级汇总，details 是物料明细行。「采购单位」与「基础单位」是两套计量口径，同名字段名不同：purchaseUnitNumber/purchasePrice/purchaseUnitAmount 是采购单位口径，purchaseNumber/currentPrice/totalPrice 是基础单位口径，做金额汇总时不要混用。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `ordersSn` | String | 否 | 采购单号 |
+| `groupOrdersSn` | String | 否 | 组合单号 |
+| `state` | Integer | 否 | 状态值：1草稿 2待入库 3部分入库 4全部入库 9撤销 |
+| `supplierName` | String | 否 | 供应商 |
+| `sumPurchaseNumber` | BigDecimal | 否 | 采购总数量 |
+| `amount` | BigDecimal | 否 | 采购金额 |
+| `businessTime` | String | 否 | 业务日期（yyyy-MM-dd） |
+| `expectTime` | String | 否 | 预计到料时间（yyyy-MM-dd） |
+| `storeInNumber` | BigDecimal | 否 | 已入库数量 |
+| `storeWinNumber` | BigDecimal | 否 | 待入库数量 |
+| `orderDeliveryState` | Integer | 否 | 发货状态：2未发货 3部分发货 4全部发货 |
+| `produceOrderSns` | Set<String> | 否 | 关联生产单号 |
+| `produceRelations` | List<RelationRow> | 否 | 关联生产单行（单号、批次号、商品货号、生产客户名） |
+| `bedNumbers` | List<String> | 否 | 床次号列表 |
+| `tags` | List<String> | 否 | 标签名称列表 |
+| `purchaseUnitNumber` | BigDecimal | 否 | 采购数（采购单位口径） |
+| `purchaseNumber` | BigDecimal | 否 | 预计入库数（基础单位口径） |
+| `deliverNumber` | BigDecimal | 否 | 基础发货数 |
+| `purchaseStoreWinNumber` | BigDecimal | 否 | 采购待入库数 |
+| `purchaseStoreInNumber` | BigDecimal | 否 | 采购已入库数 |
+| `purchaseTerminateInNumber` | BigDecimal | 否 | 采购放弃入库数 |
+| `terminateInNumber` | BigDecimal | 否 | 基础放弃入库数 |
+| `totalWipeZero` | BigDecimal | 否 | 抹零金额 |
+| `payment` | BigDecimal | 否 | 已付金额 |
+| `supplierSn` | String | 否 | 供应商单号 |
+| `purchaseStoreInTimes` | List<String> | 否 | 实际入库时间列表（yyyy-MM-dd HH:mm:ss） |
+| `businessTimeText` | String | 否 | 业务时间（yyyy-MM-dd HH:mm） |
+| `handlerName` | String | 否 | 创建人 |
+| `createTime` | String | 否 | 创建时间（yyyy-MM-dd HH:mm） |
+| `lastHandlerName` | String | 否 | 更新人 |
+| `updateTime` | String | 否 | 更新时间（yyyy-MM-dd HH:mm） |
+| `details` | List<DetailRow> | 否 | 物料明细（详情接口） |
+**details[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `details[].materialSn` | String | 否 | 物料货号 |
+| `details[].materialName` | String | 否 | 物料名称 |
+| `details[].materialImgUrl` | String | 否 | 物料图片 URL |
+| `details[].colorName` | String | 否 | 颜色 |
+| `details[].skuPropertyList` | List<SkuPropertyRow> | 否 | 物料单品规格属性 |
+| `details[].materialSkuSupplierColor` | String | 否 | 物料单品供应商色号 |
+| `details[].fabricWidth` | BigDecimal | 否 | 幅宽（有幅宽时色号才有意义） |
+| `details[].purchaseUnitNumber` | BigDecimal | 否 | 采购数量（采购单位口径） |
+| `details[].purchasePrice` | BigDecimal | 否 | 采购单价（采购单位口径） |
+| `details[].purchaseUnitAmount` | BigDecimal | 否 | 采购金额（采购单位口径） |
+| `details[].purchaseNumber` | BigDecimal | 否 | 采购数量（基础单位口径） |
+| `details[].currentPrice` | BigDecimal | 否 | 单价（基础单位口径） |
+| `details[].totalPrice` | BigDecimal | 否 | 总价（基础单位口径） |
+| `details[].storeInNumber` | BigDecimal | 否 | 已入库数量 |
+| `details[].produceOrdersSn` | String | 否 | 关联生产单号 |
+**produceRelations[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `produceRelations[].produceOrdersSn` | String | 否 | 生产单号 |
+| `produceRelations[].produceBatchSn` | String | 否 | 生产批次号 |
+| `produceRelations[].goodsSn` | String | 否 | 生产商品货号 |
+| `produceRelations[].produceOrderClientName` | String | 否 | 生产客户名称 |
+**skuPropertyList[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `skuPropertyList[].propertyName` | String | 否 | 属性名 |
+| `skuPropertyList[].propertyValue` | String | 否 | 属性值 |
+## 设计款列表（design list）
+- 命令：`scm-agent design list --sn A123 --json`
+- 接口：`GET /api/agent/v1/design/list`
+> designState 是设计款状态；convertGoodsState 是转大货状态（另一套枚举），两者含义不同。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 设计款id |
+| `designSn` | String | 否 | 款号 |
+| `customDesignSn` | String | 否 | 客户款号 |
+| `name` | String | 否 | 名称 |
+| `goodsSn` | String | 否 | 货号（转大货后有值） |
+| `relateGoodsId` | Long | 否 | 转大货后的商品id，未转为 0 或空 |
+| `designState` | Integer | 否 | 设计款状态：2设计中 3待确定 4修改中 5审核通过 6取消 15开发池 16版型资产库 |
+| `convertGoodsState` | Integer | 否 | 转大货状态 |
+| `isSealedSample` | Integer | 否 | 封样状态 |
+| `designBrandName` | String | 否 | 品牌 |
+| `designCategoryName` | String | 否 | 分类 |
+| `designStyleName` | String | 否 | 款式 |
+| `designSeasonName` | String | 否 | 季节 |
+| `designRangesName` | String | 否 | 波段 |
+| `designPlanName` | String | 否 | 企划 |
+| `year` | String | 否 | 年份 |
+| `month` | Integer | 否 | 月份 |
+| `sex` | Integer | 否 | 性别 |
+| `designDesignerName` | String | 否 | 设计师 |
+| `designPatternMakerName` | String | 否 | 打版师 |
+| `designAssistantName` | String | 否 | 设计助理 |
+| `followerName` | String | 否 | 跟单员 |
+| `costPrice` | BigDecimal | 否 | 成本价 |
+| `tagPrice` | BigDecimal | 否 | 吊牌价 |
+| `devTime` | Timestamp | 否 | 开发日期 |
+| `createTime` | Timestamp | 否 | 创建时间 |
+| `updateTime` | Timestamp | 否 | 更新时间 |
+| `designStoredNumber` | Integer | 否 | 库存数 |
+| `designAvailableNumber` | Integer | 否 | 可用库存数 |
+| `designOrderCount` | Integer | 否 | 板单数 |
+| `latestDesignOrderSerialName` | String | 否 | 最新版次名 |
+| `colorNames` | List<String> | 否 | 颜色名称列表 |
+| `sizeNames` | List<String> | 否 | 尺码名称列表 |
+| `imgUrl` | String | 否 | 款式图地址 |
+| `remark` | String | 否 | 备注 |
+## IE 核价（design ie-list）
+- 命令：`scm-agent design ie-list --sn A123 --json`
+- 接口：`GET /api/agent/v1/design/ie-list`
+> 每行是一个「设计款 × 颜色」。materials 是物料行、processFees 是工序费用行、costFees 是特殊工艺费用行、accountItems 是其他费用行，四类分别汇总才是完整核价。供应商类字段与工序单价在没有对应权限时为空，空表示「当前账号看不到」，不是「没有数据」。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 设计款id |
+| `designSn` | String | 否 | 款号 |
+| `name` | String | 否 | 名称 |
+| `goodsSn` | String | 否 | 货号（转大货后有值） |
+| `colorId` | Long | 否 | 本行颜色id |
+| `colorName` | String | 否 | 本行颜色名 |
+| `imgUrl` | String | 否 | 款式图地址 |
+| `designState` | Integer | 否 | 设计款状态：2设计中 3待确定 4修改中 5审核通过 6取消 15开发池 16版型资产库 |
+| `convertGoodsState` | Integer | 否 | 转大货状态 |
+| `isSealedSample` | Integer | 否 | 封样状态 |
+| `brandName` | String | 否 | 品牌 |
+| `seasonName` | String | 否 | 季节 |
+| `rangesName` | String | 否 | 波段 |
+| `planName` | String | 否 | 企划 |
+| `year` | String | 否 | 年份 |
+| `sex` | Integer | 否 | 性别 |
+| `designerName` | String | 否 | 设计师 |
+| `patternMakerName` | String | 否 | 打版师 |
+| `followerName` | String | 否 | 跟单员 |
+| `costPrice` | BigDecimal | 否 | 成本价 |
+| `tradePrice` | BigDecimal | 否 | 贸易价 |
+| `retailPriceArea` | BigDecimal | 否 | 工厂零售价 |
+| `currencyCode` | String | 否 | 币种代码 |
+| `currencyPrice` | BigDecimal | 否 | 外币价格 |
+| `devTime` | Timestamp | 否 | 开发日期 |
+| `executeStandardName` | String | 否 | 执行标准 |
+| `securityTypeName` | String | 否 | 安全类别 |
+| `gramWeight` | BigDecimal | 否 | 克重 |
+| `composition` | String | 否 | 成分 |
+| `serial` | SerialRow | 否 | 最新版次信息 |
+| `materials` | List<MaterialRow> | 否 | 本行颜色的物料行（单价为物料价格，无权限限制） |
+| `processFees` | List<ProcessRow> | 否 | 工序费用行（单价按隐藏价格开关与查看权限遮蔽） |
+| `costFees` | List<FeeRow> | 否 | 特殊工艺费用行（供应商名按加工厂资料权限遮蔽） |
+| `accountItems` | List<AccountItemRow> | 否 | 其他费用行 |
+**serial 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `serial.name` | String | 否 | 版次名 |
+| `serial.designOrderSn` | String | 否 | 板单号 |
+| `serial.state` | Integer | 否 | 版次状态 |
+| `serial.businessTime` | Timestamp | 否 | 业务日期 |
+| `serial.finishTime` | Timestamp | 否 | 完成时间 |
+| `serial.checkTime` | Timestamp | 否 | 审版时间 |
+| `serial.reviewResultId` | Long | 否 | 审版结果id |
+**materials[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `materials[].materialSn` | String | 否 | 物料货号 |
+| `materials[].materialName` | String | 否 | 物料名称 |
+| `materials[].materialCategoryName` | String | 否 | 物料分类 |
+| `materials[].rootCategoryName` | String | 否 | 一级分类 |
+| `materials[].subCategoryName` | String | 否 | 二级分类 |
+| `materials[].designSkuColorName` | String | 否 | 设计款颜色名 |
+| `materials[].materialSkuColorName` | String | 否 | 物料颜色名 |
+| `materials[].materialSkuSupplierColor` | String | 否 | 供应商色号 |
+| `materials[].materialSupplierSn` | String | 否 | 供应商物料货号 |
+| `materials[].materialUnitName` | String | 否 | 单位 |
+| `materials[].materialTypeName` | String | 否 | 物料类型 |
+| `materials[].materialComposition` | String | 否 | 成分 |
+| `materials[].materialGramWeight` | BigDecimal | 否 | 克重 |
+| `materials[].materialFabricWidth` | BigDecimal | 否 | 门幅 |
+| `materials[].materialMultiplyingPower` | BigDecimal | 否 | 下料倍率 |
+| `materials[].materialPrice` | BigDecimal | 否 | 单价 |
+| `materials[].materialRemark` | String | 否 | 物料备注 |
+| `materials[].supplierName` | String | 否 | 供应商名称（无物料供应商资料权限时为空） |
+| `materials[].supplierAddress` | String | 否 | 供应商地址（无物料供应商资料权限时为空） |
+| `materials[].supplierCellPhone` | String | 否 | 供应商电话（无物料供应商资料权限时为空） |
+**processFees[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `processFees[].workProcessName` | String | 否 | 工序名称 |
+| `processFees[].price` | BigDecimal | 否 | 单价（工序开启隐藏价格且无查看权限时为空） |
+| `processFees[].core` | Integer | 否 | 是否裁床工序：2是 |
+| `processFees[].showOrder` | Integer | 否 | 排序号 |
+**costFees[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `costFees[].name` | String | 否 | 费用名称 |
+| `costFees[].price` | BigDecimal | 否 | 单价 |
+| `costFees[].supplierName` | String | 否 | 供应商名称（无加工厂资料权限时为空） |
+| `costFees[].colorPrices` | List<ColorPriceRow> | 否 | 分颜色的价格明细（仅开启单价分颜色的费用有值） |
+**colorPrices[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `colorPrices[].colorName` | String | 否 | 颜色名 |
+| `colorPrices[].price` | BigDecimal | 否 | 单价 |
+**accountItems[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `accountItems[].accountItemName` | String | 否 | 费用类型名称 |
+| `accountItems[].unitName` | String | 否 | 单位名称 |
+## 版单列表（design-order list，旗舰版功能）
+- 命令：`scm-agent design-order list --sn A123 --json`
+- 接口：`GET /api/agent/v1/design-order/list`
+> state 是版单状态、nodeType 是节点类型、designOrderMode 是打版方式，三套枚举互不相同；结构里同时给了数字值与中文名（stateText/nodeTypeText/designOrderModeText），汇报给用户时用中文名。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 版单id |
+| `designOrderSn` | String | 否 | 版单号 |
+| `designSn` | String | 否 | 设计款号 |
+| `designName` | String | 否 | 设计款名称 |
+| `designGoodsSn` | String | 否 | 货号 |
+| `state` | Integer | 否 | 版单状态：1未开始 2进行中 3已结束 4废版 9撤销 10审批中 12审批拒绝 |
+| `stateText` | String | 否 | 版单状态中文 |
+| `currentProgressState` | String | 否 | 当前进度节点名 |
+| `type` | Integer | 否 | 类型：1客订 2开发款 |
+| `typeText` | String | 否 | 类型中文 |
+| `designOrderMode` | Integer | 否 | 打版方式：1自主打样 2外发打样 3共同打样 |
+| `designOrderModeText` | String | 否 | 打版方式中文 |
+| `designOrderSerialName` | String | 否 | 版次名 |
+| `businessTime` | Timestamp | 否 | 下版日期 |
+| `finishTime` | Timestamp | 否 | 预计完成时间 |
+| `isFinalVersion` | Integer | 否 | 是否终版：1是 0否 |
+| `totalNumber` | BigDecimal | 否 | 打版数 |
+| `totalDeliveryNumber` | BigDecimal | 否 | 交付数 |
+| `supplierName` | String | 否 | 供应商名（无加工厂资料权限时为空） |
+| `clientName` | String | 否 | 客户名 |
+| `followUserName` | String | 否 | 跟单员姓名 |
+| `designAssistantName` | String | 否 | 设计助理姓名 |
+| `lastHandler` | String | 否 | 最后操作人姓名 |
+| `remark` | String | 否 | 备注 |
+| `designImgUrl` | String | 否 | 款式图 |
+| `updateTime` | Timestamp | 否 | 更新时间 |
+| `nodes` | List<NodeRow> | 否 | 节点进度（精简） |
+**nodes[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `nodes[].nodeName` | String | 否 | 节点名 |
+| `nodes[].nodeType` | Integer | 否 | 节点类型：1普通 2纸样 3车板 4审版 |
+| `nodes[].nodeTypeText` | String | 否 | 节点类型中文 |
+| `nodes[].state` | Integer | 否 | 节点状态：1待处理 2已完成 |
+| `nodes[].stateText` | String | 否 | 节点状态中文 |
+| `nodes[].leaderNames` | List<String> | 否 | 负责人姓名列表 |
+| `nodes[].finishTime` | Timestamp | 否 | 预计完成时间 |
+| `nodes[].endTime` | Timestamp | 否 | 实际完成时间 |
+## 版单详情（design-order detail，旗舰版功能）
+- 命令：`scm-agent design-order detail --sn FS1024001 --json`
+- 接口：`GET /api/agent/v1/design-order/detail`
+> 在列表字段基础上追加打版数量明细、节点进度、BOM 物料行、尺码指示、工艺要求、工序，以及同款全部版单。supplierName 与工序单价受权限遮蔽。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 版单id |
+| `designOrderSn` | String | 否 | 版单号 |
+| `designId` | Long | 否 | 设计款id |
+| `designSn` | String | 否 | 设计款号 |
+| `designName` | String | 否 | 设计款名称 |
+| `state` | Integer | 否 | 版单状态：1未开始 2进行中 3已结束 4废版 9撤销 10审批中 12审批拒绝 |
+| `stateText` | String | 否 | 版单状态中文 |
+| `type` | Integer | 否 | 类型：1客订 2开发款 |
+| `typeText` | String | 否 | 类型中文 |
+| `designOrderMode` | Integer | 否 | 打版方式：1自主打样 2外发打样 3共同打样 |
+| `designOrderModeText` | String | 否 | 打版方式中文 |
+| `designOrderSerialName` | String | 否 | 版次名 |
+| `businessTime` | Timestamp | 否 | 下版日期 |
+| `finishTime` | Timestamp | 否 | 预计完成时间 |
+| `createTime` | Timestamp | 否 | 创建时间 |
+| `updateTime` | Timestamp | 否 | 更新时间 |
+| `isFinalVersion` | Integer | 否 | 是否终版：1是 0否 |
+| `totalNumber` | BigDecimal | 否 | 打版数 |
+| `totalDeliveryNumber` | BigDecimal | 否 | 交付数 |
+| `supplierName` | String | 否 | 供应商名（无加工厂资料权限时为空） |
+| `clientName` | String | 否 | 客户名 |
+| `followUserName` | String | 否 | 跟单员姓名 |
+| `designAssistantName` | String | 否 | 设计助理姓名 |
+| `handler` | String | 否 | 创建人姓名 |
+| `lastHandler` | String | 否 | 最后操作人姓名 |
+| `styleDemand` | String | 否 | 款式需求 |
+| `materialDemand` | String | 否 | 物料需求 |
+| `platemakingDemand` | String | 否 | 打版需求 |
+| `techniqueDemand` | String | 否 | 工艺需求 |
+| `revisionReason` | String | 否 | 修订原因 |
+| `abolishExplain` | String | 否 | 废版说明 |
+| `partLenSampleSizeName` | String | 否 | 打版样衣尺码名 |
+| `remark` | String | 否 | 备注 |
+| `designImgUrl` | String | 否 | 款式图 |
+| `designOrderImgUrl` | String | 否 | 版单图 |
+| `dtRows` | List<DtRow> | 否 | 打版数量明细（颜色×尺码×数量） |
+| `nodes` | List<NodeRow> | 否 | 节点进度 |
+| `bomRows` | List<BomRow> | 否 | BOM 物料行 |
+| `devRows` | List<DevRow> | 否 | 面辅料开发行 |
+| `parts` | List<PartRow> | 否 | 尺码指示行 |
+| `techniques` | List<TechniqueRow> | 否 | 工艺要求行 |
+| `workProcesses` | List<ProcessRow> | 否 | 工序行 |
+| `design` | DesignSummary | 否 | 设计款摘要 |
+| `serialOrders` | List<SerialOrderRow> | 否 | 该设计款全部版单摘要 |
+| `attachmentNames` | List<String> | 否 | 附件文件名列表（版单附件与工艺附件） |
+| `designOrderImgUrls` | List<String> | 否 | 版单图片 URL 列表 |
+| `designImgUrls` | List<String> | 否 | 设计款图片 URL 列表 |
+**dtRows[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `dtRows[].skuId` | Long | 否 | 单品id |
+| `dtRows[].colorName` | String | 否 | 颜色名 |
+| `dtRows[].sizeName` | String | 否 | 尺码名 |
+| `dtRows[].number` | BigDecimal | 否 | 打版数量 |
+| `dtRows[].sumHandoverNumber` | BigDecimal | 否 | 已交付数量 |
+**nodes[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `nodes[].nodeName` | String | 否 | 节点名 |
+| `nodes[].nodeType` | Integer | 否 | 节点类型：1普通 2纸样 3车板 4审版 |
+| `nodes[].nodeTypeText` | String | 否 | 节点类型中文 |
+| `nodes[].state` | Integer | 否 | 节点状态：1待处理 2已完成 |
+| `nodes[].stateText` | String | 否 | 节点状态中文 |
+| `nodes[].leaderNames` | List<String> | 否 | 负责人姓名列表 |
+| `nodes[].finishTime` | Timestamp | 否 | 预计完成时间 |
+| `nodes[].endTime` | Timestamp | 否 | 实际完成时间 |
+| `nodes[].reportNumber` | BigDecimal | 否 | 汇报数量 |
+| `nodes[].sumReportNumber` | BigDecimal | 否 | 累计汇报数量 |
+**bomRows[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `bomRows[].materialSn` | String | 否 | 物料货号 |
+| `bomRows[].materialName` | String | 否 | 物料名称 |
+| `bomRows[].colorName` | String | 否 | 款色名 |
+| `bomRows[].sizeName` | String | 否 | 款码名 |
+| `bomRows[].materialColor` | String | 否 | 物料颜色 |
+| `bomRows[].number` | BigDecimal | 否 | 单件用量 |
+| `bomRows[].supplierName` | String | 否 | 供应商名（无物料供应商资料权限时为空） |
+| `bomRows[].supplierAddress` | String | 否 | 供应商地址（无物料供应商资料权限时为空） |
+| `bomRows[].supplierCellPhone` | String | 否 | 供应商电话（无物料供应商资料权限时为空） |
+**devRows[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `devRows[].materialName` | String | 否 | 物料名称 |
+| `devRows[].supplierSn` | String | 否 | 供应商货号 |
+| `devRows[].colorCode` | String | 否 | 色号 |
+| `devRows[].number` | BigDecimal | 否 | 数量 |
+| `devRows[].unitName` | String | 否 | 单位 |
+| `devRows[].materialTypeName` | String | 否 | 物料类型 |
+| `devRows[].categoryName` | String | 否 | 物料分类 |
+| `devRows[].remark` | String | 否 | 备注 |
+| `devRows[].supplierName` | String | 否 | 供应商名（无物料供应商资料权限时为空） |
+**parts[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `parts[].name` | String | 否 | 部位名 |
+| `parts[].measureMethod` | String | 否 | 度量方法 |
+| `parts[].sampleLengthStr` | String | 否 | 样衣尺寸 |
+| `parts[].errorRangeStr` | String | 否 | 误差范围 |
+| `parts[].sizes` | List<SizeLengthRow> | 否 | 各尺码尺寸（尺码id 与打版数量行的尺码对应） |
+**sizes[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `sizes[].sizeId` | Long | 否 | 尺码id |
+| `sizes[].lengthStr` | String | 否 | 尺寸值 |
+**techniques[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `techniques[].name` | String | 否 | 工艺名称 |
+| `techniques[].description` | String | 否 | 工艺说明 |
+**workProcesses[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `workProcesses[].workProcessName` | String | 否 | 工序名 |
+| `workProcesses[].showOrder` | Integer | 否 | 顺序 |
+| `workProcesses[].price` | BigDecimal | 否 | 单价（该工序开启隐藏价格且无查看权限时为空） |
+| `workProcesses[].leaderNames` | List<String> | 否 | 负责人姓名列表 |
+**design 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `design.designSn` | String | 否 | 设计款号 |
+| `design.name` | String | 否 | 设计款名称 |
+| `design.designBrandName` | String | 否 | 品牌 |
+| `design.designSeasonName` | String | 否 | 季节 |
+| `design.designDesignerName` | String | 否 | 设计师姓名 |
+**serialOrders[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `serialOrders[].id` | Long | 否 | 版单id |
+| `serialOrders[].designOrderSn` | String | 否 | 版单号 |
+| `serialOrders[].designOrderSerialName` | String | 否 | 版次名 |
+| `serialOrders[].state` | Integer | 否 | 版单状态：1未开始 2进行中 3已结束 4废版 9撤销 10审批中 12审批拒绝 |
+| `serialOrders[].stateText` | String | 否 | 版单状态中文 |
+| `serialOrders[].businessTime` | Timestamp | 否 | 下版日期 |
+| `serialOrders[].isFinalVersion` | Integer | 否 | 是否终版：1是 0否 |
+## 数据变动日志（log db-change）
+- 命令：`scm-agent log db-change --keywords WL1002 --json`
+- 接口：`GET /api/agent/v1/log/db-change`
+> 按时间倒序返回，没有页码与精确总数；hasMore 为 true 时用返回的 lineNum/scrollId 续查。rows 里每行的 uid 用本结构的 users 映射换成姓名（服务端已按批查好）。data 里是变动字段的键值，隐藏字段（分库分表与内部字段）服务端已过滤。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `rows` | List<AgentDbChangeLogDTO> | 否 | 变动日志行（时间倒序） |
+| `hasMore` | boolean | 否 | 是否还有下一批 |
+| `lineNum` | String | 否 | 续查用行号（hasMore 为 true 时返回） |
+| `scrollId` | String | 否 | 续查用游标（hasMore 为 true 时返回） |
+| `users` | Map<String,String> | 否 | 本批行涉及的 uid→姓名 映射 |
+## 接口日志（log api）
+- 命令：`scm-agent log api --request-id 1790000000000_1060184727 --json`
+- 接口：`GET /api/agent/v1/log/api`
+> 返回数组，每个元素对应这次请求的一条接口日志。methodArgs 超过 4000 字符会截断，并用 argsTruncated 标记。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `time` | Long | 否 | 日志时间（毫秒时间戳） |
+| `operatorName` | String | 否 | 操作人姓名 |
+| `description` | String | 否 | 操作内容，如：修改物料 |
+| `methodPath` | String | 否 | 接口路径 |
+| `device` | String | 否 | 设备类型，如 Chrome（2.20.0） |
+| `sourceIp` | String | 否 | 来源 IP |
+| `methodArgs` | String | 否 | 方法参数 JSON 文本（超长截断） |
+| `argsTruncated` | boolean | 否 | methodArgs 是否因超长被截断 |
+## 员工搜索（user search）
+- 命令：`scm-agent user search --name 张三 --json`
+- 接口：`GET /api/agent/v1/user-list`
+> uid 是各单据里出现 handlerId、payerId 等字段时对应的同一个用户标识，做「按人汇总」的报表时用它关联。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `uid` | Long | 否 | 员工id（即各单据中的 handlerId/payerId 等） |
+| `name` | String | 否 | 姓名 |
+| `departmentId` | Long | 否 | 直属部门id |
+| `departmentName` | String | 否 | 直属部门名称（含上级部门路径） |
+| `status` | Integer | 否 | 状态：1-启用 2-停用 |
+| `phone` | String | 否 | 手机号 |
+| `workSn` | String | 否 | 工号 |
+## 员工详情（user detail）
+- 命令：`scm-agent user detail --uid 888 --json`
+- 接口：`GET /api/agent/v1/user/detail`
+> status 在这里的枚举（0 注销 1 正常 2 禁用 3 锁定）与员工搜索里的 status（1 启用 2 停用）不是同一套取值，两个接口不要互相套用。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `uid` | Long | 否 | 用户 id |
+| `name` | String | 否 | 姓名 |
+| `loginName` | String | 否 | 登录账号 |
+| `status` | Integer | 否 | 状态：0 注销 1 正常 2 禁用 3 锁定 |
+| `accountType` | Integer | 否 | 账号类型：0 主账号 1 子账号 2 微信 |
+| `roles` | List<RoleItem> | 否 | 拥有的角色 |
+**roles[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `roles[].id` | Long | 否 | 角色 id |
+| `roles[].name` | String | 否 | 角色名 |
+## 角色列表（role list）
+- 命令：`scm-agent role list --name 设计 --json`
+- 接口：`GET /api/agent/v1/role/list`
+> isSystem 为 true 表示系统内置角色，只能查看，不能修改权限。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 角色 id |
+| `name` | String | 否 | 角色名 |
+| `remark` | String | 否 | 备注 |
+| `isSystem` | Boolean | 否 | 是否系统内置角色（只能查看，不能修改） |
+| `state` | Integer | 否 | 状态：0 无效 1 有效 |
+| `createTime` | Date | 否 | 创建时间 |
+## 角色详情（role detail）
+- 命令：`scm-agent role detail --name 设计师 --json`
+- 接口：`GET /api/agent/v1/role/detail`
+> permissions 是该角色现有权限，affectedUsers 是使用该角色的用户，改权限前必须把 affectedUsers 说给用户听。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `roleId` | Long | 否 | 角色 id |
+| `name` | String | 否 | 角色名 |
+| `remark` | String | 否 | 备注 |
+| `isSystem` | Boolean | 否 | 是否系统内置角色（只能查看，不能修改） |
+| `permissions` | List<PermissionItem> | 否 | 该角色现有权限 |
+| `affectedUsers` | List<AffectedUser> | 否 | 使用该角色的用户（改权限会影响这些人） |
+**permissions[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `permissions[].menuId` | Long | 否 | 菜单 id |
+| `permissions[].label` | String | 否 | 功能标题 |
+| `permissions[].remark` | String | 否 | 中文备注，网页权限不足提示引号内的名称 |
+| `permissions[].permission` | String | 否 | 权限 key（可能为空） |
+**affectedUsers[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `affectedUsers[].uid` | Long | 否 | 用户 id |
+| `affectedUsers[].name` | String | 否 | 姓名 |
+## 权限菜单列表（permission list）
+- 命令：`scm-agent permission list --keyword 查看 --json`
+- 接口：`GET /api/agent/v1/permission/list`
+> remark 会重名（同一段中文名对应多个权限变体），需要区分时看 label、permission 与 id。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 菜单 id（角色权限保存使用的标识） |
+| `parentId` | Long | 否 | 上级菜单 id |
+| `label` | String | 否 | 功能标题 |
+| `remark` | String | 否 | 中文备注，网页权限不足提示引号内的名称 |
+| `permission` | String | 否 | 权限 key（camelCase；目录/页面节点可能为空） |
+| `type` | Integer | 否 | 节点类型：1 目录 2 页面 3 操作 |
+| `state` | Integer | 否 | 状态：1 有效 |
+## 修改角色权限的结果（role add-permission / role remove-permission）
+- 命令：`scm-agent role add-permission --name 设计师 --permissions "商品管理的查看" --confirm --json`
+- 接口：`POST /api/agent/v1/role/update-permission`
+> added 与 removed 是本次实际改动的权限，totalPermissions 是改动后该角色的权限总数（服务端会自动并入默认菜单，因此总数不是简单加减的结果）。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `roleId` | Long | 否 | 角色 id |
+| `roleName` | String | 否 | 角色名 |
+| `added` | List<AgentRoleDetailDTO.PermissionItem> | 否 | 本次增加的权限 |
+| `removed` | List<AgentRoleDetailDTO.PermissionItem> | 否 | 本次移除的权限 |
+| `totalPermissions` | Integer | 否 | 改动后的权限总数（含服务端自动并入的默认菜单） |
+## 创建员工的结果（user add）
+- 命令：`scm-agent user add --name 张三 --login-name abcd --password 1234 --confirm --json`
+- 接口：`POST /api/agent/v1/user/add`
+> 返回体是固定四个字段，没有对应的 Java DTO。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `uid` | Long | 否 | 新建员工的用户 id |
+| `name` | String | 否 | 姓名 |
+| `loginName` | String | 否 | 登录账号 |
+| `roleNames` | List<String> | 否 | 关联的角色名（未传角色时该字段不出现） |
+## data 命令的数据集
+下面每一节对应 `scm-agent data` 的一个数据集；参数说明与示例见 [cli.md](cli.md) 的 data 一节。
+## 数据集：company-config（公司配置白名单：物料小数位、是否启用生产批次号）
+- 命令：`scm-agent data company-config --json`
+- 接口：`GET /api/agent/v1/company-config`
+- 必填条件：无
+> 做金额统计要用与网页一致的小数位（materialDecimal），启用批次号的企业里单号口径优先批次号。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `materialDecimal` | Integer | 否 | 物料小数位（配置 materialDecimal 的 configValue） |
+| `produceBatchSnEnable` | Boolean | 否 | 是否启用生产批次号（由 isOpenProduceBatchSn 判断） |
+## 数据集：goods-rich（商品富化列表（档案、价格、库存、首单面料、翻单信息））
+- 命令：`scm-agent data goods-rich --sn A123 --json`
+- 接口：`GET /api/agent/v1/goods/rich-list`
+- 必填条件：--sn 或 --search-key 至少一项
+> 默认只返回上架款（服务端 isOnSale 默认 1），要看停用款给 --on-sale -1。id 用于继续查 goods-bom。首单面料、翻单信息在完整字段表的后半部分。
+**常用字段（做统计先看这些，其余字段在下面）**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 商品id（用于继续查询完整详情） |
+| `name` | String | 否 | 商品名称 |
+| `goodsSn` | String | 否 | 商品货号 |
+| `categoryName` | String | 否 | 分类 |
+| `bomFinish` | Integer | 否 | BOM完成状态：0-待完成 1-完成 |
+| `storedNumber` | Integer | 否 | 当前库存 |
+| `availableNumber` | Integer | 否 | 可用库存 |
+| `produceNumber` | BigDecimal | 否 | 生产中数量 |
+| `iePrice` | BigDecimal | 否 | IE核价 |
+| `costPrice` | BigDecimal | 否 | 成本价 |
+| `tagPrice` | BigDecimal | 否 | 吊牌价 |
+| `devTime` | String | 否 | 开发日期（yyyy-MM-dd） |
+| `isOnSale` | Integer | 否 | 状态：1-启用 0-停用 |
+**全部字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 商品id（用于继续查询完整详情） |
+| `name` | String | 否 | 商品名称 |
+| `goodsSn` | String | 否 | 商品货号 |
+| `goodsImgUrl` | String | 否 | 商品主图地址 |
+| `categoryName` | String | 否 | 分类 |
+| `tagNames` | List<String> | 否 | 标签名称列表 |
+| `bomFinish` | Integer | 否 | BOM完成状态：0-待完成 1-完成 |
+| `bomState` | Integer | 否 | BOM锁定状态：0-未锁定 1-已锁定 |
+| `externalProcessingFees` | List<String> | 否 | 委外加工费（名称:金额 列表） |
+| `isSealedSample` | Integer | 否 | 封样状态：0-未封样 1-封样 |
+| `patternMakerName` | String | 否 | 打版师 |
+| `storedNumber` | Integer | 否 | 当前库存 |
+| `winNumber` | Integer | 否 | 待入库 |
+| `woutNumber` | Integer | 否 | 待出库 |
+| `availableNumber` | Integer | 否 | 可用库存 |
+| `produceNumber` | BigDecimal | 否 | 生产中数量 |
+| `iePrice` | BigDecimal | 否 | IE核价 |
+| `costPrice` | BigDecimal | 否 | 成本价 |
+| `tagPrice` | BigDecimal | 否 | 吊牌价 |
+| `retailPriceFactory` | BigDecimal | 否 | 建议零售价 |
+| `tradePrice` | BigDecimal | 否 | 批发价 |
+| `retailPriceArea` | BigDecimal | 否 | 零售价 |
+| `materialNames` | List<String> | 否 | 物料名称列表（去重） |
+| `clientName` | String | 否 | 客户 |
+| `devTime` | String | 否 | 开发日期（yyyy-MM-dd） |
+| `brandName` | String | 否 | 品牌 |
+| `designSn` | String | 否 | 设计款号 |
+| `supplierSn` | String | 否 | 供应商货号 |
+| `designerName` | String | 否 | 设计师 |
+| `followerName` | String | 否 | 跟单员 |
+| `year` | String | 否 | 年份 |
+| `month` | Integer | 否 | 月份 |
+| `seasonName` | String | 否 | 季节 |
+| `gramWeight` | BigDecimal | 否 | 克重(g/㎡) |
+| `composition` | String | 否 | 成分 |
+| `sex` | Integer | 否 | 性别：0-通款 1-男款 2-女款 3-童装 |
+| `rangesName` | String | 否 | 波段 |
+| `barCode` | String | 否 | 商品条码 |
+| `isOnSale` | Integer | 否 | 状态：1-启用 0-停用 |
+| `remark` | String | 否 | 备注 |
+| `handlerName` | String | 否 | 创建人 |
+| `createTime` | Timestamp | 否 | 创建时间 |
+| `lastHandlerName` | String | 否 | 最后更新人 |
+| `updateTime` | Timestamp | 否 | 更新时间 |
+| `executeStandardName` | String | 否 | 执行标准 |
+| `securityTypeName` | String | 否 | 安全类别 |
+| `colorNames` | List<String> | 否 | 颜色名称列表 |
+| `sizeNames` | List<String> | 否 | 尺码名称列表 |
+| `firstOrderTime` | Timestamp | 否 | 首单日期（无生产单时为空） |
+| `reorderOrderInfo` | String | 否 | 新款/翻单信息 |
+| `firstProduceOrderMaterials` | List<FirstOrderMaterialRow> | 否 | 首单面料列表（历史首单 BOM 面料） |
+**firstProduceOrderMaterials[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `firstProduceOrderMaterials[].materialName` | String | 否 | 物料名称 |
+| `firstProduceOrderMaterials[].materialSn` | String | 否 | 物料货号 |
+| `firstProduceOrderMaterials[].bomSupplierColor` | String | 否 | BOM供应商颜色 |
+| `firstProduceOrderMaterials[].materialColor` | String | 否 | 物料颜色 |
+| `firstProduceOrderMaterials[].propertyText` | String | 否 | 物料规格（属性值拼接） |
+| `firstProduceOrderMaterials[].supplierName` | String | 否 | 默认供应商 |
+| `firstProduceOrderMaterials[].materialQunce` | BigDecimal | 否 | 安数 |
+| `firstProduceOrderMaterials[].skuPurchasePrice` | BigDecimal | 否 | 采购单价（物料单品） |
+| `firstProduceOrderMaterials[].purchasePrice` | BigDecimal | 否 | 采购单价（BOM 行） |
+| `firstProduceOrderMaterials[].skuPrice` | BigDecimal | 否 | 基础单价（物料单品） |
+| `firstProduceOrderMaterials[].price` | BigDecimal | 否 | 基础单价（BOM 行） |
+| `firstProduceOrderMaterials[].materialFabricWidth` | BigDecimal | 否 | 幅宽(cm) |
+| `firstProduceOrderMaterials[].materialComposition` | String | 否 | 面料成分 |
+| `firstProduceOrderMaterials[].remark` | String | 否 | 备注 |
+## 数据集：goods-bom（商品完整详情：BOM 物料清单、工序单价、尺寸表（129 个字段，单条））
+- 命令：`scm-agent data goods-bom --id 12345 --json`
+- 接口：`GET /api/agent/v1/goods/full-detail`
+- 必填条件：--id
+> 单条接口。BOM 物料行在 goodsMaterialList[]、工序单价在 goodsWorkProcessList[]、尺寸部位在 goodsPartList[]（部位下还有 sizes[]），这三组嵌套行做 BOM 类统计时才需要展开。
+**常用字段（做统计先看这些，其余字段在下面）**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 商品id |
+| `name` | String | 否 | 商品名称 |
+| `goodsSn` | String | 否 | 商品货号 |
+| `designSn` | String | 否 | 设计款号 |
+| `bomFinish` | Integer | 否 | BOM完成状态：0-待完成 1-完成 |
+| `bomState` | Integer | 否 | BOM锁定状态：0-未锁定 1-已锁定 |
+| `isOnSale` | Integer | 否 | 状态：1-启用 0-停用 |
+| `devTime` | String | 否 | 开发日期（yyyy-MM-dd） |
+| `costPrice` | BigDecimal | 否 | 成本价 |
+| `tagPrice` | BigDecimal | 否 | 吊牌价 |
+| `firstOrderTime` | Timestamp | 否 | 首单日期 |
+**全部字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 商品id |
+| `name` | String | 否 | 商品名称 |
+| `goodsSn` | String | 否 | 商品货号 |
+| `goodsImgUrl` | String | 否 | 商品主图地址 |
+| `categoryName` | String | 否 | 分类 |
+| `brandName` | String | 否 | 品牌 |
+| `designSn` | String | 否 | 设计款号 |
+| `supplierSn` | String | 否 | 供应商货号 |
+| `barCode` | String | 否 | 商品条码 |
+| `year` | String | 否 | 年份 |
+| `month` | Integer | 否 | 月份 |
+| `seasonName` | String | 否 | 季节 |
+| `rangesName` | String | 否 | 波段 |
+| `executeStandardName` | String | 否 | 执行标准 |
+| `securityTypeName` | String | 否 | 安全类别 |
+| `composition` | String | 否 | 成分 |
+| `gramWeight` | BigDecimal | 否 | 克重(g/㎡) |
+| `sex` | Integer | 否 | 性别：0-通款 1-男款 2-女款 3-童装 |
+| `sizeLenDisplay` | Integer | 否 | 尺寸显示方式：1-小数 2-分数 |
+| `bomFinish` | Integer | 否 | BOM完成状态：0-待完成 1-完成 |
+| `bomState` | Integer | 否 | BOM锁定状态：0-未锁定 1-已锁定 |
+| `isSealedSample` | Integer | 否 | 封样状态：0-未封样 1-封样 |
+| `isOnSale` | Integer | 否 | 状态：1-启用 0-停用 |
+| `remark` | String | 否 | 备注 |
+| `devTime` | String | 否 | 开发日期（yyyy-MM-dd） |
+| `costPrice` | BigDecimal | 否 | 成本价 |
+| `tagPrice` | BigDecimal | 否 | 吊牌价 |
+| `retailPriceFactory` | BigDecimal | 否 | 建议零售价 |
+| `tradePrice` | BigDecimal | 否 | 批发价 |
+| `retailPriceArea` | BigDecimal | 否 | 零售价 |
+| `iePrice` | BigDecimal | 否 | IE核价 |
+| `storedNumber` | Integer | 否 | 当前库存 |
+| `winNumber` | Integer | 否 | 待入库 |
+| `woutNumber` | Integer | 否 | 待出库 |
+| `availableNumber` | Integer | 否 | 可用库存 |
+| `produceNumber` | BigDecimal | 否 | 生产中数量 |
+| `designerName` | String | 否 | 设计师 |
+| `designAssistantName` | String | 否 | 设计助理 |
+| `followerName` | String | 否 | 跟单员 |
+| `patternMakerName` | String | 否 | 打版师 |
+| `clientName` | String | 否 | 客户 |
+| `handlerName` | String | 否 | 创建人 |
+| `createTime` | Timestamp | 否 | 创建时间 |
+| `lastHandlerName` | String | 否 | 最后更新人 |
+| `updateTime` | Timestamp | 否 | 更新时间 |
+| `firstOrderTime` | Timestamp | 否 | 首单日期 |
+| `reorderOrderInfo` | String | 否 | 新款/翻单信息 |
+| `partLenSampleSizeName` | String | 否 | 打样尺寸样衣尺码（尺寸表表头用） |
+| `goodsColors` | List<ColorRow> | 否 | 颜色轴（含颜色id） |
+| `goodsSizes` | List<SizeRow> | 否 | 尺码轴（含尺码id） |
+| `goodsSkuList` | List<SkuRow> | 否 | 商品单品列表（尺寸表尺码轴构建用） |
+| `goodsImgList` | List<ImgRow> | 否 | 商品图片列表 |
+| `goodsMaterialList` | List<BomRow> | 否 | BOM 物料清单行 |
+| `goodsWorkProcessList` | List<WorkProcessRow> | 否 | 商品工序及单价（按 showOrder 排序前的原始顺序） |
+| `goodsPartList` | List<PartRow> | 否 | 尺寸表部位列表 |
+**goodsColors[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `goodsColors[].colorId` | Long | 否 | 颜色id |
+| `goodsColors[].colorName` | String | 否 | 颜色名称 |
+**goodsSizes[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `goodsSizes[].sizeId` | Long | 否 | 尺码id |
+| `goodsSizes[].sizeName` | String | 否 | 尺码名称 |
+**goodsSkuList[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `goodsSkuList[].id` | Long | 否 | 单品id |
+| `goodsSkuList[].colorId` | Long | 否 | 颜色id |
+| `goodsSkuList[].colorName` | String | 否 | 颜色 |
+| `goodsSkuList[].sizeId` | Long | 否 | 尺码id |
+| `goodsSkuList[].sizeName` | String | 否 | 尺码 |
+| `goodsSkuList[].isDisable` | Integer | 否 | 是否停用：0-启用 1-停用 |
+**goodsImgList[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `goodsImgList[].url` | String | 否 | 图片地址 |
+| `goodsImgList[].isMain` | Integer | 否 | 是否主图：1-是 |
+| `goodsImgList[].showOrder` | Integer | 否 | 排序值 |
+**goodsWorkProcessList[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `goodsWorkProcessList[].workProcessName` | String | 否 | 工序名称 |
+| `goodsWorkProcessList[].price` | BigDecimal | 否 | 单价 |
+| `goodsWorkProcessList[].showOrder` | Integer | 否 | 显示顺序 |
+**goodsPartList[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `goodsPartList[].name` | String | 否 | 部位名称 |
+| `goodsPartList[].measureMethod` | String | 否 | 测量方法 |
+| `goodsPartList[].errorRange` | BigDecimal | 否 | 误差范围（数值） |
+| `goodsPartList[].errorRangeStr` | String | 否 | 误差范围（文字） |
+| `goodsPartList[].sampleLength` | BigDecimal | 否 | 打样尺寸（数值） |
+| `goodsPartList[].sampleLengthStr` | String | 否 | 打样尺寸（文字） |
+| `goodsPartList[].gradingDifference` | BigDecimal | 否 | 洗前尺寸档差 |
+| `goodsPartList[].gradingDifferenceAfterWash` | BigDecimal | 否 | 洗后尺寸档差 |
+| `goodsPartList[].attachmentUrls` | List<String> | 否 | 部位图片地址列表 |
+| `goodsPartList[].sizeLengths` | List<SizeLengthRow> | 否 | 各尺码尺寸值 |
+**sizeLengths[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `sizeLengths[].sizeId` | Long | 否 | 尺码id |
+| `sizeLengths[].sizeName` | String | 否 | 尺码名称 |
+| `sizeLengths[].length` | BigDecimal | 否 | 洗前尺寸（数值） |
+| `sizeLengths[].lengthStr` | String | 否 | 洗前尺寸（分数文字） |
+| `sizeLengths[].lengthAfterWash` | BigDecimal | 否 | 洗后尺寸（数值） |
+| `sizeLengths[].lengthStrAfterWash` | String | 否 | 洗后尺寸（分数文字） |
+**goodsMaterialList[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `goodsMaterialList[].materialSkuId` | Long | 否 | 物料单品id（BOM 聚合键） |
+| `goodsMaterialList[].goodsSkuId` | Long | 否 | 商品单品id |
+| `goodsMaterialList[].goodsColorId` | Long | 否 | 商品颜色id |
+| `goodsMaterialList[].goodsColorName` | String | 否 | 商品颜色 |
+| `goodsMaterialList[].goodsSizeId` | Long | 否 | 商品尺码id |
+| `goodsMaterialList[].goodsSizeName` | String | 否 | 商品尺码 |
+| `goodsMaterialList[].hidden` | Boolean | 否 | 是否被采购员隐藏：true-隐藏 |
+| `goodsMaterialList[].number` | BigDecimal | 否 | 单件用量 |
+| `goodsMaterialList[].materialName` | String | 否 | 物料名称 |
+| `goodsMaterialList[].materialSn` | String | 否 | 物料货号 |
+| `goodsMaterialList[].materialColorName` | String | 否 | 物料颜色 |
+| `goodsMaterialList[].materialImgUrl` | String | 否 | 物料图片地址 |
+| `goodsMaterialList[].supplierName` | String | 否 | 供应商 |
+| `goodsMaterialList[].supplierSn` | String | 否 | 供应商货号 |
+| `goodsMaterialList[].supplierAddress` | String | 否 | 供应商地址 |
+| `goodsMaterialList[].supplierCellPhone` | String | 否 | 供应商联系电话 |
+| `goodsMaterialList[].materialTypeName` | String | 否 | 类型（物料类型名称） |
+| `goodsMaterialList[].materialCategoryName` | String | 否 | 物料分类 |
+| `goodsMaterialList[].materialFabricType` | Integer | 否 | 面料属性：1-针织 2-梭织 |
+| `goodsMaterialList[].materialUnitName` | String | 否 | 基础单位 |
+| `goodsMaterialList[].price` | BigDecimal | 否 | 基础单价 |
+| `goodsMaterialList[].convertRate` | BigDecimal | 否 | 转换系数 |
+| `goodsMaterialList[].purchaseUnitName` | String | 否 | 采购单位 |
+| `goodsMaterialList[].purchasePrice` | BigDecimal | 否 | 采购单价 |
+| `goodsMaterialList[].purchaseUserNames` | String | 否 | 采购员（多人和逗号拼接） |
+| `goodsMaterialList[].materialMeterOutput` | BigDecimal | 否 | 出米数(m/kg) |
+| `goodsMaterialList[].materialPaperBucket` | BigDecimal | 否 | 纸筒(kg) |
+| `goodsMaterialList[].materialEmptyGap` | BigDecimal | 否 | 空差(kg) |
+| `goodsMaterialList[].materialNetWeight` | BigDecimal | 否 | 净重(kg) |
+| `goodsMaterialList[].materialFabricWidth` | BigDecimal | 否 | 幅宽(cm) |
+| `goodsMaterialList[].materialGramWeight` | BigDecimal | 否 | 克重(g/㎡) |
+| `goodsMaterialList[].materialQunce` | BigDecimal | 否 | 安数 |
+| `goodsMaterialList[].materialLossRate` | BigDecimal | 否 | 损耗率(%) |
+| `goodsMaterialList[].shrinkRate` | BigDecimal | 否 | 缩水率(%) |
+| `goodsMaterialList[].purchaseLossRate` | BigDecimal | 否 | 采购损耗(%) |
+| `goodsMaterialList[].materialComposition` | String | 否 | 成分 |
+| `goodsMaterialList[].materialPart` | String | 否 | 使用部位 |
+| `goodsMaterialList[].materialPostProcess` | String | 否 | 后处理 |
+| `goodsMaterialList[].materialRemark` | String | 否 | 物料备注 |
+| `goodsMaterialList[].bomSupplierColor` | String | 否 | BOM 供应商颜色 |
+| `goodsMaterialList[].materialSkuSupplierColor` | String | 否 | 物料色号（来自物料单品） |
+| `goodsMaterialList[].propertyText` | String | 否 | 物料规格（属性值拼接） |
+## 数据集：sku-inventory（单品库存列表（只含已转大货的商品））
+- 命令：`scm-agent data sku-inventory --storehouse 5 --json（或 --all-storehouses）`
+- 接口：`GET /api/agent/v1/inventory/sku-list`
+- 必填条件：--storehouse 与 --all-storehouses 二选一
+> 只包含已转大货的商品（服务端 SQL 固定过滤 bulk_goods_state=1，参数上没有开关）。库存列的含义由调用时给 --storehouse（单仓库）还是 --all-storehouses（全部仓库合计）决定。
+**常用字段（做统计先看这些，其余字段在下面）**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `goodsSn` | String | 否 | 款号（商品货号） |
+| `goodsName` | String | 否 | 商品名称 |
+| `colorName` | String | 否 | 颜色 |
+| `sizeName` | String | 否 | 尺码 |
+| `skuBarCode` | String | 否 | 单品条码 |
+| `storedNumber` | Integer | 否 | 库存数 |
+| `availableNumber` | Integer | 否 | 可用库存 |
+| `winNumber` | Integer | 否 | 待入库数 |
+| `woutNumber` | Integer | 否 | 待出库数 |
+| `isDisable` | Integer | 否 | 单品停用状态：0启用 1停用 |
+**全部字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `goodsId` | Long | 否 | 商品ID |
+| `skuId` | Long | 否 | 单品ID |
+| `goodsSn` | String | 否 | 款号（商品货号） |
+| `goodsName` | String | 否 | 商品名称 |
+| `colorName` | String | 否 | 颜色 |
+| `sizeName` | String | 否 | 尺码 |
+| `colorShowOrder` | Integer | 否 | 颜色显示顺序 |
+| `sizeShowOrder` | Integer | 否 | 尺码显示顺序 |
+| `skuBarCode` | String | 否 | 单品条码 |
+| `storedNumber` | Integer | 否 | 库存数 |
+| `availableNumber` | Integer | 否 | 可用库存 |
+| `winNumber` | Integer | 否 | 待入库数 |
+| `woutNumber` | Integer | 否 | 待出库数 |
+| `isDisable` | Integer | 否 | 单品停用状态：0启用 1停用 |
+## 数据集：produce-cost（生产成本报表数据（每行含五类成本明细））
+- 命令：`scm-agent data produce-cost --from 2026-09-01 --to 2026-09-30 --json`
+- 接口：`GET /api/agent/v1/report/produce-cost`
+- 必填条件：--from 与 --to；跨度不超过 92 天
+> 服务端默认状态 4,2,3（待生产/生产中/生产完成）、默认计算规则 1（按默认逻辑）。五类成本明细（物料、委外加工、工序外发、工人计件、其它）在嵌套的 costItems 行里；差异类统计用「实际 − 预估」字段相减，不要用单件成本反推。
+**常用字段（做统计先看这些，其余字段在下面）**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `goodsName` | String | 否 | 商品名称 |
+| `designSn` | String | 否 | 款号（设计款号） |
+| `goodsSn` | String | 否 | 大货号（商品货号） |
+| `ordersSn` | String | 否 | 生产单号 |
+| `state` | Integer | 否 | 状态：1草稿 2生产中 3生产完成 4待生产 9已撤销 11待接单 12拒绝接单 13待审批 14审批拒绝 |
+| `sumNumber` | Integer | 否 | 下单数 |
+| `sumCutBedNumber` | BigDecimal | 否 | 裁床数 |
+| `sumStoreInNumber` | Integer | 否 | 已入库数 |
+| `businessTime` | String | 否 | 业务日期（yyyy-MM-dd） |
+| `actualSumSingleGoodsCost` | BigDecimal | 否 | 实际成本-单件成本 |
+| `actualSumCost` | BigDecimal | 否 | 实际成本-总成本 |
+| `estimatedSumSingleGoodsCost` | BigDecimal | 否 | 预估成本-单件成本 |
+| `estimatedSumCost` | BigDecimal | 否 | 预估成本-总成本 |
+**全部字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `goodsName` | String | 否 | 商品名称 |
+| `designSn` | String | 否 | 款号（设计款号） |
+| `imgUrl` | String | 否 | 款式图片 URL |
+| `goodsSn` | String | 否 | 大货号（商品货号） |
+| `rangesName` | String | 否 | 波段 |
+| `designerName` | String | 否 | 设计师 |
+| `patternMakerName` | String | 否 | 打版师 |
+| `ordersSn` | String | 否 | 生产单号 |
+| `produceBatchSn` | String | 否 | 生产批次号 |
+| `state` | Integer | 否 | 状态：1草稿 2生产中 3生产完成 4待生产 9已撤销 11待接单 12拒绝接单 13待审批 14审批拒绝 |
+| `orderTypeName` | String | 否 | 订单类型名称 |
+| `tags` | List<String> | 否 | 标签名称列表 |
+| `type` | Integer | 否 | 生产类型：1自主生产 2单工序外发 3委外加工 4成品采购 |
+| `deliveryTime` | String | 否 | 预计交货日期（yyyy-MM-dd） |
+| `followerName` | String | 否 | 跟单员 |
+| `sumNumber` | Integer | 否 | 下单数 |
+| `sumCutBedNumber` | BigDecimal | 否 | 裁床数 |
+| `sumStoreInNumber` | Integer | 否 | 已入库数 |
+| `sumNoFinishNumber` | BigDecimal | 否 | 未完成数 |
+| `sumNoOutNumber` | BigDecimal | 否 | 未出数 |
+| `sumNoStoreInNumber` | BigDecimal | 否 | 未入库数 |
+| `businessTime` | String | 否 | 业务日期（yyyy-MM-dd） |
+| `actualMaterialCost` | BigDecimal | 否 | 实际成本-物料 |
+| `actualProduceOrderProcessCost` | BigDecimal | 否 | 实际成本-委外加工 |
+| `actualOutWardOrderCost` | BigDecimal | 否 | 实际成本-工序外发 |
+| `actualWorkManPieceworkCost` | BigDecimal | 否 | 实际成本-工人计件 |
+| `actualOtherCost` | BigDecimal | 否 | 实际成本-其它费用 |
+| `actualSumSingleGoodsCost` | BigDecimal | 否 | 实际成本-单件成本 |
+| `actualNumber` | BigDecimal | 否 | 实际成本-件数 |
+| `actualSumCost` | BigDecimal | 否 | 实际成本-总成本 |
+| `estimatedMaterialCost` | BigDecimal | 否 | 预估成本-物料 |
+| `estimatedProduceOrderProcessCost` | BigDecimal | 否 | 预估成本-委外加工 |
+| `estimatedOutWardOrderCost` | BigDecimal | 否 | 预估成本-工序外发 |
+| `estimatedWorkManPieceworkCost` | BigDecimal | 否 | 预估成本-工人计件 |
+| `estimatedOtherCost` | BigDecimal | 否 | 预估成本-其它费用 |
+| `estimatedSumSingleGoodsCost` | BigDecimal | 否 | 预估成本-单件成本 |
+| `estimatedNumber` | BigDecimal | 否 | 预估成本-件数 |
+| `estimatedSumCost` | BigDecimal | 否 | 预估成本-总成本 |
+| `costItem` | CostItem | 否 | 五类成本明细（物料、委外加工、工序外发、工人计件、其它费用） |
+**costItem 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `costItem.materialItems` | List<MaterialCostRow> | 否 | 物料成本明细行 |
+| `costItem.materialTotals` | CostTotals | 否 | 物料成本合计 |
+| `costItem.processItems` | List<CostDetailRow> | 否 | 委外加工成本明细行 |
+| `costItem.processTotals` | CostTotals | 否 | 委外加工成本合计 |
+| `costItem.outwardItems` | List<CostDetailRow> | 否 | 工序外发成本明细行 |
+| `costItem.outwardTotals` | CostTotals | 否 | 工序外发成本合计 |
+| `costItem.pieceworkItems` | List<CostDetailRow> | 否 | 工人计件成本明细行 |
+| `costItem.pieceworkTotals` | CostTotals | 否 | 工人计件成本合计 |
+| `costItem.otherItems` | List<CostDetailRow> | 否 | 其它费用明细行 |
+| `costItem.otherTotals` | CostTotals | 否 | 其它费用合计 |
+**processItems[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `processItems[].name` | String | 否 | 费用名称/工序名称/费用类型 |
+| `processItems[].number` | BigDecimal | 否 | 数量（委外加工=入库数，工序外发=净回收数，工人计件=汇报数） |
+| `processItems[].singleGoodsCost` | BigDecimal | 否 | 实际单件成本 |
+| `processItems[].sumGoodsCost` | BigDecimal | 否 | 实际合计成本 |
+| `processItems[].singleGoodsCostEstimate` | BigDecimal | 否 | 预估单件成本 |
+**materialItems[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `materialItems[].materialImgUrl` | String | 否 | 物料图片 URL |
+| `materialItems[].materialName` | String | 否 | 物料名称 |
+| `materialItems[].materialSn` | String | 否 | 物料货号 |
+| `materialItems[].materialUnit` | String | 否 | 物料单位 |
+| `materialItems[].purchaseAmount` | BigDecimal | 否 | 采购单成本 |
+| `materialItems[].purchaseNumber` | BigDecimal | 否 | 采购已入库数 |
+| `materialItems[].purchaseSinglePrice` | BigDecimal | 否 | 采购单价 |
+| `materialItems[].purchaseSingleGoodsCost` | BigDecimal | 否 | 单件采购成本 |
+| `materialItems[].purchaseSingleGoodsNumber` | BigDecimal | 否 | 单件采购用量 |
+| `materialItems[].sumPurchaseCost` | BigDecimal | 否 | 采购合计成本 |
+| `materialItems[].sumNumber` | BigDecimal | 否 | 实际总用量 |
+| `materialItems[].singleGoodsNumber` | BigDecimal | 否 | 实际单件用量 |
+| `materialItems[].singleStoredPrice` | BigDecimal | 否 | 库存单价 |
+| `materialItems[].singleGoodsCost` | BigDecimal | 否 | 实际单件成本 |
+| `materialItems[].sumGoodsCost` | BigDecimal | 否 | 实际合计成本 |
+| `materialItems[].singleGoodsCostEstimate` | BigDecimal | 否 | 预估单件成本 |
+**materialTotals 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `materialTotals.sumSinglePurchaseGoodsCost` | BigDecimal | 否 | 单件采购成本合计（仅物料类） |
+| `materialTotals.sumProducePurchaseCost` | BigDecimal | 否 | 采购成本合计（仅物料类） |
+| `materialTotals.sumSingleGoodsCost` | BigDecimal | 否 | 单件成本合计（实际） |
+| `materialTotals.sumProduceCost` | BigDecimal | 否 | 成本合计（实际） |
+| `materialTotals.sumSingleGoodsCostEstimate` | BigDecimal | 否 | 单件成本合计（预估） |
+## 数据集：produce-material（物料需求明细（在途与缺口））
+- 命令：`scm-agent data produce-material --from 2026-09-01 --to 2026-09-30 --json`
+- 接口：`GET /api/agent/v1/material-requirement/list`
+- 必填条件：--from 与 --to；跨度不超过 92 天
+> 服务端默认只查用料进行中的行（useState 默认 0），要含已结束的给 --use-state 1。预计用量有两套口径：orderRequirementNumber 按下单数、predictCutBedNumber 按裁床数，汇总时不要混用。
+**常用字段（做统计先看这些，其余字段在下面）**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `ordersSn` | String | 否 | 生产单号 |
+| `goodsSn` | String | 否 | 款号 |
+| `name` | String | 否 | 物料名称 |
+| `sn` | String | 否 | 物料货号 |
+| `colorName` | String | 否 | 颜色 |
+| `useState` | Integer | 否 | 用料状态：0进行中 1已结束 |
+| `isComplete` | Integer | 否 | 齐料状态：0未齐 1齐料 |
+| `orderRequirementNumber` | BigDecimal | 否 | 预计总用量（下单数口径） |
+| `predictCutBedNumber` | BigDecimal | 否 | 预计总用量（裁床数口径） |
+| `produceGoodsSkuAvgNumber` | BigDecimal | 否 | 单件用量 |
+| `purchaseNumber` | BigDecimal | 否 | 采购数 |
+| `purchaseWinNumber` | BigDecimal | 否 | 采购待入库数 |
+**全部字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `ordersSn` | String | 否 | 生产单号 |
+| `produceOrdersSn` | String | 否 | 生产单号（物料占用表关联字段） |
+| `allProduceOrdersSn` | String | 否 | 同物料占用的全部生产单号 |
+| `produceBatchSn` | String | 否 | 生产批次号 |
+| `spoState` | Integer | 否 | 生产单状态 |
+| `businessTime` | String | 否 | 业务日期（yyyy-MM-dd） |
+| `deliveryTime` | String | 否 | 预计交货时间（yyyy-MM-dd） |
+| `goodsId` | Long | 否 | 商品ID |
+| `goodsName` | String | 否 | 商品名称 |
+| `goodsSn` | String | 否 | 款号 |
+| `materialId` | Long | 否 | 物料ID |
+| `materialSkuId` | Long | 否 | 物料单品ID |
+| `imgUrl` | String | 否 | 物料图片 |
+| `name` | String | 否 | 物料名称 |
+| `sn` | String | 否 | 物料货号 |
+| `colorName` | String | 否 | 颜色 |
+| `supplierColor` | String | 否 | 物料色号 |
+| `smTypeName` | String | 否 | 物料类型名（面料/辅料等） |
+| `fabricType` | Integer | 否 | 面料属性：1针织 2梭织 |
+| `skuProperties` | List<SkuPropertyRow> | 否 | 物料单品规格属性 |
+| `useState` | Integer | 否 | 用料状态：0进行中 1已结束 |
+| `isComplete` | Integer | 否 | 齐料状态：0未齐 1齐料 |
+| `issueState` | Integer | 否 | 发料状态：0空 1发料中 2无需发料 3发料结束 |
+| `orderRequirementNumber` | BigDecimal | 否 | 预计总用量（下单数口径） |
+| `predictCutBedNumber` | BigDecimal | 否 | 预计总用量（裁床数口径） |
+| `produceGoodsSkuAvgNumber` | BigDecimal | 否 | 单件用量 |
+| `goodsSkuNumber` | Integer | 否 | 成衣件数 |
+| `purchaseNumber` | BigDecimal | 否 | 采购数 |
+| `purchaseWinNumber` | BigDecimal | 否 | 采购待入库数 |
+| `issueInNumber` | BigDecimal | 否 | 发料数 |
+| `pickedNumber` | BigDecimal | 否 | 已领料数 |
+| `actualUseNumber` | BigDecimal | 否 | 实际用量 |
+| `materialAvailableNumber` | BigDecimal | 否 | 可用库存 |
+| `convertRate` | BigDecimal | 否 | 物料转换系数（采购单位转基础单位） |
+| `purchaseUnitName` | String | 否 | 采购单位 |
+| `baseUnitName` | String | 否 | 基础单位 |
+**skuProperties[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `skuProperties[].propertyName` | String | 否 | 属性名 |
+| `skuProperties[].propertyValue` | String | 否 | 属性值 |
+## 数据集：produce-store-in（生产入库单列表）
+- 命令：`scm-agent data produce-store-in --from 2026-09-01 --to 2026-09-30 --json`
+- 接口：`GET /api/agent/v1/produce-store-in/list`
+- 必填条件：--from 与 --to；跨度不超过 92 天
+> 本节同时覆盖列表（produce-store-in）与详情（produce-store-in-detail）。orderGoods[]（入库商品明细，颜色×尺码×数量）与 processFee（委外加工费）只有详情接口返回；列表里这两个字段为空。供应商字段受权限遮蔽，为空表示当前账号看不到。
+**常用字段（做统计先看这些，其余字段在下面）**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `ordersSn` | String | 否 | 入库单号 |
+| `produceOrdersSn` | String | 否 | 生产单号 |
+| `businessTime` | String | 否 | 业务日期（yyyy-MM-dd） |
+| `state` | Integer | 否 | 单据状态：1草稿 2已入库 4待入库 5部分入库 9已撤销 |
+| `storehouseName` | String | 否 | 入库仓库名称 |
+| `goodsSn` | String | 否 | 款号 |
+| `sumStoreInNumber` | Integer | 否 | 入库数量 |
+| `sumInNumber` | Integer | 否 | 已入库数量 |
+| `sumWinNumber` | Integer | 否 | 待入库数量 |
+| `produceSupplierName` | String | 否 | 生产单供应商/加工厂（无数据权限时为空） |
+| `handler` | String | 否 | 创建人/操作用户 |
+**全部字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `ordersSn` | String | 否 | 入库单号 |
+| `produceOrdersSn` | String | 否 | 生产单号 |
+| `produceBatchSn` | String | 否 | 生产批次号 |
+| `businessTime` | String | 否 | 业务日期（yyyy-MM-dd） |
+| `state` | Integer | 否 | 单据状态：1草稿 2已入库 4待入库 5部分入库 9已撤销 |
+| `storehouseName` | String | 否 | 入库仓库名称 |
+| `goodsSn` | String | 否 | 款号 |
+| `goodsName` | String | 否 | 商品名称 |
+| `sumStoreInNumber` | Integer | 否 | 入库数量 |
+| `sumInNumber` | Integer | 否 | 已入库数量 |
+| `sumWinNumber` | Integer | 否 | 待入库数量 |
+| `produceSupplierName` | String | 否 | 生产单供应商/加工厂（无数据权限时为空） |
+| `produceOrderClientName` | String | 否 | 生产单客户名称 |
+| `supplierName` | String | 否 | 供应商（无数据权限时为空） |
+| `handler` | String | 否 | 创建人/操作用户 |
+| `deliveryTime` | String | 否 | 计划交货时间（yyyy-MM-dd） |
+| `productionGroupName` | String | 否 | 生产组名称 |
+| `produceOrderType` | Integer | 否 | 生产单类型 |
+| `processFee` | BigDecimal | 否 | 委外加工费（详情接口） |
+| `orderGoods` | List<GoodsRow> | 否 | 入库商品明细（详情接口） |
+**orderGoods[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `orderGoods[].goodsSn` | String | 否 | 款号 |
+| `orderGoods[].goodsName` | String | 否 | 商品名称 |
+| `orderGoods[].colorName` | String | 否 | 颜色 |
+| `orderGoods[].sizeName` | String | 否 | 尺码 |
+| `orderGoods[].number` | Integer | 否 | 数量 |
+| `orderGoods[].winNumber` | Integer | 否 | 待入库数量 |
+| `orderGoods[].waitStoreInNumber` | Integer | 否 | 待入库数量（新逻辑） |
+| `orderGoods[].price` | BigDecimal | 否 | 委外加工单价 |
+## 数据集：store-in-statistics（成品入库统计（按业务日期，行级含颜色尺码与金额））
+- 命令：`scm-agent data store-in-statistics --from 2026-09-01 --to 2026-09-30 --json`
+- 接口：`GET /api/agent/v1/statistics/store-in-goods`
+- 必填条件：--from 与 --to；跨度不超过 92 天
+> 一行是一条入库记录的一个单品。businessItem 是业务类型枚举（1生产入库 2调拨入库 3次品返厂 76出库退货），按类型汇总时先按它分组。生产入库行的实际加工厂优先看嵌套 produceOrders 里的供应商。
+**常用字段（做统计先看这些，其余字段在下面）**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `businessItem` | Integer | 否 | 业务类型：1生产入库 2调拨入库 3次品返厂入库 76出库退货 |
+| `ordersSn` | String | 否 | 单号 |
+| `goodsSn` | String | 否 | 商品货号 |
+| `skuColorName` | String | 否 | 颜色 |
+| `skuSizeName` | String | 否 | 尺码 |
+| `number` | Integer | 否 | 入库数 |
+| `storehouseName` | String | 否 | 入库仓库 |
+| `supplierName` | String | 否 | 加工厂/供应商（行级；生产入库、次品返厂的实际加工厂优先看 produceOrders 内的供应商） |
+| `amount` | BigDecimal | 否 | 金额 |
+| `businessTime` | String | 否 | 入库业务日期（yyyy-MM-dd） |
+**全部字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `businessItem` | Integer | 否 | 业务类型：1生产入库 2调拨入库 3次品返厂入库 76出库退货 |
+| `ordersSn` | String | 否 | 单号 |
+| `businessSn` | String | 否 | 关联业务单号 |
+| `produceOrders` | List<ProduceRow> | 否 | 关联生产单列表 |
+| `bedNumbers` | List<String> | 否 | 床次列表 |
+| `imgUrl` | String | 否 | 单品图 URL |
+| `goodsName` | String | 否 | 商品名称 |
+| `goodsSn` | String | 否 | 商品货号 |
+| `firstGoodsCategoryName` | String | 否 | 一级分类 |
+| `skuColorName` | String | 否 | 颜色 |
+| `skuSizeName` | String | 否 | 尺码 |
+| `number` | Integer | 否 | 入库数 |
+| `storehouseName` | String | 否 | 入库仓库 |
+| `settlementMethod` | Integer | 否 | 结算方式：1现结 2日结 3周结 4半月结 5月结 6季结 7年结 8单结 9其他 |
+| `remark` | String | 否 | 备注 |
+| `producePrice` | BigDecimal | 否 | 委外加工费/采购单价 |
+| `supplierName` | String | 否 | 加工厂/供应商（行级；生产入库、次品返厂的实际加工厂优先看 produceOrders 内的供应商） |
+| `productionGroupName` | String | 否 | 生产组 |
+| `amount` | BigDecimal | 否 | 金额 |
+| `accountName` | String | 否 | 结算账户 |
+| `businessTime` | String | 否 | 入库业务日期（yyyy-MM-dd） |
+| `createTime` | String | 否 | 创建日期（yyyy-MM-dd） |
+| `handlerName` | String | 否 | 创建人 |
+**produceOrders[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `produceOrders[].ordersSn` | String | 否 | 生产单号 |
+| `produceOrders[].produceBatchSn` | String | 否 | 生产批次号 |
+| `produceOrders[].type` | Integer | 否 | 生产类型：1自主生产 2单工序外发 3委外加工 4成品采购 |
+| `produceOrders[].clientName` | String | 否 | 客户名称 |
+| `produceOrders[].orderTypeName` | String | 否 | 订单类型名称 |
+| `produceOrders[].supplierName` | String | 否 | 加工厂/供应商名称 |
+## 数据集：ticket-statistics（菲票统计明细（含领包人与部门））
+- 命令：`scm-agent data ticket-statistics --from 2026-09-01 --to 2026-09-30 --json`
+- 接口：`GET /api/agent/v1/ticket/statistics`
+- 必填条件：--from 与 --to；跨度不超过 92 天
+> 服务端默认只查已领包（lendPackageState 默认 1），要未领包的给 --lend-package-state 0。ticketState 1 视为已交货。每行还内嵌工序进度 workProcessProgress[]，按工序统计时才展开。
+**常用字段（做统计先看这些，其余字段在下面）**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `ticketSn` | String | 否 | 菲票号 |
+| `produceOrdersSn` | String | 否 | 生产单号 |
+| `goodsSn` | String | 否 | 商品货号 |
+| `lendPackageUserName` | String | 否 | 领包人 |
+| `departmentName` | String | 否 | 直属部门 |
+| `totalNumber` | Integer | 否 | 领货数量（菲票件数） |
+| `ticketState` | Integer | 否 | 扫菲节点：0未完成 1已完成（已完成视为已交货） |
+| `workProcessName` | String | 否 | 当前节点名称 |
+**全部字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `ticketSn` | String | 否 | 菲票号 |
+| `bundleSn` | String | 否 | 扎号 |
+| `produceOrdersSn` | String | 否 | 生产单号 |
+| `produceBatchSn` | String | 否 | 生产批次号 |
+| `bedNumber` | String | 否 | 床次 |
+| `goodsSn` | String | 否 | 商品货号 |
+| `goodsName` | String | 否 | 商品名称 |
+| `colorName` | String | 否 | 颜色 |
+| `sizeName` | String | 否 | 尺码 |
+| `lendPackageUserId` | Long | 否 | 领包人ID |
+| `lendPackageUserName` | String | 否 | 领包人 |
+| `departmentId` | Long | 否 | 直属部门ID |
+| `departmentName` | String | 否 | 直属部门 |
+| `totalNumber` | Integer | 否 | 领货数量（菲票件数） |
+| `ticketState` | Integer | 否 | 扫菲节点：0未完成 1已完成（已完成视为已交货） |
+| `workProcessName` | String | 否 | 当前节点名称 |
+| `workProcessProgress` | List<ProcessRow> | 否 | 工序进度列表（含扫菲汇报记录） |
+**workProcessProgress[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `workProcessProgress[].workProcessId` | Long | 否 | 工序ID |
+| `workProcessProgress[].workProcessName` | String | 否 | 工序名称 |
+| `workProcessProgress[].ticketNumber` | Integer | 否 | 菲票件数 |
+| `workProcessProgress[].reportNumber` | BigDecimal | 否 | 汇报数量 |
+| `workProcessProgress[].progress` | BigDecimal | 否 | 进度百分比 |
+| `workProcessProgress[].reports` | List<ReportRow> | 否 | 扫菲汇报记录 |
+**reports[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `reports[].businessTime` | String | 否 | 汇报业务日期（yyyy-MM-dd） |
+| `reports[].createTime` | String | 否 | 记录创建日期（yyyy-MM-dd） |
+| `reports[].number` | BigDecimal | 否 | 汇报数量 |
+| `reports[].businessUser` | String | 否 | 汇报人 |
+## 数据集：factory-evaluation（工厂评估（按加工厂聚合单数、裁床数、完成件数、按时交货率）
+- 命令：`scm-agent data factory-evaluation --from 2026-09-01 --to 2026-09-30 --json`
+- 接口：`GET /api/agent/v1/report/factory-evaluation`
+- 必填条件：--from 与 --to；跨度不超过 92 天
+> 服务端已经按加工厂聚合好，一行一个加工厂，不需要再自己分组。到期判断以真实今天为准（即使查询窗口是历史区间）；没有已到期生产单时按时交货率为空，不是 0。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `factory` | String | 否 | 加工厂名称（生产单未填写供应商时为“未填写加工厂”） |
+| `orders` | Integer | 否 | 生产单数 |
+| `sumNumber` | Integer | 否 | 下单数合计 |
+| `sumCutBedNumber` | BigDecimal | 否 | 裁床数合计 |
+| `produceStoreInNumber` | Integer | 否 | 完成件数（生产入库单口径） |
+| `produceInNumber` | Integer | 否 | 完成件数（成品入库口径） |
+| `dueOrders` | Integer | 否 | 已到期生产单数（预计交货日期早于统计日） |
+| `onTimeOrders` | Integer | 否 | 按时交货生产单数 |
+| `onTimeRate` | BigDecimal | 否 | 按时交货率（百分比，保留两位小数；无已到期生产单时为 null） |
+## 数据集：supplier-list（供应商名录（对账的第一步：先取供应商 id））
+- 命令：`scm-agent data supplier-list --json`
+- 接口：`GET /api/agent/v1/supplier/list`
+- 必填条件：无
+> 对账的第一步：先按名称找到供应商，取 id 再查 supplier-balance。supplierType 是可组合的数字（0 物料供应商、1 加工厂）。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 供应商id |
+| `supplierName` | String | 否 | 供应商名称 |
+| `supplierType` | String | 否 | 供应商类型：包含0-物料供应商，包含1-加工厂，可组合 |
+| `status` | Integer | 否 | 状态：1-启用 2-停用 |
+| `cellphone` | String | 否 | 联系电话 |
+| `address` | String | 否 | 地址 |
+| `remark` | String | 否 | 备注 |
+## 数据集：supplier-balance（单供应商对账数据（11 表结构，单条）
+- 命令：`scm-agent data supplier-balance --supplier-id 88 --from 2026-09-01 --to 2026-09-30 --json`
+- 接口：`GET /api/agent/v1/supplier/balance-record`
+- 必填条件：--supplier-id 与 --from 与 --to；跨度不超过 92 天
+> 单条接口，返回 11 张表。顶层字段就是表名：shareSum 是对账周期汇总（本期应付/实付/欠款），lstType 是按业务类型的汇总，其余 9 张是明细。欠款字段（debtAmount、endDebtAmount）受权限遮蔽，为空表示当前账号看不到，不要当 0 统计。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `shareSum` | ShareSum | 否 | 对账周期汇总 |
+| `lstType` | List<TypeRow> | 否 | 按业务类型的应付/实付汇总 |
+| `lstOutWard` | List<OutWardRow> | 否 | 外发工序加工明细-发出 |
+| `lstOutWardRecover` | List<OutWardRow> | 否 | 外发工序加工明细-完成回收 |
+| `lstProcess` | List<ProcessRow> | 否 | 委外加工入库、成品采购入库明细 |
+| `lstRework` | List<ReworkRow> | 否 | 次品返厂明细 |
+| `lstRepairDeduction` | List<RepairRow> | 否 | 返修关联加工厂明细 |
+| `lstPurchaseOrderDetail` | List<PurchaseRow> | 否 | 物料采购明细（按采购金额SKU） |
+| `lstPurchaseDetail` | List<PurchaseRow> | 否 | 物料采购入库明细（按物料单品） |
+| `lstRefundDetail` | List<RefundRow> | 否 | 物料采购退货出库明细 |
+| `lstPay` | List<PayRow> | 否 | 收款、付款明细（accountItemId=5 的行是优惠金额） |
+| `lstSupplierAccount` | List<AccountRow> | 否 | 应收记账、应付记账明细 |
+**shareSum 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `shareSum.needAmount` | BigDecimal | 否 | 本期应付金额 |
+| `shareSum.realAmount` | BigDecimal | 否 | 本期实付金额 |
+| `shareSum.debtAmount` | BigDecimal | 否 | 本期欠款（无欠款查看权限时为空） |
+| `shareSum.initDebtAmount` | BigDecimal | 否 | 期初欠款 |
+| `shareSum.endDebtAmount` | BigDecimal | 否 | 期末欠款（无欠款查看权限时为空） |
+**lstType[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `lstType[].typeName` | String | 否 | 类型名称 |
+| `lstType[].needAmount` | BigDecimal | 否 | 应付金额 |
+| `lstType[].realAmount` | BigDecimal | 否 | 实付金额 |
+**lstOutWard[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `lstOutWard[].date` | String | 否 | 日期 |
+| `lstOutWard[].produceOrdersKey` | String | 否 | 生产单/批次号 |
+| `lstOutWard[].businessSn` | String | 否 | 生产单号 |
+| `lstOutWard[].goodsSn` | String | 否 | 款式 |
+| `lstOutWard[].goodsName` | String | 否 | 商品名称 |
+| `lstOutWard[].categoryName` | String | 否 | 一级分类 |
+| `lstOutWard[].colorName` | String | 否 | 颜色 |
+| `lstOutWard[].sizeName` | String | 否 | 尺码 |
+| `lstOutWard[].processNames` | String | 否 | 工序 |
+| `lstOutWard[].outWardRemark` | String | 否 | 外发备注 |
+| `lstOutWard[].recoverRemark` | String | 否 | 回收备注 |
+| `lstOutWard[].outWardNumber` | BigDecimal | 否 | 发出数 |
+| `lstOutWard[].recoverNumber` | BigDecimal | 否 | 已收回数 |
+| `lstOutWard[].repairDeductNumber` | BigDecimal | 否 | 返修扣减 |
+| `lstOutWard[].businessItemDesc` | String | 否 | 完成类型 |
+| `lstOutWard[].businessKey` | String | 否 | 完成单号 |
+| `lstOutWard[].price` | BigDecimal | 否 | 单价 |
+| `lstOutWard[].needAmount` | BigDecimal | 否 | 应付金额 |
+| `lstOutWard[].statementStateStr` | String | 否 | 结算情况 |
+| `lstOutWard[].recordState` | Integer | 否 | 对账状态：1-未对账 2-已对账 |
+| `lstOutWard[].recordRemark` | String | 否 | 备注（对账备注） |
+| `lstOutWard[].goodsImgUrl` | String | 否 | 商品主图地址 |
+**lstProcess[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `lstProcess[].date` | String | 否 | 日期 |
+| `lstProcess[].businessSn` | String | 否 | 入库单 |
+| `lstProcess[].produceOrdersKey` | String | 否 | 生产单/批次号 |
+| `lstProcess[].produceOrdersSn` | String | 否 | 生产单号 |
+| `lstProcess[].goodsSn` | String | 否 | 款式 |
+| `lstProcess[].goodsName` | String | 否 | 商品名称 |
+| `lstProcess[].categoryName` | String | 否 | 一级分类 |
+| `lstProcess[].colorName` | String | 否 | 颜色 |
+| `lstProcess[].sizeName` | String | 否 | 尺码 |
+| `lstProcess[].number` | Integer | 否 | 入库数 |
+| `lstProcess[].storehouseName` | String | 否 | 入库仓库 |
+| `lstProcess[].businessRemark` | String | 否 | 成品入库单备注 |
+| `lstProcess[].remark` | String | 否 | 入库单备注 |
+| `lstProcess[].price` | BigDecimal | 否 | 单价 |
+| `lstProcess[].needAmount` | BigDecimal | 否 | 应付金额 |
+| `lstProcess[].statementStateStr` | String | 否 | 结算情况 |
+| `lstProcess[].recordState` | Integer | 否 | 对账状态：1-未对账 2-已对账 |
+| `lstProcess[].recordRemark` | String | 否 | 备注（对账备注） |
+| `lstProcess[].handlerName` | String | 否 | 创建人 |
+**lstRework[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `lstRework[].date` | String | 否 | 日期 |
+| `lstRework[].ordersSn` | String | 否 | 次品返厂单 |
+| `lstRework[].goodsStoreInOrdersSn` | String | 否 | 入库单 |
+| `lstRework[].produceOrdersKey` | String | 否 | 生产单/批次号 |
+| `lstRework[].produceOrdersSn` | String | 否 | 生产单号 |
+| `lstRework[].goodsSn` | String | 否 | 款式 |
+| `lstRework[].goodsName` | String | 否 | 商品名称 |
+| `lstRework[].categoryName` | String | 否 | 一级分类 |
+| `lstRework[].colorName` | String | 否 | 颜色 |
+| `lstRework[].sizeName` | String | 否 | 尺码 |
+| `lstRework[].price` | BigDecimal | 否 | 单价 |
+| `lstRework[].businessRemark` | String | 否 | 成品入库单备注 |
+| `lstRework[].remark` | String | 否 | 返厂单备注 |
+| `lstRework[].illustrate` | String | 否 | 说明 |
+| `lstRework[].number` | BigDecimal | 否 | 数量 |
+| `lstRework[].needAmount` | BigDecimal | 否 | 应付金额 |
+| `lstRework[].statementStateStr` | String | 否 | 结算情况 |
+| `lstRework[].recordState` | Integer | 否 | 对账状态：1-未对账 2-已对账 |
+| `lstRework[].recordRemark` | String | 否 | 备注（对账备注） |
+| `lstRework[].handlerName` | String | 否 | 创建人 |
+**lstRepairDeduction[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `lstRepairDeduction[].date` | String | 否 | 日期 |
+| `lstRepairDeduction[].ordersSn` | String | 否 | 质检单（次品返修单） |
+| `lstRepairDeduction[].produceOrdersSn` | String | 否 | 生产单号 |
+| `lstRepairDeduction[].produceOrdersKey` | String | 否 | 生产单/批次号 |
+| `lstRepairDeduction[].goodsSn` | String | 否 | 款式 |
+| `lstRepairDeduction[].goodsName` | String | 否 | 商品名称 |
+| `lstRepairDeduction[].colorName` | String | 否 | 颜色 |
+| `lstRepairDeduction[].sizeName` | String | 否 | 尺码 |
+| `lstRepairDeduction[].price` | BigDecimal | 否 | 单价 |
+| `lstRepairDeduction[].businessRemark` | String | 否 | 质检单备注 |
+| `lstRepairDeduction[].number` | Integer | 否 | 数量 |
+| `lstRepairDeduction[].needAmount` | BigDecimal | 否 | 应付金额 |
+| `lstRepairDeduction[].statementStateStr` | String | 否 | 结算情况 |
+| `lstRepairDeduction[].recordState` | Integer | 否 | 对账状态：1-未对账 2-已对账 |
+| `lstRepairDeduction[].remark` | String | 否 | 备注（对账备注） |
+| `lstRepairDeduction[].createTime` | Timestamp | 否 | 创建时间 |
+| `lstRepairDeduction[].handlerName` | String | 否 | 创建人 |
+**lstPurchaseOrderDetail[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `lstPurchaseOrderDetail[].date` | String | 否 | 日期 |
+| `lstPurchaseOrderDetail[].businessSn` | String | 否 | 采购单/采购入库单 |
+| `lstPurchaseOrderDetail[].materialPurchaseOrderSn` | String | 否 | 物料采购单号 |
+| `lstPurchaseOrderDetail[].produceOrdersSn` | String | 否 | 生产单号 |
+| `lstPurchaseOrderDetail[].produceBatchSn` | String | 否 | 生产批次号 |
+| `lstPurchaseOrderDetail[].goodsSn` | String | 否 | 款式 |
+| `lstPurchaseOrderDetail[].goodsName` | String | 否 | 商品名称 |
+| `lstPurchaseOrderDetail[].materialName` | String | 否 | 物料 |
+| `lstPurchaseOrderDetail[].materialSkuId` | Long | 否 | 物料单品id |
+| `lstPurchaseOrderDetail[].materialSn` | String | 否 | 货号 |
+| `lstPurchaseOrderDetail[].colorName` | String | 否 | 颜色 |
+| `lstPurchaseOrderDetail[].propertyValueNameStr` | String | 否 | 规格 |
+| `lstPurchaseOrderDetail[].purchasePrice` | BigDecimal | 否 | 采购单价 |
+| `lstPurchaseOrderDetail[].purchaseRealPrice` | BigDecimal | 否 | 抹零后采购单价 |
+| `lstPurchaseOrderDetail[].purchaseNumber` | BigDecimal | 否 | 基础采购数 |
+| `lstPurchaseOrderDetail[].purchaseUnitNumber` | BigDecimal | 否 | 采购单位采购数 |
+| `lstPurchaseOrderDetail[].purchaseUnitName` | String | 否 | 采购单位 |
+| `lstPurchaseOrderDetail[].purchaseStoreInNumber` | BigDecimal | 否 | 采购单位对应入库数 |
+| `lstPurchaseOrderDetail[].number` | BigDecimal | 否 | 基础入库数 |
+| `lstPurchaseOrderDetail[].price` | BigDecimal | 否 | 基础单价（折后） |
+| `lstPurchaseOrderDetail[].basePrice` | BigDecimal | 否 | 基础单价（折前） |
+| `lstPurchaseOrderDetail[].baseUnitName` | String | 否 | 基础单位 |
+| `lstPurchaseOrderDetail[].convertRate` | BigDecimal | 否 | 转换系数 |
+| `lstPurchaseOrderDetail[].needAmount` | BigDecimal | 否 | 应付金额 |
+| `lstPurchaseOrderDetail[].remark` | String | 否 | 采购单备注 |
+| `lstPurchaseOrderDetail[].materialStoreInRemark` | String | 否 | 物料入库单备注 |
+| `lstPurchaseOrderDetail[].expectTime` | Timestamp | 否 | 预计到料日期 |
+| `lstPurchaseOrderDetail[].createTime` | Timestamp | 否 | 创建时间 |
+| `lstPurchaseOrderDetail[].supplierSn` | String | 否 | 供应商单号 |
+| `lstPurchaseOrderDetail[].statementStateStr` | String | 否 | 结算情况 |
+| `lstPurchaseOrderDetail[].recordState` | Integer | 否 | 对账状态：1-未对账 2-已对账 |
+| `lstPurchaseOrderDetail[].recordRemark` | String | 否 | 备注（对账备注） |
+**lstRefundDetail[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `lstRefundDetail[].date` | String | 否 | 日期 |
+| `lstRefundDetail[].businessSn` | String | 否 | 退货出库单 |
+| `lstRefundDetail[].materialName` | String | 否 | 物料 |
+| `lstRefundDetail[].materialSkuId` | Long | 否 | 物料单品id |
+| `lstRefundDetail[].materialSn` | String | 否 | 货号 |
+| `lstRefundDetail[].colorName` | String | 否 | 颜色 |
+| `lstRefundDetail[].propertyValueNameStr` | String | 否 | 规格 |
+| `lstRefundDetail[].purchaseRefundPrice` | BigDecimal | 否 | 单价（采购退货单价） |
+| `lstRefundDetail[].purchaseStoreOutNumber` | BigDecimal | 否 | 出库数（采购退货单位） |
+| `lstRefundDetail[].purchaseRefundUnitName` | String | 否 | 退货单位 |
+| `lstRefundDetail[].needAmount` | BigDecimal | 否 | 应收金额 |
+| `lstRefundDetail[].price` | BigDecimal | 否 | 基础单价 |
+| `lstRefundDetail[].number` | BigDecimal | 否 | 基础出库数 |
+| `lstRefundDetail[].baseUnitName` | String | 否 | 基础单位 |
+| `lstRefundDetail[].convertRate` | BigDecimal | 否 | 转换系数 |
+| `lstRefundDetail[].remark` | String | 否 | 退货单备注 |
+| `lstRefundDetail[].materialStoreOutRemark` | String | 否 | 出库单备注 |
+| `lstRefundDetail[].statementStateStr` | String | 否 | 结算情况 |
+| `lstRefundDetail[].recordState` | Integer | 否 | 对账状态：1-未对账 2-已对账 |
+| `lstRefundDetail[].recordRemark` | String | 否 | 备注（对账备注） |
+**lstPay[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `lstPay[].date` | String | 否 | 日期 |
+| `lstPay[].businessItem` | String | 否 | 业务类型 |
+| `lstPay[].accountItemId` | Long | 否 | 账目类型id（5-优惠金额） |
+| `lstPay[].accountItemName` | String | 否 | 账目类型名称 |
+| `lstPay[].businessSn` | String | 否 | 单号 |
+| `lstPay[].realAmount` | BigDecimal | 否 | 付款金额 |
+| `lstPay[].needAmount` | BigDecimal | 否 | 应付金额（优惠行取绝对值） |
+| `lstPay[].remark` | String | 否 | 备注 |
+| `lstPay[].businessRemark` | String | 否 | 单据备注 |
+| `lstPay[].statementStateStr` | String | 否 | 结算情况 |
+| `lstPay[].recordState` | Integer | 否 | 对账状态：1-未对账 2-已对账 |
+| `lstPay[].recordRemark` | String | 否 | 备注（对账备注） |
+**lstSupplierAccount[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `lstSupplierAccount[].date` | String | 否 | 日期 |
+| `lstSupplierAccount[].businessItem` | String | 否 | 业务类型 |
+| `lstSupplierAccount[].accountItemName` | String | 否 | 账目类型 |
+| `lstSupplierAccount[].businessSn` | String | 否 | 单号 |
+| `lstSupplierAccount[].produceOrdersKey` | String | 否 | 生产单/批次号（多个生产批次时见 produceBatchSnList） |
+| `lstSupplierAccount[].produceBatchSnList` | List<ProduceBatchRow> | 否 | 关联的生产批次列表 |
+| `lstSupplierAccount[].needAmount` | BigDecimal | 否 | 应付金额 |
+| `lstSupplierAccount[].payWayStr` | String | 否 | 付款方式 |
+| `lstSupplierAccount[].payerName` | String | 否 | 代付人 |
+| `lstSupplierAccount[].feeReimbursementOrdersSn` | String | 否 | 报销单 |
+| `lstSupplierAccount[].feeReimbursementOrderState` | Integer | 否 | 报销单状态 |
+| `lstSupplierAccount[].statementStateStr` | String | 否 | 结算情况 |
+| `lstSupplierAccount[].recordState` | Integer | 否 | 对账状态：1-未对账 2-已对账 |
+| `lstSupplierAccount[].handlerName` | String | 否 | 创建人 |
+| `lstSupplierAccount[].remark` | String | 否 | 备注 |
+**produceBatchSnList[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `produceBatchSnList[].ordersSn` | String | 否 | 生产单/批次号 |
+| `produceBatchSnList[].goodsName` | String | 否 | 商品名称 |
+| `produceBatchSnList[].goodsSn` | String | 否 | 货号 |
+## 数据集：work-processes（生产单工序节点列表（含预计与实际时间、汇报次数））
+- 命令：`scm-agent data work-processes --sn SC202609010001 --json`
+- 接口：`GET /api/agent/v1/produce/work-processes`
+- 必填条件：--sn
+> id 是工序节点主键，继续查 work-process-detail 用它。core=2 是裁床工序。
+**常用字段（做统计先看这些，其余字段在下面）**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 工序节点ID |
+| `workProcessName` | String | 否 | 工序名称 |
+| `core` | Integer | 否 | 关键工序标识：1无 2裁床 3生产完成 4车间生产 5尾部 6纸样 |
+| `state` | Integer | 否 | 工序状态：1未完成 2完成 |
+| `progress` | BigDecimal | 否 | 进度百分比 |
+| `produceNumber` | Integer | 否 | 目标生产数量 |
+| `reportNumber` | BigDecimal | 否 | 已汇报数量 |
+| `beginTime` | String | 否 | 实际开始时间（yyyy-MM-dd） |
+| `endTime` | String | 否 | 实际结束时间（yyyy-MM-dd） |
+| `factoryName` | String | 否 | 加工厂 |
+**全部字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `id` | Long | 否 | 工序节点ID |
+| `ordersSn` | String | 否 | 生产单号 |
+| `workProcessName` | String | 否 | 工序名称 |
+| `workProcessGroupName` | String | 否 | 工序分组名称 |
+| `core` | Integer | 否 | 关键工序标识：1无 2裁床 3生产完成 4车间生产 5尾部 6纸样 |
+| `state` | Integer | 否 | 工序状态：1未完成 2完成 |
+| `actualState` | Integer | 否 | 工序实际状态：3进行中 |
+| `progress` | BigDecimal | 否 | 进度百分比 |
+| `produceNumber` | Integer | 否 | 目标生产数量 |
+| `reportNumber` | BigDecimal | 否 | 已汇报数量 |
+| `reportTimes` | Integer | 否 | 汇报次数 |
+| `estimateBeginTime` | String | 否 | 预计开始时间（yyyy-MM-dd） |
+| `estimateFinishTime` | String | 否 | 预计完成时间（yyyy-MM-dd） |
+| `beginTime` | String | 否 | 实际开始时间（yyyy-MM-dd） |
+| `endTime` | String | 否 | 实际结束时间（yyyy-MM-dd） |
+| `factoryName` | String | 否 | 加工厂 |
+## 数据集：work-process-detail（单个工序节点的汇报记录（单条）
+- 命令：`scm-agent data work-process-detail --work-process-id 123456 --json`
+- 接口：`GET /api/agent/v1/produce/work-process-detail`
+- 必填条件：--work-process-id
+> 单条接口。汇报记录在嵌套 reportRecords[] 里（汇报人、时间、数量、方式与来源的枚举都在该行）。顶层 workProcess 字段就是「数据集：work-processes」那一节的行结构，字段含义去那里查。
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `ordersSn` | String | 否 | 生产单号 |
+| `goodsSn` | String | 否 | 款号 |
+| `goodsName` | String | 否 | 商品名称 |
+| `workProcess` | AgentWorkProcessDTO | 否 | 工序节点 |
+| `reportRecords` | List<ReportRow> | 否 | 汇报记录（按接口返回顺序） |
+**reportRecords[] 的字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `reportRecords[].businessTime` | String | 否 | 汇报业务时间（yyyy-MM-dd HH:mm:ss） |
+| `reportRecords[].createTime` | String | 否 | 汇报记录创建时间（yyyy-MM-dd HH:mm:ss） |
+| `reportRecords[].handler` | String | 否 | 汇报人 |
+| `reportRecords[].bedNumber` | String | 否 | 床次 |
+| `reportRecords[].sumNumber` | BigDecimal | 否 | 汇总数量（汇总总数/整体汇报总数） |
+| `reportRecords[].totalReportNumber` | BigDecimal | 否 | 汇报数量，整体汇报用 |
+| `reportRecords[].reportWay` | Integer | 否 | 汇报方式 1-汇报整体数量 2-分色码汇报数量 3-整体完成 |
+| `reportRecords[].type` | Integer | 否 | 汇报来源 1-手工填写 2-扫菲 3-外发回收 4-编菲汇报 5-返修扣减 |
+| `reportRecords[].remark` | String | 否 | 备注 |
+## 数据集：material-data（批量物料占用与使用状态（最多 20 个生产单）
+- 命令：`scm-agent data material-data --sns SC001,SC002 --json`
+- 接口：`GET /api/agent/v1/produce/material-data`
+- 必填条件：--sns；最多 20 个单号
+> 行里只有物料 id（materialId、materialSkuId），没有物料名称；需要名称时用 produce detail 的 materialList 按 id 关联。缺料与占用都有「按下单数 / 按裁床数」两套口径，与 produce-material 的口径对应。
+**常用字段（做统计先看这些，其余字段在下面）**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `produceOrdersSn` | String | 否 | 生产单号 |
+| `state` | Integer | 否 | 使用状态：0进行中 1已结束 |
+| `orderRequirementNumber` | BigDecimal | 否 | 预计总用量（下单数口径） |
+| `predictCutBedNumber` | BigDecimal | 否 | 预计总用量（裁床数口径） |
+| `purchaseNumber` | BigDecimal | 否 | 采购数 |
+| `purchaseWinNumber` | BigDecimal | 否 | 采购待入库数 |
+| `pickedNumber` | BigDecimal | 否 | 已领料数 |
+| `actualUseNumber` | BigDecimal | 否 | 实际用量 |
+| `lackNumberByOrderNumber` | BigDecimal | 否 | 本单缺料（按下单数） |
+| `planPurchaseOrderNumber` | BigDecimal | 否 | 建议采购数（按下单数） |
+**全部字段**
+| 字段 | 类型 | 必填 | 含义 |
+|---|---|---|---|
+| `produceOrdersSn` | String | 否 | 生产单号 |
+| `materialId` | Long | 否 | 物料ID |
+| `materialSkuId` | Long | 否 | 物料单品ID |
+| `state` | Integer | 否 | 使用状态：0进行中 1已结束 |
+| `orderRequirementNumber` | BigDecimal | 否 | 预计总用量（下单数口径） |
+| `predictCutBedNumber` | BigDecimal | 否 | 预计总用量（裁床数口径） |
+| `purchaseNumber` | BigDecimal | 否 | 采购数 |
+| `purchaseWinNumber` | BigDecimal | 否 | 采购待入库数 |
+| `pickedNumber` | BigDecimal | 否 | 已领料数 |
+| `actualUseNumber` | BigDecimal | 否 | 实际用量 |
+| `materialAvailableNumber` | BigDecimal | 否 | 可用库存 |
+| `lackNumberByOrderNumber` | BigDecimal | 否 | 本单缺料（按下单数） |
+| `lackNumberByCutBedNumber` | BigDecimal | 否 | 本单缺料（按裁床数） |
+| `occupationByOrderNumber` | BigDecimal | 否 | 本单临时占用（按下单数） |
+| `occupationByCutBedNumber` | BigDecimal | 否 | 本单临时占用（按裁床数） |
+| `otherOccupationOrderNumber` | BigDecimal | 否 | 其他单占用（按下单数） |
+| `otherOccupationCutBedNumber` | BigDecimal | 否 | 其他单占用（按裁床数） |
+| `planPurchaseOrderNumber` | BigDecimal | 否 | 建议采购数（按下单数） |
+| `planPurchaseCutBedNumber` | BigDecimal | 否 | 建议采购数（按裁床数） |
+## 附录：两条通道的边界
+本文字典覆盖两部分接口：前半部分是 CLI 命令直接可达的端点，后半部分（标题带「数据集：」）
+是 `scm-agent data` 命令的数据集。原来只给官方报表内部使用的 16 个报表数据接口已经全部
+通过 `data` 命令开放，因此不再有「AI 调不到的接口」清单。
+`/me` 与 `/token` 由 `status`、`login` 命令在内部使用，不返回业务数据，不在本字典范围内。
+官方报表（`scm-agent report`）与 `data` 命令调用的是同一批接口：报表一次拉全量并组装成
+固定格式的文件；`data` 一次只取一页，让 AI 按用户口径自己算。两条通道的权限、限流
+（每 Key 每分钟 30 次、每天 600 次）完全相同。