From 56c549816767a4487d48248510f9e9ce05db0684 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 22 Jun 2026 17:04:22 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#4246=20=E6=88=BF=E5=8A=A1?=
 =?UTF-8?q?=E6=93=8D=E4=BD=9C=E6=97=A5=E5=BF=97=E8=AE=B0=E5=BD=95=E5=AE=9A?=
 =?UTF-8?q?=E5=88=B6=E5=B8=88=E6=8F=90=E9=9C=80=E6=B1=82(=E8=AF=BB?=
 =?UTF-8?q?=E4=BE=A7=E5=90=88=E6=88=90,op=5Ftype=20REQUIREMENT=5FSUBMIT)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...“�作日志记录定制师æ��需求_读侧å�ˆæˆ�_管ç�†å�Žå�°.md | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 changelogs-v2/2026-06/22_4246_房务�作日志记录定制师�需求_读侧��_管���.md

diff --git a/changelogs-v2/2026-06/22_4246_房务�作日志记录定制师�需求_读侧��_管���.md b/changelogs-v2/2026-06/22_4246_房务�作日志记录定制师�需求_读侧��_管���.md
new file mode 100644
index 0000000..bfe9513
--- /dev/null
+++ b/changelogs-v2/2026-06/22_4246_房务�作日志记录定制师�需求_读侧��_管���.md
@@ -0,0 +1,36 @@
+# �修改接�·管���】房务订�详情「�作日志�记录定制师�交/调整需求 (#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 �增）按设计��列，首版 + �次完�版调整�一�。
+- 加性�更：原有真实日志行展示��。
+
+## 6. 关�
+- **PR**: [#4246](https://git.1814.love:8443/wx/HL/pulls/4246)（房务测试�馈驱动，无关� Issue）
+- **�端负责人**: @wx ｜ **�端**: @mmg