sfera/CLAUDE.md

# СИСТЕМНЫЕ ПРАВИЛА ДЛЯ CLAUDE CODE

## 📚 ФАЙЛЫ ПРАВИЛ СИСТЕМЫ

### Обязательные для чтения:

- **`rules-complete.md`** - основные бизнес-правила (ВСЕГДА читать первым)
- **`workflow-catalog.md`** - каталог всех бизнес-процессов системы

### Специфичные правила по кабинетам:

- **`wholesale-cabinet-rules.md`** - при работе с кабинетом поставщика
- **`logist-cabinet-rules.md`** - при работе с кабинетом логистики
- **`fulfillment-cabinet-rules.md`** - при работе с кабинетом фулфилмента
- **`seller-ui-rules.md`** - при работе с UI/UX кабинета селлера
- **`visual-design-rules.md`** - при работе с UI/UX

### Правила взаимодействия:

- **`interaction-integrity-rules.md`** - детальная методология работы (честность, прозрачность, неизменность планов, каноническая последовательность)

### Автоматическая активация:

- Упоминание "поставщик", "wholesale", "/warehouse", "/supplier-orders" → читать wholesale-cabinet-rules.md
- Упоминание "логистика", "доставка", "logist", "/logistics-requests", "/routes" → читать logist-cabinet-rules.md
- Упоминание "фулфилмент", "fulfillment", "/services", "/employees" → читать fulfillment-cabinet-rules.md
- Упоминание "селлер", "seller", "/supplies", "/my-supplies" → читать seller-ui-rules.md
- Упоминание "workflow", "процесс", "этап", "статус" → читать workflow-catalog.md
- Упоминание "дизайн", "UI", "компонент", "стиль" → читать visual-design-rules.md

## 🚨 ЕДИНСТВЕННЫЙ ИСТОЧНИК ПРАВИЛ

**КРИТИЧЕСКИ ВАЖНО:** Общие правила системы находятся в файле **`rules-complete.md`** - это основной источник истины.

❌ **НЕ СУЩЕСТВУЕТ:**

- development-checklist.md (удален)
- rules.md (удален)
- rules1.md (удален)
- rules2.md (удален)
- CLAUDE.md устаревших версий

## 🎯 WORKFLOW РАЗРАБОТКИ

### Обязательный порядок действий:

1. **Читать `rules-complete.md`** - перед любым изменением кода
2. **Следовать правилам взаимодействия** - см. [interaction-integrity-rules.md](./interaction-integrity-rules.md)
3. **Проверить специфичные правила кабинета** - если работа с конкретным типом организации
4. **Использовать TodoWrite** - для планирования задач
5. **Следовать техническим правилам** - GraphQL, TypeScript, система партнерства
6. **Проверять реализацию** - соответствие правилам и архитектуре

## 📋 КЛЮЧЕВЫЕ ПРИНЦИПЫ

> ⚠️ **ВАЖНО**: Все детальные правила взаимодействия и поведенческие принципы перенесены в **[interaction-integrity-rules.md](./interaction-integrity-rules.md)**

### Основные принципы разработки:

1. **НЕ ПРЕДПОЛАГАТЬ** - всегда уточнять при сомнениях
2. **ПРОВЕРЯТЬ СХЕМЫ** - GraphQL и Prisma должны соответствовать коду
3. **СЛЕДОВАТЬ WORKFLOW** - не нарушать последовательность статусов
4. **ДОКУМЕНТИРОВАТЬ** - обновлять rules-complete.md при решениях проблем

### ⚡ Принципы качества кода:

- **Качество кода важнее скорости** - лучше потратить время на правильное решение
- **Pre-commit hooks существуют для защиты проекта** - никогда не обходить их
- **Исправлять ошибки, а не обходить их** - каждая ошибка ESLint должна быть исправлена
- **Обход проверок создает технический долг** - `--no-verify` использовать только в крайних случаях
- **Профессиональный подход к конфигурации** - точная настройка инструментов, не "заметание под ковер"

> 📋 **Подробные правила**: см. разделы 1.2-1.3 в [interaction-integrity-rules.md](./interaction-integrity-rules.md#12--принципы-качества-кода)

### Правила взаимодействия (кратко):

- **Двухэтапный процесс**: Планирование → Одобрение → Выполнение
- **Неизменность планов**: согласованные планы нельзя менять без разрешения
- **Честность и прозрачность**: открыто сообщать о неопределенностях
- **Протоколы по сложности**: для каждого типа задач свой подход

## 🔧 КОМАНДЫ ПРОВЕРКИ КОДА

### Обязательные команды после изменений:

```bash
# TypeScript проверка типов
npm run typecheck

# Проверка линтером
npm run lint

# Запуск тестов
npm test

# Dev сервер для проверки работы
npm run dev
```

> ⚠️ **ВАЖНО**: Всегда выполнять эти команды перед завершением задачи!

## 🔄 КОМАНДЫ ОТКАТА

### Откат через комментарии:

**Основная команда:**

```
"откати [описание] через комментарии"
```

**Примеры:**

- `"откати центрирование поиска через комментарии"`
- `"откати изменения кнопки через комментарии"`
- `"откати новую логику через комментарии"`

**Дополнительные команды:**

- `"очисти комментарии"` - удалить закомментированные варианты
- `"переключи на вариант 2"` - активировать закомментированный код
- `"покажи варианты"` - показать доступные варианты

> 📖 **Подробнее**: см. раздел 6.4 в `interaction-integrity-rules.md`

## 💾 РАБОТА С КОНТЕКСТОМ

### Файлы для сохранения контекста:

- **`current-session.md`** - текущая сессия работы (активные задачи, решения, контекст)
- **`CLAUDE.md`** - системные правила и команды (этот файл)
- **TodoWrite инструмент** - для планирования и отслеживания задач

### При потере контекста:

1. **Первым делом прочитать**: `current-session.md`
2. **Проверить статус задач**: через TodoWrite
3. **Восстановить контекст**: из истории изменений в current-session.md

### Рекомендации для длинных сессий:

- Обновлять `current-session.md` после каждой важной задачи
- Фиксировать принятые решения и обоснования
- Документировать обнаруженные проблемы и их решения
- Использовать `--resume` флаг для продолжения сессий

## 🚨 НАПОМИНАНИЕ

**Этот файл служит для корректной работы system-reminder'ов. Все детальные правила находятся в `rules-complete.md`!**