docs: обновление rules-complete.md v10.0 - безопасность и терминология

- Добавлен раздел 17.3: Правила безопасности - разделение данных и функционала
- Новые критические запреты 24-26: запрет использования пользовательских данных в логике
- Расширен глоссарий: контекстно-зависимые термины для SupplyOrder
- Уточнена терминология: четкое разделение "Маркет" vs "Маркетплейс"
- Добавлены примеры безопасного и уязвимого кода

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Veronika Smirnova
2025-08-07 11:50:02 +03:00
parent 10af6f08cc
commit cd7dcd9333

View File

@ -5,12 +5,15 @@
## 🔴 ПРОТОКОЛЫ РАБОТЫ CLAUDE CODE ## 🔴 ПРОТОКОЛЫ РАБОТЫ CLAUDE CODE
### ⛔ ЖЕСТКИЙ ПРОТОКОЛ - ОБЯЗАТЕЛЬНОЕ ИСПОЛНЕНИЕ ### ⛔ ЖЕСТКИЙ ПРОТОКОЛ - ОБЯЗАТЕЛЬНОЕ ИСПОЛНЕНИЕ
**Я НЕ МОГУ выполнять НИКАКИХ изменений в коде без предварительного чтения этого файла** **Я НЕ МОГУ выполнять НИКАКИХ изменений в коде без предварительного чтения этого файла**
**КОМАНДА ОСТАНОВКИ**: "СТОП - ЧИТАЙ ПРАВИЛА" - немедленно останавливает любую работу **КОМАНДА ОСТАНОВКИ**: "СТОП - ЧИТАЙ ПРАВИЛА" - немедленно останавливает любую работу
### 📋 ОБЯЗАТЕЛЬНЫЙ ЧЕК-ЛИСТ ПЕРЕД КАЖДОЙ ЗАДАЧЕЙ ### 📋 ОБЯЗАТЕЛЬНЫЙ ЧЕК-ЛИСТ ПЕРЕД КАЖДОЙ ЗАДАЧЕЙ
**КАЖДЫЙ ОТВЕТ ДОЛЖЕН НАЧИНАТЬСЯ С:** **КАЖДЫЙ ОТВЕТ ДОЛЖЕН НАЧИНАТЬСЯ С:**
``` ```
## 📋 Чек-лист соответствия правилам: ## 📋 Чек-лист соответствия правилам:
- ✅ Прочитал rules-complete.md - ✅ Прочитал rules-complete.md
@ -19,16 +22,20 @@
- ✅ [ЕСЛИ UI/UX ЗАДАЧА] Прочитал visual-design-rules.md - ✅ [ЕСЛИ UI/UX ЗАДАЧА] Прочитал visual-design-rules.md
- ✅ Готов выполнять согласно единому источнику истины - ✅ Готов выполнять согласно единому источнику истины
``` ```
**БЕЗ ЭТОГО ЧЕК-ЛИСТА = НИКАКИХ ДЕЙСТВИЙ** **БЕЗ ЭТОГО ЧЕК-ЛИСТА = НИКАКИХ ДЕЙСТВИЙ**
### 🔄 ДВУХЭТАПНЫЙ ПРОЦЕСС РАБОТЫ ### 🔄 ДВУХЭТАПНЫЙ ПРОЦЕСС РАБОТЫ
#### **ЭТАП 1: ПЛАНИРОВАНИЕ (ОБЯЗАТЕЛЬНЫЙ)** #### **ЭТАП 1: ПЛАНИРОВАНИЕ (ОБЯЗАТЕЛЬНЫЙ)**
- Прочитать этот файл правил - Прочитать этот файл правил
- Создать детальный план действий - Создать детальный план действий
- Указать какие правила будут применены - Указать какие правила будут применены
- **ОСТАНОВИТЬСЯ И ЖДАТЬ ОДОБРЕНИЯ ПЛАНА** - **ОСТАНОВИТЬСЯ И ЖДАТЬ ОДОБРЕНИЯ ПЛАНА**
#### **ЭТАП 2: ВЫПОЛНЕНИЕ (ТОЛЬКО ПОСЛЕ ОДОБРЕНИЯ)** #### **ЭТАП 2: ВЫПОЛНЕНИЕ (ТОЛЬКО ПОСЛЕ ОДОБРЕНИЯ)**
- Получить одобрение плана от пользователя - Получить одобрение плана от пользователя
- Следовать ТОЛЬКО одобренному плану - Следовать ТОЛЬКО одобренному плану
- Использовать TodoWrite для отслеживания прогресса - Использовать TodoWrite для отслеживания прогресса
@ -40,6 +47,7 @@
### 🎯 ПРОТОКОЛ ДЛЯ ЗАДАЧ СРЕДНЕЙ СЛОЖНОСТИ ### 🎯 ПРОТОКОЛ ДЛЯ ЗАДАЧ СРЕДНЕЙ СЛОЖНОСТИ
**ОПРЕДЕЛЕНИЕ СРЕДНЕЙ СЛОЖНОСТИ:** **ОПРЕДЕЛЕНИЕ СРЕДНЕЙ СЛОЖНОСТИ:**
- Работа с 2-3 файлами - Работа с 2-3 файлами
- Изменение логики в 1-2 модулях - Изменение логики в 1-2 модулях
- Добавление новых функций без изменения архитектуры - Добавление новых функций без изменения архитектуры
@ -48,6 +56,7 @@
**ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:** **ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:**
#### 1. 🔍 **ЭТАП АНАЛИЗА** (STOP & THINK) #### 1. 🔍 **ЭТАП АНАЛИЗА** (STOP & THINK)
``` ```
ПЕРЕД НАЧАЛОМ ЗАДАТЬ СЕБЕ: ПЕРЕД НАЧАЛОМ ЗАДАТЬ СЕБЕ:
□ Какие файлы нужно изучить? (перечислить ВСЕ) □ Какие файлы нужно изучить? (перечислить ВСЕ)
@ -58,6 +67,7 @@
``` ```
#### 2. 📋 **СОЗДАНИЕ ПЛАНА** #### 2. 📋 **СОЗДАНИЕ ПЛАНА**
``` ```
□ Разбить задачу на подзадачи (не более 5) □ Разбить задачу на подзадачи (не более 5)
□ Определить порядок выполнения □ Определить порядок выполнения
@ -66,6 +76,7 @@
``` ```
#### 3. 🔄 **ВЫПОЛНЕНИЕ С ПРОВЕРКАМИ** #### 3. 🔄 **ВЫПОЛНЕНИЕ С ПРОВЕРКАМИ**
``` ```
ПОСЛЕ КАЖДОГО ШАГА: ПОСЛЕ КАЖДОГО ШАГА:
□ Соответствует ли результат правилам из этого документа? □ Соответствует ли результат правилам из этого документа?
@ -77,6 +88,7 @@
### 🔥 ПРОТОКОЛ ДЛЯ ЗАДАЧ ВЫСОКОЙ СЛОЖНОСТИ ### 🔥 ПРОТОКОЛ ДЛЯ ЗАДАЧ ВЫСОКОЙ СЛОЖНОСТИ
**ОПРЕДЕЛЕНИЕ ВЫСОКОЙ СЛОЖНОСТИ:** **ОПРЕДЕЛЕНИЕ ВЫСОКОЙ СЛОЖНОСТИ:**
- Работа с 4+ файлами - Работа с 4+ файлами
- Изменение архитектуры системы - Изменение архитектуры системы
- Создание новых модулей/компонентов - Создание новых модулей/компонентов
@ -86,6 +98,7 @@
**ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:** **ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:**
#### 1. 🛑 **СТОП! ГЛУБОКИЙ АНАЛИЗ** #### 1. 🛑 **СТОП! ГЛУБОКИЙ АНАЛИЗ**
``` ```
ОБЯЗАТЕЛЬНЫЕ ВОПРОСЫ ПОЛЬЗОВАТЕЛЮ: ОБЯЗАТЕЛЬНЫЕ ВОПРОСЫ ПОЛЬЗОВАТЕЛЮ:
□ Уточнить ВСЕ требования и ожидания □ Уточнить ВСЕ требования и ожидания
@ -95,6 +108,7 @@
``` ```
#### 2. 🔍 **ИССЛЕДОВАТЕЛЬСКАЯ ФАЗА** #### 2. 🔍 **ИССЛЕДОВАТЕЛЬСКАЯ ФАЗА**
``` ```
□ Изучить ВСЕ связанные файлы параллельно □ Изучить ВСЕ связанные файлы параллельно
□ Построить карту зависимостей □ Построить карту зависимостей
@ -104,6 +118,7 @@
``` ```
#### 3. 📊 **СОЗДАНИЕ ДЕТАЛЬНОГО ПЛАНА** #### 3. 📊 **СОЗДАНИЕ ДЕТАЛЬНОГО ПЛАНА**
``` ```
□ Разбить на этапы с промежуточными проверками □ Разбить на этапы с промежуточными проверками
□ Определить точки возврата (rollback points) □ Определить точки возврата (rollback points)
@ -114,6 +129,7 @@
### ❓ СИСТЕМА ОБЯЗАТЕЛЬНЫХ УТОЧНЕНИЙ ### ❓ СИСТЕМА ОБЯЗАТЕЛЬНЫХ УТОЧНЕНИЙ
#### 🔴 **КРИТИЧЕСКИЕ СИТУАЦИИ** (ОБЯЗАТЕЛЬНО): #### 🔴 **КРИТИЧЕСКИЕ СИТУАЦИИ** (ОБЯЗАТЕЛЬНО):
- Обнаружил противоречие в правилах - Обнаружил противоречие в правилах
- Задача может нарушить архитектуру системы - Задача может нарушить архитектуру системы
- Неясно как применить правило к конкретной ситуации - Неясно как применить правило к конкретной ситуации
@ -121,6 +137,7 @@
- Изменения затрагивают критические бизнес-процессы - Изменения затрагивают критические бизнес-процессы
#### 🟡 **ВАЖНЫЕ СИТУАЦИИ** (РЕКОМЕНДУЕТСЯ): #### 🟡 **ВАЖНЫЕ СИТУАЦИИ** (РЕКОМЕНДУЕТСЯ):
- Задача требует создания новых типов данных - Задача требует создания новых типов данных
- Нужно изменить существующий workflow - Нужно изменить существующий workflow
- Есть сомнения в интерпретации требований - Есть сомнения в интерпретации требований
@ -128,6 +145,7 @@
- Требуется интеграция с внешними системами - Требуется интеграция с внешними системами
**ФОРМАТ УТОЧНЯЮЩИХ ВОПРОСОВ:** **ФОРМАТ УТОЧНЯЮЩИХ ВОПРОСОВ:**
``` ```
🎯 КОНТЕКСТ: Что именно я делаю 🎯 КОНТЕКСТ: Что именно я делаю
❓ ВОПРОС: Что конкретно неясно ❓ ВОПРОС: Что конкретно неясно
@ -143,6 +161,7 @@
**ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:** **ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:**
#### 1. 📖 **ИЗУЧЕНИЕ ВИЗУАЛЬНЫХ ПРАВИЛ** #### 1. 📖 **ИЗУЧЕНИЕ ВИЗУАЛЬНЫХ ПРАВИЛ**
``` ```
ОБЯЗАТЕЛЬНО: ОБЯЗАТЕЛЬНО:
□ Прочитать visual-design-rules.md □ Прочитать visual-design-rules.md
@ -152,6 +171,7 @@
``` ```
#### 2. 🎯 **ПРИМЕНЕНИЕ ДИЗАЙН-СИСТЕМЫ** #### 2. 🎯 **ПРИМЕНЕНИЕ ДИЗАЙН-СИСТЕМЫ**
``` ```
ПРОВЕРИТЬ: ПРОВЕРИТЬ:
□ Соответствие цветовой палитре (OKLCH) □ Соответствие цветовой палитре (OKLCH)
@ -162,6 +182,7 @@
``` ```
#### 3. ✅ **ВАЛИДАЦИЯ ДИЗАЙНА** #### 3. ✅ **ВАЛИДАЦИЯ ДИЗАЙНА**
``` ```
УБЕДИТЬСЯ: УБЕДИТЬСЯ:
□ Соблюдены принципы иерархии □ Соблюдены принципы иерархии
@ -175,6 +196,7 @@
### 🛑 ОБЯЗАТЕЛЬНЫЕ ОСТАНОВКИ ПЕРЕД ДЕЙСТВИЯМИ ### 🛑 ОБЯЗАТЕЛЬНЫЕ ОСТАНОВКИ ПЕРЕД ДЕЙСТВИЯМИ
#### **СТОП-СИГНАЛ #1: ПЕРЕД ЛЮБЫМ АНАЛИЗОМ КОМПОНЕНТОВ** #### **СТОП-СИГНАЛ #1: ПЕРЕД ЛЮБЫМ АНАЛИЗОМ КОМПОНЕНТОВ**
``` ```
❌ ЗАПРЕЩЕНО: Делать предположения о содержании файлов/компонентов ❌ ЗАПРЕЩЕНО: Делать предположения о содержании файлов/компонентов
✅ ОБЯЗАТЕЛЬНО: ✅ ОБЯЗАТЕЛЬНО:
@ -184,6 +206,7 @@
``` ```
#### **СТОП-СИГНАЛ #2: ПРИ НЕОПРЕДЕЛЕННОСТИ** #### **СТОП-СИГНАЛ #2: ПРИ НЕОПРЕДЕЛЕННОСТИ**
``` ```
❌ ЗАПРЕЩЕНО: Гадать, предполагать, домысливать ❌ ЗАПРЕЩЕНО: Гадать, предполагать, домысливать
✅ ОБЯЗАТЕЛЬНО: ✅ ОБЯЗАТЕЛЬНО:
@ -193,6 +216,7 @@
``` ```
#### **СТОП-СИГНАЛ #3: ПЕРЕД ВЫПОЛНЕНИЕМ СРЕДНИХ/СЛОЖНЫХ ЗАДАЧ** #### **СТОП-СИГНАЛ #3: ПЕРЕД ВЫПОЛНЕНИЕМ СРЕДНИХ/СЛОЖНЫХ ЗАДАЧ**
``` ```
❌ ЗАПРЕЩЕНО: Сразу приступать к работе ❌ ЗАПРЕЩЕНО: Сразу приступать к работе
✅ ОБЯЗАТЕЛЬНО: ✅ ОБЯЗАТЕЛЬНО:
@ -204,6 +228,7 @@
### 🔒 СИСТЕМА ПРИНУДИТЕЛЬНЫХ ПРОВЕРОК ### 🔒 СИСТЕМА ПРИНУДИТЕЛЬНЫХ ПРОВЕРОК
#### **ПРОВЕРКА #1: АНАЛИЗ КОДА** #### **ПРОВЕРКА #1: АНАЛИЗ КОДА**
``` ```
Если задача включает анализ компонентов: Если задача включает анализ компонентов:
□ Использовал ли поиск по кодовой базе? □ Использовал ли поиск по кодовой базе?
@ -212,6 +237,7 @@
``` ```
#### **ПРОВЕРКА #2: СОБЛЮДЕНИЕ ПРОТОКОЛОВ** #### **ПРОВЕРКА #2: СОБЛЮДЕНИЕ ПРОТОКОЛОВ**
``` ```
Для каждой задачи: Для каждой задачи:
□ Определил ли сложность задачи? □ Определил ли сложность задачи?
@ -223,14 +249,17 @@
### ⚡ СИСТЕМА АВТОМАТИЧЕСКИХ ТРИГГЕРОВ ### ⚡ СИСТЕМА АВТОМАТИЧЕСКИХ ТРИГГЕРОВ
#### **ТРИГГЕР #1: При упоминании компонентов** #### **ТРИГГЕР #1: При упоминании компонентов**
- Ключевые слова: "компонент", "файл", "содержание", "показывает" - Ключевые слова: "компонент", "файл", "содержание", "показывает"
- Действие: ОБЯЗАТЕЛЬНО использовать инструменты анализа кода - Действие: ОБЯЗАТЕЛЬНО использовать инструменты анализа кода
#### **ТРИГГЕР #2: При неопределенности** #### **ТРИГГЕР #2: При неопределенности**
- Ключевые фразы: "возможно", "вероятно", "думаю", "предполагаю" - Ключевые фразы: "возможно", "вероятно", "думаю", "предполагаю"
- Действие: СТОП + вопрос пользователю - Действие: СТОП + вопрос пользователю
#### **ТРИГГЕР #3: При работе с UI/UX** #### **ТРИГГЕР #3: При работе с UI/UX**
- Ключевые слова: "дизайн", "интерфейс", "компонент", "стили", "UI", "UX", "визуал", "цвет", "кнопка", "форма", "карточка" - Ключевые слова: "дизайн", "интерфейс", "компонент", "стили", "UI", "UX", "визуал", "цвет", "кнопка", "форма", "карточка"
- Действие: ОБЯЗАТЕЛЬНО прочитать visual-design-rules.md перед началом работы - Действие: ОБЯЗАТЕЛЬНО прочитать visual-design-rules.md перед началом работы
@ -250,6 +279,7 @@
### 🛑 ОБЯЗАТЕЛЬНЫЙ ПРОТОКОЛ ПЕРЕД КАЖДОЙ ЗАДАЧЕЙ ### 🛑 ОБЯЗАТЕЛЬНЫЙ ПРОТОКОЛ ПЕРЕД КАЖДОЙ ЗАДАЧЕЙ
#### **ШАГ 1: ОПРЕДЕЛЕНИЕ СЛОЖНОСТИ И ПРОТОКОЛА** #### **ШАГ 1: ОПРЕДЕЛЕНИЕ СЛОЖНОСТИ И ПРОТОКОЛА**
``` ```
ВОПРОСЫ: ВОПРОСЫ:
- Сколько файлов затрагивает задача? (1-3 = средняя, 4+ = высокая) - Сколько файлов затрагивает задача? (1-3 = средняя, 4+ = высокая)
@ -260,6 +290,7 @@
``` ```
#### **ШАГ 2: ЭТАП "СТОП И ПОДУМАЙ"** #### **ШАГ 2: ЭТАП "СТОП И ПОДУМАЙ"**
``` ```
ОБЯЗАТЕЛЬНЫЕ ВОПРОСЫ: ОБЯЗАТЕЛЬНЫЕ ВОПРОСЫ:
- Какие правила из этого документа применимы? - Какие правила из этого документа применимы?
@ -281,6 +312,7 @@
``` ```
### 📈 МЕТРИКИ УСПЕХА ### 📈 МЕТРИКИ УСПЕХА
``` ```
ЦЕЛЬ: 0 пропущенных критических деталей ЦЕЛЬ: 0 пропущенных критических деталей
@ -303,7 +335,7 @@
### 🔍 БЫСТРЫЙ ПОИСК ПО ТЕМАМ ### 🔍 БЫСТРЫЙ ПОИСК ПО ТЕМАМ
| Тема | Раздел | Ключевые понятия | | Тема | Раздел | Ключевые понятия |
|------|--------|------------------| | ----------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------- |
| **Типы предметов** | [2](#2--типизация-предметов) | PRODUCT, CONSUMABLE, DEFECT, FINISHED_PRODUCT | | **Типы предметов** | [2](#2--типизация-предметов) | PRODUCT, CONSUMABLE, DEFECT, FINISHED_PRODUCT |
| **Кабинет фулфилмента** | [11](#11--кабинет-фулфилмента-полная-документация) | Склад, Услуги, Сотрудники, 6 модулей | | **Кабинет фулфилмента** | [11](#11--кабинет-фулфилмента-полная-документация) | Склад, Услуги, Сотрудники, 6 модулей |
| **Workflow поставок** | [5](#5--workflow-поставок) | 8 статусов, уведомления, логистика | | **Workflow поставок** | [5](#5--workflow-поставок) | 8 статусов, уведомления, логистика |
@ -321,15 +353,18 @@
--- ---
## 🔤 ГЛОССАРИЙ ТЕРМИНОВ ## 🔤 ГЛОССАРИЙ ТЕРМИНОВ
> Для людей → `В коде` > Для людей → `В коде`
### **ТИПЫ ПРЕДМЕТОВ:** ### **ТИПЫ ПРЕДМЕТОВ:**
- **ТОВАР** → `PRODUCT` - базовый товар от поставщика, может стать продуктом или браком - **ТОВАР** → `PRODUCT` - базовый товар от поставщика, может стать продуктом или браком
- **РАСХОДНИКИ** → `CONSUMABLE` - материалы, классифицируются по назначению при использовании (операционные/производственные) - **РАСХОДНИКИ** → `CONSUMABLE` - материалы, классифицируются по назначению при использовании (операционные/производственные)
- **БРАК** → `DEFECT` *(НЕ РЕАЛИЗОВАНО)* - функционал брака еще не внедрен в систему - **БРАК** → `DEFECT` _(НЕ РЕАЛИЗОВАНО)_ - функционал брака еще не внедрен в систему
- **ПРОДУКТ** → `FINISHED_PRODUCT` *(планируется)* - готовый товар, создается из товара по рецептуре - **ПРОДУКТ** → `FINISHED_PRODUCT` _(планируется)_ - готовый товар, создается из товара по рецептуре
### **ТИПЫ ОРГАНИЗАЦИЙ:** ### **ТИПЫ ОРГАНИЗАЦИЙ:**
- **ПОСТАВЩИК** → `WHOLESALE` - создает товары и расходники, обрабатывает заказы - **ПОСТАВЩИК** → `WHOLESALE` - создает товары и расходники, обрабатывает заказы
- **СЕЛЛЕР** → `SELLER` - заказывает товары, создает поставки на маркетплейсы - **СЕЛЛЕР** → `SELLER` - заказывает товары, создает поставки на маркетплейсы
- **ФУЛФИЛМЕНТ** → `FULFILLMENT` - обрабатывает товары, создает продукты, максимальные права - **ФУЛФИЛМЕНТ** → `FULFILLMENT` - обрабатывает товары, создает продукты, максимальные права
@ -338,11 +373,13 @@
### 2.2 Правила создания предметов по ролям ### 2.2 Правила создания предметов по ролям
**КТО МОЖЕТ СОЗДАВАТЬ:** **КТО МОЖЕТ СОЗДАВАТЬ:**
- **ПОСТАВЩИК** (`WHOLESALE`): Товары (`PRODUCT`) и Расходники (`CONSUMABLE`) - **ПОСТАВЩИК** (`WHOLESALE`): Товары (`PRODUCT`) и Расходники (`CONSUMABLE`)
- **ФУЛФИЛМЕНТ** (`FULFILLMENT`): Продукты (`FINISHED_PRODUCT`) - только из существующих товаров - **ФУЛФИЛМЕНТ** (`FULFILLMENT`): Продукты (`FINISHED_PRODUCT`) - только из существующих товаров
- **СЕЛЛЕР/ЛОГИСТ**: НЕ МОГУТ создавать предметы - **СЕЛЛЕР/ЛОГИСТ**: НЕ МОГУТ создавать предметы
**КТО МОЖЕТ ПОКУПАТЬ:** **КТО МОЖЕТ ПОКУПАТЬ:**
- **СЕЛЛЕР** (`SELLER`): - **СЕЛЛЕР** (`SELLER`):
- Товары и расходники у поставщиков - Товары и расходники у поставщиков
- Расходники фулфилмента у фулфилмента (через рецептуру в поставке) - Расходники фулфилмента у фулфилмента (через рецептуру в поставке)
@ -350,20 +387,73 @@
- **ПОСТАВЩИК/ЛОГИСТ**: НЕ МОГУТ покупать предметы - **ПОСТАВЩИК/ЛОГИСТ**: НЕ МОГУТ покупать предметы
**ЭКОНОМИЧЕСКИЙ УЧЕТ:** **ЭКОНОМИЧЕСКИЙ УЧЕТ:**
- Когда селлер выбирает расходники фулфилмента в рецептуре, это формирует экономические данные: - Когда селлер выбирает расходники фулфилмента в рецептуре, это формирует экономические данные:
- В кабинете селлера: расход на расходники фулфилмента - В кабинете селлера: расход на расходники фулфилмента
- В кабинете фулфилмента: доход от продажи расходников селлеру - В кабинете фулфилмента: доход от продажи расходников селлеру
### **КЛЮЧЕВЫЕ СУЩНОСТИ:** ### **КЛЮЧЕВЫЕ СУЩНОСТИ:**
- **Контрагент** → `Counterparty` - связь между организациями для партнерства - **Контрагент** → `Counterparty` - связь между организациями для партнерства
- **Поставка** → `SupplyOrder` - заказ товаров/расходников с workflow статусами - **Поставка** → `SupplyOrder` - заказ товаров/расходников с workflow статусами
- **Рецептура** - состав продукта: товар + услуги + расходники (задается селлером) - **Рецептура** - состав продукта: товар + услуги + расходники (задается селлером)
### **КОНТЕКСТНО-ЗАВИСИМЫЕ ТЕРМИНЫ:**
#### **SupplyOrder - многосторонний документ**
SupplyOrder представляет собой единый документ, который видится по-разному каждым участником процесса:
**ДЛЯ СОЗДАТЕЛЕЙ (Селлер/Фулфилмент):**
- **Термин**: "Поставка"
- **Контекст**: Они создают поставку товаров и расходников на фулфилмент
- **Включает**: Весь процесс от закупки до приемки на склад
**ДЛЯ ПОСТАВЩИКА (исполнитель товарной части):**
- **Термин**: "Заявка на покупку"
- **Контекст**: Получают запрос на продажу своих товаров/расходников
- **Действия**: Могут одобрить или отклонить в зависимости от наличия
**ДЛЯ ЛОГИСТИКИ (исполнитель транспортной части):**
- **Термин**: "Заявка на доставку"
- **Контекст**: Получают запрос на транспортировку груза
- **Действия**: Могут подтвердить или отклонить в зависимости от возможностей
**ОТОБРАЖЕНИЕ В ИНТЕРФЕЙСЕ КАБИНЕТОВ:**
| Кабинет | Название раздела | Обоснование |
|---------|-----------------|-------------|
| Селлер | "Мои поставки" | Создает и управляет поставками |
| Поставщик | "Заявки на покупку" | Обрабатывает входящие заявки |
| Логистика | "Заявки на доставку" | Управляет транспортировкой |
| Фулфилмент | "Входящие поставки" | Принимает поставки на склад |
**ВАЖНО**: Это один и тот же объект SupplyOrder в базе данных, но каждый участник работает со своей стороной процесса.
#### **Маркет vs Маркетплейс - четкое разделение**
**МАРКЕТ** (`/market`):
- **Что это**: Внутренний раздел системы
- **Функция**: Глобальный каталог всех товаров от всех поставщиков
- **Доступ**: Для всех типов организаций в системе
- **НЕ путать**: С названиями физических рынков типа "ОПТ Маркет"
**МАРКЕТПЛЕЙС** (Wildberries, Ozon):
- **Что это**: Внешние торговые площадки
- **Функция**: Конечные точки продаж для селлеров
- **Интеграция**: Через API ключи в настройках
- **Использование**: "Поставки на маркетплейсы", "Отгрузка на маркетплейсы"
--- ---
## 📑 ОГЛАВЛЕНИЕ ## 📑 ОГЛАВЛЕНИЕ
> 📋 **ЧТО ОБЪЕДИНЕНО**: > 📋 **ЧТО ОБЪЕДИНЕНО**:
>
> - rules-unified.md (v3.0) - общая база знаний системы > - rules-unified.md (v3.0) - общая база знаний системы
> - fulfillment-cabinet-rules.md (v1.0) - детализация кабинета фулфилмента > - fulfillment-cabinet-rules.md (v1.0) - детализация кабинета фулфилмента
> - Устранены все несоответствия в терминах, последовательностях и детализации > - Устранены все несоответствия в терминах, последовательностях и детализации
@ -427,18 +517,18 @@
### 📦 **ОСНОВНЫЕ ПРЕДМЕТЫ** ### 📦 **ОСНОВНЫЕ ПРЕДМЕТЫ**
| Сущность | Название в системе | Кабинет создания | Описание | Статус | | Сущность | Название в системе | Кабинет создания | Описание | Статус |
| ---------- | ---------------------------------- | ---------------- | ----------------------------------------------- | --------------- | | ---------- | -------------------------------------- | ---------------- | ----------------------------------------------- | -------------- |
| Товар | `Product` (type: `PRODUCT`) | Поставщик | Базовый тип товара от поставщика | ✅ Реализовано | | Товар | `Product` (type: `PRODUCT`) | Поставщик | Базовый тип товара от поставщика | ✅ Реализовано |
| Расходники | `Product` (type: `CONSUMABLE`) | Поставщик | Материалы и вспомогательные товары | ✅ Реализовано | | Расходники | `Product` (type: `CONSUMABLE`) | Поставщик | Материалы и вспомогательные товары | ✅ Реализовано |
| Брак | `Product` (type: `DEFECT`)* | Фулфилмент | Производная от товара с дефектами | 📋 Планируется | | Брак | `Product` (type: `DEFECT`)\* | Фулфилмент | Производная от товара с дефектами | 📋 Планируется |
| Продукт | `Product` (type: `FINISHED_PRODUCT`)* | Фулфилмент | Готовый к продаже товар (производная от товара) | 📋 Планируется | | Продукт | `Product` (type: `FINISHED_PRODUCT`)\* | Фулфилмент | Готовый к продаже товар (производная от товара) | 📋 Планируется |
> **\* Планируется**: Типы `DEFECT` и `FINISHED_PRODUCT` еще не добавлены в Prisma схему > **\* Планируется**: Типы `DEFECT` и `FINISHED_PRODUCT` еще не добавлены в Prisma схему
### 🏢 **ОРГАНИЗАЦИИ И РОЛИ** ### 🏢 **ОРГАНИЗАЦИИ И РОЛИ**
| Сущность | Название в системе | Основные функции | Статус | | Сущность | Название в системе | Основные функции | Статус |
| ---------- | ---------------------------------- | --------------------------------------- | -------------- | | ---------- | ------------------------------------ | --------------------------------------- | -------------- |
| Поставщик | `Organization` (type: `WHOLESALE`) | Создание товаров, управление поставками | ✅ Реализовано | | Поставщик | `Organization` (type: `WHOLESALE`) | Создание товаров, управление поставками | ✅ Реализовано |
| Селлер | `Organization` (type: `SELLER`) | Заказ товаров, управление поставками | ✅ Реализовано | | Селлер | `Organization` (type: `SELLER`) | Заказ товаров, управление поставками | ✅ Реализовано |
| Фулфилмент | `Organization` (type: `FULFILLMENT`) | Обработка товаров, управление складом | ✅ Реализовано | | Фулфилмент | `Organization` (type: `FULFILLMENT`) | Обработка товаров, управление складом | ✅ Реализовано |
@ -447,7 +537,7 @@
### 🤝 **СИСТЕМА ПАРТНЕРСТВА** ### 🤝 **СИСТЕМА ПАРТНЕРСТВА**
| Сущность | Название в системе | Описание | Статус | | Сущность | Название в системе | Описание | Статус |
| ------------ | ------------------ | ---------------------------------- | -------------- | | ---------- | --------------------- | ------------------------- | -------------- |
| Контрагент | `Counterparty` | Связь между организациями | ✅ Реализовано | | Контрагент | `Counterparty` | Связь между организациями | ✅ Реализовано |
| Заявка | `CounterpartyRequest` | Запрос на сотрудничество | ✅ Реализовано | | Заявка | `CounterpartyRequest` | Запрос на сотрудничество | ✅ Реализовано |
@ -460,10 +550,12 @@
**СТРУКТУРА СИСТЕМЫ ПО КАБИНЕТАМ:** **СТРУКТУРА СИСТЕМЫ ПО КАБИНЕТАМ:**
**🏢 КАБИНЕТ ПОСТАВЩИКА** - создает и управляет: **🏢 КАБИНЕТ ПОСТАВЩИКА** - создает и управляет:
- **ТОВАР** (`PRODUCT`) - базовые товары от поставщика - **ТОВАР** (`PRODUCT`) - базовые товары от поставщика
- **РАСХОДНИКИ** (`CONSUMABLE`) - материалы и вспомогательные товары от поставщика - **РАСХОДНИКИ** (`CONSUMABLE`) - материалы и вспомогательные товары от поставщика
**🏭 КАБИНЕТ ФУЛФИЛМЕНТА** - принимает, обрабатывает и управляет всеми типами: **🏭 КАБИНЕТ ФУЛФИЛМЕНТА** - принимает, обрабатывает и управляет всеми типами:
- **ТОВАР** (`PRODUCT`) - базовые товары от поставщиков (принятые на склад) - **ТОВАР** (`PRODUCT`) - базовые товары от поставщиков (принятые на склад)
- **БРАК** (`DEFECT` - планируется) - производная от товара (товар с дефектами) - **БРАК** (`DEFECT` - планируется) - производная от товара (товар с дефектами)
- **ПРОДУКТ** (`FINISHED_PRODUCT` - планируется) - готовый к продаже товар - **ПРОДУКТ** (`FINISHED_PRODUCT` - планируется) - готовый к продаже товар
@ -472,6 +564,7 @@
- **"Производственные расходники"** - используются в рецептурах селлеров для создания продуктов - **"Производственные расходники"** - используются в рецептурах селлеров для создания продуктов
**🛍️ КАБИНЕТ СЕЛЛЕРА** - заказывает и управляет поставками: **🛍️ КАБИНЕТ СЕЛЛЕРА** - заказывает и управляет поставками:
- Создает заказы товаров и расходников - Создает заказы товаров и расходников
- Управляет поставками на фулфилмент и маркетплейсы - Управляет поставками на фулфилмент и маркетплейсы
- Отслеживает статусы поставок - Отслеживает статусы поставок
@ -557,14 +650,17 @@
### 3.2 Специфические разделы по типам организаций ### 3.2 Специфические разделы по типам организаций
**🏪 ПОСТАВЩИК (`WHOLESALE`):** **🏪 ПОСТАВЩИК (`WHOLESALE`):**
- Склад (`/warehouse`) - управление товарами и расходниками - Склад (`/warehouse`) - управление товарами и расходниками
- Поставки (`/supplies`) - обработка заказов от селлеров - Поставки (`/supplies`) - обработка заказов от селлеров
**🛍️ СЕЛЛЕР (`SELLER`):** **🛍️ СЕЛЛЕР (`SELLER`):**
- Мои поставки (`/supplies`) - управление заказами товаров - Мои поставки (`/supplies`) - управление заказами товаров
- WB Интеграция (`/wb-integration`) - связь с Wildberries - WB Интеграция (`/wb-integration`) - связь с Wildberries
**🏭 ФУЛФИЛМЕНТ (`FULFILLMENT`):** **🏭 ФУЛФИЛМЕНТ (`FULFILLMENT`):**
- Склад фулфилмента (`/fulfillment-warehouse`) - управление всеми типами товаров - Склад фулфилмента (`/fulfillment-warehouse`) - управление всеми типами товаров
- Поставки фулфилмента (`/fulfillment-supplies`) - обработка поставок - Поставки фулфилмента (`/fulfillment-supplies`) - обработка поставок
- Услуги (`/services`) - управление услугами, логистикой, расходниками - Услуги (`/services`) - управление услугами, логистикой, расходниками
@ -572,6 +668,7 @@
- Статистика фулфилмента (`/fulfillment-statistics`) - детальная аналитика - Статистика фулфилмента (`/fulfillment-statistics`) - детальная аналитика
**🚚 ЛОГИСТИКА (`LOGIST`):** **🚚 ЛОГИСТИКА (`LOGIST`):**
- Заявки (`/logistics-requests`) - управление заявками на доставку - Заявки (`/logistics-requests`) - управление заявками на доставку
- Маршруты (`/routes`) - планирование маршрутов - Маршруты (`/routes`) - планирование маршрутов
@ -594,15 +691,15 @@
```typescript ```typescript
const handleSuppliesClick = () => { const handleSuppliesClick = () => {
switch (user?.organization?.type) { switch (user?.organization?.type) {
case "FULFILLMENT": case 'FULFILLMENT':
router.push("/fulfillment-supplies"); router.push('/fulfillment-supplies')
break; break
case "SELLER": case 'SELLER':
router.push("/supplies"); router.push('/supplies')
break; break
// ... другие типы // ... другие типы
} }
}; }
``` ```
### 4.2 GraphQL проверки доступа ### 4.2 GraphQL проверки доступа
@ -611,15 +708,15 @@ const handleSuppliesClick = () => {
```typescript ```typescript
const { data } = useQuery(GET_MY_SERVICES, { const { data } = useQuery(GET_MY_SERVICES, {
skip: user?.organization?.type !== "FULFILLMENT", skip: user?.organization?.type !== 'FULFILLMENT',
}); })
``` ```
**В GraphQL резолверах:** **В GraphQL резолверах:**
```typescript ```typescript
if (currentUser.organization.type !== "FULFILLMENT") { if (currentUser.organization.type !== 'FULFILLMENT') {
throw new GraphQLError("Доступно только для фулфилмент центров"); throw new GraphQLError('Доступно только для фулфилмент центров')
} }
``` ```
@ -652,36 +749,25 @@ if (currentUser.organization.type !== "FULFILLMENT") {
### 5.2 Пошаговый процесс поставки ### 5.2 Пошаговый процесс поставки
**ЭТАП 1: Создание заказа** **ЭТАП 1: Создание заказа**
1. Селлер заказывает товар/расходники у поставщика 1. Селлер заказывает товар/расходники у поставщика
2. Система создает SupplyOrder со статусом `PENDING` 2. Система создает SupplyOrder со статусом `PENDING`
3. Автоматическое уведомление поставщику 3. Автоматическое уведомление поставщику
**ЭТАП 2: Обработка поставщиком** **ЭТАП 2: Обработка поставщиком** 4. Поставщик получает оповещение 5. Поставщик нажимает "Одобрить" 6. Статус меняется на `SUPPLIER_APPROVED`
4. Поставщик получает оповещение
5. Поставщик нажимает "Одобрить"
6. Статус меняется на `SUPPLIER_APPROVED`
**ЭТАП 3: Передача в фулфилмент** **ЭТАП 3: Передача в фулфилмент** 7. Поставка отображается в кабинете фулфилмента 8. Фулфилмент выбирает ответственного и логистику 9. Статус меняется на `CONFIRMED`
7. Поставка отображается в кабинете фулфилмента
8. Фулфилмент выбирает ответственного и логистику
9. Статус меняется на `CONFIRMED`
**ЭТАП 4: Логистическое подтверждение** **ЭТАП 4: Логистическое подтверждение** 10. Логистика подтверждает доставку 11. Статус меняется на `LOGISTICS_CONFIRMED`
10. Логистика подтверждает доставку
11. Статус меняется на `LOGISTICS_CONFIRMED`
**ЭТАП 5: Отгрузка** **ЭТАП 5: Отгрузка** 12. Поставщик отгружает товар 13. Статус меняется на `SHIPPED`, затем `IN_TRANSIT`
12. Поставщик отгружает товар
13. Статус меняется на `SHIPPED`, затем `IN_TRANSIT`
**ЭТАП 6: Доставка и приемка** **ЭТАП 6: Доставка и приемка** 14. Логистика доставляет на фулфилмент 15. Фулфилмент принимает товар 16. Статус меняется на `DELIVERED`
14. Логистика доставляет на фулфилмент
15. Фулфилмент принимает товар
16. Статус меняется на `DELIVERED`
### 5.3 Система уведомлений ### 5.3 Система уведомлений
**Обязательные уведомления:** **Обязательные уведомления:**
- Поставщику: о новом заказе - Поставщику: о новом заказе
- Фулфилменту: о подтвержденной поставке - Фулфилменту: о подтвержденной поставке
- Логистике: о назначении на заявку - Логистике: о назначении на заявку
@ -692,6 +778,7 @@ if (currentUser.organization.type !== "FULFILLMENT") {
## 6. 🔄 ПРОЦЕСС СОЗДАНИЯ ПРОДУКТА ## 6. 🔄 ПРОЦЕСС СОЗДАНИЯ ПРОДУКТА
> 📌 **СВЯЗАННЫЕ РАЗДЕЛЫ**: > 📌 **СВЯЗАННЫЕ РАЗДЕЛЫ**:
>
> - Типы предметов → См. [раздел 2.2](#22-обязательные-поля-карточки) > - Типы предметов → См. [раздел 2.2](#22-обязательные-поля-карточки)
> - Склад фулфилмента → См. [раздел 11.2](#112-структура-раздела-склад-фулфилмента) > - Склад фулфилмента → См. [раздел 11.2](#112-структура-раздела-склад-фулфилмента)
> - Статистика движения → См. [раздел 7](#7--система-учета-движения-товаров) > - Статистика движения → См. [раздел 7](#7--система-учета-движения-товаров)
@ -701,6 +788,7 @@ if (currentUser.organization.type !== "FULFILLMENT") {
> 📌 **ВИЗУАЛЬНЫЕ ПРАВИЛА**: См. [visual-design-rules.md - Процесс создания продукта](#143-процесс-создания-продукта---визуальный-workflow) > 📌 **ВИЗУАЛЬНЫЕ ПРАВИЛА**: См. [visual-design-rules.md - Процесс создания продукта](#143-процесс-создания-продукта---визуальный-workflow)
#### **ПРЕДВАРИТЕЛЬНОЕ УСЛОВИЕ: РЕЦЕПТУРА ЗАДАНА** (селлер) #### **ПРЕДВАРИТЕЛЬНОЕ УСЛОВИЕ: РЕЦЕПТУРА ЗАДАНА** (селлер)
``` ```
Время: при создании заявки на поставку Время: при создании заявки на поставку
Действие: селлер указывает рецептуру продукта Действие: селлер указывает рецептуру продукта
@ -712,6 +800,7 @@ if (currentUser.organization.type !== "FULFILLMENT") {
``` ```
#### **ШАГ 1: ПОСТУПЛЕНИЕ НА СКЛАД** (автоматически) #### **ШАГ 1: ПОСТУПЛЕНИЕ НА СКЛАД** (автоматически)
``` ```
Время: при смене статуса поставки DELIVERED Время: при смене статуса поставки DELIVERED
Действие: товар переходит в статус "на складе" Действие: товар переходит в статус "на складе"
@ -720,6 +809,7 @@ if (currentUser.organization.type !== "FULFILLMENT") {
``` ```
#### **ШАГ 2: ПЛАНИРОВАНИЕ РАБОТЫ** (менеджер фулфилмента) #### **ШАГ 2: ПЛАНИРОВАНИЕ РАБОТЫ** (менеджер фулфилмента)
``` ```
Время: в течение 2 рабочих дней после поступления Время: в течение 2 рабочих дней после поступления
Действие: назначение параметров обработки Действие: назначение параметров обработки
@ -735,6 +825,7 @@ if (currentUser.organization.type !== "FULFILLMENT") {
``` ```
#### **ШАГ 3: ОБРАБОТКА ТОВАРА** (исполнитель) #### **ШАГ 3: ОБРАБОТКА ТОВАРА** (исполнитель)
``` ```
Время: согласно дедлайну (обычно 1-3 дня) Время: согласно дедлайну (обычно 1-3 дня)
Действие: физическая обработка товара Действие: физическая обработка товара
@ -758,6 +849,7 @@ if (currentUser.organization.type !== "FULFILLMENT") {
``` ```
#### **ШАГ 4: КОНТРОЛЬ КАЧЕСТВА** (менеджер/отдел качества) #### **ШАГ 4: КОНТРОЛЬ КАЧЕСТВА** (менеджер/отдел качества)
``` ```
Время: сразу после завершения ШАГ 3 Время: сразу после завершения ШАГ 3
Действие: приемка готовой продукции Действие: приемка готовой продукции
@ -771,6 +863,7 @@ if (currentUser.organization.type !== "FULFILLMENT") {
``` ```
#### **ШАГ 5: ЗАВЕРШЕНИЕ** (система + менеджер) #### **ШАГ 5: ЗАВЕРШЕНИЕ** (система + менеджер)
``` ```
Время: после успешного прохождения контроля качества Время: после успешного прохождения контроля качества
Действие: финализация процесса Действие: финализация процесса
@ -788,7 +881,7 @@ if (currentUser.organization.type !== "FULFILLMENT") {
### 6.2 Временные рамки и SLA ### 6.2 Временные рамки и SLA
| Этап | Стандартное время | Максимальное время | Ответственный | | Этап | Стандартное время | Максимальное время | Ответственный |
|------|------------------|-------------------|---------------| | ----------------- | ----------------- | ------------------ | -------------- |
| Планирование | 1 рабочий день | 2 рабочих дня | Менеджер ФФ | | Планирование | 1 рабочий день | 2 рабочих дня | Менеджер ФФ |
| Обработка | 2-3 рабочих дня | 5 рабочих дней | Исполнитель | | Обработка | 2-3 рабочих дня | 5 рабочих дней | Исполнитель |
| Контроль качества | 4 часа | 1 рабочий день | Отдел качества | | Контроль качества | 4 часа | 1 рабочий день | Отдел качества |
@ -833,11 +926,13 @@ if (currentUser.organization.type !== "FULFILLMENT") {
**ФАКТ**: Реальное количество после пересчета (работник фулфилмента производит сортировку при пересчете) **ФАКТ**: Реальное количество после пересчета (работник фулфилмента производит сортировку при пересчете)
**ФИКСАЦИЯ ПОТЕРЬ:** **ФИКСАЦИЯ ПОТЕРЬ:**
- **КОГДА**: В процессе работы (вкладка "В работе") - **КОГДА**: В процессе работы (вкладка "В работе")
- **ЧТО**: Недостача, повреждения (без создания записей брака) - **ЧТО**: Недостача, повреждения (без создания записей брака)
- **КАК**: Корректировка количества в статистике - **КАК**: Корректировка количества в статистике
**WORKFLOW СОЗДАНИЯ ПРОДУКТА:** **WORKFLOW СОЗДАНИЯ ПРОДУКТА:**
1. Товар поступает на склад фулфилмента (статус "на складе") 1. Товар поступает на склад фулфилмента (статус "на складе")
2. Товар берется в работу (переход в статус "в обработке") 2. Товар берется в работу (переход в статус "в обработке")
3. Исполнитель производит пересчет и сортировку 3. Исполнитель производит пересчет и сортировку
@ -845,10 +940,11 @@ if (currentUser.organization.type !== "FULFILLMENT") {
5. Продукт готов к отправке на маркетплейсы 5. Продукт готов к отправке на маркетплейсы
**ВЛИЯНИЕ НА СТАТИСТИКУ:** **ВЛИЯНИЕ НА СТАТИСТИКУ:**
- При принятии поставки: +План в статистику - При принятии поставки: +План в статистику
- При выявлении факта: корректировка на реальные данные - При выявлении факта: корректировка на реальные данные
- **ФОРМУЛА**: Факт = Потери + Хороший товар - **ФОРМУЛА**: Факт = Потери + Хороший товар
*Где потери - это недостача/повреждения, выявленные при пересчете и сортировке* _Где потери - это недостача/повреждения, выявленные при пересчете и сортировке_
- **ЛОГИКА**: Фактическое количество = сумма всех пересчитанных предметов - **ЛОГИКА**: Фактическое количество = сумма всех пересчитанных предметов
- **ПЛАН/ФАКТ**: Корректировка статистики при выявлении расхождений - **ПЛАН/ФАКТ**: Корректировка статистики при выявлении расхождений
@ -933,6 +1029,7 @@ if (currentUser.organization.type !== "FULFILLMENT") {
- ⚙️ **Настройки** - профиль и конфигурация - ⚙️ **Настройки** - профиль и конфигурация
**СПЕЦИАЛИЗИРОВАННЫЕ РАЗДЕЛЫ** (зависят от типа кабинета): **СПЕЦИАЛИЗИРОВАННЫЕ РАЗДЕЛЫ** (зависят от типа кабинета):
- Определяются в соответствующих разделах каждого кабинета - Определяются в соответствующих разделах каждого кабинета
### 8.2 Правила sidebar навигации ### 8.2 Правила sidebar навигации
@ -964,20 +1061,20 @@ if (currentUser.organization.type !== "FULFILLMENT") {
// Пример: кнопка "Поставки" ведет на разные страницы // Пример: кнопка "Поставки" ведет на разные страницы
const handleSuppliesClick = () => { const handleSuppliesClick = () => {
switch (user?.organization?.type) { switch (user?.organization?.type) {
case "FULFILLMENT": case 'FULFILLMENT':
router.push("/fulfillment-supplies"); router.push('/fulfillment-supplies')
break; break
case "SELLER": case 'SELLER':
router.push("/supplies"); router.push('/supplies')
break; break
case "WHOLESALE": case 'WHOLESALE':
router.push("/supplies"); router.push('/supplies')
break; break
case "LOGIST": case 'LOGIST':
router.push("/logistics-orders"); router.push('/logistics-orders')
break; break
} }
}; }
``` ```
--- ---
@ -1007,6 +1104,7 @@ const handleSuppliesClick = () => {
**ОБНОВЛЕННАЯ СТРУКТУРА СИСТЕМЫ (4 БЛОКА):** **ОБНОВЛЕННАЯ СТРУКТУРА СИСТЕМЫ (4 БЛОКА):**
**БЛОК 1: ПОСТАВЩИКИ** _(адаптивная сетка)_ **БЛОК 1: ПОСТАВЩИКИ** _(адаптивная сетка)_
- **Заголовок**: Минималистичный "🏢 Поставщики" без лишних элементов - **Заголовок**: Минималистичный "🏢 Поставщики" без лишних элементов
- **Поиск**: Компактное поле справа "Поиск поставщиков..." (w-64) - **Поиск**: Компактное поле справа "Поиск поставщиков..." (w-64)
- **Отображение**: Карточки поставщиков из раздела "Партнеры" в адаптивной сетке - **Отображение**: Карточки поставщиков из раздела "Партнеры" в адаптивной сетке
@ -1014,6 +1112,7 @@ const handleSuppliesClick = () => {
- **Результат**: Загружаются карточки товаров выбранного поставщика в блок 2 - **Результат**: Загружаются карточки товаров выбранного поставщика в блок 2
**БЛОК 2: КАРТОЧКИ ТОВАРОВ** _(горизонтальный скролл - НОВЫЙ)_ **БЛОК 2: КАРТОЧКИ ТОВАРОВ** _(горизонтальный скролл - НОВЫЙ)_
- **Отображение**: ТОЛЬКО минималистичные карточки товаров 80×112px - **Отображение**: ТОЛЬКО минималистичные карточки товаров 80×112px
- **Содержание**: ТОЛЬКО изображение товара, БЕЗ текста/названий/цен - **Содержание**: ТОЛЬКО изображение товара, БЕЗ текста/названий/цен
- **Навигация**: Горизонтальный скролл при множестве товаров - **Навигация**: Горизонтальный скролл при множестве товаров
@ -1021,17 +1120,20 @@ const handleSuppliesClick = () => {
- **Результат**: Товар добавляется в блок 3 для управления поставкой - **Результат**: Товар добавляется в блок 3 для управления поставкой
**БЛОК 3: ТОВАРЫ ПОСТАВЩИКА** _(детальный каталог)_ **БЛОК 3: ТОВАРЫ ПОСТАВЩИКА** _(детальный каталог)_
- **Отображение**: Детальные карточки выбранных товаров - **Отображение**: Детальные карточки выбранных товаров
- **Управление**: Количество, параметры, настройки поставки - **Управление**: Количество, параметры, настройки поставки
- **Результат**: Формирование окончательной поставки - **Результат**: Формирование окончательной поставки
**БЛОК 4: КОРЗИНА И НАСТРОЙКИ** _(правая панель)_ **БЛОК 4: КОРЗИНА И НАСТРОЙКИ** _(правая панель)_
- **Отображение**: Корзина поставки + настройки - **Отображение**: Корзина поставки + настройки
- **Управление**: Фулфилмент-центр, дата, логистика - **Управление**: Фулфилмент-центр, дата, логистика
#### **9.2.1 Детальные правила горизонтального скролла поставщиков** #### **9.2.1 Детальные правила горизонтального скролла поставщиков**
**СТРУКТУРА И ОТОБРАЖЕНИЕ:** **СТРУКТУРА И ОТОБРАЖЕНИЕ:**
- **Источник данных**: Партнеры типа `WHOLESALE` из раздела "Партнеры" - **Источник данных**: Партнеры типа `WHOLESALE` из раздела "Партнеры"
- **Контейнер**: Фиксированная высота 176px (h-44) с горизонтальным скроллом - **Контейнер**: Фиксированная высота 176px (h-44) с горизонтальным скроллом
- **Блок поставщиков**: Общая высота 180px, включает заголовок + контейнер скролла - **Блок поставщиков**: Общая высота 180px, включает заголовок + контейнер скролла
@ -1039,17 +1141,20 @@ const handleSuppliesClick = () => {
- **Поведение**: Плавный скролл с автоскрытием полосы прокрутки - **Поведение**: Плавный скролл с автоскрытием полосы прокрутки
**РАЗМЕРЫ И АДАПТИВНОСТЬ:** **РАЗМЕРЫ И АДАПТИВНОСТЬ:**
- **Десктоп**: Карточка 216×92px, отступы 12px между карточками, 16px от краев - **Десктоп**: Карточка 216×92px, отступы 12px между карточками, 16px от краев
- **Планшет**: Карточка 200×92px, отступы 12px между карточками - **Планшет**: Карточка 200×92px, отступы 12px между карточками
- **Мобильный**: Карточка 184×92px, отступы 12px между карточками - **Мобильный**: Карточка 184×92px, отступы 12px между карточками
- **Высота блока**: 180px фиксированная для всего блока поставщиков - **Высота блока**: 180px фиксированная для всего блока поставщиков
**ВЗАИМОДЕЙСТВИЕ:** **ВЗАИМОДЕЙСТВИЕ:**
- **Навигация**: Колесо мыши (Shift+скролл), стрелки клавиатуры, свайп на тач - **Навигация**: Колесо мыши (Shift+скролл), стрелки клавиатуры, свайп на тач
- **Выбор**: Клик по карточке → активная рамка + загрузка товаров в блок 2 - **Выбор**: Клик по карточке → активная рамка + загрузка товаров в блок 2
- **Состояния**: Default, Hover (box-shadow), Active (цветная рамка), Loading (скелетон) - **Состояния**: Default, Hover (box-shadow), Active (цветная рамка), Loading (скелетон)
**ГРАНИЧНЫЕ СЛУЧАИ:** **ГРАНИЧНЫЕ СЛУЧАИ:**
- **1-4 карточки**: Выравнивание по левому краю, скролл неактивен - **1-4 карточки**: Выравнивание по левому краю, скролл неактивен
- **5+ карточек**: Полный горизонтальный скролл - **5+ карточек**: Полный горизонтальный скролл
- **Нет партнеров**: Заглушка с ссылкой на раздел "Партнеры" - **Нет партнеров**: Заглушка с ссылкой на раздел "Партнеры"
@ -1057,6 +1162,7 @@ const handleSuppliesClick = () => {
**ТЕХНИЧЕСКАЯ РЕАЛИЗАЦИЯ:** **ТЕХНИЧЕСКАЯ РЕАЛИЗАЦИЯ:**
**Критическая Flex-архитектура:** **Критическая Flex-архитектура:**
```css ```css
.parent-container { .parent-container {
display: flex; display: flex;
@ -1084,6 +1190,7 @@ const handleSuppliesClick = () => {
``` ```
**Контейнер скролла:** **Контейнер скролла:**
```css ```css
.suppliers-block { .suppliers-block {
display: flex; display: flex;
@ -1112,22 +1219,26 @@ const handleSuppliesClick = () => {
**СОДЕРЖАНИЕ КАРТОЧКИ ПОСТАВЩИКА:** **СОДЕРЖАНИЕ КАРТОЧКИ ПОСТАВЩИКА:**
**Структура (3 строки в 92px высоты):** **Структура (3 строки в 92px высоты):**
- **Строка 1**: Название + рейтинг (справа, если есть) - **Строка 1**: Название + рейтинг (справа, если есть)
- **Строка 2**: ИНН (формат "ИНН: 1234567890") - **Строка 2**: ИНН (формат "ИНН: 1234567890")
- **Строка 3**: Бейдж рынка (отдельная строка) - **Строка 3**: Бейдж рынка (отдельная строка)
**Элементы:** **Элементы:**
- **Аватар**: Размер xs, слева с gap-2 - **Аватар**: Размер xs, слева с gap-2
- **Текст**: text-xs для компактности - **Текст**: text-xs для компактности
- **Отступы**: mb-1 между строками 1-2, mb-0.5 между строками 2-3 - **Отступы**: mb-1 между строками 1-2, mb-0.5 между строками 2-3
- **Padding карточки**: 8px (p-2) - **Padding карточки**: 8px (p-2)
**ЦВЕТОВАЯ СХЕМА РЫНКОВ:** **ЦВЕТОВАЯ СХЕМА РЫНКОВ:**
- **"Садовод"** (sadovod): Зеленый `bg-green-500/20 text-green-300 border-green-500/30` - **"Садовод"** (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` - **"ТЯК Москва"** (tyak-moscow): Синий `bg-blue-500/20 text-blue-300 border-blue-500/30`
- **Другие/не указан**: Серый `bg-gray-500/20 text-gray-300 border-gray-500/30` - **Другие/не указан**: Серый `bg-gray-500/20 text-gray-300 border-gray-500/30`
**ДОСТУПНОСТЬ:** **ДОСТУПНОСТЬ:**
- `role="tablist"` для контейнера - `role="tablist"` для контейнера
- `role="tab"` для карточек - `role="tab"` для карточек
- `aria-selected="true/false"` для выбранной карточки - `aria-selected="true/false"` для выбранной карточки
@ -1136,12 +1247,14 @@ const handleSuppliesClick = () => {
#### **9.2.2 Правила блока "Карточки товаров" (Блок 2)** #### **9.2.2 Правила блока "Карточки товаров" (Блок 2)**
**НАЗНАЧЕНИЕ И ЛОГИКА:** **НАЗНАЧЕНИЕ И ЛОГИКА:**
- **Источник данных**: Товары выбранного поставщика из Блока 1 - **Источник данных**: Товары выбранного поставщика из Блока 1
- **Триггер отображения**: Клик на карточку поставщика → загрузка карточек товаров - **Триггер отображения**: Клик на карточку поставщика → загрузка карточек товаров
- **Взаимодействие**: Клик на карточку товара → добавление в Блок 3 "Товары поставщика" - **Взаимодействие**: Клик на карточку товара → добавление в Блок 3 "Товары поставщика"
- **Поведение**: Горизонтальный скролл при множестве товаров - **Поведение**: Горизонтальный скролл при множестве товаров
**АРХИТЕКТУРА И РАЗМЕРЫ:** **АРХИТЕКТУРА И РАЗМЕРЫ:**
- **Внешний контейнер**: bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl flex-shrink-0 - **Внешний контейнер**: bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl flex-shrink-0
- **Внутренний контейнер скролла**: flex gap-3 overflow-x-auto p-4 - **Внутренний контейнер скролла**: flex gap-3 overflow-x-auto p-4
- **Стилизация скролла**: scrollbarWidth: 'thin' для тонкой полосы прокрутки - **Стилизация скролла**: scrollbarWidth: 'thin' для тонкой полосы прокрутки
@ -1151,10 +1264,12 @@ const handleSuppliesClick = () => {
- **БЕЗ заголовков/иконок**: только чистые карточки товаров в контейнере - **БЕЗ заголовков/иконок**: только чистые карточки товаров в контейнере
**РАЗМЕРЫ КАРТОЧЕК ТОВАРОВ:** **РАЗМЕРЫ КАРТОЧЕК ТОВАРОВ:**
- **Компактная карточка**: 80×112px (w-20 h-28), соотношение 5:7 - **Компактная карточка**: 80×112px (w-20 h-28), соотношение 5:7
- **Адаптивность**: фиксированный размер для всех устройств - **Адаптивность**: фиксированный размер для всех устройств
**СОДЕРЖАНИЕ КАРТОЧКИ ТОВАРА:** **СОДЕРЖАНИЕ КАРТОЧКИ ТОВАРА:**
- **ТОЛЬКО изображение товара**: 80×112px, object-cover - **ТОЛЬКО изображение товара**: 80×112px, object-cover
- **Минималистичный дизайн**: БЕЗ текста, названий, цен, иконок - **Минималистичный дизайн**: БЕЗ текста, названий, цен, иконок
- **Состояния**: Default, Selected, Active (БЕЗ Hover-эффектов) - **Состояния**: Default, Selected, Active (БЕЗ Hover-эффектов)
@ -1167,6 +1282,7 @@ const handleSuppliesClick = () => {
#### **9.2.3 Правила Блока 3 "Детальный каталог товаров"** #### **9.2.3 Правила Блока 3 "Детальный каталог товаров"**
**НАЗНАЧЕНИЕ И СТРУКТУРА:** **НАЗНАЧЕНИЕ И СТРУКТУРА:**
- **Контент**: Детальные карточки выбранных товаров с полным управлением - **Контент**: Детальные карточки выбранных товаров с полным управлением
- **Верхняя панель**: Выбор даты + Выбор Fulfillment + Поиск - **Верхняя панель**: Выбор даты + Выбор Fulfillment + Поиск
- **Основная область**: Сетка карточек товаров с детальной информацией - **Основная область**: Сетка карточек товаров с детальной информацией
@ -1174,19 +1290,21 @@ const handleSuppliesClick = () => {
#### **9.2.3.1 Структура верхней панели Блока 3** #### **9.2.3.1 Структура верхней панели Блока 3**
**МИНИМАЛИСТИЧНАЯ ПАНЕЛЬ УПРАВЛЕНИЯ:** **МИНИМАЛИСТИЧНАЯ ПАНЕЛЬ УПРАВЛЕНИЯ:**
- **Выбор даты поставки**: DatePicker для планирования поставки - **Выбор даты поставки**: DatePicker для планирования поставки
- **Выбор Fulfillment-центра**: Select dropdown со списком доступных фулфилментов - **Выбор Fulfillment-центра**: Select dropdown со списком доступных фулфилментов
- **Поиск по товарам**: Input с иконкой поиска и placeholder - **Поиск по товарам**: Input с иконкой поиска и placeholder
- **Компоновка**: Горизонтальная строка с равномерным распределением - **Компоновка**: Горизонтальная строка с равномерным распределением
**ТЕХНИЧЕСКИЕ ТРЕБОВАНИЯ:** **ТЕХНИЧЕСКИЕ ТРЕБОВАНИЯ:**
```tsx ```tsx
// Структура компонентов панели // Структура компонентов панели
<div className="flex items-center gap-4 p-4 bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl mb-4"> <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="Дата поставки" /> <DatePicker placeholder="Дата поставки" />
<Select placeholder="Выберите фулфилмент"> <Select placeholder="Выберите фулфилмент">
<SelectContent> <SelectContent>
{fulfillmentCenters.map(center => ( {fulfillmentCenters.map((center) => (
<SelectItem value={center.id}>{center.name}</SelectItem> <SelectItem value={center.id}>{center.name}</SelectItem>
))} ))}
</SelectContent> </SelectContent>
@ -1201,18 +1319,21 @@ const handleSuppliesClick = () => {
#### **9.2.3.2 Структура основной области карточек** #### **9.2.3.2 Структура основной области карточек**
**СЕТКА ТОВАРОВ:** **СЕТКА ТОВАРОВ:**
- **Адаптивная сетка**: `grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4` - **Адаптивная сетка**: `grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4`
- **Детальные карточки**: Полная информация + количество + управление - **Детальные карточки**: Полная информация + количество + управление
- **Состояния**: Default, Selected, Editing - **Состояния**: Default, Selected, Editing
- **Интерактивность**: Изменение количества, удаление, настройки рецептуры - **Интерактивность**: Изменение количества, удаление, настройки рецептуры
**ФУНКЦИОНАЛЬНОСТЬ ПАНЕЛИ:** **ФУНКЦИОНАЛЬНОСТЬ ПАНЕЛИ:**
- **Выбор даты**: Планирование времени поставки (обязательное поле) - **Выбор даты**: Планирование времени поставки (обязательное поле)
- **Выбор фулфилмента**: Определение исполнителя поставки (обязательное поле) - **Выбор фулфилмента**: Определение исполнителя поставки (обязательное поле)
- **Поиск**: Фильтрация товаров в каталоге по названию/артикулу - **Поиск**: Фильтрация товаров в каталоге по названию/артикулу
- **Валидация**: Блокировка создания поставки без заполнения даты и фулфилмента - **Валидация**: Блокировка создания поставки без заполнения даты и фулфилмента
**ГРАНИЧНЫЕ СЛУЧАИ:** **ГРАНИЧНЫЕ СЛУЧАИ:**
- **Пустой каталог**: Заглушка "Добавьте товары" - **Пустой каталог**: Заглушка "Добавьте товары"
- **Нет фулфилментов**: Сообщение "Настройте партнерство с фулфилмент-центрами" - **Нет фулфилментов**: Сообщение "Настройте партнерство с фулфилмент-центрами"
- **Поиск без результатов**: "По запросу ничего не найдено" - **Поиск без результатов**: "По запросу ничего не найдено"
@ -1222,18 +1343,22 @@ const handleSuppliesClick = () => {
**ДВУХУРОВНЕВАЯ АРХИТЕКТУРА:** **ДВУХУРОВНЕВАЯ АРХИТЕКТУРА:**
**УРОВЕНЬ 1 - Внешний контейнер (блок):** **УРОВЕНЬ 1 - Внешний контейнер (блок):**
```jsx ```jsx
<div className="bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl flex-shrink-0"> <div className="bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl flex-shrink-0">
``` ```
- **Назначение**: Визуальное обрамление блока, единство с другими блоками - **Назначение**: Визуальное обрамление блока, единство с другими блоками
- **Стилизация**: Стеклянный эффект с размытием и полупрозрачностью - **Стилизация**: Стеклянный эффект с размытием и полупрозрачностью
- **Рамка**: Тонкая белая рамка border-white/20 с закруглёнными углами - **Рамка**: Тонкая белая рамка border-white/20 с закруглёнными углами
- **Поведение**: flex-shrink-0 предотвращает сжатие блока - **Поведение**: flex-shrink-0 предотвращает сжатие блока
**УРОВЕНЬ 2 - Внутренний контейнер (скролл):** **УРОВЕНЬ 2 - Внутренний контейнер (скролл):**
```jsx ```jsx
<div className="flex gap-3 overflow-x-auto p-4" style={{ scrollbarWidth: 'thin' }}> <div className="flex gap-3 overflow-x-auto p-4" style={{ scrollbarWidth: 'thin' }}>
``` ```
- **Назначение**: Горизонтальная прокрутка карточек товаров - **Назначение**: Горизонтальная прокрутка карточек товаров
- **Раскладка**: Flex с промежутками gap-3 (12px) между карточками - **Раскладка**: Flex с промежутками gap-3 (12px) между карточками
- **Отступы**: padding p-4 (16px) со всех сторон - **Отступы**: padding p-4 (16px) со всех сторон
@ -1241,12 +1366,14 @@ const handleSuppliesClick = () => {
- **Поведение**: Автоматическое появление скролла при превышении ширины - **Поведение**: Автоматическое появление скролла при превышении ширины
**ПРАВИЛА КОНТЕЙНЕРОВ:** **ПРАВИЛА КОНТЕЙНЕРОВ:**
- Внешний контейнер НЕ содержит заголовков, иконок, описаний - Внешний контейнер НЕ содержит заголовков, иконок, описаний
- Внутренний контейнер содержит ТОЛЬКО карточки товаров - Внутренний контейнер содержит ТОЛЬКО карточки товаров
- Высота адаптируется под размер карточек (80×112px + отступы) - Высота адаптируется под размер карточек (80×112px + отступы)
- Визуальное единство со всеми блоками формы поставки - Визуальное единство со всеми блоками формы поставки
**ТЕХНИЧЕСКИЕ ПРАВИЛА:** **ТЕХНИЧЕСКИЕ ПРАВИЛА:**
- **Условие отображения**: selectedSupplier && products.length > 0 - **Условие отображения**: selectedSupplier && products.length > 0
- **Источник данных**: products массив из GraphQL запроса organizationProducts - **Источник данных**: products массив из GraphQL запроса organizationProducts
- **Реактивность**: Автоматическое обновление при смене поставщика - **Реактивность**: Автоматическое обновление при смене поставщика
@ -1254,6 +1381,7 @@ const handleSuppliesClick = () => {
- **Доступность**: Клавиатурная навигация (Tab, Enter для выбора) - **Доступность**: Клавиатурная навигация (Tab, Enter для выбора)
**UX ПРАВИЛА ВЗАИМОДЕЙСТВИЯ:** **UX ПРАВИЛА ВЗАИМОДЕЙСТВИЯ:**
- **Скролл**: Автоматическое появление при превышении ширины контейнера - **Скролл**: Автоматическое появление при превышении ширины контейнера
- **Индикация загрузки**: Скелетоны карточек во время загрузки товаров - **Индикация загрузки**: Скелетоны карточек во время загрузки товаров
- **Пустое состояние**: Скрытие блока при отсутствии поставщика или товаров - **Пустое состояние**: Скрытие блока при отсутствии поставщика или товаров
@ -1261,24 +1389,28 @@ const handleSuppliesClick = () => {
- **Навигация**: Стрелки ←→ для перемещения между карточками - **Навигация**: Стрелки ←→ для перемещения между карточками
**СОСТОЯНИЯ БЛОКА:** **СОСТОЯНИЯ БЛОКА:**
- **Скрыт**: При отсутствии выбранного поставщика - **Скрыт**: При отсутствии выбранного поставщика
- **Скрыт**: При отсутствии товаров у поставщика - **Скрыт**: При отсутствии товаров у поставщика
- **Активен**: При наличии поставщика и товаров - **Активен**: При наличии поставщика и товаров
- **Загрузка**: Показ скелетонов карточек во время запроса - **Загрузка**: Показ скелетонов карточек во время запроса
**ПРАВИЛА ПРОИЗВОДИТЕЛЬНОСТИ:** **ПРАВИЛА ПРОИЗВОДИТЕЛЬНОСТИ:**
- **Виртуализация**: При количестве товаров > 100 - **Виртуализация**: При количестве товаров > 100
- **Ленивая загрузка изображений**: loading="lazy" для всех изображений - **Ленивая загрузка изображений**: loading="lazy" для всех изображений
- **Мемоизация**: React.memo для компонентов карточек - **Мемоизация**: React.memo для компонентов карточек
- **Дебаунс**: 300мс для поисковых запросов (если будет добавлен поиск) - **Дебаунс**: 300мс для поисковых запросов (если будет добавлен поиск)
**ПРАВИЛА АДАПТИВНОСТИ:** **ПРАВИЛА АДАПТИВНОСТИ:**
- **Мобильные устройства**: Свайп для горизонтальной прокрутки - **Мобильные устройства**: Свайп для горизонтальной прокрутки
- **Планшеты**: Сохранение размеров карточек 80×112px - **Планшеты**: Сохранение размеров карточек 80×112px
- **Десктоп**: Полная функциональность с клавиатурной навигацией - **Десктоп**: Полная функциональность с клавиатурной навигацией
- **Высокие разрешения**: Сохранение пропорций и читаемости - **Высокие разрешения**: Сохранение пропорций и читаемости
**ПРАВИЛА БЕЗОПАСНОСТИ И ВАЛИДАЦИИ:** **ПРАВИЛА БЕЗОПАСНОСТИ И ВАЛИДАЦИИ:**
- **Валидация данных**: Проверка существования product.id перед добавлением - **Валидация данных**: Проверка существования product.id перед добавлением
- **Дубликаты**: Предотвращение добавления одного товара дважды в детальный каталог - **Дубликаты**: Предотвращение добавления одного товара дважды в детальный каталог
- **Санитизация**: Безопасное отображение названий товаров (XSS защита) - **Санитизация**: Безопасное отображение названий товаров (XSS защита)
@ -1286,18 +1418,21 @@ const handleSuppliesClick = () => {
- **Защита от спама**: Дебаунс кликов 200мс для предотвращения множественных добавлений - **Защита от спама**: Дебаунс кликов 200мс для предотвращения множественных добавлений
**ПРАВИЛА ИНТЕГРАЦИИ С ДРУГИМИ БЛОКАМИ:** **ПРАВИЛА ИНТЕГРАЦИИ С ДРУГИМИ БЛОКАМИ:**
- **Блок 1 (Поставщики)**: Слушает изменения selectedSupplier для обновления товаров - **Блок 1 (Поставщики)**: Слушает изменения selectedSupplier для обновления товаров
- **Блок 3 (Детальный каталог)**: Передаёт выбранные товары через setAllSelectedProducts - **Блок 3 (Детальный каталог)**: Передаёт выбранные товары через setAllSelectedProducts
- **Блок 4 (Корзина)**: Товары добавляются в корзину из Блока 3, не напрямую из Блока 2 - **Блок 4 (Корзина)**: Товары добавляются в корзину из Блока 3, не напрямую из Блока 2
- **Синхронизация состояний**: Реактивное обновление при изменении данных в любом блоке - **Синхронизация состояний**: Реактивное обновление при изменении данных в любом блоке
**ПРАВИЛА АНАЛИТИКИ И МЕТРИК:** **ПРАВИЛА АНАЛИТИКИ И МЕТРИК:**
- **Отслеживание кликов**: Логирование добавления товаров в детальный каталог - **Отслеживание кликов**: Логирование добавления товаров в детальный каталог
- **Метрики производительности**: Время загрузки товаров поставщика - **Метрики производительности**: Время загрузки товаров поставщика
- **Пользовательское поведение**: Количество просмотренных товаров на поставщика - **Пользовательское поведение**: Количество просмотренных товаров на поставщика
- **A/B тестирование**: Готовность к тестированию различных размеров карточек - **A/B тестирование**: Готовность к тестированию различных размеров карточек
**ПРАВИЛА ЛОКАЛИЗАЦИИ:** **ПРАВИЛА ЛОКАЛИЗАЦИИ:**
- **Alt-текст изображений**: На языке интерфейса пользователя - **Alt-текст изображений**: На языке интерфейса пользователя
- **Направление скролла**: RTL поддержка для арабского/иврита - **Направление скролла**: RTL поддержка для арабского/иврита
- **Размеры карточек**: Неизменны для всех локалей (80×112px) - **Размеры карточек**: Неизменны для всех локалей (80×112px)
@ -1306,6 +1441,7 @@ const handleSuppliesClick = () => {
#### **9.2.1.1 Заголовок и поиск Блока 1** #### **9.2.1.1 Заголовок и поиск Блока 1**
**МИНИМАЛИСТИЧНЫЙ ДИЗАЙН:** **МИНИМАЛИСТИЧНЫЙ ДИЗАЙН:**
```jsx ```jsx
<div className="flex items-center justify-between gap-4"> <div className="flex items-center justify-between gap-4">
<div className="flex items-center gap-2"> <div className="flex items-center gap-2">
@ -1325,6 +1461,7 @@ const handleSuppliesClick = () => {
``` ```
**ПРАВИЛА ЗАГОЛОВКА:** **ПРАВИЛА ЗАГОЛОВКА:**
- **Иконка**: Building2 h-5 w-5 text-blue-400 (без фонового контейнера) - **Иконка**: Building2 h-5 w-5 text-blue-400 (без фонового контейнера)
- **Текст**: "Поставщики" (убран избыточный "товаров") - **Текст**: "Поставщики" (убран избыточный "товаров")
- **Размер**: text-lg font-semibold (увеличен для лучшей читаемости) - **Размер**: text-lg font-semibold (увеличен для лучшей читаемости)
@ -1332,6 +1469,7 @@ const handleSuppliesClick = () => {
- **Выравнивание**: flex items-center gap-2 (компактное) - **Выравнивание**: flex items-center gap-2 (компактное)
**ПРАВИЛА ПОИСКА:** **ПРАВИЛА ПОИСКА:**
- **Позиция**: Справа от заголовка (justify-between) - **Позиция**: Справа от заголовка (justify-between)
- **Ширина**: w-64 (256px) фиксированная ширина - **Ширина**: w-64 (256px) фиксированная ширина
- **Плейсхолдер**: "Поиск поставщиков..." (конкретное описание) - **Плейсхолдер**: "Поиск поставщиков..." (конкретное описание)
@ -1339,6 +1477,7 @@ const handleSuppliesClick = () => {
- **Стили**: Стандартные glass-эффекты, focus:border-white/20 - **Стили**: Стандартные glass-эффекты, focus:border-white/20
**ПРАВИЛА КНОПКИ "НАЙТИ В МАРКЕТЕ":** **ПРАВИЛА КНОПКИ "НАЙТИ В МАРКЕТЕ":**
- **Условие**: Показывается только при allCounterparties.length === 0 - **Условие**: Показывается только при allCounterparties.length === 0
- **Позиция**: Отдельный блок под заголовком (mt-4) - **Позиция**: Отдельный блок под заголовком (mt-4)
- **НЕ интегрирована**: В поле поиска (отдельно) - **НЕ интегрирована**: В поле поиска (отдельно)
@ -1349,20 +1488,15 @@ const handleSuppliesClick = () => {
**МИНИМАЛИСТИЧНАЯ КАРТОЧКА ПОСТАВЩИКА:** **МИНИМАЛИСТИЧНАЯ КАРТОЧКА ПОСТАВЩИКА:**
**СТРУКТУРА ИНФОРМАЦИИ:** **СТРУКТУРА ИНФОРМАЦИИ:**
```jsx ```jsx
<div className="flex items-start gap-2"> <div className="flex items-start gap-2">
<OrganizationAvatar organization={supplier} size="sm" /> <OrganizationAvatar organization={supplier} size="sm" />
<div className="flex-1 min-w-0"> <div className="flex-1 min-w-0">
<h4 className="text-white font-medium text-sm truncate"> <h4 className="text-white font-medium text-sm truncate">{supplier.name || supplier.fullName}</h4>
{supplier.name || supplier.fullName}
</h4>
<div className="flex items-center gap-2 mt-1"> <div className="flex items-center gap-2 mt-1">
<p className="text-white/60 text-xs font-mono">ИНН: {supplier.inn}</p> <p className="text-white/60 text-xs font-mono">ИНН: {supplier.inn}</p>
{supplier.market && ( {supplier.market && <Badge className="market-badge">{getMarketLabel(supplier.market)}</Badge>}
<Badge className="market-badge">
{getMarketLabel(supplier.market)}
</Badge>
)}
</div> </div>
</div> </div>
</div> </div>
@ -1371,30 +1505,36 @@ const handleSuppliesClick = () => {
**ПРАВИЛА СОДЕРЖАНИЯ КАРТОЧКИ:** **ПРАВИЛА СОДЕРЖАНИЯ КАРТОЧКИ:**
**✅ ОСТАВИТЬ:** **✅ ОСТАВИТЬ:**
- **Аватар организации**: OrganizationAvatar size="sm" слева - **Аватар организации**: OrganizationAvatar size="sm" слева
- **Название поставщика**: supplier.name || supplier.fullName (приоритет name) - **Название поставщика**: supplier.name || supplier.fullName (приоритет name)
- **ИНН**: font-mono, text-white/60, с префиксом "ИНН: " - **ИНН**: font-mono, text-white/60, с префиксом "ИНН: "
**🔸 ДОБАВИТЬ:** **🔸 ДОБАВИТЬ:**
- **Принадлежность к рынку**: Badge с названием рынка из supplier.market - **Принадлежность к рынку**: Badge с названием рынка из supplier.market
- **Рынки**: "Садовод", "ТЯК Москва" и другие из Organization.market поля - **Рынки**: "Садовод", "ТЯК Москва" и другие из Organization.market поля
**❌ УБРАТЬ:** **❌ УБРАТЬ:**
- **Рейтинг**: Звездочка и цифра rating (избыточно) - **Рейтинг**: Звездочка и цифра rating (избыточно)
- **Тип бэдж**: "Поставщик" badge (и так понятно из контекста) - **Тип бэдж**: "Поставщик" badge (и так понятно из контекста)
- **Адрес**: supplier.address (занимает место, не критично) - **Адрес**: supplier.address (занимает место, не критично)
**СТИЛИ РЫНОЧНЫХ БЭДЖЕЙ:** **СТИЛИ РЫНОЧНЫХ БЭДЖЕЙ:**
- **Садовод**: bg-green-500/20 text-green-300 border-green-500/30 - **Садовод**: bg-green-500/20 text-green-300 border-green-500/30
- **ТЯК Москва**: bg-blue-500/20 text-blue-300 border-blue-500/30 - **ТЯК Москва**: bg-blue-500/20 text-blue-300 border-blue-500/30
- **По умолчанию**: bg-gray-500/20 text-gray-300 border-gray-500/30 - **По умолчанию**: bg-gray-500/20 text-gray-300 border-gray-500/30
**ПРАВИЛА АДАПТИВНОСТИ:** **ПРАВИЛА АДАПТИВНОСТИ:**
- **Мобильные**: Сохранение структуры, truncate для длинных названий - **Мобильные**: Сохранение структуры, truncate для длинных названий
- **Планшеты/десктоп**: Полное отображение в сетке - **Планшеты/десктоп**: Полное отображение в сетке
- **Малые экраны**: line-clamp-1 для названия организации - **Малые экраны**: line-clamp-1 для названия организации
**СОСТОЯНИЯ КАРТОЧКИ:** **СОСТОЯНИЯ КАРТОЧКИ:**
- **Default**: bg-white/5 border-white/10 - **Default**: bg-white/5 border-white/10
- **Hover**: hover:border-white/20 hover:bg-white/10 - **Hover**: hover:border-white/20 hover:bg-white/10
- **Selected**: bg-white/15 border-white/40 shadow-lg - **Selected**: bg-white/15 border-white/40 shadow-lg
@ -1403,11 +1543,13 @@ const handleSuppliesClick = () => {
**ПРАВИЛА ИНТЕГРАЦИИ С РЫНКАМИ:** **ПРАВИЛА ИНТЕГРАЦИИ С РЫНКАМИ:**
**ИСТОЧНИК ДАННЫХ:** **ИСТОЧНИК ДАННЫХ:**
- **Поле БД**: Organization.market (String?) - поле принадлежности к рынку - **Поле БД**: Organization.market (String?) - поле принадлежности к рынку
- **Настройка**: Указывается в настройках кабинета поставщика - **Настройка**: Указывается в настройках кабинета поставщика
- **Опциональность**: Поле может быть пустым (рынок не указан) - **Опциональность**: Поле может быть пустым (рынок не указан)
**ФУНКЦИЯ getMarketLabel():** **ФУНКЦИЯ getMarketLabel():**
```jsx ```jsx
const getMarketLabel = (market?: string) => { const getMarketLabel = (market?: string) => {
const marketLabels = { const marketLabels = {
@ -1420,6 +1562,7 @@ const getMarketLabel = (market?: string) => {
``` ```
**СТИЛИ ДЛЯ РЫНКОВ:** **СТИЛИ ДЛЯ РЫНКОВ:**
```jsx ```jsx
const getMarketBadgeStyle = (market?: string) => { const getMarketBadgeStyle = (market?: string) => {
const styles = { const styles = {
@ -1432,6 +1575,7 @@ const getMarketBadgeStyle = (market?: string) => {
``` ```
**ПРАВИЛА ОТОБРАЖЕНИЯ:** **ПРАВИЛА ОТОБРАЖЕНИЯ:**
- **Условие**: Показывать badge только если supplier.market существует - **Условие**: Показывать badge только если supplier.market существует
- **Размер**: text-xs для соответствия ИНН - **Размер**: text-xs для соответствия ИНН
- **Позиция**: Справа от ИНН в той же строке - **Позиция**: Справа от ИНН в той же строке
@ -1445,6 +1589,7 @@ const getMarketBadgeStyle = (market?: string) => {
**🔄 WORKFLOW СЦЕНАРИИ:** **🔄 WORKFLOW СЦЕНАРИИ:**
**СЦЕНАРИЙ 1: Добавление товаров от разных поставщиков** **СЦЕНАРИЙ 1: Добавление товаров от разных поставщиков**
1. Пользователь выбирает Поставщика А 1. Пользователь выбирает Поставщика А
2. Добавляет Товар 1 и Товар 2 в детальный каталог 2. Добавляет Товар 1 и Товар 2 в детальный каталог
3. Переключается на Поставщика Б 3. Переключается на Поставщика Б
@ -1453,44 +1598,52 @@ const getMarketBadgeStyle = (market?: string) => {
6. В блоке 3: Товар 1, Товар 2 (от А) + Товар 3 (от Б) 6. В блоке 3: Товар 1, Товар 2 (от А) + Товар 3 (от Б)
**СЦЕНАРИЙ 2: Визуальная индикация в блоке 2** **СЦЕНАРИЙ 2: Визуальная индикация в блоке 2**
- При переключении на поставщика, товары которого уже есть в блоке 3, показываются как "выбранные" - При переключении на поставщика, товары которого уже есть в блоке 3, показываются как "выбранные"
- Товары от других поставщиков в блоке 2 не отображаются - Товары от других поставщиков в блоке 2 не отображаются
**🛠️ ТЕХНИЧЕСКИЕ ПРАВИЛА:** **🛠️ ТЕХНИЧЕСКИЕ ПРАВИЛА:**
**Состояние selectedProductsForDetailView:** **Состояние selectedProductsForDetailView:**
- Глобальное состояние всех выбранных товаров - Глобальное состояние всех выбранных товаров
- НЕ зависит от текущего поставщика - НЕ зависит от текущего поставщика
- НЕ очищается при смене поставщика - НЕ очищается при смене поставщика
- Очищается только явными действиями пользователя - Очищается только явными действиями пользователя
**Единственные способы удаления:** **Единственные способы удаления:**
1. Кнопка "Удалить из каталога" в карточке товара (блок 3) 1. Кнопка "Удалить из каталога" в карточке товара (блок 3)
2. Кнопка "Очистить каталог" в заголовке блока 3 2. Кнопка "Очистить каталог" в заголовке блока 3
3. НЕ при смене поставщика 3. НЕ при смене поставщика
**🎨 UX ПРАВИЛА:** **🎨 UX ПРАВИЛА:**
- Счетчик товаров: "Детальный каталог (X товаров от Y поставщиков)" - Счетчик товаров: "Детальный каталог (X товаров от Y поставщиков)"
- Визуальная индикация выбранных товаров в блоке 2 - Визуальная индикация выбранных товаров в блоке 2
- Информация о поставщике для каждого товара в блоке 3 - Информация о поставщике для каждого товара в блоке 3
**СОСТОЯНИЯ БЛОКА:** **СОСТОЯНИЯ БЛОКА:**
- **Не выбран поставщик**: Заглушка "Выберите поставщика для просмотра товаров" - **Не выбран поставщик**: Заглушка "Выберите поставщика для просмотра товаров"
- **Поставщик выбран, нет товаров**: "У поставщика нет товаров" - **Поставщик выбран, нет товаров**: "У поставщика нет товаров"
- **Поставщик выбран, есть товары**: Карточки товаров с горизонтальным скроллом - **Поставщик выбран, есть товары**: Карточки товаров с горизонтальным скроллом
**ВЗАИМОДЕЙСТВИЕ:** **ВЗАИМОДЕЙСТВИЕ:**
- **Навигация**: Горизонтальная прокрутка мышью, клавишами ←→ - **Навигация**: Горизонтальная прокрутка мышью, клавишами ←→
- **Выбор**: Клик → добавление в Блок 3 с анимацией - **Выбор**: Клик → добавление в Блок 3 с анимацией
- **Состояния карточек**: Default, Selected, Active (при добавлении) - **Состояния карточек**: Default, Selected, Active (при добавлении)
**ГРАНИЧНЫЕ СЛУЧАИ:** **ГРАНИЧНЫЕ СЛУЧАИ:**
- **1-5 карточек**: Скролл неактивен, выравнивание по левому краю - **1-5 карточек**: Скролл неактивен, выравнивание по левому краю
- **6+ карточек**: Полноценный горизонтальный скролл - **6+ карточек**: Полноценный горизонтальный скролл
- **Поиск**: Фильтрация карточек в реальном времени - **Поиск**: Фильтрация карточек в реальном времени
- **Загрузка**: Скелетон-анимация при смене поставщика - **Загрузка**: Скелетон-анимация при смене поставщика
**БЛОК 3: ТОВАРЫ ПОСТАВЩИКА** _(детальный каталог)_ **БЛОК 3: ТОВАРЫ ПОСТАВЩИКА** _(детальный каталог)_
- **Содержание**: Детальный каталог товаров для управления поставкой - **Содержание**: Детальный каталог товаров для управления поставкой
- **Источник**: Товары, добавленные из Блока 2 "Карточки товаров" - **Источник**: Товары, добавленные из Блока 2 "Карточки товаров"
- **Сортировка**: По цене, названию, категории - **Сортировка**: По цене, названию, категории
@ -1503,6 +1656,7 @@ const getMarketBadgeStyle = (market?: string) => {
- **Действие**: Клик добавляет расходник в корзину - **Действие**: Клик добавляет расходник в корзину
**БЛОК 3: КОРЗИНА** _(правая часть)_ **БЛОК 3: КОРЗИНА** _(правая часть)_
- **Содержание корзины**: - **Содержание корзины**:
- Количество видов расходников - Количество видов расходников
- По каждому расходнику: название, количество, цена за единицу, сумма - По каждому расходнику: название, количество, цена за единицу, сумма
@ -1519,6 +1673,7 @@ const getMarketBadgeStyle = (market?: string) => {
#### **📊 Структура многоуровневой таблицы:** #### **📊 Структура многоуровневой таблицы:**
**ПЕРВЫЙ УРОВЕНЬ** _(основной список)_: **ПЕРВЫЙ УРОВЕНЬ** _(основной список)_:
- Порядковый номер поставки (от большего к меньшему) - Порядковый номер поставки (от большего к меньшему)
- Количество видов расходников селлера - Количество видов расходников селлера
- Стоимость всей поставки - Стоимость всей поставки
@ -1527,6 +1682,7 @@ const getMarketBadgeStyle = (market?: string) => {
- Кнопка раскрытия/сворачивания - Кнопка раскрытия/сворачивания
**ВТОРОЙ УРОВЕНЬ** _(раскрывается по клику)_: **ВТОРОЙ УРОВЕНЬ** _(раскрывается по клику)_:
- Название расходника селлера - Название расходника селлера
- Количество - Количество
- Цена за единицу - Цена за единицу
@ -1536,6 +1692,7 @@ const getMarketBadgeStyle = (market?: string) => {
- **Режим**: Только просмотр (редактирование недоступно после создания) - **Режим**: Только просмотр (редактирование недоступно после создания)
**ПРАВИЛА ОТОБРАЖЕНИЯ**: **ПРАВИЛА ОТОБРАЖЕНИЯ**:
- По умолчанию таблица свернута, показан только первый уровень - По умолчанию таблица свернута, показан только первый уровень
- Клик по строке или кнопке раскрывает второй уровень - Клик по строке или кнопке раскрывает второй уровень
- Анимация раскрытия плавная (300ms) - Анимация раскрытия плавная (300ms)
@ -1646,18 +1803,21 @@ transition-all duration-150
**ПРАВИЛО**: Статистика меняется в зависимости от выбранных табов **ПРАВИЛО**: Статистика меняется в зависимости от выбранных табов
**Для путей "Фулфилмент → Товар → Карточки/Поставщики":** **Для путей "Фулфилмент → Товар → Карточки/Поставщики":**
- Всего поставок - Всего поставок
- Активных поставок - Активных поставок
- Сумма активных поставок - Сумма активных поставок
- В пути - В пути
**Для пути "Фулфилмент → Расходники селлера":** **Для пути "Фулфилмент → Расходники селлера":**
- Всего поставок - Всего поставок
- Активных поставок - Активных поставок
- Видов расходников - Видов расходников
- Критические остатки - Критические остатки
**Для путей "Маркетплейсы → Wildberries/Ozon":** **Для путей "Маркетплейсы → Wildberries/Ozon":**
- Поставок на маркетплейс - Поставок на маркетплейс
- Товаров отправлено - Товаров отправлено
- Возвраты за неделю - Возвраты за неделю
@ -1666,11 +1826,13 @@ transition-all duration-150
#### **9.3.3 Высота основного блока** #### **9.3.3 Высота основного блока**
**ФОРМУЛА РАСЧЕТА**: **ФОРМУЛА РАСЧЕТА**:
```css ```css
height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins) height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins);
``` ```
**ПРАВИЛО ВЫРАВНИВАНИЯ**: **ПРАВИЛО ВЫРАВНИВАНИЯ**:
- Нижняя граница основного блока должна быть на одном уровне с нижней границей sidebar - Нижняя граница основного блока должна быть на одном уровне с нижней границей sidebar
- При изменении размера окна высота пересчитывается - При изменении размера окна высота пересчитывается
- Внутренний скролл: `overflow-y-auto` - Внутренний скролл: `overflow-y-auto`
@ -1678,6 +1840,7 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
#### **9.3.4 Сохранение функционала** #### **9.3.4 Сохранение функционала**
**КРИТИЧЕСКИ ВАЖНО**: При добавлении блока статистики весь существующий функционал сохраняется: **КРИТИЧЕСКИ ВАЖНО**: При добавлении блока статистики весь существующий функционал сохраняется:
- Таблицы с данными поставок - Таблицы с данными поставок
- Фильтры и сортировка - Фильтры и сортировка
- Кнопки действий - Кнопки действий
@ -1686,6 +1849,7 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
- Поиск - Поиск
**ЗАПРЕЩЕНО**: **ЗАПРЕЩЕНО**:
- Удалять существующие компоненты - Удалять существующие компоненты
- Изменять логику работы таблиц - Изменять логику работы таблиц
- Нарушать существующие API вызовы - Нарушать существующие API вызовы
@ -1697,6 +1861,7 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
**КЛЮЧЕВОЕ ПРАВИЛО**: Табы "Карточки" и "Поставщики" - это два способа создания поставок одного типа предмета (ТОВАР) **КЛЮЧЕВОЕ ПРАВИЛО**: Табы "Карточки" и "Поставщики" - это два способа создания поставок одного типа предмета (ТОВАР)
**СПОСОБЫ СОЗДАНИЯ**: **СПОСОБЫ СОЗДАНИЯ**:
- **Карточки** - импорт товаров через WB API с автоматическим созданием поставки - **Карточки** - импорт товаров через WB API с автоматическим созданием поставки
- **Поставщики** - прямой заказ товаров у поставщика с указанием рецептуры - **Поставщики** - прямой заказ товаров у поставщика с указанием рецептуры
@ -1707,6 +1872,7 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
**ПРАВИЛО**: Блок статистики показывает ОДИНАКОВЫЕ данные для обоих табов **ПРАВИЛО**: Блок статистики показывает ОДИНАКОВЫЕ данные для обоих табов
**МЕТРИКИ ДЛЯ ТАБОВ "КАРТОЧКИ" И "ПОСТАВЩИКИ"**: **МЕТРИКИ ДЛЯ ТАБОВ "КАРТОЧКИ" И "ПОСТАВЩИКИ"**:
- Всего поставок товаров (из всех источников) - Всего поставок товаров (из всех источников)
- Активных поставок товаров (в работе) - Активных поставок товаров (в работе)
- Сумма активных поставок товаров - Сумма активных поставок товаров
@ -1719,11 +1885,13 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
**СОДЕРЖИМОЕ**: Единая таблица всех поставок товаров **СОДЕРЖИМОЕ**: Единая таблица всех поставок товаров
**ИСТОЧНИКИ ДАННЫХ**: **ИСТОЧНИКИ ДАННЫХ**:
- Поставки, созданные через импорт карточек WB - Поставки, созданные через импорт карточек WB
- Поставки, созданные через заказ у поставщиков - Поставки, созданные через заказ у поставщиков
- Все промежуточные и завершённые поставки - Все промежуточные и завершённые поставки
**РАЗЛИЧИЯ ТАБОВ**: **РАЗЛИЧИЯ ТАБОВ**:
- Только кнопки создания ведут на разные страницы - Только кнопки создания ведут на разные страницы
- Таб "Карточки": `/supplies/create-cards` - Таб "Карточки": `/supplies/create-cards`
- Таб "Поставщики": `/supplies/create-suppliers` - Таб "Поставщики": `/supplies/create-suppliers`
@ -1733,21 +1901,25 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
#### **Структура страницы**: #### **Структура страницы**:
**БЛОК 1: ПОСТАВЩИКИ** _(обязательный, 180px)_: **БЛОК 1: ПОСТАВЩИКИ** _(обязательный, 180px)_:
- Карточки поставщиков из раздела "Партнеры" - Карточки поставщиков из раздела "Партнеры"
- Горизонтальный скролл при превышении ширины - Горизонтальный скролл при превышении ширины
- Выбор только одного поставщика одновременно - Выбор только одного поставщика одновременно
**БЛОК 2: КАРТОЧКИ ТОВАРОВ** _(адаптивная высота - НОВЫЙ БЛОК)_: **БЛОК 2: КАРТОЧКИ ТОВАРОВ** _(адаптивная высота - НОВЫЙ БЛОК)_:
- ТОЛЬКО минималистичные карточки товаров 80×112px - ТОЛЬКО минималистичные карточки товаров 80×112px
- ТОЛЬКО изображение товара, БЕЗ текста/названий/цен - ТОЛЬКО изображение товара, БЕЗ текста/названий/цен
- Горизонтальный скролл при множестве товаров - Горизонтальный скролл при множестве товаров
- Клик добавляет товар в блок 3 - Клик добавляет товар в блок 3
**БЛОК 3: ТОВАРЫ ПОСТАВЩИКА** _(flex-1, детальный каталог)_: **БЛОК 3: ТОВАРЫ ПОСТАВЩИКА** _(flex-1, детальный каталог)_:
- Детальные карточки выбранных товаров - Детальные карточки выбранных товаров
- Управление количеством и параметрами поставки - Управление количеством и параметрами поставки
**БЛОК 4: КОРЗИНА И НАСТРОЙКИ** _(правая панель, 384px)_: **БЛОК 4: КОРЗИНА И НАСТРОЙКИ** _(правая панель, 384px)_:
- Корзина поставки с выбранными товарами - Корзина поставки с выбранными товарами
- Настройки поставки (фулфилмент-центр, дата, логистика) - Настройки поставки (фулфилмент-центр, дата, логистика)
- Сортировка: цена, название, категория - Сортировка: цена, название, категория
@ -1800,12 +1972,14 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
**🔍 КРИТИЧЕСКОЕ РАЗДЕЛЕНИЕ ПОНЯТИЙ:** **🔍 КРИТИЧЕСКОЕ РАЗДЕЛЕНИЕ ПОНЯТИЙ:**
### **РЫНОК** 🏪 - физическое торговое место ### **РЫНОК** 🏪 - физическое торговое место
- **Назначение**: Географическая принадлежность поставщиков - **Назначение**: Географическая принадлежность поставщиков
- **Примеры**: Садовод, ТЯК Москва - **Примеры**: Садовод, ТЯК Москва
- **Структура**: Название + адрес - **Структура**: Название + адрес
- **Связь**: Поставщик принадлежит рынку - **Связь**: Поставщик принадлежит рынку
### **МАРКЕТ** 🛒 - раздел системы для торговли ### **МАРКЕТ** 🛒 - раздел системы для торговли
- **Назначение**: Глобальный каталог товаров в системе - **Назначение**: Глобальный каталог товаров в системе
- **Роут**: `/market` - просмотр и заказ товаров - **Роут**: `/market` - просмотр и заказ товаров
- **Содержание**: Все доступные товары от всех поставщиков - **Содержание**: Все доступные товары от всех поставщиков
@ -1928,10 +2102,12 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
#### 11.2.2 Система учета склада #### 11.2.2 Система учета склада
**Дополнительные значения** (показатели движения): **Дополнительные значения** (показатели движения):
- **ПРИБЫЛО** - количество поступивших на склад за период - **ПРИБЫЛО** - количество поступивших на склад за период
- **УБЫЛО** - количество списанных со склада за период - **УБЫЛО** - количество списанных со склада за период
**Основные значения** (текущие остатки): **Основные значения** (текущие остатки):
- **ФОРМУЛА**: Основные значения = Предыдущие остатки + Прибыло - Убыло - **ФОРМУЛА**: Основные значения = Предыдущие остатки + Прибыло - Убыло
- **ОБНОВЛЕНИЕ**: В реальном времени с изменениями за сутки - **ОБНОВЛЕНИЕ**: В реальном времени с изменениями за сутки
- **ИСТОЧНИК**: GraphQL query `GET_FULFILLMENT_WAREHOUSE_STATS` - **ИСТОЧНИК**: GraphQL query `GET_FULFILLMENT_WAREHOUSE_STATS`
@ -1950,6 +2126,7 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
``` ```
**Цветовое кодирование**: **Цветовое кодирование**:
- Каждый уровень имеет цветной индикатор увеличивающегося размера - Каждый уровень имеет цветной индикатор увеличивающегося размера
- Цветная левая граница с увеличивающимся отступом и толщиной - Цветная левая граница с увеличивающимся отступом и толщиной
- Скроллбары в цвете уровня - Скроллбары в цвете уровня
@ -1983,11 +2160,13 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
#### 11.5.1 Структура: 2 основные вкладки #### 11.5.1 Структура: 2 основные вкладки
**A) 🛒 ПОСТАВКИ ТОВАРОВ**: **A) 🛒 ПОСТАВКИ ТОВАРОВ**:
- **Детализированные товары ФФ** - планы и факты поставок с маршрутами - **Детализированные товары ФФ** - планы и факты поставок с маршрутами
- **Товары ФФ** - общие поставки товаров от селлеров - **Товары ФФ** - общие поставки товаров от селлеров
- **Возвраты с ПВЗ** - обработка возвращенных товаров - **Возвраты с ПВЗ** - обработка возвращенных товаров
**B) 🔧 ПОСТАВКИ РАСХОДНИКОВ**: **B) 🔧 ПОСТАВКИ РАСХОДНИКОВ**:
- **Заказы расходников** - управление заказами от селлеров - **Заказы расходников** - управление заказами от селлеров
- **Расходники селлеров** - материалы для клиентов - **Расходники селлеров** - материалы для клиентов
- **Создание поставок** - формирование новых поставок расходников - **Создание поставок** - формирование новых поставок расходников
@ -1995,6 +2174,7 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
#### 11.5.2 Workflow поставок товаров #### 11.5.2 Workflow поставок товаров
**Этапы обработки**: **Этапы обработки**:
1. **Planned** - поставка запланирована 1. **Planned** - поставка запланирована
2. **In-transit** - товар в пути 2. **In-transit** - товар в пути
3. **Delivered** - доставлен на склад 3. **Delivered** - доставлен на склад
@ -2005,6 +2185,7 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
#### 11.6.1 Блоки аналитики (сворачиваемые) #### 11.6.1 Блоки аналитики (сворачиваемые)
**1. НАКОПЛЕННАЯ СТАТИСТИКА** (`allTime: true`): **1. НАКОПЛЕННАЯ СТАТИСТИКА** (`allTime: true`):
- Обработано товаров (общий объем) - Обработано товаров (общий объем)
- Выявлено брака (всего единиц) - Выявлено брака (всего единиц)
- Поставок получено - Поставок получено
@ -2013,11 +2194,13 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
- Удовлетворенность клиентов (средний рейтинг) - Удовлетворенность клиентов (средний рейтинг)
**2. ОТГРУЗКА НА ПЛОЩАДКИ** (`marketplaces: true`): **2. ОТГРУЗКА НА ПЛОЩАДКИ** (`marketplaces: true`):
- Отправлено на Wildberries - Отправлено на Wildberries
- Отправлено на Ozon - Отправлено на Ozon
- Отправлено на другие площадки - Отправлено на другие площадки
**3. АНАЛИТИКА ПРОИЗВОДИТЕЛЬНОСТИ** (`performance: false`): **3. АНАЛИТИКА ПРОИЗВОДИТЕЛЬНОСТИ** (`performance: false`):
- Среднее время обработки (на единицу товара) - Среднее время обработки (на единицу товара)
- Уровень брака (от общего объема) - Уровень брака (от общего объема)
- Уровень возвратов (возвраты с площадок) - Уровень возвратов (возвраты с площадок)
@ -2028,6 +2211,7 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
#### 11.7.1 Архитектура интеграции с системой #### 11.7.1 Архитектура интеграции с системой
**СВЯЗЬ С РЕЦЕПТУРАМИ СЕЛЛЕРОВ:** **СВЯЗЬ С РЕЦЕПТУРАМИ СЕЛЛЕРОВ:**
``` ```
СЕЛЛЕР (создание поставки) СЕЛЛЕР (создание поставки)
└── Рецептура └── Рецептура
@ -2044,6 +2228,7 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
#### 11.7.2 Структура: 3 обязательные вкладки #### 11.7.2 Структура: 3 обязательные вкладки
**A) 🛠️ УСЛУГИ** (`defaultValue="services"`): **A) 🛠️ УСЛУГИ** (`defaultValue="services"`):
- **Полный CRUD**: создание, редактирование, удаление услуг - **Полный CRUD**: создание, редактирование, удаление услуг
- **Поля**: `name`, `description`, `price`, `imageUrl` - **Поля**: `name`, `description`, `price`, `imageUrl`
- **Glass Upload Zone**: элегантная загрузка изображений - **Glass Upload Zone**: элегантная загрузка изображений
@ -2051,6 +2236,7 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
- **GraphQL**: `GET_MY_SERVICES`, `CREATE_SERVICE`, `UPDATE_SERVICE`, `DELETE_SERVICE` - **GraphQL**: `GET_MY_SERVICES`, `CREATE_SERVICE`, `UPDATE_SERVICE`, `DELETE_SERVICE`
**B) 🚚 ЛОГИСТИКА**: **B) 🚚 ЛОГИСТИКА**:
- **Полный CRUD**: маршруты доставки - **Полный CRUD**: маршруты доставки
- **Поля**: откуда → куда, тарификация до/свыше 1м³ - **Поля**: откуда → куда, тарификация до/свыше 1м³
- **Группированные локации**: - **Группированные локации**:
@ -2062,6 +2248,7 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
- **GraphQL**: `GET_MY_LOGISTICS`, `CREATE_LOGISTICS`, `UPDATE_LOGISTICS`, `DELETE_LOGISTICS` - **GraphQL**: `GET_MY_LOGISTICS`, `CREATE_LOGISTICS`, `UPDATE_LOGISTICS`, `DELETE_LOGISTICS`
**C) 📦 РАСХОДНИКИ** (**❌ БЕЗ СОЗДАНИЯ**): **C) 📦 РАСХОДНИКИ** (**❌ БЕЗ СОЗДАНИЯ**):
- **ТОЛЬКО ПРОСМОТР** расходников с фулфилмент-склада - **ТОЛЬКО ПРОСМОТР** расходников с фулфилмент-склада
- **ЕДИНСТВЕННОЕ РЕДАКТИРУЕМОЕ ПОЛЕ**: `pricePerUnit` - цена за единицу для рецептур - **ЕДИНСТВЕННОЕ РЕДАКТИРУЕМОЕ ПОЛЕ**: `pricePerUnit` - цена за единицу для рецептур
- **UI подсветка**: "Цена за 1 {unit}" (например, "Цена за 1 шт") - **UI подсветка**: "Цена за 1 {unit}" (например, "Цена за 1 шт")
@ -2082,19 +2269,23 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
#### 11.7.4 Правила видимости в рецептурах #### 11.7.4 Правила видимости в рецептурах
**В РЕЦЕПТУРАХ СЕЛЛЕРОВ ПОКАЗЫВАЮТСЯ ТОЛЬКО:** **В РЕЦЕПТУРАХ СЕЛЛЕРОВ ПОКАЗЫВАЮТСЯ ТОЛЬКО:**
- `isAvailable = true` (есть на skladе) - `isAvailable = true` (есть на skladе)
- `pricePerUnit != null` (цена установлена) - `pricePerUnit != null` (цена установлена)
**НЕ ПОКАЗЫВАЮТСЯ:** **НЕ ПОКАЗЫВАЮТСЯ:**
- Расходники без цены (`pricePerUnit = null`) - Расходники без цены (`pricePerUnit = null`)
- Удаленные со склада (`isAvailable = false`) - Удаленные со склада (`isAvailable = false`)
**В РАЗДЕЛЕ УСЛУГИ/РАСХОДНИКИ ВИДНЫ ВСЕ:** **В РАЗДЕЛЕ УСЛУГИ/РАСХОДНИКИ ВИДНЫ ВСЕ:**
- С визуальной индикацией состояния (активные/неактивные/без цены) - С визуальной индикацией состояния (активные/неактивные/без цены)
#### 11.7.5 Технические требования #### 11.7.5 Технические требования
**GraphQL типы:** **GraphQL типы:**
```graphql ```graphql
# Для рецептур - только доступные с ценой # Для рецептур - только доступные с ценой
getAvailableSuppliesForRecipe: [SupplyForRecipe!]! getAvailableSuppliesForRecipe: [SupplyForRecipe!]!
@ -2111,6 +2302,7 @@ type Supply {
``` ```
**Экономический учет:** **Экономический учет:**
- Создание: через поставки расходников - Создание: через поставки расходников
- Ценообразование: в разделе Услуги - Ценообразование: в разделе Услуги
- Списание: со склада при использовании - Списание: со склада при использовании
@ -2123,17 +2315,20 @@ type Supply {
**A) 👥 СОТРУДНИКИ** (`defaultValue="combined"`): **A) 👥 СОТРУДНИКИ** (`defaultValue="combined"`):
**Управление персоналом**: **Управление персоналом**:
- **CRUD операции**: создание, редактирование, удаление сотрудников - **CRUD операции**: создание, редактирование, удаление сотрудников
- **Статусы сотрудников**: `ACTIVE`, `VACATION`, `SICK`, `FIRED` - **Статусы сотрудников**: `ACTIVE`, `VACATION`, `SICK`, `FIRED`
- **Формы добавления**: Компактная (`showCompactForm`) / Полная форма - **Формы добавления**: Компактная (`showCompactForm`) / Полная форма
- **Поиск и фильтрация** по имени, должности, статусу - **Поиск и фильтрация** по имени, должности, статусу
**Табель рабочего времени**: **Табель рабочего времени**:
- **Навигация по месяцам**: текущий год/месяц с кнопками ←/→ - **Навигация по месяцам**: текущий год/месяц с кнопками ←/→
- **Отметки по дням**: статус дня и количество отработанных часов - **Отметки по дням**: статус дня и количество отработанных часов
- **GraphQL**: `GET_EMPLOYEE_SCHEDULE`, `UPDATE_EMPLOYEE_SCHEDULE` - **GraphQL**: `GET_EMPLOYEE_SCHEDULE`, `UPDATE_EMPLOYEE_SCHEDULE`
**B) 📋 ОТЧЕТЫ** (`value="reports"`): **B) 📋 ОТЧЕТЫ** (`value="reports"`):
- **Сводные отчеты** по сотрудникам за период - **Сводные отчеты** по сотрудникам за период
- **Экспорт данных** табеля - **Экспорт данных** табеля
- **Аналитика рабочего времени** - **Аналитика рабочего времени**
@ -2246,11 +2441,13 @@ type Supply {
### 13.1 Основы системы партнерства ### 13.1 Основы системы партнерства
**ПРИНЦИП РАБОТЫ**: **ПРИНЦИП РАБОТЫ**:
- Все типы кабинетов могут создавать партнерские отношения - Все типы кабинетов могут создавать партнерские отношения
- Партнерство реализовано через таблицы `Counterparty` и `CounterpartyRequest` - Партнерство реализовано через таблицы `Counterparty` и `CounterpartyRequest`
- Двустороннее партнерство: каждая организация видит другую в разделе "Партнеры" - Двустороннее партнерство: каждая организация видит другую в разделе "Партнеры"
**ТИПЫ ОРГАНИЗАЦИЙ-ПАРТНЕРОВ**: **ТИПЫ ОРГАНИЗАЦИЙ-ПАРТНЕРОВ**:
- `WHOLESALE` - Поставщики товаров и расходников - `WHOLESALE` - Поставщики товаров и расходников
- `FULFILLMENT` - Фулфилмент-центры - `FULFILLMENT` - Фулфилмент-центры
- `LOGIST` - Логистические компании - `LOGIST` - Логистические компании
@ -2261,6 +2458,7 @@ type Supply {
#### **СПОСОБ 1: Через заказ в маркете (автоматическое партнерство)** #### **СПОСОБ 1: Через заказ в маркете (автоматическое партнерство)**
**WORKFLOW**: **WORKFLOW**:
1. Поставщик создает товар → товар попадает в глобальный маркет 1. Поставщик создает товар → товар попадает в глобальный маркет
2. Селлер/Фулфилмент находит товар в маркете 2. Селлер/Фулфилмент находит товар в маркете
3. Создает заказ (`SupplyOrder`) → статус `PENDING` 3. Создает заказ (`SupplyOrder`) → статус `PENDING`
@ -2274,6 +2472,7 @@ type Supply {
#### **СПОСОБ 2: Через раздел "Партнеры" (заявочная система)** #### **СПОСОБ 2: Через раздел "Партнеры" (заявочная система)**
**WORKFLOW**: **WORKFLOW**:
1. Любая организация идет в раздел "Партнеры" 1. Любая организация идет в раздел "Партнеры"
2. Использует поиск для нахождения нужной организации 2. Использует поиск для нахождения нужной организации
3. Отправляет заявку на партнерство → создается `CounterpartyRequest`: 3. Отправляет заявку на партнерство → создается `CounterpartyRequest`:
@ -2286,6 +2485,7 @@ type Supply {
6. **Автоматически создается двустороннее партнерство** (аналогично способу 1) 6. **Автоматически создается двустороннее партнерство** (аналогично способу 1)
**СТАТУСЫ ЗАЯВОК**: **СТАТУСЫ ЗАЯВОК**:
- `PENDING` - Ожидает рассмотрения - `PENDING` - Ожидает рассмотрения
- `ACCEPTED` - Принята (партнерство создано) - `ACCEPTED` - Принята (партнерство создано)
- `REJECTED` - Отклонена - `REJECTED` - Отклонена
@ -2296,11 +2496,13 @@ type Supply {
#### **В форме создания поставки товаров через поставщиков** #### **В форме создания поставки товаров через поставщиков**
**ПРАВИЛО ОТОБРАЖЕНИЯ ПОСТАВЩИКОВ**: **ПРАВИЛО ОТОБРАЖЕНИЯ ПОСТАВЩИКОВ**:
- Показываются только партнеры с типом `WHOLESALE` - Показываются только партнеры с типом `WHOLESALE`
- Источник: таблица `Counterparty` where `counterparty.type === "WHOLESALE"` - Источник: таблица `Counterparty` where `counterparty.type === "WHOLESALE"`
- Фильтрация по `organizationId` текущего пользователя - Фильтрация по `organizationId` текущего пользователя
**ЛОГИКА РАБОТЫ**: **ЛОГИКА РАБОТЫ**:
1. Пользователь выбирает поставщика из dropdown партнеров-поставщиков 1. Пользователь выбирает поставщика из dropdown партнеров-поставщиков
2. Загружается каталог товаров поставщика из `Product` таблицы 2. Загружается каталог товаров поставщика из `Product` таблицы
3. Товары фильтруются по `organizationId = поставщик.id` 3. Товары фильтруются по `organizationId = поставщик.id`
@ -2309,20 +2511,24 @@ type Supply {
#### **В других разделах системы** #### **В других разделах системы**
**ВЫБОР ФУЛФИЛМЕНТ-ЦЕНТРА**: **ВЫБОР ФУЛФИЛМЕНТ-ЦЕНТРА**:
- Партнеры с типом `FULFILLMENT` - Партнеры с типом `FULFILLMENT`
- Используется при создании поставок расходников - Используется при создании поставок расходников
**ВЫБОР ЛОГИСТИКИ**: **ВЫБОР ЛОГИСТИКИ**:
- Партнеры с типом `LOGIST` - Партнеры с типом `LOGIST`
- Используется при планировании доставок - Используется при планировании доставок
**МЕССЕНДЖЕР**: **МЕССЕНДЖЕР**:
- Общение доступно только между партнерами - Общение доступно только между партнерами
- Список чатов формируется из таблицы `Counterparty` - Список чатов формируется из таблицы `Counterparty`
### 13.4 Технические правила ### 13.4 Технические правила
**СОЗДАНИЕ ЗАПИСЕЙ В COUNTERPARTY**: **СОЗДАНИЕ ЗАПИСЕЙ В COUNTERPARTY**:
```sql ```sql
-- При создании партнерства создаются ДВЕ записи -- При создании партнерства создаются ДВЕ записи
INSERT INTO counterparties (organizationId, counterpartyId) VALUES (org1_id, org2_id); INSERT INTO counterparties (organizationId, counterpartyId) VALUES (org1_id, org2_id);
@ -2330,28 +2536,30 @@ INSERT INTO counterparties (organizationId, counterpartyId) VALUES (org2_id, org
``` ```
**ПРОВЕРКА ПАРТНЕРСТВА**: **ПРОВЕРКА ПАРТНЕРСТВА**:
```typescript ```typescript
const isPartner = await prisma.counterparty.findFirst({ const isPartner = await prisma.counterparty.findFirst({
where: { where: {
organizationId: currentOrgId, organizationId: currentOrgId,
counterpartyId: targetOrgId counterpartyId: targetOrgId,
} },
}); })
``` ```
**ПОЛУЧЕНИЕ ПАРТНЕРОВ ПО ТИПУ**: **ПОЛУЧЕНИЕ ПАРТНЕРОВ ПО ТИПУ**:
```typescript ```typescript
const wholesalePartners = await prisma.counterparty.findMany({ const wholesalePartners = await prisma.counterparty.findMany({
where: { where: {
organizationId: currentOrgId, organizationId: currentOrgId,
counterparty: { counterparty: {
type: "WHOLESALE" type: 'WHOLESALE',
} },
}, },
include: { include: {
counterparty: true counterparty: true,
} },
}); })
``` ```
### 13.5 Решение распространенных проблем ### 13.5 Решение распространенных проблем
@ -2359,6 +2567,7 @@ const wholesalePartners = await prisma.counterparty.findMany({
#### **ПРОБЛЕМА: GraphQL запрос не возвращает данные партнеров** #### **ПРОБЛЕМА: GraphQL запрос не возвращает данные партнеров**
**Симптомы**: **Симптомы**:
- В консоли браузера: `All counterparties: 0`, `All counterparties data: []` - В консоли браузера: `All counterparties: 0`, `All counterparties data: []`
- GraphQL запрос отправляется успешно, но возвращает пустой массив - GraphQL запрос отправляется успешно, но возвращает пустой массив
- В базе данных партнеры существуют - В базе данных партнеры существуют
@ -2366,13 +2575,15 @@ const wholesalePartners = await prisma.counterparty.findMany({
**Возможные причины и решения**: **Возможные причины и решения**:
1. **НЕПРАВИЛЬНОЕ ИМЯ ПОЛЯ В КОДЕ** (наиболее частая ошибка): 1. **НЕПРАВИЛЬНОЕ ИМЯ ПОЛЯ В КОДЕ** (наиболее частая ошибка):
```typescript ```typescript
// ❌ НЕПРАВИЛЬНО // ❌ НЕПРАВИЛЬНО
const allCounterparties = counterpartiesData?.getMyCounterparties || []; const allCounterparties = counterpartiesData?.getMyCounterparties || []
// ✅ ПРАВИЛЬНО // ✅ ПРАВИЛЬНО
const allCounterparties = counterpartiesData?.myCounterparties || []; const allCounterparties = counterpartiesData?.myCounterparties || []
``` ```
**Объяснение**: В GraphQL схеме поле называется `myCounterparties`, а не `getMyCounterparties` **Объяснение**: В GraphQL схеме поле называется `myCounterparties`, а не `getMyCounterparties`
2. **НЕСООТВЕТСТВИЕ ID ПОЛЬЗОВАТЕЛЯ**: 2. **НЕСООТВЕТСТВИЕ ID ПОЛЬЗОВАТЕЛЯ**:
@ -2380,11 +2591,12 @@ const wholesalePartners = await prisma.counterparty.findMany({
- Убедиться что `context.user.id` соответствует ожидаемому пользователю - Убедиться что `context.user.id` соответствует ожидаемому пользователю
3. **ПРОБЛЕМЫ С КЕШИРОВАНИЕМ APOLLO CLIENT**: 3. **ПРОБЛЕМЫ С КЕШИРОВАНИЕМ APOLLO CLIENT**:
```typescript ```typescript
const { data, loading, error } = useQuery(GET_MY_COUNTERPARTIES, { const { data, loading, error } = useQuery(GET_MY_COUNTERPARTIES, {
fetchPolicy: 'network-only', // Обходим кеш fetchPolicy: 'network-only', // Обходим кеш
errorPolicy: 'all' errorPolicy: 'all',
}); })
``` ```
4. **ОТСУТСТВИЕ ЛОГИРОВАНИЯ В РЕЗОЛВЕРЕ**: 4. **ОТСУТСТВИЕ ЛОГИРОВАНИЯ В РЕЗОЛВЕРЕ**:
@ -2392,6 +2604,7 @@ const wholesalePartners = await prisma.counterparty.findMany({
- Проверить что резолвер вызывается - Проверить что резолвер вызывается
**Чек-лист для диагностики**: **Чек-лист для диагностики**:
- [ ] Проверить правильность имени поля в коде (`myCounterparties`) - [ ] Проверить правильность имени поля в коде (`myCounterparties`)
- [ ] Убедиться что пользователь авторизован - [ ] Убедиться что пользователь авторизован
- [ ] Проверить логи сервера на вызов резолвера - [ ] Проверить логи сервера на вызов резолвера
@ -2527,6 +2740,9 @@ const wholesalePartners = await prisma.counterparty.findMany({
21. ❌ **ИСПОЛЬЗОВАТЬ МОКОВЫЕ ДАННЫЕ БЕЗ РАЗРЕШЕНИЯ** - все компоненты ОБЯЗАТЕЛЬНО должны использовать реальные GraphQL запросы. Моковые данные можно добавлять ТОЛЬКО с явного разрешения пользователя 21. ❌ **ИСПОЛЬЗОВАТЬ МОКОВЫЕ ДАННЫЕ БЕЗ РАЗРЕШЕНИЯ** - все компоненты ОБЯЗАТЕЛЬНО должны использовать реальные GraphQL запросы. Моковые данные можно добавлять ТОЛЬКО с явного разрешения пользователя
22. ❌ **ДОБАВЛЯТЬ ПОЛЕ РЫНКА К ТОВАРАМ** - рынок принадлежит организации поставщика (`Organization.market`), товары наследуют рынок через связь с организацией 22. ❌ **ДОБАВЛЯТЬ ПОЛЕ РЫНКА К ТОВАРАМ** - рынок принадлежит организации поставщика (`Organization.market`), товары наследуют рынок через связь с организацией
23. ❌ **ПУТАТЬ РЫНОК И МАРКЕТ** - РЫНОК = физическое место (Садовод, ТЯК), МАРКЕТ = раздел системы (/market) 23. ❌ **ПУТАТЬ РЫНОК И МАРКЕТ** - РЫНОК = физическое место (Садовод, ТЯК), МАРКЕТ = раздел системы (/market)
24. ❌ **ИСПОЛЬЗОВАТЬ НАЗВАНИЯ ОРГАНИЗАЦИЙ В ЛОГИКЕ БЕЗОПАСНОСТИ** - проверки доступа только по `organization.type` и системным ID
25. ❌ **СОЗДАВАТЬ УСЛОВИЯ НА ОСНОВЕ ПОЛЬЗОВАТЕЛЬСКИХ СТРОК** - никаких `if (name.includes())` для определения функционала
26. ❌ **ПУТАТЬ ДАННЫЕ И ФУНКЦИОНАЛ** - "ОПТ Маркет" (название рынка) ≠ "Маркет" (раздел системы)
### 17.2 ОБЯЗАТЕЛЬНЫЕ ПРАВИЛА: ### 17.2 ОБЯЗАТЕЛЬНЫЕ ПРАВИЛА:
@ -2541,6 +2757,66 @@ const wholesalePartners = await prisma.counterparty.findMany({
9. ✅ Соблюдение жизненного цикла статусов поставок 9. ✅ Соблюдение жизненного цикла статусов поставок
10. ✅ Фиксация план/факт в процессе создания продукта 10. ✅ Фиксация план/факт в процессе создания продукта
### 17.3 🔒 ПРАВИЛА БЕЗОПАСНОСТИ: Разделение данных и функционала
#### КРИТИЧЕСКОЕ ПРАВИЛО БЕЗОПАСНОСТИ
**ПРИНЦИП**: Названия организаций, рынков и любые пользовательские данные НИКОГДА не должны влиять на функционал и безопасность системы.
**ОБЯЗАТЕЛЬНЫЕ ПРАВИЛА:**
✅ **ПРАВИЛЬНЫЕ ПРОВЕРКИ:**
- Проверки доступа ТОЛЬКО по типу организации: `organization.type === 'WHOLESALE'`
- Роутинг ТОЛЬКО по предопределенным путям: `/market`, `/supplies` и т.д.
- Валидация ТОЛЬКО по ID и системным полям
- Фильтрация ТОЛЬКО по enum значениям из схемы
❌ **ЗАПРЕЩЕННЫЕ ПРОВЕРКИ (УЯЗВИМОСТИ):**
- Использование `organization.name` в условиях доступа
- Проверки по `organization.market` для определения функционала
- Любые проверки содержимого строк: `includes()`, `startsWith()`, `match()`
- Динамическое создание путей на основе пользовательских данных
**ПРИМЕРЫ:**
```typescript
// ❌ УЯЗВИМОСТЬ - название может быть любым
if (organization.name.includes('Маркет')) {
// предоставить специальный доступ
}
// ❌ УЯЗВИМОСТЬ - пользователь может подделать название
if (organization.market === 'special-market') {
// изменить цены
}
// ✅ БЕЗОПАСНО - проверка по системному типу
if (organization.type === 'WHOLESALE') {
// логика для поставщиков
}
// ✅ БЕЗОПАСНО - проверка по ID из whitelist
if (ALLOWED_FULFILLMENT_IDS.includes(organization.id)) {
// логика для проверенных фулфилментов
}
```
**РАЗДЕЛЕНИЕ КОНТЕКСТОВ:**
1. **ДАННЫЕ (могут быть любыми):**
- Названия организаций: "ОПТ Маркет", "Супер Склад", и т.д.
- Названия рынков: "Садовод", "ТЯК Москва", любые другие
- Любые пользовательские строки
2. **ФУНКЦИОНАЛ (строго определен):**
- Системные разделы: `/market`, `/supplies`, `/partners`
- Типы организаций: `WHOLESALE`, `SELLER`, `FULFILLMENT`, `LOGIST`
- Статусы и enum из Prisma схемы
**ПРАВИЛО**: Физический рынок "ОПТ Маркет" - это просто строка данных. Раздел "Маркет" (/market) - это системный функционал. Они никак не связаны и не должны влиять друг на друга.
--- ---
## 18. 🛠️ GRAPHQL И TYPESCRIPT ПРАВИЛА ## 18. 🛠️ GRAPHQL И TYPESCRIPT ПРАВИЛА
@ -2559,15 +2835,15 @@ export const GET_MY_COUNTERPARTIES = gql`
type type
} }
} }
`; `
// Использование в компоненте // Использование в компоненте
const allCounterparties = counterpartiesData?.myCounterparties || []; const allCounterparties = counterpartiesData?.myCounterparties || []
``` ```
```typescript ```typescript
// ❌ НЕПРАВИЛЬНО - не соответствует схеме // ❌ НЕПРАВИЛЬНО - не соответствует схеме
const allCounterparties = counterpartiesData?.getMyCounterparties || []; // Ошибка! const allCounterparties = counterpartiesData?.getMyCounterparties || [] // Ошибка!
``` ```
### 18.2 Правила отладки GraphQL ### 18.2 Правила отладки GraphQL
@ -2585,13 +2861,13 @@ const allCounterparties = counterpartiesData?.getMyCounterparties || []; // Ош
```typescript ```typescript
const { data, loading, error } = useQuery(QUERY_NAME, { const { data, loading, error } = useQuery(QUERY_NAME, {
fetchPolicy: 'network-only', // Обходим кеш при отладке fetchPolicy: 'network-only', // Обходим кеш при отладке
errorPolicy: 'all' // Показываем все ошибки errorPolicy: 'all', // Показываем все ошибки
}); })
// Логирование для отладки // Логирование для отладки
console.log("Data:", data); console.log('Data:', data)
console.log("Loading:", loading); console.log('Loading:', loading)
console.log("Error:", error); console.log('Error:', error)
``` ```
### 18.4 TypeScript Rules ### 18.4 TypeScript Rules
@ -2603,22 +2879,22 @@ console.log("Error:", error);
```typescript ```typescript
// ✅ ПРАВИЛЬНО - соответствует schema.prisma // ✅ ПРАВИЛЬНО - соответствует schema.prisma
interface GoodsProduct { interface GoodsProduct {
id: string; id: string
name: string; name: string
article: string; // <- соответствует полю в schema article: string // <- соответствует полю в schema
quantity?: number; // <- соответствует полю в schema quantity?: number // <- соответствует полю в schema
organization: { organization: {
id: string; id: string
name: string; name: string
}; }
} }
``` ```
```typescript ```typescript
// ❌ НЕПРАВИЛЬНО - не соответствует schema // ❌ НЕПРАВИЛЬНО - не соответствует schema
interface GoodsProduct { interface GoodsProduct {
sku: string; // <- в schema поле называется 'article' sku: string // <- в schema поле называется 'article'
stock?: number; // <- в schema поле называется 'quantity' stock?: number // <- в schema поле называется 'quantity'
} }
``` ```
@ -2813,6 +3089,7 @@ query GetMarketProducts {
### 22.2 12 специализированных категорий расходников ### 22.2 12 специализированных категорий расходников
#### 🎁 **1. УПАКОВКА И ЗАЩИТА** #### 🎁 **1. УПАКОВКА И ЗАЩИТА**
- Коробки (различных размеров) - Коробки (различных размеров)
- Пакеты (полиэтиленовые, бумажные, фирменные) - Пакеты (полиэтиленовые, бумажные, фирменные)
- Пузырчатая пленка, воздушные подушки - Пузырчатая пленка, воздушные подушки
@ -2820,6 +3097,7 @@ query GetMarketProducts {
- Паллетная пленка, защитные уголки - Паллетная пленка, защитные уголки
#### 🏷️ **2. МАРКИРОВКА И ИДЕНТИФИКАЦИЯ** #### 🏷️ **2. МАРКИРОВКА И ИДЕНТИФИКАЦИЯ**
- Этикетки (адресные, штрих-код, QR-код) - Этикетки (адресные, штрих-код, QR-код)
- Бирки (ценники, размерники) - Бирки (ценники, размерники)
- Стикеры и наклейки - Стикеры и наклейки
@ -2827,6 +3105,7 @@ query GetMarketProducts {
- Штампы и печати, термоэтикетки - Штампы и печати, термоэтикетки
#### 🔧 **3. КРЕПЕЖ И СОЕДИНЕНИЕ** #### 🔧 **3. КРЕПЕЖ И СОЕДИНЕНИЕ**
- Скотч (прозрачный, цветной, армированный) - Скотч (прозрачный, цветной, армированный)
- Клей и клеевые составы - Клей и клеевые составы
- Стяжки пластиковые - Стяжки пластиковые
@ -2834,6 +3113,7 @@ query GetMarketProducts {
- Веревки и шнуры, стрейч-лента - Веревки и шнуры, стрейч-лента
#### 📄 **4. ДОКУМЕНТООБОРОТ И ВКЛАДЫШИ** #### 📄 **4. ДОКУМЕНТООБОРОТ И ВКЛАДЫШИ**
- Накладные и сопроводительные документы - Накладные и сопроводительные документы
- Инструкции по эксплуатации - Инструкции по эксплуатации
- Гарантийные талоны - Гарантийные талоны
@ -2841,6 +3121,7 @@ query GetMarketProducts {
- Благодарственные письма, купоны и промокоды - Благодарственные письма, купоны и промокоды
#### 🧼 **5. ГИГИЕНА И БЕЗОПАСНОСТЬ** #### 🧼 **5. ГИГИЕНА И БЕЗОПАСНОСТЬ**
- Перчатки (латексные, нитриловые) - Перчатки (латексные, нитриловые)
- Маски и респираторы - Маски и респираторы
- Антисептики и дезинфекторы - Антисептики и дезинфекторы
@ -2848,6 +3129,7 @@ query GetMarketProducts {
- Фартуки и халаты, бахилы - Фартуки и халаты, бахилы
#### 🛠️ **6. ИНСТРУМЕНТЫ И ПРИСПОСОБЛЕНИЯ** #### 🛠️ **6. ИНСТРУМЕНТЫ И ПРИСПОСОБЛЕНИЯ**
- Ножи и резаки, ножницы - Ножи и резаки, ножницы
- Линейки и рулетки - Линейки и рулетки
- Упаковочные машины (ленточные) - Упаковочные машины (ленточные)
@ -2856,6 +3138,7 @@ query GetMarketProducts {
- Весы и мерная тара - Весы и мерная тара
#### 🎨 **7. БРЕНДИНГ И ДИЗАЙН** #### 🎨 **7. БРЕНДИНГ И ДИЗАЙН**
- Фирменные пакеты с логотипом - Фирменные пакеты с логотипом
- Брендированные коробки - Брендированные коробки
- Цветная упаковочная бумага - Цветная упаковочная бумага
@ -2864,6 +3147,7 @@ query GetMarketProducts {
- Подарочная упаковка - Подарочная упаковка
#### ⚡ **8. СПЕЦИАЛИЗИРОВАННЫЕ МАТЕРИАЛЫ** #### ⚡ **8. СПЕЦИАЛИЗИРОВАННЫЕ МАТЕРИАЛЫ**
- Антистатические пакеты - Антистатические пакеты
- Влагопоглотители - Влагопоглотители
- Температурные индикаторы - Температурные индикаторы
@ -2872,6 +3156,7 @@ query GetMarketProducts {
- Защита от краж (магнитные датчики) - Защита от краж (магнитные датчики)
#### 🏪 **9. ТОРГОВОЕ ОБОРУДОВАНИЕ** #### 🏪 **9. ТОРГОВОЕ ОБОРУДОВАНИЕ**
- Манекены и вешалки - Манекены и вешалки
- Ценникодержатели - Ценникодержатели
- Подставки и стойки - Подставки и стойки
@ -2880,6 +3165,7 @@ query GetMarketProducts {
- Освещение витрин - Освещение витрин
#### 🚚 **10. ЛОГИСТИКА И СКЛАДИРОВАНИЕ** #### 🚚 **10. ЛОГИСТИКА И СКЛАДИРОВАНИЕ**
- Паллеты и поддоны - Паллеты и поддоны
- Контейнеры и ящики - Контейнеры и ящики
- Стеллажные системы - Стеллажные системы
@ -2888,6 +3174,7 @@ query GetMarketProducts {
- Адресные ярлыки для груза - Адресные ярлыки для груза
#### 💻 **11. ТЕХНИЧЕСКИЕ РАСХОДНИКИ** #### 💻 **11. ТЕХНИЧЕСКИЕ РАСХОДНИКИ**
- Картриджи для принтеров - Картриджи для принтеров
- Термоголовки, красящие ленты - Термоголовки, красящие ленты
- Батарейки для сканеров - Батарейки для сканеров
@ -2895,6 +3182,7 @@ query GetMarketProducts {
- Запчасти для упаковочного оборудования - Запчасти для упаковочного оборудования
#### 🎪 **12. СЕЗОННЫЕ И ПРАЗДНИЧНЫЕ** #### 🎪 **12. СЕЗОННЫЕ И ПРАЗДНИЧНЫЕ**
- Новогодняя упаковка - Новогодняя упаковка
- Подарочные мешки - Подарочные мешки
- Праздничные ленты - Праздничные ленты
@ -2940,21 +3228,25 @@ query GetMarketProducts {
### 🔴 Отмена заказов на разных этапах workflow ### 🔴 Отмена заказов на разных этапах workflow
**PENDING → Отмена разрешена** **PENDING → Отмена разрешена**
- Действие: Удаление заказа без последствий - Действие: Удаление заказа без последствий
- Уведомления: Поставщику о отмене - Уведомления: Поставщику о отмене
- Влияние на статистику: Нет - Влияние на статистику: Нет
**SUPPLIER_APPROVED → Отмена с согласия поставщика** **SUPPLIER_APPROVED → Отмена с согласия поставщика**
- Действие: Требуется подтверждение поставщика - Действие: Требуется подтверждение поставщика
- Штрафы: Возможны согласно договору - Штрафы: Возможны согласно договору
- Восстановление: Товары возвращаются в доступные остатки - Восстановление: Товары возвращаются в доступные остатки
**CONFIRMED/LOGISTICS_CONFIRMED → Отмена критическая** **CONFIRMED/LOGISTICS_CONFIRMED → Отмена критическая**
- Действие: Требуется согласие всех участников - Действие: Требуется согласие всех участников
- Штрафы: Логистические расходы - Штрафы: Логистические расходы
- Альтернатива: Изменение адреса доставки - Альтернатива: Изменение адреса доставки
**SHIPPED/IN_TRANSIT → Отмена невозможна** **SHIPPED/IN_TRANSIT → Отмена невозможна**
- Действие: Только возврат после получения - Действие: Только возврат после получения
- Процедура: Через модуль "Возвраты с ПВЗ" - Процедура: Через модуль "Возвраты с ПВЗ"
@ -2963,6 +3255,7 @@ query GetMarketProducts {
**Сценарий**: Поставщик доставил 80 из 100 заказанных единиц **Сценарий**: Поставщик доставил 80 из 100 заказанных единиц
**Алгоритм обработки**: **Алгоритм обработки**:
1. Фулфилмент фиксирует фактическое количество 1. Фулфилмент фиксирует фактическое количество
2. Система создает два отдельных документа: 2. Система создает два отдельных документа:
- DELIVERED (80 единиц) - обрабатывается обычным порядком - DELIVERED (80 единиц) - обрабатывается обычным порядком
@ -2975,9 +3268,10 @@ query GetMarketProducts {
**Проблема**: Попытка заказать больше чем есть у поставщика **Проблема**: Попытка заказать больше чем есть у поставщика
**Техническая реализация**: **Техническая реализация**:
```typescript ```typescript
if (requestedQuantity > availableStock) { if (requestedQuantity > availableStock) {
throw new GraphQLError(`Недостаточно товара. Доступно: ${availableStock}, запрошено: ${requestedQuantity}`); throw new GraphQLError(`Недостаточно товара. Доступно: ${availableStock}, запрошено: ${requestedQuantity}`)
} }
``` ```
@ -2988,6 +3282,7 @@ if (requestedQuantity > availableStock) {
**Сценарий**: Поставщик пытается создать товар с существующим артикулом **Сценарий**: Поставщик пытается создать товар с существующим артикулом
**Проверка на уровне БД**: **Проверка на уровне БД**:
```sql ```sql
UNIQUE INDEX ON products(article, organization_id) UNIQUE INDEX ON products(article, organization_id)
``` ```
@ -3002,35 +3297,35 @@ UNIQUE INDEX ON products(article, organization_id)
```typescript ```typescript
// Основные запросы // Основные запросы
GET_MY_SERVICES; // Услуги фулфилмента GET_MY_SERVICES // Услуги фулфилмента
GET_MY_LOGISTICS; // Логистические маршруты GET_MY_LOGISTICS // Логистические маршруты
GET_MY_EMPLOYEES; // Сотрудники организации GET_MY_EMPLOYEES // Сотрудники организации
GET_FULFILLMENT_WAREHOUSE_STATS; // Статистика склада GET_FULFILLMENT_WAREHOUSE_STATS // Статистика склада
GET_WAREHOUSE_PRODUCTS; // Товары на складе GET_WAREHOUSE_PRODUCTS // Товары на складе
GET_MY_FULFILLMENT_SUPPLIES; // Расходники фулфилмента GET_MY_FULFILLMENT_SUPPLIES // Расходники фулфилмента
GET_EMPLOYEE_SCHEDULE; // Табель рабочего времени GET_EMPLOYEE_SCHEDULE // Табель рабочего времени
// Мутации // Мутации
CREATE_SERVICE, UPDATE_SERVICE, DELETE_SERVICE; ;(CREATE_SERVICE, UPDATE_SERVICE, DELETE_SERVICE)
CREATE_LOGISTICS, UPDATE_LOGISTICS, DELETE_LOGISTICS; ;(CREATE_LOGISTICS, UPDATE_LOGISTICS, DELETE_LOGISTICS)
CREATE_EMPLOYEE, UPDATE_EMPLOYEE, DELETE_EMPLOYEE; ;(CREATE_EMPLOYEE, UPDATE_EMPLOYEE, DELETE_EMPLOYEE)
UPDATE_EMPLOYEE_SCHEDULE; // Обновление табеля UPDATE_EMPLOYEE_SCHEDULE // Обновление табеля
``` ```
### Приложение B: Компоненты фулфилмента ### Приложение B: Компоненты фулфилмента
```typescript ```typescript
// Основные dashboard компоненты // Основные dashboard компоненты
FulfillmentWarehouseDashboard; // Склад фулфилмента FulfillmentWarehouseDashboard // Склад фулфилмента
FulfillmentStatisticsDashboard; // Статистика FulfillmentStatisticsDashboard // Статистика
ServicesDashboard; // Услуги (3 вкладки) ServicesDashboard // Услуги (3 вкладки)
EmployeesDashboard; // Сотрудники EmployeesDashboard // Сотрудники
SuppliesDashboard; // Поставки фулфилмента SuppliesDashboard // Поставки фулфилмента
// Специализированные компоненты // Специализированные компоненты
ServicesTab, LogisticsTab, SuppliesTab; // Вкладки услуг ;(ServicesTab, LogisticsTab, SuppliesTab) // Вкладки услуг
EmployeeInlineForm, EmployeeEditInlineForm; // Формы сотрудников ;(EmployeeInlineForm, EmployeeEditInlineForm) // Формы сотрудников
FulfillmentSuppliesTab, FulfillmentConsumablesOrdersTab; // Поставки ;(FulfillmentSuppliesTab, FulfillmentConsumablesOrdersTab) // Поставки
``` ```
### Приложение C: Специальный роутинг для типов организаций ### Приложение C: Специальный роутинг для типов организаций
@ -3038,31 +3333,32 @@ FulfillmentSuppliesTab, FulfillmentConsumablesOrdersTab; // Поставки
```typescript ```typescript
const handleSuppliesClick = () => { const handleSuppliesClick = () => {
switch (user?.organization?.type) { switch (user?.organization?.type) {
case "FULFILLMENT": case 'FULFILLMENT':
router.push("/fulfillment-supplies"); // Специальный роут router.push('/fulfillment-supplies') // Специальный роут
break; break
case "SELLER": case 'SELLER':
router.push("/supplies"); router.push('/supplies')
break; break
case "WHOLESALE": case 'WHOLESALE':
router.push("/wholesale-supplies"); router.push('/wholesale-supplies')
break; break
case "LOGIST": case 'LOGIST':
router.push("/logist-supplies"); router.push('/logist-supplies')
break; break
} }
}; }
``` ```
--- ---
_Эта база знаний создана путем объединения rules-unified.md (v3.0) и fulfillment-cabinet-rules.md (v1.0) с устранением всех несоответствий и добавлением критически важных улучшений: быстрый справочник, глоссарий терминов, детальные алгоритмы процессов, edge cases._ _Эта база знаний создана путем объединения rules-unified.md (v3.0) и fulfillment-cabinet-rules.md (v1.0) с устранением всех несоответствий и добавлением критически важных улучшений: быстрый справочник, глоссарий терминов, детальные алгоритмы процессов, edge cases._
_Версия: 9.2_ _Версия: 10.0_
ата создания: 2025_ ата создания: 2025_
_Статус: ЕДИНЫЙ ИСТОЧНИК ИСТИНЫ - ГОТОВ К РАЗРАБОТКЕ_ _Статус: ЕДИНЫЙ ИСТОЧНИК ИСТИНЫ - ГОТОВ К РАЗРАБОТКЕ_
### 🚀 УЛУЧШЕНИЯ v6.0: ### 🚀 УЛУЧШЕНИЯ v6.0:
- Быстрый справочник критических правил - Быстрый справочник критических правил
- 🔤 Полный глоссарий терминов с определениями - 🔤 Полный глоссарий терминов с определениями
- 🎯 Навигация по ролям (разработчики, аналитики, менеджеры) - 🎯 Навигация по ролям (разработчики, аналитики, менеджеры)
@ -3072,6 +3368,7 @@ _Статус: ЕДИНЫЙ ИСТОЧНИК ИСТИНЫ - ГОТОВ К РАЗ
- 📊 Таблицы SLA и временных рамок - 📊 Таблицы SLA и временных рамок
### 🔧 ИСПРАВЛЕНИЯ v6.1: ### 🔧 ИСПРАВЛЕНИЯ v6.1:
- Устранено противоречие в моменте создания БРАКА - Устранено противоречие в моменте создания БРАКА
- Исправлена логическая цепочка: рецептура задается селлером ДО процесса - Исправлена логическая цепочка: рецептура задается селлером ДО процесса
- Реалистичные временные рамки SLA (рабочие дни вместо часов) - Реалистичные временные рамки SLA (рабочие дни вместо часов)
@ -3079,11 +3376,13 @@ _Статус: ЕДИНЫЙ ИСТОЧНИК ИСТИНЫ - ГОТОВ К РАЗ
- Согласованы все алгоритмы и процессы между разделами - Согласованы все алгоритмы и процессы между разделами
### 🔧 ОБНОВЛЕНИЯ v6.3: ### 🔧 ОБНОВЛЕНИЯ v6.3:
- **ДОБАВЛЕН КРИТИЧЕСКИЙ ЗАПРЕТ**: Использование моковых данных в продакшене - **ДОБАВЛЕН КРИТИЧЕСКИЙ ЗАПРЕТ**: Использование моковых данных в продакшене
- **ОБНОВЛЕН ЧЕКЛИСТ**: Добавлена проверка на отсутствие mock данных - **ОБНОВЛЕН ЧЕКЛИСТ**: Добавлена проверка на отсутствие mock данных
- **РЕАЛИЗАЦИЯ**: Полная очистка моковых данных из раздела "Мои поставки" селлера - **РЕАЛИЗАЦИЯ**: Полная очистка моковых данных из раздела "Мои поставки" селлера
### 🎨 ИНТЕГРАЦИЯ v6.2: ### 🎨 ИНТЕГРАЦИЯ v6.2:
- Синхронизация с visual-design-rules.md v1.1 - Синхронизация с visual-design-rules.md v1.1
- Добавлены визуальные правила для 8 статусов поставок - Добавлены визуальные правила для 8 статусов поставок
- Создана цветовая система для 6 модулей фулфилмента - Создана цветовая система для 6 модулей фулфилмента
@ -3092,23 +3391,27 @@ _Статус: ЕДИНЫЙ ИСТОЧНИК ИСТИНЫ - ГОТОВ К РАЗ
- Покрытие визуальными решениями увеличено с 40% до 85% - Покрытие визуальными решениями увеличено с 40% до 85%
### 🚀 КОНСОЛИДАЦИЯ v7.0: ### 🚀 КОНСОЛИДАЦИЯ v7.0:
- Интеграция development-checklist.md и CLAUDE.md - Интеграция development-checklist.md и CLAUDE.md
- Удаление дублирующих файлов - Удаление дублирующих файлов
- Создание единого источника истины - Создание единого источника истины
### 🔧 ПОЛНАЯ ИНТЕГРАЦИЯ v8.0: ### 🔧 ПОЛНАЯ ИНТЕГРАЦИЯ v8.0:
- Интеграция work-protocols.md (детальные протоколы по сложности) - Интеграция work-protocols.md (детальные протоколы по сложности)
- Интеграция violation-prevention-protocol.md (СТОП-сигналы и триггеры) - Интеграция violation-prevention-protocol.md (СТОП-сигналы и триггеры)
- Интеграция self-validation.md (расширенная система самопроверки) - Интеграция self-validation.md (расширенная система самопроверки)
- Удаление всех дублирующих файлов протоколов - Удаление всех дублирующих файлов протоколов
### 🎯 ОПТИМИЗАЦИЯ UI/UX v8.1: ### 🎯 ОПТИМИЗАЦИЯ UI/UX v8.1:
- Добавлен ТРИГГЕР #3 для автоматической активации visual-design-rules.md - Добавлен ТРИГГЕР #3 для автоматической активации visual-design-rules.md
- Интегрирован специальный UI/UX протокол в чеклист - Интегрирован специальный UI/UX протокол в чеклист
- Создана система перекрестных ссылок с visual-design-rules.md - Создана система перекрестных ссылок с visual-design-rules.md
- visual-design-rules.md остается отдельным специализированным файлом - visual-design-rules.md остается отдельным специализированным файлом
### 📊 ИНТЕГРАЦИЯ DESCRIPTION v9.0: ### 📊 ИНТЕГРАЦИЯ DESCRIPTION v9.0:
- Добавлена UI структура создания поставки расходников (3 блока) - Добавлена UI структура создания поставки расходников (3 блока)
- Интегрирована концепция многоуровневых таблиц - Интегрирована концепция многоуровневых таблиц
- Добавлен механизм учета ПЛАН/ФАКТ в процессе создания продукта - Добавлен механизм учета ПЛАН/ФАКТ в процессе создания продукта
@ -3116,6 +3419,7 @@ _Статус: ЕДИНЫЙ ИСТОЧНИК ИСТИНЫ - ГОТОВ К РАЗ
- Добавлена опция места хранения готовых продуктов - Добавлена опция места хранения готовых продуктов
### 🔧 УТОЧНЕНИЯ ЛОГИКИ v9.1: ### 🔧 УТОЧНЕНИЯ ЛОГИКИ v9.1:
- Уточнен статус брака: НЕ РЕАЛИЗОВАНО (еще не дошли до этого этапа) - Уточнен статус брака: НЕ РЕАЛИЗОВАНО (еще не дошли до этого этапа)
- Добавлены четкие правила создания предметов по ролям - Добавлены четкие правила создания предметов по ролям
- Добавлен экономический учет расходников фулфилмента для селлера - Добавлен экономический учет расходников фулфилмента для селлера
@ -3123,8 +3427,17 @@ _Статус: ЕДИНЫЙ ИСТОЧНИК ИСТИНЫ - ГОТОВ К РАЗ
- Добавлена заметка о будущей детализации статусов товаров - Добавлена заметка о будущей детализации статусов товаров
### 🎨 UI УЛУЧШЕНИЯ v9.2: ### 🎨 UI УЛУЧШЕНИЯ v9.2:
- Добавлены детальные правила горизонтального скролла для блока поставщиков - Добавлены детальные правила горизонтального скролла для блока поставщиков
- Реализован горизонтальный скролл в create-suppliers-supply-page.tsx - Реализован горизонтальный скролл в create-suppliers-supply-page.tsx
- Добавлена адаптивность (десктоп 280px, планшет 260px, мобильный 240px) - Добавлена адаптивность (десктоп 280px, планшет 260px, мобильный 240px)
- Интегрированы ARIA атрибуты для доступности - Интегрированы ARIA атрибуты для доступности
- Реализовано автоскрытие полосы прокрутки и навигация клавиатурой - Реализовано автоскрытие полосы прокрутки и навигация клавиатурой
### 🔒 БЕЗОПАСНОСТЬ И ТЕРМИНОЛОГИЯ v10.0:
- **ДОБАВЛЕН РАЗДЕЛ 17.3**: Правила безопасности - разделение данных и функционала
- **НОВЫЕ ЗАПРЕТЫ 24-26**: Запрет использования пользовательских данных в логике безопасности
- **РАСШИРЕН ГЛОССАРИЙ**: Контекстно-зависимые термины для SupplyOrder
- **УТОЧНЕНИЕ ТЕРМИНОВ**: Четкое разделение "Маркет" (раздел) vs "Маркетплейс" (внешние площадки)
- **ПРИМЕРЫ УЯЗВИМОСТЕЙ**: Конкретные примеры безопасного и небезопасного кода