docs(changelog-v2): HOUSE 文档对齐(#3096) + FLEET H5路由/PII加密/契约补齐(#3102/3104/3106),测试服验证通过通知前端

2026-05-27 15:39:14 +08:00
@@ -0,0 +1,44 @@
+# 二期 v3 HOUSE 文档-代码对齐：加急错误码迁移 + staff 响应结构 + 分页一致性
+
+> **服务**: hl-order-service-v3
+> **PR**: #3096
+> **Issue**: #3090
+> **日期**: 2026-05-27
+> **影响**: 🟡 加急(escalate)错误码值变更(前端错误码映射需同步) + 转单候选员工接口响应结构变更 + 分页行为修复(向后兼容)
+
+---
+
+## ⚠️ 关键变化(前端 mmg 必读)
+
+### 1. 询房加急(escalate)4 个错误码迁移：`808280-808283` → `808815-808818`
+
+`POST /v3/admin/order/inquiry/{inquiryId}/escalate`(§3.6 加急/催办)相关的 4 个业务错误码，按 API 文档 §11.8 规定从 **808280-808283 段迁移到 808815-808818 段**。
+
+- **message 中文文案不变**(动态返回)。
+- 前端**若按数字 code 做错误提示映射**：请把这 4 个码从 `8082xx` 更新为 `8088xx`。
+- 前端**若直接展示 `message` 字段**：无需任何改动。
+
+### 2. 转单候选员工 staff 响应结构：裸数组 → `{list,total}`
+
+`GET /v3/admin/house/staff` 出参从裸数组改为带分页包装，对齐文档 §6.6：
+
+```jsonc
+// 之前
+"data": [ {...}, {...} ]
+// 之后
+"data": { "list": [ {...} ], "total": 12 }
+```
+
+前端请改读 `data.list` / `data.total`。
+（注：该接口数据源依赖 user-service H07 工单，当前返回空列表 `{list:[],total:0}`，**结构已就位**，待 H07 上线后有数据。）
+
+### 3. 「我的接单」分页一致性修复(行为修复，无需前端改动)
+
+`GET /v3/admin/order/grab-pool/my-claims/hotel` 带筛选条件(keyword / 出行日 等)时，`total` 与 `list` 现在保持一致。原实现是 SQL 分页后再内存过滤，导致带筛选时 total 偏大、跨页漏数据，现已下沉到 SQL。前端分页页数/条数将更准确。
+
+---
+
+## 📌 备注
+
+- 已部署测试服(dev-v3)并经真 admin token API 验证：staff 返 `{list,total}` 结构正确、加急接口路径连通(返 HOUSE 错误码)。
+- 加急错误码 808815-818 的具体触发场景由后端单测覆盖，需真实询房数据触发；前端按上述 code 段更新映射即可。