From a2626f65901919152a544741e86def81e43a345d Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Wed, 12 Aug 2026 23:47:45 +0800
Subject: [PATCH] =?UTF-8?q?docs(fleet):=20=E5=8F=91=E5=B8=83#5927=E5=B9=82?=
 =?UTF-8?q?=E7=AD=89=E5=A5=91=E7=BA=A6=E5=8F=98=E6=9B=B4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 ...¡ç®¡ç�†å†™ç«¯ç‚¹è¡¥é½�短窗幂等-修改接å�£-管ç�†å�Žå�°.md | 53 +++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 changelogs-v2/2026-08/12_5927_车务管�写端点补�短窗幂等-修改接�-管���.md

diff --git a/changelogs-v2/2026-08/12_5927_车务管�写端点补�短窗幂等-修改接�-管���.md b/changelogs-v2/2026-08/12_5927_车务管�写端点补�短窗幂等-修改接�-管���.md
new file mode 100644
index 0000000..e1708c8
--- /dev/null
+++ b/changelogs-v2/2026-08/12_5927_车务管�写端点补�短窗幂等-修改接�-管���.md
@@ -0,0 +1,53 @@
+---
+schema: "hl-changelog/v2"
+ticket: "5927"
+title: "车务管�写端点补�短窗幂等与���交错误�"
+consumer: "admin"
+change_type: "修改接�"
+author: "wx(GIT)"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: "mmg"
+frontend_ref: "pending"
+target_release: "v2.1"
+verified_at: "2026-08-12"
+updated_at: "2026-08-12"
+status_note: "�端 PR #5943 已�并 dev-v3 并部署测试�。车队/车辆/车型/�机管�写端点增加 10 秒短窗防���交；更新�作按实体 ID + 请求摘�区分，�实体��内容的连续编辑�会互拦。��请求返回 100502，�端沿用统一错误�示��。"
+base: "dev-v3"
+---
+
+# 车务管�写端点补�短窗幂等（#5927）
+
+## �更接�
+
+以下现有管�端写接�增加短窗幂等�护，**路径�请求字段和�功�应���**：
+
+- 车队新增�编辑�删除��用��用；
+- 车辆新增�编辑�删除��用��用；
+- 车型大类/型�新增�编辑�删除��用��用；
+- �机编辑；
+- 整团��沿用 Service �久幂等。
+
+原�确认和�机拒接�使用 Redis 短窗拒�，分别�留�久回执�放和状�机/CAS 业务幂等，��断网�试或下一轮派车被误拦。
+
+## 行为�化
+
+- 相�业务请求在 10 秒窗�内���交：返回业务� `100502`，�示“处�中，请勿���交�。
+- 更新�作的 key 为“实体 ID + 稳定请求摘��：
+  - 相�实体�相�内容的��请求会被拒；
+  - 相�实体���内容的�法连续编辑�以正常执行。
+- 内部导入��机审核等 Service 调用��管�端防�击 key 影�。
+
+## �端适�
+
+无需修改请求或�功�应结构。收到 `100502` 时展示�端 message，并��按钮短暂�用/等待当�请求结果；��自动改�其他请求�数�试。
+
+## 验���
+
+- �端 PR：`#5943`，squash merge `9d2c29fd`。
+- fresh 编译：763 个生产��293 个测试�。
+- 幂等定�测试：24/24；Fleet ArchTest：13/13；spotless：通过。
+- fleet 全�：3704 项中仅既有 Windows 进程管� flaky 2 项失败；该类独立�跑 23/23 通过，其余无失败/错误。
+- 测试� Deploy Panel：任务 `5042749e` �功。
+- 9443 网关�读�康验�：车辆��机�车队分页接�� `HTTP 200 / code 200`。