docs: обновление архитектурной документации и модульного рефакторинга

- Обновлен CLAUDE.md с новыми правилами системы - Дополнен workflow-catalog.md с процессами - Обновлены interaction-integrity-rules.md - Завершен модульный рефакторинг create-suppliers компонента - Добавлен модульный user-settings с блочной архитектурой - Система готова к следующему этапу архитектурных улучшений 🚀 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-13 13:19:11 +03:00
parent 7da70f96e1
commit 5fd92aebfc
24 changed files with 3585 additions and 69 deletions
--- a/workflow-catalog.md
+++ b/workflow-catalog.md
@ -8,8 +8,9 @@
 ## 📋 **ОГЛАВЛЕНИЕ**

 ### Основные процессы:
+
 - [1. Workflow поставок](#1-workflow-поставок) - 8 статусов, 6 этапов
- [2. Процесс создания продукта](#2-процесс-создания-продукта) - 5 шагов с SLA  
+- [2. Процесс создания продукта](#2-процесс-создания-продукта) - 5 шагов с SLA
 - [3. UI процессы селлера](#3-ui-процессы-селлера) - 4-блочная система
 - [4. Workflow фулфилмента](#4-workflow-фулфилмента) - 3 этапа обработки
 - [5. Workflow логистики](#5-workflow-логистики) - 4 этапа доставки
@ -18,12 +19,14 @@
 - [8. Критические ситуации](#8-критические-ситуации) - отмены и чрезвычайные

 ### Вспомогательные процессы:
+
 - [9. Протоколы разработки](#9-протоколы-разработки) - последовательность работы
 - [10. Система учета движения товаров](#10-система-учета-движения-товаров)

 ### Индекс по ролям:
+
 - **Селлер**: процессы 1, 2, 3, 6
- **Поставщик**: процессы 1, 6  
+- **Поставщик**: процессы 1, 6
 - **Фулфилмент**: процессы 1, 2, 4, 7
 - **Логистика**: процессы 1, 5

@ -102,39 +105,44 @@
 **ПРЕДВАРИТЕЛЬНОЕ УСЛОВИЕ**: Рецептура задана селлером

 **ШАГ 1: Поступление на склад (автоматически)**
+
 - Товар поступает на склад фулфилмента
 - Система фиксирует поступление
 - Товар получает статус "доступен для обработки"

 **ШАГ 2: Планирование работы (менеджер фулфилмента)**
+
 - Менеджер фулфилмента видит товар в интерфейсе
 - Планирует обработку согласно рецептуре
 - Назначает исполнителя

 **ШАГ 3: Обработка товара (исполнитель)**
+
 - Исполнитель берет товар в работу
 - Применяет услуги согласно рецептуре
 - Использует расходники селлера и фулфилмента
 - Товар превращается в продукт

 **ШАГ 4: Контроль качества (менеджер/отдел качества)**
+
 - Проверка соответствия рецептуре
 - Контроль качества обработки
 - Подтверждение или возврат на доработку

 **ШАГ 5: Завершение (система + менеджер)**
+
 - Система создает запись о готовом продукте
 - Продукт получает статус FINISHED_PRODUCT
 - Готов к отправке селлеру

 ### 2.2 Временные рамки и SLA

-| Этап | Время выполнения | Ответственный | KPI |
-|------|------------------|---------------|-----|
-| Поступление | Мгновенно | Система | 100% автоматизация |
-| Планирование | До 2 часов | Менеджер ФФ | 95% в срок |
-| Обработка | 1-3 дня | Исполнитель | Согласно сложности |
-| Контроль | До 4 часов | ОТК | 99% точность |
+| Этап         | Время выполнения | Ответственный | KPI                |
+| ------------ | ---------------- | ------------- | ------------------ |
+| Поступление  | Мгновенно        | Система       | 100% автоматизация |
+| Планирование | До 2 часов       | Менеджер ФФ   | 95% в срок         |
+| Обработка    | 1-3 дня          | Исполнитель   | Согласно сложности |
+| Контроль     | До 4 часов       | ОТК           | 99% точность       |

 ### 2.3 Детальная рецептура продукта

@ -967,7 +975,8 @@ const handleQuantityChange = (e: React.ChangeEvent<HTMLInputElement>) => {
 - Единые стили для всех корзин в системе
 - Одинаковое поведение auto-add во всех формах
 - Синхронная валидация данных
-```
+
+````

 **ДЕФОЛТНОЕ ЗНАЧЕНИЕ**: Пустой инпут (`value={''}`) вместо `value={0}`

@ -1024,7 +1033,7 @@ const getProductTotalWithRecipe = (productId: string, quantity: number) => {

  return total
 }
-```
+````

 ### 3.4 Высота основного блока и функционал

@ -1203,11 +1212,13 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins);
 ### 4.2 Движение товаров

 **Поступление товаров**:
+
 - **ПОСТАВКИ**: От поставщиков через систему заказов
 - **ВОЗВРАТЫ**: Товары, возвращенные с ПВЗ
 - **ПЕРЕМЕЩЕНИЯ**: Между складами и магазинами

 **Расход товаров**:
+
 - **ОТГРУЗКА**: Товары отправлены селлерам
 - **СПИСАНИЕ**: Брак, утрата, утилизация
 - **ВОЗВРАТ**: Возврат поставщику
@ -1322,21 +1333,25 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins);
 ### 8.1 Отмена заказов на разных этапах

 **ТИП 1: Отмена до подтверждения поставщиком**
+
 - Селлер может отменить заказ в статусе PENDING
 - Система меняет статус на CANCELLED
 - Уведомление поставщику об отмене

 **ТИП 2: Отмена после подтверждения поставщиком**
+
 - Требуется согласие поставщика
 - Возможны штрафные санкции
 - Согласование через мессенджер

 **ТИП 3: Отмена во время транспортировки**
+
 - Связь с логистикой для возврата груза
 - Дополнительные транспортные расходы
 - Перерасчет стоимости

 **ТИП 4: Отмена после доставки**
+
 - Процедура возврата товара
 - Контроль качества возвращаемого товара
 - Возмещение понесенных расходов
@ -1344,21 +1359,25 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins);
 ### 8.2 Алгоритм частичной доставки

 **ШАГ 1: Выявление недостачи**
+
 - Фулфилмент сверяет план и факт
 - Фиксирует недостающие позиции
 - Уведомляет всех участников

 **ШАГ 2: Принятие решения**
+
 - Селлер выбирает: ждать доставку или принять частично
 - Поставщик объясняет причины недостачи
 - Согласование дальнейших действий

 **ШАГ 3: Обработка частичной доставки**
+
 - Система разделяет заказ на выполненную и невыполненную части
 - Перерасчет стоимости и логистики
 - Создание нового заказа на недостающее

 **ШАГ 4: Документооборот**
+
 - Корректировка документов
 - Фиксация фактических показателей
 - Закрытие или продление заказа
@ -1371,7 +1390,7 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins);

 ### 9.1 7-шаговый workflow разработки

-1. **Читать rules-complete.md** - перед любым изменением кода
+1. **При необходимости обратиться к rules-complete.md** - для справки по бизнес-правилам
 2. **Следовать правилам взаимодействия** - честность и прозрачность
 3. **Проверить специфичные правила кабинета** - если работа с конкретным типом организации
 4. **Использовать TodoWrite** - для планирования задач
@ -1396,26 +1415,31 @@ height: calc(100vh - headerHeight - tabsHeight - statsHeight - margins);
 ### 10.1 Принципы учета

 **ПРИНЦИП 1: Полная прозрачность**
+
 - Каждое движение товара фиксируется
 - Доступна история всех операций
 - Отчетность в реальном времени

 **ПРИНЦИП 2: Двойной контроль**
+
 - План и факт сверяются системой
 - Выявление и анализ расхождений
 - Автоматические уведомления об отклонениях

 **ПРИНЦИП 3: Статусная модель**
+
 - Каждый товар имеет четкий статус
 - Переходы между статусами контролируются
 - История изменений сохраняется

 **ПРИНЦИП 4: Интеграция ролей**
+
 - Каждая роль видит релевантную информацию
 - Права доступа разграничены по функциям
 - Совместная работа через единую систему

 **ПРИНЦИП 5: Автоматизация**
+
 - Минимум ручного ввода данных
 - Автоматические расчеты и уведомления
 - Система предотвращения ошибок
@ -1769,6 +1793,7 @@ const handleSuppliesClick = () => {
 ## 📊 **СТАТИСТИКА ПРОЦЕССОВ**

 ### По объему (строки):
+
 - **UI процессы селлера**: ~942 строки (самый объемный)
 - **Процесс создания продукта**: ~175 строк (самый детализированный)
 - **Категории товаров и расходников**: ~141 строка (классификационная система)
@ -1780,13 +1805,15 @@ const handleSuppliesClick = () => {
 - **Workflow фулфилмента**: ~20 строк

 ### По ролям:
+
 - **Селлер**: 6 процессов
- **Поставщик**: 5 процессов  
+- **Поставщик**: 5 процессов
 - **Фулфилмент**: 5 процессов
 - **Логистика**: 3 процесса
 - **Универсальные**: 3 процесса

 ### По критичности:
+
 - **Критические**: Workflow поставок, Создание продукта, РЫНОК vs МАРКЕТ
 - **Важные**: UI процессы, Категории товаров, Общие правила кабинетов
 - **Вспомогательные**: Система партнерства, Учет движения, Протоколы разработки
@ -1801,6 +1828,7 @@ const handleSuppliesClick = () => {
 ✅ **СТАТУС**: ПОЛНОСТЬЮ ЗАПОЛНЕН - все ключевые процессы добавлены

 **Связанные файлы**:
+
 - [rules-complete.md](./rules-complete.md) - Основной файл с бизнес-правилами
 - [interaction-integrity-rules.md](./interaction-integrity-rules.md) - Методология работы
- [visual-design-rules.md](./visual-design-rules.md) - Визуальные правила
+- [visual-design-rules.md](./visual-design-rules.md) - Визуальные правила