# P20 在线 DFM 预审 接口清单（规划）

> 前缀：`/api/dfm`　鉴权：检查接口需登录或按设备额度限流；报告下载需归属校验

## 1. 任务

| 方法 | 路径 | 说明 | 主要参数 |
| --- | --- | --- | --- |
| POST | /tasks | 创建检查任务 | `file_ids[]` `supplier_id` `stackup` `surface_finish` |
| GET | /tasks | 我的任务列表 | `page` `size` `status` |
| GET | /tasks/{id} | 任务详情与摘要 | `id` |
| GET | /tasks/{id}/risks | 风险清单 | `level` `layer` `page` |
| GET | /tasks/{id}/report | 下载报告 | `format=pdf` |

## 2. 分层与预览

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | /tasks/{id}/layers | 分层清单与边界框 |
| GET | /tasks/{id}/layer/{layerId} | 单层渲染数据（分块坐标） |
| GET | /tasks/{id}/measure | 测量接口（两点距离 / 角度） |

## 3. 规则与供应商能力

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | /rules | 规则族与默认阈值 |
| GET | /suppliers/{id}/rules | 工厂工艺能力 |
| POST | /suppliers/{id}/rules | 保存工艺能力（需供应商身份） |
| GET | /suppliers/{id}/reports | 客户共享的 DFM 报告 |

## 4. 额度

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | /quota | 当日剩余次数与文件大小上限 |

## 5. 关键字段

`dfm_task`：`task_sn` `user_id` `supplier_id` `rfq_id` `file_type` `layer_count` `stackup` `surface_finish` `status` `yield_min` `yield_max` `risk_red` `risk_yellow` `risk_blue` `report_url`

`dfm_risk`：`task_id` `rule_code` `level` `title` `detail` `layer` `pos_x` `pos_y` `suggest`

`dfm_supplier_rule`：`supplier_id` `rule_code` `min_val` `max_val` `unit` `enabled`

## 6. 错误码

| 码 | 含义 | 处理 |
| --- | --- | --- |
| 21001 | 文件格式不支持 | 提示支持 Gerber RS274X / Excellon，ODB++ 需后端服务 |
| 21002 | 分层缺失或重名 | 列出缺失层并允许手动映射后重试 |
| 21003 | 文件超出大小上限 | 提示压缩或拆分上传 |
| 21004 | 当日额度已用完 | 提示次日或按会员额度 |
| 21005 | 工厂能力未维护 | 回退平台通用规则并在报告注明 |
| 21006 | 报告不存在或已过期 | 提示重新生成 |

## 7. 状态机

`queued → parsing → checking → done / failed`；失败保留原始错误码与失败层信息，支持重试一次。
