smaa/octopus
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity

Add ProductKit binding to ConfigurableKitProductAttribute values

Browse Source 
Implementation of kit binding feature for ConfigurableKitProduct variants:

- Added ForeignKey field `kit` to ConfigurableKitProductAttribute
  * References ProductKit with CASCADE delete
  * Optional field (blank=True, null=True)
  * Indexed for efficient queries

- Created migration 0007_add_kit_to_attribute
  * Handles existing data (NULL values for all current records)
  * Properly indexed for performance

- Updated template configurablekit_form.html
  * Injected available ProductKits into JavaScript
  * Added kit selector dropdown in card interface
  * Each value now has associated kit selection
  * JavaScript validates kit selection alongside values

- Updated JavaScript in card interface
  * serializeAttributeValues() now collects kit IDs
  * Creates parallel JSON arrays: values and kits
  * Stores in hidden fields: attributes-X-values and attributes-X-kits

- Updated views _save_attributes_from_cards() in both Create and Update
  * Reads kit IDs from POST JSON
  * Looks up ProductKit objects
  * Creates ConfigurableKitProductAttribute with FK populated
  * Gracefully handles missing kits

- Fixed _should_delete_form() method
  * More robust handling of formset deletion_field
  * Works with all formset types

- Updated __str__() method
  * Handles NULL kit case

Example workflow:
  Dlina: 50 -> Kit A, 60 -> Kit B, 70 -> Kit C
  Upakovka: BEZ -> Kit A, V_UPAKOVKE -> (no kit)

Tested with test_kit_binding.py - all tests passing
- Kit creation and retrieval
- Attribute creation with kit FK
- Mixed kit-bound and unbound attributes
- Querying attributes by kit
- Reverse queries (get kit for attribute value)

Added documentation: KIT_BINDING_IMPLEMENTATION.md

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Andrey Smakotin
2025-11-18 21:29:14 +03:00
parent a12f8f990d
commit 3f789785ca
7 changed files with 948 additions and 63 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
myproject/products/migrations/0007_add_kit_to_attribute.py Normal file
View File

@@ -0,0 +1,31 @@
# Generated by Django 5.0.10 on 2025-11-18 18:13
import django.db.models.deletion
from django.db import migrations, models
class Migration(migrations.Migration):
dependencies = [
('products', '0006_add_configurablekitoptionattribute'),
]
operations = [
migrations.AlterUniqueTogether(
name='configurablekitproductattribute',
unique_together=set(),
),
migrations.AddField(
model_name='configurablekitproductattribute',
name='kit',
field=models.ForeignKey(blank=True, help_text='Какой ProductKit связан с этим значением атрибута', null=True, on_delete=django.db.models.deletion.CASCADE, related_name='as_attribute_value_in', to='products.productkit', verbose_name='Комплект для этого значения'),
),
migrations.AlterUniqueTogether(
name='configurablekitproductattribute',
unique_together={('parent', 'name', 'option', 'kit')},
),
migrations.AddIndex(
model_name='configurablekitproductattribute',
index=models.Index(fields=['kit'], name='products_co_kit_id_c5d506_idx'),
),
]

25
myproject/products/models/kits.py
View File

@@ -405,9 +405,13 @@ class ConfigurableKitProduct(BaseProductEntity):
class ConfigurableKitProductAttribute(models.Model):
"""
Атрибут родительского вариативного товара.
Определяет схему атрибутов для экспорта на WooCommerce и подобные площадки.
Например: name="Цвет", option="Красный" или name="Размер", option="M".
Атрибут родительского вариативного товара с привязкой к ProductKit.
Каждое значение атрибута связано с конкретным ProductKit.
Например:
- Длина: 50 → ProductKit (A)
- Длина: 60 → ProductKit (B)
- Длина: 70 → ProductKit (C)
"""
parent = models.ForeignKey(
ConfigurableKitProduct,
@@ -425,6 +429,15 @@ class ConfigurableKitProductAttribute(models.Model):
verbose_name="Значение опции",
help_text="Например: Красный, M, 60см"
)
kit = models.ForeignKey(
ProductKit,
on_delete=models.CASCADE,
related_name='as_attribute_value_in',
verbose_name="Комплект для этого значения",
help_text="Какой ProductKit связан с этим значением атрибута",
blank=True,
null=True
)
position = models.PositiveIntegerField(
default=0,
verbose_name="Порядок отображения",
@@ -440,14 +453,16 @@ class ConfigurableKitProductAttribute(models.Model):
verbose_name = "Атрибут вариативного товара"
verbose_name_plural = "Атрибуты вариативных товаров"
ordering = ['parent', 'position', 'name', 'option']
unique_together = [['parent', 'name', 'option']]
unique_together = [['parent', 'name', 'option', 'kit']]
indexes = [
models.Index(fields=['parent', 'name']),
models.Index(fields=['parent', 'position']),
models.Index(fields=['kit']),
]
def __str__(self):
return f"{self.parent.name} - {self.name}: {self.option}"
kit_str = self.kit.name if self.kit else "no kit"
return f"{self.parent.name} - {self.name}: {self.option} ({kit_str})"
class ConfigurableKitOption(models.Model):

100
myproject/products/templates/products/configurablekit_form.html
View File

@@ -106,6 +106,15 @@ input[name*="DELETE"] {
{{ attribute_formset.management_form }}
<!-- Список доступных комплектов для JavaScript -->
<script>
window.AVAILABLE_KITS = [
{% for kit in available_kits %}
{ id: {{ kit.id }}, name: "{{ kit.name }}" }{% if not forloop.last %},{% endif %}
{% endfor %}
];
</script>
{% if attribute_formset.non_form_errors %}
<div class="alert alert-danger">
{{ attribute_formset.non_form_errors }}
@@ -463,17 +472,28 @@ initDefaultSwitches();
// === Управление параметрами товара (карточный интерфейс) ===
// Функция для добавления нового поля значения параметра
function addValueField(container, valueText = '') {
// Функция для добавления нового поля значения параметра с выбором ProductKit
function addValueField(container, valueText = '', kitId = '') {
const index = container.querySelectorAll('.value-field-group').length;
const fieldId = `value-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
// Получаем список доступных комплектов из скрытого элемента
const kitOptionsHtml = getKitOptionsHtml(kitId);
const html = `
<div class="value-field-group d-flex gap-2 mb-2">
<div class="value-field-group d-flex gap-2 mb-2 align-items-start">
<input type="text" class="form-control form-control-sm parameter-value-input"
placeholder="Введите значение"
value="${valueText}"
data-field-id="${fieldId}">
data-field-id="${fieldId}"
style="min-width: 100px;">
<select class="form-select form-select-sm parameter-kit-select"
data-field-id="${fieldId}"
title="Выберите комплект для этого значения"
style="min-width: 150px;">
<option value="">-- Выберите комплект --</option>
${kitOptionsHtml}
</select>
<button type="button" class="btn btn-sm btn-outline-danger remove-value-btn" title="Удалить значение">
<i class="bi bi-trash"></i>
</button>
@@ -482,6 +502,14 @@ function addValueField(container, valueText = '') {
container.insertAdjacentHTML('beforeend', html);
// Установка выбранного комплекта если был передан
if (kitId) {
const kitSelect = container.querySelector('.parameter-kit-select:last-child');
if (kitSelect) {
kitSelect.value = kitId;
}
}
// Обработчик удаления значения
container.querySelector('.remove-value-btn:last-child').addEventListener('click', function(e) {
e.preventDefault();
@@ -489,6 +517,15 @@ function addValueField(container, valueText = '') {
});
}
// Получить HTML с опциями комплектов
function getKitOptionsHtml(selectedKitId = '') {
const kitsData = window.AVAILABLE_KITS || [];
return kitsData.map(kit => {
const selected = kit.id == selectedKitId ? 'selected' : '';
return `<option value="${kit.id}" ${selected}>${kit.name}</option>`;
}).join('');
}
// Инициализация существующих параметров с их значениями из БД
function initializeParameterCards() {
document.querySelectorAll('.attribute-card').forEach(card => {
@@ -595,36 +632,55 @@ function initParamDeleteToggle(card) {
}
}
// Функция для сериализации значений параметров перед отправкой формы
// Функция для сериализации значений параметров и их комплектов перед отправкой формы
function serializeAttributeValues() {
/**
* Перед отправкой формы нужно сериализовать все значения параметров
* из инлайн input'ов в скрытые JSON поля для отправки на сервер
* и их связанные комплекты из инлайн input'ов в скрытые JSON поля
*/
document.querySelectorAll('.attribute-card').forEach((card, idx) => {
// Получаем все инпуты с значениями внутри этой карточки
const valueInputs = card.querySelectorAll('.parameter-value-input');
// Получаем все инпуты с значениями и их комплектами внутри этой карточки
const valueGroups = card.querySelectorAll('.value-field-group');
const values = [];
const kits = [];
valueInputs.forEach(input => {
const value = input.value.trim();
if (value) {
values.push(value);
valueGroups.forEach(group => {
const valueInput = group.querySelector('.parameter-value-input');
const kitSelect = group.querySelector('.parameter-kit-select');
if (valueInput) {
const value = valueInput.value.trim();
const kitId = kitSelect ? kitSelect.value : '';
if (value && kitId) { // Требуем чтобы оба поля были заполнены
values.push(value);
kits.push(parseInt(kitId));
}
}
});
// Создаем или обновляем скрытое поле JSON с названием attributes-{idx}-values
const jsonFieldName = `attributes-${idx}-values`;
let jsonField = document.querySelector(`input[name="${jsonFieldName}"]`);
if (!jsonField) {
jsonField = document.createElement('input');
jsonField.type = 'hidden';
jsonField.name = jsonFieldName;
card.appendChild(jsonField);
// Создаем или обновляем скрытые поля JSON
// поле values: ["50", "60", "70"]
const valuesFieldName = `attributes-${idx}-values`;
let valuesField = document.querySelector(`input[name="${valuesFieldName}"]`);
if (!valuesField) {
valuesField = document.createElement('input');
valuesField.type = 'hidden';
valuesField.name = valuesFieldName;
card.appendChild(valuesField);
}
valuesField.value = JSON.stringify(values);
jsonField.value = JSON.stringify(values);
// поле kits: [1, 2, 3] (id ProductKit)
const kitsFieldName = `attributes-${idx}-kits`;
let kitsField = document.querySelector(`input[name="${kitsFieldName}"]`);
if (!kitsField) {
kitsField = document.createElement('input');
kitsField.type = 'hidden';
kitsField.name = kitsFieldName;
card.appendChild(kitsField);
}
kitsField.value = JSON.stringify(kits);
});
}

140
myproject/products/views/configurablekit_views.py
View File

@@ -136,7 +136,13 @@ class ConfigurableKitProductCreateView(LoginRequiredMixin, CreateView):
context['attribute_formset'] = ConfigurableKitProductAttributeFormSetCreate(
prefix='attributes'
)
# Доступные комплекты для JavaScript (для выбора при добавлении значений атрибутов)
context['available_kits'] = ProductKit.objects.filter(
status='active',
is_temporary=False
).order_by('name')
return context
def form_valid(self, form):
@@ -215,10 +221,12 @@ class ConfigurableKitProductCreateView(LoginRequiredMixin, CreateView):
- attributes-X-position: позиция
- attributes-X-visible: видимость
- attributes-X-DELETE: помечен ли для удаления
Значения приходят как инлайн input'ы внутри параметра:
- Читаем из POST все 'parameter-value-input' инпуты
- attributes-X-values: JSON массив значений параметра
- attributes-X-kits: JSON массив ID комплектов для каждого значения
"""
import json
from products.models.kits import ProductKit
# Сначала удаляем все старые атрибуты
ConfigurableKitProductAttribute.objects.filter(parent=self.object).delete()
@@ -249,39 +257,56 @@ class ConfigurableKitProductCreateView(LoginRequiredMixin, CreateView):
visible = self.request.POST.get(f'attributes-{idx}-visible') == 'on'
# Получаем все значения параметра из POST
# Они приходят как data в JSON при отправке формы
# Нужно их извлечь из скрытых input'ов или динамически созданных
# Способ 1: Получаем все значения из POST которые относятся к этому параметру
# Шаблон: 'attr_{idx}_value_{value_idx}' или просто читаем из скрытого JSON поля
# Пока используем упрощённый подход:
# JavaScript должен будет отправить значения в скрытом поле JSON
# Формат: attributes-X-values = ["value1", "value2", "value3"]
# Получаем значения и их привязанные комплекты
values_json = self.request.POST.get(f'attributes-{idx}-values', '[]')
import json
kits_json = self.request.POST.get(f'attributes-{idx}-kits', '[]')
try:
values = json.loads(values_json)
except (json.JSONDecodeError, TypeError):
values = []
try:
kit_ids = json.loads(kits_json)
except (json.JSONDecodeError, TypeError):
kit_ids = []
# Создаём ConfigurableKitProductAttribute для каждого значения
for value_idx, value in enumerate(values):
if value and value.strip():
ConfigurableKitProductAttribute.objects.create(
parent=self.object,
name=name,
option=value.strip(),
position=position,
visible=visible
)
# Получаем соответствующий ID комплекта
kit_id = kit_ids[value_idx] if value_idx < len(kit_ids) else None
# Приготавливаем параметры создания
create_kwargs = {
'parent': self.object,
'name': name,
'option': value.strip(),
'position': position,
'visible': visible
}
# Добавляем комплект если указан
if kit_id:
try:
kit = ProductKit.objects.get(id=kit_id)
create_kwargs['kit'] = kit
except ProductKit.DoesNotExist:
# Комплект не найден - создаём без привязки
pass
ConfigurableKitProductAttribute.objects.create(**create_kwargs)
@staticmethod
def _should_delete_form(form, formset):
"""Проверить должна ли форма быть удалена"""
return formset.can_delete and form.cleaned_data.get(formset.deletion_field.name, False)
if not formset.can_delete:
return False
# Проверяем поле DELETE (стандартное имя для formset deletion field)
deletion_field_name = 'DELETE'
if hasattr(formset, 'deletion_field') and hasattr(formset.deletion_field, 'name'):
deletion_field_name = formset.deletion_field.name
return form.cleaned_data.get(deletion_field_name, False)
def get_success_url(self):
return reverse_lazy('products:configurablekit-detail', kwargs={'pk': self.object.pk})
@@ -324,7 +349,13 @@ class ConfigurableKitProductUpdateView(LoginRequiredMixin, UpdateView):
instance=self.object,
prefix='attributes'
)
# Доступные комплекты для JavaScript (для выбора при добавлении значений атрибутов)
context['available_kits'] = ProductKit.objects.filter(
status='active',
is_temporary=False
).order_by('name')
return context
def form_valid(self, form):
@@ -398,8 +429,18 @@ class ConfigurableKitProductUpdateView(LoginRequiredMixin, UpdateView):
def _save_attributes_from_cards(self):
"""
Сохранить атрибуты из карточного интерфейса.
См. копию этого метода в ConfigurableKitProductCreateView для подробностей.
Каждая карточка содержит:
- attributes-X-name: название параметра
- attributes-X-position: позиция
- attributes-X-visible: видимость
- attributes-X-DELETE: помечен ли для удаления
- attributes-X-values: JSON массив значений параметра
- attributes-X-kits: JSON массив ID комплектов для каждого значения
"""
import json
from products.models.kits import ProductKit
# Сначала удаляем все старые атрибуты
ConfigurableKitProductAttribute.objects.filter(parent=self.object).delete()
@@ -430,29 +471,56 @@ class ConfigurableKitProductUpdateView(LoginRequiredMixin, UpdateView):
visible = self.request.POST.get(f'attributes-{idx}-visible') == 'on'
# Получаем все значения параметра из POST
# Получаем значения и их привязанные комплекты
values_json = self.request.POST.get(f'attributes-{idx}-values', '[]')
import json
kits_json = self.request.POST.get(f'attributes-{idx}-kits', '[]')
try:
values = json.loads(values_json)
except (json.JSONDecodeError, TypeError):
values = []
try:
kit_ids = json.loads(kits_json)
except (json.JSONDecodeError, TypeError):
kit_ids = []
# Создаём ConfigurableKitProductAttribute для каждого значения
for value_idx, value in enumerate(values):
if value and value.strip():
ConfigurableKitProductAttribute.objects.create(
parent=self.object,
name=name,
option=value.strip(),
position=position,
visible=visible
)
# Получаем соответствующий ID комплекта
kit_id = kit_ids[value_idx] if value_idx < len(kit_ids) else None
# Приготавливаем параметры создания
create_kwargs = {
'parent': self.object,
'name': name,
'option': value.strip(),
'position': position,
'visible': visible
}
# Добавляем комплект если указан
if kit_id:
try:
kit = ProductKit.objects.get(id=kit_id)
create_kwargs['kit'] = kit
except ProductKit.DoesNotExist:
# Комплект не найден - создаём без привязки
pass
ConfigurableKitProductAttribute.objects.create(**create_kwargs)
@staticmethod
def _should_delete_form(form, formset):
"""Проверить должна ли форма быть удалена"""
return formset.can_delete and form.cleaned_data.get(formset.deletion_field.name, False)
if not formset.can_delete:
return False
# Проверяем поле DELETE (стандартное имя для formset deletion field)
deletion_field_name = 'DELETE'
if hasattr(formset, 'deletion_field') and hasattr(formset.deletion_field, 'name'):
deletion_field_name = formset.deletion_field.name
return form.cleaned_data.get(deletion_field_name, False)
def get_success_url(self):
return reverse_lazy('products:configurablekit-detail', kwargs={'pk': self.object.pk})