docs(前端通知): 司机投保承保期改短期默认+限90天(保游无年期产品),计划一取消司机标记

wx 拍先用短期险打通。保游测试目录无≥365天产品(最长豪华版180天),
10万计划≤90天可用、计划一坏的已取消DRIVER标记。前端把投保下单默认承保期
从1年改短期(如30天)+约束≤90天。司机年保1年期待对接保游配年险。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
这个提交包含在:
API Changelog Bot 2026-06-15 14:06:14 +08:00
父节点 1c5746a977
当前提交 618a6fa5bc

查看文件

@ -0,0 +1,36 @@
# 【行为/前端·管理后台】司机投保「保障期」默认应是短期且最多 90 天(保游无年期产品),别再默认 1 年
> 端hl-ui保险订单 / 投保下单 → 人员类型=司机)| 服务hl-fleet-service + hl-order-service-v3 insurance后端无改动,计划标记已调整| wx 2026-06-15 拍板「司机险先用短期险打通」| 2026-06-15
## ⚠️ 关键背景:司机险目前只能短期(保游没有年期产品)
排查实测确认:**保游测试目录里没有任何 ≥365 天1 年)的产品**——最长才 180 天豪华版,司机可用的「10万计划」**最多 90 天**。所以司机年保1 年当前做不到,wx 拍板**先用短期险打通**。
- **后端已调整**:把投不了的「计划一」(费率只有 1 档、任何承保期都失败)**取消了「司机可用」标记**;现在司机投保的「保险计划」下拉**只剩「10万计划」**可用,1–90 天)。
- 司机年保 1 年期待后续对接保游配年险,暂不在本次范围。
## 1. 前端要改什么
投保下单(人员类型=司机)的「保障开始 / 保障结束」:
1. **默认值从「1 年」改成短期**:现在默认是 `开始=明天, 结束=次年-1天`≈364 天),这必然投保失败。改成短期默认,如 **开始=明天、结束=开始+29 天**30 天)。
2. **承保期最多 90 天**:建议前端约束 `结束 - 开始 + 1 ≤ 90`,超 90 天直接拦下并提示「司机险最长 90 天」(否则提交必失败,保游返「承保天数不符」)。
3. 可选:弹窗加一句说明「司机险为短期意外险,最长 90 天」。
> 承保天数与保费对应10万计划实测1天¥1 / 30天¥10.8 / 90天¥48.4(保费后端算,前端不用管,可用试算接口预览)。
## 2. 后端契约(无变化,仅说明)
- 司机可选计划:`GET /admin/fleet/drivers/insurance/plan-options` → 现在只返「10万计划」(planId 2054773833342451714)。
- 投保:`POST /admin/fleet/drivers/{driverId}/insurance/purchase` body `{planId, coverageStartDate, coverageEndDate, remark, bindAnnual}` ——承保期超计划上限会返 **540030**「承保天数不符」(保游透传)。
## 验收
投保下单选司机 → 计划下拉只有「10万计划」→ 保障期默认是短期≤90天→ 确认投保成功INSURING 受理)。把保障期手动设成 >90 天应被前端拦下或后端返 540030。
---
## 附:本次后端侧已做
- 取消「计划一」(planId ...828716134401) 的司机可用标记PUT usage-category=CUSTOMER——它保游配置坏的、投不了,避免运营/前端选到一直报错。
- 全表 45 个测试司机身份证已修为合法号(另见同日 changelog,投保不再卡身份证。