wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 工作流 软件包 项目 发布 百科 活动
2,731 提交 29 分支 0 Git 标签
91e38984ab8ad964a1800058e02d48bc4a7dd97c
提交图
1665 次代码提交
作者 SHA1 备注 提交日期
API Changelog Bot 91e38984ab docs(changelog): add #7633 revoke reason handoff
changelog-filename-gate / validate (push) Failing after 1s
详情
2026-09-13 16:32:00 +08:00
yaosutu edab50a6a8 feat(changelog): 费用报销三件套(#7472/#7486/#7502) + 费用支付出纳对接说明
changelog-filename-gate / validate (push) Failing after 2s
详情 
- 费用报销：page 加 statuses 多状态筛选、detail 加 payRecords 付款记录、表单补 applicantId/payeeAccount/voucherUrl、透出经办人 operatorId/operatorName、598705 文案放宽；含部门组织树/员工选择器/所属公司 travel_agency/费用分类 关联接口指引
- 费用支付：出纳域对接说明（queue/pay/payments 按 EXPENSE 路由），接口无变更
 2026-09-13 16:25:38 +08:00
Mimingguang 5db14d3832 chore(changelog): #7439 用车需求分家前端 not_required（等 TRANSFER 开放）
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 15:10:28 +08:00
Mimingguang b241e8a69b chore(changelog): #7612 业务外收支 + #7625 员工选择器前端 verified
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 15:01:58 +08:00
API Changelog Bot 1c5279f327 docs(changelog): #7439 对外分册补齐 809001/809007 处置口径与「建议显式传 kind」
changelog-filename-gate / validate (push) Failing after 2s
详情 
两处是交接件自身的缺口，不是实现问题：

1. 809001（同单同 kind 重复/并发提交）此前只作为 JSON 示例出现，没有前端处置口径，
   而本文件错误码表的前提就是「每个码配一条处置口径——码本身不够，处置动作错了
   照样是线上问题」。补的处置口径关键是「不要自动重试」：只要那条活跃需求还在，
   重试永远是这个码。
2. 809007 此前只在内部分册。它确实是 fleet 消费侧的码、前端拿不到，但错误码段位
   在交接件里应当完整，且它与 809002 的分工需要说清（809002=提交时派生不出来，
   前端可引导补大交通；809007=提交时没派生、事后被消费，属存量回填，前端无动作）。
   补上之后，「交接件含 6 个错误码」在「两册之和」与「mmg 实际拿到的那一份」
   两种读法下都成立，不必再去裁哪种读法对。
3. 「不传 kind 按 TRAVEL 处理，现网代码可不改但建议显式传」此前只写在内部分册，
   而内部分册的收件人是后端与 fleet 侧、不是 mmg。已补进对外分册的影响评估与
   端点1 入参表，并写明为什么值得显式传：一旦该订单出现两类活跃需求，「不传」
   的语义就从「就是行程用车」变成「碰巧落到行程用车上」，两者在代码里长得一样。

校验：六个码（809000/809001/809002/809007/809008/809009）在对外册均为行首表格行
各 1 行；退役号 809003-809006 阴性对照各 0 命中；endpoint-count 仍为 7 / 4。
 2026-09-13 15:01:15 +08:00
API Changelog Bot 1e8404a047 docs(changelog): #7439 团期车务地基——用车需求分家（对外 7 端点 + 内部 4 端点）
changelog-filename-gate / validate (push) Failing after 1s
详情 
两份分册按 BACKEND_CHANGELOG_DELIVERY_GUIDE.md 2.5 节拆分（/v3/internal 必须单独成篇）。
2026-09-13 测试环境逐端点实测：对外 7 个经网关，内部 4 个直连服务带 X-Internal-Token
（网关按设计一律 403 拦 internal，不是路由失败）。部署 HEAD a82367e15，
order-v3 / fleet / gateway 同批。

实测顺带订正两处文档与实现不符的契约，已改在 §二/§三 正文而非附注：
1. 打回·定制师 / 打回·车控 的 kind 是 @RequestParam Query 参数，不在 RejectReqVO 里。
   原文档标成 Body —— 按原文档把 kind 塞进 JSON 会被 Jackson 静默忽略、
   不报错也不返 400、服务端按默认 TRAVEL 处理，接送机的打回会落到行程需求上。
2. 提交/修改用车需求的非法 kind 实测返 400（VehicleRequirementReqVO 的 @Pattern
   先于业务代码拦截），809000 对该端点的 body 参数不可达；809000 仍可经内部接口的
   query 入口触发。同一处校验、两个入口两种表现，两条分支都要处理。
 2026-09-13 14:47:04 +08:00
yaosutu d53a6f4328 docs(changelog): 业务外收支 7612 入参按 IN/OUT 两个页签分开说明
changelog-filename-gate / validate (push) Failing after 2s
详情 
把"四、入参"重构为分方向：先讲一套接口两个页签（direction 区分）怎么调，再分别给业务外收入(IN)/业务外支出(OUT)两张干净表单字段表，支出明确"只有 8 字段、不收凭证类"。前端对着自己页签抄即可。
 2026-09-13 14:44:50 +08:00
Mimingguang 649eea681b chore(changelog): #7327 核单住宿失效团期行前端 verified（可删+合计剔除）
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 14:39:53 +08:00
yaosutu 6e05bd81aa feat(changelog): 业务外收支接供应商与经办人(#7612) + 员工选择器接口(#7625)
changelog-filename-gate / validate (push) Failing after 2s
详情 
- 13_7612：业务外收支修改接口（破坏性：删 unitName/加 operatorId 必填/OUT 裁剪 6 字段；出参加 flowNo；含供应商弹窗/部门树/员工选择器/类别/收付方式字典 5 个关联接口对接指引）
- 13_7625：新增员工选择器 GET /admin/user/employee-options（不限角色，供经办人下拉）
 2026-09-13 14:37:16 +08:00
Mimingguang b7855447cf docs(changelog): #7487 撤销审批语义修正实证 not_required(前端未接该端点)
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 14:12:04 +08:00
API Changelog Bot 54cdd4dca8 docs(changelog): document supplier revoke failure (#7487)
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 14:07:55 +08:00
API Changelog Bot和Claude Opus 5 779f70f896 docs(7327): 订正 changelog —— PR-2 把「权威消失即软删」推翻为「转 REVOKED 不删」
changelog-filename-gate / validate (push) Failing after 2s
详情 
本篇写于 PR-1(#7600, 49ce99cc8)当天，同日 09:19 合入的 PR-2(#7603, d916986de)
把其中的行为改成了相反的。mmg 手上拿到的是错的，故就地订正而非另起新篇
（另起会把同一批接口的信息分裂到两个文件）。

订正 7 处（代理只报了 4 处，第 5-7 处是收尾时按「概念」做全文残留断言抓出来的）：

1. 关键变化段：GROUP_BATCH_PLAN_REVOKED「本期产生不出来」-> 本期就会出现
2. 对平规则：「权威消失即软删，返回结果里不再出现」-> 不删，就地转 REVOKED
   + remark 加前缀 [团期来源已失效] ，实付/凭证/确认状态/source_id 锚点全保留，
   权威回归时按 source_id 三段认回、不新建重复行
3. 行为对照表「团期权威消失」行
4. 用例名 listHotel_groupAuthorityGone_softDeletes... -> ...revokes...
   （真名见 SettlementServiceGroupBatchReconcileTest.java:219）
5. sourceType 取值域表里仍写着「本期产生不出来」
6. 读写混合说明里的对平三动作仍写着「权威消失的软删」
7. 「会新建、更新或软删住宿行」加限定（团期行走转 REVOKED，此处软删指其它来源）

另：正文顶部新增「2026-09-13 订正」段集中对账，PR 行补 #7603。

frontend_status: not_required -> pending。原 not_required 闭环是在
「REVOKED 本期产生不出来」这个前提下做的，前提已失效。
它引出一个需要拍板的新问题：一条权威已消失的 REVOKED 行，核单员到底能不能删？
按现有前端逻辑它是「不可删的派生行」，但上游已不存在 —— 意味着它会永久留在核单页上。
后端这么设计是故意的（保住已录实付与凭证、以及认回锚点），但前端侧怎么展现没定过。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-13 14:04:04 +08:00
Mimingguang 551c56609f docs(changelog): #7608 取消成团判权实证 not_required(前端无取消成团按钮,589507 兜底)
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 13:11:26 +08:00
jw和Claude Opus 5 ad0c43afb1 docs(order-v3): #7608 团期取消成团接入 group-batch:manage 判权（589507）+ 三端点旁路观察
changelog-filename-gate / validate (push) Failing after 2s
详情 
批 0+1：cancel-group 接 manage 带 nacos 灰度开关；withdraw / transfer-in /
transfer-candidates 本批只加旁路观察日志，对外行为零变化。

TEST 实打：AC-2 零写入（41 列逐列一致、update_time 未变、流水 0 新增）、
AC-3 非超管 ADMIN 仍 200、AC-6 开关两态（≈7s 生效）、观察探针端到端。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-13 11:57:43 +08:00
Mimingguang d0e762ddc6 docs(changelog): #7607 审批链口径更正实证 not_required(前端纯透传 statusChangeText)
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 11:00:37 +08:00
Mimingguang 6c7e0ef5f5 docs(changelog): #7440 团期配车只读模块回写 verified(frontend_ref 5aea88d4)
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 10:54:55 +08:00
lc和Claude Opus 5 4ca07159ba docs(changelog): 审批记录改按审批链推进并修正或签审批人（#7607），更正 #7587 口径
changelog-filename-gate / validate (push) Failing after 2s
详情 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DdmjgoN68L7TUP4oRosfTu
 2026-09-13 10:50:18 +08:00
Mimingguang bc84c8099c docs(changelog): #7520 资金账户所属公司多选回写 verified(frontend_ref 37454cb4)
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 10:31:02 +08:00
Mimingguang 86b700939c chore(changelog): #7532 回写前端 verified(95518b50) 出团通知书读写模块
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 10:20:40 +08:00
Mimingguang a61586ff83 chore(changelog): #7527 回写前端 verified(a80b9670) 发起核单入口
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 10:08:51 +08:00
yaosutu 48d36a1c84 docs(changelog): 资金账户新建/编辑表单字段对接说明（管理后台 v2）
changelog-filename-gate / validate (push) Failing after 2s
详情 
非接口改动：资金账户接口字段早已齐全，前端补 5 字段（bankName/shortName/nature/feeRate/refundReserve）+ scopeCompanies 改多选。
 2026-09-13 10:05:19 +08:00
Mimingguang 4b351d1c1c chore(changelog): #7587 回写前端 verified(e3ff8510) 审批记录补状态变化列
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 09:54:57 +08:00
Mimingguang 10502ccdd3 chore(changelog): 补回写漏网 8 条(7510×2/7511/7512 verified+not_required;7513/7530/7531/7535 not_required)
changelog-filename-gate / validate (push) Failing after 2s
详情 
7510/7511/7512 代码早已随供应商关系系列交付(a17a2c2a/4bedc8be),实证后回写 verified 挂 a17a2c2a;
11_7510 为正本 12_7510 的重复副本(canonical_path),标 not_required 消除 pending;
7513/7530/7531/7535 实证前端零改动 not_required。
 2026-09-13 09:51:52 +08:00
Mimingguang a7a687796f chore(changelog): #7327 回写前端 not_required 核单 Step1 来源透传+584129兜底均兼容
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 09:36:00 +08:00
Mimingguang 8ddf1e5268 chore(changelog): #7537 回写前端 verified(f7699455) 协同工单补团号列,余三块 no-op
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-13 09:14:00 +08:00
API Changelog Bot和Claude Fable 5.1 31d9cb8b23 docs(order-v3): 团期配房行合流进住宿核单 Step1 changelog（#7327 PR-1）
changelog-filename-gate / validate (push) Successful in 2s
详情 
面向 hl-ui：核单 Step1 的 sourceType 扩取值域，团期订单首次出现团期配房派生行
GROUP_BATCH_PLAN；新增行级确认闸业务错误码 584129。
接口路径、HTTP 方法、VO 字段集合均未变化，网关无新增路由。

Refs #7327

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
 2026-09-13 08:53:04 +08:00
jw和Claude Opus 5 d32665518f docs(order-v3): #7513 团期转期同步回写归属两列 + 在途退单守卫 589589
changelog-filename-gate / validate (push) Successful in 2s
详情 
转订单端点请求/响应结构零改动，前端无需改造。两处需告知：

1. 转期后订单详情的团期编号/名称会正确显示为【目标期】——此前因只改了
   product_batch_id、没改 group_batch_id，展示的是源期。属修复非回归。
2. 新增拒绝码 589589：该户有在途 PENDING 退单审核时转期被拒，前端按普通
   业务错误弹 message 即可，文案已含出口指引（先在源期驳回再重提）。

历史已转期订单的存量分叉本次不修，见 #7586。

frontmatter: backend_status=deployed / gateway_status=verified / frontend_status=pending
校验：validateV2Document 0 错误；validateChangelogPath 通过。

Refs #7513
PR wx/HL#7589

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-12 17:10:02 +08:00
lc和Claude Opus 5 47544d190e docs(changelog): 供应商审批记录新增变更前后状态字段（#7587）
changelog-filename-gate / validate (push) Failing after 2s
详情 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DdmjgoN68L7TUP4oRosfTu
 2026-09-12 16:50:43 +08:00
jw 4bea4c2d1c docs(order-v3): #7535 零破坏证据升级为真·双部署逐字段对拍
changelog-filename-gate / validate (push) Successful in 3s
详情
2026-09-12 15:41:25 +08:00
jw 637fad2394 docs(order-v3): 团期接口返回值整改·非破坏批 changelog（#7535）
changelog-filename-gate / validate (push) Successful in 2s
详情 
19 个团期读端点纯加响应字段，47 个新 key，既有 key 的名称/类型/取值/null 语义
一行未动，前端零改动即可继续运行。零 DDL、零错误码、零网关改动。

前端要点：opsStage 直接读不要自己折桶；联系人改读 customerName；
审批中心统一列表三个新字段只在 WITHDRAW 行有值；teamNo 逐户各不相同且未付订金为 null；
staff 候选的 groupBatchId 在团期未创建时为 null，不得当必有主键用。

四组旧字段（Text/Label 后缀、contactName、batchId、total*）已标 @Deprecated，
本批不删、值不变，删除时间另行通知。
 2026-09-12 15:12:28 +08:00
lc和Claude Opus 5 e315cbb6b0 docs(7512): 服务人员 Changelog 补齐模板必需章节与逐接口自包含内容 Refs #7512
changelog-filename-gate / validate (push) Successful in 3s
详情 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011t6wjBsvqsFKFSkCzsYsuS
 2026-09-12 12:19:39 +08:00
lc和Claude Opus 5 3a15e3de25 docs(7512): 服务人员按景区口径接入供应商关系 Changelog（supplierFullName / 原因可省略 / 无订单门禁）Refs #7512
changelog-filename-gate / validate (push) Failing after 2s
详情 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011t6wjBsvqsFKFSkCzsYsuS
 2026-09-12 12:15:55 +08:00
lc和Claude Opus 5 57be23bcd1 docs(7511): 额外成本按景区口径接入供应商关系 Changelog（supplierFullName / 固定 COST_ITEM 类型 / 原因可省略）Refs #7511
changelog-filename-gate / validate (push) Successful in 2s
详情 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UqNs52DGnGU29PN8Ey37Ms
 2026-09-12 12:04:17 +08:00
jw和Claude Opus 5 1584c8ee80 docs(order-v3): #7532 团期出团通知书读写端点（GB-ADM-081 / 082）
changelog-filename-gate / validate (push) Successful in 2s
详情 
新增两个管理后台端点：
  GET / PUT /v3/admin/order/group-batch/{groupBatchId}/docs/notice
读端点在未保存过时按团期数据即时拼草稿返回（不落库），写端点整体覆盖保存到新表
group_batch_notice（Flyway V20260912_140）。

前端必接三件事：
1. expectedVersion 必填、首次传 0、收到 589585 必须【重读再提交】——直接重试一定还是 589585；
2. releasable=false 时置灰「打印 / 存 PDF」（阶段门只卡下发不卡编辑，招募期可起草）；
3. 正文是纯文本语义，后端不转义也不反转义，按纯文本渲染、不要 v-html，
   也不要在前端 escape/unescape 后再提交。

另一条部署事实：新权限码 group-batch:docs 在 user-service 有 10 分钟 Redis 缓存，
上线后 ADMIN 最多 10 分钟才生效，这段窗口的 589507 不是漏配。
当前授权范围 ADMIN / SUPER_ADMIN，FINANCE 未授。

原型出入三处（contacts 单串 vs 两个输入框、完成编辑未发请求、service/bring 未接控件）
已在正文列出，口径由 mmg 对齐。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-12 11:55:44 +08:00
jw和Claude Opus 5 b4ef91e9eb docs(order-v3): #7531 下线 Mock 的行程整体保存端点 + #7530 团期 staff 去重与报账人扇出限定本团
changelog-filename-gate / validate (push) Successful in 3s
详情 
#7531（删除接口）：POST /v3/admin/order/{orderId}/itinerary/save 下线。
该端点自 2026-05-12 落地起就是 Mock，只回显入参 id、从不落库；
下线前已穷举 mmg/hl-ui 全部 4 条远端分支确认零调用（每条带阳性对照），
故前端预期无需改动。整体保存的真实入口是 POST /v3/admin/order/{id}/adjustment/submit。
错误码 583030-583034 号位保留未释放。

#7530（修改接口，两个端点）：
1. PUT /v3/admin/group-batch/{productBatchId}/staff 新增 589582——
   staffList 内 staffId 重复即拒绝、整批不保存，同一员工不能在同一团期占两个配置位。
   前端需提交前去重或直接透出文案。
2. PUT .../staff/{staffId}/reporter-rank 行为收敛——
   报账人等级的订单副本同步范围由「全库」收窄为「本团活跃订单」，
   响应结构与错误码不变；存量重复行不再抛裸 500。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-12 11:04:13 +08:00
lc和Claude Opus 5 3aa5242ab9 docs(7510): Changelog 路径迁移为 12_ 并登记 11_ 兼容别名 Refs #7510
changelog-filename-gate / validate (push) Successful in 3s
详情 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UqNs52DGnGU29PN8Ey37Ms
 2026-09-12 10:35:51 +08:00
lc和Claude Opus 5 fb7a6af37b docs(7510): 服务按景区口径接入供应商关系 Changelog（supplierFullName / 原因可省略 / 395063）Refs #7510
changelog-filename-gate / validate (push) Failing after 2s
详情 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UqNs52DGnGU29PN8Ey37Ms
 2026-09-12 10:29:11 +08:00
jw和Claude Opus 5 4656428473 docs(order-v3): #7527 团期发起核单端点（TRIP_FINISHED → REVIEWING）
changelog-filename-gate / validate (push) Successful in 3s
详情 
新增 POST /v3/admin/order/group-batch/{groupBatchId}/review/start。

补的是「团期卡死」的入口缺失：这一跳此前唯一入口是录共享成本的副作用，
不用大巴、没请导摄的团没有成本可录就没有触发点，永久停在「出行完毕」，
八桶看板的「核团中」桶对这类团恒为空。

面向 hl-ui 写清三件事：① 重复点击返 200 而非报错，必须看 data.alreadyStarted
区分「真的推进了」与「幂等命中」，否则会连弹两次成功；② 三个新错误码
589564/589565/589566 各对应不同的下一步动作（等团回来 / 去做验团反确认 /
这团已流团），给了逐条的前端提示建议，其中 589565 要带反确认跳转；
③ 录成本自动推进的老行为一行未改，两条入口并存，前端现有调用不需调整。

权限码复用录成本那一个（group-batch:finance:advance），按钮可见性判据可直接复用。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-12 10:26:15 +08:00
jw和Claude Opus 5 79186364b8 docs(order-v3): #7537 管理端展示订单号的响应体统一补团号（teamNo）
changelog-filename-gate / validate (push) Successful in 2s
详情 
11 个 /v3/admin/** 端点响应体纯增 teamNo：退款详情/列表、支付分页/详情/按订单、
工单分页/详情三块新增字段，订单待办 4 个写端点补上此前恒 null 的填充。

面向 hl-ui 写清四件事：teamNo 是订单团号 order_main.team_no（26-0001），不是运营
团期号 batchNo（GB-26-0001）；为空一律 null 不返空串不回退订单号；生成条件是订金
支付成功、与是不是团期单无关（已付订金散客单有、未付订金团期单没有）；同团每张
子订单团号各不相同，别按团号归并。

另记 4 个 /v3/internal/ 端点连带多出该字段（服务间调用，前端不对接）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-12 09:15:46 +08:00
Mimingguang a0d72720a6 chore(changelog): 7526 前端交付回写 verified
changelog-filename-gate / validate (push) Failing after 3s
详情 
团期物料门复判与兜底重扫:hl-admin 36c9064a 在团期详情页
onContractActionSuccess 补 fetchDetailSafe 重拉主详情,出具/签署触发物料门
自动推进时状态立即刷新。frontmatter 翻 verified + owner + ref + status_note。
 2026-09-12 07:46:16 +08:00
jw 37904dc20f docs(changelog): 团期物料门复判与兜底重扫（#7526 / PR #7559）
changelog-filename-gate / validate (push) Successful in 2s
详情 
新增 2 个端点：
- POST /v3/admin/order/group-batch/{groupBatchId}/recheck-material-gate（运维手工复判，未推进时回执指明挡门原因）
- POST /v3/internal/jobs/group-batch-material-gate/run（服务间，Quartz sys_job 1044 经 Feign 触发，公网网关不放行）

backend deployed + gateway verified，TEST 2026-09-12 实测：
事件路径 03:37:09 管理端动作 → 03:37:10 团期推进；Job 路径 cron 03:27:00 自行触发，sys_job_log 1044 SUCCESS。
 2026-09-12 07:29:45 +08:00
Mimingguang 6827c24324 chore(changelog): 7445/7446 前端核验 not_required 回写
changelog-filename-gate / validate (push) Failing after 2s
详情 
7445 团期用车结算闸(584131+VEHICLE 软预警)与 7446 住宿结算闸判团口径
(584130 判据修正),经 grep 实证 hl-admin 前端均零改动:
- 前端无按码分支,request.js 通用 bizError 兜底透传后端 message 原文,
  584131/584130 文案已含订单号+需求状态+操作指引,透传即达标。
- detail.vue warnings 渲染只取 item.message 且兼容过渡期字符串,从不读
  settlementId/dayNumber 定位明细行,category=VEHICLE 项(恒 null)正常展示。
- 7446 契约一字未变仅触发人群变化,前端对 584130 无专属处理不受影响。
frontmatter 翻 frontend_status=not_required + owner=mmg + status_note 追加,
无业务 commit,ref 留空。
 2026-09-11 19:20:10 +08:00
API Changelog Bot 251748d813 docs(7445,7446): 两份交接件补网关实测结果，gateway_status 转 verified Refs #7445 Refs #7446
changelog-filename-gate / validate (push) Successful in 2s
详情 
两单的 §八「测试环境已验证」原先都写着「本节当前为空，网关实测尚未进行」，
frontmatter 的 gateway_status 卡在 pending、pre-push 校验器报 E_GATEWAY_PENDING。

2026-09-11 网关实测已完成，本次把结果写进两份交接件：

- #7445 四组（17:38 三组 + 18:36 补一组）：团期单 + 用车 PENDING → 584131；
  推 DONE → 200；散客单两类需求都 PENDING → 200（两闸均不误触发）；
  车费派生行全部软删 + 需求 PROCESSING → 仍 584131
- #7446 四组：方向甲 + 住宿 PENDING → 584130；推 DONE → 200；
  待回填老单（product 非空 + group 为空 + 团期存活）→ 仍 584130；散客单 → 200

两份都如实写明了两条取证边界，不许读的人误推：

1. 全部前置都是 SQL 直更造出来的（直接改需求 status），不是走真实配车/配房链路产生的
2. 取证路上绕过了三道与本单无关的通用前置闸（584310 八分类未确认、584082 待收尾款、
   车费草稿冻结确认），手段是 SQL 标 CONFIRMED / 清零应收；这三道闸自身的正确性未被验证

gateway_status pending→verified、verified_at 填 2026-09-11、status_note 改为如实描述。
frontend_status 保持 pending 未动。
 2026-09-11 18:58:29 +08:00
Mimingguang 98665c3a20 chore(changelog): #7509 前端交付回写 verified(mmg,hl-admin 64573356)
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-11 18:14:35 +08:00
lc和Claude Opus 5 a28a67887f docs(7509): 酒店按景区口径接入供应商关系 Changelog（supplierFullName / 原因可省略 / 395062）Refs #7509
changelog-filename-gate / validate (push) Successful in 2s
详情 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UqNs52DGnGU29PN8Ey37Ms
 2026-09-11 18:00:02 +08:00
API Changelog Bot 5a5ca03e0f docs(7440): 交接件补 4 个改造接口 + 双侧未读取法 + 会话键不混同 Refs #7440
changelog-filename-gate / validate (push) Successful in 3s
详情 
AC-19 要求的三块内容原先在文件里 grep 零命中，校验器也只解析出 4 个端点：

- 新增「改造接口」4 节（messages 拉取/投递、read 双侧水位、biz-unread-batch
  新增 TEAM_FLEET 取值），每节含方法/路径/路径参数/请求参数/响应/错误码
- 写死「双侧未读要分别取」：车务侧传 unreadScope=TEAM_FLEET、团期管理员侧传 TEAM，
  传错不报错、会拿到对方的未读数
- 写明 GROUP_FLEET:{groupBatchId} 与「接送机沟通仍走 FLEET:{orderId}」，两个入口不混同
- 两条 internal 接口的清单编号由 *内部* 改为裸 5/6——校验器对非裸编号的端点标题
  是静默跳过的，改前它们根本没进校验
- 补错误码汇总表（281018/281019/600012-600014/809400/809401，文案逐字抄源码）
- 六.6「修改前后对比」由 N/A 换成 4 个改造端点的行为级对比

端点数 4 → 10（6 新增 + 4 改造），与工单口径一致。

另留痕一处信源冲突：biz-unread-batch 的 adminId，工单正文写「PERSONAL 时必填」，
而 ChatBizUnreadBatchReqVO.java:23-25 是 @NotNull（恒必填，与 unreadScope 无关）。
交接件按源码写，并在字段说明里标注与旧文档描述不一致、以源码为准。
 2026-09-11 17:31:04 +08:00
API Changelog Bot 274f0b16c0 docs(changelog): #7440 订正六.8 节角色授予范围——ADMIN 已被 #7514 收回
changelog-filename-gate / validate (push) Successful in 3s
详情 
原文写「菜单可见性授予 SUPER_ADMIN / ADMIN / VEHICLE_MANAGER 三个角色」「权限码
授权 VEHICLE_MANAGER / ADMIN / SUPER_ADMIN」，这两句在 PR #7514 之后已经过时：
V20260911_007__fix_group_dispatch_admin_grants.sql 于 2026-09-11 14:04:26 在测试库
收回了 ADMIN 的菜单行（2 行）与权限码授权（1 行），部署后实测两项命中数均为 0。

收回的原因本文件八节末尾那条红字早就写着：/admin/fleet/** 的访问控制是 #5626 的
路径级粗粒度角色门禁，只放行 VEHICLE_MANAGER 与 SUPER_ADMIN，不看权限码。给 ADMIN
菜单等于造一个看得见、点进去必 403 的死入口。也就是说本文件自身前后矛盾——六.8 节
说 ADMIN 有菜单，八节说 ADMIN 调接口必 403。现已统一到后者。

接口契约、错误码与行为均未变，仅授权数据层的描述订正。frontmatter 补 status_note。

前端影响：不要按「ADMIN 能看到团期配车」设计任何菜单可见性或路由逻辑。
 2026-09-11 15:07:07 +08:00
Mimingguang 8accfb3a61 chore(changelog): #7500 前端交付回写 verified(mmg,hl-admin 7d7cf020)
changelog-filename-gate / validate (push) Failing after 2s
详情
2026-09-11 14:46:14 +08:00
lc和Claude Opus 5 0c30d2c966 docs(changelog): #7500 游玩项目按景区口径接入供应商关系
changelog-filename-gate / validate (push) Successful in 2s
详情 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CKcJu3x9Ct9LutqH7AMjJb
 2026-09-11 14:28:56 +08:00
API Changelog Bot和Claude Opus 5 78ddcae40e docs(changelog): #7440 团期车务派单只读入口——看板三端点 + GROUP_FLEET 双团会话（已部署实测 861ebff0c）
changelog-filename-gate / validate (push) Successful in 3s
详情 
6 个新接口：fleet 派单看板三个 admin 读口 + order-v3 两个 internal 读口 + user-service
open-group-fleet。本单只读，不含配车写入与派单进度回写。

错误码 7 个：809400/809401（order-v3 内部口自用，经 fleet 侧 fail-closed 统一转 600012，
**前端看不到原始码**）、600012/600013/600014（fleet 对外）、281018/281019（会话侧）。
809401 把「分页越界 / 出发日区间倒挂 / keyword 超 50 字符 / dispatchProgress 枚举非法」
合并为一个出口，前端按单码统一提示重填筛选条件。

⚠️ 访问控制口径：三个 fleet 读口由 #5626 的粗粒度角色门禁把关（必须切到 VEHICLE_MANAGER
或 SUPER_ADMIN），**不看权限码**。实测 ADMIN 角色（已被本单 Flyway 授予
fleet:group-dispatch:view）同样拿到 403，前端不能按「有该权限码就能调」设计。

测试环境已验证：三服务已部署（fleet/order-v3 @ 861ebff0c、user @ 30761683e，差异原因与
契约一致性核验见正文），6 端点逐个网关实测、每条两轮。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-11 13:24:48 +08:00