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

changelogs-v2/2026-05/27_3090_HOUSE文档代码对齐-加急错误码+staff结构+分页_PR3096.md

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

changelogs-v2/2026-05/27_3101-3105_FLEET-H5网关路由+PII加密+契约补齐_PR3102-3104-3106.md

@@ -0,0 +1,69 @@
+# 二期 v3 FLEET 车务：H5 入职接口可达 + 司机 PII 加密 + 车辆/司机契约补齐
+
+> **服务**: hl-fleet-service + hl-gateway
+> **PR**: #3102 / #3104 / #3106
+> **Issue**: #3101 / #3103 / #3105
+> **日期**: 2026-05-27
+> **影响**: 🟡 H5 司机自助入职接口现可通过网关访问 + 车辆/司机列表新增字段 + 批量导入响应结构变更 + submit 入参字段名澄清(司机 PII 加密对前端透明)
+
+---
+
+## ⚠️ 关键变化(前端 mmg 必读)
+
+### 1. 【重要】H5 司机自助入职接口现可通过网关访问(原 404)
+
+之前网关缺 `/app/h5/**` 路由，下列 4 个 H5 端点过网关一律 404，现已补齐可正常调用：
+
+- `GET  /app/h5/driver-onboard/init`
+- `POST /app/h5/driver-onboard/ocr/{step}`(multipart 上传)
+- `POST /app/h5/driver-onboard/submit/new`
+- `POST /app/h5/driver-onboard/submit/renew`
+
+鉴权：H5 端走**自带 onboard token**(query/form 参数，由后端 H5OnboardService 自校验)，**不需要 admin JWT**。坏 token 返 `data.tokenValid=false`(不报错)。
+
+### 2. 车辆列表新增字段
+
+`GET /admin/fleet/vehicles/page` 的 `records[]` 现包含：
+- `typeKey` / `typeName`：车型大类(LEFT JOIN 车型库带出)
+- `regDate`：注册日期
+
+### 3. 司机列表新增字段
+
+`GET /admin/fleet/drivers/page` 的 `records[]` 现包含：
+- `licenseType` / `licenseExpire`：驾照类型 / 到期日
+- `totalOrders` / `avgRating` / `lastOrderAt`：接单数 / 评分 / 最近接单(业务流水模块上线前为默认 `0`/`0.00`/`null`)
+
+### 4. 批量导入响应结构变更 + 去重行为
+
+**车辆导入** `POST /admin/fleet/vehicles/import` 出参：
+```jsonc
+// 之前: { total, success, failed, errorRows[] }
+// 之后:
+{ "totalRows": 10, "insertedCount": 7, "updatedCount": 2, "errorCount": 1,
+  "errors": [ { "row": 5, "plate": "蒙A12345", "msg": "..." } ] }
+```
+**司机导入** `POST /admin/fleet/drivers/import` 出参：
+```jsonc
+{ "totalRows": 10, "insertedCount": 7, "renewedCount": 2, "errorCount": 1,
+  "errors": [ { "row": 5, "name": "张三", "msg": "..." } ] }
+```
+**去重行为**：车牌(车辆)/身份证(司机)**已存在的行现执行 UPDATE**(原为报错计入失败)，不存在则 INSERT。
+
+### 5. H5 新司机提交入参字段名澄清(文档笔误修正)
+
+`POST /app/h5/driver-onboard/submit/new` 入参用：
+- `idCard`(**不是** `idCardNo`)
+- `preferredCategory`(**不是** `preferredTypeKey`)
+
+代码一直是这两个名，是文档示例写错；文档已更正。前端按 `idCard` / `preferredCategory` 传参。
+
+### 6. 司机敏感字段加密(后端透明，前端无需改动)
+
+身份证 / 手机 / 驾照号 / 紧急联系电话改为**加密存储**。接口响应仍按原样**脱敏返回**(如 `idCard: "110***********2468"`)，与之前一致，**前端无感知**。
+
+---
+
+## 📌 备注
+
+- **已部署测试服(dev-v3)并经真 admin token + 真实数据 API 验证全绿**：车辆列表 typeName/typeKey/regDate 正确填充(真实 MySQL JOIN)、身份证密文存储 + 加密后按身份证去重命中 + 读路径脱敏正常、司机列表 5 个新字段齐全、`/app/h5` 路由连通。
+- 司机 PII 仅接通加密通道；测试库 #3104 前的存量明文司机均为软删数据，不影响。