Skip to content
NikPACodesPublic

About

SubFlux — Django-сервис с API-first подходом для управления подписками и анализа регулярных расходов. Отслеживание подписок, история цен, аналитика, прогнозы и напоминания о платежах.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

🚀 SubFlux: Умный менеджер подписок с аналитикой расходов

📋 Краткое описание

SubFlux — это сервис для управления цифровыми подписками и анализа регулярных расходов. Сервис помогает пользователю увидеть реальную финансовую картину, спрогнозировать будущие списания и осознанно управлять подписками.

⚠️ SubFlux не обрабатывает платежи и не хранит платёжные данные. Он работает исключительно с учётом, аналитикой и прогнозированием.
⚠️ Модель Payment используется исключительно для учёта фактически произошедших списаний (сумма, валюта, дата), введённых вручную, импортированных или полученных из интеграций.


🚧 Статус проекта

Проект находится в активной разработке.

  • текущий фокус: доменная модель и базовая аналитика
  • архитектурные решения зафиксированы
  • ведется поэтапная реализация

👉 План разработки ── ROADMAP
👉 Архитектура и схемы ── ARCHITECTURE
👉 Развертывание проекта ── DEVELOPMENT



Оглавление



❓ Зачем нужен SubFlux

Современный пользователь часто имеет десятки подписок: стриминг, сервисы, облака, инструменты, медиа. Подписки:

  • списываются автоматически
  • меняют цены
  • имеют разные периоды оплаты

В итоге человек не видит общей картины расходов. SubFlux решает эту проблему, помогая избавить пользователя от "цифрового хаоса" подписок и превращая подписки в структурированные данные и прогнозируемые расходы.


🎯 Цели проекта

  • Структурировать цифровые подписки пользователя
  • Показать реальные ежемесячные и годовые расходы
  • Предупреждать о будущих списаниях
  • Отслеживать изменения цен
  • Формировать аналитику и прогнозы расходов

🎯 Ключевые возможности

📊 Учет и мониторинг

  • Добавление подписок с различной периодичностью (ежемесячно, ежегодно, квартально)
  • Категоризация подписок по типам (стриминг, облачные сервисы, ПО и т.д.)
  • Автоматический расчет дат следующих платежей
  • Отслеживание истории изменений цен
  • Каталог доверенных тарифов (VerifiedPrice)
  • Учёт истории цен пользовательских подписок
  • Учёт фактических списаний (Payment)

🔔 Умные напоминания

  • Персонализированные уведомления об оплате за 7, 3 и 1 день до платежа
  • Настройка предпочтительных типов уведомлений (email, push)
  • Напоминания об окончании триальных периодов
  • Уведомления об изменениях тарифов

📈 Продвинутая аналитика

  • Визуализация расходов по категориям
  • Расчет месячных и годовых затрат
  • Прогнозирование будущих расходов
  • Тренды и изменения в расходах за период
  • Сравнение фактических и планируемых расходов

🔄 Автоматизация

  • Автоматическое обновление дат платежей после подтверждения оплаты
  • Фоновая обработка напоминаний через Celery
  • Еженедельные и ежемесячные отчеты
  • Планируется импорт подписок из банковских выписок (CSV)

⚙️ Доп.функции

  • ссылки на официальные страницы оплаты сервисов
  • поддержка Web и Telegram-клиента

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

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

  • Backend: Django + Django REST Framework
  • База данных: PostgreSQL
  • Очереди задач: Redis + Celery
  • Фронтенд: React.js / Vue.js (опционально)
  • Деплой: Docker + Nginx
  • Мониторинг: Flower для Celery
  • Уведомления: Telegram Bot API + Email

️⚠️ Проект реализован/тестировался на Django 6.0 и требует Python 3.12+ (на более ранних версиях Django/Python НЕ ТЕСТИРОВАЛСЯ)

Структура приложения (общая):

    subflux/
    ├── config/                  # Конфигурация проекта
    │   └── settings/            # Настроек для запуска проекта (Dev | Test | Stage | Prod)
    ├── apps/
    │   ├── users/               # Пользователь и профиль
    │   ├── subscriptions/       # Подписка + Справочники + Правила расчета (основное приложение)
    │   ├── analytics/           # Аналитика и отчеты
    │   └── notifications/       # Уведомления
    ├── utils/                   # Общие компоненты (логика работы с датами, конвертация валют и периодичностей, кастомные валидаторы)
    ├── docs/                    # Документация
    └── docker/                  # Docker Compose 

⚖️ Лицензирование

SubFlux распространяется по модели двойного лицензирования (Dual Licensing):

  • Открытая лицензия (Open Source): GNU Affero General Public License, Version 3.0 only (AGPL-3.0-only).
  • Коммерческая лицензия (Commercial): альтернативное лицензирование на коммерческих условиях, предоставляемое на основании отдельного письменного соглашения. Для получения информации об условиях коммерческой лицензии обращайтесь к правообладателю.

Автором и правообладателем оригинального программного обеспечения SubFlux является Nikolay Petukhov (NikPACodes).

Подробная информация об условиях лицензирования приведена в документах:

  • Текст лицензии AGPL-3.0 — LICENSE;
  • Описание модели двойного лицензирования — LICENSING;
  • Уведомление об авторских правах с указанием правообладателя — COPYRIGHT.

📚 Документация и правила проекта

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

Как сообщать об ошибках, предлагать улучшения и вносить изменения — CONTRIBUTING

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

Как корректно сообщать об уязвимостях — SECURITY

📜 Правила поведения

Правила общения в проекте — CODE_OF_CONDUCT

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

Описание структуры проекта и ключевых решений — ARCHITECTURE

🛠 Разработка

Roadmap реализации проекта — ROADMAP
Развертывание проекта ── DEVELOPMENT


SubFlux — это не просто трекер подписок, а полноценная система управления регулярными расходами, которая помогает принимать осознанные финансовые решения и экономить деньги за счет полной прозрачности всех подписок.

About

SubFlux — Django-сервис с API-first подходом для управления подписками и анализа регулярных расходов. Отслеживание подписок, история цен, аналитика, прогнозы и напоминания о платежах.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages