dadao
a24a493403
写一件事的时候，光有纯文本不够：要贴截图、要分段、要标重点。 这次把「正文」这条路补全，思路是**存 Markdown 而不是 HTML**—— 能导出、能全文检索、能直接喂给 LLM，也不必每次渲染都重新清洗一遍 HTML。 后端 - attachment 表 + RLS + 迁移 0005；本地磁盘存储，key 由内容 sha256 决定， 换对象存储只改 services/storage.py 一个文件 - 上传在**读流时**卡 20MB，不先落盘再判断；磁盘名由服务端生成，用户文件名只进库和响应头 - 列表带 attachment_count、详情带 attachments，避免一屏 N 次请求 - raw 直链给 <img src> 用（图片带不了 Authorization 头），只允许本工作区成员， 非成员一律 8001 不区分「不存在」与「没权限」 - 5 个用例：上传下载、超限、跨租户、删除确认与权限、raw 鉴权 前端 - 自研零依赖 Markdown 渲染器：先转义再上标签，链接协议白名单 - RichTextEditor：工具栏 + Ctrl+B/I + 预览，粘贴或拖入图片自动上传并插入引用 - AttachmentPanel：上传/下载/删除，下载走带 Authorization 的 fetch 转 blob - 任务备注、工单说明与验收结论、知识正文、评论全部接入 顺手修的 - TaskDetail.hydrate 漏了 setAttachments，导致附件面板永远是空的（e2e 抓到的） 71 passed；web tsc 0 错、构建 255.07 kB │ gzip 80.85 kB； e2e：richtext 9 项 + smoke 7 + tickets 8 + knowledge 7，全绿。
131 lines
3.6 KiB
Python
131 lines
3.6 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
|
|
LINK_NOT_FOUND = 5004
|
|
LINK_CONFLICT = 5005
|
|
|
|
# 6xxx 工单域
|
|
TICKET_NOT_FOUND = 6001
|
|
TICKET_ALREADY_EXISTS = 6002
|
|
TICKET_STATUS_INVALID = 6003
|
|
TICKET_FORBIDDEN = 6004
|
|
NOTIFICATION_NOT_FOUND = 6005
|
|
|
|
# 7xxx 知识域
|
|
KNOWLEDGE_NOT_FOUND = 7001
|
|
KNOWLEDGE_ALREADY_EXISTS = 7002
|
|
KNOWLEDGE_STATUS_INVALID = 7003
|
|
KNOWLEDGE_FORBIDDEN = 7004
|
|
KNOWLEDGE_SOURCE_REQUIRED = 7005
|
|
|
|
# 8xxx 附件
|
|
ATTACHMENT_NOT_FOUND = 8001
|
|
ATTACHMENT_TOO_LARGE = 8002
|
|
ATTACHMENT_FORBIDDEN = 8003
|
|
CONFIRM_REQUIRED = 8004
|
|
|
|
|
|
# 默认 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,
|
|
ErrorCode.LINK_NOT_FOUND: 404,
|
|
ErrorCode.LINK_CONFLICT: 409,
|
|
ErrorCode.TICKET_NOT_FOUND: 404,
|
|
ErrorCode.TICKET_ALREADY_EXISTS: 409,
|
|
ErrorCode.TICKET_STATUS_INVALID: 409,
|
|
ErrorCode.TICKET_FORBIDDEN: 403,
|
|
ErrorCode.NOTIFICATION_NOT_FOUND: 404,
|
|
ErrorCode.KNOWLEDGE_NOT_FOUND: 404,
|
|
ErrorCode.KNOWLEDGE_ALREADY_EXISTS: 409,
|
|
ErrorCode.KNOWLEDGE_STATUS_INVALID: 409,
|
|
ErrorCode.KNOWLEDGE_FORBIDDEN: 403,
|
|
ErrorCode.KNOWLEDGE_SOURCE_REQUIRED: 409,
|
|
ErrorCode.ATTACHMENT_NOT_FOUND: 404,
|
|
ErrorCode.ATTACHMENT_TOO_LARGE: 413,
|
|
ErrorCode.ATTACHMENT_FORBIDDEN: 403,
|
|
ErrorCode.CONFIRM_REQUIRED: 409,
|
|
}
|
|
|
|
|
|
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)
|