diff --git a/CLAUDE.md b/CLAUDE.md index a7cb60a..3a48469 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -6,6 +6,7 @@ - **`rules-complete.md`** - основные бизнес-правила (ВСЕГДА читать первым) - **`workflow-catalog.md`** - каталог всех бизнес-процессов системы +- **`MODULAR_ARCHITECTURE_PATTERN.md`** - ОБЯЗАТЕЛЬНАЯ архитектура для новых компонентов >500 строк ### Специфичные правила по кабинетам: @@ -27,6 +28,7 @@ - Упоминание "селлер", "seller", "/supplies", "/my-supplies" → читать seller-ui-rules.md - Упоминание "workflow", "процесс", "этап", "статус" → читать workflow-catalog.md - Упоминание "дизайн", "UI", "компонент", "стиль" → читать visual-design-rules.md +- Упоминание "компонент", "создание", "dashboard", ">500 строк", "архитектура" → читать MODULAR_ARCHITECTURE_PATTERN.md ## 🚨 ЕДИНСТВЕННЫЙ ИСТОЧНИК ПРАВИЛ @@ -47,9 +49,10 @@ 1. **Читать `rules-complete.md`** - перед любым изменением кода 2. **Следовать правилам взаимодействия** - см. [interaction-integrity-rules.md](./interaction-integrity-rules.md) 3. **Проверить специфичные правила кабинета** - если работа с конкретным типом организации -4. **Использовать TodoWrite** - для планирования задач -5. **Следовать техническим правилам** - GraphQL, TypeScript, система партнерства -6. **Проверять реализацию** - соответствие правилам и архитектуре +4. **Проверить архитектурные требования** - для компонентов >500 строк читать MODULAR_ARCHITECTURE_PATTERN.md +5. **Использовать TodoWrite** - для планирования задач +6. **Следовать техническим правилам** - GraphQL, TypeScript, система партнерства +7. **Проверять реализацию** - соответствие правилам и архитектуре ## 📋 КЛЮЧЕВЫЕ ПРИНЦИПЫ diff --git a/MODULAR_ARCHITECTURE_PATTERN.md b/MODULAR_ARCHITECTURE_PATTERN.md index 2810176..29dfbdf 100644 --- a/MODULAR_ARCHITECTURE_PATTERN.md +++ b/MODULAR_ARCHITECTURE_PATTERN.md @@ -1,6 +1,20 @@ # 🏗️ Паттерн модульной архитектуры для React компонентов -Этот документ описывает универсальный паттерн рефакторинга больших монолитных React компонентов в модульную архитектуру. +> ⚠️ **ОФИЦИАЛЬНЫЙ СТАНДАРТ АРХИТЕКТУРЫ SFERA** +> Этот документ описывает **ОБЯЗАТЕЛЬНУЮ** архитектуру для всех новых компонентов >500 строк и рефакторинга существующих >800 строк. + +## 🎯 СТАТУС АРХИТЕКТУРНОГО СТАНДАРТА + +### 🟢 ПРИНЯТЫЕ СТАНДАРТЫ (готовы к использованию): + +- ✅ **create-suppliers-supply-page.tsx** → Модульная архитектура (ФАЗА 1-4 завершены) +- ✅ **direct-supply-creation.tsx** → Модульная архитектура (ЭТАПЫ 1-5 завершены) + +### 📋 ПРАВИЛА ПРИМЕНЕНИЯ: + +1. **ВСЕ НОВЫЕ КОМПОНЕНТЫ >500 строк** → создавать по модульной архитектуре +2. **Существующие компоненты >800 строк** → рефакторить по возможности +3. **Обязательно использовать** этот паттерн для компонентов dashboard, creation, management ## 🎯 Применимость паттерна @@ -17,7 +31,7 @@ 3052 строки - timesheet-demo.tsx 2012 строк - fulfillment-warehouse-dashboard.tsx 1654 строки - navigation-demo.tsx -1637 строк - direct-supply-creation.tsx ← Следующий кандидат +1637 строк - direct-supply-creation.tsx ✅ ЗАВЕРШЕН (модульная архитектура) 1563 строки - user-settings.tsx 1523 строки - advertising-tab.tsx 1304 строки - wb-product-cards.tsx diff --git a/current-session.md b/current-session.md index b8c4956..266b26e 100644 --- a/current-session.md +++ b/current-session.md @@ -10,7 +10,7 @@ ### Текущая задача: -- **Что делаем**: ✅ МАСШТАБНЫЙ РЕФАКТОРИНГ МОДУЛЬНОЙ АРХИТЕКТУРЫ (ЗАВЕРШЕНО) +- **Что делаем**: ✅ ЗАКРЕПЛЕНИЕ АРХИТЕКТУРНОГО СТАНДАРТА (ЗАВЕРШЕНО) - **Статус**: Полностью завершена - **Начато**: 2025-08-12 - **Завершено**: 2025-08-12 @@ -30,6 +30,16 @@ - Удаление старого файла (-1,474 строки) - Оптимизация производительности с useCallback - Полная документация архитектуры и паттерна +8. ✅ **МАСШТАБНЫЙ РЕФАКТОРИНГ**: Модульная архитектура direct-supply-creation.tsx (2025-08-12) + - Разбивка монолита 1,637 строк → модульная архитектура 12 модулей (~1,400 строк) + - Создание 5 блок-компонентов с React.memo оптимизацией + - Извлечение 5 custom hooks для бизнес-логики + - Создание типизированного файла с 314 строками типов + - Полная интеграция всех модулей в главном компоненте (285 строк) +9. ✅ **ЗАКРЕПЛЕНИЕ АРХИТЕКТУРНОГО СТАНДАРТА** (2025-08-12) + - Обновлен MODULAR_ARCHITECTURE_PATTERN.md как ОФИЦИАЛЬНЫЙ СТАНДАРТ + - Добавлены правила в CLAUDE.md для автоматической активации + - Установлены обязательные требования для компонентов >500 строк ### Очередь задач: