Files
docs/overview.md
T
codex-bot 37430da4c9
Docs security / security (push) Successful in 7s
Docs verify / verify (push) Successful in 11s
docs: describe concentration tab and stored instrument classification (WealthLedger/main#48) (#60)
2026-11-01 19:29:01 +03:00

8.1 KiB

WealthLedger: назначение и возможности

WealthLedger — локальное приложение для частного инвестора, который хочет понимать свои инвестиции T-Bank: что находится на счетах, какие операции исполнены, сколько купонов и дивидендов получено и какие выплаты ожидаются. Приложение объединяет эти представления, сохраняя связь суммы с валютой, инструментом и брокерским счётом. Отдельная область ручных банковских карт помогает учитывать рублёвые остатки и повседневные траты.

Основные задачи пользователя

После регистрации или входа пользователь подключает T-Bank Invest в настройках. Локальная учётная запись WealthLedger и подключение к брокеру — разные вещи: вход открывает приложение, а подключение определяет доступные инвестиционные счета. Для ручного учёта банковских карт подключение брокера не требуется.

Задача Что показывает WealthLedger
Найти свой инвестиционный счёт Список счетов, их типы и доступные сводки
Вести банковские карты Ручной учёт: независимые балансы, расходы, пополнения, переводы, возвраты и месячные сводки
Понять текущий состав инвестиций Портфель: позиции, денежные остатки и итоги по валютам
Увидеть, где сконцентрированы деньги Концентрация: крупнейшие бумаги, секторы и эмитенты счёта
Разобрать уже совершённые движения Журнал операций: исполненные операции с фильтрами и последовательной загрузкой истории
Посчитать полученные выплаты Пассивный доход: исполненные купоны и дивиденды за календарный период
Посмотреть ожидаемые события Будущие выплаты: купоны, дивиденды, погашения и оферты по текущим позициям
Увидеть общий состав инвестиций Режим «Все счета», сохраняющий принадлежность строк к счетам
Изучить конкретный инструмент Скринер акций по параметрам каталога, страницы акций и поиск облигаций: рынок, личная позиция, история и события

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

Пользователь владеет локальными сессиями и одним подключением T-Bank. Подключение даёт доступ к поддерживаемым открытым инвестиционным счетам. Каждый счёт связывает портфель, операции, полученный доход и будущие выплаты. Режим «Все счета» объединяет результаты доступных счетов; отдельного брокерского счёта с таким именем он не создаёт.

Банковские карты имеют собственные операции и общий пользовательский список категорий. Их текущие балансы независимы; месячная сводка всех карт объединяет траты и возвраты, включая архив. Банковские деньги не добавляются к инвестициям.

Портфель отвечает на вопрос «что есть сейчас», журнал — «что исполнено», аналитика дохода — «какие выплаты уже получены», будущие события — «что ожидается». Прогноз не подтверждает фактическое зачисление. Полученные купоны и дивиденды не равны инвестиционной доходности или результату после налогов.

Денежная сумма всегда относится к одной валюте. Недоступное значение отличается от нуля, а объединение счетов не означает автоматическую конвертацию всех валют. Краткие определения собраны в глоссарии.

Источники и границы продукта

T-Bank поставляет личные брокерские данные и рыночную информацию. Публичные данные MOEX дополняют сведения об облигациях и событиях, реестр НКР — рейтинг выпуска. Изображения инструментов загружаются из публичного CDN T-Bank. Контекст системы объясняет эти внешние границы.

Инвестиционные возможности предназначены для чтения и анализа. Они не описывают размещение торговых поручений или изменение портфеля у брокера. Локально сохраняются учётные данные, сессии, зашифрованное подключение и ручная история банковских карт. Инвестиционные финансовые снимки служат временными наблюдениями, а не накопленной историей портфеля в собственной базе WealthLedger.

Данные могут зависеть от доступности поставщика и свежести последнего ответа. При допустимом использовании сохранённых данных интерфейс сообщает об этом; ошибка источника не превращается в нулевой баланс или пустой портфель. Свежесть данных и состояния интерфейса объясняют эти различия.

Описание относится к подтверждённому локальному устройству приложения. Облачная эксплуатация, гарантии доступности и масштабирование не следуют из наличия frontend и backend. Их ответственности и ограничения раскрыты в контейнерах системы.

Для выбора темы используйте карту предметных областей.