diff --git a/changelogs-v2/2026-08/05_5536_保险订单v3补orders列表别名-新增接口-管理后台.md b/changelogs-v2/2026-08/05_5536_保险订单v3补orders列表别名-新增接口-管理后台.md new file mode 100644 index 0000000..652fef3 --- /dev/null +++ b/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`(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` 同返回断言用例)