浅念
241 lines
8.4 KiB
Dart
241 lines
8.4 KiB
Dart
/// 相册表单纯逻辑测试（P3 计划 Task 4）。
|
||
///
|
||
/// 覆盖校验矩阵（默认语言覆盖/其他字段漏填标题/时间序/时区）与载荷
|
||
/// 构建：创建体形状、PATCH 最小化（无变更→null、单开关独立、endAt
|
||
/// 显式清除序列化为 null、translations 全量替换且不带其他键）。
|
||
library;
|
||
|
||
import 'package:flutter_test/flutter_test.dart';
|
||
import 'package:photo_live/features/albums/album_form.dart';
|
||
import 'package:photo_live/features/albums/models.dart';
|
||
|
||
import '../helpers/fakes.dart';
|
||
|
||
/// 与 albumJson 缺省值对齐的草稿（「原样」编辑基线）。
|
||
AlbumFormDraft draftOf({
|
||
String zhTitle = '开幕晚宴',
|
||
String zhVenue = '大宴会厅',
|
||
String enTitle = 'Opening Gala',
|
||
String defaultLocale = 'zh-CN',
|
||
String timezone = 'Asia/Shanghai',
|
||
DateTime? startAt,
|
||
DateTime? endAt,
|
||
bool uploadEnabled = true,
|
||
bool publicEnabled = true,
|
||
bool downloadEnabled = true,
|
||
bool originalDownloadEnabled = false,
|
||
}) =>
|
||
AlbumFormDraft(
|
||
zh: AlbumTranslationDraft(
|
||
locale: 'zh-CN',
|
||
title: zhTitle,
|
||
venue: zhVenue,
|
||
),
|
||
en: AlbumTranslationDraft(locale: 'en', title: enTitle),
|
||
defaultLocale: defaultLocale,
|
||
timezone: timezone,
|
||
startAt: startAt ?? DateTime.utc(2026, 9, 18, 6, 30),
|
||
endAt: endAt,
|
||
uploadEnabled: uploadEnabled,
|
||
publicEnabled: publicEnabled,
|
||
downloadEnabled: downloadEnabled,
|
||
originalDownloadEnabled: originalDownloadEnabled,
|
||
);
|
||
|
||
void main() {
|
||
group('validate（客户端预检矩阵）', () {
|
||
test('默认语言标题为空 → defaultLocaleMissing；未选开始 → startAtRequired', () {
|
||
// 直接构造（不经 draftOf：其 startAt 缺省会吞掉显式 null）。
|
||
final errors = AlbumFormDraft(
|
||
zh: const AlbumTranslationDraft(
|
||
locale: 'zh-CN',
|
||
title: ' ',
|
||
venue: '大宴会厅',
|
||
),
|
||
en: const AlbumTranslationDraft(locale: 'en', title: 'Opening Gala'),
|
||
defaultLocale: 'zh-CN',
|
||
timezone: 'Asia/Shanghai',
|
||
startAt: null,
|
||
).validate();
|
||
expect(errors, containsAll(<AlbumFormError>[
|
||
AlbumFormError.defaultLocaleMissing,
|
||
AlbumFormError.startAtRequired,
|
||
]));
|
||
});
|
||
|
||
test('非默认语言填了其他字段但没填标题 → titleRequiredWithFields', () {
|
||
final errors = draftOf(enTitle: '')
|
||
.validate()
|
||
.where((e) => e == AlbumFormError.titleRequiredWithFields)
|
||
.toList();
|
||
// en 无标题且无其他字段 → 条目整体跳过，不算错误。
|
||
expect(errors, isEmpty);
|
||
|
||
final errors2 = AlbumFormDraft(
|
||
zh: const AlbumTranslationDraft(locale: 'zh-CN', title: '标题'),
|
||
en: const AlbumTranslationDraft(locale: 'en', venue: 'Main Hall'),
|
||
defaultLocale: 'zh-CN',
|
||
timezone: 'Asia/Shanghai',
|
||
startAt: DateTime.utc(2026, 9, 18, 6, 30),
|
||
).validate();
|
||
expect(errors2, contains(AlbumFormError.titleRequiredWithFields));
|
||
expect(errors2, isNot(contains(AlbumFormError.defaultLocaleMissing)));
|
||
});
|
||
|
||
test('endAt 必须严格晚于 startAt（相等/早于报错，null 放行）', () {
|
||
final startAt = DateTime.utc(2026, 9, 18, 6, 30);
|
||
expect(
|
||
draftOf(startAt: startAt, endAt: startAt).validate(),
|
||
contains(AlbumFormError.endAtNotAfterStartAt),
|
||
);
|
||
expect(
|
||
draftOf(
|
||
startAt: startAt,
|
||
endAt: startAt.subtract(const Duration(minutes: 1)),
|
||
).validate(),
|
||
contains(AlbumFormError.endAtNotAfterStartAt),
|
||
);
|
||
expect(
|
||
draftOf(startAt: startAt, endAt: null).validate(),
|
||
isNot(contains(AlbumFormError.endAtNotAfterStartAt)),
|
||
);
|
||
});
|
||
|
||
test('时区校验：空白/非法 IANA 名报错，Asia/Shanghai 通过', () {
|
||
expect(
|
||
draftOf(timezone: '').validate(),
|
||
contains(AlbumFormError.timezoneInvalid),
|
||
);
|
||
expect(
|
||
draftOf(timezone: 'Mars/Olympus').validate(),
|
||
contains(AlbumFormError.timezoneInvalid),
|
||
);
|
||
expect(
|
||
draftOf(timezone: 'Asia/Shanghai').validate(),
|
||
isNot(contains(AlbumFormError.timezoneInvalid)),
|
||
);
|
||
});
|
||
});
|
||
|
||
group('toCreateRequest', () {
|
||
test('载荷形状：trim、空字段归一 null、不含 upload/public', () {
|
||
final req = draftOf(
|
||
zhTitle: ' 开幕晚宴 ',
|
||
zhVenue: ' ',
|
||
enTitle: 'Opening Gala',
|
||
downloadEnabled: false,
|
||
originalDownloadEnabled: true,
|
||
).toCreateRequest();
|
||
final json = req.toJson();
|
||
expect(json['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,
|
||
},
|
||
]);
|
||
expect(json['defaultLocale'], 'zh-CN');
|
||
expect(json['startAt'], '2026-09-18T06:30:00.000Z');
|
||
expect(json['endAt'], isNull);
|
||
expect(json['timezone'], 'Asia/Shanghai');
|
||
expect(json['downloadEnabled'], false);
|
||
expect(json['originalDownloadEnabled'], true);
|
||
// 契约：创建请求体不含 uploadEnabled/publicEnabled（服务端缺省 true）。
|
||
expect(json.containsKey('uploadEnabled'), isFalse);
|
||
expect(json.containsKey('publicEnabled'), isFalse);
|
||
});
|
||
});
|
||
|
||
group('toUpdatePatch（PATCH 最小化）', () {
|
||
test('与原值完全一致 → null（不提交）', () {
|
||
final original = Album.fromJson(albumJson());
|
||
expect(draftOf().toUpdatePatch(original), isNull);
|
||
});
|
||
|
||
test('仅拨动 originalDownloadEnabled → 单键载荷（开关独立性）', () {
|
||
final original = Album.fromJson(albumJson());
|
||
final patch =
|
||
draftOf(originalDownloadEnabled: true).toUpdatePatch(original);
|
||
expect(patch, isNotNull);
|
||
expect(patch!.toJson(), <String, dynamic>{
|
||
'originalDownloadEnabled': true,
|
||
});
|
||
});
|
||
|
||
test('endAt 显式清除 → 序列化为 "endAt": null', () {
|
||
final original = Album.fromJson(
|
||
albumJson(endAt: '2026-09-19T10:00:00Z'),
|
||
);
|
||
// 用户清除 endAt 后：startAt/endAt 为原开始时间与 null。
|
||
final patch = AlbumFormDraft(
|
||
zh: AlbumTranslationDraft(
|
||
locale: 'zh-CN',
|
||
title: '开幕晚宴',
|
||
venue: '大宴会厅',
|
||
),
|
||
en: const AlbumTranslationDraft(locale: 'en', title: 'Opening Gala'),
|
||
defaultLocale: 'zh-CN',
|
||
timezone: 'Asia/Shanghai',
|
||
startAt: original.startAt,
|
||
endAt: null,
|
||
).toUpdatePatch(original);
|
||
expect(patch, isNotNull);
|
||
expect(patch!.toJson(), <String, dynamic>{'endAt': null});
|
||
});
|
||
|
||
test('仅修改标题 → translations 全量替换且不含其他键', () {
|
||
final original = Album.fromJson(albumJson());
|
||
final patch =
|
||
draftOf(zhTitle: '闭幕演出').toUpdatePatch(original);
|
||
expect(patch, isNotNull);
|
||
final json = patch!.toJson();
|
||
expect(json.keys, <String>['translations']);
|
||
expect(json['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,
|
||
},
|
||
]);
|
||
});
|
||
|
||
test('切换 defaultLocale（内容未变）→ 仅 defaultLocale 单键', () {
|
||
final original = Album.fromJson(albumJson());
|
||
final patch = draftOf(defaultLocale: 'en').toUpdatePatch(original);
|
||
expect(patch, isNotNull);
|
||
final json = patch!.toJson();
|
||
// 最小化：translations 未变则不重发（服务端按存量校验 en 覆盖，
|
||
// 客户端 validate 已先行拦截 en 标题缺失的切换）。
|
||
expect(json, <String, dynamic>{'defaultLocale': 'en'});
|
||
});
|
||
|
||
test('修改开始时间 → 仅 startAt 键', () {
|
||
final original = Album.fromJson(albumJson());
|
||
final patch = draftOf(
|
||
startAt: DateTime.utc(2026, 9, 18, 8, 0),
|
||
).toUpdatePatch(original);
|
||
expect(patch!.toJson(), <String, dynamic>{
|
||
'startAt': '2026-09-18T08:00:00.000Z',
|
||
});
|
||
});
|
||
});
|
||
}
|