test: 저장 무결성 + Model 직렬화 라운드트립 테스트 추가

- save_integrity_test: 13개 (sign/verify 라운드트립, 변조 감지, 레거시 호환)
- save_data_roundtrip_test: 16개 (toJson/fromJson, v2→v4 마이그레이션, 기본값)
This commit is contained in:
JiWoong Sul
2026-03-30 19:41:21 +09:00
parent e051bd451a
commit 45d2544437
2 changed files with 759 additions and 0 deletions

View File

@@ -0,0 +1,568 @@
import 'dart:collection';
import 'dart:convert';
import 'package:asciineverdie/src/core/model/equipment_container.dart';
import 'package:asciineverdie/src/core/model/equipment_item.dart';
import 'package:asciineverdie/src/core/model/equipment_slot.dart';
import 'package:asciineverdie/src/core/model/item_stats.dart';
import 'package:asciineverdie/src/core/model/monetization_state.dart';
import 'package:asciineverdie/src/core/model/monster_grade.dart';
import 'package:asciineverdie/src/core/model/save_data.dart';
import 'package:asciineverdie/src/core/model/game_state.dart';
import 'package:flutter_test/flutter_test.dart';
void main() {
group('GameSave 직렬화(serialization) 라운드트립', () {
// =========================================================================
// 헬퍼: 모든 필드가 채워진 GameSave 생성
// =========================================================================
GameSave _createFullSave() {
return GameSave(
version: kSaveVersion,
rngState: 12345,
cheatsEnabled: true,
traits: const Traits(
name: 'TestHero',
race: 'Kernel Giant',
klass: 'Bug Hunter',
level: 42,
motto: 'Never Die',
guild: 'ASCII Warriors',
raceId: 'kernel_giant',
classId: 'bug_hunter',
),
stats: const Stats(
str: 18,
con: 16,
dex: 14,
intelligence: 12,
wis: 10,
cha: 8,
hpMax: 200,
mpMax: 100,
hpCurrent: 150,
mpCurrent: 75,
),
inventory: const Inventory(
gold: 9999,
items: [
InventoryEntry(name: 'Goblin Ear', count: 5),
InventoryEntry(name: 'Dragon Scale', count: 1),
],
),
equipment: Equipment(
items: [
const EquipmentItem(
name: 'Flaming Sword',
slot: EquipmentSlot.weapon,
level: 10,
weight: 15,
stats: ItemStats(atk: 50, criRate: 0.1),
rarity: ItemRarity.epic,
),
const EquipmentItem(
name: 'Tower Shield',
slot: EquipmentSlot.shield,
level: 8,
weight: 20,
stats: ItemStats(def: 30, blockRate: 0.2),
rarity: ItemRarity.rare,
),
EquipmentItem.empty(EquipmentSlot.helm),
EquipmentItem.empty(EquipmentSlot.hauberk),
EquipmentItem.empty(EquipmentSlot.brassairts),
EquipmentItem.empty(EquipmentSlot.vambraces),
EquipmentItem.empty(EquipmentSlot.gauntlets),
EquipmentItem.empty(EquipmentSlot.gambeson),
EquipmentItem.empty(EquipmentSlot.cuisses),
EquipmentItem.empty(EquipmentSlot.greaves),
EquipmentItem.empty(EquipmentSlot.sollerets),
],
bestIndex: 0,
),
skillBook: const SkillBook(
skills: [
SkillEntry(name: 'Hack', rank: 'III'),
SkillEntry(name: 'Slash', rank: 'V'),
],
),
progress: ProgressState(
task: const ProgressBarState(position: 50, max: 100),
quest: const ProgressBarState(position: 3, max: 10),
plot: const ProgressBarState(position: 1, max: 5),
exp: const ProgressBarState(position: 500, max: 1000),
encumbrance: const ProgressBarState(position: 30, max: 100),
currentTask: const TaskInfo(
caption: 'Executing a Goblin',
type: TaskType.kill,
monsterBaseName: 'Goblin',
monsterPart: 'ear',
monsterLevel: 5,
monsterGrade: MonsterGrade.elite,
),
plotStageCount: 3,
questCount: 7,
plotHistory: const [
HistoryEntry(caption: 'Prologue', isComplete: true),
HistoryEntry(caption: 'Act I', isComplete: false),
],
questHistory: const [
HistoryEntry(caption: 'Exterminate Goblins', isComplete: true),
],
currentQuestMonster: const QuestMonsterInfo(
monsterData: 'Goblin|3|ear',
monsterIndex: 2,
),
monstersKilled: 150,
deathCount: 3,
),
queue: QueueState(
entries: Queue<QueueEntry>.from(const [
QueueEntry(
kind: QueueKind.task,
durationMillis: 2000,
caption: 'Heading to market',
taskType: TaskType.market,
),
]),
),
monetization: const MonetizationState(
adRemovalPurchased: true,
rollsRemaining: 3,
undoRemaining: 2,
pendingChests: 4,
autoReviveEndMs: 50000,
speedBoostEndMs: 80000,
luckyCharmEndMs: 60000,
),
);
}
// =========================================================================
// toJson → fromJson 라운드트립 테스트
// =========================================================================
test('toJson() → fromJson() 라운드트립 — 모든 필드 보존', () {
final original = _createFullSave();
// jsonEncode → jsonDecode로 순수 Map 변환 (freezed 객체 제거)
final json = jsonDecode(jsonEncode(original.toJson()))
as Map<String, dynamic>;
final restored = GameSave.fromJson(json);
// traits 검증
expect(restored.traits.name, equals('TestHero'));
expect(restored.traits.race, equals('Kernel Giant'));
expect(restored.traits.klass, equals('Bug Hunter'));
expect(restored.traits.level, equals(42));
expect(restored.traits.motto, equals('Never Die'));
expect(restored.traits.guild, equals('ASCII Warriors'));
expect(restored.traits.raceId, equals('kernel_giant'));
expect(restored.traits.classId, equals('bug_hunter'));
// stats 검증
expect(restored.stats.str, equals(18));
expect(restored.stats.con, equals(16));
expect(restored.stats.dex, equals(14));
expect(restored.stats.intelligence, equals(12));
expect(restored.stats.wis, equals(10));
expect(restored.stats.cha, equals(8));
expect(restored.stats.hpMax, equals(200));
expect(restored.stats.mpMax, equals(100));
expect(restored.stats.hpCurrent, equals(150));
expect(restored.stats.mpCurrent, equals(75));
// inventory 검증
expect(restored.inventory.gold, equals(9999));
expect(restored.inventory.items.length, equals(2));
expect(restored.inventory.items[0].name, equals('Goblin Ear'));
expect(restored.inventory.items[0].count, equals(5));
expect(restored.inventory.items[1].name, equals('Dragon Scale'));
expect(restored.inventory.items[1].count, equals(1));
// equipment 검증
expect(restored.equipment.weapon, equals('Flaming Sword'));
expect(restored.equipment.shield, equals('Tower Shield'));
expect(restored.equipment.bestIndex, equals(0));
expect(
restored.equipment.weaponItem.rarity,
equals(ItemRarity.epic),
);
expect(restored.equipment.weaponItem.level, equals(10));
expect(restored.equipment.weaponItem.stats.atk, equals(50));
// skillBook 검증
expect(restored.skillBook.skills.length, equals(2));
expect(restored.skillBook.skills[0].name, equals('Hack'));
expect(restored.skillBook.skills[0].rank, equals('III'));
// progress 검증
expect(restored.progress.task.position, equals(50));
expect(restored.progress.task.max, equals(100));
expect(restored.progress.quest.position, equals(3));
expect(restored.progress.exp.position, equals(500));
expect(restored.progress.currentTask.caption, equals('Executing a Goblin'));
expect(restored.progress.currentTask.type, equals(TaskType.kill));
expect(
restored.progress.currentTask.monsterGrade,
equals(MonsterGrade.elite),
);
expect(restored.progress.plotStageCount, equals(3));
expect(restored.progress.questCount, equals(7));
expect(restored.progress.plotHistory.length, equals(2));
expect(restored.progress.plotHistory[0].isComplete, isTrue);
expect(restored.progress.questHistory.length, equals(1));
expect(restored.progress.currentQuestMonster, isNotNull);
expect(
restored.progress.currentQuestMonster!.monsterData,
equals('Goblin|3|ear'),
);
expect(restored.progress.monstersKilled, equals(150));
expect(restored.progress.deathCount, equals(3));
// queue 검증
expect(restored.queue.entries.length, equals(1));
expect(restored.queue.entries.first.kind, equals(QueueKind.task));
expect(restored.queue.entries.first.durationMillis, equals(2000));
expect(restored.queue.entries.first.taskType, equals(TaskType.market));
// monetization 검증
expect(restored.monetization, isNotNull);
expect(restored.monetization!.adRemovalPurchased, isTrue);
expect(restored.monetization!.rollsRemaining, equals(3));
expect(restored.monetization!.undoRemaining, equals(2));
expect(restored.monetization!.pendingChests, equals(4));
expect(restored.monetization!.autoReviveEndMs, equals(50000));
expect(restored.monetization!.speedBoostEndMs, equals(80000));
expect(restored.monetization!.luckyCharmEndMs, equals(60000));
// 메타(meta) 검증
expect(restored.version, equals(kSaveVersion));
expect(restored.rngState, equals(12345));
expect(restored.cheatsEnabled, isTrue);
});
// =========================================================================
// v2→v4 마이그레이션(migration) 테스트 — 레거시 장비 문자열 → 새 형식
// =========================================================================
group('v2→v4 마이그레이션', () {
test('레거시 장비 문자열이 EquipmentItem으로 변환', () {
final legacyJson = <String, dynamic>{
'version': 2,
'rng': 100,
'traits': {'name': 'OldHero', 'race': 'Elf', 'klass': 'Mage'},
'stats': {'str': 10, 'con': 10, 'dex': 10, 'int': 10, 'wis': 10, 'cha': 10},
'inventory': {'gold': 500, 'items': []},
'equipment': {
'weapon': 'Ancient Sword',
'shield': 'Wooden Shield',
'helm': 'Iron Helm',
'hauberk': '',
'brassairts': '',
'vambraces': '',
'gauntlets': '',
'gambeson': '',
'cuisses': '',
'greaves': '',
'sollerets': '',
'bestIndex': 0,
},
'skills': [],
'progress': {
'task': {'pos': 0, 'max': 1},
'quest': {'pos': 0, 'max': 1},
'plot': {'pos': 0, 'max': 1},
'exp': {'pos': 0, 'max': 1},
'encumbrance': {'pos': 0, 'max': 1},
},
'queue': [],
};
final restored = GameSave.fromJson(legacyJson);
// 레거시 장비 문자열 → EquipmentItem 변환 확인
expect(restored.equipment.weapon, equals('Ancient Sword'));
expect(restored.equipment.shield, equals('Wooden Shield'));
expect(restored.equipment.helm, equals('Iron Helm'));
// 빈 슬롯은 빈 이름으로 유지
expect(restored.equipment.hauberk, isEmpty);
// 레거시 아이템은 level 1, common으로 변환
expect(restored.equipment.weaponItem.level, equals(1));
expect(restored.equipment.weaponItem.rarity, equals(ItemRarity.common));
expect(restored.equipment.weaponItem.slot, equals(EquipmentSlot.weapon));
// 버전 정보 보존
expect(restored.version, equals(2));
});
test('v2 세이브에 monetization 없으면 null', () {
// jsonDecode로 순수 Map<String, dynamic> 생성 (타입 캐스팅 호환)
final legacyJson = jsonDecode(jsonEncode({
'version': 2,
'rng': 0,
'traits': {},
'stats': {},
'inventory': {'gold': 0, 'items': []},
'equipment': {
'weapon': 'Keyboard',
'shield': '',
'helm': '',
'hauberk': '',
'brassairts': '',
'vambraces': '',
'gauntlets': '',
'gambeson': '',
'cuisses': '',
'greaves': '',
'sollerets': '',
'bestIndex': 0,
},
'skills': [],
'progress': {},
'queue': [],
})) as Map<String, dynamic>;
final restored = GameSave.fromJson(legacyJson);
expect(restored.monetization, isNull);
});
});
// =========================================================================
// 누락된 JSON 키(missing keys)에 대한 기본값(default) 처리
// =========================================================================
group('누락된 JSON 키 기본값 처리', () {
test('완전히 빈 JSON에서 기본값으로 GameSave 생성', () {
final emptyJson = <String, dynamic>{};
final restored = GameSave.fromJson(emptyJson);
// 기본값 확인
expect(restored.version, equals(kSaveVersion));
expect(restored.rngState, equals(0));
expect(restored.cheatsEnabled, isFalse);
expect(restored.traits.name, isEmpty);
expect(restored.traits.level, equals(1));
expect(restored.stats.str, equals(0));
expect(restored.stats.hpMax, equals(0));
expect(restored.inventory.gold, equals(0));
expect(restored.inventory.items, isEmpty);
expect(restored.skillBook.skills, isEmpty);
expect(restored.queue.entries, isEmpty);
expect(restored.monetization, isNull);
});
test('traits 키만 있고 내부 필드 누락 시 기본값', () {
final json = <String, dynamic>{
'traits': {'name': 'OnlyName'},
};
final restored = GameSave.fromJson(json);
expect(restored.traits.name, equals('OnlyName'));
expect(restored.traits.race, isEmpty);
expect(restored.traits.klass, isEmpty);
expect(restored.traits.level, equals(1));
expect(restored.traits.raceId, isEmpty);
expect(restored.traits.classId, isEmpty);
});
test('stats에 hpCurrent/mpCurrent 누락 시 null', () {
final json = <String, dynamic>{
'stats': {'str': 10, 'hpMax': 50, 'mpMax': 30},
};
final restored = GameSave.fromJson(json);
expect(restored.stats.str, equals(10));
expect(restored.stats.hpMax, equals(50));
expect(restored.stats.hpCurrent, isNull);
expect(restored.stats.mpCurrent, isNull);
});
test('progress 키 누락 시 기본 ProgressBarState', () {
final json = <String, dynamic>{
'progress': {'plotStages': 5, 'questCount': 10},
};
final restored = GameSave.fromJson(json);
expect(restored.progress.task.position, equals(0));
expect(restored.progress.task.max, equals(1));
expect(restored.progress.plotStageCount, equals(5));
expect(restored.progress.questCount, equals(10));
});
test('알 수 없는 TaskType/QueueKind는 기본값으로 대체(fallback)', () {
final json = <String, dynamic>{
'progress': {
'task': {'pos': 0, 'max': 1},
'quest': {'pos': 0, 'max': 1},
'plot': {'pos': 0, 'max': 1},
'exp': {'pos': 0, 'max': 1},
'encumbrance': {'pos': 0, 'max': 1},
'taskInfo': {
'caption': 'Unknown task',
'type': 'nonexistent_type',
},
},
'queue': [
{
'kind': 'nonexistent_kind',
'duration': 1000,
'caption': 'Unknown',
'taskType': 'nonexistent_task_type',
},
],
};
final restored = GameSave.fromJson(json);
// 알 수 없는 enum 값은 기본값으로 대체
expect(restored.progress.currentTask.type, equals(TaskType.neutral));
expect(restored.queue.entries.first.kind, equals(QueueKind.task));
expect(
restored.queue.entries.first.taskType,
equals(TaskType.neutral),
);
});
});
// =========================================================================
// null/빈 배열(empty array) 처리 테스트
// =========================================================================
group('null/빈 배열 처리', () {
test('inventory.items가 빈 배열이면 빈 리스트', () {
final json = <String, dynamic>{
'inventory': {'gold': 100, 'items': []},
};
final restored = GameSave.fromJson(json);
expect(restored.inventory.items, isEmpty);
expect(restored.inventory.gold, equals(100));
});
test('skills가 빈 배열이면 빈 스킬북', () {
final json = <String, dynamic>{
'skills': [],
};
final restored = GameSave.fromJson(json);
expect(restored.skillBook.skills, isEmpty);
});
test('plotHistory/questHistory null이면 빈 리스트', () {
final json = <String, dynamic>{
'progress': {
'task': {'pos': 0, 'max': 1},
'quest': {'pos': 0, 'max': 1},
'plot': {'pos': 0, 'max': 1},
'exp': {'pos': 0, 'max': 1},
'encumbrance': {'pos': 0, 'max': 1},
'plotHistory': null,
'questHistory': null,
},
};
final restored = GameSave.fromJson(json);
expect(restored.progress.plotHistory, isEmpty);
expect(restored.progress.questHistory, isEmpty);
});
test('questMonster null이면 null 유지', () {
final json = <String, dynamic>{
'progress': {
'task': {'pos': 0, 'max': 1},
'quest': {'pos': 0, 'max': 1},
'plot': {'pos': 0, 'max': 1},
'exp': {'pos': 0, 'max': 1},
'encumbrance': {'pos': 0, 'max': 1},
'questMonster': null,
},
};
final restored = GameSave.fromJson(json);
expect(restored.progress.currentQuestMonster, isNull);
});
test('queue가 빈 배열이면 빈 큐', () {
final json = <String, dynamic>{
'queue': [],
};
final restored = GameSave.fromJson(json);
expect(restored.queue.entries, isEmpty);
});
test('monetization null이면 null 유지', () {
final json = <String, dynamic>{
'monetization': null,
};
final restored = GameSave.fromJson(json);
expect(restored.monetization, isNull);
});
test('monsterGrade null이면 null 유지 (neutral 타입)', () {
final json = <String, dynamic>{
'progress': {
'task': {'pos': 0, 'max': 1},
'quest': {'pos': 0, 'max': 1},
'plot': {'pos': 0, 'max': 1},
'exp': {'pos': 0, 'max': 1},
'encumbrance': {'pos': 0, 'max': 1},
'taskInfo': {
'caption': 'Walking',
'type': 'neutral',
'monsterGrade': null,
},
},
};
final restored = GameSave.fromJson(json);
expect(restored.progress.currentTask.monsterGrade, isNull);
});
});
// =========================================================================
// toState() 변환 테스트
// =========================================================================
test('toState()로 GameState 변환 시 DeterministicRandom 상태 보존', () {
final save = GameSave(
version: kSaveVersion,
rngState: 42,
traits: const Traits(
name: 'Test',
race: 'Human',
klass: 'Warrior',
level: 1,
motto: '',
guild: '',
),
stats: Stats.empty(),
inventory: Inventory.empty(),
equipment: Equipment.empty(),
skillBook: SkillBook.empty(),
progress: ProgressState.empty(),
queue: QueueState.empty(),
);
final state = save.toState();
expect(state.rng.state, equals(42));
expect(state.traits.name, equals('Test'));
});
});
}