2.7 KiB
2.7 KiB
【修改接口·管理后台】房务订单详情「操作日志」记录定制师提交/调整需求 (#4246)
PR: #4246 | 服务: hl-order-service-v3 | 更新: 2026-06-22 姊妹项：#4239（内部留言计入定制师需求）。本次给「操作日志」tab 补上定制师提需求轨迹。
1. 背景（房务测试反馈）
房务订单详情弹窗「操作日志」tab 应记录定制师提交需求的轨迹（对齐产品操作日志），此前恒空（计数 0 + 暂无）。house_operation_log 历来只记房务侧动作（抢单/转单/配房/询房/最终确认），定制师提需求不在其中。
2. 变更（读侧合成，对存量订单立即生效）
定制师提需求的真实记录 = order_hotel_requirement 版本历史（每个 version 行 = 一次提交）。后端读「操作日志」时即时合成这些条目，与真实 house_operation_log 行合并返回。
| 接口 | 方法 | 路径 | 变更 |
|---|---|---|---|
| 操作日志列表 | GET | /v3/admin/house/orders/{orderId}/operation-log | 返回项新增「定制师提需求」合成条目（op_type=REQUIREMENT_SUBMIT），与真实日志行按时间倒序合并；total/summary 计入 |
| 订单详情聚合 | GET | /admin/house/orders/{orderId} | tabCounts.operationLogCount 由恒 0 改为真值（真实日志行数 + 需求版本数） |
3. 合成条目结构（与真实日志行同 VO）
opType=REQUIREMENT_SUBMIT，opTypeLabel= 「定制师提交需求」。time= 该需求版本提交时刻（submittedAt）。operator.userId/name= 定制师（consultantId / consultantName，缺名兜底「定制师」）。summary= v1「定制师提交房型需求 v1」；高版本「定制师调整房型需求 v{n}」。detail= orderId + requirementId（便于跳转）。id= null（合成项无 house_operation_log 主键；前端可据opType=REQUIREMENT_SUBMIT区分合成 vs 真实行）。
4. 前端处理建议
- 「操作日志」tab 直接渲染列表项即可（新 op_type
REQUIREMENT_SUBMIT随列表返回，按opTypeLabel/summary展示）；无需单独取数。 - tab 徽标计数读
tabCounts.operationLogCount（现为真值）。 - 若需视觉区分「定制师提需求」与房务侧动作，可按
opType=REQUIREMENT_SUBMIT或id==null判定。
5. 说明 / 兼容
- 纯读侧合成，不写新表、不改既有日志写入；草稿改（version 不增）按设计不单列，首版 + 各次完成版调整各一条。
- 加性变更：原有真实日志行展示不变。