Добавлены кнопки навигации "Главная" и "Экономика" в боковую панель. Реализованы обработчики кликов для перехода на соответствующие страницы. Обновлены стили кнопок для улучшения пользовательского интерфейса в зависимости от состояния навигации.

2025-08-02 13:13:22 +03:00
parent 3f759e7454
commit a33adda9d7
21 changed files with 3225 additions and 0 deletions
--- a/rules2.md
+++ b/rules2.md
@ -0,0 +1,1070 @@
+# ПРАВИЛА СИСТЕМЫ УПРАВЛЕНИЯ СКЛАДАМИ И ПОСТАВКАМИ - БАЗА ЗНАНИЙ v2.0
+
+> ⚠️ **ВАЖНОЕ ПРИМЕЧАНИЕ**: Данный файл является объединенной базой знаний системы на основе анализа rules.md, rules1.md и description.md. Все изменения должны согласовываться.
+
+---
+
+## 📑 ОГЛАВЛЕНИЕ
+
+### 🏗️ **АРХИТЕКТУРА И ОСНОВЫ**
+
+1. [🎯 Основные принципы системы](#1--основные-принципы-системы)
+2. [📦 Типизация предметов](#2--типизация-предметов)
+3. [🏢 Структура кабинетов](#3--структура-кабинетов)
+4. [🔐 Система ролей и доступов](#4--система-ролей-и-доступов)
+
+### 🚚 **WORKFLOW И ПРОЦЕССЫ**
+
+5. [🚚 Workflow поставок](#5--workflow-поставок)
+6. [🔄 Процесс создания продукта](#6--процесс-создания-продукта)
+7. [📊 Система учета движения товаров](#7--система-учета-движения-товаров)
+
+### 🏢 **КАБИНЕТЫ СИСТЕМЫ**
+
+8. [🏠 Общие правила кабинетов](#8--общие-правила-кабинетов)
+9. [🏠 Кабинет селлера](#9--кабинет-селлера)
+10. [🏪 Кабинет поставщика](#10--кабинет-поставщика)
+11. [🏭 Кабинет фулфилмента](#11--кабинет-фулфилмента)
+12. [🚚 Кабинет логистики](#12--кабинет-логистики)
+
+### 🌐 **ИНТЕГРАЦИИ И ФУНКЦИИ**
+
+13. [🌐 Интеграции с системой](#13--интеграции-с-системой)
+14. [📊 Статистика и аналитика](#14--статистика-и-аналитика)
+15. [⚠️ Критические запреты](#15--критические-запреты)
+
+### 💻 **ТЕХНИЧЕСКИЕ ПРАВИЛА**
+
+16. [📱 Правила пользовательского интерфейса](#16--правила-пользовательского-интерфейса)
+17. [🚨 Правила обработки ошибок](#17--правила-обработки-ошибок)
+18. [📈 Правила производительности](#18--правила-производительности)
+19. [🔐 Правила безопасности данных](#19--правила-безопасности-данных)
+20. [🎯 Правила качества кода](#20--правила-качества-кода)
+
+### 📋 **ДОПОЛНИТЕЛЬНО**
+
+21. [📋 Приложение: Дополнительные возможности и планы](#-приложение-дополнительные-возможности-и-планы)
+
+---
+
+## 🏷️ РЕЕСТР СУЩНОСТЕЙ СИСТЕМЫ
+
+### 📦 **ОСНОВНЫЕ ПРЕДМЕТЫ**
+
+| Сущность   | Название в системе                 | Кабинет создания | Описание                                        | Статус          |
+| ---------- | ---------------------------------- | ---------------- | ----------------------------------------------- | --------------- |
+| Товар      | `Product` (type: PRODUCT)          | Поставщик        | Базовый тип товара от поставщика                | ✅ Реализовано  |
+| Брак       | `Product` (type: DEFECT)           | Фулфилмент       | Производная от товара с дефектами               | 🔄 В разработке |
+| Расходники | `Product` (type: CONSUMABLE)       | Поставщик        | Материалы и вспомогательные товары              | ✅ Реализовано  |
+| Продукт    | `Product` (type: FINISHED_PRODUCT) | Фулфилмент       | Готовый к продаже товар (производная от товара) | 🔄 В разработке |
+
+### 🏢 **ОРГАНИЗАЦИИ И РОЛИ**
+
+| Сущность   | Название в системе                 | Основные функции                        | Статус         |
+| ---------- | ---------------------------------- | --------------------------------------- | -------------- |
+| Поставщик  | `Organization` (type: WHOLESALE)   | Создает товары и расходники             | ✅ Реализовано |
+| Селлер     | `Organization` (type: SELLER)      | Заказывает товары, управляет поставками | ✅ Реализовано |
+| Фулфилмент | `Organization` (type: FULFILLMENT) | Принимает товары, создает продукты      | ✅ Реализовано |
+| Логистика  | `Organization` (type: LOGIST)      | Управляет доставками                    | ✅ Реализовано |
+
+---
+
+## 1. 🎯 ОСНОВНЫЕ ПРИНЦИПЫ СИСТЕМЫ
+
+### 1.1 Главная логика системы
+
+**КЛЮЧЕВОЕ ПРАВИЛО**: Товар ≠ Продукт (это разные сущности в системе)
+
+- **ТОВАР** - сырье, базовый материал от поставщика
+- **ПРОДУКТ** - готовая к продаже единица после обработки
+
+### 1.2 Потоки в системе
+
+**ПОТОК ТОВАРОВ**: Поставщик → Фулфилмент → Селлер/Маркетплейс
+**ПОТОК РАСХОДНИКОВ**: Поставщик → Фулфилмент/Селлер (в зависимости от заказчика)
+
+### 1.3 Уникальность артикулов
+
+- **ФОРМАТ**: `СФ-{ТИП}-{КОД_КАТЕГОРИИ}-{КОД_ОРГАНИЗАЦИИ}-{TIMESTAMP}-{RANDOM}`
+- **ТИПЫ В АРТИКУЛЕ**:
+  - `TOV` - Товар
+  - `BRK` - Брак
+  - `R` - Расходники
+  - `PRD` - Продукт
+
+---
+
+## 2. 📦 ТИПИЗАЦИЯ ПРЕДМЕТОВ
+
+### 2.1 Четыре основных типа предметов
+
+#### **1. ТОВАР** (базовый тип)
+
+- **СОЗДАЕТСЯ**: Поставщиком
+- **СТАТУС**: Может быть активным/неактивным
+- **ЗАКАЗ**: Доступен для заказа всеми типами организаций
+- **ТРАНСФОРМАЦИЯ**: Может стать ПРОДУКТОМ или БРАКОМ
+- **ЦЕНА**: Обязательна, больше 0
+
+#### **2. БРАК** (производная от товара)
+
+- **СОЗДАЕТСЯ**: Фулфилментом на основе существующего ТОВАРА при обнаружении дефектов
+- **МОМЕНТ СОЗДАНИЯ**: В процессе "Создание продукта" / "В работе" после подсчета факта
+- **СВЯЗЬ**: Обязательная связь с родительским товаром (parentId)
+- **ЗАКАЗ**: ЗАПРЕЩЕН заказ брака
+- **СТАТУС**: Всегда неактивен для заказа
+- **ЦЕНА**: Для селлера - себестоимость дефектного товара, для фулфилмента - 0
+- **WORKFLOW**: Особый процесс списания и утилизации
+- **УЧЕТ**: Отдельный учет в статистике потерь
+- **ОТОБРАЖЕНИЕ**: Виден только для учета потерь
+
+#### **3. РАСХОДНИКИ** (базовый тип)
+
+- **СОЗДАЕТСЯ**: Поставщиком как универсальный тип
+- **КЛАССИФИКАЦИЯ ПРИ ЗАКАЗЕ**:
+  - Фулфилмент заказывает → "Расходники фулфилмента"
+  - Селлер заказывает → "Расходники селлеров"
+- **ДОСТУП**: Видны всем типам организаций в маркете
+
+#### **4. ПРОДУКТ** (производная от товара)
+
+- **СОЗДАЕТСЯ**: Фулфилментом на основе ТОВАРА по заказу селлера
+- **ИНИЦИАТОР**: Селлер создает заказ с рецептурой, фулфилмент исполняет
+- **СВЯЗЬ**: Обязательная связь с родительским товаром (parentId)
+- **РЕЦЕПТУРА**: Задается селлером при создании заказа (Товар + Услуга + Расходники)
+- **СТАТУСЫ**: "в работе" → "готов к отправке"
+- **ЗАКАЗ**: Доступен только в статусе "готов к отправке"
+
+### 2.2 Обязательные поля карточки
+
+**КРИТИЧЕСКИ ВАЖНО**: Название, артикул, цена > 0, тип предмета
+**ИСКЛЮЧЕНИЕ ДЛЯ БРАКА**: Цена может быть 0 для фулфилмента (себестоимость для селлера)
+**ОБЯЗАТЕЛЬНО**: Количество (может быть 0 для предзаказа)
+**ДЛЯ ПРОИЗВОДНЫХ ТИПОВ**: Обязательная связь с родительским предметом
+
+---
+
+## 3. 🏢 СТРУКТУРА КАБИНЕТОВ
+
+### 3.1 Кабинет поставщика
+
+**СОЗДАЕТ И УПРАВЛЯЕТ**:
+
+- **ТОВАР** - базовые товары поставщика
+- **РАСХОДНИКИ** - материалы и вспомогательные товары
+
+### 3.2 Кабинет фулфилмента
+
+**ПРИНИМАЕТ, ОБРАБАТЫВАЕТ И УПРАВЛЯЕТ**:
+
+- **ТОВАР** - базовые товары от поставщиков (принятые на склад)
+- **БРАК** - производная от товара (товары с дефектами)
+- **ПРОДУКТ** - производная от товара (готовые к продаже товары)
+- **РАСХОДНИКИ ФУЛФИЛМЕНТА** - операционные материалы фулфилмента
+- **РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для товаров селлеров
+
+### 3.3 Кабинет селлера
+
+**ЗАКАЗЫВАЕТ И УПРАВЛЯЕТ ПОСТАВКАМИ**:
+
+- Создает заказы товаров и расходников
+- Управляет поставками на фулфилмент и маркетплейсы
+- Отслеживает статусы поставок
+
+---
+
+## 4. 🔐 СИСТЕМА РОЛЕЙ И ДОСТУПОВ
+
+### 4.1 Роли в системе
+
+| Роль       | Функции                                                                  |
+| ---------- | ------------------------------------------------------------------------ |
+| Поставщик  | Создание товаров, одобрение заказов, отгрузка                            |
+| Селлер     | Создание заказов, отслеживание поставок                                  |
+| Фулфилмент | Приемка товаров, выбор логистики, управление складом, создание продуктов |
+| Логистика  | Подтверждение доставки, транспортировка                                  |
+
+### 4.2 Контроль доступа
+
+- **ЗАПРЕЩЕНО**: Поставщик не может добавлять собственные предметы в корзину
+- **ПРАВИЛО**: Только активные предметы (`isActive: true`) отображаются в маркете
+- **ОГРАНИЧЕНИЕ**: Доступ к заказам только для участников процесса
+- **БРАК**: Доступен только для просмотра, заказ запрещен
+
+### 4.3 Проверка остатков
+
+- **ОБЯЗАТЕЛЬНО**: Проверять наличие предмета перед добавлением в корзину
+- **ПРАВИЛО**: Количество в заказе не может превышать остаток на складе
+- **ИСКЛЮЧЕНИЕ**: Предзаказы (если реализована функция)
+- **ОСОБЕННОСТИ ПО ТИПАМ**:
+  - **ТОВАР/ПРОДУКТ**: Стандартная проверка остатков
+  - **БРАК**: Остатки учитываются, но заказ запрещен
+  - **РАСХОДНИКИ**: Проверка с учетом резервирования под активные заказы
+
+---
+
+## 5. 🚚 WORKFLOW ПОСТАВОК
+
+### 5.1 Жизненный цикл статусов
+
+```
+PENDING → SUPPLIER_APPROVED → CONFIRMED → LOGISTICS_CONFIRMED → SHIPPED → IN_TRANSIT → DELIVERED
+```
+
+### 5.2 Детальный процесс поставки
+
+#### **ЭТАП 1: Создание заказа**
+
+1. Селлер заказывает товар/расходники у поставщика
+2. Система создает SupplyOrder со статусом `PENDING`
+3. Автоматическое уведомление поставщику
+
+#### **ЭТАП 2: Обработка поставщиком**
+
+4. Поставщик получает оповещение
+5. Поставщик нажимает "Одобрить"
+6. Статус меняется на `SUPPLIER_APPROVED`
+
+#### **ЭТАП 3: Передача в фулфилмент**
+
+7. Поставка отображается в кабинете фулфилмента
+8. Фулфилмент выбирает ответственного и логистику
+9. Статус меняется на `CONFIRMED`
+
+#### **ЭТАП 4: Логистическое подтверждение**
+
+10. Логистика подтверждает доставку
+11. Статус меняется на `LOGISTICS_CONFIRMED`
+
+#### **ЭТАП 5: Отгрузка**
+
+12. Поставщик отгружает товар
+13. Статус меняется на `SHIPPED`, затем `IN_TRANSIT`
+
+#### **ЭТАП 6: Доставка и приемка**
+
+14. Логистика доставляет на фулфилмент
+15. Фулфилмент принимает товар
+16. Статус меняется на `DELIVERED`
+
+### 5.3 Система уведомлений
+
+**ОБЯЗАТЕЛЬНЫЕ УВЕДОМЛЕНИЯ**:
+
+- Поставщику: о новом заказе
+- Фулфилменту: о подтвержденной поставке
+- Логистике: о назначении на заявку
+- Селлеру: об изменении каждого статуса
+
+---
+
+## 6. 🔄 ПРОЦЕСС СОЗДАНИЯ ПРОДУКТА
+
+### 6.1 Workflow создания продукта
+
+#### **ЭТАП 1: ПОСТУПЛЕНИЕ И ПОДСЧЕТ**
+
+1. Товар приходит на склад фулфилмента (статус "на складе")
+2. Подсчет фактического количества товара (может отличаться от плана)
+3. Проверка товара на дефекты и выявление брака
+
+#### **ЭТАП 2: ПОДГОТОВКА К РАБОТЕ**
+
+4. Поставка попадает в раздел "Создание продукта" / "Новые"
+5. Менеджер задает:
+   - Дедлайн выполнения
+   - Ответственного исполнителя
+   - Место хранения готовых продуктов
+6. Нажимает "В работе"
+
+#### **ЭТАП 3: ОБРАБОТКА**
+
+7. Товары получают статус "в работе"
+8. Исполнитель работает по "рецептуре" селлера:
+   - Применяет услуги фулфилмента
+   - Использует расходники селлера
+   - Использует расходники фулфилмента
+
+#### **ЭТАП 4: УЧЕТ ПЛАН/ФАКТ**
+
+9. Фиксируется в разделе "В работе":
+   - **ПЛАН**: Количество из поставки селлера
+   - **ФАКТ**: Реальное количество после подсчета = Брак + Хороший товар
+   - **СОЗДАНИЕ БРАКА**: Данные о браке вносятся в кабинете фулфилмента
+   - **ДЕТАЛИЗАЦИЯ**: По каждому размеру/объему
+
+#### **ЭТАП 5: ЗАВЕРШЕНИЕ**
+
+10. Исполнитель нажимает "Выполнено"
+11. Товары становятся продуктами со статусом "готов к отправке"
+12. Поставка переходит в "Выполнено"
+
+### 6.2 Рецептура продукта (задается селлером)
+
+**РЕЗУЛЬТАТ**: ПРОДУКТ = Товар + Услуга + Расходники
+
+**КОМПОНЕНТЫ**:
+
+- **БАЗОВЫЙ ТОВАР**: Исходный материал (например, футболка)
+- **УСЛУГА ФУЛФИЛМЕНТА**: Из каталога услуг (например, "погладить")
+- **РАСХОДНИК СЕЛЛЕРА**: Материалы селлера (например, фирменный пакет)
+- **РАСХОДНИК ФУЛФИЛМЕНТА**: Материалы фулфилмента (например, короб + маркировка)
+- **СВЯЗЬ С MP**: Опциональная связь с карточкой маркетплейса
+
+---
+
+## 7. 📊 СИСТЕМА УЧЕТА ДВИЖЕНИЯ ТОВАРОВ
+
+### 7.1 Основные принципы учета
+
+- **ПРИХОД**: Товары поступают через принятые поставки (из "в пути" → "на складе")
+- **ОБРАБОТКА**: Товары переходят в статус "в работе" для создания продуктов
+- **РАСХОД**: Товары убывают при отгрузке, списании, возврате, превращении в продукты
+
+### 7.2 Двойной учет
+
+**ДОПОЛНИТЕЛЬНЫЕ ЗНАЧЕНИЯ (показатели движения)**:
+
+- **ПРИБЫЛО**: Количество предметов, поступивших на склад
+- **УБЫЛО**: Количество предметов, списанных со склада
+
+**ОСНОВНЫЕ ЗНАЧЕНИЯ (текущие остатки)**:
+
+- **ФОРМУЛА**: Основные значения = Предыдущие остатки + Прибыло - Убыло
+- **ОТОБРАЖЕНИЕ**: Показываются в каждом модуле статистики
+
+### 7.3 Состояния процессов в фулфилменте
+
+- **"На складе"** - состояние завершения процесса поставки (товар принят)
+- **"В работе"** - состояние процесса "Создание продукта" (товар обрабатывается)
+- **ВАЖНО**: Это состояния процессов, а не взаимоисключающие характеристики товара
+
+---
+
+## 8. 🏠 ОБЩИЕ ПРАВИЛА КАБИНЕТОВ
+
+### 8.1 Универсальная структура кабинетов
+
+**ВСЕ ТИПЫ КАБИНЕТОВ** включают следующие обязательные разделы:
+
+#### 8.1.1 Страница "Главная"
+
+**СТАТУС**: Планируется к реализации
+**ДОСТУП**: Через навигацию в sidebar для всех типов кабинетов
+**СОДЕРЖАНИЕ**: Пока пустые страницы, будут наполнены позже
+
+**ПРАВИЛА**:
+
+- **ОБЯЗАТЕЛЬНО**: Каждый тип кабинета должен иметь страницу "Главная"
+- **НАВИГАЦИЯ**: Доступ через кнопку в sidebar (первая в списке)
+- **УНИВЕРСАЛЬНОСТЬ**: Одинаковая структура навигации для всех кабинетов
+- **ПЛАНЫ**: Содержание страниц будет определено на следующих этапах
+
+#### 8.1.2 Общие разделы для всех кабинетов
+
+**УНИВЕРСАЛЬНЫЕ РАЗДЕЛЫ** (доступны всем типам):
+
+- 🏠 **Главная** - основная страница кабинета (планируется)
+- 🛒 **Маркет** - просмотр и заказ товаров
+- 🤝 **Партнеры** - управление контрагентами
+- 💬 **Мессенджер** - внутренняя связь
+- ⚙️ **Настройки** - профиль и конфигурация
+
+**СПЕЦИАЛИЗИРОВАННЫЕ РАЗДЕЛЫ** (зависят от типа кабинета):
+
+- Определяются в соответствующих разделах каждого кабинета
+
+### 8.2 Правила sidebar навигации
+
+#### 8.2.1 Структура навигации
+
+**ОБЩИЙ ПРИНЦИП**:
+
+- Условное отображение: `{user?.organization?.type === "TYPE" && (...)}`
+- Адаптивность: сворачиваемый sidebar с `getSidebarMargin()`
+- Состояния активности: подсветка текущего раздела
+
+**ПОРЯДОК РАЗДЕЛОВ В SIDEBAR**:
+
+1. 🏠 **Главная** (планируется для всех)
+2. **Специализированные разделы** (зависят от типа кабинета)
+3. 🛒 **Маркет** (универсальный)
+4. 🤝 **Партнеры** (универсальный)
+5. 💬 **Мессенджер** (универсальный)
+6. ⚙️ **Настройки** (универсальный)
+7. **Выход** (универсальный)
+
+#### 8.2.2 Типо-зависимая логика
+
+**АДАПТИВНЫЙ РОУТИНГ**:
+
+```typescript
+// Пример: кнопка "Поставки" ведет на разные страницы
+const handleSuppliesClick = () => {
+  switch (user?.organization?.type) {
+    case "FULFILLMENT":
+      router.push("/fulfillment-supplies");
+      break;
+    case "SELLER":
+      router.push("/supplies");
+      break;
+    case "WHOLESALE":
+      router.push("/supplies");
+      break;
+    case "LOGIST":
+      router.push("/logistics-orders");
+      break;
+  }
+};
+```
+
+---
+
+## 9. 🏠 КАБИНЕТ СЕЛЛЕРА
+
+### 9.1 Структура раздела "Мои поставки"
+
+#### **🏢 ПОСТАВКИ НА ФУЛФИЛМЕНТ**:
+
+- **Товар** - поставка товаров для создания продуктов
+  - **Карточки** - поставка через WB API с рецептурой (результат: WildberriesSupply)
+  - **Поставщики** - заказ товаров у поставщиков с рецептурой (результат: SupplyOrder)
+- **Расходники селлера** - поставка материалов для товаров селлера
+
+#### **🛒 ПОСТАВКИ НА МАРКЕТПЛЕЙСЫ** _(планируется)_:
+
+- **Wildberries** - прямые поставки на WB
+- **Ozon** - прямые поставки на Ozon
+
+### 9.2 Создание поставки расходников селлера
+
+#### **Структура страницы**:
+
+**БЛОК 1: ПОСТАВЩИКИ** _(обязательный, верхняя часть)_:
+
+- Карточки поставщиков из раздела "Партнеры"
+- Горизонтальный скролл при превышении ширины
+- Выбор только одного поставщика одновременно
+
+**БЛОК 2: РАСХОДНИКИ** _(зависимый, центральная часть)_:
+
+- Активен только после выбора поставщика
+- Сортировка: цена, название, категория
+- Фильтры: категория, ценовой диапазон
+- Карточка с полем ввода количества и кнопками +/-
+
+**БЛОК 3: КОРЗИНА** _(правая часть)_:
+
+- **РАСПОЛОЖЕНИЕ**: Правая часть экрана
+- **СОДЕРЖАНИЕ**:
+  - Счетчик видов расходников
+  - Детализация по каждому расходнику (название, количество, цена, сумма)
+  - Общая сумма всех расходников
+- **УПРАВЛЕНИЕ**:
+  - Изменение количества (с валидацией остатков)
+  - Удаление позиций
+- **ОБЯЗАТЕЛЬНЫЕ ПОЛЯ**:
+  - Выбор фулфилмент-центра (из партнеров)
+  - Дата поставки (не прошедшая, по умолчанию - текущая)
+
+#### **Валидация и ограничения**:
+
+**КОЛИЧЕСТВО ТОВАРОВ**:
+
+- **МИНИМУМ**: 1 единица/комплект
+- **МАКСИМУМ**: Остаток у поставщика
+- **ПРОВЕРКА**: В реальном времени при изменении
+
+**ДАТА ПОСТАВКИ**:
+
+- **ЗАПРЕТ**: Выбор прошедших дат
+- **ПО УМОЛЧАНИЮ**: Дата создания поставки
+
+**ОБЯЗАТЕЛЬНЫЕ ПОЛЯ**:
+
+- Выбор поставщика
+- Минимум один расходник в корзине
+- Выбор фулфилмент-центра
+- Дата поставки
+
+### 8.3 Отображение созданных поставок
+
+#### **Многоуровневая таблица**:
+
+**ПЕРВЫЙ УРОВЕНЬ** _(основной список)_:
+
+- **СОРТИРОВКА**: Номер поставки от большего к меньшему
+- **ОБЯЗАТЕЛЬНЫЕ КОЛОНКИ**:
+  - Порядковый номер поставки
+  - Количество видов расходников
+  - Стоимость всей поставки
+  - Количество категорий
+  - Статус поставки
+
+**ВТОРОЙ УРОВЕНЬ** _(детализация по клику)_:
+
+- **АКТИВАЦИЯ**: По клику на строку первого уровня
+- **СОДЕРЖАНИЕ**:
+  - Название расходника
+  - Количество
+  - Цена
+  - Категория
+  - Поставщик
+- **ОГРАНИЧЕНИЯ**: Только просмотр, редактирование запрещено
+
+### 8.4 Статусы поставок селлера
+
+1. **В работе** - создана селлером
+2. **Одобрена** - подтверждена поставщиком
+3. **Ожидает отгрузки** - логистика назначена
+4. **В пути** - товар отгружен
+5. **Доставлена/Принято** - получена фулфилментом
+
+### 9.3 Экономика
+
+_Раздел находится в разработке. Будет добавлен позже._
+
+---
+
+## 10. 🏪 КАБИНЕТ ПОСТАВЩИКА
+
+### 10.1 Основные возможности
+
+**СОЗДАНИЕ КАРТОЧЕК**:
+
+- **ТОВАР** - базовые товары поставщика
+- **РАСХОДНИКИ** - материалы и вспомогательные товары
+
+### 10.2 Обязательные поля карточки
+
+**Базовые параметры**:
+
+- Фото (система загрузки и управления изображениями)
+- Название
+- Автоматическая генерация артикула СФ
+- Описание
+- Количество предметов в единицах
+- Количество комплектов (если применимо)
+- Категория (28 предустановленных + специализированные для расходников)
+- Бренд, Цвет, Размер/объем, Вес, Габариты, Материал
+- Цена за единицу и за комплект
+- Заказано, В пути, Остаток, Продано
+
+### 10.3 Отображение информации в карточках
+
+**Каждая карточка содержит**:
+
+- Основное изображение
+- Название и артикул СФ
+- Цена за единицу/комплект
+- Категория и статус активности
+- Данные о движении: остаток, заказано, в пути, продано
+- Индикаторы низких остатков
+
+### 10.4 Статистика поставщика
+
+**Блок статистики включает**:
+
+- **ТОВАРЫ**: Общая статистика товаров поставщика
+- **РАСХОДНИКИ**: Материалы и вспомогательные товары
+  - Классифицируются при заказе в зависимости от заказчика
+  - Общая статистика по всем расходникам
+
+### 10.5 Экономика
+
+_Раздел находится в разработке. Будет добавлен позже._
+
+---
+
+## 11. 🏭 КАБИНЕТ ФУЛФИЛМЕНТА
+
+### 11.1 Структура раздела склад фулфилмента
+
+#### **Модули в обязательной последовательности**:
+
+1. **📦 ПРОДУКТ** - готовые к продаже товары
+2. **🛒 ТОВАР** - базовые товары от поставщиков
+   - Товары "на складе" - готовы к обработке
+   - Товары "в обработке" - в процессе создания продукта
+3. **❌ БРАК** - товары с дефектами
+4. **↩️ ВОЗВРАТЫ С ПВЗ** - возвращенные товары
+5. **🎯 РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для селлеров
+6. **⚙️ РАСХОДНИКИ ФУЛФИЛМЕНТ** - операционные материалы
+   - **КЛИКАБЕЛЬНЫЙ МОДУЛЬ** - содержит полноценный раздел учёта
+
+### 11.2 Движение товаров в фулфилменте
+
+#### **Поступление товаров**:
+
+- **ПОСТАВКИ**: От поставщиков через систему заказов
+- **ВОЗВРАТЫ**: Товары, возвращенные с ПВЗ
+- **ПЕРЕМЕЩЕНИЯ**: Между складами и магазинами
+
+#### **Расход товаров**:
+
+- **ОТГРУЗКА**: Товары отправлены селлерам
+- **СПИСАНИЕ**: Брак, утрата, утилизация
+- **ВОЗВРАТ**: Возврат поставщику
+- **ИСПОЛЬЗОВАНИЕ**: Расходники для операций
+
+### 11.3 Модуль "Расходники фулфилмента"
+
+**ОСОБЕННОСТИ**:
+
+- **ИНТЕРАКТИВНОСТЬ**: Кликабельный элемент в статистике
+- **ФУНКЦИОНАЛЬНОСТЬ**: Полноценный раздел учёта
+- **СОДЕРЖАНИЕ**: Управление расходниками фулфилмента
+
+### 11.4 Блок детализации по магазинам
+
+**НАЗНАЧЕНИЕ**: Распределение товаров по торговым точкам/магазинам
+
+**ФУНКЦИИ**:
+
+- **ОСТАТКИ ПО МАГАЗИНАМ**: Отображение количества товаров в каждом магазине
+- **УПРАВЛЕНИЕ РАСПРЕДЕЛЕНИЕМ**: Перемещение товаров между точками
+- **КОНТРОЛЬ ДВИЖЕНИЯ**: Отслеживание перемещений между складами и магазинами
+- **АНАЛИТИКА**: Сравнение эффективности разных точек
+- **ПЛАНИРОВАНИЕ**: Оптимизация распределения товаров
+
+### 11.5 Экономика
+
+_Раздел находится в разработке. Будет добавлен позже._
+
+---
+
+## 12. 🚚 КАБИНЕТ ЛОГИСТИКИ
+
+### 12.1 Основные функции логистики
+
+**РОЛЬ В СИСТЕМЕ**: Управление доставками и транспортировкой
+
+**ОСНОВНЫЕ ФУНКЦИИ**:
+
+- **ПОДТВЕРЖДЕНИЕ ДОСТАВКИ**: Подтверждение возможности доставки поставок
+- **ТРАНСПОРТИРОВКА**: Организация и выполнение доставки товаров
+- **КОНТРОЛЬ МАРШРУТОВ**: Управление логистическими маршрутами
+- **ОТСЛЕЖИВАНИЕ**: Мониторинг грузов в пути
+
+### 12.2 Workflow для логистики
+
+#### **ЭТАП 1: Получение заявки**
+
+1. Логистика получает уведомление о новой поставке
+2. Заявка появляется в разделе "Заявки" кабинета логистики
+3. Логист изучает детали поставки (объем, вес, маршрут)
+
+#### **ЭТАП 2: Подтверждение доставки**
+
+4. Логист нажимает кнопку "Одобрить"
+5. Статус поставки меняется на `LOGISTICS_CONFIRMED`
+6. Уведомления отправляются всем участникам
+
+#### **ЭТАП 3: Забор товара**
+
+7. Логист приезжает к поставщику за товаром
+8. Поставщик отгружает товар логисту
+9. Поставщик отмечает "Отправлено"
+10. Статус меняется на `SHIPPED`, затем `IN_TRANSIT`
+
+#### **ЭТАП 4: Доставка**
+
+11. Логистика доставляет товар на фулфилмент-центр
+12. В кабинете логистики нажимают "Доставлено"
+13. Фулфилмент принимает товар и отмечает "Принято"
+
+### 12.3 Система тарификации
+
+**ПАРАМЕТРЫ ТАРИФИКАЦИИ**:
+
+- **Тариф до 1м³** - базовая стоимость для малых грузов
+- **Тариф свыше 1м³** - стоимость для крупных грузов
+- **Маршруты доставки** - от точки отправления до точки назначения
+- **Описание услуг** - дополнительные условия доставки
+
+**РАСЧЕТ СТОИМОСТИ**:
+
+- Автоматический расчет стоимости доставки по объему груза
+- Отображение примерной стоимости при создании заказа
+- Учет специфики маршрута и условий доставки
+
+### 12.4 Управление заявками
+
+**РАЗДЕЛЫ КАБИНЕТА ЛОГИСТИКИ**:
+
+- **НОВЫЕ ЗАЯВКИ** - поступившие заявки на доставку
+- **В РАБОТЕ** - принятые к исполнению заявки
+- **ВЫПОЛНЕННЫЕ** - завершенные доставки
+- **ОТКЛОНЕННЫЕ** - заявки, которые не могут быть выполнены
+
+**ИНФОРМАЦИЯ О ЗАЯВКЕ**:
+
+- Детали груза (объем, вес, габариты)
+- Маршрут доставки (откуда - куда)
+- Срочность доставки
+- Особые требования к транспортировке
+- Контактная информация участников
+
+### 12.5 Правила логистики
+
+**ОБЯЗАТЕЛЬНО**:
+
+- Своевременное подтверждение заявок
+- Соблюдение сроков доставки
+- Бережная транспортировка товаров
+- Уведомление о статусе доставки
+
+**ЗАПРЕЩЕНО**:
+
+- Принятие заявок без подтверждения возможности выполнения
+- Нарушение сроков доставки без уведомления
+- Повреждение товаров при транспортировке
+
+### 12.6 Экономика
+
+_Раздел находится в разработке. Будет добавлен позже._
+
+---
+
+## 13. 🌐 ИНТЕГРАЦИИ С СИСТЕМОЙ
+
+### 13.1 Глобальная интеграция
+
+- **МАРКЕТ**: Товары поставщиков отображаются в глобальном маркете
+- **СИНХРОНИЗАЦИЯ**: Данные склада синхронизируются с модулем аналитики
+- **УВЕДОМЛЕНИЯ**: Единая система через встроенный мессенджер
+
+### 13.2 Интеграция с маркетплейсами
+
+- **WILDBERRIES**: Обязательная проверка активности API ключа
+- **СИНХРОНИЗАЦИЯ**: Регулярное обновление данных из внешних источников
+- **ЛОКАЛЬНЫЕ КОПИИ**: Сохранение данных для офлайн работы
+
+### 13.3 Интеграция с модулем "Услуги"
+
+**РАСХОДНИКИ ФУЛФИЛМЕНТА В УСЛУГАХ**:
+
+- Расходники фулфилмента - собственность фулфилмента (куплены у поставщиков)
+- Фулфилмент создает заявки-поставки для покупки расходников у поставщиков
+- Селлеры могут использовать расходники фулфилмента в разделе "Услуги / Расходники"
+- Для создания продукта из товара
+- Расходники списываются с остатков фулфилмента
+- Стоимость включается в стоимость услуги
+
+**WORKFLOW ИСПОЛЬЗОВАНИЯ**:
+
+1. Селлер выбирает услугу "Создание продукта"
+2. Указывает базовый товар
+3. Выбирает необходимые расходники фулфилмента
+4. Фулфилмент обрабатывает заказ и создает продукт
+5. Расходники списываются, создается готовый продукт
+
+### 12.4 Система тарификации логистики
+
+**ПАРАМЕТРЫ**:
+
+- **Тариф до 1м³** - базовая стоимость для малых грузов
+- **Тариф свыше 1м³** - стоимость для крупных грузов
+- **Маршруты доставки** - от точки отправления до точки назначения
+- **Описание услуг** - дополнительные условия доставки
+
+---
+
+## 14. 📊 СТАТИСТИКА И АНАЛИТИКА
+
+### 14.1 Структура статистики по кабинетам
+
+#### **В КАБИНЕТЕ ПОСТАВЩИКА**:
+
+- **ТОВАРЫ**: Общая статистика товаров поставщика
+- **РАСХОДНИКИ**: Материалы и вспомогательные товары (классифицируются при заказе)
+
+#### **В КАБИНЕТЕ ФУЛФИЛМЕНТА**:
+
+- **ТОВАРЫ**: Базовые товары от поставщиков (принятые на склад)
+- **ПРОДУКТЫ**: Отдельный блок готовой продукции
+- **БРАК**: Статистика потерь и списаний
+- **РАСХОДНИКИ ФУЛФИЛМЕНТА**: Операционные материалы фулфилмента
+- **РАСХОДНИКИ СЕЛЛЕРОВ**: Материалы для товаров селлеров
+
+### 14.2 Ключевые метрики
+
+**ОБЩИЕ ПОКАЗАТЕЛИ**:
+
+- Общие остатки, заказано, в пути, остаток, продано
+- Подсветка предметов с остатками ниже критического уровня
+
+**АКТУАЛИЗАЦИЯ ДАННЫХ**:
+
+- При изменении количества в карточке данные актуализируются во всей системе
+- Статистика обновляется в реальном времени
+- Отслеживание изменений для аналитики
+
+---
+
+## 15. ⚠️ КРИТИЧЕСКИЕ ЗАПРЕТЫ
+
+### 15.1 НИКОГДА НЕ ДЕЛАТЬ:
+
+1. ❌ Удалять предметы с существующими заказами
+2. ❌ Изменять статусы заказов без уведомлений
+3. ❌ Обходить проверки остатков предметов
+4. ❌ Давать доступ к чужим данным
+5. ❌ Игнорировать ошибки валидации
+6. ❌ Сохранять пароли в открытом виде
+7. ❌ Пропускать логирование критических операций
+8. ❌ Блокировать интерфейс без индикации загрузки
+9. ❌ Создавать брак или продукт без связи с родительским товаром
+10. ❌ Создавать отдельные типы расходников (только общий тип "РАСХОДНИКИ")
+11. ❌ Разрешать заказ брака
+12. ❌ Нарушать иерархию типов предметов
+13. ❌ Пропускать промежуточные статусы в workflow
+14. ❌ Нарушать обязательную последовательность модулей в статистике фулфилмента
+
+### 13.2 ОБЯЗАТЕЛЬНЫЕ ПРАВИЛА:
+
+1. ✅ Проверка остатков перед добавлением в корзину
+2. ✅ Валидация всех числовых значений (цена > 0, вес > 0)
+3. ✅ Автоматическая генерация уникальных артикулов СФ
+4. ✅ Логирование всех изменений статусов
+5. ✅ Уведомления всех участников при изменении статусов
+6. ✅ Обязательная типизация всех предметов
+7. ✅ Связь производных типов с родительскими предметами
+8. ✅ Проверка доступности товаров перед заказом
+9. ✅ Соблюдение жизненного цикла статусов поставок
+10. ✅ Фиксация план/факт в процессе создания продукта
+
+---
+
+## 🎖️ ПРИОРИТЕТЫ РАЗРАБОТКИ
+
+### ВЫСОКИЙ ПРИОРИТЕТ:
+
+1. 🔴 Безопасность и контроль доступа
+2. 🔴 Целостность данных и валидация
+3. 🔴 Корректность статусов поставок
+4. 🔴 Уведомления участников процесса
+5. 🔴 Правильная типизация предметов
+6. 🔴 Связи между товарами и производными типами
+
+### СРЕДНИЙ ПРИОРИТЕТ:
+
+1. 🟡 Производительность и оптимизация
+2. 🟡 Пользовательский опыт
+3. 🟡 Аналитика и отчетность
+4. 🟡 Интеграции с внешними системами
+5. 🟡 Workflow для брака и продуктов
+6. 🟡 Разделение расходников по типам
+
+### НИЗКИЙ ПРИОРИТЕТ:
+
+1. 🟢 Дополнительные фильтры
+2. 🟢 Косметические улучшения
+3. 🟢 Экспериментальные функции
+4. 🟢 Расширенная кастомизация
+
+---
+
+## 📦 ПРИЛОЖЕНИЕ: КАТЕГОРИИ РАСХОДНИКОВ
+
+### Специализированные категории для расходников:
+
+#### 🎁 **УПАКОВКА И ЗАЩИТА**
+
+- Коробки, пакеты, пузырчатая пленка, стрейч-пленка, защитные уголки
+
+#### 🏷️ **МАРКИРОВКА И ИДЕНТИФИКАЦИЯ**
+
+- Этикетки, бирки, стикеры, маркеры, штампы, термоэтикетки
+
+#### 🔧 **КРЕПЕЖ И СОЕДИНЕНИЕ**
+
+- Скотч, клей, стяжки, степлер, веревки, стрейч-лента
+
+#### 📄 **ДОКУМЕНТООБОРОТ И ВКЛАДЫШИ**
+
+- Накладные, инструкции, буклеты, визитки, промокоды
+
+#### 🧼 **ГИГИЕНА И БЕЗОПАСНОСТЬ**
+
+- Перчатки, маски, антисептики, салфетки, бахилы
+
+#### 🛠️ **ИНСТРУМЕНТЫ И ПРИСПОСОБЛЕНИЯ**
+
+- Ножи, линейки, упаковочные машины, весы
+
+#### 🎨 **БРЕНДИНГ И ДИЗАЙН**
+
+- Фирменные пакеты, брендированные коробки, подарочная упаковка
+
+#### ⚡ **СПЕЦИАЛИЗИРОВАННЫЕ МАТЕРИАЛЫ**
+
+- Антистатические пакеты, влагопоглотители, защита от краж
+
+---
+
+## 16. 📱 ПРАВИЛА ПОЛЬЗОВАТЕЛЬСКОГО ИНТЕРФЕЙСА
+
+### 16.1 Отзывчивость интерфейса
+
+- **ОБЯЗАТЕЛЬНО**: Интерфейс должен работать на всех устройствах
+- **ПРАВИЛО**: Адаптивная сетка для карточек товаров
+- **ФУНКЦИЯ**: Оптимизация для мобильных устройств
+- **ТРЕБОВАНИЕ**: Корректное отображение на экранах от 320px до 4K
+
+### 15.2 Обратная связь пользователю
+
+- **ОБЯЗАТЕЛЬНО**: Уведомления об успешных/неуспешных операциях
+- **ПРАВИЛО**: Индикаторы загрузки для длительных операций
+- **ФУНКЦИЯ**: Подтверждение критических действий (удаление, деактивация)
+- **UX**: Понятные сообщения об ошибках с предложением решения
+
+---
+
+## 17. 🚨 ПРАВИЛА ОБРАБОТКИ ОШИБОК
+
+### 17.1 Обработка ошибок
+
+- **ОБЯЗАТЕЛЬНО**: Логирование всех ошибок с детальной информацией
+- **ПРАВИЛО**: Понятные сообщения об ошибках для пользователя
+- **ФУНКЦИЯ**: Автоматическое восстановление после сбоев
+- **МОНИТОРИНГ**: Отслеживание критических ошибок в реальном времени
+
+### 16.2 Резервное копирование
+
+- **КРИТИЧЕСКИ ВАЖНО**: Регулярное резервное копирование данных товаров
+- **ПРАВИЛО**: Версионность изменений для возможности отката
+- **ФУНКЦИЯ**: Автоматическое восстановление связей при сбоях
+- **ПЕРИОДИЧНОСТЬ**: Ежедневные и еженедельные бэкапы
+
+---
+
+## 18. 📈 ПРАВИЛА ПРОИЗВОДИТЕЛЬНОСТИ
+
+### 18.1 Оптимизация загрузки
+
+- **ПРАВИЛО**: Пагинация для больших списков товаров
+- **ФУНКЦИЯ**: Ленивая загрузка изображений
+- **ОПТИМИЗАЦИЯ**: Кэширование часто запрашиваемых данных
+- **ПРОИЗВОДИТЕЛЬНОСТЬ**: Время загрузки страницы не более 3 секунд
+
+### 17.2 Масштабируемость
+
+- **АРХИТЕКТУРА**: Модульная структура для легкого расширения
+- **ПРАВИЛО**: Использование индексов для быстрого поиска
+- **ФУНКЦИЯ**: Горизонтальное масштабирование при росте нагрузки
+- **ПЛАНИРОВАНИЕ**: Готовность к увеличению нагрузки в 10 раз
+
+---
+
+## 19. 🔐 ПРАВИЛА БЕЗОПАСНОСТИ ДАННЫХ
+
+### 19.1 Защита данных
+
+- **ОБЯЗАТЕЛЬНО**: Шифрование чувствительных данных
+- **ПРАВИЛО**: Аудит всех действий пользователей
+- **ФУНКЦИЯ**: Контроль доступа на уровне API
+- **БЕЗОПАСНОСТЬ**: Двухфакторная аутентификация для критических операций
+
+### 18.2 Соответствие требованиям
+
+- **GDPR**: Право на удаление и экспорт данных
+- **ПРАВИЛО**: Прозрачность обработки персональных данных
+- **ФУНКЦИЯ**: Логирование согласий пользователей
+- **СООТВЕТСТВИЕ**: Регулярный аудит безопасности
+
+---
+
+## 20. 🎯 ПРАВИЛА КАЧЕСТВА КОДА
+
+### 20.1 Стандарты разработки
+
+- **ОБЯЗАТЕЛЬНО**: Покрытие тестами критической функциональности
+- **ПРАВИЛО**: Следование принципам SOLID
+- **ФУНКЦИЯ**: Автоматическое тестирование при развертывании
+- **КАЧЕСТВО**: Минимальное покрытие тестами 80%
+
+### 19.2 Документация
+
+- **ОБЯЗАТЕЛЬНО**: Документирование всех API методов
+- **ПРАВИЛО**: Комментарии к сложной бизнес-логике
+- **ФУНКЦИЯ**: Автоматическая генерация документации
+- **СТАНДАРТ**: Актуальная техническая документация
+
+---
+
+## 21. 📋 ПРИЛОЖЕНИЕ: ДОПОЛНИТЕЛЬНЫЕ ВОЗМОЖНОСТИ И ПЛАНЫ
+
+### 🔄 Сложные сценарии (требуют дальнейшей проработки)
+
+**ЗАМЕТКА**: Данные сценарии выявлены, но пока не учитываются в текущей системе. Требуют отдельного обсуждения:
+
+#### **Сценарий 1: Из разных товаров → один продукт**
+
+- **ПРИМЕР**: Товар "Футболка" + Товар "Джинсы" = Продукт "Комплект одежды"
+- **ТРЕБУЕТ**: Разработки системы "составных продуктов"
+- **СЛОЖНОСТЬ**: Управление несколькими parentId, распределение себестоимости
+- **СТАТУС**: Требует технического решения
+
+#### **Сценарий 2: Из одного товара → несколько продуктов**
+
+- **ПРИМЕР**: Товар "Ткань 10 метров" → Продукт "Платье" (3м) + Продукт "Юбка" (2м) + остаток 5м
+- **ТРЕБУЕТ**: Системы "деления товаров" и учета остатков
+- **СЛОЖНОСТЬ**: Контроль использования материала, учет отходов
+- **СТАТУС**: Требует проработки алгоритмов
+
+### 🚀 Предложения по улучшению
+
+#### **В разработке**:
+
+- ✅ **Workflow для создания брака и продуктов** - детально описан
+- ✅ **Разделение расходников на подтипы** - реализовано
+- ✅ **Связи между товарами и производными типами** - реализовано
+
+#### **Требует реализации**:
+
+- **Автогенерация артикулов СФ с префиксами типов** - автоматическое создание уникальных номеров
+- **Система комплектов товаров** - управление наборами товаров
+- **Умные уведомления о низких остатках** - персонализированные алерты
+- **Расширенные фильтры по типам предметов** - улучшенная навигация
+- **Система прогнозирования спроса** - аналитика и планирование
+
+### 📊 Полный список 28 универсальных категорий
+
+1. Одежда и обувь
+2. Косметика и парфюмерия
+3. Дом и сад
+4. Детские товары
+5. Спорт и отдых
+6. Электроника
+7. Книги
+8. Здоровье
+9. Автотовары
+10. Строительство и ремонт
+11. Продукты питания
+12. Зоотовары
+13. Дача, сад и огород
+14. Канцелярские товары
+15. Хобби и творчество
+16. Украшения и аксессуары
+17. Сумки и чемоданы
+18. Техника для дома
+19. Музыкальные инструменты
+20. Игры и игрушки
+21. Мебель
+22. Товары для красоты
+23. Бытовая химия
+24. Товары для путешествий
+25. Медицинские товары
+26. Религиозные товары
+27. Антиквариат и коллекционирование
+28. Прочие товары
+
+---
+
+_Эта база знаний создана на основе анализа rules.md, rules1.md и description.md и является единым источником понимания структуры и логики проекта._
+
+_Версия: 2.0_  
+_Дата создания: 2024_  
+_Статус: АКТИВНАЯ БАЗА ЗНАНИЙ_
+1