From 92c9bb51c14110b5d2617a20aeb5af8b31caaf2a Mon Sep 17 00:00:00 2001
From: jw <jinwei@1814.love>
Date: Fri, 2 Oct 2026 14:43:23 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#8684=20=E9=A2=84=E6=94=AF?=
 =?UTF-8?q?=E7=9B=B8=E5=85=B3=208=20=E4=B8=AA=E6=8E=A5=E5=8F=A3=E5=87=BA?=
 =?UTF-8?q?=E5=8F=82=E6=96=B0=E5=A2=9E=20canRevoke=EF=BC=88=E4=BF=AE?=
 =?UTF-8?q?=E6=94=B9=E6=8E=A5=E5=8F=A3=C2=B7=E7=AE=A1=E7=90=86=E5=90=8E?=
 =?UTF-8?q?=E5=8F=B0=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Refs wx/HL#8684 · PR #8723 · merge 806058c66
---
 ...¡¨å‡ºå�‚补撤回标记canRevoke-修改接å�£-管ç�†å�Žå�°.md | 834 ++++++++++++++++++
 1 file changed, 834 insertions(+)
 create mode 100644 changelogs-v2/2026-10/02_8684_预支列表出�补撤回标记canRevoke-修改接�-管���.md

diff --git a/changelogs-v2/2026-10/02_8684_预支列表出�补撤回标记canRevoke-修改接�-管���.md b/changelogs-v2/2026-10/02_8684_预支列表出�补撤回标记canRevoke-修改接�-管���.md
new file mode 100644
index 00000000..08e755b3
--- /dev/null
+++ b/changelogs-v2/2026-10/02_8684_预支列表出�补撤回标记canRevoke-修改接�-管���.md
@@ -0,0 +1,834 @@
+---
+schema: "hl-changelog/v2"
+ticket: "8684"
+title: "预支相关 8 个接�出�新增 canRevoke：当��作人点「撤回�能��功，与撤回接�共用�一个判定"
+consumer: "admin"
+author: "jw(GIT)"
+change_type: "修改接�"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "已�并 dev-v3（806058c66）并部署 TEST，自签低�� token �网关实测：三个列表�角色�值��表 created_by 探针�开关关闭→还原往返（md5 �字节还原，渲染期间拒�日志零新增）�按 canRevoke 抽样真实撤回。�端待改两处撤回按钮：订�详情预支弹窗 AdvanceModal.vue 与团期财务页签 FinanceTab.vue 的 v-if 改为 a.canRevoke；审批中心本�没有撤回按钮。"
+updated_at: "2026-10-02"
+base: "dev-v3"
+---
+
+# order-v3: 预支列表出�新增 canRevoke
+
+**�务**: hl-order-service-v3
+**PR**: `#8723`（已�入 `dev-v3`，�并�交 `806058c66`）
+**Issue**: #8684
+
+---
+
+## ⚠� 关键�化
+
+🟢 **8 个接�的出�新增一个字段 `canRevoke`（Boolean）**：当��作人现在点「撤回�能�能�功。其余入��出��判��错误�全部��。
+
+🔴 **�一行，��人看到的值��。** ��缓存�跨账��用，也��拿它当这笔预支本身的属性。
+
+🟢 **�端�需把撤回按钮的显示�件改� `a.canRevoke`**，�用自己判断角色�申请人和开关。
+
+---
+
+## 一�背景
+
+#8517 之�，撤回待审批预支（`DELETE /v3/admin/order/advance/:advanceId`）�放行申请人本人和超管�管�员，其余返回 `585009`。但列表�返回申请人姓�，没有申请人账� ID，也没有「能�能撤�的标记，�端�能按「待审批�显示撤回按钮：�申请人也能看到，点了��示 `585009`。
+
+本�在出�里补 `canRevoke`，由�端按撤回接�的�一套规则算好。撤回接�本身的判���。
+
+---
+
+## 二��更接�清�
+
+| # | 接� | 方法 | 路径 | �更类型 | 说明 |
+|---|------|------|------|----------|------|
+| 1 | 本�预支列表 | GET | `/v3/admin/order/:orderId/advances` | 修改 | `records[]` 新增 `canRevoke` |
+| 2 | 预支审批列表 | GET | `/v3/admin/order/advance-approvals/page` | 修改 | `records[]` 新增 `canRevoke` |
+| 3 | 团期预支记录（财务页签） | GET | `/v3/admin/order/group-batch/:groupBatchId/advances` | 修改 | �行新增 `canRevoke` |
+| 4 | �起订�级预支 | POST | `/v3/admin/order/:orderId/advance` | 修改 | 返回体新增 `canRevoke` |
+| 5 | 预支审批通过 | PUT | `/v3/admin/order/advance/:advanceId/approve` | 修改 | 返回体新增 `canRevoke`（� `false`） |
+| 6 | 预支审批驳回 | PUT | `/v3/admin/order/advance/:advanceId/reject` | 修改 | 返回体新增 `canRevoke`（� `false`） |
+| 7 | �起团期级预支 | POST | `/v3/admin/order/group-batch/:groupBatchId/advance` | 修改 | 返回体新增 `canRevoke` |
+| 8 | 核�汇总快照 | GET | `/v3/admin/order/:orderId/settlement/summary` | 修改 | `advanceSummary.records[]` 新增 `canRevoke`（��已通过，� `false`） |
+
+---
+
+## 三�接�详情
+
+**`canRevoke` �值规则**（8 个接�相�，按顺�判，命中�返回）：
+
+| # | �件 | �值 |
+|---|---|---|
+| 1 | 这笔预支�是待审批（`status ≠ SUBMITTED`） | `false` |
+| 2 | 没有请求上下文（定时任务�消�消费等） | `false` |
+| 3 | 当�角色是团期管�员 `GROUP_BATCH_MANAGER` | `false`（撤回接�先返回 `581008`，��开关影�） |
+| 4 | 当�角色是 `SUPER_ADMIN` / `ADMIN` | `true` |
+| 5 | 当�账�就是申请人（创建人账� ID 相等） | `true` |
+| 6 | 其余：开关 `advance.acl.enforce.role-guard` 为 `true`（默认） | `false` |
+| 6' | 其余：开关已关闭 | `true`（撤回接�回到 #8517 之�的行为） |
+
+创建人账� ID 为空的存�行，�有第 4 �能得到 `true`。
+
+### 1. 本�预支列表 `GET /v3/admin/order/:orderId/advances`
+
+**VO**: `PageParam` → `Result<PageResult<OrderAdvanceRespVO>>`
+
+#### 使用场景
+
+订�详情的「预支�弹窗。�端� `canRevoke` 决定�一行显�显示「撤回�按钮。
+
+#### 入�字段表
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| orderId | Path | Long | ✅ | 订� ID | **��** |
+| page | Query | Integer | � | ≥1 | **��** |
+| pageSize | Query | Integer | � | ≥1 | **��** |
+
+#### 出�字段表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| records[].canRevoke | Boolean | 🆕 当��作人点撤回能��功，规则�上表 |
+| 其余字段 | — | **��**（`id` / `status` / `createdByName` 等） |
+
+#### 请求示例
+
+```http
+GET /v3/admin/order/2100743225424621570/advances?page=1&pageSize=20 HTTP/1.1
+Authorization: Bearer <本�定制师 token>
+```
+
+#### �应示例
+
+本�定制师看：自己申请的待审批为 `true`，管�员申请的待审批为 `false`，已通过的为 `false`。
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "records": [
+      {
+        "id": "2105886435083206657",
+        "orderId": "2100743225424621570",
+        "teamNo": "26-8707",
+        "payeeName": "刘大山",
+        "payeeRole": "LEADER",
+        "payeeRoleText": "导游",
+        "advanceType": "TICKET",
+        "amount": 180.0,
+        "purpose": "呼伦�尔大�原景区门票代垫",
+        "status": "SUBMITTED",
+        "statusText": "待审批",
+        "createdByName": "admin",
+        "canRevoke": true
+      },
+      {
+        "id": "2105886437624999938",
+        "orderId": "2100743225424621570",
+        "teamNo": "26-8707",
+        "payeeName": "刘大山",
+        "advanceType": "CATERING",
+        "amount": 120.0,
+        "purpose": "�尔�纳湿地��代垫",
+        "status": "SUBMITTED",
+        "statusText": "待审批",
+        "createdByName": "jw",
+        "canRevoke": false
+      }
+    ],
+    "total": 2,
+    "page": 1,
+    "pageSize": 20
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+无预支时 `records` 为空数组（��）。开关 `advance.acl.enforce.role-guard` 关闭时，�团期管�员看待审批行都为 `true`。
+
+#### 错误�应
+
+判���：�本�定制师�财务等无�角色�返回 `581008`。
+
+```json
+{
+  "code": 581008,
+  "message": "无�查看此订�",
+  "data": null,
+  "success": false
+}
+```
+
+#### 业务边界
+
+- �行�独计算，�一页里�以有 `true` 也有 `false`。
+- 车务管�员能看这个列表，但看所有行都是 `false`。
+
+---
+
+### 2. 预支审批列表 `GET /v3/admin/order/advance-approvals/page`
+
+**VO**: `AdvanceApprovalPageReqVO` → `Result<PageResult<AdvanceApprovalPageItemRespVO>>`
+
+#### 使用场景
+
+「财务管� → 预支审批�列表。页�目�没有撤回按钮，字段供�续使用。�有超管�管�员�财务能进（��）。
+
+#### 入�字段表
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| status | Query | String | � | `SUBMITTED` / `APPROVED` / `REJECTED` / `PAID` | **��** |
+| page | Query | Integer | � | ≥1 | **��** |
+| pageSize | Query | Integer | � | ≥1 | **��** |
+| 其余筛选项 | Query | — | � | — | **��** |
+
+#### 出�字段表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| records[].canRevoke | Boolean | 🆕 规则�上表；财务看别人申请的为 `false` |
+| 其余字段 | — | **��** |
+
+#### 请求示例
+
+```http
+GET /v3/admin/order/advance-approvals/page?status=SUBMITTED&page=1&pageSize=20 HTTP/1.1
+Authorization: Bearer <财务 token>
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "records": [
+      {
+        "id": "2105886435083206657",
+        "orderId": "2100743225424621570",
+        "orderNo": "HL20260918082629372",
+        "teamNo": "26-8707",
+        "scope": "ORDER",
+        "amount": 180.0,
+        "status": "SUBMITTED",
+        "createdByName": "admin",
+        "canRevoke": false
+      }
+    ],
+    "total": 1,
+    "page": 1,
+    "pageSize": 20
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+无数�时 `records` 为空数组（��）。开关关闭时财务看待审批行都为 `true`。
+
+#### 错误�应
+
+判���：�超管 / 管�员 / 财务返回 `585008`。
+
+```json
+{
+  "code": 585008,
+  "message": "仅财务或管�员�查看预支审批�审批或驳回预支",
+  "data": null,
+  "success": false
+}
+```
+
+#### 业务边界
+
+- 本接�多查了一列申请人账� ID 用于计算，**�出�**。
+- 团期级行（`scope=GROUP_BATCH`）�样按规则计算。
+
+---
+
+### 3. 团期预支记录（财务页签） `GET /v3/admin/order/group-batch/:groupBatchId/advances`
+
+**VO**: `List<GroupBatchAdvanceItemVO>`（继承 `OrderAdvanceRespVO`）
+
+#### 使用场景
+
+团期详情「财务�页签的预支记录。�端� `canRevoke` 决定显�显示「撤回�。
+
+#### 入�字段表
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| groupBatchId | Path | Long | ✅ | 团期 ID | **��** |
+
+#### 出�字段表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| [].canRevoke | Boolean | 🆕 规则�上表；团期管�员�为 `false` |
+| 其余字段 | — | **��**（`scope` / `orderNo` / `teamNo` 等） |
+
+#### 请求示例
+
+```http
+GET /v3/admin/order/group-batch/2104839654727618562/advances HTTP/1.1
+Authorization: Bearer <管�员 token>
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": [
+    {
+      "id": "2105589347598368769",
+      "scope": "GROUP_BATCH",
+      "scopeName": "团期级",
+      "orderId": null,
+      "orderNo": null,
+      "amount": 5000.0,
+      "status": "SUBMITTED",
+      "statusText": "待审批",
+      "createdByName": "金�",
+      "canRevoke": true
+    }
+  ],
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+无预支时返回空数组（��）。开关关闭时，�团期管�员看待审批行都为 `true`，团期管�员�为 `false`。
+
+#### 错误�应
+
+判���。团期�存在：
+
+```json
+{
+  "code": 589500,
+  "message": "团期�存在",
+  "data": null,
+  "success": false
+}
+```
+
+#### 业务边界
+
+- 原��端写的 `a.status === 'SUBMITTED' && !isGroupBatchManager` �以整体�� `a.canRevoke`。
+- �订�级行与团期级行规则相�。
+
+---
+
+### 4. �起订�级预支 `POST /v3/admin/order/:orderId/advance`
+
+**VO**: `CreateAdvanceReqVO` → `Result<OrderAdvanceRespVO>`
+
+#### 使用场景
+
+订�详情「�起预支�。返回体里 `canRevoke` 对�起人本人为 `true`（刚建的待审批，自己�以撤）。
+
+#### 入�字段表
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| orderId | Path | Long | ✅ | 订� ID | **��** |
+| payeeStaffId | Body | Long | ✅ | 本�人员 | **��** |
+| advanceType | Body | String | ✅ | 字典 `advance_type` | **��** |
+| amount | Body | BigDecimal | ✅ | >0，�超�用上� | **��** |
+| purpose | Body | String | � | — | **��** |
+| voucherUrl | Body | String | � | — | **��** |
+
+#### 出�字段表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| data.canRevoke | Boolean | 🆕 �起人本人为 `true` |
+| 其余字段 | — | **��** |
+
+#### 请求示例
+
+```json
+{
+  "payeeStaffId": "2100747615736897537",
+  "advanceType": "TICKET",
+  "amount": 180.00,
+  "purpose": "呼伦�尔大�原景区门票代垫"
+}
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "id": "2105886435083206657",
+    "orderId": "2100743225424621570",
+    "status": "SUBMITTED",
+    "statusText": "待审批",
+    "amount": 180.0,
+    "canRevoke": true
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+无。
+
+#### 错误�应
+
+判�与校验��。金�超�用上�：
+
+```json
+{
+  "code": 585004,
+  "message": "预支金�超过�用余�上�",
+  "data": null,
+  "success": false
+}
+```
+
+#### 业务边界
+
+- �是返回体多一个字段，创建逻辑��。
+
+---
+
+### 5. 预支审批通过 `PUT /v3/admin/order/advance/:advanceId/approve`
+
+**VO**: `Result<OrderAdvanceRespVO>`（无请求体）
+
+#### 使用场景
+
+审批中心「通过�。审批�状�是已通过，`canRevoke` �为 `false`。
+
+#### 入�字段表
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| advanceId | Path | Long | ✅ | 预支 ID | **��** |
+
+#### 出�字段表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| data.canRevoke | Boolean | 🆕 � `false` |
+| 其余字段 | — | **��** |
+
+#### 请求示例
+
+```http
+PUT /v3/admin/order/advance/2105886444679774210/approve HTTP/1.1
+Authorization: Bearer <财务 token>
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "id": "2105886444679774210",
+    "status": "APPROVED",
+    "statusText": "已通过",
+    "approvedBy": "yaosutu",
+    "canRevoke": false
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+无。
+
+#### 错误�应
+
+判���。预支�存在（财务 / 管�员）：
+
+```json
+{
+  "code": 585000,
+  "message": "预支记录�存在",
+  "data": null,
+  "success": false
+}
+```
+
+#### 业务边界
+
+- 审批逻辑与出纳待付款的生���。
+
+---
+
+### 6. 预支审批驳回 `PUT /v3/admin/order/advance/:advanceId/reject`
+
+**VO**: `RejectAdvanceReqVO` → `Result<OrderAdvanceRespVO>`
+
+#### 使用场景
+
+审批中心「驳回�。驳回�状�是已驳回，`canRevoke` �为 `false`。
+
+#### 入�字段表
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| advanceId | Path | Long | ✅ | 预支 ID | **��** |
+| reason | Body | String | ✅ | 驳回原因 | **��** |
+
+#### 出�字段表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| data.canRevoke | Boolean | 🆕 � `false` |
+| 其余字段 | — | **��** |
+
+#### 请求示例
+
+```json
+{
+  "reason": "门票已由地接社统一采购，无需个人垫付"
+}
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "id": "2104861622562627585",
+    "status": "REJECTED",
+    "statusText": "已驳回",
+    "rejectReason": "门票已由地接社统一采购，无需个人垫付",
+    "canRevoke": false
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+无。
+
+#### 错误�应
+
+判���。预支�存在（财务 / 管�员）：
+
+```json
+{
+  "code": 585000,
+  "message": "预支记录�存在",
+  "data": null,
+  "success": false
+}
+```
+
+#### 业务边界
+
+- 驳回逻辑��。
+
+---
+
+### 7. �起团期级预支 `POST /v3/admin/order/group-batch/:groupBatchId/advance`
+
+**VO**: `CreateGroupBatchAdvanceReqVO` → `Result<OrderAdvanceRespVO>`
+
+#### 使用场景
+
+团期财务页签「�起预支�。返回体里 `canRevoke` 对�起人本人为 `true`；团期管�员�起的为 `false`（团期管�员撤回会先被 `581008` 拦下）。
+
+#### 入�字段表
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| groupBatchId | Path | Long | ✅ | 团期 ID | **��** |
+| payeeStaffId | Body | Long | ✅ | 团期人员 | **��** |
+| advanceType | Body | String | ✅ | 字典 `advance_type` | **��** |
+| amount | Body | BigDecimal | ✅ | >0，�超团期统一池上� | **��** |
+| purpose | Body | String | � | — | **��** |
+| voucherUrl | Body | String | � | — | **��** |
+
+#### 出�字段表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| data.canRevoke | Boolean | 🆕 �起人本人为 `true`，团期管�员为 `false` |
+| 其余字段 | — | **��** |
+
+#### 请求示例
+
+```json
+{
+  "payeeStaffId": "2100747615736897537",
+  "advanceType": "CATERING",
+  "amount": 600.00,
+  "purpose": "满洲里套娃广场团�代垫"
+}
+```
+
+#### �应示例
+
+示例值（�起人本人调用）：
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "id": "2105890177461317634",
+    "orderId": null,
+    "status": "SUBMITTED",
+    "statusText": "待审批",
+    "amount": 600.0,
+    "canRevoke": true
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+无。
+
+#### 错误�应
+
+判�与校验��。团期�存在：
+
+```json
+{
+  "code": 589500,
+  "message": "团期�存在",
+  "data": null,
+  "success": false
+}
+```
+
+#### 业务边界
+
+- �是返回体多一个字段，创建逻辑与�度池��。
+
+---
+
+### 8. 核�汇总快照 `GET /v3/admin/order/:orderId/settlement/summary`
+
+**VO**: `Result<SettlementSummaryRespVO>`
+
+#### 使用场景
+
+核�页的汇总快照。`advanceSummary.records` 与预支列表共用�一个 VO，所以一并带上 `canRevoke`。这里�列已通过的预支，�为 `false`。
+
+#### 入�字段表
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| orderId | Path | Long | ✅ | 订� ID | **��** |
+
+#### 出�字段表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| advanceSummary.records[].canRevoke | Boolean | 🆕 � `false`（��已通过） |
+| 其余字段 | — | **��** |
+
+#### 请求示例
+
+```http
+GET /v3/admin/order/2100743225424621570/settlement/summary HTTP/1.1
+Authorization: Bearer <管�员 token>
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "settled": false,
+    "orderId": "2100743225424621570",
+    "teamNo": "26-8707",
+    "advanceSummary": {
+      "approvedAmount": "90.00",
+      "records": [
+        {
+          "id": "2105886444679774210",
+          "status": "APPROVED",
+          "statusText": "已通过",
+          "amount": 90.0,
+          "canRevoke": false
+        }
+      ]
+    }
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+没有已通过的预支时 `records` 为空数组（��）。
+
+#### 错误�应
+
+本接�没有业务错误�，订��存在时也返回 `200` 和 `settled=false` 的空壳（行为��）。网关层未带 token（TEST 2026-10-02 实打）：
+
+```json
+{
+  "code": 401,
+  "message": "缺少有效的 Authorization 头",
+  "data": null,
+  "success": false
+}
+```
+
+#### 业务边界
+
+- �端�需�用这里的 `canRevoke`。
+
+---
+
+## 四�契约约�与正确调用方�
+
+- 撤回按钮显示�件改� `a.canRevoke`，���自己拼「待审批 + 角色 + 是�团期管�员�。
+- `canRevoke` 跟�当�登录账�和当�角色�；切�角色���新拉列表。
+- `canRevoke=true` �表示列表渲染那一刻能撤；点击时若已被别人审批，�会返回 `585005`（状���许），照常�示��。
+- 撤回接�的判�与错误���：�申请人��管�员 `585009`，团期管�员 `581008`。
+
+---
+
+## 五�数�库行为
+
+- 零 DDL�零数��移�零写入。
+- �值用预支记录既有的创建人账� ID（�交时自动写入）；审批中心的�表查询多 select 这一列，�出�。
+- �起�审批�驳回的写库逻辑��。
+
+---
+
+## 六�边界行为
+
+- 定时任务�消�消费等无请求上下文的场景算出��为 `false`（这些场景�渲染列表）。
+- 计算 `canRevoke` �打 `ADVANCE_ACL_DENY` 日志；�有真调撤回被拒时�打。
+- 缺角色的 token 若正好是申请人本人，`canRevoke=true`，与撤回接�一致（#8517 有�的设计）。
+
+## 六.6�修改��对比
+
+| 场景 | 改� | 改� |
+|---|---|---|
+| �申请人��管�员看待审批行 | 按钮显示，点了 `585009` | `canRevoke=false`，�端��� |
+| 申请人本人 / 管�员看待审批行 | 按钮显示，能撤 | `canRevoke=true` |
+| 团期管�员看团期页签 | �端用 `!isGroupBatchManager` 自己� | `canRevoke=false` |
+| �待审批行 | �端按状�� | `canRevoke=false` |
+| 开关关闭 | �端�知�开关状� | �团期管�员都为 `true`，跟撤回接�一致 |
+
+## 六.7�影�评估
+
+- **是�破���兼容**：�，纯新增字段。
+- **�端是�必须�步上线**：�。�改�端时行为与改�相�（按钮照旧显示）；改了�能��点�了的按钮。
+- **回滚**：revert PR #8723 ��新部署 order-v3。
+
+---
+
+## 七��影�范围
+
+- 撤回接� `DELETE /v3/admin/order/advance/:advanceId` 的判�与返回：��。
+- �接�的入��判��其余出�：��。
+- 出纳付款�核�计算：��。
+- �程�端：无影�。
+
+---
+
+## 八�测试环境已验�
+
+**环境**：TEST（`https://api.test.1814.love`）　**验�时间**：2026-10-02 13:03~13:30
+**构建身份**：order-v3 部署 `dev-v3 @ 806058c66`（本��并�交），12:57 完�。零写入判�：部署�连查 6 次订�级预支列表，�行都带 `canRevoke` 键（旧字节没有这个键）。
+**身份**：自签 token 直打网关，用 TEST 真实账� ID �对应角色；TEST 上没有在用的财务账�，财务用 `role=FINANCE` 的自签 token。
+
+### 8.1 造数
+
+在待出�订� `HL20260918082629372`（定制师 1001）上：C1 定制师申请门票 180（待审批）�C2 管�员 jw 申请�费 120（待审批）�C3 定制师申请门票 90 �由财务审批（已通过）。�有该�既有的已付款�已驳回�一笔。
+
+### 8.2 三个列表�角色�值
+
+| 列表 | 查看人 | C1（1001 申请，待审批） | C2（jw 申请，待审批） | 已通过 / 已付款 / 已驳回 |
+|---|---|---|---|---|
+| 订�级 | 本�定制师 1001 | `true` | `false` | � `false` |
+| 订�级 | 管�员 | `true` | `true` | � `false` |
+| 订�级 | 车务管�员 | `false` | `false` | � `false` |
+| 审批中心 | 财务 | `false` | `false` | 已通过 `false` |
+| 审批中心 | 管�员 | `true` | `true` | 已通过 `false` |
+
+团期财务页签（团期级待审批一笔，jw 申请）：财务 `false`�团期管�员 `false`�管�员 `true`。
+�表探针：财务角色�账� ID 设为 1001 查审批中心，C1 为 `true`�C2 为 `false`，�明审批中心带出了创建人。
+核�汇总：�� C3，`canRevoke=false`。
+
+### 8.3 按 canRevoke 抽样真实撤回
+
+| �作 | 结果 |
+|---|---|
+| 财务�其他定制师撤 C1；车务�定制师 1001 撤 C2（�为 `false`） | � `585009`，未删除 |
+| 团期管�员撤 C1 | `581008` |
+| 定制师 1001 撤 C1�管�员撤 C2（�为 `true`） | � `200`，已软删 |
+
+### 8.4 nacos 回滚开关往返
+
+| � | 订�级：定制师 / 车务看 C2 | 团期页签：财务 / 团期管�员 | 审批中心：财务看 C1�C2�团期级 |
+|---|---|---|---|
+| A 默认 | `false` / `false` | `false` / `false` | 全 `false` |
+| B 关闭（10.5 秒生效） | `true` / `true` | `true` / `false` | 全 `true` |
+| C 还原（7.7 秒生效） | `false` / `false` | `false` / `false` | 全 `false` |
+
+- �布带 `casMd5`，还原写在 `finally` 里；还原� md5 与原值�为 `c2206934960057f70b7173159046dc54`。
+- 两个实例的 `ADVANCE_ACL_DENY` 计数在三�的列表渲染��都是 0；�� 4 次被拒的真实撤回让计数� +2，�明计数有效。
+
+### 8.5 回归（零写入）
+
+�存在的预支 ID 调审批 / 驳回 / 撤回：定制师�车务 `585008` / `585008` / `585009`；财务 `585000` / `585000` / `585009`；管�员三个 `585000`；团期管�员三个 `581008`。与 #8517 验收读数一致，��表行数��。
+
+### 本地��
+
+| 项 | 读数 |
+|---|---|
+| 相关 16 个测试类定� | 265/0/0/0 |
+| 一致性矩阵 | `canRevoke` 与撤回守�在 144 �角色 × 账� × 创建人 × 开关组�下��一致 |
+| �异 | 删掉审批中心�表那一列 → 1 例红；让 `canRevoke` 对财务放宽 → 2 例红；已还原 |
+| order-v3 全�（有 Docker，两�） | 1115 个�执行测试类全部有报告；红 2 个类�`hl-finance` 红 25 个类，在基底 `3bad2ad27` 上读数与用例���一致，本�零新增 |
+
+---
+
+## ��相关文档
+
+- Issue `#8684`ï¼›PR `#8723`
+- �置：Issue `#8517`（撤回判�本身）
+
+## 关� / �系人
+
+### 链接
+
+- **Issue**: [#8684](https://git.1814.love/wx/HL/issues/8684)
+- **PR**: [#8723](https://git.1814.love/wx/HL/pulls/8723)
+- **Merge commit**: [806058c66](https://git.1814.love/wx/HL/commit/806058c66)
+
+### �系人
+
+- **�端负责人**: @jw