Steven
e25a1a4e31
CI / backend (push) Canceled after 0s
- item/tag/item_tag/comment/activity 五表迁移，RLS 全覆盖，pg_trgm 子串索引
- 状态机 domain/task.py：非法流转回 5002 并给 allowed，done 写 completed_at
- /workspaces/{ws}/items 列表/详情/新建/改/状态/软删/评论/标签
- 乐观锁 UPDATE...WHERE version，冲突 4009 + current_version
- Web 任务页：视图 tab、快速新建、勾选完成、开工/阻塞、详情事件流、游标分页
- 测试 43 全绿，ruff 干净，Web 构建通过
- 文档：2.Design/API.md 新增，ROADMAP 按已验证口径重写
93 lines
2.4 KiB
Python
93 lines
2.4 KiB
Python
"""错误码与异常。错误码一旦对外发布就**不许改号**（客户端靠它做分支）。"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from enum import IntEnum
|
|
from typing import Any
|
|
|
|
|
|
class ErrorCode(IntEnum):
|
|
OK = 0
|
|
|
|
# 1xxx 通用
|
|
BAD_REQUEST = 1001
|
|
VALIDATION_FAILED = 1002
|
|
NOT_FOUND = 1004
|
|
CONFLICT = 1009
|
|
PAYLOAD_TOO_LARGE = 1013
|
|
RATE_LIMITED = 1029
|
|
INTERNAL = 1500
|
|
|
|
# 2xxx 认证 / 账号
|
|
UNAUTHORIZED = 2001
|
|
TOKEN_EXPIRED = 2002
|
|
TOKEN_INVALID = 2003
|
|
SMS_CODE_INVALID = 2010
|
|
SMS_TOO_FREQUENT = 2011
|
|
ACCOUNT_DISABLED = 2012
|
|
|
|
# 3xxx 租户 / 权限
|
|
WORKSPACE_NOT_FOUND = 3001
|
|
NOT_A_MEMBER = 3003
|
|
INSUFFICIENT_ROLE = 3004
|
|
ALREADY_A_MEMBER = 3005
|
|
INVITATION_INVALID = 3010
|
|
|
|
# 4xxx 并发
|
|
VERSION_CONFLICT = 4009
|
|
|
|
# 5xxx 任务域
|
|
ITEM_NOT_FOUND = 5001
|
|
ITEM_STATUS_INVALID = 5002
|
|
TAG_NOT_FOUND = 5003
|
|
|
|
|
|
# 默认 HTTP 状态：业务码自己带语义，HTTP 只是传输层
|
|
_HTTP_STATUS: dict[ErrorCode, int] = {
|
|
ErrorCode.OK: 200,
|
|
ErrorCode.BAD_REQUEST: 400,
|
|
ErrorCode.VALIDATION_FAILED: 422,
|
|
ErrorCode.NOT_FOUND: 404,
|
|
ErrorCode.CONFLICT: 409,
|
|
ErrorCode.PAYLOAD_TOO_LARGE: 413,
|
|
ErrorCode.RATE_LIMITED: 429,
|
|
ErrorCode.INTERNAL: 500,
|
|
ErrorCode.UNAUTHORIZED: 401,
|
|
ErrorCode.TOKEN_EXPIRED: 401,
|
|
ErrorCode.TOKEN_INVALID: 401,
|
|
ErrorCode.SMS_CODE_INVALID: 400,
|
|
ErrorCode.SMS_TOO_FREQUENT: 429,
|
|
ErrorCode.ACCOUNT_DISABLED: 403,
|
|
ErrorCode.WORKSPACE_NOT_FOUND: 404,
|
|
ErrorCode.NOT_A_MEMBER: 403,
|
|
ErrorCode.INSUFFICIENT_ROLE: 403,
|
|
ErrorCode.ALREADY_A_MEMBER: 409,
|
|
ErrorCode.INVITATION_INVALID: 400,
|
|
ErrorCode.VERSION_CONFLICT: 409,
|
|
ErrorCode.ITEM_NOT_FOUND: 404,
|
|
ErrorCode.ITEM_STATUS_INVALID: 409,
|
|
ErrorCode.TAG_NOT_FOUND: 404,
|
|
}
|
|
|
|
|
|
class AppError(Exception):
|
|
"""业务异常。__str__ 只用于日志，对外一律走 code + message。"""
|
|
|
|
def __init__(
|
|
self,
|
|
code: ErrorCode,
|
|
message: str | None = None,
|
|
*,
|
|
http_status: int | None = None,
|
|
details: Any = None,
|
|
) -> None:
|
|
self.code = code
|
|
self.message = message or code.name
|
|
self.http_status = http_status or _HTTP_STATUS.get(code, 400)
|
|
self.details = details
|
|
super().__init__(f"[{int(code)}] {self.message}")
|
|
|
|
|
|
def http_status_for(code: ErrorCode) -> int:
|
|
return _HTTP_STATUS.get(code, 400)
|