src.db.models.transactions

 16class Transactions(Base):
 17    """Модель транзакций.
 18
 19    Эта модель представляет собой структуру данных для хранения информации
 20    о транзакциях пользователей.
 21    """
 22
 23    __tablename__ = "transactions"
 24    __table_args__ = {"extend_existing": True}
 25
 26    id: Mapped[int] = mapped_column(primary_key=True)
 27    """int: Уникальный идентификатор транзакции."""
 28
 29    user_id: Mapped[int] = mapped_column(
 30        ForeignKey("userdata.telegram_id", ondelete="CASCADE"), type_=BigInteger
 31    )
 32    """int: Идентификатор пользователя в Telegram, связанный с транзакцией."""
 33
 34    date: Mapped[datetime] = mapped_column(type_=DateTime(timezone=True))
 35    """datetime: Дата и время транзакции с учетом часового пояса."""
 36
 37    amount: Mapped[float]
 38    """float: Сумма транзакции."""
 39
 40    label: Mapped[UUID]
 41    """UUID: Метка транзакции."""
 42
 43    # PAYED
 44    transaction_id: Mapped[str | None]
 45    """str | None: Идентификатор транзакции (по умолчанию None)."""
 46
 47    sha1_hash: Mapped[str | None]
 48    """str | None: SHA-1 хэш транзакции (по умолчанию None)."""
 49
 50    sender: Mapped[str | None]
 51    """str | None: Отправитель транзакции (по умолчанию None)."""
 52
 53    withdraw_amount: Mapped[float | None]
 54    """float | None: Сумма вывода (по умолчанию None)."""
 55
 56    # additionally
 57    transaction_reference: Mapped[str]
 58    """str: Ссылка на транзакцию."""
 59
 60    transact_connect: Mapped["UserData"] = relationship(  # noqa: F821 # type: ignore
 61        back_populates="transactions", lazy="subquery"
 62    )
 63    """UserData: Связанные транзакции пользователя"""
 64
 65    class ValidationSchema(BaseModel):
 66        """Схема валидации для модели транзакций.
 67
 68        Эта схема используется для валидации данных, связанных с транзакциями.
 69        """
 70
 71        id: int | None = Field(default=None, title="ID")
 72        """Уникальный идентификатор транзакции."""
 73
 74        user_id: int | None = Field(default=None, title="Telegram ID")
 75        """Идентификатор пользователя в Telegram (по умолчанию None)."""
 76
 77        date: datetime = Field(title="Transaction date")
 78        """Дата и время транзакции."""
 79
 80        amount: float = Field(title="Amount")
 81        """Сумма транзакции."""
 82
 83        label: UUID = Field(title="Label")
 84        """Метка транзакции."""
 85
 86        transaction_id: str | None = Field(default=None, title="Transaction ID")
 87        """Идентификатор транзакции (по умолчанию None)."""
 88
 89        sha1_hash: str | None = Field(default=None, title="Hash")
 90        """SHA-1 хэш транзакции (по умолчанию None)."""
 91
 92        sender: str | None = Field(default=None, title="Sender")
 93        """Отправитель транзакции (по умолчанию None)."""
 94
 95        withdraw_amount: float | None = Field(default=None, title="Withdraw_amount")
 96        """Сумма вывода (по умолчанию None)."""
 97
 98        transaction_reference: str | None = Field(
 99            default=None, title="Transaction Reference"
100        )
101        """Ссылка на транзакцию (по умолчанию None)."""
102
103        site_date: str = Field(init=False, title="Transaction date", default="00:00")
104        """Строковое представление даты транзакции (не инициализируется при создании)."""
105
106        @field_validator("amount", "withdraw_amount")
107        def round_amount(cls, v):
108            """Сумма транзакции (округленная)."""
109            return round(v, 2)
110
111        @model_validator(mode="before")
112        def convert_str_to_none(cls, values):
113            """Преобразует строки 'None' в None.
114
115            Args:
116                cls: Класс схемы.
117                values: Значения для валидации.
118
119            Returns:
120                dict: Обновленные значения.
121            """
122            if isinstance(values, Iterable):
123                return {k: None if v == "None" else v for k, v in dict(values).items()}
124            return values
125
126        @model_validator(mode="after")
127        def set_site_date(cls, values: BaseModel):
128            """Устанавливает строковое представление даты транзакции.
129
130            Args:
131                cls: Класс схемы.
132                values (BaseModel): Значения для валидации.
133
134            Returns:
135                BaseModel: Обновленные значения.
136            """
137            if hasattr(values, "date"):
138                values.site_date = values.date.astimezone().ctime()
139            return values
140
141        model_config = ConfigDict(extra="ignore")
142
143    # INTERFACE (fastui)
144    site_display = [
145        DisplayLookup(field="id"),
146        DisplayLookup(
147            field="user_id",
148            mode=DisplayMode.plain,
149            on_click=GoToEvent(url="/bot/tables/userdata/?telegram_id={user_id}"),
150        ),
151        DisplayLookup(field="site_date"),
152        DisplayLookup(field="amount"),
153        DisplayLookup(
154            field="label",
155            on_click=GoToEvent(url="/bot/tables/transactions/?label={label}"),
156        ),
157    ]
158    """list[DisplayLookup]: Отображение транзакций на сайте."""
159
160    site_display_all = site_display + [
161        DisplayLookup(field="sender"),
162        DisplayLookup(field="transaction_id", mode=DisplayMode.plain),
163        DisplayLookup(field="sha1_hash", mode=DisplayMode.inline_code),
164        DisplayLookup(field="withdraw_amount"),
165    ]
166    """list[DisplayLookup]: Полное отображение транзакций на сайте."""
167
168    def __init__(self, **kwargs):
169        """Инициализирует модель транзакций.
170
171        Args:
172            **kwargs: Дополнительные параметры для инициализации модели.
173        """
174        if kwargs:
175            validated_data = self.ValidationSchema(**kwargs).model_dump(
176                exclude={"site_date"}
177            )
178            super().__init__(**(validated_data))
179        else:
180            super().__init__(**(kwargs))

 65    class ValidationSchema(BaseModel):
 66        """Схема валидации для модели транзакций.
 67
 68        Эта схема используется для валидации данных, связанных с транзакциями.
 69        """
 70
 71        id: int | None = Field(default=None, title="ID")
 72        """Уникальный идентификатор транзакции."""
 73
 74        user_id: int | None = Field(default=None, title="Telegram ID")
 75        """Идентификатор пользователя в Telegram (по умолчанию None)."""
 76
 77        date: datetime = Field(title="Transaction date")
 78        """Дата и время транзакции."""
 79
 80        amount: float = Field(title="Amount")
 81        """Сумма транзакции."""
 82
 83        label: UUID = Field(title="Label")
 84        """Метка транзакции."""
 85
 86        transaction_id: str | None = Field(default=None, title="Transaction ID")
 87        """Идентификатор транзакции (по умолчанию None)."""
 88
 89        sha1_hash: str | None = Field(default=None, title="Hash")
 90        """SHA-1 хэш транзакции (по умолчанию None)."""
 91
 92        sender: str | None = Field(default=None, title="Sender")
 93        """Отправитель транзакции (по умолчанию None)."""
 94
 95        withdraw_amount: float | None = Field(default=None, title="Withdraw_amount")
 96        """Сумма вывода (по умолчанию None)."""
 97
 98        transaction_reference: str | None = Field(
 99            default=None, title="Transaction Reference"
100        )
101        """Ссылка на транзакцию (по умолчанию None)."""
102
103        site_date: str = Field(init=False, title="Transaction date", default="00:00")
104        """Строковое представление даты транзакции (не инициализируется при создании)."""
105
106        @field_validator("amount", "withdraw_amount")
107        def round_amount(cls, v):
108            """Сумма транзакции (округленная)."""
109            return round(v, 2)
110
111        @model_validator(mode="before")
112        def convert_str_to_none(cls, values):
113            """Преобразует строки 'None' в None.
114
115            Args:
116                cls: Класс схемы.
117                values: Значения для валидации.
118
119            Returns:
120                dict: Обновленные значения.
121            """
122            if isinstance(values, Iterable):
123                return {k: None if v == "None" else v for k, v in dict(values).items()}
124            return values
125
126        @model_validator(mode="after")
127        def set_site_date(cls, values: BaseModel):
128            """Устанавливает строковое представление даты транзакции.
129
130            Args:
131                cls: Класс схемы.
132                values (BaseModel): Значения для валидации.
133
134            Returns:
135                BaseModel: Обновленные значения.
136            """
137            if hasattr(values, "date"):
138                values.site_date = values.date.astimezone().ctime()
139            return values
140
141        model_config = ConfigDict(extra="ignore")