hl-api-changelog/changelogs-v2/2026-09/22_frontend_查看需求页订单号改团号与正式用车需求弹窗默认值文案-前端缺陷-管理后台.md

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, updated_at, base, status_note

schema	ticket	title	consumer	author	change_type	backend_status	gateway_status	frontend_status	frontend_owner	frontend_ref	target_release	verified_at	updated_at	base	status_note
hl-changelog/v2	frontend	查看需求页：订单号改显团号（5 处可立即改）+ 接送机逐行确认按钮 + 正式用车需求弹窗默认分组/默认日期/按钮文案	admin	wx(GIT)	前端缺陷	not_required	not_required	verified	mmg	91d476c9324f032f8160df73f937d6dfad69780a	v2.1	2026-09-22	2026-09-22	dev-v3	2026-09-22 wx 在「团期详情 → 查看需求」页逐屏截图提了 8 个问题。对 origin/dev-v3(cf9dc85a4) 与 hl-ui origin/v2.1(590c1155) 逐项查证后拆成两边：本条只收录后端零改动、今天就能动手的 5 项；另 3 项（另 5 处团号渲染点需后端补 teamNo、车侧未提交户后端根本不返回、接送机批量确认端点不存在）后端有硬缺口，已建 wx/HL#8195 处理，本条不含。查证依据：①名单表/打回弹窗/乘车户下拉三处的数据源 GB-ADM-003 GET /v3/admin/order/group-batch/{groupBatchId}/orders 已返回 teamNo（GroupBatchOrderItemRespVO.java:34，格式 26-0001，未付订金为 null）；②逐户接送机确认可直接调已上线端点 POST /v3/admin/order/{id}/vehicle-requirement/dispatch?kind=TRANSFER（VehicleRequirementAdminController.java:77，请求体 DispatchReqVO 只有 dispatchRemark）；③GroupVehicleRequirementEditModal.vue:434 新建时 form.groups 恒为空数组、:407-408 两个日期恒为 null，blankGroup() :401-416 只被「添加分组」按钮调用；④GroupVehicleRequirementSection.vue:19 文案「新建正式需求」。UI 库是 Naive UI 不是 Element。 | 2026-09-22 mmg 交付:团号上行(teamNo,null 显 — 勿兜底 orderNo)+删独立团号列;TRANSFER 待审核行逐行「确认」显式传 kind=TRANSFER;新建默认一空白分组+默认日期取团期 departDate/endDate(预填展开逐日行);按钮文案改「新增正式行程用车需求」;另 3 项硬缺口归 wx/HL#8195 不含本条

查看需求页：订单号改显团号 + 接送机逐行确认 + 正式用车需求弹窗三处默认值与文案

服务: hl-order-service-v3（后端零改动） 页面: 管理后台 → 团期订单 → 团期详情 → 「查看需求」Tab 日期: 2026-09-22 影响范围: 仅前台渲染与既有端点调用；无新端点、无出入参变化、无路由、无 DDL

---

⚠️ 关键变化

• 本条 5 项全部后端零改动，涉及的字段与端点今天都在测试服上返回真实值，逐条给了查证出处。
• 本条只覆盖这 5 项。wx 当天提的另外几项后端有硬缺口（响应里压根没有那个字段、那个端点不存在），记在 wx/HL#8195，不在本条范围——下面第六节把「哪些不在本条」写清楚了，免得照着改时撞上空字段。
• UI 库是 Naive UI（n-data-table / n-modal / n-date-picker），不是 Element。
• 活跃分支是 origin/v2.1，不是 master。在 master 上 grep 会得到可信但错误的 0 命中（阳性对照：git grep '#8151' origin/master -- src → 0，换 origin/v2.1 → 19）。

---

一、订单号改显团号（本页 5 处可立即改）

wx 原话：「这个页面所有显示订单号的地方都改为显示团号」。

本页 orderNo 共 11 个可见渲染点，其中 5 处的数据源已经返回 teamNo，可以现在就改：

#	文件:行	现在渲染	数据源
1	RequirementTab.vue:442-452 + _shared/renderCells.js:19,21	名单表「子订单 / 联系人」列上行 r.orderNo，以及 hover 的 title: r.orderNo	GB-ADM-003 orders
2	RequirementRejectModal.vue:129	打回弹窗「已选 N 户」标签 ${o.contactName || '未命名'} · ${o.orderNo || '无订单号'}	同上（props 传入）
3	GroupVehicleRequirementEditModal.vue:289	乘车户下拉 label o.customerName || o.contactName || o.orderNo || String(o.orderId)	同上（props 传入）

teamNo 的契约（GroupBatchOrderItemRespVO.java:34，已在返回）：

项	取值
字段名	teamNo
类型	String
格式	26-0001（年份后两位 + - + 4 位）。生成算法 GroupCodeService.java:30-37 是 LCG 混淆 (7123*seq+2731)%10000，刻意不连续、不可按大小排序
粒度	每个子订单一个，同团期内各户不同
空值	未付订金的户为 null（团号在订金支付成功那一刻才生成，OrderStatusService.java:151 / :356）
兜底	orderV2GroupBatch.js:152 注释明写「勿兜底成 orderNo/空串」；本页家族已有写法 RosterTable.vue:62-66 用 r.teamNo || '—'

⚠️ 名单表上有一处需要你们自己定的取舍

369ed5b4（同日交付，见 22_frontend_查看需求Tab子订单表补齐列并订正联系人与房型-前端缺陷-管理后台.md）刚给这张名单表新增了一个独立的「团号」列。若再把「子订单 / 联系人」列的上行也换成团号，同一行会出现两个相同的团号。

这是这张表内部的版面取舍，归你们定。三种走法都说得通：把「子订单 / 联系人」上行换成团号并删掉独立团号列；保留独立团号列、把该列上行改成客户名；或按 wx 字面全换、接受重复。

二、接送机逐行「确认」按钮

wx 原话：「这块需要确认接送机用车需求没有按钮」。

VehicleHouseholdsSection.vue 目前模板里唯一的 n-button 是 :12-19 卡右上角的「刷新」，逐行/逐户没有任何操作按钮（grep '确认' 0 命中；阳性对照：同 grep 在 RequirementTab.vue 命中 :53「整团确认需求」）。

逐户确认可以现在就接，端点已上线：

POST /v3/admin/order/{id}/vehicle-requirement/dispatch（复用不改）

项	内容
路径参数	id — 子订单 ID（Long），取逐户卡的 household.orderId
Query 参数	kind — TRAVEL | TRANSFER。@RequestParam(defaultValue = "TRAVEL")，不显式传 TRANSFER 就变成确认行程用车，务必显式传
请求体	DispatchReqVO，只有一个字段：dispatchRemark（String，选填，@Size(max=500)，"提供给房控/车队的审核意见"）
权限码	group-batch:demand:confirm
副作用	该户该类需求 PENDING_REVIEW → PENDING，vehicle_control → PENDING（即转交车务）
出处	VehicleRequirementAdminController.java:77，DispatchReqVO.java:28

按钮的显示条件用逐户卡上已有的 req.kind === 'TRANSFER' 且 req.status === 'PENDING_REVIEW'（RequirementItem.status 取值 PENDING_REVIEW / PENDING / PROCESSING / DONE，GroupVehicleHouseholdsRespVO.java:105）。

行程用车（TRAVEL）不要加这个按钮

行程用车走的是整团一条的结构化正式需求（PUT .../vehicle-requirement 全量替换），按 wx 早先的定案它本来就没有逐行确认这个动作。这一节只针对 kind === 'TRANSFER' 的行。

三、正式用车需求弹窗：新建时默认带一个分组

wx 原话：「应默认有一个分组」。

GroupVehicleRequirementEditModal.vue:434（打开弹窗时的 watch(() => props.show, ...)，:428-460）：

form.groups = (Array.isArray(req?.groups) ? req.groups : []).map(...)

新建时 props.requirement 为 null ⇒ req 为 null ⇒ form.groups = []，弹窗开出来是空的。

空分组模板 blankGroup() 已经写好了（:401-416，返回 {groupId:null, groupCode:'', vehicleType:'', serviceStartDate:null, serviceEndDate:null, seats:null, count:null, specialTags:[], remark:'', days:[]}），当前只被「添加分组」按钮（:209-215 → addGroup() :418-420）调用，watch 里没调。新建分支补一次 blankGroup() 即可。

四、正式用车需求弹窗：两个日期默认填团期日期

wx 原话：「默认填入」。

GroupVehicleRequirementEditModal.vue:82-89 / :96-103 的两个 n-date-picker，初始值来自 blankGroup() :407-408 的 serviceStartDate: null, serviceEndDate: null，全文件没有任何默认值逻辑（new Date( 只出现在 :375-380 的 expandDates 区间展开里）。

团期的出发日与结束日前端已经拿得到，不需要后端补字段：

日期	来源接口	字段	类型
出发日	GET /v3/admin/order/group-batch/{groupBatchId}（A2 团期详情，父页面已在调）	departDate	LocalDate，形如 2026-10-08
结束日	同上	endDate	LocalDate，形如 2026-10-10

出处 GroupBatchDetailRespVO.java:183-190（另有 enrollDeadline 报名截止日）。

弹窗当前的 props 只有 show / groupBatchId / requirement / orders（:259-267），拿不到日期——父页面 GroupVehicleRequirementSection.vue:169-175 挂载处把团期详情里的这两个日期传下去即可。

补充：「查看需求」的两个 households 读口（requirement/hotel-households、requirement/vehicle-households）目前返回 departDate 但不返回 endDate（GroupVehicleHouseholdsRespVO.java:36 / GroupHotelHouseholdsRespVO.java:39，git grep endDate 在这两个文件 exit=1，阳性对照同 grep 换 departDate 两个都命中）。走 A2 团期详情能一次拿全三个日期，是当前最省事的路。

五、按钮文案改为「新增正式行程用车需求」

wx 原话：「改为 新增正式行程用车需求」。

GroupVehicleRequirementSection.vue:19：

{{ requirement ? '编辑正式需求' : '新建正式需求' }}

（按钮带 v-if="canEdit"，canEdit = :421 !requirement.value || status === 'DRAFT'。）

改文案会连带红两条测试：__tests__/GroupVehicleRequirementSection.spec.js:108 与 :115。

同族文案是否一并对齐由你们定，wx 只点名了这一个按钮。现有的同族文案有：GroupVehicleRequirementSection.vue:340 头注释「data=null 显空态+「新建正式需求」」、弹窗标题 GroupVehicleRequirementEditModal.vue:5 title="正式用车需求编辑"、提交按钮 :226「保存正式需求」、成功提示 :495「正式用车需求已保存」。

六、本条不覆盖的部分（照着改会撞上空字段，先看这里）

下面三项后端有硬缺口，记在 wx/HL#8195：

缺口	具体表现	撞上的位置
另 5 处团号渲染点	confirm-check 与两个 households 读口的响应里没有 teamNo 字段（git grep teamNo 在 Group*HouseholdsRespVO.java exit=1；阳性对照同 grep 换 orderNo 命中 4 行）	RequirementTab.vue:73,82-83,106、RoomHouseholdsSection.vue:44、VehicleHouseholdsSection.vue:40
车侧「未提交用车需求」的户	这些户根本不在响应的 households 数组里——GroupBatchVehicleHouseholdService.java:118-122 遍历的是「有活跃需求行的户」，不是子订单全集（房侧 GroupBatchHotelHouseholdService.java:113-123/:196-201 相反，未提交户保留空卡、status=null）	VehicleHouseholdsSection.vue 无法照 RoomHouseholdsSection.vue:57,98 的写法做提示
接送机批量确认	不存在任何批量确认端点（git grep -nE '@(Post|Put)Mapping\("[^"]*(batch-confirm|confirm-batch|batch/confirm)' 无输出；阳性对照：房务侧有 HouseAssignmentAdminController.java:97「批量提交配房方案」）	多选 + 批量按钮

⚠️ 如果前端想先用 orderId 回 orders 数组反查 teamNo 来绕开第一项：本页 orders 已在 props 里，RequirementTab.vue:264 已有按 orderId 建 Map 的先例。这条路今天就能走通，取舍归你们。

---

七、查证基线

• 后端：HL origin/dev-v3 HEAD cf9dc85a4（2026-09-22 17:33 +0800）。
• 前端：hl-ui origin/v2.1 HEAD 590c1155（2026-09-22 18:03 读取）。
• 分支选对的阳性对照：git grep '#8151' origin/master -- src → 0 命中；同命令换 origin/v2.1 → 19 命中。git ls-tree origin/master -- .../RequirementTab.vue .../VehicleHouseholdsSection.vue → 空；origin/v2.1 两文件都在。
• 本条所有「不存在 / 0 命中」结论都配了同形状的阳性对照，逐条写在对应小节里。