docs: add MVP change proposals

2026-08-12 23:10:15 +03:00
parent 68be4760ce
commit e383e5fac6
8 changed files with 112 additions and 0 deletions
@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-08-12
@@ -0,0 +1,26 @@
+## Why
+
+Список счетов без состава активов не решает основную задачу MVP: понимать текущее состояние инвестиций. Детальный портфель должен оставаться нормализованным backend-представлением и не раскрывать protobuf-модель T-Bank frontend.
+
+## What Changes
+
+- Добавить защищенный API портфеля выбранного счета с агрегатами, всеми типами позиций и денежными остатками.
+- Передавать денежные значения как десятичные строки с кодом валюты без конвертации и без арифметики на JavaScript float.
+- Добавить страницу `/accounts/:accountId` с позициями, сортировкой по текущей стоимости по убыванию, пустым портфелем и временем последнего успешного upstream-ответа.
+- Получать и кэшировать метаданные инструментов; при недоступности названия или тикера показывать `figi`, не скрывая финансовые значения.
+- Документировать портфель, fallback-правила и различие штатного пустого состояния от upstream-ошибки.
+
+## Capabilities
+
+### New Capabilities
+- `portfolio-view`: Просмотр нормализованного состава и агрегатов портфеля активного брокерского счета.
+
+### Modified Capabilities
+
+Нет.
+
+## Impact
+
+- Затрагивает T-Bank client, cache метаданных инструментов, authenticated backend API/OpenAPI, frontend detail page и generated API client.
+- Зависит от `add-authentication`, `add-tbank-connection` и `add-brokerage-accounts`.
+- Не включает историю snapshots, операции, выплату доходов, лимиты на вывод или валютную конвертацию.