docs: Stage 5/7 완료 정리 및 환경 변수 가이드 갱신

README.md

@@ -17,6 +17,8 @@
 
 - `API_BASE_URL` — 백엔드 API 베이스 URL
 - `FEATURE_*` — 기능 플래그 (예: `FEATURE_VENDORS_ENABLED`)
+- `FEATURE_APPROVALS_ENABLED` — 기본값은 개발·운영 모두 `true`, 단 결재 백엔드가 준비되지 않았으면 `.env.*`에서 `false`로 내려 임시 비활성화한다.
+- `FEATURE_STOCK_TRANSITIONS_ENABLED` — 재고 상태 전이(상신/승인/취소) 버튼 노출 제어. 운영 환경은 백엔드 배포 전까지 `false`로 유지하고, 개발 환경에서만 필요 시 `true`로 전환한다.
 
 2) 의존성 설치
 
@@ -30,6 +32,24 @@ 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/` — 공통 구성(환경, 네트워크, 라우팅)