dingdanquanliucheng/backend/app/schemas/suppliers.py

"""
供应商模块请求模型

定义供应商管理相关的请求体数据模型，供 suppliers 路由使用。
包含供应商的创建和更新操作。
"""

from pydantic import BaseModel


class CreateSupplierRequest(BaseModel):
    """创建供应商请求体。被 POST /api/suppliers 路由使用。"""

    supplier_name: str
    """供应商名称"""

    supplier_type: str
    """供应商类型（如原材料供应商、物流供应商等）"""

    contact_name: str | None = None
    """联系人姓名"""

    contact_mobile: str | None = None
    """联系人电话"""

    address: str | None = None
    """供应商地址"""

    template_type: str | None = None
    """对账模板类型"""

    status: int = 1
    """状态：1-启用，0-禁用"""

    remark: str | None = None
    """备注信息"""


class UpdateSupplierRequest(BaseModel):
    """更新供应商请求体。被 PUT /api/suppliers/{id} 路由使用。"""

    supplier_name: str
    """供应商名称"""

    supplier_type: str
    """供应商类型"""

    contact_name: str | None = None
    """联系人姓名"""

    contact_mobile: str | None = None
    """联系人电话"""

    address: str | None = None
    """供应商地址"""

    template_type: str | None = None
    """对账模板类型"""

    status: int = 1
    """状态：1-启用，0-禁用"""

    remark: str | None = None
    """备注信息"""