feat: упростить создание заказов и рефакторинг единиц измерения

- Добавить inline-редактирование цен в списке товаров
- Оптимизировать карточки товаров в POS-терминале
- Рефакторинг моделей единиц измерения
- Миграция unit -> base_unit в SalesUnit
- Улучшить UI форм создания/редактирования товаров

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.claude/settings.local.json

@@ -1,13 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(dir /b /s settings.py)",
-      "Bash(git add:*)",
-      "Bash(..venvScriptspython.exe manage.py check)",
-      "Bash(python:*)",
-      "Bash(dir:*)"
-    ],
-    "deny": [],
-    "ask": []
-  }
-}

.claude_notes.md

@@ -1,99 +0,0 @@
-# Claude Notes - Test Qwen Project
-
-## Важные команды для этого проекта
-
-### Django Management Commands
-
-```bash
-# Проверка Django проекта (БЕЗ ошибок с путями!)
-cd /c/Users/team_/Desktop/test_qwen/myproject && ../venv/Scripts/python.exe manage.py check
-
-# Запуск сервера разработки
-cd /c/Users/team_/Desktop/test_qwen/myproject && ../venv/Scripts/python.exe manage.py runserver
-
-# Создание миграций
-cd /c/Users/team_/Desktop/test_qwen/myproject && ../venv/Scripts/python.exe manage.py makemigrations
-
-# Применение миграций
-cd /c/Users/team_/Desktop/test_qwen/myproject && ../venv/Scripts/python.exe manage.py migrate
-
-# Создание суперпользователя
-cd /c/Users/team_/Desktop/test_qwen/myproject && ../venv/Scripts/python.exe manage.py createsuperuser
-```
-
-## Структура проекта
-
-- **Корень проекта:** `c:\Users\team_\Desktop\test_qwen\`
-- **Django проект:** `c:\Users\team_\Desktop\test_qwen\myproject\`
-- **Virtual environment:** `c:\Users\team_\Desktop\test_qwen\venv\`
-
-## Особенности
-
-- Проект работает на Windows
-- Используется Git Bash, поэтому пути в Unix-стиле: `/c/Users/...`
-- Python из venv: `../venv/Scripts/python.exe` (относительно myproject/)
-
-## Недавние изменения
-
-### 2025-10-22: Система хранения и отображения изображений v1.0 ✅
-
-**Frontend интеграция:**
-- `all_products_list.html` - миниатюры (150x150, 438B)
-- `product_detail.html` - сетка миниатюр + модальное окно с большим (800x800, 5.6K)
-- `productkit_detail.html` - средний размер в сайдбаре (400x400, 2.9K) + модальное окно с большим
-- `category_detail.html` - средний размер (400x400, 2.9K)
-- Все списки используют миниатюры для быстрой загрузки
-
-**Примеры использования в шаблонах:**
-```django
-{{ photo.get_thumbnail_url }}  # для списков (150x150, 438B)
-{{ photo.get_medium_url }}     # для карточек (400x400, 2.9K)
-{{ photo.get_large_url }}      # для галерей (800x800, 5.6K)
-{{ photo.get_original_url }}   # для оригинала (full quality)
-```
-
-**Результаты:**
-- 93% экономия трафика для миниатюр
-- 12× быстрее загрузка списков товаров
-- Полная автоматизация создания размеров
-
-**Документация:**
-- `FRONTEND_IMAGES_GUIDE.md` - полное руководство для фронтенда
-
-### 2025-10-22: Система хранения изображений v1.0 (Backend) ✅
-Полностью реализована и протестирована система автоматической обработки изображений:
-
-**Что создано:**
-- `products/utils/image_processor.py` - обработка и создание размеров
-- `products/utils/image_service.py` - получение URL нужного размера
-- Обновлены модели: ProductPhoto, ProductKitPhoto, ProductCategoryPhoto
-- Management команда: `python manage.py process_images`
-- Админка с превью всех 4 версий изображения
-
-**Особенности:**
-- 4 автоматических размера: thumbnail (150x150), medium (400x400), large (800x800), original
-- Структурированное хранилище: media/products/originals/, media/products/thumbnails/, и т.д.
-- Методы в моделях: `photo.get_thumbnail_url()`, `photo.get_medium_url()`, и т.д.
-- 90% экономия размера для миниатюр
-
-**API в шаблонах:**
-```django
-{{ photo.get_thumbnail_url }}  # для списков (150x150, 438B)
-{{ photo.get_medium_url }}     # для карточек (400x400, 2.9K)
-{{ photo.get_large_url }}      # для просмотра (800x800, 5.6K)
-{{ photo.get_original_url }}   # оригинал (full quality, 6.1K)
-```
-
-**Документация:**
-- `IMAGE_STORAGE_STRATEGY.md` - полная документация
-- `QUICK_START_IMAGES.md` - быстрый старт
-- `IMAGE_SYSTEM_EXAMPLES.md` - примеры кода
-
-### 2025-10-22: Переделка навигации
-- Обновлена шапка с 4 ссылками: Товары, Заказы, Клиенты, Касса
-- Создан объединённый view `CombinedProductListView` для товаров и комплектов
-- Добавлен компонент быстрых фильтров по категориям
-- URL структура:
-  - `/` → все товары и комплекты
-  - `/products/` → только товары поштучно
-  - `/kits/` → только комплекты

.dockerignore

@@ -0,0 +1,57 @@
+# Git
+.git
+.gitignore
+
+# Python
+__pycache__
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info
+.eggs
+dist
+build
+*.egg
+
+# Virtual environment
+venv
+.venv
+env
+.env.local
+
+# IDE
+.vscode
+.idea
+*.swp
+*.swo
+
+# Tests
+.pytest_cache
+.coverage
+htmlcov
+
+# Documentation
+*.md
+docs/
+
+# Local files
+*.log
+*.sqlite3
+db.sqlite3
+
+# Media and static (монтируются как volumes)
+myproject/media/*
+myproject/staticfiles/*
+
+# Temporary files
+*.tmp
+*.temp
+.DS_Store
+Thumbs.db
+
+# Windows batch files
+*.bat
+
+# Keep important config files
+!myproject/.env.example

.gitattributes

@@ -0,0 +1,5 @@
+# Ensure consistent line endings for Docker/Linux compatibility
+*.sh text eol=lf
+Dockerfile text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf

.gitignore

@@ -19,10 +19,16 @@ db.sqlite3-journal
 media/
 staticfiles/
 
+# Celery Beat schedule database
+celerybeat-schedule
+celerybeat-schedule-shm
+celerybeat-schedule-wal
+
 # Environment variables
 .env
 .env.local
 *.env
+docker/.env.docker
 
 # IDE
 .vscode/
@@ -31,6 +37,9 @@ staticfiles/
 *.swo
 *~
 
+# Claude Code
+.claude/settings.local.json
+
 # OS
 .DS_Store
 Thumbs.db
@@ -66,3 +75,23 @@ IMPLEMENTATION_SUMMARY.md
 FINAL_REPORT.md
 start_celery.bat
 start_celery.sh
+
+# All markdown files
+*.md
+
+# Customer export files
+customers_*.xlsx
+customers_*.csv
+
+# Root-level maintenance scripts (temporary fixes, diagnostics)
+/check_*.py
+/cleanup_*.py
+/fix_*.py
+
+# Personal notes and guides
+cleanup_commands.txt
+*ГИД*
+*гид*
+
+# Windows batch files
+*.bat

ADJUSTMENT_VALUE_FIX_TESTING.md

@@ -1,265 +0,0 @@
-# Тестирование исправления загрузки сохранённых значений корректировки цены
-
-## Дата исправления: 2025-11-02
-## Коммит: c7bf23c
-
----
-
-## Описание проблемы (которая была исправлена)
-
-**Проблема:** Сохранённые значения корректировки цены не отображались на странице редактирования комплекта.
-- Отображались только в 1 из 10 случаев
-- Большую часть времени поля были пустыми
-- Когда отображались, то сразу затирались какой-то переинициализацией
-
-**URL для воспроизведения:** `http://grach.localhost:8000/products/kits/4/update/`
-
-**Корневая причина:**
-1. При загрузке значений в input-поля срабатывают события `input` и `change`
-2. Эти события вызывают `calculateFinalPrice()` и `validateSingleAdjustment()`
-3. Функция `calculateFinalPrice()` перезаписывает скрытые поля (`id_price_adjustment_type`, `id_price_adjustment_value`) со значениями по умолчанию
-4. Получается race condition: значения загружаются → события срабатывают → значения стираются
-
----
-
-## Что было исправлено
-
-### Решение: Два уровня защиты от перезаписи
-
-**Уровень 1: Флаг `isLoadingAdjustmentValues`**
-- Подавляет события `input` и `change` во время загрузки значений
-- Код видит эти события, но пропускает обработку
-- Логирует в консоль: "Skipping event during adjustment value loading"
-
-**Уровень 2: Флаг `isInitializing`**
-- Даже если событие обработается, `calculateFinalPrice()` не перезапишет скрытые поля
-- Проверка: `if (!isInitializing) { adjustmentTypeInput.value = ...; }`
-
-**Уровень 3: `requestAnimationFrame`**
-- Гарантирует что `isInitializing = false` устанавливается в конце frame
-- Синхронизация с браузерным rendering cycle
-
-### Файлы изменены
-
-**`productkit_edit.html`** (строки 435, 683-696, 912-935)
-```javascript
-// Строка 435: Добавлен новый флаг
-let isLoadingAdjustmentValues = false;
-
-// Строки 683-696: Добавлена проверка в event listeners
-input.addEventListener('input', () => {
-    if (isLoadingAdjustmentValues) {
-        console.log('Skipping event during adjustment value loading');
-        return;
-    }
-    validateSingleAdjustment();
-    calculateFinalPrice();
-});
-
-// Строки 912-935: Используется флаг во время загрузки значений
-isLoadingAdjustmentValues = true;
-console.log('isLoadingAdjustmentValues = true, suppressing input/change events');
-
-// Загрузка значений
-// ...
-
-isLoadingAdjustmentValues = false;
-console.log('isLoadingAdjustmentValues = false, events are enabled again');
-```
-
----
-
-## Как тестировать исправление
-
-### Тестовые данные
-Используются комплекты в тенанте "grach":
-- **Kit #4:** "Комплект Роза" с корректировкой `increase_percent: 10.00`
-- **Kit #2:** "Комплект белые розы" с корректировкой `increase_amount: 5.00`
-
-### Сценарий 1: Проверка отображения на странице редактирования (10 раз)
-
-**Цель:** Убедиться что значение отображается ВСЕГДА, а не 1 раз из 10
-
-**Шаги:**
-1. Открыть http://grach.localhost:8000/products/kits/4/update/
-2. Нажать Ctrl+F5 (очистить кэш и перезагрузить)
-3. Найти блок "НА СКОЛЬКО БЫЛА ИЗМЕНЕНА ЦЕНА"
-4. Должно отображаться: поле "Увеличить на %" с значением **10**
-5. Повторить шаги 2-4 ещё 9 раз (всего 10 раз)
-
-**Ожидаемый результат:** 10/10 раз значение 10 отображается в поле
-
-**Признаки успеха:**
-- ✅ Поле не пустое
-- ✅ Значение = 10
-- ✅ Остальные 3 поля (Увеличить на сумму, Уменьшить на %, Уменьшить на сумму) - отключены (disabled)
-- ✅ Они помечены серым цветом (не активны)
-
-### Сценарий 2: Проверка логирования в консоли браузера
-
-**Цель:** Убедиться что логирование показывает правильный порядок выполнения
-
-**Шаги:**
-1. Открыть http://grach.localhost:8000/products/kits/4/update/
-2. Нажать F12 (открыть DevTools)
-3. Перейти на вкладку **Console**
-4. Нажать Ctrl+F5
-5. В консоли должны появиться логи (отсортировать по времени вверх):
-
-**Ожидаемые логи (в таком порядке):**
-```
-Loading saved adjustment values: {type: 'increase_percent', value: 10}
-isLoadingAdjustmentValues = true, suppressing input/change events
-Loaded increase_percent: 10
-isLoadingAdjustmentValues = false, events are enabled again
-calculateFinalPrice: calculating...
-[несколько логов о расчётах цен]
-Initialization complete, isInitializing = false
-```
-
-**Признаки успеха:**
-- ✅ `isLoadingAdjustmentValues = true` появляется ДО загрузки значений
-- ✅ `Loaded increase_percent: 10` показывает что значение загружено
-- ✅ `isLoadingAdjustmentValues = false` появляется ПОСЛЕ загрузки
-- ✅ `Initialization complete` появляется в конце
-- ✅ Нет ошибок в консоли (красных сообщений)
-
-### Сценарий 3: Проверка редактирования корректировки
-
-**Цель:** Убедиться что можно изменить значение и оно сохраняется
-
-**Шаги:**
-1. Открыть http://grach.localhost:8000/products/kits/4/update/
-2. В поле "Увеличить на %" изменить значение с 10 на 15
-3. Нажать кнопку "Сохранить"
-4. Открыть страницу редактирования снова (F5)
-5. Проверить что значение = 15
-
-**Ожидаемый результат:**
-- ✅ Значение измененo на 15
-- ✅ Сохранилось в БД
-- ✅ При перезагрузке отображается 15
-
-### Сценарий 4: Проверка другого комплекта (с decrease_percent)
-
-**Цель:** Убедиться что исправление работает для всех 4 типов корректировки
-
-**Шаги:**
-1. Создать новый комплект
-2. Добавить товар
-3. В блоке "НА СКОЛЬКО БЫЛА ИЗМЕНЕНА ЦЕНА" выбрать "Уменьшить на %" и ввести 20
-4. Сохранить
-5. Открыть для редактирования
-6. Проверить что "Уменьшить на %" = 20
-7. Повторить 5 раз
-
-**Ожидаемый результат:** 5/5 раз значение отображается правильно
-
----
-
-## Что смотреть в консоли браузера (для отладки)
-
-**F12 → Console → Filter (Фильтр)**
-
-Полезные логи:
-```javascript
-// Загрузка сохранённых значений
-"Loading saved adjustment values:"
-"isLoadingAdjustmentValues = true"
-"Loaded increase_percent: 10"
-"isLoadingAdjustmentValues = false"
-
-// События которые подавляются
-"Skipping event during adjustment value loading"
-
-// Инициализация завершена
-"Initialization complete, isInitializing = false"
-```
-
-**Если видите эти логи в консоли - значит исправление работает правильно.**
-
----
-
-## Возможные проблемы и решения
-
-### Проблема: Значение всё ещё не отображается
-**Решение:**
-1. Откройте консоль (F12)
-2. Проверьте логи - есть ли ошибки?
-3. Проверьте что комплект в БД имеет значение `price_adjustment_value` > 0
-4. Очистите браузерный кэш (Ctrl+Shift+Delete)
-5. Нажмите Ctrl+F5 на странице редактирования
-
-### Проблема: Логи не появляются
-**Решение:**
-1. Проверьте что консоль не отфильтрована (нет активного фильтра)
-2. Нажмите Ctrl+F5 (hard refresh)
-3. Проверьте что в productkit_edit.html есть код с логами (смотрите коммит c7bf23c)
-
-### Проблема: Значение загружается но потом исчезает
-**Решение:**
-1. Это была исходная проблема
-2. Если она всё ещё есть - значит исправление не развернулось
-3. Проверьте git статус: `git log -1`
-4. Должен быть коммит "c7bf23c fix: Улучшить загрузку сохранённых значений"
-5. Если коммита нет - обновите файл productkit_edit.html вручную
-
----
-
-## Результаты тестирования
-
-Заполните после выполнения тестов:
-
-| Сценарий | Попыток | Успешных | Результат |
-|----------|---------|----------|-----------|
-| 1. Отображение (10 раз) | 10 | __/10 | ✅ / ❌ |
-| 2. Логирование | 1 | __/1 | ✅ / ❌ |
-| 3. Редактирование | 1 | __/1 | ✅ / ❌ |
-| 4. Другой тип коррекции | 5 | __/5 | ✅ / ❌ |
-
-**Итоговый результат:** ✅ ПРОЙДЕНО / ❌ НЕ ПРОЙДЕНО
-
----
-
-## Архитектура исправления
-
-```
-Загрузка страницы редактирования
-    ↓
-1. DOMContentLoaded срабатывает
-    ↓
-2. Инициализация переменных
-    - isInitializing = true
-    - isLoadingAdjustmentValues = false
-    - priceCache = {}
-    ↓
-3. Регистрация event listeners (с проверкой isLoadingAdjustmentValues)
-    ↓
-4. setTimeout 500ms → Загрузка сохранённых значений
-    ↓
-5a. Устанавливаем isLoadingAdjustmentValues = true
-5b. Заполняем поля (input события ПОДАВЛЯЮТСЯ благодаря флагу)
-5c. Вызываем validateSingleAdjustment()
-5d. Устанавливаем isLoadingAdjustmentValues = false
-    ↓
-6. calculateFinalPrice() с isInitializing = true
-   (не перезапишет скрытые поля даже если они обновятся)
-    ↓
-7. requestAnimationFrame × 2 → isInitializing = false
-   (в конце frame cycle, после всех events)
-    ↓
-8. ГОТОВО: значения загружены, события обрабатываются, скрытые поля защищены
-```
-
----
-
-## Заключение
-
-Исправление использует трёхуровневую защиту:
-1. **Подавление событий** (isLoadingAdjustmentValues) во время загрузки
-2. **Защита скрытых полей** (isInitializing) от перезаписи
-3. **Синхронизация с браузером** (requestAnimationFrame) для надёжности
-
-Это должно полностью исправить проблему с надёжностью загрузки сохранённых значений корректировки цены.
-
-🎉 **Готово к тестированию!**

BUG_FIX_PHOTO_COLLISION.md

@@ -1,90 +0,0 @@
-# Исправление бага: Подмена фотографий при загрузке
-
-## Проблема
-При загрузке новой фотографии к товару она подменялась другой уже существующей фотографией. Пользователь загружал одно фото, но в БД и на сайте появлялось совершенно другое.
-
-## Причина
-
-**Корневая причина**: Коллизия имен файлов при сохранении фотографий.
-
-### Как это происходило:
-
-1. Система сохраняет фотографии по структуре: `products/{entity_id}/{photo_id}/{размер}.{расширение}`
-   - Пример: `products/2/7/original.jpg`, `products/2/7/large.webp`, и т.д.
-
-2. Когда нужно перезаписать фотографию (при обновлении), Django обнаруживает что файл уже существует
-
-3. Вместо замены, Django добавляет суффикс коллизии к имени файла:
-   - Ожидается: `products/2/3/original.jpg`
-   - Реально сохраняется: `products/2/3/original_LxC9yjS.jpg` ← с суффиксом
-
-4. **ПРОБЛЕМА**: В БД сохраняется путь БЕЗ суффикса (`products/2/3/original.jpg`), но физически файл находится в другом месте (`products/2/3/original_LxC9yjS.jpg`)
-
-5. Когда шаблон запрашивает `{{ photo.image.url }}`, Django ищет файл `products/2/3/original.jpg`, не находит его, и возвращает путь по умолчанию или другую доступную фотографию.
-
-## Решение
-
-### Шаг 1: Обновлен `image_processor.py`
-
-В методе `_save_image_version()` добавлена проверка и удаление старого файла ПЕРЕД сохранением нового:
-
-```python
-# ВАЖНО: Удаляем старый файл если он существует, чтобы избежать коллизий имен
-if default_storage.exists(file_path):
-    try:
-        default_storage.delete(file_path)
-        logger.info(f"Deleted old file: {file_path}")
-    except Exception as e:
-        logger.warning(f"Could not delete old file {file_path}: {str(e)}")
-```
-
-Это гарантирует что:
-- Старый файл удаляется перед сохранением нового
-- Django не встречает коллизию имен
-- Путь в БД совпадает с реальным расположением файла на диске
-
-### Шаг 2: Очистка старых данных
-
-Создан и запущен скрипт `cleanup_media.py` который:
-- Удалил все старые файлы с суффиксами коллизии (`original_b374WLW.jpg`, `large_lmCnBYn.webp` и т.д.)
-- Удалил старые файлы из папки `products/originals/` (старая схема хранения)
-
-**Результат**: Успешно удалено 6 устаревших файлов
-
-## Файлы, измененные
-
-1. **myproject/products/utils/image_processor.py**
-   - Добавлена проверка и удаление старого файла перед сохранением нового
-   - Добавлено логирование коллизий имен
-
-2. **myproject/products/management/commands/cleanup_photo_media.py**
-   - Создана management команда для очистки старых файлов (опционально)
-
-3. **cleanup_media.py** (в корне проекта)
-   - Создан скрипт для ручной очистки старых данных
-
-## Как проверить исправление
-
-1. Откройте товар с ID 2 (или любой другой товар)
-2. Попробуйте загрузить новое фото
-3. При сохранении фото должно правильно отобразиться
-4. В папке `myproject/media/products/` не должно быть файлов с суффиксами вроде `_b374WLW`, `_LxC9yjS` и т.д.
-
-## Технические детали
-
-- **Файлы с коллизией**: Django использует функцию `storage.save()` которая добавляет суффикс если файл существует
-- **Суффикс коллизии**: 8 случайных буквенно-цифровых символов вроде `_b374WLW`
-- **Старые файлы**: Имели паттерн `{название}_{timestamp}_original.jpg` (из старой системы)
-
-## Результаты
-
-✓ Исправлено ошибочное сохранение путей в БД
-✓ Удалены все старые файлы с коллизией имен
-✓ Добавлена проверка при сохранении новых фотографий
-✓ Добавлено логирование для отладки будущих проблем с коллизиями
-
-## Рекомендации
-
-1. Периодически проверяйте папку `myproject/media/` на наличие файлов с суффиксами
-2. Можно добавить периодическую очистку через Celery или cron
-3. В продакшене рекомендуется использовать облачное хранилище (S3 и т.д.) которое лучше справляется с коллизиями имен

CARD_INTERFACE_COMPLETION.md

@@ -1,335 +0,0 @@
-# Card-Based Attribute Interface - Completion Report
-
-## Status: ✅ COMPLETE
-
-Успешно реализован карточный интерфейс для управления атрибутами вариативных товаров (ConfigurableKitProduct).
-
----
-
-## 📋 Что было сделано
-
-### 1. ✅ Обновлена Форма ([products/forms.py](myproject/products/forms.py))
-
-**ConfigurableKitProductAttributeForm**:
-- Убрано поле `option` (теперь добавляется через JavaScript)
-- Оставлены поля: `name`, `position`, `visible`
-- Добавлены CSS классы для JavaScript селекторов
-
-**BaseConfigurableKitProductAttributeFormSet**:
-- Обновлена валидация для карточной структуры
-- Проверка на дубликаты параметров (каждый параметр один раз)
-- Выявление пустых карточек
-
-**Формсеты**:
-- `ConfigurableKitProductAttributeFormSetCreate`: поля = `['name', 'position', 'visible']`
-- `ConfigurableKitProductAttributeFormSetUpdate`: поля = `['name', 'position', 'visible']`
-
-### 2. ✅ Переделан Шаблон ([products/templates/products/configurablekit_form.html](myproject/products/templates/products/configurablekit_form.html))
-
-**Новая структура**:
-```
-┌─ Параметр: Длина ────────────────┐
-│ Позиция: 0                       │
-│ Видимый: ✓                       │
-│ ────────────────────────────────│
-│ Значения:                        │
-│ [50] ✕  [60] ✕  [70] ✕           │
-│ [+ Добавить значение]            │
-└──────────────────────────────────┘
-```
-
-**Компоненты**:
-- Карточка для каждого параметра (`.attribute-card`)
-- Поля параметра вверху карточки
-- Контейнер значений с инлайн инпутами (`.value-fields-wrapper`)
-- Кнопка "Добавить значение" для инлайн добавления
-- Кнопка "Добавить параметр" для создания новых карточек
-- Удаление через чекбокс DELETE
-
-### 3. ✅ Добавлен JavaScript ([configurablekit_form.html lines 464-646](myproject/products/templates/products/configurablekit_form.html#L464-L646))
-
-**Основные функции**:
-
-1. **addValueField(container, valueText)**
-   - Добавляет новое поле значения в контейнер
-   - Генерирует уникальный ID для каждого значения
-   - Добавляет кнопку удаления
-
-2. **initializeParameterCards()**
-   - Инициализирует все карточки при загрузке
-   - Подключает обработчики событий
-
-3. **initAddValueBtn(card)**
-   - Инициализирует кнопку "Добавить значение" для карточки
-   - Вызывает addValueField при клике
-
-4. **addParameterBtn listener**
-   - Создает новую карточку параметра с правильными индексами
-   - Инициализирует новую карточку
-   - Обновляет TOTAL_FORMS счетчик
-
-5. **initParamDeleteToggle(card)**
-   - Скрывает карточку при отметке DELETE
-   - Восстанавливает при снятии отметки
-
-6. **serializeAttributeValues()**
-   - Читает все значения из инлайн инпутов (`.parameter-value-input`)
-   - Создает JSON массив значений для каждого параметра
-   - Сохраняет в скрытые поля: `attributes-X-values`
-
-7. **Form submission handler**
-   - Перед отправкой вызывает `serializeAttributeValues()`
-   - Гарантирует что все значения отправляются в POST
-
-### 4. ✅ Обновлены Views ([products/views/configurablekit_views.py](myproject/products/views/configurablekit_views.py))
-
-**ConfigurableKitProductCreateView**:
-- Добавлен метод `_save_attributes_from_cards()`
-- В `form_valid()` вызывает `_save_attributes_from_cards()` вместо сохранения formset
-
-**ConfigurableKitProductUpdateView**:
-- Добавлен метод `_save_attributes_from_cards()` (копия)
-- В `form_valid()` вызывает `_save_attributes_from_cards()` вместо сохранения formset
-
-**Логика сохранения**:
-```python
-def _save_attributes_from_cards(self):
-    # 1. Удаляем все старые атрибуты
-    # 2. Итерируем по количеству карточек (attributes-TOTAL_FORMS)
-    # 3. Для каждой карточки:
-    #    - Читаем: name, position, visible, DELETE
-    #    - Читаем JSON значения из attributes-X-values
-    #    - Пропускаем если помечена для удаления
-    #    - Создаем ConfigurableKitProductAttribute для каждого значения
-```
-
----
-
-## 🎨 Новый Интерфейс
-
-### До (Строки):
-```
-┌─────────────────────────────────────┐
-│ Название | Значение | Позиция | ❌ │
-├─────────────────────────────────────┤
-│ Длина    | 50       | 0       | ❌ │
-│ Длина    | 60       | 0       | ❌ │
-│ Длина    | 70       | 0       | ❌ │
-│ Упаковка | БЕЗ      | 1       | ❌ │
-│ Упаковка | В УП     | 1       | ❌ │
-└─────────────────────────────────────┘
-+ Добавить атрибут
-```
-
-### После (Карточки):
-```
-┌─ Длина ─────────────────────────────┐
-│ Позиция: 0  │ Видимый: ✓ │ ❌     │
-│─────────────────────────────────────│
-│ Значения: [50] ✕ [60] ✕ [70] ✕    │
-│ [+ Добавить значение]               │
-└─────────────────────────────────────┘
-
-┌─ Упаковка ──────────────────────────┐
-│ Позиция: 1  │ Видимый: ✓ │ ❌     │
-│─────────────────────────────────────│
-│ Значения: [БЕЗ] ✕ [В УП] ✕        │
-│ [+ Добавить значение]               │
-└─────────────────────────────────────┘
-
-[+ Добавить параметр]
-```
-
----
-
-## 🔄 Поток Данных
-
-### Создание товара с атрибутами:
-
-1. **Пользователь вводит**:
-   - Название товара
-   - Параметр 1: "Длина" → Значения: 50, 60, 70
-   - Параметр 2: "Упаковка" → Значения: БЕЗ, В УПАКОВКЕ
-
-2. **JavaScript сериализует**:
-   ```
-   attributes-0-name = "Длина"
-   attributes-0-position = "0"
-   attributes-0-visible = "on"
-   attributes-0-values = ["50", "60", "70"]   ← JSON array!
-
-   attributes-1-name = "Упаковка"
-   attributes-1-position = "1"
-   attributes-1-visible = "on"
-   attributes-1-values = ["БЕЗ", "В УПАКОВКЕ"]  ← JSON array!
-   ```
-
-3. **View обрабатывает**:
-   ```python
-   for idx in range(total_forms):
-       name = request.POST.get(f'attributes-{idx}-name')
-       values_json = request.POST.get(f'attributes-{idx}-values')
-       values = json.loads(values_json)  # ["50", "60", "70"]
-
-       # Создает по одному объекту на каждое значение:
-       for value in values:
-           ConfigurableKitProductAttribute.create(
-               parent=product,
-               name=name,
-               option=value,
-               position=position,
-               visible=visible
-           )
-   ```
-
-4. **В БД сохраняется**:
-   ```
-   ConfigurableKitProduct: {name: "Товар", sku: "SKU"}
-   ├── ConfigurableKitProductAttribute (Длина, 50)
-   ├── ConfigurableKitProductAttribute (Длина, 60)
-   ├── ConfigurableKitProductAttribute (Длина, 70)
-   ├── ConfigurableKitProductAttribute (Упаковка, БЕЗ)
-   └── ConfigurableKitProductAttribute (Упаковка, В УПАКОВКЕ)
-   ```
-
----
-
-## ✨ Преимущества Новой Архитектуры
-
-### Для пользователя:
-- ✅ Один раз вводит название параметра (не в каждой строке)
-- ✅ Быстрее добавлять значения (инлайн, без перезагрузки)
-- ✅ Очищает интуитивнее (карточки вместо множества строк)
-- ✅ Визуально разделены параметры и их значения
-- ✅ Легче управлять большим количеством параметров
-
-### Для разработчика:
-- ✅ Чистая структура данных в БД (не изменилась)
-- ✅ Модели остаются той же (ConfigurableKitProductAttribute)
-- ✅ Логика обработки четкая и понятная
-- ✅ JSON сериализация безопасна (используется json.loads)
-- ✅ Масштабируемо на сотни параметров
-
----
-
-## 🧪 Тестирование
-
-### Проведено:
-- ✅ test_card_interface.py - проверка структуры данных
-- ✅ Python синтаксис проверен и валидирован
-- ✅ JavaScript логика протестирована
-
-### Результаты:
-```
-[1] Creating test product...
-    OK: Created product: Card Test Product
-
-[2] Creating attributes (simulating card interface)...
-    OK: Created parameter 'Dlina' with 3 values: 50, 60, 70
-    OK: Created parameter 'Upakovka' with 2 values: BEZ, V_UPAKOVKE
-
-[3] Verifying attribute structure...
-    OK: Found 2 unique parameters
-    OK: All assertions passed!
-
-[4] Testing data retrieval...
-    OK: Retrieved attribute: Dlina = 50
-    OK: Can order by position and name
-
-OK: CARD INTERFACE TEST PASSED!
-```
-
----
-
-## 📁 Измененные Файлы
-
-```
-✅ myproject/products/forms.py
-   - ConfigurableKitProductAttributeForm (переделана)
-   - BaseConfigurableKitProductAttributeFormSet (обновлена)
-   - ConfigurableKitProductAttributeFormSetCreate/Update (поля обновлены)
-
-✅ myproject/products/templates/products/configurablekit_form.html
-   - Секция атрибутов (строки → карточки)
-   - JavaScript (новые функции для управления)
-
-✅ myproject/products/views/configurablekit_views.py
-   - ConfigurableKitProductCreateView._save_attributes_from_cards()
-   - ConfigurableKitProductUpdateView._save_attributes_from_cards()
-   - form_valid() обновлены в обеих Views
-
-✅ Новый тест: myproject/test_card_interface.py
-```
-
----
-
-## 🚀 Как Использовать
-
-### Создание вариативного товара с новым интерфейсом:
-
-1. Откройте `/products/configurable-kits/create/`
-2. Заполните название товара
-3. В секции "Параметры товара":
-   - Введите название параметра (например, "Длина")
-   - Установите позицию и видимость
-   - Нажимайте "Добавить значение" для каждого значения
-   - Повторите для других параметров
-4. Создавайте варианты в секции ниже
-5. Сохраните
-
----
-
-## 🐛 Известные Особенности
-
-1. **JavaScript требует**: Используется ES6 (const, arrow functions)
-2. **Браузерная совместимость**: IE11 не поддерживается (используется ES6)
-3. **JSON сериализация**: Безопасна, используется встроенный JSON.stringify/parse
-4. **Позиция параметра**: Одна для всех значений (правильно для группировки)
-
----
-
-## 📊 Статистика Изменений
-
-```
-Строк кода добавлено: ~500
-Строк кода удалено: ~200
-Сложность снижена: Да (формы упрощены)
-Производительность: Не изменилась (БД запросы те же)
-Тесты добавлены: 1 (test_card_interface.py)
-```
-
----
-
-## ✅ Чек-лист
-
-- [x] Форма переделана
-- [x] Шаблон обновлен
-- [x] JavaScript написан
-- [x] Views обновлены
-- [x] Сериализация реализована
-- [x] Тесты написаны и пройдены
-- [x] Синтаксис проверен
-- [x] Коммит создан
-- [x] Документация написана
-
----
-
-## 📝 Итоговый Комментарий
-
-Реализован полностью функциональный карточный интерфейс для управления атрибутами вариативных товаров.
-
-**Ключевая особенность**: Пользователь вводит название параметра один раз, а затем добавляет столько значений, сколько нужно, через инлайн кнопки.
-
-**Как это работает**:
-1. JavaScript читает все значения из инлайн инпутов
-2. Сохраняет их в JSON формате перед отправкой
-3. View парсит JSON и создает отдельные объекты в БД
-
-**БД структура не изменилась**, используется та же ConfigurableKitProductAttribute модель.
-
----
-
-**Date**: November 18, 2025
-**Status**: Production Ready ✅
-
-🤖 Generated with Claude Code

COMPLETION_SUMMARY.md

@@ -1,232 +0,0 @@
-# ConfigurableKitProduct Implementation - Completion Summary
-
-## Status: ✅ COMPLETE
-
-All tasks for implementing the M2M architecture for variable products have been successfully completed and tested.
-
----
-
-## Work Completed
-
-### 1. ✅ Database Model Architecture
-- **New Model**: `ConfigurableKitOptionAttribute`
-  - M2M relationship between variants and attribute values
-  - Unique constraint: one value per attribute per variant
-  - Proper indexing on both fields
-- **Migration**: `0006_add_configurablekitoptionattribute.py`
-  - Successfully created and applied
-  - Database schema updated
-
-### 2. ✅ Form Refactoring
-- **ConfigurableKitOptionForm**
-  - Removed static 'attributes' field
-  - Added dynamic field generation in `__init__`
-  - Creates ModelChoiceField for each parent attribute
-  - Pre-fills current values when editing
-- **BaseConfigurableKitOptionFormSet**
-  - Enhanced validation to check all attributes are filled
-  - Validates no duplicate kits
-  - Validates only one default variant
-  - Provides clear error messages per variant
-
-### 3. ✅ View Implementation
-- **ConfigurableKitProductCreateView**
-  - Updated `form_valid()` to save M2M relationships
-  - Creates ConfigurableKitOptionAttribute records
-  - Uses atomic transaction for consistency
-- **ConfigurableKitProductUpdateView**
-  - Same implementation as Create view
-  - Properly handles attribute updates
-
-### 4. ✅ Template & UI
-- **Template Fixes**
-  - Fixed syntax error: changed to proper `in` operator
-  - Reordered sections: Attributes before Variants
-  - Dynamic attribute select rendering
-- **JavaScript Enhancement**
-  - Dynamic form generation when adding variants
-  - Proper formset naming conventions
-  - Copies attribute structure from first form
-
-### 5. ✅ Testing & Validation
-- **Test Scripts Created**
-  - `test_configurable_simple.py` - Model/form verification
-  - `test_workflow.py` - Complete end-to-end workflow
-- **All Tests Passing**: ✅ Verified
-  - Model relationships work correctly
-  - M2M data persists and retrieves properly
-  - Forms generate dynamic fields correctly
-  - Views import and integrate properly
-
-### 6. ✅ Documentation
-- `CONFIGURABLEKIT_IMPLEMENTATION_SUMMARY.md` - Technical details
-- `TESTING_GUIDE.md` - Complete manual testing guide
-- `COMPLETION_SUMMARY.md` - This file
-
----
-
-## Code Changes Summary
-
-### Modified Files
-```
-myproject/products/models/kits.py
-  - Added ConfigurableKitOptionAttribute model (40+ lines)
-
-myproject/products/forms.py
-  - Refactored ConfigurableKitOptionForm (47 new lines)
-  - Enhanced BaseConfigurableKitOptionFormSet (30+ new lines)
-  - Total: +70 lines of validation and dynamic field generation
-
-myproject/products/views/configurablekit_views.py
-  - Updated ConfigurableKitProductCreateView.form_valid()
-  - Updated ConfigurableKitProductUpdateView.form_valid()
-  - Added ConfigurableKitOptionAttribute creation logic
-
-myproject/products/templates/products/configurablekit_form.html
-  - Fixed template syntax error
-  - Reordered form sections
-  - Updated JavaScript for dynamic form generation
-```
-
-### New Files
-```
-myproject/products/migrations/0005_alter_configurablekitoption_attributes.py
-myproject/products/migrations/0006_add_configurablekitoptionattribute.py
-myproject/test_configurable_simple.py
-myproject/test_workflow.py
-CONFIGURABLEKIT_IMPLEMENTATION_SUMMARY.md
-TESTING_GUIDE.md
-```
-
----
-
-## Key Features Implemented
-
-✅ **M2M Architecture**
-- Clean separation between attribute definitions and variant bindings
-- Proper database relationships with constraints
-
-✅ **Dynamic Form Generation**
-- Fields created based on parent product attributes
-- Works in both create and edit modes
-- Pre-filled values when editing
-
-✅ **Comprehensive Validation**
-- All attributes required for each variant
-- No duplicate kits in single product
-- Only one default variant per product
-- Clear error messages for each issue
-
-✅ **User Experience**
-- Attributes section appears before variants
-- Dynamic variant addition with all required fields
-- Visual feedback for deleted variants
-- Delete button for easy variant removal
-
-✅ **Data Consistency**
-- Atomic transactions for multi-part saves
-- Proper handling of partial updates
-- Correct M2M relationship cleanup
-
----
-
-## Testing Status
-
-### Automated Tests
-- ✅ `test_configurable_simple.py` - PASSED
-- ✅ `test_workflow.py` - PASSED
-
-### Manual Testing
-Ready for full workflow testing following `TESTING_GUIDE.md`
-
-### Test Coverage
-- Model creation and retrieval
-- M2M relationship operations
-- Dynamic form field generation
-- Form validation logic
-- View integration
-- Template syntax
-
----
-
-## How to Use
-
-### For Testing
-```bash
-cd myproject
-python test_configurable_simple.py
-python test_workflow.py
-```
-
-### For Manual Testing
-Follow `TESTING_GUIDE.md` step-by-step:
-1. Create variable product at `/products/configurable-kits/create/`
-2. Define attributes with values
-3. Create variants with attribute selections
-4. Verify validation rules
-5. Test dynamic variant addition
-
-### In Production
-Simply use the admin or API to create ConfigurableKitProduct instances with:
-- Name and SKU
-- Attributes (ConfigurableKitProductAttribute)
-- Variants (ConfigurableKitOption) with M2M bindings (ConfigurableKitOptionAttribute)
-
----
-
-## Database Schema
-
-```
-ConfigurableKitProduct
-├── parent_attributes (1:M) → ConfigurableKitProductAttribute
-│   └── name, option, position, visible, parent
-│
-└── options (1:M) → ConfigurableKitOption
-    ├── kit (FK) → ProductKit
-    ├── is_default
-    └── attributes_set (M:M through ConfigurableKitOptionAttribute)
-        └── attribute (FK) → ConfigurableKitProductAttribute
-```
-
----
-
-## Known Limitations
-
-- None at this time
-- All planned features implemented
-
----
-
-## Future Enhancements
-
-Optional improvements for future consideration:
-1. Variant SKU customization per attribute combination
-2. Variant pricing adjustments
-3. Stock tracking per variant
-4. WooCommerce integration for export
-5. Bulk variant creation from attribute combinations
-
----
-
-## Git Commit
-
-All changes committed with message:
-```
-Implement M2M architecture for ConfigurableKitProduct variants with dynamic attribute selection
-```
-
-Commit hash: Available in git history
-
----
-
-## Sign-Off
-
-✅ Implementation complete
-✅ Tests passing
-✅ Documentation complete
-✅ Ready for production use
-
----
-
-**Date**: November 18, 2025
-**Status**: Production Ready

CONFIGURABLEKIT_IMPLEMENTATION_SUMMARY.md

@@ -1,177 +0,0 @@
-# ConfigurableKitProduct Implementation Summary
-
-## Overview
-Successfully implemented a complete variable product system for binding multiple ProductKits to attribute value combinations. The system allows creating variable products with attributes and dynamically selecting ProductKits for each variant.
-
-## Changes Made
-
-### 1. Database Models ([products/models/kits.py](myproject/products/models/kits.py))
-
-#### ConfigurableKitOptionAttribute Model (NEW)
-- **Purpose**: M2M relationship between ConfigurableKitOption variants and ConfigurableKitProductAttribute values
-- **Fields**:
-  - `option`: ForeignKey to ConfigurableKitOption (with related_name='attributes_set')
-  - `attribute`: ForeignKey to ConfigurableKitProductAttribute
-- **Constraints**:
-  - unique_together: ('option', 'attribute') - ensures one value per attribute per variant
-  - Indexed on both fields for query performance
-
-#### ConfigurableKitOption Model (UPDATED)
-- **Removed**: TextField for attributes (replaced with M2M)
-- **Relationship**: New reverse relation `attributes_set` through ConfigurableKitOptionAttribute
-
-### 2. Database Migrations ([products/migrations/0006_add_configurablekitoptionattribute.py](myproject/products/migrations/0006_add_configurablekitoptionattribute.py))
-
-- Created migration for ConfigurableKitOptionAttribute model
-- Applied successfully to database schema
-
-### 3. Forms ([products/forms.py](myproject/products/forms.py))
-
-#### ConfigurableKitOptionForm (REFACTORED)
-- **Removed**: 'attributes' field from Meta.fields
-- **Added**: Dynamic field generation in __init__ method
-  - Generates ModelChoiceField for each parent attribute
-  - Field names follow pattern: `attribute_{attribute_name}`
-  - For edit mode: pre-populates current attribute values
-- **Example**: If parent has "Длина" and "Упаковка" attributes:
-  - Creates `attribute_Длина` field
-  - Creates `attribute_Упаковка` field
-
-#### BaseConfigurableKitOptionFormSet (ENHANCED)
-- **Added**: Comprehensive validation in clean() method
-  - Checks for duplicate kits
-  - Validates all attributes are filled for each variant
-  - Ensures max one default variant
-  - Provides detailed error messages per variant number
-
-#### Formsets (UPDATED)
-- ConfigurableKitOptionFormSetCreate: extra=1, fields=['kit', 'is_default']
-- ConfigurableKitOptionFormSetUpdate: extra=0, fields=['kit', 'is_default']
-
-### 4. Views ([products/views/configurablekit_views.py](myproject/products/views/configurablekit_views.py))
-
-#### ConfigurableKitProductCreateView.form_valid() (UPDATED)
-- Iterates through option_formset
-- Saves ConfigurableKitOption with parent
-- Creates ConfigurableKitOptionAttribute records for each selected attribute
-- Uses transaction.atomic() for data consistency
-
-#### ConfigurableKitProductUpdateView.form_valid() (UPDATED)
-- Same logic as Create view
-- Properly deletes old attribute relationships before creating new ones
-
-### 5. Template ([products/templates/products/configurablekit_form.html](myproject/products/templates/products/configurablekit_form.html))
-
-#### Form Structure (REORDERED)
-- Attributes section now appears BEFORE variants
-- Users define attributes first, then bind ProductKits to attribute combinations
-
-#### Dynamic Attribute Display
-- Variant form rows iterate through dynamically generated attribute fields
-- Renders select dropdowns for each attribute field
-- Field names follow pattern: `options-{formIdx}-attribute_{name}`
-
-#### JavaScript Enhancement
-- addOptionBtn listener dynamically generates attribute selects
-- Clones structure from first form's attribute fields
-- Properly names new fields with correct formset indices
-
-### 6. Test Scripts (NEW)
-
-#### test_configurable_simple.py
-- Verifies models and relationships exist
-- Checks form generation
-- Validates view imports
-
-#### test_workflow.py
-- Complete end-to-end workflow test
-- Creates ConfigurableKitProduct
-- Creates attributes with multiple values
-- Creates variants with M2M attribute bindings
-- Verifies data retrieval
-
-**Test Results**: All tests PASSED ✓
-- Successfully created 3 variants with 2 attributes each
-- All data retrieved correctly through M2M relationships
-- Form validation logic intact
-
-## Usage Workflow
-
-### Step 1: Create Variable Product
-1. Go to /products/configurable-kits/create/
-2. Enter product name and SKU
-3. Define attributes in the attributes section:
-   - Attribute Name: e.g., "Длина"
-   - Attribute Values: e.g., "50", "60", "70"
-
-### Step 2: Create Variants
-1. In variants section, for each variant:
-   - Select a ProductKit
-   - Select values for each attribute
-   - Mark as default (max 1)
-2. Form validates:
-   - All attributes must be filled
-   - No duplicate kits
-   - Only one default variant
-
-### Step 3: Save
-- System creates:
-  - ConfigurableKitOption records
-  - ConfigurableKitOptionAttribute relationships
-  - All in atomic transaction
-
-## Data Structure
-
-```
-ConfigurableKitProduct (parent product)
-├── parent_attributes (ConfigurableKitProductAttribute)
-│   ├── name: "Длина", option: "50"
-│   ├── name: "Длина", option: "60"
-│   ├── name: "Упаковка", option: "БЕЗ"
-│   └── name: "Упаковка", option: "В УПАКОВКЕ"
-│
-└── options (ConfigurableKitOption - variants)
-    ├── Option 1: kit=Kit-1
-    │   └── attributes_set (ConfigurableKitOptionAttribute)
-    │       ├── attribute: Длина=50
-    │       └── attribute: Упаковка=БЕЗ
-    │
-    ├── Option 2: kit=Kit-2
-    │   └── attributes_set
-    │       ├── attribute: Длина=60
-    │       └── attribute: Упаковка=В УПАКОВКЕ
-    │
-    └── Option 3: kit=Kit-3
-        └── attributes_set
-            ├── attribute: Длина=70
-            └── attribute: Упаковка=БЕЗ
-```
-
-## Key Features
-
-✓ **M2M Architecture**: Clean separation between attribute definitions and variant bindings
-✓ **Validation**: Ensures all attributes present for each variant
-✓ **Dynamic Forms**: Attribute fields generated based on parent configuration
-✓ **Data Consistency**: Atomic transactions for multi-part operations
-✓ **User-Friendly**: Attributes section appears before variants in form
-✓ **Flexible**: Attributes can be reordered and positioned
-
-## Notes
-
-- All attributes are REQUIRED for each variant if defined on parent
-- Maximum ONE value per attribute per variant (enforced by unique_together)
-- Maximum ONE default variant per product (enforced by validation)
-- No backward compatibility with old TextField attributes (intentional - fresh start)
-- Supports any number of attributes and values
-
-## Testing
-
-Run the test scripts to verify implementation:
-
-```bash
-cd myproject
-python test_configurable_simple.py  # Basic model/form tests
-python test_workflow.py              # Full workflow test
-```
-
-Both tests should pass with "OK: ALL TESTS PASSED!" message.

DEBUG_PRICE_CALCULATION.md

@@ -1,101 +0,0 @@
-# Отладка расчёта цены комплекта
-
-## Проблема
-Первая строка (компонент) не считается в цену. При добавлении второго товара начинает считать.
-
-## Решение
-
-### Что было исправлено
-
-1. **Улучшена функция `getProductPrice()`** с добавлением:
-   - Строгой проверки валидности элемента и productId
-   - Логирования для отладки (console.log)
-   - Проверки на isNaN и productId <= 0
-
-2. **Улучшена функция `calculateFinalPrice()`** с добавлением:
-   - Проверки что товар выбран (!productSelect || !productSelect.value)
-   - Валидации количества (если quantity <= 0, использует 1)
-   - Проверки что цена > 0 перед добавлением в сумму
-
-3. **Добавлено логирование** для отладки в браузерной консоли:
-   ```javascript
-   console.log('getProductPrice: from cache', productId, cachedPrice);
-   console.log('getProductPrice: from API', productId, price);
-   console.warn('getProductPrice: returning 0 for product', productId);
-   ```
-
-### Как провести отладку
-
-1. **Откройте DevTools** в браузере (F12 или Ctrl+Shift+I)
-2. Перейдите на вкладку **Console**
-3. Добавьте первый товар на форму создания комплекта
-4. Посмотрите в Console - должны увидеть логи вида:
-   ```
-   getProductPrice: fetching from API 1
-   getProductPrice: from API 1 20.00
-   ```
-
-5. Введите количество товара
-6. Проверьте что в Console логируется `calculateFinalPrice` вызывается
-7. Убедитесь что базовая цена обновилась
-
-### Возможные проблемы и решения
-
-#### 1. "getProductPrice: no valid product id"
-**Проблема:** selectElement пуст или не имеет ID товара
-**Решение:** Убедитесь что товар действительно выбран в Select2
-
-#### 2. "getProductPrice: returning 0 for product"
-**Проблема:** Цена товара не найдена ни в одном источнике
-**Решение:**
-- Проверьте что товар имеет цену в базе данных
-- Проверьте API endpoint возвращает actual_price
-
-#### 3. Цена считается только со 2-го товара
-**Проблема:** Первая форма загружается с пустыми значениями, но JavaScript пытается считать её
-**Решение:**
-- Логика теперь пропускает пустые товары (`if (!productSelect.value) continue`)
-- Убедитесь что Вы выбираете товар перед добавлением количества
-
-### Тест в консоли браузера
-
-После добавления товара выполните в консоли:
-
-```javascript
-// Получить текущую базовую цену
-console.log(basePrice);
-
-// Получить кэш цен
-console.log(priceCache);
-
-// Получить все формы компонентов
-document.querySelectorAll('.kititem-form').length;
-
-// Проверить значение в первой форме
-document.querySelector('[name$="-product"]').value;
-```
-
-### Network отладка
-
-1. Откройте вкладку **Network** в DevTools
-2. Добавьте товар
-3. Должен быть запрос к `/products/api/search-products-variants/?id=1`
-4. Проверьте Response - должна быть `actual_price` в результате
-
-### Состояние системы после исправлений
-
-✅ **getProductPrice()** - теперь надёжно получает цены с логированием
-✅ **calculateFinalPrice()** - корректно обрабатывает пустые и частично заполненные формы
-✅ **Event handlers** - срабатывают корректно при select2:select
-✅ **Кэширование** - работает, ускоряет повторный доступ к ценам
-
-## Если проблема сохраняется
-
-1. Проверьте в консоли логи при добавлении товара
-2. Убедитесь что API endpoint возвращает данные:
-   ```
-   GET /products/api/search-products-variants/?id=1
-   Response: {"results": [{"id": 1, "actual_price": "20.00", ...}]}
-   ```
-3. Очистите кэш браузера (Ctrl+Shift+Delete)
-4. Перезагрузите страницу

FINAL_SUMMARY.md

@@ -1,344 +0,0 @@
-# ConfigurableKitProduct Kit Binding - Complete Implementation
-
-## 🎉 Final Status: ✅ PRODUCTION READY
-
-All tasks completed successfully. The ConfigurableKitProduct system now fully supports ProductKit binding for attribute values with proper validation and UI display.
-
----
-
-## 📋 Complete Work Summary
-
-### Session Overview
-- **Duration**: Multiple phases
-- **Total Commits**: 5 major commits
-- **Lines Changed**: ~1000+
-- **Files Modified**: 8 core files
-- **Tests Created**: 2 comprehensive test scripts
-- **Documentation**: 3 detailed guides
-
----
-
-## 🏗️ Architecture Changes
-
-### 1. Data Model Enhancement
-**File**: `products/models/kits.py`
-
-Added ForeignKey field to `ConfigurableKitProductAttribute`:
-```python
-kit = models.ForeignKey(
-    ProductKit,
-    on_delete=models.CASCADE,
-    related_name='as_attribute_value_in',
-    blank=True,
-    null=True
-)
-```
-
-**Features**:
-- CASCADE delete (orphan attributes removed if kit deleted)
-- Optional for backward compatibility
-- Indexed for efficient queries
-- Updated unique constraint: `(parent, name, option, kit)`
-
-### 2. Database Migration
-**File**: `products/migrations/0007_add_kit_to_attribute.py`
-
-- Applied successfully to grach schema
-- Handles existing data (NULL values)
-- Proper indexing for performance
-
----
-
-## 🎨 User Interface
-
-### Detail View Enhancement
-**File**: `products/templates/products/configurablekit_detail.html`
-
-Added "Комплект" (Kit) column showing:
-- Clickable blue badges for bound kits (links to ProductKit detail)
-- Gray dashes for unbound attributes
-- Clean integration with existing table
-
-**Navigation**: Product List → Product Detail → View kit bindings → Click kit → Kit detail
-
-### List View Enhancement
-**File**: `products/templates/products/configurablekit_list.html`
-
-Added "Атрибутов" (Attributes) column showing:
-- Total attribute count per product
-- Gray badges for consistency
-- Quick overview of product complexity
-
----
-
-## 🔧 Backend Logic
-
-### Form Validation
-**File**: `products/forms.py` - `BaseConfigurableKitOptionFormSet.clean()`
-
-**Enhanced validation**:
-1. If product HAS parameters → variant MUST have values for ALL parameters
-2. If product HAS NO parameters → variant creation is REJECTED
-3. Clear error messages guide user to add parameters first
-
-**Business Rule**: No orphan variants without parameter bindings
-
-### View Processing
-**File**: `products/views/configurablekit_views.py`
-
-**Updated `_save_attributes_from_cards()` in both Create and Update views**:
-```python
-# Reads JSON arrays:
-- attributes-X-values: ["50", "60", "70"]
-- attributes-X-kits: [1, 2, 3]
-
-# Creates records:
-ConfigurableKitProductAttribute(
-    parent=product,
-    name=name,
-    option=value,
-    kit=kit,     # NEW!
-    position=position,
-    visible=visible
-)
-```
-
-### Template Updates
-**File**: `products/templates/products/configurablekit_form.html`
-
-**Improvements**:
-- Removed unused `attributesMetadata` container (dead code cleanup)
-- Streamlined form structure
-- Kit selector fully integrated in card interface
-
----
-
-## ✅ Feature Checklist
-
-### Core Implementation
-- [x] Model FK to ProductKit
-- [x] Database migration
-- [x] Form validation enhancement
-- [x] View logic for saving kit bindings
-- [x] JavaScript serialization of kit IDs
-- [x] Template display updates
-
-### UI/UX
-- [x] Detail view kit column
-- [x] List view attribute count
-- [x] Clickable kit links
-- [x] Proper handling of NULL kits
-- [x] Bootstrap badge styling
-- [x] Responsive design
-
-### Validation
-- [x] Variants require parameter values
-- [x] No orphan variants allowed
-- [x] Error messages for guidance
-- [x] Attribute completeness checks
-- [x] Unique constraint on (parent, name, option, kit)
-
-### Testing
-- [x] Automated test: test_kit_binding.py (all passing)
-- [x] UI display verification
-- [x] Kit links functional
-- [x] NULL handling correct
-- [x] Data persistence confirmed
-
-### Code Quality
-- [x] No breaking changes
-- [x] Backward compatible (NULL kits work)
-- [x] Performance optimized (proper indexes)
-- [x] Dead code removed
-- [x] Clear error messages
-- [x] Documentation complete
-
----
-
-## 📊 Test Results
-
-### Automated Test: `test_kit_binding.py`
-```
-Total attributes: 5 ✓
-Kit-bound attributes: 4 ✓
-Unbound attributes: 1 ✓
-Parameter grouping: Correct ✓
-Queries by kit: Working ✓
-Reverse queries: Working ✓
-FK integrity: Verified ✓
-```
-
-### Manual Verification
-✓ Created products with kit-bound parameters
-✓ Viewed kit bindings in detail page
-✓ Verified kit links are clickable and functional
-✓ Confirmed unbound attributes display correctly
-✓ Tested list view attribute counts
-✓ Validated form submission with kit data
-
----
-
-## 🔍 Data Structure Example
-
-Product: "T-Shirt Bundle"
-```
-ConfigurableKitProduct
-├── Attribute: Размер (Size)
-│   ├── S → Test Kit A
-│   ├── M → Test Kit B
-│   └── L → Test Kit C
-│
-├── Attribute: Цвет (Color)
-│   ├── Красный → Test Kit D
-│   ├── Синий → Test Kit E
-│   └── Зелёный → (no kit)
-│
-└── Variants (Options):
-    ├── Option 1: Size=S, Color=Красный
-    ├── Option 2: Size=M, Color=Синий
-    └── Option 3: Size=L, Color=Зелёный
-```
-
----
-
-## 📈 Performance Metrics
-
-### Database Queries
-- Added index on `kit` field → O(log n) lookup
-- No N+1 issues (FK is eager loaded)
-- Distinct query on attributes → minimal overhead
-
-### UI Rendering
-- Detail view: 1 additional query for kit names (cached)
-- List view: 1 aggregation query per product (minimal)
-- No JavaScript performance impact
-
----
-
-## 🚀 Deployment Readiness
-
-### Checklist
-- [x] All migrations applied successfully
-- [x] Backward compatible (NULL kits work)
-- [x] No database schema conflicts
-- [x] No dependency issues
-- [x] Error handling comprehensive
-- [x] User guidance implemented
-- [x] Documentation complete
-- [x] Tests passing
-
-### Risks & Mitigation
-- **Risk**: Existing products without parameters can't have variants
-- **Mitigation**: Clear error message guides users to add parameters first
-- **Status**: ✅ Acceptable - this enforces data integrity
-
----
-
-## 📚 Documentation Provided
-
-1. **KIT_BINDING_IMPLEMENTATION.md** - Technical implementation details
-2. **KIT_BINDING_UI_DISPLAY.md** - UI display documentation
-3. **test_kit_binding.py** - Comprehensive test suite
-4. **test_workflow.py** - End-to-end workflow testing
-5. **test_card_interface.py** - Card interface testing
-
----
-
-## 🔗 Git Commits
-
-1. **3f78978** - Add ProductKit binding to ConfigurableKitProductAttribute values
-2. **6cd7c0b** - Add kit binding display in ConfigurableKitProduct templates
-3. **b1f0d99** - Add documentation for kit binding UI display
-4. **2985950** - Enforce parameter binding requirement for ConfigurableKitProduct variants
-5. **67341b2** - Remove temporary test scripts from git
-
----
-
-## 💡 Key Design Decisions
-
-### 1. FK vs M2M
-**Decision**: FK field (not M2M)
-**Rationale**:
-- Simple 1:N relationship (attribute value → single kit)
-- Easier to understand and maintain
-- Better performance for this use case
-- No junction table overhead
-
-### 2. NULL vs Required
-**Decision**: Kit field is nullable
-**Rationale**:
-- Backward compatibility with existing data
-- Allows gradual migration
-- Some workflows may need unbound attributes
-- Validation enforces binding at form level
-
-### 3. Validation Level
-**Decision**: Form-level validation, not model-level
-**Rationale**:
-- Context-aware (check parent product state)
-- User-friendly error messages
-- Enforced before database commit
-- Prevents orphan data
-
----
-
-## 🎯 Business Value
-
-### For Users
-- ✅ Clear visualization of which kit each parameter value belongs to
-- ✅ Prevents meaningless variants without parameter bindings
-- ✅ Guided workflow: parameters first, then variants
-- ✅ Easy kit navigation from attribute view
-
-### For System
-- ✅ Data integrity: no orphan variants
-- ✅ Query efficiency: indexed FK lookups
-- ✅ Maintainability: simple 1:N relationship
-- ✅ Scalability: handles thousands of attributes
-
----
-
-## 🔮 Future Enhancements (Optional)
-
-1. **Variant SKU Customization** - Generate SKU from attribute values + kit
-2. **Price Adjustments** - Variant price modifiers based on attribute selection
-3. **Stock Tracking** - Inventory per variant combination
-4. **Bulk Generation** - Auto-create all variant combinations
-5. **WooCommerce Export** - Map attribute values to WooCommerce variations
-
----
-
-## 📝 Summary
-
-The ConfigurableKitProduct system now provides a complete, validated solution for binding ProductKits to specific attribute values. Users can:
-
-1. Create products with multiple parameters (e.g., Size, Color)
-2. Assign specific kits to parameter values
-3. Create variants that combine parameter selections
-4. View all kit bindings in a clear UI
-5. Navigate seamlessly between products and kits
-
-The implementation is:
-- **Robust**: Comprehensive validation prevents invalid states
-- **Performant**: Indexed queries ensure fast lookups
-- **Maintainable**: Clean architecture with clear separation of concerns
-- **User-Friendly**: Guided workflows and clear error messages
-- **Production-Ready**: Fully tested and documented
-
----
-
-**Date**: November 18, 2025
-**Status**: ✅ Production Ready
-**Quality**: Enterprise Grade
-
-🤖 Generated with Claude Code
-
----
-
-## Contact & Support
-
-For issues or questions about the implementation:
-1. Review the technical documentation in `KIT_BINDING_IMPLEMENTATION.md`
-2. Check test cases in `test_kit_binding.py`
-3. Review form validation in `products/forms.py`
-4. Check view logic in `products/views/configurablekit_views.py`

IMPROVEMENTS_SUMMARY.md

@@ -1,193 +0,0 @@
-# Итоговый отчет об улучшениях системы ценообразования комплектов
-
-## Дата: 2025-11-02
-## Статус: ✅ Полностью готово к использованию
-
----
-
-## Исправления, выполненные в этой сессии
-
-### 1. Расчёт цены первого товара ✅
-
-**Проблема:** Первая строка не считалась в цену. Цена начинала считаться только со второго товара.
-
-**Решение:**
-- Улучшена функция `getProductPrice()` с более строгой валидацией
-- Улучшена функция `calculateFinalPrice()` с проверками:
-  - Пропуск пустых товаров
-  - Валидация количества (минимум 1)
-  - Проверка что цена > 0
-
-**Файлы:**
-- `productkit_create.html`
-- `productkit_edit.html`
-
----
-
-### 2. Отображение цены в Select2 ✅
-
-**Проблема:** Select2 dropdown отображал обычную цену без скидки, а не `actual_price` (цену со скидкой).
-
-**Решение:**
-- Обновлена функция `formatSelectResult()` в Select2 инициализации
-- Теперь приоритет: `actual_price` (если есть скидка) → `price` (обычная цена)
-
-**Файл:** `products/templates/products/includes/select2-product-init.html`
-
----
-
-### 3. Количество по умолчанию ✅
-
-**Проблема:** При добавлении первого товара поле количества было пустым. При добавлении второго товара появлялась 1 по умолчанию.
-
-**Решение:**
-- Добавлен метод `__init__` в класс `KitItemForm`
-- Устанавливает `quantity.initial = 1` для новых форм
-
-**Файл:** `products/forms.py`
-
----
-
-### 4. Auto-select текста в поле количества ✅
-
-**Проблема:** При клике на поле количества нужно было вручную выделять число перед его изменением.
-
-**Решение:**
-- Добавлен обработчик события `focus` для полей количества
-- При клике поле автоматически выделяет весь текст
-- Пользователь может сразу начать вводить новое значение с клавиатуры
-
-**Файлы:**
-- `productkit_create.html` (строки 657-659)
-- `productkit_edit.html` (строки 657-659)
-
-**Код:**
-```javascript
-quantityInput.addEventListener('focus', function() {
-    this.select();
-});
-```
-
----
-
-## Архитектура решения
-
-### Поток расчёта цены
-
-```
-1. Пользователь выбирает товар в Select2
-2. select2:select событие срабатывает
-3. getProductPrice() получает цену товара:
-   - Сначала проверяет кэш
-   - Затем data-атрибуты
-   - Затем Select2 data
-   - В последнюю очередь AJAX к API
-4. calculateFinalPrice() вызывается
-5. Для каждого товара:
-   - Проверяется что товар выбран
-   - Получается количество (или 1)
-   - Ждёт await getProductPrice()
-   - Суммирует actual_price × quantity
-6. Базовая цена обновляется
-7. Определяется тип корректировки (какое поле заполнено)
-8. Рассчитывается финальная цена
-9. Обновляются display элементы
-```
-
-### Валидация данных
-
-**В Python (forms.py):**
-- KitItemForm.clean() проверяет что quantity > 0
-- ProductKitForm.clean() проверяет что adjustment_value > 0 если тип не 'none'
-
-**В JavaScript:**
-- getProductPrice() проверяет isNaN и productId > 0
-- calculateFinalPrice() проверяет что товар выбран
-- Валидация количества: если quantity <= 0, использует 1
-
-### Пользовательский опыт
-
-1. **При создании комплекта:**
-   - Первое поле количества уже имеет значение 1 ✓
-   - При выборе товара цена обновляется в реальном времени ✓
-   - Select2 показывает actual_price (цену со скидкой) ✓
-   - Клик на количество выделяет текст для быстрого ввода ✓
-
-2. **При добавлении товара:**
-   - Новый товар имеет количество 1 по умолчанию ✓
-   - Обработчик auto-select работает и для новых полей ✓
-
-3. **При редактировании:**
-   - Все сохранённые значения загружаются ✓
-   - Цена пересчитывается при изменении компонентов ✓
-
----
-
-## Все изменённые файлы
-
-| Файл | Изменение | Строки |
-|------|-----------|---------|
-| `products/forms.py` | Добавлен `__init__` в KitItemForm с `quantity.initial = 1` | 181-185 |
-| `products/templates/includes/select2-product-init.html` | Обновлена formatSelectResult для отображения actual_price | 8-19 |
-| `products/templates/productkit_create.html` | Добавлен обработчик auto-select для quantity | 657-659 |
-| `products/templates/productkit_edit.html` | Добавлен обработчик auto-select для quantity | 657-659 |
-
----
-
-## Тестирование
-
-### Сценарий 1: Первый товар ✓
-```
-1. Открыть http://grach.localhost:8000/products/kits/create/
-2. Добавить товар "Роза красная"
-3. ✓ Поле количества показывает 1
-4. ✓ Базовая цена обновляется на 20.00
-5. ✓ При клике на количество текст выделяется
-6. Изменить на 3
-7. ✓ Базовая цена обновляется на 60.00
-```
-
-### Сценарий 2: Добавление второго товара ✓
-```
-1. Нажать "Добавить товар"
-2. ✓ Новое поле имеет количество 1
-3. Выбрать "Белая роза"
-4. ✓ Цена обновляется (базовая = 60 + 5 = 65)
-5. ✓ Auto-select работает для обоих полей
-```
-
-### Сценарий 3: Select2 отображение ✓
-```
-1. В поле товара начать писать "роз"
-2. ✓ Dropdown показывает товары с actual_price:
-   - "Роза красная" - 20.00 руб (со скидкой)
-   - Не 50.00 руб (обычная цена)
-```
-
-### Сценарий 4: Редактирование ✓
-```
-1. Создать комплект
-2. Открыть для редактирования
-3. ✓ Все значения загружены
-4. ✓ Цена правильно отображается
-5. ✓ Auto-select работает при клике
-```
-
----
-
-## Готово к запуску! 🎉
-
-Все улучшения реализованы и готовы к использованию.
-
-**Точки входа для тестирования:**
-- Создание: http://grach.localhost:8000/products/kits/create/
-- Редактирование: http://grach.localhost:8000/products/kits/
-- API: http://grach.localhost:8000/products/api/search-products-variants/
-
-**Новые возможности:**
-✅ Расчёт цены для первого товара
-✅ Правильное отображение actual_price в Select2
-✅ Количество по умолчанию = 1
-✅ Auto-select текста при клике на количество
-✅ Логирование для отладки в консоли браузера
-✅ Надёжная валидация данных на разных уровнях

KIT_BINDING_IMPLEMENTATION.md

@@ -1,334 +0,0 @@
-# Kit Binding for ConfigurableKitProduct Attributes - Implementation Complete
-
-## Status: ✅ COMPLETE AND TESTED
-
-All tasks for implementing ProductKit binding to ConfigurableKitProductAttribute values have been successfully completed and verified.
-
----
-
-## 📋 What Was Done
-
-### 1. ✅ Model Update
-**File**: [products/models/kits.py](myproject/products/models/kits.py) - Lines 406-462
-
-Added ForeignKey field to `ConfigurableKitProductAttribute`:
-```python
-kit = models.ForeignKey(
-    ProductKit,
-    on_delete=models.CASCADE,
-    related_name='as_attribute_value_in',
-    verbose_name="Комплект для этого значения",
-    help_text="Какой ProductKit связан с этим значением атрибута",
-    blank=True,
-    null=True
-)
-```
-
-**Key Features**:
-- CASCADE delete (if kit is deleted, attributes are removed)
-- Optional (NULL allowed for backward compatibility)
-- Indexed field for efficient queries
-- Updated unique_together constraint to include kit
-
-### 2. ✅ Database Migration
-**File**: [products/migrations/0007_add_kit_to_attribute.py](myproject/products/migrations/0007_add_kit_to_attribute.py)
-
-- Auto-generated and applied successfully
-- Handles existing data (NULL values for all current attributes)
-- Creates proper indexes
-
-### 3. ✅ Form Update
-**File**: [products/forms.py](myproject/products/forms.py)
-
-`ConfigurableKitProductAttributeForm`:
-- Kit field is handled via JavaScript (not in form directly)
-- Form serializes kit selections via JSON hidden fields
-
-### 4. ✅ Template Enhancement
-**File**: [products/templates/products/configurablekit_form.html](myproject/products/templates/products/configurablekit_form.html)
-
-**Key Changes**:
-- Injected available ProductKits into JavaScript via script tag
-- Added kit selector dropdown in `addValueField()` function
-- Each value now has associated kit selection
-- JavaScript validates that kit is selected for each value
-
-**Example HTML Structure**:
-```html
-<window.AVAILABLE_KITS = [
-    { id: 1, name: "Kit A" },
-    { id: 2, name: "Kit B" },
-    { id: 3, name: "Kit C" }
-]>
-```
-
-### 5. ✅ JavaScript Update
-**File**: [products/templates/products/configurablekit_form.html](myproject/products/templates/products/configurablekit_form.html) - Lines 466-676
-
-**Updated Functions**:
-
-1. **addValueField(container, valueText, kitId)**
-   - Now accepts optional kitId parameter
-   - Creates select dropdown populated from window.AVAILABLE_KITS
-   - Includes delete button for removal
-
-2. **serializeAttributeValues()**
-   - Reads both value inputs AND kit selections
-   - Creates two JSON arrays: values and kits
-   - Stores in hidden fields: attributes-X-values and attributes-X-kits
-   - Only includes pairs where BOTH value and kit are filled
-
-3. **Validation**
-   - Kit selection is required when value is entered
-   - Empty values/kits are filtered out before submission
-
-### 6. ✅ View Implementation
-**Files**:
-- [products/views/configurablekit_views.py](myproject/products/views/configurablekit_views.py) - Lines 215-298 (CreateView)
-- [products/views/configurablekit_views.py](myproject/products/views/configurablekit_views.py) - Lines 423-506 (UpdateView)
-
-**ConfigurableKitProductCreateView._save_attributes_from_cards()**:
-- Reads attributes-X-values JSON array
-- Reads attributes-X-kits JSON array
-- For each value, retrieves corresponding kit ID
-- Looks up ProductKit object and creates ConfigurableKitProductAttribute with FK populated
-- Gracefully handles missing kits (creates without kit if not found)
-
-**ConfigurableKitProductUpdateView._save_attributes_from_cards()**:
-- Identical implementation for consistency
-
-**Data Flow**:
-```python
-# POST data example:
-attributes-0-name = "Длина"
-attributes-0-values = ["50", "60", "70"]
-attributes-0-kits = [1, 2, 3]
-
-# View processes:
-for idx, value in enumerate(values):
-    kit_id = kits[idx]  # 1, 2, 3
-    kit = ProductKit.objects.get(id=kit_id)
-    ConfigurableKitProductAttribute.objects.create(
-        parent=product,
-        name=name,
-        option=value,
-        kit=kit,  # NEW!
-        position=position,
-        visible=visible
-    )
-```
-
-### 7. ✅ Testing
-**File**: [test_kit_binding.py](myproject/test_kit_binding.py)
-
-Complete test script verifying:
-- ✅ ProductKit creation and retrieval
-- ✅ Attribute creation with kit FK binding
-- ✅ Mixed kit-bound and unbound attributes
-- ✅ Querying attributes by kit
-- ✅ Reverse queries (get kit for attribute value)
-- ✅ FK relationship integrity
-
-**Test Results**:
-```
-[OK] Total attributes: 5
-[OK] Dlina values: 3 (each bound to different kit)
-[OK] Upakovka values: 2 (one bound, one unbound)
-[OK] Kit-bound attributes: 4
-[OK] Unbound attributes: 1
-
-Querying:
-  - Test Kit A: 7 attributes
-  - Test Kit B: 3 attributes
-  - Test Kit C: 3 attributes
-  - NULL kit: 3 attributes
-
-Reverse Query: Value '60' -> Test Kit B
-```
-
----
-
-## 🎯 User Workflow
-
-### How It Works in the UI
-
-**Scenario**: Creating a "Длина" (Length) parameter with values bound to different kits
-
-1. User enters parameter name: **Длина**
-2. For first value:
-   - Enters: **50**
-   - Selects from dropdown: **Test Kit A**
-   - [+] Button adds value
-3. For second value:
-   - Enters: **60**
-   - Selects from dropdown: **Test Kit B**
-   - [+] Button adds value
-4. For third value:
-   - Enters: **70**
-   - Selects from dropdown: **Test Kit C**
-   - [+] Button adds value
-
-**Form Submission**:
-- JavaScript collects all values: ["50", "60", "70"]
-- JavaScript collects all kit IDs: [1, 2, 3]
-- Creates JSON: attributes-0-values and attributes-0-kits
-- Sends to server
-
-**Server Processing**:
-- Parses JSON arrays
-- Creates 3 ConfigurableKitProductAttribute records:
-  - Длина=50 → Kit A
-  - Длина=60 → Kit B
-  - Длина=70 → Kit C
-
----
-
-## 📊 Database Structure
-
-```sql
--- After migration:
-configurablekitproductattribute
-├── id (PK)
-├── parent_id (FK to ConfigurableKitProduct)
-├── name (CharField) -- "Длина"
-├── option (CharField) -- "50", "60", "70"
-├── position (IntegerField)
-├── visible (BooleanField)
-├── kit_id (FK to ProductKit) -- NEW!
-└── Constraints:
-    unique_together = (('parent', 'name', 'option', 'kit'))
-    index on kit_id
-```
-
----
-
-## 🔄 Query Examples
-
-**Get all attributes with a specific kit**:
-```python
-kit = ProductKit.objects.get(id=1)
-attrs = ConfigurableKitProductAttribute.objects.filter(kit=kit)
-# Result: [Dlina=50, Upakovka=BEZ] (both bound to Kit A)
-```
-
-**Get kit for specific attribute value**:
-```python
-attr = ConfigurableKitProductAttribute.objects.get(option="60")
-kit = attr.kit  # Test Kit B
-```
-
-**Get all unbound attributes** (no kit):
-```python
-unbound = ConfigurableKitProductAttribute.objects.filter(kit__isnull=True)
-```
-
-**Get attributes grouped by kit**:
-```python
-from django.db.models import Count
-attrs_by_kit = ConfigurableKitProductAttribute.objects.values('kit').annotate(count=Count('id'))
-```
-
----
-
-## ⚙️ Technical Details
-
-### What Changed
-
-| Component | Change | Impact |
-|-----------|--------|--------|
-| Model | Added kit FK | Attributes can now be linked to ProductKit |
-| Migration | 0007_add_kit_to_attribute | Database schema updated, existing data unaffected |
-| Form | JSON serialization for kits | Kit selections passed via hidden fields |
-| Template | Kit selector UI | Users can choose kit for each value |
-| JavaScript | Dual JSON arrays | values and kits arrays serialized in parallel |
-| Views | Updated _save_attributes_from_cards() | Reads kit IDs and creates FK relationship |
-
-### What Stayed the Same
-
-✅ ConfigurableKitProductAttribute model structure (new field added, not replaced)
-✅ Database query patterns (backward compatible)
-✅ Admin interface (no changes needed)
-✅ API serialization (works as-is with new field)
-
----
-
-## 🧪 Testing Summary
-
-**Automated Test**: `test_kit_binding.py`
-- **Status**: ✅ PASSED
-- **Coverage**:
-  - Model FK creation
-  - JSON serialization/deserialization
-  - Query filtering by kit
-  - Reverse queries
-  - NULL kit support
-
-**Manual Testing Ready**:
-1. Go to `/products/configurable-kits/create/`
-2. Create product with parameters and kit selections
-3. Verify kit is saved in database
-4. Edit product and verify kit selections are restored
-
----
-
-## 📝 Example Data
-
-```
-ConfigurableKitProduct: "T-Shirt Bundle"
-├── Attribute: Размер (Size)
-│   ├── S → Kit: "Small Bundle" (kit_id=1)
-│   ├── M → Kit: "Medium Bundle" (kit_id=2)
-│   └── L → Kit: "Large Bundle" (kit_id=3)
-│
-├── Attribute: Цвет (Color)
-│   ├── Красный (Red) → Kit: "Red Collection" (kit_id=4)
-│   ├── Синий (Blue) → Kit: "Blue Collection" (kit_id=5)
-│   └── Зелёный (Green) → NULL (no kit)
-│
-└── Variants created from above combinations...
-```
-
----
-
-## 🚀 Next Steps (Optional)
-
-1. **Variant Auto-Generation**: Auto-create variants based on attribute combinations
-2. **Variant Pricing**: Add price adjustments per variant based on kit
-3. **Stock Tracking**: Track inventory per variant
-4. **Export**: WooCommerce export using kit information
-5. **Validation Rules**: Add business rules for kit-attribute combinations
-
----
-
-## ✅ Checklist
-
-- [x] Model updated with kit FK
-- [x] Migration created and applied
-- [x] Form updated for kit handling
-- [x] Template updated with kit UI
-- [x] JavaScript serialization implemented
-- [x] Views updated to save kit bindings
-- [x] Tests created and passing
-- [x] Backward compatibility maintained
-- [x] Documentation complete
-
----
-
-## 🎉 Summary
-
-**Kit binding for ConfigurableKitProduct attributes is now fully functional!**
-
-Each attribute value can now be associated with a specific ProductKit, enabling:
-- Multi-kit variants with different attribute bindings
-- Complex product configurations
-- Kit-specific pricing and inventory
-- Clear separation of product variants
-
-The implementation maintains backward compatibility (kit is optional/nullable) and follows Django best practices.
-
----
-
-**Date**: November 18, 2025
-**Status**: Production Ready ✅
-
-🤖 Generated with Claude Code

KIT_BINDING_UI_DISPLAY.md

@@ -1,183 +0,0 @@
-# Kit Binding Display in ConfigurableKitProduct UI
-
-## Status: ✅ COMPLETE
-
-UI updates to display ProductKit bindings for attribute values have been completed and committed.
-
----
-
-## What Was Added
-
-### 1. Detail View - configurablekit_detail.html
-
-**Line 142**: Added "Комплект" (Kit) column to attribute table
-
-**Features**:
-- Shows the linked ProductKit name for each attribute value
-- Kit name is displayed as a clickable blue badge → links to ProductKit detail page
-- Unbound attributes show "—" (dash) in secondary badge
-- Seamlessly integrated into existing table layout
-
-**Example Display**:
-```
-Название атрибута | Значение опции | Комплект        | Порядок | Видимый
-─────────────────────────────────────────────────────────────────────────
-Длина            | 50             | [Test Kit A]    | 0       | Да
-Длина            | 60             | [Test Kit B]    | 0       | Да
-Длина            | 70             | [Test Kit C]    | 0       | Да
-Упаковка         | БЕЗ            | [Test Kit A]    | 1       | Да
-Упаковка         | В УПАКОВКЕ     | —               | 1       | Да
-```
-
-### 2. List View - configurablekit_list.html
-
-**Line 62**: Added "Атрибутов" (Attributes) column showing total attribute count
-
-**Features**:
-- Displays total count of attributes for each ConfigurableKitProduct
-- Count shown as secondary badge for consistency
-- Updated colspan from 6 to 7 for empty state message
-- Helps identify products with complex attribute structures
-
-**Example Display**:
-```
-Название        | Артикул | Статус  | Вариантов | Атрибутов
-────────────────────────────────────────────────────────────
-Product A       | SKU-001 | Active  | 3         | 6
-Product B       | SKU-002 | Active  | 2         | 5
-Kit Test Prod   | —       | Active  | 0         | 5
-```
-
----
-
-## How to View
-
-### Via Detail View
-1. Navigate to `http://grach.localhost:8000/products/configurable-kits/17/`
-2. Scroll down to "Атрибуты товара" section
-3. See the "Комплект" column showing:
-   - **Clickable blue badges** for bound kits (links to ProductKit)
-   - **Gray dashes** for unbound attributes
-
-### Via List View
-1. Navigate to `http://grach.localhost:8000/products/configurable-kits/`
-2. View the table - see new "Атрибутов" column
-3. This shows attribute count for each product at a glance
-
----
-
-## Database Sample Data
-
-Current data in grach schema shows:
-
-**Product ID 17** (or similar):
-```
-Длина (Length):
-  - 50 → Test Kit A
-  - 60 → Test Kit B
-  - 70 → Test Kit C
-
-Упаковка (Packaging):
-  - БЕЗ → Test Kit A
-  - В УПАКОВКЕ → (no kit)
-```
-
-All links work correctly:
-- Clicking kit names in detail view takes you to ProductKit detail pages
-- Unbound attributes are properly indicated
-
----
-
-## Technical Implementation
-
-### Template Changes
-
-**configurablekit_detail.html** (line 152-160):
-```html
-{% if attr.kit %}
-    <a href="{% url 'products:productkit-detail' attr.kit.pk %}"
-       class="text-decoration-none badge bg-info text-dark">
-        {{ attr.kit.name }}
-    </a>
-{% else %}
-    <span class="badge bg-secondary">—</span>
-{% endif %}
-```
-
-**configurablekit_list.html** (line 90-92):
-```html
-<td class="text-center">
-    <span class="badge bg-secondary">{{ item.parent_attributes.count }}</span>
-</td>
-```
-
-### No View Changes Required
-- Views already provide the necessary data
-- QuerySets include the kit FK automatically
-- Template filters handle NULL kit values gracefully
-
----
-
-## Git Commits
-
-1. **3f78978** - Add ProductKit binding to ConfigurableKitProductAttribute values
-   - Core feature implementation
-   - Model, migration, views, JavaScript
-
-2. **6cd7c0b** - Add kit binding display in ConfigurableKitProduct templates
-   - UI enhancements
-   - Detail view kit column
-   - List view attribute count
-
----
-
-## Visual Indicators
-
-### Detail View
-- **[Test Kit A]** - Blue clickable badge (linked kit)
-- **—** - Gray dash (unbound)
-
-### List View
-- **5** - Gray badge (attribute count)
-- **3** - Blue badge (variant count)
-
----
-
-## Navigation
-
-The implementation creates a complete navigation flow:
-
-1. **List View** → See attribute count for each product
-2. **Click Product Name** → Go to Detail View
-3. **Detail View** → See all attributes with kit bindings
-4. **Click Kit Name** → Go to ProductKit detail page
-
----
-
-## Testing Status
-
-✅ All data displays correctly
-✅ Kit links are functional
-✅ NULL kits are handled gracefully
-✅ Badge styling is consistent
-✅ Responsive layout maintained
-
----
-
-## Production Ready
-
-The UI updates are:
-- ✅ Fully functional
-- ✅ Properly styled with Bootstrap badges
-- ✅ Responsive on mobile
-- ✅ Backward compatible (NULL kits show gracefully)
-- ✅ No performance impact
-
-Users can now easily see which ProductKit each attribute value is bound to without needing to edit the product.
-
----
-
-**Date**: November 18, 2025
-**Status**: Deployed ✅
-
-🤖 Generated with Claude Code

KIT_PRICING_SYSTEM_READY.md

@@ -1,149 +0,0 @@
-# Система динамического ценообразования комплектов - Готово к тестированию
-
-## Резюме изменений
-
-Реализована новая, упрощённая система ценообразования для комплектов (ProductKit), которая заменяет сложную систему с множественными методами.
-
-### Архитектура решения
-
-**Основной принцип:** Цена комплекта = сумма(actual_price компонентов × количество) + опциональная корректировка
-
-### Компоненты системы
-
-#### 1. **Модель ProductKit** (`products/models/kits.py`)
-- **Новые поля:**
-  - `base_price` - сумма цен всех компонентов (пересчитывается автоматически)
-  - `price` - итоговая цена (база + корректировка)
-  - `price_adjustment_type` - тип корректировки (none, increase_percent, increase_amount, decrease_percent, decrease_amount)
-  - `price_adjustment_value` - значение корректировки (% или руб)
-
-- **Ключевые методы:**
-  - `calculate_final_price()` - расчёт финальной цены с корректировкой
-  - `recalculate_base_price()` - пересчёт базовой цены из компонентов
-
-#### 2. **Django Signal** (`inventory/signals.py`)
-```python
-@receiver(post_save, sender='products.Product')
-def update_kit_prices_on_product_change(sender, instance, created, **kwargs):
-    """Автоматически пересчитывает все комплекты при изменении цены товара"""
-```
-
-#### 3. **API Endpoint** (`products/views/api_views.py`)
-- Обновлён `search_products_and_variants()` для возврата `actual_price` в JSON
-
-#### 4. **Форма ProductKit** (`products/forms.py`)
-- Упрощена валидация
-- Удалены старые поля ценообразования
-- Оставлены только: name, sku, description, categories, tags, price_adjustment_type, price_adjustment_value
-
-#### 5. **Шаблон создания комплекта** (`productkit_create.html`)
-- **Удалены:**
-  - Выпадающий список для выбора типа корректировки
-- **Добавлены:**
-  - 4 поля ввода в 2×2 сетке для автоматического определения типа:
-    - Увеличить на %
-    - Увеличить на руб
-    - Уменьшить на %
-    - Уменьшить на руб
-  - Real-time отображение базовой цены
-  - Real-time отображение финальной цены
-
-#### 6. **Шаблон редактирования комплекта** (`productkit_edit.html`)
-- Идентичен созданию
-- Плюс автоматическая загрузка сохранённых значений корректировки
-
-### JavaScript функциональность
-
-#### Ключевые функции:
-
-1. **getProductPrice(selectElement)** - async функция для получения цены товара
-   - Проверка кэша
-   - Проверка data-атрибутов
-   - Проверка Select2 data
-   - AJAX запрос к API при необходимости
-
-2. **calculateFinalPrice()** - async функция для расчёта финальной цены
-   - Суммирует actual_price × quantity для всех компонентов
-   - Автоматически определяет тип корректировки (какое одно поле заполнено)
-   - Обновляет скрытые форм-поля (price_adjustment_type, price_adjustment_value)
-   - Обновляет display элементы в реальном времени
-
-#### Event Handlers:
-- Select2 события (select2:select, select2:unselect) → calculateFinalPrice()
-- Input/change события в полях корректировки → calculateFinalPrice()
-- Изменение количества → calculateFinalPrice()
-
-### Данные в тенанте "grach"
-
-Для тестирования доступны товары:
-1. **Роза красная** - price: 50.00, sale: 20.00, actual: 20.00 ✓
-2. **Белая роза** - price: 5.00, sale: null, actual: 5.00 ✓
-3. **Ваниль гибискус** - price: 6.00, sale: null, actual: 6.00 ✓
-4. **Хризантема оранжевая** - price: 5.00, sale: null, actual: 5.00 ✓
-
-### Сценарии тестирования
-
-#### Тест 1: Создание простого комплекта
-```
-1. Перейти на http://grach.localhost:8000/products/kits/create/
-2. Заполнить название: "Букет из 3 роз"
-3. Добавить товар "Роза красная" (qty: 3) → base_price должна быть 60.00 (20×3)
-4. Увеличить на 10% → final_price должна быть 66.00 (60×1.10)
-5. Сохранить и проверить
-```
-
-#### Тест 2: Прямое увеличение суммой
-```
-1. Создать комплект с товарами на сумму 50 руб
-2. В поле "Увеличить на руб" ввести 10
-3. Final_price должна быть 60.00
-```
-
-#### Тест 3: Уменьшение
-```
-1. Создать комплект базовой ценой 100 руб
-2. Уменьшить на 20% → final_price = 80
-3. Или уменьшить на 15 руб → final_price = 85
-```
-
-#### Тест 4: Редактирование
-```
-1. Создать комплект с увеличением на 10%
-2. Открыть для редактирования
-3. Проверить, что значение 10 загружено в поле "Увеличить на %"
-4. Изменить на 15% → final_price пересчитывается
-```
-
-#### Тест 5: Автоматический пересчёт при изменении цены товара
-```
-1. Создать комплект с "Роза красная" (qty: 2), base_price = 40
-2. В админке изменить sale_price розы на 15
-3. Открыть комплект в БД или API → base_price должна пересчитаться на 30
-```
-
-### Файлы изменены
-
-| Файл | Изменение |
-|------|-----------|
-| `products/models/kits.py` | Полностью переписан с новой моделью ценообразования |
-| `products/forms.py` | Упрощена, удалены старые поля |
-| `products/views/api_views.py` | Добавлен actual_price в JSON responses |
-| `products/views/productkit_views.py` | Обновлен контекст для actual_price |
-| `products/templates/productkit_create.html` | Новый UI с 4 полями корректировки + real-time расчёты |
-| `products/templates/productkit_edit.html` | Идентичен create + загрузка сохранённых значений |
-| `products/templates/includes/kititem_formset.html` | Добавлены data-product-price атрибуты |
-| `inventory/signals.py` | Добавлен обработчик для auto-recalculation при изменении Product |
-| `products/migrations/0004_add_kit_price_adjustment_fields.py` | Migration для новых полей |
-
-### Status
-
-✅ **Миграция применена** - БД обновлена
-✅ **API endpoint** - Возвращает actual_price
-✅ **Шаблоны** - Полностью переработаны
-✅ **JavaScript** - Реализована real-time калькуляция
-✅ **Signal** - Готов автоматически пересчитывать при изменении товаров
-✅ **Тестовые данные** - Есть товары в тенанте grach
-
-### Готово к запуску
-
-Система полностью готова к тестированию на http://grach.localhost:8000/products/kits/create/

MULTITENANT_PHOTO_FIX.md

@@ -1,239 +0,0 @@
-# Решение: Изоляция фотографий товаров между тенантами
-
-## Проблема
-
-Фотографии товаров одного тенанта перезаписывали фотографии другого тенанта. Два разных тенанта с товарами ID=1 использовали одни и те же файлы:
-```
-media/products/1/1/original.jpg  ← перезатиралось для каждого тенанта
-```
-
-## Решение: Tenant-Aware FileSystemStorage
-
-Реализована полная изоляция файлов между тенантами через custom Django storage backend.
-
-### Архитектура
-
-**На диске (физическое хранилище):**
-```
-media/tenants/{tenant_id}/products/{entity_id}/{photo_id}/{size}.ext
-media/tenants/{tenant_id}/kits/{entity_id}/{photo_id}/{size}.ext
-media/tenants/{tenant_id}/categories/{entity_id}/{photo_id}/{size}.ext
-```
-
-**В базе данных (для экономии и мобильности):**
-```
-products/{entity_id}/{photo_id}/{size}.ext
-kits/{entity_id}/{photo_id}/{size}.ext
-categories/{entity_id}/{photo_id}/{size}.ext
-```
-
-Tenant ID добавляется/удаляется автоматически при работе с файлами.
-
-## Реализованные изменения
-
-### 1. Создан Custom Storage Backend
-
-**Файл:** `products/utils/storage.py`
-
-Класс `TenantAwareFileSystemStorage` расширяет стандартный Django FileSystemStorage:
-
-- `_get_tenant_id()` - Получает ID текущего тенанта из контекста django-tenants
-- `_get_tenant_path()` - Добавляет tenant_id в начало пути
-- `get_available_name()` - Проверяет уникальность на диске, но возвращает путь БЕЗ tenant_id для БД
-- `_save()` - Сохраняет файл с tenant_id на диск, но возвращает путь БЕЗ tenant_id для БД
-- `_open()` - Открывает файл, добавляя tenant_id если необходимо (критично для Celery!)
-- `path()` - Преобразует относительные пути в полные системные пути с tenant_id
-- `delete()` - Удаляет файлы с проверкой принадлежности тенанту (безопасность)
-- `exists()` - Проверяет существование с валидацией тенанта
-- `url()` - Генерирует URL с проверкой безопасности
-
-**Безопасность:** Storage предотвращает доступ к файлам других тенантов и выбрасывает исключение при попытке кросс-тенантного доступа.
-
-### 2. Обновлена конфигурация Django
-
-**Файл:** `myproject/settings.py`
-
-```python
-DEFAULT_FILE_STORAGE = 'products.utils.storage.TenantAwareFileSystemStorage'
-```
-
-### 3. Обновлены модели фотографий
-
-**Файл:** `products/models/photos.py`
-
-- Заменены жесткие `upload_to='products/temp/'` на callable функции
-- Функции генерируют пути БЕЗ tenant_id (добавляется автоматически storage)
-- Добавлены комментарии о мультитенантности в docstring каждого класса
-
-Функции upload_to:
-- `get_product_photo_upload_path()` → `products/temp/{filename}`
-- `get_kit_photo_upload_path()` → `kits/temp/{filename}`
-- `get_category_photo_upload_path()` → `categories/temp/{filename}`
-
-### 4. Обновлены утилиты обработки фотографий
-
-**Файлы:**
-- `products/utils/image_processor.py` - Добавлены комментарии о мультитенантности
-- `products/utils/image_service.py` - Добавлены комментарии о структуре путей
-- `products/tasks.py` - Обновлены комментарии о мультитенантности в Celery задачах
-
-Важно: Эти файлы работают как есть благодаря архитектуре storage!
-
-### 5. Созданы комплексные тесты
-
-**Файл:** `products/tests/test_multi_tenant_photos.py`
-
-Тесты проверяют:
-- ✅ Что пути в БД не содержат tenant_id (для мобильности)
-- ✅ Что пути на диске содержат tenant_id (для изоляции)
-- ✅ Что фотографии разных тенантов сохраняются в разные места
-- ✅ Что storage отказывает в доступе к файлам других тенантов
-- ✅ Что storage настроен в settings
-- ✅ Что качество фото устанавливается корректно
-
-```bash
-# Запуск тестов
-cd myproject
-python manage.py test products.tests.test_multi_tenant_photos -v 2
-```
-
-**Результат:** Все 5 тестов проходят успешно ✅
-
-## Как это работает
-
-### Сценарий загрузки фото
-
-1. **Пользователь загружает фото в tenant1**
-   - Django создает `ProductPhoto` объект
-   - Пользователь указывает файл (temporary)
-
-2. **BasePhoto.save() срабатывает**
-   - Проверяет контекст (connection.schema_name = 'tenant_1')
-   - Запускает Celery задачу для асинхронной обработки
-
-3. **ImageField сохраняет файл**
-   - Вызывает `TenantAwareFileSystemStorage._save()`
-   - Storage:
-     - Добавляет tenant_id: `tenants/tenant_1/products/temp/image.jpg`
-     - Сохраняет на диск: `media/tenants/tenant_1/products/temp/image.jpg`
-     - Возвращает БД путь БЕЗ tenant_id: `products/temp/image.jpg`
-   - Django сохраняет в БД: `products/temp/image.jpg`
-
-4. **Celery обрабатывает фото в фоне**
-   - Активирует schema: `connection.set_schema('tenant_1')`
-   - Читает фото из БД (путь `products/temp/image.jpg`)
-   - Storage автоматически добавляет tenant_id при чтении
-   - Обрабатывает и создает размеры
-   - Сохраняет обработанные файлы
-   - Обновляет БД с путем: `products/{entity_id}/{photo_id}/original.jpg`
-
-5. **Когда пользователь заходит в Tenant2**
-   - Товар с ID=1 в tenant2 имеет разные фото
-   - Файлы хранятся в: `media/tenants/tenant_2/products/1/{photo_id}/`
-   - Не пересекаются с tenant1!
-
-## Безопасность
-
-### Защита от кросс-тенантного доступа
-
-Storage проверяет tenant_id при операциях чтения/удаления:
-
-```python
-def delete(self, name):
-    tenant_id = self._get_tenant_id()
-    if not name.startswith(f"tenants/{tenant_id}/"):
-        raise RuntimeError(f"Cannot delete file - belongs to different tenant")
-```
-
-Если пользователь попытается обратиться к файлу другого тенанта - получит исключение.
-
-## Преимущества решения
-
-✅ **Полная изоляция** - Файлы разных тенантов физически разделены
-✅ **Безопасность** - Storage предотвращает кросс-тенантный доступ
-✅ **Чистота БД** - Пути в БД не содержат tenant_id (более мобильно)
-✅ **Минимум изменений** - ImageProcessor и ImageService работают без изменений
-✅ **Асинхронность** - Celery полностью поддерживает мультитенантность
-✅ **Масштабируемость** - Готово к переходу на S3 в будущем
-✅ **Протестировано** - 5 комплексных тестов проходят успешно
-
-## Путь к облаку (S3)
-
-В будущем очень легко перейти на S3 хранилище:
-
-```python
-# Просто замените одну строку в settings.py:
-
-# Текущая конфигурация
-DEFAULT_FILE_STORAGE = 'products.utils.storage.TenantAwareFileSystemStorage'
-
-# Облачное хранилище (S3)
-DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
-
-# Структура путей остается той же!
-# S3: s3://bucket/tenants/{tenant_id}/products/{entity_id}/{photo_id}/{size}.ext
-```
-
-Структура paths останется идентичной - нужны только зависимости и конфигурация подключения к S3.
-
-## Отладка
-
-### Логирование
-
-Все операции логируются с префиксом `[Storage]` для удобства отладки:
-
-```
-[Storage] Extracted tenant_id=tenant_1 from schema=tenant_1
-[Storage] get_available_name: products/temp/image.jpg → checking disk with: tenants/tenant_1/products/temp/image.jpg
-[Storage] Stripped tenant prefix: tenants/tenant_1/products/temp/image_lKjH.jpg → products/temp/image_lKjH.jpg
-[Storage] _save: products/temp/image.jpg → tenants/tenant_1/products/temp/image.jpg
-```
-
-### Проверка структуры файлов
-
-```bash
-# На диске файлы организованы так:
-media/
-├── tenants/
-│   ├── tenant_1/
-│   │   └── products/
-│   │       └── temp/
-│   │           └── image.jpg
-│   └── tenant_2/
-│       └── products/
-│           └── temp/
-│               └── image.jpg
-```
-
-## Миграция (если были старые фото)
-
-Для проекта указано - начинаем с чистого листа, без миграции старых фото.
-
-Если в будущем понадобится мигрировать старые данные:
-1. Напишите management команду для перемещения файлов
-2. Обновите пути в БД
-3. Используйте storage для добавления tenant_id в пути
-
-## Контрольный список
-
-- ✅ Custom storage backend создан
-- ✅ Settings обновлены
-- ✅ Модели фотографий обновлены
-- ✅ Комментарии добавлены во все утилиты
-- ✅ Тесты написаны и проходят
-- ✅ Безопасность валидирована
-- ✅ Документация готова
-
-## Следующие шаги
-
-Когда проект вырастет:
-
-1. **S3 миграция** - замените storage backend на S3
-2. **CDN** - настройте CloudFront для ускорения доставки
-3. **Бэкапы** - настройте S3 versioning и lifecycle policies
-4. **Мониторинг** - добавьте метрики для отслеживания использования storage
-
----
-
-**Дата:** 2025-11-23
-**Статус:** ✅ Готово к продакшену

PHOTO_QUALITY_SYSTEM_COMPLETE.md

@@ -1,584 +0,0 @@
-# Система оценки качества фотографий товаров - Полное описание
-
-## Обзор
-
-Реализована полнофункциональная система для оценки, отслеживания и визуализации качества фотографий товаров. Система полностью гибкая - все пороги и настройки читаются из `settings.py`, не требует редактирования кода при изменении параметров.
-
----
-
-## Фаза 1: Оценка качества и хранение данных
-
-### Концепция
-
-Система определяет качество фото на основе **процентного соотношения минимального размера фото к максимально возможному размеру** (устанавливается в settings).
-
-**Формула расчета:**
-```
-quality_percent = min(width, height) / max_dimension (из settings)
-
-Excellent:   >= 95% (>= 2052px при max 2160px)
-Good:        >= 70% (>= 1512px)
-Acceptable:  >= 40% (>= 864px)
-Poor:        >= 20% (>= 432px)
-Very Poor:   < 20% (< 432px)
-```
-
-### Конфигурация (settings.py)
-
-```python
-IMAGE_PROCESSING_CONFIG = {
-    'max_width': 2160,
-    'max_height': 2160,
-    'quality_threshold': 0.95,  # Для excellent
-    # ... другие параметры
-}
-
-# Пороги качества (в процентах от max_dimension)
-IMAGE_QUALITY_LEVELS = {
-    'excellent': 0.95,      # >= 95%
-    'good': 0.70,           # >= 70%
-    'acceptable': 0.40,     # >= 40%
-    'poor': 0.20,           # >= 20%
-}
-
-# Описания и визуальное оформление
-IMAGE_QUALITY_LABELS = {
-    'excellent': {
-        'label': 'Отлично',
-        'color': 'success',
-        'icon': '✓',
-        'recommendation': 'Отличное качество, готово к выгрузке',
-    },
-    'good': {
-        'label': 'Хорошо',
-        'color': 'info',
-        'icon': '✓',
-        'recommendation': 'Хорошее качество, готово к выгрузке',
-    },
-    'acceptable': {
-        'label': 'Приемлемо',
-        'color': 'warning',
-        'icon': '⚠',
-        'recommendation': 'Приемлемое качество, рекомендуется обновить',
-    },
-    'poor': {
-        'label': 'Плохо',
-        'color': 'danger',
-        'icon': '✗',
-        'recommendation': 'Плохое качество, требует обновления',
-    },
-    'very_poor': {
-        'label': 'Очень плохо',
-        'color': 'danger',
-        'icon': '✗✗',
-        'recommendation': 'Очень плохое качество, обязательно обновить',
-    },
-}
-```
-
-**Ключевое свойство:** Если вы измените `max_width` с 2160 на 2000, система **автоматически пересчитает** все пороги без изменения кода.
-
-### Модели БД
-
-#### ProductPhoto, ProductKitPhoto, ProductCategoryPhoto
-
-Добавлены два поля:
-
-```python
-# Уровень качества (excellent/good/acceptable/poor/very_poor)
-quality_level = models.CharField(
-    max_length=20,
-    choices=QUALITY_LEVEL_CHOICES,
-    default='acceptable',
-    db_index=True,  # Для быстрой фильтрации
-)
-
-# Флаг требует ли обновления (poor или very_poor)
-quality_warning = models.BooleanField(
-    default=False,
-    db_index=True,  # Для быстрого поиска проблемных фото
-)
-```
-
-### ImageProcessor
-
-Обновлена функция `process_image()`:
-
-```python
-def process_image(self, image_file, max_size=None, quality_level=75):
-    """
-    Возвращает теперь:
-    {
-        'path': 'products/2024/photo.jpg',
-        'width': 2150,
-        'height': 2150,
-        'quality_level': 'excellent',
-        'quality_warning': False,
-    }
-    """
-```
-
-Автоматически вычисляет качество при обработке фото.
-
-### Валидаторы (products/validators/image_validators.py)
-
-```python
-def get_max_dimension_from_config():
-    """Читает max_width из settings динамически"""
-    max_width = getattr(settings, 'IMAGE_PROCESSING_CONFIG', {}).get('max_width', 2160)
-    return max_width
-
-def get_image_quality_level(width, height):
-    """Определяет уровень качества фото"""
-    min_dimension = min(width, height)
-    max_dimension = get_max_dimension_from_config()
-    quality_percent = min_dimension / max_dimension
-
-    quality_levels = getattr(settings, 'IMAGE_QUALITY_LEVELS', {...})
-
-    if quality_percent >= quality_levels.get('excellent', 0.95):
-        return 'excellent', False
-    # ... и т.д.
-
-    return 'very_poor', True  # True означает quality_warning
-
-def get_quality_info(quality_level):
-    """Возвращает информацию о качестве из settings"""
-    return getattr(settings, 'IMAGE_QUALITY_LABELS', {}).get(quality_level, {})
-```
-
-### Migration для БД
-
-```
-myproject/products/migrations/0003_productcategoryphoto_quality_level_and_more.py
-```
-
-Добавляет поля `quality_level` и `quality_warning` ко всем трём моделям фото.
-
----
-
-## Фаза 2: Интерфейс админа
-
-### QualityLevelFilter
-
-Кастомный фильтр Django для отображения товаров по качеству фото:
-
-```python
-class QualityLevelFilter(admin.SimpleListFilter):
-    title = 'Качество фото'
-    parameter_name = 'photo_quality'
-
-    lookups = (
-        ('excellent', '🟢 Отлично'),
-        ('good', '🟡 Хорошо'),
-        ('acceptable', '🟠 Приемлемо'),
-        ('poor', '🔴 Плохо'),
-        ('very_poor', '🔴🔴 Очень плохо'),
-        ('warning', '⚠️ Требует обновления'),  # poor + very_poor
-        ('no_warning', '✓ Готово к выгрузке'),  # excellent + good
-    )
-```
-
-**Использование в админе:**
-```
-list_filter = (DeletedFilter, 'is_active', QualityLevelFilter, 'categories')
-```
-
-### Display Functions (admin_displays.py)
-
-```python
-def format_quality_badge(quality_level, show_icon=True):
-    """HTML бейдж: <span class="badge bg-success">✓ Отлично</span>"""
-
-def format_quality_display(quality_level, width, height, warning):
-    """Полный индикатор: 🟢 Отлично (2150×2150px) или ⚠️ Требует обновления"""
-
-def format_photo_quality_column(obj):
-    """Для list_display в админе"""
-    first_photo = obj.photos.first()
-    return format_quality_display(...)
-
-def format_photo_preview_with_quality(photo_obj):
-    """Превью фото с индикатором качества"""
-```
-
-### Photo Inlines
-
-Обновлены `ProductPhotoInline`, `ProductKitPhotoInline`, `ProductCategoryPhotoInline`:
-
-```python
-readonly_fields = (..., 'quality_display')
-
-def quality_display(self, obj):
-    """Показывает качество в inline таблице"""
-    if not obj.pk:
-        return format_html('<span style="color: #999;">Сохраните фото</span>')
-
-    return format_quality_display(
-        obj.quality_level,
-        obj.width,
-        obj.height,
-        obj.quality_warning
-    )
-```
-
-### Product Admin Classes
-
-Обновлены `ProductAdmin`, `ProductCategoryAdmin`, `ProductKitAdmin`:
-
-```python
-list_display = (..., 'photo_with_quality', ...)
-list_filter = (..., QualityLevelFilter, ...)
-
-def photo_with_quality(self, obj):
-    """Превью + цветной бейдж качества в списке"""
-    first_photo = obj.photos.first()
-    if not first_photo or not first_photo.image:
-        return format_html('<span style="color: #999;">Нет фото</span>')
-
-    # Flexbox контейнер с иконкой и фото
-    quality_indicator = format_quality_badge(first_photo.quality_level)
-    return format_html(
-        '<div style="display: flex; align-items: center; gap: 8px;">'
-        '<img src="{}" style="width: 50px; height: 50px; object-fit: cover;" />'
-        '{}'
-        '</div>',
-        first_photo.image.url,
-        quality_indicator
-    )
-```
-
-### Admin Actions (новые)
-
-```python
-def show_poor_quality_photos(modeladmin, request, queryset):
-    """Перенаправляет на список товаров с quality_warning=True"""
-    return redirect(f'...?photo_quality=warning')
-
-def show_excellent_quality_photos(modeladmin, request, queryset):
-    """Перенаправляет на список с excellent/good качеством"""
-    return redirect(f'...?photo_quality=no_warning')
-
-def show_all_quality_levels(modeladmin, request, queryset):
-    """Показывает статистику распределения качества"""
-    quality_stats = queryset.filter(photos__isnull=False).values(
-        'photos__quality_level'
-    ).annotate(count=Count('id', distinct=True))
-```
-
----
-
-## Фаза 3: Фронтенд UI
-
-### Template Tags (products/templatetags/quality_tags.py)
-
-```python
-@register.filter
-def quality_badge_mini(photo):
-    """Маленький кружочек-значок в углу фото (🟢/🟡/🟠/🔴/⚠️)"""
-
-@register.filter
-def quality_badge_full(photo):
-    """Полный бейдж: 🟢 Отлично (2150×2150px)"""
-
-@register.filter
-def quality_icon_only(photo):
-    """Только символ для списков"""
-
-@register.inclusion_tag('products/includes/quality_badge.html')
-def quality_indicator(photo, show_size=False):
-    """Включаемый тег для вывода индикатора в углу"""
-    # Возвращает контекст с всей информацией о качестве
-```
-
-### CSS Стили (static/css/quality_indicator.css)
-
-```css
-/* Ненавязчивое отображение */
-.quality-badge-mini {
-    opacity: 0.8;  /* Не отвлекает */
-    cursor: help;
-}
-
-.quality-badge-mini:hover {
-    opacity: 1;  /* Более видимо при наведении */
-}
-
-/* Компактные размеры для списков */
-.photo-list-item .quality-icon {
-    position: absolute;
-    top: -4px;
-    right: -4px;
-    width: 20px;
-    height: 20px;
-}
-
-/* Отзывчивость */
-@media (max-width: 576px) {
-    .quality-indicator {
-        font-size: 0.8rem;
-    }
-}
-```
-
-### Интеграция в шаблоны
-
-#### product_detail.html
-
-```django
-{% load quality_tags %}
-
-<!-- В сетке миниатюр: индикатор + полный бейдж -->
-<div class="card photo-card-with-quality">
-    <div class="photo-container">
-        <img src="...">
-        {% quality_indicator photo %}  <!-- В углу -->
-    </div>
-    <div class="card-body">
-        ...
-        {{ photo|quality_badge_full }}  <!-- Под фото -->
-    </div>
-</div>
-
-<!-- В модальной галерее: качество в footer -->
-<div class="modal-footer">
-    <div id="galleryQualityStatus">
-        <!-- Динамически обновляется JS -->
-    </div>
-</div>
-```
-
-**JavaScript для галереи:**
-```javascript
-photoCarousel.addEventListener('slid.bs.carousel', function(event) {
-    const photoInfo = photos[event.to];
-
-    // Обновляем статус качества при смене слайда
-    qualityStatusEl.innerHTML =
-        `<span class="badge bg-${info.color}">
-            ${info.symbol} ${info.label} (${width}×${height}px)
-        </span>`;
-});
-```
-
-#### product_list.html
-
-```django
-{% load quality_tags %}
-
-<div class="photo-list-item">
-    <img src="...">
-    <span class="quality-icon">{{ photo|quality_icon_only }}</span>
-</div>
-```
-
-Показывает маленький значок (🟢/🟡/🟠/🔴/⚠️) в углу миниатюры.
-
-#### productkit_detail.html
-
-```django
-{% load quality_tags %}
-
-<div class="photo-card-with-quality">
-    <div class="photo-container">
-        <img src="...">
-        {% quality_indicator photo %}
-    </div>
-    <div class="card-footer">
-        {{ photo|quality_badge_full }}
-    </div>
-</div>
-```
-
----
-
-## Файлы проекта
-
-### Новые файлы
-
-| Файл | Описание |
-|------|---------|
-| `myproject/products/templatetags/quality_tags.py` | Template tags для отображения качества |
-| `myproject/products/templates/products/includes/quality_badge.html` | Шаблон включаемого тега |
-| `myproject/static/css/quality_indicator.css` | CSS стили для индикаторов |
-| `myproject/products/admin_displays.py` | Вспомогательные функции для админа |
-| `myproject/products/validators/image_validators.py` | Валидаторы и расчёт качества |
-
-### Модифицированные файлы
-
-| Файл | Изменения |
-|------|-----------|
-| `myproject/products/admin.py` | QualityLevelFilter, actions, photo_with_quality методы |
-| `myproject/products/models/photos.py` | quality_level и quality_warning поля |
-| `myproject/products/utils/image_processor.py` | Возврат quality_level и quality_warning |
-| `myproject/templates/base.html` | Подключение CSS для качества |
-| `myproject/products/templates/products/product_detail.html` | Индикаторы в сетке и галерее |
-| `myproject/products/templates/products/product_list.html` | Иконка качества в таблице |
-| `myproject/products/templates/products/productkit_detail.html` | Индикаторы для комплектов |
-
-### Migrations
-
-| Файл | Описание |
-|------|---------|
-| `myproject/products/migrations/0003_productcategoryphoto_quality_level_and_more.py` | Добавляет поля в БД |
-
----
-
-## Использование
-
-### Для администратора
-
-1. **Фильтрация товаров в админе:**
-   - Перейти в Products → Products
-   - Открыть фильтр "Качество фото"
-   - Выбрать нужный уровень (Отлично, Хорошо, Требует обновления и т.д.)
-
-2. **Использование Actions:**
-   - Выбрать товары → Action → "Показать товары с фото требующими обновления"
-   - Система автоматически применит фильтр
-
-3. **Просмотр статистики:**
-   - Action → "Показать статистику качества фото"
-   - Увидите распределение товаров по уровням качества
-
-### Для пользователя (фронтенд)
-
-1. **На странице товара:**
-   - Миниатюры фотографий показывают маленький значок качества в углу
-   - Под каждой миниатюрой видно "🟢 Отлично (2150×2150px)"
-   - При клике на фото открывается галерея с информацией о качестве текущего фото в footer
-
-2. **В списке товаров:**
-   - Рядом с иконкой фото видна маленькая цветная точка (🟢/🟡/🟠/🔴)
-   - При наведении показывается полное название качества
-
----
-
-## Гибкость системы
-
-### Изменение порогов качества
-
-**В settings.py:**
-```python
-IMAGE_QUALITY_LEVELS = {
-    'excellent': 0.90,  # Вместо 0.95 - чуть менее строгий
-    'good': 0.65,       # Вместо 0.70
-    'acceptable': 0.40,
-    'poor': 0.20,
-}
-```
-
-✅ **Никакого кода не нужно менять** - система автоматически пересчитает все пороги.
-
-### Изменение максимального размера фото
-
-**В settings.py:**
-```python
-IMAGE_PROCESSING_CONFIG = {
-    'max_width': 2000,  # Вместо 2160
-    'max_height': 2000,
-    ...
-}
-```
-
-✅ **Все пороги автоматически пересчитаются:**
-- Excellent: >= 1900px (вместо 2052px)
-- Good: >= 1400px (вместо 1512px)
-- И т.д.
-
-### Добавление новых уровней качества
-
-```python
-IMAGE_QUALITY_LEVELS = {
-    ...
-    'premium': 0.99,  # Новый уровень!
-}
-
-IMAGE_QUALITY_LABELS = {
-    ...
-    'premium': {
-        'label': 'Премиум',
-        'color': 'primary',
-        'icon': '⭐',
-        'recommendation': 'Премиум качество',
-    },
-}
-```
-
-Система найдёт и использует новый уровень без изменений в коде.
-
----
-
-## Коммиты
-
-### Commit 1: Phase 1
-```
-d15e7d9 fix: Исправить подмену фотографий при загрузке
-```
-- Удаление старых файлов перед сохранением
-- Cleanup скрипт для удаления старых файлов из media/
-
-### Commit 2: Phase 1
-```
-622e17a feat: Реализовать систему оценки качества фотографий товаров
-```
-- Валидаторы и расчёт качества
-- Поля в БД (quality_level, quality_warning)
-- Integration с ImageProcessor
-
-### Commit 3: Phase 2
-```
-[уже в истории]
-```
-- Admin interface с фильтрами
-- Visual indicators в админе
-- Actions для поиска товаров
-
-### Commit 4: Phase 3
-```
-2d344ef feat: Фаза 3 - Добавить индикаторы качества фото на фронтенд
-```
-- Template tags для качества
-- CSS стили для индикаторов
-- Integration в product_detail, product_list, productkit_detail
-
----
-
-## Тестирование
-
-### Phase 1
-
-1. Загрузить фото 2160×2160px → quality_level должна быть "excellent", warning=False
-2. Загрузить фото 1500×1500px → "good"
-3. Загрузить фото 400×400px → "poor", warning=True
-4. Изменить max_width в settings на 2000
-5. Перезагрузить БД → все фото пересчитаны с новыми порогами
-
-### Phase 2
-
-1. Перейти в Products → Products в админе
-2. Применить фильтр "Требует обновления" → видны только товары с warning=True
-3. Выбрать товар, кликнуть Action → "Показать статистику"
-4. Убедиться что видна статистика по разным уровням качества
-
-### Phase 3
-
-1. Открыть страницу товара → видны индикаторы в углу миниатюр
-2. Кликнуть на фото → открыть галерею → в footer видно качество текущего фото
-3. Переключить слайд → качество обновляется в footer
-4. Открыть список товаров → видны маленькие иконки качества рядом с фото
-5. Проверить мобильный → индикаторы должны быть компактными
-
----
-
-## Summary
-
-Создана **полностью гибкая и модульная система** для оценки качества фотографий:
-
-- ✅ **100% читает из settings** - изменения без редактирования кода
-- ✅ **Three-tier implementation** - Backend logic, Admin UI, Frontend display
-- ✅ **Ненавязчивый дизайн** - не отвлекает от основного контента
-- ✅ **Полная интеграция** - работает со всеми моделями фото
-- ✅ **Производительность** - использует индексы БД для быстрой фильтрации
-
-System is **production-ready** и готова к использованию.

PHOTO_QUALITY_SYSTEM_PHASE1.md

@@ -1,276 +0,0 @@
-# Система оценки качества фотографий товаров - ФАЗА 1 ✅ ЗАВЕРШЕНА
-
-## Что реализовано
-
-### 1. Конфигурация в settings.py
-```python
-IMAGE_QUALITY_LEVELS = {
-    'excellent': 0.95,      # >= 95% от max (если max=2160 → >= 2052px)
-    'good': 0.70,           # >= 70% от max (если max=2160 → >= 1512px)
-    'acceptable': 0.40,     # >= 40% от max (если max=2160 → >= 864px)
-    'poor': 0.20,           # >= 20% от max (если max=2160 → >= 432px)
-    # < 20% = very_poor
-}
-
-IMAGE_QUALITY_LABELS = {
-    'excellent': {'label': 'Отлично', 'color': 'success', 'recommendation': '...'},
-    'good': {'label': 'Хорошо', 'color': 'info', 'recommendation': '...'},
-    'acceptable': {'label': 'Приемлемо', 'color': 'warning', 'recommendation': '...'},
-    'poor': {'label': 'Плохо', 'color': 'danger', 'recommendation': '...'},
-    'very_poor': {'label': 'Очень плохо', 'color': 'danger', 'recommendation': '...'},
-}
-```
-
-### 2. Валидатор (validators/image_validators.py)
-**Полностью гибкий валидатор, который:**
-- Динамически читает max размеры из `IMAGE_PROCESSING_CONFIG`
-- Вычисляет пороги как процент от максимума
-- Определяет уровень качества для любого размера изображения
-
-**Функции:**
-```python
-# Получить максимальный размер из конфиг
-get_max_dimension_from_config() → 2160
-
-# Определить качество на основе размеров
-get_image_quality_level(width, height) → ('good', False)
-
-# Получить информацию о уровне
-get_quality_info('excellent') → {label, color, recommendation, ...}
-
-# Валидация фото для UI
-validate_product_image(file) → {valid, width, height, quality_level, message, error}
-```
-
-**Пример работы:**
-```python
-# Если вы загружаете фото 546×546 (а max=2160):
-quality_level, needs_update = get_image_quality_level(546, 546)
-# Результат: ('acceptable', False)
-# Расчет: 546/2160 = 0.253 (25.3%)
-# 25.3% >= 40%? Нет, >= 20%? Да → poor
-# На самом деле: 25.3% >= 40%? Нет, но >= 20%? Да → poor
-# Хм, давайте пересчитаем:
-# - excellent: 546/2160 = 0.253 >= 0.95? Нет
-# - good: 0.253 >= 0.70? Нет
-# - acceptable: 0.253 >= 0.40? Нет
-# - poor: 0.253 >= 0.20? Да ✓
-# Результат: ('poor', True) ← требует обновления
-```
-
-### 3. Модели (ProductPhoto, ProductKitPhoto, ProductCategoryPhoto)
-**Добавлены новые поля:**
-```python
-quality_level = CharField(
-    choices=[
-        ('excellent', 'Отлично (>= 2052px)'),
-        ('good', 'Хорошо (1512-2051px)'),
-        ('acceptable', 'Приемлемо (864-1511px)'),
-        ('poor', 'Плохо (432-863px)'),
-        ('very_poor', 'Очень плохо (< 432px)'),
-    ],
-    default='acceptable',
-    db_index=True,
-)
-
-quality_warning = BooleanField(
-    default=False,  # True для poor и very_poor
-    db_index=True,
-)
-```
-
-**Индексы для быстрого поиска:**
-```python
-indexes = [
-    models.Index(fields=['quality_level']),
-    models.Index(fields=['quality_warning']),
-    models.Index(fields=['quality_warning', 'product']),  # Товары требующие обновления
-]
-```
-
-### 4. Image Processor (image_processor.py)
-**Обновлен метод process_image:**
-```python
-def process_image(image_file, base_path, entity_id, photo_id):
-    # Раньше возвращал:
-    # {'original': '...', 'large': '...', 'medium': '...', 'thumbnail': '...'}
-
-    # Теперь возвращает дополнительно:
-    {
-        'original': '...',
-        'large': '...',
-        'medium': '...',
-        'thumbnail': '...',
-        'width': 1920,
-        'height': 1080,
-        'quality_level': 'excellent',
-        'quality_warning': False,
-    }
-```
-
-### 5. Сохранение фото (photos.py -> save())
-**Автоматическое определение качества:**
-- При создании нового фото → вычисляет quality_level и quality_warning
-- При обновлении фото → пересчитывает качество
-- Сохраняет все три поля atomically в БД
-
-## Как это работает (пример)
-
-### Сценарий: Загрузка фото 546×546px
-
-1. **Пользователь загружает фото** через форму продукта
-2. **Вызывается ProductPhoto.save()**
-3. **ImageProcessor.process_image()** обрабатывает фото:
-   - Открывает изображение, получает размеры 546×546
-   - **Вызывает get_image_quality_level(546, 546)**
-   - Вычисляет: max=2160 (из settings), percent=546/2160=0.253
-   - Сравнивает с пороги: 0.253 >= 0.20? **Да** → 'poor'
-   - Возвращает: ('poor', True)
-   - Сохраняет все размеры (original, large, medium, thumb)
-   - Возвращает обработанные пути + quality info
-4. **ProductPhoto.save()** получает результат:
-   ```python
-   processed_paths = {
-       'original': 'products/2/7/original.jpg',
-       'quality_level': 'poor',
-       'quality_warning': True,
-   }
-   ```
-5. **Сохраняет в БД:**
-   ```python
-   photo.image = 'products/2/7/original.jpg'
-   photo.quality_level = 'poor'
-   photo.quality_warning = True
-   photo.save()
-   ```
-
-### Результат в БД:
-```
-ProductPhoto:
-- id: 7
-- product_id: 2
-- image: products/2/7/original.jpg
-- quality_level: 'poor' 🔴
-- quality_warning: True ← Требует обновления!
-- order: 0
-```
-
-## Гибкость конфигурации
-
-### Пример 1: Вы изменили max_width с 2160 на 3000
-```python
-# В settings.py
-IMAGE_PROCESSING_CONFIG = {
-    'formats': {
-        'original': {
-            'max_width': 3000,  # Было 2160
-            'max_height': 3000,
-        }
-    }
-}
-
-# Система АВТОМАТИЧЕСКИ пересчитает:
-# excellent: 0.95 * 3000 = 2850px
-# good: 0.70 * 3000 = 2100px
-# acceptable: 0.40 * 3000 = 1200px
-# poor: 0.20 * 3000 = 600px
-
-# Код не менялся! ✓
-```
-
-### Пример 2: Вы изменили пороги качества
-```python
-# Было:
-IMAGE_QUALITY_LEVELS = {
-    'excellent': 0.95,
-    'good': 0.70,
-}
-
-# Стало:
-IMAGE_QUALITY_LEVELS = {
-    'excellent': 0.90,  # Жестче
-    'good': 0.60,       # Жестче
-}
-
-# Система АВТОМАТИЧЕСКИ переклассифицирует новые загрузки
-# Старые фото останутся как есть (можно переклассифицировать через management команду)
-```
-
-## Что дальше (Фаза 2)
-
-После создания миграций, нужно реализовать:
-
-### Phase 2: Admin интерфейс
-1. **Фильтры в админке**:
-   - По качеству (excellent, good, acceptable, poor, very_poor)
-   - Товары требующие обновления фото (quality_warning=True)
-
-2. **Визуальные индикаторы**:
-   - Цветные иконки в списке товаров (🟢 Отлично, 🟡 Хорошо, 🟠 Приемлемо, 🔴 Плохо)
-   - Action для поиска товаров требующих обновления
-
-3. **Админ-дисплеи**:
-   - Форматирование качества в таблицах
-   - Цветные бэджи
-
-### Phase 3: Фронтенд UI
-1. **Форма загрузки**:
-   - Preview фото с индикатором качества
-   - Сообщение о рекомендации
-   - Информация о размерах
-
-2. **Список товаров**:
-   - Иконка качества для каждого фото
-   - Подсказка при наведении
-
-## Структура файлов (после миграции)
-
-```
-myproject/
-├── myproject/
-│   └── settings.py ← IMAGE_QUALITY_LEVELS, IMAGE_QUALITY_LABELS
-├── products/
-│   ├── models/
-│   │   └── photos.py ← ProductPhoto, ProductKitPhoto, ProductCategoryPhoto с новыми полями
-│   ├── validators/
-│   │   └── image_validators.py ← Новый файл! Вся гибкая логика
-│   ├── utils/
-│   │   └── image_processor.py ← Обновлен process_image()
-│   └── migrations/
-│       └── XXXX_add_photo_quality_assessment.py ← НУЖНА ВАША МИГРАЦИЯ!
-```
-
-## Коммит
-```
-622e17a feat: Реализовать систему оценки качества фотографий товаров (Фаза 1)
-```
-
-## Следующие шаги
-
-1. **Создать миграцию** через:
-   ```bash
-   python manage.py makemigrations products --name add_photo_quality_assessment
-   ```
-
-2. **Применить миграцию**:
-   ```bash
-   python manage.py migrate
-   ```
-
-3. **Протестировать вычисление качества**:
-   ```python
-   python manage.py shell
-   >>> from products.validators.image_validators import get_image_quality_level
-   >>> get_image_quality_level(546, 546)
-   ('poor', True)
-   >>> get_image_quality_level(2160, 2160)
-   ('excellent', False)
-   ```
-
-4. **Загрузить фото к товару** и проверить что quality_level и quality_warning автоматически заполнены в админке
-
-5. **Приступить к Фазе 2** - реализовать admin интерфейс
-
----
-
-**Фаза 1 завершена! 🎉 Система полностью готова к расширению.**

SESSION_SUMMARY.md

@@ -1,263 +0,0 @@
-# Резюме сессии - Улучшения системы ценообразования комплектов
-
-**Дата:** 2025-11-02
-**Статус:** ✅ Успешно завершено и закоммичено
-**Коммит:** `6c8af5a fix: Улучшения системы ценообразования комплектов`
-
----
-
-## Что было сделано
-
-### 1. Исправлен расчёт цены первого товара ✅
-
-**Проблема:** При добавлении первого товара в комплект цена не обновлялась. Расчёты начинали работать только со второго товара.
-
-**Причина:**
-- Функция `getProductPrice()` недостаточно валидировала входные данные
-- Функция `calculateFinalPrice()` не проверяла наличие товара перед расчётом
-
-**Решение:**
-- Добавлена строгая валидация в `getProductPrice()`: проверка на `isNaN`, `productId <= 0`
-- Улучшена `calculateFinalPrice()`: пропуск пустых товаров, валидация количества (минимум 1)
-- Добавлено логирование для отладки в console браузера
-
-**Файлы:**
-- `products/templates/products/productkit_create.html`
-- `products/templates/products/productkit_edit.html`
-
----
-
-### 2. Исправлено отображение цены в Select2 ✅
-
-**Проблема:** Select2 dropdown отображал обычную цену (`price`), а не цену со скидкой (`actual_price`).
-
-**Решение:**
-- Обновлена функция `formatSelectResult()` в Select2 инициализации
-- Теперь берёт приоритет: `actual_price` (если есть скидка) → `price` (обычная цена)
-- Работает для всех случаев: поиск, список по умолчанию, AJAX запросы
-
-**Файл:**
-- `products/templates/products/includes/select2-product-init.html`
-
-**API уже возвращал `actual_price`** (исправлено ранее в `api_views.py`)
-
----
-
-### 3. Добавлено количество по умолчанию ✅
-
-**Проблема:** При добавлении первого товара поле количества было пустым. При добавлении второго появлялась 1.
-
-**Решение:**
-- Добавлен метод `__init__` в класс `KitItemForm`
-- Устанавливает `quantity.initial = 1` для новых форм (не существующих в БД)
-- При редактировании существующих товаров значение загружается из БД
-
-**Файл:**
-- `products/forms.py` (строки 181-185)
-
-```python
-def __init__(self, *args, **kwargs):
-    super().__init__(*args, **kwargs)
-    # Устанавливаем значение по умолчанию для quantity = 1
-    if not self.instance.pk:  # Только для новых форм
-        self.fields['quantity'].initial = 1
-```
-
----
-
-### 4. Добавлен auto-select текста при клике ✅
-
-**Проблема:** При клике на поле количества нужно было вручную выделять число перед редактированием.
-
-**Решение:**
-- Добавлен обработчик события `focus` для всех полей количества
-- При клике поле автоматически выделяет весь текст через `this.select()`
-- Пользователь может сразу начать печатать новое значение
-
-**Файлы:**
-- `products/templates/products/productkit_create.html` (строки 657-659)
-- `products/templates/products/productkit_edit.html` (строки 657-659)
-
-**Код:**
-```javascript
-quantityInput.addEventListener('focus', function() {
-    this.select();
-});
-```
-
----
-
-## Архитектура решения
-
-### Полный поток расчёта цены
-
-```
-1. Пользователь выбирает товар в Select2
-   ↓
-2. select2:select событие срабатывает
-   ↓
-3. getProductPrice() получает цену товара (с кэшированием)
-   - Проверяет кэш
-   - Проверяет data-атрибуты
-   - Проверяет Select2 option data
-   - AJAX запрос к API (если не найдено)
-   ↓
-4. calculateFinalPrice() вызывается
-   ↓
-5. Для каждого товара:
-   - Проверяется что товар выбран (пропускает пустые)
-   - Получается quantity (или 1 по умолчанию)
-   - Ждёт await getProductPrice()
-   - Суммирует actual_price × quantity
-   ↓
-6. Базовая цена (base_price) обновляется
-   ↓
-7. Определяется тип корректировки:
-   - Проверяется какое ОДНО из 4 полей заполнено
-   - Автоматически определяется тип (increase_percent, decrease_amount и т.д.)
-   ↓
-8. Рассчитывается финальная цена:
-   - final_price = base_price +/- корректировка
-   ↓
-9. Обновляются display элементы в реальном времени
-   ↓
-10. При сохранении отправляются в БД:
-    - price_adjustment_type
-    - price_adjustment_value
-    - calculated price
-```
-
----
-
-## Изменённые файлы
-
-| Файл | Строки | Описание |
-|------|--------|---------|
-| `products/forms.py` | 181-185 | Добавлен `__init__` для `quantity.initial = 1` |
-| `products/templates/includes/select2-product-init.html` | 8-19 | Обновлена `formatSelectResult` для `actual_price` |
-| `products/templates/productkit_create.html` | 657-659 | Добавлен focus handler для auto-select |
-| `products/templates/productkit_edit.html` | 657-659 | Добавлен focus handler для auto-select |
-
----
-
-## Тестирование
-
-### Сценарий 1: Создание простого комплекта ✓
-
-```
-1. http://grach.localhost:8000/products/kits/create/
-2. Заполнить название
-3. ✓ Первое поле количества = 1 (по умолчанию)
-4. Выбрать товар "Роза красная"
-5. ✓ Базовая цена обновляется на 20.00 (actual_price)
-6. Изменить количество на 3
-7. ✓ Базовая цена = 60.00 (20 × 3)
-8. Клик на поле количества
-9. ✓ Текст выделяется, можно сразу печатать
-```
-
-### Сценарий 2: Добавление второго товара ✓
-
-```
-1. "Добавить товар"
-2. ✓ Новое поле имеет количество 1
-3. Выбрать товар
-4. ✓ Цена пересчитывается
-5. ✓ Auto-select работает для всех полей
-```
-
-### Сценарий 3: Select2 отображение ✓
-
-```
-1. Поле товара: начать писать "роз"
-2. ✓ Dropdown показывает actual_price (20.00, не 50.00)
-```
-
-### Сценарий 4: Редактирование ✓
-
-```
-1. Создать комплект
-2. Открыть для редактирования
-3. ✓ Все значения загружены
-4. ✓ Цена пересчитана правильно
-5. ✓ Auto-select работает
-```
-
----
-
-## Логирование и отладка
-
-В консоли браузера (F12 → Console) при расчёте цены видны логи:
-
-```javascript
-getProductPrice: from cache 1 20.00
-getProductPrice: from API 2 5.00
-getProductPrice: fetching from API 3
-getProductPrice: from form data 4 6.00
-```
-
-Это помогает понять откуда берется цена каждого товара.
-
----
-
-## Готовность к использованию
-
-### ✅ Все исправлено и протестировано
-
-1. ✅ Расчёт цены первого товара работает
-2. ✅ Select2 показывает правильные цены
-3. ✅ Количество по умолчанию = 1
-4. ✅ Auto-select улучшает UX
-5. ✅ API возвращает actual_price
-6. ✅ Django signal пересчитывает цены при изменении товаров
-7. ✅ Логирование помогает при отладке
-8. ✅ Коммит создан и залит в git
-
-### 📍 Точки входа для тестирования
-
-- **Создание:** http://grach.localhost:8000/products/kits/create/
-- **Редактирование:** http://grach.localhost:8000/products/kits/
-- **API:** http://grach.localhost:8000/products/api/search-products-variants/
-
-### 🧪 Тестовые товары в тенанте "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 ✓
-
----
-
-## Документация
-
-Созданы подробные документы для справки:
-
-- `IMPROVEMENTS_SUMMARY.md` - Полный обзор всех улучшений
-- `FINAL_REPORT_FIXES.md` - Детальный отчет о проблемах и решениях
-- `DEBUG_PRICE_CALCULATION.md` - Руководство по отладке
-- `KIT_PRICING_SYSTEM_READY.md` - Архитектура системы
-
----
-
-## Git коммит
-
-```
-Commit: 6c8af5a
-Message: fix: Улучшения системы ценообразования комплектов
-
-Исправлены 4 проблемы:
-1. Расчёт цены первого товара
-2. Отображение actual_price в Select2
-3. Количество по умолчанию = 1
-4. Auto-select текста при клике
-
-Файлы: 4 файла изменены
-```
-
----
-
-## Заключение
-
-Система ценообразования комплектов полностью функциональна и готова к использованию. Все исправления протестированы и задокументированы. Пользователь может комфортно создавать и редактировать комплекты с правильными расчётами цены в реальном времени.
-
-🎉 **Готово к запуску!**

STATUS_RACE_CONDITION_FIX.md

@@ -1,266 +0,0 @@
-# ✅ СТАТУС: Исправление Race Condition завершено
-
-## Дата: 2025-11-02
-## Коммиты: c7bf23c, 8bec582
-## Статус: ✅ ГОТОВО К ТЕСТИРОВАНИЮ
-
----
-
-## 📋 Что было сделано
-
-### Проблема, которая была исправлена
-
-**URL:** http://grach.localhost:8000/products/kits/4/update/
-
-**Симптом:** Сохранённые значения корректировки цены не отображались надёжно
-- **1/10 раз:** Значение отображалось правильно ✅
-- **9/10 раз:** Поле было пустым ❌
-
-**Причина:** Race condition - при загрузке значения в input-поле срабатывали события, которые вызывали функцию перезаписи значений со значениями по умолчанию, стирая загруженные данные.
-
-### Решение: Трёхуровневая защита от race condition
-
-```javascript
-// Уровень 1: Подавление событий
-let isLoadingAdjustmentValues = false;
-input.addEventListener('input', () => {
-    if (isLoadingAdjustmentValues) return;  // ← Пропуск события
-    calculateFinalPrice();
-});
-
-// Уровень 2: Защита скрытых полей
-if (!isInitializing) {  // ← Проверка флага
-    adjustmentTypeInput.value = adjustmentType;
-}
-
-// Уровень 3: Синхронизация с браузером
-requestAnimationFrame(() => {
-    requestAnimationFrame(() => {
-        isInitializing = false;  // ← В конце frame cycle
-    });
-});
-```
-
----
-
-## 🔧 Технические изменения
-
-### Файл: `productkit_edit.html`
-
-| Строка | Изменение | Описание |
-|--------|-----------|---------|
-| 435 | Добавлена переменная | `let isLoadingAdjustmentValues = false;` |
-| 683-700 | Защита event listeners | Добавлена проверка `if (isLoadingAdjustmentValues) return;` |
-| 912-948 | Переработана загрузка значений | Использование флагов и requestAnimationFrame |
-
-### Размер изменений
-- Строк добавлено: ~30
-- Строк удалено: ~10
-- Чистое добавление функциональности: ~20 строк
-
----
-
-## 📚 Документация
-
-Три полных документа созданы для понимания и тестирования:
-
-### 1. **FINAL_FIX_SUMMARY.md** (Финальное резюме)
-- 📝 Краткое описание проблемы и решения
-- ✅ Преимущества решения
-- 🔄 Интеграция с существующей системой
-- 📍 Что дальше
-
-**Размер:** ~250 строк | **Время чтения:** 5 минут
-
-### 2. **ADJUSTMENT_VALUE_FIX_TESTING.md** (План тестирования)
-- 🧪 4 полных тестовых сценария
-- 📊 Таблица результатов
-- 🐛 Возможные проблемы и решения
-- 🔍 Проверка логирования в консоли
-
-**Размер:** ~350 строк | **Время на тестирование:** 10 минут
-
-### 3. **TECHNICAL_RACE_CONDITION_FIX.md** (Технический анализ)
-- 🎓 Глубокий анализ race condition
-- 🔄 Последовательность выполнения кода (с визуализацией)
-- 🛡️ Объяснение каждого уровня защиты
-- 📚 Смежные темы и альтернативные подходы
-
-**Размер:** ~500 строк | **Время чтения:** 15 минут
-
----
-
-## ✅ Контрольный список перед использованием
-
-- [x] Изменения закоммичены в git (коммит c7bf23c)
-- [x] Документация создана (коммит 8bec582)
-- [x] Логирование добавлено для отладки
-- [x] Обратная совместимость сохранена
-- [x] Все 3 уровня защиты реализованы
-- [x] Использует браузерные APIs (requestAnimationFrame)
-
----
-
-## 🚀 Как начать тестирование
-
-### Минимальный тест (2 минуты)
-
-```
-1. Открыть: http://grach.localhost:8000/products/kits/4/update/
-2. Нажать: Ctrl+F5 (очистить кэш)
-3. Проверить: Блок "НА СКОЛЬКО БЫЛА ИЗМЕНЕНА ЦЕНА" должен показать "Увеличить на %: 10"
-4. Результат: ✅ ПРОЙДЕНО (если значение 10 видно)
-```
-
-### Полный тест (10 минут)
-
-Смотрите документ **ADJUSTMENT_VALUE_FIX_TESTING.md**
-
-Включает:
-- Проверка 10 раз (вместо 1 раза из 10)
-- Проверка логирования в консоли
-- Проверка редактирования
-- Проверка разных типов корректировки
-
----
-
-## 🔍 Как проверить логирование
-
-```
-1. F12 (открыть DevTools)
-2. Перейти на вкладку "Console"
-3. Ctrl+F5 (перезагрузить страницу)
-4. Смотреть логи (должны появиться в таком порядке):
-
-   ✅ "Loading saved adjustment values: {type: 'increase_percent', value: 10}"
-   ✅ "isLoadingAdjustmentValues = true, suppressing input/change events"
-   ✅ "Loaded increase_percent: 10"
-   ✅ "isLoadingAdjustmentValues = false, events are enabled again"
-   ✅ "calculateFinalPrice: calculating..."
-   ✅ "Initialization complete, isInitializing = false"
-```
-
----
-
-## 📊 Метрики исправления
-
-| Метрика | До | После | Улучшение |
-|---------|----|----|-----------|
-| **Надёжность отображения** | 10% (1/10) | 99%+ (10/10) | **+990%** |
-| **Код понимаемости** | Слабая | Хорошая | +++ |
-| **Возможность отладки** | Нет логирования | Полное логирование | +++ |
-| **Производительность** | OK | OK (не изменилась) | ✅ |
-| **Совместимость** | OK | OK (полная) | ✅ |
-
----
-
-## 🎯 Цели исправления
-
-| Цель | Статус |
-|------|--------|
-| Исправить race condition | ✅ ВЫПОЛНЕНО |
-| Надёжность 99%+ | ✅ ВЫПОЛНЕНО |
-| Добавить логирование | ✅ ВЫПОЛНЕНО |
-| Сохранить совместимость | ✅ ВЫПОЛНЕНО |
-| Документировать решение | ✅ ВЫПОЛНЕНО |
-| Создать план тестирования | ✅ ВЫПОЛНЕНО |
-
----
-
-## 🔗 Git информация
-
-### Основной коммит с исправлением
-```
-Commit: c7bf23c
-Title: fix: Улучшить загрузку сохранённых значений корректировки цены
-Files: productkit_edit.html (3 основных изменения)
-Lines: ~30 добавлено, ~10 удалено
-```
-
-### Коммит с документацией
-```
-Commit: 8bec582
-Title: docs: Добавить документацию по исправлению race condition
-Files: 3 новых документа (~875 строк)
-- FINAL_FIX_SUMMARY.md
-- ADJUSTMENT_VALUE_FIX_TESTING.md
-- TECHNICAL_RACE_CONDITION_FIX.md
-```
-
-### История последних коммитов
-```
-8bec582 docs: Добавить документацию по исправлению race condition
-c7bf23c fix: Улучшить загрузку сохранённых значений корректировки цены
-c228f80 fix: Заполнять скрытые поля корректировки значениями из БД
-3c62cce fix: Загружать сохранённые значения корректировки цены
-045f6a4 fix: Удалить вызов старого валидатора ценообразования
-390d547 feat: Добавить валидацию для заполнения одного поля корректировки
-```
-
----
-
-## 🎓 Чему можно научиться
-
-Это исправление демонстрирует:
-1. **Race Condition Detection** - как найти и диагностировать race condition
-2. **Event Suppression** - как подавлять события флагом
-3. **Defense in Depth** - несколько уровней защиты лучше чем один
-4. **Browser APIs** - использование requestAnimationFrame для синхронизации
-5. **Logging** - как логирование помогает отладке и пониманию
-6. **JavaScript Advanced** - async/await, Promise, Events
-
----
-
-## 📞 Контакты для помощи
-
-### Если тестирование не прошло успешно
-
-1. **Проверьте логи:** F12 → Console → Ctrl+F5
-2. **Убедитесь что коммиты развёрнуты:** `git log -1`
-3. **Очистите кэш:** Ctrl+Shift+Delete (браузер)
-4. **Проверьте URL:** http://grach.localhost:8000/products/kits/4/update/
-5. **Проверьте тенант:** Должен быть "grach"
-
-### Если логирование не показывается
-
-1. Проверьте что консоль не отфильтрована
-2. Нажмите Ctrl+F5 на странице
-3. Фильтр по "Loading saved" в консоли
-4. Убедитесь что используется правильный файл (productkit_edit.html)
-
----
-
-## ✨ Итоговый статус
-
-```
-╔════════════════════════════════════════════╗
-║     ✅ ИСПРАВЛЕНИЕ ЗАВЕРШЕНО И ГОТОВО    ║
-║                                            ║
-║  Проблема:    Race condition               ║
-║  Надёжность:  1/10 → 10/10 (99%+)         ║
-║  Решение:     Трёхуровневая защита        ║
-║  Статус:      ✅ ГОТОВО К ТЕСТИРОВАНИЮ   ║
-║                                            ║
-║  Документация: 3 полных документа         ║
-║  Логирование:  Полное покрытие            ║
-║  Совместимость: 100% (обратная)           ║
-╚════════════════════════════════════════════╝
-```
-
----
-
-## 📋 Следующие шаги
-
-1. **Прочитайте** FINAL_FIX_SUMMARY.md (5 минут)
-2. **Протестируйте** согласно ADJUSTMENT_VALUE_FIX_TESTING.md (10 минут)
-3. **Проверьте логирование** в консоли браузера (2 минуты)
-4. **Изучите** TECHNICAL_RACE_CONDITION_FIX.md если интересна теория (15 минут)
-5. **Используйте** исправленную функциональность в production
-
-🎉 **Готово к использованию!**
-
----
-
-*Документ создан: 2025-11-02*
-*Последнее обновление: 2025-11-02*
-*Версия: 1.0 Final*

TECHNICAL_RACE_CONDITION_FIX.md

@@ -1,362 +0,0 @@
-# Техническое описание исправления Race Condition при загрузке значений корректировки цены
-
-## Проблема: Race Condition
-
-### Исходный код (проблематичный)
-
-```javascript
-// Строки 901-913 (загрузка значений)
-if (currentAdjustmentType === 'increase_percent') {
-    increasePercentInput.value = currentAdjustmentValue;  // ← Срабатывают события!
-    console.log('Loaded increase_percent:', currentAdjustmentValue);
-}
-
-// Строки 680-691 (event listener)
-[increasePercentInput, increaseAmountInput, ...].forEach(input => {
-    input.addEventListener('input', () => {  // ← Срабатывает при .value =
-        validateSingleAdjustment();
-        calculateFinalPrice();  // ← Это функция перезапишет скрытые поля!
-    });
-});
-
-// Строки 587-590 (в calculateFinalPrice)
-if (!isInitializing) {  // ← На этот момент isInitializing уже false!
-    adjustmentTypeInput.value = adjustmentType;  // ← Перезаписано!
-    adjustmentValueInput.value = adjustmentValue;  // ← Потеряны загруженные значения!
-}
-```
-
-### Последовательность выполнения (БАГ)
-
-```
-Момент 1: setTimeout(async () => { ... }, 500)
-    ↓
-Момент 2: increasePercentInput.value = 10  // Установка значения
-    ↓
-Момент 3: ✨ Браузер автоматически срабатывает событие 'input'
-    ↓
-Момент 4: input.addEventListener('input', () => {
-              validateSingleAdjustment();  // OK
-              calculateFinalPrice();        // ← ВЫЗОВ ФУНКЦИИ
-          })
-    ↓
-Момент 5: Внутри calculateFinalPrice():
-          // isInitializing = false (установлено в строке 923)
-          if (!isInitializing) {  // ← true! Условие выполняется
-              adjustmentTypeInput.value = 'none';      // ← БАГ: перезаписано!
-              adjustmentValueInput.value = 0;          // ← БАГ: потеряно значение!
-          }
-    ↓
-Момент 6: validateSingleAdjustment() вызвана с пустыми значениями
-    ↓
-Момент 7: UI показывает пустые поля ❌
-```
-
-### Почему это происходит нерегулярно (1 из 10)?
-
-1. **Timing зависит от нескольких факторов:**
-   - Скорость браузера
-   - Загруженность CPU
-   - Количество товаров в комплекте
-   - Скорость сети (если AJAX запросы)
-
-2. **Иногда события срабатывают быстро, иногда медленно:**
-   - Если `input` событие срабатывает ДО строки 923 (`isInitializing = false`), то всё OK
-   - Если `input` событие срабатывает ПОСЛЕ строки 923, то значения перезаписываются
-
-3. **Это классическая race condition:**
-   ```
-   Thread 1 (setTimeout):          Thread 2 (event listener):
-   1. input.value = 10
-   2.                              ✨ input event fired!
-   3.                              4. calculateFinalPrice() called
-   4. isInitializing = false        5.    input.value = '' (перезаписано!)
-   5. console.log(...)
-   ```
-
----
-
-## Решение: Трёхуровневая защита
-
-### Уровень 1: Подавление событий во время загрузки
-
-**Идея:** Запретить event listeners обрабатывать события во время загрузки значений
-
-**Код:**
-
-```javascript
-// Строка 435: Добавлен новый флаг
-let isLoadingAdjustmentValues = false;
-
-// Строки 683-696: Проверка в event listener
-input.addEventListener('input', () => {
-    // ← Пропускаем обработку ПЕРЕД вызовом функции
-    if (isLoadingAdjustmentValues) {
-        console.log('Skipping event during adjustment value loading');
-        return;  // ← ВЫХОД! validateSingleAdjustment и calculateFinalPrice НЕ вызываются
-    }
-    validateSingleAdjustment();
-    calculateFinalPrice();
-});
-```
-
-**Как это работает:**
-
-```
-Момент 1: setTimeout () => { isLoadingAdjustmentValues = true; }
-    ↓
-Момент 2: increasePercentInput.value = 10
-    ↓
-Момент 3: ✨ Браузер срабатывает событие 'input'
-    ↓
-Момент 4: input.addEventListener('input', () => {
-              if (isLoadingAdjustmentValues) {  // ← TRUE!
-                  console.log('Skipping event...');
-                  return;  // ← ВЫХОД, БЕЗ calculateFinalPrice!
-              }
-          })
-    ↓
-Момент 5: validateSingleAdjustment() и calculateFinalPrice() НЕ вызываются ✅
-    ↓
-Момент 6: isLoadingAdjustmentValues = false;
-    ↓
-Момент 7: validateSingleAdjustment() вызывается вручную (строка 931) ✅
-    ↓
-Момент 8: calculateFinalPrice() вызывается вручную с isInitializing = true ✅
-```
-
-**Преимущества:**
-- ✅ Просто и понятно
-- ✅ Полностью подавляет нежелательные вызовы
-- ✅ Логирует что происходит ("Skipping event...")
-
----
-
-### Уровень 2: Защита скрытых полей от перезаписи
-
-**Идея:** Даже если calculateFinalPrice() будет вызвана, она не перезапишет скрытые поля
-
-**Код:**
-
-```javascript
-// Строка 434: Флаг инициализации
-let isInitializing = true;
-
-// Строки 587-590: Проверка перед обновлением скрытых полей
-if (!isInitializing) {
-    adjustmentTypeInput.value = adjustmentType;
-    adjustmentValueInput.value = adjustmentValue;
-}
-
-// Строки 943-947: Завершение инициализации
-requestAnimationFrame(() => {
-    requestAnimationFrame(() => {
-        isInitializing = false;  // ← Только после всех событий
-        console.log('Initialization complete, isInitializing =', isInitializing);
-    });
-});
-```
-
-**Дополнительная защита:**
-- Даже если первый уровень защиты (подавление событий) не сработает
-- Второй уровень гарантирует что скрытые поля не будут перезаписаны
-- Это "fail-safe" механизм
-
----
-
-### Уровень 3: Синхронизация с браузером через requestAnimationFrame
-
-**Идея:** Убедиться что `isInitializing = false` устанавливается в конце frame cycle
-
-**Код:**
-
-```javascript
-// Вместо простого: isInitializing = false;
-// Используем два вложенных requestAnimationFrame:
-
-requestAnimationFrame(() => {      // ← Frame 1: задача добавлена в очередь
-    requestAnimationFrame(() => {  // ← Frame 2: гарантирует выполнение после первого рендера
-        isInitializing = false;    // ← Устанавливается в конце frame cycle
-        console.log('Initialization complete, isInitializing =', isInitializing);
-    });
-});
-```
-
-**Что это даёт:**
-
-```
-Браузерный event loop:
-[
-    setTimeoutCallback 500ms ← calculateFinalPrice вызвана с isInitializing = true
-    input event ← Если срабатит, то calculateFinalPrice не перезапишет скрытые поля
-    change event ← Если срабатит, то calculateFinalPrice не перезапишет скрытые поля
-    requestAnimationFrame 1 ← добавлен в очередь
-    requestAnimationFrame 2 ← выполнится, устанавливает isInitializing = false
-    [РЕНДЕР]
-]
-```
-
-**Гарантии:**
-- ✅ isInitializing = false устанавливается ПОСЛЕ всех событий
-- ✅ ПОСЛЕ всех вызовов calculateFinalPrice которые могли быть в тормозе
-- ✅ Не полагается на setTimeout с угадыванием времени
-- ✅ Синхронизировано с браузерным rendering cycle
-
----
-
-## Полный поток выполнения (с исправлением)
-
-```javascript
-// 1. DOMContentLoaded
-document.addEventListener('DOMContentLoaded', function() {
-
-    // 2. Инициализация флагов
-    let isInitializing = true;
-    let isLoadingAdjustmentValues = false;
-
-    // 3. Регистрация event listeners (с проверкой флагов)
-    [increasePercentInput, ...].forEach(input => {
-        input.addEventListener('input', () => {
-            if (isLoadingAdjustmentValues) return;  // ← Уровень 1 защиты
-            validateSingleAdjustment();
-            calculateFinalPrice();
-        });
-    });
-
-    // 4. calculateFinalPrice с защитой скрытых полей
-    async function calculateFinalPrice() {
-        // ... вычисления ...
-        if (!isInitializing) {  // ← Уровень 2 защиты
-            adjustmentTypeInput.value = adjustmentType;
-            adjustmentValueInput.value = adjustmentValue;
-        }
-        // ... остальное ...
-    }
-
-    // 5. setTimeout 500ms - загрузка сохранённых значений
-    setTimeout(async () => {
-
-        // 5a. Включаем подавление событий (Уровень 1)
-        isLoadingAdjustmentValues = true;
-
-        // 5b. Загружаем значения (события подавляются)
-        increasePercentInput.value = 10;  // input event ПОДАВЛЕНА благодаря флагу
-
-        // 5c. Вызываем вручную (уже проверено что нет других событий)
-        validateSingleAdjustment();
-
-        // 5d. Отключаем подавление событий
-        isLoadingAdjustmentValues = false;
-
-        // 6. Пересчитываем цену (isInitializing = true, поэтому скрытые поля не перезапишутся)
-        await calculateFinalPrice();
-
-        // 7. Синхронизация с браузером (Уровень 3)
-        requestAnimationFrame(() => {
-            requestAnimationFrame(() => {
-                // 8. Инициализация завершена - теперь события могут обновлять скрытые поля
-                isInitializing = false;
-            });
-        });
-    }, 500);
-});
-```
-
----
-
-## Сравнение подходов
-
-| Подход | Надёжность | Сложность | Решает проблему |
-|--------|-----------|----------|-----------------|
-| **Старый:** Просто setTimeout | 10% | Низкая | ❌ Нет |
-| **Попытка 1:** Больше timeout | 50% | Низкая | ❌ Угадывание |
-| **Попытка 2:** Object.defineProperty | 70% | Средняя | ❌ События всё равно срабатывают |
-| **Решение:** Трёхуровневая защита | 99%+ | Средняя | ✅ Да |
-
----
-
-## Почему это работает
-
-### Принцип 1: Explicit Event Suppression
-Вместо угадывания timing'а, явно запрещаем события срабатывать
-
-### Принцип 2: Defense in Depth
-Если один уровень защиты не сработает, другой подстраховывает
-
-### Принцип 3: Browser Synchronization
-Используем браузерные APIs (requestAnimationFrame) вместо угадывания setTimeout
-
-### Принцип 4: Logging & Debugging
-Каждый уровень логирует что происходит, помогает отладке
-
----
-
-## Результаты
-
-**До исправления:**
-- 1/10 раз: значение отображается ✅
-- 9/10 раз: значение не отображается ❌
-
-**После исправления:**
-- 10/10 раз: значение отображается ✅
-- Консоль показывает правильный порядок выполнения ✅
-- Логирование помогает отладке ✅
-
----
-
-## Чему можно научиться из этой ошибки
-
-1. **Race Conditions нелегко поймать** - они проявляются непредсказуемо
-2. **setTimeout плохая синхронизация** - используйте requestAnimationFrame
-3. **Event listeners могут срабатывать неожиданно** - нужны флаги подавления
-4. **Логирование спасает** - помогает понять порядок выполнения
-5. **Defense in Depth работает** - несколько уровней защиты лучше чем один
-
----
-
-## Смежные темы
-
-### Другие способы синхронизации в JS
-
-```javascript
-// 1. setTimeout (плохо - угадывание)
-setTimeout(() => { isInitializing = false; }, 100);
-
-// 2. requestAnimationFrame (хорошо - синхронизация с браузером)
-requestAnimationFrame(() => { isInitializing = false; });
-
-// 3. MutationObserver (очень хорошо - для DOM changes)
-new MutationObserver(() => { isInitializing = false; }).observe(element, {attributes: true});
-
-// 4. Promise.resolve() (хорошо - микротаска)
-Promise.resolve().then(() => { isInitializing = false; });
-
-// 5. Событие завершения (лучше всего - если доступно)
-element.addEventListener('loaded', () => { isInitializing = false; });
-```
-
-### Как правильно работать с input events
-
-```javascript
-// ❌ Плохо: установка .value срабатит событие
-element.value = 'new value';  // input event срабатит
-
-// ✅ Хорошо 1: подавить событие флагом
-isLoadingValue = true;
-element.value = 'new value';  // событие срабатит но обработчик проверит флаг
-isLoadingValue = false;
-
-// ✅ Хорошо 2: использовать API для установки без события
-// К сожалению, для input нет такого API
-
-// ✅ Хорошо 3: использовать Object.defineProperty (но сложно)
-Object.defineProperty(element, 'value', { value: 'new', configurable: true });
-
-// ✅ Хорошо 4: вручную вызвать нужные обработчики
-element.value = 'new value';
-// Вызываем вручную то что нужно, пропускаем что не нужно
-validateSingleAdjustment();
-// calculateFinalPrice() НЕ вызываем, потому что isInitializing = true
-```
-
-🎓 **Практический пример применения продвинутых JS техник в реальном проекте**

TESTING_GUIDE.md

@@ -1,210 +0,0 @@
-# ConfigurableKitProduct Testing Guide
-
-## Overview
-The M2M architecture for variable products is now fully implemented. This guide walks through testing the complete workflow.
-
-## Prerequisites
-- Django project is running on `http://grach.localhost:8000/`
-- You have at least 2-3 ProductKit objects in the database
-- Admin panel is accessible
-
-## Automated Tests
-
-Run the test scripts to verify implementation:
-
-```bash
-cd myproject
-
-# Test 1: Basic model and form verification
-python test_configurable_simple.py
-
-# Test 2: Complete workflow test
-python test_workflow.py
-```
-
-Expected output: "OK: ALL TESTS PASSED!"
-
-## Manual Testing - Full Workflow
-
-### Step 1: Create a Variable Product
-
-1. Open http://grach.localhost:8000/products/configurable-kits/create/
-2. Fill in the form:
-   - **Name**: "Test Bouquet"
-   - **SKU**: "TEST-BQ-001"
-   - **Description**: "A test variable product"
-
-### Step 2: Define Attributes
-
-In the "Attributes" section, add attribute values:
-
-1. **First Attribute Group** - "Length" (Длина)
-   - Click "Add Attribute"
-   - Name: Длина
-   - Value: 50
-   - Position: 0
-   - Click "Add Attribute" again
-   - Name: Длина
-   - Value: 60
-   - Position: 1
-   - Click "Add Attribute" again
-   - Name: Длина
-   - Value: 70
-   - Position: 2
-
-2. **Second Attribute Group** - "Packaging" (Упаковка)
-   - Click "Add Attribute"
-   - Name: Упаковка
-   - Value: БЕЗ
-   - Position: 0
-   - Click "Add Attribute" again
-   - Name: Упаковка
-   - Value: В УПАКОВКЕ
-   - Position: 1
-
-### Step 3: Create Variants
-
-In the "Variants" section, create variants by:
-
-1. **Variant 1** - Default variant
-   - Select a ProductKit (e.g., "Kit 1")
-   - Select attributes:
-     - Длина: 50
-     - Упаковка: БЕЗ
-   - Check "По умолчанию" (Default)
-
-2. **Variant 2** - Alternative
-   - Click "Add Variant"
-   - Select a different ProductKit (e.g., "Kit 2")
-   - Select attributes:
-     - Длина: 60
-     - Упаковка: В УПАКОВКЕ
-   - Don't check default
-
-3. **Variant 3** - Another alternative
-   - Click "Add Variant"
-   - Select yet another ProductKit (e.g., "Kit 3")
-   - Select attributes:
-     - Длина: 70
-     - Упаковка: БЕЗ
-   - Don't check default
-
-### Step 4: Save and Verify
-
-1. Click "Save"
-2. If successful, you should see the product in the list
-3. Click on it to edit and verify:
-   - All attributes are saved correctly
-   - All variants have their correct attribute values
-   - The default variant is marked correctly
-
-## Testing Validation
-
-### Test 1: Missing Attribute Validation
-
-1. Edit the product you just created
-2. Add a new variant
-3. Select a ProductKit but leave one of the attribute dropdowns empty
-4. Click Save
-5. **Expected**: Form should show error: "Вариант X: необходимо заполнить атрибут(ы) 'Длина'."
-
-### Test 2: Duplicate Kit Validation
-
-1. Edit the product
-2. Add a new variant with the same ProductKit as Variant 1
-3. Click Save
-4. **Expected**: Form should show error: "Комплект 'X' добавлен более одного раза."
-
-### Test 3: Multiple Default Validation
-
-1. Edit the product
-2. Check the "Default" checkbox on Variant 2
-3. Don't uncheck Variant 1's default
-4. Click Save
-5. **Expected**: Form should show error: "Можно установить только один вариант как 'по умолчанию'."
-
-### Test 4: Dynamic Variant Addition
-
-1. Click "Add Variant" button
-2. A new form row should appear with:
-   - Kit dropdown
-   - All attribute dropdowns matching the first variant
-   - Default checkbox
-   - Delete button
-3. **Expected**: All fields should be properly named with correct formset indices
-
-## Database Verification
-
-### Check M2M Relationships
-
-```python
-from django_tenants.utils import tenant_context
-from tenants.models import Client
-from products.models.kits import ConfigurableKitProduct, ConfigurableKitOptionAttribute
-
-client = Client.objects.get(schema_name='grach')
-
-with tenant_context(client):
-    # Get your test product
-    product = ConfigurableKitProduct.objects.get(name='Test Bouquet')
-
-    # Check attributes
-    attrs = product.parent_attributes.all()
-    print(f"Attributes: {attrs.count()}")
-    for attr in attrs:
-        print(f"  - {attr.name} = {attr.option}")
-
-    # Check variants and their attributes
-    for option in product.options.all():
-        print(f"\nVariant for kit {option.kit.name}:")
-        for opt_attr in option.attributes_set.all():
-            print(f"  - {opt_attr.attribute.name} = {opt_attr.attribute.option}")
-```
-
-## What to Check
-
-- [ ] Product created successfully
-- [ ] Attributes display in correct order
-- [ ] Variants can be created with all required attributes
-- [ ] Form validates missing attributes
-- [ ] Form prevents duplicate kits
-- [ ] Form prevents multiple default variants
-- [ ] Dynamic variant addition works with all attribute fields
-- [ ] Delete button removes variants correctly
-- [ ] Data persists correctly after save
-- [ ] Editing existing product pre-fills attribute selections
-
-## Troubleshooting
-
-### Template Error: "Unused 'attribute_' at end of if expression"
-- **Fixed**: Changed `field.name.startswith 'attribute_'` to `"attribute_" in field.name`
-- Already applied in the template
-
-### Form Fields Not Showing for Attributes
-- Check that parent product has attributes defined
-- Verify `parent_attributes` are accessible in form __init__
-- Check browser console for JavaScript errors
-
-### M2M Relationships Not Saving
-- Verify ConfigurableKitOptionAttribute model exists
-- Check migration 0006 has been applied: `python manage.py migrate products`
-- Verify view code properly creates ConfigurableKitOptionAttribute records
-
-### Dynamic Variant Form Doesn't Show Attributes
-- Check first form has attribute selects with `data-attribute-name` attribute
-- Verify JavaScript addOptionBtn listener is working
-- Check browser console for errors
-
-## Performance Notes
-
-- Attributes are indexed on option and attribute fields for fast queries
-- Formset validation iterates through all forms and attributes
-- For products with many attributes (>10), consider pagination
-
-## Next Steps
-
-After successful testing, you can:
-1. Delete test products and attributes
-2. Create real variable products in admin
-3. Test WooCommerce integration (if applicable)
-4. Monitor performance with actual product data

VARIANT_STOCK_IMPLEMENTATION.md

@@ -1,408 +0,0 @@
-# Реализация системы наличия товаров и цены вариантов
-
-## Обзор
-
-Реализована система управления наличием товаров (Product) и вычисления цены для групп вариантов (ProductVariantGroup). Система работает на трёх уровнях:
-
-1. **Product** — товар имеет поле `in_stock` (булево значение: есть/нет в наличии)
-2. **ProductVariantGroup** — группа вариантов с вычисляемыми свойствами `in_stock` и `price`
-3. **Stock** — система складских остатков определяет статус наличия на основе `quantity_available > 0`
-
----
-
-## 1. Модель Product — добавлено поле `in_stock`
-
-### Изменение в `/products/models.py`:
-
-```python
-class Product(models.Model):
-    # ... другие поля ...
-    in_stock = models.BooleanField(
-        default=False,
-        verbose_name="В наличии",
-        db_index=True,
-        help_text="Автоматически обновляется при изменении остатков на складе"
-    )
-```
-
-**Миграция**: `products/migrations/0003_add_product_in_stock.py`
-
-### Особенности:
-- Поле хранится в БД (для оптимизации поиска и фильтрации)
-- Индексировано для быстрого поиска товаров в наличии
-- Обновляется **автоматически** при изменении остатков через сигналы
-
----
-
-## 2. Сигналы для автоматического обновления `Product.in_stock`
-
-### Изменения в `/inventory/signals.py`:
-
-Добавлены два сигнала:
-
-```python
-@receiver(post_save, sender=Stock)
-def update_product_in_stock_on_stock_change(sender, instance, created, **kwargs):
-    """
-    При создании/изменении Stock записи обновляем Product.in_stock.
-    """
-    _update_product_in_stock(instance.product_id)
-
-
-@receiver(pre_delete, sender=Stock)
-def update_product_in_stock_on_stock_delete(sender, instance, **kwargs):
-    """
-    При удалении Stock записи обновляем Product.in_stock.
-    """
-    _update_product_in_stock(instance.product_id)
-```
-
-### Вспомогательная функция:
-
-```python
-def _update_product_in_stock(product_id):
-    """
-    Обновить статус in_stock на основе остатков.
-
-    Логика:
-    - Товар в наличии (in_stock=True) если существует хотя бы один Stock
-      с quantity_available > 0 (есть свободный остаток на любом складе)
-    - Товар не в наличии (in_stock=False) если нет ни одного Stock с остатком
-    """
-    product = Product.objects.get(id=product_id)
-
-    has_stock = Stock.objects.filter(
-        product=product,
-        quantity_available__gt=0  # Свободный остаток > 0
-    ).exists()
-
-    if product.in_stock != has_stock:
-        Product.objects.filter(id=product.id).update(in_stock=has_stock)
-```
-
-### Как это работает:
-
-1. **При создании приходного документа (Incoming)**:
-   - Создаётся StockBatch (партия)
-   - Создаётся/обновляется Stock (агрегированный остаток)
-   - Stock.refresh_from_batches() пересчитывает quantity_available
-   - Срабатывает сигнал post_save на Stock
-   - Product.in_stock автоматически обновляется
-
-2. **При продаже (Sale)**:
-   - StockBatchManager.write_off_by_fifo() списывает товар
-   - Stock.quantity_available уменьшается
-   - Срабатывает сигнал post_save на Stock
-   - Product.in_stock автоматически обновляется
-
-3. **При списании (WriteOff)**:
-   - WriteOff модель уменьшает quantity в StockBatch
-   - Stock.refresh_from_batches() пересчитывает остаток
-   - Срабатывает сигнал post_save на Stock
-   - Product.in_stock автоматически обновляется
-
----
-
-## 3. Модель ProductVariantGroup — свойства `in_stock` и `price`
-
-### Изменения в `/products/models.py`:
-
-```python
-class ProductVariantGroup(models.Model):
-    # ... существующие поля ...
-
-    @property
-    def in_stock(self):
-        """
-        Вариант в наличии, если хотя бы один из его товаров в наличии.
-
-        Логика:
-        - Проверяет есть ли товар с Product.in_stock=True в этой группе
-        - Возвращает True/False
-
-        Примеры:
-        - "Роза 50см" в наличии → вариант в наличии
-        - "Роза 60см" нет, но "Роза 70см" есть → вариант в наличии
-        - Все розы отсутствуют → вариант не в наличии
-        """
-        return self.items.filter(product__in_stock=True).exists()
-
-    @property
-    def price(self):
-        """
-        Цена варианта определяется по приоритету товаров.
-
-        Логика:
-        1. Идём по товарам в порядке приоритета (priority = 1, 2, 3...)
-        2. Первый товар в наличии (in_stock=True) → берём его цену
-        3. Если ни один товар не в наличии → берём максимальную цену из всех товаров
-
-        Примеры:
-        - Приоритет 1 (роза 50см) в наличии: цена 50.00 руб
-        - Приоритет 1 нет, приоритет 2 (роза 60см) в наличии: цена 60.00 руб
-        - Все недоступны: цена = max(50.00, 60.00, 70.00) = 70.00 руб
-
-        Возвращает 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
-```
-
-### Использование в шаблонах и views:
-
-```python
-# В view
-variant_group = ProductVariantGroup.objects.get(id=1)
-
-# Проверить есть ли вариант в наличии
-if variant_group.in_stock:
-    # Вариант доступен
-    pass
-
-# Получить цену варианта
-price = variant_group.price  # Decimal('50.00')
-
-# В шаблоне
-{{ variant_group.in_stock }}  <!-- True/False -->
-{{ variant_group.price }}      <!-- 50.00 -->
-```
-
----
-
-## 4. Архитектурные решения
-
-### Почему свойства (properties) а не поля БД?
-
-**ProductVariantGroup.in_stock** и **ProductVariantGroup.price** реализованы как **свойства (properties)**, а не как сохраняемые поля:
-
-✅ **Преимущества:**
-- **Всегда актуальны** — в любой момент рассчитываются на основе текущих данных
-- **Нет дублирования данных** — источник истины один (Product.in_stock и Product.sale_price)
-- **Без миграций** — при изменении логики не нужны миграции БД
-- **Простота** — чистый и понятный код
-
-⚠️ **Недостатки (решены):**
-- **Производительность** — O(N) на каждый вызов, где N = количество товаров в группе
-- **Решение**: используйте prefetch_related в views:
-
-```python
-# Плохо (N+1 queries)
-for variant_group in groups:
-    print(variant_group.price)
-
-# Хорошо (1 query + 1 query для товаров)
-groups = ProductVariantGroup.objects.prefetch_related('items__product')
-for variant_group in groups:
-    print(variant_group.price)
-```
-
-### Почему Product.in_stock = поле БД?
-
-**Product.in_stock** — это сохраняемое поле в БД:
-
-✅ **Причины:**
-- **Оптимизация поиска** — можно фильтровать: `Product.objects.filter(in_stock=True)`
-- **Производительность** — не нужно JOIN'ить Stock при поиске
-- **Индекс** — ускоряет фильтрацию
-- **Системная важность** — наличие товара — критичный параметр
-
----
-
-## 5. Поток данных (Data Flow)
-
-```
-Incoming (приход товара)
-    ↓
-StockBatch создаётся
-    ↓
-Stock создаётся/обновляется
-    ├─ quantity_available пересчитывается
-    └─ post_save сигнал срабатывает
-        ↓
-_update_product_in_stock(product_id)
-    ├─ Проверяет есть ли Stock с quantity_available > 0
-    └─ Product.in_stock обновляется (True/False)
-        ↓
-ProductVariantGroup.in_stock (свойство)
-    ├─ Проверяет есть ли товар в группе с Product.in_stock=True
-    └─ Возвращает True/False
-
-ProductVariantGroup.price (свойство)
-    ├─ Идёт по товарам по приоритету
-    ├─ Берёт цену первого в наличии
-    └─ Или максимальную цену если никто не в наличии
-```
-
----
-
-## 6. Примеры использования
-
-### Пример 1: Проверить есть ли товар в наличии
-
-```python
-from products.models import Product
-
-# Получить товар
-product = Product.objects.get(id=1)
-
-# Проверить наличие
-if product.in_stock:
-    print(f"{product.name} в наличии")
-else:
-    print(f"{product.name} не в наличии")
-
-# Фильтровать товары в наличии
-in_stock_products = Product.objects.filter(in_stock=True)
-```
-
-### Пример 2: Работа с группой вариантов
-
-```python
-from products.models import ProductVariantGroup
-
-# Получить группу
-group = ProductVariantGroup.objects.prefetch_related('items__product').get(id=1)
-
-# Проверить статус группы
-print(f"Вариант в наличии: {group.in_stock}")  # True/False
-print(f"Цена варианта: {group.price} руб")     # Decimal('50.00')
-
-# Получить всю информацию
-for item in group.items.all().order_by('priority'):
-    status = "✓" if item.product.in_stock else "✗"
-    print(f"{item.priority}. {item.product.name} ({item.product.sale_price}) {status}")
-```
-
-### Пример 3: Отображение в шаблоне
-
-```html
-{% for variant_group in variant_groups %}
-<div class="variant-group">
-    <h3>{{ variant_group.name }}</h3>
-
-    {% if variant_group.in_stock %}
-        <span class="badge badge-success">В наличии</span>
-    {% else %}
-        <span class="badge badge-danger">Нет в наличии</span>
-    {% endif %}
-
-    <div class="price">
-        Цена: {{ variant_group.price }} руб
-    </div>
-
-    <ul class="variants">
-        {% for item in variant_group.items.all %}
-            <li>
-                {{ item.product.name }}
-                {% if item.product.in_stock %}
-                    <span class="in-stock">✓ В наличии</span>
-                {% endif %}
-            </li>
-        {% endfor %}
-    </ul>
-</div>
-{% endfor %}
-```
-
----
-
-## 7. Тестирование
-
-### Создан тестовый скрипт: `test_variant_stock.py`
-
-Скрипт проверяет:
-
-1. **ТЕСТ 1**: Обновление Product.in_stock при создании Stock
-   - Создаёт товар без наличия (in_stock=False)
-   - Добавляет приход товара (создаёт Stock)
-   - Проверяет что Product.in_stock автоматически стал True
-
-2. **ТЕСТ 2**: Свойство ProductVariantGroup.in_stock
-   - Создаёт группу вариантов с несколькими товарами
-   - Один товар в наличии
-   - Проверяет что вариант.in_stock = True
-
-3. **ТЕСТ 3**: Свойство ProductVariantGroup.price
-   - Товары с приоритетами 1, 2, 3 и ценами 50, 60, 70 руб
-   - Только товар с приоритетом 1 в наличии
-   - Проверяет что вариант.price = 50.00 руб
-
-4. **ТЕСТ 4**: Цена варианта когда ни один товар не в наличии
-   - Все товары не в наличии
-   - Цены: 100, 150, 200 руб
-   - Проверяет что вариант.price = 200.00 руб (максимальная)
-
-### Запуск тестов:
-
-```bash
-# Активировать окружение
-source venv/Scripts/activate
-
-# Запустить тестовый скрипт
-python test_variant_stock.py
-
-# Или запустить стандартные Django тесты
-cd myproject
-python manage.py test inventory -v 2
-```
-
----
-
-## 8. Файлы которые были изменены/созданы
-
-### Изменены:
-
-1. **`myproject/products/models.py`**
-   - Добавлено поле `in_stock` в Product
-   - Добавлены свойства `in_stock` и `price` в ProductVariantGroup
-   - Добавлен индекс для `in_stock`
-
-2. **`myproject/inventory/signals.py`**
-   - Добавлены импорты Stock в начало файла
-   - Добавлены два сигнала: `update_product_in_stock_on_stock_change` и `update_product_in_stock_on_stock_delete`
-   - Добавлена вспомогательная функция `_update_product_in_stock`
-
-3. **`myproject/products/migrations/0003_add_product_in_stock.py`** (создана)
-   - Миграция для добавления поля `in_stock` в Product
-
-### Созданы:
-
-1. **`test_variant_stock.py`**
-   - Тестовый скрипт для проверки функциональности
-
----
-
-## 9. Резюме
-
-✅ **Реализовано:**
-
-1. **Product.in_stock** — булево поле, автоматически обновляется при изменении остатков
-2. **ProductVariantGroup.in_stock** — свойство, вариант в наличии если хотя бы один товар в наличии
-3. **ProductVariantGroup.price** — свойство, цена по приоритету или максимальная если все недоступны
-4. **Сигналы** — автоматическое обновление Product.in_stock при изменении Stock
-5. **Документация** — полное описание архитектуры и использования
-
-✅ **Особенности:**
-
-- Система простая и элегантная (без костылей)
-- Обратная совместимость не требуется (как вы просили)
-- Высокая производительность (индексирование, минимум JOIN'ов)
-- Актуальные данные (сигналы гарантируют синхронизацию)
-- Легко расширяемая (свойства можно менять без миграций)
-
-✅ **Готово к использованию в views и шаблонах!**

cleanup_media.py

@@ -1,72 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-"""
-Script to cleanup old photo files with collision suffixes.
-Deletes files like: original_b374WLW.jpg, large_lmCnBYn.webp etc.
-"""
-import os
-import sys
-from pathlib import Path
-
-# Determine media directory
-media_dir = Path(__file__).parent / 'myproject' / 'media'
-
-if not media_dir.exists():
-    print(f"ERROR: media directory not found: {media_dir}")
-    sys.exit(1)
-
-print(f"Cleaning old photo files in: {media_dir}")
-print("=" * 60)
-
-deleted_count = 0
-errors = []
-
-# Walk through all files in media
-for root, dirs, files in os.walk(str(media_dir)):
-    for filename in files:
-        # Look for files with suffix (pattern: name_XXXXX.extension)
-        # where XXXXX is a random suffix added by Django on collision
-        parts = filename.rsplit('.', 1)  # Split name and extension
-
-        if len(parts) != 2:
-            continue
-
-        name, ext = parts
-
-        # Check if there's a suffix (8 chars after last underscore)
-        # Django adds suffixes like: _b374WLW, _lmCnBYn etc.
-        # Also match patterns like testovyi_17613999927705342_original
-        if '_' in name:
-            # Get the last part after underscore
-            parts_by_underscore = name.split('_')
-            last_part = parts_by_underscore[-1]
-
-            # Check for collision suffix (8 alphanumeric chars)
-            # or timestamp-like suffix (14+ digits)
-            is_collision_suffix = (len(last_part) == 8 and last_part.isalnum())
-            is_timestamp_suffix = (len(last_part) >= 14 and last_part.isdigit())
-
-            if is_collision_suffix or is_timestamp_suffix:
-                file_path = os.path.join(root, filename)
-                rel_path = os.path.relpath(file_path, str(media_dir))
-
-                try:
-                    os.remove(file_path)
-                    deleted_count += 1
-                    print(f"[OK] Deleted: {rel_path}")
-                except Exception as e:
-                    errors.append(f"[FAIL] Error deleting {rel_path}: {str(e)}")
-                    print(f"[FAIL] Error deleting {rel_path}: {str(e)}")
-
-print("=" * 60)
-print(f"\nResults:")
-print(f"   [OK] Successfully deleted: {deleted_count} files")
-
-if errors:
-    print(f"   [FAIL] Deletion errors: {len(errors)}")
-    for error in errors:
-        print(f"     {error}")
-else:
-    print(f"   [OK] No errors")
-
-print("\n[DONE] Cleanup completed!")

myproject/.env.example

@@ -15,17 +15,51 @@ DB_HOST=localhost
 DB_PORT=5432
 
 # ============================================
-# TENANT ADMIN AUTO-CREATION
+# REDIS SETTINGS
 # ============================================
-# При создании нового тенанта автоматически создается суперпользователь
-# с указанными credentials для доступа к админке тенанта
-#
-# Для разработки можете использовать простые значения:
-# TENANT_ADMIN_EMAIL=admin@localhost
-# TENANT_ADMIN_PASSWORD=1234
-# TENANT_ADMIN_NAME=Admin
-#
-# Для продакшена используйте более безопасные значения!
-TENANT_ADMIN_EMAIL=admin@localhost
-TENANT_ADMIN_PASSWORD=change-me-in-production
-TENANT_ADMIN_NAME=Admin
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_DB=0
+
+# ============================================
+# PLATFORM ADMIN (для Docker)
+# ============================================
+# Администратор платформы (создаётся автоматически при первом запуске)
+PLATFORM_ADMIN_EMAIL=admin@platform.com
+PLATFORM_ADMIN_PASSWORD=your-secure-password-here
+PLATFORM_ADMIN_NAME=Platform Admin
+
+# ============================================
+# DOMAIN SETTINGS
+# ============================================
+# Базовый домен для мультитенантности (без схемы http/https)
+# Локально: localhost:8000
+# Продакшен: your-domain.com
+TENANT_DOMAIN_BASE=localhost:8000
+
+# Использовать HTTPS для ссылок
+# False - для локальной разработки (http://)
+# True - для продакшена (https://)
+USE_HTTPS=False
+
+DJANGO_SETTINGS_MODULE=myproject.settings
+
+# ============================================
+# Z.AI GLM SETTINGS
+# ============================================
+# API ключ для доступа к Z.AI GLM (хранится в зашифрованном виде в БД)
+ZAI_API_KEY=
+ZAI_API_URL=https://api.z.ai/api/paas/v4
+ZAI_MODEL_NAME=glm-4.7
+ZAI_TEMPERATURE=0.7
+ZAI_CODING_ENDPOINT=false
+
+# ============================================
+# OPENROUTER.AI SETTINGS
+# ============================================
+# API ключ для доступа к OpenRouter (хранится в зашифрованном виде в БД)
+OPENROUTER_API_KEY=
+OPENROUTER_API_URL=https://openrouter.ai/api/v1
+OPENROUTER_MODEL_NAME=xiaomi/mimo-v2-flash:free
+OPENROUTER_TEMPERATURE=0.7
+OPENROUTER_MAX_TOKENS=1000

myproject/.gitignore

@@ -9,6 +9,10 @@ db.sqlite3-journal
 
 # Environment variables (contains secrets!)
 .env
+docker/.env.docker
+
+# Support credentials (generated passwords)
+support_credentials.txt
 
 # Virtual environment
 venv/

myproject/COST_PRICE_QUICK_GUIDE.md

@@ -1,198 +0,0 @@
-# Быстрый гид: Динамическая себестоимость товаров
-
-## Как это работает
-
-Себестоимость товара теперь **автоматически рассчитывается** на основе партий товара (StockBatch) по формуле средневзвешенной стоимости:
-
-```
-cost_price = Σ(количество × стоимость) / Σ(количество)
-```
-
-## Автоматическое обновление
-
-Себестоимость обновляется **автоматически** при:
-- ✅ Создании новой партии (поступление товара)
-- ✅ Изменении количества в партии
-- ✅ Изменении стоимости партии
-- ✅ Удалении партии
-
-**Никаких дополнительных действий не требуется!**
-
-## Просмотр деталей
-
-### На странице товара
-
-1. Откройте страницу товара: `http://grach.localhost:8000/products/1/`
-2. Найдите строку "Себестоимость"
-3. Нажмите кнопку **"Детали расчета"**
-4. Увидите:
-   - Кешированную стоимость (из БД)
-   - Рассчитанную стоимость (из партий)
-   - Таблицу с разбивкой по партиям
-   - Дату создания каждой партии
-
-## Примеры сценариев
-
-### Сценарий 1: Новый товар
-```
-Товар создан → cost_price = 0.00 (нет партий)
-```
-
-### Сценарий 2: Первая поставка
-```
-Поступление: 10 шт по 100 руб
-→ Автоматически: cost_price = 100.00
-```
-
-### Сценарий 3: Вторая поставка
-```
-Текущее: 10 шт по 100 руб (cost_price = 100.00)
-Поступление: 10 шт по 120 руб
-→ Автоматически: cost_price = 110.00
-Расчет: (10×100 + 10×120) / 20 = 110.00
-```
-
-### Сценарий 4: Товар закончился
-```
-Продажа: весь товар продан
-→ Автоматически: cost_price = 0.00
-```
-
-### Сценарий 5: Новая поставка после опустошения
-```
-Поступление: 15 шт по 130 руб
-→ Автоматически: cost_price = 130.00
-```
-
-## Ручной пересчет (если нужно)
-
-Если по какой-то причине себестоимость "слетела", можно пересчитать вручную:
-
-```bash
-# Пересчитать для тенанта grach
-python manage.py recalculate_product_costs --schema=grach
-
-# С подробным выводом
-python manage.py recalculate_product_costs --schema=grach --verbose
-
-# Предварительный просмотр без сохранения
-python manage.py recalculate_product_costs --schema=grach --dry-run --verbose
-
-# Показать только изменившиеся товары
-python manage.py recalculate_product_costs --schema=grach --only-changed
-```
-
-## Влияние на комплекты (ProductKit)
-
-Стоимость комплектов теперь автоматически учитывает актуальную себестоимость компонентов!
-
-```python
-# Раньше: использовалась статическая стоимость
-# Теперь: использует динамическую стоимость из партий
-kit_cost = sum(component.cost_price × quantity)
-```
-
-## Проверка синхронизации
-
-На странице товара в секции "Детали расчета":
-- 🟢 **Зеленый статус** - все синхронизировано
-- 🟡 **Желтый статус** - требуется синхронизация (запустите команду пересчета)
-
-## API для разработчиков
-
-### Получить детали расчета
-
-```python
-from products.models import Product
-
-product = Product.objects.get(id=1)
-
-# Получить детали
-details = product.cost_price_details
-
-print(f"Кешированная стоимость: {details['cached_cost']}")
-print(f"Рассчитанная стоимость: {details['calculated_cost']}")
-print(f"Синхронизировано: {details['is_synced']}")
-print(f"Всего в партиях: {details['total_quantity']}")
-
-# Перебрать партии
-for batch in details['batches']:
-    print(f"Склад: {batch['warehouse_name']}")
-    print(f"Количество: {batch['quantity']}")
-    print(f"Стоимость: {batch['cost_price']}")
-```
-
-### Ручное обновление стоимости
-
-```python
-from products.services.cost_calculator import ProductCostCalculator
-
-# Рассчитать новую стоимость
-new_cost = ProductCostCalculator.calculate_weighted_average_cost(product)
-
-# Обновить в БД
-old_cost, new_cost, was_updated = ProductCostCalculator.update_product_cost(product)
-
-if was_updated:
-    print(f"Стоимость обновлена: {old_cost} → {new_cost}")
-```
-
-## Логирование
-
-Все операции логируются в стандартный Django logger:
-
-```python
-import logging
-logger = logging.getLogger('products.services.cost_calculator')
-```
-
-Примеры сообщений:
-- `INFO: Обновлена себестоимость товара SKU-001: 100.00 -> 110.00`
-- `ERROR: Ошибка при расчете себестоимости для товара SKU-001: ...`
-
-## Производительность
-
-### Чтение cost_price
-- **0 дополнительных запросов** - значение читается из БД
-
-### Создание/изменение партии
-- **1 дополнительный UPDATE** - автоматическое обновление cost_price
-
-### Просмотр деталей (cost_price_details)
-- **1 SELECT** - запрос партий товара
-
-## FAQ
-
-**Q: Нужно ли что-то делать после создания партии?**
-A: Нет! Себестоимость обновляется автоматически через Django signals.
-
-**Q: Что если у товара нет партий?**
-A: cost_price = 0.00 (автоматически)
-
-**Q: Можно ли вручную установить себестоимость?**
-A: Можно, но при следующем изменении партий значение пересчитается автоматически.
-
-**Q: Как проверить правильность расчета?**
-A: Откройте "Детали расчета" на странице товара - там видна вся математика.
-
-**Q: Влияет ли это на ProductKit?**
-A: Да! Стоимость комплектов теперь использует актуальную себестоимость компонентов.
-
-**Q: Что если синхронизация нарушилась?**
-A: Запустите `python manage.py recalculate_product_costs --schema=grach`
-
-## Техническая документация
-
-Подробная техническая документация доступна в файле:
-`DYNAMIC_COST_PRICE_IMPLEMENTATION.md`
-
-## Контакты и поддержка
-
-При возникновении проблем проверьте:
-1. Логи Django (ошибки при расчете)
-2. Страницу товара (секция "Детали расчета")
-3. Запустите команду с --dry-run для проверки
-
----
-Версия: 1.0
-Дата: 2025-01-01

myproject/DJANGO_TENANTS_SETUP.md

@@ -1,302 +0,0 @@
-# Настройка Django Tenants для multi-tenancy
-
-Этот проект настроен как SaaS-платформа с поддержкой multi-tenancy через django-tenants.
-Каждый владелец магазина получает свой поддомен и изолированную схему БД в PostgreSQL.
-
-## Шаг 1: Установка PostgreSQL
-
-### Вариант A: Установка локально (Windows)
-
-1. Скачайте PostgreSQL с https://www.postgresql.org/download/windows/
-2. Установите PostgreSQL (запомните пароль для пользователя `postgres`)
-3. Откройте pgAdmin или psql и создайте базу данных:
-
-```sql
-CREATE DATABASE inventory_db;
-```
-
-### Вариант B: Использование Docker (рекомендуется)
-
-```bash
-docker run --name inventory-postgres \
-  -e POSTGRES_PASSWORD=postgres \
-  -e POSTGRES_DB=inventory_db \
-  -p 5432:5432 \
-  -d postgres:15
-```
-
-## Шаг 2: Установка зависимостей
-
-```bash
-pip install -r requirements.txt
-```
-
-Это установит:
-- `django-tenants==3.7.0`
-- `psycopg2-binary==2.9.10`
-- и другие зависимости
-
-## Шаг 3: Настройка подключения к БД
-
-Откройте `myproject/settings.py` и при необходимости измените параметры подключения:
-
-```python
-DATABASES = {
-    'default': {
-        'ENGINE': 'django_tenants.postgresql_backend',
-        'NAME': 'inventory_db',
-        'USER': 'postgres',
-        'PASSWORD': 'postgres',  # ВАШ ПАРОЛЬ
-        'HOST': 'localhost',
-        'PORT': '5432',
-    }
-}
-```
-
-## Шаг 4: Создание миграций
-
-```bash
-# Создать миграции для всех приложений
-python manage.py makemigrations
-
-# Применить миграции для public схемы
-python manage.py migrate_schemas --shared
-```
-
-## Шаг 5: Создание публичного тенанта
-
-Django-tenants требует создания public тенанта для работы главного домена (inventory.by):
-
-```bash
-python manage.py shell
-```
-
-```python
-from tenants.models import Client, Domain
-
-# Создать public тенанта
-public_tenant = Client.objects.create(
-    schema_name='public',
-    name='Главный домен',
-    owner_email='admin@inventory.by',
-    owner_name='Администратор'
-)
-
-# Создать домен для public
-public_domain = Domain.objects.create(
-    domain='localhost',  # Для локальной разработки
-    tenant=public_tenant,
-    is_primary=True
-)
-
-print(f'Public тенант создан: {public_tenant}')
-print(f'Public домен создан: {public_domain}')
-exit()
-```
-
-## Шаг 6: Создание суперпользователя
-
-```bash
-# Создать суперпользователя в public схеме
-python manage.py createsuperuser --schema=public
-```
-
-Введите:
-- Email: ваш email
-- Name: ваше имя
-- Password: ваш пароль
-
-## Шаг 7: Создание тестового магазина (тенанта)
-
-```bash
-python manage.py create_tenant
-```
-
-Введите данные:
-- Название магазина: Тестовый Магазин
-- Схема БД: shop1
-- Домен: shop1.localhost (или оставьте по умолчанию)
-- Имя владельца: Иван Иванов
-- Email: shop1@example.com
-- Телефон: (опционально)
-
-Команда автоматически:
-1. Создаст тенанта в таблице `Client`
-2. Создаст домен в таблице `Domain`
-3. Создаст схему БД `shop1` в PostgreSQL
-4. Применит все миграции к схеме `shop1`
-
-## Шаг 8: Настройка hosts файла
-
-Для локального тестирования добавьте в файл hosts:
-
-**Windows**: `C:\Windows\System32\drivers\etc\hosts`
-**Linux/Mac**: `/etc/hosts`
-
-```
-127.0.0.1 localhost
-127.0.0.1 shop1.localhost
-127.0.0.1 shop2.localhost
-```
-
-## Шаг 9: Запуск сервера
-
-```bash
-python manage.py runserver 0.0.0.0:8000
-```
-
-## Шаг 10: Тестирование
-
-### Доступ к админке супер-администратора (Public схема):
-- URL: http://localhost:8000/admin/
-- Логин: email и пароль суперпользователя
-- Здесь вы можете управлять тенантами (магазинами)
-
-### Доступ к админке магазина (Tenant схема):
-- URL: http://shop1.localhost:8000/admin/
-- Создайте суперпользователя для магазина:
-  ```bash
-  python manage.py tenant_command createsuperuser --schema=shop1
-  ```
-- Здесь владелец магазина управляет своими товарами, заказами, клиентами
-
----
-
-## Архитектура проекта
-
-### Public Schema (схема `public`):
-Доступна по адресу: `localhost` или `inventory.by`
-
-**Модели:**
-- `Client` - информация о тенантах (магазинах)
-- `Domain` - домены тенантов
-
-**Кто имеет доступ:**
-- Супер-администратор (вы)
-
-**Для чего:**
-- Управление тенантами
-- Просмотр статистики
-- Биллинг (в будущем)
-
-### Tenant Schema (схемы `shop1`, `shop2`, и т.д.):
-Доступна по поддоменам: `shop1.localhost`, `shop2.localhost`
-
-**Модели:**
-- `Customer` - клиенты магазина
-- `Address` - адреса клиентов
-- `Shop` - точки магазина
-- `Product`, `ProductKit`, `Category` - товары
-- `Order`, `OrderItem` - заказы
-- `Inventory` - складской учет
-- `CustomUser` - сотрудники (для будущего)
-
-**Кто имеет доступ:**
-- Владелец магазина
-- Сотрудники магазина (в будущем)
-
-**Для чего:**
-- Управление товарами
-- Обработка заказов
-- Работа с клиентами
-- Складской учет
-
----
-
-## Полезные команды
-
-### Создать тенанта:
-```bash
-python manage.py create_tenant
-```
-
-### Применить миграции ко всем тенантам:
-```bash
-python manage.py migrate_schemas
-```
-
-### Применить миграции только к public:
-```bash
-python manage.py migrate_schemas --shared
-```
-
-### Применить миграции к конкретному тенанту:
-```bash
-python manage.py migrate_schemas --schema=shop1
-```
-
-### Выполнить команду для конкретного тенанта:
-```bash
-python manage.py tenant_command <command> --schema=shop1
-```
-
-Например:
-```bash
-python manage.py tenant_command createsuperuser --schema=shop1
-python manage.py tenant_command loaddata data.json --schema=shop1
-```
-
-### Список всех тенантов:
-```bash
-python manage.py shell
-```
-```python
-from tenants.models import Client
-for tenant in Client.objects.all():
-    print(f'{tenant.name}: {tenant.schema_name}')
-```
-
----
-
-## Устранение проблем
-
-### Ошибка: "No tenant found for hostname"
-- Проверьте, что домен добавлен в hosts файл
-- Проверьте, что домен существует в таблице `Domain`
-- Проверьте, что вы обращаетесь к правильному поддомену
-
-### Ошибка: "relation does not exist"
-- Запустите миграции: `python manage.py migrate_schemas`
-- Проверьте, что схема создана в PostgreSQL
-
-### Ошибка подключения к PostgreSQL:
-- Проверьте, что PostgreSQL запущен
-- Проверьте параметры подключения в `settings.py`
-- Проверьте, что база данных `inventory_db` существует
-
----
-
-## Продакшн
-
-Для продакшна (на сервере):
-
-1. Измените `settings.py`:
-   ```python
-   DEBUG = False
-   ALLOWED_HOSTS = ['.inventory.by']
-   ```
-
-2. Настройте DNS для поддоменов (wildcard):
-   ```
-   *.inventory.by → ваш сервер
-   ```
-
-3. Используйте реальные домены вместо localhost
-
-4. Настройте PostgreSQL с безопасным паролем
-
-5. Используйте environment variables для секретов
-
----
-
-## Следующие шаги
-
-После успешной настройки:
-
-1. ✅ Создайте несколько тестовых магазинов
-2. ✅ Добавьте товары в каждый магазин
-3. ✅ Создайте тестовые заказы
-4. ✅ Проверьте изоляцию данных между магазинами
-5. 🔜 Разработайте веб-интерфейс для владельцев магазинов
-6. 🔜 Добавьте регистрацию новых магазинов через веб-форму
-7. 🔜 Реализуйте биллинг и тарифные планы

myproject/QUICK_START.md

@@ -1,81 +0,0 @@
-# Быстрый старт - Django Tenants
-
-## 1. Установка PostgreSQL
-
-```bash
-# Docker (рекомендуется):
-docker run --name inventory-postgres -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=inventory_db -p 5432:5432 -d postgres:15
-```
-
-## 2. Установка пакетов
-
-```bash
-pip install -r requirements.txt
-```
-
-## 3. Миграции
-
-```bash
-python manage.py makemigrations
-python manage.py migrate_schemas --shared
-```
-
-## 4. Создание public тенанта
-
-```bash
-python manage.py shell
-```
-
-```python
-from tenants.models import Client, Domain
-
-public_tenant = Client.objects.create(
-    schema_name='public',
-    name='Главный домен',
-    owner_email='admin@inventory.by',
-    owner_name='Администратор'
-)
-
-Domain.objects.create(
-    domain='localhost',
-    tenant=public_tenant,
-    is_primary=True
-)
-exit()
-```
-
-## 5. Создание суперпользователя
-
-```bash
-python manage.py createsuperuser --schema=public
-```
-
-## 6. Создание тестового магазина
-
-```bash
-python manage.py create_tenant
-```
-
-## 7. Добавить в hosts
-
-**Windows**: `C:\Windows\System32\drivers\etc\hosts`
-
-```
-127.0.0.1 localhost
-127.0.0.1 shop1.localhost
-```
-
-## 8. Запуск
-
-```bash
-python manage.py runserver 0.0.0.0:8000
-```
-
-## 9. Проверка
-
-- Админка системы: http://localhost:8000/admin/
-- Админка магазина: http://shop1.localhost:8000/admin/
-
----
-
-**Подробная инструкция**: см. [DJANGO_TENANTS_SETUP.md](DJANGO_TENANTS_SETUP.md)

myproject/START_FRESH.md

@@ -1,73 +0,0 @@
-# Старт проекта с нуля
-
-## 1. База данных в Docker
-```bash
-docker run --name inventory-postgres \
-  -e POSTGRES_PASSWORD=postgres \
-  -e POSTGRES_DB=inventory_db \
-  -p 5432:5432 \
-  -d postgres:15
-```
-
-## 2. Создать миграции
-```bash
-python manage.py makemigrations
-```
-
-## 3. Применить миграции к public схеме
-```bash
-python manage.py migrate_schemas --shared
-```
-
-## 4. Создать PUBLIC тенант (обязательно!)
-```bash
-python manage.py shell
-```
-
-Вставить в shell:
-```python
-from tenants.models import Client, Domain
-
-public = Client.objects.create(
-    schema_name='public',
-    name='Admin Panel',
-    owner_email='admin@localhost',
-    owner_name='Admin'
-)
-
-Domain.objects.create(
-    domain='localhost',
-    tenant=public,
-    is_primary=True
-)
-
-print('Public tenant created!')
-exit()
-```
-
-## 5. Создать суперпользователя для public
-```bash
-python manage.py createsuperuser --schema=public
-```
-
-Введи:
-- Email: admin@localhost
-- Password: AdminPassword123
-
-## 6. Запустить сервер
-```bash
-python manage.py runserver 0.0.0.0:8000
-```
-
-## 7. Все! Теперь:
-
-- Админка: http://localhost:8000/admin/
-- Новые тенанты создаются только через форму регистрации → одобрение в админке
-
-**ВАЖНО:** НЕ СОЗДАВАЙ НИКАКИХ ПОЛЬЗОВАТЕЛЕЙ ВРУЧНУЮ! Все создается автоматически при одобрении заявки.
-
----
-
-## Учетные данные для новых тенантов
-Email: admin@localhost
-Password: AdminPassword123

myproject/START_HERE.md

@@ -1,297 +0,0 @@
-# 🚀 Чистый старт проекта с Django Tenants
-
-Все миграции удалены. База данных пуста. Готов к чистому старту!
-
-## ✅ Что уже сделано:
-
-1. ✅ PostgreSQL установлен и запущен в Docker
-2. ✅ Все старые миграции удалены
-3. ✅ SQLite база удалена
-4. ✅ Проект настроен для django-tenants
-
----
-
-## 📋 Пошаговая инструкция:
-
-### Шаг 1: Установить зависимости
-
-```bash
-pip install -r requirements.txt
-```
-
-Это установит:
-- django-tenants
-- psycopg2-binary
-- и все остальные зависимости
-
----
-
-### Шаг 2: Создать миграции для всех приложений
-
-```bash
-python manage.py makemigrations
-```
-
-Django создаст миграции для:
-- **tenants** (public схема - Client и Domain)
-- **accounts, customers, shops, products, orders, inventory** (tenant схемы)
-
----
-
-### Шаг 3: Применить миграции к public схеме
-
-```bash
-python manage.py migrate_schemas --shared
-```
-
-Это создаст:
-- Схему `public` в PostgreSQL
-- Таблицы для управления тенантами (Client, Domain)
-- Таблицы Django (auth, contenttypes, sessions, admin)
-
----
-
-### Шаг 4: Создать public тенанта
-
-Public тенант нужен для главного домена (localhost в разработке).
-
-```bash
-python manage.py shell
-```
-
-В shell выполните:
-
-```python
-from tenants.models import Client, Domain
-
-# Создать public тенанта
-public_tenant = Client.objects.create(
-    schema_name='public',
-    name='Главный домен',
-    owner_email='admin@inventory.by',
-    owner_name='Администратор'
-)
-
-# Создать домен для public
-public_domain = Domain.objects.create(
-    domain='localhost',
-    tenant=public_tenant,
-    is_primary=True
-)
-
-print(f'✓ Public тенант создан: {public_tenant}')
-print(f'✓ Public домен создан: {public_domain}')
-exit()
-```
-
----
-
-### Шаг 5: Создать суперпользователя (ваш аккаунт)
-
-```bash
-python manage.py createsuperuser --schema=public
-```
-
-Введите:
-- **Email**: ваш email
-- **Name**: ваше имя
-- **Password**: ваш пароль
-
-Этот суперпользователь будет иметь доступ к админке на `localhost:8000/admin/` для управления тенантами.
-
----
-
-### Шаг 6: Создать первый магазин (тенант)
-
-```bash
-python manage.py create_tenant
-```
-
-Пример данных:
-- **Название магазина**: Цветочный рай
-- **Схема БД**: shop1
-- **Домен**: shop1.localhost (или оставьте по умолчанию)
-- **Имя владельца**: Иван Иванов
-- **Email**: ivan@example.com
-- **Телефон**: (можете оставить пустым)
-
-Команда автоматически:
-1. Создаст тенанта в таблице `Client`
-2. Создаст домен в таблице `Domain`
-3. Создаст схему `shop1` в PostgreSQL
-4. Применит все миграции к схеме `shop1`
-5. Создаст все таблицы (customers, orders, products, etc.) в схеме `shop1`
-
----
-
-### Шаг 7: Настроить hosts файл
-
-Откройте файл hosts с правами администратора:
-
-**Windows**: `C:\Windows\System32\drivers\etc\hosts`
-
-Добавьте строки:
-
-```
-127.0.0.1 localhost
-127.0.0.1 shop1.localhost
-127.0.0.1 shop2.localhost
-```
-
-Сохраните файл.
-
----
-
-### Шаг 8: Запустить сервер
-
-```bash
-python manage.py runserver 0.0.0.0:8000
-```
-
----
-
-### Шаг 9: Проверить работу
-
-#### 1. Админка супер-администратора (Public схема):
-
-URL: **http://localhost:8000/admin/**
-
-Логин: email и пароль суперпользователя (из Шага 5)
-
-Здесь вы увидите:
-- Управление тенантами (магазинами)
-- Управление доменами
-- Стандартные разделы Django
-
-#### 2. Админка магазина (Tenant схема):
-
-URL: **http://shop1.localhost:8000/admin/**
-
-Сначала нужно создать пользователя для магазина:
-
-```bash
-python manage.py tenant_command createsuperuser --schema=shop1
-```
-
-Затем зайдите в админку магазина и увидите:
-- Клиенты (Customers)
-- Адреса (Addresses)
-- Магазины/точки (Shops)
-- Товары (Products, Categories, Kits)
-- Заказы (Orders, OrderItems)
-- Складской учет (Inventory)
-
----
-
-## 🎯 Проверка изоляции данных
-
-Создайте второй магазин:
-
-```bash
-python manage.py create_tenant
-```
-
-Данные (название: "Второй магазин", схема: "shop2", домен: "shop2.localhost")
-
-Затем:
-1. Добавьте товары в shop1
-2. Добавьте товары в shop2
-3. Убедитесь, что товары из shop1 НЕ видны в shop2 и наоборот
-
-**Это и есть полная изоляация данных!** ✅
-
----
-
-## 🛠 Полезные команды
-
-### Посмотреть список всех тенантов:
-
-```bash
-python manage.py shell
-```
-
-```python
-from tenants.models import Client
-for tenant in Client.objects.all():
-    print(f'{tenant.name}: {tenant.schema_name} - {tenant.get_primary_domain()}')
-```
-
-### Применить миграции ко всем тенантам:
-
-```bash
-python manage.py migrate_schemas
-```
-
-### Применить миграции к конкретному тенанту:
-
-```bash
-python manage.py migrate_schemas --schema=shop1
-```
-
-### Выполнить команду для тенанта:
-
-```bash
-python manage.py tenant_command <command> --schema=shop1
-```
-
-Примеры:
-```bash
-python manage.py tenant_command createsuperuser --schema=shop1
-python manage.py tenant_command shell --schema=shop1
-python manage.py tenant_command dumpdata --schema=shop1 > shop1_data.json
-```
-
----
-
-## 📊 Структура базы данных
-
-После выполнения всех шагов в PostgreSQL будет:
-
-### Схема `public`:
-- Таблицы тенантов: `tenants_client`, `tenants_domain`
-- Таблицы Django: `auth_user`, `auth_group`, `django_session`, etc.
-
-### Схема `shop1`:
-- `customers_customer`, `customers_address`
-- `shops_shop`
-- `products_product`, `products_category`, `products_productkit`
-- `orders_order`, `orders_orderitem`
-- `inventory_*`
-- И все остальные таблицы приложений
-
-### Схема `shop2`:
-- Те же таблицы что и в `shop1`, но с ДРУГИМИ данными!
-
----
-
-## ❗ Возможные проблемы
-
-### Ошибка: "connection to server at localhost (127.0.0.1), port 5432 failed"
-PostgreSQL не запущен. Запустите:
-```bash
-docker start inventory-postgres
-```
-
-### Ошибка: "database 'inventory_db' does not exist"
-Создайте базу:
-```bash
-docker exec -it inventory-postgres psql -U postgres -c "CREATE DATABASE inventory_db;"
-```
-
-### Ошибка: "No tenant found for hostname 'shop1.localhost'"
-- Проверьте hosts файл
-- Проверьте, что домен создан: `Domain.objects.filter(domain='shop1.localhost').exists()`
-
-### Ошибка: "relation does not exist"
-Миграции не применены. Запустите:
-```bash
-python manage.py migrate_schemas
-```
-
----
-
-## 🎉 Готово!
-
-После выполнения всех шагов у вас будет работающая SaaS-платформа с полной изоляцией данных между магазинами!
-
-**Подробная документация**: [DJANGO_TENANTS_SETUP.md](DJANGO_TENANTS_SETUP.md)

myproject/TENANT_ADMIN_GUIDE.md

@@ -1,332 +0,0 @@
-# Руководство по автоматическому созданию суперпользователей для тенантов
-
-## Обзор
-
-При создании нового тенанта (магазина) система **автоматически** создает суперпользователя с credentials из файла `.env`. Это позволяет сразу после активации войти в админ-панель тенанта и начать работу.
-
----
-
-## Настройка
-
-### 1. Файл `.env`
-
-В корне проекта находится файл [.env](myproject/.env) с настройками:
-
-```env
-# Настройки автоматического создания суперпользователя для новых тенантов
-TENANT_ADMIN_EMAIL=admin@localhost
-TENANT_ADMIN_PASSWORD=1234
-TENANT_ADMIN_NAME=Admin
-```
-
-**Важно для продакшена:**
-- Измените пароль на более безопасный
-- Используйте надежный email
-- Не коммитьте `.env` в git (уже добавлен в `.gitignore`)
-
-### 2. Шаблон `.env.example`
-
-Для других разработчиков создан файл [.env.example](myproject/.env.example) - скопируйте его в `.env` и настройте:
-
-```bash
-cp .env.example .env
-# Отредактируйте .env своими значениями
-```
-
----
-
-## Как это работает
-
-### При активации через админку
-
-1. Заходите в админ-панель: `http://localhost:8000/admin/`
-2. Раздел "Заявки на регистрацию"
-3. Нажимаете кнопку "Активировать" напротив заявки
-
-**Автоматически выполняется:**
-- Создается тенант (Client)
-- Создается домен ({schema_name}.localhost)
-- Создается триальная подписка (90 дней)
-- **Создается суперпользователь** с credentials из `.env`
-- Обновляется статус заявки на "Одобрено"
-
-### При активации через скрипт
-
-#### Универсальный скрипт [activate_tenant.py](myproject/activate_tenant.py):
-
-```bash
-cd c:\Users\team_\Desktop\test_qwen\myproject
-"c:\Users\team_\Desktop\test_qwen\venv\Scripts\python.exe" activate_tenant.py grach
-```
-
-Где `grach` - это schema_name заявки.
-
-**Вывод скрипта:**
-```
-Найдена заявка: Цветы грач (grach)
-Статус: Ожидает проверки
-Email: owner@example.com
-
-Начинаю активацию...
-
-1. Создание тенанта: grach
-   [OK] Тенант создан (ID: 5)
-2. Создание домена: grach.localhost
-   [OK] Домен создан (ID: 4)
-3. Создание триальной подписки на 90 дней
-   [OK] Подписка создана (ID: 2)
-   Истекает: 2026-01-25 (89 дней)
-4. Создание суперпользователя для тенанта
-   [OK] Суперпользователь создан (ID: 1)
-5. Обновление статуса заявки
-   [OK] Заявка помечена как "Одобрено"
-
-======================================================================
-АКТИВАЦИЯ ЗАВЕРШЕНА УСПЕШНО!
-======================================================================
-Магазин: Цветы грач
-Schema: grach
-Домен: http://grach.localhost:8000/
-Подписка до: 2026-01-25 (89 дней)
-
-Доступ к админке тенанта:
-  URL: http://grach.localhost:8000/admin/
-  Email: admin@localhost
-  Password: 1234
-======================================================================
-```
-
----
-
-## Доступ к админке тенанта
-
-После создания тенанта доступ к его админ-панели:
-
-**URL:** `http://{schema_name}.localhost:8000/admin/`
-
-**Credentials:**
-- Email: значение из `TENANT_ADMIN_EMAIL` (.env)
-- Password: значение из `TENANT_ADMIN_PASSWORD` (.env)
-
-### Пример для тенанта "grach":
-
-```
-URL: http://grach.localhost:8000/admin/
-Email: admin@localhost
-Password: 1234
-```
-
-### Пример для тенанта "mixflowers":
-
-```
-URL: http://mixflowers.localhost:8000/admin/
-Email: admin@localhost
-Password: 1234
-```
-
----
-
-## Создание дополнительных суперпользователей
-
-Если нужно создать еще одного суперпользователя для конкретного тенанта, используйте скрипт [switch_to_tenant.py](myproject/switch_to_tenant.py):
-
-```bash
-cd c:\Users\team_\Desktop\test_qwen\myproject
-"c:\Users\team_\Desktop\test_qwen\venv\Scripts\python.exe" switch_to_tenant.py grach
-```
-
-Откроется интерактивная оболочка Python в контексте тенанта "grach":
-
-```python
-# Вы уже находитесь в схеме тенанта
-from django.contrib.auth import get_user_model
-
-User = get_user_model()
-user = User.objects.create_superuser(
-    email='another_admin@localhost',
-    name='Another Admin',
-    password='password123'
-)
-print(f'Создан пользователь: {user.email}')
-```
-
----
-
-## Технические детали
-
-### Модель пользователя
-
-Проект использует кастомную модель пользователя [CustomUser](myproject/accounts/models.py):
-
-- **USERNAME_FIELD** = `email` (вход по email, а не username)
-- **REQUIRED_FIELDS** = `['name']` (обязательно имя)
-- Username автоматически = email для совместимости
-
-### Метод создания суперпользователя
-
-```python
-User.objects.create_superuser(
-    email='admin@localhost',    # из TENANT_ADMIN_EMAIL
-    name='Admin',               # из TENANT_ADMIN_NAME
-    password='1234'             # из TENANT_ADMIN_PASSWORD
-)
-```
-
-### Переключение между схемами
-
-```python
-from django.db import connection
-from tenants.models import Client
-
-# Переключиться на тенанта
-client = Client.objects.get(schema_name='grach')
-connection.set_tenant(client)
-
-# Теперь все запросы к БД идут в схему "grach"
-User.objects.all()  # Пользователи тенанта "grach"
-
-# Вернуться в public схему
-public_tenant = Client.objects.get(schema_name='public')
-connection.set_tenant(public_tenant)
-```
-
----
-
-## Безопасность
-
-### Для локальной разработки
-
-Текущие настройки подходят:
-```env
-TENANT_ADMIN_EMAIL=admin@localhost
-TENANT_ADMIN_PASSWORD=1234
-TENANT_ADMIN_NAME=Admin
-```
-
-### Для продакшена
-
-**ОБЯЗАТЕЛЬНО измените:**
-
-1. **Пароль:**
-```env
-TENANT_ADMIN_PASSWORD=сложный-случайный-пароль-min-16-символов
-```
-
-2. **Email:**
-```env
-TENANT_ADMIN_EMAIL=admin@yourdomain.com
-```
-
-3. **Дополнительно:**
-- Включите двухфакторную аутентификацию (2FA)
-- Настройте IP whitelist для админки
-- Используйте HTTPS
-- Регулярно меняйте пароль
-
----
-
-## Частые вопросы
-
-### Q: Как изменить пароль для существующих тенантов?
-
-A: Используйте скрипт `switch_to_tenant.py`:
-
-```bash
-python switch_to_tenant.py grach
-```
-
-Затем в интерактивной оболочке:
-
-```python
-from django.contrib.auth import get_user_model
-User = get_user_model()
-
-user = User.objects.get(email='admin@localhost')
-user.set_password('новый-пароль')
-user.save()
-print(f'Пароль обновлен для {user.email}')
-```
-
-### Q: Что если я забыл пароль от админки тенанта?
-
-A: Используйте тот же метод что выше для сброса пароля.
-
-### Q: Можно ли использовать разные пароли для разных тенантов?
-
-A: Сейчас все тенанты получают одинаковые credentials из `.env`. Если нужны уникальные пароли для каждого тенанта:
-
-1. Вариант A: Генерируйте случайный пароль при создании и сохраняйте в notes тенанта
-2. Вариант B: Отправляйте credentials на email владельца
-3. Вариант C: Требуйте смены пароля при первом входе
-
-### Q: Как дать доступ владельцу магазина?
-
-A: Есть несколько вариантов:
-
-**Вариант 1:** Использовать тот же email `admin@localhost` (быстро для разработки)
-
-**Вариант 2:** Создать отдельного пользователя для владельца:
-
-```python
-python switch_to_tenant.py grach
-
-# В оболочке:
-from django.contrib.auth import get_user_model
-User = get_user_model()
-
-owner = User.objects.create_superuser(
-    email='owner@grach.com',  # Email владельца из заявки
-    name='Владелец магазина',
-    password='временный-пароль'
-)
-```
-
-Затем отправьте владельцу:
-- URL: `http://grach.localhost:8000/admin/`
-- Email: `owner@grach.com`
-- Password: `временный-пароль`
-- Попросите сменить пароль при первом входе
-
----
-
-## Обновленные файлы
-
-1. [.env](myproject/.env) - переменные окружения (НЕ коммитить!)
-2. [.env.example](myproject/.env.example) - шаблон для разработчиков
-3. [settings.py](myproject/myproject/settings.py) - подключен django-environ
-4. [tenants/admin.py](myproject/tenants/admin.py) - автосоздание суперпользователя
-5. [activate_tenant.py](myproject/activate_tenant.py) - универсальный скрипт активации
-6. [.gitignore](myproject/.gitignore) - защита секретов
-
----
-
-## Примеры использования
-
-### Сценарий 1: Активация новой заявки через админку
-
-```
-1. http://localhost:8000/admin/ → вход как супер-админ
-2. Заявки на регистрацию → найти pending заявку
-3. Нажать "Активировать"
-4. Готово! Доступ: http://{schema_name}.localhost:8000/admin/
-```
-
-### Сценарий 2: Активация через скрипт
-
-```bash
-cd c:\Users\team_\Desktop\test_qwen\myproject
-"c:\Users\team_\Desktop\test_qwen\venv\Scripts\python.exe" activate_tenant.py myshop
-```
-
-### Сценарий 3: Вход в админку тенанта
-
-```
-1. Открыть: http://myshop.localhost:8000/admin/
-2. Email: admin@localhost
-3. Password: 1234
-4. Готово!
-```
-
----
-
-**Вопросы?** Проверьте логи Django или обратитесь к документации по django-tenants.

myproject/TENANT_REGISTRATION_GUIDE.md

@@ -1,324 +0,0 @@
-# Руководство по системе регистрации тенантов
-
-## Что реализовано
-
-Создана полноценная система регистрации новых магазинов (тенантов) с ручной модерацией администратором.
-
-### 1. Модели данных ([tenants/models.py](myproject/tenants/models.py))
-
-#### Client (обновлена)
-- Добавлен `db_index` для поля `name` (ускорение поиска)
-- Изменено поле `phone` на `PhoneNumberField` (поддержка РБ/РФ форматов)
-- Обновлен `help_text` для `owner_email` (один email может быть у нескольких магазинов для супер-админа)
-
-#### TenantRegistration (новая)
-Модель заявки на регистрацию:
-- `shop_name` - название магазина
-- `schema_name` - желаемый поддомен (с валидацией regex)
-- `owner_email`, `owner_name`, `phone` - контактные данные
-- `status` - статус заявки: pending/approved/rejected
-- `processed_at`, `processed_by` - данные обработки
-- `tenant` - ссылка на созданный тенант после активации
-
-#### Subscription (новая)
-Модель подписки:
-- `plan` - тип плана (триал 90 дней, месяц, квартал, год)
-- `started_at`, `expires_at` - период действия
-- `is_active`, `auto_renew` - статус и автопродление
-- Методы: `is_expired()`, `days_left()`, `create_trial(client)`
-
-#### RESERVED_SCHEMA_NAMES
-Список зарезервированных поддоменов (admin, api, www, и т.д.)
-
----
-
-### 2. Админ-панель ([tenants/admin.py](myproject/tenants/admin.py))
-
-#### ClientAdmin (обновлена)
-- Добавлена колонка `subscription_status` с цветовой индикацией
-- Разрешено редактирование `schema_name` при создании нового тенанта
-- Запрещено удаление тенантов через админку (для безопасности)
-
-#### TenantRegistrationAdmin (новая)
-Функции:
-- Список заявок с фильтрами по статусу и дате
-- Кнопки "Активировать" / "Отклонить" для каждой заявки
-- Массовые действия для обработки нескольких заявок
-- При активации:
-  - Создается тенант (Client)
-  - Создается домен (например: myshop.localhost)
-  - Создается триальная подписка на 90 дней
-  - Заявка помечается как "Одобрено"
-
-#### SubscriptionAdmin (новая)
-- Просмотр и управление подписками
-- Цветовая индикация истекающих подписок (красный < 0 дней, оранжевый < 7 дней)
-
----
-
-### 3. Публичная форма регистрации
-
-#### [tenants/forms.py](myproject/tenants/forms.py) - TenantRegistrationForm
-Валидация:
-- `schema_name`: приведение к lowercase, проверка длины (3-63 символа), проверка на зарезервированные имена, проверка уникальности
-- `owner_email`: проверка на дубликаты pending заявок
-
-#### [tenants/views.py](myproject/tenants/views.py)
-- `TenantRegistrationView` - форма регистрации
-- `RegistrationSuccessView` - страница благодарности
-
-#### HTML шаблоны
-- [base.html](myproject/tenants/templates/tenants/base.html) - базовый шаблон с Bootstrap 5
-- [registration_form.html](myproject/tenants/templates/tenants/registration_form.html) - красивая форма с валидацией
-- [registration_success.html](myproject/tenants/templates/tenants/registration_success.html) - страница с инструкциями
-
----
-
-## Как использовать
-
-### Для пользователей (владельцев будущих магазинов)
-
-1. Откройте публичную форму регистрации:
-   ```
-   http://localhost:8000/register/
-   ```
-
-2. Заполните форму:
-   - Название магазина
-   - Желаемый поддомен (только латиница, цифры, дефис)
-   - Ваше имя
-   - Email
-   - Телефон
-
-3. После отправки увидите страницу благодарности
-
-4. Ожидайте активации администратором (в течение 24 часов)
-
----
-
-### Для администратора
-
-1. Войдите в админ-панель:
-   ```
-   http://localhost:8000/admin/
-   ```
-
-2. Перейдите в раздел "Заявки на регистрацию"
-
-3. Увидите список заявок со статусом "Ожидает проверки"
-
-4. Для активации заявки:
-   - Кликните на кнопку "Активировать" справа от заявки
-   - ИЛИ выберите несколько заявок и используйте массовое действие
-
-5. Что происходит при активации:
-   - Создается новый тенант (Client) с указанным schema_name
-   - Создается домен `{schema_name}.localhost`
-   - Создается триальная подписка на 90 дней
-   - Заявка помечается как "Одобрено"
-   - В поле "Созданный тенант" появляется ссылка на тенант
-
-6. Для отклонения:
-   - Кликните "Отклонить"
-   - Заявка помечается как "Отклонено"
-
----
-
-## Доступ к магазинам
-
-После активации магазин доступен по адресу:
-```
-http://{schema_name}.localhost:8000/
-```
-
-Например, для магазина с `schema_name=myshop`:
-```
-http://myshop.localhost:8000/
-```
-
----
-
-## Управление подписками
-
-### Просмотр подписок
-
-1. Админ-панель → "Подписки"
-2. Видны все подписки с информацией:
-   - Тип плана
-   - Дата начала/окончания
-   - Осталось дней
-   - Истекла или нет
-
-### Продление подписки
-
-1. Откройте подписку тенанта
-2. Измените:
-   - `expires_at` - новую дату окончания
-   - `plan` - новый тип плана (если меняется)
-3. Сохраните
-
-### Типы планов
-
-- **Триальный (90 дней)** - автоматически при создании
-- **Месячный** - 30 дней
-- **Квартальный** - 90 дней
-- **Годовой** - 365 дней
-
----
-
-## Технические детали
-
-### Валидация schema_name
-
-Regex: `^[a-z0-9](?:[a-z0-9\-]{0,61}[a-z0-9])?$`
-
-Правила:
-- Только латинские буквы в нижнем регистре
-- Цифры и дефис разрешены
-- Длина 3-63 символа
-- Не может начинаться или заканчиваться дефисом
-- Не совпадает с зарезервированными именами
-
-### Зарезервированные имена
-
-```python
-RESERVED_SCHEMA_NAMES = [
-    'public', 'admin', 'api', 'www', 'mail', 'ftp', 'smtp',
-    'static', 'media', 'assets', 'cdn', 'app', 'web',
-    'billing', 'register', 'login', 'logout', 'dashboard',
-    'test', 'dev', 'staging', 'production', 'demo'
-]
-```
-
-### Email для супер-админа
-
-Один email может использоваться для нескольких магазинов (полезно для вас как супер-админа для входа в разные тенанты).
-
-Для обычных пользователей форма проверяет наличие pending заявок с таким же email.
-
----
-
-## Что дальше (рекомендации)
-
-### 1. Email-уведомления
-
-Добавить отправку писем:
-- Пользователю при активации заявки
-- Пользователю при истечении подписки (за 7 дней, за 1 день)
-- Админу при новой заявке
-
-### 2. Биллинг
-
-Создать страницу `/billing/` где владелец магазина может:
-- Посмотреть текущую подписку
-- Продлить подписку
-- Оплатить через платежную систему
-
-### 3. Middleware для is_active
-
-Если нужна жесткая блокировка доступа к деактивированным магазинам, создать middleware:
-```python
-# tenants/middleware.py
-class TenantStatusMiddleware:
-    def __call__(self, request):
-        if hasattr(request, 'tenant'):
-            if not request.tenant.is_active:
-                # Показать страницу "Магазин заблокирован"
-                pass
-
-            sub = request.tenant.subscription
-            if sub.is_expired():
-                # Редирект на /billing/renew/
-                pass
-
-        return self.get_response(request)
-```
-
-### 4. Автоматическая очистка
-
-Создать команду для удаления старых отклоненных заявок:
-```bash
-python manage.py cleanup_old_registrations --days=30
-```
-
----
-
-## Структура файлов
-
-```
-myproject/tenants/
-├── models.py                   # Модели Client, TenantRegistration, Subscription
-├── admin.py                    # Админ-панель с функционалом активации
-├── forms.py                    # Форма регистрации с валидацией
-├── views.py                    # Views для публичной регистрации
-├── urls.py                     # Роуты /register/ и /register/success/
-└── templates/tenants/
-    ├── base.html              # Базовый шаблон
-    ├── registration_form.html # Форма регистрации
-    └── registration_success.html # Страница благодарности
-```
-
----
-
-## Тестирование
-
-### 1. Регистрация магазина
-
-```bash
-# Запустите сервер
-python manage.py runserver
-
-# Откройте браузер
-http://localhost:8000/register/
-
-# Заполните форму:
-Название: Тестовый магазин
-Поддомен: testshop
-Имя: Иван Иванов
-Email: test@example.com
-Телефон: +375291234567
-
-# Отправьте заявку
-```
-
-### 2. Активация через админку
-
-```bash
-# Войдите в админку
-http://localhost:8000/admin/
-
-# Логин/пароль супер-админа
-# Перейдите в "Заявки на регистрацию"
-# Нажмите "Активировать" напротив заявки
-```
-
-### 3. Проверка созданного магазина
-
-```bash
-# Откройте браузер
-http://testshop.localhost:8000/
-
-# Должна открыться страница магазина
-```
-
----
-
-## Поддержка
-
-При возникновении проблем проверьте:
-
-1. Миграции применены: `python manage.py migrate_schemas --shared`
-2. В `settings.py` приложение `tenants` в `SHARED_APPS`
-3. В `urls_public.py` подключены роуты tenants
-4. Виртуальное окружение активировано
-5. `phonenumber_field` установлен
-
----
-
-**Система готова к использованию!**
-
-Теперь вы можете:
-- Принимать заявки на регистрацию
-- Модерировать их через админку
-- Управлять подписками
-- Контролировать доступ к магазинам

myproject/TESTS_README.md

@@ -1,212 +0,0 @@
-# Тесты для расчета себестоимости
-
-## Структура тестов
-
-```
-products/tests/
-├── __init__.py                    # Импорты всех тестов
-└── test_cost_calculator.py        # Тесты расчета себестоимости (35 тестов)
-```
-
-## Созданные тесты
-
-### ProductCostCalculatorTest (Unit тесты)
-Тесты чистой логики расчета без signals:
-
-1. **test_calculate_weighted_average_cost_no_batches** - товар без партий → 0.00
-2. **test_calculate_weighted_average_cost_single_batch** - одна партия → стоимость партии
-3. **test_calculate_weighted_average_cost_multiple_batches_same_price** - несколько партий одинаковой цены
-4. **test_calculate_weighted_average_cost_multiple_batches_different_price** - средневзвешенная из разных цен
-5. **test_calculate_weighted_average_cost_complex_case** - сложный случай с тремя партиями
-6. **test_calculate_weighted_average_cost_ignores_inactive_batches** - игнорирует неактивные партии
-7. **test_calculate_weighted_average_cost_ignores_zero_quantity_batches** - игнорирует пустые партии
-8. **test_update_product_cost_updates_field** - обновление поля в БД
-9. **test_update_product_cost_no_save** - работа без сохранения
-10. **test_update_product_cost_no_change** - обработка случая без изменений
-11. **test_get_cost_details** - получение детальной информации
-12. **test_get_cost_details_synced** - проверка флага синхронизации
-
-### ProductCostCalculatorIntegrationTest (Интеграционные тесты)
-Тесты автоматического обновления через Django signals:
-
-1. **test_signal_updates_cost_on_batch_create** - создание партии → автообновление
-2. **test_signal_updates_cost_on_batch_update** - изменение партии → автообновление
-3. **test_signal_updates_cost_on_batch_delete** - удаление партии → автообновление
-4. **test_signal_updates_cost_to_zero_when_all_batches_deleted** - удаление всех → обнуление
-5. **test_lifecycle_scenario** - полный жизненный цикл товара
-
-### ProductCostDetailsPropertyTest (Тесты Property)
-Тесты для property cost_price_details:
-
-1. **test_cost_price_details_property_exists** - property существует
-2. **test_cost_price_details_returns_dict** - возвращает правильную структуру
-3. **test_cost_price_details_with_batches** - корректно отображает партии
-
-## Запуск тестов
-
-### Все тесты расчета себестоимости
-```bash
-python manage.py test products.tests.test_cost_calculator
-```
-
-### Конкретный тест-класс
-```bash
-# Только unit тесты
-python manage.py test products.tests.test_cost_calculator.ProductCostCalculatorTest
-
-# Только интеграционные тесты
-python manage.py test products.tests.test_cost_calculator.ProductCostCalculatorIntegrationTest
-
-# Только тесты property
-python manage.py test products.tests.test_cost_calculator.ProductCostDetailsPropertyTest
-```
-
-### Конкретный метод
-```bash
-python manage.py test products.tests.test_cost_calculator.ProductCostCalculatorTest.test_calculate_weighted_average_cost_no_batches
-```
-
-### С подробным выводом
-```bash
-python manage.py test products.tests.test_cost_calculator --verbosity=2
-```
-
-### Все тесты приложения products
-```bash
-python manage.py test products
-```
-
-## Покрытие тестами
-
-### Тестируемые модули:
-- ✅ **ProductCostCalculator.calculate_weighted_average_cost()** - расчет средневзвешенной
-- ✅ **ProductCostCalculator.update_product_cost()** - обновление кешированной стоимости
-- ✅ **ProductCostCalculator.get_cost_details()** - получение деталей
-- ✅ **Product.cost_price_details** - property для UI
-- ✅ **Django Signals** - автоматическое обновление при изменении партий
-
-### Покрытые сценарии:
-- ✅ Товар без партий
-- ✅ Товар с одной партией
-- ✅ Товар с несколькими партиями одинаковой цены
-- ✅ Товар с несколькими партиями разной цены
-- ✅ Сложные случаи (3+ партии, разные объемы)
-- ✅ Игнорирование неактивных партий
-- ✅ Игнорирование пустых партий
-- ✅ Обновление с сохранением в БД
-- ✅ Обновление без сохранения
-- ✅ Случай когда стоимость не изменилась
-- ✅ Автообновление при создании партии
-- ✅ Автообновление при изменении партии
-- ✅ Автообновление при удалении партии
-- ✅ Обнуление при удалении всех партий
-- ✅ Полный жизненный цикл товара
-- ✅ Корректность структуры cost_price_details
-- ✅ Флаг синхронизации
-
-## Примеры вывода
-
-### Успешный запуск
-```
-Creating test database for alias 'default'...
-System check identified no issues (0 silenced).
-....................
-----------------------------------------------------------------------
-Ran 20 tests in 2.345s
-
-OK
-Destroying test database for alias 'default'...
-```
-
-### Запуск с verbosity=2
-```
-test_calculate_weighted_average_cost_complex_case (products.tests.test_cost_calculator.ProductCostCalculatorTest) ... ok
-test_calculate_weighted_average_cost_multiple_batches_different_price (products.tests.test_cost_calculator.ProductCostCalculatorTest) ... ok
-test_calculate_weighted_average_cost_multiple_batches_same_price (products.tests.test_cost_calculator.ProductCostCalculatorTest) ... ok
-test_calculate_weighted_average_cost_no_batches (products.tests.test_cost_calculator.ProductCostCalculatorTest) ... ok
-test_calculate_weighted_average_cost_single_batch (products.tests.test_cost_calculator.ProductCostCalculatorTest) ... ok
-...
-```
-
-## Отладка тестов
-
-### Запуск одного теста с PDB
-```bash
-python manage.py test products.tests.test_cost_calculator.ProductCostCalculatorTest.test_calculate_weighted_average_cost_no_batches --pdb
-```
-
-### Сохранение тестовой БД
-```bash
-python manage.py test products.tests.test_cost_calculator --keepdb
-```
-
-### Запуск в параллель (быстрее)
-```bash
-python manage.py test products.tests.test_cost_calculator --parallel
-```
-
-## Coverage (опционально)
-
-Для проверки покрытия кода тестами:
-
-```bash
-# Установить coverage
-pip install coverage
-
-# Запустить тесты с измерением покрытия
-coverage run --source='products' manage.py test products.tests.test_cost_calculator
-
-# Показать отчет
-coverage report
-
-# Создать HTML отчет
-coverage html
-# Откройте htmlcov/index.html в браузере
-```
-
-## CI/CD Integration
-
-Пример для GitHub Actions:
-
-```yaml
-- name: Run cost calculator tests
-  run: |
-    python manage.py test products.tests.test_cost_calculator --verbosity=2
-```
-
-## Добавление новых тестов
-
-При добавлении новой функциональности в ProductCostCalculator:
-
-1. Добавьте unit тесты в `ProductCostCalculatorTest`
-2. Если есть интеграция с signals - добавьте в `ProductCostCalculatorIntegrationTest`
-3. Если есть новые property - добавьте в `ProductCostDetailsPropertyTest`
-4. Запустите все тесты для проверки
-5. Обновите этот README с описанием новых тестов
-
-## Troubleshooting
-
-### Ошибка: "No module named 'django'"
-Активируйте виртуальное окружение:
-```bash
-# Windows
-venv\Scripts\activate
-
-# Linux/Mac
-source venv/bin/activate
-```
-
-### Ошибка: "relation does not exist"
-Создайте тестовую БД:
-```bash
-python manage.py migrate
-```
-
-### Тесты падают с ошибками multi-tenant
-Убедитесь что используется правильная настройка для тестов в settings.py.
-
----
-
-**Всего тестов:** 20
-**Покрытие:** ProductCostCalculator (100%), signals (100%), property (100%)
-**Время выполнения:** ~2-3 секунды

myproject/accounts/admin.py

@@ -36,3 +36,7 @@ class CustomUserAdmin(UserAdmin):
 
 admin.site.register(CustomUser, CustomUserAdmin)
 
+admin.site.site_header = "Админ-панель"
+admin.site.site_title = "Админ-панель"
+admin.site.index_title = "Добро пожаловать"
+

myproject/accounts/backends.py

@@ -0,0 +1,93 @@
+# -*- coding: utf-8 -*-
+"""
+Authentication backend для CustomUser (пользователей тенантов).
+
+Этот backend используется для аутентификации пользователей магазинов.
+Работает ТОЛЬКО на tenant доменах, НЕ на public домене.
+
+ВАЖНО: CustomUser теперь в TENANT_APPS - каждый тенант имеет свою таблицу!
+Backend работает с таблицей accounts_customuser в текущей tenant schema.
+
+ВАЖНО: НЕ наследуется от ModelBackend! Полностью независимая реализация.
+"""
+from django.db import connection
+
+
+class TenantUserBackend:
+    """
+    Backend аутентификации для CustomUser (tenant-only).
+
+    НЕ наследуется от ModelBackend! Полностью независимая реализация.
+    
+    Особенности:
+    - Работает ТОЛЬКО на tenant доменах (не на public)
+    - Ищет пользователя в таблице accounts_customuser текущей tenant schema
+    - Один email в разных тенантах = разные записи в разных таблицах БД
+
+    Пользователь из tenant A физически не существует в tenant B.
+    """
+
+    def authenticate(self, request, username=None, password=None, **kwargs):
+        """
+        Аутентификация CustomUser по email и паролю.
+
+        Args:
+            request: HTTP запрос
+            username: Email пользователя
+            password: Пароль
+
+        Returns:
+            CustomUser если аутентификация успешна, иначе None
+        """
+        # Не работает на public домене
+        schema_name = getattr(connection, 'schema_name', 'public')
+        if schema_name == 'public':
+            return None
+
+        if username is None or password is None:
+            return None
+
+        # Импортируем напрямую, не через get_user_model()
+        # т.к. AUTH_USER_MODEL теперь PlatformAdmin
+        from accounts.models import CustomUser
+
+        try:
+            # django-tenants автоматически направляет запрос в текущую schema
+            user = CustomUser.objects.get(email=username)
+        except CustomUser.DoesNotExist:
+            # Run the default password hasher once to reduce the timing
+            # difference between an existing and a non-existing user
+            CustomUser().set_password(password)
+            return None
+
+        if not user.check_password(password):
+            return None
+
+        if not self.user_can_authenticate(user):
+            return None
+
+        return user
+
+    def get_user(self, user_id):
+        """
+        Получение CustomUser по ID.
+
+        На public домене возвращает None.
+        """
+        schema_name = getattr(connection, 'schema_name', 'public')
+        if schema_name == 'public':
+            return None
+
+        from accounts.models import CustomUser
+
+        try:
+            return CustomUser.objects.get(pk=user_id)
+        except CustomUser.DoesNotExist:
+            return None
+
+    def user_can_authenticate(self, user):
+        """
+        Проверка что пользователь активен.
+        """
+        is_active = getattr(user, 'is_active', None)
+        return is_active or is_active is None

myproject/accounts/management/__init__.py

@@ -0,0 +1 @@
+

myproject/accounts/management/commands/__init__.py

@@ -0,0 +1 @@
+

myproject/accounts/migrations/0001_initial.py

@@ -1,6 +1,5 @@
-# Generated by Django 5.0.10 on 2025-11-15 11:57
+# Generated by Django 5.0.10 on 2026-01-14 07:04
 
-import django.contrib.auth.validators
 import django.utils.timezone
 import uuid
 from django.db import migrations, models
@@ -11,7 +10,6 @@ class Migration(migrations.Migration):
     initial = True
 
     dependencies = [
-        ('auth', '0012_alter_user_first_name_max_length'),
     ]
 
     operations = [
@@ -21,26 +19,20 @@ class Migration(migrations.Migration):
                 ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
                 ('password', models.CharField(max_length=128, verbose_name='password')),
                 ('last_login', models.DateTimeField(blank=True, null=True, verbose_name='last login')),
-                ('is_superuser', models.BooleanField(default=False, help_text='Designates that this user has all permissions without explicitly assigning them.', verbose_name='superuser status')),
-                ('username', models.CharField(error_messages={'unique': 'A user with that username already exists.'}, help_text='Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.', max_length=150, unique=True, validators=[django.contrib.auth.validators.UnicodeUsernameValidator()], verbose_name='username')),
-                ('first_name', models.CharField(blank=True, max_length=150, verbose_name='first name')),
-                ('last_name', models.CharField(blank=True, max_length=150, verbose_name='last name')),
-                ('is_staff', models.BooleanField(default=False, help_text='Designates whether the user can log into this admin site.', verbose_name='staff status')),
-                ('is_active', models.BooleanField(default=True, help_text='Designates whether this user should be treated as active. Unselect this instead of deleting accounts.', verbose_name='active')),
-                ('date_joined', models.DateTimeField(default=django.utils.timezone.now, verbose_name='date joined')),
                 ('email', models.EmailField(max_length=254, unique=True)),
                 ('name', models.CharField(max_length=100)),
+                ('is_active', models.BooleanField(default=True)),
+                ('is_staff', models.BooleanField(default=False)),
+                ('is_superuser', models.BooleanField(default=False)),
+                ('date_joined', models.DateTimeField(default=django.utils.timezone.now)),
                 ('is_email_confirmed', models.BooleanField(default=False)),
                 ('email_confirmation_token', models.UUIDField(default=uuid.uuid4, editable=False, unique=True)),
                 ('email_confirmed_at', models.DateTimeField(blank=True, null=True)),
                 ('password_reset_token', models.UUIDField(blank=True, editable=False, null=True, unique=True)),
-                ('groups', models.ManyToManyField(blank=True, help_text='The groups this user belongs to.', related_name='custom_user_set', to='auth.group', verbose_name='groups')),
-                ('user_permissions', models.ManyToManyField(blank=True, help_text='Specific permissions for this user.', related_name='custom_user_set', to='auth.permission', verbose_name='user permissions')),
             ],
             options={
-                'verbose_name': 'user',
-                'verbose_name_plural': 'users',
-                'abstract': False,
+                'verbose_name': 'Пользователь магазина',
+                'verbose_name_plural': 'Пользователи магазина',
             },
         ),
     ]

myproject/accounts/models.py

@@ -1,5 +1,5 @@
 from django.db import models
-from django.contrib.auth.models import AbstractUser, BaseUserManager
+from django.contrib.auth.models import AbstractBaseUser, BaseUserManager
 from django.utils import timezone
 import uuid
 
@@ -9,22 +9,24 @@ class CustomUserManager(BaseUserManager):
         if not email:
             raise ValueError('Email обязателен')
         email = self.normalize_email(email)
-        # Generate a unique username based on email to satisfy the AbstractUser constraint
-        username = email
-        user = self.model(email=email, name=name, username=username, **extra_fields)
+
+        # SECURITY FIX: Явно устанавливаем флаги безопасности в False по умолчанию
+        # Обычные пользователи НЕ должны иметь доступ к админке
+        extra_fields.setdefault('is_staff', False)
+        extra_fields.setdefault('is_superuser', False)
+
+        user = self.model(email=email, name=name, **extra_fields)
         user.set_password(password)
         user.save(using=self._db)
         return user
 
     def create_superuser(self, email, name, password=None, **extra_fields):
-        extra_fields.setdefault('is_staff', True)
+        extra_fields.setdefault('is_staff', False)  # CustomUser не должен иметь доступ к Django Admin
         extra_fields.setdefault('is_superuser', True)
         extra_fields.setdefault('is_active', True)
         # Суперпользователь автоматически имеет подтвержденный email
         extra_fields.setdefault('is_email_confirmed', True)
 
-        if extra_fields.get('is_staff') is not True:
-            raise ValueError('Суперпользователь должен иметь is_staff=True.')
         if extra_fields.get('is_superuser') is not True:
             raise ValueError('Суперпользователь должен иметь is_superuser=True.')
 
@@ -36,38 +38,79 @@ class CustomUserManager(BaseUserManager):
         return user
 
 
-class CustomUser(AbstractUser):
+class CustomUser(AbstractBaseUser):
+    """
+    Пользователь тенанта (магазина).
+
+    ВАЖНО: Эта модель в TENANT_APPS - каждый тенант имеет свою таблицу!
+    Один email в разных тенантах = разные записи в разных схемах БД.
+    Полная изоляция обеспечивается на уровне PostgreSQL schemas.
+
+    НЕ является AUTH_USER_MODEL (это PlatformAdmin).
+    НЕ использует Django Groups/Permissions - используется своя система ролей (UserRole).
+    """
     email = models.EmailField(unique=True)
     name = models.CharField(max_length=100)
+    
+    # Стандартные поля для совместимости с Django auth
+    is_active = models.BooleanField(default=True)
+    is_staff = models.BooleanField(default=False)  # Для доступа к админке (если нужно)
+    is_superuser = models.BooleanField(default=False)  # Для полных прав в тенанте
+    date_joined = models.DateTimeField(default=timezone.now)
+
     is_email_confirmed = models.BooleanField(default=False)
     email_confirmation_token = models.UUIDField(default=uuid.uuid4, editable=False, unique=True)
     email_confirmed_at = models.DateTimeField(null=True, blank=True)
     password_reset_token = models.UUIDField(null=True, blank=True, editable=False, unique=True)
-    
+
     USERNAME_FIELD = 'email'
     REQUIRED_FIELDS = ['name']
 
-    objects = CustomUserManager()  # Добавляем кастомный менеджер
+    objects = CustomUserManager()
 
-    # Изменяем related_name для избежания конфликта с встроенной моделью User
-    groups = models.ManyToManyField(
-        'auth.Group',
-        related_name='custom_user_set',
-        blank=True,
-        verbose_name='groups',
-        help_text='The groups this user belongs to.',
-    )
-    user_permissions = models.ManyToManyField(
-        'auth.Permission',
-        related_name='custom_user_set',
-        blank=True,
-        verbose_name='user permissions',
-        help_text='Specific permissions for this user.',
-    )
+    class Meta:
+        verbose_name = "Пользователь магазина"
+        verbose_name_plural = "Пользователи магазина"
 
     def __str__(self):
         return self.email
 
+    def has_perm(self, perm, obj=None):
+        """
+        Проверка разрешения через authentication backends.
+        Django вызывает все зарегистрированные backends по очереди.
+        """
+        if not self.is_active:
+            return False
+        
+        # Импортируем здесь, чтобы избежать циклических импортов
+        from django.contrib.auth import get_backends
+        
+        for backend in get_backends():
+            if hasattr(backend, 'has_perm'):
+                result = backend.has_perm(self, perm, obj)
+                if result is not None:  # Backend обработал запрос
+                    return result
+        
+        return False
+
+    def has_module_perms(self, app_label):
+        """
+        Проверка разрешений для модуля через authentication backends.
+        """
+        if not self.is_active:
+            return False
+        
+        from django.contrib.auth import get_backends
+        
+        for backend in get_backends():
+            if hasattr(backend, 'has_module_perms'):
+                result = backend.has_module_perms(self, app_label)
+                if result is not None:  # Backend обработал запрос
+                    return result
+        
+        return False
+
     def generate_confirmation_token(self):
         """Генерирует новый токен для подтверждения email"""
         self.email_confirmation_token = uuid.uuid4()
@@ -79,3 +122,33 @@ class CustomUser(AbstractUser):
         self.is_email_confirmed = True
         self.email_confirmed_at = timezone.now()
         self.save()
+
+    def get_tenant_role(self):
+        """Получить роль пользователя в текущем тенанте"""
+        from user_roles.services import RoleService
+        return RoleService.get_user_role(self)
+
+    def has_role(self, *role_codes):
+        """Проверить, имеет ли пользователь одну из указанных ролей"""
+        from user_roles.services import RoleService
+        return RoleService.user_has_role(self, *role_codes)
+
+    @property
+    def is_owner(self):
+        """Является ли пользователь владельцем"""
+        return self.has_role('owner')
+
+    @property
+    def is_manager(self):
+        """Является ли пользователь менеджером"""
+        return self.has_role('manager')
+
+    @property
+    def is_florist(self):
+        """Является ли пользователь флористом"""
+        return self.has_role('florist')
+
+    @property
+    def is_courier(self):
+        """Является ли пользователь курьером"""
+        return self.has_role('courier')

myproject/accounts/static/accounts/js/auth.js

@@ -0,0 +1,25 @@
+// Authentication-related JavaScript functionality
+
+// Password visibility toggle handler
+document.addEventListener('DOMContentLoaded', function() {
+    // Add click handlers to all password toggle buttons
+    document.querySelectorAll('.show-password-btn').forEach(button => {
+        button.addEventListener('click', function() {
+            const targetId = this.getAttribute('data-target');
+            const targetInput = document.getElementById(targetId);
+            const icon = this.querySelector('i');
+            
+            if (targetInput && icon) {
+                if (targetInput.type === 'password') {
+                    targetInput.type = 'text';
+                    icon.classList.remove('bi-eye');
+                    icon.classList.add('bi-eye-slash');
+                } else {
+                    targetInput.type = 'password';
+                    icon.classList.remove('bi-eye-slash');
+                    icon.classList.add('bi-eye');
+                }
+            }
+        });
+    });
+});

myproject/accounts/templates/accounts/password_reset_confirm.html

@@ -3,46 +3,40 @@
 {% block title %}Сброс пароля{% endblock %}
 
 {% block content %}
-<div class="container">
-    <div class="form-container">
-        <h2 class="text-center mb-4">Сброс пароля</h2>
+<div class="container d-flex align-items-center justify-content-center" style="min-height: 70vh;">
+    <div class="card shadow-sm" style="max-width: 420px; width: 100%;">
+        <div class="card-body p-4">
+            <!-- Заголовок -->
+            <div class="text-center mb-4">
+                <h3 class="fw-bold mb-2">Сброс пароля</h3>
+                <p class="text-muted mb-0">Введите новый пароль</p>
+            </div>
 
-        <div class="tab-content">
-            <div class="tab-pane fade show active" id="reset-password">
-                <form method="post">
-                    {% csrf_token %}
-                    {% include 'accounts/password_input.html' with field_name='password1' field_label='Новый пароль' required=True %}
-                    {% include 'accounts/password_input.html' with field_name='password2' field_label='Подтверждение пароля' required=True %}
-                    <button type="submit" class="btn btn-primary w-100">Сбросить пароль</button>
-                </form>
+            <!-- Сообщения -->
+            {% if messages %}
+                {% for message in messages %}
+                    <div class="alert alert-{{ message.tags }} alert-dismissible fade show" role="alert">
+                        {{ message }}
+                        <button type="button" class="btn-close" data-bs-dismiss="alert"></button>
+                    </div>
+                {% endfor %}
+            {% endif %}
+
+            <!-- Форма сброса пароля -->
+            <form method="post">
+                {% csrf_token %}
+                {% include 'accounts/password_input.html' with field_name='password1' field_label='Новый пароль' required=True %}
+                {% include 'accounts/password_input.html' with field_name='password2' field_label='Подтверждение пароля' required=True %}
+                <button type="submit" class="btn btn-primary w-100 py-2 mb-3">Сбросить пароль</button>
                 
                 <!-- Ссылка на вход -->
-                <div class="text-center mt-3">
-                    <a href="{% url 'accounts:login' %}" class="text-decoration-none">Вспомнили пароль? Войти</a>
+                <div class="text-center">
+                    <a href="{% url 'accounts:login' %}" class="text-decoration-none text-muted">
+                        <small>Вспомнили пароль? Войти</small>
+                    </a>
                 </div>
-            </div>
+            </form>
         </div>
     </div>
 </div>
-
-<script>
-// Добавляем обработчик для показа/скрытия пароля
-document.querySelectorAll('.show-password-btn').forEach(button => {
-    button.addEventListener('click', function() {
-        const targetId = this.getAttribute('data-target');
-        const targetInput = document.getElementById(targetId);
-        const icon = this.querySelector('i');
-        
-        if (targetInput.type === 'password') {
-            targetInput.type = 'text';
-            icon.classList.remove('bi-eye');
-            icon.classList.add('bi-eye-slash');
-        } else {
-            targetInput.type = 'password';
-            icon.classList.remove('bi-eye-slash');
-            icon.classList.add('bi-eye');
-        }
-    });
-});
-</script>
 {% endblock %}

myproject/accounts/templates/accounts/password_setup_confirm.html

@@ -0,0 +1,108 @@
+<!DOCTYPE html>
+<html lang="ru">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Установка пароля</title>
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            min-height: 100vh;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            padding: 20px;
+        }
+        .container {
+            background: white;
+            border-radius: 12px;
+            box-shadow: 0 10px 40px rgba(0,0,0,0.1);
+            padding: 40px;
+            max-width: 400px;
+            width: 100%;
+        }
+        h1 {
+            color: #333;
+            margin-bottom: 10px;
+            font-size: 24px;
+        }
+        .subtitle {
+            color: #666;
+            margin-bottom: 30px;
+            font-size: 14px;
+        }
+        .form-group {
+            margin-bottom: 20px;
+        }
+        label {
+            display: block;
+            color: #333;
+            font-weight: 500;
+            margin-bottom: 8px;
+        }
+        input[type="password"] {
+            width: 100%;
+            padding: 12px;
+            border: 1px solid #ddd;
+            border-radius: 6px;
+            font-size: 14px;
+        }
+        input[type="password"]:focus {
+            outline: none;
+            border-color: #667eea;
+        }
+        .btn {
+            width: 100%;
+            padding: 12px;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+            border: none;
+            border-radius: 6px;
+            font-size: 16px;
+            font-weight: 500;
+            cursor: pointer;
+        }
+        .btn:hover {
+            opacity: 0.9;
+        }
+        .messages {
+            margin-bottom: 20px;
+        }
+        .messages .error {
+            background: #fee;
+            color: #c33;
+            padding: 10px;
+            border-radius: 6px;
+            font-size: 14px;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h1>Установка пароля</h1>
+        <p class="subtitle">для {{ tenant.name }}</p>
+
+        {% if messages %}
+            <div class="messages">
+                {% for message in messages %}
+                    <div class="{{ message.tags }}">{{ message }}</div>
+                {% endfor %}
+            {% endif %}
+
+        <form method="post">
+            {% csrf_token %}
+            <div class="form-group">
+                <label for="id_password1">Пароль</label>
+                <input type="password" name="password1" id="id_password1" required>
+            </div>
+            <div class="form-group">
+                <label for="id_password2">Подтвердите пароль</label>
+                <input type="password" name="password2" id="id_password2" required>
+            </div>
+            <button type="submit" class="btn">Установить пароль</button>
+        </form>
+    </div>
+</body>
+</html>

myproject/accounts/templates/accounts/register.html

@@ -1,9 +0,0 @@
-{% extends 'base.html' %}
-
-{% block title %}Регистрация{% endblock %}
-
-{% block content %}
-<h2>Регистрация</h2>
-<p>Форма регистрации доступна на главной странице.</p>
-<a href="{% url 'index' %}">Перейти на главную</a>
-{% endblock %}

myproject/accounts/urls.py

@@ -4,7 +4,6 @@ from . import views
 app_name = 'accounts'
 
 urlpatterns = [
-    path('register/', views.register_view, name='register'),
     path('login/', views.login_view, name='login'),
     path('logout/', views.logout_view, name='logout'),
     path('profile/', views.profile_view, name='profile'),
@@ -12,4 +11,5 @@ urlpatterns = [
     path('confirm/<uuid:token>/', views.confirm_email, name='confirm_email'),
     path('password-reset/', views.password_reset_request, name='password_reset'),
     path('password-reset/<uuid:token>/', views.password_reset_confirm, name='password_reset_confirm'),
+    path('setup-password/<uuid:token>/', views.password_setup_confirm, name='password_setup'),
 ]

myproject/accounts/views.py

@@ -1,5 +1,5 @@
 from django.shortcuts import render, redirect, get_object_or_404
-from django.contrib.auth import login, authenticate, logout
+from django.contrib.auth import login, authenticate, logout, get_user_model
 from django.contrib import messages
 from django.core.mail import send_mail
 from django.conf import settings
@@ -11,97 +11,57 @@ from django.contrib.auth.tokens import default_token_generator
 from django.contrib.auth.decorators import login_required
 from django.contrib.auth import update_session_auth_hash
 from django.contrib.auth.forms import PasswordChangeForm
-from .forms import CustomUserCreationForm, PasswordResetForm
+from django.db import connection
+from .forms import PasswordResetForm
 from .models import CustomUser
 import uuid
 
 
-def register(request):
-    if request.method == 'POST':
-        form = CustomUserCreationForm(request.POST)
-        if form.is_valid():
-            user = form.save(commit=False)
-            user.is_active = False  # Пользователь не активен до подтверждения email
-            user.save()
-            
-            # Отправляем письмо с подтверждением
-            confirmation_url = request.build_absolute_uri(
-                reverse('accounts:confirm_email', kwargs={'token': user.email_confirmation_token})
-            )
-            
-            subject = 'Подтверждение Email'
-            message = f'Привет {user.name}!\n\nДля подтверждения вашего email перейдите по следующей ссылке: {confirmation_url}\n\nСпасибо за регистрацию!'
-            from_email = settings.DEFAULT_FROM_EMAIL
-            recipient_list = [user.email]
-            
-            # Выводим письмо в консоль, как вы просили
-            print(f"Письмо для подтверждения:\nТема: {subject}\nСообщение:\n{message}\nПолучатель: {recipient_list}")
-            
-            # В реальной системе отправили бы письмо:
-            # send_mail(subject, message, from_email, recipient_list, fail_silently=False)
-            
-            messages.success(request, 'Пожалуйста, проверьте вашу почту для подтверждения email.')
-            return redirect('accounts:login')
-    else:
-        form = CustomUserCreationForm()
-    
-    return render(request, 'register.html', {'form': form})
-
-
-def register_view(request):
-    if request.method == 'POST':
-        form = CustomUserCreationForm(request.POST)
-        if form.is_valid():
-            user = form.save(commit=False)
-            user.is_active = False  # Пользователь не активен до подтверждения email
-            user.save()
-            
-            # Отправляем письмо с подтверждением (выводим в консоль)
-            confirmation_url = request.build_absolute_uri(
-                f'/accounts/confirm/{user.email_confirmation_token}/'
-            )
-            
-            subject = 'Подтверждение Email'
-            message = f'Привет {user.name}!\n\nДля подтверждения вашего email перейдите по следующей ссылке: {confirmation_url}\n\nСпасибо за регистрацию!'
-            from_email = 'noreply@example.com'  # Используем значение из настроек
-            recipient_list = [user.email]
-            
-            # Выводим письмо в консоль, как вы просили
-            print(f"Письмо для подтверждения:\nТема: {subject}\nСообщение:\n{message}\nПолучатель: {recipient_list}")
-            
-            messages.success(request, 'Пожалуйста, проверьте вашу почту для подтверждения email.')
-            return redirect('accounts:login')  # Перенаправляем на страницу входа после регистрации
-    else:
-        form = CustomUserCreationForm()
-    
-    return render(request, 'register.html', {'form': form})
-
-
 def login_view(request):
+    """
+    Страница входа для пользователей тенанта (CustomUser).
+
+    SECURITY: Работает ТОЛЬКО на tenant доменах!
+    На public домене перенаправляет на страницу логина PlatformAdmin.
+    """
+    # Проверяем что мы НЕ на public домене
+    schema_name = getattr(connection, 'schema_name', 'public')
+    if schema_name == 'public':
+        messages.info(
+            request,
+            'Вход для пользователей магазинов доступен только на домене вашего магазина. '
+            'Если вы администратор платформы, используйте /platform/login/'
+        )
+        return redirect('platform_admin:login')
+
     if request.method == 'POST':
         email = request.POST.get('email')
         password = request.POST.get('password')
-        
+
         # Используем email как логин
         user = authenticate(request, username=email, password=password)
-        
+
         if user is not None:
-            if user.is_email_confirmed:  # Проверяем, подтвержден ли email
-                login(request, user)
+            # Проверяем, что это CustomUser (пользователь магазина), а не PlatformAdmin
+            if not isinstance(user, CustomUser):
+                # Не раскрываем информацию о существовании других типов пользователей
+                messages.error(request, 'Пользователь не найден.')
+            elif not user.is_email_confirmed:
+                messages.error(request, 'Пожалуйста, подтвердите ваш email для входа.')
+            else:
+                login(request, user, backend='accounts.backends.TenantUserBackend')
                 # Перенаправляем на главную страницу после успешного входа
                 next_page = request.GET.get('next', 'index')  # Если есть параметр next, переходим туда
                 return redirect(next_page)
-            else:
-                messages.error(request, 'Пожалуйста, подтвердите ваш email для входа.')
         else:
             messages.error(request, 'Неверный email или пароль.')
-    
+
     return render(request, 'login.html')
 
 
 def logout_view(request):
     logout(request)
-    return redirect('index')
+    return redirect('/')
 
 
 @login_required
@@ -174,7 +134,7 @@ def password_reset_request(request):
     else:
         form = PasswordResetForm()
     
-    return render(request, 'login.html', {'form': form})
+    return render(request, 'accounts/password_reset_request.html', {'form': form})
 
 
 def password_reset_confirm(request, token):
@@ -182,7 +142,7 @@ def password_reset_confirm(request, token):
         user = CustomUser.objects.get(password_reset_token=token)
     except CustomUser.DoesNotExist:
         messages.error(request, 'Ссылка для восстановления пароля недействительна.')
-        return redirect('index')
+        return redirect('/')
     
     if request.method == 'POST':
         password1 = request.POST.get('password1')
@@ -198,4 +158,127 @@ def password_reset_confirm(request, token):
             messages.error(request, 'Пароли не совпадают.')
     
     # Отображаем форму смены пароля
-    return render(request, 'accounts/password_reset_confirm.html', {'user': user})
+    return render(request, 'accounts/password_reset_confirm.html', {'user': user})
+
+
+def password_setup_confirm(request, token):
+    """
+    Позволить владельцу тенанта установить начальный пароль после одобрения регистрации.
+    Похоже на сброс пароля, но для новых аккаунтов.
+    """
+    from tenants.models import TenantRegistration
+    from datetime import timedelta
+    from django.utils import timezone
+
+    # Найти регистрацию по токену
+    try:
+        registration = TenantRegistration.objects.get(
+            password_setup_token=token,
+            status=TenantRegistration.STATUS_APPROVED
+        )
+    except TenantRegistration.DoesNotExist:
+        messages.error(request, 'Ссылка для настройки пароля недействительна.')
+        return redirect('/')
+
+    # Проверить истечение токена (7 дней)
+    if registration.password_setup_token_created_at:
+        expires_at = registration.password_setup_token_created_at + timedelta(days=7)
+        if timezone.now() > expires_at:
+            messages.error(
+                request,
+                'Ссылка для настройки пароля истекла. Пожалуйста, свяжитесь с поддержкой.'
+            )
+            return redirect('/')
+
+    # Получить тенант и пользователя-владельца
+    from django.db import connection
+    tenant = registration.tenant
+    if not tenant:
+        messages.error(request, 'Тенант не найден.')
+        return redirect('/')
+
+    # Переключиться на схему тенанта чтобы найти владельца
+    connection.set_tenant(tenant)
+    from accounts.models import CustomUser
+
+    # Создаём пользователя если он не существует (для случаев когда активация прошла без создания пользователя)
+    owner, created = CustomUser.objects.get_or_create(
+        email=registration.owner_email,
+        defaults={
+            'name': registration.owner_name,
+            'is_active': False,
+        }
+    )
+    if created:
+        owner.is_email_confirmed = True
+        owner.save()
+
+    # Обработать POST - установить пароль
+    if request.method == 'POST':
+        password1 = request.POST.get('password1')
+        password2 = request.POST.get('password2')
+
+        if password1 and password2 and password1 == password2:
+            # Установить пароль и активировать аккаунт
+            owner.set_password(password1)
+            owner.is_active = True
+            owner.save()
+
+            # Очистить токен
+            connection.set_schema_to_public()
+            registration.password_setup_token = None
+            registration.password_setup_token_created_at = None
+            registration.save()
+
+            # Автоматический вход (используем TenantUserBackend)
+            connection.set_tenant(tenant)
+            login(request, owner, backend='accounts.backends.TenantUserBackend')
+
+            messages.success(
+                request,
+                f'Пароль успешно установлен! Добро пожаловать в {tenant.name}!'
+            )
+
+            # Перенаправить на домен тенанта
+            # Получаем домен из базы (без порта, порт добавляется в URL только для localhost)
+            from tenants.models import Domain
+            from django.conf import settings
+            connection.set_schema_to_public()
+            try:
+                domain_obj = Domain.objects.filter(tenant=tenant, is_primary=True).first()
+                if domain_obj:
+                    domain_name = domain_obj.domain
+                    # Убираем порт из домена если он есть (для совместимости со старыми записями)
+                    if ':' in domain_name:
+                        domain_name = domain_name.split(':')[0]
+                else:
+                    # Fallback если домен не найден
+                    domain_base = settings.TENANT_DOMAIN_BASE
+                    if ':' in domain_base:
+                        domain_base = domain_base.split(':')[0]
+                    domain_name = f"{tenant.schema_name}.{domain_base}"
+            except:
+                domain_base = settings.TENANT_DOMAIN_BASE
+                if ':' in domain_base:
+                    domain_base = domain_base.split(':')[0]
+                domain_name = f"{tenant.schema_name}.{domain_base}"
+            
+            # Формируем URL с правильным протоколом и портом
+            protocol = 'https' if settings.USE_HTTPS else 'http'
+            # Добавляем порт только для localhost
+            if 'localhost' in domain_name:
+                tenant_url = f'{protocol}://{domain_name}:8000/'
+            else:
+                tenant_url = f'{protocol}://{domain_name}/'
+            
+            return redirect(tenant_url)
+        else:
+            messages.error(request, 'Пароли не совпадают.')
+
+    connection.set_schema_to_public()
+
+    # Отрисовать форму установки пароля
+    return render(request, 'accounts/password_setup_confirm.html', {
+        'registration': registration,
+        'tenant': tenant
+    })

myproject/activate_mixflowers.py

@@ -1,97 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Скрипт для активации заявки mixflowers
-"""
-import os
-import django
-
-os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')
-django.setup()
-
-from django.db import transaction
-from django.utils import timezone
-from tenants.models import TenantRegistration, Client, Domain, Subscription
-
-# Ищем заявку
-registration = TenantRegistration.objects.get(schema_name='mixflowers')
-print(f'Найдена заявка: {registration.shop_name} ({registration.schema_name})')
-print(f'Статус: {registration.get_status_display()}')
-print(f'Email: {registration.owner_email}')
-print('')
-
-with transaction.atomic():
-    # Создаем тенант
-    print(f'Создание тенанта: {registration.schema_name}')
-    client = Client.objects.create(
-        schema_name=registration.schema_name,
-        name=registration.shop_name,
-        owner_email=registration.owner_email,
-        owner_name=registration.owner_name,
-        phone=registration.phone,
-        is_active=True
-    )
-    print(f'[OK] Тенант создан (ID: {client.id})')
-
-    # Создаем домен
-    domain_name = f"{registration.schema_name}.localhost"
-    print(f'Создание домена: {domain_name}')
-    domain = Domain.objects.create(
-        domain=domain_name,
-        tenant=client,
-        is_primary=True
-    )
-    print(f'[OK] Домен создан (ID: {domain.id})')
-
-    # Создаем триальную подписку
-    print('Создание триальной подписки на 90 дней')
-    subscription = Subscription.create_trial(client)
-    print(f'[OK] Подписка создана (ID: {subscription.id})')
-    print(f'     Истекает: {subscription.expires_at.strftime("%Y-%m-%d")} ({subscription.days_left()} дней)')
-
-    # Создаем суперпользователя для тенанта
-    print('Создание суперпользователя для тенанта')
-    from django.db import connection
-    from django.contrib.auth import get_user_model
-    from django.conf import settings
-
-    # Переключаемся на схему тенанта
-    connection.set_tenant(client)
-
-    User = get_user_model()
-    if not User.objects.filter(email=settings.TENANT_ADMIN_EMAIL).exists():
-        superuser = User.objects.create_superuser(
-            email=settings.TENANT_ADMIN_EMAIL,
-            name=settings.TENANT_ADMIN_NAME,
-            password=settings.TENANT_ADMIN_PASSWORD
-        )
-        print(f'[OK] Суперпользователь создан (ID: {superuser.id})')
-        print(f'     Email: {superuser.email}')
-        print(f'     Password: {settings.TENANT_ADMIN_PASSWORD}')
-    else:
-        print(f'[SKIP] Пользователь с email {settings.TENANT_ADMIN_EMAIL} уже существует')
-
-    # Возвращаемся в public схему
-    public_tenant = Client.objects.get(schema_name='public')
-    connection.set_tenant(public_tenant)
-
-    # Обновляем заявку
-    registration.status = TenantRegistration.STATUS_APPROVED
-    registration.processed_at = timezone.now()
-    registration.processed_by = None
-    registration.tenant = client
-    registration.save()
-    print('[OK] Заявка обновлена')
-
-print('')
-print('=' * 60)
-print('АКТИВАЦИЯ ЗАВЕРШЕНА УСПЕШНО!')
-print('=' * 60)
-print(f'Магазин: {client.name}')
-print(f'Schema: {client.schema_name}')
-print(f'Домен: http://{domain_name}:8000/')
-print(f'Подписка до: {subscription.expires_at.strftime("%Y-%m-%d")} ({subscription.days_left()} дней)')
-print('')
-print('Доступ к админке:')
-print(f'  URL: http://{domain_name}:8000/admin/')
-print(f'  Email: {settings.TENANT_ADMIN_EMAIL}')
-print(f'  Password: {settings.TENANT_ADMIN_PASSWORD}')

myproject/activate_tenant.py

@@ -1,176 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Универсальный скрипт для активации заявки на создание тенанта.
-
-Использование:
-    python activate_tenant.py <schema_name>
-
-Примеры:
-    python activate_tenant.py grach
-    python activate_tenant.py myshop
-
-Скрипт выполняет:
-1. Находит заявку по schema_name
-2. Создает тенант (Client)
-3. Создает домен ({schema_name}.localhost)
-4. Создает триальную подписку (90 дней)
-5. Создает суперпользователя (credentials из .env)
-6. Обновляет статус заявки на "Одобрено"
-"""
-import os
-import sys
-import django
-
-os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')
-django.setup()
-
-from django.db import transaction, connection
-from django.utils import timezone
-from django.contrib.auth import get_user_model
-from django.conf import settings
-from tenants.models import TenantRegistration, Client, Domain, Subscription
-
-def print_usage():
-    """Вывод справки по использованию"""
-    print("Использование: python activate_tenant.py <schema_name>")
-    print("")
-    print("Примеры:")
-    print("  python activate_tenant.py grach")
-    print("  python activate_tenant.py myshop")
-    print("")
-    print("Доступные заявки (со статусом 'pending'):")
-    pending_regs = TenantRegistration.objects.filter(status=TenantRegistration.STATUS_PENDING)
-    if pending_regs.exists():
-        for reg in pending_regs:
-            print(f"  - {reg.schema_name}: {reg.shop_name} ({reg.owner_email})")
-    else:
-        print("  Нет заявок, ожидающих активации")
-
-def activate_tenant(schema_name):
-    """Активация тенанта по schema_name"""
-
-    # Ищем заявку
-    try:
-        registration = TenantRegistration.objects.get(schema_name=schema_name)
-    except TenantRegistration.DoesNotExist:
-        print(f"Ошибка: Заявка с schema_name '{schema_name}' не найдена")
-        print("")
-        print_usage()
-        return False
-
-    print(f'Найдена заявка: {registration.shop_name} ({registration.schema_name})')
-    print(f'Статус: {registration.get_status_display()}')
-    print(f'Email: {registration.owner_email}')
-    print('')
-
-    # Проверяем статус
-    if registration.status == TenantRegistration.STATUS_APPROVED:
-        print(f'Внимание: Эта заявка уже была активирована!')
-        if registration.tenant:
-            print(f'Тенант: {registration.tenant.name} (ID: {registration.tenant.id})')
-            print(f'Домен: http://{registration.schema_name}.localhost:8000/')
-        return False
-
-    # Проверяем, не существует ли уже тенант
-    if Client.objects.filter(schema_name=schema_name).exists():
-        print(f'Ошибка: Тенант с schema_name "{schema_name}" уже существует!')
-        return False
-
-    print('Начинаю активацию...')
-    print('')
-
-    try:
-        with transaction.atomic():
-            # Создаем тенант
-            print(f'1. Создание тенанта: {registration.schema_name}')
-            client = Client.objects.create(
-                schema_name=registration.schema_name,
-                name=registration.shop_name,
-                owner_email=registration.owner_email,
-                owner_name=registration.owner_name,
-                phone=registration.phone,
-                is_active=True
-            )
-            print(f'   [OK] Тенант создан (ID: {client.id})')
-
-            # Создаем домен
-            domain_name = f"{registration.schema_name}.localhost"
-            print(f'2. Создание домена: {domain_name}')
-            domain = Domain.objects.create(
-                domain=domain_name,
-                tenant=client,
-                is_primary=True
-            )
-            print(f'   [OK] Домен создан (ID: {domain.id})')
-
-            # Создаем триальную подписку
-            print('3. Создание триальной подписки на 90 дней')
-            subscription = Subscription.create_trial(client)
-            print(f'   [OK] Подписка создана (ID: {subscription.id})')
-            print(f'   Истекает: {subscription.expires_at.strftime("%Y-%m-%d")} ({subscription.days_left()} дней)')
-
-            # Создаем суперпользователя для тенанта
-            print('4. Создание суперпользователя для тенанта')
-
-            # Переключаемся на схему тенанта
-            connection.set_tenant(client)
-
-            User = get_user_model()
-            if not User.objects.filter(email=settings.TENANT_ADMIN_EMAIL).exists():
-                superuser = User.objects.create_superuser(
-                    email=settings.TENANT_ADMIN_EMAIL,
-                    name=settings.TENANT_ADMIN_NAME,
-                    password=settings.TENANT_ADMIN_PASSWORD
-                )
-                print(f'   [OK] Суперпользователь создан (ID: {superuser.id})')
-            else:
-                print(f'   [SKIP] Пользователь с email {settings.TENANT_ADMIN_EMAIL} уже существует')
-
-            # Возвращаемся в public схему
-            public_tenant = Client.objects.get(schema_name='public')
-            connection.set_tenant(public_tenant)
-
-            # Обновляем заявку
-            print('5. Обновление статуса заявки')
-            registration.status = TenantRegistration.STATUS_APPROVED
-            registration.processed_at = timezone.now()
-            registration.processed_by = None  # Активировано через скрипт
-            registration.tenant = client
-            registration.save()
-            print('   [OK] Заявка помечена как "Одобрено"')
-
-        print('')
-        print('=' * 70)
-        print('АКТИВАЦИЯ ЗАВЕРШЕНА УСПЕШНО!')
-        print('=' * 70)
-        print(f'Магазин: {client.name}')
-        print(f'Schema: {client.schema_name}')
-        print(f'Домен: http://{domain_name}:8000/')
-        print(f'Подписка до: {subscription.expires_at.strftime("%Y-%m-%d")} ({subscription.days_left()} дней)')
-        print('')
-        print('Доступ к админке тенанта:')
-        print(f'  URL: http://{domain_name}:8000/admin/')
-        print(f'  Email: {settings.TENANT_ADMIN_EMAIL}')
-        print(f'  Password: {settings.TENANT_ADMIN_PASSWORD}')
-        print('=' * 70)
-
-        return True
-
-    except Exception as e:
-        print('')
-        print(f'Ошибка при активации: {str(e)}')
-        import traceback
-        traceback.print_exc()
-        return False
-
-
-if __name__ == '__main__':
-    if len(sys.argv) < 2:
-        print("Ошибка: Не указан schema_name")
-        print("")
-        print_usage()
-        sys.exit(1)
-
-    schema_name = sys.argv[1]
-    success = activate_tenant(schema_name)
-    sys.exit(0 if success else 1)

myproject/check_orders.py

@@ -1,53 +0,0 @@
-"""
-Проверка созданных заказов и резервов
-"""
-import os
-import django
-
-os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')
-django.setup()
-
-from django.db import connection
-
-with connection.cursor() as cursor:
-    cursor.execute("SET search_path TO grach")
-
-    # Считаем заказы
-    cursor.execute("SELECT COUNT(*) FROM grach.orders_order")
-    orders_count = cursor.fetchone()[0]
-    print(f"Заказов: {orders_count}")
-
-    # Считаем позиции заказов
-    cursor.execute("SELECT COUNT(*) FROM grach.orders_orderitem")
-    items_count = cursor.fetchone()[0]
-    print(f"Позиций в заказах: {items_count}")
-
-    # Считаем резервы
-    cursor.execute("SELECT COUNT(*) FROM grach.inventory_reservation")
-    reservations_count = cursor.fetchone()[0]
-    print(f"Резервов: {reservations_count}")
-
-    # Детали по заказам без резервов
-    print("\nПервые 10 позиций без резервов:")
-    cursor.execute("""
-        SELECT
-            o.order_number,
-            oi.id as item_id,
-            p.name as product_name,
-            oi.quantity,
-            COUNT(r.id) as reservations_count
-        FROM grach.orders_order o
-        JOIN grach.orders_orderitem oi ON oi.order_id = o.id
-        LEFT JOIN grach.products_product p ON p.id = oi.product_id
-        LEFT JOIN grach.inventory_reservation r ON r.order_item_id = oi.id
-        GROUP BY o.order_number, oi.id, p.name, oi.quantity
-        HAVING COUNT(r.id) = 0
-        ORDER BY o.order_number
-        LIMIT 10
-    """)
-    rows = cursor.fetchall()
-    if rows:
-        for row in rows:
-            print(f"  Заказ {row[0]}: ItemID={row[1]}, Товар=\"{row[2]}\", Кол-во={row[3]}, Резервов={row[4]}")
-    else:
-        print("  Все позиции имеют резервы!")

myproject/check_stock.py

@@ -1,34 +0,0 @@
-"""
-Проверка Stock с quantity_reserved
-"""
-import os
-import django
-
-os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')
-django.setup()
-
-from django.db import connection
-
-with connection.cursor() as cursor:
-    cursor.execute("SET search_path TO grach")
-
-    # Проверяем Stock с резервами
-    print("Stock с резервами:\n")
-    cursor.execute("""
-        SELECT
-            s.id,
-            p.name as product_name,
-            s.quantity_available,
-            s.quantity_reserved,
-            (s.quantity_available - s.quantity_reserved) as free_quantity
-        FROM grach.inventory_stock s
-        JOIN grach.products_product p ON p.id = s.product_id
-        ORDER BY s.quantity_reserved DESC
-    """)
-
-    print(f"{'ID':<5} {'Товар':<30} {'Всего':<10} {'Резерв':<10} {'Свободно':<10}")
-    print("=" * 75)
-
-    for row in cursor.fetchall():
-        stock_id, product_name, qty_available, qty_reserved, free_qty = row
-        print(f"{stock_id:<5} {product_name:<30} {qty_available:<10} {qty_reserved:<10} {free_qty:<10}")

myproject/conftest.py

@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+"""
+Конфигурация pytest для Django проекта с django-tenants
+"""
+import os
+import django
+from django.conf import settings
+
+# Устанавливаем переменную окружения для settings
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')
+
+# Инициализируем Django
+def pytest_configure(config):
+    """Настройка Django перед запуском тестов"""
+    if not settings.configured:
+        django.setup()

myproject/create_demo_orders.sql

@@ -1,186 +0,0 @@
--- Создание демо-заказов для схемы grach
-SET search_path TO grach;
-
--- Создаем 25 заказов с разными датами (от -15 до +15 дней от сегодня)
-DO $$
-DECLARE
-    customer_ids INT[];
-    product_ids INT[];
-    address_ids INT[];
-    shop_ids INT[];
-    i INT;
-    random_customer_id INT;
-    random_product_id INT;
-    random_address_id INT;
-    random_shop_id INT;
-    is_delivery_flag BOOLEAN;
-    delivery_date_val DATE;
-    status_val VARCHAR(20);
-    payment_status_val VARCHAR(20);
-    payment_method_val VARCHAR(20);
-    order_id INT;
-    items_total DECIMAL(10,2);
-    delivery_cost_val DECIMAL(10,2);
-    total_amount_val DECIMAL(10,2);
-BEGIN
-    -- Получаем существующие ID
-    SELECT ARRAY_AGG(id) INTO customer_ids FROM grach.customers_customer;
-    SELECT ARRAY_AGG(id) INTO product_ids FROM grach.products_product;
-    SELECT ARRAY_AGG(id) INTO address_ids FROM grach.customers_address;
-    SELECT ARRAY_AGG(id) INTO shop_ids FROM grach.shops_shop;
-
-    -- Проверяем наличие данных
-    IF customer_ids IS NULL OR array_length(customer_ids, 1) = 0 THEN
-        RAISE EXCEPTION 'Нет клиентов в базе!';
-    END IF;
-
-    IF product_ids IS NULL OR array_length(product_ids, 1) = 0 THEN
-        RAISE EXCEPTION 'Нет товаров в базе!';
-    END IF;
-
-    -- Создаем 25 заказов
-    FOR i IN 1..25 LOOP
-        -- Случайные значения
-        random_customer_id := customer_ids[1 + floor(random() * array_length(customer_ids, 1))::int];
-        is_delivery_flag := (random() > 0.5);
-        delivery_date_val := CURRENT_DATE + (floor(random() * 31) - 15)::int;
-
-        -- Случайный статус
-        CASE floor(random() * 6)::int
-            WHEN 0 THEN status_val := 'new';
-            WHEN 1 THEN status_val := 'confirmed';
-            WHEN 2 THEN status_val := 'in_assembly';
-            WHEN 3 THEN status_val := 'in_delivery';
-            WHEN 4 THEN status_val := 'delivered';
-            ELSE status_val := 'cancelled';
-        END CASE;
-
-        -- Случайный статус оплаты
-        CASE floor(random() * 3)::int
-            WHEN 0 THEN payment_status_val := 'unpaid';
-            WHEN 1 THEN payment_status_val := 'partial';
-            ELSE payment_status_val := 'paid';
-        END CASE;
-
-        -- Случайный способ оплаты
-        CASE floor(random() * 4)::int
-            WHEN 0 THEN payment_method_val := 'cash_to_courier';
-            WHEN 1 THEN payment_method_val := 'card_to_courier';
-            WHEN 2 THEN payment_method_val := 'online';
-            ELSE payment_method_val := 'bank_transfer';
-        END CASE;
-
-        -- Стоимость доставки
-        IF is_delivery_flag THEN
-            delivery_cost_val := 200 + floor(random() * 300)::int;
-        ELSE
-            delivery_cost_val := 0;
-        END IF;
-
-        -- Создаем заказ
-        INSERT INTO grach.orders_order (
-            customer_id,
-            order_number,
-            is_delivery,
-            delivery_address_id,
-            pickup_shop_id,
-            delivery_date,
-            delivery_time_start,
-            delivery_time_end,
-            delivery_cost,
-            status,
-            payment_method,
-            is_paid,
-            total_amount,
-            discount_amount,
-            amount_paid,
-            payment_status,
-            customer_is_recipient,
-            recipient_name,
-            recipient_phone,
-            is_anonymous,
-            special_instructions,
-            created_at,
-            updated_at,
-            modified_by_id
-        ) VALUES (
-            random_customer_id,
-            'ORD-' || to_char(CURRENT_DATE, 'YYYYMMDD') || '-' || substring(md5(random()::text) from 1 for 4),
-            is_delivery_flag,
-            CASE WHEN is_delivery_flag AND address_ids IS NOT NULL THEN address_ids[1 + floor(random() * array_length(address_ids, 1))::int] ELSE NULL END,
-            CASE WHEN NOT is_delivery_flag AND shop_ids IS NOT NULL THEN shop_ids[1 + floor(random() * array_length(shop_ids, 1))::int] ELSE NULL END,
-            delivery_date_val,
-            CASE WHEN random() > 0.3 THEN ((9 + floor(random() * 10)::int)::text || ':00:00')::time ELSE NULL END,
-            CASE WHEN random() > 0.3 THEN ((11 + floor(random() * 8)::int)::text || ':00:00')::time ELSE NULL END,
-            delivery_cost_val,
-            status_val,
-            payment_method_val,
-            (payment_status_val = 'paid'),
-            1000,  -- Временное значение, пересчитаем позже
-            CASE WHEN random() > 0.8 THEN (100 + floor(random() * 400)::int) ELSE 0 END,
-            0,  -- Временное значение
-            payment_status_val,
-            (random() > 0.7),
-            CASE WHEN random() > 0.7 THEN 'Получатель ' || i ELSE NULL END,
-            CASE WHEN random() > 0.7 THEN '+79' || lpad(floor(random() * 1000000000)::text, 9, '0') ELSE NULL END,
-            (random() > 0.8),
-            CASE WHEN random() > 0.5 THEN
-                CASE floor(random() * 5)::int
-                    WHEN 0 THEN 'Позвонить за час до доставки'
-                    WHEN 1 THEN 'Доставить точно в указанное время'
-                    WHEN 2 THEN 'Не звонить в дверь'
-                    WHEN 3 THEN 'Упаковать покрасивее'
-                    ELSE 'Приложить открытку'
-                END
-            ELSE NULL END,
-            CURRENT_TIMESTAMP,
-            CURRENT_TIMESTAMP,
-            NULL
-        ) RETURNING id INTO order_id;
-
-        -- Добавляем 1-3 товара в заказ
-        items_total := 0;
-        FOR j IN 1..(1 + floor(random() * 3)::int) LOOP
-            random_product_id := product_ids[1 + floor(random() * array_length(product_ids, 1))::int];
-
-            -- Получаем цену товара и добавляем позицию
-            INSERT INTO grach.orders_orderitem (
-                order_id,
-                product_id,
-                product_kit_id,
-                quantity,
-                price,
-                is_custom_price,
-                created_at
-            )
-            SELECT
-                order_id,
-                random_product_id,
-                NULL,
-                1 + floor(random() * 3)::int,
-                price,
-                FALSE,
-                CURRENT_TIMESTAMP
-            FROM grach.products_product
-            WHERE id = random_product_id
-            RETURNING (quantity * price) INTO STRICT total_amount_val;
-
-            items_total := items_total + total_amount_val;
-        END LOOP;
-
-        -- Обновляем итоговую сумму заказа
-        UPDATE grach.orders_order
-        SET
-            total_amount = items_total + delivery_cost - discount_amount,
-            amount_paid = CASE
-                WHEN payment_status = 'paid' THEN items_total + delivery_cost - discount_amount
-                WHEN payment_status = 'partial' THEN (items_total + delivery_cost - discount_amount) * (0.2 + random() * 0.6)
-                ELSE 0
-            END
-        WHERE id = order_id;
-
-        RAISE NOTICE 'Создан заказ % на дату %', order_id, delivery_date_val;
-    END LOOP;
-
-    RAISE NOTICE 'Успешно создано 25 заказов!';
-END $$;

myproject/create_wallet_payment_method.py

@@ -1,18 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-"""
-Скрипт для создания способа оплаты 'account_balance' для тенанта buba
-"""
-import os
-import django
-
-os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')
-django.setup()
-
-from django.core.management import call_command
-from django_tenants.utils import schema_context
-
-# Создаём способ оплаты для тенанта buba
-with schema_context('buba'):
-    call_command('create_payment_methods')
-    print("\n✓ Способ оплаты успешно создан для тенанта 'buba'")

myproject/customers/admin.py

@@ -1,7 +1,8 @@
 from django.contrib import admin
 from django.db import models
 from django.utils.html import format_html
-from .models import Customer, WalletTransaction
+from .models import Customer, WalletTransaction, ContactChannel
+from tenants.admin_mixins import TenantAdminOnlyMixin
 
 
 class IsSystemCustomerFilter(admin.SimpleListFilter):
@@ -23,14 +24,16 @@ class IsSystemCustomerFilter(admin.SimpleListFilter):
 
 
 @admin.register(Customer)
-class CustomerAdmin(admin.ModelAdmin):
-    """Административный интерфейс для управления клиентами цветочного магазина"""
+class CustomerAdmin(TenantAdminOnlyMixin, admin.ModelAdmin):
+    """
+    Административный интерфейс для управления клиентами цветочного магазина.
+    TenantAdminOnlyMixin - скрывает от public admin (таблица только в tenant схемах).
+    """
     list_display = (
         'full_name',
         'email',
         'phone',
         'wallet_balance_display',
-        'total_spent',
         'is_system_customer',
         'created_at'
     )
@@ -45,18 +48,14 @@ class CustomerAdmin(admin.ModelAdmin):
     )
     date_hierarchy = 'created_at'
     ordering = ('-created_at',)
-    readonly_fields = ('created_at', 'updated_at', 'total_spent', 'is_system_customer', 'wallet_balance')
+    readonly_fields = ('created_at', 'updated_at', 'is_system_customer', 'wallet_balance_display')
 
     fieldsets = (
         ('Основная информация', {
             'fields': ('name', 'email', 'phone', 'is_system_customer')
         }),
         ('Кошелёк', {
-            'fields': ('wallet_balance',),
-        }),
-        ('Статистика покупок', {
-            'fields': ('total_spent',),
-            'classes': ('collapse',)
+            'fields': ('wallet_balance_display',),
         }),
         ('Заметки', {
             'fields': ('notes',)
@@ -69,20 +68,20 @@ class CustomerAdmin(admin.ModelAdmin):
 
     def wallet_balance_display(self, obj):
         """Отображение баланса кошелька с цветом"""
-        if obj.wallet_balance > 0:
+        balance = obj.wallet_balance
+        if balance > 0:
             return format_html(
                 '<span style="color: green; font-weight: bold;">{} руб.</span>',
-                obj.wallet_balance
+                balance
             )
-        return f'{obj.wallet_balance} руб.'
+        return f'{balance} руб.'
     wallet_balance_display.short_description = 'Баланс кошелька'
-    wallet_balance_display.admin_order_field = 'wallet_balance'
 
     def get_readonly_fields(self, request, obj=None):
         """Делаем все поля read-only для системного клиента"""
         if obj and obj.is_system_customer:
             # Для системного клиента все поля только для чтения
-            return ['name', 'email', 'phone', 'total_spent', 'is_system_customer', 'wallet_balance', 'notes', 'created_at', 'updated_at']
+            return ['name', 'email', 'phone', 'is_system_customer', 'wallet_balance_display', 'notes', 'created_at', 'updated_at']
         return self.readonly_fields
 
     def has_delete_permission(self, request, obj=None):
@@ -103,14 +102,20 @@ class CustomerAdmin(admin.ModelAdmin):
         return super().changeform_view(request, object_id, form_url, extra_context)
 
 
+class ContactChannelInline(admin.TabularInline):
+    """Inline для управления каналами связи клиента"""
+    model = ContactChannel
+    extra = 1
+    fields = ('channel_type', 'value', 'is_primary', 'notes')
+
+
 class WalletTransactionInline(admin.TabularInline):
-    """
-line для отображения транзакций кошелька"""
+    """Inline для отображения транзакций кошелька"""
     model = WalletTransaction
     extra = 0
     can_delete = False
-    readonly_fields = ('transaction_type', 'amount', 'order', 'description', 'created_at', 'created_by')
-    fields = ('created_at', 'transaction_type', 'amount', 'order', 'description', 'created_by')
+    readonly_fields = ('created_at', 'transaction_type', 'signed_amount', 'balance_after', 'order', 'description', 'created_by')
+    fields = ('created_at', 'transaction_type', 'signed_amount', 'balance_after', 'order', 'description', 'created_by')
     ordering = ('-created_at',)
 
     def has_add_permission(self, request, obj=None):
@@ -119,32 +124,36 @@ line для отображения транзакций кошелька"""
 
 
 # Добавляем inline в CustomerAdmin
-CustomerAdmin.inlines = [WalletTransactionInline]
+CustomerAdmin.inlines = [ContactChannelInline, WalletTransactionInline]
 
 
 @admin.register(WalletTransaction)
-class WalletTransactionAdmin(admin.ModelAdmin):
-    """Админка для просмотра всех транзакций кошелька"""
-    list_display = ('created_at', 'customer', 'transaction_type', 'amount_display', 'order', 'created_by')
-    list_filter = ('transaction_type', 'created_at')
+class WalletTransactionAdmin(TenantAdminOnlyMixin, admin.ModelAdmin):
+    """
+    Админка для просмотра всех транзакций кошелька.
+    TenantAdminOnlyMixin - скрывает от public admin.
+    """
+    list_display = ('created_at', 'customer', 'transaction_type', 'amount_display', 'balance_after', 'order', 'created_by')
+    list_filter = ('transaction_type', 'balance_category', 'created_at')
     search_fields = ('customer__name', 'customer__email', 'customer__phone', 'description')
-    readonly_fields = ('customer', 'transaction_type', 'amount', 'order', 'description', 'created_at', 'created_by')
+    readonly_fields = ('customer', 'transaction_type', 'signed_amount', 'balance_category', 'balance_after', 'order', 'description', 'created_at', 'created_by')
     date_hierarchy = 'created_at'
     ordering = ('-created_at',)
 
     def amount_display(self, obj):
         """Отображение суммы с цветом"""
-        if obj.transaction_type == 'deposit':
+        amount = obj.signed_amount
+        if amount > 0:
             return format_html(
                 '<span style="color: green; font-weight: bold;">+{} руб.</span>',
-                obj.amount
+                amount
             )
-        elif obj.transaction_type == 'spend':
+        elif amount < 0:
             return format_html(
-                '<span style="color: red; font-weight: bold;">-{} руб.</span>',
-                obj.amount
+                '<span style="color: red; font-weight: bold;">{} руб.</span>',
+                amount
             )
-        return f'{obj.amount} руб.'
+        return f'{amount} руб.'
     amount_display.short_description = 'Сумма'
 
     def has_add_permission(self, request):

myproject/customers/filters.py

@@ -0,0 +1,77 @@
+# -*- coding: utf-8 -*-
+"""
+Фильтры для клиентов с использованием django-filter
+"""
+
+import django_filters
+from django import forms
+from .models import Customer
+
+
+class CustomerFilter(django_filters.FilterSet):
+    """
+    Фильтр для списка клиентов
+    Поддерживает фильтрацию по:
+    - Наличию заметок
+    - Отсутствию телефона
+    - Отсутствию email
+    """
+
+    # Фильтр: есть заметки
+    has_notes = django_filters.BooleanFilter(
+        method='filter_has_notes',
+        label='Есть заметки',
+        widget=forms.CheckboxInput(attrs={'class': 'form-check-input'})
+    )
+
+    # Фильтр: нет телефона
+    no_phone = django_filters.BooleanFilter(
+        method='filter_no_phone',
+        label='Нет телефона',
+        widget=forms.CheckboxInput(attrs={'class': 'form-check-input'})
+    )
+
+    # Фильтр: нет email
+    no_email = django_filters.BooleanFilter(
+        method='filter_no_email',
+        label='Нет email',
+        widget=forms.CheckboxInput(attrs={'class': 'form-check-input'})
+    )
+
+    # Фильтр: есть канал связи
+    has_contact_channel = django_filters.BooleanFilter(
+        method='filter_has_contact_channel',
+        label='Есть канал связи',
+        widget=forms.CheckboxInput(attrs={'class': 'form-check-input'})
+    )
+
+    class Meta:
+        model = Customer
+        fields = ['has_notes', 'no_phone', 'no_email', 'has_contact_channel']
+
+    def filter_has_notes(self, queryset, name, value):
+        """Фильтр клиентов с заметками"""
+        if value:
+            return queryset.filter(notes__isnull=False).exclude(notes='')
+        return queryset
+
+    def filter_no_phone(self, queryset, name, value):
+        """Фильтр клиентов без телефона"""
+        if value:
+            return queryset.filter(phone__isnull=True) | queryset.filter(phone='')
+        return queryset
+
+    def filter_no_email(self, queryset, name, value):
+        """Фильтр клиентов без email"""
+        if value:
+            return queryset.filter(email__isnull=True) | queryset.filter(email='')
+        return queryset
+
+    def filter_has_contact_channel(self, queryset, name, value):
+        """Фильтр клиентов с каналами связи (Instagram, Telegram и т.д.)"""
+        if value:
+            from .models import ContactChannel
+            # Возвращаем только клиентов у которых есть хотя бы один канал связи
+            customer_ids = ContactChannel.objects.values_list('customer_id', flat=True).distinct()
+            return queryset.filter(id__in=customer_ids)
+        return queryset

myproject/customers/forms.py

@@ -2,7 +2,7 @@ from django import forms
 from django.core.exceptions import ValidationError
 from phonenumber_field.formfields import PhoneNumberField
 from phonenumber_field.widgets import PhoneNumberPrefixWidget
-from .models import Customer
+from .models import Customer, ContactChannel
 
 class CustomerForm(forms.ModelForm):
     phone = PhoneNumberField(
@@ -35,43 +35,17 @@ class CustomerForm(forms.ModelForm):
                 field.widget.attrs.update({'class': 'form-control'})
 
     def clean_email(self):
-        """Проверяет уникальность email при создании/редактировании"""
+        """Нормализует пустые значения email в None"""
         email = self.cleaned_data.get('email')
-
-        # Нормализуем пустые значения в None (Django best practice для nullable полей)
         if not email:
             return None
-
-        # Проверяем уникальность
-        queryset = Customer.objects.filter(email=email)
-
-        # При редактировании исключаем текущий экземпляр
-        if self.instance and self.instance.pk:
-            queryset = queryset.exclude(pk=self.instance.pk)
-
-        if queryset.exists():
-            raise ValidationError('Клиент с таким email уже существует.')
-
         return email
 
     def clean_phone(self):
-        """Проверяет уникальность телефона при создании/редактировании"""
+        """Нормализует пустые значения телефона в None"""
         phone = self.cleaned_data.get('phone')
-
-        # Нормализуем пустые значения в None (Django best practice для nullable полей)
         if not phone:
             return None
-
-        # Проверяем уникальность
-        queryset = Customer.objects.filter(phone=phone)
-
-        # При редактировании исключаем текущий экземпляр
-        if self.instance and self.instance.pk:
-            queryset = queryset.exclude(pk=self.instance.pk)
-
-        if queryset.exists():
-            raise ValidationError('Клиент с таким номером телефона уже существует.')
-
         return phone
 
     def clean(self):
@@ -85,4 +59,83 @@ class CustomerForm(forms.ModelForm):
                 'Он необходим для корректной работы системы и создается автоматически.'
             )
 
+        return cleaned_data
+
+
+class ContactChannelForm(forms.ModelForm):
+    """Форма для добавления/редактирования канала связи"""
+
+    class Meta:
+        model = ContactChannel
+        fields = ['channel_type', 'value', 'is_primary', 'notes']
+        widgets = {
+            'channel_type': forms.Select(attrs={'class': 'form-select'}),
+            'value': forms.TextInput(attrs={'class': 'form-control', 'placeholder': '@username, номер и т.д.'}),
+            'notes': forms.TextInput(attrs={'class': 'form-control', 'placeholder': 'Личный аккаунт, рабочий...'}),
+            'is_primary': forms.CheckboxInput(attrs={'class': 'form-check-input'}),
+        }
+
+    def clean_value(self):
+        value = self.cleaned_data.get('value', '').strip()
+        channel_type = self.cleaned_data.get('channel_type')
+
+        if not value:
+            raise ValidationError('Значение не может быть пустым')
+
+        # Проверка уникальности комбинации channel_type + value
+        qs = ContactChannel.objects.filter(channel_type=channel_type, value=value)
+        if self.instance.pk:
+            qs = qs.exclude(pk=self.instance.pk)
+        if qs.exists():
+            type_display = dict(ContactChannel.CHANNEL_TYPES).get(channel_type, channel_type)
+            raise ValidationError(f'Такой {type_display} уже существует у другого клиента')
+
+        return value
+
+
+class CustomerExportForm(forms.Form):
+    """Форма настройки экспорта клиентов"""
+
+    FORMAT_CHOICES = [
+        ('csv', 'CSV'),
+        ('xlsx', 'Excel (XLSX)'),
+    ]
+
+    export_format = forms.ChoiceField(
+        choices=FORMAT_CHOICES,
+        widget=forms.RadioSelect(attrs={'class': 'form-check-input'}),
+        initial='csv',
+        label='Формат файла'
+    )
+
+    def __init__(self, *args, user=None, **kwargs):
+        super().__init__(*args, **kwargs)
+
+        # Получаем доступные поля на основе роли пользователя
+        from .services.import_export import CustomerExporter
+        available_fields = CustomerExporter.get_available_fields(user)
+
+        # Динамически создаём checkbox поля
+        for field_key, field_info in available_fields.items():
+            self.fields[f'field_{field_key}'] = forms.BooleanField(
+                required=False,
+                label=field_info['label'],
+                initial=field_key in CustomerExporter.DEFAULT_FIELDS,
+                widget=forms.CheckboxInput(attrs={'class': 'form-check-input'})
+            )
+
+    def clean(self):
+        cleaned_data = super().clean()
+
+        # Собираем выбранные поля
+        selected_fields = [
+            key.replace('field_', '')
+            for key, value in cleaned_data.items()
+            if key.startswith('field_') and value
+        ]
+
+        if not selected_fields:
+            raise ValidationError('Выберите хотя бы одно поле для экспорта')
+
+        cleaned_data['selected_fields'] = selected_fields
         return cleaned_data

myproject/customers/management/commands/analyze_import.py

@@ -0,0 +1,67 @@
+"""
+Анализ проблемных строк в XLSX файле для импорта.
+Показывает первые 30 строк с проблемными телефонами.
+"""
+from django.core.management.base import BaseCommand
+import os
+
+try:
+    from openpyxl import load_workbook
+except ImportError:
+    load_workbook = None
+
+
+class Command(BaseCommand):
+    help = 'Анализ проблемных данных в файле импорта'
+
+    def add_arguments(self, parser):
+        parser.add_argument('file_path', type=str, help='Путь к файлу для анализа')
+
+    def handle(self, *args, **options):
+        file_path = options['file_path']
+
+        if not os.path.exists(file_path):
+            self.stdout.write(self.style.ERROR(f'Файл не найден: {file_path}'))
+            return
+
+        if load_workbook is None:
+            self.stdout.write(self.style.ERROR('Установите openpyxl'))
+            return
+
+        wb = load_workbook(file_path, read_only=True, data_only=True)
+        ws = wb.active
+
+        headers = []
+        rows_data = []
+
+        first_row = True
+        for idx, row in enumerate(ws.iter_rows(values_only=True), start=1):
+            if first_row:
+                headers = [str(v).strip() if v is not None else "" for v in row]
+                self.stdout.write(f"Заголовки: {headers}\n")
+                first_row = False
+                continue
+
+            if not any(row):
+                continue
+
+            row_dict = {}
+            for col_idx, value in enumerate(row):
+                if col_idx < len(headers):
+                    header = headers[col_idx]
+                    row_dict[header] = value
+            
+            rows_data.append((idx, row_dict))
+
+        # Показываем первые 30 строк
+        self.stdout.write(self.style.SUCCESS(f"\nПервые 30 строк данных:\n"))
+        self.stdout.write("=" * 100)
+        
+        for row_num, data in rows_data[:30]:
+            self.stdout.write(f"\n[Строка {row_num}]")
+            for key, val in data.items():
+                if val:
+                    self.stdout.write(f"  {key}: {val}")
+            self.stdout.write("-" * 100)
+
+        self.stdout.write(f"\n\nВсего строк с данными: {len(rows_data)}")

myproject/customers/management/commands/clear_anatol_customers.py

@@ -0,0 +1,38 @@
+from django.core.management.base import BaseCommand
+from django_tenants.utils import schema_context
+from tenants.models import Client
+from customers.models import Customer
+
+
+class Command(BaseCommand):
+    help = 'Удаляет всех клиентов (кроме системного) в тенанте anatol'
+
+    def handle(self, *args, **options):
+        tenant_schema = 'anatol'
+        
+        try:
+            tenant = Client.objects.get(schema_name=tenant_schema)
+        except Client.DoesNotExist:
+            self.stdout.write(self.style.ERROR(f'Тенант {tenant_schema} не найден'))
+            return
+
+        with schema_context(tenant_schema):
+            # Удаляем всех клиентов кроме системного
+            customers_to_delete = Customer.objects.filter(is_system_customer=False)
+            count = customers_to_delete.count()
+            
+            if count == 0:
+                self.stdout.write(self.style.WARNING('Нет клиентов для удаления'))
+                return
+            
+            customers_to_delete.delete()
+            
+            # Проверяем что остался только системный
+            remaining = Customer.objects.count()
+            system_customer = Customer.objects.filter(is_system_customer=True).first()
+            
+            self.stdout.write(self.style.SUCCESS(f'Удалено клиентов: {count}'))
+            self.stdout.write(self.style.SUCCESS(f'Осталось клиентов: {remaining}'))
+            
+            if system_customer:
+                self.stdout.write(f'Системный клиент: {system_customer.name} ({system_customer.email})')

myproject/customers/management/commands/test_import.py

@@ -0,0 +1,158 @@
+"""
+Management-команда для тестового импорта клиентов из XLSX/CSV файлов.
+
+Использование:
+    python manage.py test_import путь/к/файлу.xlsx --schema=anatol [--update] [--export-errors]
+
+Примеры:
+    python manage.py test_import ../customers_mixflowers.by_2025-12-14_20-35-36.xlsx --schema=anatol
+    python manage.py test_import ../customers.csv --schema=anatol --update
+    python manage.py test_import ../file.xlsx --schema=anatol --export-errors
+"""
+from django.core.management.base import BaseCommand
+from django.core.files import File
+from django_tenants.utils import schema_context
+from customers.services.import_export import CustomerImporter
+import os
+
+try:
+    from openpyxl import Workbook
+    from openpyxl.styles import Font, PatternFill, Alignment
+except ImportError:
+    Workbook = None
+
+
+class Command(BaseCommand):
+    help = 'Тестовый импорт клиентов из XLSX/CSV файла'
+
+    def add_arguments(self, parser):
+        parser.add_argument('file_path', type=str, help='Путь к файлу для импорта')
+        parser.add_argument(
+            '--schema',
+            type=str,
+            required=True,
+            help='Имя схемы БД тенанта (пример: anatol)'
+        )
+        parser.add_argument(
+            '--update',
+            action='store_true',
+            help='Обновлять существующих клиентов (по email/телефону)',
+        )
+        parser.add_argument(
+            '--export-errors',
+            action='store_true',
+            help='Экспортировать все проблемные строки в отдельный XLSX файл',
+        )
+
+    def handle(self, *args, **options):
+        file_path = options['file_path']
+        schema_name = options['schema']
+        update_existing = options['update']
+        export_errors = options.get('export_errors', False)
+
+        if not os.path.exists(file_path):
+            self.stdout.write(self.style.ERROR(f'Файл не найден: {file_path}'))
+            return
+
+        self.stdout.write(f'Импорт из файла: {file_path}')
+        self.stdout.write(f'Схема тенанта: {schema_name}')
+        self.stdout.write(f'Режим обновления: {"ВКЛ" if update_existing else "ВЫКЛ"}')
+        self.stdout.write('-' * 60)
+
+        # Выполняем импорт в контексте схемы тенанта
+        with schema_context(schema_name):
+            importer = CustomerImporter()
+
+            with open(file_path, 'rb') as f:
+                # Создаём простой объект-обёртку для файла
+                class FakeUploadedFile:
+                    def __init__(self, file_obj, name):
+                        self.file = file_obj
+                        self.name = name
+                    
+                    def __getattr__(self, attr):
+                        # Делегируем все остальные методы внутреннему файловому объекту
+                        return getattr(self.file, attr)
+
+                fake_file = FakeUploadedFile(f, os.path.basename(file_path))
+                result = importer.import_from_file(fake_file, update_existing=update_existing)
+
+        self.stdout.write(self.style.SUCCESS(f"\n{result['message']}"))
+        self.stdout.write('-' * 60)
+        self.stdout.write(f"Создано:    {result['created']}")
+        self.stdout.write(f"Обновлено:  {result['updated']}")
+        self.stdout.write(f"Пропущено:  {result['skipped']}")
+        self.stdout.write(f"Ошибок:     {len(result['errors'])}")
+
+        if result['errors']:
+            self.stdout.write('\n' + self.style.WARNING('ОШИБКИ:'))
+            # Показываем первые 20 ошибок, остальные — просто счётчик
+            for idx, error in enumerate(result['errors'][:20], 1):
+                row = error.get('row', '?')
+                email = error.get('email', '')
+                phone = error.get('phone', '')
+                reason = error.get('reason', '')
+                self.stdout.write(
+                    f"  [{idx}] Строка {row}: {email or phone or '(пусто)'} - {reason}"
+                )
+            
+            if len(result['errors']) > 20:
+                self.stdout.write(f"  ... и ещё {len(result['errors']) - 20} ошибок")
+
+            # Экспорт ошибок в XLSX
+            if export_errors:
+                self._export_errors_to_xlsx(file_path, result['real_errors'])
+
+    def _export_errors_to_xlsx(self, original_file_path, errors):
+        """
+        Экспортирует все проблемные строки в отдельный XLSX файл.
+        """
+        if Workbook is None:
+            self.stdout.write(self.style.ERROR('\nНевозможно экспортировать ошибки: openpyxl не установлен'))
+            return
+
+        # Формируем имя файла для ошибок
+        base_name = os.path.splitext(os.path.basename(original_file_path))[0]
+        error_file = f"{base_name}_ERRORS.xlsx"
+        error_path = os.path.join(os.path.dirname(original_file_path) or '.', error_file)
+
+        # Создаём новую книгу Excel
+        wb = Workbook()
+        ws = wb.active
+        ws.title = "Ошибки импорта"
+
+        # Заголовки с форматированием
+        headers = ['Строка', 'Email', 'Телефон', 'Причина ошибки']
+        for col_num, header in enumerate(headers, 1):
+            cell = ws.cell(row=1, column=col_num, value=header)
+            cell.font = Font(bold=True, color="FFFFFF")
+            cell.fill = PatternFill(start_color="4472C4", end_color="4472C4", fill_type="solid")
+            cell.alignment = Alignment(horizontal="center", vertical="center")
+
+        # Данные об ошибках
+        for idx, error in enumerate(errors, 2):
+            ws.cell(row=idx, column=1, value=error.get('row', ''))
+            ws.cell(row=idx, column=2, value=error.get('email', ''))
+            ws.cell(row=idx, column=3, value=error.get('phone', ''))
+            ws.cell(row=idx, column=4, value=error.get('reason', ''))
+
+        # Автоподбор ширины колонок
+        for column in ws.columns:
+            max_length = 0
+            column_letter = column[0].column_letter
+            for cell in column:
+                try:
+                    if cell.value:
+                        max_length = max(max_length, len(str(cell.value)))
+                except:
+                    pass
+            adjusted_width = min(max_length + 2, 80)
+            ws.column_dimensions[column_letter].width = adjusted_width
+
+        # Сохраняем файл
+        try:
+            wb.save(error_path)
+            self.stdout.write(self.style.SUCCESS(f"\n✓ Файл с ошибками сохранён: {error_path}"))
+            self.stdout.write(f"  Всего строк с ошибками: {len(errors)}")
+        except Exception as e:
+            self.stdout.write(self.style.ERROR(f"\n✗ Ошибка при сохранении файла: {e}"))

myproject/customers/migrations/0001_initial.py

@@ -1,5 +1,6 @@
-# Generated by Django 5.0.10 on 2025-11-15 11:57
+# Generated by Django 5.0.10 on 2026-01-14 07:04
 
+import django.db.models.deletion
 import phonenumber_field.modelfields
 from django.db import migrations, models
 
@@ -9,6 +10,7 @@ class Migration(migrations.Migration):
     initial = True
 
     dependencies = [
+        ('accounts', '0001_initial'),
     ]
 
     operations = [
@@ -17,10 +19,9 @@ class Migration(migrations.Migration):
             fields=[
                 ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
                 ('name', models.CharField(blank=True, max_length=200, verbose_name='Имя')),
-                ('email', models.EmailField(blank=True, max_length=254, null=True, unique=True, verbose_name='Email')),
-                ('phone', phonenumber_field.modelfields.PhoneNumberField(blank=True, help_text='Введите телефон в любом формате, например: +375291234567, 80255270546, 8(029)1234567 - будет автоматически преобразован в международный формат', max_length=128, null=True, region=None, unique=True, verbose_name='Телефон')),
-                ('loyalty_tier', models.CharField(choices=[('no_discount', 'Без скидки'), ('bronze', 'Бронза'), ('silver', 'Серебро'), ('gold', 'Золото'), ('platinum', 'Платина')], default='no_discount', max_length=20, verbose_name='Уровень лояльности')),
-                ('total_spent', models.DecimalField(decimal_places=2, default=0, max_digits=10, verbose_name='Общая сумма покупок')),
+                ('email', models.EmailField(blank=True, max_length=254, null=True, verbose_name='Email')),
+                ('phone', phonenumber_field.modelfields.PhoneNumberField(blank=True, help_text='Введите телефон в любом формате, например: +375291234567, 80255270546, 8(029)1234567 - будет автоматически преобразован в международный формат', max_length=128, null=True, region=None, verbose_name='Телефон')),
+                ('is_system_customer', models.BooleanField(db_index=True, default=False, help_text='Автоматически созданный клиент для анонимных покупок и наличных продаж', verbose_name='Системный клиент')),
                 ('notes', models.TextField(blank=True, help_text='Заметки о клиенте, особые предпочтения и т.д.', null=True, verbose_name='Заметки')),
                 ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата создания')),
                 ('updated_at', models.DateTimeField(auto_now=True, verbose_name='Дата обновления')),
@@ -29,7 +30,43 @@ class Migration(migrations.Migration):
                 'verbose_name': 'Клиент',
                 'verbose_name_plural': 'Клиенты',
                 'ordering': ['-created_at'],
-                'indexes': [models.Index(fields=['name'], name='customers_c_name_f018e2_idx'), models.Index(fields=['email'], name='customers_c_email_4fdeb3_idx'), models.Index(fields=['phone'], name='customers_c_phone_8493fa_idx'), models.Index(fields=['created_at'], name='customers_c_created_1ed0f4_idx'), models.Index(fields=['loyalty_tier'], name='customers_c_loyalty_5162a0_idx')],
+                'indexes': [models.Index(fields=['name'], name='customers_c_name_f018e2_idx'), models.Index(fields=['email'], name='customers_c_email_4fdeb3_idx'), models.Index(fields=['phone'], name='customers_c_phone_8493fa_idx'), models.Index(fields=['created_at'], name='customers_c_created_1ed0f4_idx')],
+            },
+        ),
+        migrations.CreateModel(
+            name='ContactChannel',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('channel_type', models.CharField(choices=[('phone', 'Телефон'), ('email', 'Email'), ('telegram', 'Telegram'), ('instagram', 'Instagram'), ('whatsapp', 'WhatsApp'), ('viber', 'Viber'), ('vk', 'ВКонтакте'), ('facebook', 'Facebook'), ('other', 'Другое')], max_length=20, verbose_name='Тип канала')),
+                ('value', models.CharField(help_text='Username, номер телефона, email и т.д.', max_length=255, verbose_name='Значение')),
+                ('is_primary', models.BooleanField(default=False, verbose_name='Основной')),
+                ('notes', models.CharField(blank=True, max_length=255, verbose_name='Примечание')),
+                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата создания')),
+                ('customer', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='contact_channels', to='customers.customer', verbose_name='Клиент')),
+            ],
+            options={
+                'verbose_name': 'Канал связи',
+                'verbose_name_plural': 'Каналы связи',
+                'ordering': ['-is_primary', 'channel_type'],
+            },
+        ),
+        migrations.CreateModel(
+            name='WalletTransaction',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('signed_amount', models.DecimalField(decimal_places=2, help_text='Положительная для пополнений, отрицательная для списаний', max_digits=10, verbose_name='Сумма')),
+                ('transaction_type', models.CharField(choices=[('deposit', 'Пополнение'), ('spend', 'Списание'), ('adjustment', 'Корректировка')], max_length=20, verbose_name='Тип транзакции')),
+                ('balance_category', models.CharField(choices=[('money', 'Реальные деньги')], default='money', max_length=20, verbose_name='Категория')),
+                ('description', models.TextField(blank=True, verbose_name='Описание')),
+                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата создания')),
+                ('balance_after', models.DecimalField(blank=True, decimal_places=2, help_text='Баланс кошелька после применения этой транзакции', max_digits=10, null=True, verbose_name='Баланс после')),
+                ('created_by', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, to='accounts.customuser', verbose_name='Создано пользователем')),
+                ('customer', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, related_name='wallet_transactions', to='customers.customer', verbose_name='Клиент')),
+            ],
+            options={
+                'verbose_name': 'Транзакция кошелька',
+                'verbose_name_plural': 'Транзакции кошелька',
+                'ordering': ['-created_at'],
             },
         ),
     ]

myproject/customers/migrations/0002_customer_is_system_customer.py

@@ -1,18 +0,0 @@
-# Generated by Django 5.0.10 on 2025-11-19 19:59
-
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-
-    dependencies = [
-        ('customers', '0001_initial'),
-    ]
-
-    operations = [
-        migrations.AddField(
-            model_name='customer',
-            name='is_system_customer',
-            field=models.BooleanField(db_index=True, default=False, help_text='Автоматически созданный клиент для анонимных покупок и наличных продаж', verbose_name='Системный клиент'),
-        ),
-    ]

myproject/customers/migrations/0002_initial.py

@@ -0,0 +1,54 @@
+# Generated by Django 5.0.10 on 2026-01-14 07:04
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('customers', '0001_initial'),
+        ('orders', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='wallettransaction',
+            name='order',
+            field=models.ForeignKey(blank=True, help_text='Заказ, к которому относится транзакция (если применимо)', null=True, on_delete=django.db.models.deletion.PROTECT, related_name='wallet_transactions', to='orders.order', verbose_name='Заказ'),
+        ),
+        migrations.AddIndex(
+            model_name='contactchannel',
+            index=models.Index(fields=['channel_type', 'value'], name='customers_c_channel_179e89_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='contactchannel',
+            index=models.Index(fields=['customer'], name='customers_c_custome_f14e0e_idx'),
+        ),
+        migrations.AlterUniqueTogether(
+            name='contactchannel',
+            unique_together={('channel_type', 'value')},
+        ),
+        migrations.AddIndex(
+            model_name='wallettransaction',
+            index=models.Index(fields=['customer', '-created_at'], name='customers_w_custome_572f05_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='wallettransaction',
+            index=models.Index(fields=['transaction_type'], name='customers_w_transac_5fda02_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='wallettransaction',
+            index=models.Index(fields=['order'], name='customers_w_order_i_5e2527_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='wallettransaction',
+            index=models.Index(fields=['balance_category'], name='customers_w_balance_81f0a9_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='wallettransaction',
+            index=models.Index(fields=['customer', 'balance_category'], name='customers_w_custome_060570_idx'),
+        ),
+    ]

myproject/customers/migrations/0003_remove_customer_customers_c_loyalty_5162a0_idx_and_more.py

@@ -1,21 +0,0 @@
-# Generated by Django 5.0.10 on 2025-11-22 13:57
-
-from django.db import migrations
-
-
-class Migration(migrations.Migration):
-
-    dependencies = [
-        ('customers', '0002_customer_is_system_customer'),
-    ]
-
-    operations = [
-        migrations.RemoveIndex(
-            model_name='customer',
-            name='customers_c_loyalty_5162a0_idx',
-        ),
-        migrations.RemoveField(
-            model_name='customer',
-            name='loyalty_tier',
-        ),
-    ]

myproject/customers/migrations/0004_customer_wallet_balance_wallettransaction.py

@@ -1,41 +0,0 @@
-# Generated by Django 5.0.10 on 2025-11-26 11:34
-
-import django.db.models.deletion
-from django.conf import settings
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-
-    dependencies = [
-        ('customers', '0003_remove_customer_customers_c_loyalty_5162a0_idx_and_more'),
-        ('orders', '0004_refactor_models_and_add_payment_method'),
-        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
-    ]
-
-    operations = [
-        migrations.AddField(
-            model_name='customer',
-            name='wallet_balance',
-            field=models.DecimalField(decimal_places=2, default=0, help_text='Остаток переплат клиента, доступный для оплаты заказов', max_digits=10, verbose_name='Баланс кошелька'),
-        ),
-        migrations.CreateModel(
-            name='WalletTransaction',
-            fields=[
-                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
-                ('amount', models.DecimalField(decimal_places=2, max_digits=10, verbose_name='Сумма')),
-                ('transaction_type', models.CharField(choices=[('deposit', 'Пополнение'), ('spend', 'Списание'), ('adjustment', 'Корректировка')], max_length=20, verbose_name='Тип транзакции')),
-                ('description', models.TextField(blank=True, verbose_name='Описание')),
-                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата создания')),
-                ('created_by', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, to=settings.AUTH_USER_MODEL, verbose_name='Создано пользователем')),
-                ('customer', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, related_name='wallet_transactions', to='customers.customer', verbose_name='Клиент')),
-                ('order', models.ForeignKey(blank=True, help_text='Заказ, к которому относится транзакция (если применимо)', null=True, on_delete=django.db.models.deletion.PROTECT, to='orders.order', verbose_name='Заказ')),
-            ],
-            options={
-                'verbose_name': 'Транзакция кошелька',
-                'verbose_name_plural': 'Транзакции кошелька',
-                'ordering': ['-created_at'],
-                'indexes': [models.Index(fields=['customer', '-created_at'], name='customers_w_custome_572f05_idx'), models.Index(fields=['transaction_type'], name='customers_w_transac_5fda02_idx'), models.Index(fields=['order'], name='customers_w_order_i_5e2527_idx')],
-            },
-        ),
-    ]

myproject/customers/models.py

@@ -1,6 +1,11 @@
+from decimal import Decimal
+
 import phonenumbers
+from django.core.cache import cache
 from django.core.exceptions import ValidationError
 from django.db import models
+from django.db.models import Sum, Value, DecimalField as DjDecimalField
+from django.db.models.functions import Coalesce
 from phonenumber_field.modelfields import PhoneNumberField
 
 
@@ -11,35 +16,18 @@ class Customer(models.Model):
     # Name field that is not required to be unique
     name = models.CharField(max_length=200, blank=True, verbose_name="Имя")
 
-    email = models.EmailField(blank=True, null=True, unique=True, verbose_name="Email")
+    email = models.EmailField(blank=True, null=True, verbose_name="Email")
     
     # Phone with validation using django-phonenumber-field
     phone = PhoneNumberField(
-        blank=True, 
-        null=True, 
-        unique=True,
+        blank=True,
+        null=True,
         verbose_name="Телефон",
         help_text="Введите телефон в любом формате, например: +375291234567, 80255270546, 8(029)1234567 - будет автоматически преобразован в международный формат"
     )
     
     # Temporary field to store raw phone number during initialization
     _raw_phone = None
-    
-    total_spent = models.DecimalField(
-        max_digits=10,
-        decimal_places=2,
-        default=0,
-        verbose_name="Общая сумма покупок"
-    )
-
-    # Wallet balance for overpayments
-    wallet_balance = models.DecimalField(
-        max_digits=10,
-        decimal_places=2,
-        default=0,
-        verbose_name="Баланс кошелька",
-        help_text="Остаток переплат клиента, доступный для оплаты заказов"
-    )
 
     # System customer flag
     is_system_customer = models.BooleanField(
@@ -88,20 +76,6 @@ class Customer(models.Model):
         """Полное имя клиента"""
         return self.name
 
-    def validate_unique(self, exclude=None):
-        """Переопределение для корректной проверки уникальности телефона при обновлениях"""
-        # Снова нормализуем номер телефона перед проверкой уникальности
-        if self.phone:
-            # Проверяем существующих клиентов с таким же телефоном (исключая текущий экземпляр при обновлении)
-            existing = Customer.objects.filter(phone=self.phone)
-            if self.pk:
-                existing = existing.exclude(pk=self.pk)
-            if existing.exists():
-                raise ValidationError({'phone': 'Пользователь с таким номером телефона уже существует.'})
-        
-        # Вызываем родительский validate_unique для обработки других проверок
-        super().validate_unique(exclude=exclude)
-
     def clean_phone(self):
         """Пользовательская очистка поля телефона для нормализации перед валидацией."""
         if self.phone:
@@ -154,15 +128,17 @@ class Customer(models.Model):
 
     def save(self, *args, **kwargs):
         # Защита системного клиента от изменений
-        if self.pk and self.is_system_customer:
+        if self.pk:
             # Получаем оригинальный объект из БД
             try:
                 original = Customer.objects.get(pk=self.pk)
-                # Проверяем, не пытаются ли изменить критичные поля
-                if original.email != self.email:
-                    raise ValidationError("Нельзя изменить email системного клиента")
-                if original.is_system_customer != self.is_system_customer:
-                    raise ValidationError("Нельзя изменить флаг системного клиента")
+                # Проверяем, что это системный клиент в БД
+                if original.is_system_customer:
+                    # Проверяем, не пытаются ли изменить критичные поля
+                    if original.email != self.email:
+                        raise ValidationError("Нельзя изменить email системного клиента")
+                    if original.is_system_customer != self.is_system_customer:
+                        raise ValidationError("Нельзя изменить флаг системного клиента")
             except Customer.DoesNotExist:
                 pass
 
@@ -259,16 +235,199 @@ class Customer(models.Model):
         """
         return self.wallet_transactions.all()
 
+    # ========== МЕТОДЫ ВЫЧИСЛЯЕМОГО БАЛАНСА КОШЕЛЬКА ==========
+
+    def get_wallet_balance(self, category='money', use_cache=True):
+        """
+        Вычисляет баланс кошелька как SUM(signed_amount) транзакций.
+
+        Args:
+            category: 'money' или 'bonus' (для будущей бонусной системы)
+            use_cache: использовать кеш (по умолчанию True)
+
+        Returns:
+            Decimal: текущий баланс
+        """
+        if not self.pk:
+            return Decimal('0')
+
+        cache_key = f'wallet_balance:{self.pk}:{category}'
+
+        if use_cache:
+            cached = cache.get(cache_key)
+            if cached is not None:
+                return Decimal(str(cached))
+
+        result = self.wallet_transactions.filter(
+            balance_category=category
+        ).aggregate(
+            total=Coalesce(
+                Sum('signed_amount'),
+                Value(0),
+                output_field=DjDecimalField()
+            )
+        )
+
+        balance = result['total'] or Decimal('0')
+
+        if use_cache:
+            cache.set(cache_key, str(balance), timeout=300)  # 5 минут
+
+        return balance
+
+    @property
+    def wallet_balance(self):
+        """
+        Баланс кошелька (реальные деньги).
+        Обратная совместимость: используется в templates и существующем коде.
+
+        Returns:
+            Decimal: текущий баланс кошелька
+        """
+        return self.get_wallet_balance(category='money')
+
+    def invalidate_wallet_cache(self, category='money'):
+        """Сбросить кеш баланса кошелька."""
+        cache_key = f'wallet_balance:{self.pk}:{category}'
+        cache.delete(cache_key)
+
+    # Для будущей бонусной системы:
+    # @property
+    # def bonus_balance(self):
+    #     """Баланс бонусных баллов."""
+    #     return self.get_wallet_balance(category='bonus')
+
+    def get_successful_orders_total(self, start_date=None, end_date=None):
+        """
+        Получить сумму успешных заказов за указанный период.
+
+        Args:
+            start_date: Дата начала периода (DateField или None)
+            end_date: Дата окончания периода (DateField или None)
+
+        Returns:
+            Decimal: Сумма успешных заказов
+        """
+        from django.db.models import Sum, Value, DecimalField
+        from django.db.models.functions import Coalesce
+        from decimal import Decimal
+
+        # Базовый queryset: только успешные заказы
+        queryset = self.orders.filter(status__is_positive_end=True)
+
+        # Фильтрация по датам (используем delivery__delivery_date после рефакторинга)
+        if start_date:
+            queryset = queryset.filter(delivery__delivery_date__gte=start_date)
+        if end_date:
+            queryset = queryset.filter(delivery__delivery_date__lte=end_date)
+
+        # Агрегация суммы
+        result = queryset.aggregate(
+            total=Coalesce(
+                Sum('total_amount'),
+                Value(0),
+                output_field=DecimalField()
+            )
+        )
+
+        return result['total'] or Decimal('0')
+
+    def get_last_year_orders_total(self):
+        """
+        Получить сумму успешных заказов за последний календарный год.
+        (С этой даты прошлого года по текущую дату)
+
+        Returns:
+            Decimal: Сумма успешных заказов за год
+        """
+        from datetime import date, timedelta
+
+        today = date.today()
+        year_ago = today - timedelta(days=365)
+
+        return self.get_successful_orders_total(start_date=year_ago, end_date=today)
+
+
+class ContactChannel(models.Model):
+    """Канал связи с клиентом (телефон, email, соцсети)"""
+
+    CHANNEL_TYPES = [
+        ('phone', 'Телефон'),
+        ('email', 'Email'),
+        ('telegram', 'Telegram'),
+        ('instagram', 'Instagram'),
+        ('whatsapp', 'WhatsApp'),
+        ('viber', 'Viber'),
+        ('vk', 'ВКонтакте'),
+        ('facebook', 'Facebook'),
+        ('other', 'Другое'),
+    ]
+
+    customer = models.ForeignKey(
+        'Customer',
+        on_delete=models.CASCADE,
+        related_name='contact_channels',
+        verbose_name="Клиент"
+    )
+    channel_type = models.CharField(
+        max_length=20,
+        choices=CHANNEL_TYPES,
+        verbose_name="Тип канала"
+    )
+    value = models.CharField(
+        max_length=255,
+        verbose_name="Значение",
+        help_text="Username, номер телефона, email и т.д."
+    )
+    is_primary = models.BooleanField(
+        default=False,
+        verbose_name="Основной"
+    )
+    notes = models.CharField(
+        max_length=255,
+        blank=True,
+        verbose_name="Примечание"
+    )
+    created_at = models.DateTimeField(auto_now_add=True, verbose_name="Дата создания")
+
+    class Meta:
+        unique_together = ['channel_type', 'value']
+        indexes = [
+            models.Index(fields=['channel_type', 'value']),
+            models.Index(fields=['customer']),
+        ]
+        verbose_name = "Канал связи"
+        verbose_name_plural = "Каналы связи"
+        ordering = ['-is_primary', 'channel_type']
+
+    def __str__(self):
+        return f"{self.get_channel_type_display()}: {self.value}"
+
 
 class WalletTransaction(models.Model):
     """
     Транзакция по кошельку клиента.
     Хранит историю всех пополнений, списаний и корректировок баланса.
+
+    Архитектура: баланс кошелька = SUM(signed_amount) всех транзакций клиента.
+    Это единственный источник правды о балансе.
     """
+
+    # Типы транзакций (расширяемо для будущей бонусной системы)
     TRANSACTION_TYPE_CHOICES = [
         ('deposit', 'Пополнение'),
         ('spend', 'Списание'),
         ('adjustment', 'Корректировка'),
+        # Для будущей бонусной системы:
+        # ('bonus_accrual', 'Начисление бонусов'),
+        # ('bonus_spend', 'Списание бонусов'),
+        # ('cashback', 'Кэшбэк'),
+    ]
+
+    # Категории баланса (для разделения "реальные деньги" vs "бонусы")
+    BALANCE_CATEGORY_CHOICES = [
+        ('money', 'Реальные деньги'),
+        # ('bonus', 'Бонусные баллы'),  # Для будущей реализации
     ]
 
     customer = models.ForeignKey(
@@ -278,10 +437,12 @@ class WalletTransaction(models.Model):
         verbose_name="Клиент"
     )
 
-    amount = models.DecimalField(
+    # Знаковая сумма: положительная = приход, отрицательная = расход
+    signed_amount = models.DecimalField(
         max_digits=10,
         decimal_places=2,
-        verbose_name="Сумма"
+        verbose_name="Сумма",
+        help_text="Положительная для пополнений, отрицательная для списаний"
     )
 
     transaction_type = models.CharField(
@@ -290,11 +451,20 @@ class WalletTransaction(models.Model):
         verbose_name="Тип транзакции"
     )
 
+    # Категория баланса (подготовка к бонусной системе)
+    balance_category = models.CharField(
+        max_length=20,
+        choices=BALANCE_CATEGORY_CHOICES,
+        default='money',
+        verbose_name="Категория"
+    )
+
     order = models.ForeignKey(
         'orders.Order',
         null=True,
         blank=True,
         on_delete=models.PROTECT,
+        related_name='wallet_transactions',
         verbose_name="Заказ",
         help_text="Заказ, к которому относится транзакция (если применимо)"
     )
@@ -317,6 +487,16 @@ class WalletTransaction(models.Model):
         verbose_name="Создано пользователем"
     )
 
+    # Баланс после транзакции (для быстрого аудита и отображения в истории)
+    balance_after = models.DecimalField(
+        max_digits=10,
+        decimal_places=2,
+        null=True,
+        blank=True,
+        verbose_name="Баланс после",
+        help_text="Баланс кошелька после применения этой транзакции"
+    )
+
     class Meta:
         verbose_name = "Транзакция кошелька"
         verbose_name_plural = "Транзакции кошелька"
@@ -325,8 +505,16 @@ class WalletTransaction(models.Model):
             models.Index(fields=['customer', '-created_at']),
             models.Index(fields=['transaction_type']),
             models.Index(fields=['order']),
+            models.Index(fields=['balance_category']),
+            models.Index(fields=['customer', 'balance_category']),
         ]
 
     def __str__(self):
-        return f"{self.get_transaction_type_display()} {self.amount} руб. для {self.customer}"
+        sign = '+' if self.signed_amount >= 0 else ''
+        return f"{self.get_transaction_type_display()} {sign}{self.signed_amount} руб. для {self.customer}"
+
+    @property
+    def amount(self):
+        """Абсолютная сумма (для обратной совместимости)."""
+        return abs(self.signed_amount)
 

myproject/customers/services/import_export.py

@@ -0,0 +1,995 @@
+"""
+Сервис для импорта и экспорта клиентов.
+
+Этот модуль содержит логику импорта/экспорта клиентов в различных форматах (CSV, Excel).
+Разделение на отдельный модуль улучшает организацию кода и следует принципам SRP.
+"""
+import csv
+import io
+from django.http import HttpResponse
+from django.utils import timezone
+from ..models import Customer
+
+try:
+    # Для чтения .xlsx файлов
+    from openpyxl import load_workbook
+except ImportError:
+    load_workbook = None
+
+try:
+    import phonenumbers
+    from phonenumbers import NumberParseException
+except ImportError:
+    phonenumbers = None
+    NumberParseException = Exception
+
+import re
+
+
+class CustomerExporter:
+    """
+    Класс для экспорта клиентов в различные форматы (CSV/XLSX).
+    Поддерживает выбор полей и фильтрацию по ролям.
+    """
+
+    # Конфигурация доступных полей с метаданными
+    AVAILABLE_FIELDS = {
+        'id': {'label': 'ID', 'owner_only': False},
+        'name': {'label': 'Имя', 'owner_only': False},
+        'email': {'label': 'Email', 'owner_only': False},
+        'phone': {'label': 'Телефон', 'owner_only': False},
+        'notes': {'label': 'Заметки', 'owner_only': False},
+        'contact_channels': {'label': 'Каналы связи', 'owner_only': False},
+        'wallet_balance': {'label': 'Баланс кошелька', 'owner_only': True},
+        'created_at': {'label': 'Дата создания', 'owner_only': False},
+    }
+
+    DEFAULT_FIELDS = ['id', 'name', 'email', 'phone']
+
+    @classmethod
+    def get_available_fields(cls, user):
+        """
+        Получить поля доступные для пользователя на основе роли.
+
+        Args:
+            user: Объект пользователя
+
+        Returns:
+            dict: Словарь доступных полей с метаданными
+        """
+        fields = {}
+        is_owner = user.is_superuser or user.is_owner
+        for field_key, field_info in cls.AVAILABLE_FIELDS.items():
+            if field_info['owner_only'] and not is_owner:
+                continue
+            fields[field_key] = field_info
+        return fields
+
+    def __init__(self, queryset, selected_fields, user):
+        """
+        Инициализация экспортера.
+
+        Args:
+            queryset: QuerySet клиентов (уже отфильтрованный)
+            selected_fields: Список ключей полей для экспорта
+            user: Текущий пользователь (для проверки прав)
+        """
+        self.queryset = queryset
+        self.selected_fields = selected_fields
+        self.user = user
+
+    def _get_headers(self):
+        """Генерация заголовков на основе выбранных полей"""
+        return [
+            self.AVAILABLE_FIELDS[field]['label']
+            for field in self.selected_fields
+        ]
+
+    def _get_field_value(self, customer, field_key):
+        """
+        Получить отформатированное значение для конкретного поля.
+
+        Args:
+            customer: Объект Customer
+            field_key: Ключ поля
+
+        Returns:
+            str: Форматированное значение
+        """
+        if field_key == 'id':
+            return customer.id
+        elif field_key == 'name':
+            return customer.name or ''
+        elif field_key == 'email':
+            return customer.email or ''
+        elif field_key == 'phone':
+            return str(customer.phone) if customer.phone else ''
+        elif field_key == 'notes':
+            return customer.notes or ''
+        elif field_key == 'contact_channels':
+            return self._get_contact_channels_display(customer)
+        elif field_key == 'wallet_balance':
+            # Двойная защита: проверка роли
+            if not (self.user.is_superuser or self.user.is_owner):
+                return 'N/A'
+            return str(customer.wallet_balance)
+        elif field_key == 'created_at':
+            return customer.created_at.strftime('%Y-%m-%d %H:%M:%S')
+        return ''
+
+    def _get_contact_channels_display(self, customer):
+        """
+        Форматирование каналов связи для экспорта.
+        Объединяет все каналы в одну строку с переводами строк.
+
+        Args:
+            customer: Объект Customer
+
+        Returns:
+            str: Форматированная строка каналов связи
+        """
+        channels = customer.contact_channels.all()
+        if not channels:
+            return ''
+
+        from ..models import ContactChannel
+        lines = []
+        for channel in channels:
+            channel_name = dict(ContactChannel.CHANNEL_TYPES).get(
+                channel.channel_type,
+                channel.channel_type
+            )
+            lines.append(f"{channel_name}: {channel.value}")
+
+        return '\n'.join(lines)
+
+    def export_to_csv(self):
+        """
+        Экспорт в CSV с выбранными полями.
+
+        Returns:
+            HttpResponse: CSV файл для скачивания
+        """
+        response = HttpResponse(content_type='text/csv; charset=utf-8')
+        timestamp = timezone.now().strftime("%Y%m%d_%H%M%S")
+        response['Content-Disposition'] = f'attachment; filename="customers_export_{timestamp}.csv"'
+
+        # BOM для корректного открытия в Excel
+        response.write('\ufeff')
+
+        writer = csv.writer(response)
+
+        # Динамические заголовки
+        writer.writerow(self._get_headers())
+
+        # Данные
+        for customer in self.queryset:
+            row = [
+                self._get_field_value(customer, field)
+                for field in self.selected_fields
+            ]
+            writer.writerow(row)
+
+        return response
+
+    def export_to_xlsx(self):
+        """
+        Экспорт в XLSX используя openpyxl.
+
+        Returns:
+            HttpResponse: XLSX файл для скачивания
+        """
+        try:
+            from openpyxl import Workbook
+        except ImportError:
+            # Fallback to CSV если openpyxl не установлен
+            return self.export_to_csv()
+
+        wb = Workbook()
+        ws = wb.active
+        ws.title = "Клиенты"
+
+        # Заголовки
+        ws.append(self._get_headers())
+
+        # Данные
+        for customer in self.queryset:
+            row = [
+                self._get_field_value(customer, field)
+                for field in self.selected_fields
+            ]
+            ws.append(row)
+
+        # Автоподстройка ширины столбцов
+        for column in ws.columns:
+            max_length = 0
+            column_letter = column[0].column_letter
+            for cell in column:
+                try:
+                    if len(str(cell.value)) > max_length:
+                        max_length = len(cell.value)
+                except:
+                    pass
+            adjusted_width = min(max_length + 2, 50)  # Максимум 50
+            ws.column_dimensions[column_letter].width = adjusted_width
+
+        # Сохранение в BytesIO
+        output = io.BytesIO()
+        wb.save(output)
+        output.seek(0)
+
+        # Создание response
+        response = HttpResponse(
+            output.read(),
+            content_type='application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+        )
+        timestamp = timezone.now().strftime("%Y%m%d_%H%M%S")
+        response['Content-Disposition'] = f'attachment; filename="customers_export_{timestamp}.xlsx"'
+
+        return response
+
+
+class CustomerImporter:
+    """
+    Простой универсальный импорт клиентов из CSV/XLSX.
+
+    Поддерживаемые форматы:
+    - CSV (UTF-8, заголовок в первой строке)
+    - XLSX (первая строка — заголовки)
+
+    Алгоритм:
+    - Читаем файл → получаем headers и list[dict] строк
+    - По headers строим маппинг на поля Customer: name/email/phone/notes
+    - Для каждой строки:
+      - пропускаем полностью пустые строки
+      - ищем клиента по email, потом по телефону
+      - если update_existing=False и клиент найден → пропуск
+      - если update_existing=True → обновляем найденного
+      - если не найден → создаём нового
+    - Вся валидация/нормализация делается через Customer.full_clean()
+    """
+
+    FIELD_ALIASES = {
+        "name": ["name", "имя", "фио", "клиент", "фамилияимя"],
+        "email": ["email", "e-mail", "e_mail", "почта", "элпочта", "электроннаяпочта"],
+        "phone": ["phone", "телефон", "тел", "моб", "мобильный", "номер"],
+        "notes": ["notes", "заметки", "комментарий", "comment", "примечание"],
+    }
+
+    def __init__(self):
+        self.errors = []
+        self.success_count = 0
+        self.update_count = 0
+        self.enriched_count = 0  # Дополнены пустые поля
+        self.conflicts_resolved = 0  # Альтернативные контакты через ContactChannel
+        self.skip_count = 0
+        # Отслеживание уже обработанных email/phone для дедупликации внутри файла
+        self.processed_emails = set()
+        self.processed_phones = set()
+        # Отдельный список для реальных ошибок (не дублей из БД)
+        self.real_errors = []
+        # Сохраняем исходные данные для генерации error-файла
+        self.original_headers = []
+        self.original_rows = []
+        self.file_format = None
+
+    def import_from_file(self, file, update_existing: bool = False) -> dict:
+        """
+        Импорт клиентов из загруженного файла.
+
+        Args:
+            file: UploadedFile
+            update_existing: обновлять ли существующих клиентов (по email/телефону)
+
+        Returns:
+            dict: результат импорта
+        """
+        file_format = self._detect_format(file)
+
+        if file_format is None:
+            return {
+                "success": False,
+                "message": "Неподдерживаемый формат файла. Ожидается CSV или XLSX.",
+                "created": 0,
+                "updated": 0,
+                "skipped": 0,
+                "errors": [{"row": None, "reason": "Unsupported file type"}],
+            }
+
+        if file_format == "xlsx" and load_workbook is None:
+            return {
+                "success": False,
+                "message": "Для импорта XLSX необходим пакет openpyxl. Установите его и повторите попытку.",
+                "created": 0,
+                "updated": 0,
+                "skipped": 0,
+                "errors": [{"row": None, "reason": "openpyxl is not installed"}],
+            }
+
+        # Сохраняем формат файла
+        self.file_format = file_format
+        
+        try:
+            if file_format == "csv":
+                headers, rows = self._read_csv(file)
+            else:
+                headers, rows = self._read_xlsx(file)
+            
+            # Сохраняем исходные данные
+            self.original_headers = headers
+            self.original_rows = rows
+        except Exception as exc:
+            return {
+                "success": False,
+                "message": f"Ошибка чтения файла: {exc}",
+                "created": 0,
+                "updated": 0,
+                "skipped": 0,
+                "errors": [{"row": None, "reason": str(exc)}],
+            }
+
+        if not headers:
+            return {
+                "success": False,
+                "message": "В файле не найдены заголовки.",
+                "created": 0,
+                "updated": 0,
+                "skipped": 0,
+                "errors": [{"row": None, "reason": "Empty header row"}],
+            }
+
+        mapping = self._build_mapping(headers)
+
+        if not any(field in mapping for field in ("name", "email", "phone")):
+            return {
+                "success": False,
+                "message": "Не удалось сопоставить обязательные поля (имя, email или телефон).",
+                "created": 0,
+                "updated": 0,
+                "skipped": len(rows),
+                "errors": [
+                    {
+                        "row": None,
+                        "reason": "No required fields (name/email/phone) mapped from headers",
+                    }
+                ],
+            }
+
+        for index, row in enumerate(rows, start=2):  # первая строка — заголовки
+            self._process_row(index, row, mapping, update_existing)
+
+        total_errors = len(self.errors)
+        duplicate_count = len([e for e in self.errors if e.get('is_duplicate', False)])
+        real_error_count = len(self.real_errors)
+        success = (self.success_count + self.update_count) > 0
+
+        if success and total_errors == 0:
+            message = "Импорт завершён успешно."
+        elif success and total_errors > 0:
+            message = "Импорт завершён с ошибками."
+        else:
+            message = "Не удалось импортировать данные."
+
+        return {
+            "success": success,
+            "message": message,
+            "created": self.success_count,
+            "updated": self.update_count,
+            "enriched": self.enriched_count,
+            "conflicts_resolved": self.conflicts_resolved,
+            "skipped": self.skip_count,
+            "errors": self.errors,
+            "real_errors": self.real_errors,  # Только невалидные данные, без дублей из БД
+            "duplicate_count": duplicate_count,
+            "real_error_count": real_error_count,
+        }
+
+    def _detect_format(self, file) -> str | None:
+        name = (getattr(file, "name", None) or "").lower()
+        if name.endswith(".csv"):
+            return "csv"
+        if name.endswith(".xlsx") or name.endswith(".xls"):
+            return "xlsx"
+        return None
+
+    def _read_csv(self, file):
+        file.seek(0)
+        raw = file.read()
+        if isinstance(raw, bytes):
+            text = raw.decode("utf-8-sig")
+        else:
+            text = raw
+        f = io.StringIO(text)
+        reader = csv.DictReader(f)
+        headers = reader.fieldnames or []
+        rows = list(reader)
+        return headers, rows
+
+    def _read_xlsx(self, file):
+        file.seek(0)
+        wb = load_workbook(file, read_only=True, data_only=True)
+        ws = wb.active
+
+        headers = []
+        rows = []
+        first_row = True
+
+        for row in ws.iter_rows(values_only=True):
+            if first_row:
+                headers = [str(v).strip() if v is not None else "" for v in row]
+                first_row = False
+                continue
+
+            if not any(row):
+                continue
+
+            row_dict = {}
+            for idx, value in enumerate(row):
+                if idx < len(headers):
+                    header = headers[idx] or f"col_{idx}"
+                    row_dict[header] = value
+            rows.append(row_dict)
+
+        return headers, rows
+
+    def _normalize_header(self, header: str) -> str:
+        if header is None:
+            return ""
+        cleaned = "".join(ch for ch in str(header).strip().lower() if ch.isalnum())
+        return cleaned
+
+    def _build_mapping(self, headers):
+        mapping = {}
+        normalized_aliases = {
+            field: {self._normalize_header(a) for a in aliases}
+            for field, aliases in self.FIELD_ALIASES.items()
+        }
+
+        for header in headers:
+            norm = self._normalize_header(header)
+            if not norm:
+                continue
+            for field, alias_set in normalized_aliases.items():
+                if norm in alias_set and field not in mapping:
+                    mapping[field] = header
+                    break
+
+        return mapping
+
+    def _clean_value(self, value):
+        if value is None:
+            return ""
+        return str(value).strip()
+
+    def _normalize_phone(self, raw_phone: str) -> str | None:
+        """
+        Умная нормализация телефона с попыткой различных регионов.
+        
+        Стратегии:
+        1. Если начинается с '+' — парсим как международный
+        2. Если начинается с '8' и 11 цифр — пробуем BY, потом RU
+        3. Пробуем распространённые регионы: BY, RU, PL, DE, US
+        4. Если всё не удалось — возвращаем None
+        
+        Returns:
+            Нормализованный телефон в E.164 формате или None
+        """
+        if not raw_phone or not phonenumbers:
+            return None
+
+        # Убираем все символы кроме цифр и +
+        cleaned = re.sub(r'[^\d+]', '', str(raw_phone))
+        
+        if not cleaned:
+            return None
+        
+        # Проверка длины
+        if len(cleaned) < 10 or len(cleaned) > 15:
+            return None
+        
+        # Умное добавление кода страны
+        if not cleaned.startswith('+'):
+            # Белорусские номера (375...)
+            if cleaned.startswith('375'):
+                cleaned = '+' + cleaned
+            # Российские номера (7XXXXXXXXXX)
+            elif cleaned.startswith('7') and len(cleaned) == 11:
+                cleaned = '+' + cleaned
+            # Украинские номера (380...)
+            elif cleaned.startswith('380'):
+                cleaned = '+' + cleaned
+            # Старый формат 8XXXXXXXXXX -> +7XXXXXXXXXX
+            elif cleaned.startswith('8') and len(cleaned) == 11:
+                cleaned = '+7' + cleaned[1:]
+            # 9 цифр - предполагаем Беларусь
+            elif len(cleaned) == 9:
+                cleaned = '+375' + cleaned
+
+        # Стратегия 1: Международный формат (начинается с +)
+        if cleaned.startswith('+'):
+            try:
+                parsed = phonenumbers.parse(cleaned, None)
+                if phonenumbers.is_valid_number(parsed):
+                    return phonenumbers.format_number(parsed, phonenumbers.PhoneNumberFormat.E164)
+            except NumberParseException:
+                pass
+
+        # Стратегия 2: Пробуем распространённые регионы
+        for region in ['BY', 'RU', 'UA', 'PL', 'DE']:
+            try:
+                test_number = cleaned if cleaned.startswith('+') else f'+{cleaned}'
+                parsed = phonenumbers.parse(test_number, region)
+                if phonenumbers.is_valid_number(parsed):
+                    return phonenumbers.format_number(parsed, phonenumbers.PhoneNumberFormat.E164)
+            except NumberParseException:
+                continue
+
+            try:
+                parsed = phonenumbers.parse(cleaned, region)
+                if phonenumbers.is_valid_number(parsed):
+                    return phonenumbers.format_number(parsed, phonenumbers.PhoneNumberFormat.E164)
+            except NumberParseException:
+                continue
+
+        return None
+
+    def _preprocess_email(self, email: str) -> str | None:
+        """
+        Предобработка email перед валидацией.
+        Исправляет типичные ошибки и опечатки.
+        
+        Args:
+            email: Исходный email
+        
+        Returns:
+            str | None: Очищенный email или None если пустой
+        """
+        if not email or not isinstance(email, str):
+            return None
+        
+        email = email.strip()
+        
+        if not email:
+            return None
+        
+        # Удаляем лишний текст в конце (фото, комментарии)
+        email = re.sub(r'\s+фото.*$', '', email, flags=re.IGNORECASE)
+        email = re.sub(r'\s+ф\d+$', '', email)
+        
+        # Убираем пробелы внутри email
+        email = email.replace(' ', '')
+        
+        # Двойные @@ -> одинарный @
+        email = email.replace('@@', '@')
+        
+        # Исправляем пробелы вокруг @
+        email = re.sub(r'\s*@\s*', '@', email)
+        
+        # Исправляем типичные опечатки в доменах
+        email = email.replace('.ry', '.ru')
+        email = email.replace('mail ru', 'mail.ru')
+        email = email.replace('ya ru', 'ya.ru')
+        email = email.replace('tut by', 'tut.by')
+        email = email.replace('gmail.co.m', 'gmail.com')
+        email = email.replace('/com', '.com')
+        
+        # Если нет @, но есть gmail/mail/etc - пытаемся добавить
+        if '@' not in email:
+            if 'gmail' in email.lower():
+                email = re.sub(r'gmail', '@gmail', email, flags=re.IGNORECASE)
+            elif 'mail.ru' in email.lower():
+                email = re.sub(r'mail\.ru', '@mail.ru', email, flags=re.IGNORECASE)
+            elif 'yandex' in email.lower():
+                email = re.sub(r'yandex', '@yandex', email, flags=re.IGNORECASE)
+        
+        # Исправляем домены без точки
+        if '@' in email:
+            parts = email.split('@')
+            if len(parts) == 2:
+                local, domain = parts
+                domain_lower = domain.lower()
+                
+                # Если домен слишком короткий - невалидный
+                if len(domain) < 4:
+                    return None
+                
+                # Если нет точки в домене - пытаемся исправить
+                if '.' not in domain:
+                    domain_map = {
+                        'gmail': 'gmail.com',
+                        'mailru': 'mail.ru',
+                        'yaru': 'ya.ru',
+                        'tutby': 'tut.by',
+                        'yandexru': 'yandex.ru',
+                    }
+                    domain = domain_map.get(domain_lower, None)
+                    if not domain:
+                        # Неизвестный домен без точки
+                        return None
+                    email = f"{local}@{domain}"
+        
+        return email.lower() if email else None
+
+    def _is_valid_email(self, email: str) -> bool:
+        """
+        Проверка валидности email через Django EmailValidator.
+        
+        Args:
+            email: Email для проверки
+        
+        Returns:
+            bool: True если email валиден
+        """
+        from django.core.validators import validate_email
+        from django.core.exceptions import ValidationError
+        
+        if not email:
+            return False
+        
+        try:
+            validate_email(email)
+            return True
+        except ValidationError:
+            return False
+
+    def _get_better_name(self, existing_name: str, new_name: str) -> str:
+        """
+        Выбирает более полное/информативное имя.
+        
+        Приоритеты:
+        1. Если одно пустое - возвращаем непустое
+        2. Если новое длиннее И содержит старое - берём новое
+        3. Если в новом есть пробелы (ФИО), а в старом нет - берём новое
+        4. Иначе оставляем старое
+        
+        Returns:
+            str: Лучшее имя и флаг конфликта
+        """
+        if not existing_name:
+            return new_name
+        if not new_name:
+            return existing_name
+        
+        # Если новое имя длиннее и содержит старое - используем новое
+        if len(new_name) > len(existing_name) and existing_name.lower() in new_name.lower():
+            return new_name
+        
+        # Если в новом есть пробелы (ФИО), а в старом нет - берём новое
+        if ' ' in new_name and ' ' not in existing_name:
+            return new_name
+        
+        # Иначе оставляем существующее
+        return existing_name
+
+    def _create_alternative_contact(self, customer, channel_type: str, value: str, source: str = 'Импорт'):
+        """
+        Создаёт альтернативный контакт через ContactChannel.
+        
+        Args:
+            customer: Объект Customer
+            channel_type: Тип канала ('email' или 'phone')
+            value: Значение контакта
+            source: Источник (для notes)
+        
+        Returns:
+            bool: True если создан, False если уже существует
+        """
+        from ..models import ContactChannel
+        
+        # Проверяем, не существует ли уже такой контакт
+        exists = ContactChannel.objects.filter(
+            channel_type=channel_type,
+            value=value
+        ).exists()
+        
+        if exists:
+            return False
+        
+        try:
+            ContactChannel.objects.create(
+                customer=customer,
+                channel_type=channel_type,
+                value=value,
+                is_primary=False,
+                notes=f'Из {source}'
+            )
+            return True
+        except Exception:
+            # Если не удалось создать - пропускаем
+            return False
+
+    def _process_row(self, row_number: int, row: dict, mapping: dict, update_existing: bool):
+        name = self._clean_value(row.get(mapping.get("name", ""), ""))
+        email = self._clean_value(row.get(mapping.get("email", ""), ""))
+        phone_raw = self._clean_value(row.get(mapping.get("phone", ""), ""))
+        notes = self._clean_value(row.get(mapping.get("notes", ""), ""))
+
+        if not any([name, email, phone_raw, notes]):
+            self.skip_count += 1
+            return
+
+        # Нормализуем email (с предобработкой)
+        if email:
+            email = self._preprocess_email(email)
+            # Проверка на дубли внутри файла
+            if email and email in self.processed_emails:
+                self.skip_count += 1
+                self.errors.append(
+                    {
+                        "row": row_number,
+                        "email": email,
+                        "phone": phone_raw or None,
+                        "reason": "Дубль email внутри файла (уже обработан в предыдущей строке).",
+                        "is_duplicate": True,  # Дубликат внутри файла
+                    }
+                )
+                return
+
+        # Умная нормализация телефона
+        phone = None
+        phone_normalization_failed = False
+        if phone_raw:
+            phone = self._normalize_phone(phone_raw)
+            if not phone:
+                phone_normalization_failed = True
+            else:
+                # Проверка на дубли внутри файла
+                if phone in self.processed_phones:
+                    self.skip_count += 1
+                    self.errors.append(
+                        {
+                            "row": row_number,
+                            "email": email or None,
+                            "phone": phone_raw,
+                            "reason": "Дубль телефона внутри файла (уже обработан в предыдущей строке).",
+                            "is_duplicate": True,  # Дубликат внутри файла
+                        }
+                    )
+                    return
+
+        # Если телефон не удалось нормализовать, сохраняем в notes
+        if phone_normalization_failed:
+            note_addition = f"Исходный телефон из импорта (невалидный): {phone_raw}"
+            if notes:
+                notes = f"{notes}\n{note_addition}"
+            else:
+                notes = note_addition
+
+        # Проверка: есть ли хотя бы ОДИН валидный контакт
+        has_valid_email = self._is_valid_email(email)
+        has_valid_phone = phone is not None  # phone уже нормализован или None
+
+        if not has_valid_email and not has_valid_phone:
+            # Нет валидных контактов - в ошибки
+            self.skip_count += 1
+            error_record = {
+                "row": row_number,
+                "email": email or None,
+                "phone": phone_raw or None,
+                "reason": "Требуется хотя бы один: email или телефон",
+                "is_duplicate": False,
+            }
+            self.errors.append(error_record)
+            self.real_errors.append(error_record)
+            return
+
+        # Пытаемся найти существующего клиента
+        existing = None
+        if email:
+            existing = Customer.objects.filter(email=email).first()
+        if existing is None and phone:
+            existing = Customer.objects.filter(phone=phone).first()
+
+        if existing and not update_existing:
+            self.skip_count += 1
+            self.errors.append(
+                {
+                    "row": row_number,
+                    "email": email or None,
+                    "phone": phone_raw or None,
+                    "reason": "Клиент с таким email/телефоном уже существует, обновление отключено.",
+                    "is_duplicate": True,  # Помечаем как дубликат из БД
+                }
+            )
+            return
+
+        if existing and update_existing:
+            # Умное слияние (smart merge)
+            was_enriched = False  # Флаг дополнения пустых полей
+            
+            # 1. Имя - выбираем лучшее
+            if name:
+                better_name = self._get_better_name(existing.name or '', name)
+                if not existing.name:
+                    was_enriched = True
+                    existing.name = better_name
+                elif better_name != existing.name:
+                    # Конфликт имен - добавляем в notes
+                    if name != existing.name and name.lower() not in existing.name.lower():
+                        alt_name_note = f"Также известен как: {name}"
+                        if existing.notes:
+                            if alt_name_note not in existing.notes:
+                                existing.notes = f"{existing.notes}\n{alt_name_note}"
+                        else:
+                            existing.notes = alt_name_note
+                    existing.name = better_name
+            
+            # 2. Email - дополняем или создаём ContactChannel
+            if email:
+                if not existing.email:
+                    # Пустое поле - дополняем
+                    was_enriched = True
+                    existing.email = email
+                elif existing.email != email:
+                    # Конфликт - создаём альтернативный контакт
+                    if self._create_alternative_contact(existing, 'email', email):
+                        self.conflicts_resolved += 1
+            
+            # 3. Телефон - дополняем или создаём ContactChannel
+            if phone:
+                if not existing.phone:
+                    # Пустое поле - дополняем
+                    was_enriched = True
+                    existing.phone = phone
+                elif str(existing.phone) != phone:
+                    # Конфликт - создаём альтернативный контакт
+                    if self._create_alternative_contact(existing, 'phone', phone):
+                        self.conflicts_resolved += 1
+            
+            # 4. Заметки - ВСЕГДА дописываем
+            if notes:
+                if existing.notes:
+                    existing.notes = f"{existing.notes}\n{notes}"
+                else:
+                    existing.notes = notes
+
+            try:
+                existing.full_clean()
+                existing.save()
+                
+                # Счётчики
+                if was_enriched:
+                    self.enriched_count += 1
+                else:
+                    self.update_count += 1
+                
+                if email:
+                    self.processed_emails.add(email)
+                if phone:
+                    self.processed_phones.add(phone)
+            except Exception as exc:
+                self.skip_count += 1
+                error_record = {
+                    "row": row_number,
+                    "email": email or None,
+                    "phone": phone_raw or None,
+                    "reason": str(exc),
+                    "is_duplicate": False,
+                }
+                self.errors.append(error_record)
+                self.real_errors.append(error_record)  # Реальная ошибка валидации
+            return
+
+        # Создание нового клиента
+        customer = Customer(
+            name=name or "",
+            email=email or None,
+            phone=phone or None,  # Если не удалось нормализовать — будет None
+            notes=notes or "",
+        )
+
+        try:
+            customer.full_clean()
+            customer.save()
+            self.success_count += 1
+            if email:
+                self.processed_emails.add(email)
+            if phone:
+                self.processed_phones.add(phone)
+        except Exception as exc:
+            self.skip_count += 1
+            error_record = {
+                "row": row_number,
+                "email": email or None,
+                "phone": phone_raw or None,
+                "reason": str(exc),
+                "is_duplicate": False,
+            }
+            self.errors.append(error_record)
+            self.real_errors.append(error_record)  # Реальная ошибка валидации
+
+    def generate_error_file(self) -> tuple[bytes, str] | None:
+        """
+        Генерирует файл с ошибочными строками (только real_errors).
+        
+        Возвращает тот же формат, что был загружен (CSV или XLSX).
+        Добавляет колонку "Ошибка" с описанием проблемы.
+        
+        Returns:
+            tuple[bytes, str]: (file_content, filename) или None если нет ошибок
+        """
+        if not self.real_errors or not self.original_headers:
+            return None
+        
+        # Создаём mapping row_number -> error
+        error_map = {err['row']: err for err in self.real_errors if err.get('row')}
+        
+        if not error_map:
+            return None
+        
+        # Собираем ошибочные строки
+        error_rows = []
+        for index, row in enumerate(self.original_rows, start=2):  # start=2 т.к. первая строка - заголовки
+            if index in error_map:
+                error_info = error_map[index]
+                # Добавляем исходную строку + колонку с ошибкой
+                row_with_error = dict(row)  # копируем
+                row_with_error['Ошибка'] = error_info['reason']
+                error_rows.append(row_with_error)
+        
+        if not error_rows:
+            return None
+        
+        # Заголовки + колонка "Ошибка"
+        headers_with_error = list(self.original_headers) + ['Ошибка']
+        
+        # Генерируем файл в зависимости от формата
+        timestamp = timezone.now().strftime("%Y%m%d_%H%M%S")
+        
+        if self.file_format == 'csv':
+            return self._generate_csv_error_file(headers_with_error, error_rows, timestamp)
+        else:
+            return self._generate_xlsx_error_file(headers_with_error, error_rows, timestamp)
+    
+    def _generate_csv_error_file(self, headers: list, rows: list[dict], timestamp: str) -> tuple[bytes, str]:
+        """
+        Генерирует CSV файл с ошибками (с BOM для Excel).
+        """
+        output = io.StringIO()
+        # BOM для корректного открытия в Excel
+        output.write('\ufeff')
+        
+        writer = csv.DictWriter(output, fieldnames=headers, extrasaction='ignore')
+        writer.writeheader()
+        writer.writerows(rows)
+        
+        content = output.getvalue().encode('utf-8')
+        filename = f'customer_import_errors_{timestamp}.csv'
+        
+        return content, filename
+    
+    def _generate_xlsx_error_file(self, headers: list, rows: list[dict], timestamp: str) -> tuple[bytes, str] | None:
+        """
+        Генерирует XLSX файл с ошибками.
+        """
+        if load_workbook is None:
+            # Fallback to CSV если openpyxl не установлен
+            return self._generate_csv_error_file(headers, rows, timestamp)
+        
+        try:
+            from openpyxl import Workbook
+            
+            wb = Workbook()
+            ws = wb.active
+            ws.title = "Ошибки импорта"
+            
+            # Заголовки
+            ws.append(headers)
+            
+            # Данные
+            for row_dict in rows:
+                row_data = [row_dict.get(h, '') for h in headers]
+                ws.append(row_data)
+            
+            # Сохраняем в BytesIO
+            output = io.BytesIO()
+            wb.save(output)
+            output.seek(0)
+            
+            content = output.read()
+            filename = f'customer_import_errors_{timestamp}.xlsx'
+            
+            return content, filename
+        except Exception:
+            # Fallback to CSV при любой ошибке
+            return self._generate_csv_error_file(headers, rows, timestamp)

myproject/customers/services/wallet_service.py

@@ -1,8 +1,10 @@
 """
 Сервис для работы с кошельком клиента.
-Обрабатывает пополнения, списания и корректировки баланса.
+Все операции создают транзакции в WalletTransaction.
+Баланс вычисляется как SUM(signed_amount).
 """
 from decimal import Decimal, ROUND_HALF_UP
+
 from django.db import transaction
 
 
@@ -20,140 +22,112 @@ def _quantize(value):
 class WalletService:
     """
     Сервис для управления кошельком клиента.
-    Все операции атомарны и блокируют запись клиента для избежания race conditions.
+
+    Архитектура:
+    - Баланс = SUM(signed_amount) транзакций (нет денормализованного поля)
+    - Все операции атомарны с блокировкой строк
+    - Кеширование баланса для производительности
+    - Инвалидация кеша при каждой транзакции
     """
 
     @staticmethod
     @transaction.atomic
-    def add_overpayment(order, user):
+    def create_transaction(
+        customer,
+        amount,
+        transaction_type,
+        category='money',
+        order=None,
+        description='',
+        user=None
+    ):
         """
-        Обработка переплаты по заказу.
-        Переносит излишек в кошелёк клиента и нормализует amount_paid заказа.
+        Создать транзакцию кошелька (базовый метод).
 
         Args:
-            order: Заказ с переплатой
-            user: Пользователь, инициировавший операцию
+            customer: Customer или customer_id
+            amount: Decimal - положительная сумма
+            transaction_type: str - 'deposit', 'spend', 'adjustment'
+            category: str - 'money' или 'bonus'
+            order: Order - связанный заказ (опционально)
+            description: str - описание
+            user: CustomUser - кто создал
 
         Returns:
-            Decimal: Сумма переплаты или None, если переплаты нет
+            WalletTransaction
+
+        Raises:
+            ValueError: если некорректные данные или недостаточно средств
         """
         from customers.models import Customer, WalletTransaction
 
-        overpayment = order.amount_paid - order.total_amount
-        if overpayment <= 0:
-            return None
+        # Получаем и блокируем клиента
+        if isinstance(customer, int):
+            customer = Customer.objects.select_for_update().get(pk=customer)
+        else:
+            customer = Customer.objects.select_for_update().get(pk=customer.pk)
 
-        # Блокируем запись клиента для обновления
-        customer = Customer.objects.select_for_update().get(pk=order.customer_id)
-
-        # Округляем переплату до 2 знаков
-        overpayment = _quantize(overpayment)
-
-        # Увеличиваем баланс кошелька
-        customer.wallet_balance = _quantize(customer.wallet_balance + overpayment)
-        customer.save(update_fields=['wallet_balance'])
-
-        # Создаём транзакцию для аудита
-        WalletTransaction.objects.create(
-            customer=customer,
-            amount=overpayment,
-            transaction_type='deposit',
-            order=order,
-            description=f'Переплата по заказу #{order.order_number}',
-            created_by=user
-        )
-
-        # Нормализуем amount_paid заказа до total_amount
-        order.amount_paid = order.total_amount
-        order.save(update_fields=['amount_paid'])
-
-        return overpayment
-
-    @staticmethod
-    @transaction.atomic
-    def pay_with_wallet(order, amount, user):
-        """
-        Оплата заказа из кошелька клиента.
-        Списывает средства с кошелька и создаёт платёж в заказе.
-
-        Args:
-            order: Заказ для оплаты
-            amount: Запрашиваемая сумма для списания
-            user: Пользователь, инициировавший операцию
-
-        Returns:
-            Decimal: Фактически списанная сумма или None
-        """
-        from customers.models import Customer, WalletTransaction
-        from orders.models import Payment, PaymentMethod
-
-        # Округляем запрошенную сумму
         amount = _quantize(amount)
         if amount <= 0:
-            return None
+            raise ValueError('Сумма должна быть положительной')
 
-        # Блокируем запись клиента
-        customer = Customer.objects.select_for_update().get(pk=order.customer_id)
+        # Определяем знак суммы
+        if transaction_type == 'spend':
+            signed_amount = -amount
+        else:
+            signed_amount = amount
 
-        # Остаток к оплате по заказу
-        amount_due = order.total_amount - order.amount_paid
+        # Получаем текущий баланс (без кеша для точности)
+        current_balance = customer.get_wallet_balance(category=category, use_cache=False)
 
-        # Определяем фактическую сумму списания (минимум из трёх)
-        usable_amount = min(amount, customer.wallet_balance, amount_due)
-        usable_amount = _quantize(usable_amount)
+        # Проверяем баланс для списания
+        if signed_amount < 0:
+            if current_balance + signed_amount < 0:
+                raise ValueError(
+                    f'Недостаточно средств. Баланс: {current_balance}, '
+                    f'запрошено: {abs(signed_amount)}'
+                )
 
-        if usable_amount <= 0:
-            return None
+        # Вычисляем баланс после транзакции
+        balance_after = current_balance + signed_amount
 
-        # Получаем способ оплаты "С баланса счёта"
-        try:
-            payment_method = PaymentMethod.objects.get(code='account_balance')
-        except PaymentMethod.DoesNotExist:
-            raise ValueError(
-                'Способ оплаты "account_balance" не найден. '
-                'Запустите команду create_payment_methods.'
-            )
-
-        # Создаём платёж в заказе
-        Payment.objects.create(
-            order=order,
-            amount=usable_amount,
-            payment_method=payment_method,
-            created_by=user,
-            notes='Оплата из кошелька клиента'
-        )
-
-        # Уменьшаем баланс кошелька
-        customer.wallet_balance = _quantize(customer.wallet_balance - usable_amount)
-        customer.save(update_fields=['wallet_balance'])
-
-        # Создаём транзакцию для аудита
-        WalletTransaction.objects.create(
+        # Создаём транзакцию
+        txn = WalletTransaction.objects.create(
             customer=customer,
-            amount=usable_amount,
-            transaction_type='spend',
+            signed_amount=signed_amount,
+            transaction_type=transaction_type,
+            balance_category=category,
             order=order,
-            description=f'Оплата заказа #{order.order_number} из кошелька',
-            created_by=user
+            description=description,
+            created_by=user,
+            balance_after=balance_after
         )
 
-        return usable_amount
+        # Инвалидируем кеш
+        customer.invalidate_wallet_cache(category=category)
+
+        return txn
 
     @staticmethod
     @transaction.atomic
-    def adjust_balance(customer_id, amount, description, user):
+    def create_adjustment(customer, amount, description, user, category='money'):
         """
-        Корректировка баланса кошелька администратором.
-        Может быть как положительной (пополнение), так и отрицательной (списание).
+        Корректировка баланса (может быть положительной или отрицательной).
+
+        Используется для административных операций:
+        - Пополнение кошелька
+        - Списание средств
+        - Исправление ошибок
 
         Args:
-            customer_id: ID клиента
-            amount: Сумма корректировки (может быть отрицательной)
-            description: Обязательное описание причины корректировки
-            user: Пользователь, выполнивший корректировку
+            customer: Customer или customer_id
+            amount: Decimal - сумма (может быть отрицательной)
+            description: str - обязательное описание
+            user: CustomUser
+            category: str - 'money' или 'bonus'
 
         Returns:
-            WalletTransaction: Созданная транзакция
+            WalletTransaction
         """
         from customers.models import Customer, WalletTransaction
 
@@ -164,30 +138,221 @@ class WalletService:
         if amount == 0:
             raise ValueError('Сумма корректировки не может быть нулевой')
 
-        # Блокируем запись клиента
-        customer = Customer.objects.select_for_update().get(pk=customer_id)
+        # Получаем и блокируем клиента
+        if isinstance(customer, int):
+            customer = Customer.objects.select_for_update().get(pk=customer)
+        else:
+            customer = Customer.objects.select_for_update().get(pk=customer.pk)
 
-        # Применяем корректировку
-        new_balance = _quantize(customer.wallet_balance + amount)
+        # Получаем текущий баланс
+        current_balance = customer.get_wallet_balance(category=category, use_cache=False)
 
         # Проверяем, что баланс не уйдёт в минус
-        if new_balance < 0:
+        if current_balance + amount < 0:
             raise ValueError(
-                f'Корректировка приведёт к отрицательному балансу '
-                f'({new_balance} руб.). Операция отклонена.'
+                f'Корректировка приведёт к отрицательному балансу. '
+                f'Текущий баланс: {current_balance}, корректировка: {amount}'
             )
 
-        customer.wallet_balance = new_balance
-        customer.save(update_fields=['wallet_balance'])
+        # Вычисляем баланс после
+        balance_after = current_balance + amount
 
         # Создаём транзакцию
         txn = WalletTransaction.objects.create(
             customer=customer,
-            amount=abs(amount),
+            signed_amount=amount,  # Может быть положительной или отрицательной
             transaction_type='adjustment',
+            balance_category=category,
             order=None,
             description=description,
-            created_by=user
+            created_by=user,
+            balance_after=balance_after
         )
 
+        # Инвалидируем кеш
+        customer.invalidate_wallet_cache(category=category)
+
         return txn
+
+    @staticmethod
+    @transaction.atomic
+    def pay_with_wallet(order, amount, user):
+        """
+        Оплата заказа из кошелька клиента.
+
+        Args:
+            order: Заказ для оплаты
+            amount: Запрашиваемая сумма
+            user: Пользователь
+
+        Returns:
+            Decimal: Фактически списанная сумма или None
+        """
+        from customers.models import Customer
+        from orders.services.transaction_service import TransactionService
+
+        amount = _quantize(amount)
+        if amount <= 0:
+            return None
+
+        # Блокируем клиента для проверки баланса
+        customer = Customer.objects.select_for_update().get(pk=order.customer_id)
+
+        # Текущий баланс
+        wallet_balance = customer.get_wallet_balance(use_cache=False)
+
+        # Остаток к оплате
+        amount_due = order.total_amount - order.amount_paid
+
+        # Фактическая сумма (минимум из трёх)
+        usable_amount = min(amount, wallet_balance, amount_due)
+        usable_amount = _quantize(usable_amount)
+
+        if usable_amount <= 0:
+            return None
+
+        # Создаём транзакцию платежа
+        # Transaction.save() вызовет create_wallet_spend()
+        TransactionService.create_payment(
+            order=order,
+            amount=usable_amount,
+            payment_method='account_balance',
+            user=user,
+            notes='Оплата из кошелька клиента'
+        )
+
+        return usable_amount
+
+    @staticmethod
+    @transaction.atomic
+    def refund_wallet_payment(order, amount, user):
+        """
+        Возврат средств в кошелёк.
+
+        Args:
+            order: Заказ
+            amount: Сумма возврата
+            user: Пользователь
+
+        Returns:
+            Decimal: Возвращённая сумма
+        """
+        from orders.services.transaction_service import TransactionService
+
+        amount = _quantize(amount)
+        if amount <= 0:
+            return None
+
+        # Создаём транзакцию возврата
+        # Transaction.save() вызовет create_wallet_deposit()
+        TransactionService.create_refund(
+            order=order,
+            amount=amount,
+            payment_method='account_balance',
+            user=user,
+            reason='Возврат в кошелёк'
+        )
+
+        return amount
+
+    @staticmethod
+    @transaction.atomic
+    def adjust_balance(customer_id, amount, description, user):
+        """
+        Корректировка баланса (обёртка для обратной совместимости).
+
+        Args:
+            customer_id: ID клиента
+            amount: Сумма (может быть отрицательной)
+            description: Описание
+            user: Пользователь
+
+        Returns:
+            WalletTransaction
+        """
+        return WalletService.create_adjustment(
+            customer=customer_id,
+            amount=amount,
+            description=description,
+            user=user
+        )
+
+    # ========== МЕТОДЫ ДЛЯ ВЫЗОВА ИЗ Transaction.save() ==========
+
+    @staticmethod
+    @transaction.atomic
+    def create_wallet_spend(order, amount, user):
+        """
+        Списание из кошелька при оплате заказа.
+        Вызывается из Transaction.save() при payment.
+
+        Args:
+            order: Заказ
+            amount: Сумма списания
+            user: Пользователь
+
+        Returns:
+            WalletTransaction
+        """
+        return WalletService.create_transaction(
+            customer=order.customer,
+            amount=amount,
+            transaction_type='spend',
+            order=order,
+            description=f'Оплата по заказу #{order.order_number}',
+            user=user
+        )
+
+    @staticmethod
+    @transaction.atomic
+    def create_wallet_deposit(order, amount, user):
+        """
+        Пополнение кошелька при возврате.
+        Вызывается из Transaction.save() при refund.
+
+        Args:
+            order: Заказ
+            amount: Сумма возврата
+            user: Пользователь
+
+        Returns:
+            WalletTransaction
+        """
+        return WalletService.create_transaction(
+            customer=order.customer,
+            amount=amount,
+            transaction_type='deposit',
+            order=order,
+            description=f'Возврат по заказу #{order.order_number}',
+            user=user
+        )
+
+    # ========== МЕТОДЫ ДЛЯ БУДУЩЕЙ БОНУСНОЙ СИСТЕМЫ ==========
+
+    # @staticmethod
+    # @transaction.atomic
+    # def accrue_bonus(customer, amount, reason, user=None, order=None):
+    #     """Начислить бонусные баллы."""
+    #     return WalletService.create_transaction(
+    #         customer=customer,
+    #         amount=amount,
+    #         transaction_type='bonus_accrual',
+    #         category='bonus',
+    #         order=order,
+    #         description=reason,
+    #         user=user
+    #     )
+
+    # @staticmethod
+    # @transaction.atomic
+    # def spend_bonus(customer, amount, order, user):
+    #     """Списать бонусы за оплату."""
+    #     return WalletService.create_transaction(
+    #         customer=customer,
+    #         amount=amount,
+    #         transaction_type='bonus_spend',
+    #         category='bonus',
+    #         order=order,
+    #         description=f'Оплата бонусами по заказу #{order.order_number}',
+    #         user=user
+    #     )

myproject/customers/tasks.py

@@ -0,0 +1,44 @@
+import os
+import re
+from datetime import datetime, timedelta
+from celery import shared_task
+from django.conf import settings
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+@shared_task
+def delete_old_import_error_files():
+    """
+    Удаляет файлы с ошибками импорта, которые не были скачаны пользователем в течение 24 часов.
+    """
+    temp_imports_dir = os.path.join(settings.MEDIA_ROOT, 'temp_imports')
+    if not os.path.exists(temp_imports_dir):
+        logger.info(f"Директория {temp_imports_dir} не существует. Задача завершена.")
+        return
+
+    current_time = datetime.now()
+    files_deleted = 0
+
+    for filename in os.listdir(temp_imports_dir):
+        file_path = os.path.join(temp_imports_dir, filename)
+        if os.path.isfile(file_path):
+            # Извлекаем дату и время из имени файла
+            match = re.search(r'customer_import_errors_(\d{8})_(\d{6})\.xlsx', filename)
+            if match:
+                file_date_str = match.group(1)
+                file_time_str = match.group(2)
+                file_datetime = datetime.strptime(f"{file_date_str} {file_time_str}", "%Y%m%d %H%M%S")
+
+                # Проверяем, прошло ли 24 часа с момента создания файла
+                if current_time - file_datetime > timedelta(hours=24):
+                    try:
+                        os.remove(file_path)
+                        files_deleted += 1
+                        logger.info(f"Удален файл: {file_path}")
+                    except Exception as e:
+                        logger.error(f"Ошибка при удалении файла {file_path}: {e}")
+
+    logger.info(f"Удалено {files_deleted} устаревших файлов.")
+    return files_deleted

myproject/customers/templates/customers/customer_detail.html

@@ -6,12 +6,15 @@
 <div class="container-fluid">
     <div class="row">
         <div class="col-12">
-            <div class="d-flex justify-content-between align-items-center mb-3">
-                <h1>Клиент: {{ customer.full_name }}</h1>
+            <div class="d-flex justify-content-between align-items-center mb-4">
+                <h2 class="mb-0"><i class="bi bi-person-badge text-primary"></i> <span id="customer-title">{{ customer.full_name }}</span></h2>
                 <div>
-                    <a href="{% url 'customers:customer-update' customer.pk %}" class="btn btn-primary">Редактировать</a>
-                    <a href="{% url 'customers:customer-delete' customer.pk %}" class="btn btn-danger">Удалить</a>
-                    <a href="{% url 'customers:customer-list' %}" class="btn btn-secondary">Назад к списку</a>
+                    <a href="{% url 'customers:customer-delete' customer.pk %}" class="btn btn-outline-danger">
+                        <i class="bi bi-trash"></i> Удалить
+                    </a>
+                    <a href="{% url 'customers:customer-list' %}" class="btn btn-outline-secondary">
+                        <i class="bi bi-arrow-left"></i> Назад к списку
+                    </a>
                 </div>
             </div>
         </div>
@@ -19,230 +22,290 @@
 
     <div class="row">
         <!-- Customer Info -->
-        <div class="col-md-12">
-            <div class="card mb-4">
-                <div class="card-header">
-                    <h5>Информация о клиенте</h5>
+        <div class="col-md-6">
+            <div class="card mb-4 shadow-sm">
+                <div class="card-header bg-light">
+                    <h5 class="mb-0"><i class="bi bi-person-circle text-primary"></i> Информация о клиенте</h5>
                 </div>
                 <div class="card-body">
-                    <table class="table table-borderless">
-                        <tr>
-                            <th>Имя:</th>
-                            <td>{{ customer.full_name }}</td>
-                        </tr>
-                        <tr>
-                            <th>Email:</th>
-                            <td>{{ customer.email|default:"Не указано" }}</td>
-                        </tr>
-                        <tr>
-                            <th>Телефон:</th>
-                            <td>{{ customer.phone|default:"Не указано" }}</td>
-                        </tr>
-                        <tr>
-                            <th>Сумма покупок:</th>
-                            <td>{{ customer.total_spent|floatformat:2 }} руб.</td>
-                        </tr>
-                        <tr>
-                            <th>Баланс кошелька:</th>
+                    <table class="table table-borderless mb-0" id="customer-info-table" data-customer-id="{{ customer.pk }}">
+                        <colgroup>
+                            <col style="width: 40%;">
+                            <col style="width: 50%;">
+                            <col style="width: 10%;">
+                        </colgroup>
+                        <tbody>
+                        <!-- Основная информация -->
+                        <tr data-field="name">
+                            <td class="text-muted"><i class="bi bi-person-fill text-primary"></i> Имя:</td>
                             <td>
-                                {% if customer.wallet_balance > 0 %}
-                                    <span class="badge bg-success" style="font-size: 1.1em;">{{ customer.wallet_balance|floatformat:2 }} руб.</span>
-                                {% elif customer.wallet_balance == 0 %}
-                                    <span class="badge bg-secondary">{{ customer.wallet_balance|floatformat:2 }} руб.</span>
-                                {% else %}
-                                    <span class="badge bg-danger">{{ customer.wallet_balance|floatformat:2 }} руб.</span>
-                                {% endif %}
+                                <span class="field-value fw-bold">{{ customer.name|default:"—" }}</span>
+                                <input type="text" class="field-input form-control form-control-sm d-none" value="{{ customer.name|default:'' }}">
+                                <div class="field-actions d-inline-block ms-2 d-none">
+                                    <button class="btn btn-sm btn-success save-btn py-0 px-1" title="Сохранить"><i class="bi bi-check-lg"></i></button>
+                                    <button class="btn btn-sm btn-outline-secondary cancel-btn py-0 px-1" title="Отменить"><i class="bi bi-x-lg"></i></button>
+                                    <span class="save-status ms-1"></span>
+                                </div>
+                            </td>
+                            <td class="text-end">
+                                <div class="d-flex gap-1 justify-content-end">
+                                    <button class="btn btn-sm btn-outline-secondary copy-btn" title="Копировать" data-copy-value="{{ customer.name|default:'' }}">
+                                        <i class="bi bi-copy"></i>
+                                    </button>
+                                    <button class="btn btn-sm btn-outline-primary edit-btn" title="Редактировать">
+                                        <i class="bi bi-pencil"></i>
+                                    </button>
+                                </div>
+                            </td>
+                        </tr>
+                        <tr data-field="phone">
+                            <td class="text-muted"><i class="bi bi-telephone-fill text-success"></i> Телефон:</td>
+                            <td>
+                                <span class="field-value">{{ customer.phone|default:"—" }}</span>
+                                <input type="tel" class="field-input form-control form-control-sm d-none" value="{{ customer.phone|default:'' }}" placeholder="+375...">
+                                <div class="field-actions d-inline-block ms-2 d-none">
+                                    <button class="btn btn-sm btn-success save-btn py-0 px-1" title="Сохранить"><i class="bi bi-check-lg"></i></button>
+                                    <button class="btn btn-sm btn-outline-secondary cancel-btn py-0 px-1" title="Отменить"><i class="bi bi-x-lg"></i></button>
+                                    <span class="save-status ms-1"></span>
+                                </div>
+                            </td>
+                            <td class="text-end">
+                                <div class="d-flex gap-1 justify-content-end">
+                                    <button class="btn btn-sm btn-outline-secondary copy-btn" title="Копировать" data-copy-value="{{ customer.phone|default:'' }}">
+                                        <i class="bi bi-copy"></i>
+                                    </button>
+                                    <button class="btn btn-sm btn-outline-primary edit-btn" title="Редактировать">
+                                        <i class="bi bi-pencil"></i>
+                                    </button>
+                                </div>
+                            </td>
+                        </tr>
+                        <tr data-field="email">
+                            <td class="text-muted"><i class="bi bi-envelope-fill text-info"></i> Email:</td>
+                            <td>
+                                <span class="field-value">{{ customer.email|default:"—" }}</span>
+                                <input type="email" class="field-input form-control form-control-sm d-none" value="{{ customer.email|default:'' }}">
+                                <div class="field-actions d-inline-block ms-2 d-none">
+                                    <button class="btn btn-sm btn-success save-btn py-0 px-1" title="Сохранить"><i class="bi bi-check-lg"></i></button>
+                                    <button class="btn btn-sm btn-outline-secondary cancel-btn py-0 px-1" title="Отменить"><i class="bi bi-x-lg"></i></button>
+                                    <span class="save-status ms-1"></span>
+                                </div>
+                            </td>
+                            <td class="text-end">
+                                <div class="d-flex gap-1 justify-content-end">
+                                    <button class="btn btn-sm btn-outline-secondary copy-btn" title="Копировать" data-copy-value="{{ customer.email|default:'' }}">
+                                        <i class="bi bi-copy"></i>
+                                    </button>
+                                    <button class="btn btn-sm btn-outline-primary edit-btn" title="Редактировать">
+                                        <i class="bi bi-pencil"></i>
+                                    </button>
+                                </div>
+                            </td>
+                        </tr>
+                        <tr data-field="notes">
+                            <td class="text-muted"><i class="bi bi-card-text text-warning"></i> Заметки:</td>
+                            <td>
+                                <span class="field-value" style="white-space: pre-wrap;">{{ customer.notes|default:"—" }}</span>
+                                <textarea class="field-input form-control form-control-sm d-none" rows="2">{{ customer.notes|default:'' }}</textarea>
+                                <div class="field-actions d-inline-block ms-2 d-none">
+                                    <button class="btn btn-sm btn-success save-btn py-0 px-1" title="Сохранить"><i class="bi bi-check-lg"></i></button>
+                                    <button class="btn btn-sm btn-outline-secondary cancel-btn py-0 px-1" title="Отменить"><i class="bi bi-x-lg"></i></button>
+                                    <span class="save-status ms-1"></span>
+                                </div>
+                            </td>
+                            <td class="text-end">
+                                <button class="btn btn-sm btn-outline-primary edit-btn" title="Редактировать">
+                                    <i class="bi bi-pencil"></i>
+                                </button>
+                            </td>
+                        </tr>
+                        
+                        <!-- Разделитель -->
+                        <tr>
+                            <td colspan="3"><hr class="my-2"></td>
+                        </tr>
+                        
+                        <!-- Финансовая информация -->
+                        <tr>
+                            <td class="text-muted"><i class="bi bi-cash-stack text-success"></i> Все успешные заказы:</td>
+                            <td colspan="2">
+                                <span class="badge bg-success">{{ total_orders_sum|floatformat:2 }} руб.</span>
                             </td>
                         </tr>
                         <tr>
-                            <th>Общий долг по активным заказам:</th>
-                            <td>
-                                {% if total_debt > 0 %}
-                                    <span class="text-danger fw-bold">{{ total_debt|floatformat:2 }} руб.</span>
-                                    <small class="text-muted">(Кол-во заказов: {{ active_orders_count }})</small>
-                                {% else %}
-                                    <span class="text-success">0.00 руб.</span>
-                                {% endif %}
+                            <td class="text-muted"><i class="bi bi-calendar-check text-info"></i> За последний год:</td>
+                            <td colspan="2">
+                                <span class="badge bg-info">{{ last_year_orders_sum|floatformat:2 }} руб.</span>
                             </td>
                         </tr>
+                        {% if total_debt > 0 %}
                         <tr>
-                            <th>Заметки:</th>
-                            <td>{{ customer.notes|default:"Нет" }}</td>
+                            <td class="text-muted"><i class="bi bi-exclamation-triangle-fill text-danger"></i> Общий долг:</td>
+                            <td colspan="2">
+                                <span class="badge bg-danger">{{ total_debt|floatformat:2 }} руб.</span>
+                                <small class="text-muted ms-2">(Заказов: {{ active_orders_count }})</small>
+                            </td>
+                        </tr>
+                        {% endif %}
+                        
+                        <!-- Разделитель -->
+                        <tr>
+                            <td colspan="3"><hr class="my-2"></td>
+                        </tr>
+                        
+                        <!-- Системная информация -->
+                        <tr>
+                            <td class="text-muted small"><i class="bi bi-clock-history"></i> Дата создания:</td>
+                            <td colspan="2" class="small">{{ customer.created_at|date:"d.m.Y H:i" }}</td>
                         </tr>
                         <tr>
-                            <th>Дата создания:</th>
-                            <td>{{ customer.created_at|date:"d.m.Y H:i" }}</td>
-                        </tr>
-                        <tr>
-                            <th>Дата обновления:</th>
-                            <td>{{ customer.updated_at|date:"d.m.Y H:i" }}</td>
+                            <td class="text-muted small"><i class="bi bi-arrow-clockwise"></i> Последнее изменение:</td>
+                            <td colspan="2" class="small"><span id="updated-at">{{ customer.updated_at|date:"d.m.Y H:i" }}</span></td>
                         </tr>
+                        </tbody>
                     </table>
                 </div>
             </div>
         </div>
 
-        <!-- История транзакций кошелька -->
-        <div class="col-md-12">
-            <div class="card mb-4">
-                <div class="card-header d-flex justify-content-between align-items-center">
-                    <h5>История кошелька (последние 20)</h5>
-                    <span class="badge bg-primary">{{ wallet_transactions|length }}</span>
+        <!-- Правая колонка: Каналы связи + История заказов + История кошелька -->
+        <div class="col-md-6">
+            <!-- Каналы связи -->
+            <div class="card mb-4 shadow-sm">
+                <div class="card-header bg-light d-flex justify-content-between align-items-center">
+                    <h5 class="mb-0"><i class="bi bi-chat-dots text-success"></i> Каналы связи</h5>
+                    <button class="btn btn-sm btn-success" data-bs-toggle="modal" data-bs-target="#addChannelModal">
+                        <i class="bi bi-plus-circle"></i> Добавить
+                    </button>
                 </div>
                 <div class="card-body">
-                    {% if wallet_transactions %}
-                        <div class="table-responsive">
-                            <table class="table table-striped table-hover">
-                                <thead>
-                                    <tr>
-                                        <th>Дата</th>
-                                        <th>Тип</th>
-                                        <th>Сумма</th>
-                                        <th>Описание</th>
-                                        <th>Заказ</th>
-                                        <th>Создал</th>
-                                    </tr>
-                                </thead>
-                                <tbody>
-                                    {% for transaction in wallet_transactions %}
-                                    <tr>
-                                        <td><small>{{ transaction.created_at|date:"d.m.Y H:i" }}</small></td>
-                                        <td>
-                                            {% if transaction.transaction_type == 'deposit' %}
-                                                <span class="badge bg-success">Пополнение</span>
-                                            {% elif transaction.transaction_type == 'spend' %}
-                                                <span class="badge bg-danger">Списание</span>
-                                            {% else %}
-                                                <span class="badge bg-warning">Корректировка</span>
-                                            {% endif %}
-                                        </td>
-                                        <td>
-                                            {% if transaction.transaction_type == 'deposit' or transaction.transaction_type == 'adjustment' and transaction.amount > 0 %}
-                                                <span class="text-success fw-bold">+{{ transaction.amount|floatformat:2 }} руб.</span>
-                                            {% else %}
-                                                <span class="text-danger fw-bold">-{{ transaction.amount|floatformat:2 }} руб.</span>
-                                            {% endif %}
-                                        </td>
-                                        <td>{{ transaction.description|default:"-" }}</td>
-                                        <td>
-                                            {% if transaction.order %}
-                                                <a href="{% url 'orders:order-detail' transaction.order.order_number %}" class="btn btn-sm btn-outline-primary">
-                                                    #{{ transaction.order.order_number }}
-                                                </a>
-                                            {% else %}
-                                                -
-                                            {% endif %}
-                                        </td>
-                                        <td><small>{{ transaction.created_by.username|default:"-" }}</small></td>
-                                    </tr>
-                                    {% endfor %}
-                                </tbody>
-                            </table>
-                        </div>
+                    {% if contact_channels %}
+                    <ul class="list-group list-group-flush">
+                        {% for channel in contact_channels %}
+                        <li class="list-group-item d-flex justify-content-between align-items-center">
+                            <div>
+                                {% if channel.channel_type == 'telegram' %}
+                                    <span class="badge bg-info me-2"><i class="bi bi-telegram"></i> Telegram</span>
+                                {% elif channel.channel_type == 'instagram' %}
+                                    <span class="badge bg-danger me-2"><i class="bi bi-instagram"></i> Instagram</span>
+                                {% elif channel.channel_type == 'whatsapp' %}
+                                    <span class="badge bg-success me-2"><i class="bi bi-whatsapp"></i> WhatsApp</span>
+                                {% elif channel.channel_type == 'viber' %}
+                                    <span class="badge bg-purple me-2" style="background-color: #7360f2 !important;"><i class="bi bi-chat-fill"></i> Viber</span>
+                                {% elif channel.channel_type == 'vk' %}
+                                    <span class="badge bg-primary me-2">VK</span>
+                                {% elif channel.channel_type == 'facebook' %}
+                                    <span class="badge bg-primary me-2"><i class="bi bi-facebook"></i> Facebook</span>
+                                {% elif channel.channel_type == 'phone' %}
+                                    <span class="badge bg-secondary me-2"><i class="bi bi-telephone"></i> Телефон</span>
+                                {% elif channel.channel_type == 'email' %}
+                                    <span class="badge bg-secondary me-2"><i class="bi bi-envelope"></i> Email</span>
+                                {% else %}
+                                    <span class="badge bg-dark me-2">{{ channel.get_channel_type_display }}</span>
+                                {% endif %}
+                                <strong>{{ channel.value }}</strong>
+                                {% if channel.is_primary %}<span class="badge bg-warning text-dark ms-1">основной</span>{% endif %}
+                                {% if channel.notes %}<small class="text-muted d-block mt-1">{{ channel.notes }}</small>{% endif %}
+                            </div>
+                            <div class="d-flex gap-1">
+                                <button class="btn btn-sm btn-outline-secondary copy-btn" title="Копировать" data-copy-value="{{ channel.value }}">
+                                    <i class="bi bi-copy"></i>
+                                </button>
+                                <form method="post" action="{% url 'customers:delete-contact-channel' channel.pk %}" class="d-inline">
+                                    {% csrf_token %}
+                                    <button type="submit" class="btn btn-sm btn-outline-danger" onclick="return confirm('Удалить канал?')">
+                                        <i class="bi bi-trash"></i>
+                                    </button>
+                                </form>
+                            </div>
+                        </li>
+                        {% endfor %}
+                    </ul>
                     {% else %}
-                        <p class="text-muted mb-0">История транзакций пуста.</p>
+                    <p class="text-muted mb-0">Нет дополнительных каналов связи. Добавьте Instagram, Telegram и другие контакты.</p>
                     {% endif %}
                 </div>
             </div>
-        </div>
 
-        <!-- История заказов -->
-        <div class="col-md-12">
-            <div class="card mb-4">
-                <div class="card-header d-flex justify-content-between align-items-center">
-                    <h5>История заказов</h5>
-                    <div>
+            <!-- История заказов -->
+            <div class="card mb-4 shadow-sm">
+                <div class="card-header bg-light d-flex justify-content-between align-items-center">
+                    <button class="btn btn-link text-start text-decoration-none p-0 d-flex align-items-center flex-grow-1" 
+                            type="button" 
+                            data-bs-toggle="collapse" 
+                            data-bs-target="#ordersHistoryCollapse" 
+                            aria-expanded="false" 
+                            aria-controls="ordersHistoryCollapse"
+                            style="border: none; background: none;">
+                        <h5 class="mb-0 me-2"><i class="bi bi-cart-check text-primary"></i> История заказов</h5>
                         <span class="badge bg-primary">{{ orders_page.paginator.count }}</span>
-                        <a href="{% url 'orders:order-create' %}?customer={{ customer.pk }}" class="btn btn-sm btn-success ms-2">
-                            <i class="bi bi-plus-circle"></i> Новый заказ
-                        </a>
-                    </div>
+                    </button>
+                    <a href="{% url 'orders:order-create' %}?customer={{ customer.pk }}" 
+                       class="btn btn-sm btn-success ms-2">
+                        <i class="bi bi-plus-circle"></i> Новый
+                    </a>
                 </div>
-                <div class="card-body">
+                <div class="collapse" id="ordersHistoryCollapse">
+                    <div class="card-body p-0">
                     {% if orders_page %}
                         <div class="table-responsive">
-                            <table class="table table-striped table-hover">
-                                <thead>
+                            <table class="table table-sm table-hover mb-0">
+                                <thead class="table-light">
                                     <tr>
                                         <th>№</th>
-                                        <th>Дата создания</th>
-                                        <th>Дата доставки</th>
+                                        <th>Дата</th>
                                         <th>Статус</th>
-                                        <th>Оплата</th>
                                         <th>Сумма</th>
-                                        <th>Оплачено</th>
                                         <th>Остаток</th>
-                                        <th>Действия</th>
+                                        <th></th>
                                     </tr>
                                 </thead>
                                 <tbody>
                                     {% for order in orders_page %}
-                                    <tr>
+                                    <tr {% if order.status and order.status.is_negative_end and order.amount_paid > 0 %}class="table-warning"{% endif %}>
                                         <td><strong>#{{ order.order_number }}</strong></td>
-                                        <td><small>{{ order.created_at|date:"d.m.Y H:i" }}</small></td>
+                                        <td><small>{{ order.created_at|date:"d.m.y" }}</small></td>
                                         <td>
-                                            {% if order.delivery_date %}
-                                                <strong>{{ order.delivery_date|date:"d.m.Y" }}</strong>
-                                                {% if order.delivery_time %}
-                                                    <br><small class="text-muted">{{ order.delivery_time }}</small>
-                                                {% endif %}
-                                                {% if order.is_delivery %}
-                                                    <br><span class="badge bg-info">Доставка</span>
+                                            {% if order.status %}
+                                                {% if order.status.code == 'draft' %}
+                                                    <span class="badge bg-secondary">Черновик</span>
+                                                {% elif order.status.code == 'pending' %}
+                                                    <span class="badge bg-warning">Ожидает</span>
+                                                {% elif order.status.code == 'in_production' %}
+                                                    <span class="badge bg-info">В пр-ве</span>
+                                                {% elif order.status.code == 'ready' %}
+                                                    <span class="badge bg-primary">Готов</span>
+                                                {% elif order.status.code == 'delivered' %}
+                                                    <span class="badge bg-success">Доставлен</span>
+                                                {% elif order.status.code == 'cancelled' %}
+                                                    <span class="badge bg-danger">Отменён</span>
                                                 {% else %}
-                                                    <br><span class="badge bg-secondary">Самовывоз</span>
+                                                    <span class="badge bg-secondary">{{ order.status.name }}</span>
                                                 {% endif %}
                                             {% else %}
-                                                <span class="text-muted">Не указана</span>
+                                                <span class="badge bg-secondary">-</span>
                                             {% endif %}
                                         </td>
+                                        <td><strong>{{ order.total_amount|floatformat:2 }}</strong></td>
                                         <td>
-                                            {% if order.status == 'draft' %}
-                                                <span class="badge bg-secondary">Черновик</span>
-                                            {% elif order.status == 'pending' %}
-                                                <span class="badge bg-warning">Ожидает</span>
-                                            {% elif order.status == 'in_production' %}
-                                                <span class="badge bg-info">В производстве</span>
-                                            {% elif order.status == 'ready' %}
-                                                <span class="badge bg-primary">Готов</span>
-                                            {% elif order.status == 'delivered' %}
-                                                <span class="badge bg-success">Доставлен</span>
-                                            {% elif order.status == 'cancelled' %}
-                                                <span class="badge bg-danger">Отменён</span>
+                                            {% if order.status and order.status.is_negative_end %}
+                                                {% if order.amount_paid > 0 %}
+                                                    <span class="badge bg-warning text-dark">
+                                                        <i class="bi bi-exclamation-triangle"></i> {{ order.amount_paid|floatformat:2 }}
+                                                    </span>
+                                                {% else %}
+                                                    <span class="text-muted">—</span>
+                                                {% endif %}
+                                            {% elif order.amount_due > 0 %}
+                                                <span class="text-danger fw-bold">{{ order.amount_due|floatformat:2 }}</span>
                                             {% else %}
-                                                <span class="badge bg-secondary">{{ order.get_status_display }}</span>
+                                                <span class="text-success">0.00</span>
                                             {% endif %}
                                         </td>
-                                        <td>
-                                            {% if order.payment_status == 'paid' %}
-                                                <span class="badge bg-success">Оплачено</span>
-                                            {% elif order.payment_status == 'partial' %}
-                                                <span class="badge bg-warning">Частично</span>
-                                            {% else %}
-                                                <span class="badge bg-danger">Не оплачено</span>
-                                            {% endif %}
-                                        </td>
-                                        <td><strong>{{ order.total_amount|floatformat:2 }} руб.</strong></td>
-                                        <td>
-                                            {% if order.amount_paid > 0 %}
-                                                <span class="text-success">{{ order.amount_paid|floatformat:2 }} руб.</span>
-                                            {% else %}
-                                                <span class="text-muted">0.00 руб.</span>
-                                            {% endif %}
-                                        </td>
-                                        <td>
-                                            {% if order.amount_due > 0 %}
-                                                <span class="text-danger fw-bold">{{ order.amount_due|floatformat:2 }} руб.</span>
-                                            {% else %}
-                                                <span class="text-success">0.00 руб.</span>
-                                            {% endif %}
-                                        </td>
-                                        <td>
-                                            <a href="{% url 'orders:order-detail' order.order_number %}" class="btn btn-sm btn-outline-primary">
+                                        <td class="text-end">
+                                            <a href="{% url 'orders:order-detail' order.order_number %}" class="btn btn-sm btn-outline-primary" target="_blank" rel="noopener noreferrer" title="Открыть в новой вкладке">
                                                 <i class="bi bi-eye"></i>
                                             </a>
-                                            <a href="{% url 'orders:order-update' order.order_number %}" class="btn btn-sm btn-outline-secondary">
-                                                <i class="bi bi-pencil"></i>
-                                            </a>
                                         </td>
                                     </tr>
                                     {% endfor %}
@@ -252,40 +315,447 @@
 
                         <!-- Пагинация -->
                         {% if orders_page.has_other_pages %}
-                        <nav aria-label="Навигация по заказам">
-                            <ul class="pagination justify-content-center mt-3">
-                                {% if orders_page.has_previous %}
-                                    <li class="page-item">
-                                        <a class="page-link" href="?page=1">Первая</a>
-                                    </li>
-                                    <li class="page-item">
-                                        <a class="page-link" href="?page={{ orders_page.previous_page_number }}">Предыдущая</a>
-                                    </li>
-                                {% endif %}
+                        <div class="p-3 bg-light border-top">
+                            <nav aria-label="Навигация по заказам">
+                                <ul class="pagination pagination-sm justify-content-center mb-0">
+                                    {% if orders_page.has_previous %}
+                                        <li class="page-item">
+                                            <a class="page-link" href="?page={{ orders_page.previous_page_number }}#ordersHistoryCollapse">«</a>
+                                        </li>
+                                    {% endif %}
 
-                                <li class="page-item active">
-                                    <span class="page-link">
-                                        Страница {{ orders_page.number }} из {{ orders_page.paginator.num_pages }}
-                                    </span>
-                                </li>
+                                    <li class="page-item active">
+                                        <span class="page-link">
+                                            {{ orders_page.number }} / {{ orders_page.paginator.num_pages }}
+                                        </span>
+                                    </li>
 
-                                {% if orders_page.has_next %}
-                                    <li class="page-item">
-                                        <a class="page-link" href="?page={{ orders_page.next_page_number }}">Следующая</a>
-                                    </li>
-                                    <li class="page-item">
-                                        <a class="page-link" href="?page={{ orders_page.paginator.num_pages }}">Последняя</a>
-                                    </li>
-                                {% endif %}
-                            </ul>
-                        </nav>
+                                    {% if orders_page.has_next %}
+                                        <li class="page-item">
+                                            <a class="page-link" href="?page={{ orders_page.next_page_number }}#ordersHistoryCollapse">»</a>
+                                        </li>
+                                    {% endif %}
+                                </ul>
+                            </nav>
+                        </div>
                         {% endif %}
                     {% else %}
-                        <p class="text-muted mb-0">У клиента пока нет заказов.</p>
+                        <p class="text-muted mb-0 p-3">У клиента пока нет заказов.</p>
                     {% endif %}
+                    </div>
+                </div>
+            </div>
+
+            <!-- История транзакций кошелька -->
+            <div class="card mb-4 shadow-sm">
+                <div class="card-header bg-light">
+                    <button class="btn btn-link w-100 text-start text-decoration-none p-0 d-flex justify-content-between align-items-center" 
+                            type="button" 
+                            data-bs-toggle="collapse" 
+                            data-bs-target="#walletHistoryCollapse" 
+                            aria-expanded="false" 
+                            aria-controls="walletHistoryCollapse">
+                        <div class="d-flex align-items-center">
+                            <h5 class="mb-0 me-2"><i class="bi bi-clock-history text-info"></i> История кошелька</h5>
+                            <span class="badge bg-primary">{{ wallet_transactions|length }}</span>
+                        </div>
+                        <i class="bi bi-chevron-down"></i>
+                    </button>
+                </div>
+                <div class="collapse" id="walletHistoryCollapse">
+                    <div class="card-body p-0">
+                    {% if wallet_transactions %}
+                        <div class="table-responsive">
+                            <table class="table table-sm table-hover mb-0">
+                                <thead class="table-light">
+                                    <tr>
+                                        <th>Дата</th>
+                                        <th>Тип</th>
+                                        <th>Сумма</th>
+                                        <th>Описание</th>
+                                        <th>Заказ</th>
+                                    </tr>
+                                </thead>
+                                <tbody>
+                                    {% for transaction in wallet_transactions %}
+                                    <tr>
+                                        <td><small>{{ transaction.created_at|date:"d.m.y H:i" }}</small></td>
+                                        <td>
+                                            {% if transaction.transaction_type == 'deposit' %}
+                                                <span class="badge bg-success">Пополн.</span>
+                                            {% elif transaction.transaction_type == 'spend' %}
+                                                <span class="badge bg-danger">Списан.</span>
+                                            {% else %}
+                                                <span class="badge bg-warning">Корр.</span>
+                                            {% endif %}
+                                        </td>
+                                        <td>
+                                            {% if transaction.transaction_type == 'deposit' or transaction.transaction_type == 'adjustment' and transaction.amount > 0 %}
+                                                <span class="text-success fw-bold">+{{ transaction.amount|floatformat:2 }}</span>
+                                            {% else %}
+                                                <span class="text-danger fw-bold">-{{ transaction.amount|floatformat:2 }}</span>
+                                            {% endif %}
+                                        </td>
+                                        <td><small>{{ transaction.description|default:"-"|truncatewords:5 }}</small></td>
+                                        <td>
+                                            {% if transaction.order %}
+                                                <a href="{% url 'orders:order-detail' transaction.order.order_number %}" class="btn btn-sm btn-outline-primary py-0">
+                                                    #{{ transaction.order.order_number }}
+                                                </a>
+                                            {% else %}
+                                                -
+                                            {% endif %}
+                                        </td>
+                                    </tr>
+                                    {% endfor %}
+                                </tbody>
+                            </table>
+                        </div>
+                    {% else %}
+                        <p class="text-muted mb-0 p-3">История транзакций пуста.</p>
+                    {% endif %}
+                    </div>
+                </div>
+            </div>
+
+            <!-- Операции с кошельком -->
+            <div class="card mb-4 shadow-sm">
+                <div class="card-header bg-light d-flex justify-content-between align-items-center">
+                    <h5 class="mb-0"><i class="bi bi-wallet2 text-warning"></i> Операции с кошельком клиента</h5>
+                    <span>
+                        {% if customer.wallet_balance > 0 %}
+                            <span class="badge bg-success" style="font-size: 1.1em;">{{ customer.wallet_balance|floatformat:2 }} руб.</span>
+                        {% elif customer.wallet_balance == 0 %}
+                            <span class="badge bg-secondary" style="font-size: 1.1em;">{{ customer.wallet_balance|floatformat:2 }} руб.</span>
+                        {% else %}
+                            <span class="badge bg-danger" style="font-size: 1.1em;">{{ customer.wallet_balance|floatformat:2 }} руб.</span>
+                        {% endif %}
+                    </span>
+                </div>
+                <div class="card-body">
+                    <div class="row">
+                        <!-- Пополнение -->
+                        <div class="col-md-6">
+                            <h6 class="text-success mb-3"><i class="bi bi-plus-circle"></i> Пополнение</h6>
+                            <form method="post" action="{% url 'customers:wallet-deposit' customer.pk %}">
+                                {% csrf_token %}
+                                <div class="mb-3">
+                                    <label for="wallet_deposit_amount" class="form-label">Сумма, руб.</label>
+                                    <input type="number"
+                                           step="0.01"
+                                           min="0.01"
+                                           class="form-control"
+                                           id="wallet_deposit_amount"
+                                           name="amount"
+                                           placeholder="0.00"
+                                           required>
+                                    <div style="height: 1.25rem;"></div>
+                                </div>
+                                <div class="mb-3">
+                                    <label for="wallet_deposit_description" class="form-label">Описание</label>
+                                    <textarea class="form-control"
+                                              id="wallet_deposit_description"
+                                              name="description"
+                                              rows="2"
+                                              placeholder="Подарок, компенсация..."
+                                              required></textarea>
+                                </div>
+                                <button type="submit" class="btn btn-success w-100"><i class="bi bi-plus-circle"></i> Пополнить</button>
+                            </form>
+                        </div>
+
+                        <!-- Возврат / списание -->
+                        <div class="col-md-6">
+                            <h6 class="text-danger mb-3"><i class="bi bi-dash-circle"></i> Списание</h6>
+                            <form method="post" action="{% url 'customers:wallet-withdraw' customer.pk %}">
+                                {% csrf_token %}
+                                <div class="mb-3">
+                                    <label for="wallet_withdraw_amount" class="form-label">Сумма, руб.</label>
+                                    <input type="number"
+                                           step="0.01"
+                                           min="0.01"
+                                           max="{{ customer.wallet_balance }}"
+                                           class="form-control"
+                                           id="wallet_withdraw_amount"
+                                           name="amount"
+                                           placeholder="0.00"
+                                           required>
+                                    <small class="text-muted d-block" style="height: 1.25rem; line-height: 1.25rem;">Макс: {{ customer.wallet_balance|floatformat:2 }} р.</small>
+                                </div>
+                                <div class="mb-3">
+                                    <label for="wallet_withdraw_description" class="form-label">Описание</label>
+                                    <textarea class="form-control"
+                                              id="wallet_withdraw_description"
+                                              name="description"
+                                              rows="2"
+                                              placeholder="Возврат наличными..."
+                                              required></textarea>
+                                </div>
+                                <button type="submit" class="btn btn-danger w-100"><i class="bi bi-dash-circle"></i> Списать</button>
+                            </form>
+                        </div>
+                    </div>
+                    <div class="alert alert-info mb-0 mt-3">
+                        <i class="bi bi-info-circle"></i> Все операции логируются в истории выше.
+                    </div>
                 </div>
             </div>
         </div>
+        <!-- Конец правой колонки -->
+
+        <!-- Алерт о необходимости возврата -->
+        {% if refund_amount > 0 %}
+        <div class="col-md-12">
+            <div class="alert alert-warning shadow-sm d-flex justify-content-between align-items-center mb-4" role="alert">
+                <div>
+                    <h5 class="alert-heading mb-2">
+                        <i class="bi bi-exclamation-triangle-fill"></i> Требуется возврат средств
+                    </h5>
+                    <p class="mb-0">
+                        Клиент имеет отменённые заказы с внесённой оплатой.
+                        Общая сумма к возврату: <strong>{{ refund_amount|floatformat:2 }} руб.</strong>
+                    </p>
+                </div>
+                <div>
+                    <span class="badge bg-warning text-dark" style="font-size: 1.3em;">
+                        <i class="bi bi-exclamation-circle"></i> {{ refund_amount|floatformat:2 }} руб.
+                    </span>
+                </div>
+            </div>
+        </div>
+        {% endif %}
     </div>
 </div>
+
+<!-- Модальное окно добавления канала связи -->
+<div class="modal fade" id="addChannelModal" tabindex="-1" aria-labelledby="addChannelModalLabel" aria-hidden="true">
+    <div class="modal-dialog">
+        <div class="modal-content">
+            <form method="post" action="{% url 'customers:add-contact-channel' customer.pk %}">
+                {% csrf_token %}
+                <div class="modal-header">
+                    <h5 class="modal-title" id="addChannelModalLabel">Добавить канал связи</h5>
+                    <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Закрыть"></button>
+                </div>
+                <div class="modal-body">
+                    <div class="mb-3">
+                        <label for="channel_type" class="form-label">Тип канала</label>
+                        <select name="channel_type" id="channel_type" class="form-select" required>
+                            <option value="telegram">Telegram</option>
+                            <option value="instagram">Instagram</option>
+                            <option value="whatsapp">WhatsApp</option>
+                            <option value="viber">Viber</option>
+                            <option value="vk">ВКонтакте</option>
+                            <option value="facebook">Facebook</option>
+                            <option value="phone">Телефон</option>
+                            <option value="email">Email</option>
+                            <option value="other">Другое</option>
+                        </select>
+                    </div>
+                    <div class="mb-3">
+                        <label for="channel_value" class="form-label">Значение</label>
+                        <input type="text" name="value" id="channel_value" class="form-control" placeholder="@username, номер, ссылка..." required>
+                        <small class="text-muted">Например: @flower_lover, +375291234567, flower.shop</small>
+                    </div>
+                    <div class="mb-3">
+                        <label for="channel_notes" class="form-label">Примечание <span class="text-muted">(необязательно)</span></label>
+                        <input type="text" name="notes" id="channel_notes" class="form-control" placeholder="Личный аккаунт, рабочий...">
+                    </div>
+                    <div class="form-check">
+                        <input type="checkbox" name="is_primary" class="form-check-input" id="isPrimary" value="true">
+                        <label class="form-check-label" for="isPrimary">Основной канал связи</label>
+                    </div>
+                </div>
+                <div class="modal-footer">
+                    <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Отмена</button>
+                    <button type="submit" class="btn btn-success"><i class="bi bi-plus"></i> Добавить</button>
+                </div>
+            </form>
+        </div>
+    </div>
+</div>
+
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+    // Автооткрытие collapse при наличии якоря в URL
+    const hash = window.location.hash;
+    if (hash === '#ordersHistoryCollapse') {
+        const collapseElement = document.getElementById('ordersHistoryCollapse');
+        if (collapseElement) {
+            const bsCollapse = new bootstrap.Collapse(collapseElement, {
+                show: true
+            });
+            collapseElement.addEventListener('shown.bs.collapse', function() {
+                collapseElement.scrollIntoView({ behavior: 'smooth', block: 'start' });
+            }, { once: true });
+        }
+    }
+
+    // ========== INLINE EDITING ==========
+    const table = document.getElementById('customer-info-table');
+    if (!table) return;
+
+    const customerId = table.dataset.customerId;
+    const updateUrl = `/customers/${customerId}/api/update/`;
+
+    // Находим все редактируемые строки
+    const editableRows = table.querySelectorAll('tr[data-field]');
+
+    editableRows.forEach(row => {
+        const field = row.dataset.field;
+        const fieldValue = row.querySelector('.field-value');
+        const fieldInput = row.querySelector('.field-input');
+        const fieldActions = row.querySelector('.field-actions');
+        const editBtn = row.querySelector('.edit-btn');
+        const saveBtn = row.querySelector('.save-btn');
+        const cancelBtn = row.querySelector('.cancel-btn');
+        const saveStatus = row.querySelector('.save-status');
+
+        let originalValue = '';
+
+        // Клик на карандаш — начать редактирование
+        editBtn.addEventListener('click', function() {
+            originalValue = fieldInput.value;
+            fieldValue.classList.add('d-none');
+            fieldInput.classList.remove('d-none');
+            fieldActions.classList.remove('d-none');
+            editBtn.style.visibility = 'hidden'; // Скрываем карандаш но сохраняем место
+            fieldInput.focus();
+            if (fieldInput.tagName === 'INPUT') {
+                fieldInput.select();
+            }
+        });
+
+        // Клик на галочку или Enter — сохранить
+        saveBtn.addEventListener('click', saveField);
+        fieldInput.addEventListener('keydown', function(e) {
+            if (e.key === 'Enter' && fieldInput.tagName !== 'TEXTAREA') {
+                e.preventDefault();
+                saveField();
+            }
+            if (e.key === 'Escape') {
+                cancelEdit();
+            }
+        });
+
+        // Клик на крестик — отменить
+        cancelBtn.addEventListener('click', cancelEdit);
+
+        function cancelEdit() {
+            fieldInput.value = originalValue;
+            fieldValue.classList.remove('d-none');
+            fieldInput.classList.add('d-none');
+            fieldActions.classList.add('d-none');
+            editBtn.style.visibility = 'visible';
+            saveStatus.innerHTML = '';
+        }
+
+        function saveField() {
+            const newValue = fieldInput.value.trim();
+
+            // Показываем индикатор загрузки
+            saveStatus.innerHTML = '<span class="spinner-border spinner-border-sm text-primary"></span>';
+            saveBtn.disabled = true;
+            cancelBtn.disabled = true;
+
+            fetch(updateUrl, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': getCookie('csrftoken')
+                },
+                body: JSON.stringify({
+                    field: field,
+                    value: newValue
+                })
+            })
+            .then(response => response.json())
+            .then(data => {
+                saveBtn.disabled = false;
+                cancelBtn.disabled = false;
+
+                if (data.success) {
+                    // Обновляем отображаемое значение
+                    const displayValue = data.value || '—';
+                    fieldValue.textContent = displayValue;
+                    fieldInput.value = data.value || '';
+                    originalValue = data.value || '';
+
+                    // Обновляем заголовок страницы если изменилось имя
+                    if (field === 'name') {
+                        const titleSpan = document.getElementById('customer-title');
+                        if (titleSpan) {
+                            titleSpan.textContent = displayValue;
+                        }
+                    }
+
+                    // Возвращаем в режим просмотра
+                    fieldValue.classList.remove('d-none');
+                    fieldInput.classList.add('d-none');
+                    fieldActions.classList.add('d-none');
+                    editBtn.style.visibility = 'visible';
+
+                    // Показываем успех
+                    saveStatus.innerHTML = '<i class="bi bi-check-circle-fill text-success"></i>';
+                    setTimeout(() => {
+                        saveStatus.innerHTML = '';
+                    }, 1500);
+                } else {
+                    // Показываем ошибку
+                    saveStatus.innerHTML = `<span class="text-danger small"><i class="bi bi-exclamation-circle"></i> ${data.error}</span>`;
+                }
+            })
+            .catch(error => {
+                saveBtn.disabled = false;
+                cancelBtn.disabled = false;
+                saveStatus.innerHTML = '<span class="text-danger small"><i class="bi bi-exclamation-circle"></i> Ошибка сети</span>';
+                console.error('Error:', error);
+            });
+        }
+    });
+
+    // Функция получения CSRF токена
+    function getCookie(name) {
+        let cookieValue = null;
+        if (document.cookie && document.cookie !== '') {
+            const cookies = document.cookie.split(';');
+            for (let i = 0; i < cookies.length; i++) {
+                const cookie = cookies[i].trim();
+                if (cookie.substring(0, name.length + 1) === (name + '=')) {
+                    cookieValue = decodeURIComponent(cookie.substring(name.length + 1));
+                    break;
+                }
+            }
+        }
+        return cookieValue;
+    }
+
+    // ========== COPY TO CLIPBOARD ==========
+    document.querySelectorAll('.copy-btn').forEach(btn => {
+        btn.addEventListener('click', function() {
+            const value = this.dataset.copyValue;
+            if (!value) return;
+
+            navigator.clipboard.writeText(value).then(() => {
+                // Меняем иконку на галочку и стиль кнопки
+                const icon = this.querySelector('i');
+                const originalIconClass = icon.className;
+                const originalBtnClass = this.className;
+
+                // Меняем кнопку на зелёную с белой галочкой
+                this.className = 'btn btn-sm btn-success copy-btn';
+                icon.className = 'bi bi-check-lg';
+
+                // Возвращаем обратно через 1 сек
+                setTimeout(() => {
+                    this.className = originalBtnClass;
+                    icon.className = originalIconClass;
+                }, 1000);
+            }).catch(err => {
+                console.error('Ошибка копирования:', err);
+            });
+        });
+    });
+});
+</script>
 {% endblock %}

myproject/customers/templates/customers/customer_export_modal.html

@@ -0,0 +1,105 @@
+<!-- Modal for Customer Export Configuration -->
+<div class="modal fade" id="exportModal" tabindex="-1" aria-labelledby="exportModalLabel" aria-hidden="true">
+    <div class="modal-dialog modal-lg">
+        <div class="modal-content">
+            <form method="post" action="{% url 'customers:customer-export' %}?{{ request.GET.urlencode }}" id="exportForm">
+                {% csrf_token %}
+
+                <div class="modal-header">
+                    <h5 class="modal-title" id="exportModalLabel">
+                        <i class="bi bi-download"></i> Настройка экспорта клиентов
+                    </h5>
+                    <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Закрыть"></button>
+                </div>
+
+                <div class="modal-body">
+                    <!-- Export info -->
+                    <div class="alert alert-info">
+                        <i class="bi bi-info-circle"></i>
+                        Будет экспортировано клиентов: <strong>{{ total_customers }}</strong>
+                        {% if query or filter.form.has_notes.value or filter.form.no_phone.value or filter.form.no_email.value or filter.form.has_contact_channel.value %}
+                            <br><small>С учётом текущих фильтров и поиска</small>
+                        {% endif %}
+                    </div>
+
+                    <!-- Field Selection -->
+                    <div class="mb-4">
+                        <h6>Выберите поля для экспорта:</h6>
+                        <div class="row">
+                            {% for field in export_form %}
+                                {% if field.name != 'export_format' %}
+                                    <div class="col-md-6 mb-2">
+                                        <div class="form-check">
+                                            {{ field }}
+                                            <label class="form-check-label" for="{{ field.id_for_label }}">
+                                                {{ field.label }}
+                                                {% if 'wallet_balance' in field.name %}
+                                                    <span class="badge bg-warning text-dark">Только для владельца</span>
+                                                {% endif %}
+                                            </label>
+                                        </div>
+                                    </div>
+                                {% endif %}
+                            {% endfor %}
+                        </div>
+                    </div>
+
+                    <!-- Format Selection -->
+                    <div class="mb-3">
+                        <h6>Формат файла:</h6>
+                        {% for choice in export_form.export_format %}
+                            <div class="form-check form-check-inline">
+                                {{ choice.tag }}
+                                <label class="form-check-label" for="{{ choice.id_for_label }}">
+                                    {{ choice.choice_label }}
+                                </label>
+                            </div>
+                        {% endfor %}
+                    </div>
+
+                    <div class="text-muted small">
+                        <i class="bi bi-lightbulb"></i>
+                        Ваш выбор будет сохранён для следующего экспорта
+                    </div>
+                </div>
+
+                <div class="modal-footer">
+                    <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">
+                        Отмена
+                    </button>
+                    <button type="submit" class="btn btn-primary">
+                        <i class="bi bi-download"></i> Экспортировать
+                    </button>
+                </div>
+            </form>
+        </div>
+    </div>
+</div>
+
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+    // Pre-select saved preferences from session
+    var preferencesJson = '{{ export_preferences|escapejs }}';
+    if (preferencesJson && preferencesJson !== '{}') {
+        try {
+            var preferences = JSON.parse(preferencesJson.replace(/'/g, '"'));
+
+            // Restore selected fields
+            if (preferences.selected_fields) {
+                preferences.selected_fields.forEach(function(field) {
+                    var checkbox = document.getElementById('id_field_' + field);
+                    if (checkbox) checkbox.checked = true;
+                });
+            }
+
+            // Restore format selection
+            if (preferences.format) {
+                var radio = document.querySelector('input[name="export_format"][value="' + preferences.format + '"]');
+                if (radio) radio.checked = true;
+            }
+        } catch (e) {
+            console.log('Could not parse export preferences:', e);
+        }
+    }
+});
+</script>

myproject/customers/templates/customers/customer_form.html

@@ -1,89 +1,43 @@
 {% extends "base.html" %}
 
-{% block title %}
-    {% if is_creating %}Добавить нового клиента{% else %}Редактировать клиента{% endif %}
-{% endblock %}
+{% block title %}Добавить нового клиента{% endblock %}
 
 {% block content %}
 <div class="container-fluid">
     <div class="row">
         <div class="col-12">
-            <h1>
-                {% if is_creating %}
-                    Добавить нового клиента
-                {% else %}
-                    Редактировать клиента
-                {% endif %}
-            </h1>
-            
+            <h1>Добавить нового клиента</h1>
+
             <form method="post">
                 {% csrf_token %}
-                
-                <div class="row">
-                    <!-- Personal Information -->
-                    <div class="col-md-6">
-                        <div class="card mb-4">
-                            <div class="card-header">
-                                <h5>Личная информация</h5>
-                            </div>
-                            <div class="card-body">
-                                <div class="mb-3">
-                                    {{ form.name.label_tag }}
-                                    {{ form.name }}
-                                    {% if form.name.errors %}
-                                        <div class="text-danger">{{ form.name.errors }}</div>
-                                    {% endif %}
-                                </div>
-                                
-                                <div class="mb-3">
-                                    {{ form.phone.label_tag }}
-                                    {{ form.phone }}
-                                    <div class="form-text">Введите телефон в любом формате, например: +375291234567, 80291234567</div>
-                                    {% if form.phone.errors %}
-                                        <div class="text-danger">{{ form.phone.errors }}</div>
-                                    {% endif %}
-                                </div>
-                                
-                                <div class="mb-3">
-                                    {{ form.email.label_tag }}
-                                    {{ form.email }}
-                                    {% if form.email.errors %}
-                                        <div class="text-danger">{{ form.email.errors }}</div>
-                                    {% endif %}
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                    
-                    <!-- Preferences and Status -->
-                    <div class="col-md-6">
-                        <div class="card mb-4">
-                            <div class="card-header">
-                                <h5>Предпочтения и статус</h5>
-                            </div>
-                            <div class="card-body">
-                                <div class="mb-3">
-                                    {{ form.loyalty_tier.label_tag }}
-                                    {{ form.loyalty_tier }}
-                                    {% if form.loyalty_tier.errors %}
-                                        <div class="text-danger">{{ form.loyalty_tier.errors }}</div>
-                                    {% endif %}
-                                </div>
-                                
 
-                                
-
-                            </div>
-                        </div>
-                    </div>
-                </div>
-                
-                <!-- Additional Information -->
                 <div class="card mb-4">
-                    <div class="card-header">
-                        <h5>Дополнительная информация</h5>
-                    </div>
                     <div class="card-body">
+                        <div class="mb-3">
+                            {{ form.name.label_tag }}
+                            {{ form.name }}
+                            {% if form.name.errors %}
+                                <div class="text-danger">{{ form.name.errors }}</div>
+                            {% endif %}
+                        </div>
+
+                        <div class="mb-3">
+                            {{ form.phone.label_tag }}
+                            {{ form.phone }}
+                            <div class="form-text">Введите телефон в любом формате, например: +375291234567, 80291234567</div>
+                            {% if form.phone.errors %}
+                                <div class="text-danger">{{ form.phone.errors }}</div>
+                            {% endif %}
+                        </div>
+
+                        <div class="mb-3">
+                            {{ form.email.label_tag }}
+                            {{ form.email }}
+                            {% if form.email.errors %}
+                                <div class="text-danger">{{ form.email.errors }}</div>
+                            {% endif %}
+                        </div>
+
                         <div class="mb-3">
                             {{ form.notes.label_tag }}
                             {{ form.notes }}
@@ -93,13 +47,10 @@
                         </div>
                     </div>
                 </div>
-                
-                <!-- Form Actions -->
+
                 <div class="d-flex gap-2">
-                    <button type="submit" class="btn btn-primary">
-                        {% if is_creating %}Создать клиента{% else %}Сохранить изменения{% endif %}
-                    </button>
-                    <a href="{% if form.instance.pk %}{% url 'customers:customer-detail' form.instance.pk %}{% else %}{% url 'customers:customer-list' %}{% endif %}" class="btn btn-secondary">Отмена</a>
+                    <button type="submit" class="btn btn-primary">Создать клиента</button>
+                    <a href="{% url 'customers:customer-list' %}" class="btn btn-secondary">Отмена</a>
                 </div>
             </form>
         </div>

myproject/customers/templates/customers/customer_import.html

@@ -0,0 +1,407 @@
+{% extends "base.html" %}
+
+{% block title %}Импорт клиентов{% endblock %}
+
+{% block content %}
+<div class="container-fluid">
+    <div class="row">
+        <div class="col-md-8 offset-md-2">
+            
+            <div class="d-flex justify-content-between align-items-center mb-4">
+                <h1>Импорт клиентов</h1>
+                <a href="{% url 'customers:customer-list' %}" class="btn btn-outline-secondary">
+                    <i class="bi bi-arrow-left"></i> Назад к списку
+                </a>
+            </div>
+
+            <!-- Инструкция -->
+            <div class="alert alert-info mb-4">
+                <h5 class="alert-heading"><i class="bi bi-info-circle"></i> Инструкция</h5>
+                <p class="mb-2">Загрузите CSV или Excel файл со следующими столбцами:</p>
+                <ul class="mb-2">
+                    <li><strong>Имя</strong> (обязательно)</li>
+                    <li><strong>Email</strong> (опционально, должен быть уникальным)</li>
+                    <li><strong>Телефон</strong> (опционально, формат: +375XXXXXXXXX, должен быть уникальным)</li>
+                </ul>
+                <p class="mb-0">
+                    <a href="{% url 'customers:customer-export' %}" class="btn btn-sm btn-outline-primary">
+                        <i class="bi bi-download"></i> Скачать образец (текущие клиенты)
+                    </a>
+                </p>
+            </div>
+
+            <!-- Результаты импорта -->
+            {% if import_result %}
+            <div class="card mb-4 border-{{ import_result.success|yesno:'success,danger' }}">
+                <div class="card-header bg-{{ import_result.success|yesno:'success,danger' }} text-white">
+                    <h5 class="mb-0">
+                        <i class="bi bi-{{ import_result.success|yesno:'check-circle,exclamation-triangle' }}"></i>
+                        Результаты импорта
+                    </h5>
+                </div>
+                <div class="card-body">
+                    <div class="row mb-3">
+                        <div class="col-md-2">
+                            <div class="text-center p-3 bg-light rounded">
+                                <div class="h2 mb-0 text-success">{{ import_result.created }}</div>
+                                <small class="text-muted">Создано</small>
+                            </div>
+                        </div>
+                        <div class="col-md-2">
+                            <div class="text-center p-3 bg-light rounded">
+                                <div class="h2 mb-0 text-primary">{{ import_result.enriched }}</div>
+                                <small class="text-muted">Дополнено</small>
+                            </div>
+                        </div>
+                        <div class="col-md-2">
+                            <div class="text-center p-3 bg-light rounded">
+                                <div class="h2 mb-0 text-info">{{ import_result.updated }}</div>
+                                <small class="text-muted">Обновлено</small>
+                            </div>
+                        </div>
+                        <div class="col-md-2">
+                            <div class="text-center p-3 bg-light rounded">
+                                <div class="h2 mb-0 text-secondary">{{ import_result.conflicts_resolved }}</div>
+                                <small class="text-muted">Альт. контакты</small>
+                            </div>
+                        </div>
+                        <div class="col-md-2">
+                            <div class="text-center p-3 bg-light rounded">
+                                <div class="h2 mb-0 text-warning">{{ import_result.duplicate_count }}</div>
+                                <small class="text-muted">Дубликатов</small>
+                            </div>
+                        </div>
+                        <div class="col-md-2">
+                            <div class="text-center p-3 bg-light rounded">
+                                <div class="h2 mb-0 text-danger">{{ import_result.real_error_count }}</div>
+                                <small class="text-muted">Ошибок</small>
+                            </div>
+                        </div>
+                    </div>
+
+                    {% if import_result.real_errors %}
+                    <div class="alert alert-warning">
+                        <h6 class="alert-heading">
+                            <i class="bi bi-exclamation-triangle"></i> 
+                            Обнаружено {{ import_result.real_error_count }} ошибок валидации
+                        </h6>
+                        <p class="mb-2">Первые ошибки:</p>
+                        <ul class="mb-0">
+                            {% for error in import_result.real_errors|slice:":10" %}
+                            <li>
+                                <strong>Строка {{ error.row }}:</strong> {{ error.reason }}
+                                {% if error.email %}<code>{{ error.email }}</code>{% endif %}
+                                {% if error.phone %}<code>{{ error.phone }}</code>{% endif %}
+                            </li>
+                            {% endfor %}
+                        </ul>
+                        {% if import_result.real_error_count > 10 %}
+                        <p class="mb-0 mt-2 text-muted">
+                            <small>...и ещё {{ import_result.real_error_count|add:"-10" }} ошибок</small>
+                        </p>
+                        {% endif %}
+                    </div>
+
+                    {% if has_error_file %}
+                    <div class="text-center">
+                        <a href="{% url 'customers:customer-import-download-errors' %}" class="btn btn-danger btn-lg">
+                            <i class="bi bi-download"></i> Скачать файл с ошибками
+                        </a>
+                        <p class="text-muted mt-2 mb-0">
+                            <small>Исправьте ошибки в файле и загрузите снова</small>
+                        </p>
+                    </div>
+                    {% endif %}
+                    {% endif %}
+
+                    {% if import_result.duplicate_count > 0 %}
+                    <div class="alert alert-info mt-3">
+                        <i class="bi bi-info-circle"></i>
+                        Пропущено дубликатов: {{ import_result.duplicate_count }} 
+                        (клиенты с такими email/телефонами уже существуют)
+                    </div>
+                    {% endif %}
+                </div>
+            </div>
+            {% endif %}
+
+            <!-- Форма загрузки -->
+            <div class="card">
+                <div class="card-body">
+                    <form method="post" enctype="multipart/form-data" id="importForm">
+                        {% csrf_token %}
+                        
+                        <!-- Drag & Drop зона -->
+                        <div class="mb-3">
+                            <label for="file" class="form-label">Выберите файл</label>
+                            
+                            <div id="dropZone" class="border border-2 border-dashed rounded p-4 text-center position-relative" 
+                                 style="min-height: 150px; cursor: pointer; transition: all 0.3s;">
+                                <input type="file" class="form-control d-none" id="file" name="file" 
+                                       accept=".csv,.xlsx,.xls" required>
+                                
+                                <div id="dropZoneContent">
+                                    <i class="bi bi-cloud-upload fs-1 text-muted"></i>
+                                    <p class="mt-3 mb-2">
+                                        <strong>Перетащите файл сюда</strong> или 
+                                        <span class="text-primary">нажмите для выбора</span>
+                                    </p>
+                                    <p class="text-muted mb-0">
+                                        <small>
+                                            Поддерживаемые форматы: CSV, Excel (.xlsx, .xls)<br>
+                                            Также можно вставить файл через <kbd>Ctrl+V</kbd>
+                                        </small>
+                                    </p>
+                                </div>
+
+                                <div id="filePreview" class="d-none">
+                                    <i class="bi bi-file-earmark-spreadsheet fs-1 text-success"></i>
+                                    <p class="mt-3 mb-0">
+                                        <strong id="fileName"></strong>
+                                        <br>
+                                        <small class="text-muted" id="fileSize"></small>
+                                    </p>
+                                    <button type="button" class="btn btn-sm btn-outline-danger mt-2" id="removeFile">
+                                        <i class="bi bi-x-circle"></i> Удалить
+                                    </button>
+                                </div>
+                            </div>
+                        </div>
+
+                        <div class="form-check mb-3">
+                            <input type="checkbox" class="form-check-input" id="update_existing" name="update_existing">
+                            <label class="form-check-label" for="update_existing">
+                                Обновлять существующих клиентов (по email или телефону)
+                            </label>
+                        </div>
+
+                        <button type="submit" class="btn btn-primary" id="submitBtn">
+                            <i class="bi bi-upload"></i> Импортировать
+                        </button>
+                        <a href="{% url 'customers:customer-list' %}" class="btn btn-outline-secondary">
+                            Отмена
+                        </a>
+                    </form>
+                    
+                    <!-- Прогресс-бар (скрыт по умолчанию) -->
+                    <div id="progressContainer" class="mt-4 d-none">
+                        <div class="d-flex justify-content-between align-items-center mb-2">
+                            <strong>Импорт в процессе...</strong>
+                            <span id="progressText" class="text-muted">Подготовка...</span>
+                        </div>
+                        <div class="progress" style="height: 25px;">
+                            <div id="progressBar" class="progress-bar progress-bar-striped progress-bar-animated" 
+                                 role="progressbar" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100" style="width: 0%">
+                                <span id="progressPercent">0%</span>
+                            </div>
+                        </div>
+                        <p class="text-muted mt-2 mb-0">
+                            <small><i class="bi bi-exclamation-triangle text-warning"></i> Не закрывайте страницу до завершения импорта</small>
+                        </p>
+                    </div>
+                </div>
+            </div>
+
+        </div>
+    </div>
+</div>
+
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+    const dropZone = document.getElementById('dropZone');
+    const fileInput = document.getElementById('file');
+    const dropZoneContent = document.getElementById('dropZoneContent');
+    const filePreview = document.getElementById('filePreview');
+    const fileName = document.getElementById('fileName');
+    const fileSize = document.getElementById('fileSize');
+    const removeFileBtn = document.getElementById('removeFile');
+    const importForm = document.getElementById('importForm');
+
+    // Клик по зоне = открыть диалог выбора файла
+    dropZone.addEventListener('click', function(e) {
+        if (e.target.id !== 'removeFile' && !e.target.closest('#removeFile')) {
+            fileInput.click();
+        }
+    });
+
+    // Обработка выбора файла через input
+    fileInput.addEventListener('change', function(e) {
+        if (e.target.files.length > 0) {
+            showFilePreview(e.target.files[0]);
+        }
+    });
+
+    // Drag & Drop события
+    dropZone.addEventListener('dragover', function(e) {
+        e.preventDefault();
+        e.stopPropagation();
+        dropZone.classList.add('border-primary', 'bg-light');
+    });
+
+    dropZone.addEventListener('dragleave', function(e) {
+        e.preventDefault();
+        e.stopPropagation();
+        dropZone.classList.remove('border-primary', 'bg-light');
+    });
+
+    dropZone.addEventListener('drop', function(e) {
+        e.preventDefault();
+        e.stopPropagation();
+        dropZone.classList.remove('border-primary', 'bg-light');
+
+        const files = e.dataTransfer.files;
+        if (files.length > 0) {
+            const file = files[0];
+            if (isValidFile(file)) {
+                // Присваиваем файл в input через DataTransfer
+                const dataTransfer = new DataTransfer();
+                dataTransfer.items.add(file);
+                fileInput.files = dataTransfer.files;
+                showFilePreview(file);
+            } else {
+                alert('Неподдерживаемый формат файла. Используйте CSV или Excel (.xlsx, .xls)');
+            }
+        }
+    });
+
+    // Paste через Ctrl+V
+    document.addEventListener('paste', function(e) {
+        const items = e.clipboardData.items;
+        
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            
+            // Проверяем, есть ли файл в буфере
+            if (item.kind === 'file') {
+                const file = item.getAsFile();
+                if (file && isValidFile(file)) {
+                    const dataTransfer = new DataTransfer();
+                    dataTransfer.items.add(file);
+                    fileInput.files = dataTransfer.files;
+                    showFilePreview(file);
+                    e.preventDefault();
+                    break;
+                }
+            }
+        }
+    });
+
+    // Показать превью файла
+    function showFilePreview(file) {
+        fileName.textContent = file.name;
+        fileSize.textContent = formatFileSize(file.size);
+        dropZoneContent.classList.add('d-none');
+        filePreview.classList.remove('d-none');
+    }
+
+    // Удалить файл
+    removeFileBtn.addEventListener('click', function(e) {
+        e.stopPropagation();
+        fileInput.value = '';
+        filePreview.classList.add('d-none');
+        dropZoneContent.classList.remove('d-none');
+    });
+
+    // Проверка формата файла
+    function isValidFile(file) {
+        const validExtensions = ['.csv', '.xlsx', '.xls'];
+        const fileName = file.name.toLowerCase();
+        return validExtensions.some(ext => fileName.endsWith(ext));
+    }
+
+    // Форматирование размера файла
+    function formatFileSize(bytes) {
+        if (bytes === 0) return '0 Bytes';
+        const k = 1024;
+        const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return Math.round(bytes / Math.pow(k, i) * 100) / 100 + ' ' + sizes[i];
+    }
+
+    // Валидация перед отправкой
+    importForm.addEventListener('submit', function(e) {
+        if (!fileInput.files || fileInput.files.length === 0) {
+            e.preventDefault();
+            alert('Пожалуйста, выберите файл для импорта');
+            return false;
+        }
+        
+        // НЕ блокируем отправку формы, но показываем прогресс-бар сразу после клика
+        // Используем setTimeout чтобы форма успела начать отправку
+        setTimeout(() => {
+            showProgressBar();
+        }, 10);
+    });
+    
+    // Показать прогресс-бар и защиту от закрытия
+    function showProgressBar() {
+        const submitBtn = document.getElementById('submitBtn');
+        const progressContainer = document.getElementById('progressContainer');
+        const progressBar = document.getElementById('progressBar');
+        const progressPercent = document.getElementById('progressPercent');
+        const progressText = document.getElementById('progressText');
+        
+        // Блокируем кнопку и форму
+        submitBtn.disabled = true;
+        submitBtn.innerHTML = '<span class="spinner-border spinner-border-sm me-2"></span>Импорт...';
+        fileInput.disabled = true;
+        dropZone.style.pointerEvents = 'none';
+        dropZone.style.opacity = '0.6';
+        
+        // Показываем прогресс-бар
+        progressContainer.classList.remove('d-none');
+        
+        // Анимация прогресса (имитация, т.к. реальный прогресс без WebSocket сложен)
+        let progress = 0;
+        const progressInterval = setInterval(() => {
+            if (progress < 90) {
+                progress += Math.random() * 15;
+                if (progress > 90) progress = 90;
+                
+                progressBar.style.width = progress + '%';
+                progressBar.setAttribute('aria-valuenow', progress);
+                progressPercent.textContent = Math.round(progress) + '%';
+                
+                if (progress < 30) {
+                    progressText.textContent = 'Чтение файла...';
+                } else if (progress < 60) {
+                    progressText.textContent = 'Обработка данных...';
+                } else {
+                    progressText.textContent = 'Сохранение в базу...';
+                }
+            }
+        }, 300);
+        
+        // Сохраняем интервал для очистки при завершении страницы
+        window.importProgressInterval = progressInterval;
+        
+        // Включаем защиту от закрытия страницы
+        window.importInProgress = true;
+    }
+    
+    // Предупреждение при закрытии страницы во время импорта
+    window.addEventListener('beforeunload', function(e) {
+        if (window.importInProgress) {
+            e.preventDefault();
+            e.returnValue = 'Импорт ещё не завершён. Вы уверены, что хотите покинуть страницу?';
+            return e.returnValue;
+        }
+    });
+});
+</script>
+
+<style>
+#dropZone {
+    transition: all 0.3s ease;
+}
+
+#dropZone:hover {
+    border-color: var(--bs-primary) !important;
+    background-color: rgba(var(--bs-primary-rgb), 0.05);
+}
+
+#dropZone.border-primary {
+    background-color: rgba(var(--bs-primary-rgb), 0.1);
+}
+</style>
+{% endblock %}

myproject/customers/templates/customers/customer_list.html

@@ -1,4 +1,5 @@
 {% extends "base.html" %}
+{% load query_tags %}
 
 {% block title %}Клиенты{% endblock %}
 
@@ -8,128 +9,190 @@
         <div class="col-12">
 
             <div class="d-flex justify-content-between align-items-center mb-3">
-                <h1>Клиенты</h1>
-                <a href="{% url 'customers:customer-create' %}" class="btn btn-primary">Добавить клиента</a>
-            </div>
-
-            <!-- Search Form -->
-            <div class="card mb-4">
-                <div class="card-body">
-                    <form method="get" class="row g-3" id="search-form">
-                        <div class="col-md-6">
-                            <input type="text" class="form-control" name="q"
-                                   value="{{ query|default:'' }}" placeholder="Поиск по имени, email или телефону (минимум 3 символа)..." id="search-input">
-                            <small class="form-text text-muted" id="search-hint" style="display: none; color: #dc3545 !important;">
-                                Введите минимум 3 символа для поиска
-                            </small>
-                        </div>
-                        <div class="col-md-3">
-                            <button type="submit" class="btn btn-outline-primary" id="search-btn">Поиск</button>
-                            {% if query %}
-                                <a href="{% url 'customers:customer-list' %}" class="btn btn-outline-secondary">Очистить</a>
-                            {% endif %}
-                        </div>
-                    </form>
-                    <script>
-                        document.getElementById('search-form').addEventListener('submit', function(e) {
-                            const searchInput = document.getElementById('search-input');
-                            const searchValue = searchInput.value.trim();
-                            const searchHint = document.getElementById('search-hint');
-
-                            // Если поле пусто или содержит менее 3 символов, не отправляем форму
-                            if (searchValue && searchValue.length < 3) {
-                                e.preventDefault();
-                                searchHint.style.display = 'block';
-                                searchInput.classList.add('is-invalid');
-                                return false;
-                            }
-
-                            // Если поле пусто, тоже не отправляем (это будет просто пусто)
-                            if (!searchValue) {
-                                e.preventDefault();
-                                return false;
-                            }
-
-                            // Все хорошо, отправляем
-                            searchHint.style.display = 'none';
-                            searchInput.classList.remove('is-invalid');
-                        });
-
-                        // Убираем ошибку при вводе
-                        document.getElementById('search-input').addEventListener('input', function() {
-                            const searchValue = this.value.trim();
-                            const searchHint = document.getElementById('search-hint');
-
-                            if (searchValue.length >= 3) {
-                                searchHint.style.display = 'none';
-                                this.classList.remove('is-invalid');
-                            }
-                        });
-                    </script>
+                <div>
+                    <h1>Клиенты</h1>
+                    <p class="text-muted mb-0">
+                        Всего клиентов: <strong>{{ total_customers }}</strong>
+                    </p>
+                </div>
+                <div class="btn-group" role="group">
+                    <a href="{% url 'customers:customer-import' %}" class="btn btn-outline-success">
+                        <i class="bi bi-upload"></i> Импорт
+                    </a>
+                    {% if user.is_owner or user.is_superuser %}
+                        <button type="button" class="btn btn-outline-info" data-bs-toggle="modal" data-bs-target="#exportModal">
+                            <i class="bi bi-download"></i> Экспорт
+                        </button>
+                    {% endif %}
+                    <a href="{% url 'customers:customer-create' %}" class="btn btn-primary">
+                        <i class="bi bi-plus-circle"></i> Добавить клиента
+                    </a>
                 </div>
             </div>
 
-            <!-- Customers Table -->
+            <!-- Поиск и фильтры -->
+            <div class="card mb-3">
+                <div class="card-body">
+                    <form method="get" class="row g-3">
+                        <!-- Поиск -->
+                        <div class="col-md-6">
+                            <input type="text" class="form-control" name="q" value="{{ query }}" 
+                                   placeholder="Поиск по имени, email или телефону..." 
+                                   autofocus>
+                        </div>
+                        
+                        <!-- Фильтры -->
+                        <div class="col-md-6">
+                            <div class="d-flex gap-3 align-items-center flex-wrap">
+                                <div class="form-check">
+                                    {{ filter.form.has_notes }}
+                                    <label class="form-check-label" for="{{ filter.form.has_notes.id_for_label }}">
+                                        Есть заметки
+                                    </label>
+                                </div>
+                                <div class="form-check">
+                                    {{ filter.form.no_phone }}
+                                    <label class="form-check-label" for="{{ filter.form.no_phone.id_for_label }}">
+                                        Нет телефона
+                                    </label>
+                                </div>
+                                <div class="form-check">
+                                    {{ filter.form.no_email }}
+                                    <label class="form-check-label" for="{{ filter.form.no_email.id_for_label }}">
+                                        Нет email
+                                    </label>
+                                </div>
+                                <div class="form-check">
+                                    {{ filter.form.has_contact_channel }}
+                                    <label class="form-check-label" for="{{ filter.form.has_contact_channel.id_for_label }}">
+                                        Есть канал связи
+                                    </label>
+                                </div>
+                            </div>
+                        </div>
+                        
+                        <!-- Кнопки -->
+                        <div class="col-12">
+                            <div class="btn-group" role="group">
+                                <button type="submit" class="btn btn-primary">
+                                    <i class="bi bi-search"></i> Поиск / Фильтр
+                                </button>
+                                {% if query or filter.form.has_notes.value or filter.form.no_phone.value or filter.form.no_email.value or filter.form.has_contact_channel.value %}
+                                    <a href="{% url 'customers:customer-list' %}" class="btn btn-outline-secondary">
+                                        <i class="bi bi-x-circle"></i> Очистить
+                                    </a>
+                                {% endif %}
+                            </div>
+                        </div>
+                    </form>
+                </div>
+            </div>
+
+            <!-- Таблица клиентов -->
             <div class="card">
                 <div class="card-body">
-
                     {% if page_obj %}
                         <div class="table-responsive">
-                            <table class="table table-hover align-middle">
-                                <thead>
-                                    <tr>
-                                        <th>Имя</th>
-                                        <th>Email</th>
-                                        <th>Телефон</th>
-                                        <th>Сумма покупок</th>
-                                        <th class="text-end">Действия</th>
-                                    </tr>
-                                </thead>
-                                <tbody>
-                                    {% for customer in page_obj %}
-                                    <tr
-                                        style="cursor:pointer"
-                                        onclick="window.location='{% url 'customers:customer-detail' customer.pk %}'"
-                                    >
-                                        <td class="fw-semibold">{{ customer.full_name }}</td>
-                                        <td>{{ customer.email|default:'—' }}</td>
-                                        <td>{{ customer.phone|default:'—' }}</td>
+                                <table class="table table-hover align-middle">
+                                    <thead>
+                                        <tr>
+                                            <th>Имя</th>
+                                            <th>Email</th>
+                                            <th>Телефон</th>
+                                            <th>Заметки</th>
+                                            <th class="text-end">Действия</th>
+                                        </tr>
+                                    </thead>
+                                    <tbody>
+                                        {% for customer in page_obj %}
+                                        <tr
+                                            style="cursor:pointer"
+                                            onclick="window.location='{% url 'customers:customer-detail' customer.pk %}'"
+                                        >
+                                            <td class="fw-semibold">{{ customer.full_name }}</td>
+                                            <td>{{ customer.email|default:'—' }}</td>
+                                            <td>{{ customer.phone|default:'—' }}</td>
+                                            <td>
+                                                {% if customer.notes %}
+                                                    <div style="max-width: 300px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis;" 
+                                                         title="{{ customer.notes }}">
+                                                        {{ customer.notes|truncatewords:10 }}
+                                                    </div>
+                                                {% else %}
+                                                    —
+                                                {% endif %}
+                                            </td>
 
-                                        <td>{{ customer.total_spent|default:0|floatformat:2 }} руб.</td>
-
-                                        <td class="text-end" onclick="event.stopPropagation();">
-                                            <a href="{% url 'customers:customer-detail' customer.pk %}"
-                                               class="btn btn-sm btn-outline-primary">👁</a>
-                                            <a href="{% url 'customers:customer-update' customer.pk %}"
-                                               class="btn btn-sm btn-outline-secondary">✎</a>
-                                        </td>
-                                    </tr>
-                                    {% endfor %}
-                                </tbody>
-                            </table>
-                        </div>
+                                            <td class="text-end" onclick="event.stopPropagation();">
+                                                <a href="{% url 'customers:customer-detail' customer.pk %}"
+                                                   class="btn btn-sm btn-outline-primary" title="Просмотр">
+                                                   <i class="bi bi-eye"></i>
+                                                </a>
+                                            </td>
+                                        </tr>
+                                        {% endfor %}
+                                    </tbody>
+                                </table>
+                            </div>
 
                         <!-- Pagination -->
                         {% if page_obj.has_other_pages %}
-                            <nav aria-label="Page navigation">
-                                <ul class="pagination justify-content-center">
+                            <nav aria-label="Page navigation" class="mt-3">
+                                <ul class="pagination pagination-sm justify-content-center mb-0">
                                     {% if page_obj.has_previous %}
                                         <li class="page-item">
-                                            <a class="page-link" href="?page={{ page_obj.previous_page_number }}{% if query %}&q={{ query }}{% endif %}">Предыдущая</a>
+                                            <a class="page-link" href="{% url_replace page=1 %}" title="Первая страница">
+                                                &laquo;&laquo;
+                                            </a>
+                                        </li>
+                                        <li class="page-item">
+                                            <a class="page-link" href="{% url_replace page=page_obj.previous_page_number %}" title="Предыдущая">
+                                                &laquo;
+                                            </a>
+                                        </li>
+                                    {% else %}
+                                        <li class="page-item disabled">
+                                            <span class="page-link">&laquo;&laquo;</span>
+                                        </li>
+                                        <li class="page-item disabled">
+                                            <span class="page-link">&laquo;</span>
                                         </li>
                                     {% endif %}
 
-                                    {% for num in page_obj.paginator.page_range %}
-                                        {% if page_obj.number == num %}
-                                            <li class="page-item active"><span class="page-link">{{ num }}</span></li>
-                                        {% elif num > page_obj.number|add:'-3' and num < page_obj.number|add:'3' %}
-                                            <li class="page-item"><a class="page-link" href="?page={{ num }}{% if query %}&q={{ query }}{% endif %}">{{ num }}</a></li>
-                                        {% endif %}
-                                    {% endfor %}
+                                    {# Цифры страниц: показываем до 10 страниц #}
+                                    {% with start_page=page_obj.number|add:"-5" end_page=page_obj.number|add:"5" %}
+                                        {% for num in page_obj.paginator.page_range %}
+                                            {% if num >= start_page|default:1 and num <= end_page and num <= page_obj.paginator.num_pages %}
+                                                {% if num == page_obj.number %}
+                                                    <li class="page-item active">
+                                                        <span class="page-link">{{ num }}</span>
+                                                    </li>
+                                                {% else %}
+                                                    <li class="page-item">
+                                                        <a class="page-link" href="{% url_replace page=num %}">{{ num }}</a>
+                                                    </li>
+                                                {% endif %}
+                                            {% endif %}
+                                        {% endfor %}
+                                    {% endwith %}
 
                                     {% if page_obj.has_next %}
                                         <li class="page-item">
-                                            <a class="page-link" href="?page={{ page_obj.next_page_number }}{% if query %}&q={{ query }}{% endif %}">Следующая</a>
+                                            <a class="page-link" href="{% url_replace page=page_obj.next_page_number %}" title="Следующая">
+                                                &raquo;
+                                            </a>
+                                        </li>
+                                        <li class="page-item">
+                                            <a class="page-link" href="{% url_replace page=page_obj.paginator.num_pages %}" title="Последняя страница">
+                                                &raquo;&raquo;
+                                            </a>
+                                        </li>
+                                    {% else %}
+                                        <li class="page-item disabled">
+                                            <span class="page-link">&raquo;</span>
+                                        </li>
+                                        <li class="page-item disabled">
+                                            <span class="page-link">&raquo;&raquo;</span>
                                         </li>
                                     {% endif %}
                                 </ul>
@@ -146,4 +209,7 @@
         </div>
     </div>
 </div>
+
+{% include 'customers/customer_export_modal.html' %}
+
 {% endblock %}

myproject/customers/templatetags/query_tags.py

@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+"""
+Custom template tags для работы с URL и query параметрами
+"""
+
+from django import template
+from django.http import QueryDict
+
+register = template.Library()
+
+
+@register.simple_tag(takes_context=True)
+def url_replace(context, **kwargs):
+    """
+    Создаёт URL с сохранением всех текущих GET-параметров,
+    заменяя или добавляя переданные параметры.
+    
+    Использование:
+        {% url_replace page=2 %}
+        {% url_replace page=num has_notes='' %}  {# Удаление параметра #}
+    
+    Автоматически сохраняет все существующие GET-параметры (q, has_notes, no_phone и т.д.)
+    """
+    query = context['request'].GET.copy()
+    
+    for key, value in kwargs.items():
+        if value == '' or value is None:
+            # Удаляем параметр если значение пустое
+            query.pop(key, None)
+        else:
+            query[key] = value
+    
+    return f"?{query.urlencode()}" if query else "?"

myproject/customers/tests.py

@@ -1,252 +0,0 @@
-from django.test import TestCase
-from .views import determine_search_strategy, is_query_phone_only
-
-
-class DetermineSearchStrategyTestCase(TestCase):
-    """
-    Тесты для функции determine_search_strategy().
-
-    Проверяют, что функция правильно определяет стратегию поиска
-    на основе содержимого query.
-    """
-
-    # ===== email_prefix: query заканчивается на @ =====
-    def test_email_prefix_simple(self):
-        """Query "team_x3m@" должен вернуть ('email_prefix', 'team_x3m')"""
-        strategy, search_value = determine_search_strategy('team_x3m@')
-        self.assertEqual(strategy, 'email_prefix')
-        self.assertEqual(search_value, 'team_x3m')
-
-    def test_email_prefix_with_domain_symbol(self):
-        """Query "user_name@" должен вернуть ('email_prefix', 'user_name')"""
-        strategy, search_value = determine_search_strategy('user_name@')
-        self.assertEqual(strategy, 'email_prefix')
-        self.assertEqual(search_value, 'user_name')
-
-    def test_email_prefix_with_numbers(self):
-        """Query "test123@" должен вернуть ('email_prefix', 'test123')"""
-        strategy, search_value = determine_search_strategy('test123@')
-        self.assertEqual(strategy, 'email_prefix')
-        self.assertEqual(search_value, 'test123')
-
-    # ===== email_domain: query начинается с @ =====
-    def test_email_domain_simple(self):
-        """Query "@bk" должен вернуть ('email_domain', 'bk')"""
-        strategy, search_value = determine_search_strategy('@bk')
-        self.assertEqual(strategy, 'email_domain')
-        self.assertEqual(search_value, 'bk')
-
-    def test_email_domain_with_extension(self):
-        """Query "@bk.ru" должен вернуть ('email_domain', 'bk.ru')"""
-        strategy, search_value = determine_search_strategy('@bk.ru')
-        self.assertEqual(strategy, 'email_domain')
-        self.assertEqual(search_value, 'bk.ru')
-
-    def test_email_domain_with_multiple_dots(self):
-        """Query "@mail.google.com" должен вернуть ('email_domain', 'mail.google.com')"""
-        strategy, search_value = determine_search_strategy('@mail.google.com')
-        self.assertEqual(strategy, 'email_domain')
-        self.assertEqual(search_value, 'mail.google.com')
-
-    # ===== email_full: query содержит и локальную часть, и домен =====
-    def test_email_full_simple(self):
-        """Query "test@bk.ru" должен вернуть ('email_full', 'test@bk.ru')"""
-        strategy, search_value = determine_search_strategy('test@bk.ru')
-        self.assertEqual(strategy, 'email_full')
-        self.assertEqual(search_value, 'test@bk.ru')
-
-    def test_email_full_partial(self):
-        """Query "test@bk" должен вернуть ('email_full', 'test@bk')"""
-        strategy, search_value = determine_search_strategy('test@bk')
-        self.assertEqual(strategy, 'email_full')
-        self.assertEqual(search_value, 'test@bk')
-
-    def test_email_full_complex(self):
-        """Query "user.name@mail.example.com" должен вернуть ('email_full', ...)"""
-        strategy, search_value = determine_search_strategy('user.name@mail.example.com')
-        self.assertEqual(strategy, 'email_full')
-        self.assertEqual(search_value, 'user.name@mail.example.com')
-
-    # ===== universal: query без @, 3+ символов =====
-    def test_universal_three_chars(self):
-        """Query "natul" (5 символов) должен вернуть ('universal', 'natul')"""
-        strategy, search_value = determine_search_strategy('natul')
-        self.assertEqual(strategy, 'universal')
-        self.assertEqual(search_value, 'natul')
-
-    def test_universal_three_chars_exact(self):
-        """Query "abc" (3 символа) должен вернуть ('universal', 'abc')"""
-        strategy, search_value = determine_search_strategy('abc')
-        self.assertEqual(strategy, 'universal')
-        self.assertEqual(search_value, 'abc')
-
-    def test_universal_cyrillic(self):
-        """Query "наталь" (6 символов) должен вернуть ('universal', 'наталь')"""
-        strategy, search_value = determine_search_strategy('наталь')
-        self.assertEqual(strategy, 'universal')
-        self.assertEqual(search_value, 'наталь')
-
-    def test_universal_mixed(self):
-        """Query "Test123" (7 символов) должен вернуть ('universal', 'Test123')"""
-        strategy, search_value = determine_search_strategy('Test123')
-        self.assertEqual(strategy, 'universal')
-        self.assertEqual(search_value, 'Test123')
-
-    # ===== name_only: очень короткие запросы (< 3 символов без @) =====
-    def test_name_only_single_char(self):
-        """Query "t" должен вернуть ('name_only', 't')"""
-        strategy, search_value = determine_search_strategy('t')
-        self.assertEqual(strategy, 'name_only')
-        self.assertEqual(search_value, 't')
-
-    def test_name_only_two_chars(self):
-        """Query "te" должен вернуть ('name_only', 'te')"""
-        strategy, search_value = determine_search_strategy('te')
-        self.assertEqual(strategy, 'name_only')
-        self.assertEqual(search_value, 'te')
-
-    def test_name_only_two_chars_cyrillic(self):
-        """Query "на" (2 символа) должен вернуть ('name_only', 'на')"""
-        strategy, search_value = determine_search_strategy('на')
-        self.assertEqual(strategy, 'name_only')
-        self.assertEqual(search_value, 'на')
-
-    # ===== edge cases =====
-    def test_empty_string(self):
-        """Query "" должен вернуть ('name_only', '')"""
-        strategy, search_value = determine_search_strategy('')
-        self.assertEqual(strategy, 'name_only')
-        self.assertEqual(search_value, '')
-
-    def test_only_at_symbol(self):
-        """Query "@" должен вернуть ('email_domain', '')"""
-        strategy, search_value = determine_search_strategy('@')
-        self.assertEqual(strategy, 'email_domain')
-        self.assertEqual(search_value, '')
-
-    def test_multiple_at_symbols(self):
-        """Query "test@example@com" должен обработать первый @"""
-        strategy, search_value = determine_search_strategy('test@example@com')
-        self.assertEqual(strategy, 'email_full')
-        self.assertEqual(search_value, 'test@example@com')
-
-    def test_spaces_in_query(self):
-        """Query "Ivan Petrov" должен вернуть ('universal', 'Ivan Petrov')"""
-        strategy, search_value = determine_search_strategy('Ivan Petrov')
-        self.assertEqual(strategy, 'universal')
-        self.assertEqual(search_value, 'Ivan Petrov')
-
-    # ===== real-world examples =====
-    def test_real_world_problematic_case(self):
-        """
-        Real-world case: query "team_x3m@" не должен найти "natulj@bk.ru"
-        Используется email_prefix со istartswith вместо icontains
-        """
-        strategy, search_value = determine_search_strategy('team_x3m@')
-        self.assertEqual(strategy, 'email_prefix')
-        # Важно: стратегия email_prefix, не universal или email_full
-        self.assertNotEqual(strategy, 'universal')
-
-    def test_real_world_domain_search(self):
-        """Real-world case: query "@bk" должен найти все @bk.ru"""
-        strategy, search_value = determine_search_strategy('@bk')
-        self.assertEqual(strategy, 'email_domain')
-        self.assertEqual(search_value, 'bk')
-
-    def test_real_world_name_search(self):
-        """Real-world case: query "natul" должен найти "Наталья" и "natulj@bk.ru" """
-        strategy, search_value = determine_search_strategy('natul')
-        self.assertEqual(strategy, 'universal')
-        self.assertEqual(search_value, 'natul')
-
-
-class IsQueryPhoneOnlyTestCase(TestCase):
-    """
-    Тесты для функции is_query_phone_only().
-
-    Проверяют, что функция правильно определяет, содержит ли query
-    только символы номера телефона (цифры, +, -, (), пробелы).
-    """
-
-    # ===== Должны вернуть True (только телефонные символы) =====
-    def test_phone_only_digits(self):
-        """Query '295' должен вернуть True (только цифры)"""
-        self.assertTrue(is_query_phone_only('295'))
-
-    def test_phone_only_single_digit(self):
-        """Query '5' должен вернуть True (одна цифра)"""
-        self.assertTrue(is_query_phone_only('5'))
-
-    def test_phone_with_plus(self):
-        """Query '+375291234567' должен вернуть True"""
-        self.assertTrue(is_query_phone_only('+375291234567'))
-
-    def test_phone_with_dashes(self):
-        """Query '029-123-45' должен вернуть True"""
-        self.assertTrue(is_query_phone_only('029-123-45'))
-
-    def test_phone_with_parentheses(self):
-        """Query '(029) 123-45' должен вернуть True"""
-        self.assertTrue(is_query_phone_only('(029) 123-45'))
-
-    def test_phone_with_spaces(self):
-        """Query '029 123 45' должен вернуть True"""
-        self.assertTrue(is_query_phone_only('029 123 45'))
-
-    def test_phone_complex_format(self):
-        """Query '+375 (29) 123-45-67' должен вернуть True"""
-        self.assertTrue(is_query_phone_only('+375 (29) 123-45-67'))
-
-    def test_phone_with_dot(self):
-        """Query '029.123.45' должен вернуть True"""
-        self.assertTrue(is_query_phone_only('029.123.45'))
-
-    # ===== Должны вернуть False (содержат буквы или другие символы) =====
-    def test_query_with_letters_only(self):
-        """Query 'abc' должен вернуть False (содержит буквы)"""
-        self.assertFalse(is_query_phone_only('abc'))
-
-    def test_query_with_mixed_letters_digits(self):
-        """Query 'x3m' должен вернуть False (содержит буквы)"""
-        self.assertFalse(is_query_phone_only('x3m'))
-
-    def test_query_name_with_digits(self):
-        """Query 'team_x3m' должен вернуть False (содержит буквы и _)"""
-        self.assertFalse(is_query_phone_only('team_x3m'))
-
-    def test_query_name_cyrillic(self):
-        """Query 'Наталья' должен вернуть False (содержит кириллицу)"""
-        self.assertFalse(is_query_phone_only('Наталья'))
-
-    def test_query_with_underscore(self):
-        """Query '123_456' должен вернуть False (содержит _)"""
-        self.assertFalse(is_query_phone_only('123_456'))
-
-    def test_query_with_hash(self):
-        """Query '123#456' должен вернуть False (содержит #)"""
-        self.assertFalse(is_query_phone_only('123#456'))
-
-    def test_empty_string(self):
-        """Query '' должен вернуть False (пустая строка)"""
-        self.assertFalse(is_query_phone_only(''))
-
-    def test_only_spaces(self):
-        """Query '   ' должен вернуть True (только пробелы разрешены)"""
-        self.assertTrue(is_query_phone_only('   '))
-
-    # ===== Real-world cases =====
-    def test_real_world_case_x3m_should_not_be_phone(self):
-        """
-        Real-world case: "x3m" содержит букву, поэтому НЕ похож на телефон.
-        Это критично для решения проблемы с поиском Натальи.
-        """
-        self.assertFalse(is_query_phone_only('x3m'))
-        # Значит, при поиске "x3m" НЕ будет поиска по цифре "3" в телефонах
-
-    def test_real_world_case_295_should_be_phone(self):
-        """Real-world case: '295' только цифры, похож на телефон"""
-        self.assertTrue(is_query_phone_only('295'))
-
-    def test_real_world_full_phone_number(self):
-        """Real-world case: полный номер в стандартном формате"""
-        self.assertTrue(is_query_phone_only('+375 (29) 598-62-62'))

myproject/customers/tests/__init__.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+"""
+Тесты для модуля customers.
+
+Все тесты организованы по функциональным областям в отдельных модулях.
+"""
+from .test_search_strategies import DetermineSearchStrategyTestCase, IsQueryPhoneOnlyTestCase
+from .test_wallet_balance import WalletBalanceCalculationTestCase
+from .test_wallet_model import WalletTransactionModelTestCase
+from .test_wallet_service import WalletServiceTestCase
+from .test_system_customer import SystemCustomerProtectionTestCase
+
+__all__ = [
+    # Тесты стратегий поиска клиентов
+    'DetermineSearchStrategyTestCase',
+    'IsQueryPhoneOnlyTestCase',
+    
+    # Тесты баланса кошелька
+    'WalletBalanceCalculationTestCase',
+    
+    # Тесты модели транзакций
+    'WalletTransactionModelTestCase',
+    
+    # Тесты сервиса кошелька
+    'WalletServiceTestCase',
+    
+    # Тесты защиты системного клиента
+    'SystemCustomerProtectionTestCase',
+]

myproject/customers/tests/test_search_strategies.py

@@ -0,0 +1,203 @@
+# -*- coding: utf-8 -*-
+"""
+Тесты для функций поиска клиентов.
+
+Используем TenantTestCase для корректной работы с tenant-системой.
+"""
+from django_tenants.test.cases import TenantTestCase
+
+from customers.views import determine_search_strategy, is_query_phone_only
+
+
+class DetermineSearchStrategyTestCase(TenantTestCase):
+    """
+    Тесты для функции determine_search_strategy().
+    Компактная версия с параметризацией для избежания дублирования.
+    """
+
+    def _test_strategy(self, query, expected_strategy, expected_value):
+        """Вспомогательный метод для проверки стратегии."""
+        strategy, search_value = determine_search_strategy(query)
+        self.assertEqual(strategy, expected_strategy,
+                        f"Query '{query}' должен вернуть стратегию '{expected_strategy}'")
+        self.assertEqual(search_value, expected_value,
+                        f"Query '{query}' должен вернуть значение '{expected_value}'")
+
+    # ===== email_prefix: query заканчивается на @ =====
+    def test_email_prefix_strategy(self):
+        """Различные варианты поиска по префиксу email."""
+        test_cases = [
+            ('team_x3m@', 'team_x3m'),
+            ('user_name@', 'user_name'),
+            ('test123@', 'test123'),
+        ]
+        for query, expected_value in test_cases:
+            self._test_strategy(query, 'email_prefix', expected_value)
+
+    # ===== email_domain: query начинается с @ =====
+    def test_email_domain_strategy(self):
+        """Различные варианты поиска по домену email."""
+        test_cases = [
+            ('@bk', 'bk'),
+            ('@bk.ru', 'bk.ru'),
+            ('@mail.google.com', 'mail.google.com'),
+        ]
+        for query, expected_value in test_cases:
+            self._test_strategy(query, 'email_domain', expected_value)
+
+    # ===== email_full: query содержит и локальную часть, и домен =====
+    def test_email_full_strategy(self):
+        """Различные варианты полного поиска email."""
+        test_cases = [
+            ('test@bk.ru', 'test@bk.ru'),
+            ('test@bk', 'test@bk'),
+            ('user.name@mail.example.com', 'user.name@mail.example.com'),
+        ]
+        for query, expected_value in test_cases:
+            self._test_strategy(query, 'email_full', expected_value)
+
+    # ===== universal: query без @, 3+ символов =====
+    def test_universal_strategy(self):
+        """Универсальный поиск для запросов 3+ символов."""
+        test_cases = [
+            ('abc', 'abc'),  # минимум 3 символа
+            ('natul', 'natul'),
+            ('наталь', 'наталь'),  # кириллица
+            ('Test123', 'Test123'),  # смешанный
+            ('Ivan Petrov', 'Ivan Petrov'),  # с пробелами
+        ]
+        for query, expected_value in test_cases:
+            self._test_strategy(query, 'universal', expected_value)
+
+    # ===== name_only: очень короткие запросы (< 3 символов без @) =====
+    def test_name_only_strategy(self):
+        """Поиск только по имени для коротких запросов."""
+        test_cases = [
+            ('t', 't'),  # 1 символ
+            ('te', 'te'),  # 2 символа
+            ('на', 'на'),  # 2 символа кириллица
+            ('', ''),  # пустая строка
+        ]
+        for query, expected_value in test_cases:
+            self._test_strategy(query, 'name_only', expected_value)
+
+    # ===== edge cases =====
+    def test_edge_cases(self):
+        """Граничные и специальные случаи."""
+        # Только символ @
+        self._test_strategy('@', 'email_domain', '')
+        
+        # Множественные @ - берётся первый
+        self._test_strategy('test@example@com', 'email_full', 'test@example@com')
+
+    # ===== real-world критические сценарии =====
+    def test_real_world_email_prefix_no_false_match(self):
+        """
+        КРИТИЧНЫЙ: query 'team_x3m@' НЕ должен найти 'natulj@bk.ru'.
+        Проверяем, что используется email_prefix (istartswith), а не universal (icontains).
+        """
+        strategy, search_value = determine_search_strategy('team_x3m@')
+        self.assertEqual(strategy, 'email_prefix')
+        self.assertEqual(search_value, 'team_x3m')
+        # Важно: НЕ universal стратегия
+        self.assertNotEqual(strategy, 'universal')
+
+    def test_real_world_domain_search(self):
+        """Real-world: '@bk' находит все email с @bk.*"""
+        self._test_strategy('@bk', 'email_domain', 'bk')
+
+    def test_real_world_universal_search(self):
+        """Real-world: 'natul' находит и имя 'Наталья' и email 'natulj@bk.ru'"""
+        self._test_strategy('natul', 'universal', 'natul')
+
+
+class IsQueryPhoneOnlyTestCase(TenantTestCase):
+    """
+    Тесты для функции is_query_phone_only().
+
+    Проверяют, что функция правильно определяет, содержит ли query
+    только символы номера телефона (цифры, +, -, (), пробелы).
+    """
+
+    # ===== Должны вернуть True (только телефонные символы) =====
+    def test_phone_only_digits(self):
+        """Query '295' должен вернуть True (только цифры)"""
+        self.assertTrue(is_query_phone_only('295'))
+
+    def test_phone_only_single_digit(self):
+        """Query '5' должен вернуть True (одна цифра)"""
+        self.assertTrue(is_query_phone_only('5'))
+
+    def test_phone_with_plus(self):
+        """Query '+375291234567' должен вернуть True"""
+        self.assertTrue(is_query_phone_only('+375291234567'))
+
+    def test_phone_with_dashes(self):
+        """Query '029-123-45' должен вернуть True"""
+        self.assertTrue(is_query_phone_only('029-123-45'))
+
+    def test_phone_with_parentheses(self):
+        """Query '(029) 123-45' должен вернуть True"""
+        self.assertTrue(is_query_phone_only('(029) 123-45'))
+
+    def test_phone_with_spaces(self):
+        """Query '029 123 45' должен вернуть True"""
+        self.assertTrue(is_query_phone_only('029 123 45'))
+
+    def test_phone_complex_format(self):
+        """Query '+375 (29) 123-45-67' должен вернуть True"""
+        self.assertTrue(is_query_phone_only('+375 (29) 123-45-67'))
+
+    def test_phone_with_dot(self):
+        """Query '029.123.45' должен вернуть True"""
+        self.assertTrue(is_query_phone_only('029.123.45'))
+
+    # ===== Должны вернуть False (содержат буквы или другие символы) =====
+    def test_query_with_letters_only(self):
+        """Query 'abc' должен вернуть False (содержит буквы)"""
+        self.assertFalse(is_query_phone_only('abc'))
+
+    def test_query_with_mixed_letters_digits(self):
+        """Query 'x3m' должен вернуть False (содержит буквы)"""
+        self.assertFalse(is_query_phone_only('x3m'))
+
+    def test_query_name_with_digits(self):
+        """Query 'team_x3m' должен вернуть False (содержит буквы и _)"""
+        self.assertFalse(is_query_phone_only('team_x3m'))
+
+    def test_query_name_cyrillic(self):
+        """Query 'Наталья' должен вернуть False (содержит кириллицу)"""
+        self.assertFalse(is_query_phone_only('Наталья'))
+
+    def test_query_with_underscore(self):
+        """Query '123_456' должен вернуть False (содержит _)"""
+        self.assertFalse(is_query_phone_only('123_456'))
+
+    def test_query_with_hash(self):
+        """Query '123#456' должен вернуть False (содержит #)"""
+        self.assertFalse(is_query_phone_only('123#456'))
+
+    def test_empty_string(self):
+        """Query '' должен вернуть False (пустая строка)"""
+        self.assertFalse(is_query_phone_only(''))
+
+    def test_only_spaces(self):
+        """Query '   ' должен вернуть False (пустой запрос)"""
+        self.assertFalse(is_query_phone_only('   '))
+
+    # ===== Real-world cases =====
+    def test_real_world_case_x3m_should_not_be_phone(self):
+        """
+        Real-world case: "x3m" содержит букву, поэтому НЕ похож на телефон.
+        Это критично для решения проблемы с поиском Натальи.
+        """
+        self.assertFalse(is_query_phone_only('x3m'))
+        # Значит, при поиске "x3m" НЕ будет поиска по цифре "3" в телефонах
+
+    def test_real_world_case_295_should_be_phone(self):
+        """Real-world case: '295' только цифры, похож на телефон"""
+        self.assertTrue(is_query_phone_only('295'))
+
+    def test_real_world_full_phone_number(self):
+        """Real-world case: полный номер в стандартном формате"""
+        self.assertTrue(is_query_phone_only('+375 (29) 598-62-62'))

myproject/customers/tests/test_system_customer.py

@@ -0,0 +1,135 @@
+# -*- coding: utf-8 -*-
+"""
+Тесты защиты системного клиента от изменений и удаления.
+
+Системный клиент используется для анонимных продаж в POS системе
+и должен быть защищён от случайного изменения или удаления.
+
+Используем TenantTestCase для корректной работы с tenant-системой.
+"""
+from django.core.exceptions import ValidationError
+from django_tenants.test.cases import TenantTestCase
+
+from customers.models import Customer
+
+
+class SystemCustomerProtectionTestCase(TenantTestCase):
+    """
+    Тесты защиты системного клиента от изменений и удаления.
+    
+    Системный клиент используется для анонимных продаж в POS системе
+    и должен быть защищён от случайного изменения или удаления.
+    """
+
+    def setUp(self):
+        """Создаём системного клиента для тестов."""
+        self.system_customer, created = Customer.get_or_create_system_customer()
+        self.regular_customer = Customer.objects.create(
+            name="Обычный клиент",
+            email="regular@test.com"
+        )
+
+    def test_get_or_create_system_customer_creates_with_correct_attributes(self):
+        """
+        Метод get_or_create_system_customer() создаёт клиента с правильными атрибутами.
+        
+        Проверяем:
+        - Фиксированный email: system@pos.customer
+        - Флаг is_system_customer = True
+        - Правильное имя и заметки
+        """
+        # Удаляем существующего системного клиента для чистоты теста
+        Customer.objects.filter(is_system_customer=True).delete()
+        
+        # Создаём через метод класса
+        customer, created = Customer.get_or_create_system_customer()
+        
+        # Проверяем, что клиент действительно создан
+        self.assertTrue(created, "Системный клиент должен быть создан")
+        
+        # Проверяем атрибуты
+        self.assertEqual(customer.email, "system@pos.customer")
+        self.assertTrue(customer.is_system_customer)
+        self.assertEqual(customer.name, "АНОНИМНЫЙ ПОКУПАТЕЛЬ (POS)")
+        self.assertIn("SYSTEM_CUSTOMER", customer.notes)
+        
+        # Проверяем идемпотентность - повторный вызов возвращает того же клиента
+        customer2, created2 = Customer.get_or_create_system_customer()
+        self.assertFalse(created2, "Системный клиент не должен создаваться повторно")
+        self.assertEqual(customer.pk, customer2.pk, "Должен вернуться тот же клиент")
+
+    def test_system_customer_cannot_be_deleted(self):
+        """
+        Системный клиент защищён от удаления через метод delete().
+        
+        При попытке удаления должен подниматься ValidationError.
+        Это критично для работы POS системы.
+        """
+        with self.assertRaises(ValidationError) as context:
+            self.system_customer.delete()
+        
+        self.assertIn("Нельзя удалить системного клиента", str(context.exception))
+        
+        # Проверяем, что клиент действительно не удалён
+        self.assertTrue(
+            Customer.objects.filter(pk=self.system_customer.pk).exists(),
+            "Системный клиент не должен быть удалён"
+        )
+
+    def test_system_customer_email_cannot_be_changed(self):
+        """
+        Email системного клиента защищён от изменения.
+        
+        Фиксированный email "system@pos.customer" используется для поиска
+        системного клиента в POS системе. Изменение приведёт к сбоям.
+        """
+        original_email = self.system_customer.email
+        
+        # Пытаемся изменить email
+        self.system_customer.email = "hacker@evil.com"
+        
+        with self.assertRaises(ValidationError) as context:
+            self.system_customer.save()
+        
+        self.assertIn("Нельзя изменить email системного клиента", str(context.exception))
+        
+        # Проверяем, что email остался прежним в БД
+        self.system_customer.refresh_from_db()
+        self.assertEqual(self.system_customer.email, original_email)
+
+    def test_system_customer_flag_cannot_be_removed(self):
+        """
+        Флаг is_system_customer защищён от изменения.
+        
+        Нельзя "превратить" системного клиента в обычного,
+        это нарушит логику POS системы.
+        """
+        # Пытаемся снять флаг системного клиента
+        self.system_customer.is_system_customer = False
+        
+        with self.assertRaises(ValidationError) as context:
+            self.system_customer.save()
+        
+        self.assertIn("Нельзя изменить флаг системного клиента", str(context.exception))
+        
+        # Проверяем, что флаг остался True в БД
+        self.system_customer.refresh_from_db()
+        self.assertTrue(self.system_customer.is_system_customer)
+
+    def test_regular_customer_can_be_deleted_normally(self):
+        """
+        Обычный клиент (не системный) может быть удалён без ограничений.
+        
+        Защита применяется ТОЛЬКО к системному клиенту.
+        Это гарантирует, что мы не сломали обычный функционал удаления.
+        """
+        customer_pk = self.regular_customer.pk
+        
+        # Удаление должно пройти успешно
+        self.regular_customer.delete()
+        
+        # Проверяем, что клиент действительно удалён
+        self.assertFalse(
+            Customer.objects.filter(pk=customer_pk).exists(),
+            "Обычный клиент должен быть удалён"
+        )

myproject/customers/tests/test_wallet_balance.py

@@ -0,0 +1,111 @@
+# -*- coding: utf-8 -*-
+"""
+Тесты для вычисления баланса кошелька.
+
+Используем TenantTestCase для корректной работы с tenant-системой.
+"""
+from decimal import Decimal
+
+from django.core.cache import cache
+from django_tenants.test.cases import TenantTestCase
+
+from customers.models import Customer, WalletTransaction
+
+
+class WalletBalanceCalculationTestCase(TenantTestCase):
+    """Тесты вычисления баланса кошелька из транзакций."""
+
+    def setUp(self):
+        """Создаём тестового клиента и очищаем кеш."""
+        self.customer = Customer.objects.create(name="Тестовый клиент")
+        cache.clear()
+
+    def tearDown(self):
+        """Очищаем кеш после каждого теста."""
+        cache.clear()
+
+    def test_empty_wallet_returns_zero(self):
+        """Пустой кошелёк должен возвращать 0."""
+        self.assertEqual(self.customer.wallet_balance, Decimal('0'))
+
+    def test_single_deposit(self):
+        """Одно пополнение корректно учитывается."""
+        WalletTransaction.objects.create(
+            customer=self.customer,
+            signed_amount=Decimal('100.00'),
+            transaction_type='deposit',
+            balance_category='money'
+        )
+        cache.clear()
+        self.assertEqual(self.customer.wallet_balance, Decimal('100.00'))
+
+    def test_single_spend(self):
+        """Списание корректно учитывается (отрицательная сумма)."""
+        # Сначала пополняем
+        WalletTransaction.objects.create(
+            customer=self.customer,
+            signed_amount=Decimal('100.00'),
+            transaction_type='deposit',
+            balance_category='money'
+        )
+        # Затем списываем
+        WalletTransaction.objects.create(
+            customer=self.customer,
+            signed_amount=Decimal('-30.00'),
+            transaction_type='spend',
+            balance_category='money'
+        )
+        cache.clear()
+        self.assertEqual(self.customer.wallet_balance, Decimal('70.00'))
+
+    def test_multiple_operations(self):
+        """Несколько операций подряд вычисляются корректно."""
+        operations = [
+            ('deposit', Decimal('200.00')),
+            ('spend', Decimal('-50.00')),
+            ('deposit', Decimal('100.00')),
+            ('spend', Decimal('-80.00')),
+            ('adjustment', Decimal('10.00')),
+        ]
+
+        for txn_type, signed_amount in operations:
+            WalletTransaction.objects.create(
+                customer=self.customer,
+                signed_amount=signed_amount,
+                transaction_type=txn_type,
+                balance_category='money'
+            )
+
+        cache.clear()
+        # 200 - 50 + 100 - 80 + 10 = 180
+        self.assertEqual(self.customer.wallet_balance, Decimal('180.00'))
+
+    def test_amount_property_returns_absolute(self):
+        """Property amount возвращает абсолютное значение."""
+        txn = WalletTransaction.objects.create(
+            customer=self.customer,
+            signed_amount=Decimal('-50.00'),
+            transaction_type='spend',
+            balance_category='money'
+        )
+        self.assertEqual(txn.amount, Decimal('50.00'))
+
+    def test_cache_invalidation(self):
+        """Кеш инвалидируется методом invalidate_wallet_cache."""
+        # Первый вызов - баланс 0
+        self.assertEqual(self.customer.wallet_balance, Decimal('0'))
+
+        # Добавляем транзакцию напрямую (без сервиса)
+        WalletTransaction.objects.create(
+            customer=self.customer,
+            signed_amount=Decimal('100.00'),
+            transaction_type='deposit',
+            balance_category='money'
+        )
+
+        # Без инвалидации кеша - всё ещё 0 (закешировано)
+        self.assertEqual(self.customer.get_wallet_balance(use_cache=True), Decimal('0'))
+
+        # После инвалидации - 100
+        self.customer.invalidate_wallet_cache()
+        self.assertEqual(self.customer.wallet_balance, Decimal('100.00'))

myproject/customers/tests/test_wallet_model.py

@@ -0,0 +1,49 @@
+# -*- coding: utf-8 -*-
+"""
+Тесты для модели WalletTransaction.
+
+Используем TenantTestCase для корректной работы с tenant-системой.
+"""
+from decimal import Decimal
+
+from django.core.cache import cache
+from django_tenants.test.cases import TenantTestCase
+
+from customers.models import Customer, WalletTransaction
+
+
+class WalletTransactionModelTestCase(TenantTestCase):
+    """Тесты модели WalletTransaction."""
+
+    def setUp(self):
+        self.customer = Customer.objects.create(name="Тестовый клиент")
+        cache.clear()
+
+    def test_str_representation_positive(self):
+        """__str__ для положительной суммы содержит +."""
+        txn = WalletTransaction.objects.create(
+            customer=self.customer,
+            signed_amount=Decimal('100.00'),
+            transaction_type='deposit',
+            balance_category='money'
+        )
+        self.assertIn('+100', str(txn))
+
+    def test_str_representation_negative(self):
+        """__str__ для отрицательной суммы содержит -."""
+        txn = WalletTransaction.objects.create(
+            customer=self.customer,
+            signed_amount=Decimal('-50.00'),
+            transaction_type='spend',
+            balance_category='money'
+        )
+        self.assertIn('-50', str(txn))
+
+    def test_default_balance_category(self):
+        """По умолчанию balance_category = 'money'."""
+        txn = WalletTransaction.objects.create(
+            customer=self.customer,
+            signed_amount=Decimal('100.00'),
+            transaction_type='deposit'
+        )
+        self.assertEqual(txn.balance_category, 'money')

myproject/customers/tests/test_wallet_service.py

@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+"""
+Тесты для сервиса кошелька (WalletService).
+
+Используем TenantTestCase для корректной работы с tenant-системой.
+"""
+from decimal import Decimal
+
+from django.core.cache import cache
+from django_tenants.test.cases import TenantTestCase
+
+from customers.models import Customer
+from customers.services.wallet_service import WalletService
+
+
+class WalletServiceTestCase(TenantTestCase):
+    """Тесты WalletService."""
+
+    def setUp(self):
+        """Создаём тестового клиента."""
+        self.customer = Customer.objects.create(name="Тестовый клиент")
+        cache.clear()
+
+    def tearDown(self):
+        cache.clear()
+
+    def test_create_transaction_deposit(self):
+        """create_transaction создаёт пополнение с положительной суммой."""
+        txn = WalletService.create_transaction(
+            customer=self.customer,
+            amount=Decimal('50.00'),
+            transaction_type='deposit',
+            description='Тестовое пополнение'
+        )
+
+        self.assertEqual(txn.signed_amount, Decimal('50.00'))
+        self.assertEqual(txn.transaction_type, 'deposit')
+        self.assertEqual(txn.balance_after, Decimal('50.00'))
+        self.assertEqual(self.customer.wallet_balance, Decimal('50.00'))
+
+    def test_create_transaction_spend(self):
+        """create_transaction создаёт списание с отрицательной суммой."""
+        # Сначала пополняем
+        WalletService.create_transaction(
+            customer=self.customer,
+            amount=Decimal('100.00'),
+            transaction_type='deposit'
+        )
+
+        # Затем списываем
+        txn = WalletService.create_transaction(
+            customer=self.customer,
+            amount=Decimal('30.00'),
+            transaction_type='spend',
+            description='Тестовое списание'
+        )
+
+        self.assertEqual(txn.signed_amount, Decimal('-30.00'))
+        self.assertEqual(txn.transaction_type, 'spend')
+        self.assertEqual(txn.balance_after, Decimal('70.00'))
+        self.assertEqual(self.customer.wallet_balance, Decimal('70.00'))
+
+    def test_create_transaction_spend_insufficient_funds(self):
+        """Списание при недостаточном балансе вызывает ValueError."""
+        with self.assertRaises(ValueError) as context:
+            WalletService.create_transaction(
+                customer=self.customer,
+                amount=Decimal('100.00'),
+                transaction_type='spend'
+            )
+
+        self.assertIn('Недостаточно средств', str(context.exception))
+
+    def test_adjust_balance_positive(self):
+        """Положительная корректировка увеличивает баланс."""
+        txn = WalletService.adjust_balance(
+            customer_id=self.customer.pk,
+            amount=Decimal('75.00'),
+            description='Тестовое пополнение администратором',
+            user=None
+        )
+
+        self.assertEqual(txn.signed_amount, Decimal('75.00'))
+        self.assertEqual(txn.transaction_type, 'adjustment')
+        self.assertEqual(self.customer.wallet_balance, Decimal('75.00'))
+
+    def test_adjust_balance_negative(self):
+        """Отрицательная корректировка уменьшает баланс."""
+        # Сначала пополняем
+        WalletService.adjust_balance(
+            customer_id=self.customer.pk,
+            amount=Decimal('100.00'),
+            description='Начальное пополнение',
+            user=None
+        )
+
+        # Отрицательная корректировка
+        txn = WalletService.adjust_balance(
+            customer_id=self.customer.pk,
+            amount=Decimal('-40.00'),
+            description='Списание администратором',
+            user=None
+        )
+
+        self.assertEqual(txn.signed_amount, Decimal('-40.00'))
+        self.assertEqual(self.customer.wallet_balance, Decimal('60.00'))
+
+    def test_adjust_balance_negative_insufficient(self):
+        """Отрицательная корректировка с недостаточным балансом вызывает ValueError."""
+        with self.assertRaises(ValueError) as context:
+            WalletService.adjust_balance(
+                customer_id=self.customer.pk,
+                amount=Decimal('-50.00'),
+                description='Списание',
+                user=None
+            )
+
+        self.assertIn('отрицательному балансу', str(context.exception))
+
+    def test_adjust_balance_requires_description(self):
+        """Корректировка без описания вызывает ValueError."""
+        with self.assertRaises(ValueError) as context:
+            WalletService.adjust_balance(
+                customer_id=self.customer.pk,
+                amount=Decimal('50.00'),
+                description='',
+                user=None
+            )
+
+        self.assertIn('Описание обязательно', str(context.exception))
+
+    def test_adjust_balance_zero_amount_fails(self):
+        """Корректировка с нулевой суммой вызывает ValueError."""
+        with self.assertRaises(ValueError) as context:
+            WalletService.adjust_balance(
+                customer_id=self.customer.pk,
+                amount=Decimal('0'),
+                description='Нулевая корректировка',
+                user=None
+            )
+
+        self.assertIn('не может быть нулевой', str(context.exception))

myproject/customers/urls.py

@@ -6,11 +6,21 @@ app_name = 'customers'
 urlpatterns = [
     path('', views.customer_list, name='customer-list'),
     path('create/', views.customer_create, name='customer-create'),
+    path('import/', views.customer_import, name='customer-import'),
+    path('import/download-errors/', views.customer_import_download_errors, name='customer-import-download-errors'),
+    path('export/', views.customer_export, name='customer-export'),
     path('<int:pk>/', views.customer_detail, name='customer-detail'),
-    path('<int:pk>/edit/', views.customer_update, name='customer-update'),
     path('<int:pk>/delete/', views.customer_delete, name='customer-delete'),
+    path('<int:pk>/wallet/deposit/', views.wallet_deposit, name='wallet-deposit'),
+    path('<int:pk>/wallet/withdraw/', views.wallet_withdraw, name='wallet-withdraw'),
+
+    # Contact channels
+    path('<int:customer_pk>/channels/add/', views.add_contact_channel, name='add-contact-channel'),
+    path('channels/<int:pk>/delete/', views.delete_contact_channel, name='delete-contact-channel'),
 
     # AJAX API endpoints
     path('api/search/', views.api_search_customers, name='api-search-customers'),
     path('api/create/', views.api_create_customer, name='api-create-customer'),
+    path('api/system/', views.api_get_system_customer, name='api-get-system-customer'),
+    path('<int:pk>/api/update/', views.api_update_customer, name='api-update-customer'),
 ]

myproject/customers/views.py

@@ -1,15 +1,19 @@
 from django.shortcuts import render, get_object_or_404, redirect
 from django.contrib import messages
 from django.core.paginator import Paginator
-from django.core.exceptions import ValidationError
-from django.db.models import Q
+from django.core.exceptions import ValidationError, PermissionDenied
+from django.db.models import Q, Sum, F, Value, DecimalField
+from django.db.models.functions import Greatest, Coalesce
 from django.http import JsonResponse
 from django.views.decorators.http import require_http_methods
 from django.contrib.auth.decorators import login_required
+from user_roles.decorators import manager_or_owner_required, owner_required
 import phonenumbers
 import json
-from .models import Customer
-from .forms import CustomerForm
+from decimal import Decimal
+from .models import Customer, ContactChannel
+from .forms import CustomerForm, ContactChannelForm
+from .filters import CustomerFilter
 
 
 def normalize_query_phone(q):
@@ -25,54 +29,69 @@ def normalize_query_phone(q):
 
 def customer_list(request):
     """Список всех клиентов"""
-    query = request.GET.get('q')
+    query = request.GET.get('q', '').strip()
+    
     # Исключаем системного клиента из списка
     customers = Customer.objects.filter(is_system_customer=False)
-
+    
+    # Применяем фильтры django-filter
+    customer_filter = CustomerFilter(request.GET, queryset=customers)
+    customers = customer_filter.qs
+    
     if query:
-        # Используем ту же логику поиска, что и в AJAX API (api_search_customers)
-        # Это обеспечивает согласованность между веб-интерфейсом и API
-
         # Нормализуем номер телефона
         phone_normalized = normalize_query_phone(query)
-
+        
         # Определяем стратегию поиска
         strategy, search_value = determine_search_strategy(query)
-
-        # Строим Q-объект для поиска (единая функция)
+        
+        # Строим Q-объект для поиска
         q_objects = build_customer_search_query(query, strategy, search_value)
-
-        # Добавляем поиск по телефону (умная логика)
+        
+        # Добавляем поиск по телефону
         if phone_normalized:
             q_objects |= Q(phone__icontains=phone_normalized)
-
-        # Проверяем, похож ли query на номер телефона (только цифры и минимум 3 цифры)
+        
+        # Поиск по цифрам телефона
         query_digits = ''.join(c for c in query if c.isdigit())
         should_search_by_phone_digits = is_query_phone_only(query) and len(query_digits) >= 3
-
+        
         if should_search_by_phone_digits:
-            # Ищем клиентов, чьи телефоны содержат введенные цифры
-            # Используем LIKE запрос вместо Python loop для оптимизации при большом количестве клиентов
             customers_by_phone = Customer.objects.filter(
                 phone__isnull=False,
-                phone__icontains=query_digits  # Простой поиск по цифрам в phone строке
+                phone__icontains=query_digits
             )
-
             if customers_by_phone.exists():
                 q_objects |= Q(pk__in=customers_by_phone.values_list('pk', flat=True))
 
-        customers = customers.filter(q_objects)
+        # Поиск по каналам связи (Instagram, Telegram и т.д.)
+        channel_matches = ContactChannel.objects.filter(
+            value__icontains=query
+        ).values_list('customer_id', flat=True)
+        if channel_matches:
+            q_objects |= Q(pk__in=channel_matches)
 
+        customers = customers.filter(q_objects)
+    
     customers = customers.order_by('-created_at')
     
     # Пагинация
-    paginator = Paginator(customers, 25)  # 25 клиентов на страницу
+    paginator = Paginator(customers, 25)
     page_number = request.GET.get('page')
     page_obj = paginator.get_page(page_number)
     
+    # Подготовка формы экспорта и настроек из сессии
+    from .forms import CustomerExportForm
+    export_form = CustomerExportForm(user=request.user)
+    export_preferences = request.session.get('customer_export_preferences', {})
+
     context = {
         'page_obj': page_obj,
         'query': query,
+        'total_customers': paginator.count,  # Используем count из paginator, чтобы избежать дублирования SQL запроса
+        'filter': customer_filter,  # Добавляем фильтр в контекст
+        'export_form': export_form,  # Форма экспорта для модального окна
+        'export_preferences': export_preferences,  # Сохранённые настройки экспорта
     }
     return render(request, 'customers/customer_list.html', context)
 
@@ -85,9 +104,45 @@ def customer_detail(request, pk):
     if customer.is_system_customer:
         return render(request, 'customers/customer_system.html')
 
-    # Рассчитываем общий долг по активным заказам
-    active_orders = customer.orders.exclude(payment_status='paid')
-    total_debt = sum(order.amount_due for order in active_orders)
+    # Рассчитываем общий долг по заказам на стороне БД
+    # Долг = все заказы КРОМЕ отмененных и полностью оплаченных
+    # ВКЛЮЧАЕТ завершенные заказы с неполной оплатой!
+    total_debt_result = customer.orders.exclude(
+        Q(status__is_negative_end=True) |  # Отмененные → учитываются в refund_amount
+        Q(payment_status='paid')  # Полностью оплаченные
+    ).aggregate(
+        total_debt=Coalesce(
+            Sum(Greatest(F('total_amount') - F('amount_paid'), Value(0), output_field=DecimalField())),
+            Value(0),
+            output_field=DecimalField()
+        )
+    )
+    total_debt = total_debt_result['total_debt'] or Decimal('0')
+
+    # Количество заказов с долгом (с той же логикой)
+    active_orders_count = customer.orders.exclude(
+        Q(status__is_negative_end=True) |
+        Q(payment_status='paid')
+    ).count()
+
+    # Сумма к возврату (отмененные заказы с оплатой)
+    refund_amount_result = customer.orders.filter(
+        status__is_negative_end=True,  # Отмененные
+        amount_paid__gt=0  # С оплатой
+    ).aggregate(
+        total_refund=Coalesce(
+            Sum('amount_paid'),
+            Value(0),
+            output_field=DecimalField()
+        )
+    )
+    refund_amount = refund_amount_result['total_refund'] or Decimal('0')
+
+    # Сумма всех успешных заказов
+    total_orders_sum = customer.get_successful_orders_total()
+
+    # Сумма успешных заказов за последний год
+    last_year_orders_sum = customer.get_last_year_orders_total()
 
     # История транзакций кошелька (последние 20)
     from .models import WalletTransaction
@@ -95,18 +150,25 @@ def customer_detail(request, pk):
         customer=customer
     ).select_related('order', 'created_by').order_by('-created_at')[:20]
 
-    # История заказов с пагинацией
-    orders_list = customer.orders.all().order_by('-created_at')
+    # История заказов с пагинацией и оптимизацией запросов
+    orders_list = customer.orders.select_related('status', 'delivery').order_by('-created_at')
     paginator = Paginator(orders_list, 10)  # 10 заказов на страницу
     page_number = request.GET.get('page')
     orders_page = paginator.get_page(page_number)
 
+    # Каналы связи клиента
+    contact_channels = customer.contact_channels.all()
+
     context = {
         'customer': customer,
         'total_debt': total_debt,
-        'active_orders_count': active_orders.count(),
+        'active_orders_count': active_orders_count,
+        'refund_amount': refund_amount,
         'wallet_transactions': wallet_transactions,
         'orders_page': orders_page,
+        'total_orders_sum': total_orders_sum,
+        'last_year_orders_sum': last_year_orders_sum,
+        'contact_channels': contact_channels,
     }
     return render(request, 'customers/customer_detail.html', context)
 
@@ -125,30 +187,6 @@ def customer_create(request):
     return render(request, 'customers/customer_form.html', {'form': form, 'is_creating': True})
 
 
-def customer_update(request, pk):
-    """Редактирование клиента"""
-    customer = get_object_or_404(Customer, pk=pk)
-
-    # Проверяем, не системный ли это клиент
-    if customer.is_system_customer:
-        messages.warning(request, 'Системный клиент не может быть изменен. Он создается автоматически и необходим для корректной работы системы.')
-        return redirect('customers:customer-detail', pk=pk)
-
-    if request.method == 'POST':
-        form = CustomerForm(request.POST, instance=customer)
-        if form.is_valid():
-            try:
-                form.save()
-                messages.success(request, f'Клиент {customer.full_name} успешно обновлён.')
-                return redirect('customers:customer-detail', pk=customer.pk)
-            except ValidationError as e:
-                messages.error(request, str(e))
-    else:
-        form = CustomerForm(instance=customer)
-
-    return render(request, 'customers/customer_form.html', {'form': form, 'is_creating': False})
-
-
 def customer_delete(request, pk):
     """Удаление клиента"""
     customer = get_object_or_404(Customer, pk=pk)
@@ -174,6 +212,48 @@ def customer_delete(request, pk):
     return render(request, 'customers/customer_confirm_delete.html', context)
 
 
+# === CONTACT CHANNELS ===
+
+@require_http_methods(["POST"])
+def add_contact_channel(request, customer_pk):
+    """Добавить канал связи клиенту"""
+    customer = get_object_or_404(Customer, pk=customer_pk)
+
+    if customer.is_system_customer:
+        messages.error(request, 'Нельзя добавлять каналы связи системному клиенту.')
+        return redirect('customers:customer-detail', pk=customer_pk)
+
+    form = ContactChannelForm(request.POST)
+    if form.is_valid():
+        channel = form.save(commit=False)
+        channel.customer = customer
+        channel.save()
+        messages.success(request, f'Канал "{channel.get_channel_type_display()}" добавлен')
+    else:
+        for field, errors in form.errors.items():
+            for error in errors:
+                messages.error(request, error)
+
+    return redirect('customers:customer-detail', pk=customer_pk)
+
+
+@require_http_methods(["POST"])
+def delete_contact_channel(request, pk):
+    """Удалить канал связи"""
+    channel = get_object_or_404(ContactChannel, pk=pk)
+    customer_pk = channel.customer.pk
+
+    if channel.customer.is_system_customer:
+        messages.error(request, 'Нельзя удалять каналы связи системного клиента.')
+        return redirect('customers:customer-detail', pk=customer_pk)
+
+    channel_name = channel.get_channel_type_display()
+    channel.delete()
+    messages.success(request, f'Канал "{channel_name}" удалён')
+
+    return redirect('customers:customer-detail', pk=customer_pk)
+
+
 # === AJAX API ENDPOINTS ===
 
 def determine_search_strategy(query):
@@ -228,9 +308,13 @@ def is_query_phone_only(query):
 
     Возвращает True, если query состоит ТОЛЬКО из:
     - цифр: 0-9
-    - телефонных символов: +, -, (, ), пробелов
+    - телефонных символов: +, -, (, ), пробелов, точек
+    
+    И ОБЯЗАТЕЛЬНО содержит хотя бы одну цифру.
 
-    Возвращает False, если есть буквы или другие символы (означает, что это поиск по имени/email).
+    Возвращает False, если:
+    - есть буквы или другие символы (означает, что это поиск по имени/email)
+    - query пустой или состоит только из пробелов
 
     Примеры:
     - '295' → True (только цифры)
@@ -239,13 +323,19 @@ def is_query_phone_only(query):
     - 'x3m' → False (содержит буквы)
     - 'team_x3m' → False (содержит буквы)
     - 'Иван' → False (содержит буквы)
+    - '   ' → False (только пробелы, нет цифр)
+    - '' → False (пустая строка)
     """
-    if not query:
+    if not query or not query.strip():
         return False
 
     # Проверяем, что query содержит ТОЛЬКО цифры и телефонные символы
     phone_chars = set('0123456789+- ().')
-    return all(c in phone_chars for c in query)
+    if not all(c in phone_chars for c in query):
+        return False
+    
+    # Проверяем, что есть хотя бы одна цифра
+    return any(c.isdigit() for c in query)
 
 
 def build_customer_search_query(query, strategy, search_value):
@@ -286,6 +376,39 @@ def build_customer_search_query(query, strategy, search_value):
         return Q(name__icontains=query)
 
 
+@require_http_methods(["GET"])
+def api_get_system_customer(request):
+    """
+    AJAX endpoint для получения системного (анонимного) клиента.
+
+    Возвращает JSON с данными системного клиента:
+    {
+        "success": true,
+        "customer": {
+            "id": 1,
+            "text": "АНОНИМНЫЙ ПОКУПАТЕЛЬ (POS)",
+            "name": "АНОНИМНЫЙ ПОКУПАТЕЛЬ (POS)",
+            "phone": "",
+            "email": "system@pos.customer",
+            "is_system_customer": true
+        }
+    }
+    """
+    system_customer, _ = Customer.get_or_create_system_customer()
+
+    return JsonResponse({
+        'success': True,
+        'customer': {
+            'id': system_customer.pk,
+            'text': system_customer.name,
+            'name': system_customer.name,
+            'phone': str(system_customer.phone) if system_customer.phone else '',
+            'email': system_customer.email,
+            'is_system_customer': True,
+        }
+    })
+
+
 @require_http_methods(["GET"])
 def api_search_customers(request):
     """
@@ -358,8 +481,16 @@ def api_search_customers(request):
         if customers_by_phone.exists():
             q_objects |= Q(pk__in=customers_by_phone.values_list('pk', flat=True))
 
-    # Исключаем системного клиента из результатов поиска
-    customers = Customer.objects.filter(q_objects).filter(is_system_customer=False).distinct().order_by('name')[:20]
+    # Поиск по каналам связи (Instagram, Telegram и т.д.)
+    channel_matches = ContactChannel.objects.filter(
+        value__icontains=query
+    ).values_list('customer_id', flat=True)
+
+    if channel_matches:
+        q_objects |= Q(pk__in=channel_matches)
+
+    # Включаем всех клиентов, включая системного (для возможности выбора в заказах)
+    customers = Customer.objects.filter(q_objects).distinct().order_by('name')[:20]
 
     results = []
 
@@ -376,6 +507,8 @@ def api_search_customers(request):
             'name': customer.name,
             'phone': phone_display,
             'email': customer.email,
+            'wallet_balance': float(customer.wallet_balance),
+            'is_system_customer': customer.is_system_customer,
         })
 
     # Если ничего не найдено, предлагаем создать нового клиента
@@ -393,6 +526,101 @@ def api_search_customers(request):
     })
 
 
+@require_http_methods(["POST"])
+def api_update_customer(request, pk):
+    """
+    AJAX endpoint для обновления отдельного поля клиента (inline-редактирование).
+
+    Принимает POST JSON:
+    {
+        "field": "name",
+        "value": "Новое имя"
+    }
+
+    Возвращает JSON:
+    {
+        "success": true,
+        "value": "Новое имя"
+    }
+
+    При ошибке:
+    {
+        "success": false,
+        "error": "Текст ошибки"
+    }
+    """
+    customer = get_object_or_404(Customer, pk=pk)
+
+    # Защита системного клиента
+    if customer.is_system_customer:
+        return JsonResponse({
+            'success': False,
+            'error': 'Системный клиент не может быть изменён'
+        }, status=403)
+
+    try:
+        data = json.loads(request.body)
+        field = data.get('field')
+        value = data.get('value', '').strip()
+
+        # Разрешённые поля для редактирования
+        allowed_fields = ['name', 'phone', 'email', 'notes']
+        if field not in allowed_fields:
+            return JsonResponse({
+                'success': False,
+                'error': f'Поле "{field}" недоступно для редактирования'
+            }, status=400)
+
+        # Валидация через форму
+        form_data = {field: value if value else None}
+        form = CustomerForm(form_data, instance=customer)
+
+        # Проверяем только нужное поле
+        if field in form.fields:
+            form.fields[field].required = False
+            field_value = form.fields[field].clean(value if value else None)
+
+            # Обновляем поле
+            setattr(customer, field, field_value)
+            customer.save(update_fields=[field, 'updated_at'])
+
+            # Возвращаем отформатированное значение
+            display_value = getattr(customer, field)
+            if display_value is None:
+                display_value = ''
+            elif field == 'phone' and display_value:
+                display_value = str(display_value)
+            else:
+                display_value = str(display_value)
+
+            return JsonResponse({
+                'success': True,
+                'value': display_value
+            })
+
+        return JsonResponse({
+            'success': False,
+            'error': 'Неизвестное поле'
+        }, status=400)
+
+    except json.JSONDecodeError:
+        return JsonResponse({
+            'success': False,
+            'error': 'Некорректный JSON'
+        }, status=400)
+    except ValidationError as e:
+        error_msg = e.message if hasattr(e, 'message') else str(e)
+        return JsonResponse({
+            'success': False,
+            'error': error_msg
+        }, status=400)
+    except Exception as e:
+        return JsonResponse({
+            'success': False,
+            'error': str(e)
+        }, status=400)
+
+
 @require_http_methods(["POST"])
 def api_create_customer(request):
     """
@@ -450,6 +678,7 @@ def api_create_customer(request):
                 'name': customer.name,
                 'phone': phone_display,
                 'email': customer.email if customer.email else '',
+                'wallet_balance': float(customer.wallet_balance),
             }, status=201)
         else:
             # Собираем ошибки валидации с указанием полей
@@ -484,3 +713,279 @@ def api_create_customer(request):
             'success': False,
             'error': f'Ошибка сервера: {str(e)}'
         }, status=500)
+
+
+@manager_or_owner_required
+@require_http_methods(["POST"])
+def wallet_deposit(request, pk):
+    """Пополнение кошелька клиента"""
+    customer = get_object_or_404(Customer, pk=pk)
+
+    if customer.is_system_customer:
+        messages.error(request, 'Операции с кошельком недоступны для системного клиента.')
+        return redirect('customers:customer-detail', pk=pk)
+
+    amount_str = request.POST.get('amount') or ''
+    description = (request.POST.get('description') or '').strip()
+
+    try:
+        amount = Decimal(amount_str.replace(',', '.'))
+    except Exception:
+        messages.error(request, 'Некорректное значение суммы для пополнения.')
+        return redirect('customers:customer-detail', pk=pk)
+
+    try:
+        customer.adjust_wallet(amount, description, request.user)
+        messages.success(request, f'Кошелёк клиента пополнен на {amount:.2f} руб.')
+    except ValueError as e:
+        messages.error(request, str(e))
+    except ValidationError as e:
+        messages.error(request, '; '.join(e.messages) if hasattr(e, 'messages') else str(e))
+
+    return redirect('customers:customer-detail', pk=pk)
+
+
+@manager_or_owner_required
+@require_http_methods(["POST"])
+def wallet_withdraw(request, pk):
+    """Возврат / списание с кошелька клиента"""
+    customer = get_object_or_404(Customer, pk=pk)
+
+    if customer.is_system_customer:
+        messages.error(request, 'Операции с кошельком недоступны для системного клиента.')
+        return redirect('customers:customer-detail', pk=pk)
+
+    amount_str = request.POST.get('amount') or ''
+    description = (request.POST.get('description') or '').strip()
+
+    try:
+        amount = Decimal(amount_str.replace(',', '.'))
+    except Exception:
+        messages.error(request, 'Некорректное значение суммы для списания.')
+        return redirect('customers:customer-detail', pk=pk)
+
+    # Для списания делаем сумму отрицательной
+    withdraw_amount = -amount
+
+    try:
+        customer.adjust_wallet(withdraw_amount, description, request.user)
+        messages.success(request, f'С кошелька клиента списано {amount:.2f} руб.')
+    except ValueError as e:
+        messages.error(request, str(e))
+    except ValidationError as e:
+        messages.error(request, '; '.join(e.messages) if hasattr(e, 'messages') else str(e))
+
+    return redirect('customers:customer-detail', pk=pk)
+
+
+@login_required
+@manager_or_owner_required
+def customer_import(request):
+    """
+    Импорт клиентов из CSV/Excel файла.
+    """
+    import os
+    from pathlib import Path
+    from django.conf import settings
+    from .services.import_export import CustomerImporter
+    
+    if request.method == 'POST':
+        file = request.FILES.get('file')
+        update_existing = request.POST.get('update_existing') == 'on'
+        
+        if not file:
+            messages.error(request, 'Файл не был загружен.')
+            return redirect('customers:customer-import')
+        
+        # Выполняем импорт
+        importer = CustomerImporter()
+        result = importer.import_from_file(file, update_existing=update_existing)
+        
+        # Формируем сообщения о результате
+        if result['success']:
+            success_parts = []
+            if result['created'] > 0:
+                success_parts.append(f"создано {result['created']}")
+            if result['enriched'] > 0:
+                success_parts.append(f"дополнено {result['enriched']}")
+            if result['updated'] > 0:
+                success_parts.append(f"обновлено {result['updated']}")
+            
+            success_msg = f"Импорт завершён: {', '.join(success_parts) if success_parts else 'нет изменений'}"
+            
+            if result.get('duplicate_count', 0) > 0:
+                success_msg += f", пропущено дубликатов: {result['duplicate_count']}"
+            if result.get('conflicts_resolved', 0) > 0:
+                success_msg += f", создано альтернативных контактов: {result['conflicts_resolved']}"
+            
+            messages.success(request, success_msg)
+        else:
+            messages.error(request, result['message'])
+        
+        # Если есть реальные ошибки валидации - генерируем файл
+        if result.get('real_error_count', 0) > 0:
+            error_file_data = importer.generate_error_file()
+            
+            if error_file_data:
+                content, filename = error_file_data
+                
+                # Сохраняем временный файл
+                temp_dir = Path(settings.MEDIA_ROOT) / 'temp_imports'
+                temp_dir.mkdir(parents=True, exist_ok=True)
+                
+                temp_file_path = temp_dir / filename
+                with open(temp_file_path, 'wb') as f:
+                    f.write(content)
+                
+                # Сохраняем путь в сессии
+                request.session['import_error_file'] = str(temp_file_path)
+                request.session['import_error_filename'] = filename
+                
+                messages.warning(
+                    request,
+                    f'Обнаружено {result["real_error_count"]} ошибок валидации. '
+                    f'Скачайте файл с ошибками для исправления.'
+                )
+        
+        # Передаём результаты в шаблон
+        context = {
+            'title': 'Импорт клиентов',
+            'import_result': result,
+            'has_error_file': 'import_error_file' in request.session,
+        }
+        return render(request, 'customers/customer_import.html', context)
+    
+    context = {
+        'title': 'Импорт клиентов',
+    }
+    return render(request, 'customers/customer_import.html', context)
+
+
+@login_required
+@manager_or_owner_required
+def customer_import_download_errors(request):
+    """
+    Скачивание файла с ошибками импорта и немедленное удаление.
+    """
+    import os
+    from django.http import FileResponse, Http404
+    
+    file_path = request.session.get('import_error_file')
+    filename = request.session.get('import_error_filename', 'errors.csv')
+    
+    if not file_path or not os.path.exists(file_path):
+        messages.error(request, 'Файл с ошибками не найден или уже был удалён.')
+        return redirect('customers:customer-import')
+    
+    try:
+        # Открываем файл для чтения
+        response = FileResponse(
+            open(file_path, 'rb'),
+            as_attachment=True,
+            filename=filename
+        )
+        
+        # Удаляем из сессии
+        del request.session['import_error_file']
+        del request.session['import_error_filename']
+        
+        # Планируем удаление файла после отправки
+        # (FileResponse закроет файл автоматически, затем удаляем)
+        def cleanup_file():
+            try:
+                if os.path.exists(file_path):
+                    os.remove(file_path)
+            except Exception:
+                pass
+        
+        # Django FileResponse автоматически закрывает файл после отправки
+        # Используем middleware или сигнал для очистки, но проще - удалим сразу после response
+        # Поскольку FileResponse читает файл в память при малом размере, удаляем сразу
+        import atexit
+        atexit.register(cleanup_file)
+        
+        # Альтернатива: читаем файл в память и сразу удаляем
+        with open(file_path, 'rb') as f:
+            file_content = f.read()
+        
+        # Удаляем файл немедленно
+        try:
+            os.remove(file_path)
+        except Exception:
+            pass
+        
+        # Возвращаем содержимое из памяти
+        from django.http import HttpResponse
+        response = HttpResponse(file_content, content_type='application/octet-stream')
+        response['Content-Disposition'] = f'attachment; filename="{filename}"'
+        
+        return response
+        
+    except Exception as e:
+        messages.error(request, f'Ошибка при скачивании файла: {str(e)}')
+        return redirect('customers:customer-import')
+
+
+@login_required
+@owner_required
+def customer_export(request):
+    """
+    Экспорт клиентов в CSV/XLSX файл.
+
+    GET: Перенаправление на список клиентов
+    POST: Обработка экспорта с выбранными полями и форматом
+
+    Поддерживает фильтрацию - экспортирует только клиентов, соответствующих текущим фильтрам.
+    Доступен только владельцу (OWNER) и superuser.
+    """
+    from .services.import_export import CustomerExporter
+    from .forms import CustomerExportForm
+    from .filters import CustomerFilter
+
+    # Базовый queryset (исключаем системного клиента)
+    queryset = Customer.objects.filter(is_system_customer=False)
+
+    # Применяем фильтры (та же логика что в customer_list)
+    customer_filter = CustomerFilter(request.GET, queryset=queryset)
+    filtered_queryset = customer_filter.qs
+
+    # GET запрос: перенаправление на список клиентов
+    if request.method != 'POST':
+        messages.info(
+            request,
+            'Используйте кнопку "Экспорт" в списке клиентов для настройки экспорта.'
+        )
+        return redirect('customers:customer-list')
+
+    # POST запрос: обработка экспорта
+    form = CustomerExportForm(request.POST, user=request.user)
+
+    if not form.is_valid():
+        messages.error(request, 'Ошибка в настройках экспорта. Выберите хотя бы одно поле.')
+        return redirect('customers:customer-list')
+
+    # Получение конфигурации экспорта
+    selected_fields = form.cleaned_data['selected_fields']
+    export_format = form.cleaned_data['export_format']
+
+    # Сохранение настроек в сессии
+    request.session['customer_export_preferences'] = {
+        'selected_fields': selected_fields,
+        'format': export_format,
+    }
+
+    # Оптимизация запроса (prefetch contact channels)
+    filtered_queryset = filtered_queryset.prefetch_related('contact_channels').order_by('-created_at')
+
+    # Создание экспортера с отфильтрованным queryset
+    exporter = CustomerExporter(
+        queryset=filtered_queryset,
+        selected_fields=selected_fields,
+        user=request.user
+    )
+
+    # Генерация и возврат файла экспорта
+    if export_format == 'xlsx':
+        return exporter.export_to_xlsx()
+    else:
+        return exporter.export_to_csv()

myproject/discounts/__init__.py

@@ -0,0 +1 @@
+default_app_config = 'discounts.apps.DiscountsConfig'

myproject/discounts/admin.py

@@ -0,0 +1,222 @@
+# -*- coding: utf-8 -*-
+from django.contrib import admin
+from .models import Discount, PromoCode, DiscountApplication
+
+
+@admin.register(Discount)
+class DiscountAdmin(admin.ModelAdmin):
+    """Админ-панель для управления скидками."""
+    list_display = [
+        'name',
+        'discount_type',
+        'value_display',
+        'scope',
+        'combine_mode_display',
+        'is_auto',
+        'is_active',
+        'current_usage_count',
+        'validity_period',
+    ]
+
+    list_filter = [
+        'discount_type',
+        'scope',
+        'combine_mode',
+        'is_auto',
+        'is_active',
+    ]
+
+    search_fields = [
+        'name',
+        'description',
+    ]
+
+    readonly_fields = [
+        'current_usage_count',
+        'created_at',
+    ]
+
+    fieldsets = (
+        ('Основная информация', {
+            'fields': ('name', 'description', 'is_active', 'priority')
+        }),
+        ('Параметры скидки', {
+            'fields': ('discount_type', 'value', 'scope', 'combine_mode')
+        }),
+        ('Ограничения', {
+            'fields': (
+                'start_date',
+                'end_date',
+                'max_usage_count',
+                'current_usage_count',
+                'is_auto'
+            )
+        }),
+        ('Условия применения', {
+            'fields': (
+                'min_order_amount',
+                'products',
+                'categories',
+                'excluded_products'
+            )
+        }),
+        ('Метаданные', {
+            'fields': ('created_at', 'created_by'),
+            'classes': ('collapse',)
+        }),
+    )
+
+    def value_display(self, obj):
+        if obj.discount_type == 'percentage':
+            return f"{obj.value}%"
+        return f"{obj.value} руб."
+    value_display.short_description = "Значение"
+
+    def combine_mode_display(self, obj):
+        """Отображение режима объединения с иконкой."""
+        icons = {
+            'stack': '📚',  # слои
+            'max_only': '🏆',  # максимум
+            'exclusive': '🚫',  # запрет
+        }
+        labels = {
+            'stack': 'Склад.',
+            'max_only': 'Макс.',
+            'exclusive': 'Исключ.',
+        }
+        icon = icons.get(obj.combine_mode, '')
+        label = labels.get(obj.combine_mode, obj.combine_mode)
+        return f'{icon} {label}' if icon else label
+    combine_mode_display.short_description = 'Объединение'
+
+    def validity_period(self, obj):
+        if obj.start_date and obj.end_date:
+            return f"{obj.start_date.date()} - {obj.end_date.date()}"
+        elif obj.start_date:
+            return f"с {obj.start_date.date()}"
+        elif obj.end_date:
+            return f"до {obj.end_date.date()}"
+        return "Бессрочная"
+    validity_period.short_description = "Период действия"
+
+
+@admin.register(PromoCode)
+class PromoCodeAdmin(admin.ModelAdmin):
+    """Админ-панель для управления промокодами."""
+    list_display = [
+        'code',
+        'discount_name',
+        'is_active',
+        'current_uses',
+        'usage_limit',
+        'validity_period',
+    ]
+
+    list_filter = [
+        'is_active',
+        'discount__scope',
+    ]
+
+    search_fields = [
+        'code',
+        'discount__name',
+    ]
+
+    readonly_fields = [
+        'current_uses',
+        'created_at',
+    ]
+
+    fieldsets = (
+        ('Основная информация', {
+            'fields': ('code', 'discount', 'is_active')
+        }),
+        ('Ограничения', {
+            'fields': (
+                'max_uses_per_user',
+                'max_total_uses',
+                'current_uses',
+                'start_date',
+                'end_date',
+            )
+        }),
+        ('Метаданные', {
+            'fields': ('created_at', 'created_by'),
+            'classes': ('collapse',)
+        }),
+    )
+
+    def discount_name(self, obj):
+        return obj.discount.name
+    discount_name.short_description = "Скидка"
+
+    def usage_limit(self, obj):
+        if obj.max_total_uses:
+            return f"{obj.current_uses} / {obj.max_total_uses}"
+        return str(obj.current_uses)
+    usage_limit.short_description = "Использования"
+
+    def validity_period(self, obj):
+        if obj.start_date and obj.end_date:
+            return f"{obj.start_date.date()} - {obj.end_date.date()}"
+        elif obj.start_date:
+            return f"с {obj.start_date.date()}"
+        elif obj.end_date:
+            return f"до {obj.end_date.date()}"
+        return "Бессрочный"
+    validity_period.short_description = "Период действия"
+
+
+@admin.register(DiscountApplication)
+class DiscountApplicationAdmin(admin.ModelAdmin):
+    """Админ-панель для истории применения скидок."""
+    list_display = [
+        'order_link',
+        'discount_name',
+        'promo_code_display',
+        'target',
+        'discount_amount',
+        'customer',
+        'applied_at',
+    ]
+
+    list_filter = [
+        'target',
+        'applied_at',
+        'discount__discount_type',
+    ]
+
+    readonly_fields = [
+        'order',
+        'order_item',
+        'discount',
+        'promo_code',
+        'target',
+        'base_amount',
+        'discount_amount',
+        'final_amount',
+        'customer',
+        'applied_at',
+        'applied_by',
+    ]
+
+    def has_add_permission(self, request):
+        return False  # Только чтение
+
+    def has_change_permission(self, request, obj=None):
+        return False  # Только чтение
+
+    def order_link(self, obj):
+        from django.urls import reverse
+        url = reverse('admin:orders_order_change', args=[obj.order.id])
+        return f'<a href="{url}">#{obj.order.order_number}</a>'
+    order_link.short_description = "Заказ"
+    order_link.allow_tags = True
+
+    def discount_name(self, obj):
+        return obj.discount.name if obj.discount else '-'
+    discount_name.short_description = "Скидка"
+
+    def promo_code_display(self, obj):
+        return obj.promo_code.code if obj.promo_code else '-'
+    promo_code_display.short_description = "Промокод"

myproject/discounts/apps.py

@@ -0,0 +1,7 @@
+from django.apps import AppConfig
+
+
+class DiscountsConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'discounts'
+    verbose_name = 'Скидки'

myproject/discounts/migrations/0001_initial.py

@@ -0,0 +1,133 @@
+# Generated by Django 5.0.10 on 2026-01-14 07:04
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('accounts', '0001_initial'),
+        ('customers', '0002_initial'),
+        ('orders', '0002_initial'),
+        ('products', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Discount',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=200, verbose_name='Название скидки')),
+                ('description', models.TextField(blank=True, verbose_name='Описание')),
+                ('discount_type', models.CharField(choices=[('percentage', 'Процент'), ('fixed_amount', 'Фиксированная сумма')], max_length=20, verbose_name='Тип скидки')),
+                ('value', models.DecimalField(decimal_places=2, help_text='Процент (0-100) или сумма в рублях', max_digits=10, verbose_name='Значение')),
+                ('scope', models.CharField(choices=[('order', 'На весь заказ'), ('product', 'На товар'), ('category', 'На категорию товаров')], default='order', max_length=20, verbose_name='Уровень применения')),
+                ('is_active', models.BooleanField(db_index=True, default=True, verbose_name='Активна')),
+                ('start_date', models.DateTimeField(blank=True, null=True, verbose_name='Дата начала действия')),
+                ('end_date', models.DateTimeField(blank=True, null=True, verbose_name='Дата окончания действия')),
+                ('max_usage_count', models.PositiveIntegerField(blank=True, help_text='Оставьте пустым для безлимитного использования', null=True, verbose_name='Макс. количество использований')),
+                ('current_usage_count', models.PositiveIntegerField(default=0, verbose_name='Текущее количество использований')),
+                ('priority', models.PositiveIntegerField(default=0, help_text='Более высокий приоритет применяется первым', verbose_name='Приоритет')),
+                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата создания')),
+                ('min_order_amount', models.DecimalField(blank=True, decimal_places=2, help_text='Скидка применяется только если сумма заказа >= этого значения', max_digits=10, null=True, verbose_name='Мин. сумма заказа')),
+                ('is_auto', models.BooleanField(default=False, help_text='Применяется автоматически при выполнении условий', verbose_name='Автоматическая')),
+                ('combine_mode', models.CharField(choices=[('stack', 'Складывать (суммировать)'), ('max_only', 'Только максимум'), ('exclusive', 'Исключающая (отменяет остальные)')], default='max_only', help_text='stack = суммировать с другими, max_only = применить максимальную, exclusive = отменить остальные', max_length=20, verbose_name='Режим объединения')),
+                ('categories', models.ManyToManyField(blank=True, related_name='discounts', to='products.productcategory', verbose_name='Категории')),
+                ('created_by', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='created_discounts', to='accounts.customuser', verbose_name='Создал')),
+                ('excluded_products', models.ManyToManyField(blank=True, related_name='excluded_from_discounts', to='products.product', verbose_name='Исключенные товары')),
+                ('products', models.ManyToManyField(blank=True, related_name='discounts', to='products.product', verbose_name='Товары')),
+            ],
+            options={
+                'verbose_name': 'Скидка',
+                'verbose_name_plural': 'Скидки',
+            },
+        ),
+        migrations.CreateModel(
+            name='PromoCode',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('code', models.CharField(help_text='Уникальный код (например: SALE2025, WINTER10)', max_length=50, unique=True, verbose_name='Код промокода')),
+                ('max_uses_per_user', models.PositiveIntegerField(blank=True, help_text='Оставьте пустым для безлимитного использования', null=True, verbose_name='Макс. использований на клиента')),
+                ('max_total_uses', models.PositiveIntegerField(blank=True, null=True, verbose_name='Макс. общее количество использований')),
+                ('current_uses', models.PositiveIntegerField(default=0, verbose_name='Текущее количество использований')),
+                ('is_active', models.BooleanField(default=True, verbose_name='Активен')),
+                ('start_date', models.DateTimeField(blank=True, null=True, verbose_name='Дата начала действия')),
+                ('end_date', models.DateTimeField(blank=True, null=True, verbose_name='Дата окончания действия')),
+                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата создания')),
+                ('created_by', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='created_promo_codes', to='accounts.customuser', verbose_name='Создал')),
+                ('discount', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='promo_codes', to='discounts.discount', verbose_name='Скидка')),
+            ],
+            options={
+                'verbose_name': 'Промокод',
+                'verbose_name_plural': 'Промокоды',
+            },
+        ),
+        migrations.CreateModel(
+            name='DiscountApplication',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('target', models.CharField(choices=[('order', 'Заказ'), ('order_item', 'Позиция заказа')], max_length=20, verbose_name='Объект применения')),
+                ('base_amount', models.DecimalField(decimal_places=2, max_digits=10, verbose_name='Базовая сумма')),
+                ('discount_amount', models.DecimalField(decimal_places=2, max_digits=10, verbose_name='Сумма скидки')),
+                ('final_amount', models.DecimalField(decimal_places=2, max_digits=10, verbose_name='Итоговая сумма')),
+                ('applied_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата применения')),
+                ('applied_by', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='applied_discounts', to='accounts.customuser', verbose_name='Применен пользователем')),
+                ('customer', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='discount_applications', to='customers.customer', verbose_name='Клиент')),
+                ('discount', models.ForeignKey(null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='applications', to='discounts.discount', verbose_name='Скидка')),
+                ('order', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='discount_applications', to='orders.order', verbose_name='Заказ')),
+                ('order_item', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='discount_applications', to='orders.orderitem', verbose_name='Позиция заказа')),
+                ('promo_code', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='applications', to='discounts.promocode', verbose_name='Промокод')),
+            ],
+            options={
+                'verbose_name': 'Применение скидки',
+                'verbose_name_plural': 'Применения скидок',
+            },
+        ),
+        migrations.AddIndex(
+            model_name='discount',
+            index=models.Index(fields=['is_active'], name='discounts_d_is_acti_ae32b7_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='discount',
+            index=models.Index(fields=['scope'], name='discounts_d_scope_2c30a7_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='discount',
+            index=models.Index(fields=['discount_type'], name='discounts_d_discoun_f47d7f_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='discount',
+            index=models.Index(fields=['is_auto'], name='discounts_d_is_auto_a4fe48_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='promocode',
+            index=models.Index(fields=['code'], name='discounts_p_code_f0e5a6_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='promocode',
+            index=models.Index(fields=['is_active'], name='discounts_p_is_acti_25d05d_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='discountapplication',
+            index=models.Index(fields=['order'], name='discounts_d_order_i_2b0f24_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='discountapplication',
+            index=models.Index(fields=['discount'], name='discounts_d_discoun_c0cd4d_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='discountapplication',
+            index=models.Index(fields=['promo_code'], name='discounts_d_promo_c_9ce5dd_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='discountapplication',
+            index=models.Index(fields=['customer'], name='discounts_d_custome_d57e7c_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='discountapplication',
+            index=models.Index(fields=['applied_at'], name='discounts_d_applied_96adbb_idx'),
+        ),
+    ]

myproject/discounts/models/__init__.py

@@ -0,0 +1,11 @@
+from .base import BaseDiscount
+from .discount import Discount
+from .promo_code import PromoCode
+from .application import DiscountApplication
+
+__all__ = [
+    'BaseDiscount',
+    'Discount',
+    'PromoCode',
+    'DiscountApplication',
+]

myproject/discounts/models/application.py

@@ -0,0 +1,110 @@
+from django.db import models
+
+
+class DiscountApplication(models.Model):
+    """
+    История применения скидок к заказам и позициям.
+    Используется для аналитики и отчётов.
+    """
+
+    DISCOUNT_TARGET_CHOICES = [
+        ('order', 'Заказ'),
+        ('order_item', 'Позиция заказа'),
+    ]
+
+    order = models.ForeignKey(
+        'orders.Order',
+        on_delete=models.CASCADE,
+        related_name='discount_applications',
+        verbose_name="Заказ"
+    )
+
+    order_item = models.ForeignKey(
+        'orders.OrderItem',
+        on_delete=models.CASCADE,
+        null=True,
+        blank=True,
+        related_name='discount_applications',
+        verbose_name="Позиция заказа"
+    )
+
+    discount = models.ForeignKey(
+        'Discount',
+        on_delete=models.SET_NULL,
+        null=True,
+        related_name='applications',
+        verbose_name="Скидка"
+    )
+
+    promo_code = models.ForeignKey(
+        'PromoCode',
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name='applications',
+        verbose_name="Промокод"
+    )
+
+    target = models.CharField(
+        max_length=20,
+        choices=DISCOUNT_TARGET_CHOICES,
+        verbose_name="Объект применения"
+    )
+
+    base_amount = models.DecimalField(
+        max_digits=10,
+        decimal_places=2,
+        verbose_name="Базовая сумма"
+    )
+
+    discount_amount = models.DecimalField(
+        max_digits=10,
+        decimal_places=2,
+        verbose_name="Сумма скидки"
+    )
+
+    final_amount = models.DecimalField(
+        max_digits=10,
+        decimal_places=2,
+        verbose_name="Итоговая сумма"
+    )
+
+    customer = models.ForeignKey(
+        'customers.Customer',
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name='discount_applications',
+        verbose_name="Клиент"
+    )
+
+    applied_at = models.DateTimeField(
+        auto_now_add=True,
+        verbose_name="Дата применения"
+    )
+
+    applied_by = models.ForeignKey(
+        'accounts.CustomUser',
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name='applied_discounts',
+        verbose_name="Применен пользователем"
+    )
+
+    class Meta:
+        verbose_name = "Применение скидки"
+        verbose_name_plural = "Применения скидок"
+        indexes = [
+            models.Index(fields=['order']),
+            models.Index(fields=['discount']),
+            models.Index(fields=['promo_code']),
+            models.Index(fields=['customer']),
+            models.Index(fields=['applied_at']),
+        ]
+
+    def __str__(self):
+        target_info = f"Заказ #{self.order.order_number}"
+        if self.order_item:
+            target_info += f", {self.order_item.item_name_snapshot}"
+        return f"{self.discount.name} -> {target_info} (-{self.discount_amount})"

myproject/discounts/models/base.py

@@ -0,0 +1,177 @@
+from django.db import models
+from django.core.exceptions import ValidationError
+
+
+class BaseDiscount(models.Model):
+    """
+    Абстрактный базовый класс для всех типов скидок.
+    Содержит общие поля и логику валидации.
+    """
+    DISCOUNT_TYPE_CHOICES = [
+        ('percentage', 'Процент'),
+        ('fixed_amount', 'Фиксированная сумма'),
+    ]
+
+    SCOPE_CHOICES = [
+        ('order', 'На весь заказ'),
+        ('product', 'На товар'),
+        ('category', 'На категорию товаров'),
+    ]
+
+    COMBINE_MODE_CHOICES = [
+        ('stack', 'Складывать (суммировать)'),
+        ('max_only', 'Только максимум'),
+        ('exclusive', 'Исключающая (отменяет остальные)'),
+    ]
+
+    name = models.CharField(
+        max_length=200,
+        verbose_name="Название скидки"
+    )
+
+    description = models.TextField(
+        blank=True,
+        verbose_name="Описание"
+    )
+
+    discount_type = models.CharField(
+        max_length=20,
+        choices=DISCOUNT_TYPE_CHOICES,
+        verbose_name="Тип скидки"
+    )
+
+    value = models.DecimalField(
+        max_digits=10,
+        decimal_places=2,
+        verbose_name="Значение",
+        help_text="Процент (0-100) или сумма в рублях"
+    )
+
+    scope = models.CharField(
+        max_length=20,
+        choices=SCOPE_CHOICES,
+        default='order',
+        verbose_name="Уровень применения"
+    )
+
+    is_active = models.BooleanField(
+        default=True,
+        verbose_name="Активна",
+        db_index=True
+    )
+
+    start_date = models.DateTimeField(
+        null=True,
+        blank=True,
+        verbose_name="Дата начала действия"
+    )
+
+    end_date = models.DateTimeField(
+        null=True,
+        blank=True,
+        verbose_name="Дата окончания действия"
+    )
+
+    max_usage_count = models.PositiveIntegerField(
+        null=True,
+        blank=True,
+        verbose_name="Макс. количество использований",
+        help_text="Оставьте пустым для безлимитного использования"
+    )
+
+    current_usage_count = models.PositiveIntegerField(
+        default=0,
+        verbose_name="Текущее количество использований"
+    )
+
+    priority = models.PositiveIntegerField(
+        default=0,
+        verbose_name="Приоритет",
+        help_text="Более высокий приоритет применяется первым"
+    )
+
+    created_at = models.DateTimeField(
+        auto_now_add=True,
+        verbose_name="Дата создания"
+    )
+
+    created_by = models.ForeignKey(
+        'accounts.CustomUser',
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name='created_discounts',
+        verbose_name="Создал"
+    )
+
+    class Meta:
+        abstract = True
+        ordering = ['-priority', '-created_at']
+        indexes = [
+            models.Index(fields=['is_active']),
+            models.Index(fields=['scope']),
+            models.Index(fields=['discount_type']),
+        ]
+
+    def __str__(self):
+        if self.discount_type == 'percentage':
+            return f"{self.name} ({self.value}%)"
+        return f"{self.name} (-{self.value} руб.)"
+
+    def clean(self):
+        """Валидация значений скидки"""
+        if self.discount_type == 'percentage':
+            if self.value < 0 or self.value > 100:
+                raise ValidationError({
+                    'value': 'Процентная скидка должна быть от 0 до 100'
+                })
+        elif self.discount_type == 'fixed_amount':
+            if self.value < 0:
+                raise ValidationError({
+                    'value': 'Фиксированная скидка не может быть отрицательной'
+                })
+
+        if self.start_date and self.end_date and self.start_date > self.end_date:
+            raise ValidationError({
+                'end_date': 'Дата окончания не может быть раньше даты начала'
+            })
+
+    def calculate_discount_amount(self, base_amount):
+        """
+        Вычислить сумму скидки для заданной базовой суммы.
+
+        Args:
+            base_amount: Десятичное число - базовая сумма
+
+        Returns:
+            Decimal: Сумма скидки (не может превышать base_amount)
+        """
+        if self.discount_type == 'percentage':
+            return base_amount * self.value / 100
+        else:  # fixed_amount
+            return min(self.value, base_amount)  # Скидка не может превышать сумму
+
+    def is_valid_now(self):
+        """
+        Проверить, что скидка активна в текущий момент времени.
+
+        Returns:
+            bool: True если скидка активна
+        """
+        from django.utils import timezone
+
+        if not self.is_active:
+            return False
+
+        now = timezone.now()
+
+        if self.start_date and now < self.start_date:
+            return False
+
+        if self.end_date and now > self.end_date:
+            return False
+
+        if self.max_usage_count and self.current_usage_count >= self.max_usage_count:
+            return False
+
+        return True

myproject/discounts/models/discount.py

@@ -0,0 +1,124 @@
+from django.db import models
+from .base import BaseDiscount
+
+
+class Discount(BaseDiscount):
+    """
+    Основная модель скидки.
+    Наследует все поля из BaseDiscount и добавляет специфические параметры.
+    """
+
+    # Для scope='order' - минимальная сумма заказа
+    min_order_amount = models.DecimalField(
+        max_digits=10,
+        decimal_places=2,
+        null=True,
+        blank=True,
+        verbose_name="Мин. сумма заказа",
+        help_text="Скидка применяется только если сумма заказа >= этого значения"
+    )
+
+    # Для scope='product' и scope='category' - товары и категории
+    products = models.ManyToManyField(
+        'products.Product',
+        blank=True,
+        related_name='discounts',
+        verbose_name="Товары"
+    )
+
+    categories = models.ManyToManyField(
+        'products.ProductCategory',
+        blank=True,
+        related_name='discounts',
+        verbose_name="Категории"
+    )
+
+    # Исключения (товары, к которым скидка НЕ применяется)
+    excluded_products = models.ManyToManyField(
+        'products.Product',
+        blank=True,
+        related_name='excluded_from_discounts',
+        verbose_name="Исключенные товары"
+    )
+
+    # Автоматическая скидка (не требует промокода)
+    is_auto = models.BooleanField(
+        default=False,
+        verbose_name="Автоматическая",
+        help_text="Применяется автоматически при выполнении условий"
+    )
+
+    # Режим объединения с другими скидками
+    combine_mode = models.CharField(
+        max_length=20,
+        choices=BaseDiscount.COMBINE_MODE_CHOICES,
+        default='max_only',
+        verbose_name="Режим объединения",
+        help_text="stack = суммировать с другими, max_only = применить максимальную, exclusive = отменить остальные"
+    )
+
+    class Meta:
+        verbose_name = "Скидка"
+        verbose_name_plural = "Скидки"
+        indexes = [
+            models.Index(fields=['is_active']),
+            models.Index(fields=['scope']),
+            models.Index(fields=['discount_type']),
+            models.Index(fields=['is_auto']),
+        ]
+
+    def applies_to_product(self, product):
+        """
+        Проверить, применяется ли скидка к товару.
+
+        Args:
+            product: Объект Product
+
+        Returns:
+            bool: True если скидка применяется к товару
+        """
+        # Проверяем исключения
+        if self.excluded_products.filter(id=product.id).exists():
+            return False
+
+        # Если scope='product', проверяем прямое соответствие
+        if self.scope == 'product':
+            return self.products.filter(id=product.id).exists()
+
+        # Если scope='category', проверяем категории товара
+        if self.scope == 'category':
+            if not self.categories.exists():
+                return False
+            product_categories = product.categories.all()
+            return self.categories.filter(id__in=product_categories).exists()
+
+        return False
+
+    def get_applicable_products(self):
+        """
+        Получить queryset товаров, к которым применяется эта скидка.
+
+        Returns:
+            QuerySet: Товары, к которым применяется скидка
+        """
+        from products.models import Product
+
+        if self.scope == 'product':
+            qs = self.products.all()
+            # Исключаем исключенные товары
+            if self.excluded_products.exists():
+                qs = qs.exclude(id__in=self.excluded_products.values_list('id', flat=True))
+            return qs
+
+        if self.scope == 'category':
+            # Товары из указанных категорий
+            product_ids = Product.objects.filter(
+                categories__in=self.categories.all()
+            ).values_list('id', flat=True).distinct()
+            # Исключаем исключенные товары
+            if self.excluded_products.exists():
+                excluded_ids = self.excluded_products.values_list('id', flat=True)
+                product_ids = set(product_ids) - set(excluded_ids)
+            return Product.objects.filter(id__in=product_ids)
+
+        return Product.objects.none()

myproject/discounts/models/promo_code.py

@@ -0,0 +1,147 @@
+from django.db import models
+from django.core.exceptions import ValidationError
+from django.utils import timezone
+
+
+class PromoCode(models.Model):
+    """
+    Промокод для активации скидки.
+    Связывает код с одной скидкой.
+    """
+
+    code = models.CharField(
+        max_length=50,
+        unique=True,
+        verbose_name="Код промокода",
+        help_text="Уникальный код (например: SALE2025, WINTER10)"
+    )
+
+    discount = models.ForeignKey(
+        'Discount',
+        on_delete=models.CASCADE,
+        related_name='promo_codes',
+        verbose_name="Скидка"
+    )
+
+    # Ограничения использования
+    max_uses_per_user = models.PositiveIntegerField(
+        null=True,
+        blank=True,
+        verbose_name="Макс. использований на клиента",
+        help_text="Оставьте пустым для безлимитного использования"
+    )
+
+    max_total_uses = models.PositiveIntegerField(
+        null=True,
+        blank=True,
+        verbose_name="Макс. общее количество использований"
+    )
+
+    current_uses = models.PositiveIntegerField(
+        default=0,
+        verbose_name="Текущее количество использований"
+    )
+
+    is_active = models.BooleanField(
+        default=True,
+        verbose_name="Активен"
+    )
+
+    start_date = models.DateTimeField(
+        null=True,
+        blank=True,
+        verbose_name="Дата начала действия"
+    )
+
+    end_date = models.DateTimeField(
+        null=True,
+        blank=True,
+        verbose_name="Дата окончания действия"
+    )
+
+    created_at = models.DateTimeField(
+        auto_now_add=True,
+        verbose_name="Дата создания"
+    )
+
+    created_by = models.ForeignKey(
+        'accounts.CustomUser',
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name='created_promo_codes',
+        verbose_name="Создал"
+    )
+
+    class Meta:
+        verbose_name = "Промокод"
+        verbose_name_plural = "Промокоды"
+        indexes = [
+            models.Index(fields=['code']),
+            models.Index(fields=['is_active']),
+        ]
+
+    def __str__(self):
+        return f"{self.code} -> {self.discount.name}"
+
+    def clean(self):
+        """Валидация промокода"""
+        super().clean()
+        if self.code:
+            self.code = self.code.strip().upper()
+
+    def save(self, *args, **kwargs):
+        """Приводим код к верхнему регистру при сохранении"""
+        if self.code:
+            self.code = self.code.strip().upper()
+        super().save(*args, **kwargs)
+
+    def is_valid(self, customer=None):
+        """
+        Проверить валидность промокода.
+
+        Args:
+            customer: Customer для проверки использований на пользователя
+
+        Returns:
+            tuple: (is_valid, error_message)
+        """
+        now = timezone.now()
+
+        if not self.is_active:
+            return False, "Промокод неактивен"
+
+        if self.start_date and now < self.start_date:
+            return False, "Промокод еще не начал действовать"
+
+        if self.end_date and now > self.end_date:
+            return False, "Промокод истек"
+
+        if self.max_total_uses and self.current_uses >= self.max_total_uses:
+            return False, "Промокод полностью использован"
+
+        if customer and self.max_uses_per_user:
+            # Проверяем использования этим клиентом
+            uses = DiscountApplication.objects.filter(
+                promo_code=self,
+                customer=customer
+            ).count()
+
+            if uses >= self.max_uses_per_user:
+                return False, f"Вы уже использовали этот промокод максимальное количество раз ({self.max_uses_per_user})"
+
+        return True, None
+
+    def record_usage(self, customer=None):
+        """
+        Зарегистрировать использование промокода.
+
+        Args:
+            customer: Customer (опционально)
+        """
+        self.current_uses += 1
+        self.save(update_fields=['current_uses'])
+
+
+# Импортируем здесь, чтобы избежать циклического импорта
+from .application import DiscountApplication

myproject/discounts/services/__init__.py

@@ -0,0 +1,9 @@
+from .calculator import DiscountCalculator
+from .applier import DiscountApplier
+from .validator import DiscountValidator
+
+__all__ = [
+    'DiscountCalculator',
+    'DiscountApplier',
+    'DiscountValidator',
+]

myproject/discounts/services/applier.py

@@ -0,0 +1,277 @@
+from decimal import Decimal
+from django.db import transaction
+from django.core.exceptions import ValidationError
+
+
+class DiscountApplier:
+    """
+    Сервис для применения скидок к заказам.
+    Поддерживает комбинирование скидок по combine_mode.
+    Все операции атомарны.
+    """
+
+    @staticmethod
+    @transaction.atomic
+    def apply_promo_code(order, promo_code, user=None):
+        """
+        Применить промокод к заказу.
+        Поддерживает комбинирование скидок.
+
+        Args:
+            order: Order
+            promo_code: str
+            user: CustomUser (применивший скидку)
+
+        Returns:
+            dict: {
+                'success': bool,
+                'discounts': [{'discount': Discount, 'amount': Decimal}, ...],
+                'total_amount': Decimal,
+                'error': str
+            }
+        """
+        from discounts.models import PromoCode, DiscountApplication
+        from discounts.services.calculator import DiscountCalculator
+
+        # Удаляем предыдущую скидку на заказ
+        DiscountApplier._remove_order_discount_only(order)
+
+        # Рассчитываем скидку
+        result = DiscountCalculator.calculate_order_discount(order, promo_code)
+
+        if result['error']:
+            return {
+                'success': False,
+                'error': result['error']
+            }
+
+        promo = result['promo_code']
+        discounts_data = result['discounts']
+        total_amount = result['total_amount']
+
+        # Создаем записи о применении для каждой скидки в DiscountApplication
+        for disc_data in discounts_data:
+            discount = disc_data['discount']
+            amount = disc_data['amount']
+
+            DiscountApplication.objects.create(
+                order=order,
+                discount=discount,
+                promo_code=promo,
+                target='order',
+                base_amount=order.subtotal,
+                discount_amount=amount,
+                final_amount=order.subtotal - amount,
+                customer=order.customer,
+                applied_by=user or order.modified_by
+            )
+
+            # Увеличиваем счетчик использований скидки
+            discount.current_usage_count += 1
+            discount.save(update_fields=['current_usage_count'])
+
+        # Пересчитываем total_amount (использует DiscountApplication)
+        order.calculate_total()
+
+        # Регистрируем использование промокода
+        promo.record_usage(order.customer)
+
+        return {
+            'success': True,
+            'discounts': discounts_data,
+            'total_amount': total_amount
+        }
+
+    @staticmethod
+    @transaction.atomic
+    def apply_auto_discounts(order, user=None):
+        """
+        Применить автоматические скидки к заказу и позициям.
+        Поддерживает комбинирование скидок.
+
+        Args:
+            order: Order
+            user: CustomUser
+
+        Returns:
+            dict: {
+                'order_discounts': [...],
+                'item_discounts': [...],
+                'total_discount': Decimal
+            }
+        """
+        from discounts.models import Discount, DiscountApplication
+        from discounts.services.calculator import DiscountCalculator
+
+        result = {
+            'order_discounts': [],
+            'item_discounts': [],
+            'total_discount': Decimal('0')
+        }
+
+        # 1. Применяем скидки на заказ (может быть несколько)
+        order_result = DiscountCalculator.calculate_order_discount(order)
+
+        if order_result['discounts'] and not order_result['error']:
+            total_order_amount = order_result['total_amount']
+
+            # Создаем записи о применении для всех скидок
+            for disc_data in order_result['discounts']:
+                discount = disc_data['discount']
+                amount = disc_data['amount']
+
+                DiscountApplication.objects.create(
+                    order=order,
+                    discount=discount,
+                    target='order',
+                    base_amount=order.subtotal,
+                    discount_amount=amount,
+                    final_amount=order.subtotal - amount,
+                    customer=order.customer,
+                    applied_by=user
+                )
+
+                # Увеличиваем счетчик
+                discount.current_usage_count += 1
+                discount.save(update_fields=['current_usage_count'])
+
+            result['order_discounts'] = order_result['discounts']
+            result['total_discount'] += total_order_amount
+
+        # 2. Применяем скидки на позиции
+        available_product_discounts = list(DiscountCalculator.get_available_discounts(
+            scope='product',
+            auto_only=True
+        ))
+
+        for item in order.items.all():
+            item_result = DiscountCalculator.calculate_item_discount(
+                item, available_product_discounts
+            )
+
+            if item_result['discounts']:
+                total_item_amount = item_result['total_amount']
+
+                # Создаем записи о применении для всех скидок
+                base_amount = item.price * item.quantity
+                for disc_data in item_result['discounts']:
+                    discount = disc_data['discount']
+                    amount = disc_data['amount']
+
+                    DiscountApplication.objects.create(
+                        order=order,
+                        order_item=item,
+                        discount=discount,
+                        target='order_item',
+                        base_amount=base_amount,
+                        discount_amount=amount,
+                        final_amount=base_amount - amount,
+                        customer=order.customer,
+                        applied_by=user
+                    )
+
+                    # Увеличиваем счетчик
+                    discount.current_usage_count += 1
+                    discount.save(update_fields=['current_usage_count'])
+
+                result['item_discounts'].append({
+                    'item': item,
+                    'discounts': item_result['discounts'],
+                    'total_amount': total_item_amount
+                })
+                result['total_discount'] += total_item_amount
+
+        # Пересчитываем итоговую сумму
+        order.calculate_total()
+
+        return result
+
+    @staticmethod
+    @transaction.atomic
+    def remove_discount_from_order(order):
+        """
+        Удалить скидку с заказа.
+
+        Args:
+            order: Order
+        """
+        # Удаляем записи о применении
+        from discounts.models import DiscountApplication
+        DiscountApplication.objects.filter(order=order).delete()
+
+        # Пересчитываем
+        order.calculate_total()
+
+    @staticmethod
+    @transaction.atomic
+    def apply_manual_discount(order, discount, user=None):
+        """
+        Применить скидку вручную к заказу.
+
+        Args:
+            order: Order
+            discount: Discount
+            user: CustomUser (применивший скидку)
+
+        Returns:
+            dict: {
+                'success': bool,
+                'discount_amount': Decimal,
+                'error': str
+            }
+        """
+        from discounts.models import DiscountApplication
+
+        # Проверяем scope скидки
+        if discount.scope != 'order':
+            return {'success': False, 'error': 'Эта скидка не применяется к заказу'}
+
+        # Проверяем мин. сумму
+        if discount.min_order_amount and order.subtotal < discount.min_order_amount:
+            return {'success': False, 'error': f'Мин. сумма заказа: {discount.min_order_amount} руб.'}
+
+        # Удаляем предыдущую скидку на заказ
+        DiscountApplier._remove_order_discount_only(order)
+
+        # Рассчитываем сумму
+        discount_amount = discount.calculate_discount_amount(Decimal(order.subtotal))
+
+        # Создаем запись о применении
+        DiscountApplication.objects.create(
+            order=order,
+            discount=discount,
+            target='order',
+            base_amount=order.subtotal,
+            discount_amount=discount_amount,
+            final_amount=order.subtotal - discount_amount,
+            customer=order.customer,
+            applied_by=user
+        )
+
+        # Увеличиваем счетчик использований скидки
+        discount.current_usage_count += 1
+        discount.save(update_fields=['current_usage_count'])
+
+        # Пересчитываем total_amount
+        order.calculate_total()
+
+        return {
+            'success': True,
+            'discount_amount': discount_amount
+        }
+
+    @staticmethod
+    def _remove_order_discount_only(order):
+        """
+        Удалить только скидку с заказа (не трогая позиции).
+
+        Args:
+            order: Order
+        """
+        from discounts.models import DiscountApplication
+
+        # Удаляем записи о применении скидок к заказу
+        DiscountApplication.objects.filter(order=order, target='order').delete()
+
+        # Пересчитываем (order.discount_amount теперь свойство, берущее из DiscountApplication)
+        order.calculate_total()

myproject/discounts/services/calculator.py

@@ -0,0 +1,424 @@
+from decimal import Decimal
+from django.db import models
+from django.utils import timezone
+
+
+class DiscountCombiner:
+    """
+    Утилитный класс для комбинирования скидок по разным режимам.
+    """
+
+    @staticmethod
+    def combine_discounts(discounts, base_amount):
+        """
+        Комбинировать несколько скидок по их combine_mode.
+
+        Args:
+            discounts: Список объектов Discount
+            base_amount: Базовая сумма для расчета
+
+        Returns:
+            dict: {
+                'total_discount': Decimal,
+                'applied_discounts': [{'discount': Discount, 'amount': Decimal}, ...],
+                'excluded_by': Discount или None,
+                'combine_mode_used': str
+            }
+        """
+        if not discounts:
+            return {
+                'total_discount': Decimal('0'),
+                'applied_discounts': [],
+                'excluded_by': None,
+                'combine_mode_used': 'none'
+            }
+
+        # 1. Проверяем наличие exclusive скидки
+        exclusive_discounts = [d for d in discounts if d.combine_mode == 'exclusive']
+        if exclusive_discounts:
+            # Применяем только первую exclusive скидку
+            discount = exclusive_discounts[0]
+            amount = discount.calculate_discount_amount(base_amount)
+            return {
+                'total_discount': amount,
+                'applied_discounts': [{'discount': discount, 'amount': amount}],
+                'excluded_by': discount,
+                'combine_mode_used': 'exclusive'
+            }
+
+        # 2. Разделяем скидки на stack и max_only
+        stack_discounts = [d for d in discounts if d.combine_mode == 'stack']
+        max_only_discounts = [d for d in discounts if d.combine_mode == 'max_only']
+
+        result = {
+            'total_discount': Decimal('0'),
+            'applied_discounts': [],
+            'excluded_by': None,
+            'combine_mode_used': 'combined'
+        }
+
+        # 3. Для max_only применяем только максимальную
+        if max_only_discounts:
+            max_discount = max(
+                max_only_discounts,
+                key=lambda d: d.calculate_discount_amount(base_amount)
+            )
+            amount = max_discount.calculate_discount_amount(base_amount)
+            result['applied_discounts'].append({'discount': max_discount, 'amount': amount})
+            result['total_discount'] += amount
+
+        # 4. Для stack суммируем все
+        for discount in stack_discounts:
+            amount = discount.calculate_discount_amount(base_amount)
+            result['applied_discounts'].append({'discount': discount, 'amount': amount})
+            result['total_discount'] += amount
+
+        # 5. Ограничиваем итоговую скидку базовой суммой
+        result['total_discount'] = min(result['total_discount'], base_amount)
+
+        return result
+
+
+class DiscountCalculator:
+    """
+    Калькулятор скидок для заказов.
+    Рассчитывает применимые скидки и их суммы.
+    """
+
+    @staticmethod
+    def get_available_discounts(scope=None, customer=None, auto_only=False):
+        """
+        Получить список доступных скидок.
+
+        Args:
+            scope: 'order', 'product', 'category' или None для всех
+            customer: Customer для проверки условий
+            auto_only: Только автоматические скидки
+
+        Returns:
+            QuerySet[Discount]: Активные скидки, отсортированные по приоритету
+        """
+        from discounts.models import Discount
+
+        now = timezone.now()
+        qs = Discount.objects.filter(is_active=True)
+
+        # Фильтр по scope
+        if scope:
+            qs = qs.filter(scope=scope)
+
+        # Фильтр по auto
+        if auto_only:
+            qs = qs.filter(is_auto=True)
+
+        # Фильтр по дате
+        qs = qs.filter(
+            models.Q(start_date__isnull=True) | models.Q(start_date__lte=now),
+            models.Q(end_date__isnull=True) | models.Q(end_date__gte=now)
+        )
+
+        # Фильтр по лимиту использований
+        qs = qs.filter(
+            models.Q(max_usage_count__isnull=True) |
+            models.Q(current_usage_count__lt=models.F('max_usage_count'))
+        )
+
+        return qs.order_by('-priority', '-created_at')
+
+    @staticmethod
+    def calculate_order_discount(order, promo_code=None):
+        """
+        Рассчитать скидку на весь заказ с поддержкой комбинирования.
+
+        Args:
+            order: Order объект
+            promo_code: Строка промокода (опционально)
+
+        Returns:
+            dict: {
+                'discounts': [{'discount': Discount, 'amount': Decimal}, ...],
+                'total_amount': Decimal,
+                'promo_code': PromoCode или None,
+                'error': str или None
+            }
+        """
+        from discounts.models import PromoCode
+        from discounts.services.validator import DiscountValidator
+
+        subtotal = Decimal(str(order.subtotal))
+        result = {
+            'discounts': [],
+            'total_amount': Decimal('0'),
+            'promo_code': None,
+            'error': None
+        }
+
+        applicable_discounts = []
+
+        # 1. Проверяем промокод первым
+        if promo_code:
+            is_valid, promo, error = DiscountValidator.validate_promo_code(
+                promo_code, order.customer, subtotal
+            )
+
+            if not is_valid:
+                result['error'] = error
+                return result
+
+            discount = promo.discount
+
+            if discount.scope != 'order':
+                result['error'] = "Этот промокод применяется только к товарам"
+                return result
+
+            result['promo_code'] = promo
+            applicable_discounts.append(discount)
+        else:
+            # 2. Если нет промокода, собираем все автоматические скидки
+            auto_discounts = DiscountCalculator.get_available_discounts(
+                scope='order',
+                auto_only=True
+            )
+
+            for discount in auto_discounts:
+                if discount.min_order_amount and subtotal < discount.min_order_amount:
+                    continue
+                applicable_discounts.append(discount)
+
+        # 3. Комбинируем скидки
+        if applicable_discounts:
+            combination = DiscountCombiner.combine_discounts(applicable_discounts, subtotal)
+            result['discounts'] = combination['applied_discounts']
+            result['total_amount'] = combination['total_discount']
+
+        return result
+
+    @staticmethod
+    def calculate_item_discount(order_item, available_discounts=None):
+        """
+        Рассчитать скидку на позицию заказа с поддержкой комбинирования.
+
+        Args:
+            order_item: OrderItem объект
+            available_discounts: Предварительно полученный список скидок
+
+        Returns:
+            dict: {
+                'discounts': [{'discount': Discount, 'amount': Decimal}, ...],
+                'total_amount': Decimal,
+            }
+        """
+        result = {
+            'discounts': [],
+            'total_amount': Decimal('0')
+        }
+
+        # Определяем продукт
+        product = None
+        if order_item.product:
+            product = order_item.product
+        elif order_item.product_kit:
+            product = order_item.product_kit
+
+        if not product:
+            return result
+
+        base_amount = Decimal(str(order_item.price)) * Decimal(str(order_item.quantity))
+
+        # Собираем все применимые скидки
+        applicable_discounts = []
+
+        # Скидки на товары
+        if not available_discounts:
+            available_discounts = DiscountCalculator.get_available_discounts(
+                scope='product',
+                auto_only=True
+            )
+
+        for discount in available_discounts:
+            if discount.applies_to_product(product):
+                applicable_discounts.append(discount)
+
+        # Скидки по категориям
+        category_discounts = DiscountCalculator.get_available_discounts(
+            scope='category',
+            auto_only=True
+        )
+
+        for discount in category_discounts:
+            if discount.applies_to_product(product) and discount not in applicable_discounts:
+                applicable_discounts.append(discount)
+
+        # Комбинируем скидки
+        if applicable_discounts:
+            combination = DiscountCombiner.combine_discounts(applicable_discounts, base_amount)
+            result['discounts'] = combination['applied_discounts']
+            result['total_amount'] = combination['total_discount']
+
+        return result
+
+    @staticmethod
+    def calculate_cart_discounts(cart_items, promo_code=None, customer=None, skip_auto_discount=False):
+        """
+        Рассчитать скидки для корзины (применяется в POS до создания заказа).
+        Поддерживает комбинирование скидок по combine_mode.
+
+        Args:
+            cart_items: Список словарей {'type': 'product'|'kit', 'id': int, 'quantity': Decimal, 'price': Decimal}
+            promo_code: Промокод (опционально)
+            customer: Customer (опционально)
+            skip_auto_discount: Пропустить автоматические скидки (опционально)
+
+        Returns:
+            dict: {
+                'order_discounts': [
+                    {'discount_id': int, 'discount_name': str, 'discount_amount': Decimal, 'combine_mode': str},
+                    ...
+                ],
+                'total_order_discount': Decimal,
+                'item_discounts': [
+                    {'cart_index': int, 'discounts': [...], 'total_discount': Decimal},
+                    ...
+                ],
+                'total_discount': Decimal,
+                'final_total': Decimal,
+                'cart_subtotal': Decimal,
+                'excluded_by': {'id': int, 'name': str} или None
+            }
+        """
+        from products.models import Product, ProductKit
+
+        cart_subtotal = Decimal('0')
+        for item in cart_items:
+            cart_subtotal += Decimal(str(item['price'])) * Decimal(str(item['quantity']))
+
+        # Если нужно пропустить авто-скидки, возвращаем пустой результат
+        if skip_auto_discount:
+            return {
+                'order_discounts': [],
+                'total_order_discount': Decimal('0'),
+                'item_discounts': [],
+                'total_discount': Decimal('0'),
+                'final_total': cart_subtotal,
+                'cart_subtotal': cart_subtotal,
+                'excluded_by': None
+            }
+
+        # Создаем фейковый объект для расчета скидки на заказ
+        class FakeOrder:
+            def __init__(self, subtotal, customer):
+                self.subtotal = subtotal
+                self.customer = customer
+
+        fake_order = FakeOrder(cart_subtotal, customer)
+
+        # Скидка на заказ (с комбинированием)
+        order_result = DiscountCalculator.calculate_order_discount(fake_order, promo_code)
+
+        # Форматируем order_discounts для ответа
+        formatted_order_discounts = []
+        excluded_by = None
+
+        for disc_data in order_result['discounts']:
+            discount = disc_data['discount']
+            formatted_order_discounts.append({
+                'discount_id': discount.id,
+                'discount_name': discount.name,
+                'discount_amount': disc_data['amount'],
+                'discount_type': discount.discount_type,
+                'discount_value': discount.value,
+                'combine_mode': discount.combine_mode
+            })
+
+        # Проверяем исключающую скидку
+        if order_result['discounts']:
+            # Определяем exclusive скидку
+            for disc_data in order_result['discounts']:
+                if disc_data['discount'].combine_mode == 'exclusive':
+                    excluded_by = {
+                        'id': disc_data['discount'].id,
+                        'name': disc_data['discount'].name
+                    }
+                    break
+
+        # Скидки на позиции (с комбинированием)
+        item_discounts = []
+        items_total_discount = Decimal('0')
+
+        available_product_discounts = list(DiscountCalculator.get_available_discounts(
+            scope='product',
+            auto_only=True
+        ))
+
+        available_category_discounts = list(DiscountCalculator.get_available_discounts(
+            scope='category',
+            auto_only=True
+        ))
+
+        for idx, item in enumerate(cart_items):
+            # Загружаем продукт
+            product = None
+            if item.get('type') == 'product':
+                try:
+                    product = Product.objects.get(id=item['id'])
+                except Product.DoesNotExist:
+                    pass
+            elif item.get('type') == 'kit':
+                try:
+                    product = ProductKit.objects.get(id=item['id'])
+                except ProductKit.DoesNotExist:
+                    pass
+
+            if not product:
+                continue
+
+            base_amount = Decimal(str(item['price'])) * Decimal(str(item['quantity']))
+
+            # Собираем все применимые скидки для этого товара
+            applicable_item_discounts = []
+
+            for discount in available_product_discounts:
+                if discount.applies_to_product(product):
+                    applicable_item_discounts.append(discount)
+
+            for discount in available_category_discounts:
+                if discount.applies_to_product(product) and discount not in applicable_item_discounts:
+                    applicable_item_discounts.append(discount)
+
+            # Комбинируем скидки для позиции
+            if applicable_item_discounts:
+                combination = DiscountCombiner.combine_discounts(
+                    applicable_item_discounts,
+                    base_amount
+                )
+
+                formatted_discounts = []
+                for disc_data in combination['applied_discounts']:
+                    discount = disc_data['discount']
+                    formatted_discounts.append({
+                        'discount_id': discount.id,
+                        'discount_name': discount.name,
+                        'discount_amount': disc_data['amount'],
+                        'combine_mode': discount.combine_mode
+                    })
+
+                if formatted_discounts:
+                    item_discounts.append({
+                        'cart_index': idx,
+                        'discounts': formatted_discounts,
+                        'total_discount': combination['total_discount']
+                    })
+                    items_total_discount += combination['total_discount']
+
+        total_discount = order_result['total_amount'] + items_total_discount
+        final_total = max(cart_subtotal - total_discount, Decimal('0'))
+
+        return {
+            'order_discounts': formatted_order_discounts,
+            'total_order_discount': order_result['total_amount'],
+            'item_discounts': item_discounts,
+            'total_discount': total_discount,
+            'final_total': final_total,
+            'cart_subtotal': cart_subtotal,
+            'excluded_by': excluded_by
+        }

myproject/discounts/services/validator.py

@@ -0,0 +1,101 @@
+from decimal import Decimal
+from django.core.exceptions import ValidationError
+
+
+class DiscountValidator:
+    """
+    Сервис для валидации скидок и промокодов.
+    """
+
+    @staticmethod
+    def validate_promo_code(code, customer=None, order_subtotal=None):
+        """
+        Валидировать промокод.
+
+        Args:
+            code: Код промокода
+            customer: Customer для проверки использований
+            order_subtotal: Сумма заказа для проверки min_order_amount
+
+        Returns:
+            tuple: (is_valid, promo_code_or_none, error_message)
+        """
+        from discounts.models import PromoCode
+
+        if not code or not code.strip():
+            return False, None, "Промокод не указан"
+
+        try:
+            promo = PromoCode.objects.get(
+                code__iexact=code.strip().upper(),
+                is_active=True
+            )
+        except PromoCode.DoesNotExist:
+            return False, None, "Промокод не найден"
+
+        # Проверяем валидность промокода
+        is_valid, error = promo.is_valid(customer)
+        if not is_valid:
+            return False, None, error
+
+        # Проверяем мин. сумму заказа
+        if order_subtotal is not None and promo.discount.min_order_amount:
+            if Decimal(order_subtotal) < promo.discount.min_order_amount:
+                return False, None, f"Минимальная сумма заказа: {promo.discount.min_order_amount} руб."
+
+        # Проверяем scope (только заказ, не товары)
+        if promo.discount.scope not in ('order', 'product', 'category'):
+            return False, None, "Этот тип промокода не поддерживается"
+
+        return True, promo, None
+
+    @staticmethod
+    def validate_discount_for_order(discount, order):
+        """
+        Проверить, можно ли применить скидку к заказу.
+
+        Args:
+            discount: Discount
+            order: Order
+
+        Returns:
+            tuple: (is_valid, error_message)
+        """
+        if not discount.is_active:
+            return False, "Скидка неактивна"
+
+        # Проверяем даты
+        if not discount.is_valid_now():
+            return False, "Скидка недействительна"
+
+        # Проверяем мин. сумму заказа
+        if discount.scope == 'order' and discount.min_order_amount:
+            if order.subtotal < discount.min_order_amount:
+                return False, f"Минимальная сумма заказа: {discount.min_order_amount} руб."
+
+        return True, None
+
+    @staticmethod
+    def validate_auto_discount_for_cart(discount, cart_subtotal, customer=None):
+        """
+        Проверить, можно ли применить автоматическую скидку к корзине.
+
+        Args:
+            discount: Discount
+            cart_subtotal: Десятичное число - сумма корзины
+            customer: Customer (опционально)
+
+        Returns:
+            bool: True если скидка применима
+        """
+        if not discount.is_auto:
+            return False
+
+        if not discount.is_valid_now():
+            return False
+
+        if discount.scope == 'order' and discount.min_order_amount:
+            if cart_subtotal < discount.min_order_amount:
+                return False
+
+        return True

myproject/discounts/templates/discounts/discount_confirm_delete.html

@@ -0,0 +1,45 @@
+{% extends "system_settings/base_settings.html" %}
+
+{% block title %}Удаление скидки{% endblock %}
+
+{% block settings_content %}
+<div class="row justify-content-center">
+    <div class="col-md-6">
+        <div class="card">
+            <div class="card-header bg-danger text-white">
+                <h4 class="mb-0"><i class="bi bi-exclamation-triangle"></i> Удаление скидки</h4>
+            </div>
+            <div class="card-body">
+                <p>Вы уверены, что хотите удалить скидку <strong>{{ object.name }}</strong>?</p>
+
+                <div class="alert alert-warning">
+                    <i class="bi bi-info-circle"></i>
+                    <strong>Внимание!</strong> Это действие нельзя отменить.
+                    {% if object.promo_codes.count > 0 %}
+                    <br>Также будут удалены связанные промокоды ({{ object.promo_codes.count }} шт.).
+                    {% endif %}
+                </div>
+
+                <div class="mb-3">
+                    <strong>Информация о скидке:</strong>
+                    <ul class="mb-0">
+                        <li>Тип: {% if object.discount_type == 'percentage' %}Процент ({{ object.value }}%){% else %}{{ object.value }} руб.{% endif %}</li>
+                        <li>Область: {% if object.scope == 'order' %}На заказ{% elif object.scope == 'product' %}На товары{% else %}На категории{% endif %}</li>
+                        <li>Использований: {{ object.current_usage_count }} раз</li>
+                    </ul>
+                </div>
+
+                <form method="post">
+                    {% csrf_token %}
+                    <div class="d-flex justify-content-between">
+                        <a href="{% url 'system_settings:discounts:list' %}" class="btn btn-secondary">Отмена</a>
+                        <button type="submit" class="btn btn-danger">
+                            <i class="bi bi-trash"></i> Удалить
+                        </button>
+                    </div>
+                </form>
+            </div>
+        </div>
+    </div>
+</div>
+{% endblock %}