neuroalpha 0.3.14 → 0.3.16

package/README.md

@@ -1,170 +1,80 @@
-# Рынок как язык · MOEX
-
-Исследование идеи: акции — «токены» со своими эмбеддингами (место на карте рынка по совместным движениям),
-недавнее состояние ~100 акций индекса MOEXBMI — «контекст», модель предсказывает «следующее состояние» —
-остаточное (без рынка) движение каждой акции на H часов вперёд. Над системой работает ИИ-исследователь «Стратег» (Qwen),
-который ставит эксперименты, ведёт журнал гипотез и разбирает живую проверку. Только виртуальные деньги.
-
-📖 **[Инструкция пользователя](docs/ИНСТРУКЦИЯ.md)** · 📐 **[Механика, математика и параметры системы](docs/МЕХАНИКА_И_ПАРАМЕТРЫ.md)** · 🚀 **[Инструкция по деплою и ЮKassa](docs/ДЕПЛОЙ.md)** (также доступны по кнопке «?» в программе).
-
-## Запуск
-
-```powershell
-npm.cmd install
-npm.cmd start
-```
-
-Клиент: http://localhost:3000. Нужен Node.js ≥ 22.13 (встроенный `node:sqlite`). В VS Code — **F5**, браузер откроется сам.
-В PowerShell используйте `npm.cmd` (`npm.ps1` блокируется политикой выполнения скриптов).
-Зависимости: `express`, `ws`; `@tensorflow/tfjs` и `@tensorflow/tfjs-backend-wasm` — только для трансформера (загружаются лениво).
-
-## Как устроено
-
-```
-MOEX ISS: ~100 акций MOEXBMI + IMOEX, свечи по 10 минут (будни) ──► SQLite-кэш ──► model/dataset.js (N×T, open/close, обороты)
-   dataset.js: при modelUseDividends (по умолчанию да) цены скорректированы на дивиденды — обратная корректировка по экс-датам
-   (полная доходность; экс-дата: T+1 с 31.07.2023, раньше T+2). Источник неточен (дубли, прогнозные строки, сдвиги дат), поэтому
-   дата сверяется с ночным разрывом цены (±2 дня, дивиденд ≥1%; мелкие — только в расчётный день, <0,5% не корректируются);
-   если подходящего падения нет, дивиденд пропускается. Версия обработки данных DATA_VERSION в research.js (старые прогоны не «дубликаты»). Дивиденды — data/moex.js: ISS, запасной источник — smart-lab, кэш в kv на сутки.
-   При modelUseMacro — макро-ряды: нефть Brent (склейка фьючерсов: каждый день — контракт с наибольшим оборотом,
-   стык без скачка цены), золото, юань, доллар, индекс гособлигаций (RGBI)
-   │
-   ├─ model/research.js — пошаговая проверка: окно обучения 120 дн. → прогноз месяц → сдвиг (~27 шагов за 2 года)
-   │    model/models.js:
-   │     ├─ бета к рынку и размах — по окну обучения; остаточные z-движения; признаки: цена и «денежный поток» × 3 масштаба;
-   │     │  цель — open(t+1)→open(t+1+H) без рынка (исполнение по цене открытия следующей свечи)
-   │     ├─ эмбеддинги: собственные векторы корреляций остаточных движений (Якоби), карта 2D + k-means;
-   │     │  при modelTextWeight > 0 близость смешивается с похожестью профилей компаний (model/profiles.js)
-   │     ├─ макро-головы (modelUseMacro): бета остатков акции к макро × z-движения макро × 3 масштаба
-   │     ├─ «своя инерция» (сводная регрессия по своим движениям)
-   │     ├─ «кто за кем ходит» (гребневая регрессия N×2N, λ по валидации)
-   │     └─ «внимание через карту»: 12 голов softmax(β·cos(e_i,e_j)) × признаки соседей + макро-головы
-   │    model/transformer.js — 4-я модель (modelUseTransformer или modelType = transformer): энкодер с вниманием
-   │     МЕЖДУ акциями — каждая акция «токен»; TensorFlow.js + WASM (ленивая загрузка); учится заново в каждом окне,
-   │     окна — параллельно в рабочих потоках или на видеокарте (см. «Трансформер: потоки и видеокарта»)
-   │    model/profiles.js — 20 устойчивых признаков бизнеса компании от ИИ (обновление раз в 30 дней; только факты
-   │     «вне времени» — без новостей и прогнозов, иначе ИИ «подсмотрит будущее»); «текстовая» карта: главные компоненты + k-means
-   │    портфель: modelAutoAdapt (по умолчанию вкл.) — самообучение правил торговли (авто-калибровка порога выхода под реальную
-   │    комиссию на скользящем окне + автоматический карантин систематически убыточных «акций-убийц»); modelDirection — только
-   │    покупки / покупки и продажи / нейтрально к рынку; плата за заём акций — modelShortFeePct; ручные настройки:
-   │    modelExitRatio, modelAllocMode (поровну / обратно размаху акции), modelMarketFilter; устойчивость —
-   │    быстрые сдвиги входа в каждом прогоне + startStabilityCheck (5 сдвигов периода −8…+8 дней с прогрессом и отменой)
-   │    метрики: ранговая корреляция прогноза с фактом (ликвидные), доля недель с плюсом, портфель top-K с порогом
-   │    выгоды, с комиссиями и без, рынок; период настройки / контрольный (70/30)
-   ├─ model/forecast.js — прогноз по последней свече + вклад соседей + веса «обратно размаху» для расчёта долей
-   └─ model/live.js     — виртуальные счета (до 5 параллельно): настройки замораживаются при запуске, счёт «из прогона»
-                          сверяется с коридором истории; каждую свечу оценка, раз в H свечей прогноз и пересмотр портфеля;
-                          newsFilter — не входить против важной свежей новости
-
-Брокеры (brokers/index.js): Т-Банк (T-Invest API), Финам (Trade API), Алор (OpenAPI), БКС — REST-адаптеры портфеля и заявок;
-справочник лотности и шага цены Мосбиржи (TQBR, кэш на сутки) — заявки в целых лотах с округлением лимитной цены;
-3 режима счёта: только чтение / подтверждение заявок / автомат (лимитные заявки); жёсткие предохранители: лимит суммы на
-стратегию, дневной стоп по просадке, отступ лимитки, пропуск первых/последних 10 минут сессии. Токены — только в локальной SQLite.
-
-Новости (news/index.js): RSS Интерфакса, РБК, Прайма, ТАСС + новости Мосбиржи → дешёвый фильтр по названиям компаний
-и экономическим словам → разметка ИИ (каких акций касается, тон −1…+1, важность, суть); во время торгов опрос раз в 10 минут,
-хранение 14 дней. Только для прогноза и живой проверки: истории новостей нет, и ИИ, знающий настоящее, исказил бы проверку
-на истории. Инструмент Стратега — get_news.
-
-Стратег (strategist/): цикл агента со стримингом (SSE) и вызовом функций; режимы обсуждение / с согласия / автопилот;
-журнал гипотез — память; защита от подгонки (только период настройки, контрольный — final_check ≤ 3 раз, сравнение с базой).
-```
-
-Ядро модели — чистый JavaScript без зависимостей (`model/linalg.js`: собственные векторы, Холецкий, Спирмен, k-средних).
-Единственная «тяжёлая» зависимость — трансформер: TensorFlow.js с WASM-бэкендом, загружается только когда он включён.
-
-## Трансформер: потоки и видеокарта
-
-Окна пошаговой проверки независимы, поэтому трансформер разных окон обучается одновременно (`transformerParallel`, по умолчанию
-включено): главный поток строит окна и считает базовые модели, а в рабочие потоки (`worker_threads`) уходят только нужные
-трансформеру массивы. Результат совпадает с последовательным обучением до последнего знака (те же сиды, тот же код).
-
-- **Число потоков** — автоматически: ядер − 1 (`os.availableParallelism()`), не больше числа окон и не больше, чем помещается
-  в половину свободной памяти (≈250 МБ на поток + 3 × объём данных окна). Вручную — переменная `TRANSFORMER_THREADS`.
-- **Видеокарта** (`transformerGpu`, экспериментально): без нативных сборок — TensorFlow.js с WebGL в безголовом браузере
-  на базе Chromium со своим временным профилем. Браузер ищется так: `BROWSER_PATH`, затем стандартные места Chrome / Edge /
-  Chromium / Brave (Windows: Program Files, Program Files (x86), LOCALAPPDATA; macOS: /Applications; Linux: PATH).
-  Служебная страница и WebSocket — на отдельном порту только для 127.0.0.1. Если браузера нет, WebGL недоступен
-  или отрисовка программная (SwiftShader, llvmpipe, Microsoft Basic Render…) — обучение идёт на процессоре.
-  Окна на видеокарте обучаются по очереди; браузер закрывается после исследования (для прогноза — после 10 минут простоя)
-  и при отмене; процессы завершаются по своему PID. Где шло обучение — в результатах исследования (`extra.transformer.device`).
-  На встроенной графике видеокарта обычно не быстрее процессора — выигрыш возможен на дискретной.
-- Прогноз «сейчас» и живая проверка обучают трансформер в отдельном потоке (или на видеокарте), чтобы сервер не замирал.
-- `transformerEpochs` и `transformerStride` — эпохи и шаг свечей при обучении (по умолчанию 8 и 6).
-
-## Структура
-
-| Путь | Назначение |
-|------|------------|
-| `config/strategy.json` | Настройки по умолчанию |
-| `server/model/` | Словарь, данные, модели, исследование, прогноз, живая проверка, метрики |
-| `server/model/transformer-core.js` | Трансформер: обучение и прогноз — общий код для Node и браузера (tf передаётся параметром) |
-| `server/model/transformer.js`, `tf-node.js` | Обёртка для главного потока, загрузка TensorFlow.js (WASM → процессор) |
-| `server/model/transformer-pool.js`, `transformer-worker.js` | Пул рабочих потоков: окна трансформера обучаются одновременно |
-| `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/strategist/` | Стратег: цикл агента, инструменты, аналитика |
-| `server/llm/client.js` | Потоковый клиент модели (SSE, функции, таймаут по простою, отмена) |
-| `server/llm/providers.js` | Реестр подключений и выбранная модель, GigaChat OAuth |
-| `server/params-meta.js`, `server/settings.js` | Описание и хранение настроек |
-| `server/data/moex.js` | Загрузка свечей и дивидендов MOEX ISS с кэшем (запасной источник дивидендов — smart-lab) |
-| `public/` | Интерфейс без сборки (lightweight-charts, marked) |
-
-## LLM (выбор модели для Стратега)
-
-Модель выбирается в шапке чата (список «Провайдер · модель»). Подключения настраиваются во вкладке «Настройки → Модели ИИ»:
-добавление, редактирование (включая ключ и адрес), удаление, проверка («ответь одним словом»), список моделей с сервера.
-Реестр, ключи и выбор хранятся в базе (`data/` — в git не попадают); с сервера ключи никогда не возвращаются.
-
-Протоколы:
-- **OpenAI-совместимый** — `https://…/v1/chat/completions` (потоковый ответ, размышления, инструменты).
-- **GigaChat** — формат чата как у OpenAI, но вход по OAuth: «ключ авторизации» меняется на токен (живёт ~30 минут, обновляется сам), `scope` по умолчанию `GIGACHAT_API_PERS`.
-- **Ollama** — `http://localhost:11434/v1/chat/completions`, ключ не нужен.
-- **Anthropic** — без потока и без инструментов (только беседа).
-
-Если у модели снят флажок «инструменты», Стратег только беседует (в чате доступен лишь режим «Только обсуждение»).
-
-Проект самостоятелен и не зависит от соседних папок. Единственная отправная точка — переменные `LLM_*` в `.env`
-(если заданы, при первом запуске создаётся подключение «Из .env»), дальше всё настраивается в интерфейсе.
-
-Сертификат GigaChat (НУЦ Минцифры): Node его не знает. Путь к `russian_trusted_root_ca.pem` указывается
-в поле «Сертификат» подключения или в переменной `GIGACHAT_CA_FILE` (действует только для запросов к GigaChat,
-проверка TLS не отключается). Ключ авторизации можно также задать переменной `GIGACHAT_KEY`.
-
-## API
-
-| Метод | Путь | Описание |
-|-------|------|----------|
-| GET | `/api/config` | Описание настроек, статус ИИ |
-| GET/PUT | `/api/settings`; POST `/api/settings/reset` | Настройки |
-| GET; DELETE | `/api/runs`, `/api/runs/:id`; PUT `/api/runs/:id/title` | Исследования, имена прогонов |
-| POST | `/api/model/research`, `/api/model/:id/cancel`; POST `/api/runs/:id/stability` | Исследование, отмена, проверка устойчивости |
-| GET | `/api/model/forecast` | Прогноз на ближайшие часы |
-| GET; POST | `/api/profiles`, `/api/profiles/refresh` | Описания компаний и «текстовая» карта; принудительное обновление |
-| GET | `/api/news` | Свежие размеченные новости |
-| GET/POST/DELETE | `/api/live/status`, `/api/live/start`, `/api/live/stop`, `/api/live/:id` | Виртуальные счета (несколько параллельно) |
-| GET/POST/PUT/DELETE | `/api/brokers[/:id]`; POST `…/:id/sync|prepare|execute|reject` | Брокерские счета, портфель, заявки |
-| GET/POST | `/api/journal` | Журнал гипотез |
-| GET/POST/PUT/DELETE | `/api/llm/providers[/:id]`, GET `/api/llm/providers/:id/remote-models` | Подключения к моделям ИИ |
-| POST | `/api/llm/test`, `/api/llm/select` | Проверка подключения, выбор модели |
-| GET/POST | `/api/chat`, `/chat/send`, `/chat/action`, `/chat/stop`, `/chat/mode`, `/chat/new` | Стратег |
-| WS | `/ws` | События: ответы и размышления ИИ, прогресс, виртуальные счета, брокеры, новости, описания |
-
-## Ограничения
-
-- Данные MOEX ISS без подписки приходят с задержкой; для часовых решений некритично.
-- Контрольный период использовался при разработке (выбор порога выгоды), поэтому главная проверка — живая.
-- Позиции на виртуальных счетах дробные (лоты не учитываются). В брокерских заявках лоты и шаг цены учитываются всегда.
-- Брокерские адаптеры (Т-Банк, Финам, Алор, БКС) проверены на тестовом контуре не полностью: форматы ответов брокеров
-  меняются, при первой интеграции начните с режима «Только чтение» или песочницы.
-- Исследование с трансформером медленное (~20 минут на год истории): нейросеть учится заново в каждом окне.
-- Описания компаний и разметку новостей делает ИИ — они могут ошибаться. В описания сознательно попадают только
-  устойчивые факты (без событий и прогнозов), а новости не используются в проверках на истории — иначе ИИ «подсмотрит будущее».
-
-## Правовая информация и лицензия
-
-Copyright (c) 2026 Roman A. Perepelkin (Перепелкин Р.А.). Все права защищены.
-Оператор платформы: ООО «БИС» («Бизнес Интер Софт», г. Рязань).
-Проприетарное программное обеспечение ([LICENSE](LICENSE)) — копирование, модификация и распространение без письменного разрешения правообладателя запрещены.
+# НейроАльфа · Облачная PaaS-платформа алгоритмической торговли на Мосбирже (`MOEX`)
+
+Платформа **«НейроАльфа»** переносит математическую архитектуру больших языковых моделей (LLM) на поток биржевых котировок Московской биржи (`Рынок как язык`): ~100 акций индекса широкого рынка `MOEXBMI` выступают «токенами» со своими спектральными эмбеддингами (координатами на карте рынка с авто-калибровкой размерности по теореме Марченко–Пастура), недавнее состояние всех акций — «контекстом», а 12-головый механизм внимания предсказывает остаточное (очищенное от индекса `IMOEX`) движение каждой акции на адаптивном мульти-горизонте `1,5–3,5 часа`.
+
+Встроенный ИИ-управляющий **«Стратег»** помогает подключить брокерский счёт, объясняет текущие сигналы, анализирует новости и сопровождает портфель.
+
+📖 **[Инструкция пользователя](docs/ИНСТРУКЦИЯ.md)** · 📐 **[Механика, математика и параметры системы](docs/МЕХАНИКА_И_ПАРАМЕТРЫ.md)** · 🏦 **[Подключение брокеров (API)](docs/БРОКЕРЫ_API.md)** · 🚀 **[Инструкция по деплою и ЮKassa](docs/ДЕПЛОЙ.md)** (также доступны по кнопке `?` в шапке платформы).
+
+---
+
+## Быстрый старт (сервер платформы)
+
+```powershell
+npm.cmd install
+npm.cmd start
+```
+
+Веб-терминал открывается по адресу `http://localhost:3000`. Требуется Node.js ≥ 22.13 (встроенный `node:sqlite`). В VS Code запуск выполняется клавишей **F5**.
+
+---
+
+## Архитектура и ключевые механики
+
+```
+MOEX ISS: ~100 акций MOEXBMI + IMOEX, 10-минутные свечи + живой радар котировок (каждые 45 сек)
+   │
+   ├─ server/model/dataset.js — SQLite-кэш свечей и дивидендов (v2), обратная корректировка экс-дат со сверкой по реальному ночному гэпу
+   │                            (учёт перехода T+2 → T+1 с 31.07.2023), 24-часовой суточный профиль объёма (valRatio по часам МСК)
+   │
+   ├─ server/model/models.js  — спектральные эмбеддинги с авто-калибровкой размерности по порогу Марченко–Пастура (modelEmbedDim = 0 Авто),
+   │                            мульти-горизонтная цель (0,6H / 1,0H / 1,4H), 12 голов внимания по 3 масштабам времени (1ч, 3ч, день)
+   │
+   ├─ server/model/research.js — пошаговое Walk-Forward тестирование (окно обучения 90 торговых дней → прогноз 1 месяц → сдвиг, 1000 дней истории):
+   │                             внутричасовой перехват импульса H/5 (каждые 30 мин), адаптивный выбор числа акций (Dynamic Top-K = 0),
+   │                             концентрация слота по силе сигнала (Conviction Sizing до 75%), авто-балансировка Long/Short к тренду индекса,
+   │                             временный карантин убыточных бумаг с амнистией (полураспад ~15 дней). Эталонный результат: >400% годовых (CAGR 419,6%)
+   │
+   ├─ server/model/forecast.js — живой радар прогнозов: обучение весов 1 раз в день + быстрый пересчёт всех масштабов и голов внимания каждые 45 сек
+   │
+   └─ server/brokers/index.js  — прямое подключение 9 российских брокеров (Т-Банк, Финам, БКС, Алор, Цифра брокер, ITI Capital,
+                                 СберИнвестиции, ВТБ, Альфа-Инвестиции), поддержка секций TQBR и SPBRU (SPBE), фильтр доступности шортов
+                                 у брокера (shortEnabledFlag), 3 режима работы (Только чтение / Подтверждение в Telegram и MAX / Автомат)
+                                 и тестовый режим (песочница брокера), двухфазное исполнение ордеров и умная ротация старого портфеля
+```
+
+---
+
+## Единый интерфейс платформы
+
+Правая часть рабочего окна построена вокруг единого левого меню навигации без перегрузки лишними вкладками:
+
+1. **Торговля:**
+   - **Брокерские счета** *(открывается по умолчанию)* — сворачиваемые карточки счетов с быстрой кнопкой `⏸ Пауза / ▶ Запустить`, встроенными настройками по кнопке `⚙`, переключателем **«Тестовый режим (песочница брокера)»** и четырьмя вкладками внутри счёта: `📦 Состав портфеля` (с расчётом доли владения в капитале эмитента `ISSUESIZE`), `⚡ Торговля и заявки`, `📈 График дохода` и `📜 История счёта` (с агрегацией закрытых сделок и расчётом дневного результата в `₽` и `%`).
+2. **Аналитика рынка:**
+   - **Прогноз сейчас** — живой радар ожиданий по 100 акциям Мосбиржи (обновление каждые 45 секунд) с динамикой изменения сигнала и цепочкой влияния соседей.
+   - **Новости рынка** — лента новостей и корпоративных раскрытий с ИИ-оценкой тональности и влияния на конкретные тикеры.
+3. **Управление и настройки:**
+   - **Эксперименты** *(доступен эксклюзивно в режиме «Хозяин»)* — Walk-Forward проверка ядра и управление витриной.
+   - **Издержки и новости** — настройка комиссии брокера, проскальзывания, ставки за шорт и новостного фильтра.
+   - **Подписка и уведомления** — управление тарифом, привязка ботов Telegram и MAX для подтверждения заявок в 1 клик.
+   - **Модели ИИ** — подключение провайдеров ИИ для Стратега (OpenAI-совместимые, GigaChat с сертификатом НУЦ Минцифры, Ollama).
+
+---
+
+## Тарифная политика SaaS и режим «Хозяин»
+
+| Тариф | Стоимость | Целевая доходность | Направление торговли | Лимит счетов и стартового капитала |
+|---|---|---|---|---|
+| **«Инвестор»** | `3 900 ₽ / мес` | Задавлена **до 60% годовых** | Только в рост (без шорта) | **1 брокерский счёт**, стартовый лимит **до 1 000 000 ₽** (+ 100% реинвестирование всей прибыли) |
+| **«Профи»** | `9 900 ₽ / мес` | Задавлена **до 120% годовых** | В рост и в падение (с шортом) | **До 5 брокерских счетов**, стартовый лимит **до 1 000 000 ₽** на каждом (+ 100% реинвестирование всей прибыли) |
+| **«VIP»** | По индивидуальному согласованию | Задавлена **до 240% годовых** | В рост и в падение (с шортом) | Количество счетов и начальная сумма торговли — **по индивидуальному согласованию** |
+| **Режим «Хозяин» (`owner`)** | Владелец / Администратор | **Без ограничений (>400% годовых)** | Полная мощность ядра (`H/5` + `Conviction Sizing` до 75%) | Без ограничений по счетам и капиталу + эксклюзивный доступ к разделу **«Эксперименты»** |
+
+---
+
+## Правовая информация и лицензия
+
+Copyright (c) 2026 Roman A. Perepelkin (Перепелкин Р.А.). Все права защищены.  
+Оператор платформы: ООО «БИС» («Бизнес Интер Софт», г. Рязань).  
+Проприетарное программное обеспечение ([LICENSE](LICENSE)) — копирование, модификация и распространение без письменного разрешения правообладателя запрещены.

package/config/strategy.json

@@ -4,14 +4,14 @@
   "modelHorizon": 2.5,
   "modelMinEdge": 2.5,
   "modelExitRatio": 0.95,
-  "modelTopK": 2,
+  "modelTopK": 0,
   "modelAllocMode": "equal",
   "modelDirection": "longshort",
   "modelMarketFilter": "off",
   "modelShortFeePct": 20,
   "modelTrainDays": 90,
   "modelHistoryDays": 1000,
-  "modelEmbedDim": 11,
+  "modelEmbedDim": 0,
   "modelUseDividends": true,
   "modelUseMacro": false,
   "modelTextWeight": 0,

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

@@ -0,0 +1,119 @@
+# Подключение брокерских счетов в «НейроАльфе»
+
+Платформа «НейроАльфа» поддерживает подключение **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» и в режиме «Хозяин»):**
+   - В мобильном приложении Т-Инвестиций зайдите на выбранный счёт → нажмите на **шестерёнку (Настройки счёта)** в правом верхнем углу → включите тумблер **«Маржинальная торговля»**.
+   - Если маржинальная торговля выключена (или выбран тариф «Инвестор»), платформа автоматически распознает это и будет вести счёт в безопасном режиме **«Только в рост (без шорта)»**.
+   - Платформа автоматически учитывает справочник доступности шортов по каждой бумаге в Т-Банке (`shortEnabledFlag`) и особенности секции `SPBRU` для акций `SPBE` («СПБ Биржа»).
+
+---
+
+## 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/224/320/225/320/237/320/233/320/236/320/231.md

@@ -1,25 +1,18 @@
-# Пошаговая инструкция по запуску (Деплою), ЮKassa и `npx`
+# Пошаговая инструкция по запуску облачной платформы (Деплою) и ЮKassa
 
-Эта инструкция написана простым языком для запуска вашего коммерческого облачного сайта «НейроАльфа» с нуля: от покупки домена до приёма платежей через ЮKassa и раздачи ключей `APIKey` пользователям.
+Эта инструкция написана простым языком для запуска вашего коммерческого облачного PaaS-портала «НейроАльфа» с нуля: от покупки домена до приёма платежей через ЮKassa и управления тарифами пользователей.
 
 ---
 
-## 1. Как связаны между собой Сайт, ЮKassa и `npx neuroalpha`
+## 1. Архитектура облачного портала и тарифы
 
-У вашей платформы **гибридная архитектура** (как у современных облачных сервисов):
-
-1. **Ваш Облачный Сайт (`https://ваш-домен.ru`)**:
-   * На главной странице открывается продающий **лендинг** с живой витриной стратегий и тарифами (`3 900 ₽` и `9 900 ₽`).
-   * Посетитель нажимает **«Попробовать бесплатно»** или **«Оформить подписку»**, регистрируется и оплачивает тариф картой МИР или через СБП (ЮKassa).
-   * В личном кабинете на сайте пользователь получает свой персональный **`APIKey` (`na_live_...`)**.
-
-2. **Два режима работы для вашего клиента**:
-   * **Вариант А — Прямо в браузере на вашем сайте:** клиент нажимает «Открыть веб-терминал» и пользуется платформой онлайн.
-   * **Вариант Б — На своём компьютере через `npx`:** клиент открывает у себя командную строку и запускает:
-     ```bash
-     npx neuroalpha --key na_live_его_ключ --cloud https://ваш-домен.ru
-     ```
-     Его локальная программа связывается с вашим сайтом по этому ключу, проверяет оплаченную подписку, включает тариф («Инвестор» или «Профи») и автоматически использует ИИ-Стратега вашего сервера, при этом **ключи от его брокера (Т-Банк, БКС, Финам, Алор) хранятся только на его личном компьютере**.
+1. **Ваш Облачный Портал (`https://ваш-домен.ru`)**:
+   * На главной странице открывается продающий **лендинг** с живой витриной стратегий и тремя коммерческими тарифами:
+     * **«Инвестор» (`3 900 ₽ / мес`)** — задавленная доходность до 60% годовых, без шортов, 1 брокерский счёт со стартовым лимитом до 1 000 000 ₽ (+ 100% реинвестирование всей прибыли);
+     * **«Профи» (`9 900 ₽ / мес`)** — задавленная доходность до 120% годовых, с шортами, до 5 брокерских счетов со стартовым лимитом до 1 000 000 ₽ на каждом (+ 100% реинвестирование всей прибыли);
+     * **«VIP» (по индивидуальному согласованию)** — задавленная доходность до 240% годовых, с шортами, количество счетов и начальная сумма торговли по согласованию (активируется персональным `VIP-…` токеном от администратора).
+   * Посетитель регистрируется, принимает Публичную оферту и оплачивает тариф картой МИР или через СБП (ЮKassa), после чего подключает свои брокерские счета прямо в облачном веб-терминале (включая возможность безопасной проверки на песочнице брокера или в режиме «Только чтение»).
+   * Для владельца / администратора платформы действует режим **«Хозяин» (`owner`)** — без ограничений по доходности (>400% годовых), числу счетов и сумме капитала, а также с эксклюзивным доступом к разделу **«Эксперименты»** и консоли администратора `/admin`.
 
 ---