neuroalpha 0.3.15 → 0.3.17

package/README.md

@@ -1,170 +1,79 @@
-# Рынок как язык · 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` | Брокерские счета (Т-Банк, Финам, БКС, Алор, Цифра брокер, ITI Capital, СберИнвестиции, ВТБ, Альфа-Инвестиции + DMA/QUIK-мост); лоты и шаг цены Мосбиржи; предохранители |
-| `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

@@ -17,13 +17,14 @@
    - Выберите права: **«Полный доступ»** (если хотите отправлять заявки из терминала или в режиме «Автомат») либо «Только чтение».
    - Выберите счета: **«Все счета»** (или конкретный брокерский счёт).
 3. Подтвердите выпуск токена СМС-кодом и скопируйте строку токена (начинается с `t.…`).
-4. В терминале «НейроАльфа» откройте **«Настройки → Брокерские счета → Добавить брокерский счёт»**:
+4. В терминале «НейроАльфа» откройте раздел **«Брокерские счета → + Добавить счёт»**:
    - Выберите брокера **«Т-Банк (T-Invest API)»**;
    - Вставьте токен `t.…` в поле **«Токен T-Invest API»**;
    - Нажмите кнопку **«🔍 Найти мои счета по токену»** — выберите нужный субсчёт одной кнопкой.
-5. **Для заработка на падении акций (шорты на тарифах «Профи» и «VIP»):**
+5. **Для заработка на падении акций (шорты на тарифах «Профи», «VIP» и в режиме «Хозяин»):**
    - В мобильном приложении Т-Инвестиций зайдите на выбранный счёт → нажмите на **шестерёнку (Настройки счёта)** в правом верхнем углу → включите тумблер **«Маржинальная торговля»**.
-   - Если маржинальная торговля выключена, платформа автоматически распознает это и будет вести счёт в безопасном режиме **«Только в рост (без шорта)»**.
+   - Если маржинальная торговля выключена (или выбран тариф «Инвестор»), платформа автоматически распознает это и будет вести счёт в безопасном режиме **«Только в рост (без шорта)»**.
+   - Платформа автоматически учитывает справочник доступности шортов по каждой бумаге в Т-Банке (`shortEnabledFlag`) и особенности секции `SPBRU` для акций `SPBE` («СПБ Биржа»).
 
 ---
 

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`.
 
 ---