---
Тип: Проект
Статус: Идея
Название: finance-controll
Описание: Персональный трекер инвестиций — учёт акций, облигаций, вкладов и доходности портфеля
Начат:
Завершён:
Технологии:
  - TypeScript
  - NestJS
  - React
  - Next.js
  - Spring Boot
  - Docker Compose
Теги:
  - investments
  - microservices
  - nestjs
  - react
  - finance
  - portfolio
Репозиторий:
Ссылка:
---

# finance-controll

## 🎯 Проблема и цель
Существующие сервисы типа Snowball — закрытые: нет контроля над данными, логикой подсчёта доходности и источниками котировок. Цель — самостоятельно отслеживать акции, облигации, вклады и доходность портфеля в едином месте.

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

---

## 🔍 Аналоги

| Проект | Ссылка | Почему не подошёл |
|--------|--------|-------------------|
| Snowball | https://snowball-income.com | Закрытый сервис, нет контроля над данными и логикой расчётов |

---

## ⚙️ Архитектура
**Стек:** TypeScript, NestJS, React / Next.js, Spring Boot (план), PostgreSQL, Docker Compose

**Ключевые решения:**
- Микросервисная архитектура: каждый домен — отдельный сервис
- Сервис котировок: собственный сервис-прослойка над MOEX API с кэшированием ответов
- Источники данных: ручной ввод сделок, импорт отчётов брокера (CSV/XLS), API брокера, внешние котировки
- Часть сервисов в перспективе будет переписана / добавлена на Spring Boot — для практики
- Локальный деплой через Docker Compose

---

## 📋 Функциональность
- [ ] Учёт активов: акции, облигации, вклады
- [ ] Подсчёт доходности портфеля
- [ ] Ручной ввод сделок
- [ ] Импорт отчётов брокера (CSV/XLS)
- [ ] Интеграция с API брокера
- [ ] Сервис котировок (MOEX + кэш)
- [ ] Веб-интерфейс (React / Next.js)
- [ ] Docker Compose для локального запуска
- [ ] Сервисы на Spring Boot

---

## 🧠 Что узнал / выводы

---

## 🔗 Связанные заметки
- [[]]