# 接口变更记录 — 2026-03-26 10:43

> **提交** `7d4f79c` · **作者** wx · **时间** 2026-03-26 10:43:22 +0800
>
> feat: 人员证书改为结构化列表(certificates)，标签和附件一一对应

## 变更总览


---

## 📦 其他数据对象变更

> 以下变更未直接关联到本次接口变更，但可能影响现有接口的请求/响应

### 资源服务

#### ✏️ StaffCreateRequest

  - ✏️ `certificateUrls`: 说明 "资质证书URL列表" → "资质证书URL列表（旧字段，建议用certificates）"
  - ✏️ `certificateTags`: 说明 "证书标签列表" → "证书标签列表（旧字段，建议用certificates）"

#### ✏️ StaffUpdateRequest

  - ✏️ `certificateUrls`: 说明 "资质证书URL列表" → "资质证书URL列表（旧字段，建议用certificates）"
  - ✏️ `certificateTags`: 说明 "证书标签列表" → "证书标签列表（旧字段，建议用certificates）"

#### ✏️ StaffVO

  - ✏️ `certificateUrls`: 说明 "资质证书URL列表" → "资质证书URL列表（旧字段，建议用certificates）"
  - ✏️ `certificateTags`: 说明 "证书标签列表，如[\" → "证书标签列表（旧字段，建议用certificates）"

<details>
<summary>📁 全部变更文件 (点击展开)</summary>

```
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/controller/InternalStaffController.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/dto/StaffCreateRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/dto/StaffUpdateRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/entity/Staff.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/service/StaffService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/vo/StaffVO.java
```
</details>