文件
hl-api-changelog/changelogs-v2/2026-08/05_5515_保险任务列表枚举校验补全与source筛选生效-修改接口-管理后台.md
T
Mimingguang 5e3affae41
changelog-filename-gate / validate (push) Failing after 2s
chore(changelog): 保险域 6 条 implemented 复核翻 verified
复核证据:mmg 2026-09-18 逐条核验——6 个 frontend_ref 提交均可达且为
v2.1 祖先;HEAD 上各项前端实现标记仍在(totalPremium 读取/source 筛选
链/plan-options 消费/policyPdfUrl 在线预览/保单 Tab+司机名筛选/insure
直投端点);5 个相关 spec 文件 36 例全绿。frontend_status 翻 verified、
verified_at 补 2026-09-18、status_note 追加复核记录;07_5640 的短哈希
ref 顺带补全为全哈希。
2026-09-18 15:26:28 +08:00

4.0 KiB
原始文件 Blame 文件历史

schema, ticket, title, consumer, change_type, author, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base
schema ticket title consumer change_type author backend_status gateway_status frontend_status frontend_owner frontend_ref target_release verified_at status_note updated_at base
hl-changelog/v2 5515 车务保险任务列表枚举校验补全 + source 来源筛选生效 admin 修改接口 wx(GIT) deployed verified verified pi-main-session hl-admin@1553c988ac6065e693769a95f3f412c4e43df5e7 2026-09-18 后端完成:PR #5522 已合并 dev-v3 并部署 TEST;非法枚举/分页返 400 明确错误码,source 筛选生效(BAOYOU=206)。前端若传 source 参数无需改动;旧传非法枚举值需适配 400 响应。[mmg 2026-09-18 复核翻 verified] ref 1553c988 可达且为 v2.1 祖先;HEAD 上车务保险任务页 source 筛选链完整(filters.source/sourceOptions/非法枚举归 undefined 不传);fleet/insurance spec 全绿。 2026-09-18 dev-v3

车务: 保险任务列表枚举校验补全 + source 来源筛选生效

服务: hl-fleet-service PR: #5522 Issue: #5515(#5516 分页校验同 PR) 日期: 2026-08-05 影响范围: 管理后台车务保险菜单的任务列表筛选参数


⚠️ 关键变化

GET /admin/fleet/insurance/tasks 三个筛选参数行为变更:

  1. taskType 非法值不再静默空结果:taskType=NOT_A_TYPE 此前 code=200 + total=0;现在返 400,message=任务类型必须是 PURCHASE(投保)/REFUND(退保) 之一。
  2. taskStatus 非法值不再静默空结果:taskStatus=BAD_STATUS 此前 code=200 + total=0;现在返 400,message=任务状态必须是 PENDING/PROCESSING/SUCCESS/RESOLVED/IGNORED 之一。
  3. source 参数新增并生效:此前 source=BAOYOU 被 Spring 静默忽略(返全量 207);现在按来源过滤(BAOYOU=206 / OFFLINE=1),非法值返 400(来源必须是 BAOYOU(保游)/OFFLINE(线下) 之一)。

同源收紧(同 PR):GET /admin/fleet/matrix/grid 与 GET /admin/fleet/matrix/month-counts 的 season 非法值返 400(司机赛季必须是 active/pending/archived/blacklist 之一);GET /admin/fleet/board/expiry 与 GET /admin/fleet/board/orders 分页参数 page/pageSize 非法(非数字/负数/0/超 100)返 400(页码最小为1 等),与 drivers/vehicles 列表口径一致。

变更接口清单

# 接口 方法 路径 变更类型 说明
1 保险任务列表 GET /admin/fleet/insurance/tasks 校验补全+新增参数 taskType/taskStatus 非法值 400;新增 source 筛选
2 矩阵主数据 GET /admin/fleet/matrix/grid 校验补全 season 非法值 400
3 矩阵月度统计 GET /admin/fleet/matrix/month-counts 校验补全 season 非法值 400
4 证件到期看板 GET /admin/fleet/board/expiry 校验补全 page/pageSize 非法值 400
5 看板列表 GET /admin/fleet/board/orders 校验补全 page/pageSize 非法值 400

接口详情

1. 保险任务列表 GET /admin/fleet/insurance/tasks

source 参数(新增):

  • 类型:string;枚举:BAOYOU(保游·线上)/ OFFLINE(线下);空/缺省=全部
  • 生效:与 taskType/taskStatus 等 AND 过滤下推 DB(source = ? 等值条件)

校验规则(taskType/taskStatus/source 均 @Pattern):

  • 非法值 → code=400,message 包含合法枚举(不再静默空结果)
  • 合法值行为不变(taskType=PURCHASE→28、taskStatus=PENDING→25 等回归不变)

示例:

GET /admin/fleet/insurance/tasks?source=BAOYOU&taskType=PURCHASE
→ 200,仅返回 source=BAOYOU 的投保任务
GET /admin/fleet/insurance/tasks?taskType=NOT_A_TYPE
→ 400 任务类型必须是 PURCHASE(投保)/REFUND(退保) 之一

关联/联系人

链接

联系人

  • 后端负责人: @wx