From a5e9bcda50e4fedbe86b903970be2f26bee9e9bf Mon Sep 17 00:00:00 2001 From: Mimingguang Date: Sat, 8 Aug 2026 23:11:51 +0800 Subject: [PATCH] =?UTF-8?q?chore(changelog):=20#5704=20implemented=20(hl-a?= =?UTF-8?q?dmin@d32e14b9)=20=E6=A0=B8=E5=8D=95=E6=8C=87=E7=BA=B9=E4=B8=8B?= =?UTF-8?q?=E7=BA=BF=E5=89=8D=E7=AB=AF=E5=AE=9E=E8=AF=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...5704_核单域下线数据指纹-修改接口-管理后台.md | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/changelogs-v2/2026-08/08_5704_核单域下线数据指纹-修改接口-管理后台.md b/changelogs-v2/2026-08/08_5704_核单域下线数据指纹-修改接口-管理后台.md index b54594c..fa0c83b 100644 --- a/changelogs-v2/2026-08/08_5704_核单域下线数据指纹-修改接口-管理后台.md +++ b/changelogs-v2/2026-08/08_5704_核单域下线数据指纹-修改接口-管理后台.md @@ -7,9 +7,9 @@ change_type: "修改接口" author: "yaosutu(GIT)" backend_status: "deployed" gateway_status: "verified" -frontend_status: "pending" -frontend_owner: "" -frontend_ref: "" +frontend_status: "implemented" +frontend_owner: "mmg" +frontend_ref: "d32e14b9" target_release: "" verified_at: "" status_note: "PR #5709 已合并 dev-v3；核单域 6 个端点删除 expectedSourceFingerprint/version 入参与 sourceFingerprint/version 出参，错误码 584108/584110/584325 同步下线。字段删除属硬破坏契约，前端必须先停传这些字段再与后端同批发布。" @@ -321,3 +321,14 @@ Content-Type: application/json ### 13.2 联系人 - **后端负责人**: @yaosutu (yst) + +## 前端实证确认（2026-08-08 mmg，hl-admin@d32e14b9） + +已按契约停传/停读全部指纹/版本号字段，清理下线错误码特判： + +- **入参删除**：保存导游/摄影 `buildStaffFeeTabSaveRequest` 不再传 `expectedSourceFingerprint`（含回退 #5674 给导游强制传指纹的逻辑——该 changelog 已撤回并入本单）；保存车辆 `buildVehicleSaveRequest` 删 `version`；finalize 删 `reimbursementExpectedSourceFingerprint`/`groupExpectedSourceFingerprint`。人员/车辆保存 items 白名单重建（不回传 sourceType/settlementConfirmStatus 等只读字段）保留不动。 +- **出参停读**：报告适配不再投影 `sourceFingerprint`；GET 回读不再持久化车辆 version / 人员指纹。 +- **错误码特判**：车辆来源漂移恢复分支 584108 改挂 **584315**（恢复语义不变：丢弃过期草稿+GET 回读权威明细+提示重新核对）；人员 584110/584108 指纹冲突分支删除（下线后不再命中）；584325 下线清理。584300/584302（应收总览/优惠确认指纹）不在范围，未触碰；`attachRefreshedDetailForReportError` 报告侧 584312/584314/584315 刷新逻辑保留。 +- **UI 门禁**：`detail.vue canComplete` 由「持有双报告指纹」放宽为「双报告已生成」（finalize 前 service 层双报告 GET 的 584311/584313 保护仍在，指纹门禁本是 UI 冗余）；`ReportModal` 凭据表单重置改用报告快照引用触发（语义等价）。 +- **前端未接 confirm 端点**：grep 确认无 `guide-fees/confirm`、`photographer-fees/confirm` 调用，6 端点中实际涉及 4 个。 +- 验证：settlement + orderV2 定向 vitest 105/105 通过；checkpoint（含 Vitest 全量 + 生产构建）全绿。