nex_buddy/server/app/models/media.py

74 lines
3.6 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

"""媒体库:网页上传 → 设备 TF 卡增量同步的版本仓(01-总体设计.md 3.4/3.5)。
设计要点:
- **按用户隔离**:媒体属于账号,同步目标是该账号绑定的设备。换绑设备后
新设备会按同一份清单重新同步,不用重新上传。
- **kind 只有 music / image**:音乐原样透传(MP3 由副控解码);图片上传时
服务端就转成 JPEG(限边、去 EXIF)——设备端不做图像处理,省 CPU 和内存。
- **crc32 而不是 sha256**:设备端要边下载边校验,CRC32 在 ESP32 上有硬件
加速且表驱动只要 256 字节;文件的完整性风险是传输误码不是恶意篡改,
管理端另有 sha256 需求的场景是固件,不是这里。
- **device_media 只做展示**:设备手上有一份 TF 卡清单(/nexbuddy/media.json)
才是同步的权威状态;这张表存设备最后一次回报的结果,网页端拿它显示
「已同步 / 待同步」,不再反向推导。
- **删除靠 diff**:用户在网页删掉一个文件,清单里就没有了;设备对比
「本地有、清单没有」→ 删 TF 卡文件并回报。不做软删除,减少状态机。
"""
from __future__ import annotations
import uuid
from datetime import datetime
from sqlalchemy import BigInteger, DateTime, ForeignKey, Integer, String, UniqueConstraint, func
from sqlalchemy.dialects.postgresql import UUID
from sqlalchemy.orm import Mapped, mapped_column
from app.db.session import Base
class MediaFile(Base):
__tablename__ = "media_files"
id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
owner_user_id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True), ForeignKey("users.id", ondelete="CASCADE"), index=True
)
kind: Mapped[str] = mapped_column(String(8)) # music / image
# TF 卡上的文件名(含扩展名),同一用户内唯一——设备端靠它落盘
name: Mapped[str] = mapped_column(String(160))
size: Mapped[int] = mapped_column(BigInteger, default=0)
crc32: Mapped[int] = mapped_column(BigInteger, default=0)
# 落盘文件名(相对 data/media),原始上传名只作展示
filename: Mapped[str] = mapped_column(String(128), default="")
original_name: Mapped[str] = mapped_column(String(160), default="")
# 图片处理后尺寸(音乐恒 0),设备端相册不需要再解码才知道多大
width: Mapped[int] = mapped_column(Integer, default=0)
height: Mapped[int] = mapped_column(Integer, default=0)
# MP3 内嵌封面抽取后的 JPEG 文件名(covers/ 下相对名),空 = 无封面。
# 只给网页列表当缩略图;设备唱片机自己解内嵌封面,不用这份。
cover_file: Mapped[str] = mapped_column(String(128), default="")
created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=func.now())
__table_args__ = (UniqueConstraint("owner_user_id", "name", name="uq_media_name"),)
class DeviceMedia(Base):
__tablename__ = "device_media"
__table_args__ = (UniqueConstraint("device_id", "media_id", name="uq_device_media"),)
device_id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True), ForeignKey("devices.id", ondelete="CASCADE"), primary_key=True
)
media_id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True), ForeignKey("media_files.id", ondelete="CASCADE"), primary_key=True
)
# synced = 文件已在 TF 卡上;设备删除/下载失败都会如实回报
state: Mapped[str] = mapped_column(String(12), default="synced")
synced_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))