fix: Улучшения системы ценообразования комплектов
Исправлены 4 проблемы: 1. Расчёт цены первого товара - улучшена валидация в getProductPrice и calculateFinalPrice 2. Отображение actual_price в Select2 вместо обычной цены 3. Количество по умолчанию = 1 для новых форм компонентов 4. Auto-select текста при клике на поле количества для удобства редактирования Изменённые файлы: - products/forms.py: добавлен __init__ в KitItemForm для quantity.initial = 1 - products/templates/includes/select2-product-init.html: обновлена formatSelectResult - products/templates/productkit_create.html: добавлен focus handler для auto-select - products/templates/productkit_edit.html: добавлен focus handler для auto-select 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
72
myproject/products/models/__init__.py
Normal file
72
myproject/products/models/__init__.py
Normal file
@@ -0,0 +1,72 @@
|
||||
"""
|
||||
Products models package.
|
||||
Импортирует все модели для обеспечения совместимости с Django.
|
||||
|
||||
Структура после рефакторинга:
|
||||
- base.py: SKUCounter, BaseProductEntity (абстрактный базовый класс)
|
||||
- managers.py: ActiveManager, SoftDeleteManager, SoftDeleteQuerySet
|
||||
- categories.py: ProductCategory, ProductTag
|
||||
- variants.py: ProductVariantGroup, ProductVariantGroupItem
|
||||
- products.py: Product
|
||||
- kits.py: ProductKit, KitItem, KitItemPriority
|
||||
- photos.py: BasePhoto (abstract), ProductPhoto, ProductKitPhoto, ProductCategoryPhoto
|
||||
|
||||
Бизнес-логика вынесена в:
|
||||
- services/: slug_service, product_service, kit_pricing, kit_availability
|
||||
- validators/: kit_validators
|
||||
"""
|
||||
|
||||
# Импортируем менеджеры (используются другими моделями)
|
||||
from .managers import ActiveManager, SoftDeleteManager, SoftDeleteQuerySet
|
||||
|
||||
# Базовые модели
|
||||
from .base import SKUCounter, BaseProductEntity
|
||||
|
||||
# Категории и теги
|
||||
from .categories import ProductCategory, ProductTag
|
||||
|
||||
# Группы вариантов
|
||||
from .variants import ProductVariantGroup, ProductVariantGroupItem
|
||||
|
||||
# Продукты
|
||||
from .products import Product
|
||||
|
||||
# Комплекты
|
||||
from .kits import ProductKit, KitItem, KitItemPriority
|
||||
|
||||
# Фотографии
|
||||
from .photos import BasePhoto, ProductPhoto, ProductKitPhoto, ProductCategoryPhoto
|
||||
|
||||
# Явно указываем, что экспортируется при импорте *
|
||||
__all__ = [
|
||||
# Managers
|
||||
'ActiveManager',
|
||||
'SoftDeleteManager',
|
||||
'SoftDeleteQuerySet',
|
||||
|
||||
# Base
|
||||
'SKUCounter',
|
||||
'BaseProductEntity',
|
||||
|
||||
# Categories
|
||||
'ProductCategory',
|
||||
'ProductTag',
|
||||
|
||||
# Variants
|
||||
'ProductVariantGroup',
|
||||
'ProductVariantGroupItem',
|
||||
|
||||
# Products
|
||||
'Product',
|
||||
|
||||
# Kits
|
||||
'ProductKit',
|
||||
'KitItem',
|
||||
'KitItemPriority',
|
||||
|
||||
# Photos
|
||||
'BasePhoto',
|
||||
'ProductPhoto',
|
||||
'ProductKitPhoto',
|
||||
'ProductCategoryPhoto',
|
||||
]
|
||||
178
myproject/products/models/base.py
Normal file
178
myproject/products/models/base.py
Normal file
@@ -0,0 +1,178 @@
|
||||
"""
|
||||
Базовые модели для products приложения.
|
||||
Содержит SKUCounter и BaseProductEntity (абстрактный базовый класс).
|
||||
"""
|
||||
from django.db import models, transaction
|
||||
from django.utils import timezone
|
||||
from django.contrib.auth import get_user_model
|
||||
|
||||
from .managers import ActiveManager, SoftDeleteManager, SoftDeleteQuerySet
|
||||
|
||||
# Получаем User модель один раз для использования в ForeignKey
|
||||
User = get_user_model()
|
||||
|
||||
|
||||
class SKUCounter(models.Model):
|
||||
"""
|
||||
Глобальные счетчики для генерации уникальных номеров артикулов.
|
||||
Используется для товаров (product), комплектов (kit) и категорий (category).
|
||||
"""
|
||||
COUNTER_TYPE_CHOICES = [
|
||||
('product', 'Product Counter'),
|
||||
('kit', 'Kit Counter'),
|
||||
('category', 'Category Counter'),
|
||||
]
|
||||
|
||||
counter_type = models.CharField(
|
||||
max_length=20,
|
||||
unique=True,
|
||||
choices=COUNTER_TYPE_CHOICES,
|
||||
verbose_name="Тип счетчика"
|
||||
)
|
||||
current_value = models.IntegerField(
|
||||
default=0,
|
||||
verbose_name="Текущее значение"
|
||||
)
|
||||
|
||||
class Meta:
|
||||
verbose_name = "Счетчик артикулов"
|
||||
verbose_name_plural = "Счетчики артикулов"
|
||||
|
||||
def __str__(self):
|
||||
return f"{self.get_counter_type_display()}: {self.current_value}"
|
||||
|
||||
@classmethod
|
||||
def get_next_value(cls, counter_type):
|
||||
"""
|
||||
Получить следующее значение счетчика (thread-safe).
|
||||
Использует select_for_update для предотвращения race conditions.
|
||||
"""
|
||||
with transaction.atomic():
|
||||
counter, created = cls.objects.select_for_update().get_or_create(
|
||||
counter_type=counter_type,
|
||||
defaults={'current_value': 0}
|
||||
)
|
||||
counter.current_value += 1
|
||||
counter.save()
|
||||
return counter.current_value
|
||||
|
||||
|
||||
class BaseProductEntity(models.Model):
|
||||
"""
|
||||
Абстрактный базовый класс для Product и ProductKit.
|
||||
Объединяет общие поля идентификации, описания, статуса и soft delete.
|
||||
|
||||
Используется как основа для:
|
||||
- Product (простой товар)
|
||||
- ProductKit (комплект товаров)
|
||||
"""
|
||||
# Идентификация
|
||||
name = models.CharField(
|
||||
max_length=200,
|
||||
verbose_name="Название"
|
||||
)
|
||||
sku = models.CharField(
|
||||
max_length=100,
|
||||
blank=True,
|
||||
null=True,
|
||||
verbose_name="Артикул",
|
||||
db_index=True
|
||||
)
|
||||
slug = models.SlugField(
|
||||
max_length=200,
|
||||
unique=True,
|
||||
blank=True,
|
||||
verbose_name="URL-идентификатор"
|
||||
)
|
||||
|
||||
# Описания
|
||||
description = models.TextField(
|
||||
blank=True,
|
||||
null=True,
|
||||
verbose_name="Описание"
|
||||
)
|
||||
short_description = models.TextField(
|
||||
blank=True,
|
||||
null=True,
|
||||
verbose_name="Краткое описание",
|
||||
help_text="Используется для карточек товаров, превью и площадок"
|
||||
)
|
||||
|
||||
# Статус
|
||||
is_active = models.BooleanField(
|
||||
default=True,
|
||||
verbose_name="Активен"
|
||||
)
|
||||
|
||||
# Временные метки
|
||||
created_at = models.DateTimeField(
|
||||
auto_now_add=True,
|
||||
verbose_name="Дата создания"
|
||||
)
|
||||
updated_at = models.DateTimeField(
|
||||
auto_now=True,
|
||||
verbose_name="Дата обновления"
|
||||
)
|
||||
|
||||
# Soft delete
|
||||
is_deleted = models.BooleanField(
|
||||
default=False,
|
||||
verbose_name="Удален",
|
||||
db_index=True
|
||||
)
|
||||
deleted_at = models.DateTimeField(
|
||||
null=True,
|
||||
blank=True,
|
||||
verbose_name="Время удаления"
|
||||
)
|
||||
deleted_by = models.ForeignKey(
|
||||
User,
|
||||
on_delete=models.SET_NULL,
|
||||
null=True,
|
||||
blank=True,
|
||||
related_name='deleted_%(class)s_set',
|
||||
verbose_name="Удален пользователем"
|
||||
)
|
||||
|
||||
# Managers
|
||||
objects = SoftDeleteManager.from_queryset(SoftDeleteQuerySet)()
|
||||
all_objects = models.Manager()
|
||||
active = ActiveManager()
|
||||
|
||||
class Meta:
|
||||
abstract = True
|
||||
indexes = [
|
||||
models.Index(fields=['is_active']),
|
||||
models.Index(fields=['is_deleted']),
|
||||
models.Index(fields=['is_deleted', 'created_at']),
|
||||
]
|
||||
|
||||
def __str__(self):
|
||||
return self.name
|
||||
|
||||
def delete(self, *args, **kwargs):
|
||||
"""Мягкое удаление (soft delete)"""
|
||||
user = kwargs.pop('user', None)
|
||||
self.is_deleted = True
|
||||
self.deleted_at = timezone.now()
|
||||
if user:
|
||||
self.deleted_by = user
|
||||
self.save(update_fields=['is_deleted', 'deleted_at', 'deleted_by'])
|
||||
return 1, {self.__class__._meta.label: 1}
|
||||
|
||||
def hard_delete(self):
|
||||
"""Физическое удаление из БД (необратимо!)"""
|
||||
super().delete()
|
||||
|
||||
def save(self, *args, **kwargs):
|
||||
"""Автогенерация slug из name если не задан"""
|
||||
if not self.slug or self.slug.strip() == '':
|
||||
# Используем централизованный сервис для генерации slug
|
||||
from ..services.slug_service import SlugService
|
||||
self.slug = SlugService.generate_unique_slug(
|
||||
self.name,
|
||||
self.__class__,
|
||||
self.pk
|
||||
)
|
||||
|
||||
super().save(*args, **kwargs)
|
||||
175
myproject/products/models/categories.py
Normal file
175
myproject/products/models/categories.py
Normal file
@@ -0,0 +1,175 @@
|
||||
"""
|
||||
Модели категорий и тегов для товаров и комплектов.
|
||||
"""
|
||||
from django.db import models
|
||||
from django.utils import timezone
|
||||
from django.core.exceptions import ValidationError
|
||||
from django.contrib.auth import get_user_model
|
||||
|
||||
from .managers import ActiveManager, SoftDeleteManager, SoftDeleteQuerySet
|
||||
from ..services.slug_service import SlugService
|
||||
|
||||
User = get_user_model()
|
||||
|
||||
|
||||
class ProductCategory(models.Model):
|
||||
"""
|
||||
Категории товаров и комплектов (поддержка нескольких уровней не обязательна, но возможна позже).
|
||||
"""
|
||||
name = models.CharField(max_length=200, verbose_name="Название")
|
||||
sku = models.CharField(max_length=100, blank=True, null=True, unique=True, verbose_name="Артикул", db_index=True)
|
||||
slug = models.SlugField(max_length=200, unique=True, blank=True, verbose_name="URL-идентификатор")
|
||||
parent = models.ForeignKey('self', on_delete=models.SET_NULL, null=True, blank=True,
|
||||
related_name='children', verbose_name="Родительская категория")
|
||||
is_active = models.BooleanField(default=True, verbose_name="Активна")
|
||||
created_at = models.DateTimeField(auto_now_add=True, verbose_name="Дата создания", null=True)
|
||||
updated_at = models.DateTimeField(auto_now=True, verbose_name="Дата обновления", null=True)
|
||||
|
||||
# Поля для мягкого удаления
|
||||
is_deleted = models.BooleanField(default=False, verbose_name="Удалена", db_index=True)
|
||||
deleted_at = models.DateTimeField(null=True, blank=True, verbose_name="Время удаления")
|
||||
deleted_by = models.ForeignKey(
|
||||
User,
|
||||
on_delete=models.SET_NULL,
|
||||
null=True,
|
||||
blank=True,
|
||||
related_name='deleted_categories',
|
||||
verbose_name="Удалена пользователем"
|
||||
)
|
||||
|
||||
objects = SoftDeleteManager.from_queryset(SoftDeleteQuerySet)() # Менеджер по умолчанию (исключает удаленные)
|
||||
all_objects = models.Manager() # Менеджер для доступа ко ВСЕМ объектам (включая удаленные)
|
||||
active = ActiveManager() # Кастомный менеджер для активных категорий
|
||||
|
||||
class Meta:
|
||||
verbose_name = "Категория товара"
|
||||
verbose_name_plural = "Категории товаров"
|
||||
indexes = [
|
||||
models.Index(fields=['is_active']),
|
||||
models.Index(fields=['is_deleted']),
|
||||
models.Index(fields=['is_deleted', 'created_at']),
|
||||
]
|
||||
|
||||
def __str__(self):
|
||||
return self.name
|
||||
|
||||
def clean(self):
|
||||
"""Валидация категории перед сохранением"""
|
||||
# 1. Защита от самоссылки
|
||||
if self.parent and self.parent.pk == self.pk:
|
||||
raise ValidationError({
|
||||
'parent': 'Категория не может быть родителем самой себя.'
|
||||
})
|
||||
|
||||
# 2. Защита от циклических ссылок (только для существующих категорий)
|
||||
if self.parent and self.pk:
|
||||
self._check_parent_chain()
|
||||
|
||||
# 3. Проверка активности родителя
|
||||
if self.parent and not self.parent.is_active:
|
||||
raise ValidationError({
|
||||
'parent': 'Нельзя выбрать неактивную категорию в качестве родителя.'
|
||||
})
|
||||
|
||||
def _check_parent_chain(self):
|
||||
"""Проверяет цепочку родителей на циклы и глубину вложенности"""
|
||||
from django.conf import settings
|
||||
|
||||
current = self.parent
|
||||
depth = 0
|
||||
max_depth = getattr(settings, 'MAX_CATEGORY_DEPTH', 10)
|
||||
|
||||
while current:
|
||||
if current.pk == self.pk:
|
||||
raise ValidationError({
|
||||
'parent': f'Обнаружена циклическая ссылка. '
|
||||
f'Категория "{self.name}" не может быть потомком самой себя.'
|
||||
})
|
||||
|
||||
depth += 1
|
||||
if depth > max_depth:
|
||||
raise ValidationError({
|
||||
'parent': f'Слишком глубокая вложенность категорий '
|
||||
f'(максимум {max_depth} уровней).'
|
||||
})
|
||||
|
||||
current = current.parent
|
||||
|
||||
def save(self, *args, **kwargs):
|
||||
# Вызываем валидацию перед сохранением
|
||||
self.full_clean()
|
||||
|
||||
# Автоматическая генерация slug из названия с транслитерацией
|
||||
if not self.slug or self.slug.strip() == '':
|
||||
self.slug = SlugService.generate_unique_slug(self.name, ProductCategory, self.pk)
|
||||
|
||||
# Автоматическая генерация артикула при создании новой категории
|
||||
if not self.sku and not self.pk:
|
||||
from ..utils.sku_generator import generate_category_sku
|
||||
self.sku = generate_category_sku()
|
||||
|
||||
super().save(*args, **kwargs)
|
||||
|
||||
def delete(self, *args, **kwargs):
|
||||
"""Soft delete вместо hard delete - марк как удаленный"""
|
||||
self.is_deleted = True
|
||||
self.deleted_at = timezone.now()
|
||||
self.save(update_fields=['is_deleted', 'deleted_at'])
|
||||
# Возвращаем результат в формате Django
|
||||
return 1, {self.__class__._meta.label: 1}
|
||||
|
||||
def hard_delete(self):
|
||||
"""Полное удаление из БД (необратимо!)"""
|
||||
super().delete()
|
||||
|
||||
|
||||
class ProductTag(models.Model):
|
||||
"""
|
||||
Свободные теги для фильтрации и поиска.
|
||||
"""
|
||||
name = models.CharField(max_length=100, unique=True, verbose_name="Название")
|
||||
slug = models.SlugField(max_length=100, unique=True, verbose_name="URL-идентификатор")
|
||||
created_at = models.DateTimeField(auto_now_add=True, verbose_name="Дата создания", null=True)
|
||||
updated_at = models.DateTimeField(auto_now=True, verbose_name="Дата обновления", null=True)
|
||||
|
||||
# Поля для мягкого удаления
|
||||
is_deleted = models.BooleanField(default=False, verbose_name="Удален", db_index=True)
|
||||
deleted_at = models.DateTimeField(null=True, blank=True, verbose_name="Время удаления")
|
||||
deleted_by = models.ForeignKey(
|
||||
User,
|
||||
on_delete=models.SET_NULL,
|
||||
null=True,
|
||||
blank=True,
|
||||
related_name='deleted_tags',
|
||||
verbose_name="Удален пользователем"
|
||||
)
|
||||
|
||||
objects = SoftDeleteManager.from_queryset(SoftDeleteQuerySet)() # Менеджер по умолчанию (исключает удаленные)
|
||||
all_objects = models.Manager() # Менеджер для доступа ко ВСЕМ объектам (включая удаленные)
|
||||
|
||||
class Meta:
|
||||
verbose_name = "Тег товара"
|
||||
verbose_name_plural = "Теги товаров"
|
||||
indexes = [
|
||||
models.Index(fields=['is_deleted']),
|
||||
models.Index(fields=['is_deleted', 'created_at']),
|
||||
]
|
||||
|
||||
def __str__(self):
|
||||
return self.name
|
||||
|
||||
def save(self, *args, **kwargs):
|
||||
if not self.slug:
|
||||
self.slug = SlugService.generate_unique_slug(self.name, ProductTag, self.pk)
|
||||
super().save(*args, **kwargs)
|
||||
|
||||
def delete(self, *args, **kwargs):
|
||||
"""Soft delete вместо hard delete - марк как удаленный"""
|
||||
self.is_deleted = True
|
||||
self.deleted_at = timezone.now()
|
||||
self.save(update_fields=['is_deleted', 'deleted_at'])
|
||||
return 1, {self.__class__._meta.label: 1}
|
||||
|
||||
def hard_delete(self):
|
||||
"""Полное удаление из БД (необратимо!)"""
|
||||
super().delete()
|
||||
330
myproject/products/models/kits.py
Normal file
330
myproject/products/models/kits.py
Normal file
@@ -0,0 +1,330 @@
|
||||
"""
|
||||
Модели для комплектов (ProductKit) и их компонентов.
|
||||
Цена комплекта динамически вычисляется из actual_price компонентов.
|
||||
"""
|
||||
from decimal import Decimal
|
||||
from django.db import models
|
||||
from django.utils import timezone
|
||||
from django.core.exceptions import ValidationError
|
||||
|
||||
from .base import BaseProductEntity
|
||||
from .categories import ProductCategory, ProductTag
|
||||
from .variants import ProductVariantGroup
|
||||
from .products import Product
|
||||
from ..utils.sku_generator import generate_kit_sku
|
||||
from ..services.kit_availability import KitAvailabilityChecker
|
||||
|
||||
|
||||
class ProductKit(BaseProductEntity):
|
||||
"""
|
||||
Шаблон комплекта / букета (рецепт).
|
||||
Наследует общие поля из BaseProductEntity.
|
||||
|
||||
Цена комплекта = сумма actual_price всех компонентов + корректировка.
|
||||
Корректировка может быть увеличением или уменьшением на % или фиксированную сумму.
|
||||
"""
|
||||
ADJUSTMENT_TYPE_CHOICES = [
|
||||
('none', 'Без изменения'),
|
||||
('increase_percent', 'Увеличить на %'),
|
||||
('increase_amount', 'Увеличить на сумму'),
|
||||
('decrease_percent', 'Уменьшить на %'),
|
||||
('decrease_amount', 'Уменьшить на сумму'),
|
||||
]
|
||||
|
||||
# Categories and Tags
|
||||
categories = models.ManyToManyField(
|
||||
ProductCategory,
|
||||
blank=True,
|
||||
related_name='kits',
|
||||
verbose_name="Категории"
|
||||
)
|
||||
tags = models.ManyToManyField(
|
||||
ProductTag,
|
||||
blank=True,
|
||||
related_name='kits',
|
||||
verbose_name="Теги"
|
||||
)
|
||||
|
||||
# ЦЕНООБРАЗОВАНИЕ - новый подход
|
||||
base_price = models.DecimalField(
|
||||
max_digits=10,
|
||||
decimal_places=2,
|
||||
default=0,
|
||||
verbose_name="Базовая цена",
|
||||
help_text="Сумма actual_price всех компонентов. Пересчитывается автоматически."
|
||||
)
|
||||
|
||||
price = models.DecimalField(
|
||||
max_digits=10,
|
||||
decimal_places=2,
|
||||
default=0,
|
||||
verbose_name="Итоговая цена",
|
||||
help_text="Базовая цена с учетом корректировок. Вычисляется автоматически."
|
||||
)
|
||||
|
||||
sale_price = models.DecimalField(
|
||||
max_digits=10,
|
||||
decimal_places=2,
|
||||
null=True,
|
||||
blank=True,
|
||||
verbose_name="Цена со скидкой",
|
||||
help_text="Если задана, комплект продается по этой цене"
|
||||
)
|
||||
|
||||
price_adjustment_type = models.CharField(
|
||||
max_length=20,
|
||||
choices=ADJUSTMENT_TYPE_CHOICES,
|
||||
default='none',
|
||||
verbose_name="Тип корректировки цены"
|
||||
)
|
||||
|
||||
price_adjustment_value = models.DecimalField(
|
||||
max_digits=10,
|
||||
decimal_places=2,
|
||||
default=0,
|
||||
verbose_name="Значение корректировки",
|
||||
help_text="Процент (%) или сумма (руб) в зависимости от типа корректировки"
|
||||
)
|
||||
|
||||
class Meta:
|
||||
verbose_name = "Комплект"
|
||||
verbose_name_plural = "Комплекты"
|
||||
|
||||
@property
|
||||
def actual_price(self):
|
||||
"""
|
||||
Финальная цена для продажи.
|
||||
Приоритет: sale_price > price (рассчитанная)
|
||||
"""
|
||||
if self.sale_price:
|
||||
return self.sale_price
|
||||
return self.price
|
||||
|
||||
def recalculate_base_price(self):
|
||||
"""
|
||||
Пересчитать сумму actual_price всех компонентов.
|
||||
Вызывается автоматически при изменении цены товара (через signal).
|
||||
"""
|
||||
if not self.pk:
|
||||
return # Новый объект еще не сохранен
|
||||
|
||||
total = Decimal('0')
|
||||
for item in self.kit_items.all():
|
||||
if item.product:
|
||||
actual_price = item.product.actual_price or Decimal('0')
|
||||
qty = item.quantity or Decimal('1')
|
||||
total += actual_price * qty
|
||||
|
||||
self.base_price = total
|
||||
# Обновляем финальную цену
|
||||
self.price = self.calculate_final_price()
|
||||
self.save(update_fields=['base_price', 'price'])
|
||||
|
||||
def calculate_final_price(self):
|
||||
"""
|
||||
Вычислить финальную цену с учетом корректировок.
|
||||
|
||||
Returns:
|
||||
Decimal: Итоговая цена комплекта
|
||||
"""
|
||||
if self.price_adjustment_type == 'none':
|
||||
return self.base_price
|
||||
|
||||
adjustment_value = self.price_adjustment_value or Decimal('0')
|
||||
|
||||
if 'percent' in self.price_adjustment_type:
|
||||
adjustment = self.base_price * adjustment_value / Decimal('100')
|
||||
else: # 'amount'
|
||||
adjustment = adjustment_value
|
||||
|
||||
if 'increase' in self.price_adjustment_type:
|
||||
return self.base_price + adjustment
|
||||
else: # 'decrease'
|
||||
return max(Decimal('0'), self.base_price - adjustment)
|
||||
|
||||
def save(self, *args, **kwargs):
|
||||
"""При сохранении - пересчитываем финальную цену"""
|
||||
# Генерация артикула для новых комплектов
|
||||
if not self.sku:
|
||||
self.sku = generate_kit_sku()
|
||||
|
||||
# Если объект уже существует и имеет компоненты, пересчитываем base_price
|
||||
if self.pk and self.kit_items.exists():
|
||||
# Пересчитаем базовую цену из компонентов
|
||||
total = Decimal('0')
|
||||
for item in self.kit_items.all():
|
||||
if item.product:
|
||||
actual_price = item.product.actual_price or Decimal('0')
|
||||
qty = item.quantity or Decimal('1')
|
||||
total += actual_price * qty
|
||||
self.base_price = total
|
||||
|
||||
# Устанавливаем финальную цену в поле price
|
||||
self.price = self.calculate_final_price()
|
||||
|
||||
# Вызов родительского save (генерация slug и т.д.)
|
||||
super().save(*args, **kwargs)
|
||||
|
||||
def get_total_components_count(self):
|
||||
"""Возвращает количество компонентов (строк) в комплекте"""
|
||||
return self.kit_items.count()
|
||||
|
||||
def get_components_with_variants_count(self):
|
||||
"""Возвращает количество компонентов, которые используют группы вариантов"""
|
||||
return self.kit_items.filter(variant_group__isnull=False).count()
|
||||
|
||||
def check_availability(self, stock_manager=None):
|
||||
"""
|
||||
Проверяет доступность всего комплекта.
|
||||
Делегирует проверку в сервис.
|
||||
"""
|
||||
return KitAvailabilityChecker.check_availability(self, stock_manager)
|
||||
|
||||
def delete(self, *args, **kwargs):
|
||||
"""Soft delete вместо hard delete - марк как удаленный"""
|
||||
self.is_deleted = True
|
||||
self.deleted_at = timezone.now()
|
||||
self.save(update_fields=['is_deleted', 'deleted_at'])
|
||||
return 1, {self.__class__._meta.label: 1}
|
||||
|
||||
def hard_delete(self):
|
||||
"""Полное удаление из БД (необратимо!)"""
|
||||
super().delete()
|
||||
|
||||
|
||||
class KitItem(models.Model):
|
||||
"""
|
||||
Состав комплекта: связь между ProductKit и Product или ProductVariantGroup.
|
||||
Позиция может быть либо конкретным товаром, либо группой вариантов.
|
||||
"""
|
||||
kit = models.ForeignKey(ProductKit, on_delete=models.CASCADE, related_name='kit_items',
|
||||
verbose_name="Комплект")
|
||||
product = models.ForeignKey(
|
||||
Product,
|
||||
on_delete=models.CASCADE,
|
||||
null=True,
|
||||
blank=True,
|
||||
related_name='kit_items_direct',
|
||||
verbose_name="Конкретный товар"
|
||||
)
|
||||
variant_group = models.ForeignKey(
|
||||
ProductVariantGroup,
|
||||
on_delete=models.CASCADE,
|
||||
null=True,
|
||||
blank=True,
|
||||
related_name='kit_items',
|
||||
verbose_name="Группа вариантов"
|
||||
)
|
||||
quantity = models.DecimalField(max_digits=10, decimal_places=3, null=True, blank=True, verbose_name="Количество")
|
||||
notes = models.CharField(
|
||||
max_length=200,
|
||||
blank=True,
|
||||
verbose_name="Примечание"
|
||||
)
|
||||
|
||||
class Meta:
|
||||
verbose_name = "Компонент комплекта"
|
||||
verbose_name_plural = "Компоненты комплектов"
|
||||
indexes = [
|
||||
models.Index(fields=['kit']),
|
||||
models.Index(fields=['product']),
|
||||
models.Index(fields=['variant_group']),
|
||||
models.Index(fields=['kit', 'product']),
|
||||
models.Index(fields=['kit', 'variant_group']),
|
||||
]
|
||||
|
||||
def __str__(self):
|
||||
return f"{self.kit.name} - {self.get_display_name()}"
|
||||
|
||||
def clean(self):
|
||||
"""Валидация: должен быть указан либо product, либо variant_group (но не оба)"""
|
||||
if self.product and self.variant_group:
|
||||
raise ValidationError(
|
||||
"Нельзя указывать одновременно товар и группу вариантов. Выберите что-то одно."
|
||||
)
|
||||
if not self.product and not self.variant_group:
|
||||
raise ValidationError(
|
||||
"Необходимо указать либо товар, либо группу вариантов."
|
||||
)
|
||||
|
||||
def get_display_name(self):
|
||||
"""Возвращает строку для отображения названия компонента"""
|
||||
if self.variant_group:
|
||||
return f"[Варианты] {self.variant_group.name}"
|
||||
return self.product.name if self.product else "Не указан"
|
||||
|
||||
def has_priorities_set(self):
|
||||
"""Проверяет, настроены ли приоритеты замены для данного компонента"""
|
||||
return self.priorities.exists()
|
||||
|
||||
def get_available_products(self):
|
||||
"""
|
||||
Возвращает список доступных товаров для этого компонента.
|
||||
|
||||
Если указан конкретный товар - возвращает его.
|
||||
Если указаны приоритеты - возвращает товары в порядке приоритета.
|
||||
Если не указаны приоритеты - возвращает все активные товары из группы вариантов.
|
||||
"""
|
||||
if self.product:
|
||||
# Если указан конкретный товар, возвращаем только его
|
||||
return [self.product]
|
||||
|
||||
if self.variant_group:
|
||||
# Если есть настроенные приоритеты, используем их
|
||||
if self.has_priorities_set():
|
||||
return [
|
||||
priority.product
|
||||
for priority in self.priorities.select_related('product').order_by('priority', 'id')
|
||||
]
|
||||
# Иначе возвращаем все товары из группы
|
||||
return list(self.variant_group.products.filter(is_active=True))
|
||||
|
||||
return []
|
||||
|
||||
def get_best_available_product(self, stock_manager=None):
|
||||
"""
|
||||
Возвращает первый доступный товар по приоритету, соответствующий требованиям по количеству.
|
||||
"""
|
||||
from ..utils.stock_manager import StockManager
|
||||
|
||||
if stock_manager is None:
|
||||
stock_manager = StockManager()
|
||||
|
||||
available_products = self.get_available_products()
|
||||
|
||||
for product in available_products:
|
||||
if stock_manager.check_stock(product, self.quantity):
|
||||
return product
|
||||
|
||||
return None
|
||||
|
||||
|
||||
class KitItemPriority(models.Model):
|
||||
"""
|
||||
Приоритеты товаров для конкретной позиции букета.
|
||||
Позволяет настроить индивидуальные приоритеты замен для каждого букета.
|
||||
"""
|
||||
kit_item = models.ForeignKey(
|
||||
KitItem,
|
||||
on_delete=models.CASCADE,
|
||||
related_name='priorities',
|
||||
verbose_name="Позиция в букете"
|
||||
)
|
||||
product = models.ForeignKey(
|
||||
Product,
|
||||
on_delete=models.CASCADE,
|
||||
verbose_name="Товар"
|
||||
)
|
||||
priority = models.PositiveIntegerField(
|
||||
default=0,
|
||||
help_text="Меньше = выше приоритет (0 - наивысший)"
|
||||
)
|
||||
|
||||
class Meta:
|
||||
verbose_name = "Приоритет варианта"
|
||||
verbose_name_plural = "Приоритеты вариантов"
|
||||
ordering = ['priority', 'id']
|
||||
unique_together = ['kit_item', 'product']
|
||||
|
||||
def __str__(self):
|
||||
return f"{self.product.name} (приоритет {self.priority})"
|
||||
66
myproject/products/models/managers.py
Normal file
66
myproject/products/models/managers.py
Normal file
@@ -0,0 +1,66 @@
|
||||
"""
|
||||
Менеджеры и QuerySets для моделей продуктов.
|
||||
Реализуют паттерн Soft Delete и фильтрацию активных записей.
|
||||
"""
|
||||
from django.db import models
|
||||
from django.utils import timezone
|
||||
|
||||
|
||||
class ActiveManager(models.Manager):
|
||||
"""Менеджер для фильтрации только активных записей"""
|
||||
def get_queryset(self):
|
||||
return super().get_queryset().filter(is_active=True)
|
||||
|
||||
|
||||
class SoftDeleteQuerySet(models.QuerySet):
|
||||
"""
|
||||
QuerySet для мягкого удаления (soft delete).
|
||||
Позволяет фильтровать удаленные элементы и восстанавливать их.
|
||||
"""
|
||||
def delete(self):
|
||||
"""Soft delete вместо hard delete"""
|
||||
return self.update(
|
||||
is_deleted=True,
|
||||
deleted_at=timezone.now()
|
||||
)
|
||||
|
||||
def hard_delete(self):
|
||||
"""Явный hard delete - удаляет из БД окончательно"""
|
||||
return super().delete()
|
||||
|
||||
def restore(self):
|
||||
"""Восстановление из удаленного состояния"""
|
||||
return self.update(
|
||||
is_deleted=False,
|
||||
deleted_at=None,
|
||||
deleted_by=None
|
||||
)
|
||||
|
||||
def deleted_only(self):
|
||||
"""Получить только удаленные элементы"""
|
||||
return self.filter(is_deleted=True)
|
||||
|
||||
def not_deleted(self):
|
||||
"""Получить только не удаленные элементы"""
|
||||
return self.filter(is_deleted=False)
|
||||
|
||||
def with_deleted(self):
|
||||
"""Получить все элементы включая удаленные"""
|
||||
return self.all()
|
||||
|
||||
|
||||
class SoftDeleteManager(models.Manager):
|
||||
"""
|
||||
Manager для работы с мягким удалением.
|
||||
По умолчанию исключает удаленные элементы из запросов.
|
||||
"""
|
||||
def get_queryset(self):
|
||||
return SoftDeleteQuerySet(self.model, using=self._db).filter(is_deleted=False)
|
||||
|
||||
def deleted_only(self):
|
||||
"""Получить только удаленные элементы"""
|
||||
return SoftDeleteQuerySet(self.model, using=self._db).filter(is_deleted=True)
|
||||
|
||||
def all_with_deleted(self):
|
||||
"""Получить все элементы включая удаленные"""
|
||||
return SoftDeleteQuerySet(self.model, using=self._db).all()
|
||||
149
myproject/products/models/products.py
Normal file
149
myproject/products/models/products.py
Normal file
@@ -0,0 +1,149 @@
|
||||
"""
|
||||
Модель Product - базовый товар (цветок, упаковка, аксессуар).
|
||||
"""
|
||||
from django.db import models
|
||||
|
||||
from .base import BaseProductEntity
|
||||
from .categories import ProductCategory, ProductTag
|
||||
from .variants import ProductVariantGroup
|
||||
from ..services.product_service import ProductSaveService
|
||||
|
||||
|
||||
class Product(BaseProductEntity):
|
||||
"""
|
||||
Базовый товар (цветок, упаковка, аксессуар).
|
||||
Наследует общие поля из BaseProductEntity.
|
||||
"""
|
||||
UNIT_CHOICES = [
|
||||
('шт', 'Штука'),
|
||||
('м', 'Метр'),
|
||||
('г', 'Грамм'),
|
||||
('л', 'Литр'),
|
||||
('кг', 'Килограмм'),
|
||||
]
|
||||
|
||||
# Специфичные поля Product
|
||||
variant_suffix = models.CharField(
|
||||
max_length=20,
|
||||
blank=True,
|
||||
null=True,
|
||||
verbose_name="Суффикс варианта",
|
||||
help_text="Суффикс для артикула (например: 50, 60, S, M). Автоматически извлекается из названия."
|
||||
)
|
||||
|
||||
# Categories and Tags - остаются в Product с related_name='products'
|
||||
categories = models.ManyToManyField(
|
||||
ProductCategory,
|
||||
blank=True,
|
||||
related_name='products',
|
||||
verbose_name="Категории"
|
||||
)
|
||||
tags = models.ManyToManyField(
|
||||
ProductTag,
|
||||
blank=True,
|
||||
related_name='products',
|
||||
verbose_name="Теги"
|
||||
)
|
||||
variant_groups = models.ManyToManyField(
|
||||
ProductVariantGroup,
|
||||
blank=True,
|
||||
related_name='products',
|
||||
verbose_name="Группы вариантов"
|
||||
)
|
||||
|
||||
unit = models.CharField(
|
||||
max_length=10,
|
||||
choices=UNIT_CHOICES,
|
||||
default='шт',
|
||||
verbose_name="Единица измерения"
|
||||
)
|
||||
|
||||
# ЦЕНООБРАЗОВАНИЕ - переименованные поля
|
||||
cost_price = models.DecimalField(
|
||||
max_digits=10,
|
||||
decimal_places=2,
|
||||
verbose_name="Себестоимость",
|
||||
help_text="Автоматически вычисляется из партий (средневзвешенная стоимость по FIFO)"
|
||||
)
|
||||
price = models.DecimalField(
|
||||
max_digits=10,
|
||||
decimal_places=2,
|
||||
verbose_name="Основная цена",
|
||||
help_text="Цена продажи товара (бывшее поле sale_price)"
|
||||
)
|
||||
sale_price = models.DecimalField(
|
||||
max_digits=10,
|
||||
decimal_places=2,
|
||||
blank=True,
|
||||
null=True,
|
||||
verbose_name="Цена со скидкой",
|
||||
help_text="Если задана, товар продается по этой цене (дешевле основной)"
|
||||
)
|
||||
|
||||
in_stock = models.BooleanField(
|
||||
default=False,
|
||||
verbose_name="В наличии",
|
||||
db_index=True,
|
||||
help_text="Автоматически обновляется при изменении остатков на складе"
|
||||
)
|
||||
|
||||
# Поле для улучшенного поиска
|
||||
search_keywords = models.TextField(
|
||||
blank=True,
|
||||
verbose_name="Ключевые слова для поиска",
|
||||
help_text="Автоматически генерируется из названия, артикула, описания и категории. Можно дополнить вручную."
|
||||
)
|
||||
|
||||
class Meta:
|
||||
verbose_name = "Товар"
|
||||
verbose_name_plural = "Товары"
|
||||
indexes = [
|
||||
models.Index(fields=['in_stock']),
|
||||
models.Index(fields=['sku']),
|
||||
]
|
||||
|
||||
@property
|
||||
def actual_price(self):
|
||||
"""
|
||||
Финальная цена для продажи.
|
||||
Если есть sale_price (скидка) - возвращает его, иначе - основную цену.
|
||||
"""
|
||||
return self.sale_price if self.sale_price else self.price
|
||||
|
||||
@property
|
||||
def cost_price_details(self):
|
||||
"""
|
||||
Детали расчета себестоимости для отображения в UI.
|
||||
Показывает разбивку по партиям и сравнение кешированной/рассчитанной стоимости.
|
||||
|
||||
Returns:
|
||||
dict: {
|
||||
'cached_cost': Decimal, # Кешированная себестоимость (из БД)
|
||||
'calculated_cost': Decimal, # Рассчитанная себестоимость (из партий)
|
||||
'is_synced': bool, # Совпадают ли значения
|
||||
'total_quantity': Decimal, # Общее количество в партиях
|
||||
'batches': [...] # Список партий с деталями
|
||||
}
|
||||
"""
|
||||
from ..services.cost_calculator import ProductCostCalculator
|
||||
return ProductCostCalculator.get_cost_details(self)
|
||||
|
||||
def save(self, *args, **kwargs):
|
||||
# Используем сервис для подготовки к сохранению
|
||||
ProductSaveService.prepare_product_for_save(self)
|
||||
|
||||
# Вызов родительского save (генерация slug и т.д.)
|
||||
super().save(*args, **kwargs)
|
||||
|
||||
# Обновление поисковых слов с категориями (после сохранения)
|
||||
ProductSaveService.update_search_keywords_with_categories(self)
|
||||
|
||||
def get_variant_groups(self):
|
||||
"""Возвращает все группы вариантов товара"""
|
||||
return self.variant_groups.all()
|
||||
|
||||
def get_similar_products(self):
|
||||
"""Возвращает все товары из тех же групп вариантов (исключая себя)"""
|
||||
return Product.objects.filter(
|
||||
variant_groups__in=self.variant_groups.all()
|
||||
).exclude(id=self.id).distinct()
|
||||
102
myproject/products/models/variants.py
Normal file
102
myproject/products/models/variants.py
Normal file
@@ -0,0 +1,102 @@
|
||||
"""
|
||||
Модели для работы с группами вариантов товаров.
|
||||
Позволяет группировать взаимозаменяемые товары (например, розы разной длины).
|
||||
"""
|
||||
from django.db import models
|
||||
|
||||
|
||||
class ProductVariantGroup(models.Model):
|
||||
"""
|
||||
Группа вариантов товара (взаимозаменяемые товары).
|
||||
Например: "Роза красная Freedom" включает розы 50см, 60см, 70см.
|
||||
"""
|
||||
name = models.CharField(max_length=200, verbose_name="Название")
|
||||
description = models.TextField(blank=True, verbose_name="Описание")
|
||||
created_at = models.DateTimeField(auto_now_add=True, verbose_name="Дата создания")
|
||||
updated_at = models.DateTimeField(auto_now=True, verbose_name="Дата обновления")
|
||||
|
||||
class Meta:
|
||||
verbose_name = "Группа вариантов"
|
||||
verbose_name_plural = "Группы вариантов"
|
||||
ordering = ['name']
|
||||
|
||||
def __str__(self):
|
||||
return self.name
|
||||
|
||||
def get_products_count(self):
|
||||
"""Возвращает количество товаров в группе"""
|
||||
return self.items.count()
|
||||
|
||||
@property
|
||||
def in_stock(self):
|
||||
"""
|
||||
Вариант в наличии, если хотя бы один из его товаров в наличии.
|
||||
Товар в наличии, если Product.in_stock = True.
|
||||
"""
|
||||
return self.items.filter(product__in_stock=True).exists()
|
||||
|
||||
@property
|
||||
def price(self):
|
||||
"""
|
||||
Цена варианта определяется по приоритету товаров:
|
||||
1. Берётся цена товара с приоритетом 1, если он в наличии
|
||||
2. Если нет - цена товара с приоритетом 2
|
||||
3. И так далее по приоритетам
|
||||
4. Если ни один товар не в наличии - берётся самый дорогой товар из группы
|
||||
|
||||
Возвращает Decimal (цену) или None если группа пуста.
|
||||
"""
|
||||
items = self.items.all().order_by('priority', 'id')
|
||||
|
||||
if not items.exists():
|
||||
return None
|
||||
|
||||
# Ищем первый товар в наличии
|
||||
for item in items:
|
||||
if item.product.in_stock:
|
||||
return item.product.sale_price
|
||||
|
||||
# Если ни один товар не в наличии - берем самый дорогой
|
||||
max_price = None
|
||||
for item in items:
|
||||
if max_price is None or item.product.sale_price > max_price:
|
||||
max_price = item.product.sale_price
|
||||
|
||||
return max_price
|
||||
|
||||
|
||||
class ProductVariantGroupItem(models.Model):
|
||||
"""
|
||||
Товар в группе вариантов с приоритетом для этой конкретной группы.
|
||||
Приоритет определяет порядок выбора товара при использовании группы в комплектах.
|
||||
Например: в группе "Роза красная Freedom" - роза 50см имеет приоритет 1, 60см = 2, 70см = 3.
|
||||
"""
|
||||
variant_group = models.ForeignKey(
|
||||
ProductVariantGroup,
|
||||
on_delete=models.CASCADE,
|
||||
related_name='items',
|
||||
verbose_name="Группа вариантов"
|
||||
)
|
||||
product = models.ForeignKey(
|
||||
'Product',
|
||||
on_delete=models.CASCADE,
|
||||
related_name='variant_group_items',
|
||||
verbose_name="Товар"
|
||||
)
|
||||
priority = models.PositiveIntegerField(
|
||||
default=0,
|
||||
help_text="Меньше = выше приоритет (1 - наивысший приоритет в этой группе)"
|
||||
)
|
||||
|
||||
class Meta:
|
||||
verbose_name = "Товар в группе вариантов"
|
||||
verbose_name_plural = "Товары в группах вариантов"
|
||||
ordering = ['priority', 'id']
|
||||
unique_together = [['variant_group', 'product']]
|
||||
indexes = [
|
||||
models.Index(fields=['variant_group', 'priority']),
|
||||
models.Index(fields=['product']),
|
||||
]
|
||||
|
||||
def __str__(self):
|
||||
return f"{self.variant_group.name} - {self.product.name} (приоритет {self.priority})"
|
||||
Reference in New Issue
Block a user