# P22 拼板 / V-CUT / 邮票孔 接口清单

> 说明：路径为平台内规划路径，前端经现有数据层访问；仅在平台数据库开启后可用，未开启时回退本机演示数据。

## 1. 拼板任务

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| POST | `/panel/tasks` | 创建拼板任务，返回 `task_id` 与计算结果 |
| GET | `/panel/tasks?user_id=` | 我的拼板任务列表 |
| GET | `/panel/tasks/{id}` | 任务详情（参数、结果、风险项） |
| PATCH | `/panel/tasks/{id}` | 更新参数并重算 |
| DELETE | `/panel/tasks/{id}` | 删除任务 |
| POST | `/panel/tasks/{id}/to-rfq` | 方案带入询价单 |
| POST | `/panel/tasks/{id}/to-dfm` | 方案带入 DFM 预审 |

## 2. 计算

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| POST | `/panel/compute` | 入参单板尺寸、工艺边、板间距、阵列、基板尺寸，返回拼板尺寸、单板数、利用率 |
| POST | `/panel/vcut/check` | 校验 V-CUT 角度、残留厚度、交叉跳刀 |
| POST | `/panel/stamp/check` | 校验邮票孔孔径、孔距、连接筋宽度、桥连数量 |

## 3. 模板

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | `/panel/templates?scope=public\|mine\|team` | 模板列表 |
| POST | `/panel/templates` | 保存模板 |
| DELETE | `/panel/templates/{id}` | 删除模板 |

## 4. 供应商参数

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | `/panel/supplier-params?supplier_id=` | 读取工厂拼板能力 |
| PUT | `/panel/supplier-params/{supplier_id}` | 维护参数（仅该供应商账号） |

## 5. 数据字段

`panel_task`：`id` `user_id` `board_len` `board_wid` `board_thk` `edge_rail` `gap` `rotate` `rows` `cols` `panel_len` `panel_wid` `pcs_count` `utilization` `split_mode` `vcut_json` `stamp_json` `status` `created_at`

`panel_risk`：`task_id` `code` `level` `title` `detail` `suggest`

`panel_supplier_param`：`supplier_id` `board_max_len` `board_max_wid` `vcut_min_residual` `vcut_angle` `stamp_hole_min` `stamp_hole_max` `stamp_pitch_min` `stamp_pitch_max` `bridge_min` `enabled`

## 6. 错误码

| 码 | 含义 | 处理 |
| --- | --- | --- |
| 22001 | 单板尺寸缺失或非法 | 提示必须为正数，单位 mm |
| 22002 | 阵列数为 0 | 按基板尺寸给出建议行列数 |
| 22003 | 拼板超出基板尺寸 | 提示减少行列或缩小工艺边 |
| 22004 | V-CUT 残留厚度低于工厂下限 | 提示建议值与来源 |
| 22005 | 邮票孔参数越界 | 标黄并给出可用区间 |
| 22006 | 无工厂参数 | 回退平台通用缺省值并在报告中注明 |

## 7. 状态机

`draft → computed → sent_to_rfq / sent_to_dfm → archived`；参数变更后回到 `draft` 重算。