hl-api-changelog/changelogs-v2/2026-08/09_5732_派车通知预览render-batch日期按serviceDates分段-修改接口-管理后台.md

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	5732	派车通知预览（render/render-batch）日期按 serviceDates 分段（接续场景各司机显示自己负责的服务日）	admin	wx	修改接口	deployed	verified	not_required					后端完成：PR #5740 合并 dev-v3（38f4f99a2）并部署 TEST，网关验证接续场景两司机预览日期各自分段（道尔吉 8/23~8/23、王信 8/24~8/25，修复前均为订单全程），与司机实际收到的 HOLD 通知日期口径一致。接口字段结构无变化，渲染行为修复，前端无需改动（预览页展示即正确分段）。	2026-08-09	dev-v3	2026-08-09T12:15:00+08:00

变更接口

POST /admin/fleet/message-templates/{templateId}/render 与 POST /admin/fleet/message-templates/{templateId}/render-batch

• 行为变化：请求项携带 serviceDates 时，模板变量 order.startDate / order.endDate / order.days 按该司机的 serviceDates min~max 分段渲染（与司机实际收到的 HOLD 通知口径一致：AssignmentHoldNotificationSnapshotFactory 行级 serviceDate min/max）；不传 serviceDates（单司机非接续/派单前预览）仍按订单全程渲染。
• 请求/响应字段结构无变化：serviceDates 原有字段（此前仅用于车费安排渲染）现同时驱动「日期」占位符。
• 模板占位符示例：日期：{{order.startDate}} 至 {{order.endDate}}。

验证证据

• hl-fleet-service verify 3307/0F/0E + spotless 通过；MessageTemplateRenderServiceTest 30/30（新增 4 用例）。
• TEST 网关实证（订单 26-6436，接续场景，探针 tools/probe_5732_render_dates.py 5/5 PASS）：
  • 道尔吉段 serviceDates=[2026-08-23] → 日期 2026-08-23 至 2026-08-23
  • 王信段 serviceDates=[2026-08-24,2026-08-25] → 日期 2026-08-24 至 2026-08-25
  • 不传 serviceDates → 订单全程 2026-08-23 至 2026-08-25（回归）
  • 全程段预览与 HOLD 快照工厂在 fleet_assignment 实际行集合上的 min/max 口径一致