SETTINGS_GUIDE.md

Руководство по управлению настройками

Обзор

В приложении Backtest Dashboard добавлена функциональность для сохранения и загрузки настроек фильтров и отображения. При первом запуске автоматически загружаются настройки из файла example_settings.json.

Автоматическая загрузка настроек по умолчанию

Что происходит при запуске:

• При первом запуске приложения автоматически загружаются настройки из example_settings.json
• Показывается уведомление: "🎯 Загружены настройки по умолчанию из example_settings.json"
• Настройки применяются ко всем фильтрам и параметрам отображения

Настройки по умолчанию включают:

• 10 топ-монет: XLM-USDT, BONK-USDT, HBAR-USDT, DOGE-USDT, SOL-USDT, SUI-USDT, ONDO-USDT, AAVE-USDT, AVAX-USDT, INJ-USDT
• 3 стратегии: CloudScalper2024, TemaTrendFollowing, AlligatorV2
• Период: май-июль 2025
• Тип графика: PNL по сделкам
• Колонки таблицы: все основные колонки
• Максимум строк: 100

Как использовать

1. Экспорт настроек

1. Настройте все фильтры и параметры отображения по своему усмотрению
2. Перейдите на вкладку "⚙️ Настройки"
3. В разделе "📤 Экспорт настроек" нажмите кнопку "💾 Скачать настройки"
4. Файл с настройками будет автоматически скачан в формате JSON

2. Импорт настроек

1. Перейдите на вкладку "⚙️ Настройки"
2. В разделе "📥 Импорт настроек" нажмите "Выберите JSON файл с настройками"
3. Выберите ранее сохраненный файл настроек
4. Нажмите кнопку "🔄 Применить настройки"
5. Страница автоматически обновится с примененными настройками

3. Предустановленные настройки

В разделе "🎯 Предустановленные настройки" доступны быстрые кнопки:

• 📈 Топ-стратегии - Показывает только 3 лучшие стратегии по PNL
• 💰 Топ-монеты - Показывает только 5 лучших монет по PNL
• 📅 Последний месяц - Устанавливает период на последние 30 дней
• 🎯 Настройки по умолчанию - Загружает example_settings.json

4. Сброс настроек

• В боковой панели есть кнопка "🗑️ Сбросить импортированные настройки" для очистки всех импортированных настроек

Формат файла настроек

Настройки сохраняются в JSON формате со следующей структурой:

{
  "selected_symbols": ["BTC-USDT", "ETH-USDT", "ADA-USDT"],
  "selected_strategies": ["CloudScalper2024", "TrendWaveRiderV2"],
  "start_date": "2024-09-01",
  "end_date": "2024-09-30",
  "chart_type": "Накопленный PNL",
  "show_columns": [
    "symbol", "strategy_name", "type", "entry_price", 
    "exit_price", "PNL", "PNL_percentage", "holding_period", "opened_at"
  ],
  "max_rows": 50,
  "export_timestamp": "2024-12-19T10:30:00.000000"
}

Что сохраняется

• selected_symbols - Выбранные символы (монеты)
• selected_strategies - Выбранные стратегии
• start_date - Начальная дата периода (YYYY-MM-DD)
• end_date - Конечная дата периода (YYYY-MM-DD)
• chart_type - Тип графика для отображения
• show_columns - Колонки для отображения в таблице
• max_rows - Максимальное количество строк в таблице
• export_timestamp - Время экспорта настроек

Примеры использования

Сценарий 1: Первый запуск

1. Запустите приложение
2. Настройки из example_settings.json загрузятся автоматически
3. Сразу увидите данные по топ-монетам и стратегиям

Сценарий 2: Анализ топ-стратегий

1. Настройте фильтры для анализа лучших стратегий
2. Экспортируйте настройки как "top_strategies.json"
3. В дальнейшем быстро загружайте эти настройки

Сценарий 3: Анализ конкретного периода

1. Установите период на последний месяц
2. Выберите интересующие монеты и стратегии
3. Экспортируйте настройки как "last_month_analysis.json"

Сценарий 4: Возврат к настройкам по умолчанию

1. Нажмите кнопку "🎯 Настройки по умолчанию"
2. Все настройки вернутся к значениям из example_settings.json

Советы

• При первом запуске настройки загружаются автоматически
• Сохраняйте настройки с понятными именами файлов
• Используйте предустановленные настройки для быстрого старта
• Регулярно экспортируйте рабочие конфигурации
• Кнопка "Настройки по умолчанию" поможет быстро вернуться к исходным настройкам

Устранение неполадок

Настройки не применяются после загрузки:

• Убедитесь, что нажали кнопку "Применить настройки"
• Страница должна автоматически обновиться

Ошибка при загрузке файла:

• Проверьте, что файл имеет расширение .json
• Убедитесь, что файл не поврежден
• Используйте пример файла example_settings.json как шаблон

Некоторые настройки не работают:

• Проверьте, что выбранные символы и стратегии существуют в данных
• Убедитесь, что даты находятся в доступном диапазоне

Настройки по умолчанию не загружаются:

• Проверьте, что файл example_settings.json существует в корневой папке приложения
• Убедитесь, что файл имеет правильный JSON формат