docs(changelog): 撤回含错误指纹说法的 #5674 白名单,只读字段清单并入 #5704
changelog-filename-gate / validate (push) Failing after 1s

这个提交包含在:
yaosutu
2026-08-08 22:44:38 +08:00
父节点 a0b43444db
当前提交 3928b35212
共修改 2 个文件,包含 18 行新增和 280 行删除
@@ -249,6 +249,24 @@ Content-Type: application/json
- ❌ 导游/摄影 4 个端点与车辆保存端点对请求体做字段白名单校验,**任何未知字段都会被拒**(含本次删除的指纹/版本号字段),不要把查询响应整个 echo 回请求体。
- ❌ 已终态(冻结)的核单数据仍不可编辑,该约束与本次变更无关,保持不变。
### 9.1 保存时必须剥掉的只读派生字段(导游/摄影)
导游/摄影保存接口(PUT guide-fees / photographer-fees)的 GET 响应 items[] 里含有后端计算的只读派生字段,**保存回传时必须剥掉**,否则触发白名单 400(错误码 584128「不支持字段: xxx」)。
必须剥掉的字段:
| 字段 | 含义 |
|---|---|
| `sourceType` / `sourceTypeName` | 来源类型及中文名 |
| `sourceActive` | 来源是否仍有效 |
| `serviceTypeName` | 导游服务类型中文名 |
| `feeTypeName` | 摄影费用类型中文名 |
| `paymentMethodName` | 付款方式中文名 |
| `settlementConfirmStatus` / `settlementConfirmStatusName` | 核算确认状态及中文名 |
| `candidateResolution` | 候选处理结果 |
通则:**所有 `*Name` 中文字段 + `sourceType`/`sourceActive` + 确认状态 + 候选处理结果,都是后端算的,保存一律不回传。** 推荐前端保存前按允许字段重建 payload(维护 toSaveItem 映射),不要把 GET 响应对象整个 echo 回去。
## 10. 修改前后对比
### 10.1 字段级对比