diff --git a/rules-complete.md b/rules-complete.md index 4499249..c04f07a 100644 --- a/rules-complete.md +++ b/rules-complete.md @@ -5,30 +5,37 @@ ## 🔴 ПРОТОКОЛЫ РАБОТЫ CLAUDE CODE ### ⛔ ЖЕСТКИЙ ПРОТОКОЛ - ОБЯЗАТЕЛЬНОЕ ИСПОЛНЕНИЕ + **Я НЕ МОГУ выполнять НИКАКИХ изменений в коде без предварительного чтения этого файла** **КОМАНДА ОСТАНОВКИ**: "СТОП - ЧИТАЙ ПРАВИЛА" - немедленно останавливает любую работу ### 📋 ОБЯЗАТЕЛЬНЫЙ ЧЕК-ЛИСТ ПЕРЕД КАЖДОЙ ЗАДАЧЕЙ + **КАЖДЫЙ ОТВЕТ ДОЛЖЕН НАЧИНАТЬСЯ С:** + ``` ## 📋 Чек-лист соответствия правилам: - ✅ Прочитал rules-complete.md -- ✅ Задача понята в контексте правил +- ✅ Задача понята в контексте правил - ✅ План действий соответствует правилам - ✅ [ЕСЛИ UI/UX ЗАДАЧА] Прочитал visual-design-rules.md - ✅ Готов выполнять согласно единому источнику истины ``` + **БЕЗ ЭТОГО ЧЕК-ЛИСТА = НИКАКИХ ДЕЙСТВИЙ** ### 🔄 ДВУХЭТАПНЫЙ ПРОЦЕСС РАБОТЫ + #### **ЭТАП 1: ПЛАНИРОВАНИЕ (ОБЯЗАТЕЛЬНЫЙ)** + - Прочитать этот файл правил -- Создать детальный план действий +- Создать детальный план действий - Указать какие правила будут применены - **ОСТАНОВИТЬСЯ И ЖДАТЬ ОДОБРЕНИЯ ПЛАНА** #### **ЭТАП 2: ВЫПОЛНЕНИЕ (ТОЛЬКО ПОСЛЕ ОДОБРЕНИЯ)** + - Получить одобрение плана от пользователя - Следовать ТОЛЬКО одобренному плану - Использовать TodoWrite для отслеживания прогресса @@ -40,6 +47,7 @@ ### 🎯 ПРОТОКОЛ ДЛЯ ЗАДАЧ СРЕДНЕЙ СЛОЖНОСТИ **ОПРЕДЕЛЕНИЕ СРЕДНЕЙ СЛОЖНОСТИ:** + - Работа с 2-3 файлами - Изменение логики в 1-2 модулях - Добавление новых функций без изменения архитектуры @@ -48,6 +56,7 @@ **ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:** #### 1. 🔍 **ЭТАП АНАЛИЗА** (STOP & THINK) + ``` ПЕРЕД НАЧАЛОМ ЗАДАТЬ СЕБЕ: □ Какие файлы нужно изучить? (перечислить ВСЕ) @@ -58,6 +67,7 @@ ``` #### 2. 📋 **СОЗДАНИЕ ПЛАНА** + ``` □ Разбить задачу на подзадачи (не более 5) □ Определить порядок выполнения @@ -66,6 +76,7 @@ ``` #### 3. 🔄 **ВЫПОЛНЕНИЕ С ПРОВЕРКАМИ** + ``` ПОСЛЕ КАЖДОГО ШАГА: □ Соответствует ли результат правилам из этого документа? @@ -77,6 +88,7 @@ ### 🔥 ПРОТОКОЛ ДЛЯ ЗАДАЧ ВЫСОКОЙ СЛОЖНОСТИ **ОПРЕДЕЛЕНИЕ ВЫСОКОЙ СЛОЖНОСТИ:** + - Работа с 4+ файлами - Изменение архитектуры системы - Создание новых модулей/компонентов @@ -86,6 +98,7 @@ **ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:** #### 1. 🛑 **СТОП! ГЛУБОКИЙ АНАЛИЗ** + ``` ОБЯЗАТЕЛЬНЫЕ ВОПРОСЫ ПОЛЬЗОВАТЕЛЮ: □ Уточнить ВСЕ требования и ожидания @@ -95,6 +108,7 @@ ``` #### 2. 🔍 **ИССЛЕДОВАТЕЛЬСКАЯ ФАЗА** + ``` □ Изучить ВСЕ связанные файлы параллельно □ Построить карту зависимостей @@ -104,6 +118,7 @@ ``` #### 3. 📊 **СОЗДАНИЕ ДЕТАЛЬНОГО ПЛАНА** + ``` □ Разбить на этапы с промежуточными проверками □ Определить точки возврата (rollback points) @@ -114,6 +129,7 @@ ### ❓ СИСТЕМА ОБЯЗАТЕЛЬНЫХ УТОЧНЕНИЙ #### 🔴 **КРИТИЧЕСКИЕ СИТУАЦИИ** (ОБЯЗАТЕЛЬНО): + - Обнаружил противоречие в правилах - Задача может нарушить архитектуру системы - Неясно как применить правило к конкретной ситуации @@ -121,6 +137,7 @@ - Изменения затрагивают критические бизнес-процессы #### 🟡 **ВАЖНЫЕ СИТУАЦИИ** (РЕКОМЕНДУЕТСЯ): + - Задача требует создания новых типов данных - Нужно изменить существующий workflow - Есть сомнения в интерпретации требований @@ -128,6 +145,7 @@ - Требуется интеграция с внешними системами **ФОРМАТ УТОЧНЯЮЩИХ ВОПРОСОВ:** + ``` 🎯 КОНТЕКСТ: Что именно я делаю ❓ ВОПРОС: Что конкретно неясно @@ -143,6 +161,7 @@ **ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:** #### 1. 📖 **ИЗУЧЕНИЕ ВИЗУАЛЬНЫХ ПРАВИЛ** + ``` ОБЯЗАТЕЛЬНО: □ Прочитать visual-design-rules.md @@ -152,6 +171,7 @@ ``` #### 2. 🎯 **ПРИМЕНЕНИЕ ДИЗАЙН-СИСТЕМЫ** + ``` ПРОВЕРИТЬ: □ Соответствие цветовой палитре (OKLCH) @@ -162,6 +182,7 @@ ``` #### 3. ✅ **ВАЛИДАЦИЯ ДИЗАЙНА** + ``` УБЕДИТЬСЯ: □ Соблюдены принципы иерархии @@ -175,6 +196,7 @@ ### 🛑 ОБЯЗАТЕЛЬНЫЕ ОСТАНОВКИ ПЕРЕД ДЕЙСТВИЯМИ #### **СТОП-СИГНАЛ #1: ПЕРЕД ЛЮБЫМ АНАЛИЗОМ КОМПОНЕНТОВ** + ``` ❌ ЗАПРЕЩЕНО: Делать предположения о содержании файлов/компонентов ✅ ОБЯЗАТЕЛЬНО: @@ -184,6 +206,7 @@ ``` #### **СТОП-СИГНАЛ #2: ПРИ НЕОПРЕДЕЛЕННОСТИ** + ``` ❌ ЗАПРЕЩЕНО: Гадать, предполагать, домысливать ✅ ОБЯЗАТЕЛЬНО: @@ -193,6 +216,7 @@ ``` #### **СТОП-СИГНАЛ #3: ПЕРЕД ВЫПОЛНЕНИЕМ СРЕДНИХ/СЛОЖНЫХ ЗАДАЧ** + ``` ❌ ЗАПРЕЩЕНО: Сразу приступать к работе ✅ ОБЯЗАТЕЛЬНО: @@ -204,6 +228,7 @@ ### 🔒 СИСТЕМА ПРИНУДИТЕЛЬНЫХ ПРОВЕРОК #### **ПРОВЕРКА #1: АНАЛИЗ КОДА** + ``` Если задача включает анализ компонентов: □ Использовал ли поиск по кодовой базе? @@ -212,6 +237,7 @@ ``` #### **ПРОВЕРКА #2: СОБЛЮДЕНИЕ ПРОТОКОЛОВ** + ``` Для каждой задачи: □ Определил ли сложность задачи? @@ -223,14 +249,17 @@ ### ⚡ СИСТЕМА АВТОМАТИЧЕСКИХ ТРИГГЕРОВ #### **ТРИГГЕР #1: При упоминании компонентов** + - Ключевые слова: "компонент", "файл", "содержание", "показывает" - Действие: ОБЯЗАТЕЛЬНО использовать инструменты анализа кода #### **ТРИГГЕР #2: При неопределенности** + - Ключевые фразы: "возможно", "вероятно", "думаю", "предполагаю" - Действие: СТОП + вопрос пользователю #### **ТРИГГЕР #3: При работе с UI/UX** + - Ключевые слова: "дизайн", "интерфейс", "компонент", "стили", "UI", "UX", "визуал", "цвет", "кнопка", "форма", "карточка" - Действие: ОБЯЗАТЕЛЬНО прочитать visual-design-rules.md перед началом работы @@ -250,9 +279,10 @@ ### 🛑 ОБЯЗАТЕЛЬНЫЙ ПРОТОКОЛ ПЕРЕД КАЖДОЙ ЗАДАЧЕЙ #### **ШАГ 1: ОПРЕДЕЛЕНИЕ СЛОЖНОСТИ И ПРОТОКОЛА** + ``` ВОПРОСЫ: -- Сколько файлов затрагивает задача? (1-3 = средняя, 4+ = высокая) +- Сколько файлов затрагивает задача? (1-3 = средняя, 4+ = высокая) - Изменяется ли архитектура или workflow? (да = высокая) - Влияет ли на критические бизнес-процессы? (да = высокая) @@ -260,6 +290,7 @@ ``` #### **ШАГ 2: ЭТАП "СТОП И ПОДУМАЙ"** + ``` ОБЯЗАТЕЛЬНЫЕ ВОПРОСЫ: - Какие правила из этого документа применимы? @@ -281,12 +312,13 @@ ``` ### 📈 МЕТРИКИ УСПЕХА + ``` ЦЕЛЬ: 0 пропущенных критических деталей ИЗМЕРЕНИЕ: ✅ Количество вопросов на уточнение -✅ Полнота анализа источников +✅ Полнота анализа источников ✅ Отсутствие нарушений правил ``` @@ -302,15 +334,15 @@ ### 🔍 БЫСТРЫЙ ПОИСК ПО ТЕМАМ -| Тема | Раздел | Ключевые понятия | -|------|--------|------------------| -| **Типы предметов** | [2](#2--типизация-предметов) | PRODUCT, CONSUMABLE, DEFECT, FINISHED_PRODUCT | -| **Кабинет фулфилмента** | [11](#11--кабинет-фулфилмента-полная-документация) | Склад, Услуги, Сотрудники, 6 модулей | -| **Workflow поставок** | [5](#5--workflow-поставок) | 8 статусов, уведомления, логистика | -| **GraphQL запросы** | [18](#18--graphql-и-typescript-правила), [24](#24--технические-приложения) | Резолверы, мутации, типизация | -| **Система партнерства** | [13](#13--система-партнерства-и-контрагентов) | Counterparty, WHOLESALE, заявки | -| **Рынки и маркет** | [10.1](#101-разделение-понятий-рынок-vs-маркет), [18.7](#187-правила-рынков-и-маркета) | РЫНОК ≠ МАРКЕТ, Organization.market | -| **Критические запреты** | [17](#17--критические-запреты) | Что НЕЛЬЗЯ делать в системе | +| Тема | Раздел | Ключевые понятия | +| ----------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------- | +| **Типы предметов** | [2](#2--типизация-предметов) | PRODUCT, CONSUMABLE, DEFECT, FINISHED_PRODUCT | +| **Кабинет фулфилмента** | [11](#11--кабинет-фулфилмента-полная-документация) | Склад, Услуги, Сотрудники, 6 модулей | +| **Workflow поставок** | [5](#5--workflow-поставок) | 8 статусов, уведомления, логистика | +| **GraphQL запросы** | [18](#18--graphql-и-typescript-правила), [24](#24--технические-приложения) | Резолверы, мутации, типизация | +| **Система партнерства** | [13](#13--система-партнерства-и-контрагентов) | Counterparty, WHOLESALE, заявки | +| **Рынки и маркет** | [10.1](#101-разделение-понятий-рынок-vs-маркет), [18.7](#187-правила-рынков-и-маркета) | РЫНОК ≠ МАРКЕТ, Organization.market | +| **Критические запреты** | [17](#17--критические-запреты) | Что НЕЛЬЗЯ делать в системе | ### 🎯 ДЛЯ РАЗНЫХ РОЛЕЙ @@ -321,15 +353,18 @@ --- ## 🔤 ГЛОССАРИЙ ТЕРМИНОВ + > Для людей → `В коде` ### **ТИПЫ ПРЕДМЕТОВ:** + - **ТОВАР** → `PRODUCT` - базовый товар от поставщика, может стать продуктом или браком - **РАСХОДНИКИ** → `CONSUMABLE` - материалы, классифицируются по назначению при использовании (операционные/производственные) -- **БРАК** → `DEFECT` *(НЕ РЕАЛИЗОВАНО)* - функционал брака еще не внедрен в систему -- **ПРОДУКТ** → `FINISHED_PRODUCT` *(планируется)* - готовый товар, создается из товара по рецептуре +- **БРАК** → `DEFECT` _(НЕ РЕАЛИЗОВАНО)_ - функционал брака еще не внедрен в систему +- **ПРОДУКТ** → `FINISHED_PRODUCT` _(планируется)_ - готовый товар, создается из товара по рецептуре ### **ТИПЫ ОРГАНИЗАЦИЙ:** + - **ПОСТАВЩИК** → `WHOLESALE` - создает товары и расходники, обрабатывает заказы - **СЕЛЛЕР** → `SELLER` - заказывает товары, создает поставки на маркетплейсы - **ФУЛФИЛМЕНТ** → `FULFILLMENT` - обрабатывает товары, создает продукты, максимальные права @@ -338,32 +373,87 @@ ### 2.2 Правила создания предметов по ролям **КТО МОЖЕТ СОЗДАВАТЬ:** + - **ПОСТАВЩИК** (`WHOLESALE`): Товары (`PRODUCT`) и Расходники (`CONSUMABLE`) - **ФУЛФИЛМЕНТ** (`FULFILLMENT`): Продукты (`FINISHED_PRODUCT`) - только из существующих товаров - **СЕЛЛЕР/ЛОГИСТ**: НЕ МОГУТ создавать предметы **КТО МОЖЕТ ПОКУПАТЬ:** -- **СЕЛЛЕР** (`SELLER`): + +- **СЕЛЛЕР** (`SELLER`): - Товары и расходники у поставщиков - Расходники фулфилмента у фулфилмента (через рецептуру в поставке) - **ФУЛФИЛМЕНТ** (`FULFILLMENT`): Товары и расходники у поставщиков - **ПОСТАВЩИК/ЛОГИСТ**: НЕ МОГУТ покупать предметы **ЭКОНОМИЧЕСКИЙ УЧЕТ:** + - Когда селлер выбирает расходники фулфилмента в рецептуре, это формирует экономические данные: - В кабинете селлера: расход на расходники фулфилмента - В кабинете фулфилмента: доход от продажи расходников селлеру ### **КЛЮЧЕВЫЕ СУЩНОСТИ:** + - **Контрагент** → `Counterparty` - связь между организациями для партнерства - **Поставка** → `SupplyOrder` - заказ товаров/расходников с workflow статусами - **Рецептура** - состав продукта: товар + услуги + расходники (задается селлером) +### **КОНТЕКСТНО-ЗАВИСИМЫЕ ТЕРМИНЫ:** + +#### **SupplyOrder - многосторонний документ** + +SupplyOrder представляет собой единый документ, который видится по-разному каждым участником процесса: + +**ДЛЯ СОЗДАТЕЛЕЙ (Селлер/Фулфилмент):** + +- **Термин**: "Поставка" +- **Контекст**: Они создают поставку товаров и расходников на фулфилмент +- **Включает**: Весь процесс от закупки до приемки на склад + +**ДЛЯ ПОСТАВЩИКА (исполнитель товарной части):** + +- **Термин**: "Заявка на покупку" +- **Контекст**: Получают запрос на продажу своих товаров/расходников +- **Действия**: Могут одобрить или отклонить в зависимости от наличия + +**ДЛЯ ЛОГИСТИКИ (исполнитель транспортной части):** + +- **Термин**: "Заявка на доставку" +- **Контекст**: Получают запрос на транспортировку груза +- **Действия**: Могут подтвердить или отклонить в зависимости от возможностей + +**ОТОБРАЖЕНИЕ В ИНТЕРФЕЙСЕ КАБИНЕТОВ:** +| Кабинет | Название раздела | Обоснование | +|---------|-----------------|-------------| +| Селлер | "Мои поставки" | Создает и управляет поставками | +| Поставщик | "Заявки на покупку" | Обрабатывает входящие заявки | +| Логистика | "Заявки на доставку" | Управляет транспортировкой | +| Фулфилмент | "Входящие поставки" | Принимает поставки на склад | + +**ВАЖНО**: Это один и тот же объект SupplyOrder в базе данных, но каждый участник работает со своей стороной процесса. + +#### **Маркет vs Маркетплейс - четкое разделение** + +**МАРКЕТ** (`/market`): + +- **Что это**: Внутренний раздел системы +- **Функция**: Глобальный каталог всех товаров от всех поставщиков +- **Доступ**: Для всех типов организаций в системе +- **НЕ путать**: С названиями физических рынков типа "ОПТ Маркет" + +**МАРКЕТПЛЕЙС** (Wildberries, Ozon): + +- **Что это**: Внешние торговые площадки +- **Функция**: Конечные точки продаж для селлеров +- **Интеграция**: Через API ключи в настройках +- **Использование**: "Поставки на маркетплейсы", "Отгрузка на маркетплейсы" + --- ## 📑 ОГЛАВЛЕНИЕ -> 📋 **ЧТО ОБЪЕДИНЕНО**: +> 📋 **ЧТО ОБЪЕДИНЕНО**: +> > - rules-unified.md (v3.0) - общая база знаний системы > - fulfillment-cabinet-rules.md (v1.0) - детализация кабинета фулфилмента > - Устранены все несоответствия в терминах, последовательностях и детализации @@ -426,30 +516,30 @@ ### 📦 **ОСНОВНЫЕ ПРЕДМЕТЫ** -| Сущность | Название в системе | Кабинет создания | Описание | Статус | -| ---------- | ---------------------------------- | ---------------- | ----------------------------------------------- | --------------- | -| Товар | `Product` (type: `PRODUCT`) | Поставщик | Базовый тип товара от поставщика | ✅ Реализовано | -| Расходники | `Product` (type: `CONSUMABLE`) | Поставщик | Материалы и вспомогательные товары | ✅ Реализовано | -| Брак | `Product` (type: `DEFECT`)* | Фулфилмент | Производная от товара с дефектами | 📋 Планируется | -| Продукт | `Product` (type: `FINISHED_PRODUCT`)* | Фулфилмент | Готовый к продаже товар (производная от товара) | 📋 Планируется | +| Сущность | Название в системе | Кабинет создания | Описание | Статус | +| ---------- | -------------------------------------- | ---------------- | ----------------------------------------------- | -------------- | +| Товар | `Product` (type: `PRODUCT`) | Поставщик | Базовый тип товара от поставщика | ✅ Реализовано | +| Расходники | `Product` (type: `CONSUMABLE`) | Поставщик | Материалы и вспомогательные товары | ✅ Реализовано | +| Брак | `Product` (type: `DEFECT`)\* | Фулфилмент | Производная от товара с дефектами | 📋 Планируется | +| Продукт | `Product` (type: `FINISHED_PRODUCT`)\* | Фулфилмент | Готовый к продаже товар (производная от товара) | 📋 Планируется | > **\* Планируется**: Типы `DEFECT` и `FINISHED_PRODUCT` еще не добавлены в Prisma схему ### 🏢 **ОРГАНИЗАЦИИ И РОЛИ** -| Сущность | Название в системе | Основные функции | Статус | -| ---------- | ---------------------------------- | --------------------------------------- | -------------- | -| Поставщик | `Organization` (type: `WHOLESALE`) | Создание товаров, управление поставками | ✅ Реализовано | -| Селлер | `Organization` (type: `SELLER`) | Заказ товаров, управление поставками | ✅ Реализовано | -| Фулфилмент | `Organization` (type: `FULFILLMENT`) | Обработка товаров, управление складом | ✅ Реализовано | -| Логистика | `Organization` (type: `LOGIST`) | Управление доставками | ✅ Реализовано | +| Сущность | Название в системе | Основные функции | Статус | +| ---------- | ------------------------------------ | --------------------------------------- | -------------- | +| Поставщик | `Organization` (type: `WHOLESALE`) | Создание товаров, управление поставками | ✅ Реализовано | +| Селлер | `Organization` (type: `SELLER`) | Заказ товаров, управление поставками | ✅ Реализовано | +| Фулфилмент | `Organization` (type: `FULFILLMENT`) | Обработка товаров, управление складом | ✅ Реализовано | +| Логистика | `Organization` (type: `LOGIST`) | Управление доставками | ✅ Реализовано | ### 🤝 **СИСТЕМА ПАРТНЕРСТВА** -| Сущность | Название в системе | Описание | Статус | -| ------------ | ------------------ | ---------------------------------- | -------------- | -| Контрагент | `Counterparty` | Связь между организациями | ✅ Реализовано | -| Заявка | `CounterpartyRequest` | Запрос на сотрудничество | ✅ Реализовано | +| Сущность | Название в системе | Описание | Статус | +| ---------- | --------------------- | ------------------------- | -------------- | +| Контрагент | `Counterparty` | Связь между организациями | ✅ Реализовано | +| Заявка | `CounterpartyRequest` | Запрос на сотрудничество | ✅ Реализовано | --- @@ -460,10 +550,12 @@ **СТРУКТУРА СИСТЕМЫ ПО КАБИНЕТАМ:** **🏢 КАБИНЕТ ПОСТАВЩИКА** - создает и управляет: + - **ТОВАР** (`PRODUCT`) - базовые товары от поставщика - **РАСХОДНИКИ** (`CONSUMABLE`) - материалы и вспомогательные товары от поставщика **🏭 КАБИНЕТ ФУЛФИЛМЕНТА** - принимает, обрабатывает и управляет всеми типами: + - **ТОВАР** (`PRODUCT`) - базовые товары от поставщиков (принятые на склад) - **БРАК** (`DEFECT` - планируется) - производная от товара (товар с дефектами) - **ПРОДУКТ** (`FINISHED_PRODUCT` - планируется) - готовый к продаже товар @@ -472,6 +564,7 @@ - **"Производственные расходники"** - используются в рецептурах селлеров для создания продуктов **🛍️ КАБИНЕТ СЕЛЛЕРА** - заказывает и управляет поставками: + - Создает заказы товаров и расходников - Управляет поставками на фулфилмент и маркетплейсы - Отслеживает статусы поставок @@ -557,14 +650,17 @@ ### 3.2 Специфические разделы по типам организаций **🏪 ПОСТАВЩИК (`WHOLESALE`):** + - Склад (`/warehouse`) - управление товарами и расходниками - Поставки (`/supplies`) - обработка заказов от селлеров **🛍️ СЕЛЛЕР (`SELLER`):** + - Мои поставки (`/supplies`) - управление заказами товаров - WB Интеграция (`/wb-integration`) - связь с Wildberries **🏭 ФУЛФИЛМЕНТ (`FULFILLMENT`):** + - Склад фулфилмента (`/fulfillment-warehouse`) - управление всеми типами товаров - Поставки фулфилмента (`/fulfillment-supplies`) - обработка поставок - Услуги (`/services`) - управление услугами, логистикой, расходниками @@ -572,6 +668,7 @@ - Статистика фулфилмента (`/fulfillment-statistics`) - детальная аналитика **🚚 ЛОГИСТИКА (`LOGIST`):** + - Заявки (`/logistics-requests`) - управление заявками на доставку - Маршруты (`/routes`) - планирование маршрутов @@ -594,15 +691,15 @@ ```typescript const handleSuppliesClick = () => { switch (user?.organization?.type) { - case "FULFILLMENT": - router.push("/fulfillment-supplies"); - break; - case "SELLER": - router.push("/supplies"); - break; + case 'FULFILLMENT': + router.push('/fulfillment-supplies') + break + case 'SELLER': + router.push('/supplies') + break // ... другие типы } -}; +} ``` ### 4.2 GraphQL проверки доступа @@ -611,15 +708,15 @@ const handleSuppliesClick = () => { ```typescript const { data } = useQuery(GET_MY_SERVICES, { - skip: user?.organization?.type !== "FULFILLMENT", -}); + skip: user?.organization?.type !== 'FULFILLMENT', +}) ``` **В GraphQL резолверах:** ```typescript -if (currentUser.organization.type !== "FULFILLMENT") { - throw new GraphQLError("Доступно только для фулфилмент центров"); +if (currentUser.organization.type !== 'FULFILLMENT') { + throw new GraphQLError('Доступно только для фулфилмент центров') } ``` @@ -652,36 +749,25 @@ if (currentUser.organization.type !== "FULFILLMENT") { ### 5.2 Пошаговый процесс поставки **ЭТАП 1: Создание заказа** + 1. Селлер заказывает товар/расходники у поставщика 2. Система создает SupplyOrder со статусом `PENDING` 3. Автоматическое уведомление поставщику -**ЭТАП 2: Обработка поставщиком** -4. Поставщик получает оповещение -5. Поставщик нажимает "Одобрить" -6. Статус меняется на `SUPPLIER_APPROVED` +**ЭТАП 2: Обработка поставщиком** 4. Поставщик получает оповещение 5. Поставщик нажимает "Одобрить" 6. Статус меняется на `SUPPLIER_APPROVED` -**ЭТАП 3: Передача в фулфилмент** -7. Поставка отображается в кабинете фулфилмента -8. Фулфилмент выбирает ответственного и логистику -9. Статус меняется на `CONFIRMED` +**ЭТАП 3: Передача в фулфилмент** 7. Поставка отображается в кабинете фулфилмента 8. Фулфилмент выбирает ответственного и логистику 9. Статус меняется на `CONFIRMED` -**ЭТАП 4: Логистическое подтверждение** -10. Логистика подтверждает доставку -11. Статус меняется на `LOGISTICS_CONFIRMED` +**ЭТАП 4: Логистическое подтверждение** 10. Логистика подтверждает доставку 11. Статус меняется на `LOGISTICS_CONFIRMED` -**ЭТАП 5: Отгрузка** -12. Поставщик отгружает товар -13. Статус меняется на `SHIPPED`, затем `IN_TRANSIT` +**ЭТАП 5: Отгрузка** 12. Поставщик отгружает товар 13. Статус меняется на `SHIPPED`, затем `IN_TRANSIT` -**ЭТАП 6: Доставка и приемка** -14. Логистика доставляет на фулфилмент -15. Фулфилмент принимает товар -16. Статус меняется на `DELIVERED` +**ЭТАП 6: Доставка и приемка** 14. Логистика доставляет на фулфилмент 15. Фулфилмент принимает товар 16. Статус меняется на `DELIVERED` ### 5.3 Система уведомлений **Обязательные уведомления:** + - Поставщику: о новом заказе - Фулфилменту: о подтвержденной поставке - Логистике: о назначении на заявку @@ -691,7 +777,8 @@ if (currentUser.organization.type !== "FULFILLMENT") { ## 6. 🔄 ПРОЦЕСС СОЗДАНИЯ ПРОДУКТА -> 📌 **СВЯЗАННЫЕ РАЗДЕЛЫ**: +> 📌 **СВЯЗАННЫЕ РАЗДЕЛЫ**: +> > - Типы предметов → См. [раздел 2.2](#22-обязательные-поля-карточки) > - Склад фулфилмента → См. [раздел 11.2](#112-структура-раздела-склад-фулфилмента) > - Статистика движения → См. [раздел 7](#7--система-учета-движения-товаров) @@ -701,6 +788,7 @@ if (currentUser.organization.type !== "FULFILLMENT") { > 📌 **ВИЗУАЛЬНЫЕ ПРАВИЛА**: См. [visual-design-rules.md - Процесс создания продукта](#143-процесс-создания-продукта---визуальный-workflow) #### **ПРЕДВАРИТЕЛЬНОЕ УСЛОВИЕ: РЕЦЕПТУРА ЗАДАНА** (селлер) + ``` Время: при создании заявки на поставку Действие: селлер указывает рецептуру продукта @@ -712,6 +800,7 @@ if (currentUser.organization.type !== "FULFILLMENT") { ``` #### **ШАГ 1: ПОСТУПЛЕНИЕ НА СКЛАД** (автоматически) + ``` Время: при смене статуса поставки DELIVERED Действие: товар переходит в статус "на складе" @@ -720,6 +809,7 @@ if (currentUser.organization.type !== "FULFILLMENT") { ``` #### **ШАГ 2: ПЛАНИРОВАНИЕ РАБОТЫ** (менеджер фулфилмента) + ``` Время: в течение 2 рабочих дней после поступления Действие: назначение параметров обработки @@ -735,6 +825,7 @@ if (currentUser.organization.type !== "FULFILLMENT") { ``` #### **ШАГ 3: ОБРАБОТКА ТОВАРА** (исполнитель) + ``` Время: согласно дедлайну (обычно 1-3 дня) Действие: физическая обработка товара @@ -758,6 +849,7 @@ if (currentUser.organization.type !== "FULFILLMENT") { ``` #### **ШАГ 4: КОНТРОЛЬ КАЧЕСТВА** (менеджер/отдел качества) + ``` Время: сразу после завершения ШАГ 3 Действие: приемка готовой продукции @@ -771,6 +863,7 @@ if (currentUser.organization.type !== "FULFILLMENT") { ``` #### **ШАГ 5: ЗАВЕРШЕНИЕ** (система + менеджер) + ``` Время: после успешного прохождения контроля качества Действие: финализация процесса @@ -787,12 +880,12 @@ if (currentUser.organization.type !== "FULFILLMENT") { ### 6.2 Временные рамки и SLA -| Этап | Стандартное время | Максимальное время | Ответственный | -|------|------------------|-------------------|---------------| -| Планирование | 1 рабочий день | 2 рабочих дня | Менеджер ФФ | -| Обработка | 2-3 рабочих дня | 5 рабочих дней | Исполнитель | -| Контроль качества | 4 часа | 1 рабочий день | Отдел качества | -| Завершение | 2 часа | 4 часа | Менеджер ФФ | +| Этап | Стандартное время | Максимальное время | Ответственный | +| ----------------- | ----------------- | ------------------ | -------------- | +| Планирование | 1 рабочий день | 2 рабочих дня | Менеджер ФФ | +| Обработка | 2-3 рабочих дня | 5 рабочих дней | Исполнитель | +| Контроль качества | 4 часа | 1 рабочий день | Отдел качества | +| Завершение | 2 часа | 4 часа | Менеджер ФФ | ### 6.3 Управление браком и расхождениями @@ -833,11 +926,13 @@ if (currentUser.organization.type !== "FULFILLMENT") { **ФАКТ**: Реальное количество после пересчета (работник фулфилмента производит сортировку при пересчете) **ФИКСАЦИЯ ПОТЕРЬ:** + - **КОГДА**: В процессе работы (вкладка "В работе") - **ЧТО**: Недостача, повреждения (без создания записей брака) - **КАК**: Корректировка количества в статистике **WORKFLOW СОЗДАНИЯ ПРОДУКТА:** + 1. Товар поступает на склад фулфилмента (статус "на складе") 2. Товар берется в работу (переход в статус "в обработке") 3. Исполнитель производит пересчет и сортировку @@ -845,10 +940,11 @@ if (currentUser.organization.type !== "FULFILLMENT") { 5. Продукт готов к отправке на маркетплейсы **ВЛИЯНИЕ НА СТАТИСТИКУ:** + - При принятии поставки: +План в статистику - При выявлении факта: корректировка на реальные данные - **ФОРМУЛА**: Факт = Потери + Хороший товар -*Где потери - это недостача/повреждения, выявленные при пересчете и сортировке* + _Где потери - это недостача/повреждения, выявленные при пересчете и сортировке_ - **ЛОГИКА**: Фактическое количество = сумма всех пересчитанных предметов - **ПЛАН/ФАКТ**: Корректировка статистики при выявлении расхождений @@ -897,7 +993,7 @@ if (currentUser.organization.type !== "FULFILLMENT") { **СТАТУС**: Реализовано **ДОСТУП**: Через навигацию в sidebar для всех типов кабинетов -**СОДЕРЖАНИЕ**: Универсальная страница с типо-зависимыми компонентами +**СОДЕРЖАНИЕ**: Универсальная страница с типо-зависимыми компонентами **ПРАВИЛА**: @@ -911,7 +1007,7 @@ if (currentUser.organization.type !== "FULFILLMENT") { **СТАТУС**: Реализовано в системе **РАСПОЛОЖЕНИЕ**: Перед настройками в каждом кабинете -**СОДЕРЖАНИЕ**: Пустые разделы-заглушки с пометкой "будет добавлен позже" +**СОДЕРЖАНИЕ**: Пустые разделы-заглушки с пометкой "будет добавлен позже" **ПРАВИЛА**: @@ -933,6 +1029,7 @@ if (currentUser.organization.type !== "FULFILLMENT") { - ⚙️ **Настройки** - профиль и конфигурация **СПЕЦИАЛИЗИРОВАННЫЕ РАЗДЕЛЫ** (зависят от типа кабинета): + - Определяются в соответствующих разделах каждого кабинета ### 8.2 Правила sidebar навигации @@ -964,20 +1061,20 @@ if (currentUser.organization.type !== "FULFILLMENT") { // Пример: кнопка "Поставки" ведет на разные страницы 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; + 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 } -}; +} ``` --- @@ -1007,6 +1104,7 @@ const handleSuppliesClick = () => { **ОБНОВЛЕННАЯ СТРУКТУРА СИСТЕМЫ (4 БЛОКА):** **БЛОК 1: ПОСТАВЩИКИ** _(адаптивная сетка)_ + - **Заголовок**: Минималистичный "🏢 Поставщики" без лишних элементов - **Поиск**: Компактное поле справа "Поиск поставщиков..." (w-64) - **Отображение**: Карточки поставщиков из раздела "Партнеры" в адаптивной сетке @@ -1014,6 +1112,7 @@ const handleSuppliesClick = () => { - **Результат**: Загружаются карточки товаров выбранного поставщика в блок 2 **БЛОК 2: КАРТОЧКИ ТОВАРОВ** _(горизонтальный скролл - НОВЫЙ)_ + - **Отображение**: ТОЛЬКО минималистичные карточки товаров 80×112px - **Содержание**: ТОЛЬКО изображение товара, БЕЗ текста/названий/цен - **Навигация**: Горизонтальный скролл при множестве товаров @@ -1021,17 +1120,20 @@ const handleSuppliesClick = () => { - **Результат**: Товар добавляется в блок 3 для управления поставкой **БЛОК 3: ТОВАРЫ ПОСТАВЩИКА** _(детальный каталог)_ + - **Отображение**: Детальные карточки выбранных товаров - **Управление**: Количество, параметры, настройки поставки - **Результат**: Формирование окончательной поставки **БЛОК 4: КОРЗИНА И НАСТРОЙКИ** _(правая панель)_ + - **Отображение**: Корзина поставки + настройки - **Управление**: Фулфилмент-центр, дата, логистика #### **9.2.1 Детальные правила горизонтального скролла поставщиков** **СТРУКТУРА И ОТОБРАЖЕНИЕ:** + - **Источник данных**: Партнеры типа `WHOLESALE` из раздела "Партнеры" - **Контейнер**: Фиксированная высота 176px (h-44) с горизонтальным скроллом - **Блок поставщиков**: Общая высота 180px, включает заголовок + контейнер скролла @@ -1039,17 +1141,20 @@ const handleSuppliesClick = () => { - **Поведение**: Плавный скролл с автоскрытием полосы прокрутки **РАЗМЕРЫ И АДАПТИВНОСТЬ:** + - **Десктоп**: Карточка 216×92px, отступы 12px между карточками, 16px от краев - **Планшет**: Карточка 200×92px, отступы 12px между карточками - **Мобильный**: Карточка 184×92px, отступы 12px между карточками - **Высота блока**: 180px фиксированная для всего блока поставщиков **ВЗАИМОДЕЙСТВИЕ:** + - **Навигация**: Колесо мыши (Shift+скролл), стрелки клавиатуры, свайп на тач - **Выбор**: Клик по карточке → активная рамка + загрузка товаров в блок 2 - **Состояния**: Default, Hover (box-shadow), Active (цветная рамка), Loading (скелетон) **ГРАНИЧНЫЕ СЛУЧАИ:** + - **1-4 карточки**: Выравнивание по левому краю, скролл неактивен - **5+ карточек**: Полный горизонтальный скролл - **Нет партнеров**: Заглушка с ссылкой на раздел "Партнеры" @@ -1057,6 +1162,7 @@ const handleSuppliesClick = () => { **ТЕХНИЧЕСКАЯ РЕАЛИЗАЦИЯ:** **Критическая Flex-архитектура:** + ```css .parent-container { display: flex; @@ -1084,6 +1190,7 @@ const handleSuppliesClick = () => { ``` **Контейнер скролла:** + ```css .suppliers-block { display: flex; @@ -1112,22 +1219,26 @@ const handleSuppliesClick = () => { **СОДЕРЖАНИЕ КАРТОЧКИ ПОСТАВЩИКА:** **Структура (3 строки в 92px высоты):** + - **Строка 1**: Название + рейтинг (справа, если есть) - **Строка 2**: ИНН (формат "ИНН: 1234567890") - **Строка 3**: Бейдж рынка (отдельная строка) **Элементы:** + - **Аватар**: Размер xs, слева с gap-2 - **Текст**: text-xs для компактности - **Отступы**: mb-1 между строками 1-2, mb-0.5 между строками 2-3 - **Padding карточки**: 8px (p-2) **ЦВЕТОВАЯ СХЕМА РЫНКОВ:** + - **"Садовод"** (sadovod): Зеленый `bg-green-500/20 text-green-300 border-green-500/30` - **"ТЯК Москва"** (tyak-moscow): Синий `bg-blue-500/20 text-blue-300 border-blue-500/30` - **Другие/не указан**: Серый `bg-gray-500/20 text-gray-300 border-gray-500/30` **ДОСТУПНОСТЬ:** + - `role="tablist"` для контейнера - `role="tab"` для карточек - `aria-selected="true/false"` для выбранной карточки @@ -1136,12 +1247,14 @@ const handleSuppliesClick = () => { #### **9.2.2 Правила блока "Карточки товаров" (Блок 2)** **НАЗНАЧЕНИЕ И ЛОГИКА:** + - **Источник данных**: Товары выбранного поставщика из Блока 1 - **Триггер отображения**: Клик на карточку поставщика → загрузка карточек товаров - **Взаимодействие**: Клик на карточку товара → добавление в Блок 3 "Товары поставщика" - **Поведение**: Горизонтальный скролл при множестве товаров **АРХИТЕКТУРА И РАЗМЕРЫ:** + - **Внешний контейнер**: bg-white/10 backdrop-blur-xl border border-white/20 rounded-2xl flex-shrink-0 - **Внутренний контейнер скролла**: flex gap-3 overflow-x-auto p-4 - **Стилизация скролла**: scrollbarWidth: 'thin' для тонкой полосы прокрутки @@ -1151,10 +1264,12 @@ const handleSuppliesClick = () => { - **БЕЗ заголовков/иконок**: только чистые карточки товаров в контейнере **РАЗМЕРЫ КАРТОЧЕК ТОВАРОВ:** + - **Компактная карточка**: 80×112px (w-20 h-28), соотношение 5:7 - **Адаптивность**: фиксированный размер для всех устройств **СОДЕРЖАНИЕ КАРТОЧКИ ТОВАРА:** + - **ТОЛЬКО изображение товара**: 80×112px, object-cover - **Минималистичный дизайн**: БЕЗ текста, названий, цен, иконок - **Состояния**: Default, Selected, Active (БЕЗ Hover-эффектов) @@ -1167,6 +1282,7 @@ const handleSuppliesClick = () => { #### **9.2.3 Правила Блока 3 "Детальный каталог товаров"** **НАЗНАЧЕНИЕ И СТРУКТУРА:** + - **Контент**: Детальные карточки выбранных товаров с полным управлением - **Верхняя панель**: Выбор даты + Выбор Fulfillment + Поиск - **Основная область**: Сетка карточек товаров с детальной информацией @@ -1174,19 +1290,21 @@ const handleSuppliesClick = () => { #### **9.2.3.1 Структура верхней панели Блока 3** **МИНИМАЛИСТИЧНАЯ ПАНЕЛЬ УПРАВЛЕНИЯ:** + - **Выбор даты поставки**: DatePicker для планирования поставки -- **Выбор Fulfillment-центра**: Select dropdown со списком доступных фулфилментов +- **Выбор Fulfillment-центра**: Select dropdown со списком доступных фулфилментов - **Поиск по товарам**: Input с иконкой поиска и placeholder - **Компоновка**: Горизонтальная строка с равномерным распределением **ТЕХНИЧЕСКИЕ ТРЕБОВАНИЯ:** + ```tsx // Структура компонентов панели