octopus/TESTING_WRITEOFF_IMPROVEMENTS.md

Тестирование улучшений WriteOff UI

Краткая инструкция тестирования

Подготовка

1. Убедитесь что у вас есть актуальные данные:

   • Склад (Warehouse)
   • Товар (Product)
   • Партия товара (StockBatch) с остатком > 0

2. Откройте страницу: http://grach.localhost:8000/inventory/writeoffs/create/

---

Тест 1: Информация об остатке партии

Шаги:

1. Выберите партию из dropdown "Партия"
2. Ожидаемый результат:
   • Под dropdown появляется серый блок:

   📋 Остаток в партии: X шт
   

   • Где X это количество в выбранной партии

Проверка:

• ✅ Блок информации появляется при выборе
• ✅ Блок исчезает если выбрать пустое значение
• ✅ Количество обновляется при смене партии

---

Тест 2: Реал-тайм предупреждение при превышении

Шаги:

1. Выберите партию (например, с остатком 5 шт)
2. Введите в поле "Количество" число МЕНЬШЕ остатка (например, 3)
3. Ожидаемый результат: Никаких предупреждений

Шаги 2:

1. Введите в поле "Количество" число БОЛЬШЕ остатка (например, 10)
2. Ожидаемый результат:

   ⚠️ Внимание! Вы пытаетесь списать 10 шт,
   а в партии только 5 шт.
   Недостаток: 5 шт.
   

Проверка:

• ✅ Предупреждение НЕ появляется при quantity <= batch.quantity
• ✅ Предупреждение ПОЯВЛЯЕТСЯ при quantity > batch.quantity
• ✅ Предупреждение обновляется в реал-тайме при каждом вводе
• ✅ Правильно рассчитывается недостаток (shortage)

---

Тест 3: Отправка валидных данных

Шаги:

1. Выберите партию (остаток = 5 шт)
2. Введите количество = 3 (меньше остатка)
3. Выберите причину (например, "damage")
4. Нажмите кнопку "Сохранить"

Ожидаемый результат:

• ✅ Форма отправляется успешно
• ✅ Перенаправляется на список списаний
• ✅ Появляется зеленое сообщение об успехе
• ✅ Остаток в партии уменьшился на 3 (стал 2)

---

Тест 4: Отправка невалидных данных (количество > остатка)

Шаги:

1. Выберите партию (остаток = 5 шт)
2. Введите количество = 10 (больше остатка)
3. Нажмите кнопку "Сохранить"

Ожидаемый результат:

• ✅ Форма НЕ отправляется
• ✅ На странице появляется красный alert:

  ❌ Ошибка:
  Невозможно списать 10 шт из партии,
  где только 5 шт.
  Недостаток: 5 шт.
  

• ✅ Пользователь остается на форме
• ✅ Данные в полях сохраняются (он может отредактировать)
• ✅ Остаток в партии не изменился (остался 5)

---

Тест 5: Отключенный JavaScript (браузерная консоль)

Если JavaScript отключен:

Шаги:

1. Откройте DevTools (F12)
2. Отключите JavaScript
3. Обновите страницу
4. Заполните форму с quantity > batch.quantity
5. Нажмите "Сохранить"

Ожидаемый результат:

• ✅ Реал-тайм валидация не работает (это ок - это просто nice-to-have)
• ✅ Форма отправляется на сервер
• ✅ Django form validation ловит ошибку
• ✅ На странице появляется красный alert с ошибкой
• ✅ Остаток в партии не изменился (данные защищены)

---

Тест 6: Граничные случаи

Граничный случай 1: Количество = остатку

Шаги:

1. Партия имеет остаток = 5 шт
2. Введите количество = 5
3. Ожидаемый результат:
   • ✅ Никаких предупреждений (это валидное значение)
   • ✅ Форма отправляется успешно
   • ✅ Партия полностью списывается (остаток = 0)
   • ✅ Партия деактивируется (is_active = False)

Граничный случай 2: Очень малое количество

Шаги:

1. Введите количество = 0.001 (если поддерживается)
2. Ожидаемый результат:
   • ✅ Форма отправляется
   • ✅ Остаток уменьшается на 0.001
   • ✅ Все работает корректно

Граничный случай 3: Дробные числа

Шаги:

1. Партия имеет остаток = 5.5 шт
2. Введите количество = 5.6
3. Ожидаемый результат:
   • ✅ Появляется предупреждение о превышении
   • ✅ Недостаток = 0.1 шт (правильный расчет)

---

Проверочный лист

Общие проверки

• JavaScript выполняется без ошибок (проверить консоль F12)
• Стили Bootstrap применены правильно
• Все иконки (⚠️, ❌, 📋) отображаются корректно
• Alert блоки имеют правильные цвета (красный для ошибок, желтый для warning)
• Кнопка закрытия alert работает

Функциональные проверки

• Информация об остатке появляется при выборе партии
• Предупреждение появляется при quantity > batch.quantity
• Ошибка валидации отображается красиво
• Форма не отправляется при невалидных данных
• При валидных данных форма отправляется и остаток уменьшается

Граничные случаи

• Количество = остатку работает правильно
• Дробные количества поддерживаются
• Партия деактивируется когда количество <= 0
• JavaScript отключение не ломает functionality (только UX)

---

Логирование для отладки

Если что-то не работает, проверьте:

1. Консоль браузера (F12 → Console)

   • Ошибки JavaScript
   • Логи из скрипта

2. Django логи

   • Ошибки валидации
   • Ошибки в сохранении модели

3. Network tab (F12 → Network)

   • Проверить POST запросы
   • Ответ сервера (200, 400, 500 и т.д.)

---

Быстрая проверка

Самый быстрый способ проверить что все работает:

# 1. Откройте форму
# http://grach.localhost:8000/inventory/writeoffs/create/

# 2. Выберите партию - должна появиться информация об остатке

# 3. Введите количество больше остатка - должно появиться предупреждение

# 4. Нажмите сохранить - должна появиться ошибка

# 5. Поправьте количество на меньшее - предупреждение исчезнет

# 6. Нажмите сохранить - форма отправится успешно

---

Известные ограничения

1. Форматирование дробных чисел: JavaScript использует .toFixed(3) для недостатка, может быть 0.100 вместо 0.1

   • Это не критично, просто визуально

2. Локализация запятой/точки: Код поддерживает оба варианта в regex но может быть проблемы с разными локалями

   • Проверьте что в вашей локали правильно парсятся дробные числа

3. Старые браузеры: Код использует addEventListener и querySelector - не поддерживается IE11

   • Но IE11 давно не поддерживается, это нормально

---

Что дальше?

Если тестирование прошло успешно:

1. ✅ Все остатки партий уменьшаются правильно
2. ✅ Никакие отрицательные значения не создаются
3. ✅ UI четкий и понятный

То система готова к использованию!