Создан единый источник истины rules-complete.md v9.1 с полной интеграцией всех правил системы. Консолидированы правила создания предметов по ролям, уточнен статус брака (НЕ РЕАЛИЗОВАНО), обновлен механизм учета ПЛАН/ФАКТ с заменой брака на потери при пересчете. Добавлен экономический учет расходников фулфилмента для селлера через рецептуру. Удалены дублирующие файлы правил (CLAUDE.md, development-checklist.md, work-protocols.md, violation-prevention-protocol.md, self-validation.md, description.md). Интегрированы UI структуры создания поставок и концепция многоуровневых таблиц.
🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
58
CLAUDE.md
58
CLAUDE.md
@ -1,58 +0,0 @@
|
|||||||
# СИСТЕМНЫЕ ПРАВИЛА ДЛЯ CLAUDE CODE
|
|
||||||
|
|
||||||
## 🚨 ОБЯЗАТЕЛЬНЫЕ ФАЙЛЫ ДЛЯ ПРОВЕРКИ
|
|
||||||
|
|
||||||
**ПЕРЕД ЛЮБЫМ ИЗМЕНЕНИЕМ КОДА ВСЕГДА ЧИТАТЬ:**
|
|
||||||
|
|
||||||
1. **`development-checklist.md`** - Критические проверки и запреты
|
|
||||||
2. **`rules-unified.md`** - Полная база знаний системы (v4.0)
|
|
||||||
3. **`fulfillment-cabinet-rules.md`** - Правила кабинета фулфилмента
|
|
||||||
4. **`visual-design-rules.md`** - Правила визуального дизайна
|
|
||||||
|
|
||||||
> **Архивированы**: `rules.md`, `rules1.md`, `rules2.md` → `archive/`
|
|
||||||
|
|
||||||
## 🔄 WORKFLOW РАЗРАБОТКИ
|
|
||||||
|
|
||||||
### Шаг 1: Анализ задачи
|
|
||||||
- [ ] Прочитать `development-checklist.md`
|
|
||||||
- [ ] Проверить применимые правила из всех файлов правил
|
|
||||||
- [ ] Убедиться что задача не нарушает критические запреты
|
|
||||||
|
|
||||||
### Шаг 2: Планирование
|
|
||||||
- [ ] Использовать TodoWrite для планирования задач
|
|
||||||
- [ ] Проверить соответствие архитектуре системы
|
|
||||||
- [ ] Учесть все обязательные проверки
|
|
||||||
|
|
||||||
### Шаг 3: Реализация
|
|
||||||
- [ ] Следовать техническим правилам (GraphQL, TypeScript)
|
|
||||||
- [ ] Соблюдать систему партнерства и типизацию
|
|
||||||
- [ ] Добавлять необходимое логирование
|
|
||||||
|
|
||||||
### Шаг 4: Проверка
|
|
||||||
- [ ] Проверить все пункты checklist'а
|
|
||||||
- [ ] Протестировать функциональность
|
|
||||||
- [ ] Убедиться в отсутствии нарушений запретов
|
|
||||||
|
|
||||||
## 🎯 КЛЮЧЕВЫЕ ПРИНЦИПЫ
|
|
||||||
|
|
||||||
1. **НЕ ПРЕДПОЛАГАТЬ** - всегда уточнять при сомнениях
|
|
||||||
2. **ПРОВЕРЯТЬ СХЕМЫ** - GraphQL и Prisma должны соответствовать коду
|
|
||||||
3. **СЛЕДОВАТЬ WORKFLOW** - не нарушать последовательность статусов
|
|
||||||
4. **ДОКУМЕНТИРОВАТЬ** - обновлять правила при решении проблем
|
|
||||||
|
|
||||||
## 📋 КРИТИЧЕСКИЕ ФАЙЛЫ
|
|
||||||
|
|
||||||
### Файлы с правилами (ВСЕГДА ПРОВЕРЯТЬ):
|
|
||||||
- `development-checklist.md` - ОБЯЗАТЕЛЬНЫЕ проверки
|
|
||||||
- `rules-unified.md` - Полная база знаний системы (v4.0)
|
|
||||||
- `fulfillment-cabinet-rules.md` - Правила кабинета фулфилмента
|
|
||||||
- `visual-design-rules.md` - Правила визуального дизайна
|
|
||||||
|
|
||||||
### Технические файлы:
|
|
||||||
- `prisma/schema.prisma` - Схема базы данных
|
|
||||||
- `src/graphql/typedefs.ts` - GraphQL схема
|
|
||||||
- `src/graphql/resolvers.ts` - GraphQL резолверы
|
|
||||||
|
|
||||||
## 🚨 НАПОМИНАНИЕ
|
|
||||||
|
|
||||||
**ЭТОТ ФАЙЛ СЛУЖИТ ПОСТОЯННЫМ НАПОМИНАНИЕМ О НЕОБХОДИМОСТИ ПРОВЕРКИ ВСЕХ ФАЙЛОВ С ПРАВИЛАМИ ПЕРЕД КАЖДЫМ ИЗМЕНЕНИЕМ КОДА!**
|
|
@ -1,813 +0,0 @@
|
|||||||
# ПРАВИЛА СИСТЕМЫ СКЛАДА ПОСТАВЩИКА
|
|
||||||
|
|
||||||
> ⚠️ **ВАЖНОЕ ПРИМЕЧАНИЕ**: Данные из этого файла могут быть удалены только с разрешения пользователя. Все изменения должны согласовываться.
|
|
||||||
|
|
||||||
## 🔤 ТЕРМИНЫ СИСТЕМЫ
|
|
||||||
> Для людей → `В коде`
|
|
||||||
- ТОВАР → `PRODUCT`
|
|
||||||
- РАСХОДНИКИ → `CONSUMABLE`
|
|
||||||
- БРАК → `DEFECT` *(планируется)*
|
|
||||||
- ПРОДУКТ → `FINISHED_PRODUCT` *(планируется)*
|
|
||||||
|
|
||||||
## 1. 🎯 ОСНОВНЫЕ ПРИНЦИПЫ
|
|
||||||
|
|
||||||
### 1.0 Структура системы по кабинетам
|
|
||||||
|
|
||||||
**🏢 КАБИНЕТ ПОСТАВЩИКА** - управляет созданием и поставкой:
|
|
||||||
|
|
||||||
- **ТОВАР** - базовые товары от поставщика
|
|
||||||
- **РАСХОДНИКИ** - материалы и вспомогательные товары
|
|
||||||
|
|
||||||
**🏭 КАБИНЕТ ФУЛФИЛМЕНТА** - принимает, обрабатывает и управляет всеми типами:
|
|
||||||
|
|
||||||
- **ТОВАР** - базовые товары от поставщиков (принятые на склад)
|
|
||||||
- **БРАК** - товары с дефектами (производные от товара)
|
|
||||||
- **ПРОДУКТ** - готовые к продаже товары (производные от товара)
|
|
||||||
- **РАСХОДНИКИ ФУЛФИЛМЕНТА** - операционные материалы фулфилмента
|
|
||||||
- **РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для товаров селлеров
|
|
||||||
|
|
||||||
### 1.1 Типизация предметов
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Каждый предмет должен иметь один из следующих типов:
|
|
||||||
|
|
||||||
**ТИПЫ ПРЕДМЕТОВ ПО КАБИНЕТАМ:**
|
|
||||||
|
|
||||||
**🏢 КАБИНЕТ ПОСТАВЩИКА:**
|
|
||||||
|
|
||||||
1. **ТОВАР** (`PRODUCT`) - базовый тип товара от поставщика
|
|
||||||
2. **РАСХОДНИКИ** (`CONSUMABLE`) - материалы и вспомогательные товары от поставщика
|
|
||||||
|
|
||||||
**🏭 КАБИНЕТ ФУЛФИЛМЕНТА:**
|
|
||||||
|
|
||||||
1. **ТОВАР** (`PRODUCT`) - базовые товары от поставщиков (принятые на склад)
|
|
||||||
2. **БРАК** (`DEFECT` - планируется) - производная от товара (товар с дефектами)
|
|
||||||
3. **ПРОДУКТ** (`FINISHED_PRODUCT` - планируется) - готовый к продаже товар
|
|
||||||
4. **РАСХОДНИКИ ФУЛФИЛМЕНТА** - операционные материалы фулфилмента
|
|
||||||
5. **РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для товаров селлеров
|
|
||||||
|
|
||||||
- **ЗАПРЕЩЕНО**: Создание предметов без указания типа
|
|
||||||
- **ВАЖНО**: Товар ≠ Продукт (это разные сущности в системе)
|
|
||||||
- **ПРАВИЛО**: Тип определяет логику обработки, отображения и workflow в системе
|
|
||||||
- **КЛАССИФИКАЦИЯ РАСХОДНИКОВ**: Поставщик создает просто "РАСХОДНИКИ". При заказе, в зависимости от типа заказчика, они становятся:
|
|
||||||
- **Расходники фулфилмента** - если заказывает фулфилмент-центр
|
|
||||||
- **Расходники селлеров** - если заказывает селлер
|
|
||||||
|
|
||||||
### 1.2 Правила производных типов
|
|
||||||
|
|
||||||
- **БРАК**:
|
|
||||||
|
|
||||||
- **ПРОИСХОЖДЕНИЕ**: Создается на основе существующего товара
|
|
||||||
- **СВЯЗЬ**: Обязательная связь с родительским товаром
|
|
||||||
- **УЧЕТ**: Отдельный учет в статистике потерь
|
|
||||||
- **WORKFLOW**: Особый процесс списания и утилизации
|
|
||||||
|
|
||||||
- **ПРОДУКТ**:
|
|
||||||
|
|
||||||
- **ПРОИСХОЖДЕНИЕ**: Создается на основе товара после обработки
|
|
||||||
- **ОТЛИЧИЕ**: Товар - сырье, Продукт - готовая единица к продаже
|
|
||||||
- **СТАТУС**: Имеет собственный жизненный цикл
|
|
||||||
- **УЧЕТ**: Отдельная статистика от базового товара
|
|
||||||
|
|
||||||
- **РАСХОДНИКИ ФУЛФИЛМЕНТА**:
|
|
||||||
|
|
||||||
- **НАЗНАЧЕНИЕ**: Для внутренних операций фулфилмент-центра
|
|
||||||
- **ЗАКАЗЧИК**: Фулфилмент-центр заказывает для себя
|
|
||||||
- **УЧЕТ**: В статистике операционных расходов фулфилмента
|
|
||||||
|
|
||||||
- **РАСХОДНИКИ СЕЛЛЕРОВ**:
|
|
||||||
- **НАЗНАЧЕНИЕ**: Для товаров и операций селлеров
|
|
||||||
- **ЗАКАЗЧИК**: Селлер заказывает через фулфилмент
|
|
||||||
- **УЧЕТ**: В статистике расходов селлера
|
|
||||||
|
|
||||||
### 1.3 Уникальность артикулов
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Артикул должен быть уникальным в рамках организации
|
|
||||||
- **ПРАВИЛО**: Система должна автоматически генерировать артикул СФ при создании
|
|
||||||
- **ФОРМАТ**: `СФ-{ТИП}-{КОД_КАТЕГОРИИ}-{КОД_ОРГАНИЗАЦИИ}-{TIMESTAMP}-{RANDOM}`
|
|
||||||
- **ТИПЫ В АРТИКУЛЕ**:
|
|
||||||
- `TOV` - Товар
|
|
||||||
- `BRK` - Брак
|
|
||||||
- `R` - Расходники (классифицируются при заказе)
|
|
||||||
- `PRD` - Продукт
|
|
||||||
|
|
||||||
### 1.4 Обязательные поля
|
|
||||||
|
|
||||||
- **КРИТИЧЕСКИ ВАЖНО**: Название, артикул, цена > 0, тип предмета
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Количество (может быть 0 для предзаказа)
|
|
||||||
- **ДЛЯ ПРОИЗВОДНЫХ ТИПОВ**: Обязательная связь с родительским предметом (для брака и продукта)
|
|
||||||
- **ДЛЯ РАСХОДНИКОВ**: Обязательно указание подтипа (фулфилмента или селлеров)
|
|
||||||
- **РЕКОМЕНДУЕТСЯ**: Описание, категория, основное изображение
|
|
||||||
|
|
||||||
## 2. 🔒 ПРАВИЛА ДОСТУПА И БЕЗОПАСНОСТИ
|
|
||||||
|
|
||||||
### 2.1 Контроль доступа
|
|
||||||
|
|
||||||
- **ЗАПРЕЩЕНО**: Поставщик не может добавлять собственные предметы в корзину
|
|
||||||
- **ПРАВИЛО**: Только активные предметы (`isActive: true`) отображаются в маркете
|
|
||||||
- **ОГРАНИЧЕНИЕ**: Доступ к заказам только для участников процесса (создатель, поставщик, фулфилмент)
|
|
||||||
- **ПО ТИПАМ ПРЕДМЕТОВ**:
|
|
||||||
- **ТОВАР**: Доступен всем типам организаций для заказа
|
|
||||||
- **БРАК**: Доступен только для просмотра, заказ запрещен
|
|
||||||
- **РАСХОДНИКИ**: Доступны всем типам организаций для заказа
|
|
||||||
- При заказе фулфилмент-центром классифицируются как "расходники фулфилмента"
|
|
||||||
- При заказе селлером классифицируются как "расходники селлеров"
|
|
||||||
- **ПРОДУКТ**: Доступен для заказа после подтверждения готовности
|
|
||||||
|
|
||||||
### 2.2 Проверка остатков
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Проверять наличие предмета перед добавлением в корзину
|
|
||||||
- **ПРАВИЛО**: Количество в заказе не может превышать остаток на складе
|
|
||||||
- **ИСКЛЮЧЕНИЕ**: Предзаказы (если реализована функция)
|
|
||||||
- **ОСОБЕННОСТИ ПО ТИПАМ**:
|
|
||||||
- **ТОВАР/ПРОДУКТ**: Стандартная проверка остатков
|
|
||||||
- **БРАК**: Остатки учитываются, но заказ запрещен
|
|
||||||
- **РАСХОДНИКИ**: Проверка с учетом резервирования под активные заказы
|
|
||||||
|
|
||||||
### 2.3 Валидация данных
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Проверка корректности всех числовых значений (цена, вес, количество)
|
|
||||||
- **ПРАВИЛО**: Цена должна быть больше 0
|
|
||||||
- **ОГРАНИЧЕНИЕ**: Вес и габариты должны быть положительными числами
|
|
||||||
|
|
||||||
## 3. 📊 ПРАВИЛА СТАТИСТИКИ И АНАЛИТИКИ
|
|
||||||
|
|
||||||
### 3.1 Актуализация данных
|
|
||||||
|
|
||||||
- **КРИТИЧЕСКИ ВАЖНО**: При изменении количества в карточке данные актуализируются во всей системе
|
|
||||||
- **ПРАВИЛО**: Статистика обновляется в реальном времени
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Отслеживание изменений для аналитики
|
|
||||||
|
|
||||||
### 3.2 Отображение метрик
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Блок статистики в верхней части раздела склад
|
|
||||||
- **СОСТАВ**: Общие остатки, заказано, в пути, остаток, продано
|
|
||||||
- **ПРАВИЛО**: Подсвечивать предметы с остатками ниже критического уровня
|
|
||||||
- **РАЗДЕЛЕНИЕ ПО ТИПАМ И КАБИНЕТАМ**:
|
|
||||||
|
|
||||||
**В КАБИНЕТЕ ПОСТАВЩИКА**:
|
|
||||||
|
|
||||||
- **ТОВАРЫ**: Общая статистика товаров поставщика
|
|
||||||
- **РАСХОДНИКИ**: Материалы и вспомогательные товары (классифицируются при заказе)
|
|
||||||
|
|
||||||
**В КАБИНЕТЕ ФУЛФИЛМЕНТА**:
|
|
||||||
|
|
||||||
- **ТОВАРЫ**: Базовые товары от поставщиков (принятые на склад)
|
|
||||||
- **ПРОДУКТЫ**: Отдельный блок готовой продукции
|
|
||||||
- **БРАК**: Статистика потерь и списаний
|
|
||||||
- **РАСХОДНИКИ ФУЛФИЛМЕНТА**: Операционные материалы фулфилмента
|
|
||||||
- **РАСХОДНИКИ СЕЛЛЕРОВ**: Материалы для товаров селлеров
|
|
||||||
|
|
||||||
## 4. 🚚 ПРАВИЛА WORKFLOW ПОСТАВОК
|
|
||||||
|
|
||||||
### 4.1 Жизненный цикл статусов
|
|
||||||
|
|
||||||
```
|
|
||||||
PENDING → SUPPLIER_APPROVED → CONFIRMED → LOGISTICS_CONFIRMED → SHIPPED → IN_TRANSIT → DELIVERED
|
|
||||||
```
|
|
||||||
|
|
||||||
- **ЗАПРЕЩЕНО**: Пропускать промежуточные статусы
|
|
||||||
- **ПРАВИЛО**: Каждое изменение статуса должно сопровождаться уведомлением
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Логирование всех изменений статусов
|
|
||||||
|
|
||||||
### 4.2 Уведомления
|
|
||||||
|
|
||||||
- **АВТОМАТИЧЕСКИ**: Отправка уведомления поставщику при создании заказа
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Уведомление всех участников при изменении статуса
|
|
||||||
- **ФОРМАТ**: Структурированные сообщения с деталями заказа
|
|
||||||
|
|
||||||
### 4.3 Роли и ответственность
|
|
||||||
|
|
||||||
- **ПОСТАВЩИК**: Создание товаров, одобрение заказов, отгрузка
|
|
||||||
- **СЕЛЛЕР**: Создание заказов, отслеживание поставок
|
|
||||||
- **ФУЛФИЛМЕНТ**: Приемка товаров, выбор логистики, управление складом
|
|
||||||
- **ЛОГИСТИКА**: Подтверждение доставки, транспортировка
|
|
||||||
|
|
||||||
## 5. 🖼️ ПРАВИЛА РАБОТЫ С ИЗОБРАЖЕНИЯМИ
|
|
||||||
|
|
||||||
### 5.1 Управление изображениями
|
|
||||||
|
|
||||||
- **РЕКОМЕНДУЕТСЯ**: Загружать несколько изображений для каждого товара
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Выбирать основное изображение для отображения в списках
|
|
||||||
- **ПРАВИЛО**: Изображения должны быть в поддерживаемых форматах (JPG, PNG, WebP)
|
|
||||||
- **ОГРАНИЧЕНИЕ**: Максимальный размер файла изображения
|
|
||||||
|
|
||||||
### 5.2 Отображение товаров
|
|
||||||
|
|
||||||
- **ПРАВИЛО**: 5 карточек в ряд в карточном режиме
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Возможность переключения между строчным и карточным режимами
|
|
||||||
- **ФУНКЦИЯ**: Предпросмотр изображений при наведении/клике
|
|
||||||
|
|
||||||
## 6. 🛒 ПРАВИЛА КОРЗИНЫ И ИЗБРАННОГО
|
|
||||||
|
|
||||||
### 6.1 Система корзины
|
|
||||||
|
|
||||||
- **ПРАВИЛО**: Одна корзина на организацию
|
|
||||||
- **ПРОВЕРКА**: Автоматическая проверка доступности товаров при добавлении
|
|
||||||
- **ОГРАНИЧЕНИЕ**: Нельзя добавлять неактивные товары
|
|
||||||
- **ФУНКЦИЯ**: Автоматическое обновление количества при повторном добавлении
|
|
||||||
|
|
||||||
### 6.2 Система избранного
|
|
||||||
|
|
||||||
- **ПРАВИЛО**: Индивидуальные избранные для каждого пользователя
|
|
||||||
- **ФУНКЦИЯ**: Быстрое добавление из избранного в корзину
|
|
||||||
- **СИНХРОНИЗАЦИЯ**: Проверка актуальности товаров в избранном
|
|
||||||
|
|
||||||
## 7. 🔄 ПРАВИЛА ИНТЕГРАЦИИ
|
|
||||||
|
|
||||||
### 7.1 Интеграция с маркетплейсами
|
|
||||||
|
|
||||||
- **WILDBERRIES**: Обязательная проверка активности API ключа
|
|
||||||
- **СИНХРОНИЗАЦИЯ**: Регулярное обновление данных из внешних источников
|
|
||||||
- **ПРАВИЛО**: Сохранение локальных копий данных для офлайн работы
|
|
||||||
|
|
||||||
### 7.2 Глобальная интеграция
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Товары поставщиков отображаются в глобальном маркете
|
|
||||||
- **ПРАВИЛО**: Разделение по типам (товары/расходники) в интерфейсе
|
|
||||||
- **СИНХРОНИЗАЦИЯ**: Данные склада синхронизируются с модулем аналитики
|
|
||||||
|
|
||||||
### 7.3 Интеграция с модулем "Услуги"
|
|
||||||
|
|
||||||
- **РАСХОДНИКИ ФУЛФИЛМЕНТА В УСЛУГАХ**:
|
|
||||||
- Селлеры могут использовать расходники фулфилмента в разделе "Услуги / Расходники"
|
|
||||||
- Для создания продукта из товара
|
|
||||||
- Расходники списываются с остатков фулфилмента
|
|
||||||
- Стоимость включается в стоимость услуги
|
|
||||||
- **WORKFLOW ИСПОЛЬЗОВАНИЯ**:
|
|
||||||
1. Селлер выбирает услугу "Создание продукта"
|
|
||||||
2. Указывает базовый товар
|
|
||||||
3. Выбирает необходимые расходники фулфилмента
|
|
||||||
4. Фулфилмент обрабатывает заказ и создает продукт
|
|
||||||
5. Расходники списываются, создается готовый продукт
|
|
||||||
|
|
||||||
## 8. 💰 ПРАВИЛА ЦЕНООБРАЗОВАНИЯ И ЛОГИСТИКИ
|
|
||||||
|
|
||||||
### 8.1 Система тарификации
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Указание тарифов для грузов до 1м³ и свыше 1м³
|
|
||||||
- **ПРАВИЛО**: Автоматический расчет стоимости доставки по объему
|
|
||||||
- **ФУНКЦИЯ**: Отображение примерной стоимости доставки при заказе
|
|
||||||
|
|
||||||
### 8.2 Управление ценами
|
|
||||||
|
|
||||||
- **ПРАВИЛО**: Цена за единицу и цена за комплект (если применимо)
|
|
||||||
- **ВАЛИДАЦИЯ**: Все цены должны быть больше 0
|
|
||||||
- **ФУНКЦИЯ**: История изменения цен для аналитики
|
|
||||||
|
|
||||||
## 9. 🔍 ПРАВИЛА ПОИСКА И ФИЛЬТРАЦИИ
|
|
||||||
|
|
||||||
### 9.1 Система поиска
|
|
||||||
|
|
||||||
- **ПОИСК ПО**: Название, артикул, категория, бренд, описание
|
|
||||||
- **ПРАВИЛО**: Поиск должен быть регистронезависимым
|
|
||||||
- **ФУНКЦИЯ**: Автодополнение при вводе поискового запроса
|
|
||||||
|
|
||||||
### 9.2 Фильтрация и сортировка
|
|
||||||
|
|
||||||
- **ФИЛЬТРЫ**: По категории, типу товара, статусу активности, остаткам
|
|
||||||
- **СОРТИРОВКА**: По дате создания, названию, цене, остаткам
|
|
||||||
- **ПРАВИЛО**: Сохранение настроек фильтров для пользователя
|
|
||||||
|
|
||||||
## 10. 📱 ПРАВИЛА ПОЛЬЗОВАТЕЛЬСКОГО ИНТЕРФЕЙСА
|
|
||||||
|
|
||||||
### 10.1 Отзывчивость интерфейса
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Интерфейс должен работать на всех устройствах
|
|
||||||
- **ПРАВИЛО**: Адаптивная сетка для карточек товаров
|
|
||||||
- **ФУНКЦИЯ**: Оптимизация для мобильных устройств
|
|
||||||
|
|
||||||
### 10.2 Обратная связь пользователю
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Уведомления об успешных/неуспешных операциях
|
|
||||||
- **ПРАВИЛО**: Индикаторы загрузки для длительных операций
|
|
||||||
- **ФУНКЦИЯ**: Подтверждение критических действий (удаление, деактивация)
|
|
||||||
|
|
||||||
## 11. 🚨 ПРАВИЛА ОБРАБОТКИ ОШИБОК
|
|
||||||
|
|
||||||
### 11.1 Обработка ошибок
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Логирование всех ошибок
|
|
||||||
- **ПРАВИЛО**: Понятные сообщения об ошибках для пользователя
|
|
||||||
- **ФУНКЦИЯ**: Автоматическое восстановление после сбоев
|
|
||||||
|
|
||||||
### 11.2 Резервное копирование
|
|
||||||
|
|
||||||
- **КРИТИЧЕСКИ ВАЖНО**: Регулярное резервное копирование данных товаров
|
|
||||||
- **ПРАВИЛО**: Версионность изменений для возможности отката
|
|
||||||
- **ФУНКЦИЯ**: Автоматическое восстановление связей при сбоях
|
|
||||||
|
|
||||||
## 12. 📈 ПРАВИЛА ПРОИЗВОДИТЕЛЬНОСТИ
|
|
||||||
|
|
||||||
### 12.1 Оптимизация загрузки
|
|
||||||
|
|
||||||
- **ПРАВИЛО**: Пагинация для больших списков товаров
|
|
||||||
- **ФУНКЦИЯ**: Ленивая загрузка изображений
|
|
||||||
- **ОПТИМИЗАЦИЯ**: Кэширование часто запрашиваемых данных
|
|
||||||
|
|
||||||
### 12.2 Масштабируемость
|
|
||||||
|
|
||||||
- **АРХИТЕКТУРА**: Модульная структура для легкого расширения
|
|
||||||
- **ПРАВИЛО**: Использование индексов для быстрого поиска
|
|
||||||
- **ФУНКЦИЯ**: Горизонтальное масштабирование при росте нагрузки
|
|
||||||
|
|
||||||
## 13. 🔐 ПРАВИЛА БЕЗОПАСНОСТИ ДАННЫХ
|
|
||||||
|
|
||||||
### 13.1 Защита данных
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Шифрование чувствительных данных
|
|
||||||
- **ПРАВИЛО**: Аудит всех действий пользователей
|
|
||||||
- **ФУНКЦИЯ**: Контроль доступа на уровне API
|
|
||||||
|
|
||||||
### 13.2 Соответствие требованиям
|
|
||||||
|
|
||||||
- **GDPR**: Право на удаление и экспорт данных
|
|
||||||
- **ПРАВИЛО**: Прозрачность обработки персональных данных
|
|
||||||
- **ФУНКЦИЯ**: Логирование согласий пользователей
|
|
||||||
|
|
||||||
## 14. 🎯 ПРАВИЛА КАЧЕСТВА КОДА
|
|
||||||
|
|
||||||
### 14.1 Стандарты разработки
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Покрытие тестами критической функциональности
|
|
||||||
- **ПРАВИЛО**: Следование принципам SOLID
|
|
||||||
- **ФУНКЦИЯ**: Автоматическое тестирование при развертывании
|
|
||||||
|
|
||||||
### 14.2 Документация
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Документирование всех API методов
|
|
||||||
- **ПРАВИЛО**: Комментарии к сложной бизнес-логике
|
|
||||||
- **ФУНКЦИЯ**: Автоматическая генерация документации
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 15. 📦 СПЕЦИАЛЬНЫЕ ПРАВИЛА ДЛЯ ТИПОВ ПРЕДМЕТОВ
|
|
||||||
|
|
||||||
### 15.1 Правила для ТОВАРА
|
|
||||||
|
|
||||||
- **СОЗДАНИЕ**: Базовый тип, создается поставщиком
|
|
||||||
- **СТАТУС**: Может быть активным/неактивным
|
|
||||||
- **ЗАКАЗ**: Доступен для заказа всеми типами организаций
|
|
||||||
- **ТРАНСФОРМАЦИЯ**: Может быть преобразован в ПРОДУКТ или БРАК
|
|
||||||
- **УЧЕТ**: Основная единица складского учета
|
|
||||||
- **ЦЕНА**: Обязательна, больше 0
|
|
||||||
|
|
||||||
### 15.2 Правила для БРАКА
|
|
||||||
|
|
||||||
- **СОЗДАНИЕ**: Только на основе существующего ТОВАРА
|
|
||||||
- **СВЯЗЬ**: Обязательная связь с родительским товаром (parentId)
|
|
||||||
- **СТАТУС**: Всегда неактивен для заказа
|
|
||||||
- **ЗАКАЗ**: ЗАПРЕЩЕН заказ брака
|
|
||||||
- **ОТОБРАЖЕНИЕ**: Виден только для учета потерь
|
|
||||||
- **СПИСАНИЕ**: Особый workflow списания и утилизации
|
|
||||||
- **СТАТИСТИКА**: Учитывается в потерях и браке
|
|
||||||
- **ЦЕНА**: Может быть 0 (списанный товар)
|
|
||||||
|
|
||||||
### 15.3 Правила для ПРОДУКТА
|
|
||||||
|
|
||||||
- **СОЗДАНИЕ**: Только на основе существующего ТОВАРА через процесс "Создания продукта"
|
|
||||||
- **СВЯЗЬ**: Обязательная связь с родительским товаром (parentId)
|
|
||||||
- **ОТЛИЧИЕ**: Товар = сырье, Продукт = готовая единица
|
|
||||||
- **СТАТУСЫ ЖИЗНЕННОГО ЦИКЛА**:
|
|
||||||
- Товар "на складе" → "в работе" → Продукт "готов к отправке"
|
|
||||||
- **РЕЦЕПТУРА**: Определяется селлером при создании поставки
|
|
||||||
- **СОСТАВ**: Товар + Услуга фулфилмента + Расходники (опционально)
|
|
||||||
- **АРТИКУЛЫ**: Наследует от товара + артикул MP (если связан)
|
|
||||||
- **ЗАКАЗ**: Доступен только в статусе "готов к отправке"
|
|
||||||
- **ПРОЦЕСС**: Обязательно проходит этап обработки на фулфилменте
|
|
||||||
- **УЧЕТ**: Отдельная статистика от базового товара
|
|
||||||
- **ЦЕНА**: Формируется из стоимости товара + услуг + расходников
|
|
||||||
- **СВЯЗЬ С MP**: Опциональная связь с карточкой маркетплейса
|
|
||||||
|
|
||||||
### 15.4 Правила для РАСХОДНИКОВ
|
|
||||||
|
|
||||||
- **СОЗДАНИЕ**: Поставщик создает карточки типа "РАСХОДНИКИ"
|
|
||||||
- **УНИВЕРСАЛЬНОСТЬ**: Один тип расходников для всех заказчиков
|
|
||||||
- **ПРИМЕРЫ**: Упаковочные материалы, этикетки, пленка, коробки, бирки, вкладыши
|
|
||||||
- **ДОСТУП**: Видны всем типам организаций в маркете
|
|
||||||
- **ЗАКАЗ**: Любая организация может заказать расходники
|
|
||||||
|
|
||||||
### 15.5 Классификация при заказе
|
|
||||||
|
|
||||||
**РАСХОДНИКИ → РАСХОДНИКИ ФУЛФИЛМЕНТА (при заказе фулфилмент-центром):**
|
|
||||||
|
|
||||||
- **НАЗНАЧЕНИЕ**: Для внутренних операций фулфилмент-центра и услуг селлерам
|
|
||||||
- **УЧЕТ**: В операционных расходах фулфилмента
|
|
||||||
- **WORKFLOW**: Поставщик → фулфилмент (прямая поставка)
|
|
||||||
- **ИСПОЛЬЗОВАНИЕ**: Для операций фулфилмента и услуг селлерам
|
|
||||||
|
|
||||||
**РАСХОДНИКИ → РАСХОДНИКИ СЕЛЛЕРОВ (при заказе селлером):**
|
|
||||||
|
|
||||||
- **НАЗНАЧЕНИЕ**: Для товаров и операций селлеров
|
|
||||||
- **УЧЕТ**: В расходах селлера
|
|
||||||
- **WORKFLOW**: Поставщик → фулфилмент → селлер
|
|
||||||
- **ПРИВЯЗКА**: Могут быть привязаны к конкретным товарам селлера
|
|
||||||
|
|
||||||
## 16. ⚠️ КРИТИЧЕСКИЕ ЗАПРЕТЫ
|
|
||||||
|
|
||||||
### 16.1 НИКОГДА НЕ ДЕЛАТЬ:
|
|
||||||
|
|
||||||
1. ❌ Удалять предметы с существующими заказами
|
|
||||||
2. ❌ Изменять статусы заказов без уведомлений
|
|
||||||
3. ❌ Обходить проверки остатков предметов
|
|
||||||
4. ❌ Давать доступ к чужим данным
|
|
||||||
5. ❌ Игнорировать ошибки валидации
|
|
||||||
6. ❌ Сохранять пароли в открытом виде
|
|
||||||
7. ❌ Пропускать логирование критических операций
|
|
||||||
8. ❌ Блокировать интерфейс без индикации загрузки
|
|
||||||
9. ❌ Создавать брак или продукт без связи с родительским товаром
|
|
||||||
10. ❌ Создавать отдельные типы расходников (только общий тип "РАСХОДНИКИ")
|
|
||||||
11. ❌ Разрешать заказ брака
|
|
||||||
12. ❌ Нарушать иерархию типов предметов
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 17. 🏢 ПРАВИЛА СИСТЕМЫ СКЛАДА ФУЛФИЛМЕНТА
|
|
||||||
|
|
||||||
### 17.1 Структура раздела склад фулфилмента
|
|
||||||
|
|
||||||
#### 17.1.1 Блок статистика склада
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНАЯ ПОСЛЕДОВАТЕЛЬНОСТЬ МОДУЛЕЙ:**
|
|
||||||
|
|
||||||
1. **ПРОДУКТ** - готовые к продаже товары
|
|
||||||
2. **ТОВАР** - базовые товары от поставщиков
|
|
||||||
3. **БРАК** - товары с дефектами
|
|
||||||
4. **ВОЗВРАТЫ С ПВЗ** - возвращенные товары
|
|
||||||
5. **РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для селлеров
|
|
||||||
6. **РАСХОДНИКИ ФУЛФИЛМЕНТ** - операционные материалы
|
|
||||||
|
|
||||||
**ТРЕБОВАНИЯ К МОДУЛЯМ:**
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Каждый модуль отображает текущее наличие на складе
|
|
||||||
- **ПРАВИЛО**: Последовательность модулей не может быть изменена
|
|
||||||
- **СТАТУС**: Все модули отображают актуальные данные в реальном времени
|
|
||||||
|
|
||||||
#### 17.1.2 Система учёта движения товаров
|
|
||||||
|
|
||||||
**ОСНОВНЫЕ ПРИНЦИПЫ:**
|
|
||||||
|
|
||||||
- **ПРИХОД**: Товары поступают через принятые поставки (из состояния "в пути" → "на складе")
|
|
||||||
- **ОБРАБОТКА**: Товары переходят в статус "в работе" для создания продуктов
|
|
||||||
- **РАСХОД**: Товары убывают при отгрузке, списании, возврате, превращении в продукты
|
|
||||||
- **УЧЁТ**: Ведется учет прихода и расхода для каждого типа предметов
|
|
||||||
- **ВИЗУАЛИЗАЦИЯ**: Движение отображается в дополнительных значениях
|
|
||||||
|
|
||||||
**ДОПОЛНИТЕЛЬНЫЕ ЗНАЧЕНИЯ (показатели движения):**
|
|
||||||
|
|
||||||
- **ПРИБЫЛО**: Количество предметов, поступивших на склад
|
|
||||||
- **УБЫЛО**: Количество предметов, списанных со склада
|
|
||||||
- **ВЛИЯНИЕ**: От этих значений зависят основные значения (общее количество)
|
|
||||||
|
|
||||||
**ОСНОВНЫЕ ЗНАЧЕНИЯ (текущие остатки):**
|
|
||||||
|
|
||||||
- **ОПРЕДЕЛЕНИЕ**: Итоговое количество предметов на складе
|
|
||||||
- **РАСЧЁТ**: Основные значения = Предыдущие остатки + Прибыло - Убыло
|
|
||||||
- **ОТОБРАЖЕНИЕ**: Показываются в каждом модуле статистики
|
|
||||||
- **РАЗДЕЛЕНИЕ ТОВАРОВ**:
|
|
||||||
- Товары "на складе" - готовы к обработке
|
|
||||||
- Товары "в обработке" - находятся в процессе создания продукта
|
|
||||||
|
|
||||||
#### 17.1.3 Модуль "Расходники фулфилмента"
|
|
||||||
|
|
||||||
**ОСОБЕННОСТИ МОДУЛЯ:**
|
|
||||||
|
|
||||||
- **ИНТЕРАКТИВНОСТЬ**: Является кликабельным элементом
|
|
||||||
- **ФУНКЦИОНАЛЬНОСТЬ**: Содержит полноценный раздел учёта
|
|
||||||
- **ДОСТУП**: Переход к детальному управлению расходниками фулфилмента
|
|
||||||
- **СОДЕРЖАНИЕ**: Полный функционал работы с расходниками фулфилмента
|
|
||||||
|
|
||||||
#### 17.1.4 Блок детализация по Магазинам
|
|
||||||
|
|
||||||
**НАЗНАЧЕНИЕ**: Распределение товаров по торговым точкам/магазинам
|
|
||||||
**ФУНКЦИИ**:
|
|
||||||
|
|
||||||
- Отображение остатков по каждому магазину
|
|
||||||
- Управление распределением товаров
|
|
||||||
- Контроль движения между магазинами
|
|
||||||
|
|
||||||
### 17.2 Правила движения товаров в системе фулфилмента
|
|
||||||
|
|
||||||
#### 17.2.1 Поступление товаров
|
|
||||||
|
|
||||||
**ИСТОЧНИКИ ПОСТУПЛЕНИЯ:**
|
|
||||||
|
|
||||||
- **ПОСТАВКИ**: От поставщиков через систему заказов
|
|
||||||
- **ВОЗВРАТЫ**: Товары, возвращенные с ПВЗ
|
|
||||||
- **ПЕРЕМЕЩЕНИЯ**: Между складами и магазинами
|
|
||||||
|
|
||||||
**ПРОЦЕСС ПРИЁМКИ:**
|
|
||||||
|
|
||||||
1. Поставка переходит в статус "принято"
|
|
||||||
2. Товары из "в пути" → "на складе"
|
|
||||||
3. Обновляются основные значения
|
|
||||||
4. Фиксируется в дополнительных значениях как "прибыло"
|
|
||||||
|
|
||||||
#### 17.2.2 Расход товаров
|
|
||||||
|
|
||||||
**ПРИЧИНЫ РАСХОДА:**
|
|
||||||
|
|
||||||
- **ОТГРУЗКА**: Товары отправлены селлерам
|
|
||||||
- **СПИСАНИЕ**: Брак, утрата, утилизация
|
|
||||||
- **ВОЗВРАТ**: Возврат поставщику
|
|
||||||
- **ИСПОЛЬЗОВАНИЕ**: Расходники для операций
|
|
||||||
|
|
||||||
### 17.3 Процесс "Создания продукта"
|
|
||||||
|
|
||||||
#### 17.3.1 Workflow создания продукта
|
|
||||||
|
|
||||||
**ЭТАПЫ ПРОЦЕССА:**
|
|
||||||
|
|
||||||
1. **ПОСТУПЛЕНИЕ**: Товар приходит на склад фулфилмента (статус "на складе")
|
|
||||||
2. **СОРТИРОВКА**: Перебор товара, отсеивание брака
|
|
||||||
3. **ПОДГОТОВКА К РАБОТЕ**: Менеджер задает параметры работы
|
|
||||||
4. **ОБРАБОТКА**: Превращение товара в продукт по "рецептуре" селлера
|
|
||||||
5. **ЗАВЕРШЕНИЕ**: Готовый продукт (статус "готов к отправке")
|
|
||||||
|
|
||||||
#### 17.3.2 Управление процессом
|
|
||||||
|
|
||||||
**РАЗДЕЛ "СОЗДАНИЕ ПРОДУКТА":**
|
|
||||||
|
|
||||||
- **НОВЫЕ**: Поставки после нажатия "принято", ожидающие назначения
|
|
||||||
- **В РАБОТЕ**: Поставки в процессе обработки
|
|
||||||
- **ВЫПОЛНЕНО**: Завершенные поставки с готовыми продуктами
|
|
||||||
|
|
||||||
**ДЕЙСТВИЯ МЕНЕДЖЕРА В "НОВЫЕ":**
|
|
||||||
|
|
||||||
- **ДЕДЛАЙН**: Указание срока выполнения работы
|
|
||||||
- **ОТВЕТСТВЕННЫЙ**: Назначение исполнителя
|
|
||||||
- **МЕСТО ХРАНЕНИЯ**: Указание локации для готовых продуктов (опционально)
|
|
||||||
- **ЗАПУСК**: Нажатие кнопки "В работе"
|
|
||||||
|
|
||||||
#### 17.3.3 Рецептура продукта (задается селлером)
|
|
||||||
|
|
||||||
**СЕЛЛЕР УКАЗЫВАЕТ В ПОСТАВКЕ:**
|
|
||||||
|
|
||||||
- **БАЗОВЫЙ ТОВАР**: Исходный материал (например, футболка)
|
|
||||||
- **УСЛУГА ФУЛФИЛМЕНТА**: Из каталога услуг (например, "погладить")
|
|
||||||
- **РАСХОДНИК СЕЛЛЕРА**: Материалы селлера (например, фирменный пакет)
|
|
||||||
- **РАСХОДНИК ФУЛФИЛМЕНТА**: Материалы фулфилмента (например, короб + маркировка)
|
|
||||||
|
|
||||||
**РЕЗУЛЬТАТ**: ПРОДУКТ = Товар + Услуга + Расходники
|
|
||||||
|
|
||||||
#### 17.3.4 Учет план/факт в процессе работы
|
|
||||||
|
|
||||||
**ПЛАН**: Количество товара из поставки селлера
|
|
||||||
**ФАКТ**: Реальное количество после сортировки
|
|
||||||
|
|
||||||
**ФИКСАЦИЯ БРАКА:**
|
|
||||||
|
|
||||||
- **КОГДА**: В процессе работы (вкладка "В работе")
|
|
||||||
- **КТО**: Ответственный исполнитель
|
|
||||||
- **ДЕТАЛИЗАЦИЯ**: По каждому предмету (размер/объем)
|
|
||||||
- **ОБНОВЛЕНИЕ**: Можно вносить изменения до нажатия "Выполнено"
|
|
||||||
|
|
||||||
**ВЛИЯНИЕ НА СТАТИСТИКУ:**
|
|
||||||
|
|
||||||
- При принятии поставки: +План в статистику
|
|
||||||
- При выявлении факта: корректировка на реальные данные
|
|
||||||
- **ФОРМУЛА**: Факт = Брак + Хороший товар
|
|
||||||
- **ЛОГИКА**: Фактическое количество = сумма всех пересчитанных предметов
|
|
||||||
|
|
||||||
#### 17.3.5 Связь с маркетплейсами
|
|
||||||
|
|
||||||
**АРТИКУЛЫ ПРОДУКТА:**
|
|
||||||
|
|
||||||
- **ОСНОВНОЙ**: Наследует артикул исходного товара
|
|
||||||
- **ДОПОЛНИТЕЛЬНЫЙ**: Артикул карточки маркетплейса (если связан)
|
|
||||||
|
|
||||||
**СВЯЗЫВАНИЕ С MP:**
|
|
||||||
|
|
||||||
- **МОМЕНТ**: При создании поставки селлером
|
|
||||||
- **ПОЛЕ**: "Связать с карточкой маркетплейса" (опционально)
|
|
||||||
- **ИСТОЧНИК**: Карточки, полученные через API маркетплейсов
|
|
||||||
- **ПРАВИЛО**: Карточка товара селлера на MP = карточке продукта в системе
|
|
||||||
|
|
||||||
### 17.4 Валидация и контроль в складе фулфилмента
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНЫЕ ПРОВЕРКИ:**
|
|
||||||
|
|
||||||
- **ОСТАТКИ**: Не могут быть отрицательными
|
|
||||||
- **ДВИЖЕНИЕ**: Каждое изменение должно быть зафиксировано
|
|
||||||
- **СИНХРОНИЗАЦИЯ**: Основные и дополнительные значения должны соответствовать
|
|
||||||
- **ДОСТУП**: Только авторизованный персонал фулфилмента
|
|
||||||
- **ПЛАН/ФАКТ**: Корректировка статистики при выявлении расхождений
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 18. 🎖️ ПРИОРИТЕТЫ РАЗРАБОТКИ
|
|
||||||
|
|
||||||
### 18.1 ВЫСОКИЙ ПРИОРИТЕТ:
|
|
||||||
|
|
||||||
1. 🔴 Безопасность и контроль доступа
|
|
||||||
2. 🔴 Целостность данных и валидация
|
|
||||||
3. 🔴 Корректность статусов поставок
|
|
||||||
4. 🔴 Уведомления участников процесса
|
|
||||||
5. 🔴 Правильная типизация предметов
|
|
||||||
6. 🔴 Связи между товарами и производными типами
|
|
||||||
|
|
||||||
### 18.2 СРЕДНИЙ ПРИОРИТЕТ:
|
|
||||||
|
|
||||||
1. 🟡 Производительность и оптимизация
|
|
||||||
2. 🟡 Пользовательский опыт
|
|
||||||
3. 🟡 Аналитика и отчетность
|
|
||||||
4. 🟡 Интеграции с внешними системами
|
|
||||||
5. 🟡 Workflow для брака и продуктов
|
|
||||||
6. 🟡 Разделение расходников по типам
|
|
||||||
|
|
||||||
### 18.3 НИЗКИЙ ПРИОРИТЕТ:
|
|
||||||
|
|
||||||
1. 🟢 Дополнительные фильтры
|
|
||||||
2. 🟢 Косметические улучшения
|
|
||||||
3. 🟢 Экспериментальные функции
|
|
||||||
4. 🟢 Расширенная кастомизация
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 19. 🏠 ПРАВИЛА КАБИНЕТА СЕЛЛЕРА / РАЗДЕЛ "МОИ ПОСТАВКИ"
|
|
||||||
|
|
||||||
### 19.1 Структура и навигация
|
|
||||||
|
|
||||||
#### 19.1.1 Основная структура
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНАЯ СТРУКТУРА РАЗДЕЛА:**
|
|
||||||
|
|
||||||
- **ПОСТАВКИ НА ФУЛФИЛМЕНТ**:
|
|
||||||
- Товар → Карточки / Поставщики
|
|
||||||
- Расходники селлера
|
|
||||||
- **ПОСТАВКИ НА МАРКЕТПЛЕЙСЫ**:
|
|
||||||
- Wildberries
|
|
||||||
- Ozon
|
|
||||||
|
|
||||||
**НАВИГАЦИЯ**: Переключение через кнопки между основными разделами
|
|
||||||
|
|
||||||
#### 19.1.2 Различия подразделов товаров
|
|
||||||
|
|
||||||
**КАРТОЧКИ**:
|
|
||||||
|
|
||||||
- **ИСТОЧНИК**: WB API карточки селлера
|
|
||||||
- **ФУНКЦИИ**: Указание рецептуры + выбор логистики
|
|
||||||
- **РЕЗУЛЬТАТ**: WildberriesSupply
|
|
||||||
|
|
||||||
**ПОСТАВЩИКИ**:
|
|
||||||
|
|
||||||
- **ИСТОЧНИК**: Каталог товаров поставщиков
|
|
||||||
- **ФУНКЦИИ**: Заказ товаров + рецептура для продукта
|
|
||||||
- **РЕЗУЛЬТАТ**: SupplyOrder
|
|
||||||
|
|
||||||
### 19.2 Правила создания поставки расходников селлера
|
|
||||||
|
|
||||||
#### 19.2.1 Структура страницы
|
|
||||||
|
|
||||||
**БЛОК 1: ПОСТАВЩИКИ** _(обязательный)_
|
|
||||||
|
|
||||||
- **РАСПОЛОЖЕНИЕ**: Верхняя часть экрана
|
|
||||||
- **ИСТОЧНИК**: Только поставщики из раздела "Партнеры"
|
|
||||||
- **НАВИГАЦИЯ**: Горизонтальный скролл при превышении ширины
|
|
||||||
- **ВЫБОР**: Только один поставщик одновременно
|
|
||||||
- **ИНДИКАЦИЯ**: Визуальное выделение выбранной карточки
|
|
||||||
|
|
||||||
**БЛОК 2: РАСХОДНИКИ** _(зависимый)_
|
|
||||||
|
|
||||||
- **УСЛОВИЕ**: Активен только после выбора поставщика
|
|
||||||
- **СОДЕРЖАНИЕ**: Только расходники выбранного поставщика
|
|
||||||
- **ОБЯЗАТЕЛЬНЫЕ ЭЛЕМЕНТЫ**:
|
|
||||||
- Сортировка: цена, название, категория
|
|
||||||
- Фильтры: категория, ценовой диапазон
|
|
||||||
- **КАРТОЧКА РАСХОДНИКА**:
|
|
||||||
- Фото, название, цена, остаток, категория
|
|
||||||
- Количество в комплекте (если применимо)
|
|
||||||
- Поле ввода количества с валидацией
|
|
||||||
- Кнопки +/- для изменения по единице
|
|
||||||
|
|
||||||
**БЛОК 3: КОРЗИНА** _(справа)_
|
|
||||||
|
|
||||||
- **РАСПОЛОЖЕНИЕ**: Правая часть экрана
|
|
||||||
- **СОДЕРЖАНИЕ**:
|
|
||||||
- Счетчик видов расходников
|
|
||||||
- Детализация по каждому расходнику
|
|
||||||
- Общая сумма
|
|
||||||
- **УПРАВЛЕНИЕ**:
|
|
||||||
- Изменение количества (с валидацией остатков)
|
|
||||||
- Удаление позиций
|
|
||||||
- **ОБЯЗАТЕЛЬНЫЕ ПОЛЯ**:
|
|
||||||
- Выбор фулфилмент-центра (из партнеров)
|
|
||||||
- Дата поставки (не прошедшая, по умолчанию - текущая)
|
|
||||||
|
|
||||||
#### 19.2.2 Валидация и ограничения
|
|
||||||
|
|
||||||
**КОЛИЧЕСТВО ТОВАРОВ**:
|
|
||||||
|
|
||||||
- **МИНИМУМ**: 1 единица/комплект
|
|
||||||
- **МАКСИМУМ**: Остаток у поставщика
|
|
||||||
- **ПРОВЕРКА**: В реальном времени при изменении
|
|
||||||
|
|
||||||
**ДАТА ПОСТАВКИ**:
|
|
||||||
|
|
||||||
- **ЗАПРЕТ**: Выбор прошедших дат
|
|
||||||
- **ПО УМОЛЧАНИЮ**: Дата создания поставки
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНЫЕ ПОЛЯ**:
|
|
||||||
|
|
||||||
- Выбор поставщика
|
|
||||||
- Минимум один расходник в корзине
|
|
||||||
- Выбор фулфилмент-центра
|
|
||||||
- Дата поставки
|
|
||||||
|
|
||||||
### 19.3 Отображение и управление поставками
|
|
||||||
|
|
||||||
#### 19.3.1 Многоуровневая таблица
|
|
||||||
|
|
||||||
**ПЕРВЫЙ УРОВЕНЬ** _(основной список)_:
|
|
||||||
|
|
||||||
- **СОРТИРОВКА**: Номер поставки от большего к меньшему
|
|
||||||
- **ОБЯЗАТЕЛЬНЫЕ КОЛОНКИ**:
|
|
||||||
- Порядковый номер поставки
|
|
||||||
- Количество видов расходников
|
|
||||||
- Стоимость всей поставки
|
|
||||||
- Количество категорий
|
|
||||||
- Статус поставки
|
|
||||||
|
|
||||||
**ВТОРОЙ УРОВЕНЬ** _(детализация)_:
|
|
||||||
|
|
||||||
- **АКТИВАЦИЯ**: По клику на строку первого уровня
|
|
||||||
- **СОДЕРЖАНИЕ**:
|
|
||||||
- Название расходника
|
|
||||||
- Количество
|
|
||||||
- Цена
|
|
||||||
- Категория
|
|
||||||
- Поставщик
|
|
||||||
- **ОГРАНИЧЕНИЯ**: Только просмотр, редактирование запрещено
|
|
||||||
|
|
||||||
#### 19.3.2 Статусы поставок
|
|
||||||
|
|
||||||
**ЖИЗНЕННЫЙ ЦИКЛ СТАТУСОВ**:
|
|
||||||
|
|
||||||
1. **В работе** - создана селлером
|
|
||||||
2. **Одобрена** - подтверждена поставщиком
|
|
||||||
3. **Ожидает отгрузки** - логистика назначена
|
|
||||||
4. **В пути** - товар отгружен
|
|
||||||
5. **Доставлена/Принято** - получена фулфилментом
|
|
||||||
|
|
||||||
### 19.4 Workflow и бизнес-логика
|
|
||||||
|
|
||||||
#### 19.4.1 Участники процесса
|
|
||||||
|
|
||||||
**СЕЛЛЕР**:
|
|
||||||
|
|
||||||
- Создает поставку
|
|
||||||
- Отслеживает статусы
|
|
||||||
- Получает уведомления об изменениях
|
|
||||||
|
|
||||||
**ПОСТАВЩИК**:
|
|
||||||
|
|
||||||
- Получает уведомление о заказе
|
|
||||||
- Вносит данные о грузовых местах и объеме
|
|
||||||
- Подтверждает поставку
|
|
||||||
- Отмечает отгрузку
|
|
||||||
|
|
||||||
**ФУЛФИЛМЕНТ**:
|
|
||||||
|
|
||||||
- Назначает ответственного
|
|
||||||
- Выбирает логистику
|
|
||||||
- Принимает товар
|
|
||||||
- Указывает место хранения
|
|
||||||
|
|
||||||
**ЛОГИСТИКА**:
|
|
||||||
|
|
||||||
- Получает заявку
|
|
||||||
- Подтверждает возможность доставки
|
|
||||||
- Осуществляет транспортировку
|
|
||||||
|
|
||||||
#### 19.4.2 Уведомления
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНЫЕ УВЕДОМЛЕНИЯ**:
|
|
||||||
|
|
||||||
- Поставщику: о новом заказе расходников
|
|
||||||
- Фулфилменту: о подтвержденной поставке
|
|
||||||
- Логистике: о назначении на заявку
|
|
||||||
- Селлеру: об изменении каждого статуса
|
|
||||||
|
|
||||||
### 19.5 Ограничения и запреты
|
|
||||||
|
|
||||||
**ЗАПРЕЩЕНО**:
|
|
||||||
|
|
||||||
- Редактирование созданной поставки
|
|
||||||
- Выбор нескольких поставщиков одновременно
|
|
||||||
- Заказ количества сверх остатков
|
|
||||||
- Выбор прошедших дат поставки
|
|
||||||
- Создание поставки без выбора фулфилмент-центра
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНО**:
|
|
||||||
|
|
||||||
- Валидация остатков перед добавлением в корзину
|
|
||||||
- Проверка доступности фулфилмент-центра
|
|
||||||
- Отправка уведомлений на каждом этапе
|
|
||||||
- Логирование всех изменений статусов
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
_Эти правила являются обязательными для всех участников разработки и должны соблюдаться на всех этапах жизненного цикла системы._
|
|
||||||
|
|
||||||
_Версия: 1.0_
|
|
||||||
_Дата создания: 2024_
|
|
||||||
_Статус: АКТИВНЫЕ ПРАВИЛА_
|
|
@ -1,642 +0,0 @@
|
|||||||
# ПРАВИЛА СИСТЕМЫ УПРАВЛЕНИЯ СКЛАДАМИ И ПОСТАВКАМИ
|
|
||||||
|
|
||||||
> ⚠️ **ВАЖНОЕ ПРИМЕЧАНИЕ**: Данные из этого файла могут быть удалены только с разрешения пользователя. Все изменения должны согласовываться.
|
|
||||||
|
|
||||||
## 🔤 ТЕРМИНЫ СИСТЕМЫ
|
|
||||||
> Для людей → `В коде`
|
|
||||||
- ТОВАР → `PRODUCT`
|
|
||||||
- РАСХОДНИКИ → `CONSUMABLE`
|
|
||||||
- БРАК → `DEFECT` *(планируется)*
|
|
||||||
- ПРОДУКТ → `FINISHED_PRODUCT` *(планируется)*
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📑 ОГЛАВЛЕНИЕ
|
|
||||||
|
|
||||||
### 🎯 **ОБЩИЕ ПРАВИЛА**
|
|
||||||
|
|
||||||
1. [Основные принципы системы](#1-основные-принципы-системы)
|
|
||||||
2. [Типизация предметов](#2-типизация-предметов)
|
|
||||||
3. [Workflow поставок](#3-workflow-поставок)
|
|
||||||
4. [Система ролей и доступов](#4-система-ролей-и-доступов)
|
|
||||||
|
|
||||||
### 🏢 **ПРАВИЛА ПО КАБИНЕТАМ**
|
|
||||||
|
|
||||||
5. [Кабинет селлера](#5-кабинет-селлера)
|
|
||||||
6. [Кабинет поставщика](#6-кабинет-поставщика)
|
|
||||||
7. [Кабинет фулфилмента](#7-кабинет-фулфилмента)
|
|
||||||
8. [Интеграции и связи между кабинетами](#8-интеграции-и-связи-между-кабинетами)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 🎯 ОСНОВНЫЕ ПРИНЦИПЫ СИСТЕМЫ
|
|
||||||
|
|
||||||
### 1.1 Архитектура системы
|
|
||||||
|
|
||||||
**СТРУКТУРА СИСТЕМЫ ПО КАБИНЕТАМ:**
|
|
||||||
|
|
||||||
**🏢 КАБИНЕТ ПОСТАВЩИКА** - создает и управляет:
|
|
||||||
|
|
||||||
- **ТОВАР** (`PRODUCT`) - базовые товары от поставщика
|
|
||||||
- **РАСХОДНИКИ** (`CONSUMABLE`) - материалы и вспомогательные товары от поставщика
|
|
||||||
|
|
||||||
**🏭 КАБИНЕТ ФУЛФИЛМЕНТА** - принимает, обрабатывает и управляет всеми типами:
|
|
||||||
|
|
||||||
- **ТОВАР** (`PRODUCT`) - базовые товары от поставщиков (принятые на склад)
|
|
||||||
- **БРАК** (`DEFECT` - планируется) - производная от товара (товар с дефектами)
|
|
||||||
- **ПРОДУКТ** (`FINISHED_PRODUCT` - планируется) - готовый к продаже товар
|
|
||||||
- **РАСХОДНИКИ ФУЛФИЛМЕНТА** - операционные материалы фулфилмента
|
|
||||||
- **РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для товаров селлеров
|
|
||||||
|
|
||||||
**🛍️ КАБИНЕТ СЕЛЛЕРА** - заказывает и управляет поставками:
|
|
||||||
|
|
||||||
- Создает заказы товаров и расходников
|
|
||||||
- Управляет поставками на фулфилмент и маркетплейсы
|
|
||||||
- Отслеживает статусы поставок
|
|
||||||
|
|
||||||
### 1.2 Основные сущности системы
|
|
||||||
|
|
||||||
| Сущность | Название в системе | Описание | Статус |
|
|
||||||
| ---------- | ---------------------------------- | ----------------------------------------------- | --------------- |
|
|
||||||
| Товар | `Product` (type: PRODUCT) | Базовый тип товара от поставщика | ✅ Реализовано |
|
|
||||||
| Брак | `Product` (type: DEFECT) | Производная от товара с дефектами | 🔄 В разработке |
|
|
||||||
| Расходники | `Product` (type: CONSUMABLE) | Материалы и вспомогательные товары | ✅ Реализовано |
|
|
||||||
| Продукт | `Product` (type: FINISHED_PRODUCT) | Готовый к продаже товар (производная от товара) | 🔄 В разработке |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 📦 ТИПИЗАЦИЯ ПРЕДМЕТОВ
|
|
||||||
|
|
||||||
### 2.1 Обязательные типы
|
|
||||||
|
|
||||||
**ВАЖНО**: Товар ≠ Продукт (это разные сущности в системе)
|
|
||||||
|
|
||||||
**4 основных типа предметов в системе:**
|
|
||||||
|
|
||||||
1. **ТОВАР** - базовый тип товара от поставщика
|
|
||||||
2. **БРАК** - производная от товара (товар с дефектами)
|
|
||||||
3. **РАСХОДНИКИ** - материалы и вспомогательные товары от поставщика
|
|
||||||
4. **ПРОДУКТ** - производная от товара (готовый к продаже товар)
|
|
||||||
|
|
||||||
### 2.2 Классификация расходников
|
|
||||||
|
|
||||||
- Поставщик создает карточки типа **"РАСХОДНИКИ"** (без уточнения назначения)
|
|
||||||
- При заказе, в зависимости от заказчика, они классифицируются как:
|
|
||||||
- **"Расходники фулфилмента"** - если заказывает фулфилмент-центр
|
|
||||||
- **"Расходники селлеров"** - если заказывает селлер
|
|
||||||
|
|
||||||
### 2.3 Обязательные поля карточки
|
|
||||||
|
|
||||||
**Базовые параметры:**
|
|
||||||
|
|
||||||
- **Фото** - система загрузки и управления изображениями товаров
|
|
||||||
- **Название**
|
|
||||||
- **Автоматическая генерация системой уникального номера** (артикул СФ)
|
|
||||||
- **Описание**
|
|
||||||
- **Количество предметов** в единицах
|
|
||||||
- **Количество комплектов** если продается комплектом
|
|
||||||
- **Категория** (28 предустановленных универсальных категорий + специализированные категории расходников)
|
|
||||||
- **Бренд**, **Цвет**, **Размер/объем**, **Вес**, **Габариты**, **Материал**
|
|
||||||
- **Цена за единицу** и **Цена за комплект**
|
|
||||||
- **Заказано**, **В пути**, **Остаток**, **Продано**
|
|
||||||
|
|
||||||
**Дополнительные параметры:**
|
|
||||||
|
|
||||||
- **Статус активности** (`isActive`) - возможность деактивировать предметы
|
|
||||||
- **Тип предмета** - строгое разделение на 4 основных типа
|
|
||||||
- **Связь с родительским предметом** - для производных типов (брак, продукт)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 🚚 WORKFLOW ПОСТАВОК
|
|
||||||
|
|
||||||
### 3.1 Детализированная система статусов
|
|
||||||
|
|
||||||
**Статусы SupplyOrder (Заказ поставки):**
|
|
||||||
|
|
||||||
1. **PENDING** - Ожидает подтверждения поставщиком
|
|
||||||
2. **SUPPLIER_APPROVED** - Одобрено поставщиком
|
|
||||||
3. **CONFIRMED** - Подтвержден (готов к обработке)
|
|
||||||
4. **LOGISTICS_CONFIRMED** - Подтверждено логистикой
|
|
||||||
5. **SHIPPED** - Отгружено поставщиком
|
|
||||||
6. **IN_TRANSIT** - В пути (логистика доставляет)
|
|
||||||
7. **DELIVERED** - Доставлен на фулфилмент
|
|
||||||
8. **CANCELLED** - Отменен
|
|
||||||
|
|
||||||
### 3.2 Пошаговый процесс поставки
|
|
||||||
|
|
||||||
**ЭТАП 1: Создание заказа**
|
|
||||||
|
|
||||||
1. Селлер заказывает товар/расходники у поставщика
|
|
||||||
2. Система создает SupplyOrder со статусом `PENDING`
|
|
||||||
3. Автоматическое уведомление поставщику
|
|
||||||
|
|
||||||
**ЭТАП 2: Обработка поставщиком** 4. Поставщик получает оповещение 5. Поставщик нажимает "Одобрить" 6. Статус меняется на `SUPPLIER_APPROVED`
|
|
||||||
|
|
||||||
**ЭТАП 3: Передача в фулфилмент** 7. Поставка отображается в кабинете фулфилмента 8. Фулфилмент выбирает ответственного и логистику 9. Статус меняется на `CONFIRMED`
|
|
||||||
|
|
||||||
**ЭТАП 4: Логистическое подтверждение** 10. Логистика подтверждает доставку 11. Статус меняется на `LOGISTICS_CONFIRMED`
|
|
||||||
|
|
||||||
**ЭТАП 5: Отгрузка** 12. Поставщик отгружает товар 13. Статус меняется на `SHIPPED`, затем `IN_TRANSIT`
|
|
||||||
|
|
||||||
**ЭТАП 6: Доставка и приемка** 14. Логистика доставляет на фулфилмент 15. Фулфилмент принимает товар 16. Статус меняется на `DELIVERED`
|
|
||||||
|
|
||||||
### 3.3 Система уведомлений
|
|
||||||
|
|
||||||
**Обязательные уведомления:**
|
|
||||||
|
|
||||||
- Поставщику: о новом заказе
|
|
||||||
- Фулфилменту: о подтвержденной поставке
|
|
||||||
- Логистике: о назначении на заявку
|
|
||||||
- Селлеру: об изменении каждого статуса
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 🔐 СИСТЕМА РОЛЕЙ И ДОСТУПОВ
|
|
||||||
|
|
||||||
### 4.1 Типы организаций
|
|
||||||
|
|
||||||
| Тип организации | Роль в системе | Основные функции |
|
|
||||||
| ---------------------------- | ----------------- | ------------------------------------------------------- |
|
|
||||||
| **WHOLESALE** (Поставщик) | Создатель товаров | Создание товаров, управление складом, обработка заказов |
|
|
||||||
| **SELLER** (Селлер) | Заказчик | Заказ товаров, управление поставками |
|
|
||||||
| **FULFILLMENT** (Фулфилмент) | Обработчик | Приемка товаров, управление складом, создание продуктов |
|
|
||||||
| **LOGIST** (Логистика) | Доставщик | Управление доставками |
|
|
||||||
|
|
||||||
### 4.2 Контроль доступа к заказам
|
|
||||||
|
|
||||||
- **Создатель заказа** - полный доступ к своим заказам
|
|
||||||
- **Поставщик** - доступ к заказам, где он является поставщиком
|
|
||||||
- **Фулфилмент-центр** - доступ к заказам, направленным в его центр
|
|
||||||
- **Логистическая компания** - доступ к заказам для доставки
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 🛍️ КАБИНЕТ СЕЛЛЕРА
|
|
||||||
|
|
||||||
### 5.1 Структура раздела "Мои поставки"
|
|
||||||
|
|
||||||
**🏢 ПОСТАВКИ НА ФУЛФИЛМЕНТ:**
|
|
||||||
|
|
||||||
- **Товар** - поставка товаров для создания продуктов
|
|
||||||
- **Карточки** - поставка через WB API с рецептурой
|
|
||||||
- **Поставщики** - заказ товаров у поставщиков с рецептурой
|
|
||||||
- **Расходники селлера** - поставка материалов для товаров селлера
|
|
||||||
|
|
||||||
**🛒 ПОСТАВКИ НА МАРКЕТПЛЕЙСЫ** _(планируется)_
|
|
||||||
|
|
||||||
- **Wildberries** - прямые поставки на WB
|
|
||||||
- **Ozon** - прямые поставки на Ozon
|
|
||||||
|
|
||||||
### 5.2 Создание поставки расходников селлера
|
|
||||||
|
|
||||||
**БЛОК 1: ПОСТАВЩИКИ** _(верхняя часть экрана)_
|
|
||||||
|
|
||||||
- Отображение карточек поставщиков из раздела "Партнеры"
|
|
||||||
- Горизонтальный скролл при превышении ширины экрана
|
|
||||||
- Выбор одного поставщика
|
|
||||||
|
|
||||||
**БЛОК 2: РАСХОДНИКИ** _(центральная часть)_
|
|
||||||
|
|
||||||
- Расходники выбранного поставщика
|
|
||||||
- Сортировка по цене, названию, категории
|
|
||||||
- Фильтры по категории, ценовому диапазону
|
|
||||||
- Карточка расходника с фото, названием, ценой, остатком
|
|
||||||
|
|
||||||
**БЛОК 3: КОРЗИНА** _(правая часть)_
|
|
||||||
|
|
||||||
- Количество видов расходников
|
|
||||||
- Детализация по каждому расходнику
|
|
||||||
- Общая сумма
|
|
||||||
- Выбор фулфилмент-центра
|
|
||||||
- Дата поставки
|
|
||||||
|
|
||||||
### 5.3 Правила селлера
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНО:**
|
|
||||||
|
|
||||||
- Валидация остатков перед добавлением в корзину
|
|
||||||
- Проверка доступности фулфилмент-центра
|
|
||||||
- Выбор даты поставки (не прошедшей)
|
|
||||||
|
|
||||||
**ЗАПРЕЩЕНО:**
|
|
||||||
|
|
||||||
- Редактирование созданной поставки
|
|
||||||
- Выбор нескольких поставщиков одновременно
|
|
||||||
- Заказ количества сверх остатков
|
|
||||||
- Выбор прошедших дат поставки
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 📦 КАБИНЕТ ПОСТАВЩИКА
|
|
||||||
|
|
||||||
### 6.1 Раздел склад - основные возможности
|
|
||||||
|
|
||||||
**СОЗДАНИЕ КАРТОЧЕК:**
|
|
||||||
|
|
||||||
- **ТОВАР** - базовые товары поставщика
|
|
||||||
- **РАСХОДНИКИ** - материалы и вспомогательные товары
|
|
||||||
|
|
||||||
### 6.2 Управление карточками
|
|
||||||
|
|
||||||
**Основные функции:**
|
|
||||||
|
|
||||||
- Создание карточек с обязательными полями
|
|
||||||
- Редактирование и удаление карточек
|
|
||||||
- Изменение количества в карточке
|
|
||||||
- Система загрузки изображений товаров
|
|
||||||
|
|
||||||
**Система проверок:**
|
|
||||||
|
|
||||||
- Проверка остатков при добавлении в корзину
|
|
||||||
- Валидация данных при создании/редактировании
|
|
||||||
- Проверка уникальности артикула в рамках организации
|
|
||||||
|
|
||||||
### 6.3 Статистика и аналитика поставщика
|
|
||||||
|
|
||||||
**В КАБИНЕТЕ ПОСТАВЩИКА:**
|
|
||||||
|
|
||||||
- **ТОВАРЫ**: Общая статистика товаров поставщика
|
|
||||||
- **РАСХОДНИКИ**: Материалы и вспомогательные товары
|
|
||||||
- Классифицируются при заказе в зависимости от заказчика
|
|
||||||
- Общая статистика по всем расходникам
|
|
||||||
|
|
||||||
**Блок статистики включает:**
|
|
||||||
|
|
||||||
- Общие остатки всех предметов
|
|
||||||
- Количество заказанных позиций
|
|
||||||
- Предметы в пути
|
|
||||||
- Проданные предметы
|
|
||||||
- Уведомления о низких остатках
|
|
||||||
|
|
||||||
### 6.4 Интерфейс и управление
|
|
||||||
|
|
||||||
**Режимы отображения:**
|
|
||||||
|
|
||||||
- Переключение между строчным и карточным режимами
|
|
||||||
- 5 карточек в ряд в карточном режиме
|
|
||||||
- Система фильтрации и сортировки
|
|
||||||
- Поиск по названию, артикулу, категории, бренду
|
|
||||||
|
|
||||||
**Система уведомлений:**
|
|
||||||
|
|
||||||
- Подсветка при низких остатках
|
|
||||||
- Автоматические уведомления о новых заказах
|
|
||||||
- Уведомления об изменении статусов поставок
|
|
||||||
|
|
||||||
### 6.4.1 ОТОБРАЖЕНИЕ ИНФОРМАЦИИ В КАРТОЧКАХ
|
|
||||||
|
|
||||||
**Каждая карточка товара/расходника содержит:**
|
|
||||||
|
|
||||||
**Основная информация:**
|
|
||||||
|
|
||||||
- **Основное изображение**
|
|
||||||
- **Название**
|
|
||||||
- **Артикул СФ** (автоматически сгенерированный)
|
|
||||||
- **Цена за единицу/комплект**
|
|
||||||
- **Категория**
|
|
||||||
- **Статус активности** (активен/неактивен)
|
|
||||||
|
|
||||||
**Данные о движении товара:**
|
|
||||||
|
|
||||||
- **Остаток** - текущее количество на складе
|
|
||||||
- **Заказано** - количество товара в активных заказах
|
|
||||||
- **В пути** - количество товара, которое находится в доставке
|
|
||||||
- **Продано** - количество проданного товара
|
|
||||||
|
|
||||||
**Индикаторы:**
|
|
||||||
|
|
||||||
- **Индикатор низких остатков** (если применимо)
|
|
||||||
- **Подсветка** при остатках ниже критического уровня
|
|
||||||
|
|
||||||
### 6.4.2 АКТУАЛИЗАЦИЯ ДАННЫХ
|
|
||||||
|
|
||||||
**КРИТИЧЕСКИ ВАЖНО**: При изменении количества в карточке данные актуализируются во всей системе:
|
|
||||||
|
|
||||||
- **Статистика обновляется в реальном времени**
|
|
||||||
- **Отслеживание изменений** для аналитики
|
|
||||||
- **Данные синхронизируются** с модулем аналитики
|
|
||||||
- **Обновление во всех связанных модулях** системы
|
|
||||||
|
|
||||||
### 6.5 Правила поставщика
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНО:**
|
|
||||||
|
|
||||||
- Указание всех обязательных полей при создании карточки
|
|
||||||
- Своевременная обработка заказов
|
|
||||||
- Подтверждение поставок в установленные сроки
|
|
||||||
- Ведение актуального учета остатков
|
|
||||||
|
|
||||||
**ЗАПРЕЩЕНО:**
|
|
||||||
|
|
||||||
- Добавление собственных товаров в корзину
|
|
||||||
- Создание предметов без указания типа
|
|
||||||
- Нарушение сроков обработки заказов
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 🏭 КАБИНЕТ ФУЛФИЛМЕНТА
|
|
||||||
|
|
||||||
### 7.1 Структура раздела склад фулфилмента
|
|
||||||
|
|
||||||
**Модули в обязательной последовательности:**
|
|
||||||
|
|
||||||
1. **📦 ПРОДУКТ** - готовые к продаже товары
|
|
||||||
2. **🛒 ТОВАР** - базовые товары от поставщиков
|
|
||||||
- Товары "на складе" - готовы к обработке
|
|
||||||
- Товары "в обработке" - в процессе создания продукта
|
|
||||||
3. **❌ БРАК** - товары с дефектами
|
|
||||||
4. **↩️ ВОЗВРАТЫ С ПВЗ** - возвращенные товары
|
|
||||||
5. **🎯 РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для селлеров
|
|
||||||
6. **⚙️ РАСХОДНИКИ ФУЛФИЛМЕНТ** - операционные материалы
|
|
||||||
- **КЛИКАБЕЛЬНЫЙ МОДУЛЬ** - содержит полноценный раздел учёта
|
|
||||||
|
|
||||||
### 7.2 Система учёта движения товаров
|
|
||||||
|
|
||||||
**Основные принципы учёта:**
|
|
||||||
|
|
||||||
- **ПРИХОД ТОВАРОВ**: Через принятые поставки (статус "в пути" → "на складе")
|
|
||||||
- **РАСХОД ТОВАРОВ**: При отгрузке, списании, использовании для услуг
|
|
||||||
- **ДВОЙНОЙ УЧЁТ**: Основные значения + дополнительные значения
|
|
||||||
|
|
||||||
**Дополнительные значения (показатели движения):**
|
|
||||||
|
|
||||||
- **ПРИБЫЛО** - количество поступивших на склад за период
|
|
||||||
- **УБЫЛО** - количество списанных со склада за период
|
|
||||||
|
|
||||||
**Основные значения (текущие остатки):**
|
|
||||||
|
|
||||||
- **ФОРМУЛА**: Основные значения = Предыдущие остатки + Прибыло - Убыло
|
|
||||||
- **ОТОБРАЖЕНИЕ**: Показываются в каждом модуле статистики
|
|
||||||
- **АКТУАЛЬНОСТЬ**: Обновляются в реальном времени
|
|
||||||
|
|
||||||
### 7.3 Процесс "Создания продукта"
|
|
||||||
|
|
||||||
**ЭТАП 1: ПОСТУПЛЕНИЕ И СОРТИРОВКА**
|
|
||||||
|
|
||||||
1. Товар поступает на склад фулфилмента (статус "на складе")
|
|
||||||
2. Перебор и сортировка товара
|
|
||||||
3. Выявление и отсеивание брака
|
|
||||||
|
|
||||||
**ЭТАП 2: ПОДГОТОВКА К РАБОТЕ** 4. Поставка попадает в раздел "Создание продукта" / Новые 5. Менеджер фулфилмента:
|
|
||||||
|
|
||||||
- Устанавливает дедлайн выполнения
|
|
||||||
- Назначает ответственного исполнителя
|
|
||||||
- Указывает место хранения готовых продуктов
|
|
||||||
- Нажимает "В работе"
|
|
||||||
|
|
||||||
**ЭТАП 3: ОБРАБОТКА** 6. Поставка переходит в "В работе" 7. Товары получают статус "в работе" 8. Исполнитель работает по "рецептуре" селлера:
|
|
||||||
|
|
||||||
- Применяет услуги фулфилмента
|
|
||||||
- Использует расходники селлера
|
|
||||||
- Использует расходники фулфилмента
|
|
||||||
|
|
||||||
**ЭТАП 4: УЧЕТ ПЛАН/ФАКТ** 9. Фиксируется:
|
|
||||||
|
|
||||||
- **ПЛАН**: Количество из поставки селлера
|
|
||||||
- **ФАКТ**: Реальное количество = Брак + Хороший товар
|
|
||||||
- **ДЕТАЛИЗАЦИЯ**: По каждому размеру/объему
|
|
||||||
|
|
||||||
**ЭТАП 5: ЗАВЕРШЕНИЕ** 10. Исполнитель нажимает "Выполнено" 11. Товары становятся продуктами со статусом "готов к отправке" 12. Поставка переходит в "Выполнено"
|
|
||||||
|
|
||||||
**РЕЗУЛЬТАТ**: ПРОДУКТ = Товар + Услуга + Расходники
|
|
||||||
|
|
||||||
### 7.4 Рецептура продукта
|
|
||||||
|
|
||||||
**Задается селлером при создании поставки:**
|
|
||||||
|
|
||||||
- **БАЗОВЫЙ ТОВАР**: Исходный материал
|
|
||||||
- **УСЛУГА ФУЛФИЛМЕНТА**: Из каталога услуг фулфилмента
|
|
||||||
- **РАСХОДНИК СЕЛЛЕРА**: Материалы селлера (опционально)
|
|
||||||
- **РАСХОДНИК ФУЛФИЛМЕНТА**: Материалы фулфилмента (опционально)
|
|
||||||
- **СВЯЗЬ С MP**: Связь с карточкой маркетплейса (опционально)
|
|
||||||
|
|
||||||
### 7.5 Статистика и аналитика фулфилмента
|
|
||||||
|
|
||||||
**В КАБИНЕТЕ ФУЛФИЛМЕНТА:**
|
|
||||||
|
|
||||||
- **ТОВАРЫ**: Базовые товары от поставщиков (принятые на склад)
|
|
||||||
- **ПРОДУКТЫ**: Готовая продукция (созданная из товаров)
|
|
||||||
- **БРАК**: Статистика потерь и списаний
|
|
||||||
- **РАСХОДНИКИ ФУЛФИЛМЕНТА**: Операционные материалы фулфилмента
|
|
||||||
- **РАСХОДНИКИ СЕЛЛЕРОВ**: Материалы для товаров селлеров
|
|
||||||
|
|
||||||
### 7.6 Правила фулфилмента
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНО:**
|
|
||||||
|
|
||||||
- Своевременная приемка поставок
|
|
||||||
- Ведение точного учета остатков
|
|
||||||
- Контроль качества товаров
|
|
||||||
- Фиксация брака в процессе работы
|
|
||||||
- Соблюдение сроков создания продуктов
|
|
||||||
|
|
||||||
**ЗАПРЕЩЕНО:**
|
|
||||||
|
|
||||||
- Принятие товаров без проверки качества
|
|
||||||
- Нарушение технологии создания продуктов
|
|
||||||
- Несоблюдение сроков обработки
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 🔄 ИНТЕГРАЦИИ И СВЯЗИ МЕЖДУ КАБИНЕТАМИ
|
|
||||||
|
|
||||||
### 8.1 Глобальная интеграция
|
|
||||||
|
|
||||||
- **Маркет** - данные карточки товаров и расходников отображаются в глобальной сущности
|
|
||||||
- **Синхронизация данных** между всеми модулями системы
|
|
||||||
- **Единая система уведомлений** через встроенный мессенджер
|
|
||||||
|
|
||||||
### 8.2 Интеграция с маркетплейсами
|
|
||||||
|
|
||||||
- **Wildberries API** - загрузка карточек товаров из WB
|
|
||||||
- **Синхронизация данных** с маркетплейсами
|
|
||||||
- **Создание поставок** на основе WB карточек
|
|
||||||
- **Управление API ключами** с проверкой активности
|
|
||||||
|
|
||||||
### 8.3 Интеграция с модулем "Услуги"
|
|
||||||
|
|
||||||
**Расходники фулфилмента в услугах:**
|
|
||||||
|
|
||||||
- Селлеры могут использовать расходники фулфилмента в разделе "Услуги / Расходники"
|
|
||||||
- Для создания продукта из базового товара
|
|
||||||
- Расходники списываются с остатков фулфилмента
|
|
||||||
- Стоимость включается в стоимость услуги фулфилмента
|
|
||||||
|
|
||||||
**Процесс создания продукта через услуги:**
|
|
||||||
|
|
||||||
1. Селлер выбирает услугу "Создание продукта"
|
|
||||||
2. Указывает базовый товар для обработки
|
|
||||||
3. Выбирает необходимые расходники фулфилмента
|
|
||||||
4. Фулфилмент обрабатывает заказ
|
|
||||||
5. Создается готовый продукт с использованием расходников
|
|
||||||
|
|
||||||
### 8.4 Система тарификации логистики
|
|
||||||
|
|
||||||
**Расчет стоимости доставки:**
|
|
||||||
|
|
||||||
- **Тариф до 1м³** - базовая стоимость для малых грузов
|
|
||||||
- **Тариф свыше 1м³** - стоимость для крупных грузов
|
|
||||||
- **Маршруты доставки** - от точки отправления до точки назначения
|
|
||||||
- **Описание услуг** - дополнительные условия доставки
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📋 КРИТИЧЕСКИЕ ЗАПРЕТЫ
|
|
||||||
|
|
||||||
### ❌ НИКОГДА НЕ ДЕЛАТЬ:
|
|
||||||
|
|
||||||
1. Удалять предметы с существующими заказами
|
|
||||||
2. Изменять статусы заказов без уведомлений
|
|
||||||
3. Обходить проверки остатков предметов
|
|
||||||
4. Давать доступ к чужим данным
|
|
||||||
5. Игнорировать ошибки валидации
|
|
||||||
6. Пропускать логирование критических операций
|
|
||||||
7. Создавать брак или продукт без связи с родительским товаром
|
|
||||||
8. Создавать отдельные типы расходников (только общий тип "РАСХОДНИКИ")
|
|
||||||
9. Разрешать заказ брака
|
|
||||||
10. Нарушать иерархию типов предметов
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🎖️ ПРИОРИТЕТЫ РАЗРАБОТКИ
|
|
||||||
|
|
||||||
### ВЫСОКИЙ ПРИОРИТЕТ:
|
|
||||||
|
|
||||||
1. 🔴 Безопасность и контроль доступа
|
|
||||||
2. 🔴 Целостность данных и валидация
|
|
||||||
3. 🔴 Корректность статусов поставок
|
|
||||||
4. 🔴 Уведомления участников процесса
|
|
||||||
5. 🔴 Правильная типизация предметов
|
|
||||||
|
|
||||||
### СРЕДНИЙ ПРИОРИТЕТ:
|
|
||||||
|
|
||||||
1. 🟡 Производительность и оптимизация
|
|
||||||
2. 🟡 Пользовательский опыт
|
|
||||||
3. 🟡 Аналитика и отчетность
|
|
||||||
4. 🟡 Интеграции с внешними системами
|
|
||||||
|
|
||||||
### НИЗКИЙ ПРИОРИТЕТ:
|
|
||||||
|
|
||||||
1. 🟢 Дополнительные фильтры
|
|
||||||
2. 🟢 Косметические улучшения
|
|
||||||
3. 🟢 Экспериментальные функции
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📦 ПРИЛОЖЕНИЕ: КАТЕГОРИИ РАСХОДНИКОВ
|
|
||||||
|
|
||||||
### Специализированные категории для расходников
|
|
||||||
|
|
||||||
**В дополнение к 28 универсальным категориям, для расходников рекомендуются следующие специализированные категории:**
|
|
||||||
|
|
||||||
#### 🎁 **УПАКОВКА И ЗАЩИТА**
|
|
||||||
|
|
||||||
- Коробки (различных размеров)
|
|
||||||
- Пакеты (полиэтиленовые, бумажные, фирменные)
|
|
||||||
- Пузырчатая пленка, воздушные подушки
|
|
||||||
- Стрейч-пленка, гофрокартон
|
|
||||||
- Паллетная пленка, защитные уголки
|
|
||||||
|
|
||||||
#### 🏷️ **МАРКИРОВКА И ИДЕНТИФИКАЦИЯ**
|
|
||||||
|
|
||||||
- Этикетки (адресные, штрих-код, QR-код)
|
|
||||||
- Бирки (ценники, размерники)
|
|
||||||
- Стикеры и наклейки
|
|
||||||
- Маркеры и ручки
|
|
||||||
- Штампы и печати, термоэтикетки
|
|
||||||
|
|
||||||
#### 🔧 **КРЕПЕЖ И СОЕДИНЕНИЕ**
|
|
||||||
|
|
||||||
- Скотч (прозрачный, цветной, армированный)
|
|
||||||
- Клей и клеевые составы
|
|
||||||
- Стяжки пластиковые
|
|
||||||
- Степлер и скобы
|
|
||||||
- Веревки и шнуры, стрейч-лента
|
|
||||||
|
|
||||||
#### 📄 **ДОКУМЕНТООБОРОТ И ВКЛАДЫШИ**
|
|
||||||
|
|
||||||
- Накладные и сопроводительные документы
|
|
||||||
- Инструкции по эксплуатации
|
|
||||||
- Гарантийные талоны
|
|
||||||
- Рекламные буклеты, визитки и флаеры
|
|
||||||
- Благодарственные письма, купоны и промокоды
|
|
||||||
|
|
||||||
#### 🧼 **ГИГИЕНА И БЕЗОПАСНОСТЬ**
|
|
||||||
|
|
||||||
- Перчатки (латексные, нитриловые)
|
|
||||||
- Маски и респираторы
|
|
||||||
- Антисептики и дезинфекторы
|
|
||||||
- Салфетки и тряпки
|
|
||||||
- Фартуки и халаты, бахилы
|
|
||||||
|
|
||||||
#### 🛠️ **ИНСТРУМЕНТЫ И ПРИСПОСОБЛЕНИЯ**
|
|
||||||
|
|
||||||
- Ножи и резаки, ножницы
|
|
||||||
- Линейки и рулетки
|
|
||||||
- Упаковочные машины (ленточные)
|
|
||||||
- Дозаторы скотча
|
|
||||||
- Пистолеты для термоклея
|
|
||||||
- Весы и мерная тара
|
|
||||||
|
|
||||||
#### 🎨 **БРЕНДИНГ И ДИЗАЙН**
|
|
||||||
|
|
||||||
- Фирменные пакеты с логотипом
|
|
||||||
- Брендированные коробки
|
|
||||||
- Цветная упаковочная бумага
|
|
||||||
- Ленты и банты
|
|
||||||
- Наклейки с логотипом компании
|
|
||||||
- Подарочная упаковка
|
|
||||||
|
|
||||||
#### ⚡ **СПЕЦИАЛИЗИРОВАННЫЕ МАТЕРИАЛЫ**
|
|
||||||
|
|
||||||
- Антистатические пакеты
|
|
||||||
- Влагопоглотители
|
|
||||||
- Температурные индикаторы
|
|
||||||
- Хрупкие наклейки
|
|
||||||
- Пломбы и пломбировочные материалы
|
|
||||||
- Защита от краж (магнитные датчики)
|
|
||||||
|
|
||||||
#### 🏪 **ТОРГОВОЕ ОБОРУДОВАНИЕ**
|
|
||||||
|
|
||||||
- Манекены и вешалки
|
|
||||||
- Ценникодержатели
|
|
||||||
- Подставки и стойки
|
|
||||||
- Корзины и тележки
|
|
||||||
- Зеркала примерочные
|
|
||||||
- Освещение витрин
|
|
||||||
|
|
||||||
#### 🚚 **ЛОГИСТИКА И СКЛАДИРОВАНИЕ**
|
|
||||||
|
|
||||||
- Паллеты и поддоны
|
|
||||||
- Контейнеры и ящики
|
|
||||||
- Стеллажные системы
|
|
||||||
- Погрузочные ремни
|
|
||||||
- Защитные чехлы
|
|
||||||
- Адресные ярлыки для груза
|
|
||||||
|
|
||||||
#### 💻 **ТЕХНИЧЕСКИЕ РАСХОДНИКИ**
|
|
||||||
|
|
||||||
- Картриджи для принтеров
|
|
||||||
- Термоголовки, красящие ленты
|
|
||||||
- Батарейки для сканеров
|
|
||||||
- Чистящие средства для техники
|
|
||||||
- Запчасти для упаковочного оборудования
|
|
||||||
|
|
||||||
#### 🎪 **СЕЗОННЫЕ И ПРАЗДНИЧНЫЕ**
|
|
||||||
|
|
||||||
- Новогодняя упаковка
|
|
||||||
- Подарочные мешки
|
|
||||||
- Праздничные ленты
|
|
||||||
- Тематические наклейки
|
|
||||||
- Открытки и поздравления
|
|
||||||
- Сезонная упаковочная бумага
|
|
||||||
|
|
||||||
**ПРИМЕЧАНИЕ**: Данные категории являются рекомендательными и могут быть адаптированы под специфику конкретного поставщика расходников.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
_Документ создан на основе файла description.md_
|
|
||||||
_Версия: 1.1_
|
|
||||||
_Дата: 2024_
|
|
||||||
_Статус: АКТИВНЫЕ ПРАВИЛА_
|
|
@ -1,1819 +0,0 @@
|
|||||||
# ПРАВИЛА СИСТЕМЫ УПРАВЛЕНИЯ СКЛАДАМИ И ПОСТАВКАМИ - БАЗА ЗНАНИЙ v2.0
|
|
||||||
|
|
||||||
> ⚠️ **ВАЖНОЕ ПРИМЕЧАНИЕ**: Данный файл является объединенной базой знаний системы на основе анализа rules.md, rules1.md и description.md. Все изменения должны согласовываться.
|
|
||||||
|
|
||||||
## 🔤 ТЕРМИНЫ СИСТЕМЫ
|
|
||||||
> Для людей → `В коде`
|
|
||||||
- ТОВАР → `PRODUCT`
|
|
||||||
- РАСХОДНИКИ → `CONSUMABLE`
|
|
||||||
- БРАК → `DEFECT` *(планируется)*
|
|
||||||
- ПРОДУКТ → `FINISHED_PRODUCT` *(планируется)*
|
|
||||||
- ПОСТАВЩИК → `WHOLESALE`
|
|
||||||
- СЕЛЛЕР → `SELLER`
|
|
||||||
- ФУЛФИЛМЕНТ → `FULFILLMENT`
|
|
||||||
- ЛОГИСТИКА → `LOGIST`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📑 ОГЛАВЛЕНИЕ
|
|
||||||
|
|
||||||
### 🏗️ **АРХИТЕКТУРА И ОСНОВЫ**
|
|
||||||
|
|
||||||
1. [🎯 Основные принципы системы](#1--основные-принципы-системы)
|
|
||||||
2. [📦 Типизация предметов](#2--типизация-предметов)
|
|
||||||
3. [🏢 Структура кабинетов](#3--структура-кабинетов)
|
|
||||||
4. [🔐 Система ролей и доступов](#4--система-ролей-и-доступов)
|
|
||||||
|
|
||||||
### 🚚 **WORKFLOW И ПРОЦЕССЫ**
|
|
||||||
|
|
||||||
5. [🚚 Workflow поставок](#5--workflow-поставок)
|
|
||||||
6. [🔄 Процесс создания продукта](#6--процесс-создания-продукта)
|
|
||||||
7. [📊 Система учета движения товаров](#7--система-учета-движения-товаров)
|
|
||||||
|
|
||||||
### 🏢 **КАБИНЕТЫ СИСТЕМЫ**
|
|
||||||
|
|
||||||
8. [🏠 Общие правила кабинетов](#8--общие-правила-кабинетов)
|
|
||||||
9. [🏠 Кабинет селлера](#9--кабинет-селлера)
|
|
||||||
10. [🏪 Кабинет поставщика](#10--кабинет-поставщика)
|
|
||||||
11. [🏭 Кабинет фулфилмента](#11--кабинет-фулфилмента)
|
|
||||||
12. [🚚 Кабинет логистики](#12--кабинет-логистики)
|
|
||||||
|
|
||||||
### 🤝 **СИСТЕМА ПАРТНЕРСТВА**
|
|
||||||
|
|
||||||
13. [🤝 Система партнерства и контрагентов](#13--система-партнерства-и-контрагентов)
|
|
||||||
|
|
||||||
### 🌐 **ИНТЕГРАЦИИ И ФУНКЦИИ**
|
|
||||||
|
|
||||||
14. [🌐 Интеграции с системой](#14--интеграции-с-системой)
|
|
||||||
15. [📊 Статистика и аналитика](#15--статистика-и-аналитика)
|
|
||||||
16. [⚠️ Критические запреты](#16--критические-запреты)
|
|
||||||
|
|
||||||
### 💻 **ТЕХНИЧЕСКИЕ ПРАВИЛА**
|
|
||||||
|
|
||||||
17. [📱 Правила пользовательского интерфейса](#17--правила-пользовательского-интерфейса)
|
|
||||||
18. [🚨 Правила обработки ошибок](#18--правила-обработки-ошибок)
|
|
||||||
19. [📈 Правила производительности](#19--правила-производительности)
|
|
||||||
20. [🔐 Правила безопасности данных](#20--правила-безопасности-данных)
|
|
||||||
21. [🎯 Правила качества кода](#21--правила-качества-кода)
|
|
||||||
|
|
||||||
### 📋 **ДОПОЛНИТЕЛЬНО**
|
|
||||||
|
|
||||||
22. [📋 Приложение: Дополнительные возможности и планы](#22-приложение-дополнительные-возможности-и-планы)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🏷️ РЕЕСТР СУЩНОСТЕЙ СИСТЕМЫ
|
|
||||||
|
|
||||||
### 📦 **ОСНОВНЫЕ ПРЕДМЕТЫ**
|
|
||||||
|
|
||||||
| Сущность | Название в системе | Кабинет создания | Описание | Статус |
|
|
||||||
| ---------- | ---------------------------------- | ---------------- | ----------------------------------------------- | --------------- |
|
|
||||||
| Товар | `Product` (type: `PRODUCT`) | Поставщик | Базовый тип товара от поставщика | ✅ Реализовано |
|
|
||||||
| Расходники | `Product` (type: `CONSUMABLE`) | Поставщик | Материалы и вспомогательные товары | ✅ Реализовано |
|
|
||||||
| Брак | `Product` (type: `DEFECT`)* | Фулфилмент | Производная от товара с дефектами | 📋 Планируется |
|
|
||||||
| Продукт | `Product` (type: `FINISHED_PRODUCT`)* | Фулфилмент | Готовый к продаже товар (производная от товара) | 📋 Планируется |
|
|
||||||
|
|
||||||
> **\* Планируется**: Типы `DEFECT` и `FINISHED_PRODUCT` еще не добавлены в Prisma схему
|
|
||||||
|
|
||||||
### 🏢 **ОРГАНИЗАЦИИ И РОЛИ**
|
|
||||||
|
|
||||||
| Сущность | Название в системе | Основные функции | Статус |
|
|
||||||
| ---------- | ---------------------------------- | --------------------------------------- | -------------- |
|
|
||||||
| Поставщик | `Organization` (type: WHOLESALE) | Создает товары и расходники | ✅ Реализовано |
|
|
||||||
| Селлер | `Organization` (type: SELLER) | Заказывает товары, управляет поставками | ✅ Реализовано |
|
|
||||||
| Фулфилмент | `Organization` (type: FULFILLMENT) | Принимает товары, создает продукты | ✅ Реализовано |
|
|
||||||
| Логистика | `Organization` (type: LOGIST) | Управляет доставками | ✅ Реализовано |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 🎯 ОСНОВНЫЕ ПРИНЦИПЫ СИСТЕМЫ
|
|
||||||
|
|
||||||
### 1.1 Главная логика системы
|
|
||||||
|
|
||||||
**КЛЮЧЕВОЕ ПРАВИЛО**: Товар ≠ Продукт (это разные сущности в системе)
|
|
||||||
|
|
||||||
- **ТОВАР** - сырье, базовый материал от поставщика
|
|
||||||
- **ПРОДУКТ** - готовая к продаже единица после обработки
|
|
||||||
|
|
||||||
### 1.2 Потоки в системе
|
|
||||||
|
|
||||||
**ПОТОК ТОВАРОВ**: Поставщик → Фулфилмент → Селлер/Маркетплейс
|
|
||||||
**ПОТОК РАСХОДНИКОВ**: Поставщик → Фулфилмент/Селлер (в зависимости от заказчика)
|
|
||||||
|
|
||||||
### 1.3 Уникальность артикулов
|
|
||||||
|
|
||||||
- **ФОРМАТ**: `СФ-{ТИП}-{КОД_КАТЕГОРИИ}-{КОД_ОРГАНИЗАЦИИ}-{TIMESTAMP}-{RANDOM}`
|
|
||||||
- **ТИПЫ В АРТИКУЛЕ**:
|
|
||||||
- `TOV` - Товар
|
|
||||||
- `BRK` - Брак
|
|
||||||
- `R` - Расходники
|
|
||||||
- `PRD` - Продукт
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 📦 ТИПИЗАЦИЯ ПРЕДМЕТОВ
|
|
||||||
|
|
||||||
### 2.1 Два реализованных и два планируемых типа предметов
|
|
||||||
|
|
||||||
#### **1. ТОВАР** (`PRODUCT` - базовый тип)
|
|
||||||
|
|
||||||
- **СОЗДАЕТСЯ**: Поставщиком
|
|
||||||
- **СТАТУС**: Может быть активным/неактивным
|
|
||||||
- **ЗАКАЗ**: Доступен для заказа всеми типами организаций
|
|
||||||
- **ТРАНСФОРМАЦИЯ**: Может стать ПРОДУКТОМ или БРАКОМ
|
|
||||||
- **ЦЕНА**: Обязательна, больше 0
|
|
||||||
|
|
||||||
#### **2. РАСХОДНИКИ** (`CONSUMABLE` - базовый тип)
|
|
||||||
|
|
||||||
- **СОЗДАЕТСЯ**: Поставщиком как универсальный тип
|
|
||||||
- **КЛАССИФИКАЦИЯ ПРИ ЗАКАЗЕ**:
|
|
||||||
- Фулфилмент заказывает → "Расходники фулфилмента"
|
|
||||||
- Селлер заказывает → "Расходники селлеров"
|
|
||||||
- **ДОСТУП**: Видны всем типам организаций в маркете
|
|
||||||
|
|
||||||
#### **3. БРАК** (`DEFECT` - планируется, производная от товара)
|
|
||||||
|
|
||||||
- **БУДЕТ СОЗДАВАТЬСЯ**: Фулфилментом на основе существующего ТОВАРА при обнаружении дефектов
|
|
||||||
- **МОМЕНТ СОЗДАНИЯ**: В процессе "Создание продукта" / "В работе" после подсчета факта
|
|
||||||
- **СВЯЗЬ**: Обязательная связь с родительским товаром (parentId)
|
|
||||||
- **ЗАКАЗ**: ЗАПРЕЩЕН заказ брака
|
|
||||||
- **СТАТУС**: Всегда неактивен для заказа
|
|
||||||
- **ЦЕНА**: Для селлера - себестоимость дефектного товара, для фулфилмента - 0
|
|
||||||
- **WORKFLOW**: Особый процесс списания и утилизации
|
|
||||||
- **УЧЕТ**: Отдельный учет в статистике потерь
|
|
||||||
- **ОТОБРАЖЕНИЕ**: Виден только для учета потерь
|
|
||||||
- **⚠️ СТАТУС РАЗРАБОТКИ**: Тип `DEFECT` еще не добавлен в схему БД
|
|
||||||
|
|
||||||
#### **4. ПРОДУКТ** (`FINISHED_PRODUCT` - планируется, производная от товара)
|
|
||||||
|
|
||||||
- **БУДЕТ СОЗДАВАТЬСЯ**: Фулфилментом на основе ТОВАРА по заказу селлера
|
|
||||||
- **ИНИЦИАТОР**: Селлер создает заказ с рецептурой, фулфилмент исполняет
|
|
||||||
- **СВЯЗЬ**: Обязательная связь с родительским товаром (parentId)
|
|
||||||
- **РЕЦЕПТУРА**: Задается селлером при создании заказа (Товар + Услуга + Расходники)
|
|
||||||
- **СТАТУСЫ**: "в работе" → "готов к отправке"
|
|
||||||
- **ЗАКАЗ**: Доступен только в статусе "готов к отправке"
|
|
||||||
- **⚠️ СТАТУС РАЗРАБОТКИ**: Тип `FINISHED_PRODUCT` еще не добавлен в схему БД
|
|
||||||
|
|
||||||
### 2.2 Обязательные поля карточки
|
|
||||||
|
|
||||||
**КРИТИЧЕСКИ ВАЖНО**: Название, артикул, цена > 0, тип предмета
|
|
||||||
**ИСКЛЮЧЕНИЕ ДЛЯ БРАКА**: Цена может быть 0 для фулфилмента (себестоимость для селлера)
|
|
||||||
**ОБЯЗАТЕЛЬНО**: Количество (может быть 0 для предзаказа)
|
|
||||||
**ДЛЯ ПРОИЗВОДНЫХ ТИПОВ**: Обязательная связь с родительским предметом
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 🏢 СТРУКТУРА КАБИНЕТОВ
|
|
||||||
|
|
||||||
### 3.1 Кабинет поставщика
|
|
||||||
|
|
||||||
**СОЗДАЕТ И УПРАВЛЯЕТ**:
|
|
||||||
|
|
||||||
- **ТОВАР** - базовые товары поставщика
|
|
||||||
- **РАСХОДНИКИ** - материалы и вспомогательные товары
|
|
||||||
|
|
||||||
### 3.2 Кабинет фулфилмента
|
|
||||||
|
|
||||||
**ПРИНИМАЕТ, ОБРАБАТЫВАЕТ И УПРАВЛЯЕТ**:
|
|
||||||
|
|
||||||
- **ТОВАР** - базовые товары от поставщиков (принятые на склад)
|
|
||||||
- **БРАК** - производная от товара (товары с дефектами)
|
|
||||||
- **ПРОДУКТ** - производная от товара (готовые к продаже товары)
|
|
||||||
- **РАСХОДНИКИ ФУЛФИЛМЕНТА** - операционные материалы фулфилмента
|
|
||||||
- **РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для товаров селлеров
|
|
||||||
|
|
||||||
### 3.3 Кабинет селлера
|
|
||||||
|
|
||||||
**ЗАКАЗЫВАЕТ И УПРАВЛЯЕТ ПОСТАВКАМИ**:
|
|
||||||
|
|
||||||
- Создает заказы товаров и расходников
|
|
||||||
- Управляет поставками на фулфилмент и маркетплейсы
|
|
||||||
- Отслеживает статусы поставок
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 🔐 СИСТЕМА РОЛЕЙ И ДОСТУПОВ
|
|
||||||
|
|
||||||
### 4.1 Роли в системе
|
|
||||||
|
|
||||||
| Роль | Функции |
|
|
||||||
| ---------- | ------------------------------------------------------------------------ |
|
|
||||||
| Поставщик | Создание товаров, одобрение заказов, отгрузка |
|
|
||||||
| Селлер | Создание заказов, отслеживание поставок |
|
|
||||||
| Фулфилмент | Приемка товаров, выбор логистики, управление складом, создание продуктов |
|
|
||||||
| Логистика | Подтверждение доставки, транспортировка |
|
|
||||||
|
|
||||||
### 4.2 Контроль доступа
|
|
||||||
|
|
||||||
- **ЗАПРЕЩЕНО**: Поставщик не может добавлять собственные предметы в корзину
|
|
||||||
- **ПРАВИЛО**: Только активные предметы (`isActive: true`) отображаются в маркете
|
|
||||||
- **ОГРАНИЧЕНИЕ**: Доступ к заказам только для участников процесса
|
|
||||||
- **БРАК**: Доступен только для просмотра, заказ запрещен
|
|
||||||
|
|
||||||
### 4.3 Проверка остатков
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Проверять наличие предмета перед добавлением в корзину
|
|
||||||
- **ПРАВИЛО**: Количество в заказе не может превышать остаток на складе
|
|
||||||
- **ИСКЛЮЧЕНИЕ**: Предзаказы (если реализована функция)
|
|
||||||
- **ОСОБЕННОСТИ ПО ТИПАМ**:
|
|
||||||
- **ТОВАР/ПРОДУКТ**: Стандартная проверка остатков
|
|
||||||
- **БРАК**: Остатки учитываются, но заказ запрещен
|
|
||||||
- **РАСХОДНИКИ**: Проверка с учетом резервирования под активные заказы
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 5. 🚚 WORKFLOW ПОСТАВОК
|
|
||||||
|
|
||||||
### 5.1 Жизненный цикл статусов
|
|
||||||
|
|
||||||
```
|
|
||||||
PENDING → SUPPLIER_APPROVED → CONFIRMED → LOGISTICS_CONFIRMED → SHIPPED → IN_TRANSIT → DELIVERED
|
|
||||||
```
|
|
||||||
|
|
||||||
### 5.2 Детальный процесс поставки
|
|
||||||
|
|
||||||
#### **ЭТАП 1: Создание заказа**
|
|
||||||
|
|
||||||
1. Селлер заказывает товар/расходники у поставщика
|
|
||||||
2. Система создает SupplyOrder со статусом `PENDING`
|
|
||||||
3. Автоматическое уведомление поставщику
|
|
||||||
|
|
||||||
#### **ЭТАП 2: Обработка поставщиком**
|
|
||||||
|
|
||||||
4. Поставщик получает оповещение
|
|
||||||
5. Поставщик нажимает "Одобрить"
|
|
||||||
6. Статус меняется на `SUPPLIER_APPROVED`
|
|
||||||
|
|
||||||
#### **ЭТАП 3: Передача в фулфилмент**
|
|
||||||
|
|
||||||
7. Поставка отображается в кабинете фулфилмента
|
|
||||||
8. Фулфилмент выбирает ответственного и логистику
|
|
||||||
9. Статус меняется на `CONFIRMED`
|
|
||||||
|
|
||||||
#### **ЭТАП 4: Логистическое подтверждение**
|
|
||||||
|
|
||||||
10. Логистика подтверждает доставку
|
|
||||||
11. Статус меняется на `LOGISTICS_CONFIRMED`
|
|
||||||
|
|
||||||
#### **ЭТАП 5: Отгрузка**
|
|
||||||
|
|
||||||
12. Поставщик отгружает товар
|
|
||||||
13. Статус меняется на `SHIPPED`, затем `IN_TRANSIT`
|
|
||||||
|
|
||||||
#### **ЭТАП 6: Доставка и приемка**
|
|
||||||
|
|
||||||
14. Логистика доставляет на фулфилмент
|
|
||||||
15. Фулфилмент принимает товар
|
|
||||||
16. Статус меняется на `DELIVERED`
|
|
||||||
|
|
||||||
### 5.3 Система уведомлений
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНЫЕ УВЕДОМЛЕНИЯ**:
|
|
||||||
|
|
||||||
- Поставщику: о новом заказе
|
|
||||||
- Фулфилменту: о подтвержденной поставке
|
|
||||||
- Логистике: о назначении на заявку
|
|
||||||
- Селлеру: об изменении каждого статуса
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 6. 🔄 ПРОЦЕСС СОЗДАНИЯ ПРОДУКТА
|
|
||||||
|
|
||||||
### 6.1 Workflow создания продукта
|
|
||||||
|
|
||||||
#### **ЭТАП 1: ПОСТУПЛЕНИЕ И ПОДСЧЕТ**
|
|
||||||
|
|
||||||
1. Товар приходит на склад фулфилмента (статус "на складе")
|
|
||||||
2. Подсчет фактического количества товара (может отличаться от плана)
|
|
||||||
3. Проверка товара на дефекты и выявление брака
|
|
||||||
|
|
||||||
#### **ЭТАП 2: ПОДГОТОВКА К РАБОТЕ**
|
|
||||||
|
|
||||||
4. Поставка попадает в раздел "Создание продукта" / "Новые"
|
|
||||||
5. Менеджер задает:
|
|
||||||
- Дедлайн выполнения
|
|
||||||
- Ответственного исполнителя
|
|
||||||
- Место хранения готовых продуктов
|
|
||||||
6. Нажимает "В работе"
|
|
||||||
|
|
||||||
#### **ЭТАП 3: ОБРАБОТКА**
|
|
||||||
|
|
||||||
7. Товары получают статус "в работе"
|
|
||||||
8. Исполнитель работает по "рецептуре" селлера:
|
|
||||||
- Применяет услуги фулфилмента
|
|
||||||
- Использует расходники селлера
|
|
||||||
- Использует расходники фулфилмента
|
|
||||||
|
|
||||||
#### **ЭТАП 4: УЧЕТ ПЛАН/ФАКТ**
|
|
||||||
|
|
||||||
9. Фиксируется в разделе "В работе":
|
|
||||||
- **ПЛАН**: Количество из поставки селлера
|
|
||||||
- **ФАКТ**: Реальное количество после подсчета = Брак + Хороший товар
|
|
||||||
- **СОЗДАНИЕ БРАКА**: Данные о браке вносятся в кабинете фулфилмента
|
|
||||||
- **ДЕТАЛИЗАЦИЯ**: По каждому размеру/объему
|
|
||||||
|
|
||||||
#### **ЭТАП 5: ЗАВЕРШЕНИЕ**
|
|
||||||
|
|
||||||
10. Исполнитель нажимает "Выполнено"
|
|
||||||
11. Товары становятся продуктами со статусом "готов к отправке"
|
|
||||||
12. Поставка переходит в "Выполнено"
|
|
||||||
|
|
||||||
### 6.2 Рецептура продукта (задается селлером)
|
|
||||||
|
|
||||||
**РЕЗУЛЬТАТ**: ПРОДУКТ = Товар + Услуга + Расходники
|
|
||||||
|
|
||||||
**КОМПОНЕНТЫ**:
|
|
||||||
|
|
||||||
- **БАЗОВЫЙ ТОВАР**: Исходный материал (например, футболка)
|
|
||||||
- **УСЛУГА ФУЛФИЛМЕНТА**: Из каталога услуг (например, "погладить")
|
|
||||||
- **РАСХОДНИК СЕЛЛЕРА**: Материалы селлера (например, фирменный пакет)
|
|
||||||
- **РАСХОДНИК ФУЛФИЛМЕНТА**: Материалы фулфилмента (например, короб + маркировка)
|
|
||||||
- **СВЯЗЬ С MP**: Опциональная связь с карточкой маркетплейса
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 7. 📊 СИСТЕМА УЧЕТА ДВИЖЕНИЯ ТОВАРОВ
|
|
||||||
|
|
||||||
### 7.1 Основные принципы учета
|
|
||||||
|
|
||||||
- **ПРИХОД**: Товары поступают через принятые поставки (из "в пути" → "на складе")
|
|
||||||
- **ОБРАБОТКА**: Товары переходят в статус "в работе" для создания продуктов
|
|
||||||
- **РАСХОД**: Товары убывают при отгрузке, списании, возврате, превращении в продукты
|
|
||||||
|
|
||||||
### 7.2 Двойной учет
|
|
||||||
|
|
||||||
**ДОПОЛНИТЕЛЬНЫЕ ЗНАЧЕНИЯ (показатели движения)**:
|
|
||||||
|
|
||||||
- **ПРИБЫЛО**: Количество предметов, поступивших на склад
|
|
||||||
- **УБЫЛО**: Количество предметов, списанных со склада
|
|
||||||
|
|
||||||
**ОСНОВНЫЕ ЗНАЧЕНИЯ (текущие остатки)**:
|
|
||||||
|
|
||||||
- **ФОРМУЛА**: Основные значения = Предыдущие остатки + Прибыло - Убыло
|
|
||||||
- **ОТОБРАЖЕНИЕ**: Показываются в каждом модуле статистики
|
|
||||||
|
|
||||||
### 7.3 Состояния процессов в фулфилменте
|
|
||||||
|
|
||||||
- **"На складе"** - состояние завершения процесса поставки (товар принят)
|
|
||||||
- **"В работе"** - состояние процесса "Создание продукта" (товар обрабатывается)
|
|
||||||
- **ВАЖНО**: Это состояния процессов, а не взаимоисключающие характеристики товара
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 8. 🏠 ОБЩИЕ ПРАВИЛА КАБИНЕТОВ
|
|
||||||
|
|
||||||
### 8.1 Универсальная структура кабинетов
|
|
||||||
|
|
||||||
**ВСЕ ТИПЫ КАБИНЕТОВ** включают следующие обязательные разделы:
|
|
||||||
|
|
||||||
#### 8.1.1 Страница "Главная"
|
|
||||||
|
|
||||||
**СТАТУС**: Планируется к реализации
|
|
||||||
**ДОСТУП**: Через навигацию в sidebar для всех типов кабинетов
|
|
||||||
**СОДЕРЖАНИЕ**: Пока пустые страницы, будут наполнены позже
|
|
||||||
|
|
||||||
**ПРАВИЛА**:
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Каждый тип кабинета должен иметь страницу "Главная"
|
|
||||||
- **НАВИГАЦИЯ**: Доступ через кнопку в sidebar (первая в списке)
|
|
||||||
- **УНИВЕРСАЛЬНОСТЬ**: Одинаковая структура навигации для всех кабинетов
|
|
||||||
- **ПЛАНЫ**: Содержание страниц будет определено на следующих этапах
|
|
||||||
|
|
||||||
#### 8.1.2 Общие разделы для всех кабинетов
|
|
||||||
|
|
||||||
**УНИВЕРСАЛЬНЫЕ РАЗДЕЛЫ** (доступны всем типам):
|
|
||||||
|
|
||||||
- 🏠 **Главная** - основная страница кабинета (планируется)
|
|
||||||
- 🛒 **Маркет** - просмотр и заказ товаров
|
|
||||||
- 🤝 **Партнеры** - управление контрагентами
|
|
||||||
- 💬 **Мессенджер** - внутренняя связь
|
|
||||||
- ⚙️ **Настройки** - профиль и конфигурация
|
|
||||||
|
|
||||||
**СПЕЦИАЛИЗИРОВАННЫЕ РАЗДЕЛЫ** (зависят от типа кабинета):
|
|
||||||
|
|
||||||
- Определяются в соответствующих разделах каждого кабинета
|
|
||||||
|
|
||||||
### 8.2 Правила sidebar навигации
|
|
||||||
|
|
||||||
#### 8.2.1 Структура навигации
|
|
||||||
|
|
||||||
**ОБЩИЙ ПРИНЦИП**:
|
|
||||||
|
|
||||||
- Условное отображение: `{user?.organization?.type === "TYPE" && (...)}`
|
|
||||||
- Адаптивность: сворачиваемый sidebar с `getSidebarMargin()`
|
|
||||||
- Состояния активности: подсветка текущего раздела
|
|
||||||
|
|
||||||
**ПОРЯДОК РАЗДЕЛОВ В SIDEBAR**:
|
|
||||||
|
|
||||||
1. 🏠 **Главная** (планируется для всех)
|
|
||||||
2. **Специализированные разделы** (зависят от типа кабинета)
|
|
||||||
3. 🛒 **Маркет** (универсальный)
|
|
||||||
4. 🤝 **Партнеры** (универсальный)
|
|
||||||
5. 💬 **Мессенджер** (универсальный)
|
|
||||||
6. ⚙️ **Настройки** (универсальный)
|
|
||||||
7. **Выход** (универсальный)
|
|
||||||
|
|
||||||
#### 8.2.2 Типо-зависимая логика
|
|
||||||
|
|
||||||
**АДАПТИВНЫЙ РОУТИНГ**:
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// Пример: кнопка "Поставки" ведет на разные страницы
|
|
||||||
const handleSuppliesClick = () => {
|
|
||||||
switch (user?.organization?.type) {
|
|
||||||
case "FULFILLMENT":
|
|
||||||
router.push("/fulfillment-supplies");
|
|
||||||
break;
|
|
||||||
case "SELLER":
|
|
||||||
router.push("/supplies");
|
|
||||||
break;
|
|
||||||
case "WHOLESALE":
|
|
||||||
router.push("/supplies");
|
|
||||||
break;
|
|
||||||
case "LOGIST":
|
|
||||||
router.push("/logistics-orders");
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
};
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 9. 🏠 КАБИНЕТ СЕЛЛЕРА
|
|
||||||
|
|
||||||
### 9.1 Структура раздела "Мои поставки"
|
|
||||||
|
|
||||||
#### **🏢 ПОСТАВКИ НА ФУЛФИЛМЕНТ**:
|
|
||||||
|
|
||||||
- **Товар** - поставка товаров для создания продуктов
|
|
||||||
- **Карточки** - поставка через WB API с рецептурой (результат: WildberriesSupply)
|
|
||||||
- **Поставщики** - заказ товаров у поставщиков с рецептурой (результат: SupplyOrder)
|
|
||||||
- **Расходники селлера** - поставка материалов для товаров селлера
|
|
||||||
|
|
||||||
#### **🛒 ПОСТАВКИ НА МАРКЕТПЛЕЙСЫ** _(планируется)_:
|
|
||||||
|
|
||||||
- **Wildberries** - прямые поставки на WB
|
|
||||||
- **Ozon** - прямые поставки на Ozon
|
|
||||||
|
|
||||||
### 9.2 Создание поставки расходников селлера
|
|
||||||
|
|
||||||
#### **Структура страницы**:
|
|
||||||
|
|
||||||
**БЛОК 1: ПОСТАВЩИКИ** _(обязательный, верхняя часть)_:
|
|
||||||
|
|
||||||
- Карточки поставщиков из раздела "Партнеры"
|
|
||||||
- Горизонтальный скролл при превышении ширины
|
|
||||||
- Выбор только одного поставщика одновременно
|
|
||||||
|
|
||||||
**БЛОК 2: РАСХОДНИКИ** _(зависимый, центральная часть)_:
|
|
||||||
|
|
||||||
- Активен только после выбора поставщика
|
|
||||||
- Сортировка: цена, название, категория
|
|
||||||
- Фильтры: категория, ценовой диапазон
|
|
||||||
- Карточка с полем ввода количества и кнопками +/-
|
|
||||||
|
|
||||||
**БЛОК 3: КОРЗИНА** _(правая часть)_:
|
|
||||||
|
|
||||||
- **РАСПОЛОЖЕНИЕ**: Правая часть экрана
|
|
||||||
- **СОДЕРЖАНИЕ**:
|
|
||||||
- Счетчик видов расходников
|
|
||||||
- Детализация по каждому расходнику (название, количество, цена, сумма)
|
|
||||||
- Общая сумма всех расходников
|
|
||||||
- **УПРАВЛЕНИЕ**:
|
|
||||||
- Изменение количества (с валидацией остатков)
|
|
||||||
- Удаление позиций
|
|
||||||
- **ОБЯЗАТЕЛЬНЫЕ ПОЛЯ**:
|
|
||||||
- Выбор фулфилмент-центра (из партнеров)
|
|
||||||
- Дата поставки (не прошедшая, по умолчанию - текущая)
|
|
||||||
|
|
||||||
#### **Валидация и ограничения**:
|
|
||||||
|
|
||||||
**КОЛИЧЕСТВО ТОВАРОВ**:
|
|
||||||
|
|
||||||
- **МИНИМУМ**: 1 единица/комплект
|
|
||||||
- **МАКСИМУМ**: Остаток у поставщика
|
|
||||||
- **ПРОВЕРКА**: В реальном времени при изменении
|
|
||||||
|
|
||||||
**ДАТА ПОСТАВКИ**:
|
|
||||||
|
|
||||||
- **ЗАПРЕТ**: Выбор прошедших дат
|
|
||||||
- **ПО УМОЛЧАНИЮ**: Дата создания поставки
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНЫЕ ПОЛЯ**:
|
|
||||||
|
|
||||||
- Выбор поставщика
|
|
||||||
- Минимум один расходник в корзине
|
|
||||||
- Выбор фулфилмент-центра
|
|
||||||
- Дата поставки
|
|
||||||
|
|
||||||
### 8.3 Отображение созданных поставок
|
|
||||||
|
|
||||||
#### **Многоуровневая таблица**:
|
|
||||||
|
|
||||||
**ПЕРВЫЙ УРОВЕНЬ** _(основной список)_:
|
|
||||||
|
|
||||||
- **СОРТИРОВКА**: Номер поставки от большего к меньшему
|
|
||||||
- **ОБЯЗАТЕЛЬНЫЕ КОЛОНКИ**:
|
|
||||||
- Порядковый номер поставки
|
|
||||||
- Количество видов расходников
|
|
||||||
- Стоимость всей поставки
|
|
||||||
- Количество категорий
|
|
||||||
- Статус поставки
|
|
||||||
|
|
||||||
**ВТОРОЙ УРОВЕНЬ** _(детализация по клику)_:
|
|
||||||
|
|
||||||
- **АКТИВАЦИЯ**: По клику на строку первого уровня
|
|
||||||
- **СОДЕРЖАНИЕ**:
|
|
||||||
- Название расходника
|
|
||||||
- Количество
|
|
||||||
- Цена
|
|
||||||
- Категория
|
|
||||||
- Поставщик
|
|
||||||
- **ОГРАНИЧЕНИЯ**: Только просмотр, редактирование запрещено
|
|
||||||
|
|
||||||
### 8.4 Статусы поставок селлера
|
|
||||||
|
|
||||||
1. **В работе** - создана селлером
|
|
||||||
2. **Одобрена** - подтверждена поставщиком
|
|
||||||
3. **Ожидает отгрузки** - логистика назначена
|
|
||||||
4. **В пути** - товар отгружен
|
|
||||||
5. **Доставлена/Принято** - получена фулфилментом
|
|
||||||
|
|
||||||
### 9.3 Правила кнопки "Создать поставку" в разделе "Мои поставки"
|
|
||||||
|
|
||||||
#### **9.3.1 Общие принципы**
|
|
||||||
|
|
||||||
- **КОНТЕКСТНОСТЬ**: Кнопка создания появляется только в активном табе
|
|
||||||
- **РАСПОЛОЖЕНИЕ**: Правая часть строки таба, на том же уровне что и название
|
|
||||||
- **СТИЛИСТИКА**: В том же стиле что и сами табы (соответствует уровню иерархии)
|
|
||||||
- **ФУНКЦИОНАЛЬНОСТЬ**: Кнопка ведет на страницу создания поставки соответствующего типа
|
|
||||||
|
|
||||||
#### **9.3.2 Размещение кнопок по табам**
|
|
||||||
|
|
||||||
**УРОВЕНЬ 2 (Подтабы фулфилмента):**
|
|
||||||
|
|
||||||
- **📦 Товар → Карточки**: Кнопка "Создать поставку" → `/supplies/create-cards`
|
|
||||||
- **📦 Товар → Поставщики**: Кнопка "Создать поставку" → `/supplies/create-suppliers`
|
|
||||||
- **🔧 Расходники селлера**: Кнопка "Создать поставку" → `/supplies/create-consumables`
|
|
||||||
|
|
||||||
**УРОВЕНЬ 2 (Подтабы маркетплейсов):**
|
|
||||||
|
|
||||||
- **🟣 Wildberries**: Кнопка "Создать поставку" → `/supplies/create-wildberries`
|
|
||||||
- **🔵 Ozon**: Кнопка "Создать поставку" → `/supplies/create-ozon`
|
|
||||||
|
|
||||||
#### **9.3.3 Стили кнопок**
|
|
||||||
|
|
||||||
**ДЛЯ УРОВНЯ 2 (h-9):**
|
|
||||||
|
|
||||||
```css
|
|
||||||
/* Размер и отступы */
|
|
||||||
h-9 px-3 py-1 ml-auto
|
|
||||||
|
|
||||||
/* Фон и границы */
|
|
||||||
bg-white/8 border border-white/20 hover:bg-white/12
|
|
||||||
|
|
||||||
/* Текст и иконки */
|
|
||||||
text-xs font-medium text-white/80 hover:text-white
|
|
||||||
|
|
||||||
/* Скругления */
|
|
||||||
rounded-lg
|
|
||||||
|
|
||||||
/* Переходы */
|
|
||||||
transition-all duration-150
|
|
||||||
```
|
|
||||||
|
|
||||||
**ДЛЯ УРОВНЯ 3 (h-8):**
|
|
||||||
|
|
||||||
```css
|
|
||||||
/* Размер и отступы */
|
|
||||||
h-8 px-2 py-1 ml-auto
|
|
||||||
|
|
||||||
/* Фон и границы */
|
|
||||||
bg-white/5 border border-white/15 hover:bg-white/8
|
|
||||||
|
|
||||||
/* Текст и иконки */
|
|
||||||
text-xs font-normal text-white/60 hover:text-white/80
|
|
||||||
|
|
||||||
/* Скругления */
|
|
||||||
rounded-md
|
|
||||||
|
|
||||||
/* Переходы */
|
|
||||||
transition-all duration-150
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **9.3.4 Поведение кнопок**
|
|
||||||
|
|
||||||
- **ВИДИМОСТЬ**: Кнопка показывается только в активном табе
|
|
||||||
- **ИКОНКА**: `Plus` размером `h-3 w-3` слева от текста
|
|
||||||
- **ТЕКСТ**: "Создать" на мобильных, "Создать поставку" на десктопах
|
|
||||||
- **АДАПТИВНОСТЬ**: Скрытие текста на маленьких экранах (`hidden sm:inline`)
|
|
||||||
|
|
||||||
#### **9.3.5 Удаление старой кнопки**
|
|
||||||
|
|
||||||
- **УБРАТЬ**: Текущий dropdown "Создать поставку" из верхней части
|
|
||||||
- **ПРИЧИНА**: Заменяется контекстными кнопками в табах
|
|
||||||
- **СОХРАНИТЬ**: Стили и логику навигации, но адаптировать под новые роуты
|
|
||||||
|
|
||||||
### 9.4 Структура страницы "Мои поставки" - Трёхблочная архитектура
|
|
||||||
|
|
||||||
#### **9.4.1 Обязательная структура страницы**
|
|
||||||
|
|
||||||
**ПРИНЦИП**: Страница состоит из трёх визуально разделённых блоков
|
|
||||||
|
|
||||||
```
|
|
||||||
┌─────────────────────────────────────────┐
|
|
||||||
│ 1. БЛОК ТАБОВ (навигация) │
|
|
||||||
│ - Фиксированная высота │
|
|
||||||
│ - Glass-эффект │
|
|
||||||
│ - Иерархическая структура │
|
|
||||||
├─────────────────────────────────────────┤
|
|
||||||
│ 2. БЛОК СТАТИСТИКИ (метрики) │
|
|
||||||
│ - Контекстные данные │
|
|
||||||
│ - 4 карточки в ряд (desktop) │
|
|
||||||
│ - Динамическое обновление │
|
|
||||||
├─────────────────────────────────────────┤
|
|
||||||
│ 3. ОСНОВНОЙ БЛОК (контент) │
|
|
||||||
│ - Сохраняет весь функционал │
|
|
||||||
│ - Таблицы, фильтры, действия │
|
|
||||||
│ - Высота до низа sidebar │
|
|
||||||
└─────────────────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **9.4.2 Блок статистики - контекстные метрики**
|
|
||||||
|
|
||||||
**ПРАВИЛО**: Статистика меняется в зависимости от выбранных табов
|
|
||||||
|
|
||||||
**Для путей "Фулфилмент → Товар → Карточки/Поставщики":**
|
|
||||||
- Всего поставок
|
|
||||||
- Активных поставок
|
|
||||||
- Сумма активных поставок
|
|
||||||
- В пути
|
|
||||||
|
|
||||||
**Для пути "Фулфилмент → Расходники селлера":**
|
|
||||||
- Всего поставок
|
|
||||||
- Активных поставок
|
|
||||||
- Видов расходников
|
|
||||||
- Критические остатки
|
|
||||||
|
|
||||||
**Для путей "Маркетплейсы → Wildberries/Ozon":**
|
|
||||||
- Поставок на маркетплейс
|
|
||||||
- Товаров отправлено
|
|
||||||
- Возвраты за неделю
|
|
||||||
- Эффективность поставок
|
|
||||||
|
|
||||||
#### **9.4.3 Высота основного блока**
|
|
||||||
|
|
||||||
**ФОРМУЛА РАСЧЕТА**:
|
|
||||||
```css
|
|
||||||
height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
|
|
||||||
```
|
|
||||||
|
|
||||||
**ПРАВИЛО ВЫРАВНИВАНИЯ**:
|
|
||||||
- Нижняя граница основного блока должна быть на одном уровне с нижней границей sidebar
|
|
||||||
- При изменении размера окна высота пересчитывается
|
|
||||||
- Внутренний скролл: `overflow-y-auto`
|
|
||||||
|
|
||||||
#### **9.4.4 Сохранение функционала**
|
|
||||||
|
|
||||||
**КРИТИЧЕСКИ ВАЖНО**: При добавлении блока статистики весь существующий функционал сохраняется:
|
|
||||||
- Таблицы с данными поставок
|
|
||||||
- Фильтры и сортировка
|
|
||||||
- Кнопки действий
|
|
||||||
- Детализация при клике
|
|
||||||
- Пагинация
|
|
||||||
- Поиск
|
|
||||||
|
|
||||||
**ЗАПРЕЩЕНО**:
|
|
||||||
- Удалять существующие компоненты
|
|
||||||
- Изменять логику работы таблиц
|
|
||||||
- Нарушать существующие API вызовы
|
|
||||||
|
|
||||||
#### **9.4.5 Проверка остатков при создании поставки**
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНАЯ ВАЛИДАЦИЯ**:
|
|
||||||
|
|
||||||
1. **Проверка на клиенте**:
|
|
||||||
```typescript
|
|
||||||
// При изменении количества
|
|
||||||
if (quantity > product.stock) {
|
|
||||||
toast.error(`Недостаточно товара. Доступно: ${product.stock}`);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
2. **Проверка на сервере**:
|
|
||||||
```typescript
|
|
||||||
// Перед созданием заказа
|
|
||||||
const stockAvailable = await checkStockAvailability(productId, quantity);
|
|
||||||
if (!stockAvailable) {
|
|
||||||
throw new Error("Insufficient stock");
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
3. **Логирование проверок**:
|
|
||||||
- Все попытки добавления в корзину
|
|
||||||
- Результаты проверки остатков
|
|
||||||
- ID пользователя и timestamp
|
|
||||||
|
|
||||||
#### **9.4.6 Адаптивность блоков**
|
|
||||||
|
|
||||||
**Desktop (>1024px)**:
|
|
||||||
- Все три блока вертикально
|
|
||||||
- Статистика: 4 карточки в ряд
|
|
||||||
|
|
||||||
**Tablet (768-1024px)**:
|
|
||||||
- Все три блока вертикально
|
|
||||||
- Статистика: 2 карточки в ряд
|
|
||||||
|
|
||||||
**Mobile (<768px)**:
|
|
||||||
- Блоки в колонку
|
|
||||||
- Статистика: 1 карточка в ряд
|
|
||||||
- Сворачиваемая статистика
|
|
||||||
|
|
||||||
### 9.5 Табы "Карточки" и "Поставщики" - объединённая логика
|
|
||||||
|
|
||||||
#### **9.5.1 Принцип единого типа предмета**
|
|
||||||
|
|
||||||
**КЛЮЧЕВОЕ ПРАВИЛО**: Табы "Карточки" и "Поставщики" - это два способа создания поставок одного типа предмета (ТОВАР)
|
|
||||||
|
|
||||||
**СПОСОБЫ СОЗДАНИЯ**:
|
|
||||||
- **Карточки** - импорт товаров через WB API с автоматическим созданием поставки
|
|
||||||
- **Поставщики** - прямой заказ товаров у поставщика с указанием рецептуры
|
|
||||||
|
|
||||||
**РЕЗУЛЬТАТ**: Оба способа создают `SupplyOrder` с товарами типа `PRODUCT`
|
|
||||||
|
|
||||||
#### **9.5.2 Общая статистика**
|
|
||||||
|
|
||||||
**ПРАВИЛО**: Блок статистики показывает ОДИНАКОВЫЕ данные для обоих табов
|
|
||||||
|
|
||||||
**МЕТРИКИ ДЛЯ ТАБОВ "КАРТОЧКИ" И "ПОСТАВЩИКИ"**:
|
|
||||||
- Всего поставок товаров (из всех источников)
|
|
||||||
- Активных поставок товаров (в работе)
|
|
||||||
- Сумма активных поставок товаров
|
|
||||||
- Товаров в пути (все способы доставки)
|
|
||||||
|
|
||||||
**ЗАПРЕЩЕНО**: Разделять статистику по способу создания
|
|
||||||
|
|
||||||
#### **9.5.3 Общий основной блок**
|
|
||||||
|
|
||||||
**СОДЕРЖИМОЕ**: Единая таблица всех поставок товаров
|
|
||||||
|
|
||||||
**ИСТОЧНИКИ ДАННЫХ**:
|
|
||||||
- Поставки, созданные через импорт карточек WB
|
|
||||||
- Поставки, созданные через заказ у поставщиков
|
|
||||||
- Все промежуточные и завершённые поставки
|
|
||||||
|
|
||||||
**РАЗЛИЧИЯ ТАБОВ**:
|
|
||||||
- Только кнопки создания ведут на разные страницы
|
|
||||||
- Таб "Карточки": `/supplies/create-cards`
|
|
||||||
- Таб "Поставщики": `/supplies/create-suppliers`
|
|
||||||
|
|
||||||
#### **9.5.4 Структура таблицы поставок товаров**
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНЫЕ КОЛОНКИ**:
|
|
||||||
- Номер поставки
|
|
||||||
- Способ создания (иконка: 📱 карточки / 🏢 поставщик)
|
|
||||||
- Количество товаров
|
|
||||||
- Общая стоимость
|
|
||||||
- Поставщик/Источник
|
|
||||||
- Дата поставки (планируемая дата доставки)
|
|
||||||
- Статус
|
|
||||||
- Дата создания
|
|
||||||
- Действия
|
|
||||||
|
|
||||||
**ФИЛЬТРЫ**:
|
|
||||||
- По статусу workflow
|
|
||||||
- По способу создания
|
|
||||||
- По поставщику
|
|
||||||
- По периоду
|
|
||||||
- По дате поставки
|
|
||||||
- По сумме заказа
|
|
||||||
|
|
||||||
#### **9.5.5 Детализация поставки**
|
|
||||||
|
|
||||||
**ПРИ КЛИКЕ НА ПОСТАВКУ**:
|
|
||||||
- Раскрывается детализация товаров в поставке
|
|
||||||
- Информация о рецептуре (если применимо)
|
|
||||||
- История изменения статусов
|
|
||||||
- Логистическая информация
|
|
||||||
- Связанные документы
|
|
||||||
|
|
||||||
**ДЕЙСТВИЯ В ДЕТАЛИЗАЦИИ**:
|
|
||||||
- Отслеживание статуса
|
|
||||||
- Связь с поставщиком/логистикой
|
|
||||||
- Отмена (если статус позволяет)
|
|
||||||
- Экспорт данных
|
|
||||||
|
|
||||||
#### **9.5.6 Принципы реализации**
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНО**:
|
|
||||||
- Использовать единый компонент для отображения таблицы
|
|
||||||
- Агрегировать данные из всех источников в статистике
|
|
||||||
- Сохранять фильтрацию при переключении между табами
|
|
||||||
|
|
||||||
**ЗАПРЕЩЕНО**:
|
|
||||||
- Создавать отдельные таблицы для разных способов создания
|
|
||||||
- Разделять статистику по источникам
|
|
||||||
- Дублировать логику отображения поставок
|
|
||||||
|
|
||||||
### 9.7 Форма создания поставки товаров через поставщиков
|
|
||||||
|
|
||||||
#### **9.7.1 Маршрут и навигация**
|
|
||||||
**URL**: `/supplies/create-suppliers`
|
|
||||||
**Доступ**: Только для селлеров и администраторов
|
|
||||||
**Возврат**: Кнопка "Назад" ведет к табу "Поставщики" в разделе товаров
|
|
||||||
|
|
||||||
#### **9.7.2 Структура страницы - 3 блока (аналогично create-consumables)**
|
|
||||||
|
|
||||||
**БЛОК 1: ЗАГОЛОВОК И НАВИГАЦИЯ**
|
|
||||||
- Заголовок: "Создание поставки товаров через поставщиков"
|
|
||||||
- Подзаголовок: "Прямой заказ товаров у поставщика с указанием рецептуры"
|
|
||||||
- Кнопка "Назад" (возврат к табу "Поставщики")
|
|
||||||
- Индикатор прогресса: "Шаг 1 из 3" (Товары → Логистика → Подтверждение)
|
|
||||||
|
|
||||||
**БЛОК 2: ФОРМА ТОВАРОВ**
|
|
||||||
- **Выбор поставщика**: Работает как на create-consumables (выбор из существующих)
|
|
||||||
- **Каталог товаров поставщика**: Отображение доступных товаров выбранного поставщика
|
|
||||||
- **Корзина товаров**: Система добавления товаров в корзину как на create-consumables
|
|
||||||
- **Поля товара при добавлении в корзину**:
|
|
||||||
- Название товара (из каталога поставщика)
|
|
||||||
- Артикул поставщика (из каталога)
|
|
||||||
- Категория (из каталога)
|
|
||||||
- Количество (вводит пользователь, > 0)
|
|
||||||
- Цена за единицу (из каталога или договорная)
|
|
||||||
- Комплектность (если есть) - описание состава комплекта
|
|
||||||
- Рецептура/состав (текстовое поле для дополнений)
|
|
||||||
- Параметры товара (цвет, размер, материал - если применимо)
|
|
||||||
|
|
||||||
**БЛОК 3: КОРЗИНА И ИТОГИ**
|
|
||||||
- Таблица товаров в корзине
|
|
||||||
- **Желаемая дата поставки** (обязательное поле с календарем)
|
|
||||||
- **Выбор логистики**:
|
|
||||||
- Dropdown "Логистическая компания" (опционально)
|
|
||||||
- Если не выбрано: "Логистику выберет фulfilment"
|
|
||||||
- Ориентировочная стоимость логистики (расчетная)
|
|
||||||
- Общее количество товаров в корзине
|
|
||||||
- Общая стоимость товаров
|
|
||||||
- Ориентировочная стоимость фулфилмента (расчетная)
|
|
||||||
- **Итого к оплате** (сумма всех составляющих)
|
|
||||||
- Кнопка "Продолжить" (переход к подтверждению заказа)
|
|
||||||
|
|
||||||
#### **9.7.3 Принцип работы с поставщиками-партнерами**
|
|
||||||
|
|
||||||
**ИСТОЧНИК ПОСТАВЩИКОВ**:
|
|
||||||
- Показываются только поставщики-партнеры из таблицы `Counterparty`
|
|
||||||
- Фильтрация: `counterparty.type === "WHOLESALE"`
|
|
||||||
- Партнерство может быть создано двумя способами:
|
|
||||||
1. Через заказ в маркете → автоматическое партнерство после одобрения
|
|
||||||
2. Через раздел "Партнеры" → отправка и принятие заявки `CounterpartyRequest`
|
|
||||||
|
|
||||||
**ВЫБОР ПОСТАВЩИКА**:
|
|
||||||
- Dropdown с поиском партнеров-поставщиков
|
|
||||||
- Отображение: Название поставщика, ИНН, статус партнерства
|
|
||||||
- Только активные партнеры с типом WHOLESALE
|
|
||||||
- При выборе загружается каталог товаров поставщика из `Product` таблицы
|
|
||||||
|
|
||||||
**КАТАЛОГ ТОВАРОВ ПАРТНЕРА**:
|
|
||||||
- Товары из `Product` where `organizationId = поставщик.id`
|
|
||||||
- Отображение в виде карточек с полями:
|
|
||||||
- Картинка товара
|
|
||||||
- Название, артикул
|
|
||||||
- Цена за единицу
|
|
||||||
- Доступное количество
|
|
||||||
- Поле ввода количества (минимум 5 цифр) с кнопками +/-
|
|
||||||
- Фильтрация по категориям
|
|
||||||
- Поиск по названию/артикулу
|
|
||||||
|
|
||||||
#### **9.7.4 Принцип работы с товарами и корзиной (как на create-consumables)**
|
|
||||||
|
|
||||||
**ДОБАВЛЕНИЕ В КОРЗИНУ**:
|
|
||||||
- Клик по товару → модальное окно с деталями
|
|
||||||
- Указание количества, комплектности, дополнительных параметров
|
|
||||||
- Кнопка "Добавить в корзину"
|
|
||||||
|
|
||||||
**КОРЗИНА**:
|
|
||||||
- Отображение добавленных товаров в таблице
|
|
||||||
- Колонки: Товар, Артикул, Количество, Цена, Комплектность, Сумма
|
|
||||||
- Возможность изменения количества
|
|
||||||
- Кнопка удаления товара из корзины
|
|
||||||
- Автоматический пересчет итогов
|
|
||||||
|
|
||||||
#### **9.7.5 Поля формы товара**
|
|
||||||
|
|
||||||
**ОСНОВНЫЕ ПОЛЯ** (из каталога поставщика):
|
|
||||||
- Название товара
|
|
||||||
- Артикул поставщика
|
|
||||||
- Категория
|
|
||||||
- Базовая цена
|
|
||||||
|
|
||||||
**ПОЛЯ ДЛЯ ЗАПОЛНЕНИЯ**:
|
|
||||||
- Количество (целое число > 0)
|
|
||||||
- Комплектность (если есть) - текстовое описание состава
|
|
||||||
- Цена за единицу (может отличаться от базовой по договоренности)
|
|
||||||
- Описание/рецептура (дополнительные требования)
|
|
||||||
- Особые требования к товару
|
|
||||||
|
|
||||||
**ПАРАМЕТРЫ ТОВАРА** (если применимо):
|
|
||||||
- Цвет, Размер, Материал, Бренд
|
|
||||||
- Динамические параметры для конкретной категории
|
|
||||||
|
|
||||||
#### **9.7.6 Валидация и проверки**
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНАЯ ВАЛИДАЦИЯ**:
|
|
||||||
- Выбран поставщик
|
|
||||||
- В корзине минимум 1 товар
|
|
||||||
- Указана желаемая дата поставки
|
|
||||||
- У всех товаров указано количество > 0
|
|
||||||
- Все товары проверены на наличие у поставщика
|
|
||||||
- Количество каждого товара ≤ доступному остатку
|
|
||||||
|
|
||||||
**ПРЕДУПРЕЖДЕНИЯ**:
|
|
||||||
- "Товар заканчивается на складе поставщика (осталось X шт)"
|
|
||||||
- "Товар недоступен, выберите другое количество"
|
|
||||||
- "Выбранная дата может не соответствовать возможностям логистики"
|
|
||||||
- "Габариты не указаны - стоимость логистики ориентировочная"
|
|
||||||
- Превышение лимитов заказа
|
|
||||||
- Значительное отклонение цены от каталожной
|
|
||||||
|
|
||||||
**АВТОМАТИЧЕСКИЕ РАСЧЕТЫ**:
|
|
||||||
- Стоимость по каждому товару = количество × цена
|
|
||||||
- Общая стоимость товаров в корзине
|
|
||||||
- Комиссии фулфилмента (% от стоимости)
|
|
||||||
- Логистика (по весу/габаритам или фиксированная ставка)
|
|
||||||
|
|
||||||
#### **9.7.7 Выбор логистики**
|
|
||||||
|
|
||||||
**ОПЦИИ ЛОГИСТИКИ**:
|
|
||||||
- "Автоматический выбор" (фулфилмент выберет оптимальную)
|
|
||||||
- Список доступных логистических компаний
|
|
||||||
- Отображение ориентировочной стоимости по каждой опции
|
|
||||||
- Сроки доставки по каждой опции
|
|
||||||
|
|
||||||
**ЛОГИКА ВЫБОРА**:
|
|
||||||
- Если селлер не выбрал → фулфилмент выбирает оптимальную
|
|
||||||
- Если селлер выбрал → используется выбранная компания
|
|
||||||
- Финальная стоимость может отличаться от ориентировочной
|
|
||||||
|
|
||||||
#### **9.7.8 Желаемая дата поставки**
|
|
||||||
|
|
||||||
**РАСПОЛОЖЕНИЕ**: В блоке корзины и итогов
|
|
||||||
|
|
||||||
**ПОЛЕ "ЖЕЛАЕМАЯ ДАТА ПОСТАВКИ"**:
|
|
||||||
- **Обязательное поле** для планирования
|
|
||||||
- **Календарь** с ограничениями:
|
|
||||||
- Минимум: завтра (нельзя выбрать прошедшие даты)
|
|
||||||
- Максимум: +90 дней от текущей даты
|
|
||||||
- **Проверка на рабочие дни** (опционально)
|
|
||||||
- **Подсказки** по срокам доставки от выбранной логистической компании
|
|
||||||
|
|
||||||
**ЛОГИКА РАБОТЫ С ДАТОЙ**:
|
|
||||||
- При выборе логистики → автоматическое обновление возможных дат
|
|
||||||
- При изменении даты → пересчет стоимости логистики (если зависит от срочности)
|
|
||||||
- Отображение: "Ориентировочная дата доставки: 15-17 января 2024"
|
|
||||||
|
|
||||||
#### **9.7.9 Ограничения и проверки товаров**
|
|
||||||
|
|
||||||
**КОЛИЧЕСТВЕННЫЕ ОГРАНИЧЕНИЯ**:
|
|
||||||
- **НЕТ ограничений** на максимальное количество товаров в поставке
|
|
||||||
- **ОБЯЗАТЕЛЬНАЯ проверка** доступности на складах поставщиков
|
|
||||||
- **В реальном времени** проверка остатков при добавлении в корзину
|
|
||||||
- **Предупреждения** если запрашиваемое количество превышает доступное
|
|
||||||
- **Блокировка** добавления товара если его нет в наличии у поставщика
|
|
||||||
|
|
||||||
**ЛОГИКА ПРОВЕРКИ ОСТАТКОВ**:
|
|
||||||
- При добавлении товара в корзину → запрос к API поставщика
|
|
||||||
- При изменении количества → повторная проверка
|
|
||||||
- Отображение доступного количества рядом с полем ввода
|
|
||||||
- Сообщение: "Доступно: 150 шт" или "Нет в наличии"
|
|
||||||
|
|
||||||
#### **9.7.10 Габариты и логистические данные**
|
|
||||||
|
|
||||||
**НА ЭТАПЕ СОЗДАНИЯ ПОСТАВКИ**:
|
|
||||||
- **НЕТ обязательных** полей для габаритов/веса
|
|
||||||
- **Ориентировочный расчет** логистики по средним показателям категории
|
|
||||||
- **Предупреждение** что финальная стоимость может отличаться
|
|
||||||
|
|
||||||
**В КАБИНЕТЕ ПОСТАВЩИКА** (при одобрении поставки):
|
|
||||||
- **Возможность ввести** точные логистические данные:
|
|
||||||
- Габариты каждого товара (Д×Ш×В в см)
|
|
||||||
- Объем упаковки (в куб.м)
|
|
||||||
- Количество мест/коробок
|
|
||||||
- Общий вес поставки
|
|
||||||
- **НЕ обязательные** для заполнения (можно оставить пустыми)
|
|
||||||
- **Уточнение стоимости** логистики после заполнения данных
|
|
||||||
|
|
||||||
#### **9.7.11 Навигация и сохранение**
|
|
||||||
|
|
||||||
**УПРАВЛЕНИЕ СЕССИЕЙ**:
|
|
||||||
- Автосохранение корзины каждые 30 секунд
|
|
||||||
- Сохранение состояния при смене поставщика
|
|
||||||
- Предупреждение при попытке покинуть страницу
|
|
||||||
|
|
||||||
**ПЕРЕХОДЫ**:
|
|
||||||
- "Назад" → возврат к табу "Поставщики" (с предупреждением о потере данных)
|
|
||||||
- "Очистить корзину" → очистка всех товаров с подтверждением
|
|
||||||
- "Продолжить" → переход к подтверждению и оформлению заказа
|
|
||||||
|
|
||||||
#### **9.7.12 Интеграция с системой**
|
|
||||||
|
|
||||||
**СВЯЗЬ С ДАННЫМИ**:
|
|
||||||
- Работа с каталогом товаров поставщиков
|
|
||||||
- Проверка остатков в реальном времени
|
|
||||||
- Создание черновика `SupplyOrder` типа `ТОВАР` способом `suppliers`
|
|
||||||
|
|
||||||
**ОСОБЕННОСТИ**:
|
|
||||||
- Отличие от "Карточки": здесь товары выбираются из каталога поставщика
|
|
||||||
- Отличие от "Расходники": здесь товары предназначены для перепродажи
|
|
||||||
- Возможность указания комплектности для наборов товаров
|
|
||||||
|
|
||||||
### 9.8 Экономика
|
|
||||||
|
|
||||||
_Раздел находится в разработке. Будет добавлен позже._
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 10. 🏪 КАБИНЕТ ПОСТАВЩИКА
|
|
||||||
|
|
||||||
### 10.1 Основные возможности
|
|
||||||
|
|
||||||
**СОЗДАНИЕ КАРТОЧЕК**:
|
|
||||||
|
|
||||||
- **ТОВАР** - базовые товары поставщика
|
|
||||||
- **РАСХОДНИКИ** - материалы и вспомогательные товары
|
|
||||||
|
|
||||||
### 10.2 Обязательные поля карточки
|
|
||||||
|
|
||||||
**Базовые параметры**:
|
|
||||||
|
|
||||||
- Фото (система загрузки и управления изображениями)
|
|
||||||
- Название
|
|
||||||
- Автоматическая генерация артикула СФ
|
|
||||||
- Описание
|
|
||||||
- Количество предметов в единицах
|
|
||||||
- Количество комплектов (если применимо)
|
|
||||||
- Категория (28 предустановленных + специализированные для расходников)
|
|
||||||
- Бренд, Цвет, Размер/объем, Вес, Габариты, Материал
|
|
||||||
- Цена за единицу и за комплект
|
|
||||||
- Заказано, В пути, Остаток, Продано
|
|
||||||
|
|
||||||
### 10.3 Отображение информации в карточках
|
|
||||||
|
|
||||||
**Каждая карточка содержит**:
|
|
||||||
|
|
||||||
- Основное изображение
|
|
||||||
- Название и артикул СФ
|
|
||||||
- Цена за единицу/комплект
|
|
||||||
- Категория и статус активности
|
|
||||||
- Данные о движении: остаток, заказано, в пути, продано
|
|
||||||
- Индикаторы низких остатков
|
|
||||||
|
|
||||||
### 10.4 Статистика поставщика
|
|
||||||
|
|
||||||
**Блок статистики включает**:
|
|
||||||
|
|
||||||
- **ТОВАРЫ**: Общая статистика товаров поставщика
|
|
||||||
- **РАСХОДНИКИ**: Материалы и вспомогательные товары
|
|
||||||
- Классифицируются при заказе в зависимости от заказчика
|
|
||||||
- Общая статистика по всем расходникам
|
|
||||||
|
|
||||||
### 10.5 Экономика
|
|
||||||
|
|
||||||
_Раздел находится в разработке. Будет добавлен позже._
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 11. 🏭 КАБИНЕТ ФУЛФИЛМЕНТА
|
|
||||||
|
|
||||||
### 11.1 Структура раздела склад фулфилмента
|
|
||||||
|
|
||||||
#### **Модули в обязательной последовательности**:
|
|
||||||
|
|
||||||
1. **📦 ПРОДУКТ** - готовые к продаже товары
|
|
||||||
2. **🛒 ТОВАР** - базовые товары от поставщиков
|
|
||||||
- Товары "на складе" - готовы к обработке
|
|
||||||
- Товары "в обработке" - в процессе создания продукта
|
|
||||||
3. **❌ БРАК** - товары с дефектами
|
|
||||||
4. **↩️ ВОЗВРАТЫ С ПВЗ** - возвращенные товары
|
|
||||||
5. **🎯 РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для селлеров
|
|
||||||
6. **⚙️ РАСХОДНИКИ ФУЛФИЛМЕНТ** - операционные материалы
|
|
||||||
- **КЛИКАБЕЛЬНЫЙ МОДУЛЬ** - содержит полноценный раздел учёта
|
|
||||||
|
|
||||||
### 11.2 Движение товаров в фулфилменте
|
|
||||||
|
|
||||||
#### **Поступление товаров**:
|
|
||||||
|
|
||||||
- **ПОСТАВКИ**: От поставщиков через систему заказов
|
|
||||||
- **ВОЗВРАТЫ**: Товары, возвращенные с ПВЗ
|
|
||||||
- **ПЕРЕМЕЩЕНИЯ**: Между складами и магазинами
|
|
||||||
|
|
||||||
#### **Расход товаров**:
|
|
||||||
|
|
||||||
- **ОТГРУЗКА**: Товары отправлены селлерам
|
|
||||||
- **СПИСАНИЕ**: Брак, утрата, утилизация
|
|
||||||
- **ВОЗВРАТ**: Возврат поставщику
|
|
||||||
- **ИСПОЛЬЗОВАНИЕ**: Расходники для операций
|
|
||||||
|
|
||||||
### 11.3 Модуль "Расходники фулфилмента"
|
|
||||||
|
|
||||||
**ОСОБЕННОСТИ**:
|
|
||||||
|
|
||||||
- **ИНТЕРАКТИВНОСТЬ**: Кликабельный элемент в статистике
|
|
||||||
- **ФУНКЦИОНАЛЬНОСТЬ**: Полноценный раздел учёта
|
|
||||||
- **СОДЕРЖАНИЕ**: Управление расходниками фулфилмента
|
|
||||||
|
|
||||||
### 11.4 Блок детализации по магазинам
|
|
||||||
|
|
||||||
**НАЗНАЧЕНИЕ**: Распределение товаров по торговым точкам/магазинам
|
|
||||||
|
|
||||||
**ФУНКЦИИ**:
|
|
||||||
|
|
||||||
- **ОСТАТКИ ПО МАГАЗИНАМ**: Отображение количества товаров в каждом магазине
|
|
||||||
- **УПРАВЛЕНИЕ РАСПРЕДЕЛЕНИЕМ**: Перемещение товаров между точками
|
|
||||||
- **КОНТРОЛЬ ДВИЖЕНИЯ**: Отслеживание перемещений между складами и магазинами
|
|
||||||
- **АНАЛИТИКА**: Сравнение эффективности разных точек
|
|
||||||
- **ПЛАНИРОВАНИЕ**: Оптимизация распределения товаров
|
|
||||||
|
|
||||||
### 11.5 Экономика
|
|
||||||
|
|
||||||
_Раздел находится в разработке. Будет добавлен позже._
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 12. 🚚 КАБИНЕТ ЛОГИСТИКИ
|
|
||||||
|
|
||||||
### 12.1 Основные функции логистики
|
|
||||||
|
|
||||||
**РОЛЬ В СИСТЕМЕ**: Управление доставками и транспортировкой
|
|
||||||
|
|
||||||
**ОСНОВНЫЕ ФУНКЦИИ**:
|
|
||||||
|
|
||||||
- **ПОДТВЕРЖДЕНИЕ ДОСТАВКИ**: Подтверждение возможности доставки поставок
|
|
||||||
- **ТРАНСПОРТИРОВКА**: Организация и выполнение доставки товаров
|
|
||||||
- **КОНТРОЛЬ МАРШРУТОВ**: Управление логистическими маршрутами
|
|
||||||
- **ОТСЛЕЖИВАНИЕ**: Мониторинг грузов в пути
|
|
||||||
|
|
||||||
### 12.2 Workflow для логистики
|
|
||||||
|
|
||||||
#### **ЭТАП 1: Получение заявки**
|
|
||||||
|
|
||||||
1. Логистика получает уведомление о новой поставке
|
|
||||||
2. Заявка появляется в разделе "Заявки" кабинета логистики
|
|
||||||
3. Логист изучает детали поставки (объем, вес, маршрут)
|
|
||||||
|
|
||||||
#### **ЭТАП 2: Подтверждение доставки**
|
|
||||||
|
|
||||||
4. Логист нажимает кнопку "Одобрить"
|
|
||||||
5. Статус поставки меняется на `LOGISTICS_CONFIRMED`
|
|
||||||
6. Уведомления отправляются всем участникам
|
|
||||||
|
|
||||||
#### **ЭТАП 3: Забор товара**
|
|
||||||
|
|
||||||
7. Логист приезжает к поставщику за товаром
|
|
||||||
8. Поставщик отгружает товар логисту
|
|
||||||
9. Поставщик отмечает "Отправлено"
|
|
||||||
10. Статус меняется на `SHIPPED`, затем `IN_TRANSIT`
|
|
||||||
|
|
||||||
#### **ЭТАП 4: Доставка**
|
|
||||||
|
|
||||||
11. Логистика доставляет товар на фулфилмент-центр
|
|
||||||
12. В кабинете логистики нажимают "Доставлено"
|
|
||||||
13. Фулфилмент принимает товар и отмечает "Принято"
|
|
||||||
|
|
||||||
### 12.3 Система тарификации
|
|
||||||
|
|
||||||
**ПАРАМЕТРЫ ТАРИФИКАЦИИ**:
|
|
||||||
|
|
||||||
- **Тариф до 1м³** - базовая стоимость для малых грузов
|
|
||||||
- **Тариф свыше 1м³** - стоимость для крупных грузов
|
|
||||||
- **Маршруты доставки** - от точки отправления до точки назначения
|
|
||||||
- **Описание услуг** - дополнительные условия доставки
|
|
||||||
|
|
||||||
**РАСЧЕТ СТОИМОСТИ**:
|
|
||||||
|
|
||||||
- Автоматический расчет стоимости доставки по объему груза
|
|
||||||
- Отображение примерной стоимости при создании заказа
|
|
||||||
- Учет специфики маршрута и условий доставки
|
|
||||||
|
|
||||||
### 12.4 Управление заявками
|
|
||||||
|
|
||||||
**РАЗДЕЛЫ КАБИНЕТА ЛОГИСТИКИ**:
|
|
||||||
|
|
||||||
- **НОВЫЕ ЗАЯВКИ** - поступившие заявки на доставку
|
|
||||||
- **В РАБОТЕ** - принятые к исполнению заявки
|
|
||||||
- **ВЫПОЛНЕННЫЕ** - завершенные доставки
|
|
||||||
- **ОТКЛОНЕННЫЕ** - заявки, которые не могут быть выполнены
|
|
||||||
|
|
||||||
**ИНФОРМАЦИЯ О ЗАЯВКЕ**:
|
|
||||||
|
|
||||||
- Детали груза (объем, вес, габариты)
|
|
||||||
- Маршрут доставки (откуда - куда)
|
|
||||||
- Срочность доставки
|
|
||||||
- Особые требования к транспортировке
|
|
||||||
- Контактная информация участников
|
|
||||||
|
|
||||||
### 12.5 Правила логистики
|
|
||||||
|
|
||||||
**ОБЯЗАТЕЛЬНО**:
|
|
||||||
|
|
||||||
- Своевременное подтверждение заявок
|
|
||||||
- Соблюдение сроков доставки
|
|
||||||
- Бережная транспортировка товаров
|
|
||||||
- Уведомление о статусе доставки
|
|
||||||
|
|
||||||
**ЗАПРЕЩЕНО**:
|
|
||||||
|
|
||||||
- Принятие заявок без подтверждения возможности выполнения
|
|
||||||
- Нарушение сроков доставки без уведомления
|
|
||||||
- Повреждение товаров при транспортировке
|
|
||||||
|
|
||||||
### 12.6 Экономика
|
|
||||||
|
|
||||||
_Раздел находится в разработке. Будет добавлен позже._
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 13. 🤝 СИСТЕМА ПАРТНЕРСТВА И КОНТРАГЕНТОВ
|
|
||||||
|
|
||||||
### 13.1 Основы системы партнерства
|
|
||||||
|
|
||||||
**ПРИНЦИП РАБОТЫ**:
|
|
||||||
- Все типы кабинетов могут создавать партнерские отношения
|
|
||||||
- Партнерство реализовано через таблицы `Counterparty` и `CounterpartyRequest`
|
|
||||||
- Двустороннее партнерство: каждая организация видит другую в разделе "Партнеры"
|
|
||||||
|
|
||||||
**ТИПЫ ОРГАНИЗАЦИЙ-ПАРТНЕРОВ**:
|
|
||||||
- `WHOLESALE` - Поставщики товаров и расходников
|
|
||||||
- `FULFILLMENT` - Фулфилмент-центры
|
|
||||||
- `LOGIST` - Логистические компании
|
|
||||||
- `SELLER` - Селлеры (торговые организации)
|
|
||||||
|
|
||||||
### 13.2 Способы создания партнерства
|
|
||||||
|
|
||||||
#### **СПОСОБ 1: Через заказ в маркете (автоматическое партнерство)**
|
|
||||||
|
|
||||||
**WORKFLOW**:
|
|
||||||
1. Поставщик создает товар → товар попадает в глобальный маркет
|
|
||||||
2. Селлер/Фулфилмент находит товар в маркете
|
|
||||||
3. Создает заказ (`SupplyOrder`) → статус `PENDING`
|
|
||||||
4. Поставщик получает уведомление в разделе "Заявки"
|
|
||||||
5. Поставщик одобряет заявку → статус `SUPPLIER_APPROVED`
|
|
||||||
6. **Автоматически создается двустороннее партнерство**:
|
|
||||||
- Запись в `Counterparty` для заказчика (`organizationId` → `counterpartyId`)
|
|
||||||
- Обратная запись в `Counterparty` для поставщика
|
|
||||||
7. Обе организации видят друг друга в разделе "Партнеры"
|
|
||||||
|
|
||||||
#### **СПОСОБ 2: Через раздел "Партнеры" (заявочная система)**
|
|
||||||
|
|
||||||
**WORKFLOW**:
|
|
||||||
1. Любая организация идет в раздел "Партнеры"
|
|
||||||
2. Использует поиск для нахождения нужной организации
|
|
||||||
3. Отправляет заявку на партнерство → создается `CounterpartyRequest`:
|
|
||||||
- `senderId` - отправитель заявки
|
|
||||||
- `receiverId` - получатель заявки
|
|
||||||
- `status: PENDING`
|
|
||||||
- `message` - опциональное сообщение
|
|
||||||
4. Получатель видит заявку в разделе "Партнеры" → "Входящие заявки"
|
|
||||||
5. Получатель принимает заявку → статус меняется на `ACCEPTED`
|
|
||||||
6. **Автоматически создается двустороннее партнерство** (аналогично способу 1)
|
|
||||||
|
|
||||||
**СТАТУСЫ ЗАЯВОК**:
|
|
||||||
- `PENDING` - Ожидает рассмотрения
|
|
||||||
- `ACCEPTED` - Принята (партнерство создано)
|
|
||||||
- `REJECTED` - Отклонена
|
|
||||||
- `CANCELLED` - Отменена отправителем
|
|
||||||
|
|
||||||
### 13.3 Использование партнерства в системе
|
|
||||||
|
|
||||||
#### **В форме создания поставки товаров через поставщиков**
|
|
||||||
|
|
||||||
**ПРАВИЛО ОТОБРАЖЕНИЯ ПОСТАВЩИКОВ**:
|
|
||||||
- Показываются только партнеры с типом `WHOLESALE`
|
|
||||||
- Источник: таблица `Counterparty` where `counterparty.type === "WHOLESALE"`
|
|
||||||
- Фильтрация по `organizationId` текущего пользователя
|
|
||||||
|
|
||||||
**ЛОГИКА РАБОТЫ**:
|
|
||||||
1. Пользователь выбирает поставщика из dropdown партнеров-поставщиков
|
|
||||||
2. Загружается каталог товаров поставщика из `Product` таблицы
|
|
||||||
3. Товары фильтруются по `organizationId = поставщик.id`
|
|
||||||
4. Пользователь может добавлять товары в корзину и создавать заказ
|
|
||||||
|
|
||||||
#### **В других разделах системы**
|
|
||||||
|
|
||||||
**ВЫБОР ФУЛФИЛМЕНТ-ЦЕНТРА**:
|
|
||||||
- Партнеры с типом `FULFILLMENT`
|
|
||||||
- Используется при создании поставок расходников
|
|
||||||
|
|
||||||
**ВЫБОР ЛОГИСТИКИ**:
|
|
||||||
- Партнеры с типом `LOGIST`
|
|
||||||
- Используется при планировании доставок
|
|
||||||
|
|
||||||
**МЕССЕНДЖЕР**:
|
|
||||||
- Общение доступно только между партнерами
|
|
||||||
- Список чатов формируется из таблицы `Counterparty`
|
|
||||||
|
|
||||||
### 13.4 Технические правила
|
|
||||||
|
|
||||||
**СОЗДАНИЕ ЗАПИСЕЙ В COUNTERPARTY**:
|
|
||||||
```sql
|
|
||||||
-- При создании партнерства создаются ДВЕ записи
|
|
||||||
INSERT INTO counterparties (organizationId, counterpartyId) VALUES (org1_id, org2_id);
|
|
||||||
INSERT INTO counterparties (organizationId, counterpartyId) VALUES (org2_id, org1_id);
|
|
||||||
```
|
|
||||||
|
|
||||||
**ПРОВЕРКА ПАРТНЕРСТВА**:
|
|
||||||
```typescript
|
|
||||||
const isPartner = await prisma.counterparty.findFirst({
|
|
||||||
where: {
|
|
||||||
organizationId: currentOrgId,
|
|
||||||
counterpartyId: targetOrgId
|
|
||||||
}
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
**ПОЛУЧЕНИЕ ПАРТНЕРОВ ПО ТИПУ**:
|
|
||||||
```typescript
|
|
||||||
const wholesalePartners = await prisma.counterparty.findMany({
|
|
||||||
where: {
|
|
||||||
organizationId: currentOrgId,
|
|
||||||
counterparty: {
|
|
||||||
type: "WHOLESALE"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
include: {
|
|
||||||
counterparty: true
|
|
||||||
}
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
### 13.5 Решение распространенных проблем
|
|
||||||
|
|
||||||
#### **ПРОБЛЕМА: GraphQL запрос не возвращает данные партнеров**
|
|
||||||
|
|
||||||
**Симптомы**:
|
|
||||||
- В консоли браузера: `All counterparties: 0`, `All counterparties data: []`
|
|
||||||
- GraphQL запрос отправляется успешно, но возвращает пустой массив
|
|
||||||
- В базе данных партнеры существуют
|
|
||||||
|
|
||||||
**Возможные причины и решения**:
|
|
||||||
|
|
||||||
1. **НЕПРАВИЛЬНОЕ ИМЯ ПОЛЯ В КОДЕ** (наиболее частая ошибка):
|
|
||||||
```typescript
|
|
||||||
// ❌ НЕПРАВИЛЬНО
|
|
||||||
const allCounterparties = counterpartiesData?.getMyCounterparties || [];
|
|
||||||
|
|
||||||
// ✅ ПРАВИЛЬНО
|
|
||||||
const allCounterparties = counterpartiesData?.myCounterparties || [];
|
|
||||||
```
|
|
||||||
**Объяснение**: В GraphQL схеме поле называется `myCounterparties`, а не `getMyCounterparties`
|
|
||||||
|
|
||||||
2. **НЕСООТВЕТСТВИЕ ID ПОЛЬЗОВАТЕЛЯ**:
|
|
||||||
- Проверить что пользователь авторизован под правильным аккаунтом
|
|
||||||
- Убедиться что `context.user.id` соответствует ожидаемому пользователю
|
|
||||||
|
|
||||||
3. **ПРОБЛЕМЫ С КЕШИРОВАНИЕМ APOLLO CLIENT**:
|
|
||||||
```typescript
|
|
||||||
const { data, loading, error } = useQuery(GET_MY_COUNTERPARTIES, {
|
|
||||||
fetchPolicy: 'network-only', // Обходим кеш
|
|
||||||
errorPolicy: 'all'
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
4. **ОТСУТСТВИЕ ЛОГИРОВАНИЯ В РЕЗОЛВЕРЕ**:
|
|
||||||
- Добавить console.log в GraphQL резолвер для отладки
|
|
||||||
- Проверить что резолвер вызывается
|
|
||||||
|
|
||||||
**Чек-лист для диагностики**:
|
|
||||||
- [ ] Проверить правильность имени поля в коде (`myCounterparties`)
|
|
||||||
- [ ] Убедиться что пользователь авторизован
|
|
||||||
- [ ] Проверить логи сервера на вызов резолвера
|
|
||||||
- [ ] Добавить отладочное логирование в браузере
|
|
||||||
- [ ] Проверить данные в базе через Prisma Studio
|
|
||||||
- [ ] Использовать `fetchPolicy: 'network-only'` для обхода кеша
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 14. 🌐 ИНТЕГРАЦИИ С СИСТЕМОЙ
|
|
||||||
|
|
||||||
### 14.1 Глобальная интеграция
|
|
||||||
|
|
||||||
- **МАРКЕТ**: Товары поставщиков отображаются в глобальном маркете
|
|
||||||
- **СИНХРОНИЗАЦИЯ**: Данные склада синхронизируются с модулем аналитики
|
|
||||||
- **УВЕДОМЛЕНИЯ**: Единая система через встроенный мессенджер
|
|
||||||
|
|
||||||
### 13.2 Интеграция с маркетплейсами
|
|
||||||
|
|
||||||
- **WILDBERRIES**: Обязательная проверка активности API ключа
|
|
||||||
- **СИНХРОНИЗАЦИЯ**: Регулярное обновление данных из внешних источников
|
|
||||||
- **ЛОКАЛЬНЫЕ КОПИИ**: Сохранение данных для офлайн работы
|
|
||||||
|
|
||||||
### 13.3 Интеграция с модулем "Услуги"
|
|
||||||
|
|
||||||
**РАСХОДНИКИ ФУЛФИЛМЕНТА В УСЛУГАХ**:
|
|
||||||
|
|
||||||
- Расходники фулфилмента - собственность фулфилмента (куплены у поставщиков)
|
|
||||||
- Фулфилмент создает заявки-поставки для покупки расходников у поставщиков
|
|
||||||
- Селлеры могут использовать расходники фулфилмента в разделе "Услуги / Расходники"
|
|
||||||
- Для создания продукта из товара
|
|
||||||
- Расходники списываются с остатков фулфилмента
|
|
||||||
- Стоимость включается в стоимость услуги
|
|
||||||
|
|
||||||
**WORKFLOW ИСПОЛЬЗОВАНИЯ**:
|
|
||||||
|
|
||||||
1. Селлер выбирает услугу "Создание продукта"
|
|
||||||
2. Указывает базовый товар
|
|
||||||
3. Выбирает необходимые расходники фулфилмента
|
|
||||||
4. Фулфилмент обрабатывает заказ и создает продукт
|
|
||||||
5. Расходники списываются, создается готовый продукт
|
|
||||||
|
|
||||||
### 12.4 Система тарификации логистики
|
|
||||||
|
|
||||||
**ПАРАМЕТРЫ**:
|
|
||||||
|
|
||||||
- **Тариф до 1м³** - базовая стоимость для малых грузов
|
|
||||||
- **Тариф свыше 1м³** - стоимость для крупных грузов
|
|
||||||
- **Маршруты доставки** - от точки отправления до точки назначения
|
|
||||||
- **Описание услуг** - дополнительные условия доставки
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 14. 📊 СТАТИСТИКА И АНАЛИТИКА
|
|
||||||
|
|
||||||
### 14.1 Структура статистики по кабинетам
|
|
||||||
|
|
||||||
#### **В КАБИНЕТЕ ПОСТАВЩИКА**:
|
|
||||||
|
|
||||||
- **ТОВАРЫ**: Общая статистика товаров поставщика
|
|
||||||
- **РАСХОДНИКИ**: Материалы и вспомогательные товары (классифицируются при заказе)
|
|
||||||
|
|
||||||
#### **В КАБИНЕТЕ ФУЛФИЛМЕНТА**:
|
|
||||||
|
|
||||||
- **ТОВАРЫ**: Базовые товары от поставщиков (принятые на склад)
|
|
||||||
- **ПРОДУКТЫ**: Отдельный блок готовой продукции
|
|
||||||
- **БРАК**: Статистика потерь и списаний
|
|
||||||
- **РАСХОДНИКИ ФУЛФИЛМЕНТА**: Операционные материалы фулфилмента
|
|
||||||
- **РАСХОДНИКИ СЕЛЛЕРОВ**: Материалы для товаров селлеров
|
|
||||||
|
|
||||||
### 14.2 Ключевые метрики
|
|
||||||
|
|
||||||
**ОБЩИЕ ПОКАЗАТЕЛИ**:
|
|
||||||
|
|
||||||
- Общие остатки, заказано, в пути, остаток, продано
|
|
||||||
- Подсветка предметов с остатками ниже критического уровня
|
|
||||||
|
|
||||||
**АКТУАЛИЗАЦИЯ ДАННЫХ**:
|
|
||||||
|
|
||||||
- При изменении количества в карточке данные актуализируются во всей системе
|
|
||||||
- Статистика обновляется в реальном времени
|
|
||||||
- Отслеживание изменений для аналитики
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 15. ⚠️ КРИТИЧЕСКИЕ ЗАПРЕТЫ
|
|
||||||
|
|
||||||
### 15.1 НИКОГДА НЕ ДЕЛАТЬ:
|
|
||||||
|
|
||||||
1. ❌ Удалять предметы с существующими заказами
|
|
||||||
2. ❌ Изменять статусы заказов без уведомлений
|
|
||||||
3. ❌ Обходить проверки остатков предметов
|
|
||||||
4. ❌ Давать доступ к чужим данным
|
|
||||||
5. ❌ Игнорировать ошибки валидации
|
|
||||||
6. ❌ Сохранять пароли в открытом виде
|
|
||||||
7. ❌ Пропускать логирование критических операций
|
|
||||||
8. ❌ Блокировать интерфейс без индикации загрузки
|
|
||||||
9. ❌ Создавать брак или продукт без связи с родительским товаром
|
|
||||||
10. ❌ Создавать отдельные типы расходников (только общий тип "РАСХОДНИКИ")
|
|
||||||
11. ❌ Разрешать заказ брака
|
|
||||||
12. ❌ Нарушать иерархию типов предметов
|
|
||||||
13. ❌ Пропускать промежуточные статусы в workflow
|
|
||||||
14. ❌ Нарушать обязательную последовательность модулей в статистике фулфилмента
|
|
||||||
|
|
||||||
### 13.2 ОБЯЗАТЕЛЬНЫЕ ПРАВИЛА:
|
|
||||||
|
|
||||||
1. ✅ Проверка остатков перед добавлением в корзину
|
|
||||||
2. ✅ Валидация всех числовых значений (цена > 0, вес > 0)
|
|
||||||
3. ✅ Автоматическая генерация уникальных артикулов СФ
|
|
||||||
4. ✅ Логирование всех изменений статусов
|
|
||||||
5. ✅ Уведомления всех участников при изменении статусов
|
|
||||||
6. ✅ Обязательная типизация всех предметов
|
|
||||||
7. ✅ Связь производных типов с родительскими предметами
|
|
||||||
8. ✅ Проверка доступности товаров перед заказом
|
|
||||||
9. ✅ Соблюдение жизненного цикла статусов поставок
|
|
||||||
10. ✅ Фиксация план/факт в процессе создания продукта
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🎖️ ПРИОРИТЕТЫ РАЗРАБОТКИ
|
|
||||||
|
|
||||||
### ВЫСОКИЙ ПРИОРИТЕТ:
|
|
||||||
|
|
||||||
1. 🔴 Безопасность и контроль доступа
|
|
||||||
2. 🔴 Целостность данных и валидация
|
|
||||||
3. 🔴 Корректность статусов поставок
|
|
||||||
4. 🔴 Уведомления участников процесса
|
|
||||||
5. 🔴 Правильная типизация предметов
|
|
||||||
6. 🔴 Связи между товарами и производными типами
|
|
||||||
|
|
||||||
### СРЕДНИЙ ПРИОРИТЕТ:
|
|
||||||
|
|
||||||
1. 🟡 Производительность и оптимизация
|
|
||||||
2. 🟡 Пользовательский опыт
|
|
||||||
3. 🟡 Аналитика и отчетность
|
|
||||||
4. 🟡 Интеграции с внешними системами
|
|
||||||
5. 🟡 Workflow для брака и продуктов
|
|
||||||
6. 🟡 Разделение расходников по типам
|
|
||||||
|
|
||||||
### НИЗКИЙ ПРИОРИТЕТ:
|
|
||||||
|
|
||||||
1. 🟢 Дополнительные фильтры
|
|
||||||
2. 🟢 Косметические улучшения
|
|
||||||
3. 🟢 Экспериментальные функции
|
|
||||||
4. 🟢 Расширенная кастомизация
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📦 ПРИЛОЖЕНИЕ: КАТЕГОРИИ РАСХОДНИКОВ
|
|
||||||
|
|
||||||
### Специализированные категории для расходников:
|
|
||||||
|
|
||||||
#### 🎁 **УПАКОВКА И ЗАЩИТА**
|
|
||||||
|
|
||||||
- Коробки, пакеты, пузырчатая пленка, стрейч-пленка, защитные уголки
|
|
||||||
|
|
||||||
#### 🏷️ **МАРКИРОВКА И ИДЕНТИФИКАЦИЯ**
|
|
||||||
|
|
||||||
- Этикетки, бирки, стикеры, маркеры, штампы, термоэтикетки
|
|
||||||
|
|
||||||
#### 🔧 **КРЕПЕЖ И СОЕДИНЕНИЕ**
|
|
||||||
|
|
||||||
- Скотч, клей, стяжки, степлер, веревки, стрейч-лента
|
|
||||||
|
|
||||||
#### 📄 **ДОКУМЕНТООБОРОТ И ВКЛАДЫШИ**
|
|
||||||
|
|
||||||
- Накладные, инструкции, буклеты, визитки, промокоды
|
|
||||||
|
|
||||||
#### 🧼 **ГИГИЕНА И БЕЗОПАСНОСТЬ**
|
|
||||||
|
|
||||||
- Перчатки, маски, антисептики, салфетки, бахилы
|
|
||||||
|
|
||||||
#### 🛠️ **ИНСТРУМЕНТЫ И ПРИСПОСОБЛЕНИЯ**
|
|
||||||
|
|
||||||
- Ножи, линейки, упаковочные машины, весы
|
|
||||||
|
|
||||||
#### 🎨 **БРЕНДИНГ И ДИЗАЙН**
|
|
||||||
|
|
||||||
- Фирменные пакеты, брендированные коробки, подарочная упаковка
|
|
||||||
|
|
||||||
#### ⚡ **СПЕЦИАЛИЗИРОВАННЫЕ МАТЕРИАЛЫ**
|
|
||||||
|
|
||||||
- Антистатические пакеты, влагопоглотители, защита от краж
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 16. 📱 ПРАВИЛА ПОЛЬЗОВАТЕЛЬСКОГО ИНТЕРФЕЙСА
|
|
||||||
|
|
||||||
### 16.1 Отзывчивость интерфейса
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Интерфейс должен работать на всех устройствах
|
|
||||||
- **ПРАВИЛО**: Адаптивная сетка для карточек товаров
|
|
||||||
- **ФУНКЦИЯ**: Оптимизация для мобильных устройств
|
|
||||||
- **ТРЕБОВАНИЕ**: Корректное отображение на экранах от 320px до 4K
|
|
||||||
|
|
||||||
### 15.2 Обратная связь пользователю
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Уведомления об успешных/неуспешных операциях
|
|
||||||
- **ПРАВИЛО**: Индикаторы загрузки для длительных операций
|
|
||||||
- **ФУНКЦИЯ**: Подтверждение критических действий (удаление, деактивация)
|
|
||||||
- **UX**: Понятные сообщения об ошибках с предложением решения
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 17. 🚨 ПРАВИЛА ОБРАБОТКИ ОШИБОК
|
|
||||||
|
|
||||||
### 17.1 Обработка ошибок
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Логирование всех ошибок с детальной информацией
|
|
||||||
- **ПРАВИЛО**: Понятные сообщения об ошибках для пользователя
|
|
||||||
- **ФУНКЦИЯ**: Автоматическое восстановление после сбоев
|
|
||||||
- **МОНИТОРИНГ**: Отслеживание критических ошибок в реальном времени
|
|
||||||
|
|
||||||
### 16.2 Резервное копирование
|
|
||||||
|
|
||||||
- **КРИТИЧЕСКИ ВАЖНО**: Регулярное резервное копирование данных товаров
|
|
||||||
- **ПРАВИЛО**: Версионность изменений для возможности отката
|
|
||||||
- **ФУНКЦИЯ**: Автоматическое восстановление связей при сбоях
|
|
||||||
- **ПЕРИОДИЧНОСТЬ**: Ежедневные и еженедельные бэкапы
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 18. 📈 ПРАВИЛА ПРОИЗВОДИТЕЛЬНОСТИ
|
|
||||||
|
|
||||||
### 18.1 Оптимизация загрузки
|
|
||||||
|
|
||||||
- **ПРАВИЛО**: Пагинация для больших списков товаров
|
|
||||||
- **ФУНКЦИЯ**: Ленивая загрузка изображений
|
|
||||||
- **ОПТИМИЗАЦИЯ**: Кэширование часто запрашиваемых данных
|
|
||||||
- **ПРОИЗВОДИТЕЛЬНОСТЬ**: Время загрузки страницы не более 3 секунд
|
|
||||||
|
|
||||||
### 17.2 Масштабируемость
|
|
||||||
|
|
||||||
- **АРХИТЕКТУРА**: Модульная структура для легкого расширения
|
|
||||||
- **ПРАВИЛО**: Использование индексов для быстрого поиска
|
|
||||||
- **ФУНКЦИЯ**: Горизонтальное масштабирование при росте нагрузки
|
|
||||||
- **ПЛАНИРОВАНИЕ**: Готовность к увеличению нагрузки в 10 раз
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 19. 🔐 ПРАВИЛА БЕЗОПАСНОСТИ ДАННЫХ
|
|
||||||
|
|
||||||
### 19.1 Защита данных
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Шифрование чувствительных данных
|
|
||||||
- **ПРАВИЛО**: Аудит всех действий пользователей
|
|
||||||
- **ФУНКЦИЯ**: Контроль доступа на уровне API
|
|
||||||
- **БЕЗОПАСНОСТЬ**: Двухфакторная аутентификация для критических операций
|
|
||||||
|
|
||||||
### 18.2 Соответствие требованиям
|
|
||||||
|
|
||||||
- **GDPR**: Право на удаление и экспорт данных
|
|
||||||
- **ПРАВИЛО**: Прозрачность обработки персональных данных
|
|
||||||
- **ФУНКЦИЯ**: Логирование согласий пользователей
|
|
||||||
- **СООТВЕТСТВИЕ**: Регулярный аудит безопасности
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 20. 🎯 ПРАВИЛА КАЧЕСТВА КОДА
|
|
||||||
|
|
||||||
### 20.1 Стандарты разработки
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Покрытие тестами критической функциональности
|
|
||||||
- **ПРАВИЛО**: Следование принципам SOLID
|
|
||||||
- **ФУНКЦИЯ**: Автоматическое тестирование при развертывании
|
|
||||||
- **КАЧЕСТВО**: Минимальное покрытие тестами 80%
|
|
||||||
|
|
||||||
### 19.2 Документация
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Документирование всех API методов
|
|
||||||
- **ПРАВИЛО**: Комментарии к сложной бизнес-логике
|
|
||||||
- **ФУНКЦИЯ**: Автоматическая генерация документации
|
|
||||||
- **СТАНДАРТ**: Актуальная техническая документация
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 21. 📋 ПРИЛОЖЕНИЕ: ДОПОЛНИТЕЛЬНЫЕ ВОЗМОЖНОСТИ И ПЛАНЫ
|
|
||||||
|
|
||||||
### 🔄 Сложные сценарии (требуют дальнейшей проработки)
|
|
||||||
|
|
||||||
**ЗАМЕТКА**: Данные сценарии выявлены, но пока не учитываются в текущей системе. Требуют отдельного обсуждения:
|
|
||||||
|
|
||||||
#### **Сценарий 1: Из разных товаров → один продукт**
|
|
||||||
|
|
||||||
- **ПРИМЕР**: Товар "Футболка" + Товар "Джинсы" = Продукт "Комплект одежды"
|
|
||||||
- **ТРЕБУЕТ**: Разработки системы "составных продуктов"
|
|
||||||
- **СЛОЖНОСТЬ**: Управление несколькими parentId, распределение себестоимости
|
|
||||||
- **СТАТУС**: Требует технического решения
|
|
||||||
|
|
||||||
#### **Сценарий 2: Из одного товара → несколько продуктов**
|
|
||||||
|
|
||||||
- **ПРИМЕР**: Товар "Ткань 10 метров" → Продукт "Платье" (3м) + Продукт "Юбка" (2м) + остаток 5м
|
|
||||||
- **ТРЕБУЕТ**: Системы "деления товаров" и учета остатков
|
|
||||||
- **СЛОЖНОСТЬ**: Контроль использования материала, учет отходов
|
|
||||||
- **СТАТУС**: Требует проработки алгоритмов
|
|
||||||
|
|
||||||
### 🚀 Предложения по улучшению
|
|
||||||
|
|
||||||
#### **В разработке**:
|
|
||||||
|
|
||||||
- ✅ **Workflow для создания брака и продуктов** - детально описан
|
|
||||||
- ✅ **Разделение расходников на подтипы** - реализовано
|
|
||||||
- ✅ **Связи между товарами и производными типами** - реализовано
|
|
||||||
|
|
||||||
#### **Требует реализации**:
|
|
||||||
|
|
||||||
- **Автогенерация артикулов СФ с префиксами типов** - автоматическое создание уникальных номеров
|
|
||||||
- **Система комплектов товаров** - управление наборами товаров
|
|
||||||
- **Умные уведомления о низких остатках** - персонализированные алерты
|
|
||||||
- **Расширенные фильтры по типам предметов** - улучшенная навигация
|
|
||||||
- **Система прогнозирования спроса** - аналитика и планирование
|
|
||||||
|
|
||||||
### 📊 Полный список 28 универсальных категорий
|
|
||||||
|
|
||||||
1. Одежда и обувь
|
|
||||||
2. Косметика и парфюмерия
|
|
||||||
3. Дом и сад
|
|
||||||
4. Детские товары
|
|
||||||
5. Спорт и отдых
|
|
||||||
6. Электроника
|
|
||||||
7. Книги
|
|
||||||
8. Здоровье
|
|
||||||
9. Автотовары
|
|
||||||
10. Строительство и ремонт
|
|
||||||
11. Продукты питания
|
|
||||||
12. Зоотовары
|
|
||||||
13. Дача, сад и огород
|
|
||||||
14. Канцелярские товары
|
|
||||||
15. Хобби и творчество
|
|
||||||
16. Украшения и аксессуары
|
|
||||||
17. Сумки и чемоданы
|
|
||||||
18. Техника для дома
|
|
||||||
19. Музыкальные инструменты
|
|
||||||
20. Игры и игрушки
|
|
||||||
21. Мебель
|
|
||||||
22. Товары для красоты
|
|
||||||
23. Бытовая химия
|
|
||||||
24. Товары для путешествий
|
|
||||||
25. Медицинские товары
|
|
||||||
26. Религиозные товары
|
|
||||||
27. Антиквариат и коллекционирование
|
|
||||||
28. Прочие товары
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 21. 🎯 ПРАВИЛА КАЧЕСТВА КОДА
|
|
||||||
|
|
||||||
### 21.1 GraphQL Rules
|
|
||||||
|
|
||||||
#### **Правила именования полей**
|
|
||||||
|
|
||||||
**ВАЖНО**: Имена полей в GraphQL запросах должны точно соответствовать схеме!
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// ✅ ПРАВИЛЬНО - соответствует схеме
|
|
||||||
export const GET_MY_COUNTERPARTIES = gql`
|
|
||||||
query GetMyCounterparties {
|
|
||||||
myCounterparties { // <- имя поля в схеме
|
|
||||||
id
|
|
||||||
name
|
|
||||||
type
|
|
||||||
}
|
|
||||||
}
|
|
||||||
`;
|
|
||||||
|
|
||||||
// Использование в компоненте
|
|
||||||
const allCounterparties = counterpartiesData?.myCounterparties || [];
|
|
||||||
```
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// ❌ НЕПРАВИЛЬНО - не соответствует схеме
|
|
||||||
const allCounterparties = counterpartiesData?.getMyCounterparties || []; // Ошибка!
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **Правила отладки GraphQL**
|
|
||||||
|
|
||||||
**При проблемах с GraphQL запросами следовать чек-листу**:
|
|
||||||
|
|
||||||
1. **Проверить соответствие имен полей схеме**
|
|
||||||
2. **Добавить fetchPolicy: 'network-only' для обхода кеша**
|
|
||||||
3. **Логировать данные в браузере и сервере**
|
|
||||||
4. **Проверить авторизацию пользователя**
|
|
||||||
5. **Убедиться что резолвер вызывается**
|
|
||||||
|
|
||||||
#### **Обязательные поля для отладки**
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const { data, loading, error } = useQuery(QUERY_NAME, {
|
|
||||||
fetchPolicy: 'network-only', // Обходим кеш при отладке
|
|
||||||
errorPolicy: 'all' // Показываем все ошибки
|
|
||||||
});
|
|
||||||
|
|
||||||
// Логирование для отладки
|
|
||||||
console.log("Data:", data);
|
|
||||||
console.log("Loading:", loading);
|
|
||||||
console.log("Error:", error);
|
|
||||||
```
|
|
||||||
|
|
||||||
### 21.2 TypeScript Rules
|
|
||||||
|
|
||||||
#### **Интерфейсы данных**
|
|
||||||
|
|
||||||
**Поля интерфейсов должны соответствовать GraphQL схеме**:
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// ✅ ПРАВИЛЬНО - соответствует schema.prisma
|
|
||||||
interface GoodsProduct {
|
|
||||||
id: string;
|
|
||||||
name: string;
|
|
||||||
article: string; // <- соответствует полю в schema
|
|
||||||
quantity?: number; // <- соответствует полю в schema
|
|
||||||
organization: {
|
|
||||||
id: string;
|
|
||||||
name: string;
|
|
||||||
};
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// ❌ НЕПРАВИЛЬНО - не соответствует schema
|
|
||||||
interface GoodsProduct {
|
|
||||||
sku: string; // <- в schema поле называется 'article'
|
|
||||||
stock?: number; // <- в schema поле называется 'quantity'
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
_Эта база знаний создана на основе анализа rules.md, rules1.md и description.md и является единым источником понимания структуры и логики проекта._
|
|
||||||
|
|
||||||
_Версия: 2.0_
|
|
||||||
_Дата создания: 2024_
|
|
||||||
_Статус: АКТИВНАЯ БАЗА ЗНАНИЙ_
|
|
||||||
1
|
|
802
description.md
802
description.md
@ -1,802 +0,0 @@
|
|||||||
# СИСТЕМА УПРАВЛЕНИЯ СКЛАДАМИ И ПОСТАВКАМИ - ПОЛНОЕ ОПИСАНИЕ ПРОЕКТА
|
|
||||||
|
|
||||||
> ⚠️ **ВАЖНОЕ ПРИМЕЧАНИЕ**: Данные из этого файла могут быть удалены только с разрешения пользователя. Все изменения должны согласовываться.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📑 ОГЛАВЛЕНИЕ
|
|
||||||
|
|
||||||
### 🏗️ **АРХИТЕКТУРА СИСТЕМЫ**
|
|
||||||
|
|
||||||
0. [🏠 Кабинет селлера / раздел "Мои поставки"](#0--кабинет-селлера--раздел-мои-поставки)
|
|
||||||
1. [📦 Кабинет поставщика / раздел склад](#1--кабинет-поставщика--раздел-склад)
|
|
||||||
2. [🛠️ Создание и управление карточками](#2--создание-и-управление-карточками)
|
|
||||||
3. [🔧 Управление, хранение, учёт, статус](#3--управление-хранение-учёт-статус)
|
|
||||||
4. [📊 Статистика и аналитика](#4--статистика-и-аналитика)
|
|
||||||
5. [🎛️ Интерфейс и управление](#5--интерфейс-и-управление)
|
|
||||||
|
|
||||||
### 🌐 **ИНТЕГРАЦИИ И СВЯЗИ**
|
|
||||||
|
|
||||||
6. [🌐 Интеграция с системой](#6--интеграция-с-системой)
|
|
||||||
7. [🚚 Workflow поставок - ДЕТАЛИЗИРОВАННАЯ СИСТЕМА СТАТУСОВ](#7--workflow-поставок---детализированная-система-статусов)
|
|
||||||
8. [🔐 Система ролей и доступов](#8--система-ролей-и-доступов)
|
|
||||||
9. [💰 Система тарификации логистики](#9--система-тарификации-логистики)
|
|
||||||
|
|
||||||
### 🏢 **МОДУЛИ СИСТЕМЫ**
|
|
||||||
|
|
||||||
10. [📈 Дополнительные возможности системы](#10--дополнительные-возможности-системы)
|
|
||||||
11. [🔄 Интеграция с другими модулями](#11--интеграция-с-другими-модулями)
|
|
||||||
12. [🏢 СИСТЕМА СКЛАДА ФУЛФИЛМЕНТА](#12--система-склада-фулфилмента)
|
|
||||||
|
|
||||||
### 📋 **РАЗВИТИЕ И ПЛАНЫ**
|
|
||||||
|
|
||||||
13. [📋 РЕКОМЕНДАЦИИ ПО ДОПОЛНЕНИЮ И УЛУЧШЕНИЮ](#13--рекомендации-по-дополнению-и-улучшению)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🏷️ РЕЕСТР СУЩНОСТЕЙ СИСТЕМЫ
|
|
||||||
|
|
||||||
### 📦 **ОСНОВНЫЕ ПРЕДМЕТЫ**
|
|
||||||
|
|
||||||
| Сущность | Название в системе | Описание | Статус |
|
|
||||||
| ---------- | ---------------------------------- | ----------------------------------------------- | --------------- |
|
|
||||||
| Товар | `Product` (type: PRODUCT) | Базовый тип товара от поставщика | ✅ Реализовано |
|
|
||||||
| Брак | `Product` (type: DEFECT) | Производная от товара с дефектами | 🔄 В разработке |
|
|
||||||
| Расходники | `Product` (type: CONSUMABLE) | Материалы и вспомогательные товары | ✅ Реализовано |
|
|
||||||
| Продукт | `Product` (type: FINISHED_PRODUCT) | Готовый к продаже товар (производная от товара) | 🔄 В разработке |
|
|
||||||
|
|
||||||
### 🏢 **ОРГАНИЗАЦИИ И РОЛИ**
|
|
||||||
|
|
||||||
| Сущность | Название в системе | Описание | Статус |
|
|
||||||
| ---------- | ---------------------------------- | --------------------------------------- | -------------- |
|
|
||||||
| Поставщик | `Organization` (type: WHOLESALE) | Создает товары и расходники | ✅ Реализовано |
|
|
||||||
| Селлер | `Organization` (type: SELLER) | Заказывает товары, управляет поставками | ✅ Реализовано |
|
|
||||||
| Фулфилмент | `Organization` (type: FULFILLMENT) | Принимает товары, создает продукты | ✅ Реализовано |
|
|
||||||
| Логистика | `Organization` (type: LOGIST) | Управляет доставками | ✅ Реализовано |
|
|
||||||
|
|
||||||
### 📋 **ПОСТАВКИ И ЗАКАЗЫ**
|
|
||||||
|
|
||||||
| Сущность | Название в системе | Описание | Статус |
|
|
||||||
| ---------------------------- | ------------------------ | ----------------------------------------------- | --------------- |
|
|
||||||
| Заказ поставки | `SupplyOrder` | Основная сущность заказа от селлера/фулфилмента | ✅ Реализовано |
|
|
||||||
| Поставка расходников селлера | `SellerConsumableSupply` | Поставка расходников селлера на фулфилмент | 🔄 В разработке |
|
|
||||||
| Поставка WB | `WildberriesSupply` | Поставка через карточки Wildberries | ✅ Реализовано |
|
|
||||||
| Карточка поставки WB | `WildberriesSupplyCard` | Элемент поставки WB | ✅ Реализовано |
|
|
||||||
| Позиция заказа | `SupplyOrderItem` | Товар в заказе поставки | ✅ Реализовано |
|
|
||||||
|
|
||||||
### 🛒 **ТОРГОВЫЕ ОПЕРАЦИИ**
|
|
||||||
|
|
||||||
| Сущность | Название в системе | Описание | Статус |
|
|
||||||
| --------------- | ------------------ | --------------------------------- | -------------- |
|
|
||||||
| Корзина | `Cart` | Корзина для товаров перед заказом | ✅ Реализовано |
|
|
||||||
| Позиция корзины | `CartItem` | Товар в корзине | ✅ Реализовано |
|
|
||||||
| Избранное | `Favorites` | Избранные товары пользователя | ✅ Реализовано |
|
|
||||||
|
|
||||||
### 📊 **АНАЛИТИКА И ОТЧЕТЫ**
|
|
||||||
|
|
||||||
| Сущность | Название в системе | Описание | Статус |
|
|
||||||
| --------------------- | ---------------------- | ----------------------------- | -------------- |
|
|
||||||
| Аналитика фулфилмента | `FulfillmentAnalytics` | Статистика складских операций | ✅ Реализовано |
|
|
||||||
| Логистические тарифы | `LogisticsTariffs` | Расчет стоимости доставки | ✅ Реализовано |
|
|
||||||
|
|
||||||
### 🏷️ **СПРАВОЧНИКИ**
|
|
||||||
|
|
||||||
| Сущность | Название в системе | Описание | Статус |
|
|
||||||
| --------------------- | ------------------ | ---------------------------------------- | -------------- |
|
|
||||||
| Категория | `Category` | Категория товаров (28 предустановленных) | ✅ Реализовано |
|
|
||||||
| Поставщик расходников | `SupplySupplier` | Поставщик в разделе расходников | ✅ Реализовано |
|
|
||||||
|
|
||||||
### 💬 **КОММУНИКАЦИИ**
|
|
||||||
|
|
||||||
| Сущность | Название в системе | Описание | Статус |
|
|
||||||
| --------- | ------------------ | --------------------------------------- | -------------- |
|
|
||||||
| Сообщение | `Message` | Уведомления через встроенный мессенджер | ✅ Реализовано |
|
|
||||||
|
|
||||||
### 🔄 **ПРОЦЕССЫ**
|
|
||||||
|
|
||||||
| Сущность | Название в системе | Описание | Статус |
|
|
||||||
| ----------------- | ------------------------ | ------------------------------------- | --------------- |
|
|
||||||
| Создание продукта | `ProductCreationProcess` | Workflow превращения товара в продукт | 🔄 В разработке |
|
|
||||||
| Движение товаров | `InventoryMovement` | Учет прихода/расхода товаров | 🔄 В разработке |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ЧАСТЬ I: АРХИТЕКТУРА СИСТЕМЫ
|
|
||||||
|
|
||||||
## 0. 🏠 Кабинет селлера / раздел "Мои поставки"
|
|
||||||
|
|
||||||
### 0.1 Структура раздела "Мои поставки"
|
|
||||||
|
|
||||||
**Раздел делится на два основных направления:**
|
|
||||||
|
|
||||||
#### **🏢 ПОСТАВКИ НА ФУЛФИЛМЕНТ**
|
|
||||||
|
|
||||||
- **Товар** - поставка товаров для создания продуктов
|
|
||||||
- **Карточки** - поставка через WB API с рецептурой
|
|
||||||
- **Поставщики** - заказ товаров у поставщиков с рецептурой
|
|
||||||
- **Расходники селлера** - поставка материалов для товаров селлера
|
|
||||||
|
|
||||||
#### **🛒 ПОСТАВКИ НА МАРКЕТПЛЕЙСЫ** _(планируется)_
|
|
||||||
|
|
||||||
- **Wildberries** - прямые поставки на WB
|
|
||||||
- **Ozon** - прямые поставки на Ozon
|
|
||||||
|
|
||||||
### 0.2 Создание поставки расходников селлера
|
|
||||||
|
|
||||||
#### **📄 Структура страницы создания поставки:**
|
|
||||||
|
|
||||||
**БЛОК 1: ПОСТАВЩИКИ** _(верхняя часть экрана)_
|
|
||||||
|
|
||||||
- **Отображение**: Карточки поставщиков из раздела "Партнеры"
|
|
||||||
- **Навигация**: Горизонтальный скролл (слева-направо) при превышении ширины экрана
|
|
||||||
- **Выбор**: Клик выделяет карточку поставщика
|
|
||||||
- **Результат**: Загружаются расходники выбранного поставщика в блок 2
|
|
||||||
|
|
||||||
**БЛОК 2: РАСХОДНИКИ** _(центральная часть)_
|
|
||||||
|
|
||||||
- **Содержание**: Расходники выбранного поставщика
|
|
||||||
- **Сортировка**: По цене, названию, категории
|
|
||||||
- **Фильтры**: По категории, ценовому диапазону
|
|
||||||
- **Карточка расходника**:
|
|
||||||
- Фото, название, цена, остаток, категория
|
|
||||||
- Количество в комплекте (если есть комплектность)
|
|
||||||
- Поле ввода количества (единицы или комплекты)
|
|
||||||
- Кнопки +/- для изменения количества
|
|
||||||
- **Действие**: Клик добавляет расходник в корзину
|
|
||||||
|
|
||||||
**БЛОК 3: КОРЗИНА** _(правая часть)_
|
|
||||||
|
|
||||||
- **Содержание корзины**:
|
|
||||||
- Количество видов расходников
|
|
||||||
- По каждому расходнику: название, количество, цена за единицу, сумма
|
|
||||||
- Общая сумма всех расходников
|
|
||||||
- **Управление**: Изменение количества, удаление позиций
|
|
||||||
- **Валидация**: Проверка остатков у поставщика
|
|
||||||
- **Настройки поставки**:
|
|
||||||
- Выбор фулфилмент-центра (dropdown из партнеров)
|
|
||||||
- Дата поставки (по умолчанию - дата создания, нельзя выбрать прошедшую)
|
|
||||||
- **Кнопка**: "Создать поставку"
|
|
||||||
|
|
||||||
#### **📊 Отображение созданных поставок**
|
|
||||||
|
|
||||||
**МНОГОУРОВНЕВАЯ ТАБЛИЦА:**
|
|
||||||
|
|
||||||
**Первый уровень** _(основной список)_:
|
|
||||||
|
|
||||||
- Порядковый номер поставки (от большего к меньшему)
|
|
||||||
- Количество видов расходников селлера
|
|
||||||
- Стоимость всей поставки
|
|
||||||
- Количество категорий
|
|
||||||
- Статус поставки
|
|
||||||
|
|
||||||
**Второй уровень** _(раскрывается по клику)_:
|
|
||||||
|
|
||||||
- Название расходника селлера
|
|
||||||
- Количество
|
|
||||||
- Цена
|
|
||||||
- Категория
|
|
||||||
- Поставщик
|
|
||||||
- **Режим**: Только просмотр (редактирование недоступно)
|
|
||||||
|
|
||||||
### 0.3 Workflow поставки расходников селлера
|
|
||||||
|
|
||||||
#### **🔄 Детальный процесс:**
|
|
||||||
|
|
||||||
**ЭТАП 1: СОЗДАНИЕ СЕЛЛЕРОМ**
|
|
||||||
|
|
||||||
1. Селлер создает поставку в своем кабинете
|
|
||||||
2. Поставка появляется в списке со статусом **"В работе"**
|
|
||||||
|
|
||||||
**ЭТАП 2: ОБРАБОТКА ПОСТАВЩИКОМ** 3. Поставщик получает уведомление о заказе 4. Поставщик вносит данные о количестве грузовых мест и объеме 5. Поставщик подтверждает поставку 6. Статус у селлера меняется на **"Одобрена"**
|
|
||||||
|
|
||||||
**ЭТАП 3: ПЕРЕДАЧА В ФУЛФИЛМЕНТ** 7. Данные о поставке появляются в кабинете фулфилмента:
|
|
||||||
|
|
||||||
- Раздел: "Входящие поставки" / "Расходники селлеров"
|
|
||||||
|
|
||||||
8. Менеджер фулфилмента:
|
|
||||||
- Назначает ответственного (из списка сотрудников)
|
|
||||||
- Выбирает тип логистики (из списка логистов в партнерах)
|
|
||||||
- Нажимает кнопку "В работу"
|
|
||||||
|
|
||||||
**ЭТАП 4: ЛОГИСТИЧЕСКОЕ ПОДТВЕРЖДЕНИЕ** 9. В кабинете логистики появляется уведомление о поставке (раздел "Заявки") 10. Логист нажимает кнопку "Одобрить" 11. Статус у всех участников меняется на **"Ожидает отгрузки"**
|
|
||||||
|
|
||||||
**ЭТАП 5: ОТГРУЗКА** 12. Логист приезжает к поставщику за расходниками 13. Поставщик отгружает товар логисту 14. Поставщик нажимает кнопку "Отправлено" 15. Статус у всех участников меняется на **"В пути"**
|
|
||||||
|
|
||||||
**ЭТАП 6: ДОСТАВКА И ПРИЕМКА** 16. Расходники доставляются на склад фулфилмента 17. Менеджер фулфилмента: - Вносит данные о месте хранения расходников - Нажимает кнопку "Принято" 18. **Финальные статусы**: - У селлера, поставщика, логиста: **"Доставлена"** - У фулфилмента: **"Принято"**
|
|
||||||
|
|
||||||
#### **📋 Статусы поставки расходников селлера:**
|
|
||||||
|
|
||||||
1. **В работе** - создана селлером, ожидает обработки поставщиком
|
|
||||||
2. **Одобрена** - подтверждена поставщиком, передана в фулфилмент
|
|
||||||
3. **Ожидает отгрузки** - логистика подтверждена, ожидается забор
|
|
||||||
4. **В пути** - отгружена поставщиком, доставляется на фулфилмент
|
|
||||||
5. **Доставлена/Принято** - получена и оприходована на складе фулфилмента
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 📦 Кабинет поставщика / раздел склад
|
|
||||||
|
|
||||||
### 1.1 Основные возможности
|
|
||||||
|
|
||||||
**СТРУКТУРА СИСТЕМЫ ПО КАБИНЕТАМ:**
|
|
||||||
|
|
||||||
**🏢 КАБИНЕТ ПОСТАВЩИКА** - создает и управляет:
|
|
||||||
|
|
||||||
1. **ТОВАР** - базовый тип товара от поставщика
|
|
||||||
2. **РАСХОДНИКИ** - материалы и вспомогательные товары от поставщика
|
|
||||||
|
|
||||||
**🏭 КАБИНЕТ ФУЛФИЛМЕНТА** - принимает, обрабатывает и управляет всеми типами:
|
|
||||||
|
|
||||||
1. **ТОВАР** - базовые товары от поставщиков (принятые на склад)
|
|
||||||
2. **БРАК** - производная от товара (товар с дефектами)
|
|
||||||
3. **ПРОДУКТ** - производная от товара (готовый к продаже товар)
|
|
||||||
4. **РАСХОДНИКИ ФУЛФИЛМЕНТА** - операционные материалы фулфилмента
|
|
||||||
5. **РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для товаров селлеров
|
|
||||||
|
|
||||||
**ВАЖНО**: Товар ≠ Продукт (это разные сущности в системе)
|
|
||||||
|
|
||||||
**ЛОГИКА КЛАССИФИКАЦИИ РАСХОДНИКОВ:**
|
|
||||||
|
|
||||||
- Поставщик создает карточки типа **"РАСХОДНИКИ"** (без уточнения назначения)
|
|
||||||
- При заказе, в зависимости от заказчика, они классифицируются как:
|
|
||||||
- **"Расходники фулфилмента"** - если заказывает фулфилмент-центр
|
|
||||||
- **"Расходники селлеров"** - если заказывает селлер
|
|
||||||
|
|
||||||
Разделение всех типов предметов на категории. Каждый тип имеет свою логику обработки и workflow.
|
|
||||||
|
|
||||||
## 2. 🛠️ Создание и управление карточками
|
|
||||||
|
|
||||||
### 2.1 Базовые параметры карточки
|
|
||||||
|
|
||||||
Карточка создаётся с помощью заполнения формы, параметры для заполнения:
|
|
||||||
|
|
||||||
- **Фото** - система загрузки и управления изображениями товаров (множественная загрузка, выбор главного изображения, предпросмотр)
|
|
||||||
- **Название**
|
|
||||||
- **Автоматическая генерация системой уникального номера** для конкретного предмета (артикул СФ)
|
|
||||||
- **Возможность написать описание**
|
|
||||||
- **Количество предметов** в единицах
|
|
||||||
- **Количество комплектов** если продаётся комплектом (количество предметов в комплекте, размеры или иное)
|
|
||||||
- **Категория** (28 предустановленных универсальных категорий + специализированные категории расходников)
|
|
||||||
- **Бренд**
|
|
||||||
- **Цвет**
|
|
||||||
- **Размер / объём**
|
|
||||||
- **Вес**
|
|
||||||
- **Габариты**
|
|
||||||
- **Материал**
|
|
||||||
- **Цена за единицу**
|
|
||||||
- **Цена за комплект**
|
|
||||||
- **Заказано**
|
|
||||||
- **В пути**
|
|
||||||
- **Остаток**
|
|
||||||
- **Продано**
|
|
||||||
|
|
||||||
### 2.2 Дополнительные параметры (реализованы в коде)
|
|
||||||
|
|
||||||
- **Статус активности** (`isActive`) - возможность деактивировать предметы
|
|
||||||
- Неактивные предметы не отображаются в маркете
|
|
||||||
- Неактивные предметы не доступны для заказа
|
|
||||||
- **Тип предмета** - строгое разделение на 4 основных типа
|
|
||||||
- **Связь с родительским предметом** - для производных типов (брак, продукт)
|
|
||||||
- **Подтип расходников** - фулфилмента или селлеров
|
|
||||||
- **Дата создания и обновления** - автоматическое отслеживание
|
|
||||||
- **Уникальность артикула** - в рамках организации с префиксом типа
|
|
||||||
|
|
||||||
## 3. 🔧 Управление, хранение, учёт, статус
|
|
||||||
|
|
||||||
### 3.1 Основные функции
|
|
||||||
|
|
||||||
- **Возможность редактирования и удаления карточек**
|
|
||||||
- **Изменение количества в карточке** - данные актуализируются во всей системе
|
|
||||||
- **При заказе карточки** - отображаются данные о количестве заказанного, в пути, остаток, и продано
|
|
||||||
|
|
||||||
### 3.2 Система проверок и валидации (реализовано в коде)
|
|
||||||
|
|
||||||
- **Проверка остатков** при добавлении в корзину
|
|
||||||
- **Валидация данных** при создании/редактировании карточек
|
|
||||||
- **Проверка уникальности артикула** в рамках организации
|
|
||||||
- **Контроль доступа** - нельзя добавлять собственные товары в корзину
|
|
||||||
|
|
||||||
### 3.3 Система корзины и избранного (реализовано в коде)
|
|
||||||
|
|
||||||
- **Корзина товаров** - добавление товаров с проверкой остатков
|
|
||||||
- **Избранные товары** - система избранного для удобства
|
|
||||||
- **Управление количеством** в корзине
|
|
||||||
- **Автоматическая проверка доступности** товаров
|
|
||||||
|
|
||||||
## 4. 📊 Статистика и аналитика
|
|
||||||
|
|
||||||
### 4.1 Блок статистики в верхней части раздела склад
|
|
||||||
|
|
||||||
Должен состоять из блоков и отображать итоговые сведения о параметрах в данном разделе с разделением по типам предметов:
|
|
||||||
|
|
||||||
**Общая статистика:**
|
|
||||||
|
|
||||||
- **Общие остатки всех предметов**
|
|
||||||
- **Количество заказанных позиций**
|
|
||||||
- **Предметы в пути**
|
|
||||||
- **Проданные предметы**
|
|
||||||
- **Уведомления о низких остатках**
|
|
||||||
|
|
||||||
**Разделение по типам и кабинетам:**
|
|
||||||
|
|
||||||
**В КАБИНЕТЕ ПОСТАВЩИКА:**
|
|
||||||
|
|
||||||
- **ТОВАРЫ**: Базовые товары поставщика
|
|
||||||
- **РАСХОДНИКИ**: Материалы и вспомогательные товары от поставщика
|
|
||||||
- Классифицируются при заказе в зависимости от заказчика
|
|
||||||
- Общая статистика по всем расходникам
|
|
||||||
|
|
||||||
**В КАБИНЕТЕ ФУЛФИЛМЕНТА:**
|
|
||||||
|
|
||||||
- **ТОВАРЫ**: Базовые товары от поставщиков (принятые на склад)
|
|
||||||
- **ПРОДУКТЫ**: Готовая продукция (созданная из товаров)
|
|
||||||
- **БРАК**: Статистика потерь и списаний
|
|
||||||
- **РАСХОДНИКИ ФУЛФИЛМЕНТА**: Операционные материалы фулфилмента
|
|
||||||
- **РАСХОДНИКИ СЕЛЛЕРОВ**: Материалы для товаров селлеров
|
|
||||||
|
|
||||||
### 4.2 Развитая система аналитики (реализовано в коде)
|
|
||||||
|
|
||||||
- **Статистика изменений за период** (сутки, неделя, месяц)
|
|
||||||
- **Аналитика по категориям товаров**
|
|
||||||
- **Метрики оборачиваемости**
|
|
||||||
- **Отчеты по поставщикам**
|
|
||||||
- **Анализ популярных товаров**
|
|
||||||
|
|
||||||
## 5. 🎛️ Интерфейс и управление
|
|
||||||
|
|
||||||
### 5.1 Режимы отображения
|
|
||||||
|
|
||||||
- **Возможность переключения режимов** расположения информации (строчная и карточная)
|
|
||||||
- **5 карточек в ряд** в карточном режиме
|
|
||||||
- **Возможность фильтрации и сортировки** данных
|
|
||||||
- **Поиск** по названию, артикулу, категории, бренду
|
|
||||||
|
|
||||||
### 5.2 Система уведомлений
|
|
||||||
|
|
||||||
- **Подсвечивать когда остатки становятся меньше определенного уровня**
|
|
||||||
- **Автоматические уведомления** о новых заказах в мессенджер (реализовано в коде)
|
|
||||||
- **Уведомления об изменении статусов** поставок
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ЧАСТЬ II: ИНТЕГРАЦИИ И СВЯЗИ
|
|
||||||
|
|
||||||
## 6. 🌐 Интеграция с системой
|
|
||||||
|
|
||||||
### 6.1 Глобальная интеграция
|
|
||||||
|
|
||||||
- **Учет и хранение** - данные карточки товаров и расходников отображаются в глобальной сущности «Маркет» во вкладках «Товар» и «Расходники» соответственно
|
|
||||||
|
|
||||||
### 6.2 Интеграция с маркетплейсами (реализовано в коде)
|
|
||||||
|
|
||||||
- **Wildberries API** - загрузка карточек товаров из WB
|
|
||||||
- **Синхронизация данных** с маркетплейсами
|
|
||||||
- **Создание поставок** на основе WB карточек
|
|
||||||
- **Управление API ключами** с проверкой активности
|
|
||||||
|
|
||||||
### 6.3 Интеграция с модулем "Услуги"
|
|
||||||
|
|
||||||
- **Расходники фулфилмента в услугах**:
|
|
||||||
|
|
||||||
- Селлеры могут использовать расходники фулфилмента в разделе "Услуги / Расходники"
|
|
||||||
- Для создания продукта из базового товара
|
|
||||||
- Расходники списываются с остатков фулфилмента
|
|
||||||
- Стоимость включается в стоимость услуги фулфилмента
|
|
||||||
|
|
||||||
- **Процесс создания продукта через услуги**:
|
|
||||||
1. Селлер выбирает услугу "Создание продукта"
|
|
||||||
2. Указывает базовый товар для обработки
|
|
||||||
3. Выбирает необходимые расходники фулфилмента
|
|
||||||
4. Фулфилмент обрабатывает заказ
|
|
||||||
5. Создается готовый продукт с использованием расходников
|
|
||||||
|
|
||||||
## 7. 🚚 Workflow поставок - ДЕТАЛИЗИРОВАННАЯ СИСТЕМА СТАТУСОВ
|
|
||||||
|
|
||||||
### 7.1 Сценарий поставки
|
|
||||||
|
|
||||||
Один из сценариев: селлер в своём кабинете, в разделе «Маркет» заказывает товар и расходники у поставщика, для селлера это поставка, для поставщика это заявка на поставку.
|
|
||||||
|
|
||||||
### 7.2 Детализированная система статусов (8 статусов - реализовано в коде)
|
|
||||||
|
|
||||||
#### 7.2.1 Статусы SupplyOrder (Заказ поставки):
|
|
||||||
|
|
||||||
1. **PENDING** - Ожидает подтверждения поставщиком
|
|
||||||
2. **SUPPLIER_APPROVED** - Одобрено поставщиком
|
|
||||||
3. **CONFIRMED** - Подтвержден (готов к обработке)
|
|
||||||
4. **LOGISTICS_CONFIRMED** - Подтверждено логистикой
|
|
||||||
5. **SHIPPED** - Отгружено поставщиком
|
|
||||||
6. **IN_TRANSIT** - В пути (логистика доставляет)
|
|
||||||
7. **DELIVERED** - Доставлен на фулфилмент
|
|
||||||
8. **CANCELLED** - Отменен
|
|
||||||
|
|
||||||
#### 7.2.2 Статусы Supply (Расходники):
|
|
||||||
|
|
||||||
1. **planned** - Запланировано (ожидает одобрения поставщиком)
|
|
||||||
2. **confirmed** - Подтверждено (ожидает отгрузки после одобрения логистикой)
|
|
||||||
3. **in-transit** - В пути (товар отгружен логистической компании)
|
|
||||||
4. **in-stock** - На складе (товар принят на фулфилменте)
|
|
||||||
|
|
||||||
### 7.3 Пошаговый процесс с уведомлениями
|
|
||||||
|
|
||||||
#### 7.3.1 Этап 1: Создание заказа
|
|
||||||
|
|
||||||
1. **Селлер заказывает** товар/расходники у поставщика
|
|
||||||
2. **Система создает** SupplyOrder со статусом `PENDING`
|
|
||||||
3. **Автоматическое уведомление** поставщику в мессенджер о новом заказе
|
|
||||||
|
|
||||||
#### 7.3.2 Этап 2: Обработка поставщиком
|
|
||||||
|
|
||||||
4. **Поставщику приходит оповещение** в разделе заявки
|
|
||||||
5. **Поставщик нажимает кнопку «Одобрить»**
|
|
||||||
6. **Статус меняется** на `SUPPLIER_APPROVED`
|
|
||||||
7. **У селлера статус** меняется на «Одобрено поставщиком»
|
|
||||||
|
|
||||||
#### 7.3.3 Этап 3: Передача в фулфилмент
|
|
||||||
|
|
||||||
8. **Поставка отображается** в кабинете фулфилмент в разделе «Поставки» / подраздел «поставки на фулфилмент» / новые
|
|
||||||
9. **Фулфилмент выбирает** ответственного за поставку и тип логистики
|
|
||||||
10. **Фулфилмент нажимает** кнопку «Приёмка»
|
|
||||||
11. **Статус меняется** на `CONFIRMED`
|
|
||||||
|
|
||||||
#### 7.3.4 Этап 4: Логистическое подтверждение
|
|
||||||
|
|
||||||
12. **Логистика подтверждает** возможность доставки
|
|
||||||
13. **Статус меняется** на `LOGISTICS_CONFIRMED`
|
|
||||||
14. **У селлера статус** «Ожидает отгрузки»
|
|
||||||
15. **У поставщика статус** «Ожидает отгрузки»
|
|
||||||
|
|
||||||
#### 7.3.5 Этап 5: Отгрузка
|
|
||||||
|
|
||||||
16. **Логистика приезжает** за товаром
|
|
||||||
17. **Поставщик отгружает** товар
|
|
||||||
18. **Поставщик нажимает** кнопку «Отгружено»
|
|
||||||
19. **Статус меняется** на `SHIPPED`, затем `IN_TRANSIT`
|
|
||||||
20. **У селлера статус** «В пути»
|
|
||||||
21. **У фулфилмента статус** «В пути»
|
|
||||||
|
|
||||||
#### 7.3.6 Этап 6: Доставка и приемка
|
|
||||||
|
|
||||||
22. **Логистика доставляет** товар на фулфилмент-центр
|
|
||||||
23. **В кабинете логистики** нажимают кнопку «Доставлено»
|
|
||||||
24. **В кабинете фулфилмента** вводят данные места хранения
|
|
||||||
25. **Фулфилмент нажимает** кнопку «Принято»
|
|
||||||
26. **Статус меняется** на `DELIVERED`
|
|
||||||
27. **Поставка перемещается** в «Поставки» / подраздел «поставки на фулфилмент» / принято со статусом «принято»
|
|
||||||
|
|
||||||
## 8. 🔐 Система ролей и доступов (реализовано в коде)
|
|
||||||
|
|
||||||
### 8.1 Контроль доступа к заказам
|
|
||||||
|
|
||||||
- **Создатель заказа** - полный доступ к своим заказам
|
|
||||||
- **Поставщик** - доступ к заказам, где он является поставщиком
|
|
||||||
- **Фулфилмент-центр** - доступ к заказам, направленным в его центр
|
|
||||||
- **Логистическая компания** - доступ к заказам для доставки
|
|
||||||
|
|
||||||
### 8.2 Разграничение функций по ролям
|
|
||||||
|
|
||||||
- **WHOLESALE** (Поставщик) - создание товаров, управление складом, обработка заказов
|
|
||||||
- **SELLER** (Селлер) - заказ товаров, управление поставками
|
|
||||||
- **FULFILLMENT** (Фулфилмент) - приемка товаров, управление складом
|
|
||||||
- **LOGIST** (Логистика) - управление доставками
|
|
||||||
|
|
||||||
## 9. 💰 Система тарификации логистики (реализовано в коде)
|
|
||||||
|
|
||||||
### 9.1 Расчет стоимости доставки
|
|
||||||
|
|
||||||
- **Тариф до 1м³** - базовая стоимость для малых грузов
|
|
||||||
- **Тариф свыше 1м³** - стоимость для крупных грузов
|
|
||||||
- **Маршруты доставки** - от точки отправления до точки назначения
|
|
||||||
- **Описание услуг** - дополнительные условия доставки
|
|
||||||
|
|
||||||
### 9.2 Параметры логистики
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
model Logistics {
|
|
||||||
fromLocation: String // Откуда
|
|
||||||
toLocation: String // Куда
|
|
||||||
priceUnder1m3: Float // Цена до 1м³
|
|
||||||
priceOver1m3: Float // Цена свыше 1м³
|
|
||||||
description: String? // Описание услуг
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ЧАСТЬ III: МОДУЛИ СИСТЕМЫ
|
|
||||||
|
|
||||||
## 10. 📈 Дополнительные возможности системы
|
|
||||||
|
|
||||||
### 10.1 Система категорий (28 предустановленных)
|
|
||||||
|
|
||||||
- Одежда и обувь
|
|
||||||
- Косметика и парфюмерия
|
|
||||||
- Дом и сад
|
|
||||||
- Детские товары
|
|
||||||
- Спорт и отдых
|
|
||||||
- Электроника
|
|
||||||
- Книги
|
|
||||||
- Здоровье
|
|
||||||
- Автотовары
|
|
||||||
- Строительство и ремонт
|
|
||||||
- Продукты питания
|
|
||||||
- Зоотовары
|
|
||||||
- Дача, сад и огород
|
|
||||||
- Канцелярские товары
|
|
||||||
- Хобби и творчество
|
|
||||||
- Украшения и аксессуары
|
|
||||||
- Сумки и чемоданы
|
|
||||||
- Техника для дома
|
|
||||||
- Музыкальные инструменты
|
|
||||||
- Игры и игрушки
|
|
||||||
- И другие...
|
|
||||||
|
|
||||||
### 10.1.1 Специализированные категории расходников
|
|
||||||
|
|
||||||
**В дополнение к универсальным категориям, для расходников используются:**
|
|
||||||
|
|
||||||
- **Упаковка и защита** - коробки, пакеты, пленка, защитные материалы
|
|
||||||
- **Маркировка и идентификация** - этикетки, бирки, стикеры, штампы
|
|
||||||
- **Крепеж и соединение** - скотч, клей, стяжки, веревки
|
|
||||||
- **Документооборот и вкладыши** - накладные, инструкции, буклеты
|
|
||||||
- **Гигиена и безопасность** - перчатки, маски, антисептики
|
|
||||||
- **Инструменты и приспособления** - ножи, дозаторы, весы
|
|
||||||
- **Брендинг и дизайн** - фирменная упаковка с логотипом
|
|
||||||
- **Специализированные материалы** - антистатические, влагопоглотители
|
|
||||||
- **Торговое оборудование** - манекены, ценникодержатели
|
|
||||||
- **Логистика и складирование** - паллеты, контейнеры
|
|
||||||
- **Технические расходники** - картриджи, батарейки
|
|
||||||
- **Сезонные и праздничные** - новогодняя упаковка, подарочные материалы
|
|
||||||
|
|
||||||
### 10.2 Система уведомлений через мессенджер
|
|
||||||
|
|
||||||
- **Автоматические уведомления** о новых заказах
|
|
||||||
- **Уведомления об изменении статусов**
|
|
||||||
- **Персонализированные сообщения** с деталями заказа
|
|
||||||
- **Интеграция с общим мессенджером** системы
|
|
||||||
|
|
||||||
### 10.3 Предложения по улучшению
|
|
||||||
|
|
||||||
- **Автогенерация артикулов СФ с префиксами типов** - требует реализации
|
|
||||||
- **Система комплектов товаров** - требует реализации
|
|
||||||
- ✅ **Workflow для создания брака и продуктов** - детально описан
|
|
||||||
- ✅ **Разделение расходников на подтипы** - реализовано
|
|
||||||
- ✅ **Связи между товарами и производными типами** - реализовано
|
|
||||||
- **Умные уведомления о низких остатках** - требует улучшения
|
|
||||||
- **Расширенные фильтры по типам предметов** - требует улучшения
|
|
||||||
- **Система прогнозирования спроса** - новая функция
|
|
||||||
|
|
||||||
### 10.4 Сложные сценарии (требуют дальнейшей проработки)
|
|
||||||
|
|
||||||
**ЗАМЕТКА**: Данные сценарии выявлены, но пока не учитываются в текущей системе. Требуют отдельного обсуждения:
|
|
||||||
|
|
||||||
- **Из разных товаров → один продукт**:
|
|
||||||
|
|
||||||
- Пример: Товар "Футболка" + Товар "Джинсы" = Продукт "Комплект одежды"
|
|
||||||
- Требует разработки системы "составных продуктов"
|
|
||||||
|
|
||||||
- **Из одного товара → несколько продуктов**:
|
|
||||||
- Пример: Товар "Ткань 10 метров" → Продукт "Платье" (3м) + Продукт "Юбка" (2м) + остаток 5м
|
|
||||||
- Требует системы "деления товаров" и учета остатков
|
|
||||||
|
|
||||||
## 11. 🔄 Интеграция с другими модулями
|
|
||||||
|
|
||||||
### 11.1 Связь с модулем "Маркет"
|
|
||||||
|
|
||||||
- Товары поставщиков отображаются в глобальном маркете
|
|
||||||
- Фильтрация по типам: товары/расходники
|
|
||||||
- Система поиска и категоризации
|
|
||||||
|
|
||||||
### 11.2 Связь с модулем "Поставки"
|
|
||||||
|
|
||||||
- Автоматическое создание поставок при заказе
|
|
||||||
- Отслеживание статусов в реальном времени
|
|
||||||
- Синхронизация данных между модулями
|
|
||||||
|
|
||||||
### 11.3 Связь с модулем "Аналитика"
|
|
||||||
|
|
||||||
- Передача данных для общей отчетности
|
|
||||||
- Метрики эффективности поставщиков
|
|
||||||
- Анализ популярности товаров
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ЧАСТЬ IV: РАЗВИТИЕ И ПЛАНЫ
|
|
||||||
|
|
||||||
## 12. 🏢 СИСТЕМА СКЛАДА ФУЛФИЛМЕНТА
|
|
||||||
|
|
||||||
### 12.1 Структура раздела склад фулфилмента
|
|
||||||
|
|
||||||
#### 12.1.1 Блок статистика склада
|
|
||||||
|
|
||||||
**Модули в обязательной последовательности:**
|
|
||||||
|
|
||||||
1. **📦 ПРОДУКТ** - готовые к продаже товары
|
|
||||||
|
|
||||||
- Товары, прошедшие обработку и готовые к отгрузке
|
|
||||||
- Показывает текущее количество готовой продукции
|
|
||||||
|
|
||||||
2. **🛒 ТОВАР** - базовые товары от поставщиков
|
|
||||||
|
|
||||||
- Сырье и материалы для производства продуктов
|
|
||||||
- Товары в первоначальном виде от поставщиков
|
|
||||||
|
|
||||||
3. **❌ БРАК** - товары с дефектами
|
|
||||||
|
|
||||||
- Товары, не прошедшие контроль качества
|
|
||||||
- Списанные и подлежащие утилизации предметы
|
|
||||||
|
|
||||||
4. **↩️ ВОЗВРАТЫ С ПВЗ** - возвращенные товары
|
|
||||||
|
|
||||||
- Товары, возвращенные покупателями
|
|
||||||
- Требуют проверки и переклассификации
|
|
||||||
|
|
||||||
5. **🎯 РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для селлеров
|
|
||||||
|
|
||||||
- Упаковочные материалы для товаров селлеров
|
|
||||||
- Заказываются селлерами напрямую
|
|
||||||
|
|
||||||
6. **⚙️ РАСХОДНИКИ ФУЛФИЛМЕНТ** - операционные материалы
|
|
||||||
- **КЛИКАБЕЛЬНЫЙ МОДУЛЬ** - содержит полноценный раздел учёта
|
|
||||||
- Материалы для внутренних операций фулфилмента
|
|
||||||
- Используются для услуг селлерам
|
|
||||||
|
|
||||||
**ВАЖНО**: В модуле ТОВАР отображаются два счетчика:
|
|
||||||
|
|
||||||
- **Товары "на складе"** - готовы к обработке
|
|
||||||
- **Товары "в обработке"** - находятся в процессе создания продукта
|
|
||||||
|
|
||||||
#### 12.1.2 Система учёта движения товаров
|
|
||||||
|
|
||||||
**Основные принципы учёта:**
|
|
||||||
|
|
||||||
- **ПРИХОД ТОВАРОВ**: Через принятые поставки (статус "в пути" → "на складе")
|
|
||||||
- **РАСХОД ТОВАРОВ**: При отгрузке, списании, использовании для услуг
|
|
||||||
- **ДВОЙНОЙ УЧЁТ**: Основные значения + дополнительные значения
|
|
||||||
|
|
||||||
**Дополнительные значения (показатели движения):**
|
|
||||||
|
|
||||||
- **ПРИБЫЛО** - количество предметов, поступивших на склад за период
|
|
||||||
- **УБЫЛО** - количество предметов, списанных со склада за период
|
|
||||||
- **ВЛИЯНИЕ** - от этих значений зависят основные значения
|
|
||||||
|
|
||||||
**Основные значения (текущие остатки):**
|
|
||||||
|
|
||||||
- **ФОРМУЛА**: Основные значения = Предыдущие остатки + Прибыло - Убыло
|
|
||||||
- **ОТОБРАЖЕНИЕ**: Показываются в каждом модуле статистики
|
|
||||||
- **АКТУАЛЬНОСТЬ**: Обновляются в реальном времени
|
|
||||||
|
|
||||||
#### 12.1.3 Детальный раздел "Расходники фулфилмента"
|
|
||||||
|
|
||||||
**Особенности:**
|
|
||||||
|
|
||||||
- **ИНТЕРАКТИВНОСТЬ**: Кликабельный модуль в статистике
|
|
||||||
- **ПЕРЕХОД**: К полноценному разделу управления расходниками фулфилмента
|
|
||||||
- **ФУНКЦИОНАЛЬНОСТЬ**:
|
|
||||||
- Создание и редактирование карточек расходников фулфилмента
|
|
||||||
- Управление остатками и заказами расходников фулфилмента
|
|
||||||
- Отслеживание использования расходников фулфилмента в услугах
|
|
||||||
- Аналитика расхода расходников фулфилмента по операциям
|
|
||||||
|
|
||||||
#### 12.1.4 Блок детализация по Магазинам
|
|
||||||
|
|
||||||
**Назначение**: Распределение товаров по торговым точкам
|
|
||||||
|
|
||||||
- **ОСТАТКИ ПО МАГАЗИНАМ**: Отображение количества товаров в каждом магазине
|
|
||||||
- **УПРАВЛЕНИЕ РАСПРЕДЕЛЕНИЕМ**: Перемещение товаров между точками
|
|
||||||
- **КОНТРОЛЬ ДВИЖЕНИЯ**: Отслеживание перемещений между складами и магазинами
|
|
||||||
|
|
||||||
### 12.2 Workflow движения товаров в фулфилменте
|
|
||||||
|
|
||||||
#### 12.2.1 Поступление товаров на склад
|
|
||||||
|
|
||||||
**Источники поступления:**
|
|
||||||
|
|
||||||
1. **ПОСТАВКИ ОТ ПОСТАВЩИКОВ** - основной канал поступления
|
|
||||||
2. **ВОЗВРАТЫ С ПВЗ** - товары от покупателей
|
|
||||||
3. **ВНУТРЕННИЕ ПЕРЕМЕЩЕНИЯ** - между складами фулфилмента
|
|
||||||
|
|
||||||
**Процесс приёмки:**
|
|
||||||
|
|
||||||
1. Поставка переходит в статус "принято"
|
|
||||||
2. Товары меняют статус: "в пути" → "на складе"
|
|
||||||
3. Обновляются основные значения (остатки)
|
|
||||||
4. Фиксируется в дополнительных значениях как "прибыло"
|
|
||||||
5. Обновляется статистика по модулям
|
|
||||||
|
|
||||||
#### 12.2.2 Расход товаров со склада
|
|
||||||
|
|
||||||
**Причины расхода:**
|
|
||||||
|
|
||||||
- **ОТГРУЗКА СЕЛЛЕРАМ** - выполнение заказов
|
|
||||||
- **СПИСАНИЕ** - брак, утрата, утилизация
|
|
||||||
- **ИСПОЛЬЗОВАНИЕ В УСЛУГАХ** - расходники для создания продуктов
|
|
||||||
- **ПРЕВРАЩЕНИЕ В ПРОДУКТЫ** - товары становятся продуктами
|
|
||||||
- **ВОЗВРАТ ПОСТАВЩИКУ** - некачественные товары
|
|
||||||
|
|
||||||
**Процесс списания:**
|
|
||||||
|
|
||||||
1. Указание причины расхода
|
|
||||||
2. Обновление основных значений (уменьшение остатков)
|
|
||||||
3. Фиксация в дополнительных значениях как "убыло"
|
|
||||||
4. Обновление статистики модулей
|
|
||||||
|
|
||||||
#### 12.2.3 Процесс "Создания продукта"
|
|
||||||
|
|
||||||
**Полный цикл превращения товара в продукт:**
|
|
||||||
|
|
||||||
**ЭТАП 1: ПОСТУПЛЕНИЕ И СОРТИРОВКА**
|
|
||||||
|
|
||||||
1. Товар поступает на склад фулфилмента (статус "на складе")
|
|
||||||
2. Перебор и сортировка товара
|
|
||||||
3. Выявление и отсеивание брака
|
|
||||||
|
|
||||||
**ЭТАП 2: ПОДГОТОВКА К РАБОТЕ** 4. Поставка попадает в раздел "Создание продукта" / Новые 5. Менеджер фулфилмента:
|
|
||||||
|
|
||||||
- Устанавливает дедлайн выполнения
|
|
||||||
- Назначает ответственного исполнителя
|
|
||||||
- Указывает место хранения готовых продуктов (опционально)
|
|
||||||
- Нажимает "В работе"
|
|
||||||
|
|
||||||
**ЭТАП 3: ОБРАБОТКА (СОЗДАНИЕ ПРОДУКТА)** 6. Поставка переходит в "Создание продукта" / В работе 7. Товары получают статус "в работе" 8. Исполнитель работает по "рецептуре" селлера:
|
|
||||||
|
|
||||||
- Применяет услуги фулфилмента (например, "погладить")
|
|
||||||
- Использует расходники селлера (например, фирменный пакет)
|
|
||||||
- Использует расходники фулфилмента (например, короб + маркировка)
|
|
||||||
|
|
||||||
**ЭТАП 4: УЧЕТ ПЛАН/ФАКТ** 9. В процессе работы фиксируется:
|
|
||||||
|
|
||||||
- **ПЛАН**: Количество из поставки селлера
|
|
||||||
- **ФАКТ**: Реальное количество = Брак + Хороший товар
|
|
||||||
- **ДЕТАЛИЗАЦИЯ**: По каждому размеру/объему
|
|
||||||
|
|
||||||
10. Статистика корректируется на фактические данные
|
|
||||||
|
|
||||||
**ЭТАП 5: ЗАВЕРШЕНИЕ** 11. Исполнитель нажимает "Выполнено" 12. Товары становятся продуктами со статусом "готов к отправке" 13. Поставка переходит в "Создание продукта" / Выполнено
|
|
||||||
|
|
||||||
**РЕЗУЛЬТАТ**: ПРОДУКТ = Товар + Услуга + Расходники
|
|
||||||
|
|
||||||
**РЕЦЕПТУРА ПРОДУКТА (задается селлером):**
|
|
||||||
|
|
||||||
- **БАЗОВЫЙ ТОВАР**: Исходный материал
|
|
||||||
- **УСЛУГА ФУЛФИЛМЕНТА**: Из каталога услуг фулфилмента
|
|
||||||
- **РАСХОДНИК СЕЛЛЕРА**: Материалы селлера (опционально)
|
|
||||||
- **РАСХОДНИК ФУЛФИЛМЕНТА**: Материалы фулфилмента (опционально)
|
|
||||||
- **СВЯЗЬ С MP**: Связь с карточкой маркетплейса (опционально)
|
|
||||||
|
|
||||||
### 12.3 Интеграция с системой поставщиков
|
|
||||||
|
|
||||||
**Связь систем складов:**
|
|
||||||
|
|
||||||
- **ПОСТАВЩИК → ФУЛФИЛМЕНТ**: Передача товаров через поставки
|
|
||||||
- **СИНХРОНИЗАЦИЯ ДАННЫХ**: Остатки, статусы, движение товаров
|
|
||||||
- **УВЕДОМЛЕНИЯ**: О принятии поставок и изменении статусов
|
|
||||||
|
|
||||||
## 13. 📋 РЕКОМЕНДАЦИИ ПО ДОПОЛНЕНИЮ И УЛУЧШЕНИЮ
|
|
||||||
|
|
||||||
### 13.1 Дополнить в описании
|
|
||||||
|
|
||||||
- ✅ **Система активации/деактивации товаров** - добавлено
|
|
||||||
- ✅ **Функционал корзины и избранного** - добавлено
|
|
||||||
- ✅ **Интеграция с маркетплейсами (WB)** - добавлено
|
|
||||||
- ✅ **Автоматические уведомления** - добавлено
|
|
||||||
- ✅ **Система тарификации логистики** - добавлено
|
|
||||||
- ✅ **Управление изображениями товаров** - добавлено
|
|
||||||
- ✅ **Проверки остатков и валидация** - добавлено
|
|
||||||
|
|
||||||
### 13.2 Расширить workflow
|
|
||||||
|
|
||||||
- ✅ **Промежуточные статусы** (`SUPPLIER_APPROVED`, `LOGISTICS_CONFIRMED`, `SHIPPED`) - добавлено
|
|
||||||
- ✅ **Роли и права доступа** - добавлено
|
|
||||||
- ✅ **Автоматические уведомления на каждом этапе** - добавлено
|
|
||||||
|
|
||||||
### 13.3 Дополнить систему статистики
|
|
||||||
|
|
||||||
- ✅ **Метрики изменений за период** - добавлено
|
|
||||||
- ✅ **Аналитика по категориям** - добавлено
|
|
||||||
- ✅ **Отчеты по поставщикам** - добавлено
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
_Документ создан на основе анализа существующего кода и требований пользователя_
|
|
||||||
_Версия: 1.0_
|
|
||||||
_Дата: 2024_
|
|
@ -1,223 +0,0 @@
|
|||||||
# ЧЕКЛИСТ РАЗРАБОТКИ - ОБЯЗАТЕЛЬНЫЕ ПРОВЕРКИ
|
|
||||||
|
|
||||||
> ⚠️ **КРИТИЧЕСКИ ВАЖНО**: Этот чеклист ОБЯЗАТЕЛЕН к проверке перед любым изменением кода!
|
|
||||||
|
|
||||||
## 🔤 ТЕРМИНЫ СИСТЕМЫ
|
|
||||||
> Для людей → `В коде`
|
|
||||||
- ТОВАР → `PRODUCT`
|
|
||||||
- РАСХОДНИКИ → `CONSUMABLE`
|
|
||||||
- БРАК → `DEFECT` *(планируется)*
|
|
||||||
- ПРОДУКТ → `FINISHED_PRODUCT` *(планируется)*
|
|
||||||
|
|
||||||
## 🔴 КРИТИЧЕСКИЕ ПРОВЕРКИ (НЕЛЬЗЯ НАРУШАТЬ)
|
|
||||||
|
|
||||||
### ✅ Типизация предметов
|
|
||||||
|
|
||||||
- [ ] Каждый предмет имеет один из типов: ТОВАР (`PRODUCT`), РАСХОДНИКИ (`CONSUMABLE`), БРАК и ПРОДУКТ (планируются)
|
|
||||||
- [ ] БРАК и ПРОДУКТ имеют обязательную связь с родительским товаром (parentId)
|
|
||||||
- [ ] Расходники создаются как универсальный тип, классифицируются при заказе
|
|
||||||
- [ ] ТОВАР ≠ ПРОДУКТ (разные сущности в системе)
|
|
||||||
- [ ] **В формах создания поставок товаров показываются ТОЛЬКО предметы типа ТОВАР** (`PRODUCT`)
|
|
||||||
- [ ] **В формах создания поставок расходников показываются ТОЛЬКО предметы типа РАСХОДНИКИ** (`CONSUMABLE`)
|
|
||||||
- [ ] **Фильтрация по типу предмета происходит на уровне GraphQL резолвера**, не на фронтенде
|
|
||||||
|
|
||||||
### ✅ Workflow статусов
|
|
||||||
|
|
||||||
- [ ] Соблюдена последовательность: PENDING → SUPPLIER_APPROVED → CONFIRMED → LOGISTICS_CONFIRMED → SHIPPED → IN_TRANSIT → DELIVERED
|
|
||||||
- [ ] Нет пропуска промежуточных статусов
|
|
||||||
- [ ] Каждое изменение статуса сопровождается уведомлением
|
|
||||||
|
|
||||||
### ✅ Правила доступа
|
|
||||||
|
|
||||||
- [ ] Поставщик НЕ может добавлять собственные товары в корзину
|
|
||||||
- [ ] Заказ брака ЗАПРЕЩЕН
|
|
||||||
- [ ] Только активные предметы отображаются в маркете
|
|
||||||
- [ ] Проверка остатков перед добавлением в корзину
|
|
||||||
|
|
||||||
### ✅ Система фулфилмента
|
|
||||||
|
|
||||||
- [ ] Товары разделены на "на складе" и "в обработке"
|
|
||||||
- [ ] Модули статистики в правильной последовательности: ПРОДУКТ → ТОВАР → БРАК → ВОЗВРАТЫ → РАСХОДНИКИ СЕЛЛЕРОВ → РАСХОДНИКИ ФУЛФИЛМЕНТА
|
|
||||||
- [ ] Процесс создания продукта включает учет план/факт
|
|
||||||
|
|
||||||
### ✅ Система логистики
|
|
||||||
|
|
||||||
- [ ] Своевременное подтверждение заявок на доставку
|
|
||||||
- [ ] Соблюдение workflow логистики: получение заявки → подтверждение → забор → доставка
|
|
||||||
- [ ] Корректная работа системы тарификации (до 1м³ и свыше 1м³)
|
|
||||||
- [ ] Обязательные уведомления о статусе доставки
|
|
||||||
|
|
||||||
### ✅ Структура кабинетов
|
|
||||||
|
|
||||||
- [ ] Каждый тип кабинета имеет страницу "Главная" (РЕАЛИЗОВАНО)
|
|
||||||
- [ ] Страница "Главная" первая в sidebar навигации (РЕАЛИЗОВАНО)
|
|
||||||
- [ ] Условное отображение разделов по типу организации: `{user?.organization?.type === "TYPE" && (...)}`
|
|
||||||
- [ ] Адаптивный роутинг для кнопок с разной логикой по типам кабинетов
|
|
||||||
- [ ] Роут `/home` с универсальным компонентом HomePageWrapper
|
|
||||||
- [ ] 4 типо-зависимых компонента: SellerHomePage, FulfillmentHomePage, WholesaleHomePage, LogistHomePage
|
|
||||||
- [ ] Проверки доступа и безопасности в каждом компоненте
|
|
||||||
- [ ] Каждый кабинет имеет раздел "Экономика" (РЕАЛИЗОВАНО В СИСТЕМЕ)
|
|
||||||
- [ ] Разделы "Экономика" размещены перед настройками в каждом кабинете (РЕАЛИЗОВАНО)
|
|
||||||
- [ ] Пустые разделы-заглушки с пометкой "будет добавлен позже" (РЕАЛИЗОВАНО)
|
|
||||||
- [ ] Роут `/economics` с универсальным компонентом EconomicsPageWrapper (РЕАЛИЗОВАНО)
|
|
||||||
- [ ] 4 типо-зависимых компонента экономики: SellerEconomicsPage, FulfillmentEconomicsPage, WholesaleEconomicsPage, LogistEconomicsPage (РЕАЛИЗОВАНО)
|
|
||||||
- [ ] Кнопка "Экономика" в sidebar навигации перед настройками (РЕАЛИЗОВАНО)
|
|
||||||
- [ ] Проверки доступа и безопасности в экономических компонентах (РЕАЛИЗОВАНО)
|
|
||||||
|
|
||||||
### ✅ Обязательные поля
|
|
||||||
|
|
||||||
- [ ] Название, артикул, цена > 0, тип предмета
|
|
||||||
- [ ] ИСКЛЮЧЕНИЕ: Цена брака может быть 0 для фулфилмента (себестоимость для селлера)
|
|
||||||
- [ ] Уникальность артикула в рамках организации
|
|
||||||
- [ ] Формат артикула: СФ-{ТИП}-{КОД*КАТЕГОРИИ}-{КОД*ОРГАНИЗАЦИИ}-{TIMESTAMP}-{RANDOM}
|
|
||||||
- [ ] Товар имеет минимум одно изображение (ПРИМЕР АВТОСИНХРОНИЗАЦИИ)
|
|
||||||
|
|
||||||
## 🟡 ВАЖНЫЕ ПРОВЕРКИ
|
|
||||||
|
|
||||||
### ✅ Валидация данных
|
|
||||||
|
|
||||||
- [ ] Все числовые значения корректны (цена > 0, вес > 0)
|
|
||||||
- [ ] Количество в заказе не превышает остаток
|
|
||||||
- [ ] Проверка корректности дат (не прошедшие для поставок)
|
|
||||||
- [ ] Валидация количества: минимум 1 единица/комплект, максимум = остаток у поставщика
|
|
||||||
- [ ] Проверка в реальном времени при изменении количества
|
|
||||||
|
|
||||||
### ✅ Уведомления
|
|
||||||
|
|
||||||
- [ ] Автоматические уведомления при создании заказов
|
|
||||||
- [ ] Уведомления при изменении статусов всем участникам
|
|
||||||
- [ ] Логирование всех изменений
|
|
||||||
|
|
||||||
### ✅ Интеграции
|
|
||||||
|
|
||||||
- [ ] Синхронизация данных между модулями
|
|
||||||
- [ ] Корректная работа с API маркетплейсов
|
|
||||||
- [ ] Связь с модулем "Услуги" для расходников фулфилмента
|
|
||||||
|
|
||||||
## 💻 ТЕХНИЧЕСКИЕ ПРОВЕРКИ
|
|
||||||
|
|
||||||
### ✅ Пользовательский интерфейс
|
|
||||||
|
|
||||||
- [ ] Адаптивность интерфейса для всех устройств
|
|
||||||
- [ ] Индикаторы загрузки для длительных операций
|
|
||||||
- [ ] Подтверждение критических действий
|
|
||||||
- [ ] Время загрузки страницы не более 3 секунд
|
|
||||||
|
|
||||||
### ✅ Обработка ошибок
|
|
||||||
|
|
||||||
- [ ] Логирование всех ошибок с детальной информацией
|
|
||||||
- [ ] Понятные сообщения об ошибках для пользователя
|
|
||||||
- [ ] Автоматическое восстановление после сбоев
|
|
||||||
- [ ] Регулярное резервное копирование данных
|
|
||||||
|
|
||||||
### ✅ Производительность
|
|
||||||
|
|
||||||
- [ ] Пагинация для больших списков товаров
|
|
||||||
- [ ] Ленивая загрузка изображений
|
|
||||||
- [ ] Кэширование часто запрашиваемых данных
|
|
||||||
- [ ] Готовность к масштабированию
|
|
||||||
|
|
||||||
### ✅ Безопасность данных
|
|
||||||
|
|
||||||
- [ ] Шифрование чувствительных данных
|
|
||||||
- [ ] Аудит всех действий пользователей
|
|
||||||
- [ ] Контроль доступа на уровне API
|
|
||||||
- [ ] Соответствие требованиям GDPR
|
|
||||||
|
|
||||||
### ✅ Качество кода
|
|
||||||
|
|
||||||
- [ ] Покрытие тестами критической функциональности (минимум 80%)
|
|
||||||
- [ ] Следование принципам SOLID
|
|
||||||
- [ ] Документирование всех API методов
|
|
||||||
- [ ] Автоматическое тестирование при развертывании
|
|
||||||
|
|
||||||
### ✅ GraphQL и TypeScript
|
|
||||||
|
|
||||||
- [ ] Имена полей в коде соответствуют GraphQL схеме (`myCounterparties`, не `getMyCounterparties`)
|
|
||||||
- [ ] Интерфейсы TypeScript соответствуют schema.prisma (`article`, не `sku`; `quantity`, не `stock`)
|
|
||||||
- [ ] При проблемах с GraphQL использовать `fetchPolicy: 'network-only'` для обхода кеша
|
|
||||||
- [ ] Добавлять логирование при отладке GraphQL запросов
|
|
||||||
- [ ] Проверка что резолверы вызываются (логи сервера)
|
|
||||||
- [ ] **Использовать специализированные запросы вместо общих** (`GET_ORGANIZATION_PRODUCTS` вместо `GET_ALL_PRODUCTS` для конкретного поставщика)
|
|
||||||
- [ ] **Обязательная фильтрация по типу предмета** в резолверах (`PRODUCT`/`CONSUMABLE`)
|
|
||||||
- [ ] **Параметр `organizationId` обязателен** для запросов товаров конкретной организации
|
|
||||||
|
|
||||||
### ✅ Система партнерства
|
|
||||||
|
|
||||||
- [ ] Поставщики в формах берутся только из партнеров с типом `WHOLESALE`
|
|
||||||
- [ ] Используется запрос `GET_MY_COUNTERPARTIES` с фильтрацией по типу
|
|
||||||
- [ ] НЕ используется `GET_SUPPLY_SUPPLIERS` для отображения поставщиков в формах
|
|
||||||
- [ ] Партнерство создается двумя способами: через заказ в маркете или через раздел "Партнеры"
|
|
||||||
- [ ] Двусторонние записи в таблице `Counterparty` при создании партнерства
|
|
||||||
|
|
||||||
### ✅ Архитектурные принципы GraphQL
|
|
||||||
|
|
||||||
- [ ] **Создавать специализированные резолверы** для каждого контекста использования
|
|
||||||
- [ ] **Использовать параметризованные запросы** (`organizationId`, `type`, `search`) вместо фильтрации на фронтенде
|
|
||||||
- [ ] **Добавлять подробное логирование** в резолверы для отладки (входные параметры, результаты фильтрации)
|
|
||||||
- [ ] **Типы запросов должны отражать бизнес-логику**: `organizationProducts` для товаров конкретной организации
|
|
||||||
- [ ] **Значения по умолчанию в резолверах** для критических параметров (`type: args.type || "PRODUCT"`)
|
|
||||||
- [ ] **Валидация обязательных параметров** на уровне схемы (`organizationId: ID!`)
|
|
||||||
- [ ] **Кеширование обходить при проблемах** через `fetchPolicy: 'network-only'`
|
|
||||||
|
|
||||||
## 🟢 РЕКОМЕНДУЕМЫЕ ПРОВЕРКИ
|
|
||||||
|
|
||||||
### ✅ Пользовательский опыт
|
|
||||||
|
|
||||||
- [ ] Адаптивность интерфейса
|
|
||||||
- [ ] Индикаторы загрузки
|
|
||||||
- [ ] Понятные сообщения об ошибках
|
|
||||||
|
|
||||||
### ✅ Производительность
|
|
||||||
|
|
||||||
- [ ] Пагинация для больших списков
|
|
||||||
- [ ] Ленивая загрузка изображений
|
|
||||||
- [ ] Кэширование данных
|
|
||||||
|
|
||||||
## ❌ АБСОЛЮТНО ЗАПРЕЩЕНО
|
|
||||||
|
|
||||||
1. Удалять предметы с существующими заказами
|
|
||||||
2. Изменять статусы без уведомлений
|
|
||||||
3. Обходить проверки остатков
|
|
||||||
4. Давать доступ к чужим данным
|
|
||||||
5. Создавать брак/продукт без связи с родительским товаром
|
|
||||||
6. Создавать отдельные типы расходников
|
|
||||||
7. Разрешать заказ брака
|
|
||||||
8. Нарушать последовательность статусов
|
|
||||||
9. Игнорировать валидацию
|
|
||||||
10. Нарушать последовательность модулей в статистике фулфилмента
|
|
||||||
11. **Использовать неправильные имена полей GraphQL** (`getMyCounterparties` вместо `myCounterparties`)
|
|
||||||
12. **Использовать GET_SUPPLY_SUPPLIERS для отображения поставщиков в формах** (только партнеры WHOLESALE)
|
|
||||||
13. **Создавать интерфейсы TypeScript не соответствующие schema.prisma** (`sku`/`stock` вместо `article`/`quantity`)
|
|
||||||
14. **Использовать общие запросы вместо специализированных** (`GET_ALL_PRODUCTS` вместо `GET_ORGANIZATION_PRODUCTS` для конкретного поставщика)
|
|
||||||
15. **Показывать расходники в формах создания поставок товаров** (строгая типизация `PRODUCT`/`CONSUMABLE`)
|
|
||||||
16. **Фильтровать предметы по типу на фронтенде** (фильтрация должна быть в GraphQL резолвере)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🤔 ПРАВИЛО УТОЧНЕНИЙ
|
|
||||||
|
|
||||||
**КРИТИЧЕСКИ ВАЖНО**: Если я не уверен в выполнении задачи или вижу противоречия в правилах - ОБЯЗАТЕЛЬНО уточнить у пользователя!
|
|
||||||
|
|
||||||
### ❓ КОГДА УТОЧНЯТЬ:
|
|
||||||
|
|
||||||
- [ ] Недостаточно информации для правильного выполнения
|
|
||||||
- [ ] Вижу противоречия между правилами
|
|
||||||
- [ ] Задача может нарушить критические правила
|
|
||||||
- [ ] Неясно как применить правило в конкретной ситуации
|
|
||||||
- [ ] Есть сомнения в интерпретации требований
|
|
||||||
|
|
||||||
### 📝 КАК УТОЧНЯТЬ:
|
|
||||||
|
|
||||||
1. Четко сформулировать что именно неясно
|
|
||||||
2. Указать какие правила/требования конфликтуют
|
|
||||||
3. Предложить варианты решения если возможно
|
|
||||||
4. Запросить конкретные уточнения
|
|
||||||
|
|
||||||
**❌ НИКОГДА не делать предположений если есть сомнения!**
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**ПРАВИЛО**: Перед каждым изменением кода проверить этот чеклист!
|
|
||||||
**ИСТОЧНИК ИСТИНЫ**: rules-unified.md (v4.0)
|
|
||||||
**СТАТУС**: ОБЯЗАТЕЛЬНЫЙ К ВЫПОЛНЕНИЮ
|
|
@ -1,482 +0,0 @@
|
|||||||
# ПРАВИЛА КАБИНЕТА ФУЛФИЛМЕНТА
|
|
||||||
|
|
||||||
> 📋 **Файл создан на основе анализа системы** - детальные правила для кабинета фулфилмента
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📑 ОГЛАВЛЕНИЕ
|
|
||||||
|
|
||||||
1. [🏭 Общие характеристики кабинета фулфилмента](#1--общие-характеристики-кабинета-фулфилмента)
|
|
||||||
2. [🗂️ Основные разделы кабинета](#2--основные-разделы-кабинета)
|
|
||||||
3. [🔒 Правила доступа фулфилмента](#3--правила-доступа-фулфилмента)
|
|
||||||
4. [📋 Критические правила для rules2.md](#4--критические-правила-для-rules2md)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 🏭 ОБЩИЕ ХАРАКТЕРИСТИКИ КАБИНЕТА ФУЛФИЛМЕНТА
|
|
||||||
|
|
||||||
### 1.1 Принципы доступа
|
|
||||||
|
|
||||||
- **МАКСИМАЛЬНЫЕ ПРАВА**: Фулфилмент имеет доступ ко ВСЕМ разделам системы
|
|
||||||
- **АДАПТИВНАЯ НАВИГАЦИЯ**: Sidebar изменяется в зависимости от `user.organization.type === "FULFILLMENT"`
|
|
||||||
- **ЭКСКЛЮЗИВНЫЕ КОМПОНЕНТЫ**: Услуги, Сотрудники, Статистика фулфилмента доступны ТОЛЬКО фулфилменту
|
|
||||||
- **СПЕЦИАЛЬНЫЙ РОУТИНГ**: При нажатии "Поставки" → `/fulfillment-supplies` (не `/supplies`)
|
|
||||||
|
|
||||||
### 1.2 Архитектурные особенности
|
|
||||||
|
|
||||||
- **GraphQL проверки**: `skip: user?.organization?.type !== 'FULFILLMENT'` в запросах
|
|
||||||
- **Условное отображение**: `{user?.organization?.type === "FULFILLMENT" && (...)}`
|
|
||||||
- **Адаптивные отступы**: `getSidebarMargin()` для responsive design
|
|
||||||
- **Полинг данных**: Статистика обновляется каждую минуту (`pollInterval: 60000`)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 🗂️ ОСНОВНЫЕ РАЗДЕЛЫ КАБИНЕТА
|
|
||||||
|
|
||||||
### 2.1 🏠 Главная страница (`/dashboard`)
|
|
||||||
|
|
||||||
**Компонент**: `DashboardHome`
|
|
||||||
**Содержание**:
|
|
||||||
|
|
||||||
- Основная информация организации
|
|
||||||
- Статус онлайн пользователя
|
|
||||||
- Быстрый доступ к основным разделам
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 2.2 🏭 Склад фулфилмента (`/fulfillment-warehouse`)
|
|
||||||
|
|
||||||
**Компонент**: `FulfillmentWarehouseDashboard`
|
|
||||||
|
|
||||||
#### 2.2.1 Структура склада по модулям (ОБЯЗАТЕЛЬНАЯ ПОСЛЕДОВАТЕЛЬНОСТЬ)
|
|
||||||
|
|
||||||
1. **📦 ПРОДУКТЫ** - готовые к отправке товары
|
|
||||||
2. **🛒 ТОВАРЫ** - базовые товары от поставщиков
|
|
||||||
- **"На складе"** - готовы к обработке
|
|
||||||
- **"В обработке"** - в процессе создания продукта
|
|
||||||
3. **❌ БРАК** - товары с дефектами, требуют утилизации
|
|
||||||
4. **↩️ ВОЗВРАТЫ С ПВЗ** - возвращенные товары, к обработке
|
|
||||||
5. **🎯 РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для селлеров
|
|
||||||
6. **⚙️ РАСХОДНИКИ ФУЛФИЛМЕНТА** - операционные материалы (КЛИКАБЕЛЬНЫЙ модуль)
|
|
||||||
|
|
||||||
#### 2.2.2 Система учета склада
|
|
||||||
|
|
||||||
**Дополнительные значения** (показатели движения):
|
|
||||||
|
|
||||||
- **ПРИБЫЛО** - количество поступивших на склад за период
|
|
||||||
- **УБЫЛО** - количество списанных со склада за период
|
|
||||||
|
|
||||||
**Основные значения** (текущие остатки):
|
|
||||||
|
|
||||||
- **ФОРМУЛА**: Основные значения = Предыдущие остатки + Прибыло - Убыло
|
|
||||||
- **ОБНОВЛЕНИЕ**: В реальном времени с изменениями за сутки
|
|
||||||
- **ИСТОЧНИК**: GraphQL query `GET_FULFILLMENT_WAREHOUSE_STATS`
|
|
||||||
|
|
||||||
#### 2.2.3 Структура данных склада (3-уровневая иерархия)
|
|
||||||
|
|
||||||
```
|
|
||||||
🔵 УРОВЕНЬ 1: МАГАЗИНЫ
|
|
||||||
├── ТехноМир (синий - blue-400/500)
|
|
||||||
├── Стиль и Комфорт (розовый - pink-400/500)
|
|
||||||
└── Зелёный Дом (изумрудный - emerald-400/500)
|
|
||||||
↓
|
|
||||||
🟢 УРОВЕНЬ 2: ТОВАРЫ (зеленый - green-500)
|
|
||||||
↓
|
|
||||||
🟠 УРОВЕНЬ 3: ВАРИАНТЫ ТОВАРОВ (оранжевый - orange-500)
|
|
||||||
```
|
|
||||||
|
|
||||||
**Цветовое кодирование**:
|
|
||||||
|
|
||||||
- Каждый уровень имеет цветной индикатор увеличивающегося размера
|
|
||||||
- Цветная левая граница с увеличивающимся отступом и толщиной
|
|
||||||
- Скроллбары в цвете уровня
|
|
||||||
- Контрастный цвет текста для читаемости
|
|
||||||
|
|
||||||
#### 2.2.4 Статистика склада
|
|
||||||
|
|
||||||
**6 основных карточек статистики**:
|
|
||||||
|
|
||||||
1. **Продукты** - готовые к отправке
|
|
||||||
2. **Товары** - в обработке
|
|
||||||
3. **Брак** - требует утилизации
|
|
||||||
4. **Возвраты с ПВЗ** - к обработке
|
|
||||||
5. **Расходники селлеров** - материалы клиентов
|
|
||||||
6. **Расходники фулфилмента** - операционные материалы
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 2.3 📦 Поставки фулфилмента (`/fulfillment-supplies`)
|
|
||||||
|
|
||||||
**Компонент**: `SuppliesDashboard`
|
|
||||||
|
|
||||||
#### 2.3.1 Структура: 2 основные вкладки
|
|
||||||
|
|
||||||
**A) 🛒 ПОСТАВКИ ТОВАРОВ**:
|
|
||||||
|
|
||||||
- **Детализированные товары ФФ** - планы и факты поставок с маршрутами
|
|
||||||
- **Товары ФФ** - общие поставки товаров от селлеров
|
|
||||||
- **Возвраты с ПВЗ** - обработка возвращенных товаров
|
|
||||||
|
|
||||||
**B) 🔧 ПОСТАВКИ РАСХОДНИКОВ**:
|
|
||||||
|
|
||||||
- **Заказы расходников** - управление заказами от селлеров
|
|
||||||
- **Расходники селлеров** - материалы для клиентов
|
|
||||||
- **Создание поставок** - формирование новых поставок расходников
|
|
||||||
|
|
||||||
#### 2.3.2 Workflow поставок товаров
|
|
||||||
|
|
||||||
**Этапы обработки**:
|
|
||||||
|
|
||||||
1. **Planned** - поставка запланирована
|
|
||||||
2. **In-transit** - товар в пути
|
|
||||||
3. **Delivered** - доставлен на склад
|
|
||||||
4. **Completed** - обработка завершена
|
|
||||||
|
|
||||||
**Данные поставки**:
|
|
||||||
|
|
||||||
- Номер поставки (ФФ-YYYY-XXX)
|
|
||||||
- Селлер (организация, магазин, менеджер)
|
|
||||||
- Количество позиций и грузовых мест
|
|
||||||
- Объем и стоимость поставки
|
|
||||||
- Ответственный сотрудник и логистика
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 2.4 📊 Статистика фулфилмента (`/fulfillment-statistics`)
|
|
||||||
|
|
||||||
**Компонент**: `FulfillmentStatisticsDashboard`
|
|
||||||
|
|
||||||
#### 2.4.1 Блоки аналитики (сворачиваемые)
|
|
||||||
|
|
||||||
**1. НАКОПЛЕННАЯ СТАТИСТИКА** (`allTime: true`):
|
|
||||||
|
|
||||||
- Обработано товаров (общий объем)
|
|
||||||
- Выявлено брака (всего единиц)
|
|
||||||
- Поставок получено
|
|
||||||
- Общий доход (за все время)
|
|
||||||
- Выполнено заказов (успешных отгрузок)
|
|
||||||
- Удовлетворенность клиентов (средний рейтинг)
|
|
||||||
|
|
||||||
**2. ОТГРУЗКА НА ПЛОЩАДКИ** (`marketplaces: true`):
|
|
||||||
|
|
||||||
- Отправлено на Wildberries
|
|
||||||
- Отправлено на Ozon
|
|
||||||
- Отправлено на другие площадки
|
|
||||||
|
|
||||||
**3. АНАЛИТИКА ПРОИЗВОДИТЕЛЬНОСТИ** (`performance: false`):
|
|
||||||
|
|
||||||
- Среднее время обработки (на единицу товара)
|
|
||||||
- Уровень брака (от общего объема)
|
|
||||||
- Уровень возвратов (возвраты с площадок)
|
|
||||||
- Удовлетворенность клиентов
|
|
||||||
|
|
||||||
**4. МЕТРИКИ СКЛАДА** (`warehouseMetrics: true`):
|
|
||||||
|
|
||||||
- Эффективность склада
|
|
||||||
- Оборачиваемость товаров
|
|
||||||
- Коэффициент использования
|
|
||||||
|
|
||||||
**5. УМНЫЕ РЕКОМЕНДАЦИИ** (`smartRecommendations: true`):
|
|
||||||
|
|
||||||
- Автоматические советы по оптимизации
|
|
||||||
- Предложения по улучшению процессов
|
|
||||||
|
|
||||||
**6. БЫСТРЫЕ ДЕЙСТВИЯ** (`quickActions: true`):
|
|
||||||
|
|
||||||
- Часто используемые операции
|
|
||||||
- Горячие клавиши для действий
|
|
||||||
|
|
||||||
#### 2.4.2 Ключевые показатели в заголовке
|
|
||||||
|
|
||||||
- **Общий доход** (зеленый - success)
|
|
||||||
- **Качество** (синий - X/5.0 рейтинг)
|
|
||||||
- **Уровень брака** (процент от общего объема)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 2.5 🔧 Услуги (`/services`)
|
|
||||||
|
|
||||||
**Компонент**: `ServicesDashboard`
|
|
||||||
**Условие доступа**: `user?.organization?.type === "FULFILLMENT"`
|
|
||||||
|
|
||||||
#### 2.5.1 Структура: 3 обязательные вкладки
|
|
||||||
|
|
||||||
**A) 🛠️ УСЛУГИ** (`defaultValue="services"`):
|
|
||||||
|
|
||||||
- **CRUD операции**: создание, редактирование, удаление услуг
|
|
||||||
- **Управление ценами** и описаниями
|
|
||||||
- **Загрузка изображений** услуг (`imageUrl`)
|
|
||||||
- **GraphQL**: `GET_MY_SERVICES`, `CREATE_SERVICE`, `UPDATE_SERVICE`, `DELETE_SERVICE`
|
|
||||||
|
|
||||||
**B) 🚚 ЛОГИСТИКА**:
|
|
||||||
|
|
||||||
- **Создание маршрутов доставки** (откуда → куда)
|
|
||||||
- **Тарификация**: цена до 1м³ и свыше 1м³
|
|
||||||
- **Группированные локации**:
|
|
||||||
- Мой фулфилмент (название организации)
|
|
||||||
- Рынки (предустановленные)
|
|
||||||
- Склады Wildberries
|
|
||||||
- Склады Ozon
|
|
||||||
- **GraphQL**: `GET_MY_LOGISTICS`, `CREATE_LOGISTICS`, `UPDATE_LOGISTICS`, `DELETE_LOGISTICS`
|
|
||||||
|
|
||||||
**C) 📦 РАСХОДНИКИ**:
|
|
||||||
|
|
||||||
- **Управление расходниками фулфилмента**
|
|
||||||
- **Интеграция с модулем "Услуги"** - селлеры могут использовать в услугах
|
|
||||||
- **Списание со складских остатков** при использовании
|
|
||||||
- **Стоимость включается** в стоимость услуги
|
|
||||||
|
|
||||||
#### 2.5.2 Правила логистики
|
|
||||||
|
|
||||||
**Создание маршрута**:
|
|
||||||
|
|
||||||
- **Обязательные поля**: Название маршрута, Откуда, Куда
|
|
||||||
- **Ценообразование**: Цена до 1м³, Цена свыше 1м³
|
|
||||||
- **Описание услуг**: Дополнительные условия доставки
|
|
||||||
- **Проверка**: Только организации типа FULFILLMENT могут создавать логистику
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 2.6 👥 Сотрудники (`/employees`)
|
|
||||||
|
|
||||||
**Компонент**: `EmployeesDashboard`
|
|
||||||
**Условие доступа**: `user?.organization?.type === "FULFILLMENT"`
|
|
||||||
|
|
||||||
#### 2.6.1 Структура: 2 основные вкладки
|
|
||||||
|
|
||||||
**A) 👥 СОТРУДНИКИ** (`defaultValue="combined"`):
|
|
||||||
|
|
||||||
**Управление персоналом**:
|
|
||||||
|
|
||||||
- **CRUD операции**: создание, редактирование, удаление сотрудников
|
|
||||||
- **Статусы сотрудников**: `ACTIVE`, `VACATION`, `SICK`, `FIRED`
|
|
||||||
- **Формы добавления**: Компактная (`showCompactForm`) / Полная форма
|
|
||||||
- **Поиск и фильтрация** по имени, должности, статусу
|
|
||||||
|
|
||||||
**Табель рабочего времени**:
|
|
||||||
|
|
||||||
- **Навигация по месяцам**: текущий год/месяц с кнопками ←/→
|
|
||||||
- **Отметки по дням**: статус дня и количество отработанных часов
|
|
||||||
- **GraphQL**: `GET_EMPLOYEE_SCHEDULE`, `UPDATE_EMPLOYEE_SCHEDULE`
|
|
||||||
- **Данные**: `{date, hoursWorked, employee: {id}}`
|
|
||||||
|
|
||||||
**B) 📋 ОТЧЕТЫ** (`value="reports"`):
|
|
||||||
|
|
||||||
- **Сводные отчеты** по сотрудникам за период
|
|
||||||
- **Экспорт данных** табеля
|
|
||||||
- **Аналитика рабочего времени**
|
|
||||||
|
|
||||||
#### 2.6.2 Интерфейс сотрудников
|
|
||||||
|
|
||||||
**Обязательные поля сотрудника**:
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
interface Employee {
|
|
||||||
firstName: string; // Имя
|
|
||||||
lastName: string; // Фамилия
|
|
||||||
middleName?: string; // Отчество
|
|
||||||
position: string; // Должность
|
|
||||||
phone: string; // Телефон
|
|
||||||
email?: string; // Email
|
|
||||||
status: "ACTIVE" | "VACATION" | "SICK" | "FIRED";
|
|
||||||
salary?: number; // Зарплата
|
|
||||||
hireDate: string; // Дата найма
|
|
||||||
// ... дополнительные поля
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Валидация данных**:
|
|
||||||
|
|
||||||
- Имя/Фамилия: минимум 2 символа, только буквы/пробелы/дефисы
|
|
||||||
- Телефон: обязательный, формат +7 (999) 123-45-67
|
|
||||||
- Email: валидация формата при заполнении
|
|
||||||
- Должность: минимум 2 символа
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 2.7 🌐 Универсальные разделы
|
|
||||||
|
|
||||||
#### 2.7.1 🛒 Маркет (`/market`)
|
|
||||||
|
|
||||||
- Просмотр товаров всех поставщиков
|
|
||||||
- Создание заказов у поставщиков
|
|
||||||
- Управление корзиной и избранным
|
|
||||||
|
|
||||||
#### 2.7.2 🤝 Партнеры (`/partners`)
|
|
||||||
|
|
||||||
- Управление контрагентами всех типов
|
|
||||||
- Входящие/исходящие заявки на сотрудничество
|
|
||||||
|
|
||||||
#### 2.7.3 💬 Мессенджер (`/messenger`)
|
|
||||||
|
|
||||||
- Внутренняя связь между организациями
|
|
||||||
- Поддержка файлов, изображений, голосовых сообщений
|
|
||||||
|
|
||||||
#### 2.7.4 ⚙️ Настройки (`/settings`)
|
|
||||||
|
|
||||||
- Профиль организации и пользователя
|
|
||||||
- API ключи маркетплейсов (WB, Ozon)
|
|
||||||
- Банковские реквизиты
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 🔒 ПРАВИЛА ДОСТУПА ФУЛФИЛМЕНТА
|
|
||||||
|
|
||||||
### 3.1 Эксклюзивный доступ (только фулфилмент)
|
|
||||||
|
|
||||||
**TypeScript проверки**:
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
{user?.organization?.type === "FULFILLMENT" && (
|
|
||||||
// Компоненты доступны только фулфилменту
|
|
||||||
)}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Эксклюзивные разделы**:
|
|
||||||
|
|
||||||
- **Услуги** (`/services`) - создание услуг, логистики, управление расходниками
|
|
||||||
- **Сотрудники** (`/employees`) - управление персоналом и табелем
|
|
||||||
- **Статистика фулфилмента** (`/fulfillment-statistics`) - детальная аналитика
|
|
||||||
|
|
||||||
### 3.2 Специальная логика роутинга
|
|
||||||
|
|
||||||
**При нажатии "Поставки" в sidebar**:
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const handleSuppliesClick = () => {
|
|
||||||
switch (user?.organization?.type) {
|
|
||||||
case "FULFILLMENT":
|
|
||||||
router.push("/fulfillment-supplies"); // Специальный роут
|
|
||||||
break;
|
|
||||||
case "SELLER":
|
|
||||||
router.push("/supplies");
|
|
||||||
break;
|
|
||||||
// ... другие типы
|
|
||||||
}
|
|
||||||
};
|
|
||||||
```
|
|
||||||
|
|
||||||
### 3.3 GraphQL проверки доступа
|
|
||||||
|
|
||||||
**В Apollo Client запросах**:
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
const { data } = useQuery(GET_MY_SERVICES, {
|
|
||||||
skip: user?.organization?.type !== "FULFILLMENT", // Пропуск для не-фулфилмента
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
**В GraphQL резолверах**:
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// Проверка типа организации на сервере
|
|
||||||
if (currentUser.organization.type !== "FULFILLMENT") {
|
|
||||||
throw new GraphQLError("Доступно только для фулфилмент центров");
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. 📋 КРИТИЧЕСКИЕ ПРАВИЛА ДЛЯ RULES2.MD
|
|
||||||
|
|
||||||
### 4.1 🔴 КРИТИЧЕСКИЕ ПРАВИЛА (обязательны к добавлению)
|
|
||||||
|
|
||||||
#### **ПРАВИЛО FF-01: Структура склада фулфилмента**
|
|
||||||
|
|
||||||
- **ОБЯЗАТЕЛЬНАЯ ПОСЛЕДОВАТЕЛЬНОСТЬ** модулей: ПРОДУКТ→ТОВАР→БРАК→ВОЗВРАТЫ→РАСХОДНИКИ*СЕЛЛЕРОВ→РАСХОДНИКИ*ФУЛФИЛМЕНТА
|
|
||||||
- **ЗАПРЕЩЕНО**: Изменение порядка модулей
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Модуль "Расходники фулфилмента" должен быть кликабельным
|
|
||||||
|
|
||||||
#### **ПРАВИЛО FF-02: Права доступа фулфилмента**
|
|
||||||
|
|
||||||
- **ЭКСКЛЮЗИВНЫЙ ДОСТУП**: Услуги, Сотрудники, Статистика фулфилмента
|
|
||||||
- **ПРОВЕРКА**: `user?.organization?.type === "FULFILLMENT"`
|
|
||||||
- **GraphQL**: `skip: user?.organization?.type !== 'FULFILLMENT'`
|
|
||||||
|
|
||||||
#### **ПРАВИЛО FF-03: Система учета склада**
|
|
||||||
|
|
||||||
- **ДВОЙНОЙ УЧЕТ**: Основные значения + дополнительные значения
|
|
||||||
- **ФОРМУЛА**: Основные = Предыдущие остатки + Прибыло - Убыло
|
|
||||||
- **ОБНОВЛЕНИЕ**: Статистика в реальном времени с изменениями за сутки
|
|
||||||
|
|
||||||
#### **ПРАВИЛО FF-04: Workflow создания продукта**
|
|
||||||
|
|
||||||
- **ПРОЦЕСС**: Товары "на складе" → "в обработке" → ПРОДУКТ "готов к отправке"
|
|
||||||
- **ПЛАН/ФАКТ**: Корректировка статистики при выявлении расхождений
|
|
||||||
- **ОБЯЗАТЕЛЬНО**: Фиксация брака в процессе работы (вкладка "В работе")
|
|
||||||
|
|
||||||
### 4.2 🟡 ВАЖНЫЕ ПРАВИЛА (рекомендуются к добавлению)
|
|
||||||
|
|
||||||
#### **ПРАВИЛО FF-05: Модуль услуг фулфилмента**
|
|
||||||
|
|
||||||
- **СТРУКТУРА**: 3 обязательные вкладки (Услуги, Логистика, Расходники)
|
|
||||||
- **ЛОГИСТИКА**: Создание маршрутов только фулфилментом
|
|
||||||
- **РАСХОДНИКИ**: Интеграция с модулем "Услуги", списание со склада
|
|
||||||
|
|
||||||
#### **ПРАВИЛО FF-06: Управление сотрудниками**
|
|
||||||
|
|
||||||
- **СТАТУСЫ**: 4 обязательных статуса (ACTIVE, VACATION, SICK, FIRED)
|
|
||||||
- **ТАБЕЛЬ**: Месячная навигация с отметками по дням
|
|
||||||
- **ВАЛИДАЦИЯ**: Строгие правила валидации полей сотрудника
|
|
||||||
|
|
||||||
#### **ПРАВИЛО FF-07: Специальный роутинг**
|
|
||||||
|
|
||||||
- **ПОСТАВКИ**: Фулфилмент → `/fulfillment-supplies` (не `/supplies`)
|
|
||||||
- **УСЛОВНОЕ ОТОБРАЖЕНИЕ**: Разные компоненты для разных типов организаций
|
|
||||||
|
|
||||||
### 4.3 🟢 ПОЛЕЗНЫЕ ПРАВИЛА (опциональны)
|
|
||||||
|
|
||||||
#### **ПРАВИЛО FF-08: UI/UX паттерны фулфилмента**
|
|
||||||
|
|
||||||
- **ЦВЕТОВАЯ СХЕМА**: 3-уровневая иерархия с цветовым кодированием
|
|
||||||
- **СВОРАЧИВАЕМЫЕ БЛОКИ**: Статистика с состояниями `expandedSections`
|
|
||||||
- **АДАПТИВНОСТЬ**: `getSidebarMargin()` для responsive design
|
|
||||||
|
|
||||||
#### **ПРАВИЛО FF-09: Статистика и аналитика**
|
|
||||||
|
|
||||||
- **6 ОСНОВНЫХ БЛОКОВ**: Накопленная, Площадки, Производительность, Склад, Рекомендации, Действия
|
|
||||||
- **REAL-TIME**: Обновление каждую минуту (`pollInterval: 60000`)
|
|
||||||
- **КЛЮЧЕВЫЕ ПОКАЗАТЕЛИ**: Доход, Качество, Уровень брака в заголовке
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📎 ПРИЛОЖЕНИЯ
|
|
||||||
|
|
||||||
### Приложение A: GraphQL запросы фулфилмента
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// Основные запросы
|
|
||||||
GET_MY_SERVICES; // Услуги фулфилмента
|
|
||||||
GET_MY_LOGISTICS; // Логистические маршруты
|
|
||||||
GET_MY_EMPLOYEES; // Сотрудники организации
|
|
||||||
GET_FULFILLMENT_WAREHOUSE_STATS; // Статистика склада
|
|
||||||
GET_WAREHOUSE_PRODUCTS; // Товары на складе
|
|
||||||
GET_MY_FULFILLMENT_SUPPLIES; // Расходники фулфилмента
|
|
||||||
|
|
||||||
// Мутации
|
|
||||||
CREATE_SERVICE, UPDATE_SERVICE, DELETE_SERVICE;
|
|
||||||
CREATE_LOGISTICS, UPDATE_LOGISTICS, DELETE_LOGISTICS;
|
|
||||||
CREATE_EMPLOYEE, UPDATE_EMPLOYEE, DELETE_EMPLOYEE;
|
|
||||||
```
|
|
||||||
|
|
||||||
### Приложение B: Компоненты фулфилмента
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// Основные dashboard компоненты
|
|
||||||
FulfillmentWarehouseDashboard; // Склад фулфилмента
|
|
||||||
FulfillmentStatisticsDashboard; // Статистика
|
|
||||||
ServicesDashboard; // Услуги (3 вкладки)
|
|
||||||
EmployeesDashboard; // Сотрудники
|
|
||||||
SuppliesDashboard; // Поставки фулфилмента
|
|
||||||
|
|
||||||
// Специализированные компоненты
|
|
||||||
ServicesTab, LogisticsTab, SuppliesTab; // Вкладки услуг
|
|
||||||
EmployeeInlineForm, EmployeeEditInlineForm; // Формы сотрудников
|
|
||||||
FulfillmentSuppliesTab, FulfillmentConsumablesOrdersTab; // Поставки
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**📅 Создано**: На основе анализа системы Sfera
|
|
||||||
**🎯 Статус**: Готово к интеграции в rules2.md
|
|
||||||
**📝 Версия**: 1.0
|
|
@ -1,22 +1,372 @@
|
|||||||
# ПРАВИЛА СИСТЕМЫ УПРАВЛЕНИЯ СКЛАДАМИ И ПОСТАВКАМИ - ПОЛНАЯ БАЗА ЗНАНИЙ v3.0
|
# ПРАВИЛА СИСТЕМЫ УПРАВЛЕНИЯ СКЛАДАМИ И ПОСТАВКАМИ - ЕДИНЫЙ ИСТОЧНИК ИСТИНЫ v9.1
|
||||||
|
|
||||||
> ⚠️ **ВАЖНОЕ ПРИМЕЧАНИЕ**: Данный файл является объединенной полной базой знаний системы, созданной на основе rules.md, rules1.md и rules2.md. Все изменения должны согласовываться.
|
> ⚠️ **АБСОЛЮТНО ПОЛНЫЙ ЕДИНЫЙ ИСТОЧНИК ИСТИНЫ**: Данный файл объединяет АБСОЛЮТНО ВСЕ правила системы: протоколы работы Claude Code, детальные протоколы по сложности, систему предотвращения нарушений, расширенную самопроверку, специальный UI/UX протокол и бизнес-правила. Визуальные правила вынесены в отдельный файл visual-design-rules.md с автоматической интеграцией.
|
||||||
|
|
||||||
## 🔤 ТЕРМИНЫ СИСТЕМЫ
|
## 🔴 ПРОТОКОЛЫ РАБОТЫ CLAUDE CODE
|
||||||
|
|
||||||
|
### ⛔ ЖЕСТКИЙ ПРОТОКОЛ - ОБЯЗАТЕЛЬНОЕ ИСПОЛНЕНИЕ
|
||||||
|
**Я НЕ МОГУ выполнять НИКАКИХ изменений в коде без предварительного чтения этого файла**
|
||||||
|
|
||||||
|
**КОМАНДА ОСТАНОВКИ**: "СТОП - ЧИТАЙ ПРАВИЛА" - немедленно останавливает любую работу
|
||||||
|
|
||||||
|
### 📋 ОБЯЗАТЕЛЬНЫЙ ЧЕК-ЛИСТ ПЕРЕД КАЖДОЙ ЗАДАЧЕЙ
|
||||||
|
**КАЖДЫЙ ОТВЕТ ДОЛЖЕН НАЧИНАТЬСЯ С:**
|
||||||
|
```
|
||||||
|
## 📋 Чек-лист соответствия правилам:
|
||||||
|
- ✅ Прочитал rules-complete.md
|
||||||
|
- ✅ Задача понята в контексте правил
|
||||||
|
- ✅ План действий соответствует правилам
|
||||||
|
- ✅ [ЕСЛИ UI/UX ЗАДАЧА] Прочитал visual-design-rules.md
|
||||||
|
- ✅ Готов выполнять согласно единому источнику истины
|
||||||
|
```
|
||||||
|
**БЕЗ ЭТОГО ЧЕК-ЛИСТА = НИКАКИХ ДЕЙСТВИЙ**
|
||||||
|
|
||||||
|
### 🔄 ДВУХЭТАПНЫЙ ПРОЦЕСС РАБОТЫ
|
||||||
|
#### **ЭТАП 1: ПЛАНИРОВАНИЕ (ОБЯЗАТЕЛЬНЫЙ)**
|
||||||
|
- Прочитать этот файл правил
|
||||||
|
- Создать детальный план действий
|
||||||
|
- Указать какие правила будут применены
|
||||||
|
- **ОСТАНОВИТЬСЯ И ЖДАТЬ ОДОБРЕНИЯ ПЛАНА**
|
||||||
|
|
||||||
|
#### **ЭТАП 2: ВЫПОЛНЕНИЕ (ТОЛЬКО ПОСЛЕ ОДОБРЕНИЯ)**
|
||||||
|
- Получить одобрение плана от пользователя
|
||||||
|
- Следовать ТОЛЬКО одобренному плану
|
||||||
|
- Использовать TodoWrite для отслеживания прогресса
|
||||||
|
|
||||||
|
**ПРАВИЛО ДВУХЭТАПНОСТИ: БЕЗ ОДОБРЕНИЯ ПЛАНА = НИКАКОГО ВЫПОЛНЕНИЯ**
|
||||||
|
|
||||||
|
## 🛠️ ДЕТАЛЬНЫЕ ПРОТОКОЛЫ ПО СЛОЖНОСТИ ЗАДАЧ
|
||||||
|
|
||||||
|
### 🎯 ПРОТОКОЛ ДЛЯ ЗАДАЧ СРЕДНЕЙ СЛОЖНОСТИ
|
||||||
|
|
||||||
|
**ОПРЕДЕЛЕНИЕ СРЕДНЕЙ СЛОЖНОСТИ:**
|
||||||
|
- Работа с 2-3 файлами
|
||||||
|
- Изменение логики в 1-2 модулях
|
||||||
|
- Добавление новых функций без изменения архитектуры
|
||||||
|
- Задачи, требующие анализа зависимостей
|
||||||
|
|
||||||
|
**ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:**
|
||||||
|
|
||||||
|
#### 1. 🔍 **ЭТАП АНАЛИЗА** (STOP & THINK)
|
||||||
|
```
|
||||||
|
ПЕРЕД НАЧАЛОМ ЗАДАТЬ СЕБЕ:
|
||||||
|
□ Какие файлы нужно изучить? (перечислить ВСЕ)
|
||||||
|
□ Какие правила из этого документа применимы?
|
||||||
|
□ Есть ли зависимости между компонентами?
|
||||||
|
□ Что может пойти не так?
|
||||||
|
□ Нужны ли уточнения от пользователя?
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2. 📋 **СОЗДАНИЕ ПЛАНА**
|
||||||
|
```
|
||||||
|
□ Разбить задачу на подзадачи (не более 5)
|
||||||
|
□ Определить порядок выполнения
|
||||||
|
□ Выявить критические точки
|
||||||
|
□ Создать TODO список
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 3. 🔄 **ВЫПОЛНЕНИЕ С ПРОВЕРКАМИ**
|
||||||
|
```
|
||||||
|
ПОСЛЕ КАЖДОГО ШАГА:
|
||||||
|
□ Соответствует ли результат правилам из этого документа?
|
||||||
|
□ Не нарушены ли связи с другими модулями?
|
||||||
|
□ Работает ли измененный код?
|
||||||
|
□ Нужно ли обновить documentation?
|
||||||
|
```
|
||||||
|
|
||||||
|
### 🔥 ПРОТОКОЛ ДЛЯ ЗАДАЧ ВЫСОКОЙ СЛОЖНОСТИ
|
||||||
|
|
||||||
|
**ОПРЕДЕЛЕНИЕ ВЫСОКОЙ СЛОЖНОСТИ:**
|
||||||
|
- Работа с 4+ файлами
|
||||||
|
- Изменение архитектуры системы
|
||||||
|
- Создание новых модулей/компонентов
|
||||||
|
- Задачи, влияющие на несколько кабинетов
|
||||||
|
- Изменения в правилах или workflow
|
||||||
|
|
||||||
|
**ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:**
|
||||||
|
|
||||||
|
#### 1. 🛑 **СТОП! ГЛУБОКИЙ АНАЛИЗ**
|
||||||
|
```
|
||||||
|
ОБЯЗАТЕЛЬНЫЕ ВОПРОСЫ ПОЛЬЗОВАТЕЛЮ:
|
||||||
|
□ Уточнить ВСЕ требования и ожидания
|
||||||
|
□ Выяснить приоритеты и ограничения
|
||||||
|
□ Узнать о связях с другими системами
|
||||||
|
□ Понять критерии успеха
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2. 🔍 **ИССЛЕДОВАТЕЛЬСКАЯ ФАЗА**
|
||||||
|
```
|
||||||
|
□ Изучить ВСЕ связанные файлы параллельно
|
||||||
|
□ Построить карту зависимостей
|
||||||
|
□ Найти все правила в этом документе
|
||||||
|
□ Выявить потенциальные конфликты
|
||||||
|
□ Проанализировать влияние на систему
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 3. 📊 **СОЗДАНИЕ ДЕТАЛЬНОГО ПЛАНА**
|
||||||
|
```
|
||||||
|
□ Разбить на этапы с промежуточными проверками
|
||||||
|
□ Определить точки возврата (rollback points)
|
||||||
|
□ Создать план тестирования
|
||||||
|
□ Предусмотреть обновление документации
|
||||||
|
```
|
||||||
|
|
||||||
|
### ❓ СИСТЕМА ОБЯЗАТЕЛЬНЫХ УТОЧНЕНИЙ
|
||||||
|
|
||||||
|
#### 🔴 **КРИТИЧЕСКИЕ СИТУАЦИИ** (ОБЯЗАТЕЛЬНО):
|
||||||
|
- Обнаружил противоречие в правилах
|
||||||
|
- Задача может нарушить архитектуру системы
|
||||||
|
- Неясно как применить правило к конкретной ситуации
|
||||||
|
- Есть несколько способов решения с разными последствиями
|
||||||
|
- Изменения затрагивают критические бизнес-процессы
|
||||||
|
|
||||||
|
#### 🟡 **ВАЖНЫЕ СИТУАЦИИ** (РЕКОМЕНДУЕТСЯ):
|
||||||
|
- Задача требует создания новых типов данных
|
||||||
|
- Нужно изменить существующий workflow
|
||||||
|
- Есть сомнения в интерпретации требований
|
||||||
|
- Решение может повлиять на производительность
|
||||||
|
- Требуется интеграция с внешними системами
|
||||||
|
|
||||||
|
**ФОРМАТ УТОЧНЯЮЩИХ ВОПРОСОВ:**
|
||||||
|
```
|
||||||
|
🎯 КОНТЕКСТ: Что именно я делаю
|
||||||
|
❓ ВОПРОС: Что конкретно неясно
|
||||||
|
⚖️ ВАРИАНТЫ: Какие есть альтернативы (если применимо)
|
||||||
|
⚠️ РИСКИ: Что может пойти не так
|
||||||
|
💡 ПРЕДЛОЖЕНИЕ: Мой рекомендуемый подход
|
||||||
|
```
|
||||||
|
|
||||||
|
### 🎨 СПЕЦИАЛЬНЫЙ ПРОТОКОЛ ДЛЯ UI/UX ЗАДАЧ
|
||||||
|
|
||||||
|
**АВТОМАТИЧЕСКАЯ АКТИВАЦИЯ:** При обнаружении ключевых слов: дизайн, интерфейс, компонент, стили, UI, UX, визуал, цвет, кнопка, форма, карточка
|
||||||
|
|
||||||
|
**ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:**
|
||||||
|
|
||||||
|
#### 1. 📖 **ИЗУЧЕНИЕ ВИЗУАЛЬНЫХ ПРАВИЛ**
|
||||||
|
```
|
||||||
|
ОБЯЗАТЕЛЬНО:
|
||||||
|
□ Прочитать visual-design-rules.md
|
||||||
|
□ Найти применимые цветовые схемы
|
||||||
|
□ Проверить правила для конкретного кабинета (селлер/фулфилмент/поставщик/логист)
|
||||||
|
□ Изучить glass-system и UI компоненты
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2. 🎯 **ПРИМЕНЕНИЕ ДИЗАЙН-СИСТЕМЫ**
|
||||||
|
```
|
||||||
|
ПРОВЕРИТЬ:
|
||||||
|
□ Соответствие цветовой палитре (OKLCH)
|
||||||
|
□ Использование glass-эффектов (bg-white/10 backdrop-blur)
|
||||||
|
□ Правильные статусные цвета
|
||||||
|
□ Адаптивность и отзывчивость
|
||||||
|
□ Консистентность с существующими компонентами
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 3. ✅ **ВАЛИДАЦИЯ ДИЗАЙНА**
|
||||||
|
```
|
||||||
|
УБЕДИТЬСЯ:
|
||||||
|
□ Соблюдены принципы иерархии
|
||||||
|
□ Цвета соответствуют функциональному назначению
|
||||||
|
□ Интерфейс доступен и понятен
|
||||||
|
□ Стиль согласован с общей системой
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🚨 СИСТЕМА ПРЕДОТВРАЩЕНИЯ НАРУШЕНИЙ
|
||||||
|
|
||||||
|
### 🛑 ОБЯЗАТЕЛЬНЫЕ ОСТАНОВКИ ПЕРЕД ДЕЙСТВИЯМИ
|
||||||
|
|
||||||
|
#### **СТОП-СИГНАЛ #1: ПЕРЕД ЛЮБЫМ АНАЛИЗОМ КОМПОНЕНТОВ**
|
||||||
|
```
|
||||||
|
❌ ЗАПРЕЩЕНО: Делать предположения о содержании файлов/компонентов
|
||||||
|
✅ ОБЯЗАТЕЛЬНО:
|
||||||
|
1. Использовать поиск для понимания
|
||||||
|
2. Читать файлы для точного содержания
|
||||||
|
3. Только ПОСЛЕ изучения кода - выводы
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **СТОП-СИГНАЛ #2: ПРИ НЕОПРЕДЕЛЕННОСТИ**
|
||||||
|
```
|
||||||
|
❌ ЗАПРЕЩЕНО: Гадать, предполагать, домысливать
|
||||||
|
✅ ОБЯЗАТЕЛЬНО:
|
||||||
|
1. СТОП - зафиксировать неопределенность
|
||||||
|
2. Использовать инструменты анализа (если применимо)
|
||||||
|
3. Задать прямой вопрос пользователю
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **СТОП-СИГНАЛ #3: ПЕРЕД ВЫПОЛНЕНИЕМ СРЕДНИХ/СЛОЖНЫХ ЗАДАЧ**
|
||||||
|
```
|
||||||
|
❌ ЗАПРЕЩЕНО: Сразу приступать к работе
|
||||||
|
✅ ОБЯЗАТЕЛЬНО:
|
||||||
|
1. Применить соответствующий протокол из этого документа
|
||||||
|
2. Создать план через TodoWrite
|
||||||
|
3. Пройти этап самопроверки
|
||||||
|
```
|
||||||
|
|
||||||
|
### 🔒 СИСТЕМА ПРИНУДИТЕЛЬНЫХ ПРОВЕРОК
|
||||||
|
|
||||||
|
#### **ПРОВЕРКА #1: АНАЛИЗ КОДА**
|
||||||
|
```
|
||||||
|
Если задача включает анализ компонентов:
|
||||||
|
□ Использовал ли поиск по кодовой базе?
|
||||||
|
□ Прочитал ли исходный код?
|
||||||
|
□ Основаны ли выводы на фактах, а не предположениях?
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **ПРОВЕРКА #2: СОБЛЮДЕНИЕ ПРОТОКОЛОВ**
|
||||||
|
```
|
||||||
|
Для каждой задачи:
|
||||||
|
□ Определил ли сложность задачи?
|
||||||
|
□ Применил ли соответствующий протокол?
|
||||||
|
□ Создал ли план действий?
|
||||||
|
□ Провел ли финальную самопроверку?
|
||||||
|
```
|
||||||
|
|
||||||
|
### ⚡ СИСТЕМА АВТОМАТИЧЕСКИХ ТРИГГЕРОВ
|
||||||
|
|
||||||
|
#### **ТРИГГЕР #1: При упоминании компонентов**
|
||||||
|
- Ключевые слова: "компонент", "файл", "содержание", "показывает"
|
||||||
|
- Действие: ОБЯЗАТЕЛЬНО использовать инструменты анализа кода
|
||||||
|
|
||||||
|
#### **ТРИГГЕР #2: При неопределенности**
|
||||||
|
- Ключевые фразы: "возможно", "вероятно", "думаю", "предполагаю"
|
||||||
|
- Действие: СТОП + вопрос пользователю
|
||||||
|
|
||||||
|
#### **ТРИГГЕР #3: При работе с UI/UX**
|
||||||
|
- Ключевые слова: "дизайн", "интерфейс", "компонент", "стили", "UI", "UX", "визуал", "цвет", "кнопка", "форма", "карточка"
|
||||||
|
- Действие: ОБЯЗАТЕЛЬНО прочитать visual-design-rules.md перед началом работы
|
||||||
|
|
||||||
|
### 🛡️ СИСТЕМА БЛОКИРОВКИ НАРУШЕНИЙ
|
||||||
|
|
||||||
|
```
|
||||||
|
🛑 ОСТАНОВИТЬСЯ НЕМЕДЛЕННО ЕСЛИ:
|
||||||
|
- Не определил сложность задачи
|
||||||
|
- Пропустил этап "Стоп и подумай"
|
||||||
|
- Есть сомнения в правилах
|
||||||
|
- Не проверил все применимые разделы этого документа
|
||||||
|
- Не уведомил о важных изменениях
|
||||||
|
```
|
||||||
|
|
||||||
|
## ✅ РАСШИРЕННАЯ СИСТЕМА САМОПРОВЕРКИ
|
||||||
|
|
||||||
|
### 🛑 ОБЯЗАТЕЛЬНЫЙ ПРОТОКОЛ ПЕРЕД КАЖДОЙ ЗАДАЧЕЙ
|
||||||
|
|
||||||
|
#### **ШАГ 1: ОПРЕДЕЛЕНИЕ СЛОЖНОСТИ И ПРОТОКОЛА**
|
||||||
|
```
|
||||||
|
ВОПРОСЫ:
|
||||||
|
- Сколько файлов затрагивает задача? (1-3 = средняя, 4+ = высокая)
|
||||||
|
- Изменяется ли архитектура или workflow? (да = высокая)
|
||||||
|
- Влияет ли на критические бизнес-процессы? (да = высокая)
|
||||||
|
|
||||||
|
ДЕЙСТВИЕ: Применить соответствующий протокол из этого документа
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **ШАГ 2: ЭТАП "СТОП И ПОДУМАЙ"**
|
||||||
|
```
|
||||||
|
ОБЯЗАТЕЛЬНЫЕ ВОПРОСЫ:
|
||||||
|
- Какие правила из этого документа применимы?
|
||||||
|
- Какие файлы нужно изучить? (перечислить ВСЕ)
|
||||||
|
- Есть ли неопределенности, требующие уточнения?
|
||||||
|
- Что может пойти не так?
|
||||||
|
|
||||||
|
ДЕЙСТВИЕ: Составить план с промежуточными проверками
|
||||||
|
```
|
||||||
|
|
||||||
|
### 📊 ФИНАЛЬНАЯ МЕГА-ПРОВЕРКА
|
||||||
|
|
||||||
|
```
|
||||||
|
МЕГА-ВОПРОС К СЕБЕ:
|
||||||
|
"Применил ли я правильный протокол, проверил ли все правила,
|
||||||
|
задал ли нужные вопросы, готов ли результат к production?"
|
||||||
|
|
||||||
|
ЕСЛИ ОТВЕТ НЕ "ДА 100%" - ВЕРНУТЬСЯ К НАЧАЛУ!
|
||||||
|
```
|
||||||
|
|
||||||
|
### 📈 МЕТРИКИ УСПЕХА
|
||||||
|
```
|
||||||
|
ЦЕЛЬ: 0 пропущенных критических деталей
|
||||||
|
|
||||||
|
ИЗМЕРЕНИЕ:
|
||||||
|
✅ Количество вопросов на уточнение
|
||||||
|
✅ Полнота анализа источников
|
||||||
|
✅ Отсутствие нарушений правил
|
||||||
|
```
|
||||||
|
|
||||||
|
## ⚡ БЫСТРЫЙ СПРАВОЧНИК
|
||||||
|
|
||||||
|
### 🚨 КРИТИЧЕСКИЕ ПРАВИЛА (ОБЯЗАТЕЛЬНЫ К СОБЛЮДЕНИЮ)
|
||||||
|
|
||||||
|
1. **🔴 ТИПИЗАЦИЯ**: Каждый предмет ОБЯЗАТЕЛЬНО имеет тип: `PRODUCT`, `CONSUMABLE`, `DEFECT`, `FINISHED_PRODUCT`
|
||||||
|
2. **🔴 WORKFLOW**: Нельзя пропускать статусы поставок: PENDING → SUPPLIER_APPROVED → CONFIRMED → ... → DELIVERED
|
||||||
|
3. **🔴 ДОСТУП**: Фулфилмент = полный доступ, Селлер ≠ доступ к чужим данным, Брак = ЗАПРЕЩЕН к заказу
|
||||||
|
4. **🔴 ПАРТНЕРСТВО**: Все связи через модель `Counterparty`, поставщики в формах ТОЛЬКО из партнеров `WHOLESALE`
|
||||||
|
5. **🔴 ФИЛЬТРАЦИЯ**: По типу предмета происходит в GraphQL резолверах, НЕ на фронтенде
|
||||||
|
|
||||||
|
### 🔍 БЫСТРЫЙ ПОИСК ПО ТЕМАМ
|
||||||
|
|
||||||
|
| Тема | Раздел | Ключевые понятия |
|
||||||
|
|------|--------|------------------|
|
||||||
|
| **Типы предметов** | [2](#2--типизация-предметов) | PRODUCT, CONSUMABLE, DEFECT, FINISHED_PRODUCT |
|
||||||
|
| **Кабинет фулфилмента** | [11](#11--кабинет-фулфилмента-полная-документация) | Склад, Услуги, Сотрудники, 6 модулей |
|
||||||
|
| **Workflow поставок** | [5](#5--workflow-поставок) | 8 статусов, уведомления, логистика |
|
||||||
|
| **GraphQL запросы** | [18](#18--graphql-и-typescript-правила), [24](#24--технические-приложения) | Резолверы, мутации, типизация |
|
||||||
|
| **Система партнерства** | [13](#13--система-партнерства-и-контрагентов) | Counterparty, WHOLESALE, заявки |
|
||||||
|
| **Критические запреты** | [17](#17--критические-запреты) | Что НЕЛЬЗЯ делать в системе |
|
||||||
|
|
||||||
|
### 🎯 ДЛЯ РАЗНЫХ РОЛЕЙ
|
||||||
|
|
||||||
|
**👩💻 РАЗРАБОТЧИКИ**: Разделы [18](#18--graphql-и-typescript-правила), [19](#19--архитектурные-принципы), [20](#20--правила-качества-кода), [24](#24--технические-приложения)
|
||||||
|
**📊 АНАЛИТИКИ**: Разделы [15](#15--статистика-и-аналитика), [6](#6--процесс-создания-продукта), [7](#7--система-учета-движения-товаров)
|
||||||
|
**👔 МЕНЕДЖЕРЫ**: Разделы [1](#1--основные-принципы-системы), [3](#3--структура-кабинетов), [5](#5--workflow-поставок)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔤 ГЛОССАРИЙ ТЕРМИНОВ
|
||||||
> Для людей → `В коде`
|
> Для людей → `В коде`
|
||||||
- ТОВАР → `PRODUCT`
|
|
||||||
- РАСХОДНИКИ → `CONSUMABLE`
|
### **ТИПЫ ПРЕДМЕТОВ:**
|
||||||
- БРАК → `DEFECT` *(планируется)*
|
- **ТОВАР** → `PRODUCT` - базовый товар от поставщика, может стать продуктом или браком
|
||||||
- ПРОДУКТ → `FINISHED_PRODUCT` *(планируется)*
|
- **РАСХОДНИКИ** → `CONSUMABLE` - материалы, классифицируются по назначению при использовании (операционные/производственные)
|
||||||
- ПОСТАВЩИК → `WHOLESALE`
|
- **БРАК** → `DEFECT` *(НЕ РЕАЛИЗОВАНО)* - функционал брака еще не внедрен в систему
|
||||||
- СЕЛЛЕР → `SELLER`
|
- **ПРОДУКТ** → `FINISHED_PRODUCT` *(планируется)* - готовый товар, создается из товара по рецептуре
|
||||||
- ФУЛФИЛМЕНТ → `FULFILLMENT`
|
|
||||||
- ЛОГИСТИКА → `LOGIST`
|
### **ТИПЫ ОРГАНИЗАЦИЙ:**
|
||||||
|
- **ПОСТАВЩИК** → `WHOLESALE` - создает товары и расходники, обрабатывает заказы
|
||||||
|
- **СЕЛЛЕР** → `SELLER` - заказывает товары, создает поставки на маркетплейсы
|
||||||
|
- **ФУЛФИЛМЕНТ** → `FULFILLMENT` - обрабатывает товары, создает продукты, максимальные права
|
||||||
|
- **ЛОГИСТИКА** → `LOGIST` - управляет доставками, подтверждает транспортировку
|
||||||
|
|
||||||
|
### 2.2 Правила создания предметов по ролям
|
||||||
|
|
||||||
|
**КТО МОЖЕТ СОЗДАВАТЬ:**
|
||||||
|
- **ПОСТАВЩИК** (`WHOLESALE`): Товары (`PRODUCT`) и Расходники (`CONSUMABLE`)
|
||||||
|
- **ФУЛФИЛМЕНТ** (`FULFILLMENT`): Продукты (`FINISHED_PRODUCT`) - только из существующих товаров
|
||||||
|
- **СЕЛЛЕР/ЛОГИСТ**: НЕ МОГУТ создавать предметы
|
||||||
|
|
||||||
|
**КТО МОЖЕТ ПОКУПАТЬ:**
|
||||||
|
- **СЕЛЛЕР** (`SELLER`):
|
||||||
|
- Товары и расходники у поставщиков
|
||||||
|
- Расходники фулфилмента у фулфилмента (через рецептуру в поставке)
|
||||||
|
- **ФУЛФИЛМЕНТ** (`FULFILLMENT`): Товары и расходники у поставщиков
|
||||||
|
- **ПОСТАВЩИК/ЛОГИСТ**: НЕ МОГУТ покупать предметы
|
||||||
|
|
||||||
|
**ЭКОНОМИЧЕСКИЙ УЧЕТ:**
|
||||||
|
- Когда селлер выбирает расходники фулфилмента в рецептуре, это формирует экономические данные:
|
||||||
|
- В кабинете селлера: расход на расходники фулфилмента
|
||||||
|
- В кабинете фулфилмента: доход от продажи расходников селлеру
|
||||||
|
|
||||||
|
### **КЛЮЧЕВЫЕ СУЩНОСТИ:**
|
||||||
|
- **Контрагент** → `Counterparty` - связь между организациями для партнерства
|
||||||
|
- **Поставка** → `SupplyOrder` - заказ товаров/расходников с workflow статусами
|
||||||
|
- **Рецептура** - состав продукта: товар + услуги + расходники (задается селлером)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📑 ОГЛАВЛЕНИЕ
|
## 📑 ОГЛАВЛЕНИЕ
|
||||||
|
|
||||||
|
> 📋 **ЧТО ОБЪЕДИНЕНО**:
|
||||||
|
> - rules-unified.md (v3.0) - общая база знаний системы
|
||||||
|
> - fulfillment-cabinet-rules.md (v1.0) - детализация кабинета фулфилмента
|
||||||
|
> - Устранены все несоответствия в терминах, последовательностях и детализации
|
||||||
|
|
||||||
### 🏗️ **АРХИТЕКТУРА И ОСНОВЫ**
|
### 🏗️ **АРХИТЕКТУРА И ОСНОВЫ**
|
||||||
|
|
||||||
1. [🎯 Основные принципы системы](#1--основные-принципы-системы)
|
1. [🎯 Основные принципы системы](#1--основные-принципы-системы)
|
||||||
@ -61,24 +411,13 @@
|
|||||||
22. [📋 Категории товаров и расходников](#22--категории-товаров-и-расходников)
|
22. [📋 Категории товаров и расходников](#22--категории-товаров-и-расходников)
|
||||||
23. [🎖️ Приоритеты разработки](#23--приоритеты-разработки)
|
23. [🎖️ Приоритеты разработки](#23--приоритеты-разработки)
|
||||||
|
|
||||||
### 🌐 **ИНТЕГРАЦИИ И ФУНКЦИИ**
|
### 🚨 **КРИТИЧЕСКИЕ СИТУАЦИИ**
|
||||||
|
|
||||||
14. [🌐 Интеграции с системой](#14--интеграции-с-системой)
|
24. [🚨 Критические ситуации и Edge Cases](#-критические-ситуации-и-edge-cases)
|
||||||
15. [📊 Статистика и аналитика](#15--статистика-и-аналитика)
|
|
||||||
16. [📱 Правила UI/UX и интерфейса](#16--правила-uiux-и-интерфейса)
|
|
||||||
17. [⚠️ Критические запреты](#17--критические-запреты)
|
|
||||||
|
|
||||||
### 🛠️ **ТЕХНИЧЕСКИЕ ПРАВИЛА**
|
### 📎 **ТЕХНИЧЕСКИЕ ПРИЛОЖЕНИЯ**
|
||||||
|
|
||||||
18. [🛠️ GraphQL и TypeScript правила](#18--graphql-и-typescript-правила)
|
25. [📎 Технические приложения (GraphQL, компоненты)](#24--технические-приложения)
|
||||||
19. [🔧 Архитектурные принципы](#19--архитектурные-принципы)
|
|
||||||
20. [🎯 Правила качества кода](#20--правила-качества-кода)
|
|
||||||
21. [🔍 Диагностика и решение проблем](#21--диагностика-и-решение-проблем)
|
|
||||||
|
|
||||||
### 📋 **ПРИЛОЖЕНИЯ**
|
|
||||||
|
|
||||||
22. [📋 Категории товаров и расходников](#22--категории-товаров-и-расходников)
|
|
||||||
23. [🎖️ Приоритеты разработки](#23--приоритеты-разработки)
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -127,8 +466,9 @@
|
|||||||
- **ТОВАР** (`PRODUCT`) - базовые товары от поставщиков (принятые на склад)
|
- **ТОВАР** (`PRODUCT`) - базовые товары от поставщиков (принятые на склад)
|
||||||
- **БРАК** (`DEFECT` - планируется) - производная от товара (товар с дефектами)
|
- **БРАК** (`DEFECT` - планируется) - производная от товара (товар с дефектами)
|
||||||
- **ПРОДУКТ** (`FINISHED_PRODUCT` - планируется) - готовый к продаже товар
|
- **ПРОДУКТ** (`FINISHED_PRODUCT` - планируется) - готовый к продаже товар
|
||||||
- **РАСХОДНИКИ ФУЛФИЛМЕНТА** - операционные материалы фулфилмента
|
- **РАСХОДНИКИ (`CONSUMABLE`)** - единый базовый тип, классифицируется по назначению при использовании:
|
||||||
- **РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для товаров селлеров
|
- **"Операционные расходники"** - используются фулфилментом для выполнения услуг
|
||||||
|
- **"Производственные расходники"** - используются в рецептурах селлеров для создания продуктов
|
||||||
|
|
||||||
**🛍️ КАБИНЕТ СЕЛЛЕРА** - заказывает и управляет поставками:
|
**🛍️ КАБИНЕТ СЕЛЛЕРА** - заказывает и управляет поставками:
|
||||||
- Создает заказы товаров и расходников
|
- Создает заказы товаров и расходников
|
||||||
@ -170,7 +510,7 @@
|
|||||||
#### **3. БРАК** (`DEFECT` - планируется, производная от товара)
|
#### **3. БРАК** (`DEFECT` - планируется, производная от товара)
|
||||||
|
|
||||||
- **БУДЕТ СОЗДАВАТЬСЯ**: Фулфилментом на основе существующего ТОВАРА при обнаружении дефектов
|
- **БУДЕТ СОЗДАВАТЬСЯ**: Фулфилментом на основе существующего ТОВАРА при обнаружении дефектов
|
||||||
- **МОМЕНТ СОЗДАНИЯ**: В процессе "Создание продукта" / "В работе" после подсчета факта
|
- **МОМЕНТ СОЗДАНИЯ**: В процессе обработки товара (ШАГ 3 алгоритма создания продукта) при выявлении брака
|
||||||
- **СВЯЗЬ**: Обязательная связь с родительским товаром (parentId)
|
- **СВЯЗЬ**: Обязательная связь с родительским товаром (parentId)
|
||||||
- **ЗАКАЗ**: ЗАПРЕЩЕН заказ брака
|
- **ЗАКАЗ**: ЗАПРЕЩЕН заказ брака
|
||||||
- **СТАТУС**: Всегда неактивен для заказа
|
- **СТАТУС**: Всегда неактивен для заказа
|
||||||
@ -293,6 +633,8 @@ if (currentUser.organization.type !== "FULFILLMENT") {
|
|||||||
|
|
||||||
## 5. 🚚 WORKFLOW ПОСТАВОК
|
## 5. 🚚 WORKFLOW ПОСТАВОК
|
||||||
|
|
||||||
|
> 📌 **ВИЗУАЛЬНЫЕ ПРАВИЛА**: См. [visual-design-rules.md - Статусы поставок](#142-статусы-поставок---расширенная-цветовая-система)
|
||||||
|
|
||||||
### 5.1 Детализированная система статусов
|
### 5.1 Детализированная система статусов
|
||||||
|
|
||||||
**Статусы SupplyOrder (Заказ поставки):**
|
**Статусы SupplyOrder (Заказ поставки):**
|
||||||
@ -348,61 +690,171 @@ if (currentUser.organization.type !== "FULFILLMENT") {
|
|||||||
|
|
||||||
## 6. 🔄 ПРОЦЕСС СОЗДАНИЯ ПРОДУКТА
|
## 6. 🔄 ПРОЦЕСС СОЗДАНИЯ ПРОДУКТА
|
||||||
|
|
||||||
### 6.1 Workflow создания продукта
|
> 📌 **СВЯЗАННЫЕ РАЗДЕЛЫ**:
|
||||||
|
> - Типы предметов → См. [раздел 2.2](#22-обязательные-поля-карточки)
|
||||||
|
> - Склад фулфилмента → См. [раздел 11.2](#112-структура-раздела-склад-фулфилмента)
|
||||||
|
> - Статистика движения → См. [раздел 7](#7--система-учета-движения-товаров)
|
||||||
|
|
||||||
**ЭТАПЫ ПРОЦЕССА:**
|
### 6.1 Пошаговый алгоритм создания продукта
|
||||||
|
|
||||||
1. **ПОСТУПЛЕНИЕ**: Товар приходит на склад фулфилмента (статус "на складе")
|
> 📌 **ВИЗУАЛЬНЫЕ ПРАВИЛА**: См. [visual-design-rules.md - Процесс создания продукта](#143-процесс-создания-продукта---визуальный-workflow)
|
||||||
2. **СОРТИРОВКА**: Перебор товара, отсеивание брака
|
|
||||||
3. **ПОДГОТОВКА К РАБОТЕ**: Менеджер задает параметры работы
|
|
||||||
4. **ОБРАБОТКА**: Превращение товара в продукт по "рецептуре" селлера
|
|
||||||
5. **ЗАВЕРШЕНИЕ**: Готовый продукт (статус "готов к отправке")
|
|
||||||
|
|
||||||
### 6.2 Управление процессом
|
#### **ПРЕДВАРИТЕЛЬНОЕ УСЛОВИЕ: РЕЦЕПТУРА ЗАДАНА** (селлер)
|
||||||
|
```
|
||||||
|
Время: при создании заявки на поставку
|
||||||
|
Действие: селлер указывает рецептуру продукта
|
||||||
|
Обязательные компоненты:
|
||||||
|
✓ Базовый товар (от поставщика)
|
||||||
|
✓ Услуги фулфилмента (упаковка, маркировка и т.д.)
|
||||||
|
✓ Расходники (материалы для производства)
|
||||||
|
Результат: рецептура сохраняется в заявке и передается фулфилменту
|
||||||
|
```
|
||||||
|
|
||||||
**РАЗДЕЛ "СОЗДАНИЕ ПРОДУКТА":**
|
#### **ШАГ 1: ПОСТУПЛЕНИЕ НА СКЛАД** (автоматически)
|
||||||
|
```
|
||||||
|
Время: при смене статуса поставки DELIVERED
|
||||||
|
Действие: товар переходит в статус "на складе"
|
||||||
|
Ответственный: система
|
||||||
|
Результат: +Прибыло в статистике товаров
|
||||||
|
```
|
||||||
|
|
||||||
- **НОВЫЕ**: Поставки после нажатия "принято", ожидающие назначения
|
#### **ШАГ 2: ПЛАНИРОВАНИЕ РАБОТЫ** (менеджер фулфилмента)
|
||||||
- **В РАБОТЕ**: Поставки в процессе обработки
|
```
|
||||||
- **ВЫПОЛНЕНО**: Завершенные поставки с готовыми продуктами
|
Время: в течение 2 рабочих дней после поступления
|
||||||
|
Действие: назначение параметров обработки
|
||||||
|
Ответственный: менеджер фулфилмента
|
||||||
|
Обязательные поля:
|
||||||
|
✓ Дедлайн выполнения (не более 5 рабочих дней)
|
||||||
|
✓ Ответственный исполнитель (из списка сотрудников)
|
||||||
|
✓ Рецептура (товар + услуги + расходники, указанная селлером в заявке на поставку)
|
||||||
|
Опциональные поля:
|
||||||
|
- Место хранения готовых продуктов (зона склада, стеллаж, ячейка)
|
||||||
|
- Комментарии к работе
|
||||||
|
Результат: поставка переходит во вкладку "В работе"
|
||||||
|
```
|
||||||
|
|
||||||
**ДЕЙСТВИЯ МЕНЕДЖЕРА В "НОВЫЕ":**
|
#### **ШАГ 3: ОБРАБОТКА ТОВАРА** (исполнитель)
|
||||||
|
```
|
||||||
|
Время: согласно дедлайну (обычно 1-3 дня)
|
||||||
|
Действие: физическая обработка товара
|
||||||
|
Ответственный: назначенный сотрудник
|
||||||
|
Обязательные действия:
|
||||||
|
1. Проверка качества товара
|
||||||
|
2. Фиксация фактического количества
|
||||||
|
3. Выявление и учет брака
|
||||||
|
4. Применение рецептуры (услуги + расходники)
|
||||||
|
5. Создание готового продукта
|
||||||
|
Точки контроля:
|
||||||
|
- Соответствие плану/факту
|
||||||
|
- Качество выполнения услуг
|
||||||
|
- Расход материалов по норме
|
||||||
|
|
||||||
- **ДЕДЛАЙН**: Указание срока выполнения работы
|
УЧЕТ ПЛАН/ФАКТ:
|
||||||
- **ОТВЕТСТВЕННЫЙ**: Назначение исполнителя
|
- ПЛАН: Количество товаров из поставки селлера (указано в заказе)
|
||||||
- **МЕСТО ХРАНЕНИЯ**: Указание локации для готовых продуктов (опционально)
|
- ФАКТ: Реальное количество после обработки = Брак + Хороший товар
|
||||||
- **ЗАПУСК**: Нажатие кнопки "В работе"
|
- ДЕТАЛИЗАЦИЯ: Учет ведется по каждому размеру/объему/варианту
|
||||||
|
- КОРРЕКТИРОВКА: Статистика автоматически обновляется на фактические данные
|
||||||
|
```
|
||||||
|
|
||||||
### 6.3 Рецептура продукта
|
#### **ШАГ 4: КОНТРОЛЬ КАЧЕСТВА** (менеджер/отдел качества)
|
||||||
|
```
|
||||||
|
Время: сразу после завершения ШАГ 3
|
||||||
|
Действие: приемка готовой продукции
|
||||||
|
Ответственный: менеджер или контролер качества
|
||||||
|
Критерии приемки:
|
||||||
|
✓ Соответствие рецептуре селлера
|
||||||
|
✓ Качество выполненных услуг
|
||||||
|
✓ Правильность упаковки/маркировки
|
||||||
|
✓ Полнота комплектации
|
||||||
|
Результат: продукт готов к отправке или отправлен на доработку
|
||||||
|
```
|
||||||
|
|
||||||
**СЕЛЛЕР УКАЗЫВАЕТ В ПОСТАВКЕ:**
|
#### **ШАГ 5: ЗАВЕРШЕНИЕ** (система + менеджер)
|
||||||
|
```
|
||||||
|
Время: после успешного прохождения контроля качества
|
||||||
|
Действие: финализация процесса
|
||||||
|
Автоматические действия:
|
||||||
|
- Создание записи FINISHED_PRODUCT в БД
|
||||||
|
- Обновление статистики: товар "на складе" → продукт "готов"
|
||||||
|
- Списание использованных расходников
|
||||||
|
- Уведомление селлера о готовности
|
||||||
|
Ручные действия менеджера:
|
||||||
|
- Подтверждение перехода во вкладку "Выполнено"
|
||||||
|
- Указание фактических расходов материалов
|
||||||
|
- Добавление комментариев о выполненной работе
|
||||||
|
```
|
||||||
|
|
||||||
- **БАЗОВЫЙ ТОВАР**: Исходный материал (например, футболка)
|
### 6.2 Временные рамки и SLA
|
||||||
- **УСЛУГА ФУЛФИЛМЕНТА**: Из каталога услуг (например, "погладить")
|
|
||||||
- **РАСХОДНИК СЕЛЛЕРА**: Материалы селлера (например, фирменный пакет)
|
|
||||||
- **РАСХОДНИК ФУЛФИЛМЕНТА**: Материалы фулфилмента (например, короб + маркировка)
|
|
||||||
|
|
||||||
**РЕЗУЛЬТАТ**: ПРОДУКТ = Товар + Услуга + Расходники
|
| Этап | Стандартное время | Максимальное время | Ответственный |
|
||||||
|
|------|------------------|-------------------|---------------|
|
||||||
|
| Планирование | 1 рабочий день | 2 рабочих дня | Менеджер ФФ |
|
||||||
|
| Обработка | 2-3 рабочих дня | 5 рабочих дней | Исполнитель |
|
||||||
|
| Контроль качества | 4 часа | 1 рабочий день | Отдел качества |
|
||||||
|
| Завершение | 2 часа | 4 часа | Менеджер ФФ |
|
||||||
|
|
||||||
### 6.4 Учет план/факт в процессе работы
|
### 6.3 Управление браком и расхождениями
|
||||||
|
|
||||||
|
### 6.4 Детальная рецептура продукта
|
||||||
|
|
||||||
|
**РЕЦЕПТУРА ПРОДУКТА** (задается селлером при создании поставки):
|
||||||
|
|
||||||
|
- **БАЗОВЫЙ ТОВАР**: Исходный материал (обязательно)
|
||||||
|
- Артикул товара
|
||||||
|
- Количество единиц
|
||||||
|
- Размерная сетка (если применимо)
|
||||||
|
|
||||||
|
- **УСЛУГА ФУЛФИЛМЕНТА**: Из каталога услуг фулфилмента
|
||||||
|
- Тип услуги (глажка, упаковка, маркировка и т.д.)
|
||||||
|
- Количество применений
|
||||||
|
- Специальные требования
|
||||||
|
|
||||||
|
- **РАСХОДНИК СЕЛЛЕРА**: Материалы селлера (опционально)
|
||||||
|
- Фирменная упаковка
|
||||||
|
- Этикетки, бирки
|
||||||
|
- Дополнительные аксессуары
|
||||||
|
|
||||||
|
- **РАСХОДНИК ФУЛФИЛМЕНТА**: Материалы фулфилмента (опционально)
|
||||||
|
- Стандартная упаковка
|
||||||
|
- Защитные материалы
|
||||||
|
- Маркировочные элементы
|
||||||
|
|
||||||
|
- **СВЯЗЬ С МАРКЕТПЛЕЙСОМ**: Привязка к карточке (опционально)
|
||||||
|
- ID карточки на маркетплейсе
|
||||||
|
- Артикул маркетплейса
|
||||||
|
- Особые требования МП
|
||||||
|
|
||||||
|
**ФОРМУЛА**: ПРОДУКТ = Товар + Услуга(и) + Расходники селлера + Расходники ФФ
|
||||||
|
|
||||||
|
### 6.5 Учет план/факт в процессе работы (без брака)
|
||||||
|
|
||||||
**ПЛАН**: Количество товара из поставки селлера
|
**ПЛАН**: Количество товара из поставки селлера
|
||||||
**ФАКТ**: Реальное количество после сортировки
|
**ФАКТ**: Реальное количество после пересчета (работник фулфилмента производит сортировку при пересчете)
|
||||||
|
|
||||||
**ФИКСАЦИЯ БРАКА:**
|
**ФИКСАЦИЯ ПОТЕРЬ:**
|
||||||
- **КОГДА**: В процессе работы (вкладка "В работе")
|
- **КОГДА**: В процессе работы (вкладка "В работе")
|
||||||
- **КТО**: Ответственный исполнитель
|
- **ЧТО**: Недостача, повреждения (без создания записей брака)
|
||||||
- **ДЕТАЛИЗАЦИЯ**: По каждому предмету (размер/объем)
|
- **КАК**: Корректировка количества в статистике
|
||||||
- **ОБНОВЛЕНИЕ**: Можно вносить изменения до нажатия "Выполнено"
|
|
||||||
|
**WORKFLOW СОЗДАНИЯ ПРОДУКТА:**
|
||||||
|
1. Товар поступает на склад фулфилмента (статус "на складе")
|
||||||
|
2. Товар берется в работу (переход в статус "в обработке")
|
||||||
|
3. Исполнитель производит пересчет и сортировку
|
||||||
|
4. Создается готовый продукт (тип FINISHED_PRODUCT)
|
||||||
|
5. Продукт готов к отправке на маркетплейсы
|
||||||
|
|
||||||
**ВЛИЯНИЕ НА СТАТИСТИКУ:**
|
**ВЛИЯНИЕ НА СТАТИСТИКУ:**
|
||||||
- При принятии поставки: +План в статистику
|
- При принятии поставки: +План в статистику
|
||||||
- При выявлении факта: корректировка на реальные данные
|
- При выявлении факта: корректировка на реальные данные
|
||||||
- **ФОРМУЛА**: Факт = Брак + Хороший товар
|
- **ФОРМУЛА**: Факт = Потери + Хороший товар
|
||||||
|
*Где потери - это недостача/повреждения, выявленные при пересчете и сортировке*
|
||||||
- **ЛОГИКА**: Фактическое количество = сумма всех пересчитанных предметов
|
- **ЛОГИКА**: Фактическое количество = сумма всех пересчитанных предметов
|
||||||
|
- **ПЛАН/ФАКТ**: Корректировка статистики при выявлении расхождений
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
> 🚧 **БУДУЩАЯ ФУНКЦИОНАЛЬНОСТЬ**: Система статусов товаров в фулфилменте будет детализирована позже
|
||||||
|
|
||||||
## 7. 📊 СИСТЕМА УЧЕТА ДВИЖЕНИЯ ТОВАРОВ
|
## 7. 📊 СИСТЕМА УЧЕТА ДВИЖЕНИЯ ТОВАРОВ
|
||||||
|
|
||||||
### 7.1 Принципы учета в фулфилменте
|
### 7.1 Принципы учета в фулфилменте
|
||||||
@ -531,6 +983,8 @@ const handleSuppliesClick = () => {
|
|||||||
|
|
||||||
## 9. 🏠 КАБИНЕТ СЕЛЛЕРА (ДЕТАЛЬНЫЕ ПРАВИЛА)
|
## 9. 🏠 КАБИНЕТ СЕЛЛЕРА (ДЕТАЛЬНЫЕ ПРАВИЛА)
|
||||||
|
|
||||||
|
> 📌 **ВИЗУАЛЬНЫЕ ПРАВИЛА**: См. [visual-design-rules.md - Кабинет селлера](#145-кабинет-селлера)
|
||||||
|
|
||||||
### 9.1 Структура раздела "Мои поставки"
|
### 9.1 Структура раздела "Мои поставки"
|
||||||
|
|
||||||
#### **🏢 ПОСТАВКИ НА ФУЛФИЛМЕНТ**:
|
#### **🏢 ПОСТАВКИ НА ФУЛФИЛМЕНТ**:
|
||||||
@ -545,16 +999,76 @@ const handleSuppliesClick = () => {
|
|||||||
- **Wildberries** - прямые поставки на WB
|
- **Wildberries** - прямые поставки на WB
|
||||||
- **Ozon** - прямые поставки на Ozon
|
- **Ozon** - прямые поставки на Ozon
|
||||||
|
|
||||||
### 9.2 Правила кнопки "Создать поставку" в разделе "Мои поставки"
|
### 9.2 UI структура создания поставки расходников селлера
|
||||||
|
|
||||||
#### **9.2.1 Общие принципы**
|
#### **📄 Структура страницы создания поставки:**
|
||||||
|
|
||||||
|
**БЛОК 1: ПОСТАВЩИКИ** _(верхняя часть экрана)_
|
||||||
|
- **Отображение**: Карточки поставщиков из раздела "Партнеры"
|
||||||
|
- **Навигация**: Горизонтальный скролл (слева-направо) при превышении ширины экрана
|
||||||
|
- **Выбор**: Клик выделяет карточку поставщика
|
||||||
|
- **Результат**: Загружаются расходники выбранного поставщика в блок 2
|
||||||
|
|
||||||
|
**БЛОК 2: РАСХОДНИКИ** _(центральная часть)_
|
||||||
|
- **Содержание**: Расходники выбранного поставщика
|
||||||
|
- **Сортировка**: По цене, названию, категории
|
||||||
|
- **Фильтры**: По категории, ценовому диапазону
|
||||||
|
- **Карточка расходника**:
|
||||||
|
- Фото, название, цена, остаток, категория
|
||||||
|
- Количество в комплекте (если есть комплектность)
|
||||||
|
- Поле ввода количества (единицы или комплекты)
|
||||||
|
- Кнопки +/- для изменения количества
|
||||||
|
- **Действие**: Клик добавляет расходник в корзину
|
||||||
|
|
||||||
|
**БЛОК 3: КОРЗИНА** _(правая часть)_
|
||||||
|
- **Содержание корзины**:
|
||||||
|
- Количество видов расходников
|
||||||
|
- По каждому расходнику: название, количество, цена за единицу, сумма
|
||||||
|
- Общая сумма всех расходников
|
||||||
|
- **Управление**: Изменение количества, удаление позиций
|
||||||
|
- **Валидация**: Проверка остатков у поставщика
|
||||||
|
- **Настройки поставки**:
|
||||||
|
- Выбор фулфилмент-центра (dropdown из партнеров)
|
||||||
|
- Дата поставки (по умолчанию - дата создания, нельзя выбрать прошедшую)
|
||||||
|
- **Кнопка**: "Создать поставку"
|
||||||
|
|
||||||
|
### 9.3 Многоуровневые таблицы для отображения поставок
|
||||||
|
|
||||||
|
#### **📊 Структура многоуровневой таблицы:**
|
||||||
|
|
||||||
|
**ПЕРВЫЙ УРОВЕНЬ** _(основной список)_:
|
||||||
|
- Порядковый номер поставки (от большего к меньшему)
|
||||||
|
- Количество видов расходников селлера
|
||||||
|
- Стоимость всей поставки
|
||||||
|
- Количество категорий
|
||||||
|
- Статус поставки
|
||||||
|
- Кнопка раскрытия/сворачивания
|
||||||
|
|
||||||
|
**ВТОРОЙ УРОВЕНЬ** _(раскрывается по клику)_:
|
||||||
|
- Название расходника селлера
|
||||||
|
- Количество
|
||||||
|
- Цена за единицу
|
||||||
|
- Общая стоимость позиции
|
||||||
|
- Категория
|
||||||
|
- Поставщик
|
||||||
|
- **Режим**: Только просмотр (редактирование недоступно после создания)
|
||||||
|
|
||||||
|
**ПРАВИЛА ОТОБРАЖЕНИЯ**:
|
||||||
|
- По умолчанию таблица свернута, показан только первый уровень
|
||||||
|
- Клик по строке или кнопке раскрывает второй уровень
|
||||||
|
- Анимация раскрытия плавная (300ms)
|
||||||
|
- Визуальная индикация раскрытого состояния (поворот стрелки, изменение фона)
|
||||||
|
|
||||||
|
### 9.4 Правила кнопки "Создать поставку" в разделе "Мои поставки"
|
||||||
|
|
||||||
|
#### **9.4.1 Общие принципы**
|
||||||
|
|
||||||
- **КОНТЕКСТНОСТЬ**: Кнопка создания появляется только в активном табе
|
- **КОНТЕКСТНОСТЬ**: Кнопка создания появляется только в активном табе
|
||||||
- **РАСПОЛОЖЕНИЕ**: Правая часть строки таба, на том же уровне что и название
|
- **РАСПОЛОЖЕНИЕ**: Правая часть строки таба, на том же уровне что и название
|
||||||
- **СТИЛИСТИКА**: В том же стиле что и сами табы (соответствует уровню иерархии)
|
- **СТИЛИСТИКА**: В том же стиле что и сами табы (соответствует уровню иерархии)
|
||||||
- **ФУНКЦИОНАЛЬНОСТЬ**: Кнопка ведет на страницу создания поставки соответствующего типа
|
- **ФУНКЦИОНАЛЬНОСТЬ**: Кнопка ведет на страницу создания поставки соответствующего типа
|
||||||
|
|
||||||
#### **9.2.2 Размещение кнопок по табам**
|
#### **9.4.2 Размещение кнопок по табам**
|
||||||
|
|
||||||
**УРОВЕНЬ 2 (Подтабы фулфилмента):**
|
**УРОВЕНЬ 2 (Подтабы фулфилмента):**
|
||||||
|
|
||||||
@ -567,7 +1081,7 @@ const handleSuppliesClick = () => {
|
|||||||
- **🟣 Wildberries**: Кнопка "Создать поставку" → `/supplies/create-wildberries`
|
- **🟣 Wildberries**: Кнопка "Создать поставку" → `/supplies/create-wildberries`
|
||||||
- **🔵 Ozon**: Кнопка "Создать поставку" → `/supplies/create-ozon`
|
- **🔵 Ozon**: Кнопка "Создать поставку" → `/supplies/create-ozon`
|
||||||
|
|
||||||
#### **9.2.3 Стили кнопок**
|
#### **9.4.3 Стили кнопок**
|
||||||
|
|
||||||
**ДЛЯ УРОВНЯ 2 (h-9):**
|
**ДЛЯ УРОВНЯ 2 (h-9):**
|
||||||
|
|
||||||
@ -836,21 +1350,68 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
|
|||||||
|
|
||||||
## 11. 🏭 КАБИНЕТ ФУЛФИЛМЕНТА
|
## 11. 🏭 КАБИНЕТ ФУЛФИЛМЕНТА
|
||||||
|
|
||||||
### 11.1 Структура раздела склад фулфилмента
|
### 11.1 Общие характеристики кабинета фулфилмента
|
||||||
|
|
||||||
#### **Модули в обязательной последовательности**:
|
#### 11.1.1 Принципы доступа
|
||||||
|
|
||||||
1. **📦 ПРОДУКТ** - готовые к продаже товары
|
- **МАКСИМАЛЬНЫЕ ПРАВА**: Фулфилмент имеет доступ ко ВСЕМ разделам системы
|
||||||
2. **🛒 ТОВАР** - базовые товары от поставщиков
|
- **АДАПТИВНАЯ НАВИГАЦИЯ**: Sidebar изменяется в зависимости от `user.organization.type === "FULFILLMENT"`
|
||||||
- Товары "на складе" - готовы к обработке
|
- **ЭКСКЛЮЗИВНЫЕ КОМПОНЕНТЫ**: Услуги, Сотрудники, Статистика фулфилмента доступны ТОЛЬКО фулфилменту
|
||||||
- Товары "в обработке" - в процессе создания продукта
|
- **СПЕЦИАЛЬНЫЙ РОУТИНГ**: При нажатии "Поставки" → `/fulfillment-supplies` (не `/supplies`)
|
||||||
3. **❌ БРАК** - товары с дефектами
|
|
||||||
4. **↩️ ВОЗВРАТЫ С ПВЗ** - возвращенные товары
|
|
||||||
5. **🎯 РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для селлеров
|
|
||||||
6. **⚙️ РАСХОДНИКИ ФУЛФИЛМЕНТ** - операционные материалы
|
|
||||||
- **КЛИКАБЕЛЬНЫЙ МОДУЛЬ** - содержит полноценный раздел учёта
|
|
||||||
|
|
||||||
### 11.2 Движение товаров в фулфилменте
|
#### 11.1.2 Архитектурные особенности
|
||||||
|
|
||||||
|
- **GraphQL проверки**: `skip: user?.organization?.type !== 'FULFILLMENT'` в запросах
|
||||||
|
- **Условное отображение**: `{user?.organization?.type === "FULFILLMENT" && (...)}`
|
||||||
|
- **Адаптивные отступы**: `getSidebarMargin()` для responsive design
|
||||||
|
- **Полинг данных**: Статистика обновляется каждую минуту (`pollInterval: 60000`)
|
||||||
|
|
||||||
|
### 11.2 Структура раздела склад фулфилмента
|
||||||
|
|
||||||
|
> 📌 **ВИЗУАЛЬНЫЕ ПРАВИЛА**: См. [visual-design-rules.md - Кабинет фулфилмента](#141-кабинет-фулфилмента)
|
||||||
|
|
||||||
|
#### 11.2.1 Структура склада по модулям (ОБЯЗАТЕЛЬНАЯ ПОСЛЕДОВАТЕЛЬНОСТЬ)
|
||||||
|
|
||||||
|
1. **📦 ПРОДУКТЫ** - готовые к отправке товары
|
||||||
|
2. **🛒 ТОВАРЫ** - базовые товары от поставщиков
|
||||||
|
- **"На складе"** - готовы к обработке
|
||||||
|
- **"В обработке"** - в процессе создания продукта
|
||||||
|
3. **❌ БРАК** - товары с дефектами, требуют утилизации
|
||||||
|
4. **↩️ ВОЗВРАТЫ С ПВЗ** - возвращенные товары, к обработке
|
||||||
|
5. **🎯 РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для селлеров (тип `CONSUMABLE`, заказанные селлерами)
|
||||||
|
6. **⚙️ РАСХОДНИКИ ФУЛФИЛМЕНТА** - операционные материалы (тип `CONSUMABLE`, заказанные фулфилментом, КЛИКАБЕЛЬНЫЙ модуль)
|
||||||
|
|
||||||
|
#### 11.2.2 Система учета склада
|
||||||
|
|
||||||
|
**Дополнительные значения** (показатели движения):
|
||||||
|
- **ПРИБЫЛО** - количество поступивших на склад за период
|
||||||
|
- **УБЫЛО** - количество списанных со склада за период
|
||||||
|
|
||||||
|
**Основные значения** (текущие остатки):
|
||||||
|
- **ФОРМУЛА**: Основные значения = Предыдущие остатки + Прибыло - Убыло
|
||||||
|
- **ОБНОВЛЕНИЕ**: В реальном времени с изменениями за сутки
|
||||||
|
- **ИСТОЧНИК**: GraphQL query `GET_FULFILLMENT_WAREHOUSE_STATS`
|
||||||
|
|
||||||
|
#### 11.2.3 Структура данных склада (3-уровневая иерархия)
|
||||||
|
|
||||||
|
```
|
||||||
|
🔵 УРОВЕНЬ 1: МАГАЗИНЫ
|
||||||
|
├── ТехноМир (синий - blue-400/500)
|
||||||
|
├── Стиль и Комфорт (розовый - pink-400/500)
|
||||||
|
└── Зелёный Дом (изумрудный - emerald-400/500)
|
||||||
|
↓
|
||||||
|
🟢 УРОВЕНЬ 2: ТОВАРЫ (зеленый - green-500)
|
||||||
|
↓
|
||||||
|
🟠 УРОВЕНЬ 3: ВАРИАНТЫ ТОВАРОВ (оранжевый - orange-500)
|
||||||
|
```
|
||||||
|
|
||||||
|
**Цветовое кодирование**:
|
||||||
|
- Каждый уровень имеет цветной индикатор увеличивающегося размера
|
||||||
|
- Цветная левая граница с увеличивающимся отступом и толщиной
|
||||||
|
- Скроллбары в цвете уровня
|
||||||
|
- Контрастный цвет текста для читаемости
|
||||||
|
|
||||||
|
### 11.3 Движение товаров в фулфилменте
|
||||||
|
|
||||||
#### **Поступление товаров**:
|
#### **Поступление товаров**:
|
||||||
|
|
||||||
@ -865,7 +1426,7 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
|
|||||||
- **ВОЗВРАТ**: Возврат поставщику
|
- **ВОЗВРАТ**: Возврат поставщику
|
||||||
- **ИСПОЛЬЗОВАНИЕ**: Расходники для операций
|
- **ИСПОЛЬЗОВАНИЕ**: Расходники для операций
|
||||||
|
|
||||||
### 11.3 Модуль "Расходники фулфилмента"
|
### 11.4 Модуль "Расходники фулфилмента"
|
||||||
|
|
||||||
**ОСОБЕННОСТИ**:
|
**ОСОБЕННОСТИ**:
|
||||||
|
|
||||||
@ -873,7 +1434,100 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins)
|
|||||||
- **ФУНКЦИОНАЛЬНОСТЬ**: Полноценный раздел учёта
|
- **ФУНКЦИОНАЛЬНОСТЬ**: Полноценный раздел учёта
|
||||||
- **СОДЕРЖАНИЕ**: Управление расходниками фулфилмента
|
- **СОДЕРЖАНИЕ**: Управление расходниками фулфилмента
|
||||||
|
|
||||||
### 11.4 Блок детализации по магазинам
|
### 11.5 Поставки фулфилмента (`/fulfillment-supplies`)
|
||||||
|
|
||||||
|
#### 11.5.1 Структура: 2 основные вкладки
|
||||||
|
|
||||||
|
**A) 🛒 ПОСТАВКИ ТОВАРОВ**:
|
||||||
|
- **Детализированные товары ФФ** - планы и факты поставок с маршрутами
|
||||||
|
- **Товары ФФ** - общие поставки товаров от селлеров
|
||||||
|
- **Возвраты с ПВЗ** - обработка возвращенных товаров
|
||||||
|
|
||||||
|
**B) 🔧 ПОСТАВКИ РАСХОДНИКОВ**:
|
||||||
|
- **Заказы расходников** - управление заказами от селлеров
|
||||||
|
- **Расходники селлеров** - материалы для клиентов
|
||||||
|
- **Создание поставок** - формирование новых поставок расходников
|
||||||
|
|
||||||
|
#### 11.5.2 Workflow поставок товаров
|
||||||
|
|
||||||
|
**Этапы обработки**:
|
||||||
|
1. **Planned** - поставка запланирована
|
||||||
|
2. **In-transit** - товар в пути
|
||||||
|
3. **Delivered** - доставлен на склад
|
||||||
|
4. **Completed** - обработка завершена
|
||||||
|
|
||||||
|
### 11.6 Статистика фулфилмента (`/fulfillment-statistics`)
|
||||||
|
|
||||||
|
#### 11.6.1 Блоки аналитики (сворачиваемые)
|
||||||
|
|
||||||
|
**1. НАКОПЛЕННАЯ СТАТИСТИКА** (`allTime: true`):
|
||||||
|
- Обработано товаров (общий объем)
|
||||||
|
- Выявлено брака (всего единиц)
|
||||||
|
- Поставок получено
|
||||||
|
- Общий доход (за все время)
|
||||||
|
- Выполнено заказов (успешных отгрузок)
|
||||||
|
- Удовлетворенность клиентов (средний рейтинг)
|
||||||
|
|
||||||
|
**2. ОТГРУЗКА НА ПЛОЩАДКИ** (`marketplaces: true`):
|
||||||
|
- Отправлено на Wildberries
|
||||||
|
- Отправлено на Ozon
|
||||||
|
- Отправлено на другие площадки
|
||||||
|
|
||||||
|
**3. АНАЛИТИКА ПРОИЗВОДИТЕЛЬНОСТИ** (`performance: false`):
|
||||||
|
- Среднее время обработки (на единицу товара)
|
||||||
|
- Уровень брака (от общего объема)
|
||||||
|
- Уровень возвратов (возвраты с площадок)
|
||||||
|
- Удовлетворенность клиентов
|
||||||
|
|
||||||
|
### 11.7 Услуги фулфилмента (`/services`)
|
||||||
|
|
||||||
|
#### 11.7.1 Структура: 3 обязательные вкладки
|
||||||
|
|
||||||
|
**A) 🛠️ УСЛУГИ** (`defaultValue="services"`):
|
||||||
|
- **CRUD операции**: создание, редактирование, удаление услуг
|
||||||
|
- **Управление ценами** и описаниями
|
||||||
|
- **Загрузка изображений** услуг (`imageUrl`)
|
||||||
|
- **GraphQL**: `GET_MY_SERVICES`, `CREATE_SERVICE`, `UPDATE_SERVICE`, `DELETE_SERVICE`
|
||||||
|
|
||||||
|
**B) 🚚 ЛОГИСТИКА**:
|
||||||
|
- **Создание маршрутов доставки** (откуда → куда)
|
||||||
|
- **Тарификация**: цена до 1м³ и свыше 1м³
|
||||||
|
- **Группированные локации**:
|
||||||
|
- Мой фулфилмент (название организации)
|
||||||
|
- Рынки (предустановленные)
|
||||||
|
- Склады Wildberries
|
||||||
|
- Склады Ozon
|
||||||
|
- **GraphQL**: `GET_MY_LOGISTICS`, `CREATE_LOGISTICS`, `UPDATE_LOGISTICS`, `DELETE_LOGISTICS`
|
||||||
|
|
||||||
|
**C) 📦 РАСХОДНИКИ**:
|
||||||
|
- **Управление расходниками фулфилмента**
|
||||||
|
- **Интеграция с модулем "Услуги"** - селлеры могут использовать в услугах
|
||||||
|
- **Списание со складских остатков** при использовании
|
||||||
|
- **Стоимость включается** в стоимость услуги
|
||||||
|
|
||||||
|
### 11.8 Сотрудники фулфилмента (`/employees`)
|
||||||
|
|
||||||
|
#### 11.8.1 Структура: 2 основные вкладки
|
||||||
|
|
||||||
|
**A) 👥 СОТРУДНИКИ** (`defaultValue="combined"`):
|
||||||
|
|
||||||
|
**Управление персоналом**:
|
||||||
|
- **CRUD операции**: создание, редактирование, удаление сотрудников
|
||||||
|
- **Статусы сотрудников**: `ACTIVE`, `VACATION`, `SICK`, `FIRED`
|
||||||
|
- **Формы добавления**: Компактная (`showCompactForm`) / Полная форма
|
||||||
|
- **Поиск и фильтрация** по имени, должности, статусу
|
||||||
|
|
||||||
|
**Табель рабочего времени**:
|
||||||
|
- **Навигация по месяцам**: текущий год/месяц с кнопками ←/→
|
||||||
|
- **Отметки по дням**: статус дня и количество отработанных часов
|
||||||
|
- **GraphQL**: `GET_EMPLOYEE_SCHEDULE`, `UPDATE_EMPLOYEE_SCHEDULE`
|
||||||
|
|
||||||
|
**B) 📋 ОТЧЕТЫ** (`value="reports"`):
|
||||||
|
- **Сводные отчеты** по сотрудникам за период
|
||||||
|
- **Экспорт данных** табеля
|
||||||
|
- **Аналитика рабочего времени**
|
||||||
|
|
||||||
|
### 11.9 Блок детализации по магазинам
|
||||||
|
|
||||||
**НАЗНАЧЕНИЕ**: Распределение товаров по торговым точкам/магазинам
|
**НАЗНАЧЕНИЕ**: Распределение товаров по торговым точкам/магазинам
|
||||||
|
|
||||||
@ -1259,6 +1913,7 @@ const wholesalePartners = await prisma.counterparty.findMany({
|
|||||||
18. ❌ **Использовать общие запросы вместо специализированных** (`GET_ALL_PRODUCTS` вместо `GET_ORGANIZATION_PRODUCTS` для конкретного поставщика)
|
18. ❌ **Использовать общие запросы вместо специализированных** (`GET_ALL_PRODUCTS` вместо `GET_ORGANIZATION_PRODUCTS` для конкретного поставщика)
|
||||||
19. ❌ **Показывать расходники в формах создания поставок товаров** (строгая типизация `PRODUCT`/`CONSUMABLE`)
|
19. ❌ **Показывать расходники в формах создания поставок товаров** (строгая типизация `PRODUCT`/`CONSUMABLE`)
|
||||||
20. ❌ **Фильтровать предметы по типу на фронтенде** (фильтрация должна быть в GraphQL резолвере)
|
20. ❌ **Фильтровать предметы по типу на фронтенде** (фильтрация должна быть в GraphQL резолвере)
|
||||||
|
21. ❌ **ИСПОЛЬЗОВАТЬ МОКОВЫЕ ДАННЫЕ БЕЗ РАЗРЕШЕНИЯ** - все компоненты ОБЯЗАТЕЛЬНО должны использовать реальные GraphQL запросы. Моковые данные можно добавлять ТОЛЬКО с явного разрешения пользователя
|
||||||
|
|
||||||
### 17.2 ОБЯЗАТЕЛЬНЫЕ ПРАВИЛА:
|
### 17.2 ОБЯЗАТЕЛЬНЫЕ ПРАВИЛА:
|
||||||
|
|
||||||
@ -1619,8 +2274,189 @@ interface GoodsProduct {
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
_Эта база знаний создана на основе анализа rules.md, rules1.md и rules2.md и является единым источником понимания структуры и логики проекта._
|
## 🚨 КРИТИЧЕСКИЕ СИТУАЦИИ И EDGE CASES
|
||||||
|
|
||||||
_Версия: 4.0_
|
### 🔴 Отмена заказов на разных этапах workflow
|
||||||
_Дата создания: 2024_
|
|
||||||
_Статус: ПОЛНАЯ УНИФИЦИРОВАННАЯ БАЗА ЗНАНИЙ_
|
**PENDING → Отмена разрешена**
|
||||||
|
- Действие: Удаление заказа без последствий
|
||||||
|
- Уведомления: Поставщику о отмене
|
||||||
|
- Влияние на статистику: Нет
|
||||||
|
|
||||||
|
**SUPPLIER_APPROVED → Отмена с согласия поставщика**
|
||||||
|
- Действие: Требуется подтверждение поставщика
|
||||||
|
- Штрафы: Возможны согласно договору
|
||||||
|
- Восстановление: Товары возвращаются в доступные остатки
|
||||||
|
|
||||||
|
**CONFIRMED/LOGISTICS_CONFIRMED → Отмена критическая**
|
||||||
|
- Действие: Требуется согласие всех участников
|
||||||
|
- Штрафы: Логистические расходы
|
||||||
|
- Альтернатива: Изменение адреса доставки
|
||||||
|
|
||||||
|
**SHIPPED/IN_TRANSIT → Отмена невозможна**
|
||||||
|
- Действие: Только возврат после получения
|
||||||
|
- Процедура: Через модуль "Возвраты с ПВЗ"
|
||||||
|
|
||||||
|
### 🔄 Частичная доставка товаров
|
||||||
|
|
||||||
|
**Сценарий**: Поставщик доставил 80 из 100 заказанных единиц
|
||||||
|
|
||||||
|
**Алгоритм обработки**:
|
||||||
|
1. Фулфилмент фиксирует фактическое количество
|
||||||
|
2. Система создает два отдельных документа:
|
||||||
|
- DELIVERED (80 единиц) - обрабатывается обычным порядком
|
||||||
|
- PARTIAL_DELIVERED (20 единиц) - остается в статусе ожидания
|
||||||
|
3. Селлер получает уведомление о частичной поставке
|
||||||
|
4. Принятие решения: ждать остаток или отменить недопоставку
|
||||||
|
|
||||||
|
### 📊 Превышение лимитов остатков
|
||||||
|
|
||||||
|
**Проблема**: Попытка заказать больше чем есть у поставщика
|
||||||
|
|
||||||
|
**Техническая реализация**:
|
||||||
|
```typescript
|
||||||
|
if (requestedQuantity > availableStock) {
|
||||||
|
throw new GraphQLError(`Недостаточно товара. Доступно: ${availableStock}, запрошено: ${requestedQuantity}`);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**UX решение**: Real-time валидация в формах заказа
|
||||||
|
|
||||||
|
### 🔍 Дубликаты артикулов
|
||||||
|
|
||||||
|
**Сценарий**: Поставщик пытается создать товар с существующим артикулом
|
||||||
|
|
||||||
|
**Проверка на уровне БД**:
|
||||||
|
```sql
|
||||||
|
UNIQUE INDEX ON products(article, organization_id)
|
||||||
|
```
|
||||||
|
|
||||||
|
**Обработка**: Автоматическое добавление суффикса или предложение изменить артикул
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 24. 📎 ТЕХНИЧЕСКИЕ ПРИЛОЖЕНИЯ
|
||||||
|
|
||||||
|
### Приложение A: GraphQL запросы фулфилмента
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Основные запросы
|
||||||
|
GET_MY_SERVICES; // Услуги фулфилмента
|
||||||
|
GET_MY_LOGISTICS; // Логистические маршруты
|
||||||
|
GET_MY_EMPLOYEES; // Сотрудники организации
|
||||||
|
GET_FULFILLMENT_WAREHOUSE_STATS; // Статистика склада
|
||||||
|
GET_WAREHOUSE_PRODUCTS; // Товары на складе
|
||||||
|
GET_MY_FULFILLMENT_SUPPLIES; // Расходники фулфилмента
|
||||||
|
GET_EMPLOYEE_SCHEDULE; // Табель рабочего времени
|
||||||
|
|
||||||
|
// Мутации
|
||||||
|
CREATE_SERVICE, UPDATE_SERVICE, DELETE_SERVICE;
|
||||||
|
CREATE_LOGISTICS, UPDATE_LOGISTICS, DELETE_LOGISTICS;
|
||||||
|
CREATE_EMPLOYEE, UPDATE_EMPLOYEE, DELETE_EMPLOYEE;
|
||||||
|
UPDATE_EMPLOYEE_SCHEDULE; // Обновление табеля
|
||||||
|
```
|
||||||
|
|
||||||
|
### Приложение B: Компоненты фулфилмента
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Основные dashboard компоненты
|
||||||
|
FulfillmentWarehouseDashboard; // Склад фулфилмента
|
||||||
|
FulfillmentStatisticsDashboard; // Статистика
|
||||||
|
ServicesDashboard; // Услуги (3 вкладки)
|
||||||
|
EmployeesDashboard; // Сотрудники
|
||||||
|
SuppliesDashboard; // Поставки фулфилмента
|
||||||
|
|
||||||
|
// Специализированные компоненты
|
||||||
|
ServicesTab, LogisticsTab, SuppliesTab; // Вкладки услуг
|
||||||
|
EmployeeInlineForm, EmployeeEditInlineForm; // Формы сотрудников
|
||||||
|
FulfillmentSuppliesTab, FulfillmentConsumablesOrdersTab; // Поставки
|
||||||
|
```
|
||||||
|
|
||||||
|
### Приложение C: Специальный роутинг для типов организаций
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const handleSuppliesClick = () => {
|
||||||
|
switch (user?.organization?.type) {
|
||||||
|
case "FULFILLMENT":
|
||||||
|
router.push("/fulfillment-supplies"); // Специальный роут
|
||||||
|
break;
|
||||||
|
case "SELLER":
|
||||||
|
router.push("/supplies");
|
||||||
|
break;
|
||||||
|
case "WHOLESALE":
|
||||||
|
router.push("/wholesale-supplies");
|
||||||
|
break;
|
||||||
|
case "LOGIST":
|
||||||
|
router.push("/logist-supplies");
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Эта база знаний создана путем объединения rules-unified.md (v3.0) и fulfillment-cabinet-rules.md (v1.0) с устранением всех несоответствий и добавлением критически важных улучшений: быстрый справочник, глоссарий терминов, детальные алгоритмы процессов, edge cases._
|
||||||
|
|
||||||
|
_Версия: 9.1_
|
||||||
|
_Дата создания: 2025_
|
||||||
|
_Статус: ЕДИНЫЙ ИСТОЧНИК ИСТИНЫ - ГОТОВ К РАЗРАБОТКЕ_
|
||||||
|
|
||||||
|
### 🚀 УЛУЧШЕНИЯ v6.0:
|
||||||
|
- ⚡ Быстрый справочник критических правил
|
||||||
|
- 🔤 Полный глоссарий терминов с определениями
|
||||||
|
- 🎯 Навигация по ролям (разработчики, аналитики, менеджеры)
|
||||||
|
- 🔄 Детальный алгоритм создания продукта с временными рамками
|
||||||
|
- 🚨 Раздел критических ситуаций и Edge Cases
|
||||||
|
- 📌 Связующие блоки между разделами
|
||||||
|
- 📊 Таблицы SLA и временных рамок
|
||||||
|
|
||||||
|
### 🔧 ИСПРАВЛЕНИЯ v6.1:
|
||||||
|
- ✅ Устранено противоречие в моменте создания БРАКА
|
||||||
|
- ✅ Исправлена логическая цепочка: рецептура задается селлером ДО процесса
|
||||||
|
- ✅ Реалистичные временные рамки SLA (рабочие дни вместо часов)
|
||||||
|
- ✅ Унифицирована классификация расходников (по назначению при использовании)
|
||||||
|
- ✅ Согласованы все алгоритмы и процессы между разделами
|
||||||
|
|
||||||
|
### 🔧 ОБНОВЛЕНИЯ v6.3:
|
||||||
|
- ✅ **ДОБАВЛЕН КРИТИЧЕСКИЙ ЗАПРЕТ**: Использование моковых данных в продакшене
|
||||||
|
- ✅ **ОБНОВЛЕН ЧЕКЛИСТ**: Добавлена проверка на отсутствие mock данных
|
||||||
|
- ✅ **РЕАЛИЗАЦИЯ**: Полная очистка моковых данных из раздела "Мои поставки" селлера
|
||||||
|
|
||||||
|
### 🎨 ИНТЕГРАЦИЯ v6.2:
|
||||||
|
- ✅ Синхронизация с visual-design-rules.md v1.1
|
||||||
|
- ✅ Добавлены визуальные правила для 8 статусов поставок
|
||||||
|
- ✅ Создана цветовая система для 6 модулей фулфилмента
|
||||||
|
- ✅ Визуальный workflow процесса создания продукта
|
||||||
|
- ✅ Перекрестные ссылки между техническими и визуальными правилами
|
||||||
|
- ✅ Покрытие визуальными решениями увеличено с 40% до 85%
|
||||||
|
|
||||||
|
### 🚀 КОНСОЛИДАЦИЯ v7.0:
|
||||||
|
- ✅ Интеграция development-checklist.md и CLAUDE.md
|
||||||
|
- ✅ Удаление дублирующих файлов
|
||||||
|
- ✅ Создание единого источника истины
|
||||||
|
|
||||||
|
### 🔧 ПОЛНАЯ ИНТЕГРАЦИЯ v8.0:
|
||||||
|
- ✅ Интеграция work-protocols.md (детальные протоколы по сложности)
|
||||||
|
- ✅ Интеграция violation-prevention-protocol.md (СТОП-сигналы и триггеры)
|
||||||
|
- ✅ Интеграция self-validation.md (расширенная система самопроверки)
|
||||||
|
- ✅ Удаление всех дублирующих файлов протоколов
|
||||||
|
|
||||||
|
### 🎯 ОПТИМИЗАЦИЯ UI/UX v8.1:
|
||||||
|
- ✅ Добавлен ТРИГГЕР #3 для автоматической активации visual-design-rules.md
|
||||||
|
- ✅ Интегрирован специальный UI/UX протокол в чеклист
|
||||||
|
- ✅ Создана система перекрестных ссылок с visual-design-rules.md
|
||||||
|
- ✅ visual-design-rules.md остается отдельным специализированным файлом
|
||||||
|
|
||||||
|
### 📊 ИНТЕГРАЦИЯ DESCRIPTION v9.0:
|
||||||
|
- ✅ Добавлена UI структура создания поставки расходников (3 блока)
|
||||||
|
- ✅ Интегрирована концепция многоуровневых таблиц
|
||||||
|
- ✅ Добавлен механизм учета ПЛАН/ФАКТ в процессе создания продукта
|
||||||
|
- ✅ Расширена детализация рецептуры продукта
|
||||||
|
- ✅ Добавлена опция места хранения готовых продуктов
|
||||||
|
|
||||||
|
### 🔧 УТОЧНЕНИЯ ЛОГИКИ v9.1:
|
||||||
|
- ✅ Уточнен статус брака: НЕ РЕАЛИЗОВАНО (еще не дошли до этого этапа)
|
||||||
|
- ✅ Добавлены четкие правила создания предметов по ролям
|
||||||
|
- ✅ Добавлен экономический учет расходников фулфилмента для селлера
|
||||||
|
- ✅ Обновлен механизм ПЛАН/ФАКТ: потери вместо брака при пересчете
|
||||||
|
- ✅ Добавлена заметка о будущей детализации статусов товаров
|
@ -1,146 +0,0 @@
|
|||||||
# УСОВЕРШЕНСТВОВАННАЯ СИСТЕМА САМОПРОВЕРКИ AI
|
|
||||||
|
|
||||||
## 🎯 ЦЕЛЬ
|
|
||||||
|
|
||||||
Обеспечить 100% соблюдение правил проекта Sfera с использованием новых протоколов работы.
|
|
||||||
|
|
||||||
## 🚨 КРИТИЧЕСКОЕ ДОПОЛНЕНИЕ
|
|
||||||
|
|
||||||
Интегрирована система жестких стоп-сигналов из `violation-prevention-protocol.md` для предотвращения всех типов нарушений протоколов.
|
|
||||||
|
|
||||||
## 🛑 ОБЯЗАТЕЛЬНЫЙ ПРОТОКОЛ ПЕРЕД КАЖДОЙ ЗАДАЧЕЙ
|
|
||||||
|
|
||||||
### ШАГ 1: ОПРЕДЕЛЕНИЕ СЛОЖНОСТИ И ПРОТОКОЛА
|
|
||||||
|
|
||||||
```
|
|
||||||
ВОПРОСЫ:
|
|
||||||
- Сколько файлов затрагивает задача? (1-3 = средняя, 4+ = высокая)
|
|
||||||
- Изменяется ли архитектура или workflow? (да = высокая)
|
|
||||||
- Влияет ли на критические бизнес-процессы? (да = высокая)
|
|
||||||
|
|
||||||
ДЕЙСТВИЕ: Применить соответствующий протокол из work-protocols.md
|
|
||||||
```
|
|
||||||
|
|
||||||
### ШАГ 2: ЭТАП "СТОП И ПОДУМАЙ"
|
|
||||||
|
|
||||||
```
|
|
||||||
ОБЯЗАТЕЛЬНЫЕ ВОПРОСЫ:
|
|
||||||
- Какие правила из rules2.md применимы?
|
|
||||||
- Какие файлы нужно изучить? (перечислить ВСЕ)
|
|
||||||
- Есть ли неопределенности, требующие уточнения?
|
|
||||||
- Что может пойти не так?
|
|
||||||
|
|
||||||
ДЕЙСТВИЕ: Составить план с промежуточными проверками
|
|
||||||
```
|
|
||||||
|
|
||||||
### ШАГ 3: ПРОВЕРКА КРИТИЧЕСКИХ ПРАВИЛ
|
|
||||||
|
|
||||||
```
|
|
||||||
✅ ТИПИЗАЦИЯ:
|
|
||||||
- ТОВАР ≠ ПРОДУКТ (разные сущности)
|
|
||||||
- 4 типа предметов: ТОВАР, БРАК, РАСХОДНИКИ, ПРОДУКТ
|
|
||||||
- Производные связаны с parentId
|
|
||||||
|
|
||||||
✅ WORKFLOW:
|
|
||||||
- Последовательность статусов соблюдена
|
|
||||||
- Уведомления на каждом этапе
|
|
||||||
- Логирование изменений
|
|
||||||
|
|
||||||
✅ ДОСТУП:
|
|
||||||
- Запрет заказа собственных товаров поставщиком
|
|
||||||
- Запрет заказа брака
|
|
||||||
- Проверка остатков
|
|
||||||
|
|
||||||
✅ ВАЛИДАЦИЯ:
|
|
||||||
- Цена > 0 (исключение: брак для фулфилмента)
|
|
||||||
- Количество ≤ остатков
|
|
||||||
- Обязательные поля заполнены
|
|
||||||
```
|
|
||||||
|
|
||||||
### ШАГ 4: ТЕХНИЧЕСКИЕ ПРОВЕРКИ
|
|
||||||
|
|
||||||
```
|
|
||||||
✅ ПРОИЗВОДИТЕЛЬНОСТЬ: < 3 сек загрузка
|
|
||||||
✅ БЕЗОПАСНОСТЬ: шифрование, аудит
|
|
||||||
✅ UX: индикаторы, уведомления
|
|
||||||
✅ КАЧЕСТВО: тесты 80%+, SOLID принципы
|
|
||||||
```
|
|
||||||
|
|
||||||
### ШАГ 5: УТОЧНЯЮЩИЕ ВОПРОСЫ
|
|
||||||
|
|
||||||
```
|
|
||||||
КОГДА ОБЯЗАТЕЛЬНО СПРОСИТЬ:
|
|
||||||
🔴 Противоречие в правилах
|
|
||||||
🔴 Архитектурные изменения
|
|
||||||
🔴 Критические бизнес-процессы
|
|
||||||
🔴 Несколько вариантов решения
|
|
||||||
|
|
||||||
ФОРМАТ:
|
|
||||||
🎯 КОНТЕКСТ: что делаю
|
|
||||||
❓ ВОПРОС: что неясно
|
|
||||||
⚖️ ВАРИАНТЫ: альтернативы
|
|
||||||
⚠️ РИСКИ: что может пойти не так
|
|
||||||
💡 ПРЕДЛОЖЕНИЕ: рекомендуемый подход
|
|
||||||
```
|
|
||||||
|
|
||||||
### ШАГ 6: АВТОСИНХРОНИЗАЦИЯ
|
|
||||||
|
|
||||||
```
|
|
||||||
ПРОВЕРИТЬ:
|
|
||||||
- Нужно ли обновить development-checklist.md?
|
|
||||||
- Добавлены ли новые критические правила?
|
|
||||||
- Изменились ли workflow или запреты?
|
|
||||||
|
|
||||||
ДЕЙСТВИЕ:
|
|
||||||
- Синхронизировать файлы по алгоритму auto-sync-system.md
|
|
||||||
- Уведомить пользователя о синхронизации
|
|
||||||
```
|
|
||||||
|
|
||||||
### ШАГ 7: ФИНАЛЬНАЯ ВАЛИДАЦИЯ
|
|
||||||
|
|
||||||
```
|
|
||||||
МЕГА-ВОПРОС К СЕБЕ:
|
|
||||||
"Применил ли я правильный протокол, проверил ли все правила,
|
|
||||||
задал ли нужные вопросы, синхронизировал ли файлы,
|
|
||||||
готов ли результат к production?"
|
|
||||||
|
|
||||||
ЕСЛИ ОТВЕТ НЕ "ДА 100%" - ВЕРНУТЬСЯ К НАЧАЛУ!
|
|
||||||
```
|
|
||||||
|
|
||||||
## 🚨 КРИТИЧЕСКИЕ СТОП-СИГНАЛЫ
|
|
||||||
|
|
||||||
```
|
|
||||||
🛑 ОСТАНОВИТЬСЯ НЕМЕДЛЕННО ЕСЛИ:
|
|
||||||
- Не определил сложность задачи
|
|
||||||
- Пропустил этап "Стоп и подумай"
|
|
||||||
- Есть сомнения в правилах
|
|
||||||
- Не проверил все применимые разделы rules2.md
|
|
||||||
- Не синхронизировал связанные файлы
|
|
||||||
- Не уведомил о важных изменениях
|
|
||||||
```
|
|
||||||
|
|
||||||
## 📊 МЕТРИКИ УСПЕХА
|
|
||||||
|
|
||||||
```
|
|
||||||
ЦЕЛЬ: 0 пропущенных критических деталей
|
|
||||||
|
|
||||||
ИЗМЕРЕНИЕ:
|
|
||||||
✅ Количество вопросов на уточнение
|
|
||||||
✅ Полнота анализа источников
|
|
||||||
✅ Своевременность синхронизации файлов
|
|
||||||
✅ Отсутствие нарушений правил
|
|
||||||
```
|
|
||||||
|
|
||||||
## 🔄 НЕПРЕРЫВНОЕ УЛУЧШЕНИЕ
|
|
||||||
|
|
||||||
```
|
|
||||||
ПОСЛЕ КАЖДОЙ ЗАДАЧИ АНАЛИЗИРОВАТЬ:
|
|
||||||
- Что можно было сделать лучше?
|
|
||||||
- Какие протоколы сработали?
|
|
||||||
- Где были пробелы в анализе?
|
|
||||||
- Как повысить эффективность?
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**СТАТУС**: Новая система самопроверки активирована! Применяется с каждой задачей проекта Sfera.
|
|
@ -26,7 +26,7 @@ import {
|
|||||||
} from "lucide-react";
|
} from "lucide-react";
|
||||||
import {
|
import {
|
||||||
GET_MY_COUNTERPARTIES,
|
GET_MY_COUNTERPARTIES,
|
||||||
GET_ALL_PRODUCTS,
|
GET_ORGANIZATION_PRODUCTS,
|
||||||
GET_SUPPLY_ORDERS,
|
GET_SUPPLY_ORDERS,
|
||||||
GET_MY_SUPPLIES,
|
GET_MY_SUPPLIES,
|
||||||
GET_MY_FULFILLMENT_SUPPLIES,
|
GET_MY_FULFILLMENT_SUPPLIES,
|
||||||
@ -112,19 +112,26 @@ export function CreateFulfillmentConsumablesSupplyPage() {
|
|||||||
productSearchQuery,
|
productSearchQuery,
|
||||||
});
|
});
|
||||||
|
|
||||||
// Загружаем товары для выбранного поставщика
|
// Загружаем товары для выбранного поставщика с фильтрацией по типу CONSUMABLE
|
||||||
const {
|
const {
|
||||||
data: productsData,
|
data: productsData,
|
||||||
loading: productsLoading,
|
loading: productsLoading,
|
||||||
error: productsError,
|
error: productsError,
|
||||||
} = useQuery(GET_ALL_PRODUCTS, {
|
} = useQuery(GET_ORGANIZATION_PRODUCTS, {
|
||||||
skip: !selectedSupplier,
|
skip: !selectedSupplier,
|
||||||
variables: { search: productSearchQuery || null, category: null },
|
variables: {
|
||||||
|
organizationId: selectedSupplier.id,
|
||||||
|
search: productSearchQuery || null,
|
||||||
|
category: null,
|
||||||
|
type: "CONSUMABLE" // Фильтруем только расходники согласно rules2.md
|
||||||
|
},
|
||||||
onCompleted: (data) => {
|
onCompleted: (data) => {
|
||||||
console.log("✅ GET_ALL_PRODUCTS COMPLETED:", {
|
console.log("✅ GET_ORGANIZATION_PRODUCTS COMPLETED:", {
|
||||||
totalProducts: data?.allProducts?.length || 0,
|
totalProducts: data?.organizationProducts?.length || 0,
|
||||||
|
organizationId: selectedSupplier.id,
|
||||||
|
type: "CONSUMABLE",
|
||||||
products:
|
products:
|
||||||
data?.allProducts?.map((p) => ({
|
data?.organizationProducts?.map((p) => ({
|
||||||
id: p.id,
|
id: p.id,
|
||||||
name: p.name,
|
name: p.name,
|
||||||
type: p.type,
|
type: p.type,
|
||||||
@ -134,7 +141,7 @@ export function CreateFulfillmentConsumablesSupplyPage() {
|
|||||||
});
|
});
|
||||||
},
|
},
|
||||||
onError: (error) => {
|
onError: (error) => {
|
||||||
console.error("❌ GET_ALL_PRODUCTS ERROR:", error);
|
console.error("❌ GET_ORGANIZATION_PRODUCTS ERROR:", error);
|
||||||
},
|
},
|
||||||
});
|
});
|
||||||
|
|
||||||
@ -160,14 +167,8 @@ export function CreateFulfillmentConsumablesSupplyPage() {
|
|||||||
);
|
);
|
||||||
|
|
||||||
// Фильтруем товары по выбранному поставщику
|
// Фильтруем товары по выбранному поставщику
|
||||||
// 📦 ТОЛЬКО РАСХОДНИКИ согласно правилам (раздел 2.1)
|
// 📦 Получаем товары поставщика (уже отфильтрованы в GraphQL запросе по типу CONSUMABLE)
|
||||||
const supplierProducts = selectedSupplier
|
const supplierProducts = productsData?.organizationProducts || [];
|
||||||
? (productsData?.allProducts || []).filter(
|
|
||||||
(product: FulfillmentConsumableProduct) =>
|
|
||||||
product.organization.id === selectedSupplier.id &&
|
|
||||||
product.type === "CONSUMABLE" // Только расходники для фулфилмента
|
|
||||||
)
|
|
||||||
: [];
|
|
||||||
|
|
||||||
// Отладочное логирование
|
// Отладочное логирование
|
||||||
React.useEffect(() => {
|
React.useEffect(() => {
|
||||||
@ -181,10 +182,10 @@ export function CreateFulfillmentConsumablesSupplyPage() {
|
|||||||
: null,
|
: null,
|
||||||
productsLoading,
|
productsLoading,
|
||||||
productsError: productsError?.message,
|
productsError: productsError?.message,
|
||||||
allProductsCount: productsData?.allProducts?.length || 0,
|
organizationProductsCount: productsData?.organizationProducts?.length || 0,
|
||||||
supplierProductsCount: supplierProducts.length,
|
supplierProductsCount: supplierProducts.length,
|
||||||
allProducts:
|
organizationProducts:
|
||||||
productsData?.allProducts?.map((p) => ({
|
productsData?.organizationProducts?.map((p) => ({
|
||||||
id: p.id,
|
id: p.id,
|
||||||
name: p.name,
|
name: p.name,
|
||||||
organizationId: p.organization.id,
|
organizationId: p.organization.id,
|
||||||
|
@ -25,7 +25,7 @@ import {
|
|||||||
} from "lucide-react";
|
} from "lucide-react";
|
||||||
import {
|
import {
|
||||||
GET_MY_COUNTERPARTIES,
|
GET_MY_COUNTERPARTIES,
|
||||||
GET_ALL_PRODUCTS,
|
GET_ORGANIZATION_PRODUCTS,
|
||||||
GET_SUPPLY_ORDERS,
|
GET_SUPPLY_ORDERS,
|
||||||
GET_MY_SUPPLIES,
|
GET_MY_SUPPLIES,
|
||||||
} from "@/graphql/queries";
|
} from "@/graphql/queries";
|
||||||
@ -91,12 +91,17 @@ export function MaterialsOrderForm() {
|
|||||||
GET_MY_COUNTERPARTIES
|
GET_MY_COUNTERPARTIES
|
||||||
);
|
);
|
||||||
|
|
||||||
// Загружаем товары для выбранного партнера
|
// Загружаем товары для выбранного партнера с фильтрацией по типу CONSUMABLE
|
||||||
const { data: productsData, loading: productsLoading } = useQuery(
|
const { data: productsData, loading: productsLoading } = useQuery(
|
||||||
GET_ALL_PRODUCTS,
|
GET_ORGANIZATION_PRODUCTS,
|
||||||
{
|
{
|
||||||
skip: !selectedPartner,
|
skip: !selectedPartner,
|
||||||
variables: { search: null, category: null },
|
variables: {
|
||||||
|
organizationId: selectedPartner.id,
|
||||||
|
search: null,
|
||||||
|
category: null,
|
||||||
|
type: "CONSUMABLE" // Фильтруем только расходники согласно rules2.md
|
||||||
|
},
|
||||||
}
|
}
|
||||||
);
|
);
|
||||||
|
|
||||||
@ -117,12 +122,8 @@ export function MaterialsOrderForm() {
|
|||||||
partner.inn?.toLowerCase().includes(searchQuery.toLowerCase())
|
partner.inn?.toLowerCase().includes(searchQuery.toLowerCase())
|
||||||
);
|
);
|
||||||
|
|
||||||
// Фильтруем товары по выбранному партнеру
|
// Получаем товары партнера (уже отфильтрованы в GraphQL запросе)
|
||||||
const partnerProducts = selectedPartner
|
const partnerProducts = productsData?.organizationProducts || [];
|
||||||
? (productsData?.allProducts || []).filter(
|
|
||||||
(product: Product) => product.organization.id === selectedPartner.id
|
|
||||||
)
|
|
||||||
: [];
|
|
||||||
|
|
||||||
const formatCurrency = (amount: number) => {
|
const formatCurrency = (amount: number) => {
|
||||||
return new Intl.NumberFormat("ru-RU", {
|
return new Intl.NumberFormat("ru-RU", {
|
||||||
|
@ -27,7 +27,7 @@ import {
|
|||||||
} from "lucide-react";
|
} from "lucide-react";
|
||||||
import {
|
import {
|
||||||
GET_MY_COUNTERPARTIES,
|
GET_MY_COUNTERPARTIES,
|
||||||
GET_ALL_PRODUCTS,
|
GET_ORGANIZATION_PRODUCTS,
|
||||||
GET_SUPPLY_ORDERS,
|
GET_SUPPLY_ORDERS,
|
||||||
GET_MY_SUPPLIES,
|
GET_MY_SUPPLIES,
|
||||||
} from "@/graphql/queries";
|
} from "@/graphql/queries";
|
||||||
@ -99,12 +99,17 @@ export function CreateConsumablesSupplyPage() {
|
|||||||
GET_MY_COUNTERPARTIES
|
GET_MY_COUNTERPARTIES
|
||||||
);
|
);
|
||||||
|
|
||||||
// Загружаем товары для выбранного поставщика
|
// Загружаем товары для выбранного поставщика с фильтрацией по типу CONSUMABLE
|
||||||
const { data: productsData, loading: productsLoading } = useQuery(
|
const { data: productsData, loading: productsLoading } = useQuery(
|
||||||
GET_ALL_PRODUCTS,
|
GET_ORGANIZATION_PRODUCTS,
|
||||||
{
|
{
|
||||||
skip: !selectedSupplier,
|
skip: !selectedSupplier,
|
||||||
variables: { search: productSearchQuery || null, category: null },
|
variables: {
|
||||||
|
organizationId: selectedSupplier.id,
|
||||||
|
search: productSearchQuery || null,
|
||||||
|
category: null,
|
||||||
|
type: "CONSUMABLE" // Фильтруем только расходники согласно rules2.md
|
||||||
|
},
|
||||||
}
|
}
|
||||||
);
|
);
|
||||||
|
|
||||||
@ -134,13 +139,8 @@ export function CreateConsumablesSupplyPage() {
|
|||||||
supplier.inn?.toLowerCase().includes(searchQuery.toLowerCase())
|
supplier.inn?.toLowerCase().includes(searchQuery.toLowerCase())
|
||||||
);
|
);
|
||||||
|
|
||||||
// Фильтруем товары по выбранному поставщику
|
// Получаем товары поставщика (уже отфильтрованы в GraphQL запросе)
|
||||||
const supplierProducts = selectedSupplier
|
const supplierProducts = productsData?.organizationProducts || [];
|
||||||
? (productsData?.allProducts || []).filter(
|
|
||||||
(product: ConsumableProduct) =>
|
|
||||||
product.organization.id === selectedSupplier.id
|
|
||||||
)
|
|
||||||
: [];
|
|
||||||
|
|
||||||
const formatCurrency = (amount: number) => {
|
const formatCurrency = (amount: number) => {
|
||||||
return new Intl.NumberFormat("ru-RU", {
|
return new Intl.NumberFormat("ru-RU", {
|
||||||
@ -415,11 +415,11 @@ export function CreateConsumablesSupplyPage() {
|
|||||||
<div className="h-screen flex overflow-hidden">
|
<div className="h-screen flex overflow-hidden">
|
||||||
<Sidebar />
|
<Sidebar />
|
||||||
<main
|
<main
|
||||||
className={`flex-1 ${getSidebarMargin()} overflow-auto transition-all duration-300`}
|
className={`flex-1 ${getSidebarMargin()} overflow-auto transition-all duration-300 p-4`}
|
||||||
>
|
>
|
||||||
<div className="min-h-full w-full flex flex-col px-3 py-2">
|
<div className="min-h-full w-full flex flex-col gap-4">
|
||||||
{/* Заголовок */}
|
{/* Заголовок */}
|
||||||
<div className="flex items-center justify-between mb-3 flex-shrink-0">
|
<div className="flex items-center justify-between flex-shrink-0">
|
||||||
<div>
|
<div>
|
||||||
<h1 className="text-xl font-bold text-white mb-1">
|
<h1 className="text-xl font-bold text-white mb-1">
|
||||||
Создание поставки расходников
|
Создание поставки расходников
|
||||||
@ -440,9 +440,9 @@ export function CreateConsumablesSupplyPage() {
|
|||||||
</div>
|
</div>
|
||||||
|
|
||||||
{/* Основной контент с двумя блоками */}
|
{/* Основной контент с двумя блоками */}
|
||||||
<div className="flex-1 flex gap-3 min-h-0">
|
<div className="flex-1 flex gap-4 min-h-0">
|
||||||
{/* Левая колонка - Поставщики и Расходники */}
|
{/* Левая колонка - Поставщики и Расходники */}
|
||||||
<div className="flex-1 flex flex-col gap-3 min-h-0">
|
<div className="flex-1 flex flex-col gap-4 min-h-0">
|
||||||
{/* Блок "Поставщики" */}
|
{/* Блок "Поставщики" */}
|
||||||
<Card className="bg-gradient-to-r from-white/15 via-white/10 to-white/15 backdrop-blur-xl border border-white/30 shadow-2xl flex-shrink-0 sticky top-0 z-10 rounded-xl overflow-hidden">
|
<Card className="bg-gradient-to-r from-white/15 via-white/10 to-white/15 backdrop-blur-xl border border-white/30 shadow-2xl flex-shrink-0 sticky top-0 z-10 rounded-xl overflow-hidden">
|
||||||
<div className="p-3 bg-gradient-to-r from-purple-500/10 to-pink-500/10">
|
<div className="p-3 bg-gradient-to-r from-purple-500/10 to-pink-500/10">
|
||||||
|
@ -33,6 +33,10 @@ import {
|
|||||||
import {
|
import {
|
||||||
GET_MY_COUNTERPARTIES,
|
GET_MY_COUNTERPARTIES,
|
||||||
GET_ORGANIZATION_PRODUCTS,
|
GET_ORGANIZATION_PRODUCTS,
|
||||||
|
GET_MY_SERVICES,
|
||||||
|
GET_MY_SUPPLIES,
|
||||||
|
GET_SELLER_SUPPLIES_ON_WAREHOUSE,
|
||||||
|
GET_MY_WILDBERRIES_SUPPLIES,
|
||||||
} from "@/graphql/queries";
|
} from "@/graphql/queries";
|
||||||
import { CREATE_SUPPLY_ORDER } from "@/graphql/mutations";
|
import { CREATE_SUPPLY_ORDER } from "@/graphql/mutations";
|
||||||
import { OrganizationAvatar } from "@/components/market/organization-avatar";
|
import { OrganizationAvatar } from "@/components/market/organization-avatar";
|
||||||
@ -102,6 +106,47 @@ interface LogisticsCompany {
|
|||||||
type: "EXPRESS" | "STANDARD" | "ECONOMY";
|
type: "EXPRESS" | "STANDARD" | "ECONOMY";
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Новые интерфейсы для компонентов рецептуры
|
||||||
|
interface FulfillmentService {
|
||||||
|
id: string;
|
||||||
|
name: string;
|
||||||
|
description?: string;
|
||||||
|
price: number;
|
||||||
|
category?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface FulfillmentConsumable {
|
||||||
|
id: string;
|
||||||
|
name: string;
|
||||||
|
price: number;
|
||||||
|
stock: number;
|
||||||
|
unit?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface SellerConsumable {
|
||||||
|
id: string;
|
||||||
|
name: string;
|
||||||
|
stock: number;
|
||||||
|
unit?: string;
|
||||||
|
supplierId: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface WBCard {
|
||||||
|
id: string;
|
||||||
|
title: string;
|
||||||
|
nmID: string;
|
||||||
|
vendorCode?: string;
|
||||||
|
brand?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface ProductRecipe {
|
||||||
|
productId: string;
|
||||||
|
selectedServices: string[];
|
||||||
|
selectedFFConsumables: string[];
|
||||||
|
selectedSellerConsumables: string[];
|
||||||
|
selectedWBCard?: string;
|
||||||
|
}
|
||||||
|
|
||||||
export function CreateSuppliersSupplyPage() {
|
export function CreateSuppliersSupplyPage() {
|
||||||
const router = useRouter();
|
const router = useRouter();
|
||||||
const { user } = useAuth();
|
const { user } = useAuth();
|
||||||
@ -127,8 +172,9 @@ export function CreateSuppliersSupplyPage() {
|
|||||||
const [isModalOpen, setIsModalOpen] = useState(false);
|
const [isModalOpen, setIsModalOpen] = useState(false);
|
||||||
|
|
||||||
const [isCreatingSupply, setIsCreatingSupply] = useState(false);
|
const [isCreatingSupply, setIsCreatingSupply] = useState(false);
|
||||||
|
|
||||||
// Состояние количества товаров для карточек согласно rules2.md 13.3
|
// Состояния для компонентов рецептуры
|
||||||
|
const [productRecipes, setProductRecipes] = useState<Record<string, ProductRecipe>>({});
|
||||||
const [productQuantities, setProductQuantities] = useState<Record<string, number>>({});
|
const [productQuantities, setProductQuantities] = useState<Record<string, number>>({});
|
||||||
|
|
||||||
// Загружаем партнеров-поставщиков согласно rules2.md 13.3
|
// Загружаем партнеров-поставщиков согласно rules2.md 13.3
|
||||||
@ -191,9 +237,36 @@ export function CreateSuppliersSupplyPage() {
|
|||||||
// Мутация создания поставки
|
// Мутация создания поставки
|
||||||
const [createSupplyOrder] = useMutation(CREATE_SUPPLY_ORDER);
|
const [createSupplyOrder] = useMutation(CREATE_SUPPLY_ORDER);
|
||||||
|
|
||||||
|
// Запросы для компонентов рецептуры
|
||||||
|
const { data: fulfillmentServicesData } = useQuery(GET_MY_SERVICES, {
|
||||||
|
skip: !selectedFulfillment,
|
||||||
|
errorPolicy: 'all'
|
||||||
|
});
|
||||||
|
|
||||||
|
const { data: fulfillmentConsumablesData } = useQuery(GET_MY_SUPPLIES, {
|
||||||
|
skip: !selectedFulfillment,
|
||||||
|
errorPolicy: 'all'
|
||||||
|
});
|
||||||
|
|
||||||
|
const { data: sellerConsumablesData } = useQuery(GET_SELLER_SUPPLIES_ON_WAREHOUSE, {
|
||||||
|
skip: !user?.organization?.id,
|
||||||
|
errorPolicy: 'all'
|
||||||
|
});
|
||||||
|
|
||||||
|
const { data: wbCardsData } = useQuery(GET_MY_WILDBERRIES_SUPPLIES, {
|
||||||
|
skip: !user?.organization?.id,
|
||||||
|
errorPolicy: 'all'
|
||||||
|
});
|
||||||
|
|
||||||
// Фильтруем только партнеров-поставщиков согласно rules2.md 13.3
|
// Фильтруем только партнеров-поставщиков согласно rules2.md 13.3
|
||||||
const allCounterparties = counterpartiesData?.myCounterparties || [];
|
const allCounterparties = counterpartiesData?.myCounterparties || [];
|
||||||
|
|
||||||
|
// Извлекаем данные для компонентов рецептуры
|
||||||
|
const fulfillmentServices: FulfillmentService[] = fulfillmentServicesData?.myServices || [];
|
||||||
|
const fulfillmentConsumables: FulfillmentConsumable[] = fulfillmentConsumablesData?.mySupplies || [];
|
||||||
|
const sellerConsumables: SellerConsumable[] = sellerConsumablesData?.sellerSuppliesOnWarehouse || [];
|
||||||
|
const wbCards: WBCard[] = (wbCardsData?.myWildberriesSupplies || []).flatMap((supply: any) => supply.cards || []);
|
||||||
|
|
||||||
// Показываем только партнеров с типом WHOLESALE согласно rules2.md 13.3
|
// Показываем только партнеров с типом WHOLESALE согласно rules2.md 13.3
|
||||||
const wholesaleSuppliers = allCounterparties.filter((cp: any) => {
|
const wholesaleSuppliers = allCounterparties.filter((cp: any) => {
|
||||||
try {
|
try {
|
||||||
@ -345,6 +418,106 @@ export function CreateSuppliersSupplyPage() {
|
|||||||
setIsModalOpen(true);
|
setIsModalOpen(true);
|
||||||
};
|
};
|
||||||
|
|
||||||
|
// Функции для работы с рецептурой
|
||||||
|
const initializeProductRecipe = (productId: string) => {
|
||||||
|
if (!productRecipes[productId]) {
|
||||||
|
setProductRecipes(prev => ({
|
||||||
|
...prev,
|
||||||
|
[productId]: {
|
||||||
|
productId,
|
||||||
|
selectedServices: [],
|
||||||
|
selectedFFConsumables: [],
|
||||||
|
selectedSellerConsumables: [],
|
||||||
|
selectedWBCard: undefined
|
||||||
|
}
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const toggleService = (productId: string, serviceId: string) => {
|
||||||
|
initializeProductRecipe(productId);
|
||||||
|
setProductRecipes(prev => {
|
||||||
|
const recipe = prev[productId];
|
||||||
|
const isSelected = recipe.selectedServices.includes(serviceId);
|
||||||
|
return {
|
||||||
|
...prev,
|
||||||
|
[productId]: {
|
||||||
|
...recipe,
|
||||||
|
selectedServices: isSelected
|
||||||
|
? recipe.selectedServices.filter(id => id !== serviceId)
|
||||||
|
: [...recipe.selectedServices, serviceId]
|
||||||
|
}
|
||||||
|
};
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
const toggleFFConsumable = (productId: string, consumableId: string) => {
|
||||||
|
initializeProductRecipe(productId);
|
||||||
|
setProductRecipes(prev => {
|
||||||
|
const recipe = prev[productId];
|
||||||
|
const isSelected = recipe.selectedFFConsumables.includes(consumableId);
|
||||||
|
return {
|
||||||
|
...prev,
|
||||||
|
[productId]: {
|
||||||
|
...recipe,
|
||||||
|
selectedFFConsumables: isSelected
|
||||||
|
? recipe.selectedFFConsumables.filter(id => id !== consumableId)
|
||||||
|
: [...recipe.selectedFFConsumables, consumableId]
|
||||||
|
}
|
||||||
|
};
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
const toggleSellerConsumable = (productId: string, consumableId: string) => {
|
||||||
|
initializeProductRecipe(productId);
|
||||||
|
setProductRecipes(prev => {
|
||||||
|
const recipe = prev[productId];
|
||||||
|
const isSelected = recipe.selectedSellerConsumables.includes(consumableId);
|
||||||
|
return {
|
||||||
|
...prev,
|
||||||
|
[productId]: {
|
||||||
|
...recipe,
|
||||||
|
selectedSellerConsumables: isSelected
|
||||||
|
? recipe.selectedSellerConsumables.filter(id => id !== consumableId)
|
||||||
|
: [...recipe.selectedSellerConsumables, consumableId]
|
||||||
|
}
|
||||||
|
};
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
const setWBCard = (productId: string, cardId: string) => {
|
||||||
|
initializeProductRecipe(productId);
|
||||||
|
setProductRecipes(prev => ({
|
||||||
|
...prev,
|
||||||
|
[productId]: {
|
||||||
|
...prev[productId],
|
||||||
|
selectedWBCard: cardId
|
||||||
|
}
|
||||||
|
}));
|
||||||
|
};
|
||||||
|
|
||||||
|
// Расчет стоимости компонентов рецептуры
|
||||||
|
const calculateRecipeCost = (productId: string) => {
|
||||||
|
const recipe = productRecipes[productId];
|
||||||
|
if (!recipe) return { services: 0, consumables: 0, total: 0 };
|
||||||
|
|
||||||
|
const servicesTotal = recipe.selectedServices.reduce((sum, serviceId) => {
|
||||||
|
const service = fulfillmentServices.find(s => s.id === serviceId);
|
||||||
|
return sum + (service?.price || 0);
|
||||||
|
}, 0);
|
||||||
|
|
||||||
|
const consumablesTotal = recipe.selectedFFConsumables.reduce((sum, consumableId) => {
|
||||||
|
const consumable = fulfillmentConsumables.find(c => c.id === consumableId);
|
||||||
|
return sum + (consumable?.price || 0);
|
||||||
|
}, 0);
|
||||||
|
|
||||||
|
return {
|
||||||
|
services: servicesTotal,
|
||||||
|
consumables: consumablesTotal,
|
||||||
|
total: servicesTotal + consumablesTotal
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
// Добавление товара в корзину из модального окна с дополнительными данными
|
// Добавление товара в корзину из модального окна с дополнительными данными
|
||||||
const addToCartFromModal = (
|
const addToCartFromModal = (
|
||||||
product: GoodsProduct,
|
product: GoodsProduct,
|
||||||
@ -418,7 +591,7 @@ export function CreateSuppliersSupplyPage() {
|
|||||||
const totalQuantity = selectedGoods.reduce((sum, item) => sum + item.selectedQuantity, 0);
|
const totalQuantity = selectedGoods.reduce((sum, item) => sum + item.selectedQuantity, 0);
|
||||||
const fulfillmentFee = totalGoodsAmount * 0.08; // 8% комиссия фулфилмента
|
const fulfillmentFee = totalGoodsAmount * 0.08; // 8% комиссия фулфилмента
|
||||||
const selectedLogisticsCompany = logisticsCompanies.find(lc => lc.id === selectedLogistics);
|
const selectedLogisticsCompany = logisticsCompanies.find(lc => lc.id === selectedLogistics);
|
||||||
const logisticsCost = selectedLogistics === "auto" ? 1000 : (selectedLogisticsCompany?.estimatedCost || 0);
|
const logisticsCost = selectedLogistics === "auto" ? 0 : (selectedLogisticsCompany?.estimatedCost || 0);
|
||||||
const totalAmount = totalGoodsAmount + fulfillmentFee + logisticsCost;
|
const totalAmount = totalGoodsAmount + fulfillmentFee + logisticsCost;
|
||||||
|
|
||||||
// Валидация формы согласно rules2.md 9.7.6
|
// Валидация формы согласно rules2.md 9.7.6
|
||||||
@ -475,14 +648,14 @@ export function CreateSuppliersSupplyPage() {
|
|||||||
return (
|
return (
|
||||||
<div className="h-screen flex overflow-hidden">
|
<div className="h-screen flex overflow-hidden">
|
||||||
<Sidebar />
|
<Sidebar />
|
||||||
<main className={`flex-1 ${getSidebarMargin()} overflow-hidden transition-all duration-300`}>
|
<main className={`flex-1 ${getSidebarMargin()} overflow-hidden transition-all duration-300 p-4`}>
|
||||||
<div className="h-full flex flex-col">
|
<div className="h-full flex flex-col gap-4">
|
||||||
|
|
||||||
{/* СТРУКТУРА ИЗ 3 БЛОКОВ согласно rules1.md 19.2.1 - блоки точно по уровню сайдбара */}
|
{/* СТРУКТУРА ИЗ 3 БЛОКОВ согласно rules1.md 19.2.1 - блоки точно по уровню сайдбара */}
|
||||||
<div className="flex-1 flex gap-2 min-h-0">
|
<div className="flex-1 flex gap-4 min-h-0">
|
||||||
|
|
||||||
{/* ЛЕВЫЙ БЛОК: ПОСТАВЩИКИ И ТОВАРЫ */}
|
{/* ЛЕВЫЙ БЛОК: ПОСТАВЩИКИ И ТОВАРЫ */}
|
||||||
<div className="flex-1 flex flex-col gap-2 min-h-0">
|
<div className="flex-1 flex flex-col gap-4 min-h-0">
|
||||||
|
|
||||||
{/* БЛОК 1: ПОСТАВЩИКИ - обязательный блок согласно rules1.md 19.2.1 */}
|
{/* БЛОК 1: ПОСТАВЩИКИ - обязательный блок согласно rules1.md 19.2.1 */}
|
||||||
<div className="bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl flex-shrink-0 flex flex-col"
|
<div className="bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl flex-shrink-0 flex flex-col"
|
||||||
@ -702,107 +875,279 @@ export function CreateSuppliersSupplyPage() {
|
|||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
) : (
|
) : (
|
||||||
<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
|
<div className="space-y-4">
|
||||||
{products.map((product: GoodsProduct) => (
|
{products.map((product: GoodsProduct) => (
|
||||||
<div
|
<div
|
||||||
key={product.id}
|
key={product.id}
|
||||||
className="glass-card hover:border-white/20 hover:bg-white/10 hover:scale-105 hover:shadow-xl hover:shadow-blue-500/20 transition-all duration-200 cursor-pointer group"
|
className="bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl p-4 hover:border-white/30 transition-all duration-200"
|
||||||
>
|
>
|
||||||
<div className="p-5 space-y-4">
|
{/* ОСНОВНОЙ БЛОК: Информация о товаре + количество + сумма */}
|
||||||
{product.mainImage && (
|
<div className="flex items-start gap-6 mb-4">
|
||||||
<div className="w-full h-40 rounded-lg overflow-hidden bg-white/5">
|
|
||||||
<Image
|
|
||||||
src={product.mainImage}
|
|
||||||
alt={product.name}
|
|
||||||
width={280}
|
|
||||||
height={160}
|
|
||||||
className="w-full h-full object-cover group-hover:scale-110 transition-transform duration-300"
|
|
||||||
/>
|
|
||||||
</div>
|
|
||||||
)}
|
|
||||||
|
|
||||||
<div className="space-y-3">
|
{/* ЛЕВЫЙ БЛОК: Изображение + основная информация */}
|
||||||
<div>
|
<div className="flex items-start gap-4 flex-1">
|
||||||
<h4 className="text-white font-semibold text-base line-clamp-2 group-hover:text-white transition-colors">
|
<div className="w-24 h-24 bg-white/5 rounded-lg overflow-hidden flex-shrink-0">
|
||||||
{product.name}
|
{product.mainImage ? (
|
||||||
</h4>
|
<Image
|
||||||
<p className="text-white/60 text-sm font-mono mt-1">Артикул: {product.article}</p>
|
src={product.mainImage}
|
||||||
</div>
|
alt={product.name}
|
||||||
|
width={96}
|
||||||
{product.category && (
|
height={96}
|
||||||
<Badge className="bg-blue-500/20 text-blue-300 border border-blue-500/30 text-xs font-medium">
|
className="w-full h-full object-cover"
|
||||||
{product.category.name}
|
/>
|
||||||
</Badge>
|
) : (
|
||||||
)}
|
<div className="w-full h-full flex items-center justify-center">
|
||||||
|
<Package className="h-8 w-8 text-white/40" />
|
||||||
<div className="space-y-3">
|
|
||||||
<div className="flex items-center justify-between">
|
|
||||||
<div className="space-y-1">
|
|
||||||
<p className="text-white font-bold text-lg">
|
|
||||||
{product.price.toLocaleString('ru-RU')} ₽
|
|
||||||
</p>
|
|
||||||
<p className="text-white/60 text-xs">за единицу</p>
|
|
||||||
</div>
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
<div className="flex-1">
|
||||||
|
<h4 className="text-white font-semibold text-lg mb-1">{product.name}</h4>
|
||||||
|
<p className="text-white/60 text-sm mb-2 font-mono">Артикул: {product.article}</p>
|
||||||
|
{product.category && (
|
||||||
|
<Badge className="bg-blue-500/20 text-blue-300 border border-blue-500/30 text-xs font-medium mb-2">
|
||||||
|
{product.category.name}
|
||||||
|
</Badge>
|
||||||
|
)}
|
||||||
|
<div className="flex items-center gap-4">
|
||||||
|
<span className="text-white font-bold text-xl">{product.price.toLocaleString('ru-RU')} ₽</span>
|
||||||
{product.quantity !== undefined && (
|
{product.quantity !== undefined && (
|
||||||
<div className="flex items-center gap-1">
|
<div className="flex items-center gap-2">
|
||||||
<div className={`w-2 h-2 rounded-full ${
|
<div className={`w-2 h-2 rounded-full ${
|
||||||
product.quantity > 0 ? 'bg-green-400' : 'bg-red-400'
|
product.quantity > 0 ? 'bg-green-400' : 'bg-red-400'
|
||||||
}`}></div>
|
}`}></div>
|
||||||
<p className={`text-xs font-medium ${
|
<span className={`text-sm font-medium ${
|
||||||
product.quantity > 0 ? 'text-green-400' : 'text-red-400'
|
product.quantity > 0 ? 'text-green-400' : 'text-red-400'
|
||||||
}`}>
|
}`}>
|
||||||
{product.quantity > 0
|
{product.quantity > 0
|
||||||
? `Доступно: ${product.quantity}`
|
? `Доступно: ${product.quantity}`
|
||||||
: 'Нет в наличии'
|
: 'Нет в наличии'
|
||||||
}
|
}
|
||||||
</p>
|
</span>
|
||||||
</div>
|
</div>
|
||||||
)}
|
)}
|
||||||
</div>
|
</div>
|
||||||
|
</div>
|
||||||
{/* Поле количества с кнопками +/- согласно rules2.md 13.3 */}
|
</div>
|
||||||
<div className="flex items-center gap-2">
|
|
||||||
<Button
|
{/* ПРАВЫЙ БЛОК: Количество + общая сумма */}
|
||||||
size="sm"
|
<div className="flex items-center gap-4 flex-shrink-0">
|
||||||
variant="outline"
|
<div className="flex items-center gap-2">
|
||||||
onClick={() => updateProductQuantity(product.id, -1)}
|
|
||||||
className="h-8 w-8 p-0 bg-white/5 border-white/20 hover:bg-white/10 hover:border-white/30 text-white"
|
|
||||||
disabled={!getProductQuantity(product.id) || getProductQuantity(product.id) <= 0}
|
|
||||||
>
|
|
||||||
<Minus className="h-3 w-3" />
|
|
||||||
</Button>
|
|
||||||
|
|
||||||
<Input
|
|
||||||
type="number"
|
|
||||||
min="0"
|
|
||||||
max={product.quantity}
|
|
||||||
value={getProductQuantity(product.id) || ""}
|
|
||||||
onChange={(e) => setProductQuantity(product.id, parseInt(e.target.value) || 0)}
|
|
||||||
className="h-8 w-20 text-center bg-white/5 border-white/20 text-white placeholder:text-white/40 focus:border-white/40"
|
|
||||||
placeholder="00000"
|
|
||||||
/>
|
|
||||||
|
|
||||||
<Button
|
|
||||||
size="sm"
|
|
||||||
variant="outline"
|
|
||||||
onClick={() => updateProductQuantity(product.id, 1)}
|
|
||||||
className="h-8 w-8 p-0 bg-white/5 border-white/20 hover:bg-white/10 hover:border-white/30 text-white"
|
|
||||||
disabled={product.quantity === 0 || getProductQuantity(product.id) >= product.quantity}
|
|
||||||
>
|
|
||||||
<Plus className="h-3 w-3" />
|
|
||||||
</Button>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<Button
|
<Button
|
||||||
size="sm"
|
size="sm"
|
||||||
onClick={() => addToCart(product)}
|
variant="outline"
|
||||||
className="w-full bg-gradient-to-r from-green-500 to-emerald-500 hover:from-green-600 hover:to-emerald-600 text-white border border-green-500/30 hover:border-green-400/50 transition-all duration-200 h-8 text-xs"
|
onClick={() => updateProductQuantity(product.id, -1)}
|
||||||
disabled={product.quantity === 0 || !getProductQuantity(product.id)}
|
className="h-8 w-8 p-0 bg-white/5 border-white/20 hover:bg-white/10 hover:border-white/30 text-white"
|
||||||
|
disabled={!getProductQuantity(product.id) || getProductQuantity(product.id) <= 0}
|
||||||
>
|
>
|
||||||
<ShoppingCart className="h-3 w-3 mr-1" />
|
<Minus className="h-3 w-3" />
|
||||||
В корзину
|
</Button>
|
||||||
|
|
||||||
|
<Input
|
||||||
|
type="number"
|
||||||
|
min="0"
|
||||||
|
max={product.quantity}
|
||||||
|
value={getProductQuantity(product.id) || ""}
|
||||||
|
onChange={(e) => setProductQuantity(product.id, parseInt(e.target.value) || 0)}
|
||||||
|
className="h-8 w-20 text-center bg-white/5 border-white/20 text-white placeholder:text-white/40 focus:border-white/40"
|
||||||
|
placeholder="0"
|
||||||
|
/>
|
||||||
|
|
||||||
|
<Button
|
||||||
|
size="sm"
|
||||||
|
variant="outline"
|
||||||
|
onClick={() => updateProductQuantity(product.id, 1)}
|
||||||
|
className="h-8 w-8 p-0 bg-white/5 border-white/20 hover:bg-white/10 hover:border-white/30 text-white"
|
||||||
|
disabled={product.quantity === 0 || getProductQuantity(product.id) >= (product.quantity || 0)}
|
||||||
|
>
|
||||||
|
<Plus className="h-3 w-3" />
|
||||||
</Button>
|
</Button>
|
||||||
</div>
|
</div>
|
||||||
|
{getProductQuantity(product.id) > 0 && (
|
||||||
|
<div className="bg-gradient-to-r from-green-500/10 to-emerald-500/10 border border-green-500/20 rounded-lg px-4 py-2">
|
||||||
|
<span className="text-green-400 font-bold text-lg">
|
||||||
|
{(product.price * getProductQuantity(product.id)).toLocaleString('ru-RU')} ₽
|
||||||
|
</span>
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* БЛОК РЕЦЕПТУРЫ: 4 колонки с чекбоксами */}
|
||||||
|
<div className="grid grid-cols-4 gap-4 pt-4 border-t border-white/10 mb-4">
|
||||||
|
|
||||||
|
{/* КОЛОНКА 1: Услуги фулфилмента */}
|
||||||
|
<div className="space-y-2">
|
||||||
|
<h5 className="text-white/80 font-medium text-sm flex items-center gap-2">
|
||||||
|
<Settings className="h-4 w-4 text-purple-400" />
|
||||||
|
Услуги ФФ
|
||||||
|
</h5>
|
||||||
|
<div className="space-y-1 max-h-32 overflow-y-auto">
|
||||||
|
{fulfillmentServices.length > 0 ? fulfillmentServices.map(service => {
|
||||||
|
const recipe = productRecipes[product.id];
|
||||||
|
const isSelected = recipe?.selectedServices.includes(service.id) || false;
|
||||||
|
return (
|
||||||
|
<label key={service.id} className="flex items-center gap-2 text-xs cursor-pointer hover:bg-white/5 p-1 rounded">
|
||||||
|
<input
|
||||||
|
type="checkbox"
|
||||||
|
checked={isSelected}
|
||||||
|
onChange={() => toggleService(product.id, service.id)}
|
||||||
|
className="w-3 h-3 rounded bg-white/10 border-white/20 text-purple-400 focus:ring-purple-400/50 focus:ring-offset-0"
|
||||||
|
/>
|
||||||
|
<span className="text-white/70 flex-1 truncate">{service.name}</span>
|
||||||
|
<span className="text-purple-400 text-xs font-medium">{service.price.toLocaleString('ru-RU')}₽</span>
|
||||||
|
</label>
|
||||||
|
);
|
||||||
|
}) : (
|
||||||
|
<div className="text-white/50 text-xs p-2 bg-white/5 rounded border border-white/10">
|
||||||
|
{selectedFulfillment ? 'Услуги загружаются...' : 'Выберите фулфилмент-центр'}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* КОЛОНКА 2: Расходники фулфилмента */}
|
||||||
|
<div className="space-y-2">
|
||||||
|
<h5 className="text-white/80 font-medium text-sm flex items-center gap-2">
|
||||||
|
<Box className="h-4 w-4 text-orange-400" />
|
||||||
|
Расходники ФФ
|
||||||
|
</h5>
|
||||||
|
<div className="space-y-1 max-h-32 overflow-y-auto">
|
||||||
|
{fulfillmentConsumables.length > 0 ? fulfillmentConsumables.map(consumable => {
|
||||||
|
const recipe = productRecipes[product.id];
|
||||||
|
const isSelected = recipe?.selectedFFConsumables.includes(consumable.id) || false;
|
||||||
|
return (
|
||||||
|
<label key={consumable.id} className="flex items-center gap-2 text-xs cursor-pointer hover:bg-white/5 p-1 rounded">
|
||||||
|
<input
|
||||||
|
type="checkbox"
|
||||||
|
checked={isSelected}
|
||||||
|
onChange={() => toggleFFConsumable(product.id, consumable.id)}
|
||||||
|
className="w-3 h-3 rounded bg-white/10 border-white/20 text-orange-400 focus:ring-orange-400/50 focus:ring-offset-0"
|
||||||
|
/>
|
||||||
|
<span className="text-white/70 flex-1 truncate">{consumable.name}</span>
|
||||||
|
<span className="text-orange-400 text-xs font-medium">{consumable.price.toLocaleString('ru-RU')}₽</span>
|
||||||
|
</label>
|
||||||
|
);
|
||||||
|
}) : (
|
||||||
|
<div className="text-white/50 text-xs p-2 bg-white/5 rounded border border-white/10">
|
||||||
|
{selectedFulfillment ? 'Расходники загружаются...' : 'Выберите фулфилмент-центр'}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* КОЛОНКА 3: Расходники селлера */}
|
||||||
|
<div className="space-y-2">
|
||||||
|
<h5 className="text-white/80 font-medium text-sm flex items-center gap-2">
|
||||||
|
<Package className="h-4 w-4 text-blue-400" />
|
||||||
|
Расходники селлера
|
||||||
|
</h5>
|
||||||
|
<div className="space-y-1 max-h-32 overflow-y-auto">
|
||||||
|
{sellerConsumables.length > 0 ? sellerConsumables.map(consumable => {
|
||||||
|
const recipe = productRecipes[product.id];
|
||||||
|
const isSelected = recipe?.selectedSellerConsumables.includes(consumable.id) || false;
|
||||||
|
return (
|
||||||
|
<label key={consumable.id} className="flex items-center gap-2 text-xs cursor-pointer hover:bg-white/5 p-1 rounded">
|
||||||
|
<input
|
||||||
|
type="checkbox"
|
||||||
|
checked={isSelected}
|
||||||
|
onChange={() => toggleSellerConsumable(product.id, consumable.id)}
|
||||||
|
className="w-3 h-3 rounded bg-white/10 border-white/20 text-blue-400 focus:ring-blue-400/50 focus:ring-offset-0"
|
||||||
|
/>
|
||||||
|
<span className="text-white/70 flex-1 truncate">{consumable.name}</span>
|
||||||
|
<span className="text-blue-400 text-xs">Склад: {consumable.stock}</span>
|
||||||
|
</label>
|
||||||
|
);
|
||||||
|
}) : (
|
||||||
|
<div className="text-white/50 text-xs p-2 bg-white/5 rounded border border-white/10">
|
||||||
|
Расходники селлера загружаются...
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* КОЛОНКА 4: Карточки Wildberries */}
|
||||||
|
<div className="space-y-2">
|
||||||
|
<h5 className="text-white/80 font-medium text-sm flex items-center gap-2">
|
||||||
|
<ShoppingCart className="h-4 w-4 text-pink-400" />
|
||||||
|
Карточки WB
|
||||||
|
</h5>
|
||||||
|
<div className="space-y-1 max-h-32 overflow-y-auto">
|
||||||
|
{wbCards.length > 0 ? wbCards.map(card => {
|
||||||
|
const recipe = productRecipes[product.id];
|
||||||
|
const isSelected = recipe?.selectedWBCard === card.id;
|
||||||
|
return (
|
||||||
|
<label key={card.id} className="flex items-center gap-2 text-xs cursor-pointer hover:bg-white/5 p-1 rounded">
|
||||||
|
<input
|
||||||
|
type="radio"
|
||||||
|
name={`wb-card-${product.id}`}
|
||||||
|
checked={isSelected}
|
||||||
|
onChange={() => setWBCard(product.id, card.id)}
|
||||||
|
className="w-3 h-3 rounded-full bg-white/10 border-white/20 text-pink-400 focus:ring-pink-400/50 focus:ring-offset-0"
|
||||||
|
/>
|
||||||
|
<span className="text-white/70 flex-1 truncate">{card.title}</span>
|
||||||
|
<span className="text-pink-400 text-xs">{card.nmID}</span>
|
||||||
|
</label>
|
||||||
|
);
|
||||||
|
}) : (
|
||||||
|
<div className="text-white/50 text-xs p-2 bg-white/5 rounded border border-white/10">
|
||||||
|
Карточки WB загружаются...
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* НИЖНИЙ БЛОК: Итоговая стоимость рецептуры + кнопка добавления */}
|
||||||
|
<div className="flex items-center justify-between pt-4 border-t border-white/10">
|
||||||
|
<div className="flex items-center gap-6">
|
||||||
|
{(() => {
|
||||||
|
const quantity = getProductQuantity(product.id);
|
||||||
|
const recipeCost = calculateRecipeCost(product.id);
|
||||||
|
const productTotal = product.price * quantity;
|
||||||
|
const totalRecipePrice = productTotal + recipeCost.total;
|
||||||
|
|
||||||
|
return (
|
||||||
|
<>
|
||||||
|
<div className="text-sm text-white/70">
|
||||||
|
Товар: <span className="text-white font-semibold">{productTotal.toLocaleString('ru-RU')} ₽</span>
|
||||||
|
</div>
|
||||||
|
<div className="text-sm text-white/70">
|
||||||
|
Услуги: <span className="text-purple-400 font-semibold">{recipeCost.services.toLocaleString('ru-RU')} ₽</span>
|
||||||
|
</div>
|
||||||
|
<div className="text-sm text-white/70">
|
||||||
|
Расходники: <span className="text-orange-400 font-semibold">{recipeCost.consumables.toLocaleString('ru-RU')} ₽</span>
|
||||||
|
</div>
|
||||||
|
</>
|
||||||
|
);
|
||||||
|
})()}
|
||||||
|
</div>
|
||||||
|
<div className="flex items-center gap-4">
|
||||||
|
{(() => {
|
||||||
|
const quantity = getProductQuantity(product.id);
|
||||||
|
const recipeCost = calculateRecipeCost(product.id);
|
||||||
|
const productTotal = product.price * quantity;
|
||||||
|
const totalRecipePrice = productTotal + recipeCost.total;
|
||||||
|
|
||||||
|
return (
|
||||||
|
<>
|
||||||
|
<div className="bg-gradient-to-r from-green-500/20 to-emerald-500/20 border border-green-500/30 rounded-lg px-4 py-2">
|
||||||
|
<span className="text-white/70 text-sm">Итого: </span>
|
||||||
|
<span className="text-green-400 font-bold text-lg">
|
||||||
|
{totalRecipePrice.toLocaleString('ru-RU')} ₽
|
||||||
|
</span>
|
||||||
|
</div>
|
||||||
|
<Button
|
||||||
|
onClick={() => addToCart(product)}
|
||||||
|
disabled={quantity === 0}
|
||||||
|
className="bg-gradient-to-r from-green-500 to-emerald-500 hover:from-green-600 hover:to-emerald-600 text-white border border-green-500/30 hover:border-green-400/50 transition-all duration-200"
|
||||||
|
>
|
||||||
|
<ShoppingCart className="h-4 w-4 mr-2" />
|
||||||
|
Добавить рецептуру
|
||||||
|
</Button>
|
||||||
|
</>
|
||||||
|
);
|
||||||
|
})()}
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
@ -216,11 +216,11 @@ export function CreateSupplyPage() {
|
|||||||
<div className="h-screen flex overflow-hidden">
|
<div className="h-screen flex overflow-hidden">
|
||||||
<Sidebar />
|
<Sidebar />
|
||||||
<main
|
<main
|
||||||
className={`flex-1 ${getSidebarMargin()} overflow-auto transition-all duration-300`}
|
className={`flex-1 ${getSidebarMargin()} overflow-auto transition-all duration-300 p-4`}
|
||||||
>
|
>
|
||||||
<div className="min-h-full w-full flex flex-col px-3 py-2">
|
<div className="min-h-full w-full flex flex-col gap-4">
|
||||||
{/* Заголовок */}
|
{/* Заголовок */}
|
||||||
<div className="flex items-center justify-between mb-3 flex-shrink-0">
|
<div className="flex items-center justify-between flex-shrink-0">
|
||||||
<div>
|
<div>
|
||||||
<h1 className="text-xl font-bold text-white mb-1">
|
<h1 className="text-xl font-bold text-white mb-1">
|
||||||
Создание поставки товаров
|
Создание поставки товаров
|
||||||
@ -241,7 +241,7 @@ export function CreateSupplyPage() {
|
|||||||
</div>
|
</div>
|
||||||
|
|
||||||
{/* Основной контент - карточки Wildberries */}
|
{/* Основной контент - карточки Wildberries */}
|
||||||
<div className="flex-1 flex gap-3 min-h-0">
|
<div className="flex-1 flex gap-4 min-h-0">
|
||||||
{/* Левая колонка - карточки товаров */}
|
{/* Левая колонка - карточки товаров */}
|
||||||
<div className="flex-1 min-h-0">
|
<div className="flex-1 min-h-0">
|
||||||
<DirectSupplyCreation
|
<DirectSupplyCreation
|
||||||
|
@ -6,6 +6,8 @@ import { Button } from "@/components/ui/button";
|
|||||||
import { Badge } from "@/components/ui/badge";
|
import { Badge } from "@/components/ui/badge";
|
||||||
import { StatsCard } from "../ui/stats-card";
|
import { StatsCard } from "../ui/stats-card";
|
||||||
import { StatsGrid } from "../ui/stats-grid";
|
import { StatsGrid } from "../ui/stats-grid";
|
||||||
|
import { useQuery } from "@apollo/client";
|
||||||
|
import { GET_MY_FULFILLMENT_SUPPLIES } from "@/graphql/queries";
|
||||||
import {
|
import {
|
||||||
ChevronDown,
|
ChevronDown,
|
||||||
ChevronRight,
|
ChevronRight,
|
||||||
@ -79,73 +81,12 @@ interface FulfillmentConsumableSupply {
|
|||||||
status: "planned" | "in-transit" | "delivered" | "completed";
|
status: "planned" | "in-transit" | "delivered" | "completed";
|
||||||
}
|
}
|
||||||
|
|
||||||
// Моковые данные для расходников фулфилмента
|
|
||||||
const mockFulfillmentConsumables: FulfillmentConsumableSupply[] = [
|
|
||||||
{
|
|
||||||
id: "ffc1",
|
|
||||||
number: 2001,
|
|
||||||
deliveryDate: "2024-01-18",
|
|
||||||
createdDate: "2024-01-14",
|
|
||||||
status: "delivered",
|
|
||||||
plannedTotal: 5000,
|
|
||||||
actualTotal: 4950,
|
|
||||||
defectTotal: 50,
|
|
||||||
totalConsumablesPrice: 125000,
|
|
||||||
totalLogisticsPrice: 8000,
|
|
||||||
grandTotal: 133000,
|
|
||||||
routes: [
|
|
||||||
{
|
|
||||||
id: "ffcr1",
|
|
||||||
from: "Склад расходников",
|
|
||||||
fromAddress: "Москва, ул. Промышленная, 12",
|
|
||||||
to: "SFERAV Logistics ФФ",
|
|
||||||
toAddress: "Москва, ул. Складская, 15",
|
|
||||||
totalConsumablesPrice: 125000,
|
|
||||||
logisticsPrice: 8000,
|
|
||||||
totalAmount: 133000,
|
|
||||||
suppliers: [
|
|
||||||
{
|
|
||||||
id: "ffcs1",
|
|
||||||
name: 'ООО "УпакСервис ФФ"',
|
|
||||||
inn: "7703456789",
|
|
||||||
contact: "+7 (495) 777-88-99",
|
|
||||||
address: "Москва, ул. Упаковочная, 5",
|
|
||||||
totalAmount: 75000,
|
|
||||||
consumables: [
|
|
||||||
{
|
|
||||||
id: "ffcons1",
|
|
||||||
name: "Коробки для ФФ 40x30x15",
|
|
||||||
sku: "BOX-FF-403015",
|
|
||||||
category: "Расходники фулфилмента",
|
|
||||||
type: "packaging",
|
|
||||||
plannedQty: 2000,
|
|
||||||
actualQty: 1980,
|
|
||||||
defectQty: 20,
|
|
||||||
unitPrice: 45,
|
|
||||||
parameters: [
|
|
||||||
{
|
|
||||||
id: "ffcp1",
|
|
||||||
name: "Размер",
|
|
||||||
value: "40x30x15",
|
|
||||||
unit: "см",
|
|
||||||
},
|
|
||||||
{
|
|
||||||
id: "ffcp2",
|
|
||||||
name: "Материал",
|
|
||||||
value: "Гофрокартон усиленный",
|
|
||||||
},
|
|
||||||
{ id: "ffcp3", name: "Плотность", value: "5", unit: "слоев" },
|
|
||||||
],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
];
|
|
||||||
|
|
||||||
export function FulfillmentSuppliesTab() {
|
export function FulfillmentSuppliesTab() {
|
||||||
|
// Загружаем реальные данные расходников фулфилмента
|
||||||
|
const { data: fulfillmentSuppliesData, loading, error } = useQuery(GET_MY_FULFILLMENT_SUPPLIES, {
|
||||||
|
errorPolicy: 'all'
|
||||||
|
});
|
||||||
|
|
||||||
const [expandedSupplies, setExpandedSupplies] = useState<Set<string>>(
|
const [expandedSupplies, setExpandedSupplies] = useState<Set<string>>(
|
||||||
new Set()
|
new Set()
|
||||||
);
|
);
|
||||||
@ -157,6 +98,23 @@ export function FulfillmentSuppliesTab() {
|
|||||||
new Set()
|
new Set()
|
||||||
);
|
);
|
||||||
|
|
||||||
|
// Преобразуем данные из GraphQL в нужный формат
|
||||||
|
const fulfillmentConsumables: FulfillmentConsumableSupply[] = (fulfillmentSuppliesData?.myFulfillmentSupplies || [])
|
||||||
|
.map((supply: any, index: number) => ({
|
||||||
|
id: supply.id,
|
||||||
|
number: index + 2000, // Начинаем с 2000 для отличия от товаров
|
||||||
|
deliveryDate: supply.date || new Date().toISOString().split('T')[0],
|
||||||
|
createdDate: supply.createdAt?.split('T')[0] || new Date().toISOString().split('T')[0],
|
||||||
|
status: supply.status === 'active' ? 'delivered' : 'planned',
|
||||||
|
plannedTotal: supply.quantity || 0,
|
||||||
|
actualTotal: supply.currentStock || 0,
|
||||||
|
defectTotal: 0,
|
||||||
|
totalConsumablesPrice: supply.price * (supply.quantity || 0),
|
||||||
|
totalLogisticsPrice: 0,
|
||||||
|
grandTotal: supply.price * (supply.quantity || 0),
|
||||||
|
routes: []
|
||||||
|
}));
|
||||||
|
|
||||||
const toggleSupplyExpansion = (supplyId: string) => {
|
const toggleSupplyExpansion = (supplyId: string) => {
|
||||||
const newExpanded = new Set(expandedSupplies);
|
const newExpanded = new Set(expandedSupplies);
|
||||||
if (newExpanded.has(supplyId)) {
|
if (newExpanded.has(supplyId)) {
|
||||||
@ -273,7 +231,7 @@ export function FulfillmentSuppliesTab() {
|
|||||||
<StatsGrid>
|
<StatsGrid>
|
||||||
<StatsCard
|
<StatsCard
|
||||||
title="Расходники фулфилмента"
|
title="Расходники фулфилмента"
|
||||||
value={mockFulfillmentConsumables.length}
|
value={loading ? 0 : fulfillmentConsumables.length}
|
||||||
icon={Package2}
|
icon={Package2}
|
||||||
iconColor="text-orange-400"
|
iconColor="text-orange-400"
|
||||||
iconBg="bg-orange-500/20"
|
iconBg="bg-orange-500/20"
|
||||||
@ -284,7 +242,7 @@ export function FulfillmentSuppliesTab() {
|
|||||||
<StatsCard
|
<StatsCard
|
||||||
title="Сумма расходников фулфилмента"
|
title="Сумма расходников фулфилмента"
|
||||||
value={formatCurrency(
|
value={formatCurrency(
|
||||||
mockFulfillmentConsumables.reduce(
|
loading ? 0 : fulfillmentConsumables.reduce(
|
||||||
(sum, supply) => sum + supply.grandTotal,
|
(sum, supply) => sum + supply.grandTotal,
|
||||||
0
|
0
|
||||||
)
|
)
|
||||||
@ -299,7 +257,7 @@ export function FulfillmentSuppliesTab() {
|
|||||||
<StatsCard
|
<StatsCard
|
||||||
title="В пути"
|
title="В пути"
|
||||||
value={
|
value={
|
||||||
mockFulfillmentConsumables.filter(
|
loading ? 0 : fulfillmentConsumables.filter(
|
||||||
(supply) => supply.status === "in-transit"
|
(supply) => supply.status === "in-transit"
|
||||||
).length
|
).length
|
||||||
}
|
}
|
||||||
@ -312,7 +270,7 @@ export function FulfillmentSuppliesTab() {
|
|||||||
<StatsCard
|
<StatsCard
|
||||||
title="Активные поставки"
|
title="Активные поставки"
|
||||||
value={
|
value={
|
||||||
mockFulfillmentConsumables.filter(
|
loading ? 0 : fulfillmentConsumables.filter(
|
||||||
(supply) => supply.status === "delivered"
|
(supply) => supply.status === "delivered"
|
||||||
).length
|
).length
|
||||||
}
|
}
|
||||||
@ -354,7 +312,25 @@ export function FulfillmentSuppliesTab() {
|
|||||||
</tr>
|
</tr>
|
||||||
</thead>
|
</thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
{mockFulfillmentConsumables.map((supply) => {
|
{loading && (
|
||||||
|
<tr>
|
||||||
|
<td colSpan={11} className="p-8 text-center">
|
||||||
|
<div className="text-white/60">Загрузка данных...</div>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
)}
|
||||||
|
{!loading && fulfillmentConsumables.length === 0 && (
|
||||||
|
<tr>
|
||||||
|
<td colSpan={11} className="p-8 text-center">
|
||||||
|
<div className="text-white/60">
|
||||||
|
<Package2 className="h-12 w-12 mx-auto mb-4 text-white/20" />
|
||||||
|
<div className="text-lg font-semibold text-white mb-2">Расходники фулфилмента не найдены</div>
|
||||||
|
<div>Создайте первую поставку расходников для фулфилмента</div>
|
||||||
|
</div>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
)}
|
||||||
|
{!loading && fulfillmentConsumables.map((supply) => {
|
||||||
const isSupplyExpanded = expandedSupplies.has(supply.id);
|
const isSupplyExpanded = expandedSupplies.has(supply.id);
|
||||||
|
|
||||||
return (
|
return (
|
||||||
|
@ -4,6 +4,8 @@ import React, { useState } from "react";
|
|||||||
import { Card } from "@/components/ui/card";
|
import { Card } from "@/components/ui/card";
|
||||||
import { Button } from "@/components/ui/button";
|
import { Button } from "@/components/ui/button";
|
||||||
import { Badge } from "@/components/ui/badge";
|
import { Badge } from "@/components/ui/badge";
|
||||||
|
import { useQuery } from "@apollo/client";
|
||||||
|
import { GET_SUPPLY_ORDERS } from "@/graphql/queries";
|
||||||
import {
|
import {
|
||||||
ChevronDown,
|
ChevronDown,
|
||||||
ChevronRight,
|
ChevronRight,
|
||||||
@ -75,119 +77,14 @@ interface Supply {
|
|||||||
status: "planned" | "in-transit" | "delivered" | "completed";
|
status: "planned" | "in-transit" | "delivered" | "completed";
|
||||||
}
|
}
|
||||||
|
|
||||||
// Моковые данные для товаров
|
// Данные поставок товаров из GraphQL
|
||||||
const mockGoodsSupplies: Supply[] = [
|
|
||||||
{
|
|
||||||
id: "1",
|
|
||||||
number: 1,
|
|
||||||
deliveryDate: "2024-01-15",
|
|
||||||
createdDate: "2024-01-10",
|
|
||||||
status: "delivered",
|
|
||||||
plannedTotal: 180,
|
|
||||||
actualTotal: 173,
|
|
||||||
defectTotal: 2,
|
|
||||||
totalProductPrice: 3750000,
|
|
||||||
totalFulfillmentPrice: 43000,
|
|
||||||
totalLogisticsPrice: 27000,
|
|
||||||
grandTotal: 3820000,
|
|
||||||
routes: [
|
|
||||||
{
|
|
||||||
id: "r1",
|
|
||||||
from: "Садовод",
|
|
||||||
fromAddress: "Москва, 14-й км МКАД",
|
|
||||||
to: "SFERAV Logistics",
|
|
||||||
toAddress: "Москва, ул. Складская, 15",
|
|
||||||
totalProductPrice: 3600000,
|
|
||||||
fulfillmentServicePrice: 25000,
|
|
||||||
logisticsPrice: 15000,
|
|
||||||
totalAmount: 3640000,
|
|
||||||
wholesalers: [
|
|
||||||
{
|
|
||||||
id: "w1",
|
|
||||||
name: 'ООО "ТехноСнаб"',
|
|
||||||
inn: "7701234567",
|
|
||||||
contact: "+7 (495) 123-45-67",
|
|
||||||
address: "Москва, ул. Торговая, 1",
|
|
||||||
totalAmount: 3600000,
|
|
||||||
products: [
|
|
||||||
{
|
|
||||||
id: "p1",
|
|
||||||
name: "Смартфон iPhone 15",
|
|
||||||
sku: "APL-IP15-128",
|
|
||||||
category: "Электроника",
|
|
||||||
plannedQty: 50,
|
|
||||||
actualQty: 48,
|
|
||||||
defectQty: 2,
|
|
||||||
productPrice: 75000,
|
|
||||||
parameters: [
|
|
||||||
{ id: "param1", name: "Цвет", value: "Черный" },
|
|
||||||
{ id: "param2", name: "Память", value: "128", unit: "ГБ" },
|
|
||||||
{ id: "param3", name: "Гарантия", value: "12", unit: "мес" },
|
|
||||||
],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
{
|
|
||||||
id: "2",
|
|
||||||
number: 2,
|
|
||||||
deliveryDate: "2024-01-20",
|
|
||||||
createdDate: "2024-01-12",
|
|
||||||
status: "in-transit",
|
|
||||||
plannedTotal: 30,
|
|
||||||
actualTotal: 30,
|
|
||||||
defectTotal: 0,
|
|
||||||
totalProductPrice: 750000,
|
|
||||||
totalFulfillmentPrice: 18000,
|
|
||||||
totalLogisticsPrice: 12000,
|
|
||||||
grandTotal: 780000,
|
|
||||||
routes: [
|
|
||||||
{
|
|
||||||
id: "r3",
|
|
||||||
from: "Садовод",
|
|
||||||
fromAddress: "Москва, 14-й км МКАД",
|
|
||||||
to: "WB Подольск",
|
|
||||||
toAddress: "Подольск, ул. Складская, 25",
|
|
||||||
totalProductPrice: 750000,
|
|
||||||
fulfillmentServicePrice: 18000,
|
|
||||||
logisticsPrice: 12000,
|
|
||||||
totalAmount: 780000,
|
|
||||||
wholesalers: [
|
|
||||||
{
|
|
||||||
id: "w3",
|
|
||||||
name: 'ООО "АудиоТех"',
|
|
||||||
inn: "7702345678",
|
|
||||||
contact: "+7 (495) 555-12-34",
|
|
||||||
address: "Москва, ул. Звуковая, 8",
|
|
||||||
totalAmount: 750000,
|
|
||||||
products: [
|
|
||||||
{
|
|
||||||
id: "p3",
|
|
||||||
name: "Наушники AirPods Pro",
|
|
||||||
sku: "APL-AP-PRO2",
|
|
||||||
category: "Аудио",
|
|
||||||
plannedQty: 30,
|
|
||||||
actualQty: 30,
|
|
||||||
defectQty: 0,
|
|
||||||
productPrice: 25000,
|
|
||||||
parameters: [
|
|
||||||
{ id: "param6", name: "Тип", value: "Беспроводные" },
|
|
||||||
{ id: "param7", name: "Шумоподавление", value: "Активное" },
|
|
||||||
{ id: "param8", name: "Время работы", value: "6", unit: "ч" },
|
|
||||||
],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
];
|
|
||||||
|
|
||||||
export function SuppliesGoodsTab() {
|
export function SuppliesGoodsTab() {
|
||||||
|
// Загружаем реальные данные поставок товаров
|
||||||
|
const { data: supplyOrdersData, loading, error } = useQuery(GET_SUPPLY_ORDERS, {
|
||||||
|
errorPolicy: 'all'
|
||||||
|
});
|
||||||
|
|
||||||
const [expandedSupplies, setExpandedSupplies] = useState<Set<string>>(
|
const [expandedSupplies, setExpandedSupplies] = useState<Set<string>>(
|
||||||
new Set()
|
new Set()
|
||||||
);
|
);
|
||||||
@ -199,6 +96,25 @@ export function SuppliesGoodsTab() {
|
|||||||
new Set()
|
new Set()
|
||||||
);
|
);
|
||||||
|
|
||||||
|
// Преобразуем данные из GraphQL в нужный формат
|
||||||
|
const goodsSupplies: Supply[] = (supplyOrdersData?.supplyOrders || [])
|
||||||
|
.filter((order: any) => order.status === 'CONFIRMED' || order.status === 'DELIVERED')
|
||||||
|
.map((order: any, index: number) => ({
|
||||||
|
id: order.id,
|
||||||
|
number: index + 1,
|
||||||
|
deliveryDate: order.deliveryDate || new Date().toISOString().split('T')[0],
|
||||||
|
createdDate: order.createdAt?.split('T')[0] || new Date().toISOString().split('T')[0],
|
||||||
|
status: order.status === 'DELIVERED' ? 'delivered' : 'in-transit',
|
||||||
|
plannedTotal: order.totalItems || 0,
|
||||||
|
actualTotal: order.totalItems || 0,
|
||||||
|
defectTotal: 0,
|
||||||
|
totalProductPrice: order.totalAmount || 0,
|
||||||
|
totalFulfillmentPrice: 0,
|
||||||
|
totalLogisticsPrice: 0,
|
||||||
|
grandTotal: order.totalAmount || 0,
|
||||||
|
routes: []
|
||||||
|
}));
|
||||||
|
|
||||||
const toggleSupplyExpansion = (supplyId: string) => {
|
const toggleSupplyExpansion = (supplyId: string) => {
|
||||||
const newExpanded = new Set(expandedSupplies);
|
const newExpanded = new Set(expandedSupplies);
|
||||||
if (newExpanded.has(supplyId)) {
|
if (newExpanded.has(supplyId)) {
|
||||||
@ -321,7 +237,7 @@ export function SuppliesGoodsTab() {
|
|||||||
<div>
|
<div>
|
||||||
<p className="text-white/60 text-xs">Поставок товаров</p>
|
<p className="text-white/60 text-xs">Поставок товаров</p>
|
||||||
<p className="text-xl font-bold text-white">
|
<p className="text-xl font-bold text-white">
|
||||||
{mockGoodsSupplies.length}
|
{loading ? '...' : goodsSupplies.length}
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@ -335,8 +251,8 @@ export function SuppliesGoodsTab() {
|
|||||||
<div>
|
<div>
|
||||||
<p className="text-white/60 text-xs">Сумма товаров</p>
|
<p className="text-white/60 text-xs">Сумма товаров</p>
|
||||||
<p className="text-xl font-bold text-white">
|
<p className="text-xl font-bold text-white">
|
||||||
{formatCurrency(
|
{loading ? '...' : formatCurrency(
|
||||||
mockGoodsSupplies.reduce(
|
goodsSupplies.reduce(
|
||||||
(sum, supply) => sum + supply.grandTotal,
|
(sum, supply) => sum + supply.grandTotal,
|
||||||
0
|
0
|
||||||
)
|
)
|
||||||
@ -354,8 +270,8 @@ export function SuppliesGoodsTab() {
|
|||||||
<div>
|
<div>
|
||||||
<p className="text-white/60 text-xs">В пути</p>
|
<p className="text-white/60 text-xs">В пути</p>
|
||||||
<p className="text-xl font-bold text-white">
|
<p className="text-xl font-bold text-white">
|
||||||
{
|
{loading ? '...' :
|
||||||
mockGoodsSupplies.filter(
|
goodsSupplies.filter(
|
||||||
(supply) => supply.status === "in-transit"
|
(supply) => supply.status === "in-transit"
|
||||||
).length
|
).length
|
||||||
}
|
}
|
||||||
@ -372,8 +288,8 @@ export function SuppliesGoodsTab() {
|
|||||||
<div>
|
<div>
|
||||||
<p className="text-white/60 text-xs">С браком</p>
|
<p className="text-white/60 text-xs">С браком</p>
|
||||||
<p className="text-xl font-bold text-white">
|
<p className="text-xl font-bold text-white">
|
||||||
{
|
{loading ? '...' :
|
||||||
mockGoodsSupplies.filter((supply) => supply.defectTotal > 0)
|
goodsSupplies.filter((supply) => supply.defectTotal > 0)
|
||||||
.length
|
.length
|
||||||
}
|
}
|
||||||
</p>
|
</p>
|
||||||
@ -416,7 +332,25 @@ export function SuppliesGoodsTab() {
|
|||||||
</tr>
|
</tr>
|
||||||
</thead>
|
</thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
{mockGoodsSupplies.map((supply) => {
|
{loading && (
|
||||||
|
<tr>
|
||||||
|
<td colSpan={11} className="p-8 text-center">
|
||||||
|
<div className="text-white/60">Загрузка данных...</div>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
)}
|
||||||
|
{!loading && goodsSupplies.length === 0 && (
|
||||||
|
<tr>
|
||||||
|
<td colSpan={11} className="p-8 text-center">
|
||||||
|
<div className="text-white/60">
|
||||||
|
<Package className="h-12 w-12 mx-auto mb-4 text-white/20" />
|
||||||
|
<div className="text-lg font-semibold text-white mb-2">Поставки товаров не найдены</div>
|
||||||
|
<div>Создайте первую поставку товаров через карточки или поставщиков</div>
|
||||||
|
</div>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
)}
|
||||||
|
{!loading && goodsSupplies.map((supply) => {
|
||||||
const isSupplyExpanded = expandedSupplies.has(supply.id);
|
const isSupplyExpanded = expandedSupplies.has(supply.id);
|
||||||
|
|
||||||
return (
|
return (
|
||||||
|
@ -5,6 +5,8 @@ import { Card } from "@/components/ui/card";
|
|||||||
import { Badge } from "@/components/ui/badge";
|
import { Badge } from "@/components/ui/badge";
|
||||||
import { StatsCard } from "../ui/stats-card";
|
import { StatsCard } from "../ui/stats-card";
|
||||||
import { StatsGrid } from "../ui/stats-grid";
|
import { StatsGrid } from "../ui/stats-grid";
|
||||||
|
import { useQuery } from "@apollo/client";
|
||||||
|
import { GET_MY_WILDBERRIES_SUPPLIES } from "@/graphql/queries";
|
||||||
import {
|
import {
|
||||||
Calendar,
|
Calendar,
|
||||||
Package,
|
Package,
|
||||||
@ -66,129 +68,31 @@ interface WbSupply {
|
|||||||
status: "planned" | "in-transit" | "delivered" | "completed";
|
status: "planned" | "in-transit" | "delivered" | "completed";
|
||||||
}
|
}
|
||||||
|
|
||||||
// Моковые данные для поставок на Wildberries
|
|
||||||
const mockWbSupplies: WbSupply[] = [
|
|
||||||
{
|
|
||||||
id: "wb1",
|
|
||||||
number: 4001,
|
|
||||||
supplyId: "WB24010001",
|
|
||||||
deliveryDate: "2024-01-22",
|
|
||||||
createdDate: "2024-01-16",
|
|
||||||
status: "delivered",
|
|
||||||
plannedTotal: 120,
|
|
||||||
actualTotal: 118,
|
|
||||||
defectTotal: 2,
|
|
||||||
totalProductPrice: 2400000,
|
|
||||||
totalLogisticsPrice: 18000,
|
|
||||||
grandTotal: 2418000,
|
|
||||||
routes: [
|
|
||||||
{
|
|
||||||
id: "wbr1",
|
|
||||||
from: "Садовод",
|
|
||||||
fromAddress: "Москва, 14-й км МКАД",
|
|
||||||
to: "WB Подольск",
|
|
||||||
toAddress: "Подольск, ул. Складская, 25",
|
|
||||||
totalProductPrice: 2400000,
|
|
||||||
logisticsPrice: 18000,
|
|
||||||
totalAmount: 2418000,
|
|
||||||
warehouses: [
|
|
||||||
{
|
|
||||||
id: "wbw1",
|
|
||||||
name: "Склад WB Подольск",
|
|
||||||
address: "Подольск, ул. Складская, 25",
|
|
||||||
warehouseId: 117501,
|
|
||||||
totalAmount: 2400000,
|
|
||||||
products: [
|
|
||||||
{
|
|
||||||
id: "wbp1",
|
|
||||||
name: "Смартфон Samsung Galaxy S24",
|
|
||||||
sku: "SAMS-GS24-256",
|
|
||||||
nmId: 123456789,
|
|
||||||
category: "Смартфоны и гаджеты",
|
|
||||||
plannedQty: 40,
|
|
||||||
actualQty: 39,
|
|
||||||
defectQty: 1,
|
|
||||||
productPrice: 65000,
|
|
||||||
},
|
|
||||||
{
|
|
||||||
id: "wbp2",
|
|
||||||
name: "Чехол для Samsung Galaxy S24",
|
|
||||||
sku: "CASE-GS24-BLK",
|
|
||||||
nmId: 987654321,
|
|
||||||
category: "Аксессуары для телефонов",
|
|
||||||
plannedQty: 80,
|
|
||||||
actualQty: 79,
|
|
||||||
defectQty: 1,
|
|
||||||
productPrice: 1200,
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
{
|
|
||||||
id: "wb2",
|
|
||||||
number: 4002,
|
|
||||||
supplyId: "WB24010002",
|
|
||||||
deliveryDate: "2024-01-28",
|
|
||||||
createdDate: "2024-01-20",
|
|
||||||
status: "in-transit",
|
|
||||||
plannedTotal: 60,
|
|
||||||
actualTotal: 60,
|
|
||||||
defectTotal: 0,
|
|
||||||
totalProductPrice: 1800000,
|
|
||||||
totalLogisticsPrice: 15000,
|
|
||||||
grandTotal: 1815000,
|
|
||||||
routes: [
|
|
||||||
{
|
|
||||||
id: "wbr2",
|
|
||||||
from: "ТЯК Москва",
|
|
||||||
fromAddress: "Москва, Алтуфьевское шоссе, 27",
|
|
||||||
to: "WB Электросталь",
|
|
||||||
toAddress: "Электросталь, ул. Промышленная, 10",
|
|
||||||
totalProductPrice: 1800000,
|
|
||||||
logisticsPrice: 15000,
|
|
||||||
totalAmount: 1815000,
|
|
||||||
warehouses: [
|
|
||||||
{
|
|
||||||
id: "wbw2",
|
|
||||||
name: "Склад WB Электросталь",
|
|
||||||
address: "Электросталь, ул. Промышленная, 10",
|
|
||||||
warehouseId: 117986,
|
|
||||||
totalAmount: 1800000,
|
|
||||||
products: [
|
|
||||||
{
|
|
||||||
id: "wbp3",
|
|
||||||
name: "Наушники Sony WH-1000XM5",
|
|
||||||
sku: "SONY-WH1000XM5",
|
|
||||||
nmId: 555666777,
|
|
||||||
category: "Наушники и аудио",
|
|
||||||
plannedQty: 30,
|
|
||||||
actualQty: 30,
|
|
||||||
defectQty: 0,
|
|
||||||
productPrice: 35000,
|
|
||||||
},
|
|
||||||
{
|
|
||||||
id: "wbp4",
|
|
||||||
name: "Кабель USB-C",
|
|
||||||
sku: "CABLE-USBC-2M",
|
|
||||||
nmId: 111222333,
|
|
||||||
category: "Кабели и адаптеры",
|
|
||||||
plannedQty: 30,
|
|
||||||
actualQty: 30,
|
|
||||||
defectQty: 0,
|
|
||||||
productPrice: 800,
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
];
|
|
||||||
|
|
||||||
export function WildberriesSuppliesTab() {
|
export function WildberriesSuppliesTab() {
|
||||||
|
// Загружаем реальные данные поставок на Wildberries
|
||||||
|
const { data: wbSuppliesData, loading, error } = useQuery(GET_MY_WILDBERRIES_SUPPLIES, {
|
||||||
|
errorPolicy: 'all'
|
||||||
|
});
|
||||||
|
|
||||||
|
// Преобразуем данные из GraphQL в нужный формат
|
||||||
|
const wbSupplies: WbSupply[] = (wbSuppliesData?.myWildberriesSupplies || [])
|
||||||
|
.map((supply: any, index: number) => ({
|
||||||
|
id: supply.id,
|
||||||
|
number: index + 4000, // Начинаем с 4000 для WB поставок
|
||||||
|
supplyId: `WB${new Date().getFullYear()}${String(index + 1).padStart(6, '0')}`,
|
||||||
|
deliveryDate: supply.deliveryDate || new Date().toISOString().split('T')[0],
|
||||||
|
createdDate: supply.createdAt?.split('T')[0] || new Date().toISOString().split('T')[0],
|
||||||
|
status: supply.status === 'DELIVERED' ? 'delivered' : 'in-transit',
|
||||||
|
plannedTotal: supply.totalItems || 0,
|
||||||
|
actualTotal: supply.totalItems || 0,
|
||||||
|
defectTotal: 0,
|
||||||
|
totalProductPrice: supply.totalAmount || 0,
|
||||||
|
totalLogisticsPrice: 0,
|
||||||
|
grandTotal: supply.totalAmount || 0,
|
||||||
|
routes: []
|
||||||
|
}));
|
||||||
|
|
||||||
|
|
||||||
const [expandedSupplies, setExpandedSupplies] = useState<Set<string>>(
|
const [expandedSupplies, setExpandedSupplies] = useState<Set<string>>(
|
||||||
new Set()
|
new Set()
|
||||||
);
|
);
|
||||||
@ -316,7 +220,7 @@ export function WildberriesSuppliesTab() {
|
|||||||
<StatsGrid>
|
<StatsGrid>
|
||||||
<StatsCard
|
<StatsCard
|
||||||
title="Поставок на WB"
|
title="Поставок на WB"
|
||||||
value={mockWbSupplies.length}
|
value={loading ? 0 : wbSupplies.length}
|
||||||
icon={ShoppingBag}
|
icon={ShoppingBag}
|
||||||
iconColor="text-purple-400"
|
iconColor="text-purple-400"
|
||||||
iconBg="bg-purple-500/20"
|
iconBg="bg-purple-500/20"
|
||||||
@ -327,7 +231,7 @@ export function WildberriesSuppliesTab() {
|
|||||||
<StatsCard
|
<StatsCard
|
||||||
title="Сумма WB поставок"
|
title="Сумма WB поставок"
|
||||||
value={formatCurrency(
|
value={formatCurrency(
|
||||||
mockWbSupplies.reduce((sum, supply) => sum + supply.grandTotal, 0)
|
loading ? 0 : wbSupplies.reduce((sum, supply) => sum + supply.grandTotal, 0)
|
||||||
)}
|
)}
|
||||||
icon={TrendingUp}
|
icon={TrendingUp}
|
||||||
iconColor="text-green-400"
|
iconColor="text-green-400"
|
||||||
@ -339,7 +243,7 @@ export function WildberriesSuppliesTab() {
|
|||||||
<StatsCard
|
<StatsCard
|
||||||
title="В пути"
|
title="В пути"
|
||||||
value={
|
value={
|
||||||
mockWbSupplies.filter((supply) => supply.status === "in-transit")
|
loading ? 0 : wbSupplies.filter((supply) => supply.status === "in-transit")
|
||||||
.length
|
.length
|
||||||
}
|
}
|
||||||
icon={Calendar}
|
icon={Calendar}
|
||||||
@ -351,7 +255,7 @@ export function WildberriesSuppliesTab() {
|
|||||||
<StatsCard
|
<StatsCard
|
||||||
title="С браком"
|
title="С браком"
|
||||||
value={
|
value={
|
||||||
mockWbSupplies.filter((supply) => supply.defectTotal > 0).length
|
loading ? 0 : wbSupplies.filter((supply) => supply.defectTotal > 0).length
|
||||||
}
|
}
|
||||||
icon={AlertTriangle}
|
icon={AlertTriangle}
|
||||||
iconColor="text-red-400"
|
iconColor="text-red-400"
|
||||||
@ -395,7 +299,25 @@ export function WildberriesSuppliesTab() {
|
|||||||
</tr>
|
</tr>
|
||||||
</thead>
|
</thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
{mockWbSupplies.map((supply) => {
|
{loading && (
|
||||||
|
<tr>
|
||||||
|
<td colSpan={11} className="p-8 text-center">
|
||||||
|
<div className="text-white/60">Загрузка данных...</div>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
)}
|
||||||
|
{!loading && wbSupplies.length === 0 && (
|
||||||
|
<tr>
|
||||||
|
<td colSpan={11} className="p-8 text-center">
|
||||||
|
<div className="text-white/60">
|
||||||
|
<ShoppingBag className="h-12 w-12 mx-auto mb-4 text-white/20" />
|
||||||
|
<div className="text-lg font-semibold text-white mb-2">Поставки на Wildberries не найдены</div>
|
||||||
|
<div>Создайте первую поставку товаров на Wildberries</div>
|
||||||
|
</div>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
)}
|
||||||
|
{!loading && wbSupplies.map((supply) => {
|
||||||
const isSupplyExpanded = expandedSupplies.has(supply.id);
|
const isSupplyExpanded = expandedSupplies.has(supply.id);
|
||||||
|
|
||||||
return (
|
return (
|
||||||
|
@ -93,12 +93,12 @@ export function SuppliesDashboard() {
|
|||||||
<div className="h-screen flex overflow-hidden">
|
<div className="h-screen flex overflow-hidden">
|
||||||
<Sidebar />
|
<Sidebar />
|
||||||
<main
|
<main
|
||||||
className={`flex-1 ${getSidebarMargin()} px-2 py-2 overflow-hidden transition-all duration-300`}
|
className={`flex-1 ${getSidebarMargin()} overflow-hidden transition-all duration-300 p-4`}
|
||||||
>
|
>
|
||||||
<div className="h-full flex flex-col">
|
<div className="h-full flex flex-col gap-4">
|
||||||
{/* Уведомляющий баннер */}
|
{/* Уведомляющий баннер */}
|
||||||
{hasPendingItems && (
|
{hasPendingItems && (
|
||||||
<Alert className="mb-4 bg-blue-500/20 border-blue-400/30 text-blue-300 animate-pulse">
|
<Alert className="bg-blue-500/20 border-blue-400/30 text-blue-300 animate-pulse">
|
||||||
<AlertTriangle className="h-4 w-4" />
|
<AlertTriangle className="h-4 w-4" />
|
||||||
<AlertDescription>
|
<AlertDescription>
|
||||||
{(() => {
|
{(() => {
|
||||||
|
@ -41,6 +41,7 @@ import { toast } from 'sonner'
|
|||||||
import { format } from 'date-fns'
|
import { format } from 'date-fns'
|
||||||
import { ru } from 'date-fns/locale'
|
import { ru } from 'date-fns/locale'
|
||||||
import { SelectedCard, FulfillmentService, ConsumableService, WildberriesCard } from '@/types/supplies'
|
import { SelectedCard, FulfillmentService, ConsumableService, WildberriesCard } from '@/types/supplies'
|
||||||
|
import { ProductCardSkeletonGrid } from '@/components/ui/product-card-skeleton'
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@ -86,173 +87,27 @@ export function WBProductCards({ onBack, onComplete, showSummary: externalShowSu
|
|||||||
const [selectedCardForDetails, setSelectedCardForDetails] = useState<WildberriesCard | null>(null)
|
const [selectedCardForDetails, setSelectedCardForDetails] = useState<WildberriesCard | null>(null)
|
||||||
const [currentImageIndex, setCurrentImageIndex] = useState(0)
|
const [currentImageIndex, setCurrentImageIndex] = useState(0)
|
||||||
|
|
||||||
// Моковые товары для демонстрации
|
// Загружаем реальные карточки WB
|
||||||
const getMockCards = (): WildberriesCard[] => [
|
const { data: wbCardsData, loading: wbCardsLoading } = useQuery(GET_MY_WILDBERRIES_SUPPLIES, {
|
||||||
{
|
errorPolicy: 'all'
|
||||||
nmID: 123456789,
|
});
|
||||||
vendorCode: 'SKU001',
|
|
||||||
title: 'Смартфон Samsung Galaxy A54',
|
// Используем реальные данные из GraphQL запроса
|
||||||
description: 'Современный смартфон с отличной камерой и долгим временем автономной работы',
|
const realWbCards: WildberriesCard[] = (wbCardsData?.myWildberriesSupplies || [])
|
||||||
brand: 'Samsung',
|
.flatMap((supply: any) => supply.cards || [])
|
||||||
object: 'Смартфоны',
|
.map((card: any) => ({
|
||||||
parent: 'Электроника',
|
nmID: card.nmId || card.nmID,
|
||||||
countryProduction: 'Корея',
|
vendorCode: card.vendorCode || '',
|
||||||
supplierVendorCode: 'SUPPLIER-001',
|
title: card.title || 'Без названия',
|
||||||
mediaFiles: ['/api/placeholder/400/400', '/api/placeholder/400/401', '/api/placeholder/400/402'],
|
description: card.description || '',
|
||||||
sizes: [
|
brand: card.brand || '',
|
||||||
{
|
object: card.object || '',
|
||||||
chrtID: 123456,
|
parent: card.parent || '',
|
||||||
techSize: '128GB',
|
countryProduction: card.countryProduction || '',
|
||||||
wbSize: '128GB Черный',
|
supplierVendorCode: card.supplierVendorCode || '',
|
||||||
price: 25990,
|
mediaFiles: card.mediaFiles || [],
|
||||||
discountedPrice: 22990,
|
sizes: card.sizes || []
|
||||||
quantity: 15
|
}));
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
{
|
|
||||||
nmID: 987654321,
|
|
||||||
vendorCode: 'SKU002',
|
|
||||||
title: 'Наушники Apple AirPods Pro',
|
|
||||||
description: 'Беспроводные наушники с активным шумоподавлением и пространственным звуком',
|
|
||||||
brand: 'Apple',
|
|
||||||
object: 'Наушники',
|
|
||||||
parent: 'Электроника',
|
|
||||||
countryProduction: 'Китай',
|
|
||||||
supplierVendorCode: 'SUPPLIER-002',
|
|
||||||
mediaFiles: ['/api/placeholder/400/403', '/api/placeholder/400/404'],
|
|
||||||
sizes: [
|
|
||||||
{
|
|
||||||
chrtID: 987654,
|
|
||||||
techSize: 'Standard',
|
|
||||||
wbSize: 'Белый',
|
|
||||||
price: 24990,
|
|
||||||
discountedPrice: 19990,
|
|
||||||
quantity: 8
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
{
|
|
||||||
nmID: 555666777,
|
|
||||||
vendorCode: 'SKU003',
|
|
||||||
title: 'Кроссовки Nike Air Max 270',
|
|
||||||
description: 'Спортивные кроссовки с современным дизайном и комфортной посадкой',
|
|
||||||
brand: 'Nike',
|
|
||||||
object: 'Кроссовки',
|
|
||||||
parent: 'Обувь',
|
|
||||||
countryProduction: 'Вьетнам',
|
|
||||||
supplierVendorCode: 'SUPPLIER-003',
|
|
||||||
mediaFiles: ['/api/placeholder/400/405', '/api/placeholder/400/406', '/api/placeholder/400/407'],
|
|
||||||
sizes: [
|
|
||||||
{
|
|
||||||
chrtID: 555666,
|
|
||||||
techSize: '42',
|
|
||||||
wbSize: '42 EU',
|
|
||||||
price: 12990,
|
|
||||||
discountedPrice: 9990,
|
|
||||||
quantity: 25
|
|
||||||
},
|
|
||||||
{
|
|
||||||
chrtID: 555667,
|
|
||||||
techSize: '43',
|
|
||||||
wbSize: '43 EU',
|
|
||||||
price: 12990,
|
|
||||||
discountedPrice: 9990,
|
|
||||||
quantity: 20
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
{
|
|
||||||
nmID: 444333222,
|
|
||||||
vendorCode: 'SKU004',
|
|
||||||
title: 'Футболка Adidas Originals',
|
|
||||||
description: 'Классическая футболка из органического хлопка с логотипом бренда',
|
|
||||||
brand: 'Adidas',
|
|
||||||
object: 'Футболки',
|
|
||||||
parent: 'Одежда',
|
|
||||||
countryProduction: 'Бангладеш',
|
|
||||||
supplierVendorCode: 'SUPPLIER-004',
|
|
||||||
mediaFiles: ['/api/placeholder/400/408', '/api/placeholder/400/409'],
|
|
||||||
sizes: [
|
|
||||||
{
|
|
||||||
chrtID: 444333,
|
|
||||||
techSize: 'M',
|
|
||||||
wbSize: 'M',
|
|
||||||
price: 2990,
|
|
||||||
discountedPrice: 2490,
|
|
||||||
quantity: 50
|
|
||||||
},
|
|
||||||
{
|
|
||||||
chrtID: 444334,
|
|
||||||
techSize: 'L',
|
|
||||||
wbSize: 'L',
|
|
||||||
price: 2990,
|
|
||||||
discountedPrice: 2490,
|
|
||||||
quantity: 45
|
|
||||||
},
|
|
||||||
{
|
|
||||||
chrtID: 444335,
|
|
||||||
techSize: 'XL',
|
|
||||||
wbSize: 'XL',
|
|
||||||
price: 2990,
|
|
||||||
discountedPrice: 2490,
|
|
||||||
quantity: 30
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
{
|
|
||||||
nmID: 111222333,
|
|
||||||
vendorCode: 'SKU005',
|
|
||||||
title: 'Рюкзак для ноутбука Xiaomi',
|
|
||||||
description: 'Стильный и функциональный рюкзак для ноутбука до 15.6 дюймов',
|
|
||||||
brand: 'Xiaomi',
|
|
||||||
object: 'Рюкзаки',
|
|
||||||
parent: 'Аксессуары',
|
|
||||||
countryProduction: 'Китай',
|
|
||||||
supplierVendorCode: 'SUPPLIER-005',
|
|
||||||
mediaFiles: ['/api/placeholder/400/410'],
|
|
||||||
sizes: [
|
|
||||||
{
|
|
||||||
chrtID: 111222,
|
|
||||||
techSize: '15.6"',
|
|
||||||
wbSize: 'Черный',
|
|
||||||
price: 4990,
|
|
||||||
discountedPrice: 3990,
|
|
||||||
quantity: 35
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
{
|
|
||||||
nmID: 777888999,
|
|
||||||
vendorCode: 'SKU006',
|
|
||||||
title: 'Умные часы Apple Watch Series 9',
|
|
||||||
description: 'Новейшие умные часы с передовыми функциями здоровья и фитнеса',
|
|
||||||
brand: 'Apple',
|
|
||||||
object: 'Умные часы',
|
|
||||||
parent: 'Электроника',
|
|
||||||
countryProduction: 'Китай',
|
|
||||||
supplierVendorCode: 'SUPPLIER-006',
|
|
||||||
mediaFiles: ['/api/placeholder/400/411', '/api/placeholder/400/412', '/api/placeholder/400/413'],
|
|
||||||
sizes: [
|
|
||||||
{
|
|
||||||
chrtID: 777888,
|
|
||||||
techSize: '41mm',
|
|
||||||
wbSize: '41mm GPS',
|
|
||||||
price: 39990,
|
|
||||||
discountedPrice: 35990,
|
|
||||||
quantity: 12
|
|
||||||
},
|
|
||||||
{
|
|
||||||
chrtID: 777889,
|
|
||||||
techSize: '45mm',
|
|
||||||
wbSize: '45mm GPS',
|
|
||||||
price: 42990,
|
|
||||||
discountedPrice: 38990,
|
|
||||||
quantity: 8
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
]
|
|
||||||
|
|
||||||
// Загружаем контрагентов-фулфилментов
|
// Загружаем контрагентов-фулфилментов
|
||||||
const { data: counterpartiesData } = useQuery(GET_MY_COUNTERPARTIES)
|
const { data: counterpartiesData } = useQuery(GET_MY_COUNTERPARTIES)
|
||||||
@ -327,7 +182,7 @@ export function WBProductCards({ onBack, onComplete, showSummary: externalShowSu
|
|||||||
}
|
}
|
||||||
})
|
})
|
||||||
|
|
||||||
// Моковые данные рынков
|
// Данные рынков можно будет загружать через GraphQL в будущем
|
||||||
const markets = [
|
const markets = [
|
||||||
{ value: 'sadovod', label: 'Садовод' },
|
{ value: 'sadovod', label: 'Садовод' },
|
||||||
{ value: 'luzhniki', label: 'Лужники' },
|
{ value: 'luzhniki', label: 'Лужники' },
|
||||||
@ -337,53 +192,13 @@ export function WBProductCards({ onBack, onComplete, showSummary: externalShowSu
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
// Автоматически загружаем товары при открытии компонента
|
// Загружаем карточки из GraphQL запроса
|
||||||
useEffect(() => {
|
useEffect(() => {
|
||||||
const loadCards = async () => {
|
if (!wbCardsLoading && wbCardsData) {
|
||||||
setLoading(true)
|
setWbCards(realWbCards)
|
||||||
try {
|
console.log('Загружено карточек из GraphQL:', realWbCards.length)
|
||||||
const wbApiKey = user?.organization?.apiKeys?.find(key => key.marketplace === 'WILDBERRIES')
|
|
||||||
|
|
||||||
console.log('WB API Key found:', !!wbApiKey)
|
|
||||||
console.log('WB API Key active:', wbApiKey?.isActive)
|
|
||||||
console.log('WB API Key validationData:', wbApiKey?.validationData)
|
|
||||||
|
|
||||||
if (wbApiKey?.isActive) {
|
|
||||||
// Попытка загрузить реальные данные из API Wildberries
|
|
||||||
const validationData = wbApiKey.validationData as Record<string, string>
|
|
||||||
|
|
||||||
// API ключ может храниться в разных местах
|
|
||||||
const apiToken = validationData?.token ||
|
|
||||||
validationData?.apiKey ||
|
|
||||||
validationData?.key ||
|
|
||||||
(wbApiKey as { apiKey?: string }).apiKey // Прямое поле apiKey из базы
|
|
||||||
|
|
||||||
console.log('API Token extracted:', !!apiToken)
|
|
||||||
console.log('API Token length:', apiToken?.length)
|
|
||||||
|
|
||||||
if (apiToken) {
|
|
||||||
console.log('Загружаем карточки из WB API...')
|
|
||||||
const cards = await WildberriesService.getAllCards(apiToken, 50)
|
|
||||||
setWbCards(cards)
|
|
||||||
console.log('Загружено карточек из WB API:', cards.length)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Если API ключ не настроен, оставляем пустое состояние
|
|
||||||
console.log('API ключ WB не настроен, показываем пустое состояние')
|
|
||||||
setWbCards([])
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Ошибка загрузки карточек WB:', error)
|
|
||||||
// При ошибке API показываем пустое состояние
|
|
||||||
setWbCards([])
|
|
||||||
} finally {
|
|
||||||
setLoading(false)
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
}, [wbCardsData, wbCardsLoading, realWbCards])
|
||||||
loadCards()
|
|
||||||
}, [user])
|
|
||||||
|
|
||||||
const loadAllCards = async () => {
|
const loadAllCards = async () => {
|
||||||
setLoading(true)
|
setLoading(true)
|
||||||
@ -407,17 +222,15 @@ export function WBProductCards({ onBack, onComplete, showSummary: externalShowSu
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// Если API ключ не настроен, загружаем моковые данные
|
// Если API ключ не настроен, используем данные из GraphQL
|
||||||
console.log('API ключ WB не настроен, загружаем моковые данные')
|
console.log('API ключ WB не настроен, используем данные из GraphQL')
|
||||||
const allCards = getMockCards()
|
setWbCards(realWbCards)
|
||||||
setWbCards(allCards)
|
console.log('Используются данные из GraphQL:', realWbCards.length)
|
||||||
console.log('Загружены моковые товары:', allCards.length)
|
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
console.error('Ошибка загрузки всех карточек WB:', error)
|
console.error('Ошибка загрузки всех карточек WB:', error)
|
||||||
// При ошибке загружаем моковые данные
|
// При ошибке используем данные из GraphQL
|
||||||
const allCards = getMockCards()
|
setWbCards(realWbCards)
|
||||||
setWbCards(allCards)
|
console.log('Используются данные из GraphQL (fallback):', realWbCards.length)
|
||||||
console.log('Загружены моковые товары (fallback):', allCards.length)
|
|
||||||
} finally {
|
} finally {
|
||||||
setLoading(false)
|
setLoading(false)
|
||||||
}
|
}
|
||||||
@ -450,12 +263,11 @@ export function WBProductCards({ onBack, onComplete, showSummary: externalShowSu
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// Если API ключ не настроен, ищем в моковых данных
|
// Если API ключ не настроен, ищем в данных из GraphQL
|
||||||
console.log('API ключ WB не настроен, поиск в моковых данных:', searchTerm)
|
console.log('API ключ WB не настроен, поиск в данных GraphQL:', searchTerm)
|
||||||
const mockCards = getMockCards()
|
|
||||||
|
|
||||||
// Фильтруем товары по поисковому запросу
|
// Фильтруем товары по поисковому запросу
|
||||||
const filteredCards = mockCards.filter(card =>
|
const filteredCards = realWbCards.filter(card =>
|
||||||
card.title.toLowerCase().includes(searchTerm.toLowerCase()) ||
|
card.title.toLowerCase().includes(searchTerm.toLowerCase()) ||
|
||||||
card.brand.toLowerCase().includes(searchTerm.toLowerCase()) ||
|
card.brand.toLowerCase().includes(searchTerm.toLowerCase()) ||
|
||||||
card.nmID.toString().includes(searchTerm.toLowerCase()) ||
|
card.nmID.toString().includes(searchTerm.toLowerCase()) ||
|
||||||
@ -463,19 +275,18 @@ export function WBProductCards({ onBack, onComplete, showSummary: externalShowSu
|
|||||||
)
|
)
|
||||||
|
|
||||||
setWbCards(filteredCards)
|
setWbCards(filteredCards)
|
||||||
console.log('Найдено моковых товаров:', filteredCards.length)
|
console.log('Найдено товаров в GraphQL данных:', filteredCards.length)
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
console.error('Ошибка поиска карточек WB:', error)
|
console.error('Ошибка поиска карточек WB:', error)
|
||||||
// При ошибке ищем в моковых данных
|
// При ошибке ищем в данных из GraphQL
|
||||||
const mockCards = getMockCards()
|
const filteredCards = realWbCards.filter(card =>
|
||||||
const filteredCards = mockCards.filter(card =>
|
|
||||||
card.title.toLowerCase().includes(searchTerm.toLowerCase()) ||
|
card.title.toLowerCase().includes(searchTerm.toLowerCase()) ||
|
||||||
card.brand.toLowerCase().includes(searchTerm.toLowerCase()) ||
|
card.brand.toLowerCase().includes(searchTerm.toLowerCase()) ||
|
||||||
card.nmID.toString().includes(searchTerm.toLowerCase()) ||
|
card.nmID.toString().includes(searchTerm.toLowerCase()) ||
|
||||||
card.object?.toLowerCase().includes(searchTerm.toLowerCase())
|
card.object?.toLowerCase().includes(searchTerm.toLowerCase())
|
||||||
)
|
)
|
||||||
setWbCards(filteredCards)
|
setWbCards(filteredCards)
|
||||||
console.log('Найдено моковых товаров (fallback):', filteredCards.length)
|
console.log('Найдено товаров в GraphQL данных (fallback):', filteredCards.length)
|
||||||
} finally {
|
} finally {
|
||||||
setLoading(false)
|
setLoading(false)
|
||||||
}
|
}
|
||||||
@ -1153,27 +964,13 @@ export function WBProductCards({ onBack, onComplete, showSummary: externalShowSu
|
|||||||
</div>
|
</div>
|
||||||
</Card>
|
</Card>
|
||||||
|
|
||||||
{/* Состояние загрузки */}
|
{/* Состояние загрузки с красивыми скелетонами */}
|
||||||
{loading && (
|
{(loading || wbCardsLoading) && (
|
||||||
<div className="grid grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5 2xl:grid-cols-6 gap-4">
|
<ProductCardSkeletonGrid count={12} />
|
||||||
{[...Array(12)].map((_, i) => (
|
|
||||||
<Card key={i} className="bg-white/10 backdrop-blur border-white/20 p-3 animate-pulse">
|
|
||||||
<div className="space-y-3">
|
|
||||||
<div className="bg-white/20 rounded-lg aspect-square w-full"></div>
|
|
||||||
<div className="space-y-2">
|
|
||||||
<div className="bg-white/20 rounded h-3 w-3/4"></div>
|
|
||||||
<div className="bg-white/20 rounded h-3 w-1/2"></div>
|
|
||||||
<div className="bg-white/20 rounded h-4 w-2/3"></div>
|
|
||||||
</div>
|
|
||||||
<div className="bg-white/20 rounded h-7 w-full"></div>
|
|
||||||
</div>
|
|
||||||
</Card>
|
|
||||||
))}
|
|
||||||
</div>
|
|
||||||
)}
|
)}
|
||||||
|
|
||||||
{/* Карточки товаров */}
|
{/* Карточки товаров */}
|
||||||
{!loading && wbCards.length > 0 && (
|
{!loading && !wbCardsLoading && wbCards.length > 0 && (
|
||||||
<div className="grid grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5 2xl:grid-cols-6 gap-4">
|
<div className="grid grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5 2xl:grid-cols-6 gap-4">
|
||||||
{wbCards.map((card) => {
|
{wbCards.map((card) => {
|
||||||
const selectedQuantity = getSelectedQuantity(card)
|
const selectedQuantity = getSelectedQuantity(card)
|
||||||
@ -1353,7 +1150,7 @@ export function WBProductCards({ onBack, onComplete, showSummary: externalShowSu
|
|||||||
</div>
|
</div>
|
||||||
)}
|
)}
|
||||||
|
|
||||||
{wbCards.length === 0 && !loading && (
|
{wbCards.length === 0 && !loading && !wbCardsLoading && (
|
||||||
<Card className="bg-white/10 backdrop-blur border-white/20 p-8">
|
<Card className="bg-white/10 backdrop-blur border-white/20 p-8">
|
||||||
<div className="text-center max-w-md mx-auto">
|
<div className="text-center max-w-md mx-auto">
|
||||||
<Package className="h-12 w-12 text-white/20 mx-auto mb-4" />
|
<Package className="h-12 w-12 text-white/20 mx-auto mb-4" />
|
||||||
@ -1374,17 +1171,17 @@ export function WBProductCards({ onBack, onComplete, showSummary: externalShowSu
|
|||||||
) : (
|
) : (
|
||||||
<>
|
<>
|
||||||
<p className="text-white/60 mb-3 text-sm">
|
<p className="text-white/60 mb-3 text-sm">
|
||||||
Для работы с реальными карточками необходимо настроить API ключ Wildberries
|
Для работы с полным функционалом WB API необходимо настроить API ключ Wildberries
|
||||||
</p>
|
</p>
|
||||||
<p className="text-white/40 text-xs mb-4">
|
<p className="text-white/40 text-xs mb-4">
|
||||||
Показаны демонстрационные товары для тестирования
|
Загружены товары из вашего склада
|
||||||
</p>
|
</p>
|
||||||
<Button
|
<Button
|
||||||
onClick={loadAllCards}
|
onClick={loadAllCards}
|
||||||
className="bg-gradient-to-r from-blue-500 to-cyan-500 hover:from-blue-600 hover:to-cyan-600 text-white"
|
className="bg-gradient-to-r from-blue-500 to-cyan-500 hover:from-blue-600 hover:to-cyan-600 text-white"
|
||||||
>
|
>
|
||||||
<Package className="h-4 w-4 mr-2" />
|
<Package className="h-4 w-4 mr-2" />
|
||||||
Показать демо товары
|
Загрузить товары
|
||||||
</Button>
|
</Button>
|
||||||
</>
|
</>
|
||||||
)}
|
)}
|
||||||
|
61
src/components/ui/product-card-skeleton.tsx
Normal file
61
src/components/ui/product-card-skeleton.tsx
Normal file
@ -0,0 +1,61 @@
|
|||||||
|
"use client"
|
||||||
|
|
||||||
|
import React from 'react'
|
||||||
|
import { Card } from '@/components/ui/card'
|
||||||
|
|
||||||
|
export function ProductCardSkeleton() {
|
||||||
|
return (
|
||||||
|
<Card className="bg-white/10 backdrop-blur border-white/20 p-3 animate-pulse">
|
||||||
|
<div className="space-y-3">
|
||||||
|
{/* Изображение */}
|
||||||
|
<div className="relative">
|
||||||
|
<div className="aspect-square bg-white/20 rounded-lg"></div>
|
||||||
|
{/* Бейджи */}
|
||||||
|
<div className="absolute top-2 right-2">
|
||||||
|
<div className="w-10 h-5 bg-white/30 rounded"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Информация о товаре */}
|
||||||
|
<div className="space-y-2">
|
||||||
|
{/* Бренд и номер */}
|
||||||
|
<div className="flex items-center justify-between">
|
||||||
|
<div className="w-16 h-4 bg-white/20 rounded"></div>
|
||||||
|
<div className="w-12 h-3 bg-white/15 rounded"></div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Название */}
|
||||||
|
<div className="space-y-1">
|
||||||
|
<div className="w-full h-4 bg-white/20 rounded"></div>
|
||||||
|
<div className="w-3/4 h-4 bg-white/15 rounded"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Разделитель */}
|
||||||
|
<div className="border-t border-white/10 pt-2">
|
||||||
|
<div className="w-2/3 h-3 bg-white/15 rounded mx-auto"></div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Управление */}
|
||||||
|
<div className="space-y-2 bg-white/5 rounded-lg p-2">
|
||||||
|
{/* Кнопки количества */}
|
||||||
|
<div className="flex items-center space-x-1">
|
||||||
|
<div className="h-6 w-6 bg-white/20 rounded"></div>
|
||||||
|
<div className="flex-1 h-6 bg-white/20 rounded"></div>
|
||||||
|
<div className="h-6 w-6 bg-white/20 rounded"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</Card>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
export function ProductCardSkeletonGrid({ count = 12 }: { count?: number }) {
|
||||||
|
return (
|
||||||
|
<div className="grid grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5 2xl:grid-cols-6 gap-4">
|
||||||
|
{[...Array(count)].map((_, i) => (
|
||||||
|
<ProductCardSkeleton key={i} />
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
@ -1,169 +0,0 @@
|
|||||||
# ПРОТОКОЛ ПРЕДОТВРАЩЕНИЯ НАРУШЕНИЙ AI
|
|
||||||
|
|
||||||
## 🚨 СИСТЕМА ЖЕСТКИХ СТОП-СИГНАЛОВ
|
|
||||||
|
|
||||||
### 🛑 ОБЯЗАТЕЛЬНЫЕ ОСТАНОВКИ ПЕРЕД ДЕЙСТВИЯМИ
|
|
||||||
|
|
||||||
#### **СТОП-СИГНАЛ #1: ПЕРЕД ЛЮБЫМ АНАЛИЗОМ КОМПОНЕНТОВ**
|
|
||||||
|
|
||||||
```
|
|
||||||
❌ ЗАПРЕЩЕНО: Делать предположения о содержании файлов/компонентов
|
|
||||||
✅ ОБЯЗАТЕЛЬНО:
|
|
||||||
1. codebase_search для понимания
|
|
||||||
2. read_file для точного содержания
|
|
||||||
3. Только ПОСЛЕ изучения кода - выводы
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **СТОП-СИГНАЛ #2: ПЕРЕД ИЗМЕНЕНИЕМ RULES2.MD**
|
|
||||||
|
|
||||||
```
|
|
||||||
❌ ЗАПРЕЩЕНО: Завершать работу без синхронизации
|
|
||||||
✅ ОБЯЗАТЕЛЬНО:
|
|
||||||
1. Внести изменения в rules2.md
|
|
||||||
2. НЕМЕДЛЕННО обновить development-checklist.md
|
|
||||||
3. Проверить соответствие изменений
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **СТОП-СИГНАЛ #3: ПРИ НЕОПРЕДЕЛЕННОСТИ**
|
|
||||||
|
|
||||||
```
|
|
||||||
❌ ЗАПРЕЩЕНО: Гадать, предполагать, домысливать
|
|
||||||
✅ ОБЯЗАТЕЛЬНО:
|
|
||||||
1. СТОП - зафиксировать неопределенность
|
|
||||||
2. Использовать инструменты анализа (если применимо)
|
|
||||||
3. Задать прямой вопрос пользователю
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **СТОП-СИГНАЛ #4: ПЕРЕД ВЫПОЛНЕНИЕМ СРЕДНИХ/СЛОЖНЫХ ЗАДАЧ**
|
|
||||||
|
|
||||||
```
|
|
||||||
❌ ЗАПРЕЩЕНО: Сразу приступать к работе
|
|
||||||
✅ ОБЯЗАТЕЛЬНО:
|
|
||||||
1. Применить соответствующий протокол из work-protocols.md
|
|
||||||
2. Создать план через todo_write
|
|
||||||
3. Пройти этап самопроверки
|
|
||||||
```
|
|
||||||
|
|
||||||
### 🔒 СИСТЕМА ПРИНУДИТЕЛЬНЫХ ПРОВЕРОК
|
|
||||||
|
|
||||||
#### **ПРОВЕРКА #1: АНАЛИЗ КОДА**
|
|
||||||
|
|
||||||
```
|
|
||||||
Если задача включает анализ компонентов:
|
|
||||||
□ Использовал ли я codebase_search?
|
|
||||||
□ Прочитал ли я исходный код?
|
|
||||||
□ Основаны ли мои выводы на фактах, а не предположениях?
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **ПРОВЕРКА #2: СИНХРОНИЗАЦИЯ ДОКУМЕНТАЦИИ**
|
|
||||||
|
|
||||||
```
|
|
||||||
Если изменил rules2.md:
|
|
||||||
□ Обновил ли development-checklist.md?
|
|
||||||
□ Добавил ли новые критические правила в чеклист?
|
|
||||||
□ Уведомил ли пользователя о синхронизации?
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **ПРОВЕРКА #3: СОБЛЮДЕНИЕ ПРОТОКОЛОВ**
|
|
||||||
|
|
||||||
```
|
|
||||||
Для каждой задачи:
|
|
||||||
□ Определил ли сложность задачи?
|
|
||||||
□ Применил ли соответствующий протокол?
|
|
||||||
□ Создал ли план действий?
|
|
||||||
□ Провел ли финальную самопроверку?
|
|
||||||
```
|
|
||||||
|
|
||||||
### ⚡ СИСТЕМА АВТОМАТИЧЕСКИХ ТРИГГЕРОВ
|
|
||||||
|
|
||||||
#### **ТРИГГЕР #1: При упоминании компонентов**
|
|
||||||
|
|
||||||
- Ключевые слова: "компонент", "файл", "содержание", "показывает"
|
|
||||||
- Действие: ОБЯЗАТЕЛЬНО использовать инструменты анализа кода
|
|
||||||
|
|
||||||
#### **ТРИГГЕР #2: При изменении rules2.md**
|
|
||||||
|
|
||||||
- Событие: Любое изменение в rules2.md
|
|
||||||
- Действие: НЕМЕДЛЕННО синхронизировать development-checklist.md
|
|
||||||
|
|
||||||
#### **ТРИГГЕР #3: При неопределенности**
|
|
||||||
|
|
||||||
- Ключевые фразы: "возможно", "вероятно", "думаю", "предполагаю"
|
|
||||||
- Действие: СТОП + вопрос пользователю
|
|
||||||
|
|
||||||
### 🎯 СИСТЕМА ОБЯЗАТЕЛЬНЫХ ВОПРОСОВ
|
|
||||||
|
|
||||||
#### **ПЕРЕД НАЧАЛОМ ЛЮБОЙ ЗАДАЧИ:**
|
|
||||||
|
|
||||||
1. Какова сложность этой задачи? (простая/средняя/сложная)
|
|
||||||
2. Какой протокол применить?
|
|
||||||
3. Есть ли неопределенности, требующие уточнения?
|
|
||||||
4. Какие инструменты анализа необходимы?
|
|
||||||
|
|
||||||
#### **ПОСЛЕ КАЖДОГО ЗНАЧИМОГО ДЕЙСТВИЯ:**
|
|
||||||
|
|
||||||
1. Соответствует ли результат правилам в rules2.md?
|
|
||||||
2. Нужно ли синхронизировать documentation?
|
|
||||||
3. Что еще я мог упустить?
|
|
||||||
4. Готов ли результат для пользователя?
|
|
||||||
|
|
||||||
### 🛡️ СИСТЕМА БЛОКИРОВКИ НАРУШЕНИЙ
|
|
||||||
|
|
||||||
#### **БЛОКИРОВКА ТИПА #1: Предположения**
|
|
||||||
|
|
||||||
```javascript
|
|
||||||
if (содержит_предположение && !использовал_анализ_кода) {
|
|
||||||
ОСТАНОВИТЬ_ВЫПОЛНЕНИЕ();
|
|
||||||
ТРЕБОВАТЬ_АНАЛИЗ_КОДА();
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **БЛОКИРОВКА ТИПА #2: Незавершенная синхронизация**
|
|
||||||
|
|
||||||
```javascript
|
|
||||||
if (изменил_rules2md && !обновил_checklist) {
|
|
||||||
ОСТАНОВИТЬ_ОТВЕТ();
|
|
||||||
ТРЕБОВАТЬ_СИНХРОНИЗАЦИЮ();
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **БЛОКИРОВКА ТИПА #3: Пропуск протоколов**
|
|
||||||
|
|
||||||
```javascript
|
|
||||||
if (сложность_задачи >= СРЕДНЯЯ && !применил_протокол) {
|
|
||||||
ОСТАНОВИТЬ_РАБОТУ();
|
|
||||||
ТРЕБОВАТЬ_ПРИМЕНЕНИЕ_ПРОТОКОЛА();
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📋 ИТОГОВЫЙ ЧЕКЛИСТ ПРЕДОТВРАЩЕНИЯ НАРУШЕНИЙ
|
|
||||||
|
|
||||||
### ✅ ПЕРЕД КАЖДЫМ ОТВЕТОМ:
|
|
||||||
|
|
||||||
- [ ] Определена сложность задачи
|
|
||||||
- [ ] Выбран соответствующий протокол
|
|
||||||
- [ ] Проверены стоп-сигналы
|
|
||||||
- [ ] Использованы инструменты анализа (если нужно)
|
|
||||||
- [ ] Заданы уточняющие вопросы (если есть неопределенности)
|
|
||||||
|
|
||||||
### ✅ ПОСЛЕ КАЖДОГО ИЗМЕНЕНИЯ:
|
|
||||||
|
|
||||||
- [ ] Проверено соответствие rules2.md
|
|
||||||
- [ ] Синхронизирован development-checklist.md (если изменялся rules2.md)
|
|
||||||
- [ ] Проведена финальная самопроверка
|
|
||||||
- [ ] Обновлена память (если нужно)
|
|
||||||
|
|
||||||
### ✅ В СЛУЧАЕ СОМНЕНИЙ:
|
|
||||||
|
|
||||||
- [ ] СТОП - зафиксирована неопределенность
|
|
||||||
- [ ] Использованы все доступные инструменты анализа
|
|
||||||
- [ ] Задан прямой вопрос пользователю
|
|
||||||
- [ ] НЕ ДЕЛАТЬ предположений
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**СТАТУС**: АКТИВИРОВАН
|
|
||||||
**ПРИОРИТЕТ**: КРИТИЧЕСКИЙ
|
|
||||||
**ОБХОД**: ЗАПРЕЩЕН
|
|
@ -702,6 +702,380 @@ function PageWithSidebar() {
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**📊 СТАТУС**: Действующие правила v1.0
|
## 14. 🏢 КАБИНЕТ-СПЕЦИФИЧНЫЕ КОМПОНЕНТЫ
|
||||||
**🔄 ОБНОВЛЕНО**: На основе анализа UI Kit системы
|
|
||||||
**📅 ДАТА**: Основано на текущем состоянии проекта
|
> 📌 **СВЯЗАНО С**: [rules-complete.md - Структура кабинетов](#3--структура-кабинетов)
|
||||||
|
|
||||||
|
### 14.1 Кабинет фулфилмента
|
||||||
|
|
||||||
|
#### 14.1.1 Визуальная система 6 модулей склада
|
||||||
|
|
||||||
|
**ЦВЕТОВОЕ КОДИРОВАНИЕ** (обязательная последовательность):
|
||||||
|
|
||||||
|
```css
|
||||||
|
/* 1. ПРОДУКТЫ - готовые к отправке */
|
||||||
|
.module-products {
|
||||||
|
@apply bg-green-500/20 border-green-400 text-green-100;
|
||||||
|
--icon-color: #10b981; /* emerald-500 */
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 2. ТОВАРЫ - базовые товары */
|
||||||
|
.module-goods {
|
||||||
|
@apply bg-blue-500/20 border-blue-400 text-blue-100;
|
||||||
|
--icon-color: #3b82f6; /* blue-500 */
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 3. БРАК - дефектные товары */
|
||||||
|
.module-defect {
|
||||||
|
@apply bg-red-500/20 border-red-400 text-red-100;
|
||||||
|
--icon-color: #ef4444; /* red-500 */
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 4. ВОЗВРАТЫ С ПВЗ - возвращенные товары */
|
||||||
|
.module-returns {
|
||||||
|
@apply bg-yellow-500/20 border-yellow-400 text-yellow-100;
|
||||||
|
--icon-color: #eab308; /* yellow-500 */
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 5. РАСХОДНИКИ СЕЛЛЕРОВ - материалы клиентов */
|
||||||
|
.module-seller-supplies {
|
||||||
|
@apply bg-purple-500/20 border-purple-400 text-purple-100;
|
||||||
|
--icon-color: #a855f7; /* purple-500 */
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 6. РАСХОДНИКИ ФУЛФИЛМЕНТА - операционные материалы (КЛИКАБЕЛЬНЫЙ) */
|
||||||
|
.module-ff-supplies {
|
||||||
|
@apply bg-orange-500/20 border-orange-400 text-orange-100 cursor-pointer hover:bg-orange-400/30;
|
||||||
|
--icon-color: #f97316; /* orange-500 */
|
||||||
|
transition: all 0.2s ease-in-out;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 14.1.2 3-уровневая иерархия склада
|
||||||
|
|
||||||
|
**ВИЗУАЛЬНАЯ СТРУКТУРА**:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
// УРОВЕНЬ 1: МАГАЗИНЫ (синий - крупные блоки)
|
||||||
|
<div className="border-l-4 border-blue-500 bg-blue-500/10 pl-4 mb-3">
|
||||||
|
<div className="flex items-center gap-3">
|
||||||
|
<div className="w-4 h-4 rounded-full bg-blue-500"></div>
|
||||||
|
<span className="text-blue-100 font-semibold text-lg">ТехноМир</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* УРОВЕНЬ 2: ТОВАРЫ (зеленый - средние блоки) */}
|
||||||
|
<div className="border-l-4 border-green-500 bg-green-500/10 pl-6 ml-2 mt-2 mb-2">
|
||||||
|
<div className="flex items-center gap-2">
|
||||||
|
<div className="w-3 h-3 rounded-full bg-green-500"></div>
|
||||||
|
<span className="text-green-100 font-medium">Смартфон iPhone 15</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* УРОВЕНЬ 3: ВАРИАНТЫ (оранжевый - мелкие блоки) */}
|
||||||
|
<div className="border-l-2 border-orange-500 bg-orange-500/10 pl-4 ml-1 mt-1">
|
||||||
|
<div className="flex items-center gap-2">
|
||||||
|
<div className="w-2 h-2 rounded-full bg-orange-500"></div>
|
||||||
|
<span className="text-orange-100 text-sm">128GB Space Black</span>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 14.2 Статусы поставок - расширенная цветовая система
|
||||||
|
|
||||||
|
**8 СТАТУСОВ WORKFLOW** (согласно rules-complete.md):
|
||||||
|
|
||||||
|
```css
|
||||||
|
/* 1. PENDING - ожидает подтверждения */
|
||||||
|
.status-pending {
|
||||||
|
@apply bg-gray-500/20 border-gray-400 text-gray-100;
|
||||||
|
--dot-color: #6b7280;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 2. SUPPLIER_APPROVED - подтверждено поставщиком */
|
||||||
|
.status-supplier-approved {
|
||||||
|
@apply bg-blue-500/20 border-blue-400 text-blue-100;
|
||||||
|
--dot-color: #3b82f6;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 3. CONFIRMED - подтверждено системой */
|
||||||
|
.status-confirmed {
|
||||||
|
@apply bg-cyan-500/20 border-cyan-400 text-cyan-100;
|
||||||
|
--dot-color: #06b6d4;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 4. LOGISTICS_CONFIRMED - подтверждено логистикой */
|
||||||
|
.status-logistics-confirmed {
|
||||||
|
@apply bg-indigo-500/20 border-indigo-400 text-indigo-100;
|
||||||
|
--dot-color: #6366f1;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 5. SHIPPED - отправлено */
|
||||||
|
.status-shipped {
|
||||||
|
@apply bg-purple-500/20 border-purple-400 text-purple-100;
|
||||||
|
--dot-color: #a855f7;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 6. IN_TRANSIT - в пути */
|
||||||
|
.status-in-transit {
|
||||||
|
@apply bg-yellow-500/20 border-yellow-400 text-yellow-100;
|
||||||
|
--dot-color: #eab308;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 7. DELIVERED - доставлено */
|
||||||
|
.status-delivered {
|
||||||
|
@apply bg-green-500/20 border-green-400 text-green-100;
|
||||||
|
--dot-color: #22c55e;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 8. COMPLETED - завершено (только для фулфилмента) */
|
||||||
|
.status-completed {
|
||||||
|
@apply bg-emerald-600/20 border-emerald-500 text-emerald-100;
|
||||||
|
--dot-color: #059669;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 14.3 Процесс создания продукта - визуальный workflow
|
||||||
|
|
||||||
|
**ПОШАГОВЫЙ ИНДИКАТОР** (5 шагов согласно rules-complete.md):
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
const productCreationSteps = [
|
||||||
|
{ id: 'recipe', label: 'Рецептура задана', status: 'completed' },
|
||||||
|
{ id: 'arrival', label: 'Поступление на склад', status: 'completed' },
|
||||||
|
{ id: 'planning', label: 'Планирование работы', status: 'active' },
|
||||||
|
{ id: 'processing', label: 'Обработка товара', status: 'pending' },
|
||||||
|
{ id: 'quality', label: 'Контроль качества', status: 'pending' },
|
||||||
|
{ id: 'completion', label: 'Завершение', status: 'pending' }
|
||||||
|
];
|
||||||
|
|
||||||
|
// Визуальный компонент
|
||||||
|
<div className="flex items-center justify-between mb-6">
|
||||||
|
{productCreationSteps.map((step, index) => (
|
||||||
|
<div key={step.id} className="flex items-center">
|
||||||
|
<div className={`
|
||||||
|
flex items-center justify-center w-10 h-10 rounded-full border-2 text-sm font-semibold
|
||||||
|
${step.status === 'completed' ? 'bg-green-500 border-green-500 text-white' : ''}
|
||||||
|
${step.status === 'active' ? 'bg-blue-500 border-blue-500 text-white animate-pulse' : ''}
|
||||||
|
${step.status === 'pending' ? 'bg-white/10 border-white/30 text-white/50' : ''}
|
||||||
|
`}>
|
||||||
|
{step.status === 'completed' ? '✓' : index + 1}
|
||||||
|
</div>
|
||||||
|
<span className="ml-2 text-sm text-white/70">{step.label}</span>
|
||||||
|
{index < productCreationSteps.length - 1 && (
|
||||||
|
<div className="w-12 h-0.5 bg-white/20 mx-4"></div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 14.4 Система партнерства - визуальные индикаторы
|
||||||
|
|
||||||
|
**ТИПЫ ПАРТНЕРОВ**:
|
||||||
|
|
||||||
|
```css
|
||||||
|
/* WHOLESALE - поставщики */
|
||||||
|
.partner-wholesale {
|
||||||
|
@apply bg-emerald-500/20 border-emerald-400;
|
||||||
|
--icon: "🏭"; /* factory */
|
||||||
|
}
|
||||||
|
|
||||||
|
/* SELLER - селлеры */
|
||||||
|
.partner-seller {
|
||||||
|
@apply bg-blue-500/20 border-blue-400;
|
||||||
|
--icon: "🛍️"; /* shopping */
|
||||||
|
}
|
||||||
|
|
||||||
|
/* FULFILLMENT - фулфилмент центры */
|
||||||
|
.partner-fulfillment {
|
||||||
|
@apply bg-purple-500/20 border-purple-400;
|
||||||
|
--icon: "📦"; /* package */
|
||||||
|
}
|
||||||
|
|
||||||
|
/* LOGIST - логистические компании */
|
||||||
|
.partner-logist {
|
||||||
|
@apply bg-orange-500/20 border-orange-400;
|
||||||
|
--icon: "🚚"; /* truck */
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 14.5 Кабинет селлера
|
||||||
|
|
||||||
|
> 📌 **СВЯЗАНО С**: [rules-complete.md - Кабинет селлера](#9--кабинет-селлера-детальные-правила)
|
||||||
|
|
||||||
|
#### 14.5.1 Трёхблочная архитектура страницы "Мои поставки"
|
||||||
|
|
||||||
|
**КРИТИЧЕСКИ ВАЖНО**: Правильное выравнивание с сайдбаром
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
// ✅ ПРАВИЛЬНАЯ архитектура (согласно rules-complete.md)
|
||||||
|
export function SuppliesPage() {
|
||||||
|
const { getSidebarMargin } = useSidebar();
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="h-screen flex overflow-hidden">
|
||||||
|
<Sidebar />
|
||||||
|
<main className={`flex-1 ${getSidebarMargin()} overflow-hidden transition-all duration-300`}>
|
||||||
|
<div className="h-full flex flex-col">
|
||||||
|
{/* БЛОК 1: ТАБЫ - фиксированная высота, glass-эффект */}
|
||||||
|
<div className="bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl p-6 mb-2">
|
||||||
|
<TabNavigation />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* БЛОК 2: СТАТИСТИКА - контекстные метрики */}
|
||||||
|
<div className="bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl p-4 mb-2">
|
||||||
|
<SupplyStatistics />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* БЛОК 3: ОСНОВНОЙ КОНТЕНТ - до низа sidebar */}
|
||||||
|
<div className="bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl flex-1 overflow-hidden">
|
||||||
|
<SupplyContent />
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</main>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// ❌ НЕПРАВИЛЬНО (текущее состояние)
|
||||||
|
<div className="px-2 py-2"> {/* Нарушает архитектуру! */}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 14.5.2 Контекстная статистика по табам
|
||||||
|
|
||||||
|
**Для пути "Фулфилмент → Товар → Карточки/Поставщики":**
|
||||||
|
```tsx
|
||||||
|
const suppliesStats = [
|
||||||
|
{ label: "Всего поставок", value: "24", color: "text-blue-400" },
|
||||||
|
{ label: "Активных поставок", value: "8", color: "text-green-400" },
|
||||||
|
{ label: "Сумма активных поставок", value: "₽142,350", color: "text-yellow-400" },
|
||||||
|
{ label: "В пути", value: "3", color: "text-purple-400" }
|
||||||
|
];
|
||||||
|
```
|
||||||
|
|
||||||
|
**Для пути "Фулфилмент → Расходники селлера":**
|
||||||
|
```tsx
|
||||||
|
const consumablesStats = [
|
||||||
|
{ label: "Всего поставок", value: "12", color: "text-blue-400" },
|
||||||
|
{ label: "Активных поставок", value: "4", color: "text-green-400" },
|
||||||
|
{ label: "Видов расходников", value: "18", color: "text-orange-400" },
|
||||||
|
{ label: "Критические остатки", value: "2", color: "text-red-400" }
|
||||||
|
];
|
||||||
|
```
|
||||||
|
|
||||||
|
**Для путей "Маркетплейсы → Wildberries/Ozon":**
|
||||||
|
```tsx
|
||||||
|
const marketplaceStats = [
|
||||||
|
{ label: "Поставок на маркетплейс", value: "15", color: "text-blue-400" },
|
||||||
|
{ label: "Товаров отправлено", value: "347", color: "text-green-400" },
|
||||||
|
{ label: "Возвраты за неделю", value: "12", color: "text-yellow-400" },
|
||||||
|
{ label: "Эффективность поставок", value: "94%", color: "text-emerald-400" }
|
||||||
|
];
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 14.5.3 Система создания поставок
|
||||||
|
|
||||||
|
**Выбор типа поставки:**
|
||||||
|
```tsx
|
||||||
|
const supplyTypes = [
|
||||||
|
{
|
||||||
|
id: 'goods-cards',
|
||||||
|
title: 'Карточки товаров',
|
||||||
|
description: 'Импорт через WB API с автосозданием поставки',
|
||||||
|
icon: '📱',
|
||||||
|
color: 'bg-blue-500/20 border-blue-400'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: 'goods-suppliers',
|
||||||
|
title: 'Поставщики товаров',
|
||||||
|
description: 'Прямой заказ с указанием рецептуры',
|
||||||
|
icon: '🏭',
|
||||||
|
color: 'bg-emerald-500/20 border-emerald-400'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: 'consumables',
|
||||||
|
title: 'Расходники селлера',
|
||||||
|
description: 'Материалы для производства',
|
||||||
|
icon: '🔧',
|
||||||
|
color: 'bg-purple-500/20 border-purple-400'
|
||||||
|
}
|
||||||
|
];
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 14.5.4 Интерфейс рецептуры продукта
|
||||||
|
|
||||||
|
**3-блочная структура создания рецептуры:**
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
// БЛОК 1: БАЗОВЫЙ ТОВАР (слева)
|
||||||
|
<div className="w-1/3 bg-white/5 border border-white/10 rounded-xl p-4">
|
||||||
|
<h3 className="text-white font-semibold mb-3">1. Базовый товар</h3>
|
||||||
|
<ProductSelector
|
||||||
|
placeholder="Выберите товар от поставщика"
|
||||||
|
filterType="PRODUCT"
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
// БЛОК 2: УСЛУГИ ФУЛФИЛМЕНТА (центр)
|
||||||
|
<div className="w-1/3 bg-white/5 border border-white/10 rounded-xl p-4">
|
||||||
|
<h3 className="text-white font-semibold mb-3">2. Услуги ФФ</h3>
|
||||||
|
<ServicesSelector
|
||||||
|
placeholder="Упаковка, маркировка..."
|
||||||
|
multiSelect={true}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
// БЛОК 3: РАСХОДНИКИ (справа)
|
||||||
|
<div className="w-1/3 bg-white/5 border border-white/10 rounded-xl p-4">
|
||||||
|
<h3 className="text-white font-semibold mb-3">3. Расходники</h3>
|
||||||
|
<ConsumablesSelector
|
||||||
|
placeholder="Материалы для производства"
|
||||||
|
filterType="CONSUMABLE"
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 14.5.5 WB интеграция - визуальные индикаторы
|
||||||
|
|
||||||
|
**Статусы синхронизации с WB API:**
|
||||||
|
```css
|
||||||
|
/* Успешная синхронизация */
|
||||||
|
.wb-sync-success {
|
||||||
|
@apply bg-green-500/20 border-green-400 text-green-100;
|
||||||
|
--status-icon: "✅";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Ошибка синхронизации */
|
||||||
|
.wb-sync-error {
|
||||||
|
@apply bg-red-500/20 border-red-400 text-red-100;
|
||||||
|
--status-icon: "❌";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* В процессе синхронизации */
|
||||||
|
.wb-sync-loading {
|
||||||
|
@apply bg-yellow-500/20 border-yellow-400 text-yellow-100;
|
||||||
|
--status-icon: "⏳";
|
||||||
|
animation: pulse 2s infinite;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Не настроена */
|
||||||
|
.wb-sync-none {
|
||||||
|
@apply bg-gray-500/20 border-gray-400 text-gray-100;
|
||||||
|
--status-icon: "⚠️";
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**📊 СТАТУС**: Действующие правила v1.2 (добавлен кабинет селлера)
|
||||||
|
**🔄 ОБНОВЛЕНО**: Интеграция с rules-complete.md v6.2
|
||||||
|
**📅 ДАТА**: 2025, полная синхронизация с техническими требованиями
|
||||||
|
|
||||||
|
### 🆕 ДОБАВЛЕНИЯ v1.2:
|
||||||
|
- ✅ Детальные правила для кабинета селлера (раздел 14.5)
|
||||||
|
- ✅ Трёхблочная архитектура страницы "Мои поставки"
|
||||||
|
- ✅ Контекстная статистика по типам поставок
|
||||||
|
- ✅ Визуальные компоненты создания рецептуры
|
||||||
|
- ✅ WB интеграция и статусы синхронизации
|
||||||
|
- ✅ Исправление архитектурного нарушения px-2 py-2
|
||||||
|
@ -1,217 +0,0 @@
|
|||||||
# ПРОТОКОЛЫ РАБОТЫ ДЛЯ AI АССИСТЕНТА
|
|
||||||
|
|
||||||
## 🎯 ПРОТОКОЛ ДЛЯ ЗАДАЧ СРЕДНЕЙ СЛОЖНОСТИ
|
|
||||||
|
|
||||||
### ОПРЕДЕЛЕНИЕ СРЕДНЕЙ СЛОЖНОСТИ:
|
|
||||||
|
|
||||||
- Работа с 2-3 файлами
|
|
||||||
- Изменение логики в 1-2 модулях
|
|
||||||
- Добавление новых функций без изменения архитектуры
|
|
||||||
- Задачи, требующие анализа зависимостей
|
|
||||||
|
|
||||||
### ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:
|
|
||||||
|
|
||||||
#### 1. 🔍 **ЭТАП АНАЛИЗА** (STOP & THINK)
|
|
||||||
|
|
||||||
```
|
|
||||||
ПЕРЕД НАЧАЛОМ ЗАДАТЬ СЕБЕ:
|
|
||||||
□ Какие файлы нужно изучить? (перечислить ВСЕ)
|
|
||||||
□ Какие правила из rules2.md применимы?
|
|
||||||
□ Есть ли зависимости между компонентами?
|
|
||||||
□ Что может пойти не так?
|
|
||||||
□ Нужны ли уточнения от пользователя?
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 2. 📋 **СОЗДАНИЕ ПЛАНА**
|
|
||||||
|
|
||||||
```
|
|
||||||
□ Разбить задачу на подзадачи (не более 5)
|
|
||||||
□ Определить порядок выполнения
|
|
||||||
□ Выявить критические точки
|
|
||||||
□ Создать TODO список
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 3. 🔄 **ВЫПОЛНЕНИЕ С ПРОВЕРКАМИ**
|
|
||||||
|
|
||||||
```
|
|
||||||
ПОСЛЕ КАЖДОГО ШАГА:
|
|
||||||
□ Соответствует ли результат rules2.md?
|
|
||||||
□ Не нарушены ли связи с другими модулями?
|
|
||||||
□ Работает ли измененный код?
|
|
||||||
□ Нужно ли обновить documentation?
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 4. ✅ **ФИНАЛЬНАЯ САМОПРОВЕРКА**
|
|
||||||
|
|
||||||
```
|
|
||||||
□ Прочитать изменения еще раз
|
|
||||||
□ Проверить development-checklist.md
|
|
||||||
□ Убедиться в полноте решения
|
|
||||||
□ Задать вопрос: "Что еще я мог упустить?"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🔥 ПРОТОКОЛ ДЛЯ ЗАДАЧ ВЫСОКОЙ СЛОЖНОСТИ
|
|
||||||
|
|
||||||
### ОПРЕДЕЛЕНИЕ ВЫСОКОЙ СЛОЖНОСТИ:
|
|
||||||
|
|
||||||
- Работа с 4+ файлами
|
|
||||||
- Изменение архитектуры системы
|
|
||||||
- Создание новых модулей/компонентов
|
|
||||||
- Задачи, влияющие на несколько кабинетов
|
|
||||||
- Изменения в правилах или workflow
|
|
||||||
|
|
||||||
### ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:
|
|
||||||
|
|
||||||
#### 1. 🛑 **СТОП! ГЛУБОКИЙ АНАЛИЗ**
|
|
||||||
|
|
||||||
```
|
|
||||||
ОБЯЗАТЕЛЬНЫЕ ВОПРОСЫ ПОЛЬЗОВАТЕЛЮ:
|
|
||||||
□ Уточнить ВСЕ требования и ожидания
|
|
||||||
□ Выяснить приоритеты и ограничения
|
|
||||||
□ Узнать о связях с другими системами
|
|
||||||
□ Понять критерии успеха
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 2. 🔍 **ИССЛЕДОВАТЕЛЬСКАЯ ФАЗА**
|
|
||||||
|
|
||||||
```
|
|
||||||
□ Изучить ВСЕ связанные файлы параллельно
|
|
||||||
□ Построить карту зависимостей
|
|
||||||
□ Найти все правила в rules2.md
|
|
||||||
□ Выявить потенциальные конфликты
|
|
||||||
□ Проанализировать влияние на систему
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 3. 📊 **СОЗДАНИЕ ДЕТАЛЬНОГО ПЛАНА**
|
|
||||||
|
|
||||||
```
|
|
||||||
□ Разбить на этапы с промежуточными проверками
|
|
||||||
□ Определить точки возврата (rollback points)
|
|
||||||
□ Создать план тестирования
|
|
||||||
□ Предусмотреть обновление документации
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 4. 🎯 **ПОЭТАПНОЕ ВЫПОЛНЕНИЕ**
|
|
||||||
|
|
||||||
```
|
|
||||||
ПОСЛЕ КАЖДОГО ЭТАПА:
|
|
||||||
□ Проверка работоспособности
|
|
||||||
□ Валидация против всех правил
|
|
||||||
□ Промежуточная демонстрация пользователю
|
|
||||||
□ Корректировка плана при необходимости
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 5. 🔄 **ИТЕРАТИВНАЯ ПРОВЕРКА**
|
|
||||||
|
|
||||||
```
|
|
||||||
□ Полное тестирование системы
|
|
||||||
□ Проверка всех затронутых модулей
|
|
||||||
□ Обновление всей связанной документации
|
|
||||||
□ Финальное согласование с пользователем
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ❓ СИСТЕМА ОБЯЗАТЕЛЬНЫХ УТОЧНЕНИЙ
|
|
||||||
|
|
||||||
### КОГДА ВСЕГДА СПРАШИВАТЬ:
|
|
||||||
|
|
||||||
#### 🔴 **КРИТИЧЕСКИЕ СИТУАЦИИ** (ОБЯЗАТЕЛЬНО):
|
|
||||||
|
|
||||||
- Обнаружил противоречие в правилах
|
|
||||||
- Задача может нарушить архитектуру системы
|
|
||||||
- Неясно как применить правило к конкретной ситуации
|
|
||||||
- Есть несколько способов решения с разными последствиями
|
|
||||||
- Изменения затрагивают критические бизнес-процессы
|
|
||||||
|
|
||||||
#### 🟡 **ВАЖНЫЕ СИТУАЦИИ** (РЕКОМЕНДУЕТСЯ):
|
|
||||||
|
|
||||||
- Задача требует создания новых типов данных
|
|
||||||
- Нужно изменить существующий workflow
|
|
||||||
- Есть сомнения в интерпретации требований
|
|
||||||
- Решение может повлиять на производительность
|
|
||||||
- Требуется интеграция с внешними системами
|
|
||||||
|
|
||||||
### ФОРМАТ УТОЧНЯЮЩИХ ВОПРОСОВ:
|
|
||||||
|
|
||||||
```
|
|
||||||
🎯 КОНТЕКСТ: Что именно я делаю
|
|
||||||
❓ ВОПРОС: Что конкретно неясно
|
|
||||||
⚖️ ВАРИАНТЫ: Какие есть альтернативы (если применимо)
|
|
||||||
⚠️ РИСКИ: Что может пойти не так
|
|
||||||
💡 ПРЕДЛОЖЕНИЕ: Мой рекомендуемый подход
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🛠️ СИСТЕМА САМОПРОВЕРКИ
|
|
||||||
|
|
||||||
### ЧЕК-ЛИСТ ПОСЛЕ КАЖДОЙ ЗАДАЧИ:
|
|
||||||
|
|
||||||
#### ✅ **СООТВЕТСТВИЕ ПРАВИЛАМ**
|
|
||||||
|
|
||||||
```
|
|
||||||
□ Проверил против rules2.md (ВСЕ применимые разделы)
|
|
||||||
□ Обновил development-checklist.md если нужно
|
|
||||||
□ Не нарушил критические запреты
|
|
||||||
□ Соблюдены принципы ТОВАР ≠ ПРОДУКТ
|
|
||||||
□ Workflow статусы корректны
|
|
||||||
```
|
|
||||||
|
|
||||||
#### ✅ **ТЕХНИЧЕСКОЕ КАЧЕСТВО**
|
|
||||||
|
|
||||||
```
|
|
||||||
□ Код следует принципам SOLID
|
|
||||||
□ Добавлены необходимые проверки и валидации
|
|
||||||
□ Обработаны ошибки
|
|
||||||
□ Производительность не пострадала
|
|
||||||
□ Безопасность данных соблюдена
|
|
||||||
```
|
|
||||||
|
|
||||||
#### ✅ **ПОЛНОТА РЕШЕНИЯ**
|
|
||||||
|
|
||||||
```
|
|
||||||
□ Решены ВСЕ аспекты задачи
|
|
||||||
□ Обновлена документация
|
|
||||||
□ Проверены связанные компоненты
|
|
||||||
□ Нет "технических долгов"
|
|
||||||
□ Готово к production
|
|
||||||
```
|
|
||||||
|
|
||||||
#### ✅ **КОММУНИКАЦИЯ**
|
|
||||||
|
|
||||||
```
|
|
||||||
□ Объяснил что сделал и почему
|
|
||||||
□ Указал на важные изменения
|
|
||||||
□ Предупредил о потенциальных рисках
|
|
||||||
□ Дал рекомендации по дальнейшим действиям
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🎖️ ДОПОЛНИТЕЛЬНЫЕ РЕКОМЕНДАЦИИ
|
|
||||||
|
|
||||||
### ДЛЯ ПОЛЬЗОВАТЕЛЯ:
|
|
||||||
|
|
||||||
1. **📋 Создавайте подробные задачи** - чем больше контекста, тем лучше результат
|
|
||||||
2. **🎯 Указывайте приоритеты** - что критично, а что можно отложить
|
|
||||||
3. **⚠️ Предупреждайте об ограничениях** - технических, временных, бизнесовых
|
|
||||||
4. **🔄 Давайте обратную связь** - что работает хорошо, что нужно улучшить
|
|
||||||
|
|
||||||
### ДЛЯ МЕНЯ:
|
|
||||||
|
|
||||||
1. **🛑 Принцип "Стоп и подумай"** перед каждой сложной задачей
|
|
||||||
2. **📊 Параллельный сбор информации** вместо последовательного
|
|
||||||
3. **❓ Активное уточнение** при малейших сомнениях
|
|
||||||
4. **🔄 Итеративная проверка** на каждом этапе
|
|
||||||
5. **📝 Документирование процесса** для улучшения в будущем
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🚀 АКТИВАЦИЯ ПРОТОКОЛОВ
|
|
||||||
|
|
||||||
Данные протоколы активируются автоматически на основе сложности задачи. Я буду следовать им при каждой работе с проектом Sfera.
|
|
||||||
|
|
||||||
**КРИТЕРИЙ УСПЕХА**: Количество пропущенных важных деталей = 0
|
|
Reference in New Issue
Block a user