SRM 资质附件上传 - 前端联调方案

涉及页面

• 采购管理-SRM-供应商管理-资质证书列表页
• 采购管理-SRM-供应商管理-资质证书新增/编辑弹窗
• 采购管理-SRM-招标项目-新增/编辑弹窗（含发布中/投标中的部分更新）
• 采购管理-SRM-招标项目-详情页

业务流程与数据带入

1. 用户在表单中通过上传组件选择文件
2. 上传组件调用 /system/storage-blob/upload 获得 blobId
3. 保存业务记录（资质证书 / 招标项目）时，将文件 ID 列表 blobIds 随业务数据一并提交
4. 后端在业务记录保存后，通过 recordType + recordId 将文件绑定到 system_storage_attachment 中间表
5. 查询业务记录（详情、分页）时，后端返回 attachmentList（含文件 URL、名称），前端展示下载链接

API

1. 资质证书附件

请求参数（create/update 新增字段）：

响应字段新增（attachmentList 数组元素）：

响应示例：

{
  "code": 0,
  "data": {
    "id": 1,
    "supplierId": 10,
    "certificateName": "ISO9001质量管理体系",
    "attachmentList": [
      {
        "id": 1001,
        "name": "iso9001_cert.pdf",
        "url": "https://example.com/files/xxx.pdf"
      }
    ]
  }
}

2. 招标项目资质要求附件

请求参数（create/update/update-info 新增字段）：

响应字段新增： 同资质证书，attachmentList 数组元素含 id、name、url、previewURL、downloadURL。

字段展示规则

业务规则说明

注意事项

• 上传必须走 /system/storage-blob/upload，禁止使用旧版 /infra/file/* 接口。
• 资质证书与招标项目使用不同的 recordType：资质证书为 srm_supplier_certificate，招标项目为 srm_tender_project，前端无需关心，由后端处理。
• 编辑回显时若用户未改动附件，提交的 blobIds 仍应包含原有文件 ID（由上传组件回显对象携带），避免附件被误删。
• 招标项目部分更新（update-info）请求体同样需携带 blobIds。
• 列表页附件链接建议 target="_blank" 新窗口打开，便于预览 PDF/图片。