1071 lines
54 KiB
Markdown
1071 lines
54 KiB
Markdown
# ПРАВИЛА СИСТЕМЫ УПРАВЛЕНИЯ СКЛАДАМИ И ПОСТАВКАМИ - БАЗА ЗНАНИЙ v2.0
|
||
|
||
> ⚠️ **ВАЖНОЕ ПРИМЕЧАНИЕ**: Данный файл является объединенной базой знаний системы на основе анализа rules.md, rules1.md и description.md. Все изменения должны согласовываться.
|
||
|
||
---
|
||
|
||
## 📑 ОГЛАВЛЕНИЕ
|
||
|
||
### 🏗️ **АРХИТЕКТУРА И ОСНОВЫ**
|
||
|
||
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. [📋 Приложение: Дополнительные возможности и планы](#-приложение-дополнительные-возможности-и-планы)
|
||
|
||
---
|
||
|
||
## 🏷️ РЕЕСТР СУЩНОСТЕЙ СИСТЕМЫ
|
||
|
||
### 📦 **ОСНОВНЫЕ ПРЕДМЕТЫ**
|
||
|
||
| Сущность | Название в системе | Кабинет создания | Описание | Статус |
|
||
| ---------- | ---------------------------------- | ---------------- | ----------------------------------------------- | --------------- |
|
||
| Товар | `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) | Управляет доставками | ✅ Реализовано |
|
||
|
||
---
|
||
|
||
## 1. 🎯 ОСНОВНЫЕ ПРИНЦИПЫ СИСТЕМЫ
|
||
|
||
### 1.1 Главная логика системы
|
||
|
||
**КЛЮЧЕВОЕ ПРАВИЛО**: Товар ≠ Продукт (это разные сущности в системе)
|
||
|
||
- **ТОВАР** - сырье, базовый материал от поставщика
|
||
- **ПРОДУКТ** - готовая к продаже единица после обработки
|
||
|
||
### 1.2 Потоки в системе
|
||
|
||
**ПОТОК ТОВАРОВ**: Поставщик → Фулфилмент → Селлер/Маркетплейс
|
||
**ПОТОК РАСХОДНИКОВ**: Поставщик → Фулфилмент/Селлер (в зависимости от заказчика)
|
||
|
||
### 1.3 Уникальность артикулов
|
||
|
||
- **ФОРМАТ**: `СФ-{ТИП}-{КОД_КАТЕГОРИИ}-{КОД_ОРГАНИЗАЦИИ}-{TIMESTAMP}-{RANDOM}`
|
||
- **ТИПЫ В АРТИКУЛЕ**:
|
||
- `TOV` - Товар
|
||
- `BRK` - Брак
|
||
- `R` - Расходники
|
||
- `PRD` - Продукт
|
||
|
||
---
|
||
|
||
## 2. 📦 ТИПИЗАЦИЯ ПРЕДМЕТОВ
|
||
|
||
### 2.1 Четыре основных типа предметов
|
||
|
||
#### **1. ТОВАР** (базовый тип)
|
||
|
||
- **СОЗДАЕТСЯ**: Поставщиком
|
||
- **СТАТУС**: Может быть активным/неактивным
|
||
- **ЗАКАЗ**: Доступен для заказа всеми типами организаций
|
||
- **ТРАНСФОРМАЦИЯ**: Может стать ПРОДУКТОМ или БРАКОМ
|
||
- **ЦЕНА**: Обязательна, больше 0
|
||
|
||
#### **2. БРАК** (производная от товара)
|
||
|
||
- **СОЗДАЕТСЯ**: Фулфилментом на основе существующего ТОВАРА при обнаружении дефектов
|
||
- **МОМЕНТ СОЗДАНИЯ**: В процессе "Создание продукта" / "В работе" после подсчета факта
|
||
- **СВЯЗЬ**: Обязательная связь с родительским товаром (parentId)
|
||
- **ЗАКАЗ**: ЗАПРЕЩЕН заказ брака
|
||
- **СТАТУС**: Всегда неактивен для заказа
|
||
- **ЦЕНА**: Для селлера - себестоимость дефектного товара, для фулфилмента - 0
|
||
- **WORKFLOW**: Особый процесс списания и утилизации
|
||
- **УЧЕТ**: Отдельный учет в статистике потерь
|
||
- **ОТОБРАЖЕНИЕ**: Виден только для учета потерь
|
||
|
||
#### **3. РАСХОДНИКИ** (базовый тип)
|
||
|
||
- **СОЗДАЕТСЯ**: Поставщиком как универсальный тип
|
||
- **КЛАССИФИКАЦИЯ ПРИ ЗАКАЗЕ**:
|
||
- Фулфилмент заказывает → "Расходники фулфилмента"
|
||
- Селлер заказывает → "Расходники селлеров"
|
||
- **ДОСТУП**: Видны всем типам организаций в маркете
|
||
|
||
#### **4. ПРОДУКТ** (производная от товара)
|
||
|
||
- **СОЗДАЕТСЯ**: Фулфилментом на основе ТОВАРА по заказу селлера
|
||
- **ИНИЦИАТОР**: Селлер создает заказ с рецептурой, фулфилмент исполняет
|
||
- **СВЯЗЬ**: Обязательная связь с родительским товаром (parentId)
|
||
- **РЕЦЕПТУРА**: Задается селлером при создании заказа (Товар + Услуга + Расходники)
|
||
- **СТАТУСЫ**: "в работе" → "готов к отправке"
|
||
- **ЗАКАЗ**: Доступен только в статусе "готов к отправке"
|
||
|
||
### 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 Экономика
|
||
|
||
_Раздел находится в разработке. Будет добавлен позже._
|
||
|
||
---
|
||
|
||
## 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 Глобальная интеграция
|
||
|
||
- **МАРКЕТ**: Товары поставщиков отображаются в глобальном маркете
|
||
- **СИНХРОНИЗАЦИЯ**: Данные склада синхронизируются с модулем аналитики
|
||
- **УВЕДОМЛЕНИЯ**: Единая система через встроенный мессенджер
|
||
|
||
### 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. Прочие товары
|
||
|
||
---
|
||
|
||
_Эта база знаний создана на основе анализа rules.md, rules1.md и description.md и является единым источником понимания структуры и логики проекта._
|
||
|
||
_Версия: 2.0_
|
||
_Дата создания: 2024_
|
||
_Статус: АКТИВНАЯ БАЗА ЗНАНИЙ_
|
||
1
|