feat(mobile): login, password change and logout screens
P3 Task 3 移动端（对接 Task 2 api client + 本任务新增的后端契约）： - 登录页实装：账号/密码表单（空值客户端校验）→ api.login（会话自动 持久化）→ pushReplacement /home；错误码本地化（AUTH_INVALID_ CREDENTIALS / AUTH_RATE_LIMITED（含稍后再试文案）/ 网络 / 校验）； 提交加载态防重复提交。 - 修改密码页（设置页入口）：当前/新/确认三字段，客户端校验（≥8 位、 两次一致）→ api.changePassword → toast + pop；成功后本地会话不变 （服务端保留当前会话）；旧密码错误（401 AUTH_INVALID_CREDENTIALS） 显示「当前密码错误」且不触发 401 驱逐。 - 退出登录：设置页按钮 → api.logout 尽力而为 → 清会话 → 清栈回 /login；App 壳 initState 注册 onUnauthorized（业务 401 → 清栈 /login）， 根 navigatorKey 接线；password-change 的 401 豁免会话驱逐（拦截器 豁免集合与令牌附加分离）。 - l10n：新增 16 组 zh/en 文案；错误码 → 文案解析扩展 （core/error_l10n.dart，errorCode→AppLocalizations）。 - 测试：ApiClient.changePassword 单测 ×2（Bearer+请求体；旧密码 401 不驱逐）；widget 测试 ×12（登录 5：空值/成功跳转/凭据错误/限速文案/ 加载禁用；改密 4：过短/不一致/旧密码错误文案+会话保留/成功 toast+pop 且令牌不变；设置 2：改密入口跳转/登出清会话回登录；App 壳 1：401 清栈回 /login）。flutter analyze 0 issue；flutter test 81/81。 Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
@@ -0,0 +1,155 @@
|
||||
/// 登录页 widget 测试（P3 计划 Task 3）。
|
||||
///
|
||||
/// 覆盖：空字段客户端校验（不发请求）、成功登录写会话并跳 /home、
|
||||
/// 凭据错误/限速（429）错误码本地化文案、提交中加载态（按钮禁用防重复提交）。
|
||||
/// API 层经 FakeAdapter（dio HttpClientAdapter）打桩，Provider 以 override
|
||||
/// 注入测试客户端（无真实网络）。
|
||||
library;
|
||||
|
||||
import 'dart:async';
|
||||
|
||||
import 'package:dio/dio.dart';
|
||||
import 'package:flutter/material.dart';
|
||||
import 'package:flutter_riverpod/flutter_riverpod.dart';
|
||||
import 'package:flutter_test/flutter_test.dart';
|
||||
import 'package:photo_live/core/api_client.dart';
|
||||
import 'package:photo_live/core/error_codes.dart';
|
||||
import 'package:photo_live/l10n/app_localizations.dart';
|
||||
import 'package:photo_live/pages/login_page.dart';
|
||||
|
||||
import '../helpers/fakes.dart';
|
||||
|
||||
void main() {
|
||||
late FakeSessionStore store;
|
||||
late int unauthorizedCalls;
|
||||
|
||||
setUp(() {
|
||||
store = FakeSessionStore();
|
||||
unauthorizedCalls = 0;
|
||||
});
|
||||
|
||||
ApiClient clientOf(FakeAdapter adapter) => ApiClient(
|
||||
sessionStore: store,
|
||||
dio: Dio(BaseOptions(baseUrl: 'http://test.local'))
|
||||
..httpClientAdapter = adapter,
|
||||
)..onUnauthorized = () => unauthorizedCalls++;
|
||||
|
||||
Future<void> pumpLoginPage(WidgetTester tester, ApiClient client) async {
|
||||
await tester.pumpWidget(
|
||||
ProviderScope(
|
||||
overrides: [apiClientProvider.overrideWith((ref) => client)],
|
||||
child: MaterialApp(
|
||||
localizationsDelegates: AppLocalizations.localizationsDelegates,
|
||||
supportedLocales: AppLocalizations.supportedLocales,
|
||||
home: const LoginPage(),
|
||||
routes: {
|
||||
'/home': (context) =>
|
||||
const Scaffold(body: Center(child: Text('HOME_MARK'))),
|
||||
},
|
||||
),
|
||||
),
|
||||
);
|
||||
await tester.pumpAndSettle();
|
||||
}
|
||||
|
||||
Future<void> fillAndSubmit(WidgetTester tester) async {
|
||||
await tester.enterText(
|
||||
find.widgetWithText(TextFormField, 'Account'),
|
||||
'staff01',
|
||||
);
|
||||
await tester.enterText(
|
||||
find.widgetWithText(TextFormField, 'Password'),
|
||||
'pw-123456',
|
||||
);
|
||||
await tester.tap(find.text('Sign in'));
|
||||
await tester.pump(); // 触发提交（含 SnackBar 动画首帧）。
|
||||
}
|
||||
|
||||
testWidgets('空字段 → 客户端校验提示，不发请求', (tester) async {
|
||||
final adapter = FakeAdapter((_) => throw StateError('不应发起请求'));
|
||||
await pumpLoginPage(tester, clientOf(adapter));
|
||||
|
||||
await tester.tap(find.text('Sign in'));
|
||||
await tester.pump();
|
||||
|
||||
// 测试环境默认 locale=en：账号/密码两个必填提示。
|
||||
expect(find.text('This field is required'), findsNWidgets(2));
|
||||
expect(adapter.requests, isEmpty);
|
||||
});
|
||||
|
||||
testWidgets('成功 → 写会话并跳 /home', (tester) async {
|
||||
final adapter = FakeAdapter(
|
||||
(o) => o.path == '/v1/auth/password' ? (200, loginOkBody())
|
||||
: throw StateError('unexpected ${o.path}'),
|
||||
);
|
||||
await pumpLoginPage(tester, clientOf(adapter));
|
||||
|
||||
await fillAndSubmit(tester);
|
||||
await tester.pumpAndSettle();
|
||||
|
||||
expect(find.text('HOME_MARK'), findsOneWidget);
|
||||
expect(store.session?.token, 'tok-new');
|
||||
expect(store.session?.account, 'staff01');
|
||||
expect(
|
||||
adapter.requests.single.body,
|
||||
{'account': 'staff01', 'password': 'pw-123456'},
|
||||
);
|
||||
});
|
||||
|
||||
testWidgets('凭据错误（401）→ 「账号或密码错误」文案，不驱逐通知', (tester) async {
|
||||
final adapter = FakeAdapter(
|
||||
(o) => o.path == '/v1/auth/password'
|
||||
? (401, errorBody(ErrorCodes.authInvalidCredentials))
|
||||
: throw StateError('unexpected ${o.path}'),
|
||||
);
|
||||
await pumpLoginPage(tester, clientOf(adapter));
|
||||
|
||||
await fillAndSubmit(tester);
|
||||
await tester.pumpAndSettle();
|
||||
|
||||
expect(find.text('Incorrect account or password'), findsOneWidget);
|
||||
expect(store.session, isNull, reason: '登录失败不落会话');
|
||||
expect(unauthorizedCalls, 0, reason: '登录 401 不触发驱逐');
|
||||
expect(find.text('HOME_MARK'), findsNothing);
|
||||
});
|
||||
|
||||
testWidgets('限速（429 AUTH_RATE_LIMITED）→ 稍后再试文案', (tester) async {
|
||||
final adapter = FakeAdapter(
|
||||
(o) => o.path == '/v1/auth/password'
|
||||
? (429, errorBody(ErrorCodes.authRateLimited))
|
||||
: throw StateError('unexpected ${o.path}'),
|
||||
);
|
||||
await pumpLoginPage(tester, clientOf(adapter));
|
||||
|
||||
await fillAndSubmit(tester);
|
||||
await tester.pumpAndSettle();
|
||||
|
||||
expect(
|
||||
find.text('Too many attempts. Please try again later'),
|
||||
findsOneWidget,
|
||||
);
|
||||
});
|
||||
|
||||
testWidgets('提交中 → 加载指示且按钮禁用（防重复提交）', (tester) async {
|
||||
final gate = Completer<void>();
|
||||
final adapter = FakeAdapter((o) async {
|
||||
await gate.future;
|
||||
return (200, loginOkBody());
|
||||
});
|
||||
await pumpLoginPage(tester, clientOf(adapter));
|
||||
|
||||
await fillAndSubmit(tester);
|
||||
// dio 链路经真实定时器推进（fake-async 需步进时钟才抵达适配器）。
|
||||
await tester.pump(const Duration(milliseconds: 50));
|
||||
|
||||
expect(find.byType(CircularProgressIndicator), findsOneWidget);
|
||||
// 加载中再点按钮（onPressed=null）不产生第二个请求。
|
||||
await tester.tap(find.byType(FilledButton), warnIfMissed: false);
|
||||
await tester.pump(const Duration(milliseconds: 50));
|
||||
expect(adapter.requests, hasLength(1));
|
||||
|
||||
gate.complete();
|
||||
await tester.pumpAndSettle();
|
||||
expect(find.text('HOME_MARK'), findsOneWidget);
|
||||
});
|
||||
}
|
||||
@@ -0,0 +1,164 @@
|
||||
/// 修改密码页 widget 测试（P3 计划 Task 3）。
|
||||
///
|
||||
/// 覆盖：客户端校验（新密码 ≥8、两次一致；不发请求）、旧密码错误
|
||||
/// （401 AUTH_INVALID_CREDENTIALS）→「当前密码错误」文案且本地会话保留
|
||||
/// （password-change 的 401 不驱逐）、成功 → toast + pop 回上级且
|
||||
/// 会话令牌不变（服务端保留当前会话语义）。
|
||||
library;
|
||||
|
||||
import 'package:dio/dio.dart';
|
||||
import 'package:flutter/material.dart';
|
||||
import 'package:flutter_riverpod/flutter_riverpod.dart';
|
||||
import 'package:flutter_test/flutter_test.dart';
|
||||
import 'package:photo_live/core/api_client.dart';
|
||||
import 'package:photo_live/core/error_codes.dart';
|
||||
import 'package:photo_live/core/session_store.dart';
|
||||
import 'package:photo_live/l10n/app_localizations.dart';
|
||||
import 'package:photo_live/pages/password_change_page.dart';
|
||||
|
||||
import '../helpers/fakes.dart';
|
||||
|
||||
void main() {
|
||||
late FakeSessionStore store;
|
||||
late int unauthorizedCalls;
|
||||
|
||||
setUp(() {
|
||||
store = FakeSessionStore();
|
||||
unauthorizedCalls = 0;
|
||||
});
|
||||
|
||||
ApiClient clientOf(FakeAdapter adapter) => ApiClient(
|
||||
sessionStore: store,
|
||||
dio: Dio(BaseOptions(baseUrl: 'http://test.local'))
|
||||
..httpClientAdapter = adapter,
|
||||
)..onUnauthorized = () => unauthorizedCalls++;
|
||||
|
||||
void seedSession() {
|
||||
store.session = Session(
|
||||
token: 'tok-live-1',
|
||||
expiresAt: DateTime.utc(2099, 1, 1),
|
||||
account: 'staff01',
|
||||
);
|
||||
}
|
||||
|
||||
Future<void> pumpOverMarker(WidgetTester tester, ApiClient client) async {
|
||||
await tester.pumpWidget(
|
||||
ProviderScope(
|
||||
overrides: [apiClientProvider.overrideWith((ref) => client)],
|
||||
child: MaterialApp(
|
||||
localizationsDelegates: AppLocalizations.localizationsDelegates,
|
||||
supportedLocales: AppLocalizations.supportedLocales,
|
||||
home: const Scaffold(body: Center(child: Text('MARK'))),
|
||||
routes: {
|
||||
'/password-change': (context) => const PasswordChangePage(),
|
||||
},
|
||||
),
|
||||
),
|
||||
);
|
||||
tester.state<NavigatorState>(find.byType(Navigator).first)
|
||||
.pushNamed('/password-change');
|
||||
await tester.pumpAndSettle();
|
||||
}
|
||||
|
||||
Future<void> fill(
|
||||
WidgetTester tester, {
|
||||
String oldPw = 'old-pass-123',
|
||||
String newPw = 'brand-new-pass-9',
|
||||
String confirmPw = 'brand-new-pass-9',
|
||||
}) async {
|
||||
await tester.enterText(
|
||||
find.widgetWithText(TextFormField, 'Current password'),
|
||||
oldPw,
|
||||
);
|
||||
await tester.enterText(
|
||||
find.widgetWithText(TextFormField, 'New password'),
|
||||
newPw,
|
||||
);
|
||||
await tester.enterText(
|
||||
find.widgetWithText(TextFormField, 'Confirm new password'),
|
||||
confirmPw,
|
||||
);
|
||||
}
|
||||
|
||||
testWidgets('新密码过短 → 客户端校验提示，不发请求', (tester) async {
|
||||
seedSession();
|
||||
final adapter = FakeAdapter((_) => throw StateError('不应发起请求'));
|
||||
await pumpOverMarker(tester, clientOf(adapter));
|
||||
|
||||
await fill(tester, newPw: 'short7', confirmPw: 'short7');
|
||||
await tester.tap(find.widgetWithText(FilledButton, 'Change password'));
|
||||
await tester.pump();
|
||||
|
||||
expect(
|
||||
find.text('New password must be at least 8 characters'),
|
||||
findsOneWidget,
|
||||
);
|
||||
expect(adapter.requests, isEmpty);
|
||||
});
|
||||
|
||||
testWidgets('两次新密码不一致 → 校验提示，不发请求', (tester) async {
|
||||
seedSession();
|
||||
final adapter = FakeAdapter((_) => throw StateError('不应发起请求'));
|
||||
await pumpOverMarker(tester, clientOf(adapter));
|
||||
|
||||
await fill(tester, confirmPw: 'different-pass-9');
|
||||
await tester.tap(find.widgetWithText(FilledButton, 'Change password'));
|
||||
await tester.pump();
|
||||
|
||||
expect(
|
||||
find.text('New passwords do not match'),
|
||||
findsOneWidget,
|
||||
);
|
||||
expect(adapter.requests, isEmpty);
|
||||
});
|
||||
|
||||
testWidgets('旧密码错误（401）→ 「当前密码错误」文案，会话保留不驱逐', (tester) async {
|
||||
seedSession();
|
||||
final adapter = FakeAdapter(
|
||||
(o) => o.path == '/v1/auth/password-change'
|
||||
? (401, errorBody(ErrorCodes.authInvalidCredentials))
|
||||
: throw StateError('unexpected ${o.path}'),
|
||||
);
|
||||
await pumpOverMarker(tester, clientOf(adapter));
|
||||
|
||||
await fill(tester);
|
||||
await tester.tap(find.widgetWithText(FilledButton, 'Change password'));
|
||||
await tester.pumpAndSettle();
|
||||
|
||||
expect(find.text('Current password is incorrect'), findsOneWidget);
|
||||
expect(store.session?.token, 'tok-live-1', reason: '旧密码错误不清会话');
|
||||
expect(unauthorizedCalls, 0, reason: 'password-change 的 401 不驱逐');
|
||||
expect(find.text('MARK'), findsNothing, reason: '停留在修改密码页');
|
||||
});
|
||||
|
||||
testWidgets('成功 → toast + pop 回上级；会话令牌不变（当前会话保留）', (tester) async {
|
||||
seedSession();
|
||||
final adapter = FakeAdapter(
|
||||
(o) => o.path == '/v1/auth/password-change'
|
||||
? (204, null)
|
||||
: throw StateError('unexpected ${o.path}'),
|
||||
);
|
||||
await pumpOverMarker(tester, clientOf(adapter));
|
||||
|
||||
await fill(tester);
|
||||
await tester.tap(find.widgetWithText(FilledButton, 'Change password'));
|
||||
await tester.pumpAndSettle();
|
||||
|
||||
final req = adapter.requests.single;
|
||||
expect(req.method, 'POST');
|
||||
expect(req.path, '/v1/auth/password-change');
|
||||
expect(req.headers['Authorization'], 'Bearer tok-live-1');
|
||||
expect(req.body, {
|
||||
'oldPassword': 'old-pass-123',
|
||||
'newPassword': 'brand-new-pass-9',
|
||||
});
|
||||
|
||||
expect(find.text('Password changed'), findsOneWidget);
|
||||
expect(find.text('MARK'), findsOneWidget, reason: '成功后 pop 回上级');
|
||||
expect(
|
||||
store.session?.token,
|
||||
'tok-live-1',
|
||||
reason: '服务端保留当前会话：本地令牌无需变更',
|
||||
);
|
||||
});
|
||||
}
|
||||
@@ -0,0 +1,88 @@
|
||||
/// 设置页 widget 测试（P3 计划 Task 3）。
|
||||
///
|
||||
/// 覆盖：修改密码入口跳 /password-change；退出登录 → 调 api.logout
|
||||
/// （尽力而为）→ 清空本地会话 → 清栈回 /login。
|
||||
library;
|
||||
|
||||
import 'package:dio/dio.dart';
|
||||
import 'package:flutter/material.dart';
|
||||
import 'package:flutter_riverpod/flutter_riverpod.dart';
|
||||
import 'package:flutter_test/flutter_test.dart';
|
||||
import 'package:photo_live/core/api_client.dart';
|
||||
import 'package:photo_live/core/session_store.dart';
|
||||
import 'package:photo_live/l10n/app_localizations.dart';
|
||||
import 'package:photo_live/pages/home_page.dart';
|
||||
import 'package:photo_live/pages/login_page.dart';
|
||||
import 'package:photo_live/pages/password_change_page.dart';
|
||||
|
||||
import '../helpers/fakes.dart';
|
||||
|
||||
void main() {
|
||||
late FakeSessionStore store;
|
||||
|
||||
setUp(() {
|
||||
store = FakeSessionStore();
|
||||
store.session = Session(
|
||||
token: 'tok-live-1',
|
||||
expiresAt: DateTime.utc(2099, 1, 1),
|
||||
account: 'staff01',
|
||||
);
|
||||
});
|
||||
|
||||
ApiClient clientOf(FakeAdapter adapter) => ApiClient(
|
||||
sessionStore: store,
|
||||
dio: Dio(BaseOptions(baseUrl: 'http://test.local'))
|
||||
..httpClientAdapter = adapter,
|
||||
);
|
||||
|
||||
Future<void> pumpHome(WidgetTester tester, ApiClient client) async {
|
||||
await tester.pumpWidget(
|
||||
ProviderScope(
|
||||
overrides: [apiClientProvider.overrideWith((ref) => client)],
|
||||
child: MaterialApp(
|
||||
localizationsDelegates: AppLocalizations.localizationsDelegates,
|
||||
supportedLocales: AppLocalizations.supportedLocales,
|
||||
home: const HomePage(),
|
||||
routes: {
|
||||
'/login': (context) => const LoginPage(),
|
||||
'/password-change': (context) => const PasswordChangePage(),
|
||||
},
|
||||
),
|
||||
),
|
||||
);
|
||||
await tester.pumpAndSettle();
|
||||
// 切到设置 tab（底部导航第三项）。
|
||||
await tester.tap(find.byIcon(Icons.settings_outlined));
|
||||
await tester.pumpAndSettle();
|
||||
}
|
||||
|
||||
testWidgets('修改密码入口 → 跳 /password-change', (tester) async {
|
||||
final adapter = FakeAdapter((_) => throw StateError('不应发起请求'));
|
||||
await pumpHome(tester, clientOf(adapter));
|
||||
|
||||
await tester.tap(find.text('Change password'));
|
||||
await tester.pumpAndSettle();
|
||||
|
||||
expect(find.byType(PasswordChangePage), findsOneWidget);
|
||||
});
|
||||
|
||||
testWidgets('退出登录 → api.logout + 清会话 + 清栈回 /login（服务端失败亦然）',
|
||||
(tester) async {
|
||||
// 服务端撤销失败（500）也照样本地登出——尽力而为语义。
|
||||
final adapter = FakeAdapter(
|
||||
(o) => o.path == '/v1/auth/logout'
|
||||
? (500, errorBody('INTERNAL_ERROR'))
|
||||
: throw StateError('unexpected ${o.path}'),
|
||||
);
|
||||
await pumpHome(tester, clientOf(adapter));
|
||||
|
||||
await tester.tap(find.text('Sign out'));
|
||||
await tester.pumpAndSettle();
|
||||
|
||||
expect(adapter.requests.single.path, '/v1/auth/logout');
|
||||
expect(adapter.requests.single.method, 'POST');
|
||||
expect(store.session, isNull, reason: '本地会话必须清除');
|
||||
expect(find.byType(LoginPage), findsOneWidget);
|
||||
expect(find.byType(HomePage), findsNothing, reason: '主壳已出栈');
|
||||
});
|
||||
}
|
||||
Reference in New Issue
Block a user