update: 人员证书上传流程说明

changelogs/2026-03/26_0905_xmm_detail_fields.md

@@ -281,3 +281,30 @@
 ```
 
 如果没有可报名团期，`priceTiers` 返回 null。
+
+---
+
+## 十、人员证书上传说明
+
+**上传流程**：使用通用文件上传接口，和上传其他图片一样。
+
+**步骤**：
+1. `POST /file/upload/token` → 获取预签名URL
+```json
+{ "fileName": "急救证书.jpg", "bizType": "staff" }
+```
+2. 用返回的预签名URL上传文件到OSS
+3. `POST /file/upload/confirm` → 确认上传，拿到最终URL
+4. 将URL填入 `certificates[].url`
+
+**保存人员时传 certificates 字段**：
+```json
+{
+  "certificates": [
+    { "tag": "急救证书", "url": "https://xxx/cert1.jpg" },
+    { "tag": "导游证", "url": "https://xxx/cert2.jpg" }
+  ]
+}
+```
+
+每项 `tag` 和 `url` 必须同时填，缺一报错。旧字段 `certificateTags`/`certificateUrls` 仍可用但建议迁移。