Глоссарий Barfinex

Сервисы

• Provider — Шлюз рыночных данных и единственный источник правды. Подключается к биржам (REST + WebSocket), нормализует рыночные данные, обнаруживает и восстанавливает пробелы свечей, ведёт реестр приложений, проксирует ко всем другим сервисам и раскрывает единый REST API и WebSocket /ws для Studio. Весь трафик от Studio и внешних клиентов маршрутизируется через Provider.
• Detector — Движок стратегий. Оценивает типизированные конфигурации правил на живых рыночных данных от Provider. Каждый экземпляр работает независимо; событие оценённого сигнала генерируется, когда условия правил пересекают сконфигурированный порог. Несколько экземпляров работают параллельно без разделения состояния.
• Advisor — AI-движок принятия решений. Запускает 8-ступенчатый конвейер рассуждений на каждом сигнале от Detector: шлюз качества рынка, ML-скоринг уверенности, калибровка по режиму, LLM-синтез, валидация решения. Генерирует исполнительные намерения для Inspector. Раскрывает свой API как инструменты MCP через Provider.
• Inspector — Риск-регулятор. Валидирует каждое исполнительное намерение от Advisor по сконфигурированным риск-политикам прежде, чем любой ордер достигнет биржи. Управляет защитными ордерами (стоп-лосс, тейк-профит) для всех runtime-позиций. Аудирует каждое заполнение.
• Studio — Операционный терминал (Next.js). Подключается исключительно через шлюз Provider. Отображает сигналы, AI-решения, состояние риска и метрики эффективности капитала в реальном времени. Только для чтения с точки зрения исполнения.

Инфраструктура

• Шина событий — Redis pub/sub основа. Все сервисы публикуют и подписываются через типизированные каналы. Имена каналов и схемы данных определены в libs/types.
• Реестр приложений (App Registry) — Реестр работающих сервисов Provider. Detector, Advisor и Inspector регистрируются при старте через register + heartbeat. Provider использует реестр для прокси-маршрутизации и отображения доступности сервисов в Studio.
• MCP (Model Context Protocol) — Provider раскрывает весь свой REST API как инструменты MCP, делая его вызываемым любым LLM с поддержкой инструментов. API Advisor также раскрывается через MCP через Provider.
• libs/types — Общий TypeScript-пакет, определяющий все имена каналов событий, схемы данных и типы подписок. Изменения в этом пакете отлавливаются компилятором TypeScript до попадания в production.

Концепции AI-конвейера

• Показатель уверенности (conviction score) — Нормализованное значение [0, 1], представляющее уверенность Advisor в сигнале после агрегации входов правил и ML. Калибруется перед использованием.
• Калибровка уверенности — Процесс корректировки сырых показателей уверенности с помощью логистической регрессии с режим-адаптивным масштабированием (масштабирование Платта или изотоническая регрессия). Учитывает историческое распределение результатов по разным рыночным режимам.
• Оценка качества рынка — Оценка, вычисляемая движком качества Provider и представляющая свежесть данных, стабильность спреда и глубину ликвидности. Advisor блокирует сигналы при падении качества ниже порога.
• Рыночный режим — Классификация текущих рыночных условий (например, тренд, флет, волатильность). Используется Advisor для выбора соответствующих параметров калибровки.
• Исполнительное намерение (execution intent) — Типизированное событие, генерируемое Advisor после завершения конвейера. Содержит направленное решение, показатель уверенности, рассуждения и рекомендацию по размеру. Inspector подписывается на исполнительные намерения.
• Обнаружение галлюцинаций — Событие Advisor, генерируемое когда выход LLM программно несогласован с количественным сигналом. Блокирует цикл.

Концепции риска

• Runtime-позиция — Позиция, открытая пока Inspector работает. Inspector имеет полный контроль: выставляет стопы, трейлит их, может закрыть по политике или триггеру.
• Legacy-позиция — Позиция, существовавшая до начала текущей сессии Inspector. Inspector обнаруживает её и отправляет уведомление, но не модифицирует и не закрывает автоматически.
• THROTTLE — Действие Inspector, снижающее частоту генерации сигналов. Публикуется в Detector при достижении мягкого лимита риска.
• STAND_DOWN — Действие Inspector, приостанавливающее новые входы при сохранении управления существующими позициями.
• CLOSE_ALL — Действие Inspector, немедленно закрывающее все runtime-позиции. Используется при достижении жёсткого лимита риска.
• Реконсилиация — Периодическая проверка Inspector, что его внутреннее состояние позиций соответствует фактическому состоянию счёта на бирже. Расхождения запускают событие реконсилиации.

Окружение

• Testnet — Тестовая среда биржи (например Binance Testnet). Ключи и URL отличаются от production; настраиваются отдельно.
• Production — Боевая среда с реальными ключами биржи и реальными средствами. Требует внимания к секретам, HTTPS и доступу к сети.

Подробнее об архитектуре и потоке данных — в Архитектура Barfinex. По API — в Справочник API Provider.