changelog: #5536 保险订单 v3 补 /orders 列表别名

changelogs-v2/2026-08/05_5536_保险订单v3补orders列表别名-新增接口-管理后台.md

@@ -0,0 +1,55 @@
+---
+schema: "hl-changelog/v2"
+ticket: "5536"
+title: "保险订单 v3 补 /orders 列表别名（对齐 v2 与前端调用）"
+consumer: "admin"
+change_type: "新增接口"
+author: "wx(GIT)"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: "wx"
+frontend_ref: "hl-ui 保险订单页已调 /v3/admin/insurance/orders（此前 404），后端别名已上线，无需前端改动；待前端回归确认页面加载恢复后置 verified"
+target_release: ""
+verified_at: ""
+status_note: "后端完成：PR #5541 已合并 dev-v3 并部署 TEST；网关实测 /v3/admin/insurance/orders 200 total=255，与 /list 完全一致（修复前 404）。前端保险订单页无需改动，回归确认后置 verified。"
+updated_at: "2026-08-05"
+base: "dev-v3"
+---
+
+# 保险订单 v3 补 /orders 列表别名（#5536）
+
+> **服务**: hl-order-service-v3
+> **PR**: #5541
+> **Issue**: #5536（P1）
+> **联系人**: @wx
+> **日期**: 2026-08-05
+> **影响范围**: 管理后台-保险管理-保险订单页（前端已调 /orders 复数路径）
+
+---
+
+## 背景
+
+前端保险订单页调 `GET /v3/admin/insurance/orders` → **404 数据加载失败**。v3 只有 `/v3/admin/insurance/list`（实测 code=200 total=255），缺 `/orders` 复数别名；v2（`/admin/insurance/orders`）与前端调用均为复数路径。
+
+## 变更接口
+
+| 方法 | 路径 | 来源 |
+|---|---|---|
+| GET | /v3/admin/insurance/orders | 管理后台-保险订单页 |
+
+## 变更说明
+
+`AdminInsuranceController.listOrders` 路由映射由 `"/list"` 扩展为 `/list` 与 `/orders` 两个路径——**同一方法同返回**（分页参数 `InsuranceQueryRequest` 与 /list 完全一致），不新增逻辑。
+
+## 接口行为变化
+
+| 接口 | 修复前 | 修复后 |
+|---|---|---|
+| `GET /v3/admin/insurance/orders` | 404 | 200，`PageResult<InsuranceOrderVO>`（total=255，与 /list 一致） |
+| `GET /v3/admin/insurance/list` | 200 | 不变 |
+
+## 验证证据
+
+- 网关实测（api.test.1814.love:9443，admin，2026-08-05）：`/v3/admin/insurance/orders` 200 total=255；`/v3/admin/insurance/list` 200 total=255；首条 `insuranceOrderId=2084823362831306753 / extPolicyNo=MOCKPOL-... / totalPremium="88.00"`，两路径响应一致
+- 定向测试：AdminInsuranceControllerTest 19/19（新增 `/orders` 别名与 `/list` 同返回断言用例）