docs: 发布#5932车务错误码契约
这个提交包含在:
父节点
f5cf9b2f53
当前提交
5b2de4a2a0
@ -0,0 +1,41 @@
|
|||||||
|
---
|
||||||
|
schema: "hl-changelog/v2"
|
||||||
|
ticket: "5932"
|
||||||
|
title: "车务降级与权限错误码统一"
|
||||||
|
consumer: "admin"
|
||||||
|
change_type: "修改接口"
|
||||||
|
author: "wx(GIT)"
|
||||||
|
backend_status: "deployed"
|
||||||
|
gateway_status: "verified"
|
||||||
|
frontend_status: "pending"
|
||||||
|
frontend_owner: "mmg"
|
||||||
|
frontend_ref: "pending"
|
||||||
|
target_release: "v2.1"
|
||||||
|
verified_at: "2026-08-13"
|
||||||
|
updated_at: "2026-08-13"
|
||||||
|
status_note: "PR #5950 已合并 dev-v3,fleet 测试服部署任务 30cb1e1b 成功;车辆分页和对账期分页网关只读实测 HTTP/code 200。"
|
||||||
|
base: "dev-v3"
|
||||||
|
---
|
||||||
|
|
||||||
|
# 车务降级与权限错误码统一(#5932)
|
||||||
|
|
||||||
|
## 影响范围
|
||||||
|
|
||||||
|
- fleet 调权限、文件、团期资源、订单服务的 Feign 降级响应统一为可稳定识别的六位业务码。
|
||||||
|
- 日快照回调区分瞬时失败 `605711` 与永久 4xx `605712`:前者重试,后者立即隔离。
|
||||||
|
- 未认证/无权限分别保留真实 HTTP 401/403;超级管理员业务权限拒绝仍为 HTTP 200 + 业务码 `403001`。
|
||||||
|
- 参数绑定错误统一 HTTP 200 + `100001`,类型错误文案补字段和日期格式提示。
|
||||||
|
|
||||||
|
## 前端适配
|
||||||
|
|
||||||
|
- Feign 服务不可用按响应 `code` 处理,不依赖中文 message。
|
||||||
|
- HTTP 401/403 继续由登录/权限公共处理器接管。
|
||||||
|
- `403001` 是业务权限码,不等于 HTTP 403。
|
||||||
|
|
||||||
|
## 验证证据
|
||||||
|
|
||||||
|
- PR `#5950`,squash merge `453540c7`。
|
||||||
|
- 聚焦 75/75,ArchTest 13/13,spotless 通过。
|
||||||
|
- MockMvc 真实验证 HTTP 401/403。
|
||||||
|
- Deploy Panel `30cb1e1b` 成功。
|
||||||
|
- 网关只读:`GET /admin/fleet/vehicles/page`、`GET /admin/fleet/reconciliation/periods` 均 HTTP 200 / code 200。
|
||||||
正在加载...
x
在新工单中引用
屏蔽一个用户