chore: sync worktree changes - update protocols, trellis workspace, and config
This commit is contained in:
@@ -64,13 +64,20 @@
|
||||
|
||||
## Error Codes
|
||||
|
||||
推荐错误码(由后端映射为 4xx):
|
||||
当前实现(`backend/src/v1/schedule_items/service.py`)实际返回以下稳定错误码:
|
||||
|
||||
- `INVALID_DATETIME_FORMAT`
|
||||
- `NAIVE_DATETIME_FORBIDDEN`
|
||||
- `INVALID_TIMEZONE`
|
||||
- `TIMEZONE_REQUIRED`
|
||||
- `INVALID_TIME_RANGE`
|
||||
- `SCHEDULE_ITEM_DATETIME_TIMEZONE_REQUIRED`:输入 datetime 缺少时区偏移
|
||||
- `SCHEDULE_ITEM_START_AT_TIMEZONE_REQUIRED`:`end_at` 校验阶段缺少可用的 `start_at` 时区信息
|
||||
- `SCHEDULE_ITEM_INVALID_TIME_RANGE`:`end_at <= start_at`
|
||||
|
||||
说明:`timezone` 非法、`start_at/end_at` 无时区等基础结构错误在 schema 校验阶段由 FastAPI/Pydantic 返回 `422`,业务错误码表(`docs/protocols/common/http-error-codes.md`)目前仅登记服务层稳定码。
|
||||
|
||||
---
|
||||
|
||||
## Compatibility Strategy
|
||||
|
||||
- 策略:`backward-compatible`
|
||||
- 本次为文档对齐更新,不改变线上接口行为;客户端若仅按 HTTP 状态码处理不受影响。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user