feat: 초기 커밋

- Progress Quest 6.4 Flutter 포팅 프로젝트 - 게임 루프, 상태 관리, UI 구현 - 캐릭터 생성, 인벤토리, 장비, 주문 시스템 - 시장/판매/구매 메커니즘
2025-12-09 17:24:04 +09:00
commit 08054d97c1
168 changed files with 12876 additions and 0 deletions
--- a/test/features/game_play_screen_test.dart
+++ b/test/features/game_play_screen_test.dart
@@ -0,0 +1,199 @@
+import 'package:askiineverdie/src/core/engine/game_mutations.dart';
+import 'package:askiineverdie/src/core/engine/progress_service.dart';
+import 'package:askiineverdie/src/core/engine/reward_service.dart';
+import 'package:askiineverdie/src/core/model/game_state.dart';
+import 'package:askiineverdie/src/core/model/pq_config.dart';
+import 'package:askiineverdie/src/core/storage/save_manager.dart';
+import 'package:askiineverdie/src/core/storage/save_repository.dart';
+import 'package:askiineverdie/src/core/storage/save_service.dart';
+import 'package:askiineverdie/src/features/game/game_play_screen.dart';
+import 'package:askiineverdie/src/features/game/game_session_controller.dart';
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+
+class _FakeSaveManager implements SaveManager {
+  @override
+  Future<SaveOutcome> saveState(GameState state, {String? fileName}) async {
+    return const SaveOutcome.success();
+  }
+
+  @override
+  Future<(SaveOutcome, GameState?)> loadState({String? fileName}) async {
+    return (const SaveOutcome.success(), null);
+  }
+
+  @override
+  Future<List<SaveFileInfo>> listSaves() async => [];
+}
+
+GameState _createTestState() {
+  return GameState.withSeed(
+    seed: 42,
+    traits: const Traits(
+      name: 'TestHero',
+      race: 'Elf',
+      klass: 'Mage',
+      level: 5,
+      motto: 'Test Motto',
+      guild: '',
+    ),
+    stats: const Stats(
+      str: 10,
+      con: 12,
+      dex: 14,
+      intelligence: 16,
+      wis: 11,
+      cha: 9,
+      hpMax: 50,
+      mpMax: 40,
+    ),
+    progress: const ProgressState(
+      task: ProgressBarState(position: 500, max: 1000),
+      quest: ProgressBarState(position: 300, max: 600),
+      plot: ProgressBarState(position: 1800, max: 3600),
+      exp: ProgressBarState(position: 500, max: 1500),
+      encumbrance: ProgressBarState(position: 5, max: 20),
+      currentTask: TaskInfo(caption: 'Battling a Goblin', type: TaskType.kill),
+      plotStageCount: 2,
+      questCount: 3,
+    ),
+  );
+}
+
+GameSessionController _createController() {
+  const config = PqConfig();
+  final mutations = GameMutations(config);
+  return GameSessionController(
+    progressService: ProgressService(
+      config: config,
+      mutations: mutations,
+      rewards: RewardService(mutations),
+    ),
+    saveManager: _FakeSaveManager(),
+    tickInterval: const Duration(seconds: 10), // 느린 틱
+  );
+}
+
+void main() {
+  testWidgets('GamePlayScreen renders 3-panel layout', (tester) async {
+    final controller = _createController();
+    addTearDown(() async {
+      await controller.pause(saveOnStop: false);
+      controller.dispose();
+    });
+
+    await controller.startNew(_createTestState(), isNewGame: false);
+
+    await tester.pumpWidget(
+      MaterialApp(home: GamePlayScreen(controller: controller)),
+    );
+
+    // AppBar 타이틀 확인
+    expect(find.text('Progress Quest - TestHero'), findsOneWidget);
+
+    // 3패널 헤더 확인
+    expect(find.text('Character Sheet'), findsOneWidget);
+    expect(find.text('Equipment'), findsOneWidget);
+    expect(find.text('Plot Development'), findsOneWidget);
+    expect(find.text('Quests'), findsOneWidget);
+
+    // 테스트 완료 후 정리
+    await controller.pause(saveOnStop: false);
+  });
+
+  testWidgets('GamePlayScreen shows character traits', (tester) async {
+    final controller = _createController();
+    addTearDown(() async {
+      await controller.pause(saveOnStop: false);
+      controller.dispose();
+    });
+
+    await controller.startNew(_createTestState(), isNewGame: false);
+
+    await tester.pumpWidget(
+      MaterialApp(home: GamePlayScreen(controller: controller)),
+    );
+
+    // Traits 섹션 확인
+    expect(find.text('Traits'), findsOneWidget);
+    expect(find.text('TestHero'), findsOneWidget);
+    expect(find.text('Elf'), findsOneWidget);
+    expect(find.text('Mage'), findsOneWidget);
+
+    await controller.pause(saveOnStop: false);
+  });
+
+  testWidgets('GamePlayScreen shows stats', (tester) async {
+    final controller = _createController();
+    addTearDown(() async {
+      await controller.pause(saveOnStop: false);
+      controller.dispose();
+    });
+
+    await controller.startNew(_createTestState(), isNewGame: false);
+
+    await tester.pumpWidget(
+      MaterialApp(home: GamePlayScreen(controller: controller)),
+    );
+
+    // Stats 섹션 확인
+    expect(find.text('Stats'), findsOneWidget);
+    expect(find.text('STR'), findsOneWidget);
+    expect(find.text('CON'), findsOneWidget);
+
+    await controller.pause(saveOnStop: false);
+  });
+
+  testWidgets('GamePlayScreen shows current task caption', (tester) async {
+    final controller = _createController();
+    addTearDown(() async {
+      await controller.pause(saveOnStop: false);
+      controller.dispose();
+    });
+
+    await controller.startNew(_createTestState(), isNewGame: false);
+
+    await tester.pumpWidget(
+      MaterialApp(home: GamePlayScreen(controller: controller)),
+    );
+
+    // 현재 태스크 캡션 확인 (퀘스트 목록과 하단 패널에 표시됨)
+    expect(find.text('Battling a Goblin'), findsAtLeast(1));
+
+    await controller.pause(saveOnStop: false);
+  });
+
+  testWidgets('GamePlayScreen shows progress bars', (tester) async {
+    final controller = _createController();
+    addTearDown(() async {
+      await controller.pause(saveOnStop: false);
+      controller.dispose();
+    });
+
+    await controller.startNew(_createTestState(), isNewGame: false);
+
+    await tester.pumpWidget(
+      MaterialApp(home: GamePlayScreen(controller: controller)),
+    );
+
+    // LinearProgressIndicator가 여러 개 표시되는지 확인
+    expect(find.byType(LinearProgressIndicator), findsAtLeast(4));
+
+    await controller.pause(saveOnStop: false);
+  });
+
+  testWidgets('Loading state shows CircularProgressIndicator', (tester) async {
+    final controller = _createController();
+    addTearDown(() {
+      controller.dispose();
+    });
+
+    // 상태 없이 시작 (startNew 호출 안 함)
+    await tester.pumpWidget(
+      MaterialApp(home: GamePlayScreen(controller: controller)),
+    );
+
+    // 로딩 인디케이터 확인
+    expect(find.byType(CircularProgressIndicator), findsOneWidget);
+  });
+}
--- a/test/features/game_session_controller_test.dart
+++ b/test/features/game_session_controller_test.dart
@@ -0,0 +1,143 @@
+import 'package:askiineverdie/src/core/engine/game_mutations.dart';
+import 'package:askiineverdie/src/core/engine/progress_service.dart';
+import 'package:askiineverdie/src/core/engine/reward_service.dart';
+import 'package:askiineverdie/src/core/model/game_state.dart';
+import 'package:askiineverdie/src/core/model/pq_config.dart';
+import 'package:askiineverdie/src/core/storage/save_manager.dart';
+import 'package:askiineverdie/src/core/storage/save_repository.dart';
+import 'package:askiineverdie/src/core/storage/save_service.dart';
+import 'package:askiineverdie/src/features/game/game_session_controller.dart';
+import 'package:fake_async/fake_async.dart';
+import 'package:flutter_test/flutter_test.dart';
+
+class FakeSaveManager implements SaveManager {
+  final List<GameState> savedStates = [];
+  (SaveOutcome, GameState?) Function(String?)? onLoad;
+  SaveOutcome saveOutcome = const SaveOutcome.success();
+
+  @override
+  Future<SaveOutcome> saveState(GameState state, {String? fileName}) async {
+    savedStates.add(state);
+    return saveOutcome;
+  }
+
+  @override
+  Future<(SaveOutcome, GameState?)> loadState({String? fileName}) async {
+    if (onLoad != null) {
+      return onLoad!(fileName);
+    }
+    return (const SaveOutcome.success(), null);
+  }
+
+  @override
+  Future<List<SaveFileInfo>> listSaves() async => [];
+}
+
+void main() {
+  const config = PqConfig();
+  final mutations = GameMutations(config);
+  final progressService = ProgressService(
+    config: config,
+    mutations: mutations,
+    rewards: RewardService(mutations),
+  );
+
+  GameSessionController buildController(
+    FakeAsync async,
+    FakeSaveManager saveManager,
+  ) {
+    return GameSessionController(
+      progressService: progressService,
+      saveManager: saveManager,
+      tickInterval: const Duration(milliseconds: 10),
+      now: () =>
+          DateTime.fromMillisecondsSinceEpoch(async.elapsed.inMilliseconds),
+    );
+  }
+
+  GameState sampleState() {
+    return GameState.withSeed(
+      seed: 1,
+      traits: const Traits(
+        name: 'Hero',
+        race: 'Human',
+        klass: 'Fighter',
+        level: 1,
+        motto: '',
+        guild: '',
+      ),
+      stats: const Stats(
+        str: 5,
+        con: 5,
+        dex: 5,
+        intelligence: 5,
+        wis: 5,
+        cha: 5,
+        hpMax: 10,
+        mpMax: 8,
+      ),
+      progress: const ProgressState(
+        task: ProgressBarState(position: 0, max: 50),
+        quest: ProgressBarState(position: 0, max: 1000),
+        plot: ProgressBarState(position: 0, max: 1000),
+        exp: ProgressBarState(position: 0, max: 9999),
+        encumbrance: ProgressBarState(position: 0, max: 1),
+        currentTask: TaskInfo(caption: 'Battle', type: TaskType.kill),
+        plotStageCount: 1,
+        questCount: 0,
+      ),
+    );
+  }
+
+  test('startNew runs loop and publishes state updates', () {
+    fakeAsync((async) {
+      final saveManager = FakeSaveManager();
+      final controller = buildController(async, saveManager);
+
+      controller.startNew(sampleState(), isNewGame: false);
+      async.flushMicrotasks();
+
+      expect(controller.status, GameSessionStatus.running);
+      expect(controller.state, isNotNull);
+
+      async.elapse(const Duration(milliseconds: 30));
+      async.flushMicrotasks();
+
+      expect(controller.state!.progress.task.position, greaterThan(0));
+
+      controller.pause();
+      async.flushMicrotasks();
+      expect(controller.status, GameSessionStatus.idle);
+    });
+  });
+
+  test('loadAndStart surfaces save load errors', () {
+    fakeAsync((async) {
+      final saveManager = FakeSaveManager()
+        ..onLoad = (_) => (const SaveOutcome.failure('boom'), null);
+      final controller = buildController(async, saveManager);
+
+      controller.loadAndStart(fileName: 'bad.pqf');
+      async.flushMicrotasks();
+
+      expect(controller.status, GameSessionStatus.error);
+      expect(controller.error, 'boom');
+    });
+  });
+
+  test('pause saves on stop when requested', () {
+    fakeAsync((async) {
+      final saveManager = FakeSaveManager();
+      final controller = buildController(async, saveManager);
+
+      controller.startNew(sampleState(), isNewGame: false);
+      async.flushMicrotasks();
+
+      controller.pause(saveOnStop: true);
+      async.flushMicrotasks();
+
+      expect(controller.status, GameSessionStatus.idle);
+      expect(saveManager.savedStates.length, 1);
+    });
+  });
+}
--- a/test/features/new_character_screen_test.dart
+++ b/test/features/new_character_screen_test.dart
@@ -0,0 +1,107 @@
+import 'package:askiineverdie/src/core/model/game_state.dart';
+import 'package:askiineverdie/src/features/new_character/new_character_screen.dart';
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+
+void main() {
+  testWidgets('NewCharacterScreen renders main sections', (tester) async {
+    await tester.pumpWidget(
+      MaterialApp(home: NewCharacterScreen(onCharacterCreated: (_) {})),
+    );
+
+    // 화면 타이틀 확인
+    expect(find.text('Progress Quest - New Character'), findsOneWidget);
+
+    // 종족 섹션 확인
+    expect(find.text('Race'), findsOneWidget);
+
+    // 직업 섹션 확인
+    expect(find.text('Class'), findsOneWidget);
+
+    // 능력치 섹션 확인
+    expect(find.text('Stats'), findsOneWidget);
+    expect(find.text('STR'), findsOneWidget);
+    expect(find.text('CON'), findsOneWidget);
+
+    // Sold! 버튼 확인
+    expect(find.text('Sold!'), findsOneWidget);
+  });
+
+  testWidgets('Unroll button exists and can be tapped', (tester) async {
+    await tester.pumpWidget(
+      MaterialApp(home: NewCharacterScreen(onCharacterCreated: (_) {})),
+    );
+
+    // Unroll 버튼 확인
+    final unrollButton = find.text('Unroll');
+    expect(unrollButton, findsOneWidget);
+
+    // Unroll 버튼 탭
+    await tester.tap(unrollButton);
+    await tester.pump();
+
+    // Total이 표시되는지 확인
+    expect(find.textContaining('Total'), findsOneWidget);
+  });
+
+  testWidgets('Sold button creates character with generated name', (
+    tester,
+  ) async {
+    GameState? createdState;
+
+    await tester.pumpWidget(
+      MaterialApp(
+        home: NewCharacterScreen(
+          onCharacterCreated: (state) {
+            createdState = state;
+          },
+        ),
+      ),
+    );
+
+    // Sold! 버튼이 보이도록 스크롤
+    await tester.scrollUntilVisible(
+      find.text('Sold!'),
+      500.0,
+      scrollable: find.byType(Scrollable).first,
+    );
+    await tester.pumpAndSettle();
+
+    // Sold! 버튼 탭
+    await tester.tap(find.text('Sold!'));
+    await tester.pumpAndSettle();
+
+    // 콜백이 호출되었는지 확인
+    expect(createdState, isNotNull);
+    expect(createdState!.traits.name.isNotEmpty, isTrue);
+    expect(createdState!.traits.level, 1);
+    expect(createdState!.traits.race.isNotEmpty, isTrue);
+    expect(createdState!.traits.klass.isNotEmpty, isTrue);
+  });
+
+  testWidgets('Stats section displays all six stats', (tester) async {
+    await tester.pumpWidget(
+      MaterialApp(home: NewCharacterScreen(onCharacterCreated: (_) {})),
+    );
+
+    // 능력치 라벨들이 표시되는지 확인
+    expect(find.text('STR'), findsOneWidget);
+    expect(find.text('CON'), findsOneWidget);
+    expect(find.text('DEX'), findsOneWidget);
+    expect(find.text('INT'), findsOneWidget);
+    expect(find.text('WIS'), findsOneWidget);
+    expect(find.text('CHA'), findsOneWidget);
+
+    // Total 라벨 확인
+    expect(find.textContaining('Total'), findsOneWidget);
+  });
+
+  testWidgets('Name text field exists', (tester) async {
+    await tester.pumpWidget(
+      MaterialApp(home: NewCharacterScreen(onCharacterCreated: (_) {})),
+    );
+
+    // TextField 확인 (이름 입력 필드)
+    expect(find.byType(TextField), findsOneWidget);
+  });
+}