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:
@ -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. **Проверять реализацию** - соответствие правилам и архитектуре
|
||||
|
||||
## 📋 КЛЮЧЕВЫЕ ПРИНЦИПЫ
|
||||
|
||||
|
@ -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
|
||||
|
@ -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 строк
|
||||
|
||||
### Очередь задач:
|
||||
|
||||
|
Reference in New Issue
Block a user