# 二期 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 段更新映射即可。
