feat(app): offline-кэш GET-запросов на дашборде — фаза 5

CacheInterceptor кэширует каждый успешный GET по путь+параметры в drift (sqlite нативно, wasm+OPFS в браузере) и подменяет им сетевую ошибку; провайдер отдаёт Cached<T>, экран показывает баннер «данные на …». Контракт для остальных экранов — docs/ai/offline-cache.md. flake.nix: libsecret/pkg-config для линуксовой сборки, jq/curl для just app-web-assets (сборка sqlite3.wasm + drift_worker.js).
2026-09-19 12:40:08 +03:00
parent 95cd6f176e
commit ffc5ed959a
21 changed files with 15852 additions and 60 deletions
@@ -0,0 +1,122 @@
+import 'package:dio/dio.dart';
+import 'package:drift/native.dart';
+import 'package:fintracker_app/core/cache/cache_interceptor.dart';
+import 'package:fintracker_app/core/cache/response_cache.dart';
+import 'package:flutter_test/flutter_test.dart';
+
+/// `onResponse`/`onError` complete synchronously in `CacheInterceptor` — no
+/// real Dio transport needed, same approach as `date_query_interceptor_test.dart`.
+class _ResponseCapture extends ResponseInterceptorHandler {
+  Response<dynamic>? passed;
+  @override
+  void next(Response response) => passed = response;
+}
+
+class _ErrorCapture extends ErrorInterceptorHandler {
+  Response<dynamic>? resolvedResponse;
+  DioException? forwarded;
+
+  @override
+  void resolve(Response response) => resolvedResponse = response;
+
+  @override
+  void next(DioException error) => forwarded = error;
+}
+
+RequestOptions _request(String method, String path, [Map<String, dynamic> query = const {}]) =>
+    RequestOptions(path: path, method: method, queryParameters: query);
+
+DioException _offline(RequestOptions options) =>
+    DioException(requestOptions: options, type: DioExceptionType.connectionError);
+
+void main() {
+  late ResponseCacheDatabase db;
+  late CacheInterceptor interceptor;
+
+  setUp(() {
+    db = ResponseCacheDatabase.forTesting(NativeDatabase.memory());
+    interceptor = CacheInterceptor(db);
+  });
+
+  tearDown(() => db.close());
+
+  test('a successful GET is written to the cache', () async {
+    final options = _request('GET', '/networth/breakdown');
+
+    interceptor.onResponse(
+      Response<dynamic>(requestOptions: options, statusCode: 200, data: {'totalRub': '100'}),
+      _ResponseCapture(),
+    );
+    await pumpEventQueue(); // the write is fire-and-forget
+
+    final cached = await db.get(CacheInterceptor.requestKey(options));
+    expect(cached?.body, {'totalRub': '100'});
+  });
+
+  test('a connection error is answered from the cache, with fetchedAt set', () async {
+    final options = _request('GET', '/networth/breakdown');
+    await db.put(CacheInterceptor.requestKey(options), {'totalRub': '100'});
+
+    final handler = _ErrorCapture();
+    await interceptor.onError(_offline(options), handler);
+
+    expect(handler.resolvedResponse?.data, {'totalRub': '100'});
+    expect(handler.resolvedResponse?.extra['fetchedAt'], isA<DateTime>());
+    expect(handler.forwarded, isNull);
+  });
+
+  test('a connection error with nothing cached still fails', () async {
+    final options = _request('GET', '/networth/breakdown', {'never': 'asked'});
+    final failure = _offline(options);
+    final handler = _ErrorCapture();
+
+    await interceptor.onError(failure, handler);
+
+    expect(handler.resolvedResponse, isNull);
+    expect(handler.forwarded, same(failure));
+  });
+
+  test('a real server error is never masked by a cached answer', () async {
+    final options = _request('GET', '/networth/breakdown');
+    await db.put(CacheInterceptor.requestKey(options), {'totalRub': '100'});
+
+    final serverError = DioException(
+      requestOptions: options,
+      type: DioExceptionType.badResponse,
+      response: Response<dynamic>(requestOptions: options, statusCode: 500),
+    );
+    final handler = _ErrorCapture();
+    await interceptor.onError(serverError, handler);
+
+    expect(handler.resolvedResponse, isNull);
+    expect(handler.forwarded, same(serverError));
+  });
+
+  test('a failed mutation is never served from the cache', () async {
+    final options = _request('POST', '/links');
+    final failure = _offline(options);
+    final handler = _ErrorCapture();
+
+    await interceptor.onError(failure, handler);
+
+    expect(handler.resolvedResponse, isNull);
+    expect(handler.forwarded, same(failure));
+  });
+
+  test('query parameters are part of the cache key', () async {
+    final page1 = _request('GET', '/events', {'page': 1});
+    final page2 = _request('GET', '/events', {'page': 2});
+    await db.put(CacheInterceptor.requestKey(page1), 'page1');
+
+    final handler = _ErrorCapture();
+    await interceptor.onError(_offline(page2), handler);
+
+    expect(handler.resolvedResponse, isNull); // page=2 was never cached
+  });
+
+  test('the key ignores query parameter order', () {
+    final a = _request('GET', '/events', {'a': 1, 'b': 2});
+    final b = _request('GET', '/events', {'b': 2, 'a': 1});
+    expect(CacheInterceptor.requestKey(a), CacheInterceptor.requestKey(b));
+  });
+}
@@ -1,4 +1,5 @@
 import 'package:fintracker_api/fintracker_api.dart';
+import 'package:fintracker_app/core/cache/cached.dart';
 import 'package:fintracker_app/core/widgets/money_text.dart';
 import 'package:fintracker_app/features/home/home_page.dart';
 import 'package:fintracker_app/features/home/providers.dart';
@@ -6,9 +7,7 @@ import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:flutter_test/flutter_test.dart';

-void main() {
-  testWidgets('Обзор renders stat tiles from a net worth breakdown', (tester) async {
-    final breakdown = NetWorthBreakdown(
+NetWorthBreakdown _breakdown() => NetWorthBreakdown(
      accounts: const [],
      byCurrency: const {'RUB': '123456.78'},
      d: DateTime(2026, 9, 17),
@@ -20,22 +19,33 @@ void main() {
      totalRub: '123456.78',
    );

+RunwayOut _runway() => RunwayOut(
+      asOf: DateTime(2026, 9, 17),
+      avgBaseline3mRub: '0',
+      liquidReserveRub: '0',
+      runwayMonths: null,
+    );
+
+// Every provider HomePage watches needs an override — including
+// portfolioSummaryHomeProvider, easy to forget since it renders nothing on an
+// empty ledger. Without it, HomePage falls through to the real apiProvider,
+// which now also opens a real ResponseCacheDatabase (see docs/ai/offline-cache.md).
+List<Override> _overrides({DateTime? staleAt}) => [
+      netWorthBreakdownProvider.overrideWith((ref) => Cached(_breakdown(), fetchedAt: staleAt)),
+      netWorthSeriesProvider.overrideWith((ref) => Cached(const <NetWorthDay>[], fetchedAt: staleAt)),
+      cashflowThisMonthProvider.overrideWith((ref) => Cached(null, fetchedAt: staleAt)),
+      cashflowLast12Provider.overrideWith((ref) => Cached(const <CashFlowMonth>[], fetchedAt: staleAt)),
+      runwayProvider.overrideWith((ref) => Cached(_runway(), fetchedAt: staleAt)),
+      metricsStatusProvider.overrideWith((ref) => Cached(null, fetchedAt: staleAt)),
+      dataQualityProvider.overrideWith((ref) => Cached(const <DataQualityRow>[], fetchedAt: staleAt)),
+      portfolioSummaryHomeProvider.overrideWith((ref) => Cached(null, fetchedAt: staleAt)),
+    ];
+
+void main() {
+  testWidgets('Обзор renders stat tiles from a net worth breakdown', (tester) async {
    await tester.pumpWidget(
      ProviderScope(
-        overrides: [
-          netWorthBreakdownProvider.overrideWith((ref) => breakdown),
-          netWorthSeriesProvider.overrideWith((ref) => const <NetWorthDay>[]),
-          cashflowThisMonthProvider.overrideWith((ref) => null),
-          cashflowLast12Provider.overrideWith((ref) => const <CashFlowMonth>[]),
-          runwayProvider.overrideWith((ref) => RunwayOut(
-                asOf: DateTime(2026, 9, 17),
-                avgBaseline3mRub: '0',
-                liquidReserveRub: '0',
-                runwayMonths: null,
-              )),
-          metricsStatusProvider.overrideWith((ref) => null),
-          dataQualityProvider.overrideWith((ref) => const <DataQualityRow>[]),
-        ],
+        overrides: _overrides(),
        child: const MaterialApp(home: HomePage()),
      ),
    );
@@ -47,5 +57,18 @@ void main() {
    expect(find.text(MoneyText.format('3000', 'RUB')), findsOneWidget);
    expect(find.text('Долги'), findsOneWidget);
    expect(find.text(MoneyText.format('1000', 'RUB')), findsOneWidget);
+    expect(find.textContaining('Нет соединения'), findsNothing);
+  });
+
+  testWidgets('shows the offline banner when the dashboard came from the cache', (tester) async {
+    await tester.pumpWidget(
+      ProviderScope(
+        overrides: _overrides(staleAt: DateTime(2026, 9, 10, 8, 30)),
+        child: const MaterialApp(home: HomePage()),
+      ),
+    );
+    await tester.pumpAndSettle();
+
+    expect(find.textContaining('Нет соединения — данные на 10.09.2026 08:30'), findsOneWidget);
  });
 }