spec: add stock screener

2026-10-11 10:44:30 +03:00
parent 13e3e53d06
commit ed6cf299f2
10 changed files with 653 additions and 0 deletions
@@ -0,0 +1,51 @@
+# Proposal
+
+## Why
+
+Раздел акций сейчас позволяет искать по тексту, но не помогает найти подходящие акции по характеристикам без заранее известного названия или тикера. Пользователю нужен скринер, который проверяет условия по каталогу доступных к покупке акций и показывает результаты без ограничения исходного набора первыми совпадениями текстового поиска.
+
+## What Changes
+
+- В разделе акций появляется поиск по выбранным параметрам с явным запуском кнопкой «Найти»; строка названия или тикера остаётся необязательным условием.
+- Результаты включают только акции, доступные для покупки и торговли через API по сведениям каталога T-Invest на момент получения списка. Это не гарантия исполнения заявки конкретного пользователя прямо сейчас.
+- Пользователь получает устойчиво упорядоченную постраничную выдачу по 30 выпусков и видит время получения списка.
+
+## Scope
+
+### In Scope
+
+- Необязательные условия по сектору, типу акции, валюте расчётов, площадке, стране риска и максимальному размеру лота; необязательный текстовый поиск.
+- Одна карточка на выпуск (ISIN), при отсутствии ISIN — отдельная карточка на инструмент; выбор представителя выпуска сохраняет ссылку на конкретный инструмент.
+- Новый поиск после изменения условий или повторного нажатия «Найти» возвращает на первую страницу; переход между страницами относится к одному полученному списку.
+- Неизвестное значение выбранного условия не считается совпадением.
+
+### Out of Scope / Non-Goals
+
+- Просмотр всех акций, включая недоступные для покупки, и переключатель «Все акции».
+- Фильтрация по цене, дивидендной доходности, капитализации и финансовым мультипликаторам.
+- Проверка личной возможности совершить сделку, её исполнения или актуального состояния биржевой сессии.
+- Изменение страниц облигаций и состава личного портфеля.
+
+## Capabilities
+
+### New Capabilities
+
+- `specs/stock-screener/spec.md` — отбор и просмотр акций по параметрам каталога.
+
+### Modified Capabilities
+
+- Нет: существующее требование `specs/online-instrument-information/spec.md` об онлайн-получении сведений остаётся в силе.
+
+## Impact
+
+Затронуты пользовательский раздел акций, получение каталога и представление результатов. Скринер зависит от доступности T-Invest; поиск и навигация по выпускам должны согласовываться с уже существующей страницей акции. Личные финансовые данные и портфель не становятся источником полного каталога для скринера.
+
+## Success Criteria
+
+- Пользователь без названия или тикера выбирает условия, нажимает «Найти» и получает полный относительно выбранных условий список доступных к покупке выпусков, а не только отфильтрованные первые результаты текстового поиска.
+- Текстовое условие совместимо с фильтрами; неизвестные значения не создают ложных совпадений.
+- Повторный поиск показывает результат нового получения каталога с отметкой времени и начинает выдачу с первой страницы; листание ранее полученного результата не даёт пропусков или дублей.
+
+## Assumptions / Dependencies
+
+- Каталог T-Invest предоставляет признаки доступности покупки и торговли через API, необходимые характеристики акций и время получения сведений. Отсутствие или недоступность онлайн-сведений не означает подтверждённого отсутствия акций.