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:
@ -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 "Маркетплейс" (внешние площадки)
|
||||||
|
- ✅ **ПРИМЕРЫ УЯЗВИМОСТЕЙ**: Конкретные примеры безопасного и небезопасного кода
|
||||||
|
Reference in New Issue
Block a user