Хочу Плачу

Бесплатная система управления финансами с открытым исходным кодом

Простое и эффективное решение для контроля ваших расходов, отслеживания регулярных платежей и управления бюджетом

🌟 Попробуйте прямо сейчас!

Для большинства пользователей рекомендуется использовать готовую онлайн-версию:

🌐 hpio.ru - Бесплатный сервис, готовый к использованию прямо в браузере

📱 Android приложение - Доступна мобильная версия! См. инструкции по сборке APK

Самостоятельная установка на локальном сервере нужна только если вам требуется повышенная безопасность, конфиденциальность данных или полный контроль над системой.

---

📋 Что это такое?

"Хочу Плачу" - это современное веб-приложение для управления личными финансами, которое поможет вам:

✅ Никогда не забывать о платежах - автоматические напоминания и уведомления
✅ Контролировать бюджет - наглядная аналитика и графики расходов
✅ Организовывать платежи - категории, теги и прикрепление чеков
✅ Экономить время - автоматическое создание регулярных платежей
✅ Анализировать траты - детальная статистика по категориям и периодам

🎯 Для кого этот проект?

• Семьи - которые хотят вести семейный бюджет и не забывать о коммунальных платежах
• Фрилансеры - которым нужно отслеживать доходы и расходы для налогов
• Студенты - которые учатся управлять финансами и контролировать трату денег
• Малый бизнес - который ищет простое решение для учета регулярных платежей
• Энтузиасты приватности - которые предпочитают хранить финансовые данные на собственном сервере

🚀 Основные возможности

💡 Умное отслеживание

• Централизованный учет всех счетов и подписок
• Автоматические напоминания о предстоящих платежах
• Предотвращение просрочек и штрафов

🔄 Регулярные платежи

• Настройка повторяющихся платежей один раз
• Автоматическое создание новых платежей по расписанию
• Гибкие настройки периодичности (ежедневно, еженедельно, ежемесячно, ежегодно)

📊 Аналитика и статистика

• Наглядные графики трат по категориям
• Анализ расходов по дням, месяцам и годам
• Отслеживание динамики бюджета
• Детальные отчеты о финансовых привычках

🏷️ Организация и структура

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

🎨 Удобный интерфейс

• Интуитивно понятный дизайн
• Работает на всех устройствах (компьютер, планшет, телефон)
• Android приложение (iOS приложение в разработке)
• Светлая и темная темы оформления
• Быстрый доступ ко всем функциям

📱 Импорт платежей

• Автоматический импорт платежей из Android push-уведомлений
• Полу-автоматический режим с подтверждением пользователя
• Поддержка банков: Raiffeisen, Сбербанк, Ozon bank, Яндекс банк, Тинькофф
• Безопасная обработка данных без доступа к банковским аккаунтам

🛠️ Технические характеристики

"Хочу Плачу" построено на современных технологиях:

• Frontend: React 19, TypeScript, Tailwind CSS, Vite
• Backend: Node.js, Express, TypeScript
• База данных: PostgreSQL с миграциями
• Аутентификация: JWT токены
• Валидация: React Hook Form + Zod
• Мониторинг: OpenTelemetry
• Email: Интеграция с почтовыми сервисами

📦 Установка и запуск

Вариант 1: Готовое решение (Рекомендуется)

Просто перейдите на hpio.ru и начните пользоваться прямо сейчас!

Вариант 2: Запуск через Docker (Скоро)

Docker установка в активной разработке и будет доступна в ближайшее время.

Ожидаемые шаги:

1. Установите Docker на ваш компьютер

2. Скачайте проект:

   git clone https://github.com/apertso/next-payment.git
   cd next-payment

3. Запустите приложение:

   docker-compose up -d

4. Откройте в браузере: http://localhost:3000

Вариант 3: Установка для разработчиков

Требования:

• Node.js 18+
• npm или yarn
• PostgreSQL

Шаги установки:

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

   git clone https://github.com/apertso/next-payment.git
   cd next-payment

2. Установите зависимости для backend:

   cd backend
   npm install

3. Установите зависимости для frontend:

   cd ../frontend
   npm install

4. Настройте конфигурацию:

   • Создайте базу данных PostgreSQL
   • Скопируйте .env.example в .env
   • Укажите конфигурацию базы данных и ваш JWT_SECRET

5. Запустите миграции:

   cd ../backend
   npm run migrate

6. Запустите приложение:

   # Backend (в одном терминале)
   cd backend
   npm run dev
   
   # Frontend (в другом терминале)
   cd frontend
   npm run dev

7. Откройте браузер: http://localhost:5173

🔧 Настройка

Переменные окружения

Скопируйте файл .env.example в .env в папке backend и настройте основные параметры:

# База данных PostgreSQL
DB_HOST=localhost
DB_PORT=5432
DB_NAME=hpio
DB_USER=your_username
DB_PASSWORD=your_password

# JWT токены
JWT_SECRET=your_secret_key

# Остальные параметры уже настроены по умолчанию

🔮 Планы развития

Мы активно работаем над новыми функциями:

📱 Мобильные и десктопные приложения

• iOS приложение для iPhone и iPad
• Десктопные приложения для Windows, macOS, Linux
• Синхронизация между всеми устройствами

🏷️ Расширенная система тегов

• Множественные теги для одного платежа
• Быстрые фильтры по тегам
• Статистика по тегам

🔍 Умные фильтры и поиск

• Продвинутые фильтры по датам, суммам, категориям
• Поиск по описанию и комментариям
• Сохраненные поисковые запросы
• Быстрые фильтры "одним кликом"

📤 Импорт/Экспорт банковских выписок

• Автоматический импорт из популярных банков (Сбербанк, ВТБ, Альфа-Банк, Тинькофф)
• Импорт из Excel/CSV файлов
• Экспорт данных в различных форматах
• Распознавание категорий при импорте

🔔 Push-уведомления

• Напоминания о предстоящих платежах
• Уведомления о превышении бюджета
• Еженедельные отчеты по тратам
• Настраиваемые правила уведомлений

📊 Расширенная аналитика

• Прогнозирование расходов
• Сравнение с предыдущими периодами
• Рекомендации по оптимизации бюджета

🔒 Безопасность и приватность

Защищенное хранение ваших данных

"Хочу Плачу" разработан с учетом максимальной безопасности ваших финансовых данных:

• Не запрашиваем доступ к банковским аккаунтам - мы не просим ваши логины и пароли от банков
• Локальная обработка данных - все операции выполняются на вашем устройстве или сервере
• Шифрование данных - чувствительная информация хранится в зашифрованном виде
• Отсутствие облачного хранения - опционально, вы можете использовать только локальную инфраструктуру

Почему стоит выбрать локальную установку?

• Максимальная приватность - ваши данные никогда не покидают вашу инфраструктуру
• Полный контроль - вы сами управляете резервным копированием и доступом
• Соответствие требованиям - идеально для компаний с жесткими политиками безопасности
• Независимость от интернета - работает полностью автономно после настройки

Меры безопасности

• 🔐 JWT аутентификация с безопасными токенами
• 🛡️ Валидация данных на всех уровнях
• 🔒 Шифрование паролей с использованием bcrypt
• 🚫 Защита от CSRF и XSS атак
• ⏰ Автоматический logout по истечении сессии
• 🏠 Локальное хранение - возможность работы без облачных сервисов

🤝 Сообщество и поддержка

Нужна помощь?

• 💬 Обратная связь: Напишите нам через hpio.ru
• 🐛 Сообщить о баге: Создайте issue в GitHub
• 💡 Предложить идею: Поделитесь своими предложениями в Issues
• 📚 Документация: Изучите код и комментарии в репозитории

Хотите помочь проекту?

• ⭐ Поставьте звезду этому репозиторию
• 🔀 Сделайте форк и внесите свои улучшения
• 🐛 Сообщайте о багах и помогайте их исправлять
• 📖 Улучшайте документацию и переводы
• 💬 Рассказывайте друзьям о проекте

📄 Лицензия

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

🎉 Быстрый старт

Хотите просто попробовать?

👉 Переходите на hpio.ru прямо сейчас!

Бесплатная версия в облаке готова к использованию за 30 секунд. Никаких установок, настроек и технических сложностей!

---

Сделано с ❤️ для людей, которые хотят контролировать свои финансы