2026-10-13 07:43:17 +03:00
6 changed files with 52 additions and 21 deletions
@@ -35,7 +35,7 @@ WealthLedger помогает частному инвестору понимат
 | [Операции](domains/operations/overview.md) | Исполненные операции, фильтры и пагинация |
 | [Доход](domains/income/overview.md) | Полученные купоны и дивиденды, периоды и состав расчёта |
 | [Будущие выплаты](domains/income/upcoming-events.md) | Календарь по текущим позициям и ограничения прогноза |
-| [Акции](domains/instruments/stocks.md) и [облигации](domains/instruments/bonds.md) | Поиск выпуска, рыночные показатели и личная история |
+| [Скринер акций](domains/instruments/stocks.md) и [облигации](domains/instruments/bonds.md) | Подбор акций по параметрам, поиск выпуска, рыночные показатели и личная история |

 ## Найти материал по задаче

@@ -21,6 +21,17 @@ artifact у себя и проверяет соответствие generated ty
 API имеет prefix `/api/v1`; Swagger публикуется для локальной разработки по
 environment policy, а не используется frontend в runtime.

+## Скринер акций
+
+`POST /api/v1/stocks/screener/search` всегда создаёт новый результат по
+условиям скринера, включая пустой подтверждённый список. Ответ первой страницы
+содержит непрозрачный `searchId`, время получения каталога и признак следующей
+страницы. `GET /api/v1/stocks/screener/search/{searchId}?page=...` читает
+последующую страницу того же результата, не запускает новый поиск и сохраняет
+состав и время списка. Идентификатор результата принадлежит текущему пользователю
+и его подключению; недоступный или чужой результат возвращает ошибку, а не
+пустой список. Точные поля и статусы определяет backend-generated OpenAPI.
+
 ## Инвестиционные данные и синхронизация

 Затронутые GET инвестиционных ресурсов возвращают сгенерированный contract
@@ -28,24 +28,29 @@
 на frontend. Общее для акций и облигаций восстановление справочных данных
 принадлежит [загрузке портфеля на backend](../portfolio/flows/portfolio-loading.md).

-Раздел «Акции» в боковой и мобильной навигации ведёт на `/stocks`: поиск
-по названию или тикеру через каталог Т-Банка, начиная с двух символов.
-Результаты разных выпусков, включая обыкновенные и привилегированные акции,
-имеют отдельные UID. Карточка результата показывает логотип, последнюю цену
-с её временем, тип бумаги, площадку, код режима, ISIN и доступность торгов через
-API. Поиск показывает одну карточку на нормализованный ISIN. До ограничения
-в 30 результатов выбирается представитель выпуска: доступность через API,
-точное совпадение тикера, затем режим TQBR; равные варианты упорядочены по UID.
-Записи без ISIN сохраняются отдельно по UID. Обыкновенные и привилегированные
-акции с разными ISIN не объединяются. Цена и ссылка принадлежат выбранному
-UID; данные разных режимов не смешиваются. Прямые ссылки из портфеля сохраняют
+Раздел «Акции» в боковой и мобильной навигации ведёт на `/stocks`: скринер
+запускается кнопкой «Найти» с необязательным названием или тикером, сектором,
+типом акции, валютой расчётов, площадкой, страной риска и максимальным размером
+лота. Он использует полный полученный каталог и показывает только акции, для
+которых каталог подтверждает доступность покупки и торговли через API. Это не
+гарантирует, что конкретная заявка пользователя будет исполнена прямо сейчас.
+
+Скринер показывает одну карточку на выпуск с нормализованным ISIN, а выпуск
+без ISIN остаётся отдельной карточкой точного UID. Обыкновенные и
+привилегированные акции с разными ISIN не объединяются. После отбора карточки
+упорядочены по тикеру и UID, разделены на страницы по 30 и показывают единое
+время получения списка. Изменение условий не заменяет текущий список до
+следующего нажатия «Найти». Повторный поиск получает новый каталог; страницы
+одного результата не пересчитываются. Подтверждённый пустой результат отличается
+от ошибки источника, для которой интерфейс предлагает повторить поиск.
+
+Ссылка карточки принадлежит выбранному UID; данные разных режимов не смешиваются.
+Прямые ссылки из портфеля сохраняют
 исходный UID, даже если поиск выбрал другой режим этого выпуска; такая страница
 сохраняет UUID в адресе. Если один точный тикер относится к разным выпускам,
-сервер возвращает `409 STOCK_TICKER_AMBIGUOUS`, а страница предлагает поиск.
-Поиск тикера нечувствителен к регистру, но использует точное совпадение:
-SBER не заменяется на SBERP. Однобуквенные тикеры также поддерживаются.
+сервер возвращает `409 STOCK_TICKER_AMBIGUOUS`.
 Прямая ссылка не требует предварительного открытия портфеля. Хлебные крошки
-«Акции → название» возвращают к поиску.
+«Акции → название» возвращают к скринеру.

 ## Содержание и состояния

@@ -144,10 +149,11 @@ TTM означает последние 12 месяцев, MRQ — послед
 ## Получение данных и ограничения

 Общие metadata, discovery, company, quotes, свечи и календари сохраняются
-в SQLite. Поиск хранит подтверждённый набор UID для конкретного query;
-успешный SBER не подтверждает пустой GAZP. Отсутствующее enrichment не
-скрывает найденную бумагу. Сохранённые общие источники переиспользуются
-между пользователями, но личные позиции и выплаты всегда проверяют доступ.
+в SQLite. Скринер получает каталог online и показывает время его получения;
+временная недоступность каталога не подтверждает отсутствие подходящих акций.
+Отсутствующее enrichment не скрывает найденную бумагу. Сохранённые общие
+источники переиспользуются между пользователями, но личные позиции и выплаты
+всегда проверяют доступ.

 Обычное чтение не ждёт RPC; missing/stale зависимости запрашиваются в фоне
 через существующий T-Bank limiter. Минутная свежесть применяется к quotes
@@ -128,6 +128,14 @@ Instrument обогащают отображение Position или Event, но

 _Не использовать_: бумага, тикер, актив позиции.

+## Скринер акций
+
+Подбор выпусков акций по заданным условиям из каталога T-Bank с указанием
+времени получения списка. Скринер отличается от текстового поиска конкретного
+инструмента, личного портфеля и подтверждения исполнимости сделки.
+
+_Не использовать_: гарантия покупки, личная проверка доступа к сделке.
+
 ## Instrument Logo

 Имя файла бренда T-Bank для отображения Instrument в интерфейсе;
@@ -20,6 +20,12 @@ T-Bank определяет исходные данные и права token. B
 сессию, выбирает подключение её пользователя и устанавливает доступ к счёту.
 Наличие идентификатора счёта в URL этого доступа не подтверждает.

+Скринер акций получает полный online-каталог акций T-Bank для каждого нового
+поиска. В него входят только инструменты, для которых каталог подтверждает и
+доступность покупки, и торговли через API. Эти признаки описывают полученный
+снимок каталога: они не подтверждают личные права пользователя, состояние торгов
+или исполнение будущей заявки. Скринер не использует личный портфель как каталог.
+
 [MOEX](moex.md) и [НКР](nkr.md) дополняют публичные сведения об облигациях; они не заменяют
 брокера как источник личных позиций и исполненных выплат. Границы источников
 показаны в [контексте](../architecture/context.md), смысл дополнений — в
@@ -24,7 +24,7 @@ WealthLedger — локальное приложение для частного
 | Посчитать полученные выплаты | [Пассивный доход](domains/income/overview.md): исполненные купоны и дивиденды за календарный период |
 | Посмотреть ожидаемые события | [Будущие выплаты](domains/income/upcoming-events.md): купоны, дивиденды, погашения и оферты по текущим позициям |
 | Увидеть общий состав инвестиций | Режим [«Все счета»](domains/portfolio/all-accounts.md), сохраняющий принадлежность строк к счетам |
-| Изучить конкретный инструмент | Поиск и страницы [акций](domains/instruments/stocks.md) и [облигаций](domains/instruments/bonds.md): рынок, личная позиция, история и события |
+| Изучить конкретный инструмент | [Скринер акций](domains/instruments/stocks.md) по параметрам каталога, страницы акций и поиск [облигаций](domains/instruments/bonds.md): рынок, личная позиция, история и события |

 ## Как связаны представления