# Tutorials - Обучающие материалы BQuant

## 📚 Обзор

Обучающие материалы помогут вам освоить BQuant от базовых концепций до продвинутых техник.

## 🎓 Содержание

### 🚀 Быстрый старт (5 минут) - Универсальный анализ зон
- **7 разделов:** MACD, RSI, AO, пересечение скользящих средних, предзагруженные зоны, кэширование, модульное использование
- **Универсальный API:** демонстрация fluent builder для всех индикаторов
- **Ноль дублирования кода:** таблица сравнения индикаторов без копирования
- **297 строк** готового к продакшену кода

### 📊 Глубокое погружение (30 минут) - Полный конвейер анализа
- **10 шагов NotebookSimulator:** от загрузки данных до модульных сценариев
- **Сравнение старого и нового API:** производительность и функциональность
- **Эксперименты со стратегиями детекции:** все 5 типов стратегий
- **Анализ чувствительности параметров:** влияние настроек на качество зон
- **Полный анализ-пайплайн:** признаки, кластеризация, статистические тесты, анализ последовательностей
- **412 строк** всестороннего анализа

### 🔬 Продвинутые возможности - Свинг, дивергенции, регрессия
- **10 шагов:** от базового анализа до регрессии и валидации
- **Свинг-стратегии:** FindPeaks, PivotPoints, ZigZag (все три работают!)
- **Расширенные возможности:** анализ дивергенций, объёма, волатильности
- **Миграция на v2.1:** полный переход с устаревшего API
- **Автоматизация статистических гипотез:** тесты внутри конвейера

### 🔄 Руководство по миграции - Старый и новый API
- **Legacy vs New API:** сравнение старого и нового подходов
- **Предупреждения об устаревании:** демонстрация предупреждений
- **Сравнение производительности:** время выполнения и использование памяти
- **Несколько стратегий:** zero_crossing, line_crossing, комбинированные правила
- **241 строка** примеров миграции

## 🧭 Пошаговые tutorials (v2.1)

- **[MACD zones (Пример 1)](macd_basic_pipeline.md)** — базовый pipeline и визуализация результатов с `ZoneVisualizer`.
- **[RSI zones (Пример 5)](rsi_strategy_switching.md)** — демонстрация смены стратегий `threshold` → `line_crossing` без повторного расчёта индикатора.
- **[Combined Rules (Пример 8)](combined_rules_detection.md)** — конфигурация `CombinedRulesDetection` с AND/OR логикой и ручной отладкой.
- **[Preloaded зоны (Пример 3 + Сценарий 9)](preloaded_zones_workflow.md)** — работа с внешними CSV, `load_preloaded_zones()` и сравнительный анализ экспертов против автоматических стратегий.

### 🏗️ [Будущие учебные материалы (TODO)] - План
- **Разработка собственных стратегий** - создание пользовательских правил детекции
- **Шаблоны интеграции с ML** - взаимодействие с моделями машинного обучения
- **Оптимизация производительности** - повышение скорости и эффективности
- **Развёртывание в продакшене** - переход из исследований в эксплуатацию

## 🎯 Целевая аудитория

### 👶 Начинающие
- **Быстрый старт** - основы универсального API
- **Руководство по миграции** - переход со старого API

### 👨‍💻 Продвинутые пользователи
- **Глубокое погружение** - полный конвейер анализа
- **Продвинутые возможности** - свинг, дивергенции, регрессия

### 🚀 Эксперты
- **Будущие учебные материалы** - пользовательские стратегии, интеграция с ML
- **Оптимизация производительности** - вывод решений в продакшен

## 📋 Предварительные требования

### Базовые знания
- Python 3.8+
- Pandas и NumPy
- Основы статистики
- Финансовые данные (OHLCV)

### Установка
```bash
pip install bquant
```

## 🚀 Рекомендуемый порядок изучения

### Траектория изучения архитектуры
1. **[Быстрый старт](../../examples/02a_universal_zones.py)** - основы универсального API → паттерн Fluent Builder
2. **[Глубокое погружение](../../research/notebooks/03_zones_universal.py)** - полное понимание → двухслойная архитектура
3. **[Продвинутые возможности](../../research/notebooks/03_analysis_new_features.py)** - расширенные функции → конфигурация стратегий
4. **[Руководство по миграции](../../examples/02_macd_zone_analysis.py)** - переход с legacy → шаблоны устаревания

## 💡 Советы по изучению

### 🎯 Практический подход
- **Выполняйте все примеры** - Не просто читайте, а запускайте код
- **Экспериментируйте** - Изменяйте параметры и наблюдайте результаты
- **Используйте sample данные** - Для безопасных экспериментов
- **Ведите заметки** - Записывайте важные моменты

### 🔧 Технические советы
- **Используйте Jupyter Notebooks** - Для интерактивного изучения
- **Создайте виртуальное окружение** - Для изоляции зависимостей
- **Изучайте ошибки** - Они помогают понять систему
- **Задавайте вопросы** - Используйте GitHub Issues

### 📚 Дополнительные ресурсы
- **[Справочник API](../api/)** - подробная документация
- **[Примеры](../examples/)** - готовые сценарии
- **[Руководство пользователя](../user_guide/)** - последовательное обучение

## 🎓 Структура каждого tutorial

Каждый tutorial содержит:

### 📖 Теория
- Объяснение концепций
- Математические основы
- Принципы работы

### 💻 Практика
- Пошаговые примеры
- Готовый код
- Интерактивные упражнения

### 🔍 Анализ
- Интерпретация результатов
- Лучшие практики
- Типичные ошибки

### 🚀 Следующие шаги
- Продолжение изучения
- Дополнительные ресурсы
- Практические задания

## 🤝 Поддержка

### Если что-то не работает
1. **Проверьте версии** - Убедитесь в совместимости
2. **Изучите ошибки** - Читайте сообщения об ошибках
3. **Создайте issue** - На GitHub с подробным описанием

### Если нужна помощь
1. **GitHub Issues** - Для багов и проблем
2. **GitHub Discussions** - Для вопросов и обсуждений
3. **Documentation** - Изучите API Reference

## 🔗 Связанные разделы

- **[Руководство пользователя](../user_guide/)** - основное обучение
- **[Справочник API](../api/)** - подробности по модулям
- **[Примеры](../examples/)** - практические сценарии
- **[Руководство разработчика](../developer_guide/)** - расширение и вклад

---

**Начать изучение:** [Быстрый стартовый tutorial](../user_guide/quick_start.md) 🚀
