feat(mobile): album management pages with qr share

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-09-19 01:56:38 +08:00
parent 8be21b856b
commit bbea1dd364
27 changed files with 5485 additions and 28 deletions
@@ -0,0 +1,269 @@
/// 相册详情页 widget 测试(P3 计划 Task 4)。
///
/// 覆盖:详情信息区(标题/状态/时间时区/令牌/开关标签)与动作行;
/// 分类管理三流(新增对话框载荷、名称空校验拦截、编辑 PATCH、删除确认)。
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/l10n/app_localizations.dart';
import 'package:photo_live/pages/album_detail_page.dart';
import '../helpers/fakes.dart';
void main() {
late FakeSessionStore store;
late List<Map<String, dynamic>> categories;
setUp(() {
store = FakeSessionStore();
categories = <Map<String, dynamic>>[
categoryJson(id: 'cat-1', sortOrder: 0),
];
});
/// 路由:GET 详情(反映可变分类表)/ 分类 CRUD;其余路径直接抛错。
FakeAdapter detailAdapter({
(int, Object?)? Function(String method, String path)? onCategoryMutation,
}) =>
FakeAdapter((o) {
if (o.path == '/v1/albums/alb-1' && o.method == 'GET') {
return (200, albumJson(categories: categories));
}
if (o.path == '/v1/albums/alb-1/categories' && o.method == 'POST') {
return onCategoryMutation?.call('POST', o.path) ?? (201, categoryJson(id: 'cat-new'));
}
if (o.path.startsWith('/v1/categories/') && o.method == 'PATCH') {
return onCategoryMutation?.call('PATCH', o.path) ??
(200, categoryJson(id: 'cat-1'));
}
if (o.path.startsWith('/v1/categories/') && o.method == 'DELETE') {
return onCategoryMutation?.call('DELETE', o.path) ?? (204, null);
}
throw StateError('unexpected ${o.method} ${o.path}');
});
ApiClient clientOf(FakeAdapter adapter) => ApiClient(
sessionStore: store,
dio: Dio(BaseOptions(baseUrl: 'http://test.local'))
..httpClientAdapter = adapter,
);
Future<void> pumpDetail(WidgetTester tester, ApiClient client) async {
await tester.pumpWidget(
ProviderScope(
overrides: [apiClientProvider.overrideWith((ref) => client)],
child: MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
home: const AlbumDetailPage(albumId: 'alb-1'),
),
),
);
await tester.pumpAndSettle();
}
testWidgets('加载详情 → 信息区 + 动作行 + 分类列表', (tester) async {
final adapter = detailAdapter();
await pumpDetail(tester, clientOf(adapter));
// 信息区(标题同时出现在 AppBar 与信息卡)。
expect(find.text('开幕晚宴'), findsNWidgets(2));
expect(find.text('Active'), findsOneWidget);
expect(
find.text('2026/9/18 14:30 ~ Not set (Asia/Shanghai)'),
findsOneWidget,
);
expect(find.text('sharetoken000000000001'), findsOneWidget);
expect(find.text('大宴会厅'), findsOneWidget);
expect(find.text('Upload'), findsOneWidget);
expect(find.text('Original'), findsOneWidget);
// 动作行(5 项)。
expect(find.text('Edit'), findsOneWidget);
expect(find.text('Members'), findsOneWidget);
// 「Categories」同时出现在动作按钮与分区标题。
expect(find.text('Categories'), findsNWidgets(2));
expect(find.text('Share QR code'), findsOneWidget);
expect(find.text('Photos'), findsOneWidget);
// 分类条目(zh · en 名称连接)。
expect(find.text('仪式 · Ceremony'), findsOneWidget);
});
testWidgets('新增分类:填名称与排序 → POST 载荷 → 列表刷新', (tester) async {
var posted = false;
final adapter = detailAdapter(
onCategoryMutation: (method, path) {
if (method == 'POST') {
posted = true;
categories = <Map<String, dynamic>>[
...categories,
categoryJson(
id: 'cat-new',
sortOrder: 5,
translations: <Map<String, dynamic>>[
<String, dynamic>{'locale': 'zh-CN', 'name': '签到'},
<String, dynamic>{'locale': 'en', 'name': 'Check-in'},
],
),
];
return (201, categoryJson(id: 'cat-new', sortOrder: 5));
}
return null;
},
);
await pumpDetail(tester, clientOf(adapter));
await tester.tap(find.byIcon(Icons.add_circle_outline));
await tester.pumpAndSettle();
await tester.enterText(
find.widgetWithText(TextFormField, 'Chinese name'),
'签到',
);
await tester.enterText(
find.widgetWithText(TextFormField, 'English name'),
'Check-in',
);
await tester.enterText(
find.widgetWithText(TextFormField, 'Sort order'),
'5',
);
await tester.tap(find.text('Save'));
await tester.pumpAndSettle();
expect(posted, isTrue);
// 成功后详情重载会追加 GET,故按方法+路径取 POST。
final request = adapter.requests.singleWhere(
(r) => r.method == 'POST' && r.path == '/v1/albums/alb-1/categories',
);
expect(request.path, '/v1/albums/alb-1/categories');
expect(request.body, <String, dynamic>{
'sortOrder': 5,
'translations': <Map<String, dynamic>>[
<String, dynamic>{'locale': 'zh-CN', 'name': '签到'},
<String, dynamic>{'locale': 'en', 'name': 'Check-in'},
],
});
// 详情重载后列表含新分类。
expect(find.text('签到 · Check-in'), findsOneWidget);
});
testWidgets('新增分类:名称全空 → 客户端拦截,不发请求', (tester) async {
final adapter = detailAdapter();
await pumpDetail(tester, clientOf(adapter));
final requestsBefore = adapter.requests.length;
await tester.tap(find.byIcon(Icons.add_circle_outline));
await tester.pumpAndSettle();
await tester.tap(find.text('Save'));
await tester.pump();
expect(
find.text('At least one language name is required'),
findsOneWidget,
);
expect(adapter.requests, hasLength(requestsBefore));
});
testWidgets('编辑分类:预填并改名 → PATCH 全量 translations + sortOrder',
(tester) async {
var patched = false;
final adapter = detailAdapter(
onCategoryMutation: (method, path) {
if (method == 'PATCH') {
patched = true;
categories = <Map<String, dynamic>>[
categoryJson(
id: 'cat-1',
sortOrder: 2,
translations: <Map<String, dynamic>>[
<String, dynamic>{'locale': 'zh-CN', 'name': '签到墙'},
<String, dynamic>{'locale': 'en', 'name': 'Ceremony'},
],
),
];
return (200, categoryJson(id: 'cat-1'));
}
return null;
},
);
await pumpDetail(tester, clientOf(adapter));
await tester.tap(find.text('仪式 · Ceremony'));
await tester.pumpAndSettle();
// 预填检查。
final zhField = tester.widget<TextFormField>(
find.widgetWithText(TextFormField, 'Chinese name'),
);
expect(zhField.controller!.text, '仪式');
await tester.enterText(
find.widgetWithText(TextFormField, 'Chinese name'),
'签到墙',
);
await tester.enterText(
find.widgetWithText(TextFormField, 'Sort order'),
'2',
);
await tester.tap(find.text('Save'));
await tester.pumpAndSettle();
expect(patched, isTrue);
// 成功后详情重载会追加 GET,故按方法+路径取 PATCH。
final request = adapter.requests.singleWhere(
(r) => r.method == 'PATCH' && r.path == '/v1/categories/cat-1',
);
expect(request.body, <String, dynamic>{
'sortOrder': 2,
'translations': <Map<String, dynamic>>[
<String, dynamic>{'locale': 'zh-CN', 'name': '签到墙'},
<String, dynamic>{'locale': 'en', 'name': 'Ceremony'},
],
});
expect(find.text('签到墙 · Ceremony'), findsOneWidget);
});
testWidgets('删除分类:确认对话框 → DELETE → 列表移除', (tester) async {
final adapter = detailAdapter(
onCategoryMutation: (method, path) {
if (method == 'DELETE') {
categories = <Map<String, dynamic>>[];
return (204, null);
}
return null;
},
);
await pumpDetail(tester, clientOf(adapter));
await tester.tap(find.byIcon(Icons.delete_outline));
await tester.pumpAndSettle();
expect(
find.text('Delete this category? Its photos will become uncategorized.'),
findsOneWidget,
);
// 取消可用:先取消再重删,验证确认门。
await tester.tap(find.text('Cancel'));
await tester.pumpAndSettle();
expect(find.text('仪式 · Ceremony'), findsOneWidget);
await tester.tap(find.byIcon(Icons.delete_outline));
await tester.pumpAndSettle();
await tester.tap(find.widgetWithText(FilledButton, 'Delete'));
await tester.pumpAndSettle();
expect(
adapter.requests.any(
(r) => r.method == 'DELETE' && r.path == '/v1/categories/cat-1',
),
isTrue,
);
expect(find.text('仪式 · Ceremony'), findsNothing);
expect(find.text('No categories yet. Tap + to add one'), findsOneWidget);
});
}
@@ -0,0 +1,321 @@
/// 相册创建/编辑表单 widget 测试(P3 计划 Task 4)。
///
/// 覆盖:校验矩阵(默认语言标题缺失/未选开始时间/endAt 早于 startAt)、
/// 创建成功 POST 载荷形状、编辑预加载(字段与四开关初值、创建仅两开关)、
/// PATCH 最小化(仅拨动的开关出现在请求体)、endAt 显式清除、
/// 标题修改仅发全量 translations。
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/features/albums/album_form.dart';
import 'package:photo_live/features/albums/models.dart';
import 'package:photo_live/l10n/app_localizations.dart';
import 'package:photo_live/pages/album_form_page.dart';
import '../helpers/fakes.dart';
void main() {
late FakeSessionStore store;
setUp(() {
store = FakeSessionStore();
});
ApiClient clientOf(FakeAdapter adapter) => ApiClient(
sessionStore: store,
dio: Dio(BaseOptions(baseUrl: 'http://test.local'))
..httpClientAdapter = adapter,
);
Future<void> pumpForm(
WidgetTester tester,
ApiClient client, {
Album? existing,
AlbumFormDraft? initialDraft,
}) async {
await tester.pumpWidget(
ProviderScope(
overrides: [apiClientProvider.overrideWith((ref) => client)],
child: MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
home: AlbumFormPage(existing: existing, initialDraft: initialDraft),
),
),
);
await tester.pumpAndSettle();
}
/// 创建模式合法草稿(测试注入开始/结束时间,避开平台日期选择器)。
AlbumFormDraft createDraft({
String zhTitle = '开幕晚宴',
String enTitle = 'Opening Gala',
String defaultLocale = 'zh-CN',
DateTime? startAt,
DateTime? endAt,
bool downloadEnabled = true,
bool originalDownloadEnabled = false,
}) =>
AlbumFormDraft(
zh: AlbumTranslationDraft(locale: 'zh-CN', title: zhTitle),
en: AlbumTranslationDraft(locale: 'en', title: enTitle),
defaultLocale: defaultLocale,
timezone: 'Asia/Shanghai',
startAt: startAt ?? DateTime.utc(2026, 9, 18, 6, 30),
endAt: endAt,
downloadEnabled: downloadEnabled,
originalDownloadEnabled: originalDownloadEnabled,
);
/// 表单长于测试视口(800x600):按钮常在折叠线下,tap 前先滚动可见。
Future<void> tapVisible(WidgetTester tester, Finder finder) async {
await tester.ensureVisible(finder);
await tester.pumpAndSettle();
await tester.tap(finder);
}
testWidgets('创建:空表单提交 → 汇总错误(默认语言标题/开始时间),不发请求',
(tester) async {
final adapter = FakeAdapter((_) => throw StateError('不应发起请求'));
await pumpForm(tester, clientOf(adapter));
// 创建模式仅两开关(download/original)。
expect(find.byType(SwitchListTile), findsNWidgets(2));
await tapVisible(tester, find.text('Create'));
await tester.pump();
expect(find.text('Default locale must have a title'), findsOneWidget);
// 开始时间行占位与汇总错误复用同一文案 → 2 处。
expect(find.text('Pick a start time'), findsNWidgets(2));
expect(adapter.requests, isEmpty);
});
testWidgets('创建:defaultLocale=en 而 en 标题空 → 默认语言覆盖错误',
(tester) async {
final adapter = FakeAdapter((_) => throw StateError('不应发起请求'));
await pumpForm(
tester,
clientOf(adapter),
initialDraft: createDraft(defaultLocale: 'en', enTitle: ''),
);
await tapVisible(tester, find.text('Create'));
await tester.pump();
expect(find.text('Default locale must have a title'), findsOneWidget);
expect(adapter.requests, isEmpty);
});
testWidgets('创建:endAt 早于 startAt → 时间序错误', (tester) async {
final adapter = FakeAdapter((_) => throw StateError('不应发起请求'));
await pumpForm(
tester,
clientOf(adapter),
initialDraft: createDraft(
endAt: DateTime.utc(2026, 9, 18, 5, 0),
),
);
await tapVisible(tester, find.text('Create'));
await tester.pump();
expect(find.text('End time must be after start time'), findsOneWidget);
expect(adapter.requests, isEmpty);
});
testWidgets('创建:合法提交 → POST 载荷形状(双语 translations/UTC 时间/开关)',
(tester) async {
final adapter = FakeAdapter(
(o) => o.path == '/v1/albums'
? (201, albumJson())
: throw StateError('unexpected ${o.path}'),
);
await pumpForm(
tester,
clientOf(adapter),
initialDraft: createDraft(
endAt: DateTime.utc(2026, 9, 19, 10, 0),
downloadEnabled: false,
originalDownloadEnabled: true,
),
);
await tapVisible(tester, find.text('Create'));
await tester.pumpAndSettle();
final request = adapter.requests.single;
expect(request.method, 'POST');
expect(request.path, '/v1/albums');
expect(request.body, <String, dynamic>{
'translations': <Map<String, dynamic>>[
<String, dynamic>{
'locale': 'zh-CN',
'title': '开幕晚宴',
'description': null,
'venue': null,
'address': null,
},
<String, dynamic>{
'locale': 'en',
'title': 'Opening Gala',
'description': null,
'venue': null,
'address': null,
},
],
'defaultLocale': 'zh-CN',
'startAt': '2026-09-18T06:30:00.000Z',
'endAt': '2026-09-19T10:00:00.000Z',
'timezone': 'Asia/Shanghai',
'downloadEnabled': false,
'originalDownloadEnabled': true,
});
});
testWidgets('编辑:预加载既有值(字段、四开关独立初值、无变更时保存禁用)',
(tester) async {
final adapter = FakeAdapter(
(o) => throw StateError('编辑预加载不应发起请求:${o.path}'),
);
final existing = Album.fromJson(
albumJson(
publicEnabled: false,
originalDownloadEnabled: true,
endAt: '2026-09-19T10:00:00Z',
),
);
await pumpForm(tester, clientOf(adapter), existing: existing);
// 编辑模式四开关。
expect(find.byType(SwitchListTile), findsNWidgets(4));
// 字段预填(当前 zh tab;title 为第一个文本字段)。
final titleField = tester.widget<TextFormField>(
find.byType(TextFormField).first,
);
expect(titleField.controller!.text, '开幕晚宴');
// 开关初值与原相册一致。
expect(
tester
.widget<SwitchListTile>(
find.widgetWithText(SwitchListTile, 'Allow uploads'),
)
.value,
true,
);
expect(
tester
.widget<SwitchListTile>(
find.widgetWithText(SwitchListTile, 'Publicly visible'),
)
.value,
false,
);
expect(
tester
.widget<SwitchListTile>(
find.widgetWithText(SwitchListTile, 'Allow original downloads'),
)
.value,
true,
);
// 时间回显按相册时区。
expect(find.text('2026/9/18 14:30'), findsOneWidget);
expect(find.text('2026/9/19 18:00'), findsOneWidget);
// 无任何变更 → 保存禁用(PATCH minProperties 1)。
expect(
tester.widget<FilledButton>(find.byType(FilledButton)).onPressed,
isNull,
);
});
testWidgets('编辑:仅拨动 originalDownloadEnabled → PATCH 单键载荷',
(tester) async {
final adapter = FakeAdapter(
(o) => o.path == '/v1/albums/alb-1'
? (200, albumJson(originalDownloadEnabled: true))
: throw StateError('unexpected ${o.path}'),
);
final existing = Album.fromJson(albumJson());
await pumpForm(tester, clientOf(adapter), existing: existing);
await tapVisible(
tester,
find.widgetWithText(SwitchListTile, 'Allow original downloads'),
);
await tester.pump();
await tapVisible(tester, find.text('Save'));
await tester.pumpAndSettle();
final request = adapter.requests.single;
expect(request.method, 'PATCH');
expect(request.path, '/v1/albums/alb-1');
expect(request.body, <String, dynamic>{
'originalDownloadEnabled': true,
});
});
testWidgets('编辑:清除 endAt → PATCH 序列化 "endAt": null', (tester) async {
final adapter = FakeAdapter(
(o) => o.path == '/v1/albums/alb-1'
? (200, albumJson(endAt: null))
: throw StateError('unexpected ${o.path}'),
);
final existing = Album.fromJson(
albumJson(endAt: '2026-09-19T10:00:00Z'),
);
await pumpForm(tester, clientOf(adapter), existing: existing);
await tapVisible(tester, find.byTooltip('Clear end time'));
await tester.pump();
await tapVisible(tester, find.text('Save'));
await tester.pumpAndSettle();
expect(adapter.requests.single.body, <String, dynamic>{'endAt': null});
});
testWidgets('编辑:修改 zh 标题 → 仅发全量 translations(不含开关/时间)',
(tester) async {
final adapter = FakeAdapter(
(o) => o.path == '/v1/albums/alb-1'
? (200, albumJson())
: throw StateError('unexpected ${o.path}'),
);
final existing = Album.fromJson(albumJson());
await pumpForm(tester, clientOf(adapter), existing: existing);
await tester.enterText(
find.byType(TextFormField).first,
'闭幕演出',
);
await tester.pump();
await tapVisible(tester, find.text('Save'));
await tester.pumpAndSettle();
final body = adapter.requests.single.body as Map<String, dynamic>;
expect(body.keys, <String>['translations']);
expect(body['translations'], <Map<String, dynamic>>[
<String, dynamic>{
'locale': 'zh-CN',
'title': '闭幕演出',
'description': null,
'venue': '大宴会厅',
'address': null,
},
<String, dynamic>{
'locale': 'en',
'title': 'Opening Gala',
'description': null,
'venue': null,
'address': null,
},
]);
});
}
@@ -0,0 +1,209 @@
/// 成员管理页 widget 测试(P3 计划 Task 4)。
///
/// 覆盖:列表角色标签/owner 徽标/本人与创建者不可移除;账号前缀搜索
/// 防抖(300ms、≥2 字符、连续输入合并);邀请载荷与 MEMBER_CONFLICT
/// 本地化;移除确认流。
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/features/albums/models.dart';
import 'package:photo_live/l10n/app_localizations.dart';
import 'package:photo_live/pages/album_members_page.dart';
import '../helpers/fakes.dart';
void main() {
late FakeSessionStore store;
late List<Map<String, dynamic>> members;
setUp(() {
store = FakeSessionStore()
..session = Session(
token: 'tok-live',
expiresAt: DateTime.utc(2099, 1, 1),
account: 'staff01',
);
members = <Map<String, dynamic>>[
memberJson(
userId: 'u-owner',
account: 'boss01',
displayName: 'The Owner',
role: 'owner',
),
memberJson(userId: 'u-1', account: 'staff01', displayName: 'Staff One'),
memberJson(userId: 'u-2', account: 'staff02', displayName: 'Staff Two'),
];
});
FakeAdapter membersAdapter({
(int, Object?)? Function(String method, String path)? onMutation,
}) =>
FakeAdapter((o) {
if (o.path == '/v1/albums/alb-1/members' && o.method == 'GET') {
return (200, cursorPageBody(members));
}
if (o.path == '/v1/albums/alb-1/members' && o.method == 'POST') {
final override = onMutation?.call('POST', o.path);
if (override != null) return override;
members = <Map<String, dynamic>>[
...members,
memberJson(userId: 'u-9', account: 'staff09'),
];
return (201, memberJson(userId: 'u-9', account: 'staff09'));
}
if (o.path == '/v1/albums/alb-1/members/u-2' && o.method == 'DELETE') {
final override = onMutation?.call('DELETE', o.path);
if (override != null) return override;
members = members
.where((m) => m['userId'] != 'u-2')
.toList();
return (204, null);
}
if (o.path == '/v1/admin/users' && o.method == 'GET') {
return (200, <String, dynamic>{
'items': <Map<String, dynamic>>[lookupUserJson()],
});
}
throw StateError('unexpected ${o.method} ${o.path}');
});
ApiClient clientOf(FakeAdapter adapter) => ApiClient(
sessionStore: store,
dio: Dio(BaseOptions(baseUrl: 'http://test.local'))
..httpClientAdapter = adapter,
);
Future<void> pumpMembers(WidgetTester tester, ApiClient client) async {
await tester.pumpWidget(
ProviderScope(
overrides: [
apiClientProvider.overrideWith((ref) => client),
// 本人识别走会话存储:覆写为内存假件(secure storage 插件缺失)。
sessionStoreProvider.overrideWith((ref) => store),
],
child: MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
home: AlbumMembersPage(
album: Album.fromJson(albumJson()),
),
),
),
);
await tester.pumpAndSettle();
}
testWidgets('列表渲染:角色标签、owner 徽标、本人/创建者无移除按钮',
(tester) async {
await pumpMembers(tester, clientOf(membersAdapter()));
expect(find.text('Owner'), findsOneWidget);
expect(find.text('Collaborator'), findsNWidgets(2));
expect(find.byIcon(Icons.star), findsOneWidget, reason: 'owner 徽标');
// 本人标记。
expect(find.text('staff01 (you)'), findsOneWidget);
// 仅 staff02(非 owner、非本人)有移除按钮。
expect(find.byIcon(Icons.person_remove_outlined), findsOneWidget);
});
testWidgets('搜索防抖:<2 字符不请求;连续输入合并为最后一次(300ms)',
(tester) async {
final adapter = membersAdapter();
await pumpMembers(tester, clientOf(adapter));
final field = find.byType(TextField);
// 1 个字符:无请求。
await tester.enterText(field, 's');
await tester.pump(const Duration(milliseconds: 400));
expect(
adapter.requests.where((r) => r.path == '/v1/admin/users'),
isEmpty,
);
// 连续输入两次,防抖合并为最后一次。
await tester.enterText(field, 'st');
await tester.pump(const Duration(milliseconds: 100));
await tester.enterText(field, 'sta');
await tester.pump(const Duration(milliseconds: 350));
final lookups = adapter.requests
.where((r) => r.path == '/v1/admin/users')
.toList();
expect(lookups, hasLength(1));
expect(lookups.single.uri.queryParameters['accountPrefix'], 'sta');
});
testWidgets('搜索命中 → 点击邀请 → POST userId 载荷 → 列表刷新 + 提示',
(tester) async {
final adapter = membersAdapter();
await pumpMembers(tester, clientOf(adapter));
await tester.enterText(find.byType(TextField), 'staff09');
await tester.pump(const Duration(milliseconds: 400));
// 搜索框 EditableText 与结果条目同名,按 ListTile 定位结果。
expect(find.widgetWithText(ListTile, 'staff09'), findsOneWidget);
await tester.tap(find.text('Invite'));
await tester.pumpAndSettle();
final invite = adapter.requests.singleWhere(
(r) => r.method == 'POST' && r.path == '/v1/albums/alb-1/members',
);
expect(invite.body, <String, dynamic>{'userId': 'u-9'});
expect(find.text('Invited'), findsOneWidget);
// 邀请成功后列表重载(staff09 入列)。
expect(find.text('Collaborator'), findsNWidgets(3));
});
testWidgets('邀请冲突(409 MEMBER_CONFLICT)→ 已是成员文案', (tester) async {
final adapter = membersAdapter(
onMutation: (method, path) =>
method == 'POST' ? (409, errorBody(ErrorCodes.memberConflict)) : null,
);
await pumpMembers(tester, clientOf(adapter));
await tester.enterText(find.byType(TextField), 'staff09');
await tester.pump(const Duration(milliseconds: 400));
await tester.tap(find.text('Invite'));
await tester.pumpAndSettle();
expect(find.text('User is already a member'), findsOneWidget);
});
testWidgets('移除成员:确认对话框门控 → DELETE → 列表刷新', (tester) async {
final adapter = membersAdapter();
await pumpMembers(tester, clientOf(adapter));
await tester.tap(find.byIcon(Icons.person_remove_outlined));
await tester.pumpAndSettle();
expect(find.text('Remove this member?'), findsOneWidget);
// 取消不发请求。
await tester.tap(find.text('Cancel'));
await tester.pumpAndSettle();
expect(
adapter.requests.any((r) => r.method == 'DELETE'),
isFalse,
);
await tester.tap(find.byIcon(Icons.person_remove_outlined));
await tester.pumpAndSettle();
await tester.tap(find.widgetWithText(FilledButton, 'Delete'));
await tester.pumpAndSettle();
expect(
adapter.requests.any(
(r) => r.method == 'DELETE' && r.path == '/v1/albums/alb-1/members/u-2',
),
isTrue,
);
expect(find.text('staff02'), findsNothing);
});
}
@@ -0,0 +1,94 @@
/// 照片管理占位页 widget 测试(P3 计划 Task 4)。
///
/// 覆盖:Task 9 占位横幅、基础列表(可见性/处理状态标签、时区时间)、
/// 游标加载更多。完整交互由 Task 9 替换。
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/features/albums/models.dart';
import 'package:photo_live/l10n/app_localizations.dart';
import 'package:photo_live/pages/album_photos_page.dart';
import '../helpers/fakes.dart';
void main() {
late FakeSessionStore store;
setUp(() {
store = FakeSessionStore();
});
ApiClient clientOf(FakeAdapter adapter) => ApiClient(
sessionStore: store,
dio: Dio(BaseOptions(baseUrl: 'http://test.local'))
..httpClientAdapter = adapter,
);
Future<void> pumpPhotos(WidgetTester tester, ApiClient client) async {
await tester.pumpWidget(
ProviderScope(
overrides: [apiClientProvider.overrideWith((ref) => client)],
child: MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
home: AlbumPhotosPage(album: Album.fromJson(albumJson())),
),
),
);
await tester.pumpAndSettle();
}
testWidgets('占位横幅 + 列表标签 + 游标加载第二页', (tester) async {
final page1 = List<Map<String, dynamic>>.generate(
20,
(i) => adminPhotoJson(
photoId: 'ph-${(i + 1).toString().padLeft(8, '0')}',
visibility: i % 2 == 0 ? 'published' : 'unpublished',
processingState: i % 2 == 0 ? 'ready' : 'processing',
),
);
final page2 = <Map<String, dynamic>>[
// 区分度高的 ID:第二页条目渲染后可按标题前缀断言。
adminPhotoJson(photoId: 'page2item'),
];
final adapter = FakeAdapter((o) {
if (o.path != '/v1/albums/alb-1/photos') {
throw StateError('unexpected ${o.method} ${o.path}');
}
final cursor = o.uri.queryParameters['cursor'];
if (cursor == null) {
return (200, cursorPageBody(page1, nextCursor: 'pc1'));
}
if (cursor == 'pc1') return (200, cursorPageBody(page2));
throw StateError('unexpected cursor $cursor');
});
await pumpPhotos(tester, clientOf(adapter));
// Task 9 占位横幅。
expect(
find.textContaining('the full experience ships in Task 9'),
findsOneWidget,
);
// 标签与条目(ListView 懒构建,只断言在渲染的可见条目)。
expect(find.text('Published'), findsWidgets);
expect(find.text('Unpublished'), findsWidgets);
expect(find.text('Ready'), findsWidgets);
expect(find.text('Processing'), findsWidgets);
expect(find.text('2026/9/18 15:00'), findsWidgets, reason: '相册时区展示');
// 滚动加载第二页。
await tester.drag(find.byType(ListView), const Offset(0, -4000));
await tester.pumpAndSettle();
expect(
adapter.requests.last.uri.queryParameters['cursor'],
'pc1',
);
// 第二页条目渲染(标题展示 photoId 前 8 位)。
expect(find.textContaining('page2ite'), findsOneWidget);
});
}
+157
View File
@@ -0,0 +1,157 @@
/// 相册列表页签 widget 测试(P3 计划 Task 4)。
///
/// 覆盖:首屏加载与卡片标签行(状态/开关/时区时间/令牌短显)、游标
/// 加载更多(第二页携带 cursor)、空态文案、首屏错误 + 重试恢复。
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/features/albums/providers.dart';
import 'package:photo_live/l10n/app_localizations.dart';
import 'package:photo_live/pages/albums_tab.dart';
import '../helpers/fakes.dart';
void main() {
late FakeSessionStore store;
setUp(() {
store = FakeSessionStore();
});
ApiClient clientOf(FakeAdapter adapter) => ApiClient(
sessionStore: store,
dio: Dio(BaseOptions(baseUrl: 'http://test.local'))
..httpClientAdapter = adapter,
);
Future<void> pumpTab(WidgetTester tester, ApiClient client) async {
await tester.pumpWidget(
ProviderScope(
overrides: [apiClientProvider.overrideWith((ref) => client)],
child: MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
home: const AlbumsTab(),
),
),
);
await tester.pumpAndSettle();
}
testWidgets('首屏加载 → 卡片渲染标题/状态/开关标签/时区时间/令牌短显',
(tester) async {
final adapter = FakeAdapter(
(o) => o.path == '/v1/albums'
? (200, cursorPageBody([albumJson(
status: 'offline',
uploadEnabled: true,
publicEnabled: false,
downloadEnabled: true,
originalDownloadEnabled: false,
)]))
: throw StateError('unexpected ${o.path}'),
);
await pumpTab(tester, clientOf(adapter));
expect(find.text('开幕晚宴'), findsOneWidget);
expect(find.text('Offline'), findsOneWidget);
// 四个开关标签(色调区分开关,文案一致)。
expect(find.text('Upload'), findsOneWidget);
expect(find.text('Public'), findsOneWidget);
expect(find.text('Download'), findsOneWidget);
expect(find.text('Original'), findsOneWidget);
// Asia/Shanghai 墙钟 14:30;结束未定。
expect(find.text('2026/9/18 14:30 ~ Not set'), findsOneWidget);
// 令牌短显(前 10 字符 + 省略号)。
expect(find.text('sharetoken…'), findsOneWidget);
expect(find.byIcon(Icons.add), findsOneWidget, reason: 'FAB 新建入口');
});
testWidgets('滚动接近底部 → 游标加载第二页(携带 cursor)', (tester) async {
final page1 = List<Map<String, dynamic>>.generate(
20,
(i) => albumJson(id: 'alb-${i + 1}'),
);
final page2 = List<Map<String, dynamic>>.generate(
10,
(i) => albumJson(id: 'alb-${i + 21}'),
);
final adapter = FakeAdapter(
(o) {
if (o.path != '/v1/albums') throw StateError('unexpected ${o.path}');
final cursor = o.uri.queryParameters['cursor'];
if (cursor == null) return (200, cursorPageBody(page1, nextCursor: 'c1'));
if (cursor == 'c1') return (200, cursorPageBody(page2));
throw StateError('unexpected cursor $cursor');
},
);
await pumpTab(tester, clientOf(adapter));
// 首屏只拉第一页(20 条入 state;ListView 懒构建,不逐条断言渲染)。
expect(adapter.requests, hasLength(1));
final container = ProviderScope.containerOf(
tester.element(find.byType(AlbumsTab)),
);
expect(container.read(albumListProvider).items, hasLength(20));
// 上滑触发加载更多。
await tester.drag(find.byType(ListView), const Offset(0, -2400));
await tester.pumpAndSettle();
expect(adapter.requests, hasLength(2));
expect(
adapter.requests.last.uri.queryParameters['cursor'],
'c1',
reason: '第二页携带游标 c1',
);
expect(
container.read(albumListProvider).items,
hasLength(30),
reason: '两页累积',
);
});
testWidgets('空列表 → 空态文案', (tester) async {
final adapter = FakeAdapter(
(o) => o.path == '/v1/albums'
? (200, cursorPageBody(<Map<String, dynamic>>[]))
: throw StateError('unexpected ${o.path}'),
);
await pumpTab(tester, clientOf(adapter));
expect(
find.text('No albums yet. Tap "Create album" to get started'),
findsOneWidget,
);
});
testWidgets('首屏错误 → 错误视图,重试后恢复', (tester) async {
var failFirst = true;
final adapter = FakeAdapter(
(o) {
if (o.path != '/v1/albums') throw StateError('unexpected ${o.path}');
if (failFirst) {
failFirst = false;
return (500, errorBody(ErrorCodes.internalError));
}
return (200, cursorPageBody([albumJson()]));
},
);
await pumpTab(tester, clientOf(adapter));
expect(
find.text('Service temporarily unavailable. Please retry later'),
findsOneWidget,
);
await tester.tap(find.text('Retry'));
await tester.pumpAndSettle();
expect(find.text('开幕晚宴'), findsOneWidget);
});
}
+10 -7
View File
@@ -69,18 +69,21 @@ void main() {
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}'),
);
// 首页「相册」页签(Task 4)进入即自动拉列表,需一并兜底路由。
final adapter = FakeAdapter((o) {
if (o.path == '/v1/auth/logout') return (500, errorBody('INTERNAL_ERROR'));
if (o.path == '/v1/albums') return (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');
final logout = adapter.requests.singleWhere(
(r) => r.path == '/v1/auth/logout',
);
expect(logout.method, 'POST');
expect(store.session, isNull, reason: '本地会话必须清除');
expect(find.byType(LoginPage), findsOneWidget);
expect(find.byType(HomePage), findsNothing, reason: '主壳已出栈');
@@ -0,0 +1,72 @@
/// 分享二维码对话框 widget 测试(P3 计划 Task 4)。
///
/// 覆盖:QrImageView 以 viewer URL({VIEWER_BASE}/a/{token})渲染、
/// URL 文本可见、复制按钮写入剪贴板并提示。
library;
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:photo_live/core/config.dart';
import 'package:photo_live/l10n/app_localizations.dart';
import 'package:photo_live/pages/share_qr_dialog.dart';
import 'package:qr_flutter/qr_flutter.dart';
void main() {
const token = 'sharetoken000000000001';
Future<void> pumpDialog(WidgetTester tester) async {
await tester.pumpWidget(
MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
// 复制提示走 ScaffoldMessenger:包一层 Scaffold 供 SnackBar 挂载。
home: const Scaffold(
body: Center(child: ShareQrDialog(publicToken: token)),
),
),
);
await tester.pumpAndSettle();
}
testWidgets('渲染 QrImageView,data 为观众链接;URL 文本可见', (tester) async {
await pumpDialog(tester);
final url = ApiConfig.viewerAlbumUrl(token);
// qr_flutter 4.1 未公开 QrImageView.data(私有 _data),以同源的
// SelectableText 文本断言 URL 构造(二维码与文本同用该局部变量)。
expect(find.byType(QrImageView), findsOneWidget);
expect(
tester.widget<SelectableText>(find.byType(SelectableText)).data,
url,
);
expect(url, 'http://10.0.2.2:5175/a/$token');
expect(find.text('Scan the code or open the link to view'), findsOneWidget);
});
testWidgets('复制按钮 → 剪贴板收到 URL + 已复制提示', (tester) async {
final clipboardCalls = <MethodCall>[];
tester.binding.defaultBinaryMessenger.setMockMethodCallHandler(
SystemChannels.platform,
(call) async {
clipboardCalls.add(call);
return null;
},
);
await pumpDialog(tester);
await tester.tap(find.text('Copy link'));
await tester.pumpAndSettle();
final url = ApiConfig.viewerAlbumUrl(token);
expect(
clipboardCalls.any(
(c) =>
c.method == 'Clipboard.setData' &&
(c.arguments as Map<String, dynamic>)['text'] == url,
),
isTrue,
);
expect(find.text('Copied'), findsOneWidget);
});
}