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

@@ -1,6 +1,8 @@
import 'package:flutter/foundation.dart';
import 'package:flutter_dotenv/flutter_dotenv.dart';
import 'package:superport_v2/core/config/feature_flags.dart';
/// 환경 설정 로더
///
/// - .env.development / .env.production 파일을 로드하여 런타임 설정을 주입한다.
@@ -57,6 +59,7 @@ class Environment {
}
baseUrl = dotenv.maybeGet('API_BASE_URL') ?? 'http://localhost:8080';
FeatureFlags.initialize();
_loadPermissions();
}

View File

@@ -0,0 +1,75 @@
import 'package:flutter_dotenv/flutter_dotenv.dart';
/// 기능 토글을 중앙에서 관리한다.
///
/// - `Environment.initialize` 후 `FeatureFlags.initialize()`가 호출되어야 한다.
/// - 백엔드의 `feature.*` 키와 기존 `FEATURE_*` 키를 모두 지원한다.
class FeatureFlags {
FeatureFlags._();
static final Map<String, bool> _values = {};
/// 승인 화면 노출 여부.
static bool get approvalsEnabled => _values['approvals_enabled'] ?? false;
/// 재고 전표 화면 노출 여부.
static bool get stockTransitionsEnabled =>
_values['stock_transitions_enabled'] ?? false;
/// Approval Flow v2 기능 토글.
static bool get approvalFlowV2 => _values['approval_flow_v2'] ?? false;
/// 기능 토글을 환경 변수에서 읽어 초기화한다.
static void initialize() {
_values
..clear()
..addAll({
'approvals_enabled': _readFlag(
'FEATURE_APPROVALS_ENABLED',
defaultValue: false,
),
'stock_transitions_enabled': _readFlag(
'FEATURE_STOCK_TRANSITIONS_ENABLED',
defaultValue: true,
),
'approval_flow_v2': _readFlag(
'FEATURE_APPROVAL_FLOW_V2',
aliases: const ['feature.approval_flow_v2'],
defaultValue: false,
),
});
}
/// 논리 키 기반으로 토글 값을 조회한다.
static bool isEnabled(String logicalKey) =>
_values[logicalKey.toLowerCase()] ?? false;
static bool _readFlag(
String key, {
bool defaultValue = false,
List<String> aliases = const [],
}) {
for (final candidate in <String>{key, ...aliases}) {
final raw = dotenv.maybeGet(candidate);
if (raw == null) {
continue;
}
final normalized = raw.trim().toLowerCase();
switch (normalized) {
case '1':
case 'y':
case 'yes':
case 'true':
return true;
case '0':
case 'n':
case 'no':
case 'false':
return false;
default:
continue;
}
}
return defaultValue;
}
}