于小丘
bcb0a9b322
Some checks failed
Test / test (push) Failing after 2m32s
Replace one-to-one FileMetadata table with flexible ObjectMetadata KV pairs, add custom property definitions, WOPI Discovery auto-configuration, and per-extension action URL support. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
128 lines
3.7 KiB
Python
128 lines
3.7 KiB
Python
"""
|
||
对象元数据 KV 模型
|
||
|
||
以键值对形式存储文件的扩展元数据。键名使用命名空间前缀分类，
|
||
如 exif:width, stream:duration, music:artist 等。
|
||
|
||
架构：
|
||
ObjectMetadata (KV 表，与 Object 一对多关系)
|
||
└── 每个 Object 可以有多条元数据记录
|
||
└── (object_id, name) 组合唯一索引
|
||
|
||
命名空间：
|
||
- exif: 图片 EXIF 信息（尺寸、相机参数、拍摄时间等）
|
||
- stream: 音视频流信息（时长、比特率、视频尺寸、编解码等）
|
||
- music: 音乐标签（标题、艺术家、专辑等）
|
||
- geo: 地理位置（经纬度、地址）
|
||
- apk: Android 安装包信息
|
||
- custom: 用户自定义属性
|
||
- sys: 系统内部元数据
|
||
- thumb: 缩略图信息
|
||
"""
|
||
from enum import StrEnum
|
||
from typing import TYPE_CHECKING
|
||
from uuid import UUID
|
||
|
||
from sqlmodel import Field, UniqueConstraint, Index, Relationship
|
||
|
||
from sqlmodel_ext import SQLModelBase, UUIDTableBaseMixin
|
||
|
||
if TYPE_CHECKING:
|
||
from .object import Object
|
||
|
||
|
||
# ==================== 枚举 ====================
|
||
|
||
class MetadataNamespace(StrEnum):
|
||
"""元数据命名空间枚举"""
|
||
EXIF = "exif"
|
||
"""图片 EXIF 信息（含尺寸、相机参数、拍摄时间等）"""
|
||
MUSIC = "music"
|
||
"""音乐标签（title/artist/album/genre 等）"""
|
||
STREAM = "stream"
|
||
"""音视频流信息（codec/duration/bitrate/resolution 等）"""
|
||
GEO = "geo"
|
||
"""地理位置（latitude/longitude/address）"""
|
||
APK = "apk"
|
||
"""Android 安装包信息（package_name/version 等）"""
|
||
THUMB = "thumb"
|
||
"""缩略图信息（内部使用）"""
|
||
SYS = "sys"
|
||
"""系统元数据（内部使用）"""
|
||
CUSTOM = "custom"
|
||
"""用户自定义属性"""
|
||
|
||
|
||
# 对外不可见的命名空间（API 不返回给普通用户）
|
||
INTERNAL_NAMESPACES: set[str] = {MetadataNamespace.SYS, MetadataNamespace.THUMB}
|
||
|
||
# 用户可写的命名空间
|
||
USER_WRITABLE_NAMESPACES: set[str] = {MetadataNamespace.CUSTOM}
|
||
|
||
|
||
# ==================== Base 模型 ====================
|
||
|
||
class ObjectMetadataBase(SQLModelBase):
|
||
"""对象元数据 KV 基础模型"""
|
||
|
||
name: str = Field(max_length=255)
|
||
"""元数据键名，格式：namespace:key（如 exif:width, stream:duration）"""
|
||
|
||
value: str
|
||
"""元数据值（统一为字符串存储）"""
|
||
|
||
|
||
# ==================== 数据库模型 ====================
|
||
|
||
class ObjectMetadata(ObjectMetadataBase, UUIDTableBaseMixin):
|
||
"""
|
||
对象元数据 KV 模型
|
||
|
||
以键值对形式存储文件的扩展元数据。键名使用命名空间前缀分类，
|
||
每个对象的每个键名唯一（通过唯一索引保证）。
|
||
"""
|
||
|
||
__table_args__ = (
|
||
UniqueConstraint("object_id", "name", name="uq_object_metadata_object_name"),
|
||
Index("ix_object_metadata_object_id", "object_id"),
|
||
)
|
||
|
||
object_id: UUID = Field(
|
||
foreign_key="object.id",
|
||
ondelete="CASCADE",
|
||
)
|
||
"""关联的对象UUID"""
|
||
|
||
is_public: bool = False
|
||
"""是否对分享页面公开"""
|
||
|
||
# 关系
|
||
object: "Object" = Relationship(back_populates="metadata_entries")
|
||
"""关联的对象"""
|
||
|
||
|
||
# ==================== DTO 模型 ====================
|
||
|
||
class MetadataResponse(SQLModelBase):
|
||
"""元数据查询响应 DTO"""
|
||
|
||
metadatas: dict[str, str]
|
||
"""元数据字典（键名 → 值）"""
|
||
|
||
|
||
class MetadataPatchItem(SQLModelBase):
|
||
"""单条元数据补丁 DTO"""
|
||
|
||
key: str = Field(max_length=255)
|
||
"""元数据键名"""
|
||
|
||
value: str | None = None
|
||
"""值，None 表示删除此条目"""
|
||
|
||
|
||
class MetadataPatchRequest(SQLModelBase):
|
||
"""元数据批量更新请求 DTO"""
|
||
|
||
patches: list[MetadataPatchItem]
|
||
"""补丁列表"""
|