docs: 收敛 api-contract 错误码(HTTP 5 位码 vs 业务规则号)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
parent
634897cd3d
commit
455708fbc0
@ -19,7 +19,7 @@
|
||||
## 契约 / 文档
|
||||
|
||||
- [x] ~~**统一响应 `hint` 字段**~~ ✅ 已补(2026-10-21):TransformInterceptor + error filter 都加 `hint: null`。
|
||||
- [ ] **api-contract 错误码列表(1001–4001)未实现**:实际用 5 位 `[域2][序3]`(如 40001),spec 内部不一致,需先收敛 spec 再对齐。
|
||||
- [x] ~~**api-contract 错误码列表(1001–4001)未实现**~~ ✅ 已收敛(2026-10-21):spec 区分 HTTP 5 位码(error-codes.ts 权威)与业务规则号(message/hint 中的 1001–4001)。
|
||||
- [ ] **登录页属地提示**:frontend spec「属地提示」未实现(多租户登录前属地未知,需先厘清语义)。
|
||||
- [ ] **前端等级筛选未暴露**:后端 `ListElderQuery.level` 已实现,前端搜索未用。
|
||||
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
- **THEN** 返回非 0 code 与可读 message,且 `hint` 说明「先做什么才能做」
|
||||
|
||||
### Requirement: 业务错误码
|
||||
业务错误码 MUST 落地为 5 位码 [域码2][序3],并覆盖:1001 无有效待遇、1002 无有效计划、1003 无有效工单、1004 留痕不完整、1005 未质控、1006 资质不匹配(提示级)、2001 时间冲突(硬拒)、2002 项数不满足(提示)、3001 必拍未拍(硬拒)、3002 定位失败(非错误)、3003 扑空登记、3004 垫付不计费、4001 越权或自审自放行。
|
||||
HTTP 业务错误码 MUST 落地为 **5 位码 [域码2][序3]**(权威见 `src/common/error-codes.ts`:40 机构/41 人员/42 目录/43 老人/44 计划工单/45 留痕/46 质控),如 40001 机构不存在、44001 计划不存在、45001 留痕不存在、46001 qc 不存在。**业务规则号**(非 HTTP 码,出现在 message/hint):1001 无有效待遇、1002 无有效计划、1003 无有效工单、1004 留痕不完整、1005 未质控、1006 资质不匹配(提示级)、2001 时间冲突(硬拒)、2002 项数不满足(提示)、3001 必拍未拍(硬拒)、3002 定位失败(非错误)、3003 扑空登记、3004 垫付不计费、4001 越权或自审自放行。
|
||||
|
||||
#### Scenario: 资质不匹配提示级
|
||||
- **WHEN** 派单时护理员资质不匹配
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user