🚀 Быстрый старт¶

Системные требования¶

Компонент	Минимум	Рекомендуется
Процессор	2 ядра	4+ ядер
ОЗУ	4 ГБ	8+ ГБ
Диск	20 ГБ	50+ ГБ SSD
ОС	Linux/macOS с Docker	Linux Ubuntu 22.04+
Docker	20.10+	Последняя версия
Docker Compose	2.0+	Последняя версия

Установка¶

Автоматическая установка (рекомендуется)¶

# клонирование и установка
chmod +x install.sh
./install.sh

Скрипт выполнит: 1. Проверку зависимостей (Docker, Docker Compose) 2. Генерацию паролей и секретов 3. Создание структуры директорий 4. Настройку схем базы данных 5. Сборку и запуск всех сервисов

С собственными параметрами:

./install.sh --db-password mypass --admin-password myadmin --production

Ручная установка¶

# 1. Создать файл окружения
cp .env.example .env
nano .env

# 2. Создать директории
mkdir -p {logs,backup_DB,data,db/init,db/init-analytics}

# 3. Запустить базу данных
docker compose up -d postgres postgres-analytics redis

# 4. Дождаться инициализации (30 сек)
sleep 30

# 5. Запустить все сервисы
docker compose up -d

Установка для продакшена¶

./install.sh \
  --production \
  --db-password "$(openssl rand -base64 32)" \
  --jwt-secret "$(openssl rand -hex 64)" \
  --admin-password "$(openssl rand -base64 16)"

Первый вход¶

Откройте http://localhost:15000
Войдите с учётными данными по умолчанию:
Имя пользователя: admin
Пароль: admin
Сразу смените пароль администратора! Настройки → Профиль → Сменить пароль

Обзор сервисов¶

После запуска становятся доступны:

Сервис	URL	Описание
Веб-интерфейс	http://localhost:15000	React фронтенд
Backend API	http://localhost:18001	FastAPI / REST API
API (Swagger)	http://localhost:18001/docs	Swagger UI
Adminer (БД)	http://localhost:18091	Управление PostgreSQL
Mastra AI	http://localhost:4111/api	ИИ-агент
Telegram Bot	—	aiogram-бот (polling)
Документация	http://localhost:9500	Эта документация

Структура проекта¶

├── backend/              # Бэкенд FastAPI (Python 3.11)
│   └── src/
│       ├── api/          # Точки входа REST API
│       ├── models/       # Модели SQLAlchemy
│       ├── services/     # Бизнес-логика
│       ├── config.py     # Загрузчик конфигурации
│       └── main.py       # Точка входа приложения
├── frontend/             # React + Vite + Tailwind CSS
│   └── src/
│       ├── pages/        # Компоненты страниц
│       ├── components/   # Переиспользуемые компоненты
│       ├── hooks/        # Хуки React
│       ├── store/        # Состояние (Zustand)
│       └── services/     # API-клиент
├── mobile/               # Приложение Expo React Native
│   └── src/
│       ├── screens/      # Экраны мобильного приложения
│       ├── navigation/   # Навигация
│       └── api/          # API-клиент
├── config/               # YAML-конфиг дашборда
├── Strategies/           # Файлы стратегий Freqtrade
├── mastra/               # Микросервис Mastra AI
├── data_collector/       # Конвейер аналитики
├── mkdocs/               # Эта документация (MkDocs)
└── docker-compose.yml    # Стек Docker Compose

Основные страницы¶

Путь	Раздел	Описание
`/`	Дашборд	Сводка портфеля, прибыль, активные боты
`/freqtrade-bots`	Боты	Статус и управление ботами
`/bots/:id`	Карточка бота	Детали конкретного бота
`/backtest`	Бэктесты	Результаты бэктестов
`/strategy-lab`	Лаборатория стратегий	Стратегии, воркфлоу, гипероптимизация
`/financedata`	Финансовые данные	Котировки, новости, макропоказатели
`/agent`	Агенты	Динамические торговые агенты
`/pairlist-selector`	Селектор пар	ML-оптимизация пар
`/alerts`	Уведомления	Системные оповещения
`/settings`	Настройки	Конфигурация системы
`/users`	Пользователи	Управление пользователями (админ)
`/compare`	Сравнение	Сравнение стратегий и ботов
`/discovery`	Обнаружение	Автообнаружение ботов
	`/historic`	История

Интерфейс¶

Сайдбар — по умолчанию свёрнут, отображает только иконки. Нажмите кнопку ☰ в левом верхнем углу, чтобы развернуть полное меню.

Свёрнутый режим: только иконки, ширина 64px
Развёрнутый режим: иконки + названия, ширина 256px
Группы с подменю: Торговля, Аналитика, Стратегии, Мониторинг — раскрываются по клику
На мобильных устройствах сайдбар открывается поверх контента

Навигация переключается плавно — контент сдвигается вправо при раскрытии сайдбара.