diff --git a/.gitea/workflows/commits.yml b/.gitea/workflows/commits.yml index 2372d2c..7485d8c 100644 --- a/.gitea/workflows/commits.yml +++ b/.gitea/workflows/commits.yml @@ -2,7 +2,11 @@ name: Conventional commits on: pull_request: - types: [opened, synchronize, reopened, edited] + types: [opened, synchronize, reopened] + +concurrency: + group: specs-commits-${{ gitea.event.pull_request.number }} + cancel-in-progress: true jobs: commits: diff --git a/.gitea/workflows/security.yml b/.gitea/workflows/security.yml index abce889..05edff5 100644 --- a/.gitea/workflows/security.yml +++ b/.gitea/workflows/security.yml @@ -2,12 +2,16 @@ name: Specs security on: push: - branches: - - '**' + branches: [develop, main] pull_request: + types: [opened, synchronize, reopened] schedule: - cron: '17 5 * * *' +concurrency: + group: specs-security-${{ gitea.event_name }}-${{ gitea.event.pull_request.number || gitea.ref }} + cancel-in-progress: true + jobs: security: runs-on: ubuntu-latest diff --git a/.gitea/workflows/verify.yml b/.gitea/workflows/verify.yml index e59c2d5..cd6d109 100644 --- a/.gitea/workflows/verify.yml +++ b/.gitea/workflows/verify.yml @@ -2,8 +2,13 @@ name: Specs verify on: push: - branches: ['**'] + branches: [develop, main] pull_request: + types: [opened, synchronize, reopened] + +concurrency: + group: specs-verify-${{ gitea.event_name }}-${{ gitea.event.pull_request.number || gitea.ref }} + cancel-in-progress: true jobs: verify: diff --git a/openspec/changes/stock-screener/.openspec.yaml b/openspec/changes/stock-screener/.openspec.yaml new file mode 100644 index 0000000..368f09c --- /dev/null +++ b/openspec/changes/stock-screener/.openspec.yaml @@ -0,0 +1,2 @@ +schema: wealth-ledger-sdd-v2 +created: 2026-10-10 diff --git a/openspec/changes/stock-screener/design.md b/openspec/changes/stock-screener/design.md new file mode 100644 index 0000000..8d8a04a --- /dev/null +++ b/openspec/changes/stock-screener/design.md @@ -0,0 +1,93 @@ +# Engineering Design + +## Context and Constraints + +Текущий текстовый поиск акций использует `FindInstrument` и ограничивает результат 30 выпусками до получения подробных сведений и цены. Он не может быть источником скринера. Новый поток использует полный `Shares(INSTRUMENT_STATUS_ALL)` и целевой контракт из [System Analysis](system-analysis/analysis.md); существующие ссылки на страницы отдельных акций продолжают использовать точный UID. Справочные сведения остаются online-only, а личный портфель не является каталогом. + +## Technical Goals / Non-Goals + +- Получить полный список один раз при явном поиске, отфильтровать и зафиксировать упорядоченную выдачу до первой страницы; чтение страницы не вызывает новый поиск T-Invest. +- Изолировать результат от другого пользователя и от другого поколения его подключения; обеспечить ограниченный расход памяти без нового долговременного справочника. +- Не обогащать все инструменты ценами и фундаментальными показателями и не менять старый текстовый endpoint или поиск облигаций. + +## Implementation Impact Map + +### main + +N/A: workspace, Compose и release orchestration не меняются. + +### frontend + +Affected: раздел `/stocks` становится формой скринера с черновыми и применёнными условиями, явным запуском и страницами результата; использует опубликованный API contract. + +### backend + +Affected: отдельные операции скринера, получение списка `Shares`, фильтрация и временный результат с безопасной выдачей страниц. Текущий поиск и публичные страницы отдельных акций остаются доступными. + +### qa + +N/A: отдельного QA repository пока нет; системная проверка описана в `qa-analysis.md`. + +## Decisions + +### main + +N/A. + +### frontend + +На странице акций форма содержит необязательные текст, сектор, тип акции, валюту, площадку, страну риска и верхнюю границу лота. Черновик полей отделён от последнего применённого поиска; изменение поля само по себе не отправляет запрос и не заменяет результат. Нажатие «Найти» всегда отправляет новый POST, сбрасывает номер страницы и связывает ответ со своим `searchId`. Последующие страницы читаются GET; поздний ответ прежнего запуска не заменяет результат нового. Ошибка или потеря снимка отображается отдельно от подтверждённого пустого списка. + +Повторно использовать имеющуюся карточку `InstrumentSearchCard` с точным `instrumentUid` в ссылке. Текущая карточка цены не подходит для скринера без цены: показывать только доступные каталожные поля и не приписывать им котировку. Список опций берётся из известной предметной лексики и доступных значений каталога, если они предоставлены; фильтрация выполняется на сервере. Если динамические опции требуют дополнительного контракта, вернуть этот вопрос в System Analysis до реализации, а не добавлять неоговорённый запрос. + +### backend + +Расширить T-Bank client операцией `Shares` через существующий gRPC transport, очередь, deadline и retry. Перед выбором страницы проверить полноту полученного ответа, обязательные признаки покупки/торговли и все выбранные поля на каждом инструменте. Сначала отбор по инструментам, затем детерминированный представитель по нормализованному ISIN (при отсутствии — UID), сортировка по тикеру/UID, затем страницы. Не переносить имя, режим или характеристики между UID при дедупликации. + +Временный снимок полного результата на backend, привязанный к пользователю и revision подключения, содержит выбранные элементы и `asOf`; случайный `searchId` — только указатель, не пропуск доступа. Держать снимок в ограниченной RAM с конечным сроком жизни и пределом числа результатов. Истечение, вытеснение или рестарт дают 404 при чтении страницы и предложение начать новый поиск; никогда не пересчитывать старую страницу по новому каталогу. Для одного экземпляра backend достаточно локального хранилища в памяти; распределённое хранение не требуется текущему deployment. При каждом GET проверить ownership и revision до выдачи страницы. Повторный POST всегда обращается к T-Invest, даже при одинаковых условиях. + +### qa + +N/A. + +## Cross-cutting Implementation + +Не передавать T-Bank token в браузер или результат; служебные события регистрируют исход поиска, время каталога, количество исходных инструментов/выпусков и отсутствие снимка без полного текста поискового условия. При смене подключения прежняя revision теряет доступ к снимку независимо от того, успел ли он вытесниться. Отказ источника не публикует частичный снимок и не превращается в пустую страницу. Ограничить размер памяти/число одновременных результатов; локальный rate limiter остаётся единственным владельцем gRPC-повторов. + +## Data / Storage Changes + +Prisma schema и миграция не нужны: новый результат поиска краткоживущий и не является самостоятельной долговременной копией каталога. После перезапуска backend прежние `searchId` более недоступны. Персональные сохранённые данные не меняются. + +## Contract Implementation + +Backend DTO и Swagger metadata задают обе операции согласно [target OpenAPI](system-analysis/contracts/stock-screener.openapi.yaml). Валидация входа и статусы 400/401/404/503 соответствуют утверждённым ошибкам; success shape включает `items`, `searchId`, `asOf`, `page`, `hasNext`. Сгенерированный backend OpenAPI сравнить семантически с target contract до переноса snapshot в frontend и проверить опубликованный artifact и сгенерированные клиентские типы. Не подменять утверждённый контракт отдельным frontend DTO. Старый `GET /api/v1/stocks` остаётся совместимым. + +## Developer Verification Strategy + +Backend owner проверяет отбор по обоим флагам, все поля условий, граничный лот, дедупликацию после отбора, порядок страниц и привязку к пользователю/revision на собственных тестовых границах; отдельно HTTP validation и соответствие generated OpenAPI target. Frontend owner проверяет разделение черновика и применённых условий, повторный POST, переход между страницами и отображение пустого результата/ошибки на уровне страницы. На этапе реализации применяются соответствующие repo-local verify gates; проверки не требуют живого T-Invest token. + +## UI/UX Package + +**Applicability and scope:** new/changed UI для страницы `/stocks`. Пакет полностью inline; графические материалы не требуются. + +**Package revision:** 1, `wealth-ledger-specs:openspec/changes/stock-screener/design.md`. + +**Screens, states and interactions:** необязательный текст, шесть фильтров и кнопка «Найти»; до запуска нет утверждения об отсутствии акций. После запуска — загрузка, карточки и время списка либо подтверждённое пустое состояние; ошибка источника отдельно с возможностью повторить поиск. Кнопки перехода к страницам показывают тот же снимок; при недоступном снимке — предложение нового поиска. Черновые изменения не меняют показанный результат до нажатия. Формулировка доступности указывает на признаки каталога, а не на возможность немедленной сделки. + +**Responsive behavior:** форма перестраивается в одну колонку на узком экране, карточки и навигация доступны без горизонтального прокручивания. + +**Reused source and differences:** повторно используются текущий раздел акций, его компоненты карточки и состояния загрузки/ошибки; точный вход в текущий AS-IS — `frontend/src/pages/stocks/ui/StocksPage/StocksPage.view.tsx`, `frontend/src/features/instrument-search/ui/InstrumentSearch/InstrumentSearch.view.tsx`. Скринер заменяет автоматический поиск при вводе на явный запуск и не обязан показывать цену. Долговременное обоснование текущего поведения — `docs/domains/instruments/stocks.md`; сам пакет остаётся по locator версии выше и доступен после архива. + +## Risks / Trade-offs + +- Полный `Shares(ALL)` может быть объёмным; предельное потребление памяти и допустимую длительность live-поиска нужно измерить до rollout. Локальный снимок экономит повторные вызовы и сохраняет порядок, но теряется при рестарте или вытеснении; предусмотрен явный повторный поиск. +- Опции фильтров по сектору/стране могут изменяться вместе с каталогом. Нельзя обещать полноту пользовательского выбора, если показывать только фиксированные значения без подтверждения состава каталога. +- Поток не знает права конкретного счёта и состояние торгов; текст интерфейса не должен обещать немедленную покупку. + +## Migration / Rollout / Rollback + +Сначала backend реализует и публикует совместимый контракт, затем frontend получает новый artifact и использует скринер; действующий текстовый endpoint остаётся доступным. При откате frontend продолжает работать со старым endpoint; временные снимки можно удалить без миграции. Изменений личных данных и разрушительных миграций нет. + +## Solution Assessment + +Сопоставлены: (1) фильтрация первых 30 результатов `FindInstrument` — дешёвая, но неверная полнота, отклонена; (2) сохранённый постоянный каталог с индексацией — облегчает массовые запросы, но противоречит online-only границе и добавляет синхронизацию; (3) полный online `Shares` и ограниченный краткоживущий снимок результата — соответствует полноте и стабильным страницам при текущем single-instance deployment. Последний вариант принят для изменения. При реальной потребности в нескольких экземплярах потребуется отдельное согласование shared storage или stateless модели страниц, а не молчаливое изменение контракта. diff --git a/openspec/changes/stock-screener/docs-impact.md b/openspec/changes/stock-screener/docs-impact.md new file mode 100644 index 0000000..bb8366c --- /dev/null +++ b/openspec/changes/stock-screener/docs-impact.md @@ -0,0 +1,32 @@ +# Documentation Impact + +## Summary + +После реализации нужна актуализация существующих AS-IS страниц: раздел «Акции» перестанет быть только текстовым поиском. Целевой контракт и мотивы выбора временного снимка остаются в change; документация описывает получившуюся функцию и границы данных. + +## Documentation Changes + +| Action | Target | Category | Resulting AS-IS | Source | Verification | +| --- | --- | --- | --- | --- | --- | +| update | `docs/domains/instruments/stocks.md` | domain | Описать скринер с явной кнопкой поиска, необязательным текстом и шестью условиями, отбор только по подтверждённым признакам покупки и торговли через API, одну карточку на выпуск, стабильные страницы по 30 и время получения каталога. Разъяснить, что это не проверка возможности немедленной сделки и что подтверждённая пустота отличается от отказа источника. Прежнее описание автопоиска на `/stocks` заменить на фактическое поведение; сохранённый текстовый API и переход к отдельной акции описывать отдельно. | [Delta spec](specs/stock-screener/spec.md), [System Analysis](system-analysis/analysis.md), [Design](design.md) | Сверить страницу с реализованным UI, порядком выдачи и доступными полями; не называть признак покупки гарантией сделки или цену условием скринера. | +| update | `docs/integrations/tbank.md` | integration | Кратко объяснить источник полного online-каталога для скринера и смысл признаков доступности; не смешивать справочный каталог с личным портфелем или торговым статусом. | [System Analysis](system-analysis/analysis.md#contracts) | Сверить с фактическим вызовом полного списка акций и опубликованным поведением backend, не дублировать протокол целиком. | +| update | `docs/architecture/http-api.md` | architecture | Отметить семантику нового запуска поиска и чтения страницы зафиксированного результата: повторный запуск получает новый список, чтение страницы сохраняет состав и время, недоступный результат не становится пустым. Ссылаться на backend-generated OpenAPI для точной формы операций. | [Target contract](system-analysis/contracts/stock-screener.openapi.yaml), [System Analysis](system-analysis/analysis.md#data-and-state-semantics) | Сверить описание с опубликованным backend OpenAPI и фактической обработкой ошибок, не переносить YAML в docs. | +| update | `docs/overview.md` | overview | Задача «Изучить конкретный инструмент» включает подбор акций по параметрам наряду с открытием отдельной акции и поиском облигаций. | [Proposal](proposal.md), [Delta spec](specs/stock-screener/spec.md) | Убедиться, что обзор ссылается на актуальную страницу акций и не обещает фильтры по финансовым показателям. | +| update | `docs/README.md` | overview | Строка навигации «Акции и облигации» явно называет скринер акций, не создавая новую страницу ради функции. | [Delta spec](specs/stock-screener/spec.md) | Проверить ссылку на существующий раздел акций и согласованность с обзором. | +| update | `docs/glossary.md` | domain | Определить «Скринер акций» как подбор выпусков по условиям из каталога с указанием времени получения; отличить его от текстового поиска конкретного инструмента, личного портфеля и подтверждения исполнимости сделки. | [Delta spec](specs/stock-screener/spec.md), [System Analysis](system-analysis/analysis.md#data-and-state-semantics) | Определение не содержит маршрутов, классов, механизма хранения или перечня HTTP-полей. | + +## Diagram Promotion + +По умолчанию не переносить `system-analysis/sequences/stock-screener.mmd`: он объясняет согласование change и не нужен для понимания устойчивого пользовательского поведения сверх тематической страницы. Если после реализации поток страниц окажется существенным для AS-IS архитектуры, пересмотреть отдельно по фактическому состоянию, а не копировать диаграмму автоматически. + +## ADR Decision + +N/A: краткоживущий снимок результатов — обратимый способ обеспечить стабильные страницы при текущем одном экземпляре backend. Альтернативы и последствия уже записаны в Design; нового долгоживущего инфраструктурного стандарта не вводится. + +## Glossary / Navigation Impact + +Добавить один термин в существующий `docs/glossary.md`; обновить существующие строки `docs/README.md` и `docs/overview.md`. Новая страница или раздел индекса не требуются. + +## No-Change Rationale + +`docs/architecture/cross-cutting/data-freshness.md` уже различает online-справочные сведения и сохранённые личные данные; обновление нужно лишь при изменении этой границы при реализации. Прочие страницы, включая облигации, не затрагиваются. Канонический OpenAPI в docs не создаётся. diff --git a/openspec/changes/stock-screener/proposal.md b/openspec/changes/stock-screener/proposal.md new file mode 100644 index 0000000..75cdba9 --- /dev/null +++ b/openspec/changes/stock-screener/proposal.md @@ -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, необходимые характеристики акций и время получения сведений. Отсутствие или недоступность онлайн-сведений не означает подтверждённого отсутствия акций. diff --git a/openspec/changes/stock-screener/qa-analysis.md b/openspec/changes/stock-screener/qa-analysis.md new file mode 100644 index 0000000..c2ed321 --- /dev/null +++ b/openspec/changes/stock-screener/qa-analysis.md @@ -0,0 +1,58 @@ +# QA Analysis + +## Verification Scope + +### In Scope + +Новая capability `stock-screener`: полный online-поиск доступных к покупке акций, шесть фильтров и необязательный текст, выпускная дедупликация, стабильные страницы и различение подтверждённой пустоты от ошибки. Проверка перехода по точному инструменту и совместимости старых адресов акций. + +### Out of Scope + +Финансовые показатели, исполнение заявки, личная возможность покупки, изменение облигаций, проверка цены или актуальности биржевой сессии. + +## Coverage Matrix + +| Requirement / Scenario в `specs/stock-screener/spec.md` | Проверка на уровне системы | +| --- | --- | +| «Скринер ищет среди доступных к покупке акций» / «Поиск без названия или тикера» | Отправить пустые условия; убедиться, что результат получен без текста и содержит выпуски из полного доступного каталога, включая кандидатов вне первых 30 совпадений старого поиска; показать время списка. | +| Тот же requirement / «Акция недоступна для покупки» | Сопоставить инструменты со всеми комбинациями двух флагов: в результат попадают только подтверждённые `true` + `true`. | +| «Условия скринера применяются совместно» / «Несколько условий без текста», «Текст совместно с характеристиками» | Выбрать по очереди и в сочетании все шесть условий, дополнить названием/тикером; проверить пересечение по полному каталогу до страниц. | +| Тот же requirement / «Неизвестный сектор», «Граница максимального лота» | Отсутствующее выбранное свойство исключает результат; лот, равный границе, включён, больший и неизвестный исключены. | +| «Результат представляет отдельные выпуски» / три сценария | Один ISIN в нескольких режимах даёт одну карточку; только подходящий режим даёт ссылку на него; разные ISIN и инструменты без ISIN не склеиваются. | +| «Страницы относятся к одному результату поиска» / «Переход к следующей странице» | Выдача более 30 выпусков: страницы имеют общий `asOf`, нет повторов/пропусков, порядок по тикеру и UID; каждая содержит не более 30. | +| Тот же requirement / «Повторный поиск», «Поля изменены, но поиск не запущен» | Черновые поля не подменяют выдачу; повторное «Найти» запускает новый поиск, первую страницу и новое время списка. | +| «Отсутствие совпадений отличается от недоступности поиска» / оба сценария | Успешный поиск без совпадений показывает пустое состояние; недоступный каталог — ошибку с возможностью повторить, без утверждения об отсутствии акций. | + +## Cross-system Verification + +Сопоставить обе HTTP-операции с [утверждённым target contract](system-analysis/contracts/stock-screener.openapi.yaml): обязательность полей, схема ошибок и статусы, авторизация, страницы одного `searchId`. Проверить отказ или неполноту источника, смену подключения между страницами, недоступный/чужой `searchId`, устаревший ответ прежнего поиска после нового; ни один случай не должен возвращать пустую подтверждённую страницу или пересчитывать старый результат. Проверить, что `Shares` запрашивается для полного каталога до отбора, а переход «Далее» не запускает новый поиск. Дублирования/перестановки на границе страниц не допускаются. + +## Risk-based Priorities + +1. Критично: ложная полнота при фильтрации только первых 30, неправильно подтверждённая доступность покупки, выдача чужого или старого результата подключения. +2. Высокий риск: дубли/пропуски выпуска между страницами, смешение атрибутов разных UID, неполный ответ как успешная пустота. +3. Средний риск: несоответствие текста и фильтров, различие времени снимка на страницах, сломанные ссылки на отдельную акцию и старый текстовый маршрут. + +## Test Data and Environment Needs + +Управляемый полный каталог со следующими группами: более 30 подходящих выпусков; одинаковый ISIN в разных режимах, разные ISIN одного эмитента и отсутствующий ISIN; значения каждого фильтра, пропуски полей, пограничный размер лота; комбинации двух флагов покупки и торговли. Два пользователя и два последовательных подключения одного пользователя позволяют проверить область доступа. Предусмотреть системный сценарий отказа или неполного ответа T-Invest и недоступного результата между страницами; токены и личные финансовые данные для этого не нужны. + +## Manual / Exploratory Scope + +Проверить поиск пустой формой и заполненной формой на широком и узком экране; состояние до поиска, загрузку, подтверждённую пустоту, ошибку и повтор. С клавиатуры пройти поля, запуск и навигацию страниц; убедиться, что активные условия и время результата различимы, ссылка ведёт к выбранной акции, а подпись «доступна к покупке» не выдаёт каталожный признак за обещание сделки. + +## Automation Candidates + +Black-box проверки HTTP-контракта и сценариев поиска/листинга/доступа; сквозной сценарий формы, фильтров, повторного запуска и страницы акции. Repository automation: **deferred until QA repo exists**. Этот artifact не определяет внутренние тесты frontend/backend. + +## Observability Verification + +На системной границе проверить отличимость успешного пустого поиска от отказа источника, фиксацию `asOf` и количества исходных/подходящих выпусков при успехе, регистрации недоступного результата и отказа чужому пользователю. Секрет подключения и полный текст запроса не должны попадать в наблюдаемые события. + +## Regression Impact + +Старый текстовый `GET /api/v1/stocks?query=...`, прямые страницы по тикеру/UID и поиск облигаций остаются действующими. Смена подключения по-прежнему отделяет личные данные; новая выдача акций не меняет портфель. + +## Gaps / Blockers + +Для управляемой системной проверки нужен способ получить предсказуемый каталог и вызвать отказ источника и потерю результата: тестируемость среды адресуется Engineering Design, без требования к внутренней реализации. Динамическая полнота опций фильтров не определена контрактом; если от неё зависит достижимость акций пользователем, вернуть вопрос в System Analysis до approval Design. diff --git a/openspec/changes/stock-screener/specs/stock-screener/spec.md b/openspec/changes/stock-screener/specs/stock-screener/spec.md new file mode 100644 index 0000000..139d8f7 --- /dev/null +++ b/openspec/changes/stock-screener/specs/stock-screener/spec.md @@ -0,0 +1,76 @@ +## Purpose + +Определяет поиск доступных к покупке акций по характеристикам всего доступного каталога, просмотр совпавших выпусков и навигацию по результату поиска. + +## ADDED Requirements + +### Requirement: Скринер ищет среди доступных к покупке акций +Система SHALL по нажатию «Найти» искать по всему доступному на момент запроса каталогу акций, не ограничивая исходный набор первыми совпадениями текстового поиска. В результаты MUST включаться только акции, для которых в полученных сведениях подтверждены и доступность покупки, и возможность торговли через API. Скринер MUST показывать время получения списка и MUST NOT представлять эти признаки как гарантию, что конкретный пользователь сможет исполнить заявку прямо сейчас. + +#### Scenario: Поиск без названия или тикера +- **WHEN** пользователь не ввёл текст и нажал «Найти» +- **THEN** система ищет по доступному каталогу и показывает выпуски, удовлетворяющие условиям и обоим признакам доступности + +#### Scenario: Акция недоступна для покупки +- **WHEN** у акции отсутствует подтверждение доступности покупки или торговли через API +- **THEN** система не включает её в результаты скринера независимо от остальных совпавших условий + +### Requirement: Условия скринера применяются совместно +Система SHALL позволять независимо задавать необязательные условия по сектору, типу акции, валюте расчётов, площадке, стране риска и максимальному количеству бумаг в лоте, а также необязательный текстовый запрос по названию или тикеру. После нажатия «Найти» система SHALL возвращать только акции, удовлетворяющие всем заданным условиям. Отсутствующее или неизвестное значение выбранного условия MUST NOT считаться совпадением. + +#### Scenario: Несколько условий без текста +- **WHEN** пользователь выбрал сектор и валюту, оставил текст пустым и нажал «Найти» +- **THEN** в результате остаются только доступные к покупке акции выбранного сектора и валюты + +#### Scenario: Текст совместно с характеристиками +- **WHEN** пользователь ввёл название или тикер, выбрал тип акции и нажал «Найти» +- **THEN** система отбирает совпадения по тексту и типу среди доступного каталога до разделения результата на страницы + +#### Scenario: Неизвестный сектор +- **WHEN** пользователь выбрал сектор, а у акции сектор не указан +- **THEN** акция не считается совпадением + +#### Scenario: Граница максимального лота +- **WHEN** задано максимальное количество бумаг в лоте +- **THEN** акции с известным размером лота не больше указанного включаются при соблюдении остальных условий, а акции с неизвестным или большим лотом исключаются + +### Requirement: Результат представляет отдельные выпуски +Система SHALL показывать не более одной карточки для каждого выпуска с одинаковым ISIN; акции с разными ISIN SHALL оставаться отдельными результатами. При отсутствии ISIN отдельным результатом SHALL быть инструмент с собственным идентификатором. Представитель выпуска MUST выбираться среди инструментов, удовлетворяющих заданным условиям, а карточка MUST вести к выбранному инструменту. + +#### Scenario: Несколько подходящих режимов одного выпуска +- **WHEN** несколько инструментов с одним ISIN удовлетворяют всем условиям +- **THEN** система показывает одну карточку выпуска со ссылкой на один из этих инструментов + +#### Scenario: Один режим не соответствует условиям +- **WHEN** два инструмента имеют один ISIN, но только один удовлетворяет всем условиям +- **THEN** карточка выпуска ведёт к соответствующему условиям инструменту + +#### Scenario: Разные выпуски одного эмитента +- **WHEN** обыкновенная и привилегированная акции имеют разные ISIN и обе удовлетворяют условиям +- **THEN** система показывает их как отдельные результаты + +### Requirement: Страницы относятся к одному результату поиска +Система SHALL упорядочивать совпадения по тикеру, затем по идентификатору инструмента, и показывать не более 30 выпусков на странице. Переход между страницами одного поиска MUST сохранять состав и порядок полученного результата без пропусков и повторов. Изменение полей без нажатия «Найти» MUST NOT заменять текущий результат; повторное нажатие «Найти», в том числе без изменения условий, SHALL запускать новый поиск и возвращать к первой странице. + +#### Scenario: Переход к следующей странице +- **WHEN** пользователь открывает следующую страницу полученного результата +- **THEN** он видит следующие до 30 выпусков в том же порядке и с тем же временем получения списка, без повторения выпусков предыдущей страницы + +#### Scenario: Повторный поиск +- **WHEN** пользователь изменил условия или оставил их прежними и нажал «Найти» повторно +- **THEN** система получает новый результат с новым временем получения списка и показывает его первую страницу + +#### Scenario: Поля изменены, но поиск не запущен +- **WHEN** пользователь изменяет условия и ещё не нажал «Найти» +- **THEN** ранее полученные страницы не подменяются результатом для новых условий + +### Requirement: Отсутствие совпадений отличается от недоступности поиска +Система MUST показывать пустой результат только после успешного поиска без совпадений. Если получить сведения для поиска не удалось, система SHALL сообщать о недоступности поиска и MUST NOT выдавать отсутствие акций за подтверждённый результат. + +#### Scenario: Успешный поиск без совпадений +- **WHEN** поиск завершился успешно, но ни одна акция не удовлетворяет условиям +- **THEN** система показывает, что подходящие акции не найдены + +#### Scenario: Источник каталога недоступен +- **WHEN** поиск не может получить сведения о каталоге +- **THEN** система сообщает об ошибке получения результата, не утверждая, что подходящих акций нет diff --git a/openspec/changes/stock-screener/system-analysis/analysis.md b/openspec/changes/stock-screener/system-analysis/analysis.md new file mode 100644 index 0000000..2d6c6d3 --- /dev/null +++ b/openspec/changes/stock-screener/system-analysis/analysis.md @@ -0,0 +1,67 @@ +# System Analysis + +## Requirement Coverage + +| Требование delta spec | Межсистемная граница и поток | +| --- | --- | +| Скринер ищет среди доступных к покупке акций | Запуск поиска, полный список Shares, обязательные признаки и время получения: [поиск](sequences/stock-screener.mmd), [контракт](contracts/stock-screener.openapi.yaml). | +| Условия скринера применяются совместно | Необязательные параметры в запросе, отбор по всему полученному списку до разделения на страницы; неизвестное не совпадает. | +| Результат представляет отдельные выпуски | После отбора группировка по нормализованному ISIN, иначе по UID; карточка выбранного представителя с точным UID. | +| Страницы относятся к одному результату поиска | Создание нового результата при каждом запуске, чтение последующих страниц того же результата по непрозрачному идентификатору; не более 30 выпусков на страницу. | +| Отсутствие совпадений отличается от недоступности поиска | Успешный пустой набор имеет `200` и `items: []`; ошибка каталога или потеря результата возвращает ошибку, не пустую страницу. | + +## Systems and Responsibilities + +- Пользователь задаёт условия и запускает поиск в приложении. +- Frontend хранит черновик условий отдельно от применённого поиска, показывает карточки, время получения и управляет навигацией по страницам. Он не отбирает только первые найденные строки и не склеивает результаты разных поисков. +- Backend проверяет локальную сессию и действующее подключение T-Bank, получает полный список акций, применяет обязательные признаки и выбранные условия, выбирает один подходящий инструмент на выпуск, фиксирует результат и выдаёт страницы. Инструмент и личный портфель — разные данные. +- T-Invest поставляет список акций с характеристиками и признаками доступности. Это источник сведений для нового поиска, но не подтверждение доступа конкретного счёта к сделке. + +## Interaction Flows + +[stock-screener.mmd](sequences/stock-screener.mmd) описывает новый поиск без текста, переход к следующей странице того же результата, повторный поиск, неподтверждённую доступность инструмента, отказ внешнего источника и отсутствие сохранённого результата. Чтение карточки выбранной акции после перехода по ссылке относится к существующему маршруту инструмента. + +## Contracts + +- **Frontend → Backend**, HTTP JSON, новая пара операций `POST /api/v1/stocks/screener/search` и `GET /api/v1/stocks/screener/search/{searchId}`. Целевой контракт версии `/api/v1`: [stock-screener.openapi.yaml](contracts/stock-screener.openapi.yaml). Каждый POST — новый поиск даже при совпадающих параметрах; повтор того же POST не идемпотентен в смысле получения данных. GET следующей страницы не повторяет обращение к каталогу. Ответ содержит `items`, `asOf`, `searchId`, `page`, `hasNext`. `searchId` непрозрачен и принадлежит аутентифицированному пользователю и текущему подключению; `page` — номер страницы с единицы. Контракт не задаёт срок хранения результата и не позволяет подменить применённые условия в запросе страницы. +- **Backend → T-Invest**, существующий gRPC over TLS: `InstrumentsService.Shares(InstrumentsRequest)` с `instrument_status = INSTRUMENT_STATUS_ALL` возвращает список `Share`. Базовый список не должен заранее исключать выпуск, у которого оба необходимых признака подтверждены. Отбор по сектору, типу, валюте, площадке, стране риска и лоту выполняется после получения всего списка: этих параметров нет в `InstrumentsRequest`. Ожидаются `buy_available_flag`, `api_trade_available_flag`, `uid`, `isin`, `ticker`, `name`, `sector`, `share_type`, `currency`, `real_exchange`, `country_of_risk`, `lot`. `FindInstrument` с обязательной поисковой строкой не является источником полного скринера. +- Контракт старого `GET /api/v1/stocks?query=...` не меняется в этой версии. Его обязательный текст, ограничение и текущая форма ответа продолжают работать для существующих потребителей; новое представление не выводится из его первых 30 результатов. + +## Data and State Semantics + +Источник истины для нового поиска — полученный целиком ответ Shares, а не накопленные инструменты портфеля или прежние текстовые запросы. Backend фиксирует полный набор совпавших выпусков и время успешного получения каталога до выдачи первой страницы. Пустая выдача подтверждается только успешным получением списка. Результат поиска отделён от долговременного самостоятельного справочника инструментов; правила существующего `online-instrument-information` остаются в силе. + +Признаки `buy_available_flag = true` и `api_trade_available_flag = true` обязательны вместе. Неизвестное либо неподтверждённое значение любого из них исключает инструмент. Эти признаки относятся к снимку каталога, а не к биржевой сессии, счёту пользователя или исполнению заявки. + +Применённые условия сравниваются с данными конкретного инструмента: текст — с названием или тикером, выбранные категории — с соответствующими значениями, `maxLot` — с известным положительным размером лота не больше границы. Отсутствие выбранного свойства исключает инструмент; отсутствие незаданного свойства не мешает совпадению. Страна риска — код страны основного бизнеса, а не юрисдикция регистрации. «Площадка» означает `real_exchange`, а не секцию/режим `class_code` и не дилерский `instrument_exchange`. + +После отбора инструменты с одинаковым нормализованным ISIN представляют один выпуск; пустой ISIN заменяется точным UID, а не общим пустым ключом. При нескольких подходящих инструментах одного выпуска выбор представителя должен быть детерминированным; он определяет ссылку и все сведения карточки, данные режимов не смешиваются. Затем выпуски упорядочиваются по тикеру и UID выбранного инструмента и делятся на страницы по 30. `asOf` и порядок неизменны для всех страниц одного `searchId`. Повторное нажатие «Найти» не использует старый результат как новый, даже если условия совпадают. + +## Error and Recovery Semantics + +- Неверные границы или формат условий / страницы: `400` с публичной ошибкой в стандартном профиле. Отсутствующая сессия: `401`. Отсутствующее/недействительное подключение T-Bank: соответствующая ошибка доступа подключения; секрет и upstream-исключение не раскрываются. +- Источник каталога недоступен, возвращает неполный или неинтерпретируемый список: ошибка запроса, не `items: []`. При новом поиске предыдущий успешно показанный результат не становится доказательством нового поиска. Пользователь может повторить запуск. +- Идентификатор результата больше не доступен или не принадлежит текущему пользователю/подключению: ошибка вместо пустой страницы или пересчёта по новому каталогу. Frontend предлагает выполнить новый поиск. Потеря результата в рамках действующего поиска — техническая деградация; время и данные прошлого результата не выдаются за новый. +- Нет утверждений о «прямо сейчас можно купить»: статус торгов и права конкретного счёта не проверяются. Недоступная цена/логотип не меняет состав подходящих выпусков. + +## Observability Semantics + +Существенны попытка нового поиска, успешное получение каталога (`asOf`, число исходных инструментов, подходящих выпусков), технический отказ источника, чтение страницы недоступного результата и отказ доступа к чужому результату. Секрет подключения, пользовательский токен и полный текст запроса не нужны для диагностики. Успешный пустой результат отличим от отказа источника. + +## Security and NFR at System Boundaries + +Обе HTTP-операции требуют локальной аутентификации; доступ к T-Invest выполняется только на backend с токеном текущего подключения. Идентификатор результата не является правом доступа и не переносит данные между пользователями или поколениями подключения. Полный каталог нужен до пагинации, чтобы 30 карточек не превратились в ограничение области поиска. Значение `asOf` относится к получению каталога, не к актуальности возможности купить позже. Количественная задержка/SLA для получения списка пока не установлена; не следует обещать мгновенную выдачу при сбое внешнего сервиса. + +## Compatibility / Migration + +Новый маршрут добавляется без изменения действующего текстового поиска и адресов отдельных акций. Frontend переходит на новый контракт для скринера; старый маршрут остаётся доступен его текущим потребителям. После реализации backend-generated OpenAPI должен быть семантически совместим с целевым контрактом в архивируемом change. Документ в этом change не становится вторым постоянным источником исполняемой схемы. + +## Durable Documentation Candidates + +- Новое назначение раздела акций, набор фильтров и смысл «доступна к покупке по данным каталога» в описании домена акций. +- Граница между online-каталогом, страницей акции и личным портфелем; снимок результата, время получения и стабильные страницы. +- Семантика новых HTTP-операций на уровне описания API без дублирования machine-readable OpenAPI. Окончательный выбор принадлежит `docs-impact`. + +## Open Questions + +Нет блокирующих вопросов по согласованным границам поведения. Выбор механизма хранения результата и допустимой внутренней длительности его доступности принадлежит Engineering Design; потеря результата остаётся ошибкой, а не молчаливой заменой поиска. diff --git a/openspec/changes/stock-screener/system-analysis/contracts/stock-screener.openapi.yaml b/openspec/changes/stock-screener/system-analysis/contracts/stock-screener.openapi.yaml new file mode 100644 index 0000000..18dd447 --- /dev/null +++ b/openspec/changes/stock-screener/system-analysis/contracts/stock-screener.openapi.yaml @@ -0,0 +1,177 @@ +openapi: 3.0.3 +info: + title: WealthLedger stock screener target contract + version: 1.0.0 + description: Целевой контракт change; исполняемый HTTP-контракт после реализации генерирует backend. +paths: + /api/v1/stocks/screener/search: + post: + operationId: createStockScreenerSearch + summary: Получить новый результат скринера по полному каталогу акций + security: + - bearer: [] + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/StockScreenerCriteria' + responses: + '200': + description: Первая страница нового результата, включая подтверждённый пустой список + content: + application/json: + schema: + $ref: '#/components/schemas/StockScreenerPage' + '400': + $ref: '#/components/responses/Problem' + '401': + $ref: '#/components/responses/Problem' + '503': + $ref: '#/components/responses/Problem' + /api/v1/stocks/screener/search/{searchId}: + get: + operationId: readStockScreenerPage + summary: Прочитать страницу того же зафиксированного результата + security: + - bearer: [] + parameters: + - name: searchId + in: path + required: true + schema: + type: string + description: Непрозрачный идентификатор результата; не является полномочием доступа. + - name: page + in: query + required: true + schema: + type: integer + minimum: 1 + description: Номер страницы с единицы. Условия поиска при чтении страницы не меняются. + responses: + '200': + description: Страница зафиксированного результата с тем же временем получения каталога + content: + application/json: + schema: + $ref: '#/components/schemas/StockScreenerPage' + '400': + $ref: '#/components/responses/Problem' + '401': + $ref: '#/components/responses/Problem' + '404': + $ref: '#/components/responses/Problem' + '503': + $ref: '#/components/responses/Problem' +components: + securitySchemes: + bearer: + type: http + scheme: bearer + responses: + Problem: + description: Ошибка в текущем публичном профиле WealthLedger; отсутствие результата не кодируется пустым списком. + content: + application/problem+json: + schema: + $ref: '#/components/schemas/Problem' + schemas: + Problem: + type: object + required: [status, code] + properties: + status: + type: integer + code: + type: string + title: + type: string + detail: + type: string + StockScreenerCriteria: + type: object + description: Все условия необязательны; отсутствие полей означает поиск по всем доступным к покупке акциям каталога. + additionalProperties: false + properties: + query: + type: string + maxLength: 80 + description: Необязательная подстрока названия или тикера; пустая строка равнозначна отсутствию условия. + sector: + type: string + minLength: 1 + shareType: + type: string + minLength: 1 + currency: + type: string + minLength: 1 + realExchange: + type: string + minLength: 1 + description: Реальная площадка исполнения, не код торгового режима. + countryOfRisk: + type: string + minLength: 1 + description: Код страны основного бизнеса. + maxLot: + type: integer + minimum: 1 + description: Включительная верхняя граница числа бумаг в лоте. + StockScreenerPage: + type: object + required: [searchId, asOf, page, hasNext, items] + properties: + searchId: + type: string + description: Идентификатор только этого поиска, ограничен пользователем и подключением. + asOf: + type: string + format: date-time + description: Время получения полного списка акций от T-Invest, одинаковое на всех страницах результата. + page: + type: integer + minimum: 1 + hasNext: + type: boolean + items: + type: array + maxItems: 30 + items: + $ref: '#/components/schemas/StockScreenerItem' + StockScreenerItem: + type: object + required: [instrumentUid, name, ticker, isin, shareType, sector, currency, realExchange, countryOfRisk, lot] + properties: + instrumentUid: + type: string + format: uuid + description: Точный выбранный инструмент для ссылки на страницу акции; нельзя подменять неоднозначным тикером. + name: + type: string + ticker: + type: string + nullable: true + isin: + type: string + nullable: true + shareType: + type: string + nullable: true + sector: + type: string + nullable: true + currency: + type: string + nullable: true + realExchange: + type: string + nullable: true + countryOfRisk: + type: string + nullable: true + lot: + type: integer + minimum: 1 + nullable: true diff --git a/openspec/changes/stock-screener/system-analysis/sequences/stock-screener.mmd b/openspec/changes/stock-screener/system-analysis/sequences/stock-screener.mmd new file mode 100644 index 0000000..9278c71 --- /dev/null +++ b/openspec/changes/stock-screener/system-analysis/sequences/stock-screener.mmd @@ -0,0 +1,40 @@ +sequenceDiagram + actor U as Пользователь + participant F as WealthLedger frontend + participant B as WealthLedger backend + participant T as T-Invest API + U->>F: Выбирает условия и нажимает «Найти» + F->>B: POST /api/v1/stocks/screener/search (условия) + B->>B: Проверка сессии и подключения + alt Нет доступа или неверные условия + B-->>F: 400 / 401 / ошибка подключения + F-->>U: Объяснение ошибки без нового результата + else Доступ подтверждён + B->>T: Shares (INSTRUMENT_STATUS_ALL) + alt Каталог получен полностью + T-->>B: Share[] + B->>B: Проверить доступность, фильтры, выпуски, сортировку и зафиксировать asOf + B-->>F: 200, items (до 30), searchId, asOf, hasNext + F-->>U: Первая страница или подтверждённый пустой результат + opt Есть следующая страница + U->>F: Далее + F->>B: GET /api/v1/stocks/screener/search/{searchId}?page=2 + alt Результат доступен тому же пользователю и подключению + B-->>F: 200, следующие items, тот же asOf + F-->>U: Следующая страница без пропусков и повторов + else Результат недоступен или сменилось подключение + B-->>F: Ошибка без пересчёта по новому каталогу + F-->>U: Результат недоступен, предложить новый поиск + end + end + else Каталог недоступен или неполон + T-->>B: Ошибка / неполные сведения + B-->>F: Ошибка поиска, не пустая выборка + F-->>U: Поиск недоступен, можно повторить + end + end + opt Условия изменены или нажат повторный поиск + U->>F: Нажимает «Найти» + F->>B: Новый POST с текущими условиями + Note over B,T: Новый список и новая первая страница без подмены прежнего searchId + end diff --git a/openspec/changes/stock-screener/tasks.md b/openspec/changes/stock-screener/tasks.md new file mode 100644 index 0000000..f951c74 --- /dev/null +++ b/openspec/changes/stock-screener/tasks.md @@ -0,0 +1,57 @@ +# Tasks + +## 1. Каталог и отбор + +- [x] 1.1 [backend] Получать полный список акций T-Invest для каждого нового запуска скринера, сохраняя действующие границы доступа и обработки недоступности источника. + - **Covers:** `stock-screener` — `Скринер ищет среди доступных к покупке акций`; `stock-screener` — `Отсутствие совпадений отличается от недоступности поиска`. + - **Source:** `system-analysis/analysis.md` — Contracts, Error and Recovery Semantics; `design.md` — Decisions/backend. + - **Verification:** управляемый ответ Shares с подходящей акцией за пределами первых 30 текстовых совпадений и отказом источника; backend developer tests и repo-local verify. + - **Depends on:** none + +- [x] 1.2 [backend] Применять обязательные признаки доступности и все необязательные условия к полному списку, выбирать только соответствующего условиям представителя каждого выпуска и упорядочивать результаты до разделения на страницы. + - **Covers:** `stock-screener` — `Скринер ищет среди доступных к покупке акций`; `stock-screener` — `Условия скринера применяются совместно`; `stock-screener` — `Результат представляет отдельные выпуски`. + - **Source:** `specs/stock-screener/spec.md` — соответствующие Requirements; `system-analysis/analysis.md` — Data and State Semantics; `design.md` — Decisions/backend. + - **Verification:** backend developer tests проверяют пересечение условий, неизвестное значение, включительную границу лота, одинаковый и разный ISIN, отсутствие ISIN и ссылку на точный выбранный UID. + - **Depends on:** 1.1 + +## 2. Зафиксированные страницы и публичный контракт + +- [x] 2.1 [backend] Предоставить новый поиск и чтение страниц одного ограниченного по времени результата с привязкой к пользователю и поколению подключения, отличая пустой успешный поиск от ошибки и не пересчитывая старые страницы. + - **Covers:** `stock-screener` — `Страницы относятся к одному результату поиска`; `stock-screener` — `Отсутствие совпадений отличается от недоступности поиска`; `stock-screener` — `Результат представляет отдельные выпуски`. + - **Source:** `system-analysis/contracts/stock-screener.openapi.yaml`; `system-analysis/analysis.md` — Error and Recovery Semantics, Security and NFR at System Boundaries; `design.md` — Decisions/backend, Data / Storage Changes. + - **Verification:** backend HTTP и access checks: до 30 элементов, одинаковые `asOf` и порядок на следующих страницах, новый POST создаёт новый результат, чужой/истёкший `searchId` и смена подключения не выдают данные. + - **Depends on:** 1.2 + +- [x] 2.2 [backend] Опубликовать сгенерированный OpenAPI для операций скринера и подтвердить его семантическую совместимость с утверждённым target contract, сохранив старый текстовый поиск. + - **Covers:** `stock-screener` — `Условия скринера применяются совместно`; `stock-screener` — `Страницы относятся к одному результату поиска`; `stock-screener` — `Отсутствие совпадений отличается от недоступности поиска`. + - **Source:** `system-analysis/contracts/stock-screener.openapi.yaml`; `design.md` — Contract Implementation, Migration / Rollout / Rollback. + - **Verification:** `npm run openapi:generate`, `npm run test:openapi-contract`, сравнение двух маршрутов, запросов, ответов и ошибок с target contract; backend repo-local verify и regression старого GET. + - **Depends on:** 2.1 + +## 3. Пользовательский поиск + +- [x] 3.1 [frontend] Подключить экран акций к опубликованному контракту: сохранять черновые условия отдельно от применённых, отправлять новый поиск только по кнопке и получать страницы по `searchId` без подмены результата поздним ответом. + - **Covers:** `stock-screener` — `Условия скринера применяются совместно`; `stock-screener` — `Страницы относятся к одному результату поиска`. + - **Source:** `design.md` — Decisions/frontend, Contract Implementation; `system-analysis/contracts/stock-screener.openapi.yaml`. + - **Verification:** frontend developer checks для повторного нажатия «Найти», чернового изменения полей, смены страницы и позднего ответа; генерация типов от предоставленного backend OpenAPI и frontend repo-local verify. + - **Depends on:** 2.2 + +- [x] 3.2 [frontend] Показать фильтры, каталожные карточки выбранных выпусков, время списка, страницы, подтверждённую пустоту и восстановление после недоступности поиска без обещания немедленной покупки. + - **Covers:** `stock-screener` — `Скринер ищет среди доступных к покупке акций`; `stock-screener` — `Результат представляет отдельные выпуски`; `stock-screener` — `Страницы относятся к одному результату поиска`; `stock-screener` — `Отсутствие совпадений отличается от недоступности поиска`. + - **Source:** `design.md` — UI/UX Package, Decisions/frontend; `qa-analysis.md` — Manual / Exploratory Scope. + - **Verification:** на широкой и узкой ширине, в том числе с клавиатуры, проверить запуск пустой формой, применение всех фильтров, точную UID-ссылку, состояния loading/empty/error и переход «Далее»; frontend repo-local verify. + - **Depends on:** 3.1 + +## 4. Итоговая документация + +- [x] 4.1 [docs] Обновить существующее описание акций, интеграции T-Invest и HTTP API до реализованного поведения скринера, не копируя целевой OpenAPI и change-диаграмму в AS-IS. + - **Covers:** `stock-screener` — `Скринер ищет среди доступных к покупке акций`; `stock-screener` — `Страницы относятся к одному результату поиска`; `stock-screener` — `Отсутствие совпадений отличается от недоступности поиска`. + - **Source:** `docs-impact.md` — entries `docs/domains/instruments/stocks.md`, `docs/integrations/tbank.md`, `docs/architecture/http-api.md`. + - **Verification:** сверить опубликованные страницы с реализованной формой, ответами и backend-generated OpenAPI; docs repo-local Markdown/link checks и `git diff --check`. + - **Depends on:** 2.2, 3.2 + +- [x] 4.2 [docs] Обновить обзор продукта, существующий навигационный пункт акций и глоссарий с точным определением скринера без технических деталей хранения результата. + - **Covers:** `stock-screener` — `Скринер ищет среди доступных к покупке акций`. + - **Source:** `docs-impact.md` — entries `docs/overview.md`, `docs/README.md`, `docs/glossary.md`; Glossary / Navigation Impact. + - **Verification:** проверить ссылки, согласованность термина с разделом акций, docs repo-local Markdown/link checks и `git diff --check`. + - **Depends on:** 3.2