docs(7512): 服务人员 Changelog 补齐模板必需章节与逐接口自包含内容 Refs #7512

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011t6wjBsvqsFKFSkCzsYsuS

changelogs-v2/2026-09/12_7512_服务人员按景区口径接入供应商关系-修改接口-管理后台.md

@@ -28,13 +28,13 @@ base: "dev-v3"
 ## ⚠️ 关键变化
 
 - 服务人员列表每条记录固定返回 `supplierFullName`；无当前供应商时为 `null`。
-- 服务人员首次绑定、改绑都可以省略 `changeReason`；此前缺原因返回 `400 changeReason不能为空`。解绑此前已可省略，保持不变。
+- 服务人员首次绑定、改绑可以省略 `changeReason`；此前缺原因返回 `400 changeReason不能为空`。解绑此前已可省略，保持不变。
 - **服务人员不检查订单**：改绑、解绑不做未结束订单门禁，不新增任何错误码。这与景区(395059)、餐厅(395060)、游玩项目(395061)、酒店(395062)、服务(395063)不同。
 - `requiredTypeCode` 规则**没有变化**：服务人员本来就固定 `STAFF`，可省略；传其他类型仍返回 `400 requiredTypeCode与资源模块不匹配`。
 
 ## 一、背景
 
-服务人员此前不展示当前供应商全称，且设置、改绑必须填写变更原因。本次按景区、餐厅、游玩项目、酒店、服务现行口径冻结服务人员所需的展示字段与原因规则。与前述模块不同的是，订单侧不按服务人员资源 ID 识别订单（V3 派工表 `order_staff_assignment`、`order_batch_staff` 的 `staff_id` 是用户服务员工账号 ID，与资源侧 `staff` 表无对应字段），因此服务人员不接订单门禁。
+服务人员此前不展示当前供应商全称，且设置、改绑必须填写变更原因。本次按景区、餐厅、游玩项目、酒店、服务现行口径冻结服务人员所需的展示字段与原因规则。与前述模块不同的是，订单侧不按服务人员资源 ID 识别订单，因此服务人员不接订单门禁。
 
 ## 二、变更接口清单
 
@@ -43,7 +43,7 @@ base: "dev-v3"
 | 1 | 服务人员列表 | GET | `/admin/staff/list` | 响应字段新增 | 每条记录固定返回 `supplierFullName` |
 | 2 | 查询服务人员当前供应商 | GET | `/admin/supplier/resource-relations/{resourceModule}/{resourceId}/view` | 调用契约补充 | 服务人员传 `resourceModule=STAFF` |
 | 3 | 设置或改绑服务人员供应商 | PUT | `/admin/supplier/resource-relations/{resourceModule}/{resourceId}/update` | 请求与行为修改 | 可省略 `changeReason` |
-| 4 | 解绑服务人员供应商 | POST | `/admin/supplier/resource-relations/{resourceModule}/{resourceId}/unbind` | 无变化 | 原因此前已可省略，保持 |
+| 4 | 解绑服务人员供应商 | POST | `/admin/supplier/resource-relations/{resourceModule}/{resourceId}/unbind` | 调用契约补充 | 原因此前已可省略，保持 |
 
 ## 三、接口详情
 
@@ -55,32 +55,56 @@ base: "dev-v3"
 
 服务人员管理列表初始化、翻页、筛选或刷新时调用；列表「供应商」列直接读取 `supplierFullName`。
 
-#### 出参新增字段
+#### 入参
 
-| 字段 | 类型 | 必返回 | 说明 |
-|---|---|---|---|
-| `supplierFullName` | String | 是 | 当前有效关系对应的供应商全称；未关联或供应商已删除时为 `null` |
+| 字段 | 位置 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|---|
+| `keyword` | Query | String | 否 | - | 姓名模糊搜索 |
+| `staffType` | Query | String | 否 | 字典 `staff_type` | 人员类型筛选 |
+| `status` | Query | Integer | 否 | `0` 下架，`1` 上架 | 状态筛选 |
+| `page` | Query | Integer | 否 | 最小 1，默认 1 | 页码 |
+| `pageSize` | Query | Integer | 否 | 默认 20 | 每页条数 |
 
-其余字段（`staffId`、`name`、`staffType`、`settleType`、`phone`、`highlights`、`rating`、`viewCount`、`sortOrder`、`coverUrl`、`status`、`approvalNo`、`pendingStatus`、`tags`、`createdAt`、`updatedAt`）与分页元数据（`total`、`page`、`pageSize`）口径不变。
+本次不新增、不修改任何入参。
+
+#### 出参 `Result<PageResult<StaffAdminListVO>>`
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `code` / `message` / `success` | Integer / String / Boolean | 业务结果 |
+| `data.total` / `page` / `pageSize` | Long | 分页元数据，口径不变 |
+| `data.records[].staffId` | String | 人员 ID（雪花号序列化为字符串） |
+| `data.records[].name` | String | 姓名 |
+| `data.records[].staffType` | String | 人员类型 |
+| `data.records[].settleType` | String | 结算方式 |
+| `data.records[].phone` | String | 手机号 |
+| `data.records[].status` | Integer | `0` 下架，`1` 上架 |
+| `data.records[].tags` | Array | 标签列表 |
+| **`data.records[].supplierFullName`** | **String 或 null** | **本次新增**：当前有效关系对应的供应商全称；未关联或供应商已删除时为 `null` |
+
+其余既有字段（`highlights`、`rating`、`viewCount`、`sortOrder`、`coverUrl`、`approvalNo`、`pendingStatus`、`createdAt`、`updatedAt`）口径不变。
+
+#### 请求示例
+
+```http
+GET /admin/staff/list?page=1&pageSize=20 HTTP/1.1
+Authorization: Bearer <token>
+```
 
 #### 响应示例
 
 ```json
-{
-  "code": 200,
-  "message": "成功",
-  "data": {
-    "total": 12,
-    "page": 1,
-    "pageSize": 20,
-    "records": [
-      { "staffId": "1005", "name": "刘大山", "staffType": "LEADER", "status": 1,
-        "supplierFullName": "陈巴尔虎旗天下草原旅游服务有限" },
-      { "staffId": "1002", "name": "李雪梅", "staffType": "GUIDE", "status": 1,
-        "supplierFullName": null }
-    ]
-  }
-}
+{"code":200,"message":"成功","success":true,"data":{"total":12,"page":1,"pageSize":20,"records":[{"staffId":"1005","name":"刘大山","staffType":"LEADER","status":1,"supplierFullName":"陈巴尔虎旗天下草原旅游服务有限"},{"staffId":"1002","name":"李雪梅","staffType":"GUIDE","status":1,"supplierFullName":null}]}}
+```
+
+#### 空数据 / 降级响应
+
+无匹配人员时 `records` 为空数组、`total` 为 `0`，不是错误。未关联供应商的人员返回 `supplierFullName: null`，字段始终存在。
+
+#### 错误响应
+
+```json
+{"code":401,"message":"缺少有效的 Authorization 头","success":false,"data":null}
 ```
 
 #### 业务边界
@@ -89,84 +113,294 @@ base: "dev-v3"
 - 该字段按当前页 ID 批量查询实时关系得到，不缓存；供应商改名后下次翻页即生效。
 - 内部接口 `/internal/staff/**` 与小程序链路不返回该字段，口径不变。
 
-### 2. 查询服务人员当前供应商 `GET /admin/supplier/resource-relations/STAFF/{staffId}/view`
+### 2. 查询服务人员当前供应商 `GET /admin/supplier/resource-relations/{resourceModule}/{resourceId}/view`
+
+**VO**: `-` / `Result<SupplierResourceRelationRespVO>`
+
+#### 使用场景
+
+打开服务人员详情或供应商关系弹窗时，回读当前供应商与关系版本；改绑、解绑前必须先调用它取版本对。
 
 #### 入参
 
-| 字段 | 位置 | 类型 | 必填 | 说明 |
-|---|---|---|---|---|
-| `resourceModule` | Path | String | 是 | 服务人员固定传 `STAFF` |
-| `resourceId` | Path | Long | 是 | 服务人员 ID（列表 `staffId`） |
+| 字段 | 位置 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|---|
+| `resourceModule` | Path | String | 是 | 服务人员固定为 `STAFF` | 资源模块 |
+| `resourceId` | Path | String | 是 | 正整数 | 服务人员 ID（列表 `staffId`） |
 
-#### 业务边界
+#### 出参 `Result<SupplierResourceRelationRespVO>`
 
-- 未关联供应商时返回 `395038`，前端据此展示「未关联」。
-- 资源不存在返回 `395035`。
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `code` / `message` / `success` | Integer / String / Boolean | 业务结果 |
+| `data.supplierId` | String | 当前供应商 ID |
+| `data.supplierFullName` | String | 当前供应商全称 |
+| `data.requiredTypeCode` | String | 生效类型；服务人员固定 `STAFF` |
+| `data.relationUpdateTime` | String | 关系版本，格式 `yyyy-MM-dd HH:mm:ss`，改绑/解绑时回传 |
 
-### 3. 设置或改绑服务人员供应商 `PUT /admin/supplier/resource-relations/STAFF/{staffId}/update`
+均为既有字段，本次不新增、不修改字段结构。
 
-#### 入参
+#### 请求示例
 
-| 字段 | 位置 | 类型 | 必填 | 说明 |
-|---|---|---|---|---|
-| `supplierId` | Body | Long | 是 | 目标供应商 ID，须为合作中且具备 `STAFF` 类型 |
-| `changeReason` | Body | String | **否（本次放宽）** | 最长 500 字；省略或全空白按 `null` 存储 |
-| `requiredTypeCode` | Body | String | 否 | 省略即 `STAFF`；传其他值返回 400 |
-| `expectedCurrentSupplierId` | Body | Long | 改绑必填 | 乐观并发围栏，取自 view |
-| `expectedRelationUpdateTime` | Body | String | 改绑必填 | 同上，与前者必须同时提供或同时省略 |
-
-#### 请求示例（首次绑定，省略原因与类型）
-
-```json
-{ "supplierId": 2097974318146146305 }
+```http
+GET /admin/supplier/resource-relations/STAFF/1002/view HTTP/1.1
+Authorization: Bearer <token>
 ```
 
-#### 请求示例（改绑，省略原因）
+#### 响应示例
 
 ```json
-{
-  "supplierId": 2097937816108269570,
-  "expectedCurrentSupplierId": 2097974318146146305,
-  "expectedRelationUpdateTime": "2026-09-12 12:20:31"
-}
+{"code":200,"message":"成功","success":true,"data":{"supplierId":"2097974318146146305","supplierFullName":"陈巴尔虎旗天下草原旅游服务有限","requiredTypeCode":"STAFF","relationUpdateTime":"2026-09-12 12:20:31"}}
 ```
 
+#### 空数据 / 降级响应
+
+当前无关系时返回 `395038`，前端据此展示「未关联」，不是异常。
+
 #### 错误响应
 
-| code | 场景 |
-|---|---|
-| `400 requiredTypeCode与资源模块不匹配` | 显式传了非 `STAFF` 的类型 |
-| `400 expectedCurrentSupplierId与expectedRelationUpdateTime必须同时提供或同时省略` | 两个并发围栏字段只传其一 |
-| `395010` | 目标供应商非合作中 |
-| `395014` | 并发围栏不匹配（他人已改） |
-| `395035` | 服务人员不存在 |
+```json
+{"code":395038,"message":"供应商资源关联不存在","success":false,"data":null}
+```
+
+```json
+{"code":395035,"message":"资源不存在","success":false,"data":null}
+```
 
 #### 业务边界
 
-- **不做订单门禁**：无论该服务人员是否出现在任何订单中，改绑都不被拦截，也不会返回 395059~395063 中的任何一个。
-- 原因放宽只作用于服务人员；其他未豁免模块（如备品 `SUPPLIES`）省略原因仍返回 `400 changeReason不能为空`。
-- 关系版本围栏与审计链路照常执行，省略原因时审计记录的原因列为 `null`。
+- 服务人员必须传 `resourceModule=STAFF`，大小写不敏感但建议全大写。
+- 该接口只读，不产生审计记录。
+- 登录与查看权限、数据范围规则不变。
 
-### 4. 解绑服务人员供应商 `POST /admin/supplier/resource-relations/STAFF/{staffId}/unbind`
+### 3. 设置或改绑服务人员供应商 `PUT /admin/supplier/resource-relations/{resourceModule}/{resourceId}/update`
 
-本次无变化。请求体需带 `expectedCurrentSupplierId` 与 `expectedRelationUpdateTime`，`changeReason` 可省略（此前已对全部资源模块豁免）。注意该接口是 **POST**，不是 DELETE。
+**VO**: `SupplierResourceReassignReqVO / Result<SupplierResourceRelationRespVO>`
 
-## 四、前端动作
+#### 使用场景
 
-1. 服务人员列表新增「供应商」列，读 `supplierFullName`，为 `null` 时展示「未关联」。
-2. 服务人员供应商的设置、改绑表单去掉「变更原因」必填校验（字段可保留为选填）。
-3. 改绑、解绑仍需先调 view 取 `supplierId` 与关系版本，作为并发围栏回传。
-4. 不需要为服务人员处理「存在未结束订单」类拦截提示，该模块不会返回此类错误码。
+为服务人员首次绑定供应商，或把已有关系改绑到另一家供应商。
 
-## 五、当前状态
+#### 入参
 
-- 后端：已合并 `dev-v3`（PR #7575，merge `58659736a`），已部署 TEST（部署提交 `ab7644ea4`）。
-- Gateway 验证：已通过，覆盖列表字段两种取值、首次绑定/改绑/解绑省略原因、订单侧数据零变化。
-- 前端：待接入。
+| 字段 | 位置 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|---|
+| `resourceModule` | Path | String | 是 | 服务人员固定为 `STAFF` | 资源模块 |
+| `resourceId` | Path | String | 是 | 正整数 | 服务人员 ID |
+| `supplierId` | Body | String | 是 | 正整数 | 目标供应商，须合作中且具备 `STAFF` 类型 |
+| `changeReason` | Body | String | **否（本次放宽）** | 最长 500 字 | 可省略、`null`、空串或空白 |
+| `requiredTypeCode` | Body | String | 否 | 省略即 `STAFF` | 传其他值返回 400 |
+| `expectedCurrentSupplierId` | Body | String | 改绑必填 | 正整数 | 当前关系的 `supplierId` |
+| `expectedRelationUpdateTime` | Body | String | 改绑必填 | `yyyy-MM-dd HH:mm:ss` | 当前关系的 `relationUpdateTime` |
 
-## 六、同系列历史
+#### 出参 `Result<SupplierResourceRelationRespVO>`
 
-| PR | Issue | 范围 | 已生效 |
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `code` / `message` / `success` | Integer / String / Boolean | 业务结果 |
+| `data.supplierId` / `supplierFullName` | String | 变更后的当前供应商 |
+| `data.requiredTypeCode` | String | 生效类型，固定 `STAFF` |
+| `data.relationUpdateTime` | String | 新的关系版本，供下次改绑/解绑使用 |
+
+#### 请求示例
+
+首次绑定（省略原因与类型）：
+
+```json
+{"supplierId":"2097974318146146305"}
+```
+
+改绑（省略原因）：
+
+```json
+{"supplierId":"2097937816108269570","expectedCurrentSupplierId":"2097974318146146305","expectedRelationUpdateTime":"2026-09-12 12:20:31"}
+```
+
+#### 响应示例
+
+```json
+{"code":200,"message":"成功","success":true,"data":{"supplierId":"2097937816108269570","supplierFullName":"示例服务人员供应商有限公司","requiredTypeCode":"STAFF","relationUpdateTime":"2026-09-12 12:20:44"}}
+```
+
+#### 空数据 / 降级响应
+
+无空成功结果；权限、字典或供应商资格等必要依赖无法明确核验时返回失败且不改变关系。
+
+#### 错误响应
+
+```json
+{"code":400,"message":"requiredTypeCode与资源模块不匹配","success":false,"data":null}
+```
+
+```json
+{"code":395010,"message":"请先完成供应商注册","success":false,"data":null}
+```
+
+#### 业务边界
+
+- 当前无关系时是首次绑定：不传版本对。
+- 当前有关系且目标供应商不同才是真正改绑：必须传完整、最新版本对；两个版本字段必须同时提供或同时省略，否则返回 `400 expectedCurrentSupplierId与expectedRelationUpdateTime必须同时提供或同时省略`。
+- **服务人员不检查订单**：无论该人员是否出现在任何订单或派工中，改绑都不会被拒绝，也不会返回 395059~395063。
+- 目标供应商必须合作中且已挂 `STAFF` 类型，否则分别返回 `395010` 与 `400 requiredTypeCode与资源模块不匹配`。
+- 版本过期返回 `395014`；失败不改变关系或审计。
+
+### 4. 解绑服务人员供应商 `POST /admin/supplier/resource-relations/{resourceModule}/{resourceId}/unbind`
+
+**VO**: `SupplierResourceUnbindReqVO / Result<Void>`
+
+#### 使用场景
+
+用户确认清除服务人员当前供应商关系时调用。注意该接口是 **POST**，不是 DELETE。
+
+#### 入参
+
+| 字段 | 位置 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|---|
+| `resourceModule` | Path | String | 是 | 服务人员固定为 `STAFF` | 资源模块 |
+| `resourceId` | Path | String | 是 | 正整数 | 服务人员 ID |
+| `expectedCurrentSupplierId` | Body | String | 是 | 正整数 | 当前关系的 `supplierId` |
+| `expectedRelationUpdateTime` | Body | String | 是 | `yyyy-MM-dd HH:mm:ss` | 当前关系的 `relationUpdateTime` |
+| `changeReason` | Body | String | 否 | 最长 500 字 | 可省略、`null`、空串或空白 |
+
+#### 出参 `Result<Void>`
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `code` / `message` / `success` | Integer / String / Boolean | 业务结果 |
+| `data` | null | 成功时固定为 `null` |
+
+#### 请求示例
+
+```json
+{"expectedCurrentSupplierId":"2097937816108269570","expectedRelationUpdateTime":"2026-09-12 12:20:44"}
+```
+
+#### 响应示例
+
+```json
+{"code":200,"message":"成功","success":true,"data":null}
+```
+
+#### 空数据 / 降级响应
+
+当前无关系时返回 `395038`，不执行解绑。
+
+#### 错误响应
+
+```json
+{"code":395014,"message":"数据已被其他操作修改，请刷新后重试","success":false,"data":null}
+```
+
+#### 业务边界
+
+- 解绑必须使用当前关系最新版本对；版本过期返回 `395014`，原关系不变。
+- 服务人员解绑同样不检查订单。
+- 登录、`supplier:resource:manage` 服务端权限、数据范围、幂等、锁和审计规则保持不变；失败零写入。
+
+## 四、契约约束与正确调用方式
+
+| 场景 | 正确 payload | 调用结果 |
+|---|---|---|
+| 查询当前关系 | 无请求体，`resourceModule=STAFF` | 返回关系；无关系为 `395038` |
+| 首次绑定 | `{"supplierId":"22"}` | 不传版本对、类型和原因 |
+| 改绑 | `{"supplierId":"33","expectedCurrentSupplierId":"22","expectedRelationUpdateTime":"2026-09-12 12:20:31"}` | 两个版本字段必须成对且取最新关系值 |
+| 解绑 | `{"expectedCurrentSupplierId":"33","expectedRelationUpdateTime":"2026-09-12 12:20:44"}` | POST 方法，可省略 `changeReason` |
+| 错误：传其他类型 | `{"supplierId":"33","requiredTypeCode":"SCENIC"}` | 返回 `400 requiredTypeCode与资源模块不匹配`，不写入 |
+| 错误：版本字段只传一个 | `{"supplierId":"33","expectedCurrentSupplierId":"22"}` | 返回 `400`，不写入 |
+
+每次改绑或解绑前先回读当前关系，成功后重新刷新关系和服务人员列表。业务失败可能仍为 HTTP 200，必须同时判断响应体 `code` 与 `success`。
+
+## 五、数据库行为
+
+| 前端操作 | 外部可观察结果 |
+|---|---|
+| 首次绑定 | 生成一个当前有效关系，`requiredTypeCode=STAFF`；未填原因时不虚构默认原因 |
+| 改绑 | 旧关系转为历史，新供应商成为唯一当前关系，并保留正常变更审计 |
+| 解绑 | 当前关系消失并保留正常解绑审计；服务人员列表返回 `supplierFullName: null` |
+| 版本、权限、类型或资格校验失败 | 当前关系和审计均不变化 |
+
+本次不迁移或回填任何数据，不修改服务人员自身业务数据，不修改订单业务、订单数据或派工数据。
+
+## 六、边界行为
+
+- 未登录返回 `401`；关系查询要求查看权限，设置、改绑、解绑要求维护权限及对应数据范围。
+- 服务人员未绑定供应商时，列表返回 `supplierFullName: null`，关系查询返回 `395038`。
+- `changeReason` 最长 500 字；省略、`null`、空串或纯空白均按未填写处理。
+- `requiredTypeCode` 省略时按 `STAFF` 生效；传入任何其他值一律返回 `400 requiredTypeCode与资源模块不匹配`。
+- 服务人员改绑、解绑**不做订单核验**，不会返回未结束订单类错误码。
+
+## 六.5、枚举 / 数据字典
+
+### `resourceModule` / `requiredTypeCode`（服务人员供应商关系）
+
+**所属字段**: Path `resourceModule`、Body/Response `requiredTypeCode` | **类型**: `String`
+
+| 值 | 中文 | 说明 |
+|---|---|---|
+| `STAFF` | 服务人员管理 | 服务人员关系固定值；`requiredTypeCode` 可省略并由后端确定 |
+
+### 业务错误码
+
+本次**未新增**任何业务错误码。涉及的既有错误码：
+
+| 值 | 中文 | 说明 |
+|---|---|---|
+| `400` | requiredTypeCode与资源模块不匹配 | 显式传入非 `STAFF` 类型时 |
+| `395038` | 供应商资源关联不存在 | 查询或解绑时当前无有效关系 |
+| `395014` | 数据已被其他操作修改，请刷新后重试 | 关系版本过期 |
+| `395010` | 请先完成供应商注册 | 目标供应商非合作中状态 |
+
+## 六.6、修改前后对比
+
+### 字段级对比
+
+| 字段 | 改前 | 改后 |
+|---|---|---|
+| `GET /admin/staff/list` 的 `records[].supplierFullName` | 不返回 | 每条固定返回 `String` 或 `null` |
+| 服务人员设置/改绑的 `changeReason` | 必填，否则 `400 changeReason不能为空` | 可省略；原有非空值继续兼容 |
+| 服务人员解绑的 `changeReason` | 已可省略 | 保持可省略 |
+| 服务人员设置/改绑的 `requiredTypeCode` | 可省略，按 `STAFF` 生效 | 不变 |
+
+### 行为级对比
+
+| 行为 | 改前 | 改后 |
+|---|---|---|
+| 服务人员列表展示供应商 | 列表无名称字段 | 直接读取 `supplierFullName` |
+| 服务人员设置、改绑 | 必须填写变更原因 | 可以不填 |
+| 服务人员改绑、解绑 | 不检查订单 | 仍不检查订单（本次未引入门禁） |
+
+## 六.7、影响评估
+
+- **是否破坏向后兼容**: 否；新增可空字段、放宽一个可选入参。原来显式传 `changeReason` 的调用继续有效。
+- **前端是否必须同步上线**: 是。
+- **前端 workaround 清理点**: 服务人员列表直接展示 `supplierFullName`；复用供应商关系弹窗并传 `STAFF`；删除服务人员设置/改绑的原因弹框与必填校验；解绑请求确认使用 POST。
+
+## 七、不影响范围
+
+- **仅影响**: 管理端服务人员列表、服务人员供应商关系操作。
+- **零影响**: 订单创建、状态流转、结算、支付、退款、订单数据、派工与团期人员配置；服务人员自身的创建、修改、审批、价格日历与标签；内部接口 `/internal/staff/**` 及其 `StaffBriefRespVO`、`StaffSimpleRespVO`。
+- 景区、餐厅、备品、组合配品、游玩项目、酒店、服务、额外成本、车队各模块的字段、类型、原因规则和订单门禁保持原契约；数据库结构、配置、Redis、MQ 和 Gateway 路由无变化。
+
+## 八、测试环境已验证
+
+TEST 部署提交 `ab7644ea4cb98920fed71062369b272c06a30211`（hl-resource-service，Deploy Panel API 规范客户端，双实例健康启用 2/2）；2026-09-12 经 Gateway 以真实 TEST 身份实测 13/13 通过：
+
+| 场景 | 结果 |
+|---|---|
+| `GET /admin/staff/list` 每条记录含 `supplierFullName` 字段 | 通过 |
+| 已关联人员（`staffId=1005`）返回当前供应商全称 | 通过 |
+| 未关联的 11 名人员均返回 `supplierFullName: null` | 通过 |
+| 未绑定人员查询关系返回 `395038` | 通过 |
+| 首次绑定省略 `changeReason` 成功，view 回读为目标供应商 | 通过 |
+| 改绑到另一家供应商、省略 `changeReason` 成功，view 回读为新供应商 | 通过 |
+| 解绑省略 `changeReason` 成功，之后查询回到 `395038` | 通过 |
+| 改绑、解绑前后 `order_staff_assignment`、`order_batch_staff` 摘要一致（订单侧零变化） | 通过 |
+
+**当前状态：后端已部署并验证；待前端处理。**
+
+## 九、相关历史 PR
+
+| PR | Issue | 说明 | 是否仍有效 |
 |---|---|---|---|
 | #7358 | #7357 | 景区改绑供应商免原因 | 是 |
 | #7401 | #7400 | 全部资源供应商解绑免原因 | 是 |
@@ -177,6 +411,11 @@ base: "dev-v3"
 | #7573 | #7511 | 额外成本列表、固定类型与原因规则（不含订单门禁） | 是 |
 | **#7575** | **#7512** | 服务人员列表与原因规则（无订单门禁） | **是，服务人员最新契约** |
 
+## 十、相关文档
+
+- 关联 Issue：[#7512](https://git.1814.love:8443/wx/HL/issues/7512)
+- 后端 PR：[#7575](https://git.1814.love:8443/wx/HL/pulls/7575)
+
 ## 关联 / 联系人
 
 ### 链接