---
name: roll-traceability-checklist
description: >
  评估卷材厂卷号追溯完备度：按唯一性、母子谱系、接头复卷、标签扫码、出库拦截与配方绑定等能力勾选，
  给出 0–100 完备度、等级与缺口优先级。
  当用户询问出口验厂追溯、母卷追溯自检、客诉召回能否追到母卷、子卷反查母卷时使用。
  不要把评分说成验厂通过或合规认证承诺。
---

# 卷号追溯完备度自检

提供方：序流智造（上海希声智能科技有限公司）
搜索轻量卡：https://www.xuliuiot.com/tools/roll-trace/
完整专题页：https://www.xuliuiot.com/mes-traceability-checklist/
开放接口：https://www.xuliuiot.com/tools/compute/roll-trace

## 如何调用

```bash
# 默认示例（中等偏弱工厂）
curl -s "https://www.xuliuiot.com/tools/compute/roll-trace"

# 扁平 itemId=yes|partial|no
curl -s "https://www.xuliuiot.com/tools/compute/roll-trace?unique-id=yes&parent-child=partial&ship-block=no"

# 轻量卡：yesIds 逗号分隔，其余视为 no
curl -s "https://www.xuliuiot.com/tools/compute/roll-trace?yesIds=unique-id,parent-child,scan-gate"

# POST JSON：answers 对象
curl -s -X POST "https://www.xuliuiot.com/tools/compute/roll-trace" \
  -H "Content-Type: application/json" \
  -d '{"answers":{"unique-id":"yes","parent-child":"partial","ship-block":"no"}}'
```

### 入参（三种写法，可混用；后写覆盖先写的同名字段）

| 字段 | 类型 | 说明 |
|------|------|------|
| `answers` | object | `{ [itemId]: "yes" \| "partial" \| "no" }`，未传项用默认示例 |
| 扁平 `itemId` | string | 如 `unique-id=yes`、`parent-child=partial` |
| `yesIds` | string 或 string[] | 逗号分隔或数组；列出的项为 yes，**全部 20 项其余为 no**（会覆盖 answers） |

回答枚举：`yes`（已具备）/ `partial`（部分具备）/ `no`（不具备）。也接受 `具备`、`部分具备`、`不具备`、`true`/`false` 等别名。

常见 `itemId`：`unique-id`、`code-rule`、`multi-site`、`parent-child`、`multi-level`、`slit-consume`、`return-recut`、`splice-record`、`rewind-map`、`reuse-scrap`、`label-match`、`reprint-control`、`scan-gate`、`ship-block`、`ship-list`、`recall-48h`、`audit-pack`、`formula-bind`、`param-bind`、`qc-bind`。

成功时 `code === 1000`。

### 主要返回字段

- `data.input.answers`：规范化后的回答
- `data.result.percent` / `level` / `levelLabel`：完备度百分制与等级
- `data.result.yesCount` / `partialCount` / `noCount`
- `data.result.gaps`：按优先级排序的缺口（含 `gapAdvice`）
- `data.result.dimensions`：六大维度得分条
- `data.result.summary`：一句话结论
- `data.disclaimer`：非验厂承诺声明

## 口径

- 满分按权重累计：具备 = 权重×2，部分具备 = 权重×1，不具备 = 0；百分制 = 得分 / 满分 ×100。
- ≥80 相对完备；≥55 明显缺口；否则风险较高。
- 明确告诉用户：评分用于缺口排序与立项讨论，不构成出口验厂、客户审核或合规认证通过承诺。
- 需要人工复核时给电话 400-800-5817。