docs: обновление правил UI Kit и блока поставщиков + новые glass компоненты
- Добавлены правила анализа UI Kit компонентов (interaction-integrity-rules.md) - Обновлены правила блока 1: убран заголовок, добавлена кнопка навигации (rules-complete.md) - Детальная спецификация плавающей кнопки "Назад" (seller-ui-rules.md) - Новые компоненты: GlassDatePicker и GlassSelect для UI Kit - Улучшены hover/focus эффекты в DatePicker 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@ -139,6 +139,52 @@ ignores: ['diagnostic-script.js', 'legacy-config.js'] // конкретные ф
|
||||
- Планирую создать новые файлы вместо редактирования существующих
|
||||
```
|
||||
|
||||
### 1.5 🎯 ПРАВИЛА АНАЛИЗА ИСХОДНЫХ ПРИМЕРОВ
|
||||
|
||||
**КРИТИЧЕСКИ ВАЖНО**: При работе с существующими примерами кода или UI Kit компонентами:
|
||||
|
||||
#### 🔍 **ОБЯЗАТЕЛЬНЫЙ ТРЕХУРОВНЕВЫЙ АНАЛИЗ:**
|
||||
|
||||
1. **📋 СОДЕРЖАТЕЛЬНЫЙ АНАЛИЗ** (что делает код):
|
||||
- Функциональность компонента
|
||||
- Логика работы
|
||||
- Данные и состояния
|
||||
|
||||
2. **🏗️ АРХИТЕКТУРНЫЙ АНАЛИЗ** (как организован код):
|
||||
- Структура компонентов и контейнеров
|
||||
- Взаимосвязи между элементами
|
||||
- Позиционирование и layout
|
||||
- Иерархия DOM-элементов
|
||||
|
||||
3. **🎨 СТИЛЕВОЙ АНАЛИЗ** (как выглядит код):
|
||||
- CSS классы и стили
|
||||
- Анимации и переходы
|
||||
- Цвета и размеры
|
||||
|
||||
#### ❌ **ТИПИЧНЫЕ ОШИБКИ АНАЛИЗА:**
|
||||
|
||||
- **Поверхностный анализ**: Копирование только стилей без понимания архитектуры
|
||||
- **Игнорирование контекста**: Непонимание места элемента в общей структуре
|
||||
- **Буквальное копирование**: Применение решения без адаптации к текущей задаче
|
||||
|
||||
#### ✅ **ПРАВИЛЬНЫЙ ПОДХОД:**
|
||||
|
||||
```
|
||||
🔬 АЛГОРИТМ АНАЛИЗА ПРИМЕРА:
|
||||
1. Прочитать ВЕСЬ код компонента-примера
|
||||
2. Понять АРХИТЕКТУРУ: где элемент размещен относительно других
|
||||
3. Понять ЛОГИКУ: почему именно так структурировано
|
||||
4. Адаптировать к ТЕКУЩЕЙ ЗАДАЧЕ: применить принципы, а не просто скопировать
|
||||
5. Проверить СООТВЕТСТВИЕ правилам проекта
|
||||
```
|
||||
|
||||
#### 🚨 **СТОП-ВОПРОСЫ ПЕРЕД РЕАЛИЗАЦИЕЙ:**
|
||||
|
||||
- "Понимаю ли я **архитектуру** этого решения?"
|
||||
- "Где именно должен располагаться элемент в **общей структуре**?"
|
||||
- "Какова **семантическая роль** этого элемента?"
|
||||
- "Как это решение **адаптируется** к моей текущей задаче?"
|
||||
|
||||
---
|
||||
|
||||
## 🔄 II. ПРОЦЕДУРНЫЙ УРОВЕНЬ: ПОСЛЕДОВАТЕЛЬНОСТИ ДЕЙСТВИЙ
|
||||
@ -563,9 +609,69 @@ ignores: ['diagnostic-script.js', 'legacy-config.js'] // конкретные ф
|
||||
|
||||
---
|
||||
|
||||
## 📚 VIII. ИЗВЛЕЧЕННЫЕ УРОКИ И АНТИ-ПАТТЕРНЫ
|
||||
|
||||
### 8.1 🚨 КРИТИЧЕСКИЕ ОШИБКИ В АНАЛИЗЕ UI КОМПОНЕНТОВ
|
||||
|
||||
#### **CASE STUDY: Ошибка с плавающей кнопкой из UI Kit**
|
||||
|
||||
**❌ ОШИБКА**: При добавлении кнопки "🌟 Вариант 1: Плавающая кнопка слева" из UI Kit:
|
||||
|
||||
1. **Поверхностный анализ**: Скопировал только стили кнопки
|
||||
2. **Игнорирование архитектуры**: Не заметил, что кнопка в **отдельном контейнере**
|
||||
3. **Неправильное размещение**: Добавил как часть блока контента
|
||||
4. **Непонимание термина**: "Плавающая" = независимая от контента, между элементами
|
||||
|
||||
**✅ ПРАВИЛЬНОЕ РЕШЕНИЕ**:
|
||||
|
||||
```tsx
|
||||
// ❌ НЕПРАВИЛЬНО - кнопка внутри блока контента
|
||||
<div className="content-block relative">
|
||||
<button className="absolute...">Назад</button>
|
||||
<div className="actual-content">...</div>
|
||||
</div>
|
||||
|
||||
// ✅ ПРАВИЛЬНО - кнопка в отдельном контейнере
|
||||
<div className="flex gap-4">
|
||||
<Sidebar />
|
||||
<div className="relative"> {/* Отдельный контейнер */}
|
||||
<button className="absolute...">Назад</button>
|
||||
</div>
|
||||
<div className="content-block">...</div>
|
||||
</div>
|
||||
```
|
||||
|
||||
#### **📋 ОБЯЗАТЕЛЬНЫЙ ЧЕКЛИСТ ДЛЯ UI KIT КОМПОНЕНТОВ:**
|
||||
|
||||
```
|
||||
🔍 ПЕРЕД РЕАЛИЗАЦИЕЙ:
|
||||
□ Прочитал ВЕСЬ код компонента-примера
|
||||
□ Понял архитектуру размещения в layout
|
||||
□ Определил семантическую роль элемента
|
||||
□ Понял взаимосвязи с соседними элементами
|
||||
□ Адаптировал принципы к текущей задаче
|
||||
□ Проверил соответствие правилам проекта
|
||||
```
|
||||
|
||||
#### **⚡ АНТИ-ПАТТЕРНЫ:**
|
||||
|
||||
- **"Быстрое копирование"** - копировать стили без понимания архитектуры
|
||||
- **"Частичный анализ"** - читать только нужную часть кода
|
||||
- **"Буквальное применение"** - использовать без адаптации к контексту
|
||||
- **"Игнорирование контейнеров"** - не обращать внимание на DOM-структуру
|
||||
|
||||
#### **✅ ПРАВИЛЬНЫЕ ПАТТЕРНЫ:**
|
||||
|
||||
- **"Архитектурный анализ первым"** - понять структуру, потом стили
|
||||
- **"Контекстная адаптация"** - применять принципы, а не код буквально
|
||||
- **"Семантическое понимание"** - осознавать роль каждого элемента
|
||||
- **"Итеративная проверка"** - сверяться с примером на каждом шаге
|
||||
|
||||
---
|
||||
|
||||
**Дата создания**: Декабрь 2024
|
||||
**Последнее обновление**: Август 2025
|
||||
**Версия**: 3.0 - ПОЛНАЯ РЕСТРУКТУРИЗАЦИЯ
|
||||
**Версия**: 3.1 - ДОПОЛНЕНЫ ПРАВИЛА АНАЛИЗА UI KIT
|
||||
**Статус**: АКТИВЕН - ОБЯЗАТЕЛЕН К ИСПОЛНЕНИЮ
|
||||
|
||||
**Связанные файлы**:
|
||||
|
Reference in New Issue
Block a user