docs: document stock screener

domains/instruments/stocks.md

@@ -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