259b056072
- 입고 레코드에 파트너 식별자와 고객 요약을 캐싱하고 상세 칩으로 노출 - 입고 등록 모달에서 파트너 선택 복원과 고객 동기화를 지원하며 취소 시 상세를 복귀하도록 수정 - 재고 컨트롤러에 고객 동기화 유틸리티와 결재 상태 로딩을 추가하고 단위 테스트를 확장 - 제품·파트너 자동완성 위젯을 재작성해 초기 로딩, 검색, 외부 컨트롤러 동기화를 안정화 - 재고 상세/공통 모달 닫기와 출고·대여 편집 모달의 네비게이터 호출을 루트 기준으로 통일 - 테스트: flutter analyze, flutter test (기존 레이아웃 검증 케이스 실패 지속)
Superport v2
간단 입·출고 + 결재 시스템(웹) UI.
환경 설정
- 환경 파일 준비 (.env)
루트에 다음 파일을 생성하세요(예시 제공):
.env.development→ 개발 환경.env.production→ 운영 환경
*.example 파일을 복사하여 값을 채우면 됩니다.
핵심 키:
API_BASE_URL— 백엔드 API 베이스 URLFEATURE_*— 기능 플래그 (예:FEATURE_VENDORS_ENABLED)FEATURE_APPROVALS_ENABLED— 기본값은 개발·운영 모두true, 단 결재 백엔드가 준비되지 않았으면.env.*에서false로 내려 임시 비활성화한다.FEATURE_STOCK_TRANSITIONS_ENABLED— 재고 상태 전이(상신/승인/취소) 버튼 노출 제어. 운영 환경은 백엔드 배포 전까지false로 유지하고, 개발 환경에서만 필요 시true로 전환한다.
- 의존성 설치
flutter pub get
- 개발 실행 (웹)
flutter run -d chrome --web-renderer canvaskit --dart-define=ENV=development
API 연동
- 모든 HTTP 호출은
ApiRoutes.apiV1(/api/v1) 프리픽스를 사용하며,Environment.initialize()완료 후ApiClient를 통해 수행한다. - 현재 연동된 주요 리소스
/customers,/vendors,/products,/uoms,/users,/groups,/menus,/group-menu-permissions/warehouses,/transaction-types,/transaction-statuses,/approval-statuses,/approval-actions/approvals,/approval-steps,/approval-templates,/approval-histories/stock-transactions(lines/customers 포함),/reports/downloads/zipcodes(우편번호 검색)
- API 응답 실패는
Failure.describe()를 통해 토스트/다이얼로그로 노출되며, 필드 검증 오류와 일반 메시지를 자동 병합한다.
필수 환경 변수
ENV—development/production중 하나로.env.<env>파일을 선택API_BASE_URL— 서버 베이스 URL (/api/v1제외)FEATURE_*— 도메인별 기능 플래그 (FEATURE_APPROVALS_ENABLED,FEATURE_PRODUCTS_ENABLED등)PERMISSION__<resource>— 권한 게이트에서 사용할 리소스별 액션 집합(예:PERMISSION__stock-transactions=read,submit,approve)
구조
lib/core/— 공통 구성(환경, 네트워크, 라우팅)lib/features/<domain>/— 기능별 폴더 (clean architecture: domain/data/presentation)lib/widgets/— 공용 위젯
빌드/검증
flutter analyze— 정적 분석flutter test— 단위/위젯 테스트