sfera/rules.md

ПРАВИЛА СИСТЕМЫ СКЛАДА ПОСТАВЩИКА

⚠️ ВАЖНОЕ ПРИМЕЧАНИЕ: Данные из этого файла могут быть удалены только с разрешения пользователя. Все изменения должны согласовываться.

1. 🎯 ОСНОВНЫЕ ПРИНЦИПЫ

1.1 Типизация предметов

• ОБЯЗАТЕЛЬНО: Каждый предмет должен иметь один из следующих типов:

  1. ТОВАР - базовый тип товара от поставщика
  2. БРАК - производная от товара (товар с дефектами)
  3. РАСХОДНИКИ - материалы и вспомогательные товары от поставщика
  4. ПРОДУКТ - производная от товара (готовый к продаже товар)

• ЗАПРЕЩЕНО: Создание предметов без указания типа

• ВАЖНО: Товар ≠ Продукт (это разные сущности в системе)

• ПРАВИЛО: Тип определяет логику обработки, отображения и workflow в системе

• КЛАССИФИКАЦИЯ РАСХОДНИКОВ: Поставщик создает просто "РАСХОДНИКИ". При заказе, в зависимости от типа заказчика, они становятся:

  • Расходники фулфилмента - если заказывает фулфилмент-центр
  • Расходники селлеров - если заказывает селлер

1.2 Правила производных типов

• БРАК:

  • ПРОИСХОЖДЕНИЕ: Создается на основе существующего товара
  • СВЯЗЬ: Обязательная связь с родительским товаром
  • УЧЕТ: Отдельный учет в статистике потерь
  • WORKFLOW: Особый процесс списания и утилизации

• ПРОДУКТ:

  • ПРОИСХОЖДЕНИЕ: Создается на основе товара после обработки
  • ОТЛИЧИЕ: Товар - сырье, Продукт - готовая единица к продаже
  • СТАТУС: Имеет собственный жизненный цикл
  • УЧЕТ: Отдельная статистика от базового товара

• РАСХОДНИКИ ФУЛФИЛМЕНТА:

  • НАЗНАЧЕНИЕ: Для внутренних операций фулфилмент-центра
  • ЗАКАЗЧИК: Фулфилмент-центр заказывает для себя
  • УЧЕТ: В статистике операционных расходов фулфилмента

• РАСХОДНИКИ СЕЛЛЕРОВ:

  • НАЗНАЧЕНИЕ: Для товаров и операций селлеров
  • ЗАКАЗЧИК: Селлер заказывает через фулфилмент
  • УЧЕТ: В статистике расходов селлера

1.3 Уникальность артикулов

• ОБЯЗАТЕЛЬНО: Артикул должен быть уникальным в рамках организации
• ПРАВИЛО: Система должна автоматически генерировать артикул СФ при создании
• ФОРМАТ: СФ-{ТИП}-{КОД_КАТЕГОРИИ}-{КОД_ОРГАНИЗАЦИИ}-{TIMESTAMP}-{RANDOM}
• ТИПЫ В АРТИКУЛЕ:
  • TOV - Товар
  • BRK - Брак
  • R - Расходники (классифицируются при заказе)
  • PRD - Продукт

1.4 Обязательные поля

• КРИТИЧЕСКИ ВАЖНО: Название, артикул, цена > 0, тип предмета
• ОБЯЗАТЕЛЬНО: Количество (может быть 0 для предзаказа)
• ДЛЯ ПРОИЗВОДНЫХ ТИПОВ: Обязательная связь с родительским предметом (для брака и продукта)
• ДЛЯ РАСХОДНИКОВ: Обязательно указание подтипа (фулфилмента или селлеров)
• РЕКОМЕНДУЕТСЯ: Описание, категория, основное изображение

2. 🔒 ПРАВИЛА ДОСТУПА И БЕЗОПАСНОСТИ

2.1 Контроль доступа

• ЗАПРЕЩЕНО: Поставщик не может добавлять собственные предметы в корзину
• ПРАВИЛО: Только активные предметы (isActive: true) отображаются в маркете
• ОГРАНИЧЕНИЕ: Доступ к заказам только для участников процесса (создатель, поставщик, фулфилмент)
• ПО ТИПАМ ПРЕДМЕТОВ:
  • ТОВАР: Доступен всем типам организаций для заказа
  • БРАК: Доступен только для просмотра, заказ запрещен
  • РАСХОДНИКИ: Доступны всем типам организаций для заказа
    • При заказе фулфилмент-центром классифицируются как "расходники фулфилмента"
    • При заказе селлером классифицируются как "расходники селлеров"
  • ПРОДУКТ: Доступен для заказа после подтверждения готовности

2.2 Проверка остатков

• ОБЯЗАТЕЛЬНО: Проверять наличие предмета перед добавлением в корзину
• ПРАВИЛО: Количество в заказе не может превышать остаток на складе
• ИСКЛЮЧЕНИЕ: Предзаказы (если реализована функция)
• ОСОБЕННОСТИ ПО ТИПАМ:
  • ТОВАР/ПРОДУКТ: Стандартная проверка остатков
  • БРАК: Остатки учитываются, но заказ запрещен
  • РАСХОДНИКИ: Проверка с учетом резервирования под активные заказы

2.3 Валидация данных

• ОБЯЗАТЕЛЬНО: Проверка корректности всех числовых значений (цена, вес, количество)
• ПРАВИЛО: Цена должна быть больше 0
• ОГРАНИЧЕНИЕ: Вес и габариты должны быть положительными числами

3. 📊 ПРАВИЛА СТАТИСТИКИ И АНАЛИТИКИ

3.1 Актуализация данных

• КРИТИЧЕСКИ ВАЖНО: При изменении количества в карточке данные актуализируются во всей системе
• ПРАВИЛО: Статистика обновляется в реальном времени
• ОБЯЗАТЕЛЬНО: Отслеживание изменений для аналитики

3.2 Отображение метрик

• ОБЯЗАТЕЛЬНО: Блок статистики в верхней части раздела склад
• СОСТАВ: Общие остатки, заказано, в пути, остаток, продано
• ПРАВИЛО: Подсвечивать предметы с остатками ниже критического уровня
• РАЗДЕЛЕНИЕ ПО ТИПАМ:
  • ТОВАРЫ: Общая статистика товаров
  • ПРОДУКТЫ: Отдельный блок готовой продукции
  • БРАК: Статистика потерь и списаний
  • РАСХОДНИКИ ФУЛФИЛМЕНТА: Операционные материалы
  • РАСХОДНИКИ СЕЛЛЕРОВ: Материалы для товаров селлеров

4. 🚚 ПРАВИЛА WORKFLOW ПОСТАВОК

4.1 Жизненный цикл статусов

PENDING → SUPPLIER_APPROVED → CONFIRMED → LOGISTICS_CONFIRMED → SHIPPED → IN_TRANSIT → DELIVERED

• ЗАПРЕЩЕНО: Пропускать промежуточные статусы
• ПРАВИЛО: Каждое изменение статуса должно сопровождаться уведомлением
• ОБЯЗАТЕЛЬНО: Логирование всех изменений статусов

4.2 Уведомления

• АВТОМАТИЧЕСКИ: Отправка уведомления поставщику при создании заказа
• ОБЯЗАТЕЛЬНО: Уведомление всех участников при изменении статуса
• ФОРМАТ: Структурированные сообщения с деталями заказа

4.3 Роли и ответственность

• ПОСТАВЩИК: Создание товаров, одобрение заказов, отгрузка
• СЕЛЛЕР: Создание заказов, отслеживание поставок
• ФУЛФИЛМЕНТ: Приемка товаров, выбор логистики, управление складом
• ЛОГИСТИКА: Подтверждение доставки, транспортировка

5. 🖼️ ПРАВИЛА РАБОТЫ С ИЗОБРАЖЕНИЯМИ

5.1 Управление изображениями

• РЕКОМЕНДУЕТСЯ: Загружать несколько изображений для каждого товара
• ОБЯЗАТЕЛЬНО: Выбирать основное изображение для отображения в списках
• ПРАВИЛО: Изображения должны быть в поддерживаемых форматах (JPG, PNG, WebP)
• ОГРАНИЧЕНИЕ: Максимальный размер файла изображения

5.2 Отображение товаров

• ПРАВИЛО: 5 карточек в ряд в карточном режиме
• ОБЯЗАТЕЛЬНО: Возможность переключения между строчным и карточным режимами
• ФУНКЦИЯ: Предпросмотр изображений при наведении/клике

6. 🛒 ПРАВИЛА КОРЗИНЫ И ИЗБРАННОГО

6.1 Система корзины

• ПРАВИЛО: Одна корзина на организацию
• ПРОВЕРКА: Автоматическая проверка доступности товаров при добавлении
• ОГРАНИЧЕНИЕ: Нельзя добавлять неактивные товары
• ФУНКЦИЯ: Автоматическое обновление количества при повторном добавлении

6.2 Система избранного

• ПРАВИЛО: Индивидуальные избранные для каждого пользователя
• ФУНКЦИЯ: Быстрое добавление из избранного в корзину
• СИНХРОНИЗАЦИЯ: Проверка актуальности товаров в избранном

7. 🔄 ПРАВИЛА ИНТЕГРАЦИИ

7.1 Интеграция с маркетплейсами

• WILDBERRIES: Обязательная проверка активности API ключа
• СИНХРОНИЗАЦИЯ: Регулярное обновление данных из внешних источников
• ПРАВИЛО: Сохранение локальных копий данных для офлайн работы

7.2 Глобальная интеграция

• ОБЯЗАТЕЛЬНО: Товары поставщиков отображаются в глобальном маркете
• ПРАВИЛО: Разделение по типам (товары/расходники) в интерфейсе
• СИНХРОНИЗАЦИЯ: Данные склада синхронизируются с модулем аналитики

7.3 Интеграция с модулем "Услуги"

• РАСХОДНИКИ ФУЛФИЛМЕНТА В УСЛУГАХ:
  • Селлеры могут использовать расходники фулфилмента в разделе "Услуги / Расходники"
  • Для создания продукта из товара
  • Расходники списываются с остатков фулфилмента
  • Стоимость включается в стоимость услуги
• WORKFLOW ИСПОЛЬЗОВАНИЯ:
  1. Селлер выбирает услугу "Создание продукта"
  2. Указывает базовый товар
  3. Выбирает необходимые расходники фулфилмента
  4. Фулфилмент обрабатывает заказ и создает продукт
  5. Расходники списываются, создается готовый продукт

8. 💰 ПРАВИЛА ЦЕНООБРАЗОВАНИЯ И ЛОГИСТИКИ

8.1 Система тарификации

• ОБЯЗАТЕЛЬНО: Указание тарифов для грузов до 1м³ и свыше 1м³
• ПРАВИЛО: Автоматический расчет стоимости доставки по объему
• ФУНКЦИЯ: Отображение примерной стоимости доставки при заказе

8.2 Управление ценами

• ПРАВИЛО: Цена за единицу и цена за комплект (если применимо)
• ВАЛИДАЦИЯ: Все цены должны быть больше 0
• ФУНКЦИЯ: История изменения цен для аналитики

9. 🔍 ПРАВИЛА ПОИСКА И ФИЛЬТРАЦИИ

9.1 Система поиска

• ПОИСК ПО: Название, артикул, категория, бренд, описание
• ПРАВИЛО: Поиск должен быть регистронезависимым
• ФУНКЦИЯ: Автодополнение при вводе поискового запроса

9.2 Фильтрация и сортировка

• ФИЛЬТРЫ: По категории, типу товара, статусу активности, остаткам
• СОРТИРОВКА: По дате создания, названию, цене, остаткам
• ПРАВИЛО: Сохранение настроек фильтров для пользователя

10. 📱 ПРАВИЛА ПОЛЬЗОВАТЕЛЬСКОГО ИНТЕРФЕЙСА

10.1 Отзывчивость интерфейса

• ОБЯЗАТЕЛЬНО: Интерфейс должен работать на всех устройствах
• ПРАВИЛО: Адаптивная сетка для карточек товаров
• ФУНКЦИЯ: Оптимизация для мобильных устройств

10.2 Обратная связь пользователю

• ОБЯЗАТЕЛЬНО: Уведомления об успешных/неуспешных операциях
• ПРАВИЛО: Индикаторы загрузки для длительных операций
• ФУНКЦИЯ: Подтверждение критических действий (удаление, деактивация)

11. 🚨 ПРАВИЛА ОБРАБОТКИ ОШИБОК

11.1 Обработка ошибок

• ОБЯЗАТЕЛЬНО: Логирование всех ошибок
• ПРАВИЛО: Понятные сообщения об ошибках для пользователя
• ФУНКЦИЯ: Автоматическое восстановление после сбоев

11.2 Резервное копирование

• КРИТИЧЕСКИ ВАЖНО: Регулярное резервное копирование данных товаров
• ПРАВИЛО: Версионность изменений для возможности отката
• ФУНКЦИЯ: Автоматическое восстановление связей при сбоях

12. 📈 ПРАВИЛА ПРОИЗВОДИТЕЛЬНОСТИ

12.1 Оптимизация загрузки

• ПРАВИЛО: Пагинация для больших списков товаров
• ФУНКЦИЯ: Ленивая загрузка изображений
• ОПТИМИЗАЦИЯ: Кэширование часто запрашиваемых данных

12.2 Масштабируемость

• АРХИТЕКТУРА: Модульная структура для легкого расширения
• ПРАВИЛО: Использование индексов для быстрого поиска
• ФУНКЦИЯ: Горизонтальное масштабирование при росте нагрузки

13. 🔐 ПРАВИЛА БЕЗОПАСНОСТИ ДАННЫХ

13.1 Защита данных

• ОБЯЗАТЕЛЬНО: Шифрование чувствительных данных
• ПРАВИЛО: Аудит всех действий пользователей
• ФУНКЦИЯ: Контроль доступа на уровне API

13.2 Соответствие требованиям

• GDPR: Право на удаление и экспорт данных
• ПРАВИЛО: Прозрачность обработки персональных данных
• ФУНКЦИЯ: Логирование согласий пользователей

14. 🎯 ПРАВИЛА КАЧЕСТВА КОДА

14.1 Стандарты разработки

• ОБЯЗАТЕЛЬНО: Покрытие тестами критической функциональности
• ПРАВИЛО: Следование принципам SOLID
• ФУНКЦИЯ: Автоматическое тестирование при развертывании

14.2 Документация

• ОБЯЗАТЕЛЬНО: Документирование всех API методов
• ПРАВИЛО: Комментарии к сложной бизнес-логике
• ФУНКЦИЯ: Автоматическая генерация документации

---

15. 📦 СПЕЦИАЛЬНЫЕ ПРАВИЛА ДЛЯ ТИПОВ ПРЕДМЕТОВ

15.1 Правила для ТОВАРА

• СОЗДАНИЕ: Базовый тип, создается поставщиком
• СТАТУС: Может быть активным/неактивным
• ЗАКАЗ: Доступен для заказа всеми типами организаций
• ТРАНСФОРМАЦИЯ: Может быть преобразован в ПРОДУКТ или БРАК
• УЧЕТ: Основная единица складского учета
• ЦЕНА: Обязательна, больше 0

15.2 Правила для БРАКА

• СОЗДАНИЕ: Только на основе существующего ТОВАРА
• СВЯЗЬ: Обязательная связь с родительским товаром (parentId)
• СТАТУС: Всегда неактивен для заказа
• ЗАКАЗ: ЗАПРЕЩЕН заказ брака
• ОТОБРАЖЕНИЕ: Виден только для учета потерь
• СПИСАНИЕ: Особый workflow списания и утилизации
• СТАТИСТИКА: Учитывается в потерях и браке
• ЦЕНА: Может быть 0 (списанный товар)

15.3 Правила для ПРОДУКТА

• СОЗДАНИЕ: Только на основе существующего ТОВАРА через процесс "Создания продукта"
• СВЯЗЬ: Обязательная связь с родительским товаром (parentId)
• ОТЛИЧИЕ: Товар = сырье, Продукт = готовая единица
• СТАТУСЫ ЖИЗНЕННОГО ЦИКЛА:
  • Товар "на складе" → "в работе" → Продукт "готов к отправке"
• РЕЦЕПТУРА: Определяется селлером при создании поставки
• СОСТАВ: Товар + Услуга фулфилмента + Расходники (опционально)
• АРТИКУЛЫ: Наследует от товара + артикул MP (если связан)
• ЗАКАЗ: Доступен только в статусе "готов к отправке"
• ПРОЦЕСС: Обязательно проходит этап обработки на фулфилменте
• УЧЕТ: Отдельная статистика от базового товара
• ЦЕНА: Формируется из стоимости товара + услуг + расходников
• СВЯЗЬ С MP: Опциональная связь с карточкой маркетплейса

15.4 Правила для РАСХОДНИКОВ

• СОЗДАНИЕ: Поставщик создает карточки типа "РАСХОДНИКИ"
• УНИВЕРСАЛЬНОСТЬ: Один тип расходников для всех заказчиков
• ПРИМЕРЫ: Упаковочные материалы, этикетки, пленка, коробки, бирки, вкладыши
• ДОСТУП: Видны всем типам организаций в маркете
• ЗАКАЗ: Любая организация может заказать расходники

15.5 Классификация при заказе

РАСХОДНИКИ → РАСХОДНИКИ ФУЛФИЛМЕНТА (при заказе фулфилмент-центром):

• НАЗНАЧЕНИЕ: Для внутренних операций фулфилмент-центра и услуг селлерам
• УЧЕТ: В операционных расходах фулфилмента
• WORKFLOW: Поставщик → фулфилмент (прямая поставка)
• ИСПОЛЬЗОВАНИЕ: Для операций фулфилмента и услуг селлерам

РАСХОДНИКИ → РАСХОДНИКИ СЕЛЛЕРОВ (при заказе селлером):

• НАЗНАЧЕНИЕ: Для товаров и операций селлеров
• УЧЕТ: В расходах селлера
• WORKFLOW: Поставщик → фулфилмент → селлер
• ПРИВЯЗКА: Могут быть привязаны к конкретным товарам селлера

16. ⚠️ КРИТИЧЕСКИЕ ЗАПРЕТЫ

16.1 НИКОГДА НЕ ДЕЛАТЬ:

1. ❌ Удалять предметы с существующими заказами
2. ❌ Изменять статусы заказов без уведомлений
3. ❌ Обходить проверки остатков предметов
4. ❌ Давать доступ к чужим данным
5. ❌ Игнорировать ошибки валидации
6. ❌ Сохранять пароли в открытом виде
7. ❌ Пропускать логирование критических операций
8. ❌ Блокировать интерфейс без индикации загрузки
9. ❌ Создавать брак или продукт без связи с родительским товаром
10. ❌ Создавать отдельные типы расходников (только общий тип "РАСХОДНИКИ")
11. ❌ Разрешать заказ брака
12. ❌ Нарушать иерархию типов предметов

---

17. 🏢 ПРАВИЛА СИСТЕМЫ СКЛАДА ФУЛФИЛМЕНТА

17.1 Структура раздела склад фулфилмента

17.1.1 Блок статистика склада

ОБЯЗАТЕЛЬНАЯ ПОСЛЕДОВАТЕЛЬНОСТЬ МОДУЛЕЙ:

1. ПРОДУКТ - готовые к продаже товары
2. ТОВАР - базовые товары от поставщиков
3. БРАК - товары с дефектами
4. ВОЗВРАТЫ С ПВЗ - возвращенные товары
5. РАСХОДНИКИ СЕЛЛЕРОВ - материалы для селлеров
6. РАСХОДНИКИ ФУЛФИЛМЕНТ - операционные материалы

ТРЕБОВАНИЯ К МОДУЛЯМ:

• ОБЯЗАТЕЛЬНО: Каждый модуль отображает текущее наличие на складе
• ПРАВИЛО: Последовательность модулей не может быть изменена
• СТАТУС: Все модули отображают актуальные данные в реальном времени

17.1.2 Система учёта движения товаров

ОСНОВНЫЕ ПРИНЦИПЫ:

• ПРИХОД: Товары поступают через принятые поставки (из состояния "в пути" → "на складе")
• ОБРАБОТКА: Товары переходят в статус "в работе" для создания продуктов
• РАСХОД: Товары убывают при отгрузке, списании, возврате, превращении в продукты
• УЧЁТ: Ведется учет прихода и расхода для каждого типа предметов
• ВИЗУАЛИЗАЦИЯ: Движение отображается в дополнительных значениях

ДОПОЛНИТЕЛЬНЫЕ ЗНАЧЕНИЯ (показатели движения):

• ПРИБЫЛО: Количество предметов, поступивших на склад
• УБЫЛО: Количество предметов, списанных со склада
• ВЛИЯНИЕ: От этих значений зависят основные значения (общее количество)

ОСНОВНЫЕ ЗНАЧЕНИЯ (текущие остатки):

• ОПРЕДЕЛЕНИЕ: Итоговое количество предметов на складе
• РАСЧЁТ: Основные значения = Предыдущие остатки + Прибыло - Убыло
• ОТОБРАЖЕНИЕ: Показываются в каждом модуле статистики
• РАЗДЕЛЕНИЕ ТОВАРОВ:
  • Товары "на складе" - готовы к обработке
  • Товары "в обработке" - находятся в процессе создания продукта

17.1.3 Модуль "Расходники фулфилмента"

ОСОБЕННОСТИ МОДУЛЯ:

• ИНТЕРАКТИВНОСТЬ: Является кликабельным элементом
• ФУНКЦИОНАЛЬНОСТЬ: Содержит полноценный раздел учёта
• ДОСТУП: Переход к детальному управлению расходниками фулфилмента
• СОДЕРЖАНИЕ: Полный функционал работы с расходниками фулфилмента

17.1.4 Блок детализация по Магазинам

НАЗНАЧЕНИЕ: Распределение товаров по торговым точкам/магазинам ФУНКЦИИ:

• Отображение остатков по каждому магазину
• Управление распределением товаров
• Контроль движения между магазинами

17.2 Правила движения товаров в системе фулфилмента

17.2.1 Поступление товаров

ИСТОЧНИКИ ПОСТУПЛЕНИЯ:

• ПОСТАВКИ: От поставщиков через систему заказов
• ВОЗВРАТЫ: Товары, возвращенные с ПВЗ
• ПЕРЕМЕЩЕНИЯ: Между складами и магазинами

ПРОЦЕСС ПРИЁМКИ:

1. Поставка переходит в статус "принято"
2. Товары из "в пути" → "на складе"
3. Обновляются основные значения
4. Фиксируется в дополнительных значениях как "прибыло"

17.2.2 Расход товаров

ПРИЧИНЫ РАСХОДА:

• ОТГРУЗКА: Товары отправлены селлерам
• СПИСАНИЕ: Брак, утрата, утилизация
• ВОЗВРАТ: Возврат поставщику
• ИСПОЛЬЗОВАНИЕ: Расходники для операций

17.3 Процесс "Создания продукта"

17.3.1 Workflow создания продукта

ЭТАПЫ ПРОЦЕССА:

1. ПОСТУПЛЕНИЕ: Товар приходит на склад фулфилмента (статус "на складе")
2. СОРТИРОВКА: Перебор товара, отсеивание брака
3. ПОДГОТОВКА К РАБОТЕ: Менеджер задает параметры работы
4. ОБРАБОТКА: Превращение товара в продукт по "рецептуре" селлера
5. ЗАВЕРШЕНИЕ: Готовый продукт (статус "готов к отправке")

17.3.2 Управление процессом

РАЗДЕЛ "СОЗДАНИЕ ПРОДУКТА":

• НОВЫЕ: Поставки после нажатия "принято", ожидающие назначения
• В РАБОТЕ: Поставки в процессе обработки
• ВЫПОЛНЕНО: Завершенные поставки с готовыми продуктами

ДЕЙСТВИЯ МЕНЕДЖЕРА В "НОВЫЕ":

• ДЕДЛАЙН: Указание срока выполнения работы
• ОТВЕТСТВЕННЫЙ: Назначение исполнителя
• МЕСТО ХРАНЕНИЯ: Указание локации для готовых продуктов (опционально)
• ЗАПУСК: Нажатие кнопки "В работе"

17.3.3 Рецептура продукта (задается селлером)

СЕЛЛЕР УКАЗЫВАЕТ В ПОСТАВКЕ:

• БАЗОВЫЙ ТОВАР: Исходный материал (например, футболка)
• УСЛУГА ФУЛФИЛМЕНТА: Из каталога услуг (например, "погладить")
• РАСХОДНИК СЕЛЛЕРА: Материалы селлера (например, фирменный пакет)
• РАСХОДНИК ФУЛФИЛМЕНТА: Материалы фулфилмента (например, короб + маркировка)

РЕЗУЛЬТАТ: ПРОДУКТ = Товар + Услуга + Расходники

17.3.4 Учет план/факт в процессе работы

ПЛАН: Количество товара из поставки селлера ФАКТ: Реальное количество после сортировки

ФИКСАЦИЯ БРАКА:

• КОГДА: В процессе работы (вкладка "В работе")
• КТО: Ответственный исполнитель
• ДЕТАЛИЗАЦИЯ: По каждому предмету (размер/объем)
• ОБНОВЛЕНИЕ: Можно вносить изменения до нажатия "Выполнено"

ВЛИЯНИЕ НА СТАТИСТИКУ:

• При принятии поставки: +План в статистику
• При выявлении факта: корректировка на реальные данные
• ФОРМУЛА: Факт = Брак + Хороший товар
• ЛОГИКА: Фактическое количество = сумма всех пересчитанных предметов

17.3.5 Связь с маркетплейсами

АРТИКУЛЫ ПРОДУКТА:

• ОСНОВНОЙ: Наследует артикул исходного товара
• ДОПОЛНИТЕЛЬНЫЙ: Артикул карточки маркетплейса (если связан)

СВЯЗЫВАНИЕ С MP:

• МОМЕНТ: При создании поставки селлером
• ПОЛЕ: "Связать с карточкой маркетплейса" (опционально)
• ИСТОЧНИК: Карточки, полученные через API маркетплейсов
• ПРАВИЛО: Карточка товара селлера на MP = карточке продукта в системе

17.4 Валидация и контроль в складе фулфилмента

ОБЯЗАТЕЛЬНЫЕ ПРОВЕРКИ:

• ОСТАТКИ: Не могут быть отрицательными
• ДВИЖЕНИЕ: Каждое изменение должно быть зафиксировано
• СИНХРОНИЗАЦИЯ: Основные и дополнительные значения должны соответствовать
• ДОСТУП: Только авторизованный персонал фулфилмента
• ПЛАН/ФАКТ: Корректировка статистики при выявлении расхождений

---

18. 🎖️ ПРИОРИТЕТЫ РАЗРАБОТКИ

18.1 ВЫСОКИЙ ПРИОРИТЕТ:

1. 🔴 Безопасность и контроль доступа
2. 🔴 Целостность данных и валидация
3. 🔴 Корректность статусов поставок
4. 🔴 Уведомления участников процесса
5. 🔴 Правильная типизация предметов
6. 🔴 Связи между товарами и производными типами

18.2 СРЕДНИЙ ПРИОРИТЕТ:

1. 🟡 Производительность и оптимизация
2. 🟡 Пользовательский опыт
3. 🟡 Аналитика и отчетность
4. 🟡 Интеграции с внешними системами
5. 🟡 Workflow для брака и продуктов
6. 🟡 Разделение расходников по типам

18.3 НИЗКИЙ ПРИОРИТЕТ:

1. 🟢 Дополнительные фильтры
2. 🟢 Косметические улучшения
3. 🟢 Экспериментальные функции
4. 🟢 Расширенная кастомизация

---

19. 🏠 ПРАВИЛА КАБИНЕТА СЕЛЛЕРА / РАЗДЕЛ "МОИ ПОСТАВКИ"

19.1 Структура и навигация

19.1.1 Основная структура

ОБЯЗАТЕЛЬНАЯ СТРУКТУРА РАЗДЕЛА:

• ПОСТАВКИ НА ФУЛФИЛМЕНТ:
  • Товар → Карточки / Поставщики
  • Расходники селлера
• ПОСТАВКИ НА МАРКЕТПЛЕЙСЫ:
  • Wildberries
  • Ozon

НАВИГАЦИЯ: Переключение через кнопки между основными разделами

19.1.2 Различия подразделов товаров

КАРТОЧКИ:

• ИСТОЧНИК: WB API карточки селлера
• ФУНКЦИИ: Указание рецептуры + выбор логистики
• РЕЗУЛЬТАТ: WildberriesSupply

ПОСТАВЩИКИ:

• ИСТОЧНИК: Каталог товаров поставщиков
• ФУНКЦИИ: Заказ товаров + рецептура для продукта
• РЕЗУЛЬТАТ: SupplyOrder

19.2 Правила создания поставки расходников селлера

19.2.1 Структура страницы

БЛОК 1: ПОСТАВЩИКИ (обязательный)

• РАСПОЛОЖЕНИЕ: Верхняя часть экрана
• ИСТОЧНИК: Только поставщики из раздела "Партнеры"
• НАВИГАЦИЯ: Горизонтальный скролл при превышении ширины
• ВЫБОР: Только один поставщик одновременно
• ИНДИКАЦИЯ: Визуальное выделение выбранной карточки

БЛОК 2: РАСХОДНИКИ (зависимый)

• УСЛОВИЕ: Активен только после выбора поставщика
• СОДЕРЖАНИЕ: Только расходники выбранного поставщика
• ОБЯЗАТЕЛЬНЫЕ ЭЛЕМЕНТЫ:
  • Сортировка: цена, название, категория
  • Фильтры: категория, ценовой диапазон
• КАРТОЧКА РАСХОДНИКА:
  • Фото, название, цена, остаток, категория
  • Количество в комплекте (если применимо)
  • Поле ввода количества с валидацией
  • Кнопки +/- для изменения по единице

БЛОК 3: КОРЗИНА (справа)

• РАСПОЛОЖЕНИЕ: Правая часть экрана
• СОДЕРЖАНИЕ:
  • Счетчик видов расходников
  • Детализация по каждому расходнику
  • Общая сумма
• УПРАВЛЕНИЕ:
  • Изменение количества (с валидацией остатков)
  • Удаление позиций
• ОБЯЗАТЕЛЬНЫЕ ПОЛЯ:
  • Выбор фулфилмент-центра (из партнеров)
  • Дата поставки (не прошедшая, по умолчанию - текущая)

19.2.2 Валидация и ограничения

КОЛИЧЕСТВО ТОВАРОВ:

• МИНИМУМ: 1 единица/комплект
• МАКСИМУМ: Остаток у поставщика
• ПРОВЕРКА: В реальном времени при изменении

ДАТА ПОСТАВКИ:

• ЗАПРЕТ: Выбор прошедших дат
• ПО УМОЛЧАНИЮ: Дата создания поставки

ОБЯЗАТЕЛЬНЫЕ ПОЛЯ:

• Выбор поставщика
• Минимум один расходник в корзине
• Выбор фулфилмент-центра
• Дата поставки

19.3 Отображение и управление поставками

19.3.1 Многоуровневая таблица

ПЕРВЫЙ УРОВЕНЬ (основной список):

• СОРТИРОВКА: Номер поставки от большего к меньшему
• ОБЯЗАТЕЛЬНЫЕ КОЛОНКИ:
  • Порядковый номер поставки
  • Количество видов расходников
  • Стоимость всей поставки
  • Количество категорий
  • Статус поставки

ВТОРОЙ УРОВЕНЬ (детализация):

• АКТИВАЦИЯ: По клику на строку первого уровня
• СОДЕРЖАНИЕ:
  • Название расходника
  • Количество
  • Цена
  • Категория
  • Поставщик
• ОГРАНИЧЕНИЯ: Только просмотр, редактирование запрещено

19.3.2 Статусы поставок

ЖИЗНЕННЫЙ ЦИКЛ СТАТУСОВ:

1. В работе - создана селлером
2. Одобрена - подтверждена поставщиком
3. Ожидает отгрузки - логистика назначена
4. В пути - товар отгружен
5. Доставлена/Принято - получена фулфилментом

19.4 Workflow и бизнес-логика

19.4.1 Участники процесса

СЕЛЛЕР:

• Создает поставку
• Отслеживает статусы
• Получает уведомления об изменениях

ПОСТАВЩИК:

• Получает уведомление о заказе
• Вносит данные о грузовых местах и объеме
• Подтверждает поставку
• Отмечает отгрузку

ФУЛФИЛМЕНТ:

• Назначает ответственного
• Выбирает логистику
• Принимает товар
• Указывает место хранения

ЛОГИСТИКА:

• Получает заявку
• Подтверждает возможность доставки
• Осуществляет транспортировку

19.4.2 Уведомления

ОБЯЗАТЕЛЬНЫЕ УВЕДОМЛЕНИЯ:

• Поставщику: о новом заказе расходников
• Фулфилменту: о подтвержденной поставке
• Логистике: о назначении на заявку
• Селлеру: об изменении каждого статуса

19.5 Ограничения и запреты

ЗАПРЕЩЕНО:

• Редактирование созданной поставки
• Выбор нескольких поставщиков одновременно
• Заказ количества сверх остатков
• Выбор прошедших дат поставки
• Создание поставки без выбора фулфилмент-центра

ОБЯЗАТЕЛЬНО:

• Валидация остатков перед добавлением в корзину
• Проверка доступности фулфилмент-центра
• Отправка уведомлений на каждом этапе
• Логирование всех изменений статусов

---

Эти правила являются обязательными для всех участников разработки и должны соблюдаться на всех этапах жизненного цикла системы.

Версия: 1.0
Дата создания: 2024
Статус: АКТИВНЫЕ ПРАВИЛА