xinyouhe/photo-live
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(mobile): UI-03 photos and share pages (17-20)

Browse Source 
Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-09-22 02:45:34 +08:00
parent ab51616c70
commit 8ee69598bf
14 changed files with 1338 additions and 379 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/mobile/test/pages/album_photo_viewer_test.dart
+279 -39
View File
@@ -1,13 +1,16 @@
/// 照片大图查看器 widget 测试（UI-01 §4.3）。
/// 照片大图查看器 widget 测试（UI-01 §4.3；UI-03 §4 页面 18/20 回归）。
///
/// 覆盖：信息栏（上传者/相册时区时间/尺寸大小 + ID 诊断区）、左右切换、
/// 覆盖：摄影深色背景 + contain 展示、信息栏（上传者/相册时区时间·尺寸·
/// 大小/状态/ID 诊断区）、左右滑动与方向键切换、临近末尾加载更多、
/// 权限（管理者隐藏/恢复/删除；协作者自己上传可隐藏删除、不可恢复）、
/// 删除确认（云端照片将被删除）、关闭返回网格原位置、签名 URL 失败一次
/// 受控刷新、临近末尾加载更多。
/// 隐藏经确认 BottomSheet（标题/缩略图/影响说明/取消不请求/photoId 打开
/// 时捕获/成功回网格角标翻转）、删除确认（软删除文案，与隐藏确认分开）、
/// 「⋯」更多菜单、关闭返回网格原位置、签名 URL 失败一次受控刷新。
library;
import 'package:dio/dio.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:photo_live/core/api_client.dart';
@@ -18,6 +21,8 @@ import 'package:photo_live/l10n/app_localizations.dart';
import 'package:photo_live/pages/album_photos_page.dart';
import 'package:photo_live/pages/album_photo_viewer_page.dart';
import 'package:photo_live/ui/components/photo_thumbnail.dart';
import 'package:photo_live/ui/components/state_badge.dart';
import 'package:photo_live/ui/tokens.dart';
import '../helpers/fakes.dart';
@@ -64,7 +69,15 @@ void main() {
return before;
}
testWidgets('信息栏：上传者 / 相册时区时间 / 尺寸大小 + ID 诊断区', (tester) async {
/// 查看器子树内的查找（网格页在路由栈下方仍挂载，需按页面收窄）。
Finder inViewer(Finder finder) => find.descendant(
of: find.byType(AlbumPhotoViewerPage),
matching: finder,
);
testWidgets('深色摄影背景 + contain + 信息栏（上传者/时间·尺寸·大小/状态/ID）', (
tester,
) async {
final adapter = FakeAdapter((o) {
if (o.path != '/v1/albums/alb-1/photos') {
throw StateError('unexpected ${o.method} ${o.path}');
@@ -79,10 +92,24 @@ void main() {
await pumpGridAndOpen(tester, clientOf(adapter));
expect(find.byType(AlbumPhotoViewerPage), findsOneWidget);
expect(find.text('Staff Two'), findsOneWidget);
// uploadedAt 07:00Z → 相册时区上海 15:00；尺寸 + 大小。
// 恒深色摄影背景（不随系统主题）。
expect(
tester.widget<Scaffold>(inViewer(find.byType(Scaffold))).backgroundColor,
kColorPhotoBackdrop,
);
// contain 完整展示（不裁切）。
expect(
tester.widget<Image>(inViewer(find.byType(Image))).fit,
BoxFit.contain,
);
// 顶栏：关闭 × + 更多 ⋯。
expect(inViewer(find.byIcon(Icons.close)), findsOneWidget);
expect(inViewer(find.byIcon(Icons.more_vert)), findsOneWidget);
// 信息栏：上传者 / 相册时区墙钟·尺寸·大小 / 真实状态 / ID 诊断区。
expect(find.text('Uploaded by Staff Two'), findsOneWidget);
// uploadedAt 07:00Z → 相册时区上海 15:00；4000×3000 · 121 KB。
expect(find.text('2026/9/18 15:00 · 4000×3000 · 121 KB'), findsOneWidget);
// ID 放诊断区域（弱化呈现）。
expect(find.text('Status: Published'), findsOneWidget);
expect(find.text('ph-info-1'), findsOneWidget);
});
@@ -116,11 +143,11 @@ void main() {
await pumpGridAndOpen(tester, clientOf(adapter));
// 初始第一张。
expect(find.text('Uploader 1'), findsOneWidget);
expect(find.text('Uploaded by Uploader 1'), findsOneWidget);
// 左右切换：到第二张。
await tester.drag(find.byType(PageView), const Offset(-700, 0));
await tester.pumpAndSettle();
expect(find.text('Uploader 2'), findsOneWidget);
expect(find.text('Uploaded by Uploader 2'), findsOneWidget);
// 连续滑到接近已加载末尾（page >= length-3 触发加载更多）。
for (var i = 0; i < 20; i++) {
@@ -134,7 +161,46 @@ void main() {
);
});
testWidgets('管理者：已发布照片可隐藏/删除；隐藏照片可恢复', (tester) async {
testWidgets('方向键左右切换（键盘可达性，与滑动同序列）', (tester) async {
final adapter = FakeAdapter((o) {
if (o.path != '/v1/albums/alb-1/photos') {
throw StateError('unexpected ${o.method} ${o.path}');
}
return (
200,
cursorPageBody(<Map<String, dynamic>>[
adminPhotoJson(
photoId: 'ph-k1',
uploaderName: 'Uploader 1',
preview: photoPreviewJson(),
),
adminPhotoJson(
photoId: 'ph-k2',
uploaderName: 'Uploader 2',
preview: photoPreviewJson(),
),
]),
);
});
await pumpGridAndOpen(tester, clientOf(adapter));
expect(find.text('Uploaded by Uploader 1'), findsOneWidget);
// → 右键下一张。
await tester.sendKeyEvent(LogicalKeyboardKey.arrowRight);
await tester.pumpAndSettle();
expect(find.text('Uploaded by Uploader 2'), findsOneWidget);
// ← 左键回上一张；再左（已在首张）忽略不越界。
await tester.sendKeyEvent(LogicalKeyboardKey.arrowLeft);
await tester.pumpAndSettle();
expect(find.text('Uploaded by Uploader 1'), findsOneWidget);
await tester.sendKeyEvent(LogicalKeyboardKey.arrowLeft);
await tester.pumpAndSettle();
expect(find.text('Uploaded by Uploader 1'), findsOneWidget);
});
testWidgets('管理者操作行：已发布→Hide photo+Delete；已隐藏→Publish again', (
tester,
) async {
final adapter = FakeAdapter((o) {
if (o.path == '/v1/albums/alb-1/photos') {
return (
@@ -149,42 +215,163 @@ void main() {
]),
);
}
if (o.method == 'PATCH' && o.path == '/v1/photos/ph-pub') {
throw StateError('unexpected ${o.method} ${o.path}');
});
await pumpGridAndOpen(tester, clientOf(adapter));
// 已发布：Hide photo + Delete（管理者，scope=all 成功）。
expect(find.text('Hide photo'), findsOneWidget);
expect(find.text('Delete'), findsOneWidget);
expect(find.text('Publish again'), findsNothing);
// 切到第二张（隐藏照片）：Publish again（仅管理者）+ Delete。
await tester.drag(find.byType(PageView), const Offset(-700, 0));
await tester.pumpAndSettle();
expect(find.text('Publish again'), findsOneWidget);
expect(find.text('Hide photo'), findsNothing);
expect(find.text('Delete'), findsOneWidget);
});
testWidgets('Publish again：PATCH published → 操作行翻转为 Hide photo', (
tester,
) async {
final adapter = FakeAdapter((o) {
if (o.path == '/v1/albums/alb-1/photos') {
return (
200,
adminPhotoJson(photoId: 'ph-pub', visibility: 'hidden'),
cursorPageBody(<Map<String, dynamic>>[
adminPhotoJson(
photoId: 'ph-hid',
visibility: 'hidden',
preview: photoPreviewJson(),
),
]),
);
}
if (o.method == 'PATCH' && o.path == '/v1/photos/ph-hid') {
return (200, adminPhotoJson(photoId: 'ph-hid'));
}
throw StateError('unexpected ${o.method} ${o.path}');
});
final client = clientOf(adapter);
await pumpGridAndOpen(tester, client);
await pumpGridAndOpen(tester, clientOf(adapter));
// 已发布：隐藏 + 删除（管理者，scope=all 成功）。
expect(find.text('Hide'), findsOneWidget);
expect(find.text('Delete'), findsOneWidget);
expect(find.text('Unhide'), findsNothing);
await tester.tap(find.text('Publish again'));
await tester.pumpAndSettle();
// 切到第二张（隐藏照片）：恢复显示（仅管理者）+ 删除。
await tester.drag(find.byType(PageView), const Offset(-700, 0));
await tester.pumpAndSettle();
expect(find.text('Unhide'), findsOneWidget);
expect(find.text('Hide'), findsNothing);
// 隐藏操作：PATCH visibility=hidden → 按钮翻转为恢复显示。
await tester.drag(find.byType(PageView), const Offset(700, 0));
await tester.pumpAndSettle();
await tester.tap(find.text('Hide'));
await tester.pumpAndSettle();
final patch = adapter.requests.singleWhere(
(r) => r.method == 'PATCH' && r.path == '/v1/photos/ph-pub',
(r) => r.method == 'PATCH' && r.path == '/v1/photos/ph-hid',
);
expect(patch.body, <String, dynamic>{'visibility': 'hidden'});
expect(find.text('Unhide'), findsOneWidget, reason: '隐藏后可恢复');
expect(find.text('Hide'), findsNothing, reason: '已隐藏态不再显示隐藏入口');
expect(patch.body, <String, dynamic>{'visibility': 'published'});
expect(find.text('Hide photo'), findsOneWidget, reason: '恢复后可再隐藏');
expect(find.text('Publish again'), findsNothing);
expect(find.text('Status: Published'), findsOneWidget);
});
testWidgets('协作者（scope=own）：自己上传可隐藏/删除，不可恢复', (tester) async {
testWidgets('隐藏确认 BottomSheet：标题/缩略图/影响说明；取消不请求', (tester) async {
final adapter = FakeAdapter((o) {
if (o.path != '/v1/albums/alb-1/photos') {
throw StateError('unexpected ${o.method} ${o.path}');
}
return (
200,
cursorPageBody(<Map<String, dynamic>>[
adminPhotoJson(photoId: 'ph-sheet', preview: photoPreviewJson()),
]),
);
});
await pumpGridAndOpen(tester, clientOf(adapter));
// 操作行 Hide photo（OutlinedButton）打开确认面板。
await tester.tap(find.widgetWithText(OutlinedButton, 'Hide photo'));
await tester.pumpAndSettle();
final sheet = find.descendant(
of: find.byType(BottomSheet),
matching: find.byType(PhotoThumbnail),
);
expect(find.text('Hide this photo?'), findsOneWidget);
expect(
find.text(
'Viewers will no longer see this photo. '
'Authorized album managers can publish it again.',
),
findsOneWidget,
);
expect(sheet, findsOneWidget, reason: '有可见预览 → 面板内展示当前图缩略图');
// 主操作 FilledButton + 取消。
expect(find.widgetWithText(FilledButton, 'Hide photo'), findsOneWidget);
// 取消：不发 PATCH，查看器保持。
await tester.tap(find.text('Cancel'));
await tester.pumpAndSettle();
expect(
adapter.requests.any((r) => r.method == 'PATCH'),
isFalse,
reason: '取消不请求接口',
);
expect(find.byType(AlbumPhotoViewerPage), findsOneWidget);
});
testWidgets('确认隐藏：photoId 打开时捕获 → PATCH 正确对象 → 回网格角标翻转', (
tester,
) async {
final adapter = FakeAdapter((o) {
if (o.path == '/v1/albums/alb-1/photos') {
return (
200,
cursorPageBody(<Map<String, dynamic>>[
adminPhotoJson(
photoId: 'ph-h1',
uploaderName: 'Uploader 1',
preview: photoPreviewJson(),
),
adminPhotoJson(
photoId: 'ph-h2',
uploaderName: 'Uploader 2',
preview: photoPreviewJson(),
),
]),
);
}
if (o.method == 'PATCH' && o.path == '/v1/photos/ph-h2') {
return (200, adminPhotoJson(photoId: 'ph-h2', visibility: 'hidden'));
}
throw StateError('unexpected ${o.method} ${o.path}');
});
// 打开第二张（tile 1 = ph-h2）。
await pumpGridAndOpen(tester, clientOf(adapter), tile: 1);
expect(find.text('Uploaded by Uploader 2'), findsOneWidget);
// 操作行 Hide photo → 面板内 FilledButton Hide photo 确认。
await tester.tap(find.widgetWithText(OutlinedButton, 'Hide photo'));
await tester.pumpAndSettle();
await tester.tap(find.widgetWithText(FilledButton, 'Hide photo'));
await tester.pumpAndSettle();
// 请求作用于打开面板时捕获的照片（ph-h2），不受其他条目影响。
final patch = adapter.requests.singleWhere((r) => r.method == 'PATCH');
expect(patch.path, '/v1/photos/ph-h2');
expect(patch.body, <String, dynamic>{'visibility': 'hidden'});
// 成功：关闭面板 + 关闭查看器回网格；条目状态合并，角标翻转 Hidden。
expect(find.byType(AlbumPhotoViewerPage), findsNothing);
// SnackBar「Hidden」成功提示（chip 同名标签在外，按容器收窄）。
expect(
find.descendant(of: find.byType(SnackBar), matching: find.text('Hidden')),
findsOneWidget,
);
expect(
find.descendant(
of: find.byKey(const ValueKey('grid-photo-ph-h2')),
matching: find.byType(StateBadge),
),
findsOneWidget,
reason: '网格瓦片角标翻转为 Hidden',
);
});
testWidgets('协作者（scope=own）：自己上传可删除，无恢复入口；无预览占位', (
tester,
) async {
store.session = Session(
token: 'tok-1',
expiresAt: DateTime.utc(2099, 1, 1),
@@ -214,14 +401,16 @@ void main() {
await pumpGridAndOpen(tester, clientOf(adapter));
// 自己上传的隐藏照片：恢复发布仅创建者/管理员 → 不显示恢复入口。
expect(find.text('Unhide'), findsNothing);
expect(find.text('Publish again'), findsNothing);
expect(find.text('Delete'), findsOneWidget, reason: '自己上传可删除');
// 无预览（隐藏对协作者不签发）→ 状态说明 + 图片暂不可用。
expect(find.text('Image unavailable'), findsOneWidget);
expect(find.text('ph-own-hidden'), findsOneWidget);
});
testWidgets('删除：确认「云端照片」→ DELETE → 条目移除', (tester) async {
testWidgets('删除确认：软删除文案 + 取消不删 + 确认 DELETE 移除条目', (
tester,
) async {
final adapter = FakeAdapter((o) {
if (o.path == '/v1/albums/alb-1/photos') {
return (
@@ -240,10 +429,13 @@ void main() {
await tester.tap(find.text('Delete'));
await tester.pumpAndSettle();
// 确认弹窗：明确影响云端照片。
// 确认弹窗：与隐藏确认分开，说明当前实际软删除语义。
expect(find.text('Delete this photo?'), findsOneWidget);
expect(
find.text('The cloud photo will be deleted. This cannot be undone.'),
find.text(
'This will soft-delete the photo. It can be managed by admins. '
'Cloud storage is not immediately purged.',
),
findsOneWidget,
);
// 取消不删。
@@ -271,6 +463,54 @@ void main() {
expect(find.text('No photos yet'), findsOneWidget);
});
testWidgets('「⋯」更多菜单：按权限出菜单项，删除项可走确认弹窗', (tester) async {
final adapter = FakeAdapter((o) {
if (o.path != '/v1/albums/alb-1/photos') {
throw StateError('unexpected ${o.method} ${o.path}');
}
return (
200,
cursorPageBody(<Map<String, dynamic>>[
adminPhotoJson(photoId: 'ph-menu', preview: photoPreviewJson()),
]),
);
});
await pumpGridAndOpen(tester, clientOf(adapter));
await tester.tap(find.byIcon(Icons.more_vert));
await tester.pumpAndSettle();
// 菜单项与操作行同一套权限裁决（已发布管理者：Hide photo + Delete）。
final sheetDelete = find.descendant(
of: find.byType(BottomSheet),
matching: find.text('Delete'),
);
expect(
find.descendant(
of: find.byType(BottomSheet),
matching: find.text('Hide photo'),
),
findsOneWidget,
);
expect(sheetDelete, findsOneWidget);
expect(
find.descendant(
of: find.byType(BottomSheet),
matching: find.text('Publish again'),
),
findsNothing,
);
// 菜单删除 → 独立删除确认弹窗；取消不删。
await tester.tap(sheetDelete);
await tester.pumpAndSettle();
expect(find.text('Delete this photo?'), findsOneWidget);
await tester.tap(find.text('Cancel'));
await tester.pumpAndSettle();
expect(adapter.requests.any((r) => r.method == 'DELETE'), isFalse);
expect(find.byType(AlbumPhotoViewerPage), findsOneWidget);
});
testWidgets('关闭返回网格原滚动位置', (tester) async {
// 默认测试画布 800 宽 → 5 列；24 条 ≈ 5 行，超出视口可滚动。
final items = List<Map<String, dynamic>>.generate(