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，全绿。
67 lines
2.3 KiB
Python
67 lines
2.3 KiB
Python
"""附件：任务与知识条目共用一张表。
|
||
|
||
为什么不区分 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
|
||
)
|