Files

Veronika Smirnova 7da70f96e1 fix(refactor): исправление React Hooks warnings в отрефакторенных компонентах

- Исправлен missing dependency в useSupplyCart.ts
- Исправлен missing dependency в useWildberriesProducts.ts
- Добавлен useCallback для getProductTotalWithRecipe для стабильности
- Оптимизированы зависимости в useMemo и useCallback хуках
- Обновлена система правил для разделенных файлов rules-complete1/2
- Созда��а система проактивного мониторинга контекста
- Добавлен детальный план безопасного рефакторинга больших компонентов

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

Co-Authored-By: Claude <noreply@anthropic.com>

2025-08-12 23:14:19 +03:00

111 KiB

Raw Blame History

❌ ЗАПРЕЩЕНО РЕДАКТИРОВАТЬ БЕЗ ЯВНОГО РАЗРЕШЕНИЯ ПОЛЬЗОВАТЕЛЯ!

📅 Дата создания резерва: 2025-08-08 🔐 Статус: ЗАЩИЩЕН ОТ ИЗМЕНЕНИЙ 📄 Оригинальный файл: rules-complete.md

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

⚠️ АБСОЛЮТНО ПОЛНЫЙ ЕДИНЫЙ ИСТОЧНИК ИСТИНЫ: Данный файл объединяет АБСОЛЮТНО ВСЕ правила системы: протоколы работы Claude Code, детальные протоколы по сложности, систему предотвращения нарушений, расширенную самопроверку, специальный UI/UX протокол и бизнес-правила. Визуальные правила вынесены в отдельный файл visual-design-rules.md с автоматической интеграцией.

📚 СТРУКТУРА ДОКУМЕНТАЦИИ

Основные файлы правил:

rules-complete.md (этот файл) - общие бизнес-правила и процессы
wholesale-cabinet-rules.md - технические детали кабинета поставщика
visual-design-rules.md - визуальные правила (уже интегрирован)

Когда какой файл читать:

При работе с компонентами поставщика → wholesale-cabinet-rules.md
При изменении бизнес-логики → rules-complete.md
При работе с UI/UX → visual-design-rules.md

🔴 ПРАВИЛА ВЗАИМОДЕЙСТВИЯ С CLAUDE

Основные принципы работы:

Двухэтапный процесс: Планирование → Одобрение → Выполнение
Обязательное чтение правил перед каждой задачей
Детальные протоколы по сложности задач
Система проверок и самоконтроля
Честность и прозрачность при неопределенности

Обязательная последовательность:

Читать rules-complete.md перед началом работы
Определить сложность задачи
Применить соответствующий протокол
Создать план через TodoWrite
Получить одобрение пользователя
Выполнить согласно плану
Проверить качество результата

🛠️ ПРОТОКОЛЫ РАБОТЫ ПО СЛОЖНОСТИ

Краткий обзор протоколов:

Простые задачи: Прямое выполнение с базовыми проверками
Средние задачи: Трехэтапный процесс (Анализ → План → Выполнение)
Сложные задачи: Расширенный анализ с множественными проверками
Критические задачи: Полный протокол безопасности

Определение сложности:

Средняя: 2-3 файла, изменение логики в 1-2 модулях
Высокая: 4+ файлов, изменение архитектуры, влияние на несколько кабинетов

🔥 ПРОТОКОЛ ВЫСОКОЙ СЛОЖНОСТИ

Обязательные этапы для сложных задач:

СТОП! ГЛУБОКИЙ АНАЛИЗ - уточнить все требования у пользователя
ИССЛЕДОВАНИЕ - изучить все связанные файлы параллельно
ДЕТАЛЬНЫЙ ПЛАН - с промежуточными проверками и rollback точками

❓ СИСТЕМА УТОЧНЕНИЙ

Когда ОБЯЗАТЕЛЬНО спрашивать:

Обнаружил противоречие в правилах
Задача может нарушить архитектуру системы
Неясно как применить правило к ситуации
Есть несколько способов с разными последствиями

🎨 UI/UX ПРОТОКОЛ

Автоматическая активация при ключевых словах: дизайн, интерфейс, компонент, UI, UX

Обязательно:

Прочитать visual-design-rules.md перед началом
Проверить соответствие цветовой палитре
Использовать glass-эффекты согласно дизайн-системе

🚨 СИСТЕМА КОНТРОЛЯ КАЧЕСТВА

Принципы контроля:

Стоп-сигналы перед критическими действиями
Принудительные проверки соблюдения протоколов
Автоматические триггеры для специфических ситуаций
Система блокировки нарушений
Расширенная самопроверка с финальными проверками

Обязательные остановки:

Перед анализом компонентов без использования инструментов
При любой неопределенности или сомнениях
Перед выполнением средних/сложных задач без протокола

Финальная проверка:

"Применил ли правильный протокол, проверил все правила, готов результат к production?"

⚡ БЫСТРЫЙ СПРАВОЧНИК

🚨 КРИТИЧЕСКИЕ ПРАВИЛА (ОБЯЗАТЕЛЬНЫ К СОБЛЮДЕНИЮ)

🔴 ТИПИЗАЦИЯ: Каждый предмет ОБЯЗАТЕЛЬНО имеет тип: PRODUCT, CONSUMABLE, DEFECT, FINISHED_PRODUCT
🔴 WORKFLOW: Нельзя пропускать статусы поставок: PENDING → SUPPLIER_APPROVED → CONFIRMED → ... → DELIVERED
🔴 ДОСТУП: Фулфилмент = полный доступ, Селлер ≠ доступ к чужим данным, Брак = ЗАПРЕЩЕН к заказу
🔴 ПАРТНЕРСТВО: Все связи через модель Counterparty, поставщики в формах ТОЛЬКО из партнеров WHOLESALE
🔴 ФИЛЬТРАЦИЯ: По типу предмета происходит в GraphQL резолверах, НЕ на фронтенде

🔍 БЫСТРЫЙ ПОИСК ПО ТЕМАМ

Тема	Раздел	Ключевые понятия
Типы предметов	2	PRODUCT, CONSUMABLE, DEFECT, FINISHED_PRODUCT
Кабинет фулфилмента	11	Склад, Услуги, Сотрудники, 6 модулей
Workflow поставок	5	8 статусов, уведомления, логистика
GraphQL запросы	18, 24	Резолверы, мутации, типизация
Система партнерства	13	Counterparty, WHOLESALE, заявки
Рынки и маркет	10.1, 18.7	РЫНОК ≠ МАРКЕТ, Organization.market
Критические запреты	17	Что НЕЛЬЗЯ делать в системе

🎯 ДЛЯ РАЗНЫХ РОЛЕЙ

👩‍💻 РАЗРАБОТЧИКИ: Разделы 18, 19, 20, 24
📊 АНАЛИТИКИ: Разделы 15, 6, 7
👔 МЕНЕДЖЕРЫ: Разделы 1, 3, 5

🔤 ГЛОССАРИЙ ТЕРМИНОВ

Для людей → В коде

ТИПЫ ПРЕДМЕТОВ:

ТОВАР → PRODUCT - базовый товар от поставщика, может стать продуктом или браком
РАСХОДНИКИ → CONSUMABLE - материалы, классифицируются по назначению при использовании (операционные/производственные)
БРАК → DEFECT (НЕ РЕАЛИЗОВАНО) - функционал брака еще не внедрен в систему
ПРОДУКТ → FINISHED_PRODUCT (планируется) - готовый товар, создается из товара по рецептуре

ТИПЫ ОРГАНИЗАЦИЙ:

ПОСТАВЩИК → WHOLESALE - создает товары и расходники, обрабатывает заказы
СЕЛЛЕР → SELLER - заказывает товары, создает поставки на маркетплейсы
ФУЛФИЛМЕНТ → FULFILLMENT - обрабатывает товары, создает продукты, максимальные права
ЛОГИСТИКА → LOGIST - управляет доставками, подтверждает транспортировку

2.2 Правила создания предметов по ролям

КТО МОЖЕТ СОЗДАВАТЬ:

ПОСТАВЩИК (WHOLESALE): Товары (PRODUCT) и Расходники (CONSUMABLE)
ФУЛФИЛМЕНТ (FULFILLMENT): Продукты (FINISHED_PRODUCT) - только из существующих товаров
СЕЛЛЕР/ЛОГИСТ: НЕ МОГУТ создавать предметы

КТО МОЖЕТ ПОКУПАТЬ:

СЕЛЛЕР (SELLER):
- Товары и расходники у поставщиков
- Расходники фулфилмента у фулфилмента (через рецептуру в поставке)
ФУЛФИЛМЕНТ (FULFILLMENT): Товары и расходники у поставщиков
ПОСТАВЩИК/ЛОГИСТ: НЕ МОГУТ покупать предметы

ЭКОНОМИЧЕСКИЙ УЧЕТ:

Когда селлер выбирает расходники фулфилмента в рецептуре, это формирует экономические данные:
- В кабинете селлера: расход на расходники фулфилмента
- В кабинете фулфилмента: доход от продажи расходников селлеру

КЛЮЧЕВЫЕ СУЩНОСТИ:

Контрагент → Counterparty - связь между организациями для партнерства
Поставка → SupplyOrder - заказ товаров/расходников с workflow статусами
Рецептура - состав продукта: товар + услуги + расходники (задается селлером)

КОНТЕКСТНО-ЗАВИСИМЫЕ ТЕРМИНЫ:

SupplyOrder - многосторонний документ

SupplyOrder представляет собой единый документ, который видится по-разному каждым участником процесса:

ДЛЯ СОЗДАТЕЛЕЙ (Селлер/Фулфилмент):

Термин: "Поставка"
Контекст: Они создают поставку товаров и расходников на фулфилмент
Включает: Весь процесс от закупки до приемки на склад

ДЛЯ ПОСТАВЩИКА (исполнитель товарной части):

Термин: "Заявка на покупку"
Контекст: Получают запрос на продажу своих товаров/расходников
Действия: Могут одобрить или отклонить в зависимости от наличия

ДЛЯ ЛОГИСТИКИ (исполнитель транспортной части):

Термин: "Заявка на доставку"
Контекст: Получают запрос на транспортировку груза
Действия: Могут подтвердить или отклонить в зависимости от возможностей

ОТОБРАЖЕНИЕ В ИНТЕРФЕЙСЕ КАБИНЕТОВ:

Кабинет	Название раздела	Обоснование
Селлер	"Мои поставки"	Создает и управляет поставками
Поставщик	"Заявки на покупку"	Обрабатывает входящие заявки
Логистика	"Заявки на доставку"	Управляет транспортировкой
Фулфилмент	"Входящие поставки"	Принимает поставки на склад

ВАЖНО: Это один и тот же объект SupplyOrder в базе данных, но каждый участник работает со своей стороной процесса.

Маркет vs Маркетплейс - четкое разделение

МАРКЕТ (/market):

Что это: Внутренний раздел системы
Функция: Глобальный каталог всех товаров от всех поставщиков
Доступ: Для всех типов организаций в системе
НЕ путать: С названиями физических рынков типа "ОПТ Маркет"

МАРКЕТПЛЕЙС (Wildberries, Ozon):

Что это: Внешние торговые площадки
Функция: Конечные точки продаж для селлеров
Интеграция: Через API ключи в настройках
Использование: "Поставки на маркетплейсы", "Отгрузка на маркетплейсы"

📑 ОГЛАВЛЕНИЕ

📖 Каталог процессов: См. workflow-catalog.md для полного каталога всех бизнес-процессов системы

📋 ЧТО ОБЪЕДИНЕНО:

rules-unified.md (v3.0) - общая база знаний системы

fulfillment-cabinet-rules.md (v1.0) - детализация кабинета фулфилмента

Устранены все несоответствия в терминах, последовательностях и детализации

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

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

Сущность	Название в системе	Кабинет создания	Описание	Статус
Товар	`Product` (type: `PRODUCT`)	Поставщик	Базовый тип товара от поставщика	✅ Реализовано
Расходники	`Product` (type: `CONSUMABLE`)	Поставщик	Материалы и вспомогательные товары	✅ Реализовано
Брак	`Product` (type: `DEFECT`)*	Фулфилмент	Производная от товара с дефектами	📋 Планируется
Продукт	`Product` (type: `FINISHED_PRODUCT`)*	Фулфилмент	Готовый к продаже товар (производная от товара)	📋 Планируется

* Планируется: Типы DEFECT и FINISHED_PRODUCT еще не добавлены в Prisma схему

🏢 ОРГАНИЗАЦИИ И РОЛИ

Сущность	Название в системе	Основные функции	Статус
Поставщик	`Organization` (type: `WHOLESALE`)	Создание товаров, управление поставками	✅ Реализовано
Селлер	`Organization` (type: `SELLER`)	Заказ товаров, управление поставками	✅ Реализовано
Фулфилмент	`Organization` (type: `FULFILLMENT`)	Обработка товаров, управление складом	✅ Реализовано
Логистика	`Organization` (type: `LOGIST`)	Управление доставками	✅ Реализовано

🤝 СИСТЕМА ПАРТНЕРСТВА

Сущность	Название в системе	Описание	Статус
Контрагент	`Counterparty`	Связь между организациями	✅ Реализовано
Заявка	`CounterpartyRequest`	Запрос на сотрудничество	✅ Реализовано

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

1.1 Архитектура системы

СТРУКТУРА СИСТЕМЫ ПО КАБИНЕТАМ:

🏢 КАБИНЕТ ПОСТАВЩИКА - создает и управляет:

ТОВАР (PRODUCT) - базовые товары от поставщика
РАСХОДНИКИ (CONSUMABLE) - материалы и вспомогательные товары от поставщика

🏭 КАБИНЕТ ФУЛФИЛМЕНТА - принимает, обрабатывает и управляет всеми типами:

ТОВАР (PRODUCT) - базовые товары от поставщиков (принятые на склад)
БРАК (DEFECT - планируется) - производная от товара (товар с дефектами)
ПРОДУКТ (FINISHED_PRODUCT - планируется) - готовый к продаже товар
РАСХОДНИКИ (CONSUMABLE) - единый базовый тип, классифицируется по назначению при использовании:
- "Операционные расходники" - используются фулфилментом для выполнения услуг
- "Производственные расходники" - используются в рецептурах селлеров для создания продуктов

🛍️ КАБИНЕТ СЕЛЛЕРА - заказывает и управляет поставками:

Создает заказы товаров и расходников
Управляет поставками на фулфилмент и маркетплейсы
Отслеживает статусы поставок

1.2 Основные принципы разработки

КРИТИЧЕСКИ ВАЖНЫЕ ПРИНЦИПЫ:

Строгая типизация: Каждый предмет имеет один из типов: ТОВАР (PRODUCT), РАСХОДНИКИ (CONSUMABLE), БРАК и ПРОДУКТ (планируется)
Партнерская система: Все связи между организациями через модель Counterparty
Workflow статусов: Строгая последовательность статусов поставок
Безопасность доступа: Контроль доступа на уровне GraphQL резолверов
Единый источник истины: Централизованное управление данными

2. 📦 ТИПИЗАЦИЯ ПРЕДМЕТОВ

2.1 Два реализованных и два планируемых типа предметов

1. ТОВАР (`PRODUCT` - базовый тип)

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

2. РАСХОДНИКИ (`CONSUMABLE` - базовый тип)

СОЗДАЕТСЯ: Поставщиком как универсальный тип
КЛАССИФИКАЦИЯ ПРИ ЗАКАЗЕ:
- Фулфилмент заказывает → "Расходники фулфилмента"
- Селлер заказывает → "Расходники селлеров"
ДОСТУП: Видны всем типам организаций в маркете

3. БРАК (`DEFECT` - планируется, производная от товара)

БУДЕТ СОЗДАВАТЬСЯ: Фулфилментом на основе существующего ТОВАРА при обнаружении дефектов
МОМЕНТ СОЗДАНИЯ: В процессе обработки товара (ШАГ 3 алгоритма создания продукта) при выявлении брака
СВЯЗЬ: Обязательная связь с родительским товаром (parentId)
ЗАКАЗ: ЗАПРЕЩЕН заказ брака
СТАТУС: Всегда неактивен для заказа
ЦЕНА: Для селлера - себестоимость дефектного товара, для фулфилмента - 0
WORKFLOW: Особый процесс списания и утилизации
УЧЕТ: Отдельный учет в статистике потерь
ОТОБРАЖЕНИЕ: Виден только для учета потерь
⚠️ СТАТУС РАЗРАБОТКИ: Тип DEFECT еще не добавлен в схему БД

4. ПРОДУКТ (`FINISHED_PRODUCT` - планируется, производная от товара)

БУДЕТ СОЗДАВАТЬСЯ: Фулфилментом на основе ТОВАРА по заказу селлера
ИНИЦИАТОР: Селлер создает заказ с рецептурой, фулфилмент исполняет
СВЯЗЬ: Обязательная связь с родительским товаром (parentId)
РЕЦЕПТУРА: Задается селлером при создании заказа (Товар + Услуга + Расходники)
СТАТУСЫ: "в работе" → "готов к отправке"
ЗАКАЗ: Доступен только в статусе "готов к отправке"
⚠️ СТАТУС РАЗРАБОТКИ: Тип FINISHED_PRODUCT еще не добавлен в схему БД

2.2 Обязательные поля карточки

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

3. 🏢 СТРУКТУРА КАБИНЕТОВ

3.1 Общие принципы кабинетов

КАЖДЫЙ КАБИНЕТ ИМЕЕТ:

Главная страница (/dashboard) - общая информация и статистика
Экономика (/economics) - финансовая аналитика
Универсальные разделы:
- Маркет (/market) - просмотр и заказ товаров
- Партнеры (/partners) - управление контрагентами
- Мессенджер (/messenger) - связь между организациями
- Настройки (/settings) - профиль и API ключи

3.2 Специфические разделы по типам организаций

🏪 ПОСТАВЩИК (WHOLESALE):

Склад (/warehouse) - управление товарами и расходниками
Поставки (/supplies) - обработка заказов от селлеров

🛍️ СЕЛЛЕР (SELLER):

Мои поставки (/supplies) - управление заказами товаров
WB Интеграция (/wb-integration) - связь с Wildberries

🏭 ФУЛФИЛМЕНТ (FULFILLMENT):

Склад фулфилмента (/fulfillment-warehouse) - управление всеми типами товаров
Поставки фулфилмента (/fulfillment-supplies) - обработка поставок
Услуги (/services) - управление услугами, логистикой, расходниками
Сотрудники (/employees) - управление персоналом
Статистика фулфилмента (/fulfillment-statistics) - детальная аналитика

🚚 ЛОГИСТИКА (LOGIST):

Заявки (/logistics-requests) - управление заявками на доставку
Маршруты (/routes) - планирование маршрутов

4. 🔐 СИСТЕМА РОЛЕЙ И ДОСТУПОВ

4.1 Контроль доступа к разделам

ПРОВЕРКА НА УРОВНЕ КОМПОНЕНТОВ:

{user?.organization?.type === "FULFILLMENT" && (
  // Компоненты доступны только фулфилменту
)}

СПЕЦИАЛЬНАЯ ЛОГИКА РОУТИНГА:

const handleSuppliesClick = () => {
  switch (user?.organization?.type) {
    case 'FULFILLMENT':
      router.push('/fulfillment-supplies')
      break
    case 'SELLER':
      router.push('/supplies')
      break
    // ... другие типы
  }
}

4.2 GraphQL проверки доступа

В Apollo Client запросах:

const { data } = useQuery(GET_MY_SERVICES, {
  skip: user?.organization?.type !== 'FULFILLMENT',
})

В GraphQL резолверах:

if (currentUser.organization.type !== 'FULFILLMENT') {
  throw new GraphQLError('Доступно только для фулфилмент центров')
}

4.3 Контроль доступа к заказам

Создатель заказа - полный доступ к своим заказам
Поставщик - доступ к заказам, где он является поставщиком
Фулфилмент-центр - доступ к заказам, направленным в его центр
Логистическая компания - доступ к заказам для доставки

5. 🚚 WORKFLOW ПОСТАВОК

📌 ВИЗУАЛЬНЫЕ ПРАВИЛА: См. visual-design-rules.md - Статусы поставок

См. детальное описание в workflow-catalog.md#1-workflow-поставок

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

📌 СВЯЗАННЫЕ РАЗДЕЛЫ:

Типы предметов → См. раздел 2.2

Склад фулфилмента → См. раздел 11.2

Статистика движения → См. раздел 7

6.1 Пошаговый алгоритм создания продукта

📌 ВИЗУАЛЬНЫЕ ПРАВИЛА: См. visual-design-rules.md - Процесс создания продукта

ПРЕДВАРИТЕЛЬНОЕ УСЛОВИЕ: РЕЦЕПТУРА ЗАДАНА (селлер)

Время: при создании заявки на поставку
Действие: селлер указывает рецептуру продукта
Обязательные компоненты:
  ✓ Базовый товар (от поставщика)
  ✓ Услуги фулфилмента (упаковка, маркировка и т.д.)
  ✓ Расходники (материалы для производства)
Результат: рецептура сохраняется в заявке и передается фулфилменту

ШАГ 1: ПОСТУПЛЕНИЕ НА СКЛАД (автоматически)

Время: при смене статуса поставки DELIVERED
Действие: товар переходит в статус "на складе"
Ответственный: система
Результат: +Прибыло в статистике товаров

ШАГ 2: ПЛАНИРОВАНИЕ РАБОТЫ (менеджер фулфилмента)

Время: в течение 2 рабочих дней после поступления
Действие: назначение параметров обработки
Ответственный: менеджер фулфилмента
Обязательные поля:
  ✓ Дедлайн выполнения (не более 5 рабочих дней)
  ✓ Ответственный исполнитель (из списка сотрудников)
  ✓ Рецептура (товар + услуги + расходники, указанная селлером в заявке на поставку)
Опциональные поля:
  - Место хранения готовых продуктов (зона склада, стеллаж, ячейка)
  - Комментарии к работе
Результат: поставка переходит во вкладку "В работе"

ШАГ 3: ОБРАБОТКА ТОВАРА (исполнитель)

Время: согласно дедлайну (обычно 1-3 дня)
Действие: физическая обработка товара
Ответственный: назначенный сотрудник
Обязательные действия:
  1. Проверка качества товара
  2. Фиксация фактического количества
  3. Выявление и учет брака
  4. Применение рецептуры (услуги + расходники)
  5. Создание готового продукта
Точки контроля:
  - Соответствие плану/факту
  - Качество выполнения услуг
  - Расход материалов по норме

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

ШАГ 4: КОНТРОЛЬ КАЧЕСТВА (менеджер/отдел качества)

Время: сразу после завершения ШАГ 3
Действие: приемка готовой продукции
Ответственный: менеджер или контролер качества
Критерии приемки:
  ✓ Соответствие рецептуре селлера
  ✓ Качество выполненных услуг
  ✓ Правильность упаковки/маркировки
  ✓ Полнота комплектации
Результат: продукт готов к отправке или отправлен на доработку

ШАГ 5: ЗАВЕРШЕНИЕ (система + менеджер)

Время: после успешного прохождения контроля качества
Действие: финализация процесса
Автоматические действия:
  - Создание записи FINISHED_PRODUCT в БД
  - Обновление статистики: товар "на складе" → продукт "готов"
  - Списание использованных расходников
  - Уведомление селлера о готовности
Ручные действия менеджера:
  - Подтверждение перехода во вкладку "Выполнено"
  - Указание фактических расходов материалов
  - Добавление комментариев о выполненной работе

6.2 Временные рамки и SLA

Этап	Стандартное время	Максимальное время	Ответственный
Планирование	1 рабочий день	2 рабочих дня	Менеджер ФФ
Обработка	2-3 рабочих дня	5 рабочих дней	Исполнитель
Контроль качества	4 часа	1 рабочий день	Отдел качества
Завершение	2 часа	4 часа	Менеджер ФФ

6.3 Управление браком и расхождениями

6.4 Детальная рецептура продукта

РЕЦЕПТУРА ПРОДУКТА (задается селлером при создании поставки):

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

ФОРМУЛА: ПРОДУКТ = Товар + Услуга(и) + Расходники селлера + Расходники ФФ

6.5 Учет план/факт в процессе работы (без брака)

ПЛАН: Количество товара из поставки селлера ФАКТ: Реальное количество после пересчета (работник фулфилмента производит сортировку при пересчете)

ФИКСАЦИЯ ПОТЕРЬ:

КОГДА: В процессе работы (вкладка "В работе")
ЧТО: Недостача, повреждения (без создания записей брака)
КАК: Корректировка количества в статистике

WORKFLOW СОЗДАНИЯ ПРОДУКТА:

Товар поступает на склад фулфилмента (статус "на складе")
Товар берется в работу (переход в статус "в обработке")
Исполнитель производит пересчет и сортировку
Создается готовый продукт (тип FINISHED_PRODUCT)
Продукт готов к отправке на маркетплейсы

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

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

🚧 БУДУЩАЯ ФУНКЦИОНАЛЬНОСТЬ: Система статусов товаров в фулфилменте будет детализирована позже

7. 📊 СИСТЕМА УЧЕТА ДВИЖЕНИЯ ТОВАРОВ

7.1 Принципы учета в фулфилменте

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

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

7.2 Дополнительные и основные значения

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

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

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

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

8. 🏠 ОБЩИЕ ПРАВИЛА КАБИНЕТОВ

8.1 Универсальная структура кабинетов

ВСЕ ТИПЫ КАБИНЕТОВ включают следующие обязательные разделы:

8.1.1 Страница "Главная"

СТАТУС: Реализовано
ДОСТУП: Через навигацию в sidebar для всех типов кабинетов
СОДЕРЖАНИЕ: Универсальная страница с типо-зависимыми компонентами

ПРАВИЛА:

ОБЯЗАТЕЛЬНО: Каждый тип кабинета должен иметь страницу "Главная"
НАВИГАЦИЯ: Доступ через кнопку в sidebar (первая в списке)
УНИВЕРСАЛЬНОСТЬ: Одинаковая структура навигации для всех кабинетов
РОУТ: /home с универсальным компонентом HomePageWrapper
КОМПОНЕНТЫ: 4 типо-зависимых компонента: SellerHomePage, FulfillmentHomePage, WholesaleHomePage, LogistHomePage

8.1.2 Раздел "Экономика"

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

ПРАВИЛА:

ОБЯЗАТЕЛЬНО: Каждый кабинет имеет раздел "Экономика"
РОУТ: /economics с универсальным компонентом EconomicsPageWrapper
КОМПОНЕНТЫ: 4 типо-зависимых компонента экономики: SellerEconomicsPage, FulfillmentEconomicsPage, WholesaleEconomicsPage, LogistEconomicsPage
КНОПКА: "Экономика" в sidebar навигации перед настройками
БЕЗОПАСНОСТЬ: Проверки доступа и безопасности в экономических компонентах

8.1.3 Общие разделы для всех кабинетов

УНИВЕРСАЛЬНЫЕ РАЗДЕЛЫ (доступны всем типам):

🏠 Главная - основная страница кабинета (реализовано)
🛒 Маркет - просмотр и заказ товаров
🤝 Партнеры - управление контрагентами
💬 Мессенджер - внутренняя связь
💰 Экономика - финансовая аналитика (реализовано)
⚙️ Настройки - профиль и конфигурация

СПЕЦИАЛИЗИРОВАННЫЕ РАЗДЕЛЫ (зависят от типа кабинета):

Определяются в соответствующих разделах каждого кабинета

8.2 Правила sidebar навигации

8.2.1 Структура навигации

ОБЩИЙ ПРИНЦИП:

Условное отображение: {user?.organization?.type === "TYPE" && (...)}
Адаптивность: сворачиваемый sidebar с getSidebarMargin()
Состояния активности: подсветка текущего раздела

ПОРЯДОК РАЗДЕЛОВ В SIDEBAR:

🏠 Главная (реализовано для всех)
Специализированные разделы (зависят от типа кабинета)
🛒 Маркет (универсальный)
🤝 Партнеры (универсальный)
💬 Мессенджер (универсальный)
💰 Экономика (универсальный, реализовано)
⚙️ Настройки (универсальный)
Выход (универсальный)

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. 🏠 КАБИНЕТ СЕЛЛЕРА (ДЕТАЛЬНЫЕ ПРАВИЛА)

📌 ВИЗУАЛЬНЫЕ ПРАВИЛА: См. visual-design-rules.md - Кабинет селлера

9.1 Структура раздела "Мои поставки"

🏢 ПОСТАВКИ НА ФУЛФИЛМЕНТ:

Товар - поставка товаров для создания продуктов
- Карточки - поставка через WB API с рецептурой (результат: WildberriesSupply)
- Поставщики - заказ товаров у поставщиков с рецептурой (результат: SupplyOrder)
Расходники селлера - поставка материалов для товаров селлера

🛒 ПОСТАВКИ НА МАРКЕТПЛЕЙСЫ (планируется):

Wildberries - прямые поставки на WB
Ozon - прямые поставки на Ozon

9.2 UI структура создания поставки расходников селлера

📄 Структура страницы создания поставки:

ВАЖНО: Страница НЕ имеет основного заголовка и описания. Сразу начинается с блоков контента.

ОБНОВЛЕННАЯ СТРУКТУРА СИСТЕМЫ (4 БЛОКА):

БЛОК 1: ПОСТАВЩИКИ (адаптивная сетка)

Навигация: Плавающая кнопка "Назад" между сайдбаром и контентом (см. детали в seller-ui-rules.md)
Заголовок: БЕЗ заголовка - блок начинается сразу с функционального контента
Поиск: Компактное поле справа "Поиск поставщиков..." (w-64)
Отображение: Карточки поставщиков из раздела "Партнеры" в адаптивной сетке
Выбор: Клик выделяет карточку поставщика
Результат: Загружаются карточки товаров выбранного поставщика в блок 2

БЛОК 2: КАРТОЧКИ ТОВАРОВ (горизонтальный скролл - НОВЫЙ)

Отображение: ТОЛЬКО минималистичные карточки товаров 80×112px
Содержание: ТОЛЬКО изображение товара, БЕЗ текста/названий/цен
Навигация: Горизонтальный скролл при множестве товаров
Выбор: Клик добавляет товар в детальный каталог
Результат: Товар добавляется в блок 3 для управления поставкой

БЛОК 3: ТОВАРЫ ПОСТАВЩИКА (детальный каталог)

Отображение: Детальные карточки выбранных товаров
Управление: Количество, параметры, настройки поставки
Результат: Формирование окончательной поставки

БЛОК 4: КОРЗИНА И НАСТРОЙКИ (правая панель)

Отображение: Корзина поставки + настройки
Управление: Фулфилмент-центр, дата, логистика

9.2.1 Детальные правила горизонтального скролла поставщиков

СТРУКТУРА И ОТОБРАЖЕНИЕ:

Источник данных: Партнеры типа WHOLESALE из раздела "Партнеры"
Контейнер: Фиксированная высота 176px (h-44) с горизонтальным скроллом
Блок поставщиков: Общая высота 180px, включает заголовок + контейнер скролла
Направление: Слева направо (LTR)
Поведение: Плавный скролл с автоскрытием полосы прокрутки

РАЗМЕРЫ И АДАПТИВНОСТЬ:

Десктоп: Карточка 216×92px, отступы 12px между карточками, 16px от краев
Планшет: Карточка 200×92px, отступы 12px между карточками
Мобильный: Карточка 184×92px, отступы 12px между карточками
Высота блока: 180px фиксированная для всего блока поставщиков

ВЗАИМОДЕЙСТВИЕ:

Навигация: Колесо мыши (Shift+скролл), стрелки клавиатуры, свайп на тач
Выбор: Клик по карточке → активная рамка + загрузка товаров в блок 2
Состояния: Default, Hover (box-shadow), Active (цветная рамка), Loading (скелетон)

ГРАНИЧНЫЕ СЛУЧАИ:

1-4 карточки: Выравнивание по левому краю, скролл неактивен
5+ карточек: Полный горизонтальный скролл
Нет партнеров: Заглушка с ссылкой на раздел "Партнеры"

ТЕХНИЧЕСКАЯ РЕАЛИЗАЦИЯ:

Критическая Flex-архитектура:

.parent-container {
  display: flex;
  gap: 16px;
  min-height: 0;
}

.left-block {
  flex: 1;
  min-width: 0; /* КРИТИЧЕСКИ ВАЖНО для overflow */
  display: flex;
  flex-direction: column;
}

.suppliers-container {
  height: 180px; /* Общая высота блока */
  flex-shrink: 0;
  min-width: 0; /* Предотвращает растяжение */
}

.right-block {
  width: 384px; /* w-96 */
  flex-shrink: 0; /* Защита от сжатия */
}

Контейнер скролла:

.suppliers-block {
  display: flex;
  overflow-x: auto;
  scroll-behavior: smooth;
  gap: 12px;
  padding: 0 16px 8px 16px; /* px-4 pb-2 */
  height: 176px; /* h-44 */
  scrollbar-width: thin;
  scrollbar-color: #64748b33 transparent;
}

.suppliers-block:hover {
  scrollbar-color: #cbd5e0 #64748b22;
}

.supplier-card {
  flex-shrink: 0;
  width: 216px; /* Десктоп */
  height: 92px; /* Фиксированная высота */
  padding: 8px; /* p-2 */
  transition: all 0.2s ease;
}

СОДЕРЖАНИЕ КАРТОЧКИ ПОСТАВЩИКА:

Структура (3 строки в 92px высоты):

Строка 1: Название + рейтинг (справа, если есть)
Строка 2: ИНН (формат "ИНН: 1234567890")
Строка 3: Бейдж рынка (отдельная строка)

Элементы:

Аватар: Размер xs, слева с gap-2
Текст: text-xs для компактности
Отступы: mb-1 между строками 1-2, mb-0.5 между строками 2-3
Padding карточки: 8px (p-2)

ЦВЕТОВАЯ СХЕМА РЫНКОВ:

"Садовод" (sadovod): Зеленый bg-green-500/20 text-green-300 border-green-500/30
"ТЯК Москва" (tyak-moscow): Синий bg-blue-500/20 text-blue-300 border-blue-500/30
Другие/не указан: Серый bg-gray-500/20 text-gray-300 border-gray-500/30

ДОСТУПНОСТЬ:

role="tablist" для контейнера
role="tab" для карточек
aria-selected="true/false" для выбранной карточки
tabindex="0" для активной, -1 для неактивных

9.2.2 Правила блока "Карточки товаров" (Блок 2)

НАЗНАЧЕНИЕ И ЛОГИКА:

Источник данных: Товары выбранного поставщика из Блока 1
Триггер отображения: Клик на карточку поставщика → загрузка карточек товаров
Взаимодействие: Клик на карточку товара → добавление в Блок 3 "Товары поставщика"
Поведение: Горизонтальный скролл при множестве товаров

АРХИТЕКТУРА И РАЗМЕРЫ:

Внешний контейнер: bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl flex-shrink-0
Внутренний контейнер скролла: flex gap-3 overflow-x-auto p-4
Стилизация скролла: scrollbarWidth: 'thin' для тонкой полосы прокрутки
Отступы: padding: 16px (p-4) внутри, gap: 12px (gap-3) между карточками
Адаптивная высота: по содержимому карточек (БЕЗ фиксированной высоты)
Визуальное единство: стеклянный эффект как у других блоков системы
БЕЗ заголовков/иконок: только чистые карточки товаров в контейнере

РАЗМЕРЫ КАРТОЧЕК ТОВАРОВ:

Компактная карточка: 80×112px (w-20 h-28), соотношение 5:7
Адаптивность: фиксированный размер для всех устройств

СОДЕРЖАНИЕ КАРТОЧКИ ТОВАРА:

ТОЛЬКО изображение товара: 80×112px, object-cover
Минималистичный дизайн: БЕЗ текста, названий, цен, иконок
Состояния: Default, Selected, Active (БЕЗ Hover-эффектов)
Рамка: border-white/10, при выборе border-white/30
Фон: bg-white/5 полупрозрачный

ДЕЙСТВИЕ: Клик на карточку → добавление товара в Блок 3 (детальный каталог)

9.2.3 Правила Блока 3 "Детальный каталог товаров"

НАЗНАЧЕНИЕ И СТРУКТУРА:

Контент: Детальные карточки выбранных товаров с полным управлением
Верхняя панель: Выбор даты + Выбор Fulfillment + Поиск
Основная область: Сетка карточек товаров с детальной информацией

9.2.3.1 Структура верхней панели Блока 3

МИНИМАЛИСТИЧНАЯ ПАНЕЛЬ УПРАВЛЕНИЯ:

Выбор даты поставки: DatePicker для планирования поставки
Выбор Fulfillment-центра: Select dropdown со списком доступных фулфилментов
Поиск по товарам: Input с иконкой поиска и placeholder
Компоновка: Горизонтальная строка с равномерным распределением

ТЕХНИЧЕСКИЕ ТРЕБОВАНИЯ:

// Структура компонентов панели
<div className="flex items-center gap-4 p-4 bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl mb-4">
  <DatePicker placeholder="Дата поставки" />
  <Select placeholder="Выберите фулфилмент">
    <SelectContent>
      {fulfillmentCenters.map((center) => (
        <SelectItem value={center.id}>{center.name}</SelectItem>
      ))}
    </SelectContent>
  </Select>
  <div className="relative flex-1">
    <Search className="absolute left-3 top-1/2 transform -translate-y-1/2 h-4 w-4 text-white/40" />
    <Input placeholder="Поиск товаров..." className="pl-10 glass-input" />
  </div>
</div>

9.2.3.2 Структура основной области карточек

СЕТКА ТОВАРОВ:

Адаптивная сетка: grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4
Детальные карточки: Полная информация + количество + управление
Состояния: Default, Selected, Editing
Интерактивность: Изменение количества, удаление, настройки рецептуры

ФУНКЦИОНАЛЬНОСТЬ ПАНЕЛИ:

Выбор даты: Планирование времени поставки (обязательное поле)
Выбор фулфилмента: Определение исполнителя поставки (обязательное поле)
Поиск: Фильтрация товаров в каталоге по названию/артикулу
Валидация: Блокировка создания поставки без заполнения даты и фулфилмента

ГРАНИЧНЫЕ СЛУЧАИ:

Пустой каталог: Заглушка "Добавьте товары"
Нет фулфилментов: Сообщение "Настройте партнерство с фулфилмент-центрами"
Поиск без результатов: "По запросу ничего не найдено"

9.2.2.1 Структура контейнера Блока 2

ДВУХУРОВНЕВАЯ АРХИТЕКТУРА:

УРОВЕНЬ 1 - Внешний контейнер (блок):

<div className="bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl flex-shrink-0">

Назначение: Визуальное обрамление блока, единство с другими блоками
Стилизация: Стеклянный эффект с размытием и полупрозрачностью
Рамка: Тонкая белая рамка border-white/20 с закруглёнными углами
Поведение: flex-shrink-0 предотвращает сжатие блока

УРОВЕНЬ 2 - Внутренний контейнер (скролл):

<div className="flex gap-3 overflow-x-auto p-4" style={{ scrollbarWidth: 'thin' }}>

Назначение: Горизонтальная прокрутка карточек товаров
Раскладка: Flex с промежутками gap-3 (12px) между карточками
Отступы: padding p-4 (16px) со всех сторон
Скролл: overflow-x-auto с тонкой полосой прокрутки
Поведение: Автоматическое появление скролла при превышении ширины

ПРАВИЛА КОНТЕЙНЕРОВ:

Внешний контейнер НЕ содержит заголовков, иконок, описаний
Внутренний контейнер содержит ТОЛЬКО карточки товаров
Высота адаптируется под размер карточек (80×112px + отступы)
Визуальное единство со всеми блоками формы поставки

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

Условие отображения: selectedSupplier && products.length > 0
Источник данных: products массив из GraphQL запроса organizationProducts
Реактивность: Автоматическое обновление при смене поставщика
Производительность: React.memo для карточек при большом количестве товаров
Доступность: Клавиатурная навигация (Tab, Enter для выбора)

UX ПРАВИЛА ВЗАИМОДЕЙСТВИЯ:

Скролл: Автоматическое появление при превышении ширины контейнера
Индикация загрузки: Скелетоны карточек во время загрузки товаров
Пустое состояние: Скрытие блока при отсутствии поставщика или товаров
Фокус: Первая карточка получает фокус при загрузке товаров
Навигация: Стрелки ←→ для перемещения между карточками

СОСТОЯНИЯ БЛОКА:

Скрыт: При отсутствии выбранного поставщика
Скрыт: При отсутствии товаров у поставщика
Активен: При наличии поставщика и товаров
Загрузка: Показ скелетонов карточек во время запроса

ПРАВИЛА ПРОИЗВОДИТЕЛЬНОСТИ:

Виртуализация: При количестве товаров > 100
Ленивая загрузка изображений: loading="lazy" для всех изображений
Мемоизация: React.memo для компонентов карточек
Дебаунс: 300мс для поисковых запросов (если будет добавлен поиск)

ПРАВИЛА АДАПТИВНОСТИ:

Мобильные устройства: Свайп для горизонтальной прокрутки
Планшеты: Сохранение размеров карточек 80×112px
Десктоп: Полная функциональность с клавиатурной навигацией
Высокие разрешения: Сохранение пропорций и читаемости

ПРАВИЛА БЕЗОПАСНОСТИ И ВАЛИДАЦИИ:

Валидация данных: Проверка существования product.id перед добавлением
Дубликаты: Предотвращение добавления одного товара дважды в детальный каталог
Санитизация: Безопасное отображение названий товаров (XSS защита)
Обработка ошибок: Graceful degradation при ошибках загрузки изображений
Защита от спама: Дебаунс кликов 200мс для предотвращения множественных добавлений

ПРАВИЛА ИНТЕГРАЦИИ С ДРУГИМИ БЛОКАМИ:

Блок 1 (Поставщики): Слушает изменения selectedSupplier для обновления товаров
Блок 3 (Детальный каталог): Передаёт выбранные товары через setAllSelectedProducts
Блок 4 (Корзина): Товары добавляются в корзину из Блока 3, не напрямую из Блока 2
Синхронизация состояний: Реактивное обновление при изменении данных в любом блоке

ПРАВИЛА АНАЛИТИКИ И МЕТРИК:

Отслеживание кликов: Логирование добавления товаров в детальный каталог
Метрики производительности: Время загрузки товаров поставщика
Пользовательское поведение: Количество просмотренных товаров на поставщика
A/B тестирование: Готовность к тестированию различных размеров карточек

ПРАВИЛА ЛОКАЛИЗАЦИИ:

Alt-текст изображений: На языке интерфейса пользователя
Направление скролла: RTL поддержка для арабского/иврита
Размеры карточек: Неизменны для всех локалей (80×112px)
Сообщения об ошибках: Локализованные уведомления при проблемах загрузки

9.2.1.1 Заголовок и поиск Блока 1

МИНИМАЛИСТИЧНЫЙ ДИЗАЙН:

<div className="flex items-center justify-between gap-4">
  <div className="flex items-center gap-2">
    <Building2 className="h-5 w-5 text-blue-400" />
    <h2 className="text-lg font-semibold text-white">Поставщики</h2>
  </div>
  <div className="w-64">
    <div className="relative">
      <Search className="absolute left-3 top-1/2 transform -translate-y-1/2 text-white/40 h-4 w-4" />
      <Input
        placeholder="Поиск поставщиков..."
        className="bg-white/5 border-white/10 text-white placeholder:text-white/50 pl-10 h-9"
      />
    </div>
  </div>
</div>

ПРАВИЛА ЗАГОЛОВКА:

Иконка: Building2 h-5 w-5 text-blue-400 (без фонового контейнера)
Текст: "Поставщики" (убран избыточный "товаров")
Размер: text-lg font-semibold (увеличен для лучшей читаемости)
БЕЗ бэджа: Убран избыточный бэдж "Создание поставки"
Выравнивание: flex items-center gap-2 (компактное)

ПРАВИЛА ПОИСКА:

Позиция: Справа от заголовка (justify-between)
Ширина: w-64 (256px) фиксированная ширина
Плейсхолдер: "Поиск поставщиков..." (конкретное описание)
Иконка: Search h-4 w-4 слева в поле
Стили: Стандартные glass-эффекты, focus:border-white/20

ПРАВИЛА КНОПКИ "НАЙТИ В МАРКЕТЕ":

Условие: Показывается только при allCounterparties.length === 0
Позиция: Отдельный блок под заголовком (mt-4)
НЕ интегрирована: В поле поиска (отдельно)
Стили: glass-secondary outline button размера sm

9.2.1.2 Структура карточки поставщика в Блоке 1

МИНИМАЛИСТИЧНАЯ КАРТОЧКА ПОСТАВЩИКА:

СТРУКТУРА ИНФОРМАЦИИ:

<div className="flex items-start gap-2">
  <OrganizationAvatar organization={supplier} size="sm" />
  <div className="flex-1 min-w-0">
    <h4 className="text-white font-medium text-sm truncate">{supplier.name || supplier.fullName}</h4>
    <div className="flex items-center gap-2 mt-1">
      <p className="text-white/60 text-xs font-mono">ИНН: {supplier.inn}</p>
      {supplier.market && <Badge className="market-badge">{getMarketLabel(supplier.market)}</Badge>}
    </div>
  </div>
</div>

ПРАВИЛА СОДЕРЖАНИЯ КАРТОЧКИ:

✅ ОСТАВИТЬ:

Аватар организации: OrganizationAvatar size="sm" слева
Название поставщика: supplier.name || supplier.fullName (приоритет name)
ИНН: font-mono, text-white/60, с префиксом "ИНН: "

🔸 ДОБАВИТЬ:

Принадлежность к рынку: Badge с названием рынка из supplier.market
Рынки: "Садовод", "ТЯК Москва" и другие из Organization.market поля

❌ УБРАТЬ:

Рейтинг: Звездочка и цифра rating (избыточно)
Тип бэдж: "Поставщик" badge (и так понятно из контекста)
Адрес: supplier.address (занимает место, не критично)

СТИЛИ РЫНОЧНЫХ БЭДЖЕЙ:

Садовод: bg-green-500/20 text-green-300 border-green-500/30
ТЯК Москва: bg-blue-500/20 text-blue-300 border-blue-500/30
По умолчанию: bg-gray-500/20 text-gray-300 border-gray-500/30

ПРАВИЛА АДАПТИВНОСТИ:

Мобильные: Сохранение структуры, truncate для длинных названий
Планшеты/десктоп: Полное отображение в сетке
Малые экраны: line-clamp-1 для названия организации

СОСТОЯНИЯ КАРТОЧКИ:

Default: bg-white/5 border-white/10
Hover: hover:border-white/20 hover:bg-white/10
Selected: bg-white/15 border-white/40 shadow-lg
Disabled: opacity-50 cursor-not-allowed (при недоступности)

ПРАВИЛА ИНТЕГРАЦИИ С РЫНКАМИ:

ИСТОЧНИК ДАННЫХ:

Поле БД: Organization.market (String?) - поле принадлежности к рынку
Настройка: Указывается в настройках кабинета поставщика
Опциональность: Поле может быть пустым (рынок не указан)

ФУНКЦИЯ getMarketLabel():

const getMarketLabel = (market?: string) => {
  const marketLabels = {
    'sadovod': 'Садовод',
    'tyak-moscow': 'ТЯК Москва',
    'opt-market': 'ОПТ Маркет',
  }
  return marketLabels[market as keyof typeof marketLabels] || market
}

СТИЛИ ДЛЯ РЫНКОВ:

const getMarketBadgeStyle = (market?: string) => {
  const styles = {
    'sadovod': 'bg-green-500/20 text-green-300 border-green-500/30',
    'tyak-moscow': 'bg-blue-500/20 text-blue-300 border-blue-500/30',
    'opt-market': 'bg-purple-500/20 text-purple-300 border-purple-500/30',
  }
  return styles[market as keyof typeof styles] || 'bg-gray-500/20 text-gray-300 border-gray-500/30'
}

ПРАВИЛА ОТОБРАЖЕНИЯ:

Условие: Показывать badge только если supplier.market существует
Размер: text-xs для соответствия ИНН
Позиция: Справа от ИНН в той же строке
Приоритет: Рынок важнее типа организации для селлера

9.2.2.2 ПРАВИЛО ПЕРСИСТЕНТНОСТИ ВЫБРАННЫХ ТОВАРОВ

🎯 ОСНОВНОЙ ПРИНЦИП: Выбранные товары в детальном каталоге (блок 3) сохраняются при смене поставщика и могут быть удалены только явным действием пользователя.

🔄 WORKFLOW СЦЕНАРИИ:

СЦЕНАРИЙ 1: Добавление товаров от разных поставщиков

Пользователь выбирает Поставщика А
Добавляет Товар 1 и Товар 2 в детальный каталог
Переключается на Поставщика Б
Товар 1 и Товар 2 остаются в блоке 3
Добавляет Товар 3 от Поставщика Б
В блоке 3: Товар 1, Товар 2 (от А) + Товар 3 (от Б)

СЦЕНАРИЙ 2: Визуальная индикация в блоке 2

При переключении на поставщика, товары которого уже есть в блоке 3, показываются как "выбранные"
Товары от других поставщиков в блоке 2 не отображаются

🛠️ ТЕХНИЧЕСКИЕ ПРАВИЛА:

Состояние selectedProductsForDetailView:

Глобальное состояние всех выбранных товаров
НЕ зависит от текущего поставщика
НЕ очищается при смене поставщика
Очищается только явными действиями пользователя

Единственные способы удаления:

Кнопка "Удалить из каталога" в карточке товара (блок 3)
Кнопка "Очистить каталог" в заголовке блока 3
НЕ при смене поставщика

🎨 UX ПРАВИЛА:

Счетчик товаров: "Детальный каталог (X товаров от Y поставщиков)"
Визуальная индикация выбранных товаров в блоке 2
Информация о поставщике для каждого товара в блоке 3

СОСТОЯНИЯ БЛОКА:

Не выбран поставщик: Заглушка "Выберите поставщика для просмотра товаров"
Поставщик выбран, нет товаров: "У поставщика нет товаров"
Поставщик выбран, есть товары: Карточки товаров с горизонтальным скроллом

ВЗАИМОДЕЙСТВИЕ:

Навигация: Горизонтальная прокрутка мышью, клавишами ←→
Выбор: Клик → добавление в Блок 3 с анимацией
Состояния карточек: Default, Selected, Active (при добавлении)

ГРАНИЧНЫЕ СЛУЧАИ:

1-5 карточек: Скролл неактивен, выравнивание по левому краю
6+ карточек: Полноценный горизонтальный скролл
Поиск: Фильтрация карточек в реальном времени
Загрузка: Скелетон-анимация при смене поставщика

БЛОК 3: ТОВАРЫ ПОСТАВЩИКА (детальный каталог)

Содержание: Детальный каталог товаров для управления поставкой
Источник: Товары, добавленные из Блока 2 "Карточки товаров"
Сортировка: По цене, названию, категории
Фильтры: По категории, ценовому диапазону
Карточка расходника:
- Фото, название, цена, остаток, категория
- Количество в комплекте (если есть комплектность)
- Поле ввода количества (единицы или комплекты)
- Кнопки +/- для изменения количества
Действие: Клик добавляет расходник в корзину

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

Содержание корзины:
- Количество видов расходников
- По каждому расходнику: название, количество, цена за единицу, сумма
- Общая сумма всех расходников
Управление: Изменение количества, удаление позиций
Валидация: Проверка остатков у поставщика
Настройки поставки:
- Выбор фулфилмент-центра (dropdown из партнеров)
- Дата поставки (по умолчанию - дата создания, нельзя выбрать прошедшую)
Кнопка: "Создать поставку"

9.3 Многоуровневые таблицы для отображения поставок

📊 Структура многоуровневой таблицы:

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

Порядковый номер поставки (от большего к меньшему)
Количество видов расходников селлера
Стоимость всей поставки
Количество категорий
Статус поставки
Кнопка раскрытия/сворачивания

ВТОРОЙ УРОВЕНЬ (раскрывается по клику):

Название расходника селлера
Количество
Цена за единицу
Общая стоимость позиции
Категория
Поставщик
Режим: Только просмотр (редактирование недоступно после создания)

ПРАВИЛА ОТОБРАЖЕНИЯ:

По умолчанию таблица свернута, показан только первый уровень
Клик по строке или кнопке раскрывает второй уровень
Анимация раскрытия плавная (300ms)
Визуальная индикация раскрытого состояния (поворот стрелки, изменение фона)

9.4 Правила кнопки "Создать поставку" в разделе "Мои поставки"

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

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

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

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

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

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

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

9.4.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.2.4 Поведение кнопок

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

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

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

9.2.6 ПРАВИЛА КОРЗИНЫ - ЕДИНЫЙ СТАНДАРТ

КРИТИЧЕСКИ ВАЖНО: Все корзины в системе должны следовать единому стандарту дизайна и функциональности.

9.2.6.1 Размеры и позиционирование

<div className="w-72 flex-shrink-0">
  <div className="bg-white/10 backdrop-blur border-white/20 p-3 sticky top-0 rounded-2xl">

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

Ширина: w-72 (288px) - фиксированная ширина для всех корзин
Флекс: flex-shrink-0 - корзина не сжимается
Позиция: sticky top-0 - прилипает к верху при прокрутке
Стиль: Glass morphism эффект с backdrop-blur и bg-white/10

9.2.6.2 Автодобавление товаров

ПРАВИЛО AUTO-ADD: При вводе количества товар автоматически добавляется в корзину.

// ОБЯЗАТЕЛЬНАЯ РЕАЛИЗАЦИЯ:
const handleQuantityChange = (e: React.ChangeEvent<HTMLInputElement>) => {
  const inputValue = e.target.value
  const newQuantity = inputValue === '' ? 0 : Math.max(0, parseInt(inputValue) || 0)

  if (newQuantity > 0) {
    // Автоматически добавляем товар в корзину
    updateProductQuantity(product.id, newQuantity)
  } else {
    // Удаляем товар из корзины при количестве 0
    removeFromCart(product.id)
  }
}

ДЕФОЛТНОЕ ЗНАЧЕНИЕ: Пустой инпут (value={''}) вместо value={0}

9.2.6.3 Структура корзины

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

Заголовок: "Корзина (X шт)" с иконкой корзины
Список товаров:
- Название товара (БЕЗ суффикса "(с рецептурой)")
- Цена за единицу × количество
- Кнопка удаления (X справа)
Мета-информация: Дата поставки, фулфилмент-центр, логистика
Итого: Общая сумма с выделением зелёным цветом
Кнопка действия: "Создать поставку" с градиентом

ЗАПРЕЩЕНО: Отображать текст "(с рецептурой)" в названиях товаров в корзине

9.2.6.4 Единая функция расчета стоимости

КРИТИЧЕСКИ ВАЖНО: Использовать единую функцию расчета для избежания расхождений:

const getProductTotalWithRecipe = (productId: string, quantity: number) => {
  const product = products.find((p) => p.id === productId)
  if (!product) return 0

  // Базовая цена товара
  let total = (product.pricePerUnit || 0) * quantity

  // Добавляем услуги
  if (product.services && product.services.length > 0) {
    const servicesTotal = product.services.reduce((sum, service) => {
      return sum + (service.pricePerUnit || 0) * quantity
    }, 0)
    total += servicesTotal
  }

  // Добавляем FF расходники (используем .price, НЕ .pricePerUnit!)
  if (product.ffConsumables && product.ffConsumables.length > 0) {
    const ffConsumablesTotal = product.ffConsumables.reduce((sum, consumable) => {
      return sum + (consumable.price || 0) * quantity // ВАЖНО: .price!
    }, 0)
    total += ffConsumablesTotal
  }

  // Добавляем расходники продавца
  if (product.sellerConsumables && product.sellerConsumables.length > 0) {
    const sellerConsumablesTotal = product.sellerConsumables.reduce((sum, consumable) => {
      return sum + (consumable.pricePerUnit || 0) * quantity
    }, 0)
    total += sellerConsumablesTotal
  }

  return total
}

9.2.6.5 Синхронизация данных между блоками

ПРАВИЛО СИНХРОНИЗАЦИИ: Данные в корзине должны отражать выборы из всех блоков формы:

Дата поставки: Из Блока 3 (дата пикер)
Фулфилмент-центр: Название выбранного FF (реальные данные!)
Логистическая компания: Только партнеры типа 'LOGIST'

ПОРЯДОК ОТОБРАЖЕНИЯ В КОРЗИНЕ:

Дата поставки: 08.08.2025
Фулфилмент-центр: ФУЛФИЛМЕНТ РУ
Логистическая компания: [Выпадающий список]

9.2.6.6 Критические требования

🚨 БЕЗОПАСНОСТЬ ТИПОВ:

Всегда проверять на null/undefined: selectedSupplier?.id || ''
Использовать optional chaining для всех вложенных объектов

🚨 ПРОИЗВОДИТЕЛЬНОСТЬ:

Мемоизация расчетов: useMemo для дорогих вычислений
Debounce для инпутов количества

🚨 UX КОНСИСТЕНТНОСТЬ:

Единые стили для всех корзин в системе
Одинаковое поведение auto-add во всех формах
Синхронная валидация данных

9.3 Структура страницы "Мои поставки" - Трёхблочная архитектура

9.3.1 Обязательная структура страницы

ПРИНЦИП: Страница состоит из трёх визуально разделённых блоков

┌─────────────────────────────────────────┐
│  1. БЛОК ТАБОВ (навигация)             │
│     - Фиксированная высота             │
│     - Glass-эффект                     │
│     - Иерархическая структура          │
├─────────────────────────────────────────┤
│  2. БЛОК СТАТИСТИКИ (метрики)          │
│     - Контекстные данные               │
│     - 4 карточки в ряд (desktop)       │
│     - Динамическое обновление          │
├─────────────────────────────────────────┤
│  3. ОСНОВНОЙ БЛОК (контент)            │
│     - Сохраняет весь функционал        │
│     - Таблицы, фильтры, действия       │
│     - Высота до низа sidebar           │
└─────────────────────────────────────────┘

9.3.2 Блок статистики - контекстные метрики

ПРАВИЛО: Статистика меняется в зависимости от выбранных табов

Для путей "Фулфилмент → Товар → Карточки/Поставщики":

Всего поставок
Активных поставок
Сумма активных поставок
В пути

Для пути "Фулфилмент → Расходники селлера":

Всего поставок
Активных поставок
Видов расходников
Критические остатки

Для путей "Маркетплейсы → Wildberries/Ozon":

Поставок на маркетплейс
Товаров отправлено
Возвраты за неделю
Эффективность поставок

9.3.3 Высота основного блока

ФОРМУЛА РАСЧЕТА:

height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins);

ПРАВИЛО ВЫРАВНИВАНИЯ:

Нижняя граница основного блока должна быть на одном уровне с нижней границей sidebar
При изменении размера окна высота пересчитывается
Внутренний скролл: overflow-y-auto

9.3.4 Сохранение функционала

КРИТИЧЕСКИ ВАЖНО: При добавлении блока статистики весь существующий функционал сохраняется:

Таблицы с данными поставок
Фильтры и сортировка
Кнопки действий
Детализация при клике
Пагинация
Поиск

ЗАПРЕЩЕНО:

Удалять существующие компоненты
Изменять логику работы таблиц
Нарушать существующие API вызовы

9.4 Табы "Карточки" и "Поставщики" - объединённая логика

9.4.1 Принцип единого типа предмета

КЛЮЧЕВОЕ ПРАВИЛО: Табы "Карточки" и "Поставщики" - это два способа создания поставок одного типа предмета (ТОВАР)

СПОСОБЫ СОЗДАНИЯ:

Карточки - импорт товаров через WB API с автоматическим созданием поставки
Поставщики - прямой заказ товаров у поставщика с указанием рецептуры

РЕЗУЛЬТАТ: Оба способа создают SupplyOrder с товарами типа PRODUCT

9.4.2 Общая статистика

ПРАВИЛО: Блок статистики показывает ОДИНАКОВЫЕ данные для обоих табов

МЕТРИКИ ДЛЯ ТАБОВ "КАРТОЧКИ" И "ПОСТАВЩИКИ":

Всего поставок товаров (из всех источников)
Активных поставок товаров (в работе)
Сумма активных поставок товаров
Товаров в пути (все способы доставки)

ЗАПРЕЩЕНО: Разделять статистику по способу создания

9.4.3 Общий основной блок

СОДЕРЖИМОЕ: Единая таблица всех поставок товаров

ИСТОЧНИКИ ДАННЫХ:

Поставки, созданные через импорт карточек WB
Поставки, созданные через заказ у поставщиков
Все промежуточные и завершённые поставки

РАЗЛИЧИЯ ТАБОВ:

Только кнопки создания ведут на разные страницы
Таб "Карточки": /supplies/create-cards
Таб "Поставщики": /supplies/create-suppliers

9.5 Создание поставки расходников селлера

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

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

Навигация: Плавающая кнопка "Назад" между сайдбаром и контентом (см. seller-ui-rules.md)
БЕЗ заголовка - блок начинается сразу с поиска и карточек
Карточки поставщиков из раздела "Партнеры"
Горизонтальный скролл при превышении ширины
Выбор только одного поставщика одновременно

БЛОК 2: КАРТОЧКИ ТОВАРОВ (адаптивная высота - НОВЫЙ БЛОК):

ТОЛЬКО минималистичные карточки товаров 80×112px
ТОЛЬКО изображение товара, БЕЗ текста/названий/цен
Горизонтальный скролл при множестве товаров
Клик добавляет товар в блок 3

БЛОК 3: ТОВАРЫ ПОСТАВЩИКА (flex-1, детальный каталог):

Детальные карточки выбранных товаров
Управление количеством и параметрами поставки

БЛОК 4: КОРЗИНА И НАСТРОЙКИ (правая панель, 384px):

Корзина поставки с выбранными товарами
Настройки поставки (фулфилмент-центр, дата, логистика)
Сортировка: цена, название, категория
Фильтры: категория, ценовой диапазон
Карточка с полем ввода количества и кнопками +/-

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

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

9.6 Многоуровневая таблица поставок

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

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

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

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

10. 🏪 КАБИНЕТ ПОСТАВЩИКА

📖 Технические детали кабинета: См. wholesale-cabinet-rules.md для компонентов, GraphQL и UI/UX

10.1 Разделение понятий: РЫНОК vs МАРКЕТ

🔍 КРИТИЧЕСКОЕ РАЗДЕЛЕНИЕ ПОНЯТИЙ:

РЫНОК 🏪 - физическое торговое место

Назначение: Географическая принадлежность поставщиков
Примеры: Садовод, ТЯК Москва
Структура: Название + адрес
Связь: Поставщик принадлежит рынку

МАРКЕТ 🛒 - раздел системы для торговли

Назначение: Глобальный каталог товаров в системе
Роут: /market - просмотр и заказ товаров
Содержание: Все доступные товары от всех поставщиков
Связь: НЕ связан с физическими рынками

🏢 АРХИТЕКТУРА ПРИНАДЛЕЖНОСТИ:

РЫНОК (физическое место)
 └── Поставщик (Organization.market)
     └── Товары/Расходники (наследуют рынок от поставщика)
         └── Отображаются в МАРКЕТЕ (/market)

🎯 ПРИНЦИПЫ ИЕРАРХИИ:

РЫНОК → ПОСТАВЩИК: Поставщик работает на конкретном рынке
ПОСТАВЩИК → ТОВАРЫ: Товары принадлежат поставщику с его рынка
ТОВАРЫ → МАРКЕТ: Все товары показываются в глобальном маркете (/market)
НАСЛЕДОВАНИЕ: Товары получают рынок от организации поставщика

🏪 ФИЗИЧЕСКИЕ РЫНКИ В СИСТЕМЕ:

"Садовод" (sadovod) - Москва, 14-й км МКАД
- Цветовая схема: bg-green-500/20 text-green-300 border-green-500/30
"ТЯК Москва" (tyak-moscow) - Москва, Алтуфьевское шоссе, 27
- Цветовая схема: bg-blue-500/20 text-blue-300 border-blue-500/30

🛒 МАРКЕТ В СИСТЕМЕ:

Роут: /market - глобальный каталог товаров
Функции: Просмотр, поиск, фильтрация, заказ товаров
Источник: Товары от всех поставщиков всех рынков
Отображение рынка: В карточках поставщиков и товаров

🔧 ТЕХНИЧЕСКАЯ РЕАЛИЗАЦИЯ:

Поле рынка: Organization.market (String?) - принадлежность поставщика к рынку
Настройка рынка: В настройках организации поставщика
Отображение в маркете: Товары показывают рынок через product.organization.market
Фильтрация: В маркете по рынку поставщика

10.2 Основные возможности

СОЗДАНИЕ КАРТОЧЕК:

ТОВАР - базовые товары поставщика
РАСХОДНИКИ - материалы и вспомогательные товары

10.3 Обязательные поля карточки

Базовые параметры:

Фото (система загрузки и управления изображениями)
Название
Автоматическая генерация артикула СФ
Описание
Количество предметов в единицах
Количество комплектов (если применимо)
Категория (28 предустановленных + специализированные для расходников)
Бренд, Цвет, Размер/объем, Вес, Габариты, Материал
Цена за единицу и за комплект
Заказано, В пути, Остаток, Продано

10.4 Отображение информации в карточках

Каждая карточка содержит:

Основное изображение
Название и артикул СФ
Цена за единицу/комплект
Категория и статус активности
Данные о движении: остаток, заказано, в пути, продано
Индикаторы низких остатков

10.5 Статистика поставщика

Блок статистики включает:

ТОВАРЫ: Общая статистика товаров поставщика
РАСХОДНИКИ: Материалы и вспомогательные товары
- Классифицируются при заказе в зависимости от заказчика
- Общая статистика по всем расходникам

11. 🏭 КАБИНЕТ ФУЛФИЛМЕНТА

📖 Технические детали кабинета: См. fulfillment-cabinet-rules.md для компонентов, GraphQL, UI/UX и всех технических деталей реализации

11.1 Основные функции фулфилмента

РОЛЬ В СИСТЕМЕ: Обработка товаров и предоставление услуг

ОСНОВНЫЕ ФУНКЦИИ:

ПРИЕМКА ТОВАРОВ: Получение и обработка поставок от поставщиков
СОЗДАНИЕ ПРОДУКТОВ: Превращение товаров в готовые продукты по рецептурам
ПРЕДОСТАВЛЕНИЕ УСЛУГ: Услуги обработки для селлеров
УПРАВЛЕНИЕ РАСХОДНИКАМИ: Установка цен и контроль наличия
ЛОГИСТИЧЕСКИЕ УСЛУГИ: Маршруты доставки и тарификация

11.2 Workflow фулфилмента

См. детальное описание в workflow-catalog.md#4-workflow-фулфилмента

11.3 Основные разделы кабинета

СТРУКТУРА ДОСТУПА:

Склад - управление товарами по модулям
Поставки - обработка входящих товаров
Услуги - каталог услуг и расходники
Сотрудники - управление персоналом
Статистика - аналитика деятельности

11.4 Правила фулфилмента

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

Установка цен на расходники перед доступностью селлерам
Контроль качества товаров при приемке
Своевременная обработка возвратов
Ведение учета движения товаров
Управление персоналом и рабочим временем

ЗАПРЕЩЕНО:

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

12. 🚚 КАБИНЕТ ЛОГИСТИКИ

12.1 Основные функции логистики

РОЛЬ В СИСТЕМЕ: Управление доставками и транспортировкой

ОСНОВНЫЕ ФУНКЦИИ:

ПОДТВЕРЖДЕНИЕ ДОСТАВКИ: Подтверждение возможности доставки поставок
ТРАНСПОРТИРОВКА: Организация и выполнение доставки товаров
КОНТРОЛЬ МАРШРУТОВ: Управление логистическими маршрутами
ОТСЛЕЖИВАНИЕ: Мониторинг грузов в пути

12.2 Workflow для логистики

См. детальное описание в workflow-catalog.md#5-workflow-логистики

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

ПАРАМЕТРЫ ТАРИФИКАЦИИ:

Тариф до 1м³ - базовая стоимость для малых грузов
Тариф свыше 1м³ - стоимость для крупных грузов
Маршруты доставки - от точки отправления до точки назначения
Описание услуг - дополнительные условия доставки

РАСЧЕТ СТОИМОСТИ:

Автоматический расчет стоимости доставки по объему груза
Отображение примерной стоимости при создании заказа
Учет специфики маршрута и условий доставки

12.4 Управление заявками

РАЗДЕЛЫ КАБИНЕТА ЛОГИСТИКИ:

НОВЫЕ ЗАЯВКИ - поступившие заявки на доставку
В РАБОТЕ - принятые к исполнению заявки
ВЫПОЛНЕННЫЕ - завершенные доставки
ОТКЛОНЕННЫЕ - заявки, которые не могут быть выполнены

ИНФОРМАЦИЯ О ЗАЯВКЕ:

Детали груза (объем, вес, габариты)
Маршрут доставки (откуда - куда)
Срочность доставки
Особые требования к транспортировке
Контактная информация участников

12.5 Правила логистики

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

Своевременное подтверждение заявок
Соблюдение сроков доставки
Бережная транспортировка товаров
Уведомление о статусе доставки

ЗАПРЕЩЕНО:

Принятие заявок без подтверждения возможности выполнения
Нарушение сроков доставки без уведомления
Повреждение товаров при транспортировке

111 KiB Raw Blame History Unescape Escape

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

📚 СТРУКТУРА ДОКУМЕНТАЦИИ

Основные файлы правил:

Когда какой файл читать:

🔴 ПРАВИЛА ВЗАИМОДЕЙСТВИЯ С CLAUDE

Основные принципы работы:

Обязательная последовательность:

🛠️ ПРОТОКОЛЫ РАБОТЫ ПО СЛОЖНОСТИ

Краткий обзор протоколов:

Определение сложности:

🔥 ПРОТОКОЛ ВЫСОКОЙ СЛОЖНОСТИ

❓ СИСТЕМА УТОЧНЕНИЙ

🎨 UI/UX ПРОТОКОЛ

🚨 СИСТЕМА КОНТРОЛЯ КАЧЕСТВА

Принципы контроля:

Обязательные остановки:

Финальная проверка:

⚡ БЫСТРЫЙ СПРАВОЧНИК

🚨 КРИТИЧЕСКИЕ ПРАВИЛА (ОБЯЗАТЕЛЬНЫ К СОБЛЮДЕНИЮ)

🔍 БЫСТРЫЙ ПОИСК ПО ТЕМАМ

🎯 ДЛЯ РАЗНЫХ РОЛЕЙ

🔤 ГЛОССАРИЙ ТЕРМИНОВ

ТИПЫ ПРЕДМЕТОВ:

ТИПЫ ОРГАНИЗАЦИЙ:

2.2 Правила создания предметов по ролям

КЛЮЧЕВЫЕ СУЩНОСТИ:

КОНТЕКСТНО-ЗАВИСИМЫЕ ТЕРМИНЫ:

SupplyOrder - многосторонний документ

Маркет vs Маркетплейс - четкое разделение

📑 ОГЛАВЛЕНИЕ

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

🚚 WORKFLOW И ПРОЦЕССЫ

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

🤝 СИСТЕМА ПАРТНЕРСТВА

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

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

📋 ПРИЛОЖЕНИЯ

🚨 КРИТИЧЕСКИЕ СИТУАЦИИ

📎 ТЕХНИЧЕСКИЕ ПРИЛОЖЕНИЯ

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

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

🏢 ОРГАНИЗАЦИИ И РОЛИ

🤝 СИСТЕМА ПАРТНЕРСТВА

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

1.1 Архитектура системы

1.2 Основные принципы разработки

2. 📦 ТИПИЗАЦИЯ ПРЕДМЕТОВ

2.1 Два реализованных и два планируемых типа предметов

1. ТОВАР (PRODUCT - базовый тип)

2. РАСХОДНИКИ (CONSUMABLE - базовый тип)

3. БРАК (DEFECT - планируется, производная от товара)

4. ПРОДУКТ (FINISHED_PRODUCT - планируется, производная от товара)

2.2 Обязательные поля карточки

3. 🏢 СТРУКТУРА КАБИНЕТОВ

3.1 Общие принципы кабинетов

3.2 Специфические разделы по типам организаций

4. 🔐 СИСТЕМА РОЛЕЙ И ДОСТУПОВ

4.1 Контроль доступа к разделам

4.2 GraphQL проверки доступа

4.3 Контроль доступа к заказам

5. 🚚 WORKFLOW ПОСТАВОК

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

6.1 Пошаговый алгоритм создания продукта

ПРЕДВАРИТЕЛЬНОЕ УСЛОВИЕ: РЕЦЕПТУРА ЗАДАНА (селлер)

ШАГ 1: ПОСТУПЛЕНИЕ НА СКЛАД (автоматически)

ШАГ 2: ПЛАНИРОВАНИЕ РАБОТЫ (менеджер фулфилмента)

ШАГ 3: ОБРАБОТКА ТОВАРА (исполнитель)

ШАГ 4: КОНТРОЛЬ КАЧЕСТВА (менеджер/отдел качества)

ШАГ 5: ЗАВЕРШЕНИЕ (система + менеджер)

6.2 Временные рамки и SLA

6.3 Управление браком и расхождениями

6.4 Детальная рецептура продукта

6.5 Учет план/факт в процессе работы (без брака)

7. 📊 СИСТЕМА УЧЕТА ДВИЖЕНИЯ ТОВАРОВ

7.1 Принципы учета в фулфилменте

7.2 Дополнительные и основные значения

8. 🏠 ОБЩИЕ ПРАВИЛА КАБИНЕТОВ

8.1 Универсальная структура кабинетов

8.1.1 Страница "Главная"

111 KiB

Raw Blame History

1. ТОВАР (`PRODUCT` - базовый тип)

2. РАСХОДНИКИ (`CONSUMABLE` - базовый тип)

3. БРАК (`DEFECT` - планируется, производная от товара)

4. ПРОДУКТ (`FINISHED_PRODUCT` - планируется, производная от товара)