From 694c1a71be6e8e8ee2991c939d2f21a8b03576c7 Mon Sep 17 00:00:00 2001
From: jw <jinwei@1814.love>
Date: Thu, 24 Sep 2026 17:36:41 +0800
Subject: [PATCH] =?UTF-8?q?changelog:=20#8355=20=E5=9B=A2=E6=9C=9F?=
 =?UTF-8?q?=E5=85=AD=E8=8A=82=E7=82=B9=E6=B5=81=E7=A8=8B=E5=89=8D=E7=AB=AF?=
 =?UTF-8?q?=E5=AF=B9=E6=8E=A5=E6=80=BB=E8=A7=88=EF=BC=88=E8=A1=A5=20#8270?=
 =?UTF-8?q?=20/=20#8308=20/=20#8309=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 ...Ž¥æ€»è§ˆä¸Žé¢„支æµ�团å�ˆå�Œå‡ºå…·æ�ƒé™�补录-修改接å�£-管ç�†å�Žå�°.md | 1018 +++++++++++++++++
 1 file changed, 1018 insertions(+)
 create mode 100644 changelogs-v2/2026-09/24_8355_团期六节点�程�端对接总览与预支�团��出具��补录-修改接�-管���.md

diff --git a/changelogs-v2/2026-09/24_8355_团期六节点�程�端对接总览与预支�团��出具��补录-修改接�-管���.md b/changelogs-v2/2026-09/24_8355_团期六节点�程�端对接总览与预支�团��出具��补录-修改接�-管���.md
new file mode 100644
index 00000000..b84e4d7a
--- /dev/null
+++ b/changelogs-v2/2026-09/24_8355_团期六节点�程�端对接总览与预支�团��出具��补录-修改接�-管���.md
@@ -0,0 +1,1018 @@
+---
+schema: "hl-changelog/v2"
+ticket: "8355"
+title: "团期六节点�程�端对接总览：�张��端改动一张表；补录三处未推 changelog 的行为�化——预支核�����起且去掉四项��门（#8270）��团�能在确认��起与批�且审批中心 canApprove 确认�� false（#8308）����险出具 / �开 / 催签授团期管�员（#8309）"
+consumer: "admin"
+author: "jw(GIT)"
+change_type: "修改接�"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: "2026-09-24"
+status_note: "团期�程改为六节点（招募 → �置 → 确认 → 出行 → 核� → 结算，SRS §0.27 / §0.27.7）�，�端 #8267～#8271�#8308�#8309�#8339～#8341 已�入 dev-v3 并部署 TEST。本�是给�端的总览：第〇节一张表列出�张��自�改的�端�置�对应 changelog；�补录三处当时按「契约四项未改����但会改��端行为的�。① #8270（PR #8272）POST /v3/admin/order/group-batch/{groupBatchId}/advance 删除四项��门（589542 ��抛出），起点�移到�置节点；�� #8322 ��移到招募中，当�代��径为 RECRUITING～TRIP_FINISHED ���核�中 / 已结算 / 已�团 589541「当�团期状����起预支（进入核��关闭）�，该接��端已� 24_8322 交付。② #8308（PR #8313�#8315）�起�团 POST .../{groupBatchId}/disband 与���团 POST .../disband/{approvalId}/approve �在 RECRUITING / RESOURCE_PREPARING 放行，确认�之�返 589544，文案由「团期已出行，���起或批��团�改为「团期已确认，���起或批��团�；审批中心列表 GET .../approvals/page 与�团详情 GET .../disband/{approvalId} 的�团行 canApprove 在团期确认�� false；确认��交�确认时�待审批的申请�在 PENDING，�能驳回。③ #8309（PR #8312）contracts/issue�reissue�remind-sign 的��� group-batch:contract:issue 新授团期管�员 GROUP_BATCH_MANAGER（user-service Flyway V20260924_8309，��缓存 10 分钟）；团期确认�户确认行程自动出具���险（#8339 起由团期确认�户驱动）。三处路径�入��出�结构���。�端需：�团按钮确认����审批中心��按钮按 canApprove；团期管�员显示���险出具 / �开 / 催签按钮；其余�第〇节。"
+updated_at: "2026-09-24"
+base: "dev-v3"
+---
+
+# 团期六节点�程�端对接总览 + 预支 / �团 / ���险出具��补录（管���）
+
+> **�务**: hl-order-service-v3（端� 8086/8186）；hl-user-service（����，仅 #8309）
+> **PR**: #8272（#8270）�#8313 / #8315（#8308）�#8312（#8309）
+> **Issue**: #8355（本�）；补录 #8270�#8308�#8309；总览覆盖 #8267～#8271�#8308�#8309�#8339～#8341
+> **日期**: 2026-09-24
+> **影�范围**: 管���团期详情（工具��步骤��财务 / ���险 / �置�页签）�团期看��团期审批中心�订�详情（团期�）�房务抢�池
+
+---
+
+## ⚠� 关键�化
+
+1. **�端改动一次看全**：第〇节按工�列出�张��自�改的�端�置和对应 changelog，已推的五份（24_8268 / 24_8269 / 24_8271 / 24_8339 / 24_8341）与 24_8322 ���展开，�给指引。
+2. **�团�能在「确认�之��起**（#8308）：团期进入确认（`MATERIAL_PREPARING`）�之�，�起�团����团一律返 **589544**，文案改为「团期已确认，���起或批��团�。团期详情的「�团�按钮在确认�应��。
+3. **审批中心�团行 `canApprove` 在团期确认�� false**（#8308）：列表与�团详情两处��径，�端按 `canApprove` 显示「�����，��自己拼�件。确认��交�确认时还没批的�团申请会�在待审批，�能驳回。
+4. **团期管�员�以出具 / �开 / 催签���险**（#8309）：`group-batch:contract:issue` 新授 `GROUP_BATCH_MANAGER`。登录信��下����，�端若按角色控制这三个按钮，需�把团期管�员加进去。
+5. **预支���求四项��**（#8270）：`589542` ��返回；当��许状�为招募中～出行完毕（#8322 在 #8270 基础上�放开招募中）。该入��端已� 24_8322 交付，此处�补 #8270 的说明。
+
+---
+
+## 〇��端改动总清�（�张�）
+
+> �� SRS §0.27 / §0.27.7（`docs/group/团期模�一期实施拆分详细设计-v1.0.html`，dev-v3）与��验收评论。「�端状���对应 changelog 的 `frontend_status`。
+
+| 工� | �端�化（一��） | �端�改什么 | changelog | �端状� |
+|---|---|---|---|---|
+| #8267 | 自动�团改为**满团**（户数或人数任一达满团容�，待支付算��）；��按最低�团门槛自动�团 | **无代�改动**。�团时机�了：达到最低门槛�会�自动进入�置节点，需人工点「�团�或等满团；页�上的门槛�作�考 | 无（定时任务判��化，按���径未推） | — |
+| #8268 | 新增人工「确认�端点（�置 → 确认），门�满足 589556 �项回执；确认物资�在�置节点�调；`recheck-material-gate` 下线 | 团期详情新增「确认�按钮（仅 `RESOURCE_PREPARING`）并展示 589556 �项未满足项；「确认物资�挪到�置节点；移除物资门�判入� | 24_8268（bfc1a32） | verified（hl-admin@72b5e17c） |
+| #8269 | 确认�导摄 / 物资 / 订房计划 / 分房 / 需求确认与打回 / 正�用车需求 / 抢�池等写�一律拒� | 确认���或置�上述�置写�作，按新文案�示（589598 / 808600 / 809111 等）；房务抢�池 `batchStatus` 筛选��留「资�准备中�（其它值 400） | 24_8269（bfc1a32） | pending |
+| #8270 | 预支删除四项��门（589542 ��返回），�置节点起��；#8322 �放开到招募中，进入核��关闭 | 「�起预支�按钮��按四项��置�，按团期状�判断：招募中～出行完毕�用，核�中 / 已结算 / 已�团置� | **本�**（接� 1）；�� 24_8322 | 已� 24_8322 交付（verified） |
+| #8271 | 看�改七桶�统计� 13 键；分页 / 详情 / 看�行新增 `stage` / `stageName` / `tripSubStatus` / `tripSubStatusName`；核团 / 验团用语改核� / 结算 | 看�页签与统计�切七桶（`total` �等于七桶之和，��对 `buckets` 整体求和）；详情步骤�按 `stage` / `tripSubStatus` 展示；文案「核团 / 验团�改「核� / 结算� | 24_8271（bfc1a32） | pending |
+| #8308 | �起�团����团�在招募 / �置；确认� 589544；审批中心与�团详情的�团行 `canApprove` 确认�� false | 团期详情「�团�按钮在确认�（`stage` �是 `RECRUIT` / `CONFIGURE`）��；审批中心「���按钮�看 `canApprove`；589544 �传�端文案 | **本�**（接� 2～5） | pending |
+| #8309 | `group-batch:contract:issue` 授团期管�员；团期确认�户确认行程自动出具���险 | 「���险�页签的出具 / 作废�开 / 催签按钮对 `GROUP_BATCH_MANAGER` 显示；确认�无需人工出具（自动出） | **本�**（接� 6～8） | pending |
+| #8339 | 团期确认连带�户确认行程；589556 改为「；�分段�户回执；团期�在团期确认��户确认返 581065；时间线新事件 `BATCH_SUB_ORDER_CONFIRM_FAILED` | 团期�订�详情在团期确认���或置�「确认行程�并处� 581065；589556 按「；�分段�户展示；时间线显示新事件（`eventTypeName` �端已给） | 24_8339（846822a） | pending |
+| #8340 | 团期��订�出� / 返团�团期（1007 ��推团期�，1041 / 1042 �步推�订�） | **无代�改动**。团期��订�的「出行中�「已完��时点改为跟�团期；团期没出�，�订�也�出� | 无（定时任务行为�化，按���径未推） | — |
+| #8341 | 团期进入核� / 结算 / �结算�步�订�；团期结算有�户核�未�交的户返 589568 并列订� ID | 团期结算处� 589568 新原因（�示先去对应订��交�户核�）；团期结算���引导�户点「结算确认�，�订�核� / 结算状��团期 | 24_8341（846822a） | pending |
+
+**按页�归并**（�一页�的改动集中在这里，便于排期）：
+
+| 页� | 改动 | �� |
+|---|---|---|
+| 团期看� | 页签与统计�七桶；阶段�改核� / 结算 | #8271 |
+| 团期详情 · 步骤� | 六节点 + 出行�状�，读 `stage` / `tripSubStatus` | #8271 |
+| 团期详情 · 工具� | 「确认�按钮（�置节点）；「�团�按钮�在招募 / �置显示 | #8268�#8308 |
+| 团期详情 · �置类页签（人员 / 物资 / 订房 / 分房 / 需求 / 用车） | 确认�写�作��或置�；确认物资挪到�置节点 | #8268�#8269 |
+| 团期详情 · 财务 | 预支入�招募中～出行完毕�用 | #8270�#8322 |
+| 团期详情 · ���险 | 确认���出具；团期管�员��出具 / �开 / 催签 | #8268�#8309�#8339 |
+| 团期详情 · 结算 | 589568 未�交户�示 | #8341 |
+| 团期详情 · 时间线 | 新事件 `BATCH_SUB_ORDER_CONFIRM_FAILED` | #8339 |
+| 团期审批中心 | �团行「���按 `canApprove` | #8308 |
+| 订�详情（团期�） | 团期确认���「确认行程�，处� 581065 | #8339 |
+| 房务抢�池 | `batchStatus` 筛选�留资�准备中 | #8269 |
+
+---
+
+## 一�背景
+
+jw 2026-09-23 定案团期六节点（SRS §0.27），2026-09-24 补充�订�跟�团期（§0.27.7）与�团收窄（§0.27.4 #2）。�张�端��已�入 dev-v3�部署 TEST 并验收关�，其中五张推了 changelog；#8270�#8308�#8309 当时按「接�� / 入� / 出� / 返回结构�未改���未推，但三者都改�了�端按钮的�用�件或��角色，本�补录。#8267�#8340 是定时任务行为�化，无�端代�改动，�在第〇节说明时机�化。
+
+| 节点 | �久� `batchStatus` | 派生 `stage`（#8271） | ��团 | �预支 | �出具���险 |
+|---|---|---|---|---|---|
+| 招募 | `RECRUITING` | `RECRUIT` | ✅ | ✅ | � |
+| �置 | `RESOURCE_PREPARING` | `CONFIGURE` | ✅ | ✅ | � |
+| 确认 | `MATERIAL_PREPARING` | `CONFIRM` | � 589544 | ✅ | ✅ |
+| 出行 | `PENDING_DEPARTURE` / `TRAVELLING` / `TRIP_FINISHED` | `TRIP` | � 589544 | ✅ | ✅ |
+| 核� | `REVIEWING` | `REVIEW` | � 589544 | � 589541 | ✅ |
+| 结算 | `SETTLED` | `SETTLE` | � 589544 | � 589541 | ✅ |
+| 已�团 | `CANCELLED` | `DISBANDED` | � 589544 | � 589541 | � 589548 |
+
+---
+
+## 二��更接�清�
+
+| # | 接� | 方法 | 路径 | �更类型 | 说明 |
+|---|------|------|------|----------|------|
+| 1 | �起团期预支（GB-ADM-042） | POST | `/v3/admin/order/group-batch/{groupBatchId}/advance` | 修改（�置门放宽 + 错误��用 + 文案） | #8270：删除四项��门，589542 ��返回，�置节点起��；当��径（� #8322）招募中～出行完毕 |
+| 2 | �起�团申请（GB-ADM-060） | POST | `/v3/admin/order/group-batch/{groupBatchId}/disband` | 修改（�置门收窄 + 文案） | #8308：�在招募 / �置��起，确认� 589544，文案改 |
+| 3 | ���团（GB-ADM-062） | POST | `/v3/admin/order/group-batch/disband/{approvalId}/approve` | 修改（�置门收窄 + 文案） | #8308：团期已确认时拒�执行 589544，申请�待审批 |
+| 4 | 团期审批中心列表（GB-ADM-061） | GET | `/v3/admin/order/group-batch/approvals/page` | 修改（出��值） | #8308：�团行 `canApprove` 在团期确认�� false |
+| 5 | �团申请详情（GB-ADM-061） | GET | `/v3/admin/order/group-batch/disband/{approvalId}` | 修改（出��值） | #8308：`canApprove` �接� 4 |
+| 6 | 手动开�� / �险（GB-ADM-031） | POST | `/v3/admin/order/group-batch/{groupBatchId}/contracts/issue` | 修改（授�角色） | #8309：团期管�员�调 |
+| 7 | 作废�开�� / �险（GB-ADM-031） | POST | `/v3/admin/order/group-batch/{groupBatchId}/contracts/reissue` | 修改（授�角色） | #8309：�上 |
+| 8 | 批�催签�� | POST | `/v3/admin/order/group-batch/{groupBatchId}/contracts/remind-sign` | 修改（授�角色） | #8309：�上 |
+
+路径�HTTP 方法�入���功出�结构���；网关无改动（�在既有 `/v3/admin/order/group-batch` �缀下）；无新增错误�；#8309 新增一� user-service ����，无 order-v3 schema �更。
+
+---
+
+## 三�接�详情
+
+### 1. �起团期预支 `POST /v3/admin/order/group-batch/{groupBatchId}/advance`
+
+**VO**: `CreateGroupBatchAdvanceReqVO` → `OrderAdvanceRespVO`
+
+#### 使用场景
+
+团期详情「财务�页签点「�起预支�。#8270 起���求房 / 车 / 导游领队 / 摄影四项��，�置节点���；#8322 �把起点�移到招募中。下�按**当� dev-v3 代�**（#8270 + #8322 ���）�述，领款人�定主报账人（589557）的细节� 24_8322。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| groupBatchId | Path | Long | ✅ | 订�侧团期主键 | �存在 589500（��） |
+| payeeStaffId | Body | Long | ✅ | 须为本团主报账人 | �领款人候选接�返回的 `id`（#8322） |
+| advanceType | Body | String | ✅ | 字典 `advance_type` | 借款类型（��） |
+| amount | Body | BigDecimal | ✅ | ≥ 0.01 且 ≤ 团期统一池�用余� | 超� 585004（��） |
+| purpose | Body | String | � | ≤ 255 字 | 用途说明（��） |
+| voucherUrl | Body | String | � | ≤ 512 字符 | 凭� URL（��） |
+
+#### 出�
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | Long(String) | 预支� ID（��） |
+| orderId | Long | 团期级预支� null（��） |
+| payeeStaffId / payeeName / payeeRole | String | 领款人快照（��） |
+| advanceType / amount / purpose / voucherUrl | - | �入�（��） |
+| status / statusText | String | 创建�� `SUBMITTED` / 「待审批�（��） |
+| createdByName / createTime / submittedAt | String | �起人与时间（��） |
+
+#### 请求示例
+
+```http
+POST /v3/admin/order/group-batch/2102696181195001858/advance HTTP/1.1
+Host: api.test.1814.love:9443
+Authorization: Bearer <admin token>
+Content-Type: application/json
+
+{
+  "payeeStaffId": 1002,
+  "advanceType": "TICKET",
+  "amount": 100,
+  "purpose": "门票备用金"
+}
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "id": "2102968264214872066",
+    "orderId": null,
+    "payeeStaffId": "1002",
+    "payeeName": "�雪梅",
+    "payeeRole": "GUIDE",
+    "advanceType": "TICKET",
+    "amount": 100,
+    "purpose": "门票备用金",
+    "voucherUrl": null,
+    "status": "SUBMITTED",
+    "statusText": "待审批",
+    "createdByName": "admin",
+    "createTime": "2026-09-24 11:48:00",
+    "submittedAt": "2026-09-24 11:48:00"
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+写接�，无空数�形�；任何校验失败零写入。时间线 `BATCH_ADVANCE` 写入失败��级告警，�影�预支�创建（��）。
+
+```json
+{ "code": 200, "message": "�功", "data": { "id": "2102968264214872066", "status": "SUBMITTED" }, "success": true }
+```
+
+#### 错误�应
+
+团期处于核�中 / 已结算 / 已�团（文案为当�代�值，�六.6 沿�）：
+
+```json
+{
+  "code": 589541,
+  "message": "当�团期状����起预支（进入核��关闭）",
+  "success": false,
+  "data": null
+}
+```
+
+| code | 触� | 说明 |
+|---|---|---|
+| 589541 | `batchStatus` �在招募中～出行完毕 | 文案两次�化，�六.6 |
+| 589542 | — | **#8270 起��返回**（四项��门已删除，���留��用） |
+| 585007 / 589557 | 领款人�在本团 / �是主报账人 | � 24_8322 |
+| 585004 | 超团期统一池�用余� | �� |
+| 589507 | 角色无 `group-batch:finance:advance` | ��（团期管�员�未授此�） |
+
+#### 业务边界
+
+- �许状�：`RECRUITING`�`RESOURCE_PREPARING`�`MATERIAL_PREPARING`�`PENDING_DEPARTURE`�`TRAVELLING`�`TRIP_FINISHED`；`REVIEWING` / `SETTLED` / `CANCELLED` 拒 589541。
+- #8270 本身�加了 `RESOURCE_PREPARING` 并删四项门；`RECRUITING` 由 #8322 放开。
+- �看团期状���看四项 ready �；超支�由团期统一池上�兜�。
+- 校验顺�：589500 → 589541 → 585007 → 589557 → 借款类型 → 585004。
+
+---
+
+### 2. �起�团申请 `POST /v3/admin/order/group-batch/{groupBatchId}/disband`
+
+**VO**: `DisbandSubmitReqVO` → `DisbandApprovalRespVO`
+
+#### 使用场景
+
+团期详情工具�「�团�按钮，�交�团审批申请（批准��真正�团）。#8308 起�在招募��置两个节点��起；团期人工确认之�（确认 / 出行 / 核� / 结算）一律拒�，确认��户退出走退�审批。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| groupBatchId | Path | Long | ✅ | 团期主键 | �� |
+| reason | Body | String | ✅ | �空，≤ 512 字 | �团�由（��） |
+
+#### 出�
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| approvalId | Long | 审批� ID（��） |
+| groupBatchId / batchNo / batchName / batchLabel | - | 团期信�（��） |
+| approvalStatus / approvalStatusName | String | 新建� `PENDING` / 「待审批�（��） |
+| affectedOrderCount / participantCount / estimatedRefundAmount | - | �交时快照（��） |
+| applicantId / applicantName / ccUserNames / createTime | - | �� |
+| canApprove | Boolean | 当�用户能�批；�径�接� 5（本次新增阶段�件） |
+
+#### 请求示例
+
+```json
+{
+  "reason": "临近出团�未达最低�团数（6 户）"
+}
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "approvalId": "2102949786913333999",
+    "groupBatchId": "2102946606599028738",
+    "batchNo": "GT-26-0004",
+    "batchName": "�蒙马�季亲��",
+    "batchLabel": "1",
+    "approvalStatus": "PENDING",
+    "approvalStatusName": "待审批",
+    "reason": "临近出团�未达最低�团数（6 户）",
+    "affectedOrderCount": 1,
+    "participantCount": 2,
+    "estimatedRefundAmount": 0.00,
+    "actualRefundAmount": null,
+    "applicantName": "团期管�员",
+    "ccUserNames": [],
+    "canApprove": false
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+团期下无活跃�订�时照常建�，`affectedOrderCount=0`�`estimatedRefundAmount=0`�`ccUserNames` 为空数组（��）：
+
+```json
+{ "code": 200, "message": "�功", "data": { "approvalStatus": "PENDING", "affectedOrderCount": 0, "estimatedRefundAmount": 0, "ccUserNames": [] }, "success": true }
+```
+
+#### 错误�应
+
+团期已确认（`MATERIAL_PREPARING` �之�，�已结算 / 已�团）：
+
+```json
+{
+  "code": 589544,
+  "message": "团期已确认，���起或批��团",
+  "success": false,
+  "data": null
+}
+```
+
+| code | 触� | 说明 |
+|---|---|---|
+| 589544 | 团期�在 `RECRUITING` / `RESOURCE_PREPARING` | **�径收窄 + 文案改**（原「团期已出行，…�） |
+| 589543 | 已有一�待审批�团申请 | �� |
+| 589554 | 团期下有出行中的�订� | �� |
+| 589507 | 无 `group-batch:manage` | �� |
+
+#### 业务边界
+
+- 判定顺�：589507 → 589500 → 589544 → 589543 → 589554。
+- 改� `MATERIAL_PREPARING` / `PENDING_DEPARTURE` ��起，改�拒 589544。
+- �建申请��写团期时间线 `BATCH_DISBAND_SUBMIT`，�动团期��订����和钱（��）。
+
+---
+
+### 3. ���团 `POST /v3/admin/order/group-batch/disband/{approvalId}/approve`
+
+**VO**: `ApproveDisbandReqVO` → `DisbandApprovalRespVO`
+
+#### 使用场景
+
+审批中心 / �团详情的「���。批准��执行�团（团期置已�团��户退款�释放�车）。#8308 起执行��按团期**当�**状�判一次：�置节点�交�批��团期已被人工确认的申请，��时拒�执行。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| approvalId | Path | Long | ✅ | �团审批� ID | �存在 589545（��） |
+| remark | Body | String | � | ≤ 512 字 | 批�备注；请求体��略（��） |
+
+#### 出�
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| approvalStatus / approvalStatusName | String | �功� `APPROVED` / 「已通过�（��） |
+| actualRefundAmount | BigDecimal | 已�起退款金�（��） |
+| approvedById / approvedByName / approvedAt / approveRemark | - | 批�信�（��） |
+| canApprove | Boolean | 已处�� false（��） |
+| 其余字段 | - | �接� 2（��） |
+
+#### 请求示例
+
+```json
+{
+  "remark": "确认无法�团，���团"
+}
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "approvalId": "2102949786913333999",
+    "groupBatchId": "2102946606599028738",
+    "approvalStatus": "APPROVED",
+    "approvalStatusName": "已通过",
+    "actualRefundAmount": 0.00,
+    "approvedByName": "admin",
+    "approveRemark": "确认无法�团，���团",
+    "canApprove": false
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+请求体�整体�传（��）；退款�由�交�的异步监�建出，`actualRefundAmount` 先�暂定值��交�回读定稿（��）。
+
+```json
+{}
+```
+
+#### 错误�应
+
+团期在申请�交�被人工确认（或已进入出行 / 核�）：
+
+```json
+{
+  "code": 589544,
+  "message": "团期已确认，���起或批��团",
+  "success": false,
+  "data": null
+}
+```
+
+| code | 触� | 说明 |
+|---|---|---|
+| 589544 | 团期当��在招募 / �置，且�是终� | **�径收窄 + 文案改**；整笔回滚，申请� `PENDING`�团期状��� |
+| 589501 | 团期已结算 / 已�团 | �� |
+| 589547 | �管�员（ADMIN / SUPER_ADMIN）批� | �� |
+| 589546 | 申请已处� | �� |
+| 589554 | 有出行中�订� | �� |
+
+#### 业务边界
+
+- 阶段判定走 CAS 白��（与�起共用�一集�），确认�到达的批� CAS �空�拒，�会�执行。
+- 被 589544 拒的申请**�会自动关闭**：审批中心 `canApprove=false` ��显示「���，需人工「驳回�（驳回接��看团期阶段，��）。
+- 团期�团的�端入�也应�团期确认��（�接� 2）。
+
+---
+
+### 4. 团期审批中心列表 `GET /v3/admin/order/group-batch/approvals/page`
+
+**VO**: `GroupBatchApprovalListReqVO` → `PageResult<GroupBatchApprovalItemRespVO>`
+
+#### 使用场景
+
+团期审批中心统一列表（�团 + 退�户）。「���按钮以 `canApprove` 为准。#8308 起�团行多一个�件：团期�在招募 / �置。退�户行�径��。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| bizType | Query | String | � | `DISBAND` / `WITHDRAW` | �传两类都�（��） |
+| approvalStatus | Query | String | � | `PENDING` / `APPROVED` / `REJECTED` | �� |
+| groupBatchId | Query | Long | � | - | �� |
+| batchName | Query | String | � | - | 团期�称 / 期��索（��） |
+| pageNum | Query | Integer | � | ≥ 1 | 默认 1（��） |
+| pageSize | Query | Integer | � | 1～100 | 默认 20（��） |
+
+#### 出�
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| records[].canApprove | Boolean | **�值�径�化**：�团行 = 管�员角色 且 `PENDING` 且团期存在且团期 `batchStatus ∈ {RECRUITING, RESOURCE_PREPARING}`；团期确认�� false |
+| records[].bizType / approvalStatus / groupBatchId / batchName 等 | - | �� |
+| total / pageNum / pageSize | - | �� |
+
+#### 请求示例
+
+```http
+GET /v3/admin/order/group-batch/approvals/page?bizType=DISBAND&approvalStatus=PENDING&pageNum=1&pageSize=20 HTTP/1.1
+Host: api.test.1814.love:9443
+Authorization: Bearer <admin token>
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "records": [
+      {
+        "approvalId": "2102949786913334001",
+        "bizType": "DISBAND",
+        "bizTypeName": "�团",
+        "groupBatchId": "2102949786913333250",
+        "batchName": "�蒙马�季亲��",
+        "approvalStatus": "PENDING",
+        "approvalStatusName": "待审批",
+        "orderId": null,
+        "affectedOrderCount": 1,
+        "canApprove": false
+      }
+    ],
+    "total": 1,
+    "pageNum": 1,
+    "pageSize": 20
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+无匹�时空页（��）：
+
+```json
+{ "code": 200, "message": "�功", "data": { "records": [], "total": 0, "pageNum": 1, "pageSize": 20 }, "success": true }
+```
+
+#### 错误�应
+
+```json
+{
+  "code": 589507,
+  "message": "无�作��（当�角色未授予团期��，或该团期�在您�下）",
+  "success": false,
+  "data": null
+}
+```
+
+#### 业务边界
+
+- `canApprove=false` 的待审批�团行�会出现在列表里（状��是待审批），�端���「���，�留「驳回�。
+- 退�户行（`WITHDRAW`）的 `canApprove` �径��。
+- �管�员角色（如 FINANCE）� false（��）。
+
+---
+
+### 5. �团申请详情 `GET /v3/admin/order/group-batch/disband/{approvalId}`
+
+**VO**: `DisbandApprovalRespVO`
+
+#### 使用场景
+
+审批中心点开�团申请的详情抽屉；「���按钮以 `canApprove` 为准，与列表��径。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| approvalId | Path | Long | ✅ | �团审批� ID | �存在 589545（��） |
+
+#### 出�
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| canApprove | Boolean | **�值�径�化**：`PENDING` 且团期 `batchStatus ∈ {RECRUITING, RESOURCE_PREPARING}` 且管�员角色；团期确认�� false |
+| 其余字段 | - | �接� 2（��） |
+
+#### 请求示例
+
+```http
+GET /v3/admin/order/group-batch/disband/2102949786913334001 HTTP/1.1
+Host: api.test.1814.love:9443
+Authorization: Bearer <admin token>
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "approvalId": "2102949786913334001",
+    "groupBatchId": "2102949786913333250",
+    "approvalStatus": "PENDING",
+    "approvalStatusName": "待审批",
+    "reason": "临近出团�未达最低�团数",
+    "affectedOrderCount": 1,
+    "estimatedRefundAmount": 0.00,
+    "approvedByName": null,
+    "canApprove": false
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+团期已软删时 `batchNo` / `batchName` 为 null�`canApprove=false`（��）：
+
+```json
+{ "code": 200, "message": "�功", "data": { "approvalStatus": "PENDING", "batchNo": null, "canApprove": false }, "success": true }
+```
+
+#### 错误�应
+
+```json
+{
+  "code": 589545,
+  "message": "�团申请�存在",
+  "success": false,
+  "data": null
+}
+```
+
+#### 业务边界
+
+- 与接� 4 �一判�（共用��团状�集），两处�会�一致。
+- 与接� 3 的拒��件一致：`canApprove=false` 时点「���必得 589544。
+
+---
+
+### 6. 手动开�� / �险 `POST /v3/admin/order/group-batch/{groupBatchId}/contracts/issue`
+
+**VO**: `GroupBatchContractIssueReqVO` → `GroupBatchIssueResultVO`
+
+#### 使用场景
+
+「���险�页签�户手动开�� / �险。#8309 起团期管�员也能用（此��有 ADMIN / SUPER_ADMIN）。团期确认�户确认行程会自动出具，本接�是出具失败时的人工补出通路。出具门�径� 24_8268 / 24_8339，本次��。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| groupBatchId | Path | Long | ✅ | 团期主键 | �� |
+| orderIds | Body | List&lt;Long&gt; | � | 须属本团 | 为空 = 本期全部活跃户（��） |
+| target | Body | String | ✅ | `CONTRACT` / `INSURANCE` / `BOTH` | �� |
+
+#### 出�
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| totalCount / successCount / failCount / skipCount | Integer | �� |
+| results[].orderId / target / outcome / message | - | `outcome` ∈ `SUCCESS` / `SKIPPED` / `FAILED`（��） |
+
+#### 请求示例
+
+```json
+{
+  "orderIds": ["2102947020270653443"],
+  "target": "CONTRACT"
+}
+```
+
+#### �应示例
+
+团期管�员调用，该户已自动出具（TEST 实测形�）：
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "totalCount": 1,
+    "successCount": 0,
+    "failCount": 0,
+    "skipCount": 1,
+    "results": [
+      { "orderId": "2102947020270653443", "target": "CONTRACT", "outcome": "SKIPPED", "message": "该户��已出具，自动跳过" }
+    ]
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+本期无活跃户时 `totalCount=0`�`results` 为空数组（��）：
+
+```json
+{ "code": 200, "message": "�功", "data": { "totalCount": 0, "successCount": 0, "failCount": 0, "skipCount": 0, "results": [] }, "success": true }
+```
+
+#### 错误�应
+
+角色未授 `group-batch:contract:issue`（ROOM_MANAGER / VEHICLE_MANAGER / CUSTOMIZER / FINANCE 等）：
+
+```json
+{
+  "code": 589507,
+  "message": "无�作��（当�角色未授予团期��，或该团期�在您�下）",
+  "success": false,
+  "data": null
+}
+```
+
+| code | 触� | 说明 |
+|---|---|---|
+| 589507 | 角色未授� | **团期管�员��返回**；其余角色�� |
+| 589548 | 团期未确认 | ��（24_8268 / 24_8339） |
+| 589549 | `target` �法 | �� |
+| 589512 | `orderIds` ��本团订� | �� |
+
+#### 业务边界
+
+- 授�：ADMIN�SUPER_ADMIN�**GROUP_BATCH_MANAGER（本次新增）**；其余角色 589507。
+- ���缓存 10 分钟：部署�最长 10 分钟内团期管�员��能 589507，之�自动生效（TEST 已过缓存验�）。
+- 判�顺�：589507 → 589500 → 589548 → 目标解�。
+
+---
+
+### 7. 作废�开�� / �险 `POST /v3/admin/order/group-batch/{groupBatchId}/contracts/reissue`
+
+**VO**: `GroupBatchContractIssueReqVO` → `GroupBatchIssueResultVO`
+
+#### 使用场景
+
+「开错��的补救通路：先作废该户现有����开。授�与接� 6 相�，团期管�员�用。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| groupBatchId | Path | Long | ✅ | 团期主键 | �� |
+| orderIds | Body | List&lt;Long&gt; | � | 须属本团 | �� |
+| target | Body | String | ✅ | `CONTRACT` / `INSURANCE` / `BOTH` | �� |
+| reason | Body | String | � | - | 作废原因（��） |
+
+#### 出�
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| totalCount / successCount / failCount / skipCount | Integer | �� |
+| results[] | List | �户结果（��） |
+
+#### 请求示例
+
+```json
+{
+  "orderIds": ["2102947020270653443"],
+  "target": "CONTRACT",
+  "reason": "方案选错"
+}
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "totalCount": 1,
+    "successCount": 1,
+    "failCount": 0,
+    "skipCount": 0,
+    "results": [
+      { "orderId": "2102947020270653443", "target": "CONTRACT", "outcome": "SUCCESS", "message": null }
+    ]
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+作废失败的户记 `FAILED`��进�开，�影�其他户（��）：
+
+```json
+{ "code": 200, "message": "�功", "data": { "totalCount": 1, "successCount": 0, "failCount": 1, "skipCount": 0, "results": [] }, "success": true }
+```
+
+#### 错误�应
+
+```json
+{
+  "code": 589507,
+  "message": "无�作��（当�角色未授予团期��，或该团期�在您�下）",
+  "success": false,
+  "data": null
+}
+```
+
+#### 业务边界
+
+- 与接� 6 �一�����一出具门；团期管�员改� 589507，改�放行。
+- �开�旧�� `VOIDED`�新�� `GENERATED`（TEST 实测）。
+
+---
+
+### 8. 批�催签�� `POST /v3/admin/order/group-batch/{groupBatchId}/contracts/remind-sign`
+
+**VO**: `GroupBatchContractRemindReqVO` → `GroupBatchIssueResultVO`
+
+#### 使用场景
+
+「���险�页签「批�催签�，�对��已出未签的户�短信。授�与接� 6 相�，团期管�员�用。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| groupBatchId | Path | Long | ✅ | 团期主键 | �� |
+| orderIds | Body | List&lt;Long&gt; | � | 须属本团 | 为空 = 本期全部已出未签户；请求体��略（��） |
+
+#### 出�
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| totalCount / successCount / failCount / skipCount | Integer | �� |
+| results[].target | String | � `CONTRACT`（��） |
+| results[].outcome / message | String | 未出具或已签的户 `SKIPPED`（��） |
+
+#### 请求示例
+
+```json
+{
+  "orderIds": ["2102947020270653443"]
+}
+```
+
+#### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "totalCount": 1,
+    "successCount": 1,
+    "failCount": 0,
+    "skipCount": 0,
+    "results": [
+      { "orderId": "2102947020270653443", "target": "CONTRACT", "outcome": "SUCCESS", "message": null }
+    ]
+  },
+  "success": true
+}
+```
+
+#### 空数� / �级�应
+
+没有已出未签的户时全部 `SKIPPED`，��短信��写时间线（��）：
+
+```json
+{ "code": 200, "message": "�功", "data": { "totalCount": 1, "successCount": 0, "failCount": 0, "skipCount": 1, "results": [ { "target": "CONTRACT", "outcome": "SKIPPED", "message": "该户��未出具或已签署，无需催签" } ] }, "success": true }
+```
+
+#### 错误�应
+
+```json
+{
+  "code": 589507,
+  "message": "无�作��（当�角色未授予团期��，或该团期�在您�下）",
+  "success": false,
+  "data": null
+}
+```
+
+#### 业务边界
+
+- 本接���出具门约�（��能催签说明已出具，��）。
+- 团期管�员改� 589507，改�放行；其余角色��。
+
+---
+
+## 四�契约约�与正确调用方�
+
+### ✅ 正确 / � 错误调用对照
+
+| 场景 | 调用 |
+|------|------|
+| ✅ �团按钮��性 | 团期 `stage ∈ {RECRUIT, CONFIGURE}` �显示「�团� |
+| � 确认��显示�团按钮 | 点了必 589544 |
+| ✅ 审批中心「��� | 直接读 `canApprove`；false 时�给「驳回� |
+| � �端自己按 `approvalStatus=PENDING` 显示「��� | 团期确认�点了必 589544 |
+| ✅ 预支按钮 | `batchStatus` 在核�之�（招募中～出行完毕）�用 |
+| � 按四项��置�预支 | 四项门已删除，会误挡 |
+| ✅ ���险出具 / �开 / 催签按钮 | 对 ADMIN / SUPER_ADMIN / GROUP_BATCH_MANAGER 显示；是��点�看�� `issuable`（�开 / 出具）|
+| � �对 ADMIN 显示 | 团期管�员无入�，�能找管�员代点 |
+
+### 按钮显�速查（按 `stage`）
+
+| 按钮 | RECRUIT | CONFIGURE | CONFIRM | TRIP | REVIEW | SETTLE | DISBANDED |
+|---|---|---|---|---|---|---|---|
+| �团 | ✅ | ✅ | � | � | � | � | � |
+| �起预支 | ✅ | ✅ | ✅ | ✅ | � | � | � |
+| 确认（#8268） | � | ✅ | � | � | � | � | � |
+| ���险出具 / �开 | � | � | ✅ | ✅ | ✅ | ✅ | � |
+| �置类写�作（#8269） | ✅ | ✅ | � | � | � | � | � |
+
+> 精确判定以 `batchStatus` 为准（`stage` 由其派生）；�置类写�作�接�的细分�径（如订房计划仅�置节点）� 24_8269。
+
+### 错误�处�
+
+- 589544：�传�端文案��；新文案「团期已确认，���起或批��团�。按旧文案「团期已出行��过字符串匹�的�改。
+- 589541：�传；文案两次�化，勿�字符串匹�。
+- 589542：��返回，针对它的分支�删除。
+
+---
+
+## 五�数�库行为
+
+| �端动作 | 外部�观察的写入 |
+|----------|------------------|
+| �起预支�功 | `order_advance` 一行（`scope=GROUP_BATCH`）+ 时间线 `BATCH_ADVANCE`（��）；被 589541 拒零写入 |
+| �起�团�功 | `group_batch_approval` 一行 `PENDING` + 时间线 `BATCH_DISBAND_SUBMIT`（��）；被 589544 拒零写入 |
+| ���团被 589544 拒 | 整笔回滚：审批�� `PENDING`�团期状�����订���消 |
+| 审批中心 / 详情读 | �读 |
+| 团期管�员出具 / �开 / 催签 | 与管�员调用相�的�� / �险 / 短信写入（��） |
+
+**Schema / 数��更**：order-v3 零 schema �更。hl-user-service 新增 Flyway `V20260924_8309__grant_group_batch_manager_contract_issue.sql`：� `admin_role_permission` 按 `role_key='GROUP_BATCH_MANAGER'` 与 `permission_code='group-batch:contract:issue'` �查询 `INSERT IGNORE` 一行（幂等，角色或����存在时零行）。TEST 已于 2026-09-24 10:16:17 执行。
+
+---
+
+## 六�边界行为
+
+- 未登录 → 401（网关拦截）；团期�存在 → 589500。
+- **确认��交�确认时�待审批的�团申请**�在 `PENDING`：`canApprove=false`，�能驳回；�端�自动关闭（产�待定，�六.7）。
+- �团驳回（`POST .../disband/{approvalId}/reject`）�看团期阶段，确认���驳回，用于清�上述申请。
+- �团批�判的是**批�那一刻**的团期状�，�是�交时的。
+- 已�团 / 已结算团期�起�团返 589544，���团返 589501（��的区分）。
+- 团期管�员授�有 10 分钟��缓存。
+- 预支领款人为主报账人�候选接��返回主报账人，� 24_8322。
+
+---
+
+## 六.5�枚举 / 数�字典
+
+### 错误�（本�涉�，�为既有�）
+
+| � | 当�文案 | 本��化 |
+|----|------|------|
+| 589541 | 当�团期状����起预支（进入核��关闭） | 触�区间收窄为核�中 / 已结算 / 已�团；文案改 |
+| 589542 | 房 / 车 / 导 / 摄四项����能预支 | ��抛出，���留 |
+| 589544 | 团期已确认，���起或批��团 | 触�区间扩大到确认�之�；文案改 |
+| 589507 | 无�作��（当�角色未授予团期��，或该团期�在您�下） | 团期管�员调���险三接���触� |
+
+### 角色 × ���险写��（`group-batch:contract:issue`）
+
+| 角色 | 改� | 改� |
+|---|---|---|
+| SUPER_ADMIN / ADMIN | ✅ | ✅ |
+| GROUP_BATCH_MANAGER | � 589507 | ✅ |
+| FINANCE / CUSTOMIZER / ROOM_MANAGER / VEHICLE_MANAGER 等 | � 589507 | � 589507 |
+
+## 六.6�修改��对比
+
+### 字段级对比
+
+| 字段 / � | 改� | 改� |
+|------|------|------|
+| 预支�许状� | `MATERIAL_PREPARING`～`TRIP_FINISHED` 且四项 ready | #8270：`RESOURCE_PREPARING`～`TRIP_FINISHED`；#8322：`RECRUITING`～`TRIP_FINISHED`；�看四项 |
+| 589541 文案 | 当�团期状����起预支（须为物料准备中 / 待出� / 出行中） | #8270：…（须在资�准备中至出行完毕之间，进入核��关闭）→ #8322：当�团期状����起预支（进入核��关闭） |
+| 589542 | 四项未�时返回 | ��返回 |
+| �团�起 / 批��许状� | `RECRUITING` / `RESOURCE_PREPARING` / `MATERIAL_PREPARING` / `PENDING_DEPARTURE` | `RECRUITING` / `RESOURCE_PREPARING` |
+| 589544 文案 | 团期已出行，���起或批��团 | 团期已确认，���起或批��团 |
+| �团行 `canApprove` | 管�员 + `PENDING` + 团期存在 | �加团期在招募 / �置 |
+| 团期管�员调 contracts/issue�reissue�remind-sign | 589507 | 放行 |
+
+### 行为级对比
+
+| 行为 | 改� | 改� |
+|------|------|------|
+| 确认��团 | ��起��批�（至待出�） | �起�批�� 589544 |
+| 确认��交�确认�批� | 批�执行�团 | 拒�执行，申请�待审批 |
+| 预支入� | 四项��� | 进入核�� |
+| ���险人工补出 | �有管�员 | 团期管�员也� |
+| 团期确认�户确认行程 | 自动出具（�户事件） | ��；#8339 起由团期确认�户驱动 |
+
+## 六.7�影�评估
+
+- **是�破���兼容**: 部分是。确认��显示�团按钮 / 按 `PENDING` 显示「���的�端会让用户点出 589544；按四项��置�预支的�端会误挡；按旧 589544 文案�字符串匹�的�改。结构���，�会解�失败。
+- **�端是�必须�步上线**: 建议�步。�改时�端�正确拦截，�是按钮�点但报错�团期管�员缺入�。
+- **待产��决**: 确认��交�确认时�待审批的�团申请是��在团期确认时自动驳回（当�需人工驳回，#8308 验收评论已记）。
+- **�端 workaround 清�点**: 删除 589542 分支；�团 / ��按钮改读 `stage` / `canApprove`；���险按钮角色白��加 `GROUP_BATCH_MANAGER`。
+
+---
+
+## 七��影�范围
+
+- **仅影�**: 团期预支状�门��团�起 / 批�阶段门与 `canApprove`����险三个写接�的授�角色。
+- **零影�**:
+  - �团驳回 `POST /v3/admin/order/group-batch/disband/{approvalId}/reject`（�看团期阶段，��）
+  - 退�户审批（GB-ADM-070～074）�审批中心退�户行的 `canApprove`
+  - 团期预支领款人候选�财务总览�预支记录（候选�径� 24_8322）
+  - ���险�� `GET .../contracts` 与出具门（� 24_8268 / 24_8339）
+  - 团期管�员的其它��（��授 `group-batch:finance:advance`）
+  - �程�端
+- 第〇节列出的其余�的接�细节以�自 changelog 为准，本����。
+
+---
+
+## 八�测试环境已验�
+
+�为 TEST 环境真实网关实测，�����验收评论；三��已验收关�。
+
+**#8270**（dev-v3 @ b212cb708，2026-09-23 17:47–17:49；构建身份：�置节点团期��存在的领款人得 585007 而� 589541）
+
+| # | 场景 | 结果 |
+|---|---|---|
+| 1 | `RESOURCE_PREPARING` 且四项 ready 0/0/0/0 | 200 `SUBMITTED`，`order_advance` � 1 行，时间线 `BATCH_ADVANCE` |
+| 2 | `MATERIAL_PREPARING` / `PENDING_DEPARTURE` / `TRAVELLING` / `TRIP_FINISHED` | � 200 |
+| 3 | `RECRUITING` / `REVIEWING` / `SETTLED` / `CANCELLED` | � 589541�零写入（其中 `RECRUITING` 已被 #8322 放开，11:47 �测招募中 200） |
+| 4 | �用 5890.00：� 5890.01 / 5890 / � 0.01 | 585004 / 200 / 585004 |
+| 5 | ROOM_MANAGER / VEHICLE_MANAGER | 589507 |
+
+**#8308**（dev-v3 @ 3cd787713 / b2e7140e3，2026-09-24 10:22–10:36；构建身份：589544 返回新文案）
+
+| # | 场景 | 结果 |
+|---|---|---|
+| 1 | 招募中��置节点团期：团期管�员�起 → ADMIN �� | `PENDING` → `APPROVED`，团期 `CANCELLED`，订��消 |
+| 2 | 团期�次置 `MATERIAL_PREPARING` / `PENDING_DEPARTURE` / `TRAVELLING` / `TRIP_FINISHED` / `REVIEWING` / `SETTLED` ��起 | � 589544，状���，申请行 0→0 |
+| 3 | �置节点�交（`PENDING`）→ 团期管�员真实 confirm → ADMIN �� | 589544；团期� `MATERIAL_PREPARING`，申请� `PENDING`，�订�未�消 |
+| 4 | 团期 2102949786913333250 确认�：ADMIN 看列表与详情 | `canApprove=true`（FINANCE 对照 false） |
+| 5 | �团真实 confirm �：列表与详情 | 两处� `canApprove=false`，申请� `PENDING`；点�� 589544 |
+
+**#8309**（dev-v3 @ 3cd787713，2026-09-24 10:24–10:29；Flyway 20260924.8309 于 10:16:17 执行，判�测试在 10:27:30 过缓存�执行，未用超管）
+
+| # | 场景 | 结果 |
+|---|---|---|
+| 1 | 团期人工确认� A 户确认行程 | 1 秒内自动出具：�� 1 份（mock 自动签约 SIGNED）+ �险 2 � INSURED，`order_main` �步；未确认行程的 B 户�出具 |
+| 2 | ROOM_MANAGER / VEHICLE_MANAGER / CUSTOMIZER × 出具 / �开 / 催签 | 9 次全 589507 |
+| 3 | GROUP_BATCH_MANAGER 出具 | 过判�，`SKIPPED`（已出具） |
+| 4 | GROUP_BATCH_MANAGER 作废�开�� | `SUCCESS`，旧�� `VOIDED`�新�� `GENERATED` |
+| 5 | GROUP_BATCH_MANAGER 催签新�� | `SUCCESS` |
+
+本地：#8270 `GroupBatchAdvanceServiceTest` 17 例 + 错误�守� 20 例；#8308 相关�测 373 例 + Docker IT 27 例；#8309 �移测试与 `GroupBatchIssueGateListenerChainTest` 等，� 0 失败。
+
+---
+
+## ��相关历� PR
+
+| PR | Issue | 说明 | 是��有效 |
+|----|-------|------|------------|
+| #8272 | #8270 | 预支�置节点起���删四项门 | ✅（起点已被 #8323 ��移到招募中） |
+| #8323 | #8322 | 预支招募中���领款人�主报账人 | ✅ 最新 |
+| #8313 | #8308 | �团收窄到确认之�，589544 文案 | ✅ |
+| #8315 | #8308 | 审批中心 / 详情�团行 `canApprove` 加阶段�件 | ✅ |
+| #8312 | #8309 | `group-batch:contract:issue` 授团期管�员 | ✅ |
+
+---
+
+## ��相关文档
+
+- 关� Issue: [wx/HL#8355](https://git.1814.love/wx/HL/issues/8355)；补录 [#8270](https://git.1814.love/wx/HL/issues/8270)�[#8308](https://git.1814.love/wx/HL/issues/8308)�[#8309](https://git.1814.love/wx/HL/issues/8309)
+- 关� PR: [#8272](https://git.1814.love/wx/HL/pulls/8272)�[#8313](https://git.1814.love/wx/HL/pulls/8313)�[#8315](https://git.1814.love/wx/HL/pulls/8315)�[#8312](https://git.1814.love/wx/HL/pulls/8312)
+- 需求��：SRS §0.27 / §0.27.7（`docs/group/团期模�一期实施拆分详细设计-v1.0.html`，dev-v3）
+- �批 changelog：
+  - `changelogs-v2/2026-09/24_8268_团期人工确认端点与确认��出���险-新增接�-管���.md`
+  - `changelogs-v2/2026-09/24_8269_团期确认��定�置�写�收紧到�置阶段-修改接�-管���.md`
+  - `changelogs-v2/2026-09/24_8271_团期看�与详情按六节点展示看�改七桶-修改接�-管���.md`
+  - `changelogs-v2/2026-09/24_8339_团期确认�动�订�确认行程与团期���户确认581065-修改接�-管���.md`
+  - `changelogs-v2/2026-09/24_8341_团期核�结算�结算�步�订�与结算589568列未�交户-修改接�-管���.md`
+  - `changelogs-v2/2026-09/24_8322_团期预支核�����起与领款人�定主报账人-修改接�-管���.md`
+
+## 关� / �系人
+
+### 链接
+
+- **Issue**: [#8355](https://git.1814.love/wx/HL/issues/8355)
+- **PR**: [#8272](https://git.1814.love/wx/HL/pulls/8272)�[#8313](https://git.1814.love/wx/HL/pulls/8313)�[#8315](https://git.1814.love/wx/HL/pulls/8315)�[#8312](https://git.1814.love/wx/HL/pulls/8312)
+- **Merge commit**: [968d80b78](https://git.1814.love/wx/HL/commit/968d80b78)�[3cd787713](https://git.1814.love/wx/HL/commit/3cd787713)�[b2e7140e3](https://git.1814.love/wx/HL/commit/b2e7140e3)�[94f2ae5a7](https://git.1814.love/wx/HL/commit/94f2ae5a7)
+
+### �系人
+
+- **�端负责人**: @jw