octopus/FINAL_REPORT_FIXES.md

Отчет об исправлениях системы динамического ценообразования комплектов

Дата: 2025-11-02

Статус: ✅ Готово к тестированию

---

Проблема 1: Первая строка не считается в цену

Описание

При добавлении первого товара в комплект цена не обновлялась. Цена начинала считаться только со второго товара.

Решение

Файл: products/templates/products/productkit_create.html Файл: products/templates/products/productkit_edit.html

1. Улучшена функция getProductPrice():

   • Добавлена строгая проверка валидности selectElement
   • Добавлена проверка на isNaN и productId <= 0
   • Добавлено консольное логирование для отладки

2. Улучшена функция calculateFinalPrice():

   • Добавлена проверка что товар выбран (if (!productSelect || !productSelect.value) continue)
   • Добавлена валидация количества (если quantity <= 0, использует 1)
   • Добавлена проверка что цена > 0 перед добавлением в сумму

Результат

✅ Первая строка теперь корректно считается в цену ✅ Цена обновляется в реальном времени при добавлении товара

---

Проблема 2: Select2 отображает цену без скидки

Описание

При поиске товаров в Select2 отображалась обычная цена (price), а не цена со скидкой (actual_price).

Решение

Файл: products/templates/products/includes/select2-product-init.html

Обновлена функция formatSelectResult():

function formatSelectResult(item) {
    if (item.loading) return item.text;
    var $container = $('<div class="select2-result-item">');
    $container.text(item.text);

    // Отображаем actual_price (цену со скидкой если она есть), иначе обычную цену
    var displayPrice = item.actual_price || item.price;
    if (displayPrice) {
        $container.append($('<div class="text-muted small">').text(displayPrice + ' руб.'));
    }
    return $container;
}

Результат

✅ Select2 теперь отображает actual_price (цену со скидкой) ✅ Это исправление касается обоих случаев: поиск и список по умолчанию

---

Архитектура решения - Полный обзор

Модель данных (ProductKit)

class ProductKit(BaseProductEntity):
    base_price = DecimalField()  # Сумма actual_price компонентов
    price = DecimalField()  # Итоговая цена (база + корректировка)
    price_adjustment_type = CharField()  # 'none', 'increase_percent', 'increase_amount', 'decrease_percent', 'decrease_amount'
    price_adjustment_value = DecimalField()  # Значение корректировки

    def calculate_final_price(self):
        """Рассчитывает финальную цену с корректировкой"""
        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)

Поток данных

Пользователь выбирает товар
    ↓
Select2 запрашивает API (/api/search-products-variants/?id=X)
    ↓
API возвращает JSON с actual_price
    ↓
getProductPrice() кэширует цену в priceCache
    ↓
calculateFinalPrice() вызывается
    ↓
Суммирует actual_price × quantity для всех компонентов
    ↓
Вычисляет корректировку (автоопределение типа)
    ↓
Обновляет basePriceDisplay и finalPriceDisplay в реальном времени
    ↓
При сохранении отправляет в БД:
  - price_adjustment_type
  - price_adjustment_value
  - calculated price

JavaScript логика

getProductPrice(selectElement)

Получает цену товара с приоритизацией:

1. Кэш (самое быстро)
2. data-product-price атрибут на форме
3. Select2 option data attributes
4. AJAX запрос к API

Логирование:

console.log('getProductPrice: from cache', productId, cachedPrice);
console.log('getProductPrice: from form data', productId, price);
console.log('getProductPrice: from select2 data', productId, price);
console.log('getProductPrice: fetching from API', productId);
console.log('getProductPrice: from API', productId, price);
console.warn('getProductPrice: returning 0 for product', productId);

calculateFinalPrice()

Асинхронная функция которая:

1. Получает все формы компонентов
2. Для каждой формы:
   • Проверяет выбран ли товар
   • Получает quantity (или 1 если не задана)
   • Ждёт await getProductPrice()
   • Суммирует actual_price × quantity
3. Автоматически определяет тип корректировки:
   • Проверяет какое ОДНО из 4 полей заполнено
   • Устанавливает price_adjustment_type
   • Устанавливает price_adjustment_value
4. Рассчитывает финальную цену
5. Обновляет display элементы

API Endpoint

URL: /products/api/search-products-variants/

Параметры:

• q - поисковая строка
• id - ID товара для получения его данных
• type - 'product' или 'variant'
• page - номер страницы

Response:

{
  "results": [
    {
      "id": 1,
      "text": "Роза красная (PROD-000001)",
      "sku": "PROD-000001",
      "price": "50.00",
      "actual_price": "20.00",
      "in_stock": true,
      "type": "product"
    }
  ],
  "pagination": {"more": false}
}

Django Signal для автоматического пересчёта

Файл: inventory/signals.py

@receiver(post_save, sender='products.Product')
def update_kit_prices_on_product_change(sender, instance, created, **kwargs):
    """Пересчитывает все комплекты когда меняется цена товара"""
    if created:
        return

    kit_items = KitItem.objects.filter(product=instance)
    kits_to_update = set(item.kit_id for item in kit_items)

    for kit_id in kits_to_update:
        kit = ProductKit.objects.get(id=kit_id)
        kit.recalculate_base_price()

---

Файлы изменены

Файл	Изменение	Версия
products/models/kits.py	Полная переработка модели ценообразования	✅
products/forms.py	Упрощена, удалены старые поля ценообразования	✅
products/views/api_views.py	Добавлен actual_price во все responses	✅
products/views/productkit_views.py	Добавлен actual_price в context	✅
products/templates/productkit_create.html	Переработан UI + исправлены логика getProductPrice + calculateFinalPrice	✅
products/templates/productkit_edit.html	То же + загрузка сохранённых значений	✅
products/templates/includes/kititem_formset.html	Добавлены data-product-price атрибуты	✅
products/templates/includes/select2-product-init.html	Обновлено отображение actual_price вместо price	✅
inventory/signals.py	Добавлен signal для автоматического пересчёта	✅
products/migrations/0004_add_kit_price_adjustment_fields.py	Migration для новых полей	✅

---

Тестовые сценарии

Сценарий 1: Создание простого комплекта ✅

1. Перейти на http://grach.localhost:8000/products/kits/create/
2. Заполнить название: "Букет из 3 роз"
3. Добавить товар "Роза красная" (qty: 3)
   ✓ base_price должна быть 60.00 (20.00 × 3)
4. Увеличить на 10%
   ✓ final_price должна быть 66.00 (60 × 1.10)
5. Сохранить
   ✓ Комплект должен быть создан с price = 66.00

Сценарий 2: Увеличение суммой ✅

1. Создать комплект с товарами на сумму 50 руб
2. В поле "Увеличить на руб" ввести 10
   ✓ final_price должна быть 60.00
   ✓ price_adjustment_type = 'increase_amount'
   ✓ price_adjustment_value = 10

Сценарий 3: Уменьшение ✅

1. Создать комплект базовой ценой 100 руб
2. Уменьшить на 20%
   ✓ final_price = 80.00
   ✓ price_adjustment_type = 'decrease_percent'
3. Или уменьшить на 15 руб
   ✓ final_price = 85.00
   ✓ price_adjustment_type = 'decrease_amount'

Сценарий 4: Редактирование ✅

1. Создать комплект с увеличением на 10%
2. Открыть для редактирования
   ✓ Значение 10 должно быть загружено в "Увеличить на %"
3. Изменить на 15%
   ✓ final_price пересчитывается в реальном времени
4. Сохранить

Сценарий 5: Отображение цены в Select2 ✅

1. На форме создания комплекта в поле выбора товара начать вводить "роз"
   ✓ В dropdown должны отображаться товары с actual_price (20.00, а не 50.00)
2. При наведении на товар видна цена со скидкой
3. При выборе товара берется actual_price для расчёта

---

Отладка

Просмотр логов в консоли браузера (F12)

// При выборе товара должны видеть:
getProductPrice: fetching from API 1
getProductPrice: from API 1 20.00

// При расчёте цены:
// (логирование каждого товара из calculateFinalPrice)

Проверка данных в Network tab

GET /products/api/search-products-variants/?id=1
Response: {
  "results": [{
    "id": 1,
    "actual_price": "20.00",
    ...
  }]
}

---

Статус готовности

Компонент	Статус	Комментарий
Модель ProductKit	✅	Применена миграция 0004
API endpoint	✅	Возвращает actual_price
Select2 форматирование	✅	Отображает actual_price
Real-time расчёты	✅	Все товары считаются корректно
Сохранение данных	✅	price_adjustment_type и value сохраняются
Редактирование	✅	Загружаются сохранённые значения
Django signal	✅	Готов автоматически пересчитывать
Документация	✅	Полная

---

Готово к тестированию! 🎉

Система полностью переработана и готова к использованию.

URL для тестирования:

• Создание: http://grach.localhost:8000/products/kits/create/
• Редактирование: http://grach.localhost:8000/products/kits/
• API: http://grach.localhost:8000/products/api/search-products-variants/?q=роз

Тестовые товары в тенанте "grach":

1. Роза красная - price: 50.00, sale: 20.00, actual: 20.00 ✓
2. Белая роза - price: 5.00, actual: 5.00 ✓
3. Ваниль гибискус - price: 6.00, actual: 6.00 ✓
4. Хризантема оранжевая - price: 5.00, actual: 5.00 ✓