Sfera/sfera
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
1d5d4906be3ee50f921fc691c696aa00bfe36295
sfera/rules2.md

57 KiB
Raw Blame History

ПРАВИЛА СИСТЕМЫ УПРАВЛЕНИЯ СКЛАДАМИ И ПОСТАВКАМИ - БАЗА ЗНАНИЙ v2.0

⚠️ ВАЖНОЕ ПРИМЕЧАНИЕ: Данный файл является объединенной базой знаний системы на основе анализа rules.md, rules1.md и description.md. Все изменения должны согласовываться.

📑 ОГЛАВЛЕНИЕ

🏗️ АРХИТЕКТУРА И ОСНОВЫ

  1. 🎯 Основные принципы системы
  2. 📦 Типизация предметов
  3. 🏢 Структура кабинетов
  4. 🔐 Система ролей и доступов

🚚 WORKFLOW И ПРОЦЕССЫ

  1. 🚚 Workflow поставок
  2. 🔄 Процесс создания продукта
  3. 📊 Система учета движения товаров

🏢 КАБИНЕТЫ СИСТЕМЫ

  1. 🏠 Общие правила кабинетов
  2. 🏠 Кабинет селлера
  3. 🏪 Кабинет поставщика
  4. 🏭 Кабинет фулфилмента
  5. 🚚 Кабинет логистики

🌐 ИНТЕГРАЦИИ И ФУНКЦИИ

  1. 🌐 Интеграции с системой
  2. 📊 Статистика и аналитика
  3. ⚠️ Критические запреты

💻 ТЕХНИЧЕСКИЕ ПРАВИЛА

  1. 📱 Правила пользовательского интерфейса
  2. 🚨 Правила обработки ошибок
  3. 📈 Правила производительности
  4. 🔐 Правила безопасности данных
  5. 🎯 Правила качества кода

📋 ДОПОЛНИТЕЛЬНО

  1. 📋 Приложение: Дополнительные возможности и планы

🏷️ РЕЕСТР СУЩНОСТЕЙ СИСТЕМЫ

📦 ОСНОВНЫЕ ПРЕДМЕТЫ

Сущность Название в системе Кабинет создания Описание Статус
Товар 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: Обработка поставщиком

  1. Поставщик получает оповещение
  2. Поставщик нажимает "Одобрить"
  3. Статус меняется на SUPPLIER_APPROVED

ЭТАП 3: Передача в фулфилмент

  1. Поставка отображается в кабинете фулфилмента
  2. Фулфилмент выбирает ответственного и логистику
  3. Статус меняется на CONFIRMED

ЭТАП 4: Логистическое подтверждение

  1. Логистика подтверждает доставку
  2. Статус меняется на LOGISTICS_CONFIRMED

ЭТАП 5: Отгрузка

  1. Поставщик отгружает товар
  2. Статус меняется на SHIPPED, затем IN_TRANSIT

ЭТАП 6: Доставка и приемка

  1. Логистика доставляет на фулфилмент
  2. Фулфилмент принимает товар
  3. Статус меняется на DELIVERED

5.3 Система уведомлений

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

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

6. 🔄 ПРОЦЕСС СОЗДАНИЯ ПРОДУКТА

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

ЭТАП 1: ПОСТУПЛЕНИЕ И ПОДСЧЕТ

  1. Товар приходит на склад фулфилмента (статус "на складе")
  2. Подсчет фактического количества товара (может отличаться от плана)
  3. Проверка товара на дефекты и выявление брака

ЭТАП 2: ПОДГОТОВКА К РАБОТЕ

  1. Поставка попадает в раздел "Создание продукта" / "Новые"
  2. Менеджер задает:
    • Дедлайн выполнения
    • Ответственного исполнителя
    • Место хранения готовых продуктов
  3. Нажимает "В работе"

ЭТАП 3: ОБРАБОТКА

  1. Товары получают статус "в работе"
  2. Исполнитель работает по "рецептуре" селлера:
    • Применяет услуги фулфилмента
    • Использует расходники селлера
    • Использует расходники фулфилмента

ЭТАП 4: УЧЕТ ПЛАН/ФАКТ

  1. Фиксируется в разделе "В работе":
    • ПЛАН: Количество из поставки селлера
    • ФАКТ: Реальное количество после подсчета = Брак + Хороший товар
    • СОЗДАНИЕ БРАКА: Данные о браке вносятся в кабинете фулфилмента
    • ДЕТАЛИЗАЦИЯ: По каждому размеру/объему

ЭТАП 5: ЗАВЕРШЕНИЕ

  1. Исполнитель нажимает "Выполнено"
  2. Товары становятся продуктами со статусом "готов к отправке"
  3. Поставка переходит в "Выполнено"

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 Типо-зависимая логика

АДАПТИВНЫЙ РОУТИНГ:

// Пример: кнопка "Поставки" ведет на разные страницы
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 Правила кнопки "Создать поставку" в разделе "Мои поставки"

9.3.1 Общие принципы

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

9.3.2 Размещение кнопок по табам

УРОВЕНЬ 2 (Подтабы фулфилмента):

  • 📦 Товар → Карточки: Кнопка "Создать поставку" → /supplies/create-cards
  • 📦 Товар → Поставщики: Кнопка "Создать поставку" → /supplies/create-suppliers
  • 🔧 Расходники селлера: Кнопка "Создать поставку" → /supplies/create-consumables

УРОВЕНЬ 2 (Подтабы маркетплейсов):

  • 🟣 Wildberries: Кнопка "Создать поставку" → /supplies/create-wildberries
  • 🔵 Ozon: Кнопка "Создать поставку" → /supplies/create-ozon

9.3.3 Стили кнопок

ДЛЯ УРОВНЯ 2 (h-9):

/* Размер и отступы */
h-9 px-3 py-1 ml-auto

/* Фон и границы */
bg-white/8 border border-white/20 hover:bg-white/12

/* Текст и иконки */
text-xs font-medium text-white/80 hover:text-white

/* Скругления */
rounded-lg

/* Переходы */
transition-all duration-150

ДЛЯ УРОВНЯ 3 (h-8):

/* Размер и отступы */
h-8 px-2 py-1 ml-auto

/* Фон и границы */
bg-white/5 border border-white/15 hover:bg-white/8

/* Текст и иконки */
text-xs font-normal text-white/60 hover:text-white/80

/* Скругления */
rounded-md

/* Переходы */
transition-all duration-150

9.3.4 Поведение кнопок

  • ВИДИМОСТЬ: Кнопка показывается только в активном табе
  • ИКОНКА: Plus размером h-3 w-3 слева от текста
  • ТЕКСТ: "Создать" на мобильных, "Создать поставку" на десктопах
  • АДАПТИВНОСТЬ: Скрытие текста на маленьких экранах (hidden sm:inline)

9.3.5 Удаление старой кнопки

  • УБРАТЬ: Текущий dropdown "Создать поставку" из верхней части
  • ПРИЧИНА: Заменяется контекстными кнопками в табах
  • СОХРАНИТЬ: Стили и логику навигации, но адаптировать под новые роуты

9.4 Экономика

Раздел находится в разработке. Будет добавлен позже.

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: Подтверждение доставки

  1. Логист нажимает кнопку "Одобрить"
  2. Статус поставки меняется на LOGISTICS_CONFIRMED
  3. Уведомления отправляются всем участникам

ЭТАП 3: Забор товара

  1. Логист приезжает к поставщику за товаром
  2. Поставщик отгружает товар логисту
  3. Поставщик отмечает "Отправлено"
  4. Статус меняется на SHIPPED, затем IN_TRANSIT

ЭТАП 4: Доставка

  1. Логистика доставляет товар на фулфилмент-центр
  2. В кабинете логистики нажимают "Доставлено"
  3. Фулфилмент принимает товар и отмечает "Принято"

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