vault backup: 2026-04-04 23:38:18

Knowledges/Библиотека/Pet проекты/finance-controll.md

@@ -0,0 +1,73 @@
+---
+Тип: Проект
+Статус: Идея
+Название: 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
+
+---
+
+## 🧠 Что узнал / выводы
+
+---
+
+## 🔗 Связанные заметки
+- [[]]