feat: 落地登录纵切——网络层、认证会话与登录/注册/Splash 三页（ADR-003/ADR-004）

- 新增 lib/core/network/：ApiClient（dio 封装，错误信封→类型化异常，base URL 经 --dart-define=PATBOND_API_BASE_URL 注入）、AuthInterceptor（Bearer + 设备标识）、TokenRefresher（单飞刷新，401/40101 重放一次，仅 40102/再 401 清会话） - 新增 lib/features/auth/：SessionManager（token 只进 flutter_secure_storage）、AuthRepository（login/register/refresh/logout/me，注册带 Idempotency-Key）、Splash（500ms 最短停留/5s 超时/错误态重试+改用账号登录）、登录页与注册页（照 12 号组装稿，错误三层映射，预留区不渲染） - App 根组件改为认证状态机驱动（Splash↔登录↔主壳 300ms fade）；个人中心退出登录接入真实 logout - 顺带修复：FIX-1 促销卡渐变改 [primaryStrong, primary]、FIX-2 补 helperStyle: muted、README dart format 命令补 --output=none - 新增依赖：dio ^5.11.1、flutter_secure_storage ^11.0.0、uuid ^4.6.0 - 门禁：dart format（0 changed）/ flutter analyze（No issues）/ flutter test（30 passed，其中新增 23：TokenRefresher 5 + AuthRepository 10 + 登录页 4 + 注册页 4） Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-04 11:52:51 +08:00
parent ee77361b92
commit 8d890c0424
30 changed files with 2306 additions and 9 deletions
@@ -0,0 +1,99 @@
+import 'dart:async';
+
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:patbond_flutter/core/network/api_exception.dart';
+import 'package:patbond_flutter/core/theme/app_theme.dart';
+import 'package:patbond_flutter/core/widgets/inline_error_banner.dart';
+import 'package:patbond_flutter/features/auth/auth_repository.dart';
+import 'package:patbond_flutter/features/auth/login_page.dart';
+
+import '../../helpers/auth_test_helpers.dart';
+
+void main() {
+  Future<void> pumpLogin(WidgetTester tester, AuthRepository repository) {
+    return tester.pumpWidget(
+      MaterialApp(
+        theme: buildAppTheme(),
+        home: LoginPage(authRepository: repository),
+      ),
+    );
+  }
+
+  Future<void> fillValidInput(WidgetTester tester) async {
+    await tester.enterText(find.byType(TextFormField).at(0), 'gunnar');
+    await tester.enterText(find.byType(TextFormField).at(1), 'passw0rd');
+  }
+
+  testWidgets('初始态：品牌区、两个输入框、登录按钮与注册链接，无错误无 loading', (tester) async {
+    await pumpLogin(tester, FakeAuthRepository());
+
+    expect(find.text('Patbond'), findsOneWidget);
+    expect(find.text('用户名 / 手机号'), findsOneWidget);
+    expect(find.text('密码'), findsOneWidget);
+    expect(find.text('登录'), findsOneWidget);
+    expect(find.text('立即注册'), findsOneWidget);
+    expect(find.byType(InlineErrorBanner), findsNothing);
+    expect(find.byType(CircularProgressIndicator), findsNothing);
+  });
+
+  testWidgets('loading 态：按钮转圈、字段禁用、注册链接不可点', (tester) async {
+    final completer = Completer<void>();
+    final repository = FakeAuthRepository(loginHandler: () => completer.future);
+    await pumpLogin(tester, repository);
+
+    await fillValidInput(tester);
+    await tester.tap(find.text('登录'));
+    await tester.pump();
+
+    expect(find.byType(CircularProgressIndicator), findsOneWidget);
+    final fields = tester.widgetList<TextFormField>(find.byType(TextFormField));
+    expect(fields.every((field) => field.enabled == false), isTrue);
+    final registerLink = tester.widget<TextButton>(
+      find.widgetWithText(TextButton, '立即注册'),
+    );
+    expect(registerLink.onPressed, isNull);
+
+    completer.complete();
+    await tester.pumpAndSettle();
+    expect(find.byType(CircularProgressIndicator), findsNothing);
+  });
+
+  testWidgets('字段错误态：空表单提交显示两条字段级错误，输入即清除', (tester) async {
+    final repository = FakeAuthRepository();
+    await pumpLogin(tester, repository);
+
+    await tester.tap(find.text('登录'));
+    await tester.pump();
+
+    expect(find.text('请输入用户名或手机号'), findsOneWidget);
+    expect(find.text('请输入密码'), findsOneWidget);
+    expect(repository.loginCalls, 0);
+
+    await tester.enterText(find.byType(TextFormField).at(0), 'g');
+    await tester.pump();
+    expect(find.text('请输入用户名或手机号'), findsNothing);
+    expect(find.text('请输入密码'), findsOneWidget);
+  });
+
+  testWidgets('横幅错误态：40100 显示「用户名或密码错误」，任一字段输入即清除', (tester) async {
+    final repository = FakeAuthRepository(
+      loginHandler: () => Future.error(
+        const ApiBusinessException(code: ApiCodes.badCredentials, message: ''),
+      ),
+    );
+    await pumpLogin(tester, repository);
+
+    await fillValidInput(tester);
+    await tester.tap(find.text('登录'));
+    await tester.pumpAndSettle();
+
+    expect(find.byType(InlineErrorBanner), findsOneWidget);
+    expect(find.text('用户名或密码错误'), findsOneWidget);
+    expect(repository.loginCalls, 1);
+
+    await tester.enterText(find.byType(TextFormField).at(1), 'changed1');
+    await tester.pump();
+    expect(find.byType(InlineErrorBanner), findsNothing);
+  });
+}