74 lines
3.6 KiB
Python
74 lines
3.6 KiB
Python
"""媒体库:网页上传 → 设备 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))
|