Добавлены кнопки навигации "Главная" и "Экономика" в боковую панель. Реализованы обработчики кликов для перехода на соответствующие страницы. Обновлены стили кнопок для улучшения пользовательского интерфейса в зависимости от состояния навигации.
This commit is contained in:
Veronika Smirnova
141
auto-sync-system.md
Normal file
141
auto-sync-system.md
Normal file
@ -0,0 +1,141 @@
|
|||||||
|
# СИСТЕМА АВТОМАТИЧЕСКОЙ СИНХРОНИЗАЦИИ
|
||||||
|
|
||||||
|
## 🔄 ПРИНЦИП АВТОСИНХРОНИЗАЦИИ
|
||||||
|
|
||||||
|
**ПРАВИЛО**: При любом изменении в `rules2.md` автоматически анализировать влияние на `development-checklist.md` и обновлять его.
|
||||||
|
|
||||||
|
## 📊 АЛГОРИТМ СИНХРОНИЗАЦИИ
|
||||||
|
|
||||||
|
### 1. 🔍 **ТРИГГЕРЫ ДЛЯ СИНХРОНИЗАЦИИ**
|
||||||
|
|
||||||
|
```
|
||||||
|
КОГДА СИНХРОНИЗИРОВАТЬ:
|
||||||
|
✅ Добавлено новое критическое правило в rules2.md
|
||||||
|
✅ Изменены запреты или ограничения
|
||||||
|
✅ Обновлены workflow процессы
|
||||||
|
✅ Модифицированы правила валидации
|
||||||
|
✅ Добавлены новые типы данных или сущности
|
||||||
|
✅ Изменены технические требования
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 🎯 **КАТЕГОРИИ ИЗМЕНЕНИЙ**
|
||||||
|
|
||||||
|
#### 🔴 **КРИТИЧЕСКИЕ** (обязательно добавить в checklist):
|
||||||
|
|
||||||
|
- Новые запреты (❌ НИКОГДА НЕ ДЕЛАТЬ)
|
||||||
|
- Обязательные проверки данных
|
||||||
|
- Правила безопасности
|
||||||
|
- Критические бизнес-правила
|
||||||
|
- Валидация типов предметов
|
||||||
|
|
||||||
|
#### 🟡 **ВАЖНЫЕ** (рекомендуется добавить):
|
||||||
|
|
||||||
|
- Новые workflow этапы
|
||||||
|
- Правила производительности
|
||||||
|
- UX требования
|
||||||
|
- Интеграционные требования
|
||||||
|
|
||||||
|
#### 🟢 **ДОПОЛНИТЕЛЬНЫЕ** (опционально):
|
||||||
|
|
||||||
|
- Рекомендации по улучшению
|
||||||
|
- Косметические правила
|
||||||
|
- Экспериментальные функции
|
||||||
|
|
||||||
|
### 3. 📋 **ПРОЦЕСС ОБНОВЛЕНИЯ CHECKLIST**
|
||||||
|
|
||||||
|
```
|
||||||
|
1. АНАЛИЗ ИЗМЕНЕНИЙ в rules2.md
|
||||||
|
↓
|
||||||
|
2. ОПРЕДЕЛЕНИЕ КАТЕГОРИИ (критическое/важное/дополнительное)
|
||||||
|
↓
|
||||||
|
3. ПОИСК СООТВЕТСТВУЮЩЕЙ СЕКЦИИ в development-checklist.md
|
||||||
|
↓
|
||||||
|
4. ДОБАВЛЕНИЕ/ОБНОВЛЕНИЕ ЧЕКБОКСА
|
||||||
|
↓
|
||||||
|
5. УВЕДОМЛЕНИЕ ПОЛЬЗОВАТЕЛЯ о синхронизации
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🛠️ ПРАКТИЧЕСКИЕ ПРИМЕРЫ
|
||||||
|
|
||||||
|
### ПРИМЕР 1: Добавлено новое правило в rules2.md
|
||||||
|
|
||||||
|
```
|
||||||
|
ИЗМЕНЕНИЕ: "Товар должен иметь минимум одно изображение"
|
||||||
|
↓
|
||||||
|
ACTION: Добавить в development-checklist.md:
|
||||||
|
"- [ ] Товар имеет минимум одно изображение"
|
||||||
|
```
|
||||||
|
|
||||||
|
### ПРИМЕР 2: Изменен workflow статус
|
||||||
|
|
||||||
|
```
|
||||||
|
ИЗМЕНЕНИЕ: Добавлен новый статус "QUALITY_CHECK"
|
||||||
|
↓
|
||||||
|
ACTION: Обновить в checklist секцию "Workflow поставок":
|
||||||
|
"- [ ] Соблюдение последовательности: PENDING → SUPPLIER_APPROVED → QUALITY_CHECK → CONFIRMED..."
|
||||||
|
```
|
||||||
|
|
||||||
|
### ПРИМЕР 3: Новое техническое требование
|
||||||
|
|
||||||
|
```
|
||||||
|
ИЗМЕНЕНИЕ: "API должно возвращать ответ за 500ms"
|
||||||
|
↓
|
||||||
|
ACTION: Добавить в секцию "Производительность":
|
||||||
|
"- [ ] API возвращает ответ за 500ms или меньше"
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🎯 ШАБЛОНЫ ДЛЯ СИНХРОНИЗАЦИИ
|
||||||
|
|
||||||
|
### ФОРМАТ ДОБАВЛЕНИЯ В CHECKLIST:
|
||||||
|
|
||||||
|
```
|
||||||
|
- [ ] {КРАТКОЕ_ОПИСАНИЕ_ПРАВИЛА} {(ИСТОЧНИК_ЕСЛИ_НУЖНО)}
|
||||||
|
```
|
||||||
|
|
||||||
|
### ПРИМЕРЫ ХОРОШИХ ЧЕКБОКСОВ:
|
||||||
|
|
||||||
|
```
|
||||||
|
✅ - [ ] Проверить типизацию: ТОВАР ≠ ПРОДУКТ
|
||||||
|
✅ - [ ] Валидировать остатки перед добавлением в корзину
|
||||||
|
✅ - [ ] Запретить заказ предметов типа БРАК
|
||||||
|
✅ - [ ] Обеспечить связь parentId для производных типов
|
||||||
|
```
|
||||||
|
|
||||||
|
### ПРИМЕРЫ ПЛОХИХ ЧЕКБОКСОВ:
|
||||||
|
|
||||||
|
```
|
||||||
|
❌ - [ ] Проверить что все хорошо (слишком общий)
|
||||||
|
❌ - [ ] Сделать как в rules2.md (не конкретный)
|
||||||
|
❌ - [ ] Не забыть про безопасность (неизмеримый)
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🔄 АВТОМАТИЧЕСКОЕ УВЕДОМЛЕНИЕ
|
||||||
|
|
||||||
|
Когда я обновляю `development-checklist.md` из-за изменений в `rules2.md`, я буду сообщать:
|
||||||
|
|
||||||
|
```
|
||||||
|
🔄 АВТОСИНХРОНИЗАЦИЯ ВЫПОЛНЕНА:
|
||||||
|
📝 Изменения в rules2.md: {ОПИСАНИЕ}
|
||||||
|
✅ Обновлен development-checklist.md: {КОНКРЕТНЫЕ ДОБАВЛЕНИЯ}
|
||||||
|
🎯 Новых критических проверок: {КОЛИЧЕСТВО}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📊 МОНИТОРИНГ СИНХРОНИЗАЦИИ
|
||||||
|
|
||||||
|
### МЕТРИКИ КАЧЕСТВА:
|
||||||
|
|
||||||
|
- Время между изменением rules2.md и обновлением checklist
|
||||||
|
- Полнота переноса критических правил
|
||||||
|
- Отсутствие дублирования в checklist
|
||||||
|
- Актуальность формулировок
|
||||||
|
|
||||||
|
### УСПЕШНАЯ СИНХРОНИЗАЦИЯ:
|
||||||
|
|
||||||
|
✅ Все критические правила отражены в checklist
|
||||||
|
✅ Формулировки понятны и проверяемы
|
||||||
|
✅ Нет дублирования или противоречий
|
||||||
|
✅ Checklist остается удобным для использования
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**СТАТУС**: Система активирована и будет применяться при каждом изменении rules2.md
|
||||||
178
development-checklist.md
Normal file
178
development-checklist.md
Normal file
@ -0,0 +1,178 @@
|
|||||||
|
# ЧЕКЛИСТ РАЗРАБОТКИ - ОБЯЗАТЕЛЬНЫЕ ПРОВЕРКИ
|
||||||
|
|
||||||
|
> ⚠️ **КРИТИЧЕСКИ ВАЖНО**: Этот чеклист ОБЯЗАТЕЛЕН к проверке перед любым изменением кода!
|
||||||
|
|
||||||
|
## 🔴 КРИТИЧЕСКИЕ ПРОВЕРКИ (НЕЛЬЗЯ НАРУШАТЬ)
|
||||||
|
|
||||||
|
### ✅ Типизация предметов
|
||||||
|
|
||||||
|
- [ ] Каждый предмет имеет один из 4 типов: ТОВАР, БРАК, РАСХОДНИКИ, ПРОДУКТ
|
||||||
|
- [ ] БРАК и ПРОДУКТ имеют обязательную связь с родительским товаром (parentId)
|
||||||
|
- [ ] Расходники создаются как универсальный тип, классифицируются при заказе
|
||||||
|
- [ ] ТОВАР ≠ ПРОДУКТ (разные сущности в системе)
|
||||||
|
|
||||||
|
### ✅ Workflow статусов
|
||||||
|
|
||||||
|
- [ ] Соблюдена последовательность: PENDING → SUPPLIER_APPROVED → CONFIRMED → LOGISTICS_CONFIRMED → SHIPPED → IN_TRANSIT → DELIVERED
|
||||||
|
- [ ] Нет пропуска промежуточных статусов
|
||||||
|
- [ ] Каждое изменение статуса сопровождается уведомлением
|
||||||
|
|
||||||
|
### ✅ Правила доступа
|
||||||
|
|
||||||
|
- [ ] Поставщик НЕ может добавлять собственные товары в корзину
|
||||||
|
- [ ] Заказ брака ЗАПРЕЩЕН
|
||||||
|
- [ ] Только активные предметы отображаются в маркете
|
||||||
|
- [ ] Проверка остатков перед добавлением в корзину
|
||||||
|
|
||||||
|
### ✅ Система фулфилмента
|
||||||
|
|
||||||
|
- [ ] Товары разделены на "на складе" и "в обработке"
|
||||||
|
- [ ] Модули статистики в правильной последовательности: ПРОДУКТ → ТОВАР → БРАК → ВОЗВРАТЫ → РАСХОДНИКИ СЕЛЛЕРОВ → РАСХОДНИКИ ФУЛФИЛМЕНТА
|
||||||
|
- [ ] Процесс создания продукта включает учет план/факт
|
||||||
|
|
||||||
|
### ✅ Система логистики
|
||||||
|
|
||||||
|
- [ ] Своевременное подтверждение заявок на доставку
|
||||||
|
- [ ] Соблюдение workflow логистики: получение заявки → подтверждение → забор → доставка
|
||||||
|
- [ ] Корректная работа системы тарификации (до 1м³ и свыше 1м³)
|
||||||
|
- [ ] Обязательные уведомления о статусе доставки
|
||||||
|
|
||||||
|
### ✅ Структура кабинетов
|
||||||
|
|
||||||
|
- [ ] Каждый тип кабинета имеет страницу "Главная" (РЕАЛИЗОВАНО)
|
||||||
|
- [ ] Страница "Главная" первая в sidebar навигации (РЕАЛИЗОВАНО)
|
||||||
|
- [ ] Условное отображение разделов по типу организации: `{user?.organization?.type === "TYPE" && (...)}`
|
||||||
|
- [ ] Адаптивный роутинг для кнопок с разной логикой по типам кабинетов
|
||||||
|
- [ ] Роут `/home` с универсальным компонентом HomePageWrapper
|
||||||
|
- [ ] 4 типо-зависимых компонента: SellerHomePage, FulfillmentHomePage, WholesaleHomePage, LogistHomePage
|
||||||
|
- [ ] Проверки доступа и безопасности в каждом компоненте
|
||||||
|
- [ ] Каждый кабинет имеет раздел "Экономика" (РЕАЛИЗОВАНО В СИСТЕМЕ)
|
||||||
|
- [ ] Разделы "Экономика" размещены перед настройками в каждом кабинете (РЕАЛИЗОВАНО)
|
||||||
|
- [ ] Пустые разделы-заглушки с пометкой "будет добавлен позже" (РЕАЛИЗОВАНО)
|
||||||
|
- [ ] Роут `/economics` с универсальным компонентом EconomicsPageWrapper (РЕАЛИЗОВАНО)
|
||||||
|
- [ ] 4 типо-зависимых компонента экономики: SellerEconomicsPage, FulfillmentEconomicsPage, WholesaleEconomicsPage, LogistEconomicsPage (РЕАЛИЗОВАНО)
|
||||||
|
- [ ] Кнопка "Экономика" в sidebar навигации перед настройками (РЕАЛИЗОВАНО)
|
||||||
|
- [ ] Проверки доступа и безопасности в экономических компонентах (РЕАЛИЗОВАНО)
|
||||||
|
|
||||||
|
### ✅ Обязательные поля
|
||||||
|
|
||||||
|
- [ ] Название, артикул, цена > 0, тип предмета
|
||||||
|
- [ ] ИСКЛЮЧЕНИЕ: Цена брака может быть 0 для фулфилмента (себестоимость для селлера)
|
||||||
|
- [ ] Уникальность артикула в рамках организации
|
||||||
|
- [ ] Формат артикула: СФ-{ТИП}-{КОД*КАТЕГОРИИ}-{КОД*ОРГАНИЗАЦИИ}-{TIMESTAMP}-{RANDOM}
|
||||||
|
- [ ] Товар имеет минимум одно изображение (ПРИМЕР АВТОСИНХРОНИЗАЦИИ)
|
||||||
|
|
||||||
|
## 🟡 ВАЖНЫЕ ПРОВЕРКИ
|
||||||
|
|
||||||
|
### ✅ Валидация данных
|
||||||
|
|
||||||
|
- [ ] Все числовые значения корректны (цена > 0, вес > 0)
|
||||||
|
- [ ] Количество в заказе не превышает остаток
|
||||||
|
- [ ] Проверка корректности дат (не прошедшие для поставок)
|
||||||
|
- [ ] Валидация количества: минимум 1 единица/комплект, максимум = остаток у поставщика
|
||||||
|
- [ ] Проверка в реальном времени при изменении количества
|
||||||
|
|
||||||
|
### ✅ Уведомления
|
||||||
|
|
||||||
|
- [ ] Автоматические уведомления при создании заказов
|
||||||
|
- [ ] Уведомления при изменении статусов всем участникам
|
||||||
|
- [ ] Логирование всех изменений
|
||||||
|
|
||||||
|
### ✅ Интеграции
|
||||||
|
|
||||||
|
- [ ] Синхронизация данных между модулями
|
||||||
|
- [ ] Корректная работа с API маркетплейсов
|
||||||
|
- [ ] Связь с модулем "Услуги" для расходников фулфилмента
|
||||||
|
|
||||||
|
## 💻 ТЕХНИЧЕСКИЕ ПРОВЕРКИ
|
||||||
|
|
||||||
|
### ✅ Пользовательский интерфейс
|
||||||
|
|
||||||
|
- [ ] Адаптивность интерфейса для всех устройств
|
||||||
|
- [ ] Индикаторы загрузки для длительных операций
|
||||||
|
- [ ] Подтверждение критических действий
|
||||||
|
- [ ] Время загрузки страницы не более 3 секунд
|
||||||
|
|
||||||
|
### ✅ Обработка ошибок
|
||||||
|
|
||||||
|
- [ ] Логирование всех ошибок с детальной информацией
|
||||||
|
- [ ] Понятные сообщения об ошибках для пользователя
|
||||||
|
- [ ] Автоматическое восстановление после сбоев
|
||||||
|
- [ ] Регулярное резервное копирование данных
|
||||||
|
|
||||||
|
### ✅ Производительность
|
||||||
|
|
||||||
|
- [ ] Пагинация для больших списков товаров
|
||||||
|
- [ ] Ленивая загрузка изображений
|
||||||
|
- [ ] Кэширование часто запрашиваемых данных
|
||||||
|
- [ ] Готовность к масштабированию
|
||||||
|
|
||||||
|
### ✅ Безопасность данных
|
||||||
|
|
||||||
|
- [ ] Шифрование чувствительных данных
|
||||||
|
- [ ] Аудит всех действий пользователей
|
||||||
|
- [ ] Контроль доступа на уровне API
|
||||||
|
- [ ] Соответствие требованиям GDPR
|
||||||
|
|
||||||
|
### ✅ Качество кода
|
||||||
|
|
||||||
|
- [ ] Покрытие тестами критической функциональности (минимум 80%)
|
||||||
|
- [ ] Следование принципам SOLID
|
||||||
|
- [ ] Документирование всех API методов
|
||||||
|
- [ ] Автоматическое тестирование при развертывании
|
||||||
|
|
||||||
|
## 🟢 РЕКОМЕНДУЕМЫЕ ПРОВЕРКИ
|
||||||
|
|
||||||
|
### ✅ Пользовательский опыт
|
||||||
|
|
||||||
|
- [ ] Адаптивность интерфейса
|
||||||
|
- [ ] Индикаторы загрузки
|
||||||
|
- [ ] Понятные сообщения об ошибках
|
||||||
|
|
||||||
|
### ✅ Производительность
|
||||||
|
|
||||||
|
- [ ] Пагинация для больших списков
|
||||||
|
- [ ] Ленивая загрузка изображений
|
||||||
|
- [ ] Кэширование данных
|
||||||
|
|
||||||
|
## ❌ АБСОЛЮТНО ЗАПРЕЩЕНО
|
||||||
|
|
||||||
|
1. Удалять предметы с существующими заказами
|
||||||
|
2. Изменять статусы без уведомлений
|
||||||
|
3. Обходить проверки остатков
|
||||||
|
4. Давать доступ к чужим данным
|
||||||
|
5. Создавать брак/продукт без связи с родительским товаром
|
||||||
|
6. Создавать отдельные типы расходников
|
||||||
|
7. Разрешать заказ брака
|
||||||
|
8. Нарушать последовательность статусов
|
||||||
|
9. Игнорировать валидацию
|
||||||
|
10. Нарушать последовательность модулей в статистике фулфилмента
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🤔 ПРАВИЛО УТОЧНЕНИЙ
|
||||||
|
|
||||||
|
**КРИТИЧЕСКИ ВАЖНО**: Если я не уверен в выполнении задачи или вижу противоречия в правилах - ОБЯЗАТЕЛЬНО уточнить у пользователя!
|
||||||
|
|
||||||
|
### ❓ КОГДА УТОЧНЯТЬ:
|
||||||
|
|
||||||
|
- [ ] Недостаточно информации для правильного выполнения
|
||||||
|
- [ ] Вижу противоречия между правилами
|
||||||
|
- [ ] Задача может нарушить критические правила
|
||||||
|
- [ ] Неясно как применить правило в конкретной ситуации
|
||||||
|
- [ ] Есть сомнения в интерпретации требований
|
||||||
|
|
||||||
|
### 📝 КАК УТОЧНЯТЬ:
|
||||||
|
|
||||||
|
1. Четко сформулировать что именно неясно
|
||||||
|
2. Указать какие правила/требования конфликтуют
|
||||||
|
3. Предложить варианты решения если возможно
|
||||||
|
4. Запросить конкретные уточнения
|
||||||
|
|
||||||
|
**❌ НИКОГДА не делать предположений если есть сомнения!**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**ПРАВИЛО**: Перед каждым изменением кода проверить этот чеклист!
|
||||||
|
**ИСТОЧНИК ИСТИНЫ**: rules2.md
|
||||||
|
**СТАТУС**: ОБЯЗАТЕЛЬНЫЙ К ВЫПОЛНЕНИЮ
|
||||||
482
fulfillment-cabinet-rules.md
Normal file
482
fulfillment-cabinet-rules.md
Normal file
@ -0,0 +1,482 @@
|
|||||||
|
# ПРАВИЛА КАБИНЕТА ФУЛФИЛМЕНТА
|
||||||
|
|
||||||
|
> 📋 **Файл создан на основе анализа системы** - детальные правила для кабинета фулфилмента
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📑 ОГЛАВЛЕНИЕ
|
||||||
|
|
||||||
|
1. [🏭 Общие характеристики кабинета фулфилмента](#1--общие-характеристики-кабинета-фулфилмента)
|
||||||
|
2. [🗂️ Основные разделы кабинета](#2--основные-разделы-кабинета)
|
||||||
|
3. [🔒 Правила доступа фулфилмента](#3--правила-доступа-фулфилмента)
|
||||||
|
4. [📋 Критические правила для rules2.md](#4--критические-правила-для-rules2md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. 🏭 ОБЩИЕ ХАРАКТЕРИСТИКИ КАБИНЕТА ФУЛФИЛМЕНТА
|
||||||
|
|
||||||
|
### 1.1 Принципы доступа
|
||||||
|
|
||||||
|
- **МАКСИМАЛЬНЫЕ ПРАВА**: Фулфилмент имеет доступ ко ВСЕМ разделам системы
|
||||||
|
- **АДАПТИВНАЯ НАВИГАЦИЯ**: Sidebar изменяется в зависимости от `user.organization.type === "FULFILLMENT"`
|
||||||
|
- **ЭКСКЛЮЗИВНЫЕ КОМПОНЕНТЫ**: Услуги, Сотрудники, Статистика фулфилмента доступны ТОЛЬКО фулфилменту
|
||||||
|
- **СПЕЦИАЛЬНЫЙ РОУТИНГ**: При нажатии "Поставки" → `/fulfillment-supplies` (не `/supplies`)
|
||||||
|
|
||||||
|
### 1.2 Архитектурные особенности
|
||||||
|
|
||||||
|
- **GraphQL проверки**: `skip: user?.organization?.type !== 'FULFILLMENT'` в запросах
|
||||||
|
- **Условное отображение**: `{user?.organization?.type === "FULFILLMENT" && (...)}`
|
||||||
|
- **Адаптивные отступы**: `getSidebarMargin()` для responsive design
|
||||||
|
- **Полинг данных**: Статистика обновляется каждую минуту (`pollInterval: 60000`)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 🗂️ ОСНОВНЫЕ РАЗДЕЛЫ КАБИНЕТА
|
||||||
|
|
||||||
|
### 2.1 🏠 Главная страница (`/dashboard`)
|
||||||
|
|
||||||
|
**Компонент**: `DashboardHome`
|
||||||
|
**Содержание**:
|
||||||
|
|
||||||
|
- Основная информация организации
|
||||||
|
- Статус онлайн пользователя
|
||||||
|
- Быстрый доступ к основным разделам
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.2 🏭 Склад фулфилмента (`/fulfillment-warehouse`)
|
||||||
|
|
||||||
|
**Компонент**: `FulfillmentWarehouseDashboard`
|
||||||
|
|
||||||
|
#### 2.2.1 Структура склада по модулям (ОБЯЗАТЕЛЬНАЯ ПОСЛЕДОВАТЕЛЬНОСТЬ)
|
||||||
|
|
||||||
|
1. **📦 ПРОДУКТЫ** - готовые к отправке товары
|
||||||
|
2. **🛒 ТОВАРЫ** - базовые товары от поставщиков
|
||||||
|
- **"На складе"** - готовы к обработке
|
||||||
|
- **"В обработке"** - в процессе создания продукта
|
||||||
|
3. **❌ БРАК** - товары с дефектами, требуют утилизации
|
||||||
|
4. **↩️ ВОЗВРАТЫ С ПВЗ** - возвращенные товары, к обработке
|
||||||
|
5. **🎯 РАСХОДНИКИ СЕЛЛЕРОВ** - материалы для селлеров
|
||||||
|
6. **⚙️ РАСХОДНИКИ ФУЛФИЛМЕНТА** - операционные материалы (КЛИКАБЕЛЬНЫЙ модуль)
|
||||||
|
|
||||||
|
#### 2.2.2 Система учета склада
|
||||||
|
|
||||||
|
**Дополнительные значения** (показатели движения):
|
||||||
|
|
||||||
|
- **ПРИБЫЛО** - количество поступивших на склад за период
|
||||||
|
- **УБЫЛО** - количество списанных со склада за период
|
||||||
|
|
||||||
|
**Основные значения** (текущие остатки):
|
||||||
|
|
||||||
|
- **ФОРМУЛА**: Основные значения = Предыдущие остатки + Прибыло - Убыло
|
||||||
|
- **ОБНОВЛЕНИЕ**: В реальном времени с изменениями за сутки
|
||||||
|
- **ИСТОЧНИК**: GraphQL query `GET_FULFILLMENT_WAREHOUSE_STATS`
|
||||||
|
|
||||||
|
#### 2.2.3 Структура данных склада (3-уровневая иерархия)
|
||||||
|
|
||||||
|
```
|
||||||
|
🔵 УРОВЕНЬ 1: МАГАЗИНЫ
|
||||||
|
├── ТехноМир (синий - blue-400/500)
|
||||||
|
├── Стиль и Комфорт (розовый - pink-400/500)
|
||||||
|
└── Зелёный Дом (изумрудный - emerald-400/500)
|
||||||
|
↓
|
||||||
|
🟢 УРОВЕНЬ 2: ТОВАРЫ (зеленый - green-500)
|
||||||
|
↓
|
||||||
|
🟠 УРОВЕНЬ 3: ВАРИАНТЫ ТОВАРОВ (оранжевый - orange-500)
|
||||||
|
```
|
||||||
|
|
||||||
|
**Цветовое кодирование**:
|
||||||
|
|
||||||
|
- Каждый уровень имеет цветной индикатор увеличивающегося размера
|
||||||
|
- Цветная левая граница с увеличивающимся отступом и толщиной
|
||||||
|
- Скроллбары в цвете уровня
|
||||||
|
- Контрастный цвет текста для читаемости
|
||||||
|
|
||||||
|
#### 2.2.4 Статистика склада
|
||||||
|
|
||||||
|
**6 основных карточек статистики**:
|
||||||
|
|
||||||
|
1. **Продукты** - готовые к отправке
|
||||||
|
2. **Товары** - в обработке
|
||||||
|
3. **Брак** - требует утилизации
|
||||||
|
4. **Возвраты с ПВЗ** - к обработке
|
||||||
|
5. **Расходники селлеров** - материалы клиентов
|
||||||
|
6. **Расходники фулфилмента** - операционные материалы
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.3 📦 Поставки фулфилмента (`/fulfillment-supplies`)
|
||||||
|
|
||||||
|
**Компонент**: `SuppliesDashboard`
|
||||||
|
|
||||||
|
#### 2.3.1 Структура: 2 основные вкладки
|
||||||
|
|
||||||
|
**A) 🛒 ПОСТАВКИ ТОВАРОВ**:
|
||||||
|
|
||||||
|
- **Детализированные товары ФФ** - планы и факты поставок с маршрутами
|
||||||
|
- **Товары ФФ** - общие поставки товаров от селлеров
|
||||||
|
- **Возвраты с ПВЗ** - обработка возвращенных товаров
|
||||||
|
|
||||||
|
**B) 🔧 ПОСТАВКИ РАСХОДНИКОВ**:
|
||||||
|
|
||||||
|
- **Заказы расходников** - управление заказами от селлеров
|
||||||
|
- **Расходники селлеров** - материалы для клиентов
|
||||||
|
- **Создание поставок** - формирование новых поставок расходников
|
||||||
|
|
||||||
|
#### 2.3.2 Workflow поставок товаров
|
||||||
|
|
||||||
|
**Этапы обработки**:
|
||||||
|
|
||||||
|
1. **Planned** - поставка запланирована
|
||||||
|
2. **In-transit** - товар в пути
|
||||||
|
3. **Delivered** - доставлен на склад
|
||||||
|
4. **Completed** - обработка завершена
|
||||||
|
|
||||||
|
**Данные поставки**:
|
||||||
|
|
||||||
|
- Номер поставки (ФФ-YYYY-XXX)
|
||||||
|
- Селлер (организация, магазин, менеджер)
|
||||||
|
- Количество позиций и грузовых мест
|
||||||
|
- Объем и стоимость поставки
|
||||||
|
- Ответственный сотрудник и логистика
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.4 📊 Статистика фулфилмента (`/fulfillment-statistics`)
|
||||||
|
|
||||||
|
**Компонент**: `FulfillmentStatisticsDashboard`
|
||||||
|
|
||||||
|
#### 2.4.1 Блоки аналитики (сворачиваемые)
|
||||||
|
|
||||||
|
**1. НАКОПЛЕННАЯ СТАТИСТИКА** (`allTime: true`):
|
||||||
|
|
||||||
|
- Обработано товаров (общий объем)
|
||||||
|
- Выявлено брака (всего единиц)
|
||||||
|
- Поставок получено
|
||||||
|
- Общий доход (за все время)
|
||||||
|
- Выполнено заказов (успешных отгрузок)
|
||||||
|
- Удовлетворенность клиентов (средний рейтинг)
|
||||||
|
|
||||||
|
**2. ОТГРУЗКА НА ПЛОЩАДКИ** (`marketplaces: true`):
|
||||||
|
|
||||||
|
- Отправлено на Wildberries
|
||||||
|
- Отправлено на Ozon
|
||||||
|
- Отправлено на другие площадки
|
||||||
|
|
||||||
|
**3. АНАЛИТИКА ПРОИЗВОДИТЕЛЬНОСТИ** (`performance: false`):
|
||||||
|
|
||||||
|
- Среднее время обработки (на единицу товара)
|
||||||
|
- Уровень брака (от общего объема)
|
||||||
|
- Уровень возвратов (возвраты с площадок)
|
||||||
|
- Удовлетворенность клиентов
|
||||||
|
|
||||||
|
**4. МЕТРИКИ СКЛАДА** (`warehouseMetrics: true`):
|
||||||
|
|
||||||
|
- Эффективность склада
|
||||||
|
- Оборачиваемость товаров
|
||||||
|
- Коэффициент использования
|
||||||
|
|
||||||
|
**5. УМНЫЕ РЕКОМЕНДАЦИИ** (`smartRecommendations: true`):
|
||||||
|
|
||||||
|
- Автоматические советы по оптимизации
|
||||||
|
- Предложения по улучшению процессов
|
||||||
|
|
||||||
|
**6. БЫСТРЫЕ ДЕЙСТВИЯ** (`quickActions: true`):
|
||||||
|
|
||||||
|
- Часто используемые операции
|
||||||
|
- Горячие клавиши для действий
|
||||||
|
|
||||||
|
#### 2.4.2 Ключевые показатели в заголовке
|
||||||
|
|
||||||
|
- **Общий доход** (зеленый - success)
|
||||||
|
- **Качество** (синий - X/5.0 рейтинг)
|
||||||
|
- **Уровень брака** (процент от общего объема)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.5 🔧 Услуги (`/services`)
|
||||||
|
|
||||||
|
**Компонент**: `ServicesDashboard`
|
||||||
|
**Условие доступа**: `user?.organization?.type === "FULFILLMENT"`
|
||||||
|
|
||||||
|
#### 2.5.1 Структура: 3 обязательные вкладки
|
||||||
|
|
||||||
|
**A) 🛠️ УСЛУГИ** (`defaultValue="services"`):
|
||||||
|
|
||||||
|
- **CRUD операции**: создание, редактирование, удаление услуг
|
||||||
|
- **Управление ценами** и описаниями
|
||||||
|
- **Загрузка изображений** услуг (`imageUrl`)
|
||||||
|
- **GraphQL**: `GET_MY_SERVICES`, `CREATE_SERVICE`, `UPDATE_SERVICE`, `DELETE_SERVICE`
|
||||||
|
|
||||||
|
**B) 🚚 ЛОГИСТИКА**:
|
||||||
|
|
||||||
|
- **Создание маршрутов доставки** (откуда → куда)
|
||||||
|
- **Тарификация**: цена до 1м³ и свыше 1м³
|
||||||
|
- **Группированные локации**:
|
||||||
|
- Мой фулфилмент (название организации)
|
||||||
|
- Рынки (предустановленные)
|
||||||
|
- Склады Wildberries
|
||||||
|
- Склады Ozon
|
||||||
|
- **GraphQL**: `GET_MY_LOGISTICS`, `CREATE_LOGISTICS`, `UPDATE_LOGISTICS`, `DELETE_LOGISTICS`
|
||||||
|
|
||||||
|
**C) 📦 РАСХОДНИКИ**:
|
||||||
|
|
||||||
|
- **Управление расходниками фулфилмента**
|
||||||
|
- **Интеграция с модулем "Услуги"** - селлеры могут использовать в услугах
|
||||||
|
- **Списание со складских остатков** при использовании
|
||||||
|
- **Стоимость включается** в стоимость услуги
|
||||||
|
|
||||||
|
#### 2.5.2 Правила логистики
|
||||||
|
|
||||||
|
**Создание маршрута**:
|
||||||
|
|
||||||
|
- **Обязательные поля**: Название маршрута, Откуда, Куда
|
||||||
|
- **Ценообразование**: Цена до 1м³, Цена свыше 1м³
|
||||||
|
- **Описание услуг**: Дополнительные условия доставки
|
||||||
|
- **Проверка**: Только организации типа FULFILLMENT могут создавать логистику
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.6 👥 Сотрудники (`/employees`)
|
||||||
|
|
||||||
|
**Компонент**: `EmployeesDashboard`
|
||||||
|
**Условие доступа**: `user?.organization?.type === "FULFILLMENT"`
|
||||||
|
|
||||||
|
#### 2.6.1 Структура: 2 основные вкладки
|
||||||
|
|
||||||
|
**A) 👥 СОТРУДНИКИ** (`defaultValue="combined"`):
|
||||||
|
|
||||||
|
**Управление персоналом**:
|
||||||
|
|
||||||
|
- **CRUD операции**: создание, редактирование, удаление сотрудников
|
||||||
|
- **Статусы сотрудников**: `ACTIVE`, `VACATION`, `SICK`, `FIRED`
|
||||||
|
- **Формы добавления**: Компактная (`showCompactForm`) / Полная форма
|
||||||
|
- **Поиск и фильтрация** по имени, должности, статусу
|
||||||
|
|
||||||
|
**Табель рабочего времени**:
|
||||||
|
|
||||||
|
- **Навигация по месяцам**: текущий год/месяц с кнопками ←/→
|
||||||
|
- **Отметки по дням**: статус дня и количество отработанных часов
|
||||||
|
- **GraphQL**: `GET_EMPLOYEE_SCHEDULE`, `UPDATE_EMPLOYEE_SCHEDULE`
|
||||||
|
- **Данные**: `{date, hoursWorked, employee: {id}}`
|
||||||
|
|
||||||
|
**B) 📋 ОТЧЕТЫ** (`value="reports"`):
|
||||||
|
|
||||||
|
- **Сводные отчеты** по сотрудникам за период
|
||||||
|
- **Экспорт данных** табеля
|
||||||
|
- **Аналитика рабочего времени**
|
||||||
|
|
||||||
|
#### 2.6.2 Интерфейс сотрудников
|
||||||
|
|
||||||
|
**Обязательные поля сотрудника**:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
interface Employee {
|
||||||
|
firstName: string; // Имя
|
||||||
|
lastName: string; // Фамилия
|
||||||
|
middleName?: string; // Отчество
|
||||||
|
position: string; // Должность
|
||||||
|
phone: string; // Телефон
|
||||||
|
email?: string; // Email
|
||||||
|
status: "ACTIVE" | "VACATION" | "SICK" | "FIRED";
|
||||||
|
salary?: number; // Зарплата
|
||||||
|
hireDate: string; // Дата найма
|
||||||
|
// ... дополнительные поля
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Валидация данных**:
|
||||||
|
|
||||||
|
- Имя/Фамилия: минимум 2 символа, только буквы/пробелы/дефисы
|
||||||
|
- Телефон: обязательный, формат +7 (999) 123-45-67
|
||||||
|
- Email: валидация формата при заполнении
|
||||||
|
- Должность: минимум 2 символа
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.7 🌐 Универсальные разделы
|
||||||
|
|
||||||
|
#### 2.7.1 🛒 Маркет (`/market`)
|
||||||
|
|
||||||
|
- Просмотр товаров всех поставщиков
|
||||||
|
- Создание заказов у поставщиков
|
||||||
|
- Управление корзиной и избранным
|
||||||
|
|
||||||
|
#### 2.7.2 🤝 Партнеры (`/partners`)
|
||||||
|
|
||||||
|
- Управление контрагентами всех типов
|
||||||
|
- Входящие/исходящие заявки на сотрудничество
|
||||||
|
|
||||||
|
#### 2.7.3 💬 Мессенджер (`/messenger`)
|
||||||
|
|
||||||
|
- Внутренняя связь между организациями
|
||||||
|
- Поддержка файлов, изображений, голосовых сообщений
|
||||||
|
|
||||||
|
#### 2.7.4 ⚙️ Настройки (`/settings`)
|
||||||
|
|
||||||
|
- Профиль организации и пользователя
|
||||||
|
- API ключи маркетплейсов (WB, Ozon)
|
||||||
|
- Банковские реквизиты
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. 🔒 ПРАВИЛА ДОСТУПА ФУЛФИЛМЕНТА
|
||||||
|
|
||||||
|
### 3.1 Эксклюзивный доступ (только фулфилмент)
|
||||||
|
|
||||||
|
**TypeScript проверки**:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
{user?.organization?.type === "FULFILLMENT" && (
|
||||||
|
// Компоненты доступны только фулфилменту
|
||||||
|
)}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Эксклюзивные разделы**:
|
||||||
|
|
||||||
|
- **Услуги** (`/services`) - создание услуг, логистики, управление расходниками
|
||||||
|
- **Сотрудники** (`/employees`) - управление персоналом и табелем
|
||||||
|
- **Статистика фулфилмента** (`/fulfillment-statistics`) - детальная аналитика
|
||||||
|
|
||||||
|
### 3.2 Специальная логика роутинга
|
||||||
|
|
||||||
|
**При нажатии "Поставки" в sidebar**:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const handleSuppliesClick = () => {
|
||||||
|
switch (user?.organization?.type) {
|
||||||
|
case "FULFILLMENT":
|
||||||
|
router.push("/fulfillment-supplies"); // Специальный роут
|
||||||
|
break;
|
||||||
|
case "SELLER":
|
||||||
|
router.push("/supplies");
|
||||||
|
break;
|
||||||
|
// ... другие типы
|
||||||
|
}
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.3 GraphQL проверки доступа
|
||||||
|
|
||||||
|
**В Apollo Client запросах**:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
const { data } = useQuery(GET_MY_SERVICES, {
|
||||||
|
skip: user?.organization?.type !== "FULFILLMENT", // Пропуск для не-фулфилмента
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
**В GraphQL резолверах**:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Проверка типа организации на сервере
|
||||||
|
if (currentUser.organization.type !== "FULFILLMENT") {
|
||||||
|
throw new GraphQLError("Доступно только для фулфилмент центров");
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 📋 КРИТИЧЕСКИЕ ПРАВИЛА ДЛЯ RULES2.MD
|
||||||
|
|
||||||
|
### 4.1 🔴 КРИТИЧЕСКИЕ ПРАВИЛА (обязательны к добавлению)
|
||||||
|
|
||||||
|
#### **ПРАВИЛО FF-01: Структура склада фулфилмента**
|
||||||
|
|
||||||
|
- **ОБЯЗАТЕЛЬНАЯ ПОСЛЕДОВАТЕЛЬНОСТЬ** модулей: ПРОДУКТ→ТОВАР→БРАК→ВОЗВРАТЫ→РАСХОДНИКИ*СЕЛЛЕРОВ→РАСХОДНИКИ*ФУЛФИЛМЕНТА
|
||||||
|
- **ЗАПРЕЩЕНО**: Изменение порядка модулей
|
||||||
|
- **ОБЯЗАТЕЛЬНО**: Модуль "Расходники фулфилмента" должен быть кликабельным
|
||||||
|
|
||||||
|
#### **ПРАВИЛО FF-02: Права доступа фулфилмента**
|
||||||
|
|
||||||
|
- **ЭКСКЛЮЗИВНЫЙ ДОСТУП**: Услуги, Сотрудники, Статистика фулфилмента
|
||||||
|
- **ПРОВЕРКА**: `user?.organization?.type === "FULFILLMENT"`
|
||||||
|
- **GraphQL**: `skip: user?.organization?.type !== 'FULFILLMENT'`
|
||||||
|
|
||||||
|
#### **ПРАВИЛО FF-03: Система учета склада**
|
||||||
|
|
||||||
|
- **ДВОЙНОЙ УЧЕТ**: Основные значения + дополнительные значения
|
||||||
|
- **ФОРМУЛА**: Основные = Предыдущие остатки + Прибыло - Убыло
|
||||||
|
- **ОБНОВЛЕНИЕ**: Статистика в реальном времени с изменениями за сутки
|
||||||
|
|
||||||
|
#### **ПРАВИЛО FF-04: Workflow создания продукта**
|
||||||
|
|
||||||
|
- **ПРОЦЕСС**: Товары "на складе" → "в обработке" → ПРОДУКТ "готов к отправке"
|
||||||
|
- **ПЛАН/ФАКТ**: Корректировка статистики при выявлении расхождений
|
||||||
|
- **ОБЯЗАТЕЛЬНО**: Фиксация брака в процессе работы (вкладка "В работе")
|
||||||
|
|
||||||
|
### 4.2 🟡 ВАЖНЫЕ ПРАВИЛА (рекомендуются к добавлению)
|
||||||
|
|
||||||
|
#### **ПРАВИЛО FF-05: Модуль услуг фулфилмента**
|
||||||
|
|
||||||
|
- **СТРУКТУРА**: 3 обязательные вкладки (Услуги, Логистика, Расходники)
|
||||||
|
- **ЛОГИСТИКА**: Создание маршрутов только фулфилментом
|
||||||
|
- **РАСХОДНИКИ**: Интеграция с модулем "Услуги", списание со склада
|
||||||
|
|
||||||
|
#### **ПРАВИЛО FF-06: Управление сотрудниками**
|
||||||
|
|
||||||
|
- **СТАТУСЫ**: 4 обязательных статуса (ACTIVE, VACATION, SICK, FIRED)
|
||||||
|
- **ТАБЕЛЬ**: Месячная навигация с отметками по дням
|
||||||
|
- **ВАЛИДАЦИЯ**: Строгие правила валидации полей сотрудника
|
||||||
|
|
||||||
|
#### **ПРАВИЛО FF-07: Специальный роутинг**
|
||||||
|
|
||||||
|
- **ПОСТАВКИ**: Фулфилмент → `/fulfillment-supplies` (не `/supplies`)
|
||||||
|
- **УСЛОВНОЕ ОТОБРАЖЕНИЕ**: Разные компоненты для разных типов организаций
|
||||||
|
|
||||||
|
### 4.3 🟢 ПОЛЕЗНЫЕ ПРАВИЛА (опциональны)
|
||||||
|
|
||||||
|
#### **ПРАВИЛО FF-08: UI/UX паттерны фулфилмента**
|
||||||
|
|
||||||
|
- **ЦВЕТОВАЯ СХЕМА**: 3-уровневая иерархия с цветовым кодированием
|
||||||
|
- **СВОРАЧИВАЕМЫЕ БЛОКИ**: Статистика с состояниями `expandedSections`
|
||||||
|
- **АДАПТИВНОСТЬ**: `getSidebarMargin()` для responsive design
|
||||||
|
|
||||||
|
#### **ПРАВИЛО FF-09: Статистика и аналитика**
|
||||||
|
|
||||||
|
- **6 ОСНОВНЫХ БЛОКОВ**: Накопленная, Площадки, Производительность, Склад, Рекомендации, Действия
|
||||||
|
- **REAL-TIME**: Обновление каждую минуту (`pollInterval: 60000`)
|
||||||
|
- **КЛЮЧЕВЫЕ ПОКАЗАТЕЛИ**: Доход, Качество, Уровень брака в заголовке
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📎 ПРИЛОЖЕНИЯ
|
||||||
|
|
||||||
|
### Приложение A: GraphQL запросы фулфилмента
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Основные запросы
|
||||||
|
GET_MY_SERVICES; // Услуги фулфилмента
|
||||||
|
GET_MY_LOGISTICS; // Логистические маршруты
|
||||||
|
GET_MY_EMPLOYEES; // Сотрудники организации
|
||||||
|
GET_FULFILLMENT_WAREHOUSE_STATS; // Статистика склада
|
||||||
|
GET_WAREHOUSE_PRODUCTS; // Товары на складе
|
||||||
|
GET_MY_FULFILLMENT_SUPPLIES; // Расходники фулфилмента
|
||||||
|
|
||||||
|
// Мутации
|
||||||
|
CREATE_SERVICE, UPDATE_SERVICE, DELETE_SERVICE;
|
||||||
|
CREATE_LOGISTICS, UPDATE_LOGISTICS, DELETE_LOGISTICS;
|
||||||
|
CREATE_EMPLOYEE, UPDATE_EMPLOYEE, DELETE_EMPLOYEE;
|
||||||
|
```
|
||||||
|
|
||||||
|
### Приложение B: Компоненты фулфилмента
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Основные dashboard компоненты
|
||||||
|
FulfillmentWarehouseDashboard; // Склад фулфилмента
|
||||||
|
FulfillmentStatisticsDashboard; // Статистика
|
||||||
|
ServicesDashboard; // Услуги (3 вкладки)
|
||||||
|
EmployeesDashboard; // Сотрудники
|
||||||
|
SuppliesDashboard; // Поставки фулфилмента
|
||||||
|
|
||||||
|
// Специализированные компоненты
|
||||||
|
ServicesTab, LogisticsTab, SuppliesTab; // Вкладки услуг
|
||||||
|
EmployeeInlineForm, EmployeeEditInlineForm; // Формы сотрудников
|
||||||
|
FulfillmentSuppliesTab, FulfillmentConsumablesOrdersTab; // Поставки
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**📅 Создано**: На основе анализа системы Sfera
|
||||||
|
**🎯 Статус**: Готово к интеграции в rules2.md
|
||||||
|
**📝 Версия**: 1.0
|
||||||
1070
rules2.md
Normal file
1070
rules2.md
Normal file
@ -0,0 +1,1070 @@
|
|||||||
|
# ПРАВИЛА СИСТЕМЫ УПРАВЛЕНИЯ СКЛАДАМИ И ПОСТАВКАМИ - БАЗА ЗНАНИЙ 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
|
||||||
146
self-validation.md
Normal file
146
self-validation.md
Normal file
@ -0,0 +1,146 @@
|
|||||||
|
# УСОВЕРШЕНСТВОВАННАЯ СИСТЕМА САМОПРОВЕРКИ AI
|
||||||
|
|
||||||
|
## 🎯 ЦЕЛЬ
|
||||||
|
|
||||||
|
Обеспечить 100% соблюдение правил проекта Sfera с использованием новых протоколов работы.
|
||||||
|
|
||||||
|
## 🚨 КРИТИЧЕСКОЕ ДОПОЛНЕНИЕ
|
||||||
|
|
||||||
|
Интегрирована система жестких стоп-сигналов из `violation-prevention-protocol.md` для предотвращения всех типов нарушений протоколов.
|
||||||
|
|
||||||
|
## 🛑 ОБЯЗАТЕЛЬНЫЙ ПРОТОКОЛ ПЕРЕД КАЖДОЙ ЗАДАЧЕЙ
|
||||||
|
|
||||||
|
### ШАГ 1: ОПРЕДЕЛЕНИЕ СЛОЖНОСТИ И ПРОТОКОЛА
|
||||||
|
|
||||||
|
```
|
||||||
|
ВОПРОСЫ:
|
||||||
|
- Сколько файлов затрагивает задача? (1-3 = средняя, 4+ = высокая)
|
||||||
|
- Изменяется ли архитектура или workflow? (да = высокая)
|
||||||
|
- Влияет ли на критические бизнес-процессы? (да = высокая)
|
||||||
|
|
||||||
|
ДЕЙСТВИЕ: Применить соответствующий протокол из work-protocols.md
|
||||||
|
```
|
||||||
|
|
||||||
|
### ШАГ 2: ЭТАП "СТОП И ПОДУМАЙ"
|
||||||
|
|
||||||
|
```
|
||||||
|
ОБЯЗАТЕЛЬНЫЕ ВОПРОСЫ:
|
||||||
|
- Какие правила из rules2.md применимы?
|
||||||
|
- Какие файлы нужно изучить? (перечислить ВСЕ)
|
||||||
|
- Есть ли неопределенности, требующие уточнения?
|
||||||
|
- Что может пойти не так?
|
||||||
|
|
||||||
|
ДЕЙСТВИЕ: Составить план с промежуточными проверками
|
||||||
|
```
|
||||||
|
|
||||||
|
### ШАГ 3: ПРОВЕРКА КРИТИЧЕСКИХ ПРАВИЛ
|
||||||
|
|
||||||
|
```
|
||||||
|
✅ ТИПИЗАЦИЯ:
|
||||||
|
- ТОВАР ≠ ПРОДУКТ (разные сущности)
|
||||||
|
- 4 типа предметов: ТОВАР, БРАК, РАСХОДНИКИ, ПРОДУКТ
|
||||||
|
- Производные связаны с parentId
|
||||||
|
|
||||||
|
✅ WORKFLOW:
|
||||||
|
- Последовательность статусов соблюдена
|
||||||
|
- Уведомления на каждом этапе
|
||||||
|
- Логирование изменений
|
||||||
|
|
||||||
|
✅ ДОСТУП:
|
||||||
|
- Запрет заказа собственных товаров поставщиком
|
||||||
|
- Запрет заказа брака
|
||||||
|
- Проверка остатков
|
||||||
|
|
||||||
|
✅ ВАЛИДАЦИЯ:
|
||||||
|
- Цена > 0 (исключение: брак для фулфилмента)
|
||||||
|
- Количество ≤ остатков
|
||||||
|
- Обязательные поля заполнены
|
||||||
|
```
|
||||||
|
|
||||||
|
### ШАГ 4: ТЕХНИЧЕСКИЕ ПРОВЕРКИ
|
||||||
|
|
||||||
|
```
|
||||||
|
✅ ПРОИЗВОДИТЕЛЬНОСТЬ: < 3 сек загрузка
|
||||||
|
✅ БЕЗОПАСНОСТЬ: шифрование, аудит
|
||||||
|
✅ UX: индикаторы, уведомления
|
||||||
|
✅ КАЧЕСТВО: тесты 80%+, SOLID принципы
|
||||||
|
```
|
||||||
|
|
||||||
|
### ШАГ 5: УТОЧНЯЮЩИЕ ВОПРОСЫ
|
||||||
|
|
||||||
|
```
|
||||||
|
КОГДА ОБЯЗАТЕЛЬНО СПРОСИТЬ:
|
||||||
|
🔴 Противоречие в правилах
|
||||||
|
🔴 Архитектурные изменения
|
||||||
|
🔴 Критические бизнес-процессы
|
||||||
|
🔴 Несколько вариантов решения
|
||||||
|
|
||||||
|
ФОРМАТ:
|
||||||
|
🎯 КОНТЕКСТ: что делаю
|
||||||
|
❓ ВОПРОС: что неясно
|
||||||
|
⚖️ ВАРИАНТЫ: альтернативы
|
||||||
|
⚠️ РИСКИ: что может пойти не так
|
||||||
|
💡 ПРЕДЛОЖЕНИЕ: рекомендуемый подход
|
||||||
|
```
|
||||||
|
|
||||||
|
### ШАГ 6: АВТОСИНХРОНИЗАЦИЯ
|
||||||
|
|
||||||
|
```
|
||||||
|
ПРОВЕРИТЬ:
|
||||||
|
- Нужно ли обновить development-checklist.md?
|
||||||
|
- Добавлены ли новые критические правила?
|
||||||
|
- Изменились ли workflow или запреты?
|
||||||
|
|
||||||
|
ДЕЙСТВИЕ:
|
||||||
|
- Синхронизировать файлы по алгоритму auto-sync-system.md
|
||||||
|
- Уведомить пользователя о синхронизации
|
||||||
|
```
|
||||||
|
|
||||||
|
### ШАГ 7: ФИНАЛЬНАЯ ВАЛИДАЦИЯ
|
||||||
|
|
||||||
|
```
|
||||||
|
МЕГА-ВОПРОС К СЕБЕ:
|
||||||
|
"Применил ли я правильный протокол, проверил ли все правила,
|
||||||
|
задал ли нужные вопросы, синхронизировал ли файлы,
|
||||||
|
готов ли результат к production?"
|
||||||
|
|
||||||
|
ЕСЛИ ОТВЕТ НЕ "ДА 100%" - ВЕРНУТЬСЯ К НАЧАЛУ!
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🚨 КРИТИЧЕСКИЕ СТОП-СИГНАЛЫ
|
||||||
|
|
||||||
|
```
|
||||||
|
🛑 ОСТАНОВИТЬСЯ НЕМЕДЛЕННО ЕСЛИ:
|
||||||
|
- Не определил сложность задачи
|
||||||
|
- Пропустил этап "Стоп и подумай"
|
||||||
|
- Есть сомнения в правилах
|
||||||
|
- Не проверил все применимые разделы rules2.md
|
||||||
|
- Не синхронизировал связанные файлы
|
||||||
|
- Не уведомил о важных изменениях
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📊 МЕТРИКИ УСПЕХА
|
||||||
|
|
||||||
|
```
|
||||||
|
ЦЕЛЬ: 0 пропущенных критических деталей
|
||||||
|
|
||||||
|
ИЗМЕРЕНИЕ:
|
||||||
|
✅ Количество вопросов на уточнение
|
||||||
|
✅ Полнота анализа источников
|
||||||
|
✅ Своевременность синхронизации файлов
|
||||||
|
✅ Отсутствие нарушений правил
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🔄 НЕПРЕРЫВНОЕ УЛУЧШЕНИЕ
|
||||||
|
|
||||||
|
```
|
||||||
|
ПОСЛЕ КАЖДОЙ ЗАДАЧИ АНАЛИЗИРОВАТЬ:
|
||||||
|
- Что можно было сделать лучше?
|
||||||
|
- Какие протоколы сработали?
|
||||||
|
- Где были пробелы в анализе?
|
||||||
|
- Как повысить эффективность?
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**СТАТУС**: Новая система самопроверки активирована! Применяется с каждой задачей проекта Sfera.
|
||||||
10
src/app/economics/page.tsx
Normal file
10
src/app/economics/page.tsx
Normal file
@ -0,0 +1,10 @@
|
|||||||
|
import { AuthGuard } from "@/components/auth-guard";
|
||||||
|
import { EconomicsPageWrapper } from "@/components/economics/economics-page-wrapper";
|
||||||
|
|
||||||
|
export default function EconomicsPage() {
|
||||||
|
return (
|
||||||
|
<AuthGuard>
|
||||||
|
<EconomicsPageWrapper />
|
||||||
|
</AuthGuard>
|
||||||
|
);
|
||||||
|
}
|
||||||
10
src/app/home/page.tsx
Normal file
10
src/app/home/page.tsx
Normal file
@ -0,0 +1,10 @@
|
|||||||
|
import { AuthGuard } from "@/components/auth-guard";
|
||||||
|
import { HomePageWrapper } from "@/components/home/home-page-wrapper";
|
||||||
|
|
||||||
|
export default function HomePage() {
|
||||||
|
return (
|
||||||
|
<AuthGuard>
|
||||||
|
<HomePageWrapper />
|
||||||
|
</AuthGuard>
|
||||||
|
);
|
||||||
|
}
|
||||||
@ -25,6 +25,8 @@ import {
|
|||||||
ChevronLeft,
|
ChevronLeft,
|
||||||
ChevronRight,
|
ChevronRight,
|
||||||
BarChart3,
|
BarChart3,
|
||||||
|
Home,
|
||||||
|
DollarSign,
|
||||||
} from "lucide-react";
|
} from "lucide-react";
|
||||||
|
|
||||||
// Компонент для отображения уведомлений о непринятых поставках
|
// Компонент для отображения уведомлений о непринятых поставках
|
||||||
@ -173,6 +175,16 @@ export function Sidebar() {
|
|||||||
router.push("/partners");
|
router.push("/partners");
|
||||||
};
|
};
|
||||||
|
|
||||||
|
const handleHomeClick = () => {
|
||||||
|
router.push("/home");
|
||||||
|
};
|
||||||
|
|
||||||
|
const handleEconomicsClick = () => {
|
||||||
|
router.push("/economics");
|
||||||
|
};
|
||||||
|
|
||||||
|
const isHomeActive = pathname === "/home";
|
||||||
|
const isEconomicsActive = pathname === "/economics";
|
||||||
const isSettingsActive = pathname === "/settings";
|
const isSettingsActive = pathname === "/settings";
|
||||||
const isMarketActive = pathname.startsWith("/market");
|
const isMarketActive = pathname.startsWith("/market");
|
||||||
const isMessengerActive = pathname.startsWith("/messenger");
|
const isMessengerActive = pathname.startsWith("/messenger");
|
||||||
@ -304,6 +316,27 @@ export function Sidebar() {
|
|||||||
|
|
||||||
{/* Навигация */}
|
{/* Навигация */}
|
||||||
<div className="space-y-1 mb-3 flex-1">
|
<div className="space-y-1 mb-3 flex-1">
|
||||||
|
{/* Кнопка Главная - первая для всех типов кабинетов */}
|
||||||
|
<Button
|
||||||
|
variant={isHomeActive ? "secondary" : "ghost"}
|
||||||
|
className={`w-full ${
|
||||||
|
isCollapsed ? "justify-center px-2 h-9" : "justify-start h-10"
|
||||||
|
} text-left transition-all duration-200 text-xs ${
|
||||||
|
isHomeActive
|
||||||
|
? "bg-white/20 text-white hover:bg-white/30"
|
||||||
|
: "text-white/80 hover:bg-white/10 hover:text-white"
|
||||||
|
} cursor-pointer`}
|
||||||
|
onClick={handleHomeClick}
|
||||||
|
title={isCollapsed ? "Главная" : ""}
|
||||||
|
>
|
||||||
|
<Home
|
||||||
|
className={`${
|
||||||
|
isCollapsed ? "h-4 w-4" : "h-4 w-4"
|
||||||
|
} flex-shrink-0`}
|
||||||
|
/>
|
||||||
|
{!isCollapsed && <span className="ml-3">Главная</span>}
|
||||||
|
</Button>
|
||||||
|
|
||||||
<Button
|
<Button
|
||||||
variant={isMarketActive ? "secondary" : "ghost"}
|
variant={isMarketActive ? "secondary" : "ghost"}
|
||||||
className={`w-full ${
|
className={`w-full ${
|
||||||
@ -607,6 +640,27 @@ export function Sidebar() {
|
|||||||
</Button>
|
</Button>
|
||||||
)}
|
)}
|
||||||
|
|
||||||
|
{/* Кнопка Экономика - для всех типов кабинетов, перед настройками */}
|
||||||
|
<Button
|
||||||
|
variant={isEconomicsActive ? "secondary" : "ghost"}
|
||||||
|
className={`w-full ${
|
||||||
|
isCollapsed ? "justify-center px-2 h-9" : "justify-start h-10"
|
||||||
|
} text-left transition-all duration-200 text-xs ${
|
||||||
|
isEconomicsActive
|
||||||
|
? "bg-white/20 text-white hover:bg-white/30"
|
||||||
|
: "text-white/80 hover:bg-white/10 hover:text-white"
|
||||||
|
} cursor-pointer`}
|
||||||
|
onClick={handleEconomicsClick}
|
||||||
|
title={isCollapsed ? "Экономика" : ""}
|
||||||
|
>
|
||||||
|
<DollarSign
|
||||||
|
className={`${
|
||||||
|
isCollapsed ? "h-4 w-4" : "h-4 w-4"
|
||||||
|
} flex-shrink-0`}
|
||||||
|
/>
|
||||||
|
{!isCollapsed && <span className="ml-3">Экономика</span>}
|
||||||
|
</Button>
|
||||||
|
|
||||||
<Button
|
<Button
|
||||||
variant={isSettingsActive ? "secondary" : "ghost"}
|
variant={isSettingsActive ? "secondary" : "ghost"}
|
||||||
className={`w-full ${
|
className={`w-full ${
|
||||||
|
|||||||
40
src/components/economics/economics-page-wrapper.tsx
Normal file
40
src/components/economics/economics-page-wrapper.tsx
Normal file
@ -0,0 +1,40 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useAuth } from "@/hooks/useAuth";
|
||||||
|
import { SellerEconomicsPage } from "./seller-economics-page";
|
||||||
|
import { FulfillmentEconomicsPage } from "./fulfillment-economics-page";
|
||||||
|
import { WholesaleEconomicsPage } from "./wholesale-economics-page";
|
||||||
|
import { LogistEconomicsPage } from "./logist-economics-page";
|
||||||
|
|
||||||
|
export function EconomicsPageWrapper() {
|
||||||
|
const { user } = useAuth();
|
||||||
|
|
||||||
|
// Проверка доступа - только авторизованные пользователи с организацией
|
||||||
|
if (!user?.organization?.type) {
|
||||||
|
return (
|
||||||
|
<div className="min-h-screen bg-gradient-smooth flex items-center justify-center">
|
||||||
|
<div className="text-white">Ошибка: тип организации не определен</div>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Роутинг по типу организации
|
||||||
|
switch (user.organization.type) {
|
||||||
|
case "SELLER":
|
||||||
|
return <SellerEconomicsPage />;
|
||||||
|
case "FULFILLMENT":
|
||||||
|
return <FulfillmentEconomicsPage />;
|
||||||
|
case "WHOLESALE":
|
||||||
|
return <WholesaleEconomicsPage />;
|
||||||
|
case "LOGIST":
|
||||||
|
return <LogistEconomicsPage />;
|
||||||
|
default:
|
||||||
|
return (
|
||||||
|
<div className="min-h-screen bg-gradient-smooth flex items-center justify-center">
|
||||||
|
<div className="text-white">
|
||||||
|
Неподдерживаемый тип кабинета: {user.organization.type}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
59
src/components/economics/fulfillment-economics-page.tsx
Normal file
59
src/components/economics/fulfillment-economics-page.tsx
Normal file
@ -0,0 +1,59 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useAuth } from "@/hooks/useAuth";
|
||||||
|
import { Sidebar } from "@/components/dashboard/sidebar";
|
||||||
|
import { useSidebar } from "@/hooks/useSidebar";
|
||||||
|
import { Card } from "@/components/ui/card";
|
||||||
|
import { TrendingUp } from "lucide-react";
|
||||||
|
|
||||||
|
export function FulfillmentEconomicsPage() {
|
||||||
|
const { user } = useAuth();
|
||||||
|
const { getSidebarMargin } = useSidebar();
|
||||||
|
|
||||||
|
const getOrganizationName = () => {
|
||||||
|
if (user?.organization?.name) {
|
||||||
|
return user.organization.name;
|
||||||
|
}
|
||||||
|
if (user?.organization?.fullName) {
|
||||||
|
return user.organization.fullName;
|
||||||
|
}
|
||||||
|
return "Вашей организации";
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="h-screen flex overflow-hidden">
|
||||||
|
<Sidebar />
|
||||||
|
<main
|
||||||
|
className={`flex-1 ${getSidebarMargin()} px-6 py-4 overflow-hidden transition-all duration-300`}
|
||||||
|
>
|
||||||
|
<div className="p-8">
|
||||||
|
{/* Заголовок страницы */}
|
||||||
|
<div className="mb-8">
|
||||||
|
<h1 className="text-3xl font-bold text-white mb-2">
|
||||||
|
Экономика фулфилмента
|
||||||
|
</h1>
|
||||||
|
<p className="text-white/60">
|
||||||
|
Финансовые показатели {getOrganizationName()}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Карточка-заглушка */}
|
||||||
|
<Card className="bg-white/10 backdrop-blur border-white/20 p-6">
|
||||||
|
<div className="flex items-center space-x-3 mb-4">
|
||||||
|
<TrendingUp className="h-8 w-8 text-purple-400" />
|
||||||
|
<h3 className="text-xl font-semibold text-white">
|
||||||
|
Экономические показатели
|
||||||
|
</h3>
|
||||||
|
</div>
|
||||||
|
<div className="space-y-2">
|
||||||
|
<p className="text-white font-medium">
|
||||||
|
Раздел находится в разработке
|
||||||
|
</p>
|
||||||
|
<p className="text-white/60 text-sm">Будет добавлен позже</p>
|
||||||
|
</div>
|
||||||
|
</Card>
|
||||||
|
</div>
|
||||||
|
</main>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
59
src/components/economics/logist-economics-page.tsx
Normal file
59
src/components/economics/logist-economics-page.tsx
Normal file
@ -0,0 +1,59 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useAuth } from "@/hooks/useAuth";
|
||||||
|
import { Sidebar } from "@/components/dashboard/sidebar";
|
||||||
|
import { useSidebar } from "@/hooks/useSidebar";
|
||||||
|
import { Card } from "@/components/ui/card";
|
||||||
|
import { Calculator } from "lucide-react";
|
||||||
|
|
||||||
|
export function LogistEconomicsPage() {
|
||||||
|
const { user } = useAuth();
|
||||||
|
const { getSidebarMargin } = useSidebar();
|
||||||
|
|
||||||
|
const getOrganizationName = () => {
|
||||||
|
if (user?.organization?.name) {
|
||||||
|
return user.organization.name;
|
||||||
|
}
|
||||||
|
if (user?.organization?.fullName) {
|
||||||
|
return user.organization.fullName;
|
||||||
|
}
|
||||||
|
return "Вашей организации";
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="h-screen flex overflow-hidden">
|
||||||
|
<Sidebar />
|
||||||
|
<main
|
||||||
|
className={`flex-1 ${getSidebarMargin()} px-6 py-4 overflow-hidden transition-all duration-300`}
|
||||||
|
>
|
||||||
|
<div className="p-8">
|
||||||
|
{/* Заголовок страницы */}
|
||||||
|
<div className="mb-8">
|
||||||
|
<h1 className="text-3xl font-bold text-white mb-2">
|
||||||
|
Экономика логистики
|
||||||
|
</h1>
|
||||||
|
<p className="text-white/60">
|
||||||
|
Финансовые показатели {getOrganizationName()}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Карточка-заглушка */}
|
||||||
|
<Card className="bg-white/10 backdrop-blur border-white/20 p-6">
|
||||||
|
<div className="flex items-center space-x-3 mb-4">
|
||||||
|
<Calculator className="h-8 w-8 text-orange-400" />
|
||||||
|
<h3 className="text-xl font-semibold text-white">
|
||||||
|
Экономические показатели
|
||||||
|
</h3>
|
||||||
|
</div>
|
||||||
|
<div className="space-y-2">
|
||||||
|
<p className="text-white font-medium">
|
||||||
|
Раздел находится в разработке
|
||||||
|
</p>
|
||||||
|
<p className="text-white/60 text-sm">Будет добавлен позже</p>
|
||||||
|
</div>
|
||||||
|
</Card>
|
||||||
|
</div>
|
||||||
|
</main>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
59
src/components/economics/seller-economics-page.tsx
Normal file
59
src/components/economics/seller-economics-page.tsx
Normal file
@ -0,0 +1,59 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useAuth } from "@/hooks/useAuth";
|
||||||
|
import { Sidebar } from "@/components/dashboard/sidebar";
|
||||||
|
import { useSidebar } from "@/hooks/useSidebar";
|
||||||
|
import { Card } from "@/components/ui/card";
|
||||||
|
import { DollarSign } from "lucide-react";
|
||||||
|
|
||||||
|
export function SellerEconomicsPage() {
|
||||||
|
const { user } = useAuth();
|
||||||
|
const { getSidebarMargin } = useSidebar();
|
||||||
|
|
||||||
|
const getOrganizationName = () => {
|
||||||
|
if (user?.organization?.name) {
|
||||||
|
return user.organization.name;
|
||||||
|
}
|
||||||
|
if (user?.organization?.fullName) {
|
||||||
|
return user.organization.fullName;
|
||||||
|
}
|
||||||
|
return "Вашей организации";
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="h-screen flex overflow-hidden">
|
||||||
|
<Sidebar />
|
||||||
|
<main
|
||||||
|
className={`flex-1 ${getSidebarMargin()} px-6 py-4 overflow-hidden transition-all duration-300`}
|
||||||
|
>
|
||||||
|
<div className="p-8">
|
||||||
|
{/* Заголовок страницы */}
|
||||||
|
<div className="mb-8">
|
||||||
|
<h1 className="text-3xl font-bold text-white mb-2">
|
||||||
|
Экономика селлера
|
||||||
|
</h1>
|
||||||
|
<p className="text-white/60">
|
||||||
|
Финансовые показатели {getOrganizationName()}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Карточка-заглушка */}
|
||||||
|
<Card className="bg-white/10 backdrop-blur border-white/20 p-6">
|
||||||
|
<div className="flex items-center space-x-3 mb-4">
|
||||||
|
<DollarSign className="h-8 w-8 text-green-400" />
|
||||||
|
<h3 className="text-xl font-semibold text-white">
|
||||||
|
Экономические показатели
|
||||||
|
</h3>
|
||||||
|
</div>
|
||||||
|
<div className="space-y-2">
|
||||||
|
<p className="text-white font-medium">
|
||||||
|
Раздел находится в разработке
|
||||||
|
</p>
|
||||||
|
<p className="text-white/60 text-sm">Будет добавлен позже</p>
|
||||||
|
</div>
|
||||||
|
</Card>
|
||||||
|
</div>
|
||||||
|
</main>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
59
src/components/economics/wholesale-economics-page.tsx
Normal file
59
src/components/economics/wholesale-economics-page.tsx
Normal file
@ -0,0 +1,59 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useAuth } from "@/hooks/useAuth";
|
||||||
|
import { Sidebar } from "@/components/dashboard/sidebar";
|
||||||
|
import { useSidebar } from "@/hooks/useSidebar";
|
||||||
|
import { Card } from "@/components/ui/card";
|
||||||
|
import { BarChart3 } from "lucide-react";
|
||||||
|
|
||||||
|
export function WholesaleEconomicsPage() {
|
||||||
|
const { user } = useAuth();
|
||||||
|
const { getSidebarMargin } = useSidebar();
|
||||||
|
|
||||||
|
const getOrganizationName = () => {
|
||||||
|
if (user?.organization?.name) {
|
||||||
|
return user.organization.name;
|
||||||
|
}
|
||||||
|
if (user?.organization?.fullName) {
|
||||||
|
return user.organization.fullName;
|
||||||
|
}
|
||||||
|
return "Вашей организации";
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="h-screen flex overflow-hidden">
|
||||||
|
<Sidebar />
|
||||||
|
<main
|
||||||
|
className={`flex-1 ${getSidebarMargin()} px-6 py-4 overflow-hidden transition-all duration-300`}
|
||||||
|
>
|
||||||
|
<div className="p-8">
|
||||||
|
{/* Заголовок страницы */}
|
||||||
|
<div className="mb-8">
|
||||||
|
<h1 className="text-3xl font-bold text-white mb-2">
|
||||||
|
Экономика поставщика
|
||||||
|
</h1>
|
||||||
|
<p className="text-white/60">
|
||||||
|
Финансовые показатели {getOrganizationName()}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Карточка-заглушка */}
|
||||||
|
<Card className="bg-white/10 backdrop-blur border-white/20 p-6">
|
||||||
|
<div className="flex items-center space-x-3 mb-4">
|
||||||
|
<BarChart3 className="h-8 w-8 text-blue-400" />
|
||||||
|
<h3 className="text-xl font-semibold text-white">
|
||||||
|
Экономические показатели
|
||||||
|
</h3>
|
||||||
|
</div>
|
||||||
|
<div className="space-y-2">
|
||||||
|
<p className="text-white font-medium">
|
||||||
|
Раздел находится в разработке
|
||||||
|
</p>
|
||||||
|
<p className="text-white/60 text-sm">Будет добавлен позже</p>
|
||||||
|
</div>
|
||||||
|
</Card>
|
||||||
|
</div>
|
||||||
|
</main>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
62
src/components/home/fulfillment-home-page.tsx
Normal file
62
src/components/home/fulfillment-home-page.tsx
Normal file
@ -0,0 +1,62 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useAuth } from "@/hooks/useAuth";
|
||||||
|
import { Sidebar } from "@/components/dashboard/sidebar";
|
||||||
|
import { useSidebar } from "@/hooks/useSidebar";
|
||||||
|
import { Card } from "@/components/ui/card";
|
||||||
|
import { Factory } from "lucide-react";
|
||||||
|
|
||||||
|
export function FulfillmentHomePage() {
|
||||||
|
const { user } = useAuth();
|
||||||
|
const { getSidebarMargin } = useSidebar();
|
||||||
|
|
||||||
|
const getOrganizationName = () => {
|
||||||
|
if (user?.organization?.name) {
|
||||||
|
return user.organization.name;
|
||||||
|
}
|
||||||
|
if (user?.organization?.fullName) {
|
||||||
|
return user.organization.fullName;
|
||||||
|
}
|
||||||
|
return "Вашей организации";
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="h-screen flex overflow-hidden">
|
||||||
|
<Sidebar />
|
||||||
|
<main
|
||||||
|
className={`flex-1 ${getSidebarMargin()} px-6 py-4 overflow-hidden transition-all duration-300`}
|
||||||
|
>
|
||||||
|
<div className="p-8">
|
||||||
|
{/* Заголовок страницы */}
|
||||||
|
<div className="mb-8">
|
||||||
|
<h1 className="text-3xl font-bold text-white mb-2">
|
||||||
|
Главная страница фулфилмента
|
||||||
|
</h1>
|
||||||
|
<p className="text-white/60">
|
||||||
|
Добро пожаловать в кабинет фулфилмент-центра{" "}
|
||||||
|
{getOrganizationName()}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Карточка-заглушка */}
|
||||||
|
<Card className="bg-white/10 backdrop-blur border-white/20 p-6">
|
||||||
|
<div className="flex items-center space-x-3 mb-4">
|
||||||
|
<Factory className="h-8 w-8 text-purple-400" />
|
||||||
|
<h3 className="text-xl font-semibold text-white">
|
||||||
|
Кабинет фулфилмента
|
||||||
|
</h3>
|
||||||
|
</div>
|
||||||
|
<div className="space-y-2">
|
||||||
|
<p className="text-white font-medium">
|
||||||
|
Страница находится в разработке
|
||||||
|
</p>
|
||||||
|
<p className="text-white/60 text-sm">
|
||||||
|
Содержание будет добавлено позже
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</Card>
|
||||||
|
</div>
|
||||||
|
</main>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
40
src/components/home/home-page-wrapper.tsx
Normal file
40
src/components/home/home-page-wrapper.tsx
Normal file
@ -0,0 +1,40 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useAuth } from "@/hooks/useAuth";
|
||||||
|
import { SellerHomePage } from "./seller-home-page";
|
||||||
|
import { FulfillmentHomePage } from "./fulfillment-home-page";
|
||||||
|
import { WholesaleHomePage } from "./wholesale-home-page";
|
||||||
|
import { LogistHomePage } from "./logist-home-page";
|
||||||
|
|
||||||
|
export function HomePageWrapper() {
|
||||||
|
const { user } = useAuth();
|
||||||
|
|
||||||
|
// Проверка доступа - только авторизованные пользователи с организацией
|
||||||
|
if (!user?.organization?.type) {
|
||||||
|
return (
|
||||||
|
<div className="min-h-screen bg-gradient-smooth flex items-center justify-center">
|
||||||
|
<div className="text-white">Ошибка: тип организации не определен</div>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Роутинг по типу организации
|
||||||
|
switch (user.organization.type) {
|
||||||
|
case "SELLER":
|
||||||
|
return <SellerHomePage />;
|
||||||
|
case "FULFILLMENT":
|
||||||
|
return <FulfillmentHomePage />;
|
||||||
|
case "WHOLESALE":
|
||||||
|
return <WholesaleHomePage />;
|
||||||
|
case "LOGIST":
|
||||||
|
return <LogistHomePage />;
|
||||||
|
default:
|
||||||
|
return (
|
||||||
|
<div className="min-h-screen bg-gradient-smooth flex items-center justify-center">
|
||||||
|
<div className="text-white">
|
||||||
|
Неподдерживаемый тип кабинета: {user.organization.type}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
62
src/components/home/logist-home-page.tsx
Normal file
62
src/components/home/logist-home-page.tsx
Normal file
@ -0,0 +1,62 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useAuth } from "@/hooks/useAuth";
|
||||||
|
import { Sidebar } from "@/components/dashboard/sidebar";
|
||||||
|
import { useSidebar } from "@/hooks/useSidebar";
|
||||||
|
import { Card } from "@/components/ui/card";
|
||||||
|
import { Truck } from "lucide-react";
|
||||||
|
|
||||||
|
export function LogistHomePage() {
|
||||||
|
const { user } = useAuth();
|
||||||
|
const { getSidebarMargin } = useSidebar();
|
||||||
|
|
||||||
|
const getOrganizationName = () => {
|
||||||
|
if (user?.organization?.name) {
|
||||||
|
return user.organization.name;
|
||||||
|
}
|
||||||
|
if (user?.organization?.fullName) {
|
||||||
|
return user.organization.fullName;
|
||||||
|
}
|
||||||
|
return "Вашей организации";
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="h-screen flex overflow-hidden">
|
||||||
|
<Sidebar />
|
||||||
|
<main
|
||||||
|
className={`flex-1 ${getSidebarMargin()} px-6 py-4 overflow-hidden transition-all duration-300`}
|
||||||
|
>
|
||||||
|
<div className="p-8">
|
||||||
|
{/* Заголовок страницы */}
|
||||||
|
<div className="mb-8">
|
||||||
|
<h1 className="text-3xl font-bold text-white mb-2">
|
||||||
|
Главная страница логистики
|
||||||
|
</h1>
|
||||||
|
<p className="text-white/60">
|
||||||
|
Добро пожаловать в кабинет логистической компании{" "}
|
||||||
|
{getOrganizationName()}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Карточка-заглушка */}
|
||||||
|
<Card className="bg-white/10 backdrop-blur border-white/20 p-6">
|
||||||
|
<div className="flex items-center space-x-3 mb-4">
|
||||||
|
<Truck className="h-8 w-8 text-orange-400" />
|
||||||
|
<h3 className="text-xl font-semibold text-white">
|
||||||
|
Кабинет логистики
|
||||||
|
</h3>
|
||||||
|
</div>
|
||||||
|
<div className="space-y-2">
|
||||||
|
<p className="text-white font-medium">
|
||||||
|
Страница находится в разработке
|
||||||
|
</p>
|
||||||
|
<p className="text-white/60 text-sm">
|
||||||
|
Содержание будет добавлено позже
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</Card>
|
||||||
|
</div>
|
||||||
|
</main>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
61
src/components/home/seller-home-page.tsx
Normal file
61
src/components/home/seller-home-page.tsx
Normal file
@ -0,0 +1,61 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useAuth } from "@/hooks/useAuth";
|
||||||
|
import { Sidebar } from "@/components/dashboard/sidebar";
|
||||||
|
import { useSidebar } from "@/hooks/useSidebar";
|
||||||
|
import { Card } from "@/components/ui/card";
|
||||||
|
import { Building2 } from "lucide-react";
|
||||||
|
|
||||||
|
export function SellerHomePage() {
|
||||||
|
const { user } = useAuth();
|
||||||
|
const { getSidebarMargin } = useSidebar();
|
||||||
|
|
||||||
|
const getOrganizationName = () => {
|
||||||
|
if (user?.organization?.name) {
|
||||||
|
return user.organization.name;
|
||||||
|
}
|
||||||
|
if (user?.organization?.fullName) {
|
||||||
|
return user.organization.fullName;
|
||||||
|
}
|
||||||
|
return "Вашей организации";
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="h-screen flex overflow-hidden">
|
||||||
|
<Sidebar />
|
||||||
|
<main
|
||||||
|
className={`flex-1 ${getSidebarMargin()} px-6 py-4 overflow-hidden transition-all duration-300`}
|
||||||
|
>
|
||||||
|
<div className="p-8">
|
||||||
|
{/* Заголовок страницы */}
|
||||||
|
<div className="mb-8">
|
||||||
|
<h1 className="text-3xl font-bold text-white mb-2">
|
||||||
|
Главная страница селлера
|
||||||
|
</h1>
|
||||||
|
<p className="text-white/60">
|
||||||
|
Добро пожаловать в кабинет селлера {getOrganizationName()}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Карточка-заглушка */}
|
||||||
|
<Card className="bg-white/10 backdrop-blur border-white/20 p-6">
|
||||||
|
<div className="flex items-center space-x-3 mb-4">
|
||||||
|
<Building2 className="h-8 w-8 text-blue-400" />
|
||||||
|
<h3 className="text-xl font-semibold text-white">
|
||||||
|
Кабинет селлера
|
||||||
|
</h3>
|
||||||
|
</div>
|
||||||
|
<div className="space-y-2">
|
||||||
|
<p className="text-white font-medium">
|
||||||
|
Страница находится в разработке
|
||||||
|
</p>
|
||||||
|
<p className="text-white/60 text-sm">
|
||||||
|
Содержание будет добавлено позже
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</Card>
|
||||||
|
</div>
|
||||||
|
</main>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
61
src/components/home/wholesale-home-page.tsx
Normal file
61
src/components/home/wholesale-home-page.tsx
Normal file
@ -0,0 +1,61 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useAuth } from "@/hooks/useAuth";
|
||||||
|
import { Sidebar } from "@/components/dashboard/sidebar";
|
||||||
|
import { useSidebar } from "@/hooks/useSidebar";
|
||||||
|
import { Card } from "@/components/ui/card";
|
||||||
|
import { Package } from "lucide-react";
|
||||||
|
|
||||||
|
export function WholesaleHomePage() {
|
||||||
|
const { user } = useAuth();
|
||||||
|
const { getSidebarMargin } = useSidebar();
|
||||||
|
|
||||||
|
const getOrganizationName = () => {
|
||||||
|
if (user?.organization?.name) {
|
||||||
|
return user.organization.name;
|
||||||
|
}
|
||||||
|
if (user?.organization?.fullName) {
|
||||||
|
return user.organization.fullName;
|
||||||
|
}
|
||||||
|
return "Вашей организации";
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="h-screen flex overflow-hidden">
|
||||||
|
<Sidebar />
|
||||||
|
<main
|
||||||
|
className={`flex-1 ${getSidebarMargin()} px-6 py-4 overflow-hidden transition-all duration-300`}
|
||||||
|
>
|
||||||
|
<div className="p-8">
|
||||||
|
{/* Заголовок страницы */}
|
||||||
|
<div className="mb-8">
|
||||||
|
<h1 className="text-3xl font-bold text-white mb-2">
|
||||||
|
Главная страница поставщика
|
||||||
|
</h1>
|
||||||
|
<p className="text-white/60">
|
||||||
|
Добро пожаловать в кабинет поставщика {getOrganizationName()}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Карточка-заглушка */}
|
||||||
|
<Card className="bg-white/10 backdrop-blur border-white/20 p-6">
|
||||||
|
<div className="flex items-center space-x-3 mb-4">
|
||||||
|
<Package className="h-8 w-8 text-green-400" />
|
||||||
|
<h3 className="text-xl font-semibold text-white">
|
||||||
|
Кабинет поставщика
|
||||||
|
</h3>
|
||||||
|
</div>
|
||||||
|
<div className="space-y-2">
|
||||||
|
<p className="text-white font-medium">
|
||||||
|
Страница находится в разработке
|
||||||
|
</p>
|
||||||
|
<p className="text-white/60 text-sm">
|
||||||
|
Содержание будет добавлено позже
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</Card>
|
||||||
|
</div>
|
||||||
|
</main>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
186
token-optimization.md
Normal file
186
token-optimization.md
Normal file
@ -0,0 +1,186 @@
|
|||||||
|
# ОПТИМИЗАЦИЯ РАСХОДА ТОКЕНОВ
|
||||||
|
|
||||||
|
## 🎯 ПРИНЦИПЫ ЭКОНОМИИ
|
||||||
|
|
||||||
|
### 1. **УМНАЯ ЗАГРУЗКА КОНТЕКСТА**
|
||||||
|
|
||||||
|
#### ✅ **ОПТИМАЛЬНАЯ СТРАТЕГИЯ:**
|
||||||
|
|
||||||
|
```
|
||||||
|
ВМЕСТО: Читать весь rules2.md (975 строк)
|
||||||
|
ДЕЛАТЬ: Читать только нужные разделы по запросу
|
||||||
|
|
||||||
|
ВМЕСТО: Загружать все файлы проекта
|
||||||
|
ДЕЛАТЬ: Загружать только затронутые файлы
|
||||||
|
|
||||||
|
ВМЕСТО: Дублировать информацию в памяти
|
||||||
|
ДЕЛАТЬ: Ссылаться на уже загруженные данные
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 📋 **ПРАВИЛА ЗАГРУЗКИ:**
|
||||||
|
|
||||||
|
- **Для простых задач**: Читать только 1-2 конкретных раздела rules2.md
|
||||||
|
- **Для средних задач**: Загружать связанные разделы параллельно
|
||||||
|
- **Для сложных задач**: Поэтапная загрузка по мере необходимости
|
||||||
|
|
||||||
|
### 2. **ЭФФЕКТИВНОЕ ИСПОЛЬЗОВАНИЕ ПАМЯТИ**
|
||||||
|
|
||||||
|
#### 🧠 **СТРАТЕГИЯ ПАМЯТИ:**
|
||||||
|
|
||||||
|
```
|
||||||
|
КРИТИЧЕСКИЕ ПРАВИЛА → В память (один раз)
|
||||||
|
ЧАСТО ИСПОЛЬЗУЕМЫЕ → В память (экономия на перечитывании)
|
||||||
|
СПЕЦИФИЧЕСКИЕ → Читать по запросу
|
||||||
|
ТЕХНИЧЕСКИЕ ДЕТАЛИ → Ссылки вместо полного текста
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 💾 **КЛЮЧЕВЫЕ ПАМЯТИ:**
|
||||||
|
|
||||||
|
- [[memory:4966770]] - Протоколы работы (уже сохранено)
|
||||||
|
- [[memory:4966638]] - Автосинхронизация (уже сохранено)
|
||||||
|
- [[memory:4970102]] - Правила проекта (уже сохранено)
|
||||||
|
|
||||||
|
### 3. **ОПТИМИЗАЦИЯ ПРОТОКОЛОВ**
|
||||||
|
|
||||||
|
#### ⚡ **УПРОЩЕННЫЕ ПРОТОКОЛЫ ДЛЯ ЭКОНОМИИ:**
|
||||||
|
|
||||||
|
**ЛЕГКИЕ ЗАДАЧИ** (1 файл, простые изменения):
|
||||||
|
|
||||||
|
```
|
||||||
|
1. Проверить память (0 токенов)
|
||||||
|
2. Прочитать 1 раздел rules2.md (50-100 токенов)
|
||||||
|
3. Выполнить без дополнительных проверок
|
||||||
|
4. Краткая валидация
|
||||||
|
```
|
||||||
|
|
||||||
|
**СРЕДНИЕ ЗАДАЧИ** (2-3 файла):
|
||||||
|
|
||||||
|
```
|
||||||
|
1. Проверить память (0 токенов)
|
||||||
|
2. Читать разделы по мере необходимости (по 50-100 токенов)
|
||||||
|
3. Применить сокращенный протокол
|
||||||
|
4. Синхронизировать только при изменении правил
|
||||||
|
```
|
||||||
|
|
||||||
|
**СЛОЖНЫЕ ЗАДАЧИ** (4+ файлов, архитектура):
|
||||||
|
|
||||||
|
```
|
||||||
|
1. Полный протокол (оправданный расход)
|
||||||
|
2. Поэтапная загрузка файлов
|
||||||
|
3. Промежуточные проверки вместо полной валидации
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. **УМНЫЕ ПРОВЕРКИ**
|
||||||
|
|
||||||
|
#### 🎯 **СЕЛЕКТИВНАЯ ВАЛИДАЦИЯ:**
|
||||||
|
|
||||||
|
```
|
||||||
|
ВСЕГДА ПРОВЕРЯТЬ:
|
||||||
|
- Типизация предметов (ТОВАР ≠ ПРОДУКТ)
|
||||||
|
- Критические запреты
|
||||||
|
- Workflow статусы
|
||||||
|
|
||||||
|
ПРОВЕРЯТЬ ПРИ НЕОБХОДИМОСТИ:
|
||||||
|
- Технические требования (только для tech-задач)
|
||||||
|
- Интеграции (только при работе с API)
|
||||||
|
- Производительность (только для оптимизации)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. **ОПТИМИЗАЦИЯ СИНХРОНИЗАЦИИ**
|
||||||
|
|
||||||
|
#### 🔄 **УМНАЯ СИНХРОНИЗАЦИЯ:**
|
||||||
|
|
||||||
|
```
|
||||||
|
НЕ СИНХРОНИЗИРОВАТЬ ЕСЛИ:
|
||||||
|
- Изменения не затрагивают rules2.md
|
||||||
|
- Добавлены только комментарии/документация
|
||||||
|
- Исправлены опечатки без изменения логики
|
||||||
|
|
||||||
|
СИНХРОНИЗИРОВАТЬ ТОЛЬКО ЕСЛИ:
|
||||||
|
- Добавлены новые критические правила
|
||||||
|
- Изменены запреты или workflow
|
||||||
|
- Модифицированы правила валидации
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📈 ЭКОНОМИЧЕСКИЕ ПРОТОКОЛЫ
|
||||||
|
|
||||||
|
### 🟢 **ПРОТОКОЛ ДЛЯ ПРОСТЫХ ЗАДАЧ** (ЭКОНОМНЫЙ)
|
||||||
|
|
||||||
|
```
|
||||||
|
ОПРЕДЕЛЕНИЕ: 1 файл, простые правки, без изменения логики
|
||||||
|
|
||||||
|
ПРОЦЕСС:
|
||||||
|
1. ✅ Проверить память (критические правила)
|
||||||
|
2. ✅ Прочитать ТОЛЬКО нужный раздел rules2.md
|
||||||
|
3. ✅ Выполнить изменение
|
||||||
|
4. ✅ Краткая проверка (3-4 ключевых пункта)
|
||||||
|
5. ✅ Уведомить о результате
|
||||||
|
|
||||||
|
ЭКОНОМИЯ: ~70% токенов от полного протокола
|
||||||
|
```
|
||||||
|
|
||||||
|
### 🟡 **ПРОТОКОЛ ДЛЯ СРЕДНИХ ЗАДАЧ** (СБАЛАНСИРОВАННЫЙ)
|
||||||
|
|
||||||
|
```
|
||||||
|
ОПРЕДЕЛЕНИЕ: 2-3 файла, изменение логики, без архитектуры
|
||||||
|
|
||||||
|
ПРОЦЕСС:
|
||||||
|
1. ✅ Определить сложность по памяти
|
||||||
|
2. ✅ Читать разделы поэтапно по мере необходимости
|
||||||
|
3. ✅ Применить основные проверки (не все)
|
||||||
|
4. ✅ Синхронизировать только при добавлении правил
|
||||||
|
5. ✅ Финальная валидация (сокращенная)
|
||||||
|
|
||||||
|
ЭКОНОМИЯ: ~40% токенов от полного протокола
|
||||||
|
```
|
||||||
|
|
||||||
|
### 🔴 **ПРОТОКОЛ ДЛЯ СЛОЖНЫХ ЗАДАЧ** (ПОЛНЫЙ)
|
||||||
|
|
||||||
|
```
|
||||||
|
ОПРЕДЕЛЕНИЕ: 4+ файлов, архитектура, критические процессы
|
||||||
|
|
||||||
|
ПРОЦЕСС:
|
||||||
|
1. ✅ Полный протокол (расход оправдан важностью)
|
||||||
|
2. ✅ Поэтапная загрузка вместо массового чтения
|
||||||
|
3. ✅ Все проверки и валидации
|
||||||
|
4. ✅ Полная синхронизация и документирование
|
||||||
|
|
||||||
|
ЭКОНОМИЯ: Оптимизация через поэтапность, не сокращение проверок
|
||||||
|
```
|
||||||
|
|
||||||
|
## 💡 ПРАКТИЧЕСКИЕ РЕКОМЕНДАЦИИ
|
||||||
|
|
||||||
|
### ДЛЯ ПОЛЬЗОВАТЕЛЯ:
|
||||||
|
|
||||||
|
1. **🎯 Указывайте сложность задачи** в запросе:
|
||||||
|
|
||||||
|
- "Простая правка в одном файле"
|
||||||
|
- "Средняя задача, 2-3 файла"
|
||||||
|
- "Сложная архитектурная задача"
|
||||||
|
|
||||||
|
2. **📋 Группируйте связанные задачи** для экономии контекста
|
||||||
|
|
||||||
|
3. **⚡ Используйте краткие формулировки** для простых задач
|
||||||
|
|
||||||
|
### ДЛЯ МЕНЯ:
|
||||||
|
|
||||||
|
1. **🧠 Максимально использовать память** вместо перечитывания
|
||||||
|
2. **📊 Читать файлы по частям** вместо целиком
|
||||||
|
3. **⚖️ Балансировать качество и экономию** в зависимости от сложности
|
||||||
|
4. **🔄 Синхронизировать селективно** только при реальной необходимости
|
||||||
|
|
||||||
|
## 📊 ОЖИДАЕМАЯ ЭКОНОМИЯ
|
||||||
|
|
||||||
|
```
|
||||||
|
ПРОСТЫЕ ЗАДАЧИ: -70% токенов (с применением экономного протокола)
|
||||||
|
СРЕДНИЕ ЗАДАЧИ: -40% токенов (сбалансированный подход)
|
||||||
|
СЛОЖНЫЕ ЗАДАЧИ: +20% токенов НО -80% ошибок (долгосрочная экономия)
|
||||||
|
|
||||||
|
ОБЩИЙ ЭФФЕКТ: Экономия 30-50% за счет предотвращения переделок
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🎯 АКТИВАЦИЯ ОПТИМИЗАЦИИ
|
||||||
|
|
||||||
|
Данные стратегии экономии активированы и будут применяться автоматически в зависимости от сложности задачи.
|
||||||
|
|
||||||
|
**ПРИНЦИП**: Качество не в ущерб экономии, экономия не в ущерб качеству.
|
||||||
169
violation-prevention-protocol.md
Normal file
169
violation-prevention-protocol.md
Normal file
@ -0,0 +1,169 @@
|
|||||||
|
# ПРОТОКОЛ ПРЕДОТВРАЩЕНИЯ НАРУШЕНИЙ AI
|
||||||
|
|
||||||
|
## 🚨 СИСТЕМА ЖЕСТКИХ СТОП-СИГНАЛОВ
|
||||||
|
|
||||||
|
### 🛑 ОБЯЗАТЕЛЬНЫЕ ОСТАНОВКИ ПЕРЕД ДЕЙСТВИЯМИ
|
||||||
|
|
||||||
|
#### **СТОП-СИГНАЛ #1: ПЕРЕД ЛЮБЫМ АНАЛИЗОМ КОМПОНЕНТОВ**
|
||||||
|
|
||||||
|
```
|
||||||
|
❌ ЗАПРЕЩЕНО: Делать предположения о содержании файлов/компонентов
|
||||||
|
✅ ОБЯЗАТЕЛЬНО:
|
||||||
|
1. codebase_search для понимания
|
||||||
|
2. read_file для точного содержания
|
||||||
|
3. Только ПОСЛЕ изучения кода - выводы
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **СТОП-СИГНАЛ #2: ПЕРЕД ИЗМЕНЕНИЕМ RULES2.MD**
|
||||||
|
|
||||||
|
```
|
||||||
|
❌ ЗАПРЕЩЕНО: Завершать работу без синхронизации
|
||||||
|
✅ ОБЯЗАТЕЛЬНО:
|
||||||
|
1. Внести изменения в rules2.md
|
||||||
|
2. НЕМЕДЛЕННО обновить development-checklist.md
|
||||||
|
3. Проверить соответствие изменений
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **СТОП-СИГНАЛ #3: ПРИ НЕОПРЕДЕЛЕННОСТИ**
|
||||||
|
|
||||||
|
```
|
||||||
|
❌ ЗАПРЕЩЕНО: Гадать, предполагать, домысливать
|
||||||
|
✅ ОБЯЗАТЕЛЬНО:
|
||||||
|
1. СТОП - зафиксировать неопределенность
|
||||||
|
2. Использовать инструменты анализа (если применимо)
|
||||||
|
3. Задать прямой вопрос пользователю
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **СТОП-СИГНАЛ #4: ПЕРЕД ВЫПОЛНЕНИЕМ СРЕДНИХ/СЛОЖНЫХ ЗАДАЧ**
|
||||||
|
|
||||||
|
```
|
||||||
|
❌ ЗАПРЕЩЕНО: Сразу приступать к работе
|
||||||
|
✅ ОБЯЗАТЕЛЬНО:
|
||||||
|
1. Применить соответствующий протокол из work-protocols.md
|
||||||
|
2. Создать план через todo_write
|
||||||
|
3. Пройти этап самопроверки
|
||||||
|
```
|
||||||
|
|
||||||
|
### 🔒 СИСТЕМА ПРИНУДИТЕЛЬНЫХ ПРОВЕРОК
|
||||||
|
|
||||||
|
#### **ПРОВЕРКА #1: АНАЛИЗ КОДА**
|
||||||
|
|
||||||
|
```
|
||||||
|
Если задача включает анализ компонентов:
|
||||||
|
□ Использовал ли я codebase_search?
|
||||||
|
□ Прочитал ли я исходный код?
|
||||||
|
□ Основаны ли мои выводы на фактах, а не предположениях?
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **ПРОВЕРКА #2: СИНХРОНИЗАЦИЯ ДОКУМЕНТАЦИИ**
|
||||||
|
|
||||||
|
```
|
||||||
|
Если изменил rules2.md:
|
||||||
|
□ Обновил ли development-checklist.md?
|
||||||
|
□ Добавил ли новые критические правила в чеклист?
|
||||||
|
□ Уведомил ли пользователя о синхронизации?
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **ПРОВЕРКА #3: СОБЛЮДЕНИЕ ПРОТОКОЛОВ**
|
||||||
|
|
||||||
|
```
|
||||||
|
Для каждой задачи:
|
||||||
|
□ Определил ли сложность задачи?
|
||||||
|
□ Применил ли соответствующий протокол?
|
||||||
|
□ Создал ли план действий?
|
||||||
|
□ Провел ли финальную самопроверку?
|
||||||
|
```
|
||||||
|
|
||||||
|
### ⚡ СИСТЕМА АВТОМАТИЧЕСКИХ ТРИГГЕРОВ
|
||||||
|
|
||||||
|
#### **ТРИГГЕР #1: При упоминании компонентов**
|
||||||
|
|
||||||
|
- Ключевые слова: "компонент", "файл", "содержание", "показывает"
|
||||||
|
- Действие: ОБЯЗАТЕЛЬНО использовать инструменты анализа кода
|
||||||
|
|
||||||
|
#### **ТРИГГЕР #2: При изменении rules2.md**
|
||||||
|
|
||||||
|
- Событие: Любое изменение в rules2.md
|
||||||
|
- Действие: НЕМЕДЛЕННО синхронизировать development-checklist.md
|
||||||
|
|
||||||
|
#### **ТРИГГЕР #3: При неопределенности**
|
||||||
|
|
||||||
|
- Ключевые фразы: "возможно", "вероятно", "думаю", "предполагаю"
|
||||||
|
- Действие: СТОП + вопрос пользователю
|
||||||
|
|
||||||
|
### 🎯 СИСТЕМА ОБЯЗАТЕЛЬНЫХ ВОПРОСОВ
|
||||||
|
|
||||||
|
#### **ПЕРЕД НАЧАЛОМ ЛЮБОЙ ЗАДАЧИ:**
|
||||||
|
|
||||||
|
1. Какова сложность этой задачи? (простая/средняя/сложная)
|
||||||
|
2. Какой протокол применить?
|
||||||
|
3. Есть ли неопределенности, требующие уточнения?
|
||||||
|
4. Какие инструменты анализа необходимы?
|
||||||
|
|
||||||
|
#### **ПОСЛЕ КАЖДОГО ЗНАЧИМОГО ДЕЙСТВИЯ:**
|
||||||
|
|
||||||
|
1. Соответствует ли результат правилам в rules2.md?
|
||||||
|
2. Нужно ли синхронизировать documentation?
|
||||||
|
3. Что еще я мог упустить?
|
||||||
|
4. Готов ли результат для пользователя?
|
||||||
|
|
||||||
|
### 🛡️ СИСТЕМА БЛОКИРОВКИ НАРУШЕНИЙ
|
||||||
|
|
||||||
|
#### **БЛОКИРОВКА ТИПА #1: Предположения**
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
if (содержит_предположение && !использовал_анализ_кода) {
|
||||||
|
ОСТАНОВИТЬ_ВЫПОЛНЕНИЕ();
|
||||||
|
ТРЕБОВАТЬ_АНАЛИЗ_КОДА();
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **БЛОКИРОВКА ТИПА #2: Незавершенная синхронизация**
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
if (изменил_rules2md && !обновил_checklist) {
|
||||||
|
ОСТАНОВИТЬ_ОТВЕТ();
|
||||||
|
ТРЕБОВАТЬ_СИНХРОНИЗАЦИЮ();
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **БЛОКИРОВКА ТИПА #3: Пропуск протоколов**
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
if (сложность_задачи >= СРЕДНЯЯ && !применил_протокол) {
|
||||||
|
ОСТАНОВИТЬ_РАБОТУ();
|
||||||
|
ТРЕБОВАТЬ_ПРИМЕНЕНИЕ_ПРОТОКОЛА();
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 ИТОГОВЫЙ ЧЕКЛИСТ ПРЕДОТВРАЩЕНИЯ НАРУШЕНИЙ
|
||||||
|
|
||||||
|
### ✅ ПЕРЕД КАЖДЫМ ОТВЕТОМ:
|
||||||
|
|
||||||
|
- [ ] Определена сложность задачи
|
||||||
|
- [ ] Выбран соответствующий протокол
|
||||||
|
- [ ] Проверены стоп-сигналы
|
||||||
|
- [ ] Использованы инструменты анализа (если нужно)
|
||||||
|
- [ ] Заданы уточняющие вопросы (если есть неопределенности)
|
||||||
|
|
||||||
|
### ✅ ПОСЛЕ КАЖДОГО ИЗМЕНЕНИЯ:
|
||||||
|
|
||||||
|
- [ ] Проверено соответствие rules2.md
|
||||||
|
- [ ] Синхронизирован development-checklist.md (если изменялся rules2.md)
|
||||||
|
- [ ] Проведена финальная самопроверка
|
||||||
|
- [ ] Обновлена память (если нужно)
|
||||||
|
|
||||||
|
### ✅ В СЛУЧАЕ СОМНЕНИЙ:
|
||||||
|
|
||||||
|
- [ ] СТОП - зафиксирована неопределенность
|
||||||
|
- [ ] Использованы все доступные инструменты анализа
|
||||||
|
- [ ] Задан прямой вопрос пользователю
|
||||||
|
- [ ] НЕ ДЕЛАТЬ предположений
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**СТАТУС**: АКТИВИРОВАН
|
||||||
|
**ПРИОРИТЕТ**: КРИТИЧЕСКИЙ
|
||||||
|
**ОБХОД**: ЗАПРЕЩЕН
|
||||||
217
work-protocols.md
Normal file
217
work-protocols.md
Normal file
@ -0,0 +1,217 @@
|
|||||||
|
# ПРОТОКОЛЫ РАБОТЫ ДЛЯ AI АССИСТЕНТА
|
||||||
|
|
||||||
|
## 🎯 ПРОТОКОЛ ДЛЯ ЗАДАЧ СРЕДНЕЙ СЛОЖНОСТИ
|
||||||
|
|
||||||
|
### ОПРЕДЕЛЕНИЕ СРЕДНЕЙ СЛОЖНОСТИ:
|
||||||
|
|
||||||
|
- Работа с 2-3 файлами
|
||||||
|
- Изменение логики в 1-2 модулях
|
||||||
|
- Добавление новых функций без изменения архитектуры
|
||||||
|
- Задачи, требующие анализа зависимостей
|
||||||
|
|
||||||
|
### ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:
|
||||||
|
|
||||||
|
#### 1. 🔍 **ЭТАП АНАЛИЗА** (STOP & THINK)
|
||||||
|
|
||||||
|
```
|
||||||
|
ПЕРЕД НАЧАЛОМ ЗАДАТЬ СЕБЕ:
|
||||||
|
□ Какие файлы нужно изучить? (перечислить ВСЕ)
|
||||||
|
□ Какие правила из rules2.md применимы?
|
||||||
|
□ Есть ли зависимости между компонентами?
|
||||||
|
□ Что может пойти не так?
|
||||||
|
□ Нужны ли уточнения от пользователя?
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2. 📋 **СОЗДАНИЕ ПЛАНА**
|
||||||
|
|
||||||
|
```
|
||||||
|
□ Разбить задачу на подзадачи (не более 5)
|
||||||
|
□ Определить порядок выполнения
|
||||||
|
□ Выявить критические точки
|
||||||
|
□ Создать TODO список
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 3. 🔄 **ВЫПОЛНЕНИЕ С ПРОВЕРКАМИ**
|
||||||
|
|
||||||
|
```
|
||||||
|
ПОСЛЕ КАЖДОГО ШАГА:
|
||||||
|
□ Соответствует ли результат rules2.md?
|
||||||
|
□ Не нарушены ли связи с другими модулями?
|
||||||
|
□ Работает ли измененный код?
|
||||||
|
□ Нужно ли обновить documentation?
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 4. ✅ **ФИНАЛЬНАЯ САМОПРОВЕРКА**
|
||||||
|
|
||||||
|
```
|
||||||
|
□ Прочитать изменения еще раз
|
||||||
|
□ Проверить development-checklist.md
|
||||||
|
□ Убедиться в полноте решения
|
||||||
|
□ Задать вопрос: "Что еще я мог упустить?"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔥 ПРОТОКОЛ ДЛЯ ЗАДАЧ ВЫСОКОЙ СЛОЖНОСТИ
|
||||||
|
|
||||||
|
### ОПРЕДЕЛЕНИЕ ВЫСОКОЙ СЛОЖНОСТИ:
|
||||||
|
|
||||||
|
- Работа с 4+ файлами
|
||||||
|
- Изменение архитектуры системы
|
||||||
|
- Создание новых модулей/компонентов
|
||||||
|
- Задачи, влияющие на несколько кабинетов
|
||||||
|
- Изменения в правилах или workflow
|
||||||
|
|
||||||
|
### ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:
|
||||||
|
|
||||||
|
#### 1. 🛑 **СТОП! ГЛУБОКИЙ АНАЛИЗ**
|
||||||
|
|
||||||
|
```
|
||||||
|
ОБЯЗАТЕЛЬНЫЕ ВОПРОСЫ ПОЛЬЗОВАТЕЛЮ:
|
||||||
|
□ Уточнить ВСЕ требования и ожидания
|
||||||
|
□ Выяснить приоритеты и ограничения
|
||||||
|
□ Узнать о связях с другими системами
|
||||||
|
□ Понять критерии успеха
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2. 🔍 **ИССЛЕДОВАТЕЛЬСКАЯ ФАЗА**
|
||||||
|
|
||||||
|
```
|
||||||
|
□ Изучить ВСЕ связанные файлы параллельно
|
||||||
|
□ Построить карту зависимостей
|
||||||
|
□ Найти все правила в rules2.md
|
||||||
|
□ Выявить потенциальные конфликты
|
||||||
|
□ Проанализировать влияние на систему
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 3. 📊 **СОЗДАНИЕ ДЕТАЛЬНОГО ПЛАНА**
|
||||||
|
|
||||||
|
```
|
||||||
|
□ Разбить на этапы с промежуточными проверками
|
||||||
|
□ Определить точки возврата (rollback points)
|
||||||
|
□ Создать план тестирования
|
||||||
|
□ Предусмотреть обновление документации
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 4. 🎯 **ПОЭТАПНОЕ ВЫПОЛНЕНИЕ**
|
||||||
|
|
||||||
|
```
|
||||||
|
ПОСЛЕ КАЖДОГО ЭТАПА:
|
||||||
|
□ Проверка работоспособности
|
||||||
|
□ Валидация против всех правил
|
||||||
|
□ Промежуточная демонстрация пользователю
|
||||||
|
□ Корректировка плана при необходимости
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5. 🔄 **ИТЕРАТИВНАЯ ПРОВЕРКА**
|
||||||
|
|
||||||
|
```
|
||||||
|
□ Полное тестирование системы
|
||||||
|
□ Проверка всех затронутых модулей
|
||||||
|
□ Обновление всей связанной документации
|
||||||
|
□ Финальное согласование с пользователем
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ❓ СИСТЕМА ОБЯЗАТЕЛЬНЫХ УТОЧНЕНИЙ
|
||||||
|
|
||||||
|
### КОГДА ВСЕГДА СПРАШИВАТЬ:
|
||||||
|
|
||||||
|
#### 🔴 **КРИТИЧЕСКИЕ СИТУАЦИИ** (ОБЯЗАТЕЛЬНО):
|
||||||
|
|
||||||
|
- Обнаружил противоречие в правилах
|
||||||
|
- Задача может нарушить архитектуру системы
|
||||||
|
- Неясно как применить правило к конкретной ситуации
|
||||||
|
- Есть несколько способов решения с разными последствиями
|
||||||
|
- Изменения затрагивают критические бизнес-процессы
|
||||||
|
|
||||||
|
#### 🟡 **ВАЖНЫЕ СИТУАЦИИ** (РЕКОМЕНДУЕТСЯ):
|
||||||
|
|
||||||
|
- Задача требует создания новых типов данных
|
||||||
|
- Нужно изменить существующий workflow
|
||||||
|
- Есть сомнения в интерпретации требований
|
||||||
|
- Решение может повлиять на производительность
|
||||||
|
- Требуется интеграция с внешними системами
|
||||||
|
|
||||||
|
### ФОРМАТ УТОЧНЯЮЩИХ ВОПРОСОВ:
|
||||||
|
|
||||||
|
```
|
||||||
|
🎯 КОНТЕКСТ: Что именно я делаю
|
||||||
|
❓ ВОПРОС: Что конкретно неясно
|
||||||
|
⚖️ ВАРИАНТЫ: Какие есть альтернативы (если применимо)
|
||||||
|
⚠️ РИСКИ: Что может пойти не так
|
||||||
|
💡 ПРЕДЛОЖЕНИЕ: Мой рекомендуемый подход
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛠️ СИСТЕМА САМОПРОВЕРКИ
|
||||||
|
|
||||||
|
### ЧЕК-ЛИСТ ПОСЛЕ КАЖДОЙ ЗАДАЧИ:
|
||||||
|
|
||||||
|
#### ✅ **СООТВЕТСТВИЕ ПРАВИЛАМ**
|
||||||
|
|
||||||
|
```
|
||||||
|
□ Проверил против rules2.md (ВСЕ применимые разделы)
|
||||||
|
□ Обновил development-checklist.md если нужно
|
||||||
|
□ Не нарушил критические запреты
|
||||||
|
□ Соблюдены принципы ТОВАР ≠ ПРОДУКТ
|
||||||
|
□ Workflow статусы корректны
|
||||||
|
```
|
||||||
|
|
||||||
|
#### ✅ **ТЕХНИЧЕСКОЕ КАЧЕСТВО**
|
||||||
|
|
||||||
|
```
|
||||||
|
□ Код следует принципам SOLID
|
||||||
|
□ Добавлены необходимые проверки и валидации
|
||||||
|
□ Обработаны ошибки
|
||||||
|
□ Производительность не пострадала
|
||||||
|
□ Безопасность данных соблюдена
|
||||||
|
```
|
||||||
|
|
||||||
|
#### ✅ **ПОЛНОТА РЕШЕНИЯ**
|
||||||
|
|
||||||
|
```
|
||||||
|
□ Решены ВСЕ аспекты задачи
|
||||||
|
□ Обновлена документация
|
||||||
|
□ Проверены связанные компоненты
|
||||||
|
□ Нет "технических долгов"
|
||||||
|
□ Готово к production
|
||||||
|
```
|
||||||
|
|
||||||
|
#### ✅ **КОММУНИКАЦИЯ**
|
||||||
|
|
||||||
|
```
|
||||||
|
□ Объяснил что сделал и почему
|
||||||
|
□ Указал на важные изменения
|
||||||
|
□ Предупредил о потенциальных рисках
|
||||||
|
□ Дал рекомендации по дальнейшим действиям
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎖️ ДОПОЛНИТЕЛЬНЫЕ РЕКОМЕНДАЦИИ
|
||||||
|
|
||||||
|
### ДЛЯ ПОЛЬЗОВАТЕЛЯ:
|
||||||
|
|
||||||
|
1. **📋 Создавайте подробные задачи** - чем больше контекста, тем лучше результат
|
||||||
|
2. **🎯 Указывайте приоритеты** - что критично, а что можно отложить
|
||||||
|
3. **⚠️ Предупреждайте об ограничениях** - технических, временных, бизнесовых
|
||||||
|
4. **🔄 Давайте обратную связь** - что работает хорошо, что нужно улучшить
|
||||||
|
|
||||||
|
### ДЛЯ МЕНЯ:
|
||||||
|
|
||||||
|
1. **🛑 Принцип "Стоп и подумай"** перед каждой сложной задачей
|
||||||
|
2. **📊 Параллельный сбор информации** вместо последовательного
|
||||||
|
3. **❓ Активное уточнение** при малейших сомнениях
|
||||||
|
4. **🔄 Итеративная проверка** на каждом этапе
|
||||||
|
5. **📝 Документирование процесса** для улучшения в будущем
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 АКТИВАЦИЯ ПРОТОКОЛОВ
|
||||||
|
|
||||||
|
Данные протоколы активируются автоматически на основе сложности задачи. Я буду следовать им при каждой работе с проектом Sfera.
|
||||||
|
|
||||||
|
**КРИТЕРИЙ УСПЕХА**: Количество пропущенных важных деталей = 0
|
||||||
Reference in New Issue
Block a user