feat: Enhance warehouse statistics with detailed logging and real-time updates
- Improved logging for warehouse statistics to aid in debugging - Updated GraphQL resolver to track 24-hour changes in warehouse metrics - Implemented polling mechanism for real-time updates of warehouse statistics - Enhanced StatCard component to reflect accurate percentage changes from GraphQL data 🤖 Generated with [Claude Code](https://claude.ai/code)
This commit is contained in:
772
описание.md
Normal file
772
описание.md
Normal file
@ -0,0 +1,772 @@
|
||||
# СИСТЕМА УПРАВЛЕНИЯ СКЛАДАМИ И ПОСТАВКАМИ - ПОЛНОЕ ОПИСАНИЕ ПРОЕКТА
|
||||
|
||||
> ⚠️ **ВАЖНОЕ ПРИМЕЧАНИЕ**: Данные из этого файла могут быть удалены только с разрешения пользователя. Все изменения должны согласовываться.
|
||||
|
||||
---
|
||||
|
||||
## 📑 ОГЛАВЛЕНИЕ
|
||||
|
||||
### 🏗️ **АРХИТЕКТУРА СИСТЕМЫ**
|
||||
|
||||
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 Основные возможности
|
||||
|
||||
Возможность создать карточки различных типов предметов:
|
||||
|
||||
**4 основных типа предметов в системе:**
|
||||
|
||||
1. **ТОВАР** - базовый тип товара от поставщика
|
||||
2. **БРАК** - производная от товара (товар с дефектами)
|
||||
3. **РАСХОДНИКИ** - материалы и вспомогательные товары от поставщика
|
||||
4. **ПРОДУКТ** - производная от товара (готовый к продаже товар)
|
||||
|
||||
**ВАЖНО**: Товар ≠ Продукт (это разные сущности в системе)
|
||||
|
||||
**ЛОГИКА КЛАССИФИКАЦИИ РАСХОДНИКОВ:**
|
||||
|
||||
- Поставщик создает карточки типа **"РАСХОДНИКИ"** (без уточнения назначения)
|
||||
- При заказе, в зависимости от заказчика, они классифицируются как:
|
||||
- **"Расходники фулфилмента"** - если заказывает фулфилмент-центр
|
||||
- **"Расходники селлеров"** - если заказывает селлер
|
||||
|
||||
Разделение всех типов предметов на категории. Каждый тип имеет свою логику обработки и 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.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_
|
773
правила.md
Normal file
773
правила.md
Normal file
@ -0,0 +1,773 @@
|
||||
# ПРАВИЛА СИСТЕМЫ СКЛАДА ПОСТАВЩИКА
|
||||
|
||||
> ⚠️ **ВАЖНОЕ ПРИМЕЧАНИЕ**: Данные из этого файла могут быть удалены только с разрешения пользователя. Все изменения должны согласовываться.
|
||||
|
||||
## 1. 🎯 ОСНОВНЫЕ ПРИНЦИПЫ
|
||||
|
||||
### 1.1 Типизация предметов
|
||||
|
||||
- **ОБЯЗАТЕЛЬНО**: Каждый предмет должен иметь один из следующих типов:
|
||||
|
||||
1. **ТОВАР** - базовый тип товара от поставщика
|
||||
2. **БРАК** - производная от товара (товар с дефектами)
|
||||
3. **РАСХОДНИКИ** - материалы и вспомогательные товары от поставщика
|
||||
4. **ПРОДУКТ** - производная от товара (готовый к продаже товар)
|
||||
|
||||
- **ЗАПРЕЩЕНО**: Создание предметов без указания типа
|
||||
- **ВАЖНО**: Товар ≠ Продукт (это разные сущности в системе)
|
||||
- **ПРАВИЛО**: Тип определяет логику обработки, отображения и 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_
|
||||
_Статус: АКТИВНЫЕ ПРАВИЛА_
|
Reference in New Issue
Block a user