FinTrack - Финтех-агрегатор MVP

Современный финтех-агрегатор для управления банковскими счетами, бюджетом, сбережениями и инвестициями с интеграцией Госуслуг и AI-ассистентом.

🎯 Описание проекта

FinTrack — это MVP приложение-агрегатор финансовых услуг, разработанное специально для российского рынка. Проект объединяет банковские счета, анализ трат, бюджетирование и инвестиции в одной безопасной платформе с поддержкой государственной идентификации через Госуслуги.

🚀 Ключевые особенности

• 🏛️ Интеграция с Госуслугами (ЕСИА) - Безопасная авторизация через государственную систему
• 🏦 Агрегация банковских данных - Подключение к российским банкам через ПКС/Open Banking
• 🤖 AI-финансовый ассистент - Персональные советы на базе Claude 3.5 Sonnet
• 📊 Умная аналитика трат - Автоматическая категоризация и анализ расходов
• 🎯 Управление бюджетом - Планирование и контроль финансов
• 🔒 Повышенная безопасность - 2FA, шифрование данных, защита по стандартам ЦБ РФ
• 👥 Семейные планы - Совместное управление финансами для семей
• 📱 Адаптивный дизайн - Полная поддержка мобильных устройств

🛠️ Технологический стек

Frontend

• React 18 с TypeScript
• Tailwind CSS + shadcn/ui для стилизации
• React Query для кэширования и состояния
• Wouter для роутинга
• Vite для сборки

Backend

• Node.js + Express.js
• TypeScript для типобезопасности
• JWT аутентификация
• PostgreSQL база данных
• Drizzle ORM для работы с БД

Безопасность

• Сквозное шифрование (E2EE)
• TOTP двухфакторная аутентификация
• ЕСИА интеграция с ГОСТ криптографией
• Безопасное хранение токенов и API ключей

AI & Интеграции

• OpenRouter API с Claude 3.5 Sonnet
• Госуслуги OAuth 2.0 интеграция
• Российские банки API (готовность к ПКС)

🚀 Быстрый старт

Предварительные требования

• Node.js 18+
• PostgreSQL
• Replit аккаунт (для деплоя)

Установка

1. Клонируйте репозиторий:

git clone https://github.com/tulubyev/fintech-aggregator-mvp.git
cd fintech-aggregator-mvp

2. Установите зависимости:

npm install

3. Настройте переменные окружения:

# Обязательные переменные
DATABASE_URL=postgresql://username:password@host:port/database
JWT_SECRET=your-jwt-secret-key
ENCRYPTION_KEY=32-character-encryption-key

# Для AI-ассистента
OPENROUTER_API_KEY=your-openrouter-api-key

# Для ЕСИА интеграции (опционально)
ESIA_CLIENT_ID=your-esia-client-id
ESIA_REDIRECT_URI=your-callback-url

4. Запустите миграции базы данных:

npm run db:push

5. Запустите проект:

npm run dev

Приложение будет доступно по адресу http://localhost:5000

📋 Основные функции

🔐 Аутентификация и безопасность

• Регистрация по номеру телефона
• Вход через email/телефон + пароль
• Госуслуги (ЕСИА) авторизация
• TOTP двухфакторная аутентификация
• Резервные коды восстановления

💳 Банковские подключения

• Подключение российских банков (Сбербанк, ВТБ, Тинькофф)
• Автоматическая синхронизация счетов
• Просмотр балансов и транзакций
• Категоризация операций

📊 Аналитика и бюджет

• Анализ трат по категориям
• Месячные и годовые отчеты
• Установка лимитов по категориям
• Прогнозы расходов

🎯 Цели и сбережения

• Создание целей накоплений
• Отслеживание прогресса
• Автоматические переводы
• Инвестиционные рекомендации

🤖 AI-ассистент

• Персональные финансовые советы
• Анализ паттернов трат
• Рекомендации по оптимизации
• Прогнозы и предупреждения

🏗️ Архитектура проекта

fintech-aggregator-mvp/
├── client/                 # React фронтенд
│   ├── src/
│   │   ├── components/     # UI компоненты
│   │   ├── pages/         # Страницы приложения
│   │   ├── hooks/         # React хуки
│   │   └── lib/          # Утилиты
├── server/                # Express бэкенд
│   ├── services/         # Бизнес-логика
│   ├── routes.ts         # API маршруты
│   └── storage.ts        # Работа с БД
├── shared/               # Общий код
│   └── schema.ts         # Схема БД
└── docs/                 # Документация

🔒 Безопасность

Соответствие стандартам

• ЦБ РФ требования к финтех-приложениям
• ГОСТ Р криптографические стандарты
• GDPR/152-ФЗ защита персональных данных

Реализованные меры

• Шифрование данных на уровне поля
• Безопасное хранение токенов
• Rate limiting для API
• Аудит безопасности транзакций
• Мониторинг подозрительной активности

🚦 Статус разработки

✅ Готово

• Базовая аутентификация и регистрация
• Интеграция с Госуслугами (ЕСИА)
• Двухфакторная аутентификация (2FA)
• Система ролей (Personal/Family/Business)
• AI-ассистент на Claude 3.5 Sonnet
• Базовый UI/UX дизайн
• PostgreSQL схема данных
• API эндпоинты для основных функций
• Тестовая инфраструктура

🔄 В разработке

• Интеграция с банками через ПКС
• Расширенная аналитика трат
• Инвестиционный модуль
• Мобильное приложение
• Система уведомлений

📋 Планируется

• Интеграция с криптовалютными биржами
• Автоматизация налогового учета
• Корпоративные тарифы
• API для партнеров
• Международная экспансия

🧪 Тестирование

Для тестирования доступна специальная страница /testing с возможностью:

• Создания тестовых пользователей разных ролей
• Генерации mock данных
• Симуляции банковских операций
• Тестирования ЕСИА интеграции

# Запуск тестов
npm test

# Доступ к тестовой странице (только в dev режиме)
http://localhost:5000/testing

🤝 Вклад в проект

Мы приветствуем вклад в развитие FinTrack! Пожалуйста:

1. Форкните репозиторий
2. Создайте ветку для новой функции (git checkout -b feature/AmazingFeature)
3. Зафиксируйте изменения (git commit -m 'Add some AmazingFeature')
4. Отправьте в ветку (git push origin feature/AmazingFeature)
5. Откройте Pull Request

📄 Лицензия

Проект распространяется под лицензией MIT. См. файл LICENSE для подробностей.

📞 Контакты и поддержка

• Email: [email protected]
• Telegram: @fintrack_support
• GitHub Issues: Создать issue

🏆 Команда

Проект разработан с использованием AI-ассистента Replit для ускорения разработки MVP.

---

Disclaimer: Данный проект является MVP (Minimum Viable Product) и предназначен для демонстрации возможностей. Для продуктивного использования требуется дополнительная настройка безопасности и получение необходимых лицензий ЦБ РФ.