PCB报价APP API设计

1. 文件上传端点 (POST)

POST /api/v1/quote/upload
Content-Type: multipart/form-data

请求参数：

{
  "file": "gerber.zip",            // PCB设计文件 (必需)
  "parameters": {                  // 用户自定义参数 (可选覆盖解析结果)
    "layers": 4,                   // 层数
    "material": "FR4",             // 板材类型
    "copperWeight": 1,             // 铜厚 (oz)
    "surfaceFinish": "HASL",       // 表面处理
    "solderMaskColor": "green",    // 阻焊颜色
    "silkscreenColor": "white",    // 丝印颜色
    "minHoleSize": 0.3,            // 最小孔径 (mm)
    "minTraceWidth": 0.15,         // 最小线宽 (mm)
    "quantity": 100                // 数量
  }
}

2. 报价计算端点 (POST)

POST /api/v1/quote/calculate
Content-Type: application/json

请求示例：

{
  "fileId": "gerber_12345",       // 上传后返回的文件ID
  "customParams": {               // 可覆盖解析参数的定制参数
    "quantity": 500,
    "surfaceFinish": "ENIG"
  },
  "manufacturerOptions": [        // 选择的制造商方案
    "standard", 
    "high_precision"
  ]
}

3. 响应数据结构

成功响应 (200 OK)：

{
  "quoteId": "quote_2023abc",
  "baseSpecs": {                   // 解析出的基础规格
    "boardSize": [100, 150],       // 板子尺寸 [长(mm), 宽(mm)]
    "layers": 4,
    "material": "FR4",
    "copperWeight": 1,
    "surfaceFinish": "HASL",
    "solderMaskColor": "green",
    "silkscreenColor": "white",
    "minHoleSize": 0.3,
    "minTraceWidth": 0.15
  },
  "quotes": [
    {
      "manufacturerId": "manu_sz001",
      "processType": "standard",    // 工艺类型
      "unitPrice": 2.50,            // 单片价格(元)
      "totalPrice": 1250,           // 总价(元)
      "deliveryDays": 7,            // 交货天数
      "capabilities": {             // 工艺能力说明
        "minLineWidth": 0.1,
        "minHoleSize": 0.2
      }
    },
    {
      "manufacturerId": "manu_sh002",
      "processType": "high_precision",
      "unitPrice": 4.20,
      "totalPrice": 2100,
      "deliveryDays": 5,
      "capabilities": {
        "minLineWidth": 0.05,
        "minHoleSize": 0.1
      }
    }
  ]
}

4. 错误响应

400 Bad Request：

{
  "error": "INVALID_FILE",
  "message": "不支持的Gerber文件版本"
}

404 Not Found：

{
  "error": "FILE_NOT_FOUND",
  "message": "文件ID gerber_12345 不存在"
}

关键设计说明

1. 文件分离处理：

   • 先通过/upload接口传文件获得fileId
   • 后续请求携带fileId避免重复传输大文件

2. 参数覆盖机制：

   • 系统自动解析文件参数
   • 用户可在customParams中覆盖任意参数

3. 多方案报价：

   • 响应中的quotes数组包含不同制造商/工艺的报价方案
   • 每个方案包含工艺能力说明供用户决策

4. 扩展性设计：

   • manufacturerOptions支持动态添加新工艺类型
   • 板材类型等参数使用字符串枚举值（如FR4/Aluminum）

5. 安全措施：

   • 文件类型校验（仅接受.zip/.rar/.gerber）
   • 参数范围校验（如铜厚0.5-6oz）

使用流程示例

用户操作流：
1. 上传Gerber文件 → 获取fileId
2. 修改数量/工艺参数 → 提交计算
3. 获取多厂商报价方案
4. (可选) 调整参数重新提交步骤2

此设计平衡了灵活性和性能，通过分离文件上传和计算流程，有效支持大文件处理和参数动态调整场景。