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

@@ -4,6 +4,11 @@ import 'package:mocktail/mocktail.dart';
import 'package:superport_v2/core/common/models/paginated_result.dart';
import 'package:superport_v2/core/network/api_error.dart';
import 'package:superport_v2/core/network/failure.dart';
import 'package:superport_v2/features/approvals/domain/entities/approval.dart';
import 'package:superport_v2/features/approvals/domain/entities/approval_draft.dart';
import 'package:superport_v2/features/approvals/domain/usecases/get_approval_draft_use_case.dart';
import 'package:superport_v2/features/approvals/domain/usecases/list_approval_drafts_use_case.dart';
import 'package:superport_v2/features/approvals/domain/usecases/save_approval_draft_use_case.dart';
import 'package:superport_v2/features/inventory/inbound/presentation/controllers/inbound_controller.dart';
import 'package:superport_v2/features/inventory/transactions/domain/entities/stock_transaction.dart';
import 'package:superport_v2/features/inventory/transactions/domain/entities/stock_transaction_input.dart';
@@ -23,20 +28,14 @@ class _MockTransactionLineRepository extends Mock
class _MockTransactionCustomerRepository extends Mock
implements TransactionCustomerRepository {}
class _FakeStockTransactionCreateInput extends Fake
implements StockTransactionCreateInput {}
class _MockSaveApprovalDraftUseCase extends Mock
implements SaveApprovalDraftUseCase {}
class _FakeStockTransactionUpdateInput extends Fake
implements StockTransactionUpdateInput {}
class _MockGetApprovalDraftUseCase extends Mock
implements GetApprovalDraftUseCase {}
class _FakeStockTransactionListFilter extends Fake
implements StockTransactionListFilter {}
class _FakeTransactionCustomerCreateInput extends Fake
implements TransactionCustomerCreateInput {}
class _FakeTransactionCustomerUpdateInput extends Fake
implements TransactionCustomerUpdateInput {}
class _MockListApprovalDraftsUseCase extends Mock
implements ListApprovalDraftsUseCase {}
void main() {
group('InboundController', () {
@@ -47,13 +46,31 @@ void main() {
late InboundController controller;
setUpAll(() {
registerFallbackValue(_FakeStockTransactionCreateInput());
registerFallbackValue(_FakeStockTransactionUpdateInput());
registerFallbackValue(_FakeStockTransactionListFilter());
registerFallbackValue(_FakeTransactionCustomerCreateInput());
registerFallbackValue(_FakeTransactionCustomerUpdateInput());
registerFallbackValue(
StockTransactionCreateInput(
transactionTypeId: 0,
transactionStatusId: 0,
warehouseId: 0,
transactionDate: DateTime(2000, 1, 1),
createdById: 0,
approval: StockTransactionApprovalInput(requestedById: 0),
),
);
registerFallbackValue(
StockTransactionUpdateInput(transactionStatusId: 0),
);
registerFallbackValue(StockTransactionListFilter());
registerFallbackValue(TransactionCustomerCreateInput(customerId: 0));
registerFallbackValue(TransactionCustomerUpdateInput(id: 0));
registerFallbackValue(<TransactionCustomerCreateInput>[]);
registerFallbackValue(<TransactionCustomerUpdateInput>[]);
registerFallbackValue(const ApprovalDraftListFilter(requesterId: 0));
registerFallbackValue(
ApprovalDraftSaveInput(
requesterId: 0,
steps: [ApprovalDraftStep(stepOrder: 0, approverId: 0)],
),
);
});
setUp(() {
@@ -81,6 +98,7 @@ void main() {
warehouseId: 3,
transactionDate: DateTime(2024, 3, 1),
createdById: 9,
approval: StockTransactionApprovalInput(requestedById: 9),
);
final record = await controller.createTransaction(
@@ -91,6 +109,7 @@ void main() {
expect(record.id, equals(transaction.id));
expect(controller.records.length, equals(1));
expect(controller.records.first.id, equals(transaction.id));
expect(controller.approvalDraft?.requestedById, equals(9));
verify(() => transactionRepository.create(any())).called(1);
});
@@ -111,6 +130,7 @@ void main() {
warehouseId: 3,
transactionDate: DateTime(2024, 3, 1),
createdById: 9,
approval: StockTransactionApprovalInput(requestedById: 9),
),
refreshAfter: false,
);
@@ -149,6 +169,7 @@ void main() {
warehouseId: 3,
transactionDate: DateTime(2024, 3, 1),
createdById: 9,
approval: StockTransactionApprovalInput(requestedById: 9),
),
refreshAfter: false,
);
@@ -197,6 +218,107 @@ void main() {
verify(() => customerRepository.addCustomers(42, any())).called(1);
});
test('updateApprovalDraft와 clearApprovalDraft가 초안을 관리한다', () {
final approval = StockTransactionApprovalInput(
requestedById: 55,
approvalStatusId: 7,
note: '메모',
);
controller.updateApprovalDraft(approval);
expect(controller.approvalDraft?.requestedById, equals(55));
expect(controller.approvalDraft?.approvalStatusId, equals(7));
controller.clearApprovalDraft();
expect(controller.approvalDraft, isNull);
});
test('updateApprovalDraft는 서버 초안을 동기화한다', () async {
final saveUseCase = _MockSaveApprovalDraftUseCase();
when(() => saveUseCase.call(any())).thenAnswer(
(_) async => ApprovalDraftDetail(
id: 1,
requesterId: 3,
savedAt: DateTime.utc(2025, 1, 1),
payload: ApprovalDraftPayload(steps: const []),
),
);
final controllerWithSave = InboundController(
transactionRepository: transactionRepository,
lineRepository: lineRepository,
customerRepository: customerRepository,
lookupRepository: lookupRepository,
saveDraftUseCase: saveUseCase,
);
final approval = StockTransactionApprovalInput(
requestedById: 3,
approvalStatusId: 2,
steps: [ApprovalStepAssignmentItem(stepOrder: 1, approverId: 4)],
);
controllerWithSave.updateApprovalDraft(approval);
await Future<void>.delayed(Duration.zero);
verify(() => saveUseCase.call(captureAny())).called(1);
});
test('loadApprovalDraftFromServer는 원격 초안을 반영한다', () async {
final listUseCase = _MockListApprovalDraftsUseCase();
final getUseCase = _MockGetApprovalDraftUseCase();
final summary = ApprovalDraftSummary(
id: 5,
requesterId: 3,
status: ApprovalDraftStatus.active,
savedAt: DateTime.utc(2025, 1, 2),
sessionKey: 'inventory_inbound_3',
stepCount: 1,
);
when(() => listUseCase.call(any())).thenAnswer(
(_) async => PaginatedResult<ApprovalDraftSummary>(
items: [summary],
page: 1,
pageSize: 10,
total: 1,
),
);
final detail = ApprovalDraftDetail(
id: summary.id,
requesterId: 3,
savedAt: DateTime.utc(2025, 1, 2),
payload: ApprovalDraftPayload(
metadata: const {
'_client_state': {'status_id': 6},
},
steps: [ApprovalDraftStep(stepOrder: 1, approverId: 9)],
),
);
when(
() => getUseCase.call(id: summary.id, requesterId: 3),
).thenAnswer((_) async => detail);
final controllerWithDrafts = InboundController(
transactionRepository: transactionRepository,
lineRepository: lineRepository,
customerRepository: customerRepository,
lookupRepository: lookupRepository,
getDraftUseCase: getUseCase,
listDraftsUseCase: listUseCase,
);
await controllerWithDrafts.loadApprovalDraftFromServer(requesterId: 3);
verify(() => listUseCase.call(any())).called(1);
verify(() => getUseCase.call(id: summary.id, requesterId: 3)).called(1);
final approval = controllerWithDrafts.approvalDraft;
expect(approval, isNotNull);
expect(approval!.requestedById, 3);
expect(approval.approvalStatusId, 6);
expect(approval.steps, hasLength(1));
});
test('submitTransaction은 refreshAfter가 true일 때 목록을 다시 불러온다', () async {
final filter = StockTransactionListFilter(transactionTypeId: 1);
final initial = _buildTransaction();