暂存提交

docs/phase1-local-api.md

@@ -77,6 +77,8 @@ Content-Type: application/json
 | PUT | `/api/merchant/v1/iam/tenant/profile` | 更新当前租户资料 |
 | GET | `/api/merchant/v1/iam/tenant/qualifications` | 返回当前租户资质列表 |
 
+IAM 的商户资质接口只读。旧的 `POST /api/merchant/v1/iam/tenant/qualifications` 已移除，上传必须使用 File 服务的 multipart 接口，避免数据库出现没有真实文件支撑的 URL。
+
 个人资料与修改密码：
 
 | 方法 | 路径 | 说明 |
@@ -142,6 +144,8 @@ Content-Type: application/json
 | GET | `/api/merchant/v1/files/qualifications/{fileName}` | 商户下载自己的资质 |
 | GET | `/api/platform/v1/files/qualifications/{tenantId}/{fileName}` | 平台查看指定租户资质 |
 
+历史 `/phase1-seed/...` 路径不符合 File 服务契约，不能直接改成不存在的 UUID。处理步骤见 `docs/企业资质文件迁移说明.md`。
+
 上传采用 `multipart/form-data`：`file` 必填，`certificateNo` 可选。只接受文件内容真实为 JPG/PNG 的图片，最大 5MB。上传成功 `data`：
 
 ```json