145 lines
4.6 KiB
Python
145 lines
4.6 KiB
Python
from django.db import models
|
||
from accounts.models import CustomUser
|
||
|
||
|
||
class PaymentMethod(models.Model):
|
||
"""
|
||
Способ оплаты заказа.
|
||
Справочник для управления доступными методами оплаты.
|
||
"""
|
||
|
||
# Код для программного доступа
|
||
code = models.SlugField(
|
||
unique=True,
|
||
max_length=50,
|
||
verbose_name="Код способа оплаты",
|
||
help_text="Уникальный идентификатор (например: 'cash_to_courier', 'card_to_courier')"
|
||
)
|
||
|
||
# Отображаемое название
|
||
name = models.CharField(
|
||
max_length=100,
|
||
verbose_name="Название способа оплаты"
|
||
)
|
||
|
||
# Описание
|
||
description = models.TextField(
|
||
blank=True,
|
||
verbose_name="Описание",
|
||
help_text="Дополнительная информация о способе оплаты"
|
||
)
|
||
|
||
# Активность
|
||
is_active = models.BooleanField(
|
||
default=True,
|
||
verbose_name="Активен",
|
||
help_text="Отключенные способы оплаты не отображаются при создании заказа"
|
||
)
|
||
|
||
# Порядок отображения
|
||
order = models.PositiveIntegerField(
|
||
default=0,
|
||
verbose_name="Порядок отображения"
|
||
)
|
||
|
||
# Системный флаг
|
||
is_system = models.BooleanField(
|
||
default=False,
|
||
verbose_name="Системный",
|
||
help_text="Системные способы оплаты нельзя удалить через интерфейс"
|
||
)
|
||
|
||
# Аудит
|
||
created_at = models.DateTimeField(auto_now_add=True)
|
||
updated_at = models.DateTimeField(auto_now=True)
|
||
|
||
created_by = models.ForeignKey(
|
||
CustomUser,
|
||
on_delete=models.SET_NULL,
|
||
null=True,
|
||
blank=True,
|
||
related_name='created_payment_methods',
|
||
verbose_name="Создано"
|
||
)
|
||
|
||
class Meta:
|
||
verbose_name = "Способ оплаты"
|
||
verbose_name_plural = "Способы оплаты"
|
||
ordering = ['order', 'name']
|
||
indexes = [
|
||
models.Index(fields=['code']),
|
||
models.Index(fields=['is_active']),
|
||
models.Index(fields=['order']),
|
||
]
|
||
|
||
def __str__(self):
|
||
return self.name
|
||
|
||
|
||
class Payment(models.Model):
|
||
"""
|
||
Платеж по заказу.
|
||
Хранит историю всех платежей, включая частичные оплаты.
|
||
Поддерживает смешанную оплату (несколько платежей разными способами на один заказ).
|
||
"""
|
||
order = models.ForeignKey(
|
||
'Order',
|
||
on_delete=models.CASCADE,
|
||
related_name='payments',
|
||
verbose_name="Заказ"
|
||
)
|
||
|
||
amount = models.DecimalField(
|
||
max_digits=10,
|
||
decimal_places=2,
|
||
verbose_name="Сумма платежа"
|
||
)
|
||
|
||
payment_method = models.ForeignKey(
|
||
'PaymentMethod',
|
||
on_delete=models.PROTECT,
|
||
related_name='payments',
|
||
verbose_name="Способ оплаты",
|
||
help_text="Способ оплаты данного платежа"
|
||
)
|
||
|
||
payment_date = models.DateTimeField(
|
||
auto_now_add=True,
|
||
verbose_name="Дата и время платежа"
|
||
)
|
||
|
||
created_by = models.ForeignKey(
|
||
CustomUser,
|
||
on_delete=models.SET_NULL,
|
||
null=True,
|
||
blank=True,
|
||
related_name='payments_created',
|
||
verbose_name="Принял платеж"
|
||
)
|
||
|
||
notes = models.TextField(
|
||
blank=True,
|
||
null=True,
|
||
verbose_name="Примечания",
|
||
help_text="Дополнительная информация о платеже"
|
||
)
|
||
|
||
class Meta:
|
||
verbose_name = "Платеж"
|
||
verbose_name_plural = "Платежи"
|
||
ordering = ['-payment_date']
|
||
indexes = [
|
||
models.Index(fields=['order']),
|
||
models.Index(fields=['payment_date']),
|
||
]
|
||
|
||
def __str__(self):
|
||
return f"Платеж {self.amount} руб. по заказу #{self.order.order_number}"
|
||
|
||
def save(self, *args, **kwargs):
|
||
"""При сохранении платежа обновляем сумму оплаты в заказе"""
|
||
super().save(*args, **kwargs)
|
||
# Пересчитываем общую сумму оплаты в заказе
|
||
self.order.amount_paid = sum(p.amount for p in self.order.payments.all())
|
||
self.order.update_payment_status()
|