feat(rich): 备注/工单说明/知识正文支持 Markdown 与图片附件

写一件事的时候,光有纯文本不够:要贴截图、要分段、要标重点。
这次把「正文」这条路补全,思路是**存 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,全绿。
This commit is contained in:
dadao
2026-10-29 01:53:46 +08:00
parent 0a3b0f3ca0
commit a24a493403
24 changed files with 1843 additions and 25 deletions
+66
View File
@@ -0,0 +1,66 @@
"""附件:任务与知识条目共用一张表。
为什么不区分 kind:知识本身就是 `item`(kind=knowledge),附件挂在 `item_id` 上
天然对任务、工单、知识一视同仁;将来要给「工单」加验收材料也不用再建表。
文件本体放磁盘,库里只存元数据与 `storage_key`。这样做的代价是备份要同时备盘,
收益是数据库不会被几十 MB 的文件撑爆、备份与恢复的粒度还能分开。
"""
from __future__ import annotations
import uuid
from datetime import datetime
from sqlalchemy import (
BigInteger,
CheckConstraint,
DateTime,
ForeignKey,
Index,
String,
func,
)
from sqlalchemy.dialects.postgresql import UUID as PgUUID
from sqlalchemy.orm import Mapped, mapped_column
from app.models import Base
ATTACHMENT_TENANT_TABLES = ("attachment",)
class Attachment(Base):
__tablename__ = "attachment"
__table_args__ = (
CheckConstraint("size_bytes >= 0", name="ck_attachment_size"),
Index("ix_attachment_ws_item", "workspace_id", "item_id", "created_at"),
)
id: Mapped[uuid.UUID] = mapped_column(
PgUUID(as_uuid=True), primary_key=True, default=uuid.uuid4
)
workspace_id: Mapped[uuid.UUID] = mapped_column(
PgUUID(as_uuid=True),
ForeignKey("workspace.id", ondelete="CASCADE"),
nullable=False,
)
item_id: Mapped[uuid.UUID] = mapped_column(
PgUUID(as_uuid=True),
ForeignKey("item.id", ondelete="CASCADE"),
nullable=False,
)
uploader_id: Mapped[uuid.UUID] = mapped_column(
PgUUID(as_uuid=True), ForeignKey("app_user.id", ondelete="RESTRICT"), nullable=False
)
# 原始文件名:只用于展示与下载时的 Content-Disposition,绝不参与磁盘路径
filename: Mapped[str] = mapped_column(String(255), nullable=False)
content_type: Mapped[str] = mapped_column(
String(120), nullable=False, default="application/octet-stream"
)
size_bytes: Mapped[int] = mapped_column(BigInteger, nullable=False, default=0)
sha256: Mapped[str] = mapped_column(String(64), nullable=False)
storage_key: Mapped[str] = mapped_column(String(255), nullable=False, unique=True)
created_at: Mapped[datetime] = mapped_column(
DateTime(timezone=True), server_default=func.now(), nullable=False
)