Files

Veronika Smirnova b72ac42173 Создание защищенной резервной копии rules-complete.md

- Создан файл rules-complete-BACKUP.md как полная резервная копия
- Добавлено предупреждение о запрете редактирования без разрешения
- Файл содержит 3636 строк всех бизнес-правил системы
- Резерв создан для защиты от случайных изменений

⚠️ ВАЖНО: Файл rules-complete-BACKUP.md ЗАПРЕЩЕНО редактировать без явного разрешения пользователя\!

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

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

2025-08-08 16:37:51 +03:00

188 KiB

Raw Blame History

🔒 РЕЗЕРВНАЯ КОПИЯ - НЕ РЕДАКТИРОВАТЬ БЕЗ РАЗРЕШЕНИЯ!

🚨 КРИТИЧЕСКИ ВАЖНО: Это РЕЗЕРВНАЯ КОПИЯ файла rules-complete.md

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

📅 Дата создания резерва: 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 ключи в настройках
Использование: "Поставки на маркетплейсы", "Отгрузка на маркетплейсы"

📑 ОГЛАВЛЕНИЕ

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

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 - Статусы поставок

5.1 Детализированная система статусов

Статусы SupplyOrder (Заказ поставки):

PENDING - Ожидает подтверждения поставщиком
SUPPLIER_APPROVED - Одобрено поставщиком
CONFIRMED - Подтвержден (готов к обработке)
LOGISTICS_CONFIRMED - Подтверждено логистикой
SHIPPED - Отгружено поставщиком
IN_TRANSIT - В пути (логистика доставляет)
DELIVERED - Доставлен на фулфилмент
CANCELLED - Отменен

5.2 Пошаговый процесс поставки

ЭТАП 1: Создание заказа

Селлер заказывает товар/расходники у поставщика
Система создает SupplyOrder со статусом PENDING
Автоматическое уведомление поставщику

ЭТАП 2: Обработка поставщиком 4. Поставщик получает оповещение 5. Поставщик нажимает "Одобрить" 6. Статус меняется на SUPPLIER_APPROVED

ЭТАП 3: Передача в фулфилмент 7. Поставка отображается в кабинете фулфилмента 8. Фулфилмент выбирает ответственного и логистику 9. Статус меняется на CONFIRMED

ЭТАП 4: Логистическое подтверждение 10. Логистика подтверждает доставку 11. Статус меняется на LOGISTICS_CONFIRMED

ЭТАП 5: Отгрузка 12. Поставщик отгружает товар 13. Статус меняется на SHIPPED, затем IN_TRANSIT

ЭТАП 6: Доставка и приемка 14. Логистика доставляет на фулфилмент 15. Фулфилмент принимает товар 16. Статус меняется на DELIVERED

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

Обязательные уведомления:

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

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

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

Типы предметов → См. раздел 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: ПОСТАВЩИКИ (адаптивная сетка)

Заголовок: Минималистичный "🏢 Поставщики" без лишних элементов
Поиск: Компактное поле справа "Поиск поставщиков..." (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):

Карточки поставщиков из раздела "Партнеры"
Горизонтальный скролл при превышении ширины
Выбор только одного поставщика одновременно

БЛОК 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. 🏭 КАБИНЕТ ФУЛФИЛМЕНТА

11.1 Общие характеристики кабинета фулфилмента

11.1.1 Принципы доступа

МАКСИМАЛЬНЫЕ ПРАВА: Фулфилмент имеет доступ ко ВСЕМ разделам системы
АДАПТИВНАЯ НАВИГАЦИЯ: Sidebar изменяется в зависимости от user.organization.type === "FULFILLMENT"
ЭКСКЛЮЗИВНЫЕ КОМПОНЕНТЫ: Услуги, Сотрудники, Статистика фулфилмента доступны ТОЛЬКО фулфилменту
СПЕЦИАЛЬНЫЙ РОУТИНГ: При нажатии "Поставки" → /fulfillment-supplies (не /supplies)

11.1.2 Архитектурные особенности

GraphQL проверки: skip: user?.organization?.type !== 'FULFILLMENT' в запросах
Условное отображение: {user?.organization?.type === "FULFILLMENT" && (...)}
Адаптивные отступы: getSidebarMargin() для responsive design
Полинг данных: Статистика обновляется каждую минуту (pollInterval: 60000)

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

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

11.2.1 Структура склада по модулям (ОБЯЗАТЕЛЬНАЯ ПОСЛЕДОВАТЕЛЬНОСТЬ)

📦 ПРОДУКТЫ - готовые к отправке товары
🛒 ТОВАРЫ - базовые товары от поставщиков
- "На складе" - готовы к обработке
- "В обработке" - в процессе создания продукта
❌ БРАК - товары с дефектами, требуют утилизации
↩️ ВОЗВРАТЫ С ПВЗ - возвращенные товары, к обработке
🎯 РАСХОДНИКИ СЕЛЛЕРОВ - материалы для селлеров (тип CONSUMABLE, заказанные селлерами)
⚙️ РАСХОДНИКИ ФУЛФИЛМЕНТА - операционные материалы (тип CONSUMABLE, заказанные фулфилментом, КЛИКАБЕЛЬНЫЙ модуль)

11.2.2 Система учета склада

Дополнительные значения (показатели движения):

ПРИБЫЛО - количество поступивших на склад за период
УБЫЛО - количество списанных со склада за период

Основные значения (текущие остатки):

ФОРМУЛА: Основные значения = Предыдущие остатки + Прибыло - Убыло
ОБНОВЛЕНИЕ: В реальном времени с изменениями за сутки
ИСТОЧНИК: GraphQL query GET_FULFILLMENT_WAREHOUSE_STATS

11.2.3 Структура данных склада (3-уровневая иерархия)

🔵 УРОВЕНЬ 1: МАГАЗИНЫ
├── ТехноМир (синий - blue-400/500)
├── Стиль и Комфорт (розовый - pink-400/500)
└── Зелёный Дом (изумрудный - emerald-400/500)
    ↓
🟢 УРОВЕНЬ 2: ТОВАРЫ (зеленый - green-500)
    ↓
🟠 УРОВЕНЬ 3: ВАРИАНТЫ ТОВАРОВ (оранжевый - orange-500)

Цветовое кодирование:

Каждый уровень имеет цветной индикатор увеличивающегося размера
Цветная левая граница с увеличивающимся отступом и толщиной
Скроллбары в цвете уровня
Контрастный цвет текста для читаемости

11.3 Движение товаров в фулфилменте

Поступление товаров:

ПОСТАВКИ: От поставщиков через систему заказов
ВОЗВРАТЫ: Товары, возвращенные с ПВЗ
ПЕРЕМЕЩЕНИЯ: Между складами и магазинами

Расход товаров:

ОТГРУЗКА: Товары отправлены селлерам
СПИСАНИЕ: Брак, утрата, утилизация
ВОЗВРАТ: Возврат поставщику
ИСПОЛЬЗОВАНИЕ: Расходники для операций

11.4 Модуль "Расходники фулфилмента"

ОСОБЕННОСТИ:

ИНТЕРАКТИВНОСТЬ: Кликабельный элемент в статистике
ФУНКЦИОНАЛЬНОСТЬ: Полноценный раздел учёта
СОДЕРЖАНИЕ: Управление расходниками фулфилмента

11.5 Поставки фулфилмента (`/fulfillment-supplies`)

11.5.1 Структура: 2 основные вкладки

A) 🛒 ПОСТАВКИ ТОВАРОВ:

Детализированные товары ФФ - планы и факты поставок с маршрутами
Товары ФФ - общие поставки товаров от селлеров
Возвраты с ПВЗ - обработка возвращенных товаров

B) 🔧 ПОСТАВКИ РАСХОДНИКОВ:

Заказы расходников - управление заказами от селлеров
Расходники селлеров - материалы для клиентов
Создание поставок - формирование новых поставок расходников

11.5.2 Workflow поставок товаров

Этапы обработки:

Planned - поставка запланирована
In-transit - товар в пути
Delivered - доставлен на склад
Completed - обработка завершена

11.6 Статистика фулфилмента (`/fulfillment-statistics`)

11.6.1 Блоки аналитики (сворачиваемые)

1. НАКОПЛЕННАЯ СТАТИСТИКА (allTime: true):

Обработано товаров (общий объем)
Выявлено брака (всего единиц)
Поставок получено
Общий доход (за все время)
Выполнено заказов (успешных отгрузок)
Удовлетворенность клиентов (средний рейтинг)

2. ОТГРУЗКА НА ПЛОЩАДКИ (marketplaces: true):

Отправлено на Wildberries
Отправлено на Ozon
Отправлено на другие площадки

3. АНАЛИТИКА ПРОИЗВОДИТЕЛЬНОСТИ (performance: false):

Среднее время обработки (на единицу товара)
Уровень брака (от общего объема)
Уровень возвратов (возвраты с площадок)
Удовлетворенность клиентов

11.7 Услуги фулфилмента (`/services`)

11.7.1 Архитектура интеграции с системой

СВЯЗЬ С РЕЦЕПТУРАМИ СЕЛЛЕРОВ:

СЕЛЛЕР (создание поставки)
    └── Рецептура
         ├── Товар (от поставщика)
         ├── Услуги фулфилмента ← CRUD в разделе Услуги
         ├── Расходники селлера
         └── Расходники фулфилмента ← ТОЛЬКО с установленной ценой
                    ↓
ФУЛФИЛМЕНТ (обработка)
    ├── Входящие поставки → Поставки расходников (создание)
    └── Услуги → Расходники (установка цены за единицу)

11.7.2 Структура: 3 обязательные вкладки

A) 🛠️ УСЛУГИ (defaultValue="services"):

Полный CRUD: создание, редактирование, удаление услуг
Поля: name, description, price, imageUrl
Glass Upload Zone: элегантная загрузка изображений
Назначение: каталог услуг для рецептур селлеров
GraphQL: GET_MY_SERVICES, CREATE_SERVICE, UPDATE_SERVICE, DELETE_SERVICE

B) 🚚 ЛОГИСТИКА:

Полный CRUD: маршруты доставки
Поля: откуда → куда, тарификация до/свыше 1м³
Группированные локации:
- Мой фулфилмент (название организации)
- Рынки (предустановленные)
- Склады Wildberries
- Склады Ozon
Glass Upload Zone: для изображений маршрутов
GraphQL: GET_MY_LOGISTICS, CREATE_LOGISTICS, UPDATE_LOGISTICS, DELETE_LOGISTICS

C) 📦 РАСХОДНИКИ (❌ БЕЗ СОЗДАНИЯ):

ТОЛЬКО ПРОСМОТР расходников с фулфилмент-склада
ЕДИНСТВЕННОЕ РЕДАКТИРУЕМОЕ ПОЛЕ: pricePerUnit - цена за единицу для рецептур
UI подсветка: "Цена за 1 {unit}" (например, "Цена за 1 шт")
Автоматическая синхронизация при приеме поставки расходников
Glass Upload Zone: для обновления изображений расходников
GraphQL: GET_MY_SUPPLIES (read-only), UPDATE_SUPPLY_PRICE

11.7.3 Workflow расходников

ШАГ 1 - СОЗДАНИЕ: Только через "Входящие поставки → Поставки расходников фулфилмента"

ШАГ 2 - СИНХРОНИЗАЦИЯ: При приеме на склад → автоматически в Услуги/Расходники

ШАГ 3 - ЦЕНООБРАЗОВАНИЕ: Установка цены за единицу в разделе Услуги

ШАГ 4 - ИСПОЛЬЗОВАНИЕ: Доступны в рецептурах селлеров

11.7.4 Правила видимости в рецептурах

В РЕЦЕПТУРАХ СЕЛЛЕРОВ ПОКАЗЫВАЮТСЯ ТОЛЬКО:

isAvailable = true (есть на skladе)
pricePerUnit != null (цена установлена)

НЕ ПОКАЗЫВАЮТСЯ:

Расходники без цены (pricePerUnit = null)
Удаленные со склада (isAvailable = false)

В РАЗДЕЛЕ УСЛУГИ/РАСХОДНИКИ ВИДНЫ ВСЕ:

С визуальной индикацией состояния (активные/неактивные/без цены)

11.7.5 Разделение цен закупки и продажи

КРИТИЧЕСКОЕ ПРАВИЛО: Расходники фулфилмента имеют ДВЕ РАЗНЫЕ ЦЕНЫ для разных бизнес-процессов:

ЦЕНА ЗАКУПКИ (Supply.price) - цена, по которой фулфилмент купил расходник у поставщика
ЦЕНА ПРОДАЖИ (Supply.pricePerUnit) - цена, по которой фулфилмент продает расходник селлерам

ПОЛЯ В БАЗЕ ДАННЫХ:

model Supply {
  price        Decimal  @db.Decimal(10, 2) // Цена закупки у поставщика (НЕИЗМЕННАЯ)
  pricePerUnit Decimal? @db.Decimal(10, 2) // Цена продажи селлерам (устанавливается фулфилментом)
}

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

РАЗДЕЛ "СКЛАД → РАСХОДНИКИ ФУЛФИЛМЕНТА":

Показывает Supply.price (цена закупки)
Цена ТОЛЬКО ДЛЯ ЧТЕНИЯ, нельзя изменять
Отражает историческую стоимость приобретения

РАЗДЕЛ "УСЛУГИ → РАСХОДНИКИ":

Показывает и редактирует Supply.pricePerUnit (цена продажи)
Единственное место где можно изменить цену для селлеров
Влияет на рецептуры и расчеты для селлеров

БИЗНЕС-ЛОГИКА СОЗДАНИЯ:

ПРИ ПОСТУПЛЕНИИ ОТ ПОСТАВЩИКА:

const supply = await prisma.supply.create({
  data: {
    price: item.price, // Цена поставщика → ЗАФИКСИРОВАНА
    pricePerUnit: null, // Цена продажи → ПУСТАЯ
  },
})

УСТАНОВКА ЦЕНЫ ПРОДАЖИ (в разделе "Услуги"):

const updated = await prisma.supply.update({
  data: {
    pricePerUnit: newPrice, // ТОЛЬКО цена продажи
    // price НЕ ТРОГАЕМ - остается цена закупки
  },
})

11.7.6 Технические требования

GraphQL типы:

# Для рецептур - только доступные с ценой
getAvailableSuppliesForRecipe: [SupplyForRecipe!]!

# В разделе Услуги - все расходники
getMySupplies: [Supply!]!

type Supply {
  pricePerUnit: Float        # Может быть null
  unit: String!              # "шт", "кг", "м"
  isAvailable: Boolean!      # Статус на складе
  warehouseConsumableId: ID! # Связь со складом
}

Экономический учет:

Создание: через поставки расходников
Ценообразование: в разделе Услуги
Списание: со склада при использовании
Стоимость = количество × цена за единицу

11.8 Сотрудники фулфилмента (`/employees`)

11.8.1 Структура: 2 основные вкладки

A) 👥 СОТРУДНИКИ (defaultValue="combined"):

Управление персоналом:

CRUD операции: создание, редактирование, удаление сотрудников
Статусы сотрудников: ACTIVE, VACATION, SICK, FIRED
Формы добавления: Компактная (showCompactForm) / Полная форма
Поиск и фильтрация по имени, должности, статусу

Табель рабочего времени:

Навигация по месяцам: текущий год/месяц с кнопками ←/→
Отметки по дням: статус дня и количество отработанных часов
GraphQL: GET_EMPLOYEE_SCHEDULE, UPDATE_EMPLOYEE_SCHEDULE

B) 📋 ОТЧЕТЫ (value="reports"):

Сводные отчеты по сотрудникам за период
Экспорт данных табеля
Аналитика рабочего времени

11.9 Блок детализации по магазинам

НАЗНАЧЕНИЕ: Распределение товаров по торговым точкам/магазинам

ФУНКЦИИ:

ОСТАТКИ ПО МАГАЗИНАМ: Отображение количества товаров в каждом магазине
УПРАВЛЕНИЕ РАСПРЕДЕЛЕНИЕМ: Перемещение товаров между точками
КОНТРОЛЬ ДВИЖЕНИЯ: Отслеживание перемещений между складами и магазинами
АНАЛИТИКА: Сравнение эффективности разных точек
ПЛАНИРОВАНИЕ: Оптимизация распределения товаров

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

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

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

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

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

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

ЭТАП 1: Получение заявки

Логистика получает уведомление о новой поставке
Заявка появляется в разделе "Заявки" кабинета логистики
Логист изучает детали поставки (объем, вес, маршрут)

ЭТАП 2: Подтверждение доставки

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ЗАПРЕЩЕНО:

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

13. 🤝 СИСТЕМА ПАРТНЕРСТВА И КОНТРАГЕНТОВ

13.1 Основы системы партнерства

ПРИНЦИП РАБОТЫ:

Все типы кабинетов могут создавать партнерские отношения
Партнерство реализовано через таблицы Counterparty и CounterpartyRequest
Двустороннее партнерство: каждая организация видит другую в разделе "Партнеры"

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

WHOLESALE - Поставщики товаров и расходников
FULFILLMENT - Фулфилмент-центры
LOGIST - Логистические компании
SELLER - Селлеры (торговые организации)

13.2 Способы создания партнерства

СПОСОБ 1: Через заказ в маркете (автоматическое партнерство)

WORKFLOW:

Поставщик создает товар → товар попадает в глобальный маркет
Селлер/Фулфилмент находит товар в маркете
Создает заказ (SupplyOrder) → статус PENDING
Поставщик получает уведомление в разделе "Заявки"
Поставщик одобряет заявку → статус SUPPLIER_APPROVED
Автоматически создается двустороннее партнерство:
- Запись в Counterparty для заказчика (organizationId → counterpartyId)
- Обратная запись в Counterparty для поставщика
Обе организации видят друг друга в разделе "Партнеры"

СПОСОБ 2: Через раздел "Партнеры" (заявочная система)

WORKFLOW:

Любая организация идет в раздел "Партнеры"
Использует поиск для нахождения нужной организации
Отправляет заявку на партнерство → создается CounterpartyRequest:
- senderId - отправитель заявки
- receiverId - получатель заявки
- status: PENDING
- message - опциональное сообщение
Получатель видит заявку в разделе "Партнеры" → "Входящие заявки"
Получатель принимает заявку → статус меняется на ACCEPTED
Автоматически создается двустороннее партнерство (аналогично способу 1)

СТАТУСЫ ЗАЯВОК:

PENDING - Ожидает рассмотрения
ACCEPTED - Принята (партнерство создано)
REJECTED - Отклонена
CANCELLED - Отменена отправителем

13.3 Использование партнерства в системе

В форме создания поставки товаров через поставщиков

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

Показываются только партнеры с типом WHOLESALE
Источник: таблица Counterparty where counterparty.type === "WHOLESALE"
Фильтрация по organizationId текущего пользователя

ЛОГИКА РАБОТЫ:

Пользователь выбирает поставщика из dropdown партнеров-поставщиков
Загружается каталог товаров поставщика из Product таблицы
Товары фильтруются по organizationId = поставщик.id
Пользователь может добавлять товары в корзину и создавать заказ

В других разделах системы

ВЫБОР ФУЛФИЛМЕНТ-ЦЕНТРА:

Партнеры с типом FULFILLMENT
Используется при создании поставок расходников

ВЫБОР ЛОГИСТИКИ:

Партнеры с типом LOGIST
Используется при планировании доставок

МЕССЕНДЖЕР:

Общение доступно только между партнерами
Список чатов формируется из таблицы Counterparty

13.4 Технические правила

СОЗДАНИЕ ЗАПИСЕЙ В COUNTERPARTY:

-- При создании партнерства создаются ДВЕ записи
INSERT INTO counterparties (organizationId, counterpartyId) VALUES (org1_id, org2_id);
INSERT INTO counterparties (organizationId, counterpartyId) VALUES (org2_id, org1_id);

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

const isPartner = await prisma.counterparty.findFirst({
  where: {
    organizationId: currentOrgId,
    counterpartyId: targetOrgId,
  },
})

ПОЛУЧЕНИЕ ПАРТНЕРОВ ПО ТИПУ:

const wholesalePartners = await prisma.counterparty.findMany({
  where: {
    organizationId: currentOrgId,
    counterparty: {
      type: 'WHOLESALE',
    },
  },
  include: {
    counterparty: true,
  },
})

13.5 Решение распространенных проблем

ПРОБЛЕМА: GraphQL запрос не возвращает данные партнеров

Симптомы:

В консоли браузера: All counterparties: 0, All counterparties data: []
GraphQL запрос отправляется успешно, но возвращает пустой массив
В базе данных партнеры существуют

Возможные причины и решения:

НЕПРАВИЛЬНОЕ ИМЯ ПОЛЯ В КОДЕ (наиболее частая ошибка):

// ❌ НЕПРАВИЛЬНО
const allCounterparties = counterpartiesData?.getMyCounterparties || []

// ✅ ПРАВИЛЬНО
const allCounterparties = counterpartiesData?.myCounterparties || []

Объяснение: В GraphQL схеме поле называется myCounterparties, а не getMyCounterparties

НЕСООТВЕТСТВИЕ ID ПОЛЬЗОВАТЕЛЯ:
- Проверить что пользователь авторизован под правильным аккаунтом
- Убедиться что context.user.id соответствует ожидаемому пользователю

ПРОБЛЕМЫ С КЕШИРОВАНИЕМ APOLLO CLIENT:

const { data, loading, error } = useQuery(GET_MY_COUNTERPARTIES, {
  fetchPolicy: 'network-only', // Обходим кеш
  errorPolicy: 'all',
})

ОТСУТСТВИЕ ЛОГИРОВАНИЯ В РЕЗОЛВЕРЕ:
- Добавить console.log в GraphQL резолвер для отладки
- Проверить что резолвер вызывается

Чек-лист для диагностики:

Проверить правильность имени поля в коде (myCounterparties)
Убедиться что пользователь авторизован
Проверить логи сервера на вызов резолвера
Добавить отладочное логирование в браузере
Проверить данные в базе через Prisma Studio
Использовать fetchPolicy: 'network-only' для обхода кеша

14. 🌐 ИНТЕГРАЦИИ С СИСТЕМОЙ

14.1 Глобальная интеграция

МАРКЕТ: Товары поставщиков отображаются в глобальном маркете
СИНХРОНИЗАЦИЯ: Данные склада синхронизируются с модулем аналитики
УВЕДОМЛЕНИЯ: Единая система через встроенный мессенджер

14.2 Интеграция с маркетплейсами

WILDBERRIES: Обязательная проверка активности API ключа
СИНХРОНИЗАЦИЯ: Регулярное обновление данных из внешних источников
ЛОКАЛЬНЫЕ КОПИИ: Сохранение данных для офлайн работы

14.3 Интеграция с модулем "Услуги"

РАСХОДНИКИ ФУЛФИЛМЕНТА В УСЛУГАХ:

Расходники фулфилмента - собственность фулфилмента (куплены у поставщиков)
Фулфилмент создает заявки-поставки для покупки расходников у поставщиков
Селлеры могут использовать расходники фулфилмента в разделе "Услуги / Расходники"
Для создания продукта из товара
Расходники списываются с остатков фулфилмента
Стоимость включается в стоимость услуги

WORKFLOW ИСПОЛЬЗОВАНИЯ:

Селлер выбирает услугу "Создание продукта"
Указывает базовый товар
Выбирает необходимые расходники фулфилмента
Фулфилмент обрабатывает заказ и создает продукт
Расходники списываются, создается готовый продукт

15. 📊 СТАТИСТИКА И АНАЛИТИКА

15.1 Структура статистики по кабинетам

В КАБИНЕТЕ ПОСТАВЩИКА:

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

В КАБИНЕТЕ ФУЛФИЛМЕНТА:

ТОВАРЫ: Базовые товары от поставщиков (принятые на склад)
ПРОДУКТЫ: Отдельный блок готовой продукции
БРАК: Статистика потерь и списаний
РАСХОДНИКИ ФУЛФИЛМЕНТА: Операционные материалы фулфилмента
РАСХОДНИКИ СЕЛЛЕРОВ: Материалы для товаров селлеров

15.2 Ключевые метрики

ОБЩИЕ ПОКАЗАТЕЛИ:

Общие остатки, заказано, в пути, остаток, продано
Подсветка предметов с остатками ниже критического уровня

АКТУАЛИЗАЦИЯ ДАННЫХ:

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

16. 📱 ПРАВИЛА UI/UX И ИНТЕРФЕЙСА

16.1 Отзывчивость интерфейса

ОБЯЗАТЕЛЬНО: Интерфейс должен работать на всех устройствах
ПРАВИЛО: Адаптивная сетка для карточек товаров
ФУНКЦИЯ: Оптимизация для мобильных устройств
ТРЕБОВАНИЕ: Корректное отображение на экранах от 320px до 4K

16.2 Обратная связь пользователю

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

16.3 Правила обработки ошибок

ОБЯЗАТЕЛЬНО: Логирование всех ошибок с детальной информацией
ПРАВИЛО: Понятные сообщения об ошибках для пользователя
ФУНКЦИЯ: Автоматическое восстановление после сбоев
МОНИТОРИНГ: Отслеживание критических ошибок в реальном времени

16.4 Производительность

ПРАВИЛО: Пагинация для больших списков товаров
ФУНКЦИЯ: Ленивая загрузка изображений
ОПТИМИЗАЦИЯ: Кэширование часто запрашиваемых данных
ПРОИЗВОДИТЕЛЬНОСТЬ: Время загрузки страницы не более 3 секунд

17. ⚠️ КРИТИЧЕСКИЕ ЗАПРЕТЫ

17.1 НИКОГДА НЕ ДЕЛАТЬ:

❌ Удалять предметы с существующими заказами
❌ Изменять статусы заказов без уведомлений
❌ Обходить проверки остатков предметов
❌ Давать доступ к чужим данным
❌ Игнорировать ошибки валидации
❌ Сохранять пароли в открытом виде
❌ Пропускать логирование критических операций
❌ Блокировать интерфейс без индикации загрузки
❌ Создавать брак или продукт без связи с родительским товаром
❌ Создавать отдельные типы расходников (только общий тип "РАСХОДНИКИ")
❌ Разрешать заказ брака
❌ Нарушать иерархию типов предметов
❌ Пропускать промежуточные статусы в workflow
❌ Нарушать обязательную последовательность модулей в статистике фулфилмента
❌ Использовать неправильные имена полей GraphQL (getMyCounterparties вместо myCounterparties)
❌ Использовать GET_SUPPLY_SUPPLIERS для отображения поставщиков в формах (только партнеры WHOLESALE)
❌ Создавать интерфейсы TypeScript не соответствующие schema.prisma (sku/stock вместо article/quantity)
❌ Использовать общие запросы вместо специализированных (GET_ALL_PRODUCTS вместо GET_ORGANIZATION_PRODUCTS для конкретного поставщика)
❌ Показывать расходники в формах создания поставок товаров (строгая типизация PRODUCT/CONSUMABLE)
❌ Фильтровать предметы по типу на фронтенде (фильтрация должна быть в GraphQL резолвере)
❌ ИСПОЛЬЗОВАТЬ МОКОВЫЕ ДАННЫЕ БЕЗ РАЗРЕШЕНИЯ - все компоненты ОБЯЗАТЕЛЬНО должны использовать реальные GraphQL запросы. Моковые данные можно добавлять ТОЛЬКО с явного разрешения пользователя
❌ ДОБАВЛЯТЬ ПОЛЕ РЫНКА К ТОВАРАМ - рынок принадлежит организации поставщика (Organization.market), товары наследуют рынок через связь с организацией
❌ ПУТАТЬ РЫНОК И МАРКЕТ - РЫНОК = физическое место (Садовод, ТЯК), МАРКЕТ = раздел системы (/market)
❌ ИСПОЛЬЗОВАТЬ НАЗВАНИЯ ОРГАНИЗАЦИЙ В ЛОГИКЕ БЕЗОПАСНОСТИ - проверки доступа только по organization.type и системным ID
❌ СОЗДАВАТЬ УСЛОВИЯ НА ОСНОВЕ ПОЛЬЗОВАТЕЛЬСКИХ СТРОК - никаких if (name.includes()) для определения функционала
❌ ПУТАТЬ ДАННЫЕ И ФУНКЦИОНАЛ - "ОПТ Маркет" (название рынка) ≠ "Маркет" (раздел системы)
❌ ПРЕДСТАВЛЯТЬ ИНТЕРПРЕТАЦИИ КАК ФАКТЫ - всегда четко разделять прямые цитаты из правил и логические выводы
❌ ОТВЕЧАТЬ БЕЗ ССЫЛОК НА ИСТОЧНИКИ - при ссылке на правила всегда указывать номер строки или раздел
❌ ИСПОЛЬЗОВАТЬ КАТЕГОРИЧНЫЕ УТВЕРЖДЕНИЯ БЕЗ ДОКАЗАТЕЛЬСТВ - избегать "ТОЧНО!", "ИМЕННО ТАК!" без прямых цитат

17.2 ОБЯЗАТЕЛЬНЫЕ ПРАВИЛА:

✅ Проверка остатков перед добавлением в корзину
✅ Валидация всех числовых значений (цена > 0, вес > 0)
✅ Автоматическая генерация уникальных артикулов СФ
✅ Логирование всех изменений статусов
✅ Уведомления всех участников при изменении статусов
✅ Обязательная типизация всех предметов
✅ Связь производных типов с родительскими предметами
✅ Проверка доступности товаров перед заказом
✅ Соблюдение жизненного цикла статусов поставок
✅ Фиксация план/факт в процессе создания продукта
✅ УКАЗЫВАТЬ ИСТОЧНИКИ ИНФОРМАЦИИ - при ссылке на правила обязательно указывать строку/раздел
✅ РАЗДЕЛЯТЬ ФАКТЫ И ИНТЕРПРЕТАЦИИ - четко маркировать что взято из правил, а что является выводом
✅ ИСПОЛЬЗОВАТЬ ОСТОРОЖНЫЕ ФОРМУЛИРОВКИ - "согласно правилам", "возможно", "требует уточнения"

17.3 📝 ОБЯЗАТЕЛЬНЫЙ ФОРМАТ ОТВЕТОВ С ФАКТАМИ

При ссылке на правила ОБЯЗАТЕЛЬНО использовать формат:

✅ ПРАВИЛЬНО:

📖 ФАКТ из rules-complete.md (строка 2225): "установка цены за единицу"
🧠 МОЯ ИНТЕРПРЕТАЦИЯ: возможно, это происходит в разделе X
❓ ПРЕДПОЛОЖЕНИЕ: требует уточнения у пользователя
⚠️ НЕ НАЙДЕНО в правилах: информация о точном местоположении

❌ НЕПРАВИЛЬНО:

"Да! Точно понимаю! Фулфилмент устанавливает цены в разделе X!"

ОБЯЗАТЕЛЬНАЯ МАРКИРОВКА:

📖 ФАКТ - прямая цитата из правил с номером строки
🧠 ИНТЕРПРЕТАЦИЯ - мой логический вывод (четко обозначен)
❓ ПРЕДПОЛОЖЕНИЕ - гипотеза, требующая подтверждения
⚠️ НЕ НАЙДЕНО - информация отсутствует в правилах

СТОП-СЛОВА (избегать без доказательств): ❌ "ТОЧНО!", "ИМЕННО ТАК!", "ДА! ПОНИМАЮ!", "АБСОЛЮТНО ВЕРНО!" ✅ "Согласно правилам...", "Не указано, но возможно...", "Требует уточнения"

17.4 🔒 ПРАВИЛА БЕЗОПАСНОСТИ: Разделение данных и функционала

КРИТИЧЕСКОЕ ПРАВИЛО БЕЗОПАСНОСТИ

ПРИНЦИП: Названия организаций, рынков и любые пользовательские данные НИКОГДА не должны влиять на функционал и безопасность системы.

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

✅ ПРАВИЛЬНЫЕ ПРОВЕРКИ:

Проверки доступа ТОЛЬКО по типу организации: organization.type === 'WHOLESALE'
Роутинг ТОЛЬКО по предопределенным путям: /market, /supplies и т.д.
Валидация ТОЛЬКО по ID и системным полям
Фильтрация ТОЛЬКО по enum значениям из схемы

❌ ЗАПРЕЩЕННЫЕ ПРОВЕРКИ (УЯЗВИМОСТИ):

Использование organization.name в условиях доступа
Проверки по organization.market для определения функционала
Любые проверки содержимого строк: includes(), startsWith(), match()
Динамическое создание путей на основе пользовательских данных

ПРИМЕРЫ:

// ❌ УЯЗВИМОСТЬ - название может быть любым
if (organization.name.includes('Маркет')) {
  // предоставить специальный доступ
}

// ❌ УЯЗВИМОСТЬ - пользователь может подделать название
if (organization.market === 'special-market') {
  // изменить цены
}

// ✅ БЕЗОПАСНО - проверка по системному типу
if (organization.type === 'WHOLESALE') {
  // логика для поставщиков
}

// ✅ БЕЗОПАСНО - проверка по ID из whitelist
if (ALLOWED_FULFILLMENT_IDS.includes(organization.id)) {
  // логика для проверенных фулфилментов
}

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

ДАННЫЕ (могут быть любыми):
- Названия организаций: "ОПТ Маркет", "Супер Склад", и т.д.
- Названия рынков: "Садовод", "ТЯК Москва", любые другие
- Любые пользовательские строки
ФУНКЦИОНАЛ (строго определен):
- Системные разделы: /market, /supplies, /partners
- Типы организаций: WHOLESALE, SELLER, FULFILLMENT, LOGIST
- Статусы и enum из Prisma схемы

ПРАВИЛО: Физический рынок "ОПТ Маркет" - это просто строка данных. Раздел "Маркет" (/market) - это системный функционал. Они никак не связаны и не должны влиять друг на друга.

17.5 📦 УПРАВЛЕНИЕ СВЯЗЯМИ ТОВАР-КАРТОЧКА В РЕЦЕПТУРЕ

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

НАЗНАЧЕНИЕ: Связь товара с карточкой маркетплейса - это метаданные для учета, НЕ влияющие на физический состав продукта.

ФОРМУЛА ПРОДУКТА НЕИЗМЕННА:

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

СВЯЗЬ С МП = отдельные метаданные для логистики и учета

17.5.2 UI компонент связи с карточками

РАСПОЛОЖЕНИЕ: В форме создания поставки, в секции каждого товара

ТИП КОМПОНЕНТА: Dropdown с поиском и фильтрацией

ИСТОЧНИК ДАННЫХ: База данных карточек маркетплейсов селлера (GraphQL запрос)

17.5.3 Логика состояний карточек

✅ СВЯЗАНО - карточка уже привязана к этому товару:

Показывать зеленую галочку
Текст: "Название карточки - Связано"
Можно отвязать (сброс в "Без привязки")

⚠️ ДОСТУПНО - карточка свободна для привязки:

Показывать желтый значок предупреждения
Текст: "Название карточки - Доступно"
Можно привязать к текущему товару

❌ ЗАНЯТО - карточка привязана к другому товару:

Показывать красный крестик
Текст: "Название карточки - Занято (товар: 'Название')"
Пункт заблокирован (disabled)
Показывать для информации, но нельзя выбрать

🔍 БЕЗ ПРИВЯЗКИ - товар не связан с карточкой:

Пункт по умолчанию
Показывать серый значок
Текст: "Без привязки к карточке"

17.5.4 Техническая реализация

GraphQL запрос:

query GetSellerCards {
  myMarketplaceCards {
    id
    title
    marketplace
    article
    linkedProductId # null если свободна
    linkedProduct {
      # для отображения занятости
      id
      name
    }
  }
}

Логика фильтрации:

Все карточки селлера показываются в dropdown
Статус определяется по полю linkedProductId
Автосвязка: карточки с похожим названием показываются первыми

Сохранение:

При создании поставки связь сохраняется в поле marketplaceCardId рецептуры
При изменении связи обновляется поле linkedProductId в карточке

17.5.5 UX поведение

ПОИСК В DROPDOWN:

Фильтрация по названию карточки
Фильтрация по артикулу маркетплейса
Автофокус при открытии

ГРУППИРОВКА:

[Dropdown: Выберите карточку Wildberries ▼]
├─ 🔍 БЕЗ ПРИВЯЗКИ
├─ ────── ДОСТУПНЫЕ ──────
├─ ⚠️ "Кроссовки Nike Air" - Доступно
├─ ⚠️ "Футболка Adidas" - Доступно
├─ ────── СВЯЗАННЫЕ ──────
├─ ✅ "Джинсы Levi's" - Связано
├─ ────── ЗАНЯТЫЕ ──────
└─ ❌ "Куртка Puma" - Занято (товар "Верхняя одежда") [disabled]

ВАЛИДАЦИЯ:

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

17.5.6 Интеграция с существующими правилами

СОВМЕСТИМОСТЬ:

Не нарушает существующую логику создания поставок
Дополняет рецептуру метаданными
Совместима с типами поставок (карточки/поставщики)

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

Связь с карточкой - ОПЦИОНАЛЬНА
Товар может существовать без привязки к МП
Карточка может существовать без привязки к товару

ПРИОРИТЕТ РАЗРАБОТКИ: Средний (не блокирует основную функциональность)

18. 🛠️ GRAPHQL И TYPESCRIPT ПРАВИЛА

18.1 Правила именования полей

ВАЖНО: Имена полей в GraphQL запросах должны точно соответствовать схеме!

// ✅ ПРАВИЛЬНО - соответствует схеме
export const GET_MY_COUNTERPARTIES = gql`
  query GetMyCounterparties {
    myCounterparties {  // <- имя поля в схеме
      id
      name
      type
    }
  }
`

// Использование в компоненте
const allCounterparties = counterpartiesData?.myCounterparties || []

// ❌ НЕПРАВИЛЬНО - не соответствует схеме
const allCounterparties = counterpartiesData?.getMyCounterparties || [] // Ошибка!

18.2 Правила отладки GraphQL

При проблемах с GraphQL запросами следовать чек-листу:

Проверить соответствие имен полей схеме
Добавить fetchPolicy: 'network-only' для обхода кеша
Логировать данные в браузере и сервере
Проверить авторизацию пользователя
Убедиться что резолвер вызывается

18.3 Обязательные поля для отладки

const { data, loading, error } = useQuery(QUERY_NAME, {
  fetchPolicy: 'network-only', // Обходим кеш при отладке
  errorPolicy: 'all', // Показываем все ошибки
})

// Логирование для отладки
console.log('Data:', data)
console.log('Loading:', loading)
console.log('Error:', error)

18.4 TypeScript Rules

Интерфейсы данных

Поля интерфейсов должны соответствовать GraphQL схеме:

// ✅ ПРАВИЛЬНО - соответствует schema.prisma
interface GoodsProduct {
  id: string
  name: string
  article: string // <- соответствует полю в schema
  quantity?: number // <- соответствует полю в schema
  organization: {
    id: string
    name: string
  }
}

// ❌ НЕПРАВИЛЬНО - не соответствует schema
interface GoodsProduct {
  sku: string // <- в schema поле называется 'article'
  stock?: number // <- в schema поле называется 'quantity'
}

18.5 Система партнерства в GraphQL

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

Поставщики в формах берутся только из партнеров с типом WHOLESALE
Используется запрос GET_MY_COUNTERPARTIES с фильтрацией по типу
НЕ используется GET_SUPPLY_SUPPLIERS для отображения поставщиков в формах
Партнерство создается двумя способами: через заказ в маркете или через раздел "Партнеры"
Двусторонние записи в таблице Counterparty при создании партнерства

18.6 Архитектурные принципы GraphQL

Создавать специализированные резолверы для каждого контекста использования
Использовать параметризованные запросы (organizationId, type, search) вместо фильтрации на фронтенде
Добавлять подробное логирование в резолверы для отладки (входные параметры, результаты фильтрации)
Типы запросов должны отражать бизнес-логику: organizationProducts для товаров конкретной организации

18.7 Правила РЫНКОВ и МАРКЕТА

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

РЫНОК 🏪 = физическое место (Садовод, ТЯК)
МАРКЕТ 🛒 = раздел системы /market

ПОЛЕ РЫНКА В SCHEMA:

Organization.market ✅ - поставщик принадлежит физическому рынку
Product.market ❌ - ЗАПРЕЩЕНО, товары наследуют рынок от организации
Отображение рынка товаров: через product.organization.market
Фильтрация по рынкам: через organization.market, НЕ через product.market

ЗАПРОСЫ С РЫНКАМИ:

# ✅ ПРАВИЛЬНО - рынок от организации поставщика
query GetProductsWithMarket {
  myProducts {
    id
    name
    organization {
      market # Физический рынок поставщика
    }
  }
}

# ✅ ПРАВИЛЬНО - товары в маркете с информацией о рынке
query GetMarketProducts {
  marketProducts {
    id
    name
    organization {
      market # Рынок поставщика
      name # Название поставщика
    }
  }
}

МАРКЕТ (/market) ПРАВИЛА:

Назначение: Глобальный каталог всех товаров
Фильтрация: По рынкам поставщиков, типам товаров, категориям
Отображение: Показать рынок поставщика в карточках товаров
НЕ путать: МАРКЕТ ≠ конкретный физический рынок
Значения по умолчанию в резолверах для критических параметров (type: args.type || "PRODUCT")
Валидация обязательных параметров на уровне схемы (organizationId: ID!)
Кеширование обходить при проблемах через fetchPolicy: 'network-only'

18.8 GraphQL правила для поля organization в мутациях

18.8.1 Обязательность поля organization

ПРАВИЛО: Все мутации, возвращающие объекты с типом, включающим organization: Organization!, ДОЛЖНЫ запрашивать это поле.

ПРОБЛЕМА: Apollo Client кэш ожидает поле organization в ответе, если оно определено в GraphQL типе как обязательное.

18.8.2 Правильное написание мутаций

❌ НЕПРАВИЛЬНО (вызывает ошибку Apollo Client):

mutation UpdateLogistics($id: ID!, $input: LogisticsInput!) {
  updateLogistics(id: $id, input: $input) {
    success
    logistics {
      id
      fromLocation
      # НЕТ поля organization - ОШИБКА кэша!
    }
  }
}

✅ ПРАВИЛЬНО (работает корректно):

mutation UpdateLogistics($id: ID!, $input: LogisticsInput!) {
  updateLogistics(id: $id, input: $input) {
    success
    logistics {
      id
      fromLocation
      organization {
        # ОБЯЗАТЕЛЬНО включить!
        id
        name
        fullName
      }
    }
  }
}

18.8.3 Чек-лист для мутаций

ОБЯЗАТЕЛЬНАЯ ПРОВЕРКА перед созданием мутации:

✅ Проверить GraphQL тип возвращаемого объекта
✅ Если есть поле organization: Organization! - добавить в запрос
✅ Включить минимальные поля: id, name, fullName
✅ Проверить resolver включает include: { organization: true }

ПРИМЕНЯЕТСЯ К:

CREATE_LOGISTICS ✅ Исправлено
UPDATE_LOGISTICS ✅ Исправлено
CREATE_SERVICE - проверить при разработке
UPDATE_SERVICE - проверить при разработке
Все другие мутации с организационными объектами

ОШИБКА БЕЗ ПОЛЯ: Error converting field "organization" of expected non-nullable type

19. 🔧 АРХИТЕКТУРНЫЕ ПРИНЦИПЫ

19.1 Стандарты разработки

ОБЯЗАТЕЛЬНО: Покрытие тестами критической функциональности
ПРАВИЛО: Следование принципам SOLID
ФУНКЦИЯ: Автоматическое тестирование при развертывании
КАЧЕСТВО: Минимальное покрытие тестами 80%

19.2 Документация

ОБЯЗАТЕЛЬНО: Документирование всех API методов
ПРАВИЛО: Комментарии к сложной бизнес-логике
ФУНКЦИЯ: Автоматическая генерация документации
СТАНДАРТ: Актуальная техническая документация

19.3 Масштабируемость

АРХИТЕКТУРА: Модульная структура для легкого расширения
ПРАВИЛО: Использование индексов для быстрого поиска
ФУНКЦИЯ: Горизонтальное масштабирование при росте нагрузки
ПЛАНИРОВАНИЕ: Готовность к увеличению нагрузки в 10 раз

19.4 Безопасность данных

ОБЯЗАТЕЛЬНО: Шифрование чувствительных данных
ПРАВИЛО: Аудит всех действий пользователей
ФУНКЦИЯ: Контроль доступа на уровне API
БЕЗОПАСНОСТЬ: Двухфакторная аутентификация для критических операций

20. 🎯 ПРАВИЛА КАЧЕСТВА КОДА

20.1 Проверки и валидация

ОБЯЗАТЕЛЬНЫЕ ПРОВЕРКИ:

✅ Типизация предметов: каждый предмет имеет один из типов: ТОВАР (PRODUCT), РАСХОДНИКИ (CONSUMABLE), БРАК и ПРОДУКТ (планируются)
✅ БРАК и ПРОДУКТ имеют обязательную связь с родительским товаром (parentId)
✅ Расходники создаются как универсальный тип, классифицируются при заказе
✅ В формах создания поставок товаров показываются ТОЛЬКО предметы типа ТОВАР (PRODUCT)
✅ В формах создания поставок расходников показываются ТОЛЬКО предметы типа РАСХОДНИКИ (CONSUMABLE)
✅ Фильтрация по типу предмета происходит на уровне GraphQL резолвера, не на фронтенде

20.2 Workflow статусов

✅ Соблюдена последовательность: PENDING → SUPPLIER_APPROVED → CONFIRMED → LOGISTICS_CONFIRMED → SHIPPED → IN_TRANSIT → DELIVERED
✅ Нет пропуска промежуточных статусов
✅ Каждое изменение статуса сопровождается уведомлением

20.3 Правила доступа

✅ Поставщик НЕ может добавлять собственные товары в корзину
✅ Заказ брака ЗАПРЕЩЕН
✅ Только активные предметы отображаются в маркете
✅ Проверка остатков перед добавлением в корзину

21. 🔍 ДИАГНОСТИКА И РЕШЕНИЕ ПРОБЛЕМ

21.1 Правило уточнений

КРИТИЧЕСКИ ВАЖНО: Если я не уверен в выполнении задачи или вижу противоречия в правилах - ОБЯЗАТЕЛЬНО уточнить у пользователя!

21.2 КОГДА УТОЧНЯТЬ:

Недостаточно информации для правильного выполнения
Вижу противоречия между правилами
Задача может нарушить критические правила
Неясно как применить правило в конкретной ситуации
Есть сомнения в интерпретации требований

21.3 КАК УТОЧНЯТЬ:

Четко сформулировать что именно неясно
Указать какие правила/требования конфликтуют
Предложить варианты решения если возможно
Запросить конкретные уточнения

❌ НИКОГДА не делать предположений если есть сомнения!

22. 📋 КАТЕГОРИИ ТОВАРОВ И РАСХОДНИКОВ

22.1 Полный список 28 универсальных категорий товаров

Одежда и обувь
Косметика и парфюмерия
Дом и сад
Детские товары
Спорт и отдых
Электроника
Книги
Здоровье
Автотовары
Строительство и ремонт
Продукты питания
Зоотовары
Дача, сад и огород
Канцелярские товары
Хобби и творчество
Украшения и аксессуары
Сумки и чемоданы
Техника для дома
Музыкальные инструменты
Игры и игрушки
Мебель
Товары для красоты
Бытовая химия
Товары для путешествий
Медицинские товары
Религиозные товары
Антиквариат и коллекционирование
Прочие товары

22.2 12 специализированных категорий расходников

🎁 1. УПАКОВКА И ЗАЩИТА

Коробки (различных размеров)
Пакеты (полиэтиленовые, бумажные, фирменные)
Пузырчатая пленка, воздушные подушки
Стрейч-пленка, гофрокартон
Паллетная пленка, защитные уголки

🏷️ 2. МАРКИРОВКА И ИДЕНТИФИКАЦИЯ

Этикетки (адресные, штрих-код, QR-код)
Бирки (ценники, размерники)
Стикеры и наклейки
Маркеры и ручки
Штампы и печати, термоэтикетки

🔧 3. КРЕПЕЖ И СОЕДИНЕНИЕ

Скотч (прозрачный, цветной, армированный)
Клей и клеевые составы
Стяжки пластиковые
Степлер и скобы
Веревки и шнуры, стрейч-лента

📄 4. ДОКУМЕНТООБОРОТ И ВКЛАДЫШИ

Накладные и сопроводительные документы
Инструкции по эксплуатации
Гарантийные талоны
Рекламные буклеты, визитки и флаеры
Благодарственные письма, купоны и промокоды

🧼 5. ГИГИЕНА И БЕЗОПАСНОСТЬ

Перчатки (латексные, нитриловые)
Маски и респираторы
Антисептики и дезинфекторы
Салфетки и тряпки
Фартуки и халаты, бахилы

🛠️ 6. ИНСТРУМЕНТЫ И ПРИСПОСОБЛЕНИЯ

Ножи и резаки, ножницы
Линейки и рулетки
Упаковочные машины (ленточные)
Дозаторы скотча
Пистолеты для термоклея
Весы и мерная тара

🎨 7. БРЕНДИНГ И ДИЗАЙН

Фирменные пакеты с логотипом
Брендированные коробки
Цветная упаковочная бумага
Ленты и банты
Наклейки с логотипом компании
Подарочная упаковка

⚡ 8. СПЕЦИАЛИЗИРОВАННЫЕ МАТЕРИАЛЫ

Антистатические пакеты
Влагопоглотители
Температурные индикаторы
Хрупкие наклейки
Пломбы и пломбировочные материалы
Защита от краж (магнитные датчики)

🏪 9. ТОРГОВОЕ ОБОРУДОВАНИЕ

Манекены и вешалки
Ценникодержатели
Подставки и стойки
Корзины и тележки
Зеркала примерочные
Освещение витрин

🚚 10. ЛОГИСТИКА И СКЛАДИРОВАНИЕ

Паллеты и поддоны
Контейнеры и ящики
Стеллажные системы
Погрузочные ремни
Защитные чехлы
Адресные ярлыки для груза

💻 11. ТЕХНИЧЕСКИЕ РАСХОДНИКИ

Картриджи для принтеров
Термоголовки, красящие ленты
Батарейки для сканеров
Чистящие средства для техники
Запчасти для упаковочного оборудования

🎪 12. СЕЗОННЫЕ И ПРАЗДНИЧНЫЕ

Новогодняя упаковка
Подарочные мешки
Праздничные ленты
Тематические наклейки
Открытки и поздравления
Сезонная упаковочная бумага

ПРИМЕЧАНИЕ: Данные категории являются рекомендательными и могут быть адаптированы под специфику конкретного поставщика расходников.

23. 🎖️ ПРИОРИТЕТЫ РАЗРАБОТКИ

23.1 ВЫСОКИЙ ПРИОРИТЕТ:

🔴 Безопасность и контроль доступа
🔴 Целостность данных и валидация
🔴 Корректность статусов поставок
🔴 Уведомления участников процесса
🔴 Правильная типизация предметов
🔴 Связи между товарами и производными типами

23.2 СРЕДНИЙ ПРИОРИТЕТ:

🟡 Производительность и оптимизация
🟡 Пользовательский опыт
🟡 Аналитика и отчетность
🟡 Интеграции с внешними системами
🟡 Workflow для брака и продуктов
🟡 Разделение расходников по типам

23.3 НИЗКИЙ ПРИОРИТЕТ:

🟢 Дополнительные фильтры
🟢 Косметические улучшения
🟢 Экспериментальные функции
🟢 Расширенная кастомизация

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

🔴 Отмена заказов на разных этапах workflow

PENDING → Отмена разрешена

Действие: Удаление заказа без последствий
Уведомления: Поставщику о отмене
Влияние на статистику: Нет

SUPPLIER_APPROVED → Отмена с согласия поставщика

Действие: Требуется подтверждение поставщика
Штрафы: Возможны согласно договору
Восстановление: Товары возвращаются в доступные остатки

CONFIRMED/LOGISTICS_CONFIRMED → Отмена критическая

Действие: Требуется согласие всех участников
Штрафы: Логистические расходы
Альтернатива: Изменение адреса доставки

SHIPPED/IN_TRANSIT → Отмена невозможна

Действие: Только возврат после получения
Процедура: Через модуль "Возвраты с ПВЗ"

🔄 Частичная доставка товаров

Сценарий: Поставщик доставил 80 из 100 заказанных единиц

Алгоритм обработки:

Фулфилмент фиксирует фактическое количество
Система создает два отдельных документа:
- DELIVERED (80 единиц) - обрабатывается обычным порядком
- PARTIAL_DELIVERED (20 единиц) - остается в статусе ожидания
Селлер получает уведомление о частичной поставке
Принятие решения: ждать остаток или отменить недопоставку

📊 Превышение лимитов остатков

Проблема: Попытка заказать больше чем есть у поставщика

Техническая реализация:

if (requestedQuantity > availableStock) {
  throw new GraphQLError(`Недостаточно товара. Доступно: ${availableStock}, запрошено: ${requestedQuantity}`)
}

UX решение: Real-time валидация в формах заказа

🔍 Дубликаты артикулов

Сценарий: Поставщик пытается создать товар с существующим артикулом

Проверка на уровне БД:

UNIQUE INDEX ON products(article, organization_id)

Обработка: Автоматическое добавление суффикса или предложение изменить артикул

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

Приложение A: GraphQL запросы фулфилмента

// Основные запросы
GET_MY_SERVICES // Услуги фулфилмента
GET_MY_LOGISTICS // Логистические маршруты
GET_MY_EMPLOYEES // Сотрудники организации
GET_FULFILLMENT_WAREHOUSE_STATS // Статистика склада
GET_WAREHOUSE_PRODUCTS // Товары на складе
GET_MY_FULFILLMENT_SUPPLIES // Расходники фулфилмента
GET_EMPLOYEE_SCHEDULE // Табель рабочего времени

// Мутации
;(CREATE_SERVICE, UPDATE_SERVICE, DELETE_SERVICE)
;(CREATE_LOGISTICS, UPDATE_LOGISTICS, DELETE_LOGISTICS)
;(CREATE_EMPLOYEE, UPDATE_EMPLOYEE, DELETE_EMPLOYEE)
UPDATE_EMPLOYEE_SCHEDULE // Обновление табеля

Приложение B: Компоненты фулфилмента

// Основные dashboard компоненты
FulfillmentWarehouseDashboard // Склад фулфилмента
FulfillmentStatisticsDashboard // Статистика
ServicesDashboard // Услуги (3 вкладки)
EmployeesDashboard // Сотрудники
SuppliesDashboard // Поставки фулфилмента

// Специализированные компоненты
;(ServicesTab, LogisticsTab, SuppliesTab) // Вкладки услуг
;(EmployeeInlineForm, EmployeeEditInlineForm) // Формы сотрудников
;(FulfillmentSuppliesTab, FulfillmentConsumablesOrdersTab) // Поставки

Приложение C: Специальный роутинг для типов организаций

const handleSuppliesClick = () => {
  switch (user?.organization?.type) {
    case 'FULFILLMENT':
      router.push('/fulfillment-supplies') // Специальный роут
      break
    case 'SELLER':
      router.push('/supplies')
      break
    case 'WHOLESALE':
      router.push('/wholesale-supplies')
      break
    case 'LOGIST':
      router.push('/logist-supplies')
      break
  }
}

Эта база знаний создана путем объединения rules-unified.md (v3.0) и fulfillment-cabinet-rules.md (v1.0) с устранением всех несоответствий и добавлением критически важных улучшений: быстрый справочник, глоссарий терминов, детальные алгоритмы процессов, edge cases.

Версия: 10.1
Дата создания: 2025
Статус: ЕДИНЫЙ ИСТОЧНИК ИСТИНЫ - ГОТОВ К РАЗРАБОТКЕ

🚀 УЛУЧШЕНИЯ v6.0:

⚡ Быстрый справочник критических правил
🔤 Полный глоссарий терминов с определениями
🎯 Навигация по ролям (разработчики, аналитики, менеджеры)
🔄 Детальный алгоритм создания продукта с временными рамками
🚨 Раздел критических ситуаций и Edge Cases
📌 Связующие блоки между разделами
📊 Таблицы SLA и временных рамок

🔧 ИСПРАВЛЕНИЯ v6.1:

✅ Устранено противоречие в моменте создания БРАКА
✅ Исправлена логическая цепочка: рецептура задается селлером ДО процесса
✅ Реалистичные временные рамки SLA (рабочие дни вместо часов)
✅ Унифицирована классификация расходников (по назначению при использовании)
✅ Согласованы все алгоритмы и процессы между разделами

🔧 ОБНОВЛЕНИЯ v6.3:

✅ ДОБАВЛЕН КРИТИЧЕСКИЙ ЗАПРЕТ: Использование моковых данных в продакшене
✅ ОБНОВЛЕН ЧЕКЛИСТ: Добавлена проверка на отсутствие mock данных
✅ РЕАЛИЗАЦИЯ: Полная очистка моковых данных из раздела "Мои поставки" селлера

🎨 ИНТЕГРАЦИЯ v6.2:

✅ Синхронизация с visual-design-rules.md v1.1
✅ Добавлены визуальные правила для 8 статусов поставок
✅ Создана цветовая система для 6 модулей фулфилмента
✅ Визуальный workflow процесса создания продукта
✅ Перекрестные ссылки между техническими и визуальными правилами
✅ Покрытие визуальными решениями увеличено с 40% до 85%

🚀 КОНСОЛИДАЦИЯ v7.0:

✅ Интеграция development-checklist.md и CLAUDE.md
✅ Удаление дублирующих файлов
✅ Создание единого источника истины

🔧 ПОЛНАЯ ИНТЕГРАЦИЯ v8.0:

✅ Интеграция work-protocols.md (детальные протоколы по сложности)
✅ Интеграция violation-prevention-protocol.md (СТОП-сигналы и триггеры)
✅ Интеграция self-validation.md (расширенная система самопроверки)
✅ Удаление всех дублирующих файлов протоколов

🎯 ОПТИМИЗАЦИЯ UI/UX v8.1:

✅ Добавлен ТРИГГЕР #3 для автоматической активации visual-design-rules.md
✅ Интегрирован специальный UI/UX протокол в чеклист
✅ Создана система перекрестных ссылок с visual-design-rules.md
✅ visual-design-rules.md остается отдельным специализированным файлом

📊 ИНТЕГРАЦИЯ DESCRIPTION v9.0:

✅ Добавлена UI структура создания поставки расходников (3 блока)
✅ Интегрирована концепция многоуровневых таблиц
✅ Добавлен механизм учета ПЛАН/ФАКТ в процессе создания продукта
✅ Расширена детализация рецептуры продукта
✅ Добавлена опция места хранения готовых продуктов

🔧 УТОЧНЕНИЯ ЛОГИКИ v9.1:

✅ Уточнен статус брака: НЕ РЕАЛИЗОВАНО (еще не дошли до этого этапа)
✅ Добавлены четкие правила создания предметов по ролям
✅ Добавлен экономический учет расходников фулфилмента для селлера
✅ Обновлен механизм ПЛАН/ФАКТ: потери вместо брака при пересчете
✅ Добавлена заметка о будущей детализации статусов товаров

🎨 UI УЛУЧШЕНИЯ v9.2:

✅ Добавлены детальные правила горизонтального скролла для блока поставщиков
✅ Реализован горизонтальный скролл в create-suppliers-supply-page.tsx
✅ Добавлена адаптивность (десктоп 280px, планшет 260px, мобильный 240px)
✅ Интегрированы ARIA атрибуты для доступности
✅ Реализовано автоскрытие полосы прокрутки и навигация клавиатурой

🔒 БЕЗОПАСНОСТЬ И ТЕРМИНОЛОГИЯ v10.0:

✅ ДОБАВЛЕН РАЗДЕЛ 17.3: Правила безопасности - разделение данных и функционала
✅ НОВЫЕ ЗАПРЕТЫ 24-26: Запрет использования пользовательских данных в логике безопасности
✅ РАСШИРЕН ГЛОССАРИЙ: Контекстно-зависимые термины для SupplyOrder
✅ УТОЧНЕНИЕ ТЕРМИНОВ: Четкое разделение "Маркет" (раздел) vs "Маркетплейс" (внешние площадки)
✅ ПРИМЕРЫ УЯЗВИМОСТЕЙ: Конкретные примеры безопасного и небезопасного кода

📝 КАЧЕСТВО ОТВЕТОВ v10.1:

✅ НОВЫЕ ЗАПРЕТЫ 27-29: Запрет представления интерпретаций как фактов
✅ ОБЯЗАТЕЛЬНЫЙ ФОРМАТ ОТВЕТОВ 17.3: Четкое разделение фактов, интерпретаций и предположений
✅ СИСТЕМА МАРКИРОВКИ: 📖 ФАКТ, 🧠 ИНТЕРПРЕТАЦИЯ, ❓ ПРЕДПОЛОЖЕНИЕ, ⚠️ НЕ НАЙДЕНО
✅ СТОП-СЛОВА: Список категоричных утверждений для избегания без доказательств
✅ ОБЯЗАТЕЛЬНЫЕ ПРАВИЛА 11-13: Указание источников и осторожные формулировки

188 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 ПОСТАВОК

5.1 Детализированная система статусов

5.2 Пошаговый процесс поставки

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

188 KiB

Raw Blame History

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

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

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

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