Steven
ed31af3f46
CI / backend (push) Canceled after 0s
知识以前只能"填个标题就完成"，正文、标签、归类都要点进去再补。现在新建 就是一张完整的备忘录：标题、类型、分类、标签、正文一次写完，存完直接打开 详情继续编辑；知识页左侧多了工作区三级分类树，可按分类子树 / 未分类 / 标签 筛选。凡是填信息的抽屉都加宽了，还能一键展开整屏。 后端 - 新增 `knowledge_category`（迁移 0007）：`workspace_id NOT NULL` + 自引用 `parent_id`、`depth` 1..3 检查约束、同层重名唯一索引（lower(name)）、 RLS 策略与 `dadao_app` 授权；`knowledge_doc.category_id` 外键 ON DELETE SET NULL。 - 新增 `/knowledge/categories` 增删改查：超三级 `7007`、同层重名 `7008`、 跨租户或不存在 `7006`；`move=true` 才改父级，成环与移动后超过三级的子树 一律拒绝，删除有知识的分类要 `force=true`（知识变未分类）。 - 知识列表支持 `category_id`（含子树）、`uncategorized`、`tag`；输出带 `category`（含 `path` / `full_path`）。 - PATCH 只改分类或标签也会推进 `version`，避免"只动标签"之后下次保存撞 乐观锁 `4009`。 Web - `Sheet` 增 `size="md/lg/xl"` 与展开整屏按钮；任务、工单、知识抽屉统一 加宽（`TaskDetail` / `Tickets` / `Knowledge`）。 - 知识页：左侧三级分类树（新建、按子树筛选、未分类）、`KnowledgeComposer` 一次写全新的备忘录、列表卡片露出分类路径与标签、详情抽屉里可直接改分类 与标签。 - 抽屉详情只拉一次：重复的 effect 或迟到的响应不再覆盖用户正在敲的内容。 安卓 - `Api.kt`：分类模型与接口、新建/更新带 `tag_names`/`category_id`、 列表带分类与标签筛选。 - 知识页重做：新建改为近全屏大对话框（标题/类型/分类/标签/正文），列表 顶部按分类筛选，详情里能改分类与标签后单独保存。 文档与测试 - `2.Design/API.md`：5.1/5.3/5.4 补分类与筛选参数，新增 5.5 分类接口章节， 错误码补 `7006`/`7007`/`7008`。 - `2.Design/ROADMAP-M0-M1.md`：新增 3.11（三级分类）、3.12（备忘录形态）。 - 新增 `backend/tests/test_knowledge_categories.py`（8 例）：备忘形态落库、 三级到底、移动越界与成环、重名、按子树/未分类/标签/关键词筛选、删分类需 `force`、跨租户隔离。 - 新增 `web/e2e/knowledge-notebook.mjs`（10 项，全绿）：建两级分类 → 一次 写全 → 卡片与筛选 → 抽屉改标签/分类 → 正文落库 → 重名 7008。 验证：`pytest` 93 passed、`ruff check` / `ruff format --check` 全过、 `tsc --noEmit` 通过、`vite build` 通过、`knowledge-notebook.mjs` 10 项全绿。 安卓端本机只有 JDK 25，Gradle 8.7 / AGP 8.7.3 不支持，本次未做编译验证。
137 lines
3.8 KiB
Python
137 lines
3.8 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
|
|
KNOWLEDGE_CATEGORY_NOT_FOUND = 7006
|
|
KNOWLEDGE_CATEGORY_DEPTH = 7007
|
|
KNOWLEDGE_CATEGORY_CONFLICT = 7008
|
|
|
|
# 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.KNOWLEDGE_CATEGORY_NOT_FOUND: 404,
|
|
ErrorCode.KNOWLEDGE_CATEGORY_DEPTH: 422,
|
|
ErrorCode.KNOWLEDGE_CATEGORY_CONFLICT: 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)
|