# Firewire Analytics — Учет и аналитика инвестиционных портфелей

Firewire Analytics (ранее BKS Analytics) — это профессиональное веб-приложение для импорта, учета и глубокого анализа инвестиционных портфелей из различных источников. Инструмент ориентирован на частных инвесторов, управляющих капиталом и финансовых аналитиков.

## Основные возможности
- **Bento-дашборд**: Настраиваемая панель управления с перетаскиваемыми и масштабируемыми виджетами (распределение активов, история PnL, кредитное качество, концентрация эмитентов и др.).
- **Календарь купонов и дивидендов**: Интерактивная помесячная матрица будущих выплат, собранная на основе данных Московской биржи (MOEX ISS) и прогнозов аналитических агентств.
- **Расчет точных метрик доходности**: Взвешенная по времени доходность (TWR), денежно-взвешенная доходность (XIRR), доходность к погашению (YTM), дюрация портфеля, коэффициенты Шарпа и Сортино, бета-волатильность.
- **Учет инфляции**: Автоматический расчет реальной доходности портфеля на основе динамики индекса потребительских цен (ИПЦ Росстата).
- **Экспорт данных**: Генерация PDF-отчетов по сделкам и позициям с защитой от DOM XSS, а также выгрузка данных в Excel.
- **Сообщества и шеринг**: Возможность публиковать свои портфели (с настройкой приватности и анонимизации) в публичном фиде, комментировать и добавлять в избранное.

## Поддерживаемые брокеры и источники
- **БКС Мир Инвестиций**: Прямая интеграция через БКС Trade API (авторизация по refresh-токену, WebSocket-стриминг сделок в реальном времени, автоматическая синхронизация портфеля).
- **Финам**: Интеграция через Finam Trade API (сессионная авторизация, получение структуры портфеля, сделок и котировок).
- **JetLend**: Интеграция с крупнейшей платформой краудлендинга для учета займов, выплат и доходности.
- **Импорт отчетов**: Поддержка загрузки и парсинга официальных Excel, PDF и XML-отчетов ключевых брокеров (Т-Инвестиции, Альфа-Инвестиции, Сбер, ВТБ, Interactive Brokers и др.) с интеллектуальной дедупликацией через ReAct ИИ-агента.
- **Рыночные данные**: Интеграция с Московской биржей (MOEX ISS) для получения характеристик инструментов и графиков купонов.

## Математический базис и API
Подробное описание используемых формул (XIRR, TWR, YTM, формула Фишера для реальной доходности, дюрация Маколея), а также спецификация API-эндпоинтов представлены в файле:
- [llms-full.txt](https://fire-wire.ru/llms-full.txt)