docs(changelog): #8322 团期预支核单前均可发起+领款人限定主报账人(589557),补 #8270 放宽说明,订正 #7154 错误码 589538/589539→589541/589542
changelog-filename-gate / validate (push) Failing after 2s

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
这个提交包含在:
jw
2026-09-24 11:51:33 +08:00
共同撰写人 Claude Opus 5.5
父节点 05adbfcbb5
当前提交 1fe976a7a6
共修改 2 个文件,包含 347 行新增和 9 行删除
@@ -10,10 +10,10 @@ gateway_status: "verified"
frontend_status: "verified"
frontend_owner: "mmg"
frontend_ref: "af7cc62b"
target_release: ""
target_release: "hl-ui@af7cc62b"
verified_at: "2026-09-08"
status_note: "后端 PR #7170 已合 dev-v3 并部署测试服(网关 finance/advances/payee-candidates 实测 200),原 backend_status/gateway_status=pending 系 09-06 陈旧快照已修正为 deployed/verified。前端团期财务 Tab 与预支接真已交付:groupBatchFinance.js 五端点+FinanceTab(四金额卡/逐户付款表/预支记录/整团核算口径行)+GroupAdvanceModal+detail 挂财务 Tab+store 键缓存+AdvanceApprovalList scope 筛选;金额全后端权威值零反算。ref af7cc62b,checkpoint 全绿含 Vitest 全量+生产构建。"
updated_at: "2026-09-08"
updated_at: "2026-09-24"
base: "dev-v3"
---
@@ -378,8 +378,8 @@ POST /v3/admin/order/group-batch/90211/advance
|---|---|
| `589500` | 团期不存在 |
| `589507` | 缺 `group-batch:finance:advance` 权限 |
| `589538` | 团期状态不可发起预支(须为物料准备中 / 待出发 / 出行中) |
| `589539` | 房 / 车 / 导 / 摄四项未配齐 |
| `589541` | 团期状态不可发起预支。⚠️ 2026-09-24 订正:原文误写为 `589538`(号段顺延后实际落 589541);允许状态已两次放宽,现为「进入核单前都可以」(#8270 / #8322) |
| `589542` | 房 / 车 / 导 / 摄四项未配齐。⚠️ 2026-09-24 订正:原文误写为 `589539`(该号实为 #7178「名额调整量不能为 0」);**#8270 起本码不再返回** |
| `585003` | 预支金额必须大于 0 |
| `585004` | 预支金额超过可用余额上限 |
| `585006` | 借款类型非法 |
@@ -391,7 +391,7 @@ POST /v3/admin/order/group-batch/90211/advance
#### 业务边界
- **双前置闸门**:团期状态 + 四项资源全就绪,缺一即拒(此前服务端两道都没有,只有前端做了置灰)。
- **双前置闸门**:团期状态 + 四项资源全就绪,缺一即拒(此前服务端两道都没有,只有前端做了置灰)。⚠️ 已变更:#8270 删除四项配齐门,#8322 起进入核单前都可发起,且领款人限定为本团主报账人(589557),见 `24_8322_…` 条目。
- **上限走团期统一池**:团期级与各子订单级**共扣一池**。团期把整团尾款预支满后,该团任一子订单再发起订单级预支同样会被 `585004` 拒——这是本次修复的超支漏洞。
- 创建后进入**站内财务审批**,走既有 `advance-approvals` 列表与 approve / reject / 撤回三端点,与订单级完全一致。
- 一期仍**只记账不出款**,实际出款走财务既有付款流程。
@@ -583,8 +583,8 @@ GET /v3/admin/order/group-batch/90211/settlement/summary
| 团期无活跃子订单 | 六个金额字段 `0.00`,`items` 空数组 |
| 子订单已取消 | 不进金额、不进 `items`,只计入 `withdrawnCount` |
| 未设置报账人 | `primaryPayeeName` 为 `null`,后端不兜底默认导游 |
| 团期状态为招募中 / 核单中 | 发起预支返回 `589538` |
| 四项资源缺任一 | 发起预支返回 `589539` |
| 团期状态为招募中 / 核单中 | 发起预支返回 `589541`(2026-09-24 订正码值;#8322 起招募中已可发起,仅核单中及之后返回) |
| 四项资源缺任一 | 原返回 `589542`(2026-09-24 订正码值);#8270 起不再拦截 |
| 团期尾款池已被预支占满 | 团期级与该团任一子订单级预支**均**返回 `585004` |
| 数据字典服务不可用 | 借款类型降级到内置集合校验,正常类型仍可提交 |
| 审批列表出现团期级行 | `orderId` / `orderNo` / `consultantName` / 订单四态均为 `null` |
@@ -611,7 +611,7 @@ GET /v3/admin/order/group-batch/90211/settlement/summary
1. 财务 Tab 四张卡与逐户表末行合计一致,且与团期详情、看板列表三处应收同源。
2. **超支被堵死**:团期级把整团尾款预支满 → 该团任一子订单再发起订单级预支被 `585004` 拒。
3. **核单零重复扣**:团期级预支 5,000 通过 + 某户订单级预支 2,000 通过 → 该户报销单含 2,000,整团 `groupAdvanceApproved` 仍是 5,000;`grandTotalCost` 不变。
4. 两道闸门各拒一次(`589538` / `589539`)。
4. 两道闸门各拒一次(`589541` / `589542`,2026-09-24 订正码值)。
5. 团期级预支出现在预支审批列表,「团号 / 产品」「行程」两列有值,按团期号搜得到,就地通过 / 驳回 / 撤回正常。
6. 订单级预支五端点回归无变化。
@@ -627,7 +627,7 @@ GET /v3/admin/order/group-batch/90211/settlement/summary
| 处 | 文档现状 | 实际 |
|---|---|---|
| §0B.9 错误码 | 「统一用 `AdvanceErrorCode`(585 段)」 | 改落 `589538` / `589539`;585 段被 v2/v3 整段重叠声明且 585001-585010 已被 order-v2 实占 |
| §0B.9 错误码 | 「统一用 `AdvanceErrorCode`(585 段)」 | 改落 `589541` / `589542`(原拟 589538 / 589539,被 #7158 / #7178 先占后顺延,2026-09-24 订正);585 段被 v2/v3 整段重叠声明且 585001-585010 已被 order-v2 实占 |
| GB-ADM-040 出参 | `payStatus` 写五值含 `REFUNDING` / `REFUNDED` | 代码只有三值;结清状态另出 `settleStatus` 字段 |
| GB-ADM-040 出参 | 含 `advanceTotal` | 已废,改三个数 |
| GB-ADM-042 | 返回 `GroupBatchWriteResultVO`、不回传 `advanceId` | 改返 `OrderAdvanceRespVO` 并回传 `advanceId` |