Balance/Balance/docs/PRODUCT.md

Функциональная документация

Dashboard

Показывает:

• общий баланс;
• доходы текущего месяца;
• расходы текущего месяца;
• последние операции;
• быстрый переход к аналитике, операциям, бюджетам, категориям, корректировке и настройкам.

Операции

Поддерживаются:

• доходы;
• расходы;
• категория;
• сумма;
• дата;
• заметка;
• редактирование;
• удаление;
• поиск;
• фильтрация по типу.

Корректировка баланса

Пользователь задаёт фактический баланс.

Разница между фактическим и текущим балансом сохраняется как специальная операция с isBalanceAdjustment=true.

Такая запись:

• влияет на общий баланс;
• не влияет на месячные income/expenses;
• не попадает в spending-by-category.

Это позволяет исправить расхождение между приложением и реальным счётом, не искажая историю расходов.

Аналитика

Доступны периоды:

• месяц;
• 3 месяца;
• 12 месяцев.

Используются:

• доходы;
• расходы;
• результат;
• savings rate;
• структура расходов по категориям;
• динамика доходов и расходов.

Бюджеты

Для категории можно задать месячный лимит.

Budget хранится отдельно от транзакций и синхронизируется через собственную entity budget.

Категории

Системные категории разделены на income/expense.

Пользователь может создать свою категорию:

• название;
• тип;
• SF Symbol или emoji;
• цвет.

Имя категории не должно дублировать существующее имя.

Настройки

• валюта: RUB, EUR, USD, SEK;
• тема: system/light/dark;
• сервер и синхронизация;
• CSV export на iOS/macOS.

watchOS

Watch-приложение предоставляет компактные версии:

• Dashboard;
• Add/Edit transaction;
• All transactions;
• Analytics;
• Budgets;
• Categories;
• Balance adjustment;
• Settings.

macOS

Mac-приложение предоставляет:

• dashboard;
• полную аналитику;
• операции;
• бюджеты;
• категории;
• корректировку;
• настройки;
• CSV export.