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:
Veronika Smirnova
2025-08-12 18:08:24 +03:00
parent c586ddc868
commit c5cd75cdb9
6 changed files with 323 additions and 8 deletions

View File

@ -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
**Статус**: АКТИВЕН - ОБЯЗАТЕЛЕН К ИСПОЛНЕНИЮ
**Связанные файлы**: