Advisor — обзор и быстрый старт

Что такое Advisor?

Advisor — отдельный сервис в экосистеме Barfinex, который:

• Получает торговые сигналы от Detector
• При необходимости обогащает их контекстом (рынок, риск или AI/LLM)
• Публикует решения (например, разрешено или отклонено) в шину событий

Другие части системы (исполнение, Studio) могут подписаться на эти решения и реагировать — открывать/закрывать позиции, логировать или отправлять уведомления.

Advisor работает отдельным процессом или контейнером, не внутри Detector. Он подключается к той же шине событий и регистрируется в Provider, чтобы Studio и API-клиенты могли обращаться к нему через прокси Provider.

Как Advisor получает сигналы

Advisor подписывается на события платформенной шины:

• Новые сигналы детектора — Когда Detector генерирует сигнал, Advisor вызывается автоматически. Он может обращаться к правилам или LLM и затем публиковать решение и снимок контекста.
• Запросы на решение — Другие сервисы или REST могут отправить явный запрос на решение; Advisor отвечает теми же типами событий.

В payload приходят символ, сторона (long/short), уверенность и идентификатор стратегии.

Как Advisor подключается

• Шина событий — Обязательна. Подключение настраивается тем же хостом/портом, что и у остального стека (например, общая Docker-сеть с Provider и Detector).
• Provider (реестр приложений) — При старте Advisor регистрируется в Provider и отправляет периодические heartbeat. Provider затем проксирует запросы к Advisor и отображает его в Studio. В конфигурации задаются URL API Provider, при необходимости токен, ключ приложения Advisor и его публичный URL и порт (по умолчанию 8009).

То есть Advisor не «встроен» в Detector: это отдельный процесс, который слушает шину и при необходимости обращается к Provider за контекстом (например, цены через API).

Минимальная настройка

1. Окружение — Та же шина событий и сеть, что у Provider и Detector (например, общая Docker-сеть). Задать хост/порт шины и URL API Provider; при необходимости — API-токен.
2. Порты — REST API Advisor обычно на порту 8009.
3. Опционально — Настройки LLM и риска (макс. позиция, лимиты спреда, флаги) при использовании этих возможностей.

После запуска Advisor появляется в реестре приложений Provider и доступен через Studio и прокси Provider (например, /api/advisors/<appKey>/...).

Что видно в Studio и в логах

• Studio — Если фронтенд работает через Provider, запросы к Advisor идут через прокси Provider. Решения и события контекста Advisor приходят в Studio в реальном времени через WebSocket Provider (/ws), так как Provider транслирует шину в браузер.
• Логи — В логах контейнера или процесса Advisor видны подключение к шине, регистрация в Provider, обработка входящих событий и публикация решений.

Дальше

• Архитектура Barfinex — Как устроена экосистема
• Справочник API Advisor — REST-эндпоинты и использование
• Работа с API — Provider как единый шлюз