hl-api-changelog/changelogs-v2/2026-08/18_6016_终止行程房侧资源释放标记-修改接口-管理后台.md
API Changelog Bot d22d6ea2a7
所有检测均成功
changelog-filename-gate / validate (push) Successful in 1s
docs(changelog): 4篇负责人改wx+6014/6016改pending+补关联联系人段
2026-08-18 16:58:11 +08:00

4.4 KiB

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base, generated
schema ticket title consumer author change_type backend_status gateway_status frontend_status frontend_owner frontend_ref target_release verified_at status_note updated_at base generated
hl-changelog/v2 6016 终止行程后房侧资源释放标记——订单已终止落异常桶+REFUND待办+按terminateDate释放未确认候选 admin wx 修改接口 deployed verified pending mmg 2026-08-18 后端完成PR #6020 已合并 dev-v31690be35cc并部署 TESThl-order-service-v3 双实例 12:20 重启、jar 12:20 新编译,SSH 核实)。房侧新增终止行程监听 onOrderTerminated→handleOrderTerminated;house 包 922 + ArchTest 54 全绿。端到端 TRAVELLING 终止实测待补(测试库无现成出行中订单)。 2026-08-18 dev-v3 2026-08-18T12:30:00+08:00

终止行程后房侧资源释放标记(#6016

背景

「终止行程」terminateTrip,出行中 TRAVELLING→COMPLETED的资源释放此前车侧已闭环(#5518 TERMINATE_TRUNCATE、房侧缺失——房侧没有任何对终止行程的监听,已配好的房(house_hotel_assignment + 已扣酒店库存)滞留,房务不知道该来释放。

变更接口

无新增 admin 端点。房侧新增对 OrderTransitionedEvent(eventCode=TERMINATE) 的进程内监听,改变的是终止行程后房务侧数据/待办的可视结果

房务侧入口 终止行程后的新行为
房务「异常桶」(需求 house_status=EXCEPTION 已配房的终止订单需求会落进来,作为「订单已终止」标记
房务待办REFUND 类型) 已配房产「客人终止行程 · 请处理酒店退订」待办(复用 REFUND 同桶,退款完成自动闭环)
抢单池/我的接单 未配房的终止订单需求被软删除,不再残留

行为口径wx 拍定三决策)

  • 只标记 + 引导手动释放,不自动清配房、不自动退酒店(对齐取消订单 #3208 房侧语义)。
  • ① 释放边界 = 按 terminateDate 切分terminateDate = 出发日 + (endDayNumber - 1)。已入住/已消费晚数terminateDate 之前)的配房与库存原样保留;只自动释放 dayNumber ≥ endDayNumber 的「未确认INQUIRING候选」占的库存。CONFIRMED 行与已过晚数一律不动,由房务在异常桶按边界手动取消未入住部分(走现成删配房流,软删 + 释放已扣库存)再标完成。
  • ② 待办类型 = 复用 REFUND:取消订单与终止行程产同一种 REFUND 待办,同桶呈现;owner 取抢单人(无则广播 owner=NULL,dedupKey 复用不重复产。
  • ③ 未配房分支 = 软删需求:终止行程且无 active 配房时,软删该订单 active 用房需求(移出抢单池/视图),级联软删孤儿询房配房行,不产 REFUND。
  • 幂等(终止事件可重投):状态机 EXCEPTION→EXCEPTION 自循环不抛、REFUND dedupKey 复用、软删 0 行幂等。
  • 与车侧 #5518 TERMINATE_TRUNCATE 独立,互不影响。

前端动作

  • 房务「异常桶」会新出现终止行程的需求(标「订单已终止」),引导房务按 terminateDate 边界处理:保留已入住晚数、手动取消未入住的配房释放库存,再标完成。
  • REFUND 待办照常渲染(标题区分「客人终止行程」),退款完成后自动 RESOLVE。

验证证据

  • 单测HouseTodoServiceTest 4 用例(已配房带抢单人/无抢单人广播+endDay 兜底/REFUND 复用幂等/未配房软删、HouseTodoEventListenerTest 4 用例TERMINATE 透传/非 TERMINATE 忽略/null 忽略/异常降级、HouseAssignmentServiceTest 3 用例dayNumber 切分/边界前返 0/null 返 0、OrderEventPublisherTest 1 用例双路发布、OrderServiceTest 断言 endDayNumber 透传。house 包 922 + ArchTest 54 全绿
  • 部署PR #6020 squash 合并 dev-v3merge commit 1690be35cc,Deploy Panel task 29a0c139 success,SSH 核实 jar 12:20:17 更新 + 双实例 12:20 重启生效。
  • 端到端造出行中订单→terminateTrip→验房侧落异常桶+产 REFUND待补测试库当前无现成 TRAVELLING 订单,按需补测。

关联 / 联系人