Read in English 🇺🇸

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

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

1. Функционал
2. Технологии
3. Установка и База Данных
4. Сборка и Запуск
5. Галерея

• 🎯 Управление целями: Создание целей с картинками, категориями и приоритетами. Полный цикл CRUD (Создание, Чтение, Обновление, Удаление).

• 💳 История операций: Внесение депозитов, редактирование истории пополнений. Прогресс-бар пересчитывается автоматически.

• 📊 Аналитика: Дашборд с круговой диаграммой (цвета генерируются динамически), статистика накоплений и список ближайших дедлайнов.

• 📄 Отчетность: Генерация профессионального PDF-отчета со сводкой и таблицами. Файлы сохраняются в папку Документы/FinanceFlow-Reports.

• 🛡️ Безопасность данных: Система валидации предотвращает ввод некорректных данных (например, отрицательных сумм или неверных дат), выводя понятные уведомления.

Проект построен на актуальном стеке технологий. Нажмите на технологию, чтобы перейти на официальный сайт загрузки.

• Язык: C# / .NET 8.0 — Основная платформа.
• UI Фреймворк: AvaloniaUI 11.3.8 — Кроссплатформенный XAML.
• База данных: PostgreSQL 16+ — Надежная реляционная СУБД.
• ORM: Entity Framework Core 8 — Работа с данными через объекты.
• PDF: QuestPDF — Генерация документов.

⚠️ Важно: Для работы приложения необходим установленный сервер PostgreSQL.

Учетные данные по умолчанию: Приложение настроено на подключение со следующими данными:

• Database: financeflow_db
• User: financeflow_user
• Password: Ff_Postgres_Mdk_2025!

Если вы хотите использовать свой логин/пароль, откройте файл Data/AppDbContext.cs и измените строку подключения в методе OnConfiguring.

В корне проекта находится файл setup_db.bat.

1. Запустите его от имени администратора (или просто двойным кликом).
2. Скрипт автоматически:
   • Создаст пользователя и базу данных.
   • Создаст структуру таблиц.
   • Наполнит базу тестовыми категориями из файла seed_data.sql. (Требуется, чтобы PostgreSQL был в переменных среды PATH).

Если вы предпочитаете настраивать БД вручную (через pgAdmin или psql):

1. Создание базы и пользователя:

   CREATE USER financeflow_user WITH PASSWORD 'Ff_Postgres_Mdk_2025!';
   CREATE DATABASE financeflow_db OWNER financeflow_user;
   ALTER USER financeflow_user CREATEDB;

2. Создание таблиц и наполнение: Найдите в корне проекта файл seed_data.sql и выполните его содержимое в созданной базе financeflow_db. Этот скрипт создаст все необходимые таблицы и добавит категории целей.

• seed_data.sql — Полный скрипт инициализации (удаление старого, создание таблиц, вставка данных).
• cleanup.sql — Скрипт для полной очистки базы (Drop All).

1. Перейдите в раздел Releases этого репозитория.
2. Скачайте архив FinanceFlow_Release_v1.0.zip.
3. Запустите FinanceFlow.exe.

Требуется установленный .NET 8 SDK.

1. Клонирование:

   git clone https://github.com/RamenOfficialGovPatsy/FinanceFlow.git
   cd FinanceFlow

2. Настройка БД (через EF Core): Если вы не использовали SQL-скрипты выше, можно создать структуру таблиц командой:

   dotnet ef database update

3. Запуск:

   dotnet run

Главное меню с обзором целей и прогресс-баром

Форма создания ноовой цели

Форма создания ноовой цели(часть2)

Внесение средств

Журнал транзакций

Общая статистика

Распределение по категориям

Дедлайны

1 страница отчета

2 страница отчета

Проверка обязательных полей - название цели

Контроль корректности введенной суммы

Защита от превышения целевой суммы