68 行
2.5 KiB
Markdown
68 行
2.5 KiB
Markdown
---
|
||
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: "verified"
|
||
frontend_owner: "pi-main-session"
|
||
frontend_ref: "hl-admin@ef497e8e30d2df2d55d97f5554c8c5e921dc49ef"
|
||
target_release: ""
|
||
verified_at: "2026-08-05"
|
||
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` 同返回断言用例）
|
||
|
||
## 关联/联系人
|
||
|
||
### 链接
|
||
|
||
- [后端工单 #5536](https://git.1814.love:8443/wx/HL/issues/5536)
|
||
- [后端 PR #5541](https://git.1814.love:8443/wx/HL/pulls/5541)
|
||
- Merge commit: `2936d67f1b`
|
||
|
||
### 联系人
|
||
|
||
- **后端负责人**: @wx
|