4.1 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
| 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hl-changelog/v2 | frontend | 前台整团名单速览补状态与需求审核列 | admin | wx(GIT) | 前端优化 | not_required | not_required | verified | mmg | 55d3a040e71ae0855a2bd31b36746b836e75b5ca | 2026-09-16 | 纯前端条目，后端零改动。RosterTable 缺「状态」与「需求审核」两列，组件注释「流程状态后端仍不返回,不展示」已过时——GB-ADM-003 现网返回 orderStatusName/hotelRequirementStatus/vehicleRequirementStatus。需求审核列的中文名翻译缺陷已另开后端工单，前端先按直显 code 兜底接入。需求出处 需求分析/团期测试.md「前台问题 团期-整团总览」。；前端 hl-admin 55d3a040 已实现:RosterTable 补状态列(orderStatusName 回落原码)+需求审核列(房/车 Name 优先原码兜底直显,不建映射),spec 5/5,checkpoint 全绿。 | 2026-09-16 | dev-v3 |
前台整团名单速览补状态与需求审核列（前端优化）
服务: hl-order-service-v3（后端零改动） 页面: 管理后台
/order-v2/batch→ 团期详情 → 整团总览 Tab 组件:src/views/order-v2/batch/detail/components/RosterTable.vue接口:GET /v3/admin/order/group-batch/{groupBatchId}/orders（GB-ADM-003） 日期: 2026-09-16 影响范围: 仅前台渲染；无端点、无出入参、无路由、无 DDL 变化
⚠️ 关键变化
🔵 组件注释已过时。 RosterTable.vue:25 写着「已收/定制师/流程状态后端仍不返回,不展示」，
但 GB-ADM-003 现网确实返回订单状态与房/车需求状态，该注释所依据的情况已不成立。
一、原型要求 vs 当前渲染
原型「整团名单总览」要求 7 列：联系人、订单编号、出行人、档位、房型、状态、需求审核。
| 原型列 | 接口字段 | RosterTable 现状 |
|---|---|---|
| 联系人 | customerName |
✅ 已渲染（第 52 行「子订单 / 联系人」） |
| 订单编号 | orderNo |
✅ 已渲染 |
| 出行人 | travelers[] |
✅ 已渲染（第 105 行「游客」列） |
| 档位 | tierName |
✅ 已渲染（第 64 行「套餐」列） |
| 房型 | roomTypeName / roomCount |
✅ 已渲染（第 80 行） |
| 状态 | orderStatusName |
❌ 缺 |
| 需求审核 | hotelRequirementStatus / vehicleRequirementStatus |
❌ 缺 |
includeTravelers / includeNeeds 两个开关缺省均为 true，前端无需显式传参。
二、本次调整
2.1 新增「状态」列
直显 orderStatusName，枚举外回落 orderStatus（与 SubOrderTable 9/15 的做法一致，不建前端映射）。
现网实测取值：定制中（CUSTOMIZING）、已完成（COMPLETED）。
2.2 新增「需求审核」列
展示 hotelRequirementStatusName / vehicleRequirementStatusName。
⚠️ 后端该字段当前有缺陷：
DONE、PENDING_REVIEW两个取值翻译失败、原样返回英文码 （TEST 取样 30 条子订单中 26 条房需求状态名为英文）。已另开后端工单修复。 前端本次按直显处理、不自建映射兜底，待后端修复后自动恢复中文； 若产品要求上线前不得出现英文，则本列需等后端工单合入后再接。
2.3 删除注释中已过时的表述
RosterTable.vue:25 的「流程状态后端仍不返回,不展示」需删除或改写，避免后续误导。
三、不影响范围
- GB-ADM-003 出入参、分页、权限码、网关路由均未变化。
- 「子订单 Tab」的 RosterTable 其余 8 列保持原样。
- 列表页展开区
SubOrderTable不在本单范围（见同日列表页条目）。 - 小程序端零影响。
四、相关文档
- 需求出处：
需求分析/团期测试.md「前台问题 团期-整团总览」1~2 - 差异清单：
需求分析/测试发现问题.md模块 5、模块 10
关联 / 联系人
- 后端：wx（本单后端零改动；需求审核中文名缺陷另单跟踪）
- 前端：mmg