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 重算。

