配房差价 VO 新增 priceMissing 字段 + direction 新值 UNPRICED(价格未录入提示)

日期: 2026-04-24 PR: #1353 (dev) Issue: #1349 类型: fix / enhance 服务: hl-order-service-v2

摘要

POST /admin/order/{orderId}/hotel-assignment/preview 返回的 RoomUpgradePreviewVO 和内嵌 DayUpgradeDetail:

新增字段 priceMissing: Boolean — 标记该天/该 VO 是否因房型价格未录入而无法算差价
direction 字段新增枚举值 UNPRICED — 所有差价天均为价格未录入时 RoomUpgradePreviewVO.direction=UNPRICED;单天 DayUpgradeDetail.direction=UNPRICED
description 文案增强 — 含未录入天数时拼接「另有 N 天房型价格未录入,请联系运营补录后再算差价」

背景

PR #1348 在房型价格未录入(queryDayPrice 返 0)时把整天跳过不进 details,保住了「防假扣 280」但造成副作用:用户配非默认房型依然显示「无差价」(details 空)。本 PR 把 unpriced 天保留进 details 并明确标记,前端可区分「真无差价」和「价格待录入」。

字段契约

`DayUpgradeDetail`

{
  "familyIndex": 1,
  "date": "2026-04-27",
  "defaultRoomTypeId": "2023727403196502017",
  "defaultRoomTypeName": "普通标间",
  "assignedRoomTypeId": "3002000000000000013",
  "assignedRoomTypeName": "大床房",
  "defaultPrice": 280.00,
  "assignedPrice": 0,
  "dayDiff": 0,
  "direction": "UNPRICED",     // 新枚举值
  "priceMissing": true,        // 新字段: true 表示价格未录入
  "remark": "1111"
}

`RoomUpgradePreviewVO`

{
  "details": [ ... ],
  "totalDiff": 0,
  "direction": "UNPRICED",     // 所有天都 unpriced 时;否则仍是 UPGRADE/DOWNGRADE/MIXED/SAME
  "description": "共 2 天有差价,合计+200;另有 1 天房型价格未录入,请联系运营补录后再算差价"
}

direction 枚举值完整表

值	含义
`UPGRADE`	升级(`dayDiff > 0`)
`DOWNGRADE`	降级(`dayDiff < 0`)
`SAME`	一致 / 无差价 / details 空
`MIXED`	既有升级又有降级
`UNPRICED`(新)	房型价格未录入,该天/该 VO 不计入差价,仅提示

前端渲染建议

DayUpgradeDetail.direction === 'UNPRICED' / priceMissing === true — 该行用红字/tag 提示「价格未录入, 请联系运营补录」,不显示 dayDiff 数字(或显示灰色 0)
RoomUpgradePreviewVO.direction === 'UNPRICED' — 顶部 alert 用 warning 色调而不是 info
totalDiff === 0 且 description 含「价格未录入」 — 保留「确认提交」按钮但提示「本订单存在价格未录入天,本次提交不会产生差价,建议运营补录后重新配房」
priceMissing 的条目不影响顶部 totalDiff 数字

测试服实测(订单 2047252402389598209 第 3 天大床房)

POST /preview
{
  "assignments": [
    {"familyIndex":1,"hotelId":...,"roomTypeId":3002000000000000013,"roomType":"大床房","dayNumber":3}
  ]
}

响应:
{
  "code": 200,
  "data": {
    "details": [{
      "priceMissing": true,
      "direction": "UNPRICED",
      "dayDiff": 0,
      ...
    }],
    "totalDiff": 0,
    "direction": "UNPRICED",
    "description": "另有 1 天房型价格未录入,请联系运营补录后再算差价"
  }
}

风险与回滚

新增字段 priceMissing 和新枚举值 UNPRICED 对历史前端向后兼容:不识别 UNPRICED 的旧前端会把它当 SAME 处理(退化到「无差价」),不会崩
接口路径/其它字段/DB 不变
回滚:revert PR #1353 恢复 PR #1348 行为

3.6 KiB 原始文件 Blame 文件历史