Объединены файлы правил системы в единую базу знаний v3.0 с устранением противоречий и дублирования. Создан rules-unified.md на основе rules.md, rules1.md и rules2.md с добавлением всех уникальных разделов. Обновлена терминология системы с соответствием реальной схеме БД (ТОВАР→PRODUCT, РАСХОДНИКИ→CONSUMABLE). Архивированы старые файлы правил в папку archive. Обновлены ссылки в CLAUDE.md и development-checklist.md на новый единый источник истины.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Veronika Smirnova
2025-08-05 00:19:17 +03:00
parent 17ffd6c9ed
commit ee72a9488b
21 changed files with 9147 additions and 174 deletions

813
archive/rules-v1.0.md Normal file
View File

@ -0,0 +1,813 @@
# ПРАВИЛА СИСТЕМЫ СКЛАДА ПОСТАВЩИКА
> ⚠️ **ВАЖНОЕ ПРИМЕЧАНИЕ**: Данные из этого файла могут быть удалены только с разрешения пользователя. Все изменения должны согласовываться.
## 🔤 ТЕРМИНЫ СИСТЕМЫ
> Для людей → `В коде`
- ТОВАР`PRODUCT`
- РАСХОДНИКИ → `CONSUMABLE`
- БРАК → `DEFECT` *(планируется)*
- ПРОДУКТ → `FINISHED_PRODUCT` *(планируется)*
## 1. 🎯 ОСНОВНЫЕ ПРИНЦИПЫ
### 1.0 Структура системы по кабинетам
**🏢 КАБИНЕТ ПОСТАВЩИКА** - управляет созданием и поставкой:
- **ТОВАР** - базовые товары от поставщика
- **РАСХОДНИКИ** - материалы и вспомогательные товары
**🏭 КАБИНЕТ ФУЛФИЛМЕНТА** - принимает, обрабатывает и управляет всеми типами:
- **ТОВАР** - базовые товары от поставщиков (принятые на склад)
- **БРАК** - товары с дефектами (производные от товара)
- **ПРОДУКТ** - готовые к продаже товары (производные от товара)
- **РАСХОДНИКИ ФУЛФИЛМЕНТА** - операционные материалы фулфилмента
- **РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для товаров селлеров
### 1.1 Типизация предметов
- **ОБЯЗАТЕЛЬНО**: Каждый предмет должен иметь один из следующих типов:
**ТИПЫ ПРЕДМЕТОВ ПО КАБИНЕТАМ:**
**🏢 КАБИНЕТ ПОСТАВЩИКА:**
1. **ТОВАР** (`PRODUCT`) - базовый тип товара от поставщика
2. **РАСХОДНИКИ** (`CONSUMABLE`) - материалы и вспомогательные товары от поставщика
**🏭 КАБИНЕТ ФУЛФИЛМЕНТА:**
1. **ТОВАР** (`PRODUCT`) - базовые товары от поставщиков (принятые на склад)
2. **БРАК** (`DEFECT` - планируется) - производная от товара (товар с дефектами)
3. **ПРОДУКТ** (`FINISHED_PRODUCT` - планируется) - готовый к продаже товар
4. **РАСХОДНИКИ ФУЛФИЛМЕНТА** - операционные материалы фулфилмента
5. **РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для товаров селлеров
- **ЗАПРЕЩЕНО**: Создание предметов без указания типа
- **ВАЖНО**: Товар ≠ Продукт (это разные сущности в системе)
- **ПРАВИЛО**: Тип определяет логику обработки, отображения и 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_
_Статус: АКТИВНЫЕ ПРАВИЛА_