forked from hesabix/arc
936 lines
35 KiB
Python
Executable file
936 lines
35 KiB
Python
Executable file
"""
|
||
Schema models کامل برای محصولات (Products)
|
||
|
||
این ماژول شامل تمام schema های مورد نیاز برای مدیریت محصولات است.
|
||
"""
|
||
from typing import Optional, List, Literal, Dict, Any
|
||
from pydantic import BaseModel, Field, field_validator, model_validator, ValidationInfo, ConfigDict
|
||
from datetime import datetime
|
||
from decimal import Decimal
|
||
from enum import Enum
|
||
|
||
|
||
class ProductItemType(str, Enum):
|
||
"""نوع آیتم محصول"""
|
||
PRODUCT = "کالا"
|
||
SERVICE = "خدمت"
|
||
|
||
|
||
class ProductAttributeValue(BaseModel):
|
||
"""مقدار ویژگی محصول"""
|
||
attribute_id: int = Field(..., description="شناسه ویژگی", gt=0)
|
||
value: str = Field(..., description="مقدار ویژگی", max_length=200)
|
||
|
||
|
||
class CatalogSpecificationItem(BaseModel):
|
||
"""یک ردیف مشخصات فنی کاتالوگ"""
|
||
field_id: Optional[int] = Field(None, description="شناسه قالب فیلد کسبوکار (اختیاری)")
|
||
label: str = Field(..., min_length=1, max_length=255, description="عنوان مشخصه")
|
||
value: str = Field(default="", max_length=2000, description="مقدار مشخصه")
|
||
sort_order: int = Field(default=0, ge=0)
|
||
|
||
|
||
class ProductSupplierSocialContactInput(BaseModel):
|
||
"""راه ارتباط پیامرسان برای تأمینکنندهٔ کالا"""
|
||
model_config = ConfigDict(extra="ignore")
|
||
|
||
platform_key: str = Field(..., min_length=1, max_length=64)
|
||
custom_label: Optional[str] = Field(default=None, max_length=128)
|
||
value: str = Field(..., min_length=1, max_length=2000)
|
||
|
||
@field_validator("platform_key", mode="before")
|
||
@classmethod
|
||
def _norm_platform_key(cls, v) -> str:
|
||
return ("" if v is None else str(v)).strip().lower()
|
||
|
||
@field_validator("custom_label", mode="before")
|
||
@classmethod
|
||
def _empty_custom_to_none(cls, v):
|
||
if v is None:
|
||
return None
|
||
t = str(v).strip()
|
||
return t if t else None
|
||
|
||
@field_validator("value", mode="before")
|
||
@classmethod
|
||
def _norm_value(cls, v) -> str:
|
||
return ("" if v is None else str(v)).strip()
|
||
|
||
@model_validator(mode="after")
|
||
def _other_needs_label(self):
|
||
if self.platform_key == "other" and not self.custom_label:
|
||
raise ValueError("برای پلتفرم «سایر» باید نام/برچسب وارد شود")
|
||
return self
|
||
|
||
|
||
class ProductSupplierInput(BaseModel):
|
||
"""تأمینکنندهٔ یک کالا (ورودی ایجاد/ویرایش)"""
|
||
model_config = ConfigDict(extra="ignore")
|
||
|
||
id: Optional[int] = Field(default=None, description="شناسه (فقط برای نمایش؛ در ذخیره نادیده گرفته میشود)")
|
||
person_id: Optional[int] = Field(default=None, gt=0, description="لینک به شخص تأمینکننده (اختیاری)")
|
||
name: Optional[str] = Field(default=None, max_length=255, description="نام/عنوان")
|
||
website: Optional[str] = Field(default=None, max_length=512)
|
||
phone: Optional[str] = Field(default=None, max_length=64)
|
||
email: Optional[str] = Field(default=None, max_length=255)
|
||
notes: Optional[str] = Field(default=None, max_length=4000)
|
||
is_preferred: bool = Field(default=False)
|
||
sort_order: int = Field(default=0, ge=0)
|
||
social_contacts: List[ProductSupplierSocialContactInput] = Field(default_factory=list)
|
||
|
||
|
||
class ProductSupplierResponse(BaseModel):
|
||
"""تأمینکنندهٔ یک کالا (خروجی API)"""
|
||
id: int
|
||
person_id: Optional[int] = None
|
||
person_name: Optional[str] = None
|
||
name: str
|
||
website: Optional[str] = None
|
||
phone: Optional[str] = None
|
||
email: Optional[str] = None
|
||
notes: Optional[str] = None
|
||
is_preferred: bool = False
|
||
sort_order: int = 0
|
||
social_contacts: List[Dict[str, Any]] = Field(default_factory=list)
|
||
|
||
|
||
class ProductOpeningBalanceInput(BaseModel):
|
||
"""تعداد اولیه کالا — فقط در سند تراز افتتاحیه ذخیره میشود."""
|
||
model_config = ConfigDict(extra="ignore")
|
||
|
||
quantity: float = Field(default=0, ge=0, description="تعداد اولیه (۰ همراه clear برای حذف)")
|
||
cost_price: float = Field(
|
||
default=0,
|
||
ge=0,
|
||
description="بهای تمامشده هر واحد برای ارزشگذاری حساب موجودی کالا",
|
||
)
|
||
warehouse_id: Optional[int] = Field(
|
||
default=None,
|
||
gt=0,
|
||
description="انبار (در صورت عدم ارسال، از default_warehouse_id کالا استفاده میشود)",
|
||
)
|
||
fiscal_year_id: Optional[int] = Field(
|
||
default=None,
|
||
description="سال مالی (در صورت عدم ارسال، سال جاری)",
|
||
)
|
||
clear: bool = Field(
|
||
default=False,
|
||
description="حذف خط موجودی اولیه از سند تراز افتتاحیه (فقط در ویرایش)",
|
||
)
|
||
|
||
@model_validator(mode="after")
|
||
def _validate_quantity_or_clear(self):
|
||
if self.clear:
|
||
return self
|
||
if self.quantity <= 0:
|
||
raise ValueError("تعداد اولیه باید بزرگتر از صفر باشد")
|
||
return self
|
||
|
||
|
||
class ProductCatalogProfileMixin(BaseModel):
|
||
"""فیلدهای پروفایل شبکهٔ تأمین (کاتالوگ عمومی)"""
|
||
catalog_short_description: Optional[str] = Field(
|
||
None,
|
||
description="خلاصه کوتاه برای نمایش در کاتالوگ",
|
||
max_length=1000,
|
||
)
|
||
catalog_expert_review: Optional[str] = Field(
|
||
None,
|
||
description="بررسی تخصصی محصول",
|
||
max_length=16000,
|
||
)
|
||
catalog_specifications: Optional[List[CatalogSpecificationItem]] = Field(
|
||
None,
|
||
description="مشخصات فنی (جدول key-value)",
|
||
)
|
||
catalog_brand: Optional[str] = Field(None, max_length=255)
|
||
catalog_model: Optional[str] = Field(None, max_length=255)
|
||
catalog_country_of_origin: Optional[str] = Field(None, max_length=128)
|
||
catalog_video_url: Optional[str] = Field(None, max_length=512)
|
||
catalog_gallery_file_ids: Optional[List[str]] = Field(
|
||
None,
|
||
description="شناسههای فایل گالری کاتالوگ (حداکثر ۱۲ تصویر)",
|
||
max_length=12,
|
||
)
|
||
|
||
|
||
class ProductCreateRequest(ProductCatalogProfileMixin):
|
||
"""درخواست ایجاد محصول جدید"""
|
||
code: Optional[str] = Field(
|
||
None,
|
||
description="کد محصول (اگر ارسال نشود، خودکار تولید میشود)",
|
||
max_length=50,
|
||
example="P1001"
|
||
)
|
||
name: str = Field(
|
||
...,
|
||
description="نام محصول",
|
||
max_length=200,
|
||
example="لپتاپ Asus Vivobook"
|
||
)
|
||
item_type: Literal["کالا", "خدمت"] = Field(
|
||
default="کالا",
|
||
description="نوع آیتم: کالا یا خدمت",
|
||
example="کالا"
|
||
)
|
||
|
||
description: Optional[str] = Field(
|
||
None,
|
||
description="توضیحات کامل محصول",
|
||
max_length=2000
|
||
)
|
||
|
||
# دستهبندی
|
||
category_id: Optional[int] = Field(
|
||
None,
|
||
description="شناسه دستهبندی",
|
||
gt=0
|
||
)
|
||
|
||
# واحدها
|
||
main_unit: Optional[str] = Field(
|
||
None,
|
||
description="واحد اصلی (مثال: عدد، کیلوگرم، متر)",
|
||
max_length=50,
|
||
example="عدد"
|
||
)
|
||
secondary_unit: Optional[str] = Field(
|
||
None,
|
||
description="واحد فرعی (اختیاری)",
|
||
max_length=50,
|
||
example="بسته"
|
||
)
|
||
unit_conversion_factor: Optional[Decimal] = Field(
|
||
None,
|
||
description="ضریب تبدیل واحد فرعی به اصلی (مثال: 1 بسته = 12 عدد)",
|
||
gt=0,
|
||
example=12
|
||
)
|
||
|
||
# قیمتگذاری
|
||
base_sales_price: Optional[Decimal] = Field(
|
||
None,
|
||
description="قیمت فروش پایه",
|
||
ge=0,
|
||
example=15000000
|
||
)
|
||
base_purchase_price: Optional[Decimal] = Field(
|
||
None,
|
||
description="قیمت خرید پایه",
|
||
ge=0,
|
||
example=12000000
|
||
)
|
||
sales_price_fx: Optional[Decimal] = Field(
|
||
None,
|
||
description="قیمت فروش ارزی (چندارزی)",
|
||
ge=0,
|
||
)
|
||
purchase_price_fx: Optional[Decimal] = Field(
|
||
None,
|
||
description="قیمت خرید ارزی (چندارزی)",
|
||
ge=0,
|
||
)
|
||
price_fx_currency_id: Optional[int] = Field(
|
||
None,
|
||
description="ارز قیمتهای ارزی",
|
||
gt=0,
|
||
)
|
||
auto_update_base_from_fx: bool = Field(
|
||
default=False,
|
||
description="بهروزرسانی خودکار قیمت پایه از نرخ × قیمت ارزی",
|
||
)
|
||
|
||
# موجودی و انبارداری
|
||
track_inventory: bool = Field(
|
||
default=False,
|
||
description="آیا موجودی این محصول کنترل شود؟"
|
||
)
|
||
default_warehouse_id: Optional[int] = Field(
|
||
None,
|
||
description="شناسه انبار پیشفرض",
|
||
gt=0
|
||
)
|
||
reorder_point: Optional[int] = Field(
|
||
None,
|
||
description="نقطه سفارش مجدد (حداقل موجودی)",
|
||
ge=0
|
||
)
|
||
min_order_qty: Optional[int] = Field(
|
||
None,
|
||
description="حداقل تعداد سفارش",
|
||
ge=0
|
||
)
|
||
lead_time_days: Optional[int] = Field(
|
||
None,
|
||
description="زمان تحویل (روز)",
|
||
ge=0
|
||
)
|
||
|
||
# حالت موجودی (فلهای/یونیک)
|
||
inventory_mode: Optional[Literal["bulk", "unique"]] = Field(
|
||
default="bulk",
|
||
description="حالت موجودی: bulk (فلهای) یا unique (یونیک)"
|
||
)
|
||
track_serial: bool = Field(
|
||
default=False,
|
||
description="ردیابی سریال نامبر برای کالاهای یونیک"
|
||
)
|
||
track_barcode: bool = Field(
|
||
default=False,
|
||
description="ردیابی بارکد برای کالاهای یونیک"
|
||
)
|
||
|
||
# مالیات
|
||
is_sales_taxable: bool = Field(
|
||
default=False,
|
||
description="آیا در فروش مشمول مالیات است؟"
|
||
)
|
||
is_purchase_taxable: bool = Field(
|
||
default=False,
|
||
description="آیا در خرید مشمول مالیات است؟"
|
||
)
|
||
sales_tax_rate: Optional[Decimal] = Field(
|
||
None,
|
||
description="نرخ مالیات فروش (درصد)",
|
||
ge=0,
|
||
le=100,
|
||
example=9
|
||
)
|
||
purchase_tax_rate: Optional[Decimal] = Field(
|
||
None,
|
||
description="نرخ مالیات خرید (درصد)",
|
||
ge=0,
|
||
le=100
|
||
)
|
||
tax_type_id: Optional[int] = Field(
|
||
None,
|
||
description="شناسه نوع مالیات",
|
||
gt=0
|
||
)
|
||
tax_code: Optional[str] = Field(
|
||
None,
|
||
description="کد مالیاتی محصول",
|
||
max_length=50
|
||
)
|
||
tax_unit_id: Optional[int] = Field(
|
||
None,
|
||
description="شناسه واحد مالیاتی",
|
||
gt=0
|
||
)
|
||
|
||
# یادداشتهای پیشفرض
|
||
base_sales_note: Optional[str] = Field(
|
||
None,
|
||
description="یادداشت پیشفرض فروش",
|
||
max_length=500
|
||
)
|
||
base_purchase_note: Optional[str] = Field(
|
||
None,
|
||
description="یادداشت پیشفرض خرید",
|
||
max_length=500
|
||
)
|
||
|
||
# تصویر
|
||
image_file_id: Optional[str] = Field(
|
||
None,
|
||
description="شناسه فایل تصویر محصول (UUID)"
|
||
)
|
||
|
||
# ویژگیها
|
||
attribute_ids: Optional[List[int]] = Field(
|
||
None,
|
||
description="لیست شناسههای ویژگیهای محصول"
|
||
)
|
||
|
||
# بارکد (legacy؛ در صورت نبود general_barcodes بهعنوان یک بارکد عمومی اولیه اعمال میشود)
|
||
barcode: Optional[str] = Field(
|
||
None,
|
||
description="بارکد محصول (legacy)",
|
||
max_length=50
|
||
)
|
||
|
||
general_barcodes: Optional[str] = Field(
|
||
None,
|
||
description="بارکدهای عمومی جدا شده با ویرگول برای اسکن و چاپ برچسب",
|
||
max_length=8192,
|
||
)
|
||
|
||
# وضعیت
|
||
is_active: bool = Field(
|
||
default=True,
|
||
description="آیا محصول فعال است؟"
|
||
)
|
||
|
||
is_public_catalog: bool = Field(
|
||
default=False,
|
||
description="انتشار عمومی در شبکهٔ کاتالوگ (API عمومی بدون احراز هویت)",
|
||
)
|
||
|
||
opening_balance: Optional[ProductOpeningBalanceInput] = Field(
|
||
default=None,
|
||
description="تعداد اولیه — در سند تراز افتتاحیه سال مالی جاری ثبت میشود",
|
||
)
|
||
|
||
suppliers: Optional[List[ProductSupplierInput]] = Field(
|
||
default=None,
|
||
description="تأمینکنندگان کالا (جایگزینی کامل در ویرایش)",
|
||
)
|
||
|
||
class Config:
|
||
json_schema_extra = {
|
||
"example": {
|
||
"code": "P1001",
|
||
"name": "لپتاپ Asus Vivobook 15",
|
||
"item_type": "کالا",
|
||
"description": "لپتاپ 15.6 اینچی با پردازنده Core i5",
|
||
"category_id": 1,
|
||
"main_unit": "عدد",
|
||
"base_sales_price": 15000000,
|
||
"base_purchase_price": 12000000,
|
||
"track_inventory": True,
|
||
"default_warehouse_id": 1,
|
||
"reorder_point": 5,
|
||
"is_sales_taxable": True,
|
||
"sales_tax_rate": 9,
|
||
"barcode": "1234567890123"
|
||
}
|
||
}
|
||
|
||
|
||
class ProductUpdateRequest(ProductCatalogProfileMixin):
|
||
"""درخواست ویرایش محصول"""
|
||
code: Optional[str] = Field(None, max_length=50)
|
||
name: Optional[str] = Field(None, max_length=200)
|
||
item_type: Optional[Literal["کالا", "خدمت"]] = None
|
||
description: Optional[str] = Field(None, max_length=2000)
|
||
category_id: Optional[int] = Field(None, gt=0)
|
||
|
||
main_unit: Optional[str] = Field(None, max_length=50)
|
||
secondary_unit: Optional[str] = Field(None, max_length=50)
|
||
unit_conversion_factor: Optional[Decimal] = Field(None, gt=0)
|
||
|
||
base_sales_price: Optional[Decimal] = Field(None, ge=0)
|
||
base_purchase_price: Optional[Decimal] = Field(None, ge=0)
|
||
sales_price_fx: Optional[Decimal] = Field(None, ge=0)
|
||
purchase_price_fx: Optional[Decimal] = Field(None, ge=0)
|
||
price_fx_currency_id: Optional[int] = Field(None, gt=0)
|
||
auto_update_base_from_fx: Optional[bool] = None
|
||
|
||
track_inventory: Optional[bool] = None
|
||
default_warehouse_id: Optional[int] = Field(None, gt=0)
|
||
reorder_point: Optional[int] = Field(None, ge=0)
|
||
min_order_qty: Optional[int] = Field(None, ge=0)
|
||
lead_time_days: Optional[int] = Field(None, ge=0)
|
||
|
||
inventory_mode: Optional[Literal["bulk", "unique"]] = None
|
||
track_serial: Optional[bool] = None
|
||
track_barcode: Optional[bool] = None
|
||
|
||
is_sales_taxable: Optional[bool] = None
|
||
is_purchase_taxable: Optional[bool] = None
|
||
sales_tax_rate: Optional[Decimal] = Field(None, ge=0, le=100)
|
||
purchase_tax_rate: Optional[Decimal] = Field(None, ge=0, le=100)
|
||
tax_type_id: Optional[int] = Field(None, gt=0)
|
||
tax_code: Optional[str] = Field(None, max_length=50)
|
||
tax_unit_id: Optional[int] = Field(None, gt=0)
|
||
|
||
base_sales_note: Optional[str] = Field(None, max_length=500)
|
||
base_purchase_note: Optional[str] = Field(None, max_length=500)
|
||
|
||
image_file_id: Optional[str] = None
|
||
attribute_ids: Optional[List[int]] = None
|
||
barcode: Optional[str] = Field(None, max_length=50)
|
||
general_barcodes: Optional[str] = Field(None, max_length=8192)
|
||
is_active: Optional[bool] = None
|
||
is_public_catalog: Optional[bool] = None
|
||
|
||
opening_balance: Optional[ProductOpeningBalanceInput] = Field(
|
||
default=None,
|
||
description="تعداد اولیه — در سند تراز افتتاحیه سال مالی جاری ثبت/بهروزرسانی میشود",
|
||
)
|
||
|
||
suppliers: Optional[List[ProductSupplierInput]] = Field(
|
||
default=None,
|
||
description="تأمینکنندگان کالا؛ اگر ارسال شود جایگزین کامل است",
|
||
)
|
||
|
||
|
||
class BulkDefaultWarehouseApplyScope(str, Enum):
|
||
"""دامنه اعمال تغییر انبار پیشفرض به صورت گروهی"""
|
||
TRACK_INVENTORY_TRUE = "track_inventory_true"
|
||
TRACK_INVENTORY_FALSE = "track_inventory_false"
|
||
ALL = "all"
|
||
|
||
|
||
class BulkDefaultWarehouseRequest(BaseModel):
|
||
"""درخواست تغییر گروهی انبار پیشفرض کالاها"""
|
||
ids: List[int] = Field(..., description="لیست شناسه کالاها", min_length=1)
|
||
default_warehouse_id: Optional[int] = Field(
|
||
None,
|
||
description="شناسه انبار پیشفرض جدید (اگر null باشد یعنی پاکسازی)",
|
||
gt=0
|
||
)
|
||
apply_scope: BulkDefaultWarehouseApplyScope = Field(
|
||
default=BulkDefaultWarehouseApplyScope.ALL,
|
||
description="اعمال روی کالاهای انبارداری/غیرانبارداری/همه"
|
||
)
|
||
|
||
|
||
class BulkDefaultWarehouseSkippedItem(BaseModel):
|
||
id: int
|
||
reason: str
|
||
code: Optional[str] = None
|
||
name: Optional[str] = None
|
||
|
||
|
||
class BulkDefaultWarehousePreviewResponse(BaseModel):
|
||
total_requested: int
|
||
found_count: int
|
||
will_update_count: int
|
||
forced_service_null_count: int = 0
|
||
skipped: List[BulkDefaultWarehouseSkippedItem] = Field(default_factory=list)
|
||
notes: List[str] = Field(default_factory=list)
|
||
|
||
|
||
class BulkDefaultWarehouseApplyResponse(BaseModel):
|
||
total_requested: int
|
||
found_count: int
|
||
updated_count: int
|
||
forced_service_null_count: int = 0
|
||
skipped: List[BulkDefaultWarehouseSkippedItem] = Field(default_factory=list)
|
||
notes: List[str] = Field(default_factory=list)
|
||
|
||
|
||
class ProductInventoryInfo(BaseModel):
|
||
"""اطلاعات موجودی محصول"""
|
||
warehouse_id: Optional[int]
|
||
warehouse_name: Optional[str]
|
||
quantity: Decimal
|
||
reserved_quantity: Decimal
|
||
available_quantity: Decimal
|
||
unit_cost: Optional[Decimal]
|
||
total_value: Optional[Decimal]
|
||
|
||
|
||
class ProductResponse(BaseModel):
|
||
"""پاسخ اطلاعات محصول"""
|
||
id: int = Field(..., description="شناسه محصول")
|
||
code: str = Field(..., description="کد محصول")
|
||
name: str = Field(..., description="نام محصول")
|
||
item_type: str = Field(..., description="نوع آیتم")
|
||
|
||
description: Optional[str] = None
|
||
|
||
business_id: int
|
||
|
||
category_id: Optional[int] = None
|
||
category_name: Optional[str] = None
|
||
|
||
main_unit: Optional[str] = None
|
||
secondary_unit: Optional[str] = None
|
||
unit_conversion_factor: Optional[Decimal] = None
|
||
|
||
base_sales_price: Optional[Decimal] = None
|
||
base_purchase_price: Optional[Decimal] = None
|
||
sales_price_fx: Optional[Decimal] = None
|
||
purchase_price_fx: Optional[Decimal] = None
|
||
price_fx_currency_id: Optional[int] = None
|
||
auto_update_base_from_fx: bool = False
|
||
|
||
track_inventory: bool
|
||
default_warehouse_id: Optional[int] = None
|
||
default_warehouse_name: Optional[str] = None
|
||
default_warehouse_code: Optional[str] = None
|
||
reorder_point: Optional[int] = None
|
||
min_order_qty: Optional[int] = None
|
||
lead_time_days: Optional[int] = None
|
||
|
||
# حالت موجودی و ردیابی
|
||
inventory_mode: Optional[str] = None
|
||
track_serial: bool = False
|
||
track_barcode: bool = False
|
||
|
||
is_sales_taxable: bool
|
||
is_purchase_taxable: bool
|
||
sales_tax_rate: Optional[Decimal] = None
|
||
purchase_tax_rate: Optional[Decimal] = None
|
||
tax_type_id: Optional[int] = None
|
||
tax_code: Optional[str] = None
|
||
tax_unit_id: Optional[int] = None
|
||
|
||
base_sales_note: Optional[str] = None
|
||
base_purchase_note: Optional[str] = None
|
||
|
||
image_file_id: Optional[str] = None
|
||
image_url: Optional[str] = None
|
||
thumbnail_url: Optional[str] = None
|
||
|
||
barcode: Optional[str] = None
|
||
general_barcodes: Optional[str] = None
|
||
is_active: bool
|
||
|
||
is_public_catalog: bool = False
|
||
catalog_public_uuid: Optional[str] = Field(
|
||
None,
|
||
description="شناسهٔ عمومی برای لینک کاتالوگ (پس از فعالسازی انتشار)",
|
||
)
|
||
|
||
catalog_short_description: Optional[str] = None
|
||
catalog_expert_review: Optional[str] = None
|
||
catalog_specifications: Optional[List[CatalogSpecificationItem]] = None
|
||
catalog_brand: Optional[str] = None
|
||
catalog_model: Optional[str] = None
|
||
catalog_country_of_origin: Optional[str] = None
|
||
catalog_video_url: Optional[str] = None
|
||
catalog_gallery_file_ids: Optional[List[str]] = None
|
||
|
||
# اطلاعات موجودی (اختیاری - بسته به درخواست)
|
||
inventory: Optional[List[ProductInventoryInfo]] = Field(
|
||
None,
|
||
description="اطلاعات موجودی در انبارها (فقط در صورت درخواست)"
|
||
)
|
||
total_quantity: Optional[Decimal] = Field(
|
||
None,
|
||
description="موجودی کل در تمام انبارها"
|
||
)
|
||
total_value: Optional[Decimal] = Field(
|
||
None,
|
||
description="ارزش کل موجودی"
|
||
)
|
||
|
||
# ویژگیها
|
||
attributes: Optional[List[dict]] = None
|
||
attribute_ids: Optional[List[int]] = None
|
||
|
||
suppliers: Optional[List[ProductSupplierResponse]] = Field(
|
||
default=None,
|
||
description="تأمینکنندگان کالا",
|
||
)
|
||
|
||
# موجودی (برای جستجو با include_inventory)
|
||
inventory_stock_accounting: Optional[Decimal] = None
|
||
inventory_stock_warehouse: Optional[Decimal] = None
|
||
|
||
created_at: Optional[str] = None
|
||
updated_at: Optional[str] = None
|
||
created_by_name: Optional[str] = None
|
||
|
||
class Config:
|
||
json_schema_extra = {
|
||
"example": {
|
||
"id": 1,
|
||
"code": "P1001",
|
||
"name": "لپتاپ Asus Vivobook 15",
|
||
"item_type": "کالا",
|
||
"category_name": "لپتاپ",
|
||
"main_unit": "عدد",
|
||
"base_sales_price": 15000000,
|
||
"base_purchase_price": 12000000,
|
||
"track_inventory": True,
|
||
"total_quantity": 25,
|
||
"total_value": 300000000,
|
||
"is_active": True
|
||
}
|
||
}
|
||
|
||
|
||
class ProductListPagination(BaseModel):
|
||
"""اطلاعات صفحهبندی لیست (همشکل با پاسخ لیست اشخاص برای DataTable)"""
|
||
total: int = Field(..., description="تعداد کل رکوردها")
|
||
page: int = Field(..., description="شماره صفحه فعلی (از ۱)")
|
||
per_page: int = Field(..., description="تعداد در هر صفحه")
|
||
total_pages: int = Field(..., description="تعداد کل صفحات")
|
||
has_next: bool = Field(..., description="آیا صفحه بعدی وجود دارد")
|
||
has_prev: bool = Field(..., description="آیا صفحه قبلی وجود دارد")
|
||
|
||
|
||
class ProductListResponse(BaseModel):
|
||
"""پاسخ لیست محصولات (همشکل با لیست اشخاص برای DataTable و pagination)"""
|
||
items: List[ProductResponse] = Field(..., description="لیست محصولات")
|
||
total_count: int = Field(..., description="تعداد کل")
|
||
has_more: bool = Field(..., description="آیا رکورد بیشتری وجود دارد")
|
||
pagination: Optional[ProductListPagination] = Field(
|
||
None,
|
||
description="اطلاعات صفحهبندی برای نمایش دکمههای صفحه بعدی/قبلی در DataTable",
|
||
)
|
||
|
||
|
||
class BulkPriceUpdateType(str, Enum):
|
||
"""نوع تغییر قیمت گروهی"""
|
||
PERCENTAGE = "percentage"
|
||
AMOUNT = "amount"
|
||
|
||
|
||
class BulkPriceUpdateDirection(str, Enum):
|
||
"""جهت تغییر قیمت"""
|
||
INCREASE = "increase"
|
||
DECREASE = "decrease"
|
||
|
||
|
||
class BulkPriceUpdateTarget(str, Enum):
|
||
"""هدف تغییر قیمت"""
|
||
SALES_PRICE = "sales_price"
|
||
PURCHASE_PRICE = "purchase_price"
|
||
BOTH = "both"
|
||
|
||
|
||
class BulkPriceUpdateScope(str, Enum):
|
||
"""محدوده اعمال تغییر قیمت گروهی"""
|
||
BASE_PRICES = "base_prices"
|
||
PRICE_LIST_ITEMS = "price_list_items"
|
||
BOTH = "both"
|
||
|
||
|
||
class BulkPriceUpdateRequest(BaseModel):
|
||
"""
|
||
درخواست تغییر گروهی قیمت (نسخه جدید)
|
||
|
||
نکته: این مدل باید با فرانت (`BulkPriceUpdateRequest.toJson`) و سرویس
|
||
`app/services/bulk_price_update_service.py` همخوان باشد.
|
||
"""
|
||
update_type: BulkPriceUpdateType = Field(
|
||
...,
|
||
description="نوع تغییر: percentage (درصدی) یا amount (مبلغی)"
|
||
)
|
||
direction: BulkPriceUpdateDirection = Field(
|
||
default=BulkPriceUpdateDirection.INCREASE,
|
||
description="جهت تغییر: increase (افزایش) یا decrease (کاهش)"
|
||
)
|
||
target: BulkPriceUpdateTarget = Field(
|
||
...,
|
||
description="هدف تغییر: sales_price / purchase_price / both"
|
||
)
|
||
update_scope: BulkPriceUpdateScope = Field(
|
||
default=BulkPriceUpdateScope.BOTH,
|
||
description="محدوده اعمال: فقط قیمت پایه، فقط آیتمهای لیست قیمت، یا هر دو",
|
||
)
|
||
value: Decimal = Field(
|
||
...,
|
||
description="مقدار تغییر (همیشه غیرمنفی؛ جهت از طریق direction تعیین میشود)",
|
||
ge=0
|
||
)
|
||
|
||
# فیلترهای انتخاب کالاها (اختیاری)
|
||
category_ids: Optional[List[int]] = Field(None, description="فیلتر بر اساس دستهبندی", min_items=1)
|
||
currency_ids: Optional[List[int]] = Field(None, description="فیلتر بر اساس ارز", min_items=1)
|
||
price_list_ids: Optional[List[int]] = Field(None, description="فیلتر بر اساس لیست قیمت", min_items=1)
|
||
item_types: Optional[List[ProductItemType]] = Field(None, description="فیلتر بر اساس نوع آیتم", min_items=1)
|
||
product_ids: Optional[List[int]] = Field(None, description="شناسههای کالاهای خاص", min_items=1)
|
||
|
||
# گزینههای اضافی
|
||
only_products_with_inventory: Optional[bool] = Field(
|
||
default=None,
|
||
description="اگر true باشد فقط کالاهای دارای کنترل موجودی؛ اگر false باشد فقط کالاهای بدون کنترل موجودی؛ اگر null باشد بدون فیلتر"
|
||
)
|
||
only_products_with_base_price: bool = Field(
|
||
default=True,
|
||
description="فقط کالاهایی که قیمت پایه (متناسب با target) دارند"
|
||
)
|
||
|
||
@field_validator("value")
|
||
@classmethod
|
||
def validate_value(cls, v: Decimal, info: ValidationInfo) -> Decimal:
|
||
update_type = info.data.get("update_type")
|
||
# محدودیت منطقی برای درصد
|
||
if update_type == BulkPriceUpdateType.PERCENTAGE and v > Decimal("1000"):
|
||
raise ValueError("درصد نمیتواند بیشتر از 1000 باشد")
|
||
return v
|
||
|
||
@model_validator(mode="after")
|
||
def validate_scope_vs_target(self) -> "BulkPriceUpdateRequest":
|
||
if (
|
||
self.update_scope == BulkPriceUpdateScope.PRICE_LIST_ITEMS
|
||
and self.target == BulkPriceUpdateTarget.PURCHASE_PRICE
|
||
):
|
||
raise ValueError(
|
||
"لیستهای قیمت فقط قیمت فروش دارند؛ هدف «فقط قیمت خرید» با محدوده «فقط لیست قیمت» سازگار نیست"
|
||
)
|
||
return self
|
||
|
||
class Config:
|
||
json_schema_extra = {
|
||
"examples": [
|
||
{
|
||
"summary": "افزایش 10 درصدی قیمت فروش (با فیلتر دسته)",
|
||
"value": {
|
||
"update_type": "percentage",
|
||
"direction": "increase",
|
||
"target": "sales_price",
|
||
"value": 10,
|
||
"category_ids": [1],
|
||
"only_products_with_base_price": True
|
||
}
|
||
},
|
||
{
|
||
"summary": "کاهش 50000 تومانی قیمت خرید (برای محصولات انتخابشده)",
|
||
"value": {
|
||
"update_type": "amount",
|
||
"direction": "decrease",
|
||
"target": "purchase_price",
|
||
"value": 50000,
|
||
"product_ids": [4, 5]
|
||
}
|
||
}
|
||
]
|
||
}
|
||
|
||
|
||
class BulkPriceListItemPreview(BaseModel):
|
||
"""پیشنمایش یک ردیف قیمت در لیست قیمت"""
|
||
price_item_id: int
|
||
price_list_id: int
|
||
price_list_name: Optional[str] = None
|
||
currency_id: int
|
||
tier_name: str
|
||
current_price: Decimal
|
||
new_price: Decimal
|
||
price_change: Decimal
|
||
|
||
|
||
class BulkPriceUpdatePreview(BaseModel):
|
||
"""پیشنمایش تغییرات قیمت"""
|
||
product_id: int
|
||
product_name: str
|
||
product_code: str
|
||
category_name: Optional[str] = None
|
||
current_sales_price: Optional[Decimal] = None
|
||
current_purchase_price: Optional[Decimal] = None
|
||
new_sales_price: Optional[Decimal] = None
|
||
new_purchase_price: Optional[Decimal] = None
|
||
sales_price_change: Optional[Decimal] = None
|
||
purchase_price_change: Optional[Decimal] = None
|
||
price_list_items: List[BulkPriceListItemPreview] = Field(
|
||
default_factory=list,
|
||
description="پیشنمایش تغییر قیمت در لیستهای قیمت (همخوان با اعمال)",
|
||
)
|
||
|
||
|
||
class BulkPriceUpdatePreviewResponse(BaseModel):
|
||
"""پیشنمایش تغییر قیمت گروهی (مطابق خروجی سرویس bulk_price_update_service و فرانت)"""
|
||
total_products: int = Field(..., description="تعداد کل محصولات مطابق فیلترها")
|
||
affected_products: List[BulkPriceUpdatePreview] = Field(
|
||
...,
|
||
description="لیست محصولات و پیشنمایش تغییرات قیمت"
|
||
)
|
||
summary: Dict[str, Any] = Field(..., description="خلاصه آماری تغییرات")
|
||
|
||
class Config:
|
||
json_schema_extra = {
|
||
"example": {
|
||
"total_products": 3,
|
||
"affected_products": [
|
||
{
|
||
"product_id": 1,
|
||
"product_name": "محصول A",
|
||
"product_code": "P-001",
|
||
"category_name": "دسته ۱",
|
||
"current_sales_price": 100000,
|
||
"current_purchase_price": 80000,
|
||
"new_sales_price": 110000,
|
||
"new_purchase_price": 88000,
|
||
"sales_price_change": 10000,
|
||
"purchase_price_change": 8000,
|
||
}
|
||
],
|
||
"summary": {
|
||
"total_products": 3,
|
||
"affected_products": 3,
|
||
"products_with_sales_change": 3,
|
||
"products_with_purchase_change": 3,
|
||
"total_sales_change": 30000,
|
||
"total_purchase_change": 24000,
|
||
"update_type": "amount",
|
||
"direction": "increase",
|
||
"target": "both",
|
||
"value": 1000,
|
||
},
|
||
}
|
||
}
|
||
|
||
|
||
class BulkProductPriceSheetPriceItemUpdate(BaseModel):
|
||
"""بهروزرسانی یک سلول قیمت در لیست قیمت (ورق ویرایش)"""
|
||
price_item_id: int = Field(..., gt=0)
|
||
price: Decimal = Field(..., ge=0, description="قیمت جدید (عدد صحیح غیرمنفی)")
|
||
|
||
|
||
class BulkProductPriceSheetRow(BaseModel):
|
||
"""یک ردیف ویرایش گسترده: قیمت پایه و/یا ردیفهای لیست قیمت"""
|
||
product_id: int = Field(..., gt=0)
|
||
base_sales_price: Optional[Decimal] = Field(
|
||
None,
|
||
description="در صورت ارسال (و بدون clear)، قیمت فروش پایه بهروز میشود",
|
||
)
|
||
base_purchase_price: Optional[Decimal] = Field(
|
||
None,
|
||
description="در صورت ارسال (و بدون clear)، قیمت خرید پایه بهروز میشود",
|
||
)
|
||
clear_base_sales_price: bool = Field(
|
||
default=False,
|
||
description="اگر true باشد قیمت فروش پایه پاک (null) میشود",
|
||
)
|
||
clear_base_purchase_price: bool = Field(
|
||
default=False,
|
||
description="اگر true باشد قیمت خرید پایه پاک (null) میشود",
|
||
)
|
||
price_item_updates: List[BulkProductPriceSheetPriceItemUpdate] = Field(
|
||
default_factory=list,
|
||
description="تغییر قیمت ردیفهای لیست قیمت مرتبط با همین کالا",
|
||
)
|
||
|
||
@model_validator(mode="after")
|
||
def at_least_one_action(self) -> "BulkProductPriceSheetRow":
|
||
has_base = (
|
||
self.clear_base_sales_price
|
||
or self.clear_base_purchase_price
|
||
or self.base_sales_price is not None
|
||
or self.base_purchase_price is not None
|
||
)
|
||
if not has_base and not self.price_item_updates:
|
||
raise ValueError("حداقل یک تغییر (قیمت پایه، پاک کردن پایه، یا قیمت لیست) لازم است")
|
||
return self
|
||
|
||
|
||
class BulkProductPriceSheetItemsRequest(BaseModel):
|
||
"""دریافت ردیفهای قیمت لیست برای نمایش در ورق ویرایش"""
|
||
product_ids: List[int] = Field(..., min_length=1, max_length=200)
|
||
price_list_ids: List[int] = Field(
|
||
...,
|
||
min_length=1,
|
||
max_length=12,
|
||
description="حداقل یک لیست قیمت برای بارگذاری ستونها",
|
||
)
|
||
|
||
|
||
class BulkProductPriceSheetApplyRequest(BaseModel):
|
||
"""اعمال دستهای قیمتهای پایه (مثلاً از نمای شبیه اکسل)"""
|
||
items: List[BulkProductPriceSheetRow] = Field(
|
||
...,
|
||
min_length=1,
|
||
max_length=500,
|
||
description="حداکثر ۵۰۰ ردیف در هر درخواست",
|
||
)
|
||
|
||
|
||
class BulkProductPriceSheetExcelExportRequest(BaseModel):
|
||
"""خروجی اکسل ورق ویرایش گسترده قیمت (همان فیلتر جستجو و لیستهای قیمت انتخابشده در UI)"""
|
||
|
||
search: Optional[str] = Field(None, max_length=500)
|
||
search_fields: Optional[List[str]] = Field(None, alias="searchFields")
|
||
price_list_ids: List[int] = Field(
|
||
default_factory=list,
|
||
max_length=12,
|
||
description="لیستهای قیمت برای ستونهای pi_*؛ خالی یعنی فقط قیمتهای پایه",
|
||
)
|
||
|
||
class Config:
|
||
populate_by_name = True
|
||
|
||
@field_validator("price_list_ids")
|
||
@classmethod
|
||
def _positive_price_list_ids(cls, v: List[int]) -> List[int]:
|
||
out: List[int] = []
|
||
for x in v:
|
||
if x > 0:
|
||
out.append(int(x))
|
||
return out
|