feat(app): Flutter-клиент — логин, дашборд, потоки, категории, транзакции, правила

Riverpod + go_router с auth-guard, NavigationRail на широком экране и bottom bar на узком. Токены в flutter_secure_storage, на web access живёт в памяти. Интерцептор подставляет токен и делает ровно один refresh на 401. Деньги приходят строками и форматируются через Decimal: парсить их в double значило бы терять копейки ровно там, где бэкенд их бережёт.
2026-09-18 13:44:09 +03:00
parent b9c12fa1a1
commit ce0966fca2
99 changed files with 6284 additions and 0 deletions
@@ -0,0 +1,66 @@
+import 'package:dio/dio.dart';
+import 'package:fintracker_api/fintracker_api.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+import '../../core/api/api_client.dart';
+
+final netWorthBreakdownProvider = FutureProvider.autoDispose<NetWorthBreakdown>((ref) async {
+  final r = await ref.watch(apiProvider).getNetworthApi().networthBreakdown();
+  return r.data!;
+});
+
+/// Daily net worth for the last 365 days.
+final netWorthSeriesProvider = FutureProvider.autoDispose<List<NetWorthDay>>((ref) async {
+  final now = DateTime.now();
+  final r = await ref.watch(apiProvider).getNetworthApi().networthSeries(
+        from: now.subtract(const Duration(days: 365)),
+        to: now,
+      );
+  return r.data ?? const [];
+});
+
+/// The current (partial) month's cashflow, or null before any data exists.
+final cashflowThisMonthProvider = FutureProvider.autoDispose<CashFlowMonth?>((ref) async {
+  final r = await ref.watch(apiProvider).getCashflowApi().cashflowMonthly(months: 1);
+  final rows = r.data ?? const [];
+  return rows.isEmpty ? null : rows.last;
+});
+
+/// The last 12 months, for the income-vs-expense bar chart.
+final cashflowLast12Provider = FutureProvider.autoDispose<List<CashFlowMonth>>((ref) async {
+  final r = await ref.watch(apiProvider).getCashflowApi().cashflowMonthly(months: 12);
+  return r.data ?? const [];
+});
+
+final runwayProvider = FutureProvider.autoDispose<RunwayOut>((ref) async {
+  final r = await ref.watch(apiProvider).getCashflowApi().cashflowRunway();
+  return r.data!;
+});
+
+/// When the metric tables were last rebuilt; null before the first refresh.
+final metricsStatusProvider = FutureProvider.autoDispose<RefreshLogOut?>((ref) async {
+  try {
+    final r = await ref.watch(apiProvider).getMetricsApi().metricsStatus();
+    return r.data;
+  } on DioException catch (e) {
+    if (e.response?.statusCode == 404) return null;
+    rethrow;
+  }
+});
+
+final dataQualityProvider = FutureProvider.autoDispose<List<DataQualityRow>>((ref) async {
+  final r = await ref.watch(apiProvider).getMetricsApi().metricsDataQuality();
+  return r.data ?? const [];
+});
+
+/// Every dashboard provider, refreshed together after a manual
+/// `POST /metrics/refresh` or a pull-to-refresh.
+void invalidateHomeProviders(WidgetRef ref) {
+  ref.invalidate(netWorthBreakdownProvider);
+  ref.invalidate(netWorthSeriesProvider);
+  ref.invalidate(cashflowThisMonthProvider);
+  ref.invalidate(cashflowLast12Provider);
+  ref.invalidate(runwayProvider);
+  ref.invalidate(metricsStatusProvider);
+  ref.invalidate(dataQualityProvider);
+}