From 4122ff82eb1e5f54476d0f5eab268269f86286a1 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Thu, 26 Mar 2026 10:43:39 +0800
Subject: [PATCH] =?UTF-8?q?update:=20=E4=BA=BA=E5=91=98=E8=AF=81=E4=B9=A6?=
 =?UTF-8?q?=E7=BB=93=E6=9E=84=E5=8C=96=E5=88=97=E8=A1=A8=E9=80=9A=E7=9F=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../2026-03/26_0905_xmm_detail_fields.md      | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/changelogs/2026-03/26_0905_xmm_detail_fields.md b/changelogs/2026-03/26_0905_xmm_detail_fields.md
index ac78f6b..586c69d 100644
--- a/changelogs/2026-03/26_0905_xmm_detail_fields.md
+++ b/changelogs/2026-03/26_0905_xmm_detail_fields.md
@@ -200,3 +200,27 @@
 > 添加了证书标签，必须同时上传对应的证书文件
 
 前端在提交人员表单时，如果用户添加了证书标签但没上传证书文件，建议在前端也做提示拦截。
+
+---
+
+## 七、人员证书改为结构化列表
+
+**服务**: hl-resource-service
+
+### 新增字段 `certificates`（替代旧的 certificateTags + certificateUrls）
+
+人员创建/更新接口新增 `certificates` 字段，标签和附件一一对应：
+
+```json
+[
+  { "tag": "急救证书", "url": "https://xxx/cert1.jpg" },
+  { "tag": "导游证", "url": "https://xxx/cert2.jpg" },
+  { "tag": "教师资格证", "url": "https://xxx/cert3.jpg" }
+]
+```
+
+**校验规则**：每项的 `tag` 和 `url` 必须同时存在，缺一报错（如"第1个证书'急救证书'缺少证书附件"）。
+
+**兼容**：旧字段 `certificateUrls` / `certificateTags` 保留可用，但建议前端迁移到 `certificates`。
+
+**领队介绍**：小程序详情 `leaderInfoList` 中的 `certificateTags` 优先从 `certificates` 提取，同时也返回完整的 `certificates` 列表。