neuroalpha 0.3.13 → 0.3.15

package/README.md

@@ -104,7 +104,7 @@ MOEX ISS: ~100 акций MOEXBMI + IMOEX, свечи по 10 минут (буд
 | `server/model/transformer-gpu.js`, `gpu-worker.html/.js` | Обучение на видеокарте: WebGL в безголовом Chrome / Edge / Chromium / Brave |
 | `server/model/profiles.js` | Описания компаний: 20 устойчивых признаков от ИИ, «текстовая» карта |
 | `server/news/index.js` | Новости: сбор из RSS и с Мосбиржи, разметка ИИ, фильтр для живой проверки |
-| `server/brokers/index.js` | Брокерские счета: Т-Банк, Финам, Алор, БКС; лоты и шаг цены Мосбиржи; предохранители |
+| `server/brokers/index.js` | Брокерские счета (Т-Банк, Финам, БКС, Алор, Цифра брокер, ITI Capital, СберИнвестиции, ВТБ, Альфа-Инвестиции + DMA/QUIK-мост); лоты и шаг цены Мосбиржи; предохранители |
 | `server/strategist/` | Стратег: цикл агента, инструменты, аналитика |
 | `server/llm/client.js` | Потоковый клиент модели (SSE, функции, таймаут по простою, отмена) |
 | `server/llm/providers.js` | Реестр подключений и выбранная модель, GigaChat OAuth |

package/docs//320/221/320/240/320/236/320/232/320/225/320/240/320/253_API.md

@@ -0,0 +1,118 @@
+# Подключение брокерских счетов в «НейроАльфе»
+
+Платформа «НейроАльфа» поддерживает подключение **9 российских брокеров** для работы с акциями Мосбиржи (`TQBR`). Все токены и ключи доступа шифруются алгоритмом **AES-256-GCM** и никогда не передаются обратно в интерфейс браузера.
+
+> **Важное правило безопасности и Оферты:**  
+> Запрещается подключать к платформе счета, участвующие в сервисах **автоследования / копирования сделок** (как в роли ведущего стратегии, так и в роли подписчика). Платформа автоматически проверяет счета на признаки автоследования и блокирует торговлю при их обнаружении.
+
+---
+
+## 1. Т-Банк (`T-Invest API`) — рекомендуется
+
+Самый быстрый и функциональный облачный API на российском рынке: поддерживает автопоиск всех ваших субсчетов, проверку маржинальной торговли (`GetMarginAttributes`), проверку доступных лотов (`GetMaxLots`), выписку операций за все годы и выставление лимитных заявок.
+
+### Пошаговая инструкция:
+1. Откройте веб-кабинет **Т-Инвестиций** на сайте `https://www.tbank.ru/invest/settings/` (раздел **Настройки → Токены T-Invest API**).
+2. Нажмите **«Выпустить токен»**:
+   - Выберите права: **«Полный доступ»** (если хотите отправлять заявки из терминала или в режиме «Автомат») либо «Только чтение».
+   - Выберите счета: **«Все счета»** (или конкретный брокерский счёт).
+3. Подтвердите выпуск токена СМС-кодом и скопируйте строку токена (начинается с `t.…`).
+4. В терминале «НейроАльфа» откройте **«Настройки → Брокерские счета → Добавить брокерский счёт»**:
+   - Выберите брокера **«Т-Банк (T-Invest API)»**;
+   - Вставьте токен `t.…` в поле **«Токен T-Invest API»**;
+   - Нажмите кнопку **«🔍 Найти мои счета по токену»** — выберите нужный субсчёт одной кнопкой.
+5. **Для заработка на падении акций (шорты на тарифах «Профи» и «VIP»):**
+   - В мобильном приложении Т-Инвестиций зайдите на выбранный счёт → нажмите на **шестерёнку (Настройки счёта)** в правом верхнем углу → включите тумблер **«Маржинальная торговля»**.
+   - Если маржинальная торговля выключена, платформа автоматически распознает это и будет вести счёт в безопасном режиме **«Только в рост (без шорта)»**.
+
+---
+
+## 2. Финам (`Finam Trade API`)
+
+Официальный облачный REST API брокера «Финам» (`https://trade-api.finam.ru`).
+
+### Пошаговая инструкция:
+1. Войдите в личный кабинет клиента Финам (`https://edox.finam.ru` / `finam.ru`).
+2. Перейдите в раздел **«Торговля» → «Токены доступа (Finam Trade API)»**.
+3. Нажмите **«Создать новый токен»**, подтвердите выпуск по СМС и скопируйте токен (обычно начинается с `CA…`).
+4. Узнайте ваш **Код клиента (`ClientId`)** для Единого счёта Мосбиржи (отображается в таблице токенов и в терминале FinamTrade, например `123456R` или `КлФ-…`).
+5. В форме добавления счёта в «НейроАльфе» выберите **«Финам (Finam Trade API)»**, вставьте токен `CA…` и укажите `ClientId`.
+
+---
+
+## 3. БКС Мир инвестиций (`BCS Trade API`)
+
+Облачный торговый REST API брокера БКС (`https://be.broker.ru`).
+
+### Пошаговая инструкция:
+1. Откройте веб-терминал или личный кабинет **«БКС Мир инвестиций»** в браузере.
+2. Перейдите в **Профиль / Настройки → «Торговый API (BCS Trade API)»**.
+3. Выпустите токен с правом **«Чтение и торговля»** (`trade-api-write`).
+4. Скопируйте полученный **Refresh-токен** и вставьте его в поле «Refresh-токен БКС Trade API» в «НейроАльфе». Платформа сама обменивает его на сессионный JWT-ключ при каждом запросе.
+
+---
+
+## 4. Алор Брокер (`Alor OpenAPI v2`)
+
+Профессиональный облачный интерфейс Алор Брокера (`https://api.alor.ru`).
+
+### Пошаговая инструкция:
+1. Авторизуйтесь под вашей брокерской учётной записью на портале разработчика **`https://alor.dev`** (или через кабинет `my.alor.ru` → раздел **OpenAPI**).
+2. Выпустите **Refresh Token** для боевого контура Мосбиржи.
+3. В поле **«Фондовый портфель Мосбиржи»** укажите ваш портфель с литерой `D` (например, `D39004`).
+
+---
+
+## 5. Цифра брокер (`Tradernet API v2`)
+
+Облачный REST API платформы Tradernet («Цифра брокер» / бывш. ИК «Фридом Финанс», `https://tradernet.ru`).
+
+### Пошаговая инструкция:
+1. Войдите в веб-кабинет **`https://tradernet.ru`** → откройте **Настройки профиля → «API ключи»**.
+2. Нажмите **«Создать ключи API»** — система выдаст два ключа: **Public Key** (публичный) и **Secret Key** (секретный).
+3. В «НейроАльфе» выберите **«Цифра брокер (Tradernet API)»** и вставьте оба ключа в поле токена **через двоеточие без пробелов**:
+   `PublicKey:SecretKey`.
+
+---
+
+## 6. ITI Capital (`OpenAPI`)
+
+Алго-брокер с поддержкой протокола OpenAPI (`https://api.iticapital.ru`).
+
+### Пошаговая инструкция:
+1. В личном кабинете клиента **ITI Capital** перейдите в раздел **«Торговые системы → OpenAPI»** и выпустите **Refresh Token**.
+2. Вставьте Refresh-токен в «НейроАльфу» и укажите ваш фондовый портфель Мосбиржи вида `BP12345`.
+
+---
+
+## 7. СберИнвестиции (Сбербанк), ВТБ Мои Инвестиции и Альфа-Инвестиции
+
+У розничных подразделений **СберИнвестиций**, **ВТБ** и **Альфа-Инвестиций** нет публичного облачного REST-токена для физлиц (алготорговля у этих брокеров предоставляется через десктопный терминал **QUIK**).
+
+В «НейроАльфе» для клиентов **Сбера, ВТБ и Альфы** предусмотрены **два удобных режима работы**:
+
+1. **Режим «Подтверждение заявок» через Telegram / MAX (рекомендуется, работает без QUIK):**
+   - При добавлении счёта выберите **«СберИнвестиции»** (или ВТБ / Альфа-Инвестиции), **оставьте поле адреса моста QUIK пустым**, укажите номер счёта и ваш **Лимит суммы на стратегию** (например, `100 000 ₽`).
+   - В начале каждого торгового шага платформа автоматически рассчитывает точный пакет лимитных заявок в лотах Мосбиржи под ваш баланс и присылает уведомление в **Telegram / MAX** и во вкладку **«⚡ Торговля и заявки»**.
+   - Вы выставляете указанные заявки в мобильном приложении СберИнвестиций / ВТБ / Альфы и нажимаете кнопку **«Исполнить заявки»** в терминале (или в боте) — платформа автоматически обновляет состав бумаг и остаток рублей в карточке вашего счёта.
+2. **Автоматический режим через локальный HTTP-мост QUIK:**
+   - Если у вас запущен терминал QUIK Сбербанка / ВТБ с локальным HTTP REST-шлюзом (`QuikHttpBridge`), укажите его адрес (`http://127.0.0.1:8080` или адрес вашего сервера) в поле **«Адрес моста QUIK»** — тогда чтение портфеля и отправка лимитных заявок будут выполняться автоматически.
+
+---
+
+## 8. Можно ли торговать напрямую через Мосбиржу без брокера (DMA / MOEX ISS / FIX)?
+
+Этот вопрос часто возникает у трейдеров и корпоративных клиентов. Важно разделять **получение биржевых данных** и **исполнение сделок в стакане**:
+
+1. **Рыночные данные и котировки «НейроАльфа» уже получает напрямую с Мосбиржи (без брокеров):**
+   - Все 10-минутные свечи 99 акций индекса широкого рынка, живые котировки `LAST / MARKETPRICE` (обновление каждые 45 секунд), размеры лотов (`LOTSIZE`), минимальный шаг цены (`MINSTEP`) и календарь дивидендов загружаются платформой **напрямую из ядра Московской биржи (`iss.moex.com` / `MOEX ISS`)**.
+   - Поэтому обучение моделей, карта рынка, живой радар прогнозов и виртуальные счета работают полностью независимо от брокеров.
+
+2. **Почему для реальных сделок с акциями (`TQBR`) обязательно нужен лицензированный брокер:**
+   - По российскому законодательству (**ФЗ № 39-ФЗ «О рынке ценных бумаг»** и **ФЗ № 325-ФЗ «Об организованных торгах»**) прямой клиринговый допуск к фондовому рынку акций Мосбиржи (`TQBR`) имеют только профессиональные участники рынка ценных бумаг с лицензией Банка России и взносом в гарантийный фонд НКЦ.
+   - Частный инвестор или обычное юридическое лицо подаёт заявки в торговое ядро Мосбиржи через свой счёт у лицензированного брокера (деньги и акции при этом хранятся на вашем именном счёте в НРД / у брокера).
+
+3. **Прямой доступ к ядру биржи (DMA — Direct Market Access / MOEX FIX / ASTS Bridge):**
+   - Для крупных алготрейдеров и институциональных клиентов (тариф **«VIP»**), у которых у брокера (Алор, Финам, ITI Capital, БКС) подключена услуга прямого биржевого шлюза **DMA (протоколы MOEX FIX / FAST или ASTS Bridge)**, «НейроАльфа» поддерживает подключение через локальный HTTP-мост (`http://ip:port/orders`).
+   - При этом для горизонта стратегии **2,5 часа** (с проверкой импульса каждые **30 минут** и выставлением лимитных заявок с защитным отступом `0,1%`) стандартные бесплатные облачные REST API **Т-Банка, Финама, БКС, Алора, Цифры и ITI Capital** (отклик `50–120 мс`) обеспечивают точно такую же цену исполнения без абонентской платы за выделенный FIX-шлюз.
+

package/docs//320/230/320/235/320/241/320/242/320/240/320/243/320/232/320/246/320/230/320/257.md

@@ -140,7 +140,7 @@
 | Обучать трансформер на видеокарте | Экспериментально: через встроенный в браузер Chrome / Edge движок. Если видеокарта недоступна, обучение идёт на процессоре. Результат может чуть отличаться в последних знаках |
 | Учитывать новости в торговле | В виртуальной торговле не открывать сделку против важной свежей новости (сбор новостей идёт в фоне всегда) |
 
-**Брокерские счета** (Т-Банк, Финам, Алор, БКС): добавляются по токену API с номером счёта/портфеля, режимом работы («Только чтение» / «Подтверждение заявок» / «Автомат») и предохранителями: лимит суммы на стратегию (₽), дневной стоп по просадке (%), защитный отступ лимитной заявки (%) и пропуск первых и последних 10 минут сессии. Можно привязать счёт к номеру удачного прогона — тогда заявки считаются по его замороженным настройкам. Токены хранятся только в локальной базе.
+**Брокерские счета** (Т-Банк, Финам, БКС, Алор, Цифра брокер, ITI Capital, а также СберИнвестиции, ВТБ и Альфа-Инвестиции): добавляются во вкладке **«Настройки → Брокерские счета»** с выбором режима работы («Только чтение» / «Подтверждение заявок» / «Автомат») и жёсткими предохранителями: лимит суммы на стратегию (₽), дневной стоп по просадке (%), защитный отступ лимитной заявки (%) и пропуск первых и последних 10 минут сессии. Рыночные данные (свечи, живые котировки, лоты и дивиденды) платформа получает напрямую с Мосбиржи (`MOEX ISS`), а выставление реальных заявок в стакан `TQBR` по закону (ФЗ № 39-ФЗ) проходит через ваш брокерский счёт (по облачному REST API брокера, через подтверждение в Telegram/MAX или через прямой DMA/QUIK-мост). Подробная инструкция по каждому брокеру открывается прямо в форме добавления счёта и во вкладке справки **«Подключение брокеров (API)»**.
 
 ## Запуск
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neuroalpha",
-  "version": "0.3.13",
+  "version": "0.3.15",
   "description": "НейроАльфа — ИИ-автопилот для рынка акций Мосбиржи: эмбеддинги акций, самообучение правил, коннекторы Т-Банк / БКС / Финам / Алор и боты Telegram / MAX",
   "author": "Roman A. Perepelkin",
   "license": "UNLICENSED",