feat(approvals): Approval Flow v2 프런트엔드 전면 개편

- 환경/라우터 모듈에 approval_flow_v2 토글을 추가하고 FeatureFlags 초기화를 연결 (.env*, lib/core/**)
- ApiClient 빌더·ApiRoutes 확장과 ApprovalRepositoryRemote 리팩터링으로 include·액션 시그니처를 정합화
- ApprovalFlow·ApprovalDraft 엔티티/레포/유즈케이스를 도입해 서버 초안과 단계 액션(승인·회수·재상신)을 지원
- Approval 컨트롤러·히스토리·템플릿 페이지와 공유 위젯을 재작성해 감사 로그·회수 UX·템플릿 CRUD를 반영
- Inbound/Outbound/Rental 컨트롤러·페이지에 결재 섹션을 삽입하고 대시보드 pending 카드 요약을 갱신
- SuperportDialog·FormField 등 공통 위젯을 보강하고 승인 위젯 가이드를 추가해 UI 가이드를 정리
- 결재/재고 테스트 픽스처와 단위·위젯·통합 테스트를 확장하고 flutter_test_config로 스테이징 호스트를 허용
- Approval Flow 레포트/플랜 문서를 업데이트하고 ApprovalFlow_System_Integration_and_ChangePlan.md를 추가
- 실행: flutter analyze, flutter test
This commit is contained in:
JiWoong Sul
2025-10-31 01:05:39 +09:00
parent 259b056072
commit d76f765814
133 changed files with 13878 additions and 947 deletions

View File

@@ -0,0 +1,58 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:superport_v2/features/approvals/request/presentation/controllers/approval_request_controller.dart';
import 'package:superport_v2/features/approvals/request/presentation/widgets/approval_step_configurator.dart';
Widget _buildTestApp(Widget child) {
return MaterialApp(
home: ShadTheme(
data: ShadThemeData(
colorScheme: const ShadSlateColorScheme.light(),
brightness: Brightness.light,
),
child: Scaffold(body: child),
),
);
}
ApprovalRequestParticipant _participant(int id, String name) {
return ApprovalRequestParticipant(id: id, name: name, employeeNo: 'EMP$id');
}
void main() {
TestWidgetsFlutterBinding.ensureInitialized();
testWidgets('요약 섹션에 상신자와 단계 정보가 표시된다', (tester) async {
final controller = ApprovalRequestController();
controller.setRequester(_participant(1, '상신자'));
controller.addStep(approver: _participant(2, '1차 승인자'));
controller.addStep(approver: _participant(3, '최종 승인자'));
await tester.pumpWidget(
_buildTestApp(ApprovalStepConfigurator(controller: controller)),
);
await tester.pumpAndSettle();
expect(find.textContaining('상신자: 상신자'), findsOneWidget);
expect(find.textContaining('최종 승인자: 최종 승인자'), findsOneWidget);
expect(find.textContaining('총 단계: 2개'), findsOneWidget);
});
testWidgets('편집 버튼을 누르면 구성 모달이 열린다', (tester) async {
final controller = ApprovalRequestController();
controller.setRequester(_participant(1, '사용자A'));
await tester.pumpWidget(
_buildTestApp(ApprovalStepConfigurator(controller: controller)),
);
await tester.pump();
await tester.tap(find.text('단계 구성 편집'));
await tester.pumpAndSettle();
expect(find.text('결재 단계 구성'), findsWidgets);
expect(find.text('결재 단계 목록'), findsOneWidget);
});
}

View File

@@ -0,0 +1,136 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:mocktail/mocktail.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:superport_v2/core/common/models/paginated_result.dart';
import 'package:superport_v2/features/approvals/domain/entities/approval_template.dart';
import 'package:superport_v2/features/approvals/domain/repositories/approval_template_repository.dart';
import 'package:superport_v2/features/approvals/request/presentation/controllers/approval_request_controller.dart';
import 'package:superport_v2/features/approvals/request/presentation/widgets/approval_template_picker.dart';
class _MockApprovalTemplateRepository extends Mock
implements ApprovalTemplateRepository {}
Widget _buildApp(Widget child) {
return MaterialApp(
home: ShadTheme(
data: ShadThemeData(
colorScheme: const ShadSlateColorScheme.light(),
brightness: Brightness.light,
),
child: Scaffold(body: child),
),
);
}
void main() {
TestWidgetsFlutterBinding.ensureInitialized();
late _MockApprovalTemplateRepository repository;
setUp(() {
repository = _MockApprovalTemplateRepository();
});
testWidgets('템플릿을 선택해 적용하면 단계가 컨트롤러에 반영된다', (tester) async {
final view = tester.view;
view.physicalSize = const Size(1280, 800);
view.devicePixelRatio = 1.0;
addTearDown(() {
view.resetPhysicalSize();
view.resetDevicePixelRatio();
});
final controller = ApprovalRequestController();
final template = ApprovalTemplate(
id: 1,
code: 'AP-RENTAL',
name: '입고 결재 템플릿',
isActive: true,
steps: const [],
updatedAt: DateTime.utc(2025, 1, 1),
createdBy: ApprovalTemplateAuthor(
id: 7,
employeeNo: 'EMP-7',
name: '관리자',
),
);
final templateDetail = template.copyWith(
steps: [
ApprovalTemplateStep(
id: 10,
stepOrder: 1,
approver: ApprovalTemplateApprover(
id: 101,
employeeNo: 'EMP-101',
name: '1차 승인자',
),
note: '재고 확인',
),
ApprovalTemplateStep(
id: 11,
stepOrder: 2,
approver: ApprovalTemplateApprover(
id: 102,
employeeNo: 'EMP-102',
name: '최종 승인자',
),
note: '승인 처리',
),
],
);
when(
() => repository.list(
page: any(named: 'page'),
pageSize: any(named: 'pageSize'),
isActive: any(named: 'isActive'),
),
).thenAnswer(
(_) async => PaginatedResult<ApprovalTemplate>(
items: [template],
page: 1,
pageSize: 30,
total: 1,
),
);
when(
() => repository.fetchDetail(
template.id,
includeSteps: any(named: 'includeSteps'),
),
).thenAnswer((_) async => templateDetail);
final applied = <ApprovalTemplate>[];
controller.setTemplateSnapshot(
ApprovalTemplateSnapshot(
templateId: template.id,
updatedAt: template.updatedAt,
),
);
await tester.pumpWidget(
_buildApp(
ApprovalTemplatePicker(
controller: controller,
repository: repository,
onTemplateApplied: applied.add,
),
),
);
await tester.pump();
await tester.pumpAndSettle();
final applyButton = find.widgetWithText(ShadButton, '템플릿 적용');
expect(tester.widget<ShadButton>(applyButton).onPressed, isNotNull);
await tester.tap(applyButton);
await tester.pumpAndSettle();
expect(controller.steps, hasLength(2));
expect(controller.steps.first.approver.name, '1차 승인자');
expect(controller.steps.last.approver.name, '최종 승인자');
expect(applied.single.id, templateDetail.id);
});
}