dingdanquanliucheng/backend/app/schemas/files.py

"""
文件上传模块请求模型

定义文件上传相关的请求体数据模型，供 files 路由使用。
包含获取上传凭证和保存附件元信息两个操作。
"""

from pydantic import BaseModel, Field


class CreateUploadTokenRequest(BaseModel):
    """获取文件上传凭证请求体。被 POST /api/files/upload-token 路由使用。"""

    biz_type: str
    """业务类型（如 order / logistics / customer 等，用于文件归档分类）"""

    biz_id: int = Field(gt=0)
    """业务关联 ID（如订单 ID、客户 ID 等）"""

    file_name: str
    """原始文件名称"""

    file_type: str
    """文件 MIME 类型（如 image/png）"""

    file_size: int = Field(gt=0)
    """文件大小（字节）"""


class SaveAttachmentRequest(BaseModel):
    """保存附件元信息请求体。被 POST /api/files/attachments 路由使用。"""

    biz_type: str
    """业务类型"""

    biz_id: int = Field(gt=0)
    """业务关联 ID"""

    file_name: str
    """文件名称"""

    file_url: str
    """文件 URL（上传后的访问地址）"""

    file_type: str
    """文件 MIME 类型"""

    file_size: int = Field(gt=0)
    """文件大小（字节）"""