# ПРАВИЛА СИСТЕМЫ УПРАВЛЕНИЯ СКЛАДАМИ И ПОСТАВКАМИ - БАЗА ЗНАНИЙ 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