hesabixArc/hesabixAPI/adapters/api/v1/schema_models/person.py

from typing import List, Optional
from pydantic import BaseModel, Field
from enum import Enum
from datetime import datetime


class PersonType(str, Enum):
    """نوع شخص"""
    CUSTOMER = "مشتری"
    MARKETER = "بازاریاب"
    EMPLOYEE = "کارمند"
    SUPPLIER = "تامین‌کننده"
    PARTNER = "همکار"
    SELLER = "فروشنده"
    SHAREHOLDER = "سهامدار"


class PersonBankAccountCreateRequest(BaseModel):
    """درخواست ایجاد حساب بانکی شخص"""
    bank_name: str = Field(..., min_length=1, max_length=255, description="نام بانک")
    account_number: Optional[str] = Field(default=None, max_length=50, description="شماره حساب")
    card_number: Optional[str] = Field(default=None, max_length=20, description="شماره کارت")
    sheba_number: Optional[str] = Field(default=None, max_length=30, description="شماره شبا")


class PersonBankAccountUpdateRequest(BaseModel):
    """درخواست ویرایش حساب بانکی شخص"""
    bank_name: Optional[str] = Field(default=None, min_length=1, max_length=255, description="نام بانک")
    account_number: Optional[str] = Field(default=None, max_length=50, description="شماره حساب")
    card_number: Optional[str] = Field(default=None, max_length=20, description="شماره کارت")
    sheba_number: Optional[str] = Field(default=None, max_length=30, description="شماره شبا")
    is_active: Optional[bool] = Field(default=None, description="وضعیت فعال بودن")


class PersonBankAccountResponse(BaseModel):
    """پاسخ اطلاعات حساب بانکی شخص"""
    id: int = Field(..., description="شناسه حساب بانکی")
    person_id: int = Field(..., description="شناسه شخص")
    bank_name: str = Field(..., description="نام بانک")
    account_number: Optional[str] = Field(default=None, description="شماره حساب")
    card_number: Optional[str] = Field(default=None, description="شماره کارت")
    sheba_number: Optional[str] = Field(default=None, description="شماره شبا")
    is_active: bool = Field(..., description="وضعیت فعال بودن")
    created_at: str = Field(..., description="تاریخ ایجاد")
    updated_at: str = Field(..., description="تاریخ آخرین بروزرسانی")

    class Config:
        from_attributes = True


class PersonCreateRequest(BaseModel):
    """درخواست ایجاد شخص جدید"""
    # اطلاعات پایه
    code: Optional[int] = Field(default=None, ge=1, description="کد یکتا در هر کسب و کار (در صورت عدم ارسال، خودکار تولید می‌شود)")
    alias_name: str = Field(..., min_length=1, max_length=255, description="نام مستعار (الزامی)")
    first_name: Optional[str] = Field(default=None, max_length=100, description="نام")
    last_name: Optional[str] = Field(default=None, max_length=100, description="نام خانوادگی")
    person_type: Optional[PersonType] = Field(default=None, description="نوع شخص (سازگاری قدیمی)")
    person_types: Optional[List[PersonType]] = Field(default=None, description="انواع شخص (چندانتخابی)")
    company_name: Optional[str] = Field(default=None, max_length=255, description="نام شرکت")
    payment_id: Optional[str] = Field(default=None, max_length=100, description="شناسه پرداخت")
    
    # اطلاعات اقتصادی
    national_id: Optional[str] = Field(default=None, max_length=20, description="شناسه ملی")
    registration_number: Optional[str] = Field(default=None, max_length=50, description="شماره ثبت")
    economic_id: Optional[str] = Field(default=None, max_length=50, description="شناسه اقتصادی")
    
    # اطلاعات تماس
    country: Optional[str] = Field(default=None, max_length=100, description="کشور")
    province: Optional[str] = Field(default=None, max_length=100, description="استان")
    city: Optional[str] = Field(default=None, max_length=100, description="شهرستان")
    address: Optional[str] = Field(default=None, description="آدرس")
    postal_code: Optional[str] = Field(default=None, max_length=20, description="کد پستی")
    phone: Optional[str] = Field(default=None, max_length=20, description="تلفن")
    mobile: Optional[str] = Field(default=None, max_length=20, description="موبایل")
    fax: Optional[str] = Field(default=None, max_length=20, description="فکس")
    email: Optional[str] = Field(default=None, max_length=255, description="پست الکترونیکی")
    website: Optional[str] = Field(default=None, max_length=255, description="وب‌سایت")
    
    # حساب‌های بانکی
    bank_accounts: Optional[List[PersonBankAccountCreateRequest]] = Field(default=[], description="حساب‌های بانکی")
    # سهام
    share_count: Optional[int] = Field(default=None, ge=1, description="تعداد سهام (برای سهامدار، اجباری و حداقل 1)")
    # پورسانت (برای بازاریاب/فروشنده)
    commission_sale_percent: Optional[float] = Field(default=None, ge=0, le=100, description="درصد پورسانت از فروش")
    commission_sales_return_percent: Optional[float] = Field(default=None, ge=0, le=100, description="درصد پورسانت از برگشت از فروش")
    commission_sales_amount: Optional[float] = Field(default=None, ge=0, description="مبلغ فروش مبنا")
    commission_sales_return_amount: Optional[float] = Field(default=None, ge=0, description="مبلغ برگشت از فروش مبنا")
    commission_exclude_discounts: Optional[bool] = Field(default=False, description="عدم محاسبه تخفیف")
    commission_exclude_additions_deductions: Optional[bool] = Field(default=False, description="عدم محاسبه اضافات و کسورات")
    commission_post_in_invoice_document: Optional[bool] = Field(default=False, description="ثبت پورسانت در سند فاکتور")

    @classmethod
    def __get_validators__(cls):
        yield from super().__get_validators__()

    @staticmethod
    def _has_shareholder(person_type: Optional[PersonType], person_types: Optional[List[PersonType]]) -> bool:
        if person_type == PersonType.SHAREHOLDER:
            return True
        if person_types:
            return PersonType.SHAREHOLDER in person_types
        return False

    @classmethod
    def validate(cls, value):  # type: ignore[override]
        obj = super().validate(value)
        # اعتبارسنجی شرطی سهامدار
        if cls._has_shareholder(getattr(obj, 'person_type', None), getattr(obj, 'person_types', None)):
            sc = getattr(obj, 'share_count', None)
            if sc is None or (isinstance(sc, int) and sc <= 0):
                raise ValueError("برای سهامدار، مقدار تعداد سهام الزامی و باید بزرگتر از صفر باشد")
        return obj


class PersonUpdateRequest(BaseModel):
    """درخواست ویرایش شخص"""
    # اطلاعات پایه
    code: Optional[int] = Field(default=None, ge=1, description="کد یکتا در هر کسب و کار")
    alias_name: Optional[str] = Field(default=None, min_length=1, max_length=255, description="نام مستعار")
    first_name: Optional[str] = Field(default=None, max_length=100, description="نام")
    last_name: Optional[str] = Field(default=None, max_length=100, description="نام خانوادگی")
    person_type: Optional[PersonType] = Field(default=None, description="نوع شخص (سازگاری قدیمی)")
    person_types: Optional[List[PersonType]] = Field(default=None, description="انواع شخص (چندانتخابی)")
    company_name: Optional[str] = Field(default=None, max_length=255, description="نام شرکت")
    payment_id: Optional[str] = Field(default=None, max_length=100, description="شناسه پرداخت")
    
    # اطلاعات اقتصادی
    national_id: Optional[str] = Field(default=None, max_length=20, description="شناسه ملی")
    registration_number: Optional[str] = Field(default=None, max_length=50, description="شماره ثبت")
    economic_id: Optional[str] = Field(default=None, max_length=50, description="شناسه اقتصادی")
    
    # اطلاعات تماس
    country: Optional[str] = Field(default=None, max_length=100, description="کشور")
    province: Optional[str] = Field(default=None, max_length=100, description="استان")
    city: Optional[str] = Field(default=None, max_length=100, description="شهرستان")
    address: Optional[str] = Field(default=None, description="آدرس")
    postal_code: Optional[str] = Field(default=None, max_length=20, description="کد پستی")
    phone: Optional[str] = Field(default=None, max_length=20, description="تلفن")
    mobile: Optional[str] = Field(default=None, max_length=20, description="موبایل")
    fax: Optional[str] = Field(default=None, max_length=20, description="فکس")
    email: Optional[str] = Field(default=None, max_length=255, description="پست الکترونیکی")
    website: Optional[str] = Field(default=None, max_length=255, description="وب‌سایت")
    
    # وضعیت
    is_active: Optional[bool] = Field(default=None, description="وضعیت فعال بودن")
    # سهام
    share_count: Optional[int] = Field(default=None, ge=1, description="تعداد سهام (برای سهامدار)")
    # پورسانت
    commission_sale_percent: Optional[float] = Field(default=None, ge=0, le=100, description="درصد پورسانت از فروش")
    commission_sales_return_percent: Optional[float] = Field(default=None, ge=0, le=100, description="درصد پورسانت از برگشت از فروش")
    commission_sales_amount: Optional[float] = Field(default=None, ge=0, description="مبلغ فروش مبنا")
    commission_sales_return_amount: Optional[float] = Field(default=None, ge=0, description="مبلغ برگشت از فروش مبنا")
    commission_exclude_discounts: Optional[bool] = Field(default=None, description="عدم محاسبه تخفیف")
    commission_exclude_additions_deductions: Optional[bool] = Field(default=None, description="عدم محاسبه اضافات و کسورات")
    commission_post_in_invoice_document: Optional[bool] = Field(default=None, description="ثبت پورسانت در سند فاکتور")

    @classmethod
    def __get_validators__(cls):
        yield from super().__get_validators__()

    @staticmethod
    def _has_shareholder(person_type: Optional[PersonType], person_types: Optional[List[PersonType]]) -> bool:
        if person_type == PersonType.SHAREHOLDER:
            return True
        if person_types:
            return PersonType.SHAREHOLDER in person_types
        return False

    @classmethod
    def validate(cls, value):  # type: ignore[override]
        obj = super().validate(value)
        # اگر ورودی‌ها مشخصاً به سهامدار اشاره دارند، share_count باید معتبر باشد
        if cls._has_shareholder(getattr(obj, 'person_type', None), getattr(obj, 'person_types', None)):
            sc = getattr(obj, 'share_count', None)
            if sc is None or (isinstance(sc, int) and sc <= 0):
                raise ValueError("برای سهامدار، مقدار تعداد سهام الزامی و باید بزرگتر از صفر باشد")
        return obj


class PersonResponse(BaseModel):
    """پاسخ اطلاعات شخص"""
    id: int = Field(..., description="شناسه شخص")
    business_id: int = Field(..., description="شناسه کسب و کار")
    
    # اطلاعات پایه
    code: Optional[int] = Field(default=None, description="کد یکتا")
    alias_name: str = Field(..., description="نام مستعار")
    first_name: Optional[str] = Field(default=None, description="نام")
    last_name: Optional[str] = Field(default=None, description="نام خانوادگی")
    person_type: str = Field(..., description="نوع شخص")
    person_types: List[str] = Field(default_factory=list, description="انواع شخص")
    company_name: Optional[str] = Field(default=None, description="نام شرکت")
    payment_id: Optional[str] = Field(default=None, description="شناسه پرداخت")
    
    # اطلاعات اقتصادی
    national_id: Optional[str] = Field(default=None, description="شناسه ملی")
    registration_number: Optional[str] = Field(default=None, description="شماره ثبت")
    economic_id: Optional[str] = Field(default=None, description="شناسه اقتصادی")
    
    # اطلاعات تماس
    country: Optional[str] = Field(default=None, description="کشور")
    province: Optional[str] = Field(default=None, description="استان")
    city: Optional[str] = Field(default=None, description="شهرستان")
    address: Optional[str] = Field(default=None, description="آدرس")
    postal_code: Optional[str] = Field(default=None, description="کد پستی")
    phone: Optional[str] = Field(default=None, description="تلفن")
    mobile: Optional[str] = Field(default=None, description="موبایل")
    fax: Optional[str] = Field(default=None, description="فکس")
    email: Optional[str] = Field(default=None, description="پست الکترونیکی")
    website: Optional[str] = Field(default=None, description="وب‌سایت")
    
    # وضعیت
    is_active: bool = Field(..., description="وضعیت فعال بودن")
    
    # زمان‌بندی
    created_at: str = Field(..., description="تاریخ ایجاد")
    updated_at: str = Field(..., description="تاریخ آخرین بروزرسانی")
    
    # حساب‌های بانکی
    bank_accounts: List[PersonBankAccountResponse] = Field(default=[], description="حساب‌های بانکی")
    # سهام
    share_count: Optional[int] = Field(default=None, description="تعداد سهام")
    # پورسانت
    commission_sale_percent: Optional[float] = Field(default=None, description="درصد پورسانت از فروش")
    commission_sales_return_percent: Optional[float] = Field(default=None, description="درصد پورسانت از برگشت از فروش")
    commission_sales_amount: Optional[float] = Field(default=None, description="مبلغ فروش مبنا")
    commission_sales_return_amount: Optional[float] = Field(default=None, description="مبلغ برگشت از فروش مبنا")
    commission_exclude_discounts: Optional[bool] = Field(default=False, description="عدم محاسبه تخفیف")
    commission_exclude_additions_deductions: Optional[bool] = Field(default=False, description="عدم محاسبه اضافات و کسورات")
    commission_post_in_invoice_document: Optional[bool] = Field(default=False, description="ثبت پورسانت در سند فاکتور")

    class Config:
        from_attributes = True


class PersonListResponse(BaseModel):
    """پاسخ لیست اشخاص"""
    items: List[PersonResponse] = Field(..., description="لیست اشخاص")
    pagination: dict = Field(..., description="اطلاعات صفحه‌بندی")
    query_info: dict = Field(..., description="اطلاعات جستجو و فیلتر")


class PersonSummaryResponse(BaseModel):
    """پاسخ خلاصه اشخاص"""
    total_persons: int = Field(..., description="تعداد کل اشخاص")
    by_type: dict = Field(..., description="تعداد بر اساس نوع")
    active_persons: int = Field(..., description="تعداد اشخاص فعال")
    inactive_persons: int = Field(..., description="تعداد اشخاص غیرفعال")