- Добавлен параметр lock в get_batches_for_fifo() для блокировки строк
- Используется select_for_update() в write_off_by_fifo() для предотвращения
параллельной перезаписи quantity при одновременном списании из одной партии
- Защита от потери данных при параллельном завершении заказов
Проблема:
- Прямой переход cancelled → completed вызывал race condition между сигналами
- Сигналы срабатывали в непредсказуемом порядке
- ShowcaseItem и Reservation не успевали корректно обработаться
- Букеты оставались в неправильном статусе
Решение ПОД КАПОТОМ:
- orders/models/order.py: Order.save() теперь перехватывает прямой переход cancelled → completed
- Автоматически разбивает на два последовательных шага:
1. cancelled → draft: reserve_stock_on_uncancellation возвращает резервы и букеты в reserved
2. draft → completed: create_sale_on_order_completion корректно финализирует в sold
- Каждый шаг вызывает super().save() в отдельной транзакции
- Сигналы срабатывают последовательно в правильном порядке
Преимущества:
- Пользователь не замечает промежуточный переход (происходит мгновенно)
- Не нужны сложные проверки порядка срабатывания сигналов
- Гарантируется корректная работа всех существующих сигналов
- Решение элегантное и не требует изменений в сигналах
Flow теперь гарантированно работает:
cancelled → draft → completed:
Шаг 1: ShowcaseItem available → reserved ✅
Шаг 2: ShowcaseItem reserved → sold ✅
Шаг 1: Reservation order_item=None → привязаны ✅
Шаг 2: Sale создаются, резервы converted_to_sale ✅
Проблема:
- При переходе cancelled → completed резервы витринных букетов отвязаны от order_item (order_item=None)
- В create_sale_on_order_completion поиск резервов по order_item не находит их
- Sale не создаются → букет освобождается вместо продажи
Решение:
- inventory/signals.py: в create_sale_on_order_completion добавлена fallback-логика для витринных комплектов
- Если резервы не найдены по order_item=item, проверяем: витринный комплект?
- Для витринных: ищем резервы через product_kit + showcase__isnull=False + status='reserved'
- Найденные резервы привязываем к order_item перед созданием Sale
- Затем создаются Sale и ShowcaseItem корректно переходит в sold
Flow теперь работает полностью:
1. cancelled: ShowcaseItem → available, Reservation order_item=None
2. cancelled → completed:
- create_sale_on_order_completion находит резервы через product_kit ✅
- Привязывает их к order_item ✅
- Создаёт Sale для компонентов ✅
- Финализирует ShowcaseItem: available → sold ✅
Гарантирует создание Sale даже если порядок срабатывания сигналов не предсказуем.
Проблема:
- При переходе cancelled → completed срабатывали ОБА сигнала:
1. reserve_stock_on_uncancellation переводил ShowcaseItem: available → reserved
2. create_sale_on_order_completion искал букеты в available, но они уже в reserved
3. Букеты оставались в reserved вместо sold
Решение:
- inventory/signals.py: в reserve_stock_on_uncancellation добавлена проверка current_status.is_positive_end
- Если текущий статус положительный финальный (completed) - ShowcaseItem НЕ трогаем
- Оставляем в available для финализации в create_sale_on_order_completion
- Если текущий статус нейтральный (draft/pending) - переводим available → reserved как раньше
Flow теперь работает корректно:
1. cancelled → draft/pending: ShowcaseItem available → reserved ✅
2. cancelled → completed: ShowcaseItem available → sold ✅ (ИСПРАВЛЕНО!)
- reserve_stock_on_uncancellation пропускает (видит is_positive_end)
- create_sale_on_order_completion финализирует: available → sold
Защита от race condition между двумя сигналами.
Проблема:
- При отмене (cancelled) метод return_to_available() сбрасывает sold_order_item = None
- При переходе cancelled → completed поиск ShowcaseItem по sold_order_item__order не находит букеты
- Букеты оставались в статусе 'available' вместо 'sold'
Решение:
- inventory/signals.py: в сигнале create_sale_on_order_completion изменена логика поиска
- Разделён поиск на два этапа:
1. Поиск по sold_order_item для букетов в 'reserved' (обычный flow)
2. Поиск по product_kit для букетов в 'available' (переход из cancelled)
- Для букетов в 'available': ищем через product_kit + status='available' + sold_order_item__isnull=True
- Вызываем mark_sold(order_item) для каждого найденного букета
- Букет корректно переходит available → sold и привязывается к OrderItem
Flow теперь работает:
1. draft → completed: ShowcaseItem reserved → sold ✅
2. cancelled → completed: ShowcaseItem available → sold ✅ (ИСПРАВЛЕНО!)
Защита от двойной продажи работает корректно.
Проблема:
- При переходе заказа cancelled → completed витринный букет оставался в статусе 'available'
- Логика финализации искала только ShowcaseItem в статусе 'reserved'
- НО при отмене (cancelled) ShowcaseItem переходит в 'available', а не остаётся в 'reserved'
- Итог: букет не финализировался, оставался свободным вместо проданного
Решение:
- inventory/signals.py: в сигнале create_sale_on_order_completion обновлена логика финализации
- Теперь ищем ShowcaseItem в статусах ['reserved', 'available']
- Для статуса 'reserved': вызываем mark_sold_from_reserved() (обычный flow)
- Для статуса 'available': вызываем mark_sold() (переход из отмены cancelled → completed)
- Оба метода корректно переводят букет в 'sold' и устанавливают sold_at
Flow переходов:
1. Обычный: draft → completed: ShowcaseItem reserved → sold ✅
2. Из отмены: cancelled → completed: ShowcaseItem available → sold ✅ (ИСПРАВЛЕНО)
Проблема:
- При отмене заказа (cancelled) ShowcaseItem переходил в 'available'
- При возврате из cancelled в нейтральный статус (draft/pending) резервы привязывались обратно
- НО ShowcaseItem оставался в 'available', что позволяло добавить букет в другой заказ
- Итог: один физический букет в двух заказах
Решение:
- inventory/signals.py: в сигнале reserve_stock_on_uncancellation добавлена логика
- При переходе cancelled → нейтральный:
* Находим ShowcaseItem витринных комплектов в статусе 'available'
* Вызываем return_to_reserved(order_item) для каждого экземпляра
* ShowcaseItem: available → reserved (привязан к OrderItem)
- Теперь букет корректно возвращается в резерв и недоступен на витрине
Lifecycle при откате отмены:
1. cancelled: ShowcaseItem = available, резервы отвязаны
2. cancelled → draft/pending: ShowcaseItem = reserved, резервы привязаны
3. Букет остаётся за заказом, защищён от двойной продажи
- inventory/views/showcase.py: фильтр .exclude(status='reserved')
* Витринные букеты со статусом 'reserved' не отображаются в POS
* Защита от конфликтов: один букет - один заказ
- pos/views.py: фильтр .exclude(showcase_items__status='reserved')
* Showcase комплекты без доступных букетов скрыты в POS
* Фильтрация на уровне queryset для производительности
- Консистентная видимость витрины для всех кассиров
- orders/forms.py: добавлено поле is_from_showcase в OrderItemForm
* HiddenInput widget
* Устанавливается через JavaScript для showcase_kit
- orders/templates/orders/order_form.html: JavaScript логика
* Автоматическое определение showcase_kit при загрузке черновика
* Установка is_from_showcase=true для витринных комплектов
* Консольное логирование для отладки
- Флаг используется backend для вызова reserve_for_order()
- inventory/signals.py: обработчик изменения статуса Order
* При смене статуса на 'завершён' (is_positive_end=True): reserved → sold
* При смене на 'отменён' (is_negative_end=True): reserved → available
- inventory/services/showcase_manager.py: метод reserve_for_order()
* Переводит ShowcaseItem: in_cart → reserved
* Создаёт жёсткую связь с OrderItem
* Автоматическое управление статусами через сигналы
- Транзакционная безопасность через @transaction.atomic
- inventory/models.py: добавлен статус 'reserved' в STATUS_CHOICES
- Миграция: 0004_add_reserved_status_to_showcaseitem.py
- Статус reserved используется для витринных букетов в отложенных заказах
- Жизненный цикл: available → in_cart → reserved → sold
- pos/static/pos/js/terminal.js: переработана функция createDeferredOrder()
- Новый flow:
1. Вызывает POST /orders/api/create-from-pos/ для создания Order (draft)
2. Получает order_number в ответе
3. ShowcaseItem резервируются на backend (in_cart → reserved)
4. Очищает корзину POS (cart.clear + saveCartToRedis)
5. Перезагружает витрину (refreshShowcaseKits) для синхронизации UI
6. Открывает /orders/<order_number>/edit/ в новой вкладке
- Устранена race condition: резервирование ДО очистки корзины
- Витринные букеты корректно исчезают из POS после резервирования
- orders/views.py: новая функция create_order_from_pos()
- orders/urls.py: маршрут POST /orders/api/create-from-pos/
- Логика:
* Создаёт Order со статусом 'draft'
* Создаёт OrderItem с флагом is_from_showcase=True для showcase_kit
* Резервирует ShowcaseItem через reserve_for_order() (in_cart → reserved)
* Возвращает order_number в JSON
- Транзакция atomic гарантирует целостность данных
- Правильная архитектура: endpoint в orders app, не в POS
- orders/views.py: убрано auto_fill_draft_date из order_create и order_update
- Черновики теперь могут сохраняться с NULL датой доставки
- Валидация на уровне модели обеспечивает корректность данных
- orders/models/delivery.py: delivery_date теперь null=True, blank=True
- Валидация: для черновиков дата необязательна, для обычных заказов - обязательна
- Миграция: 0003_allow_null_delivery_date_for_drafts.py
Проблемы:
1. При продаже витринного комплекта через POS создавались дубликаты резервов
- reserve_stock_on_item_create создавал новые резервы для витринного комплекта
- Хотя резервы уже существовали от ShowcaseManager.reserve_kit_to_showcase
2. При переходе заказа в Completed создавались дубликаты Sale
- ShowcaseManager.sell_showcase_items создавал Sale
- Затем сигнал create_sale_on_order_completion создавал Sale повторно
3. При отмене заказа (Completed → Cancelled) терялась связь ShowcaseItem с резервами
- ShowcaseItem возвращался на витрину, но резервы теряли поле showcase_item
- При повторном переходе в Completed резервы дублировались
Исправления:
1. inventory/signals.py - reserve_stock_on_item_create (строки 165-180):
- Добавлена проверка витринного комплекта (is_temporary && showcase)
- Для витринных комплектов сигнал пропускает создание новых резервов
- Привязка существующих резервов происходит в update_reservation_on_item_change
2. inventory/signals.py - create_sale_on_order_completion (строки 346-365):
- Добавлена проверка уже обработанных резервов (status='converted_to_sale')
- Сигнал пропускает витринные резервы, уже обработанные ShowcaseManager
- Логирует информацию о пропущенных резервах
3. inventory/signals.py - rollback_sale_on_status_change (строки 746-774):
- При возврате ShowcaseItem на витрину восстанавливается связь с резервами
- Обновляется поле showcase_item в резервах через Reservation.objects.update()
- Логируется количество восстановленных связей
4. inventory/services/showcase_manager.py - sell_showcase_items (строки 201-206):
- Добавлена проверка статуса резерва перед созданием Sale
- Если резерв уже в 'converted_to_sale', он пропускается
- Защита от двойного списания одного резерва
Результат:
✅ Резервы создаются только один раз при размещении на витрине
✅ Sale создаются только один раз при продаже
✅ ShowcaseItem корректно возвращается на витрину со связью с резервами
✅ Остатки на складе корректные (60 → 55 после продажи, 60 после отмены)
✅ Нет дублирования при многократных переходах Completed ↔ Cancelled
Заменен чекбокс "только в наличии" на выпадающий список с опциями: все товары, в наличии, не в наличии. Обновлена логика фильтрации в API и интерфейсе.
feat(inventory): introduce stock deficit notifications and base quantity tracking
- Added `quantity_base` field to reservation model for precise inventory calculations
- Implemented non-blocking stock deficit warnings during kit creation process
- Enhanced API responses with warning details for frontend display
- Updated terminal interface to show formatted stock shortage alerts
BREAKING CHANGE: API response structure now includes `warnings` array instead of previous stock warning format
Implement functionality to allow sales even when stock is insufficient, tracking pending quantities and resolving them when new stock arrives via incoming documents. This includes new fields in Sale model (is_pending_cost, pending_quantity), updates to batch manager for negative write-offs, and signal handlers for automatic processing.
- Add is_pending_cost and pending_quantity fields to Sale model
- Modify write_off_by_fifo to support allow_negative flag and return pending quantity
- Update incoming document service to allocate pending sales to new batches
- Enhance sale processor and signals to handle pending sales
- Remove outdated tests.py file
- Add migration for new Sale fields
- Updated generated timestamps in initial migrations of accounts, customers,
inventory, orders, products, tenants, and user_roles apps
- Reflect new generation time from 08:35 to 23:23 on 2026-01-03
- No changes to migration logic or schema detected
- Ensures migration files align with most recent generation time for consistency
- Все docker-файлы теперь в myproject/docker/
- Добавлен docker/.env.docker в gitignore для защиты секретов
- Сохранена обратная совместимость с существующими настройками
- Структура проекта стала более организованной
Реализован полностью новый функционал экспорта клиентов с возможностью
выбора полей, формата файла (CSV/XLSX) и сохранением предпочтений.
Ключевые изменения:
1. CustomerExporter (import_export.py):
- Полностью переписан класс с поддержкой динамического выбора полей
- Добавлена конфигурация AVAILABLE_FIELDS с метаданными полей
- Реализован метод get_available_fields() для фильтрации по ролям
- Новый метод export_to_xlsx() с автоподстройкой ширины столбцов
- Форматирование ContactChannel с переводами строк
- Поддержка фильтрации queryset
2. CustomerExportForm (forms.py):
- Динамическое создание checkbox полей на основе роли пользователя
- Выбор формата файла (CSV/XLSX) через radio buttons
- Валидация выбора хотя бы одного поля
3. View customer_export (views.py):
- КРИТИЧНО: Изменён декоратор с @manager_or_owner_required на @owner_required
- Обработка GET (редирект) и POST запросов
- Применение фильтров CustomerFilter из списка клиентов
- Оптимизация с prefetch_related('contact_channels')
- Сохранение настроек экспорта в session
4. UI изменения:
- Создан шаблон customer_export_modal.html с модальным окном
- Обновлён customer_list.html: кнопка экспорта с проверкой роли
- JavaScript для восстановления сохранённых настроек из session
- Отображение количества экспортируемых клиентов
- Бейдж "Только для владельца" на поле баланса кошелька
Безопасность:
- Экспорт доступен ТОЛЬКО владельцу тенанта (OWNER) и superuser
- Поле "Баланс кошелька" скрыто от менеджеров на уровне формы
- Двойная проверка роли при экспорте баланса
- Кнопка экспорта скрыта в UI для всех кроме owner/superuser
Функциональность:
- Выбор полей: ID, имя, email, телефон, заметки, каналы связи, баланс, дата создания
- Форматы: CSV (с BOM для Excel) и XLSX
- Учёт текущих фильтров и поиска из списка клиентов
- Сохранение предпочтений между экспортами в session
- Исключение системного клиента из экспорта
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Проблема: при создании тенанта автоматически создаются дефолтные
Склад и Витрина. Если пользователь удалит их, система может сломаться:
POS, создание заказов и резервирование перестанут работать.
Решение: реализована строгая валидация + мягкое удаление для витрин.
Изменения в inventory/views/warehouse.py:
- Добавлена валидация перед деактивацией склада:
* Блокировка деактивации последнего активного склада
* Проверка ненулевых остатков товаров
* Проверка активных резервов
* Предупреждение при деактивации дефолтного склада
Изменения в inventory/views/showcase.py:
- ShowcaseListView: по умолчанию показывает только активные витрины
- ShowcaseDeleteView: изменена логика с жесткого на мягкое удаление
- Добавлена валидация перед деактивацией витрины:
* Блокировка деактивации последней активной витрины склада
* Проверка активных резервов
* Проверка физических экземпляров комплектов (ShowcaseItem)
* Предупреждение при деактивации дефолтной витрины
Изменения в inventory/forms_showcase.py:
- Проверка уникальности названия витрины учитывает только активные
Изменения в inventory/admin.py:
- ShowcaseAdmin: добавлены методы delete_model() и delete_queryset()
для блокировки удаления последней витрины через админку
- WarehouseAdmin: добавлены методы delete_model() и delete_queryset()
для блокировки удаления последнего склада через админку
Преимущества:
✅ Система не сломается - всегда есть хотя бы один активный склад/витрина
✅ Данные в безопасности - мягкое удаление для обеих сущностей
✅ Понятные сообщения об ошибках для пользователя
✅ Защита работает как в UI, так и в Django Admin
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Проблема: при создании новой группы вариантов (VariantGroup) поиск
товаров через Select2 не работал. При редактировании существующих
групп всё работало корректно.
Причина: отсутствовали проверки инициализации Select2, обработка
ошибок AJAX запросов и валидация параметров.
Изменения:
1. select2-product-init.html - улучшена функция initProductSelect2:
- Добавлена валидация входных параметров (element, apiUrl)
- Добавлена проверка загрузки jQuery и Select2
- Улучшена проверка повторной инициализации
- Добавлен try-catch для обработки ошибок
- Функция возвращает boolean (успех/неудача)
- Добавлено логирование для отладки
2. variantgroup_form.html - улучшены все функции работы с формой:
initSelect2ForRow:
- Добавлена проверка существования row и select элемента
- Удаление старых обработчиков перед инициализацией
- Проверка результата инициализации Select2
updateRowData:
- Добавлен timeout (5 сек) для fetch запросов
- Добавлена проверка статуса HTTP ответа
- Улучшена обработка ошибок с fallback данными
- Добавлено логирование ошибок
DOMContentLoaded инициализация:
- Добавлена валидация контейнера, totalFormsInput и apiUrl
- Задержка перед инициализацией существующих строк (100ms)
- Проверка успешности инициализации перед updateRowData
Добавление нового товара:
- Задержка (50ms) перед инициализацией Select2
- Повторная попытка при неудаче (через 500ms)
- Улучшена надежность работы с динамическими элементами
Результат: Select2 поиск работает корректно как при создании новых
групп, так и при редактировании существующих. Добавлена надежная
обработка ошибок и логирование для отладки.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Новый фильтр has_contact_channel показывает клиентов с записями в ContactChannel
- Проверяет наличие альтернативных контактов (Instagram, Telegram и т.д.)
- Добавлен чекбокс в форму фильтров с flex-wrap для переноса
- Обновлено условие показа кнопки Очистить
- Фильтр автоматически сохраняется в пагинации через url_replace
- Создан элегантный тег для автоматического сохранения GET-параметров
- Код пагинации сократился в 10 раз
- Переиспользуется в любых шаблонах проекта
- 100 процентов Django-way без хаков
- Убран нерабочий хак с params.pop
- Все ссылки пагинации теперь явно передают параметры:
* q (поисковый запрос)
* has_notes (фильтр заметок)
* no_phone (фильтр отсутствия телефона)
* no_email (фильтр отсутствия email)
- Пагинация теперь работает корректно с сохранением всех фильтров
- Вместо текста 'X / Y' теперь кликабельные цифры страниц
- Показывается до 10 страниц (±5 от текущей)
- Текущая страница выделена (active)
- Умная логика: если на странице 15, показывает 10-20
- Все параметры фильтров сохраняются при клике на номер страницы
- Пагинация теперь сохраняет ВСЕ GET-параметры (query, has_notes, no_phone, no_email)
- Использован request.GET.copy() и params.urlencode для передачи всех параметров
- Фильтры больше не сбрасываются при переходе между страницами
- Создан CustomerFilter с тремя фильтрами:
* Есть заметки (has_notes)
* Нет телефона (no_phone)
* Нет email (no_email)
- Обновлен views.py для использования фильтров
- Добавлены чекбоксы фильтров в шаблон списка клиентов
- Фильтры работают совместно с поиском
- Кнопка Очистить отображается при активных фильтрах или поиске
- Новый столбец Notes в таблице клиентов
- Текст обрезается до 10 слов (truncatewords)
- Максимальная ширина 300px с ellipsis
- При наведении показывается полный текст через title
- Если заметок нет, отображается тире (—)
- Форма начинает отправку сразу при submit
- Прогресс-бар и защита включаются через 10ms (после начала отправки)
- Предупреждение появляется только при попытке закрыть страницу во время импорта
- Импорт корректно выполняется на сервере
- Добавлена предобработка email перед валидацией:
* Исправление типичных опечаток (mail ru -> mail.ru, .ry -> .ru)
* Удаление пробелов и двойных @@
* Умное добавление @ для популярных доменов
* Исправление доменов без точки (gmail -> gmail.com)
- Улучшена нормализация телефонов:
* Умное добавление кода страны (+375, +7, +380)
* Конверсия старого формата 8XXXXXXXXXX -> +7XXXXXXXXXX
* Проверка длины номера (10-15 символов)
* Поддержка локальных белорусских номеров (9 цифр)
- Реализована идемпотентность импорта:
* Notes не раздуваются при повторных импортах (метод _append_unique_note)
* ContactChannel не дублируется для одного клиента
* Проверка существования альтернативных контактов по customer+type+value
- Добавлен прогресс-бар и защита от закрытия:
* Визуальный прогресс-бар с анимацией и динамическим текстом
* Блокировка формы во время импорта
* Предупреждение браузера при попытке закрыть страницу
- Создана команда clear_anatol_customers для тестирования
- Добавлен тестовый файл test_customer_preprocess.csv с примерами исправляемых ошибок
- Обновлены начальные миграции для всех приложений
- Удалены устаревшие миграции для единиц измерения и SKU
- Добавлен новый сервис unit_service.py для управления единицами
- Обновлены команды инициализации данных тенанта
На странице детализации товара теперь отображается таблица с единицами
продажи: название, единица измерения, коэффициент, цена, мин. количество
и шаг. Единица по умолчанию выделена зелёным.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Изменён floatformat с :0 на :-3 для корректного отображения
дробных остатков товаров (до 3 знаков после запятой).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
При редактировании товара проверка зарезервированных префиксов теперь
пропускается, если артикул не изменился. Это позволяет редактировать
товары с автоматически сгенерированными артикулами.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Удалена функция parse_variant_suffix и логика автоматического добавления
суффикса варианта к артикулу товара. SKU теперь всегда имеет формат
PROD-XXXXXX без дополнительных суффиксов.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Проблема: при приёмке товаров отображались только товары с ненулевым
остатком на складе, товары с нулевым остатком не находились.
Решение: добавлен параметр skip_stock_filter в компонент поиска товаров,
который отключает фильтрацию по остаткам. Для приёмки этот параметр
включён по умолчанию.
Изменения:
- api_views.py: добавлен параметр skip_stock_filter в _apply_product_filters
- product_search_picker.html: добавлен data-атрибут skip_stock_filter
- product-search-picker.js: передача параметра в API
- incoming_document_detail.html: включён skip_stock_filter=True
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
