feat: 결재·마스터 실연동 업데이트

test/features/util/postal_search/data/postal_search_repository_remote_test.dart

@@ -0,0 +1,77 @@
+import 'package:dio/dio.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:mocktail/mocktail.dart';
+
+import 'package:superport_v2/core/network/api_client.dart';
+import 'package:superport_v2/features/util/postal_search/data/repositories/postal_search_repository_remote.dart';
+
+class _MockApiClient extends Mock implements ApiClient {}
+
+void main() {
+  late ApiClient apiClient;
+  late PostalSearchRepositoryRemote repository;
+
+  setUpAll(() {
+    registerFallbackValue(Options());
+    registerFallbackValue(CancelToken());
+  });
+
+  setUp(() {
+    apiClient = _MockApiClient();
+    repository = PostalSearchRepositoryRemote(apiClient: apiClient);
+  });
+
+  test('검색 키워드가 비어 있으면 빈 배열을 반환한다', () async {
+    final result = await repository.search(keyword: '   ');
+    expect(result, isEmpty);
+    verifyNever(() => apiClient.get<dynamic>(any()));
+  });
+
+  test('검색 요청 시 q/page/page_size 파라미터를 전달한다', () async {
+    when(
+      () => apiClient.get<dynamic>(
+        any(),
+        query: any(named: 'query'),
+        options: any(named: 'options'),
+        cancelToken: any(named: 'cancelToken'),
+      ),
+    ).thenAnswer(
+      (_) async => Response<dynamic>(
+        data: {
+          'items': [
+            {
+              'zipcode': '06000',
+              'sido': '서울특별시',
+              'sigungu': '강남구',
+              'road_name': '테헤란로',
+            },
+          ],
+        },
+        requestOptions: RequestOptions(path: '/api/v1/zipcodes'),
+        statusCode: 200,
+      ),
+    );
+
+    final result = await repository.search(keyword: '테헤란로', limit: 10, page: 2);
+
+    expect(result, hasLength(1));
+
+    final verification = verify(
+      () => apiClient.get<dynamic>(
+        captureAny(),
+        query: captureAny(named: 'query'),
+        options: any(named: 'options'),
+        cancelToken: any(named: 'cancelToken'),
+      ),
+    );
+    final path = verification.captured[0] as String;
+    final query = verification.captured[1] as Map<String, dynamic>;
+
+    expect(path, equals('/api/v1/zipcodes'));
+    expect(query['q'], '테헤란로');
+    expect(query['page'], 2);
+    expect(query['page_size'], 10);
+    expect(query.containsKey('zipcode'), isFalse);
+    expect(query.containsKey('road_name'), isFalse);
+  });
+}

test/features/util/postal_search/presentation/widgets/postal_search_dialog_test.dart

@@ -2,6 +2,8 @@ import 'package:flutter/material.dart';
 import 'package:flutter_test/flutter_test.dart';
 import 'package:shadcn_ui/shadcn_ui.dart';
 
+import 'package:superport_v2/core/network/api_error.dart';
+import 'package:superport_v2/core/network/failure.dart';
 import 'package:superport_v2/features/util/postal_search/presentation/models/postal_search_result.dart';
 import 'package:superport_v2/features/util/postal_search/presentation/widgets/postal_search_dialog.dart';
 
@@ -151,4 +153,32 @@ void main() {
     await tester.tap(find.text('닫기'));
     await tester.pumpAndSettle();
   });
+
+  testWidgets('검색 실패 시 Failure 메시지를 표시한다', (tester) async {
+    final exception = ApiException(
+      code: ApiErrorCode.unprocessableEntity,
+      message: '우편번호 검색에 실패했습니다.',
+      details: {
+        'errors': {
+          'keyword': ['검색어를 다시 확인해 주세요.'],
+        },
+      },
+    );
+
+    await tester.pumpWidget(
+      _PostalSearchHarness(
+        fetcher: (_) => Future<List<PostalSearchResult>>.error(exception),
+      ),
+    );
+
+    await tester.pumpAndSettle();
+
+    final inputFinder = find.byType(EditableText);
+    await tester.enterText(inputFinder, '강남대로');
+    await tester.tap(find.text('검색'));
+    await tester.pumpAndSettle();
+
+    final failure = Failure.from(exception);
+    expect(find.text(failure.describe()), findsOneWidget);
+  });
 }