docs: закрепление модульной архитектуры как официального стандарта

- MODULAR_ARCHITECTURE_PATTERN.md помечен как ОФИЦИАЛЬНЫЙ СТАНДАРТ АРХИТЕКТУРЫ
- Добавлены обязательные правила для компонентов >500 строк в новых и >800 строк в существующих
- Обновлен CLAUDE.md с автоматической активацией правил архитектуры
- Зафиксированы статусы завершенных рефакторингов (create-suppliers-supply-page.tsx, direct-supply-creation.tsx)
- Обновлен current-session.md с контекстом архитектурного стандарта

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Veronika Smirnova
2025-08-12 21:37:23 +03:00
parent 6647299a05
commit 6a148f7706
3 changed files with 33 additions and 6 deletions

View File

@ -6,6 +6,7 @@
- **`rules-complete.md`** - основные бизнес-правила (ВСЕГДА читать первым) - **`rules-complete.md`** - основные бизнес-правила (ВСЕГДА читать первым)
- **`workflow-catalog.md`** - каталог всех бизнес-процессов системы - **`workflow-catalog.md`** - каталог всех бизнес-процессов системы
- **`MODULAR_ARCHITECTURE_PATTERN.md`** - ОБЯЗАТЕЛЬНАЯ архитектура для новых компонентов >500 строк
### Специфичные правила по кабинетам: ### Специфичные правила по кабинетам:
@ -27,6 +28,7 @@
- Упоминание "селлер", "seller", "/supplies", "/my-supplies" → читать seller-ui-rules.md - Упоминание "селлер", "seller", "/supplies", "/my-supplies" → читать seller-ui-rules.md
- Упоминание "workflow", "процесс", "этап", "статус" → читать workflow-catalog.md - Упоминание "workflow", "процесс", "этап", "статус" → читать workflow-catalog.md
- Упоминание "дизайн", "UI", "компонент", "стиль" → читать visual-design-rules.md - Упоминание "дизайн", "UI", "компонент", "стиль" → читать visual-design-rules.md
- Упоминание "компонент", "создание", "dashboard", ">500 строк", "архитектура" → читать MODULAR_ARCHITECTURE_PATTERN.md
## 🚨 ЕДИНСТВЕННЫЙ ИСТОЧНИК ПРАВИЛ ## 🚨 ЕДИНСТВЕННЫЙ ИСТОЧНИК ПРАВИЛ
@ -47,9 +49,10 @@
1. **Читать `rules-complete.md`** - перед любым изменением кода 1. **Читать `rules-complete.md`** - перед любым изменением кода
2. **Следовать правилам взаимодействия** - см. [interaction-integrity-rules.md](./interaction-integrity-rules.md) 2. **Следовать правилам взаимодействия** - см. [interaction-integrity-rules.md](./interaction-integrity-rules.md)
3. **Проверить специфичные правила кабинета** - если работа с конкретным типом организации 3. **Проверить специфичные правила кабинета** - если работа с конкретным типом организации
4. **Использовать TodoWrite** - для планирования задач 4. **Проверить архитектурные требования** - для компонентов >500 строк читать MODULAR_ARCHITECTURE_PATTERN.md
5. **Следовать техническим правилам** - GraphQL, TypeScript, система партнерства 5. **Использовать TodoWrite** - для планирования задач
6. **Проверять реализацию** - соответствие правилам и архитектуре 6. **Следовать техническим правилам** - GraphQL, TypeScript, система партнерства
7. **Проверять реализацию** - соответствие правилам и архитектуре
## 📋 КЛЮЧЕВЫЕ ПРИНЦИПЫ ## 📋 КЛЮЧЕВЫЕ ПРИНЦИПЫ

View File

@ -1,6 +1,20 @@
# 🏗️ Паттерн модульной архитектуры для React компонентов # 🏗️ Паттерн модульной архитектуры для 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 3052 строки - timesheet-demo.tsx
2012 строк - fulfillment-warehouse-dashboard.tsx 2012 строк - fulfillment-warehouse-dashboard.tsx
1654 строки - navigation-demo.tsx 1654 строки - navigation-demo.tsx
1637 строк - direct-supply-creation.tsx ← Следующий кандидат 1637 строк - direct-supply-creation.tsx ✅ ЗАВЕРШЕН (модульная архитектура)
1563 строки - user-settings.tsx 1563 строки - user-settings.tsx
1523 строки - advertising-tab.tsx 1523 строки - advertising-tab.tsx
1304 строки - wb-product-cards.tsx 1304 строки - wb-product-cards.tsx

View File

@ -10,7 +10,7 @@
### Текущая задача: ### Текущая задача:
- **Что делаем**: ✅ МАСШТАБНЫЙ РЕФАКТОРИНГ МОДУЛЬНОЙ АРХИТЕКТУРЫ (ЗАВЕРШЕНО) - **Что делаем**: ✅ ЗАКРЕПЛЕНИЕ АРХИТЕКТУРНОГО СТАНДАРТА (ЗАВЕРШЕНО)
- **Статус**: Полностью завершена - **Статус**: Полностью завершена
- **Начато**: 2025-08-12 - **Начато**: 2025-08-12
- **Завершено**: 2025-08-12 - **Завершено**: 2025-08-12
@ -30,6 +30,16 @@
- Удаление старого файла (-1,474 строки) - Удаление старого файла (-1,474 строки)
- Оптимизация производительности с useCallback - Оптимизация производительности с 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 строк
### Очередь задач: ### Очередь задач: