From 8757c2dc0637c4c3c97dbc950bfa1a58f921ff04 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Wed, 5 Aug 2026 17:45:22 +0800 Subject: [PATCH] =?UTF-8?q?changelog:=20#5549=20=E5=8F=B8=E6=9C=BA?= =?UTF-8?q?=E4=BF=9D=E9=99=A9=E6=8D=A2=E5=8F=AF=E5=94=AE=E4=BA=A7=E5=93=81?= =?UTF-8?q?=E4=B8=8E=E4=B8=8D=E5=8F=AF=E5=94=AE=E5=8F=8B=E5=A5=BD=E6=8A=A5?= =?UTF-8?q?=E9=94=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...可售产品与不可售友好报错-修改接口-管理后台.md | 71 +++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 changelogs-v2/2026-08/05_5549_司机保险换可售产品与不可售友好报错-修改接口-管理后台.md diff --git a/changelogs-v2/2026-08/05_5549_司机保险换可售产品与不可售友好报错-修改接口-管理后台.md b/changelogs-v2/2026-08/05_5549_司机保险换可售产品与不可售友好报错-修改接口-管理后台.md new file mode 100644 index 0000000..ed9df6d --- /dev/null +++ b/changelogs-v2/2026-08/05_5549_司机保险换可售产品与不可售友好报错-修改接口-管理后台.md @@ -0,0 +1,71 @@ +--- +schema: "hl-changelog/v2" +ticket: "5549" +title: "司机保险切换到可售产品 + 不可售产品友好报错" +consumer: "admin" +change_type: "修改接口" +author: "wx(GIT)" +backend_status: "deployed" +gateway_status: "verified" +frontend_status: "pending" +frontend_owner: "wx" +frontend_ref: "司机端保险计划下拉（plan-options）新增未来星 20/30/50万 计划、畅心游保留；下架产品投保返回 540034 需前端按错误码提示（或走通用 message）" +target_release: "" +verified_at: "" +status_note: "后端完成：PR #5553/#5556/#5557 合并 dev-v3 并部署 TEST；网关实测畅心游真实投保成功（保单 11209006600507256500）、不可售产品 540034 友好报错、plan-options 过滤真实生效。" +updated_at: "2026-08-05" +base: "dev-v3" +--- + +# 司机保险切换到可售产品 + 不可售产品友好报错（#5549） + +> **服务**: hl-order-service-v3 +> **PR**: #5553 / #5556 / #5557 +> **Issue**: #5549（P1） +> **联系人**: @wx +> **日期**: 2026-08-05 +> **影响范围**: 管理后台-司机档案-保险投保；fleet 司机保险页（Feign 消费 driver-purchase / driver-plan-options） + +--- + +## 背景 + +畅心游产品费率码旧值（BY919212138521）失效导致投保必 404（#5545 排查）；保游 GetProductList 下架产品本地不更新、司机端仍可选。需求：司机保险切到可售产品（未来星等）、不可售产品报错友好。 + +## 变更接口 + +| 方法 | 路径 | 来源 | +|---|---|---| +| POST | /v3/internal/insurance/driver-purchase | fleet 司机保险投保（Feign） | +| GET | /v3/internal/insurance/driver-plan-options | fleet 司机保险计划下拉（Feign） | + +## 变更说明 + +1. **同步链路**（保险产品同步 /v3/admin/insurance/sync-products）：以保游 GetProductList 为权威可售列表，列表外的存量启用产品标记 INACTIVE（下架自动失效） +2. **投保链路** driver-purchase： + - 本地拦截：产品 INACTIVE（下架标记）→ 新错误码 **540034** + - 保游 404（费率码失效）→ 翻译 **540034** + - 保游业务拒绝（501 URL 地址受限 / 地址受限 / 下架 / 失效）→ 翻译 **540034**（替代 540030 裸透传） +3. **plan-options**：过滤 INACTIVE 产品与孤儿计划的计划；司机端不再看到下架产品 + +## 接口行为变化 + +| 接口 | 修复前 | 修复后 | +|---|---|---| +| `POST driver-purchase`（不可售产品） | 540030「为{0}投保失败: [501]url地址受限」/ 裸 404 | **540034「该产品已下架/不可售，请更换可售产品」** | +| `POST driver-purchase`（可售产品） | 不变 | 不变（畅心游真实投保成功，保单号非 MOCK） | +| `GET driver-plan-options` | 仅畅心游 20万计划 | 畅心游 20万 + 未来星 20/30/50万（未来星产品计划 usage_category 已标注 BOTH）；INACTIVE 产品被过滤 | + +## 新增错误码 + +| 错误码 | 消息 | +|---|---| +| 540034 | 该产品已下架/不可售，请更换可售产品 | + +## 验证证据 + +- 网关实测（2026-08-05，内部接口 SSH 直连 8086）： + - 畅心游投保 → 200，extOrderNo=BX2026080517395620000670，回调后 INSURED + 真实保单号 **11209006600507256500**（非 MOCK） + - 未来星投保 → **540034**「该产品已下架/不可售，请更换可售产品」（保游 501 URL 受限翻译） + - plan-options → 4 计划（畅心游+未来星 20/30/50万）；临时标 INACTIVE 后过滤只剩畅心游，恢复后 4 计划 +- 定向测试：InsuranceCreateServiceTest/InsuranceManageServiceTest/InsuranceQueryServiceTest 111/111（新增 5 用例：540034 本地拦截/404 翻译/501 翻译/plan-options 过滤/同步标 INACTIVE）