feat(inventory): 재고 현황 요약/상세 플로우를 릴리스

- lib/features/inventory/summary 계층과 warehouse select 위젯을 추가해 목록/상세, 자동 새로고침, 필터, 상세 시트를 구현

- PermissionBootstrapper, scope 파서, 라우트 가드로 inventory.view 기반 권한 부여와 메뉴 노출을 통합(lib/core, lib/main.dart 등)

- Inventory Summary API/QA/Audit 문서와 PR 템플릿, CHANGELOG를 신규 스펙과 검증 커맨드로 업데이트

- DTO 직렬화 의존성을 추가하고 Golden·Widget·단위 테스트를 작성했으며 flutter analyze / flutter test --coverage를 통과
This commit is contained in:
JiWoong Sul
2025-11-09 01:13:02 +09:00
parent 486ab8706f
commit 47cc62a33d
72 changed files with 5453 additions and 1021 deletions

View File

@@ -0,0 +1,37 @@
# 재고 요약 감사 로그 · Slack 알림 계획
> 원본 정의: `../superport_api_v2/doc/inventory_summary_audit_plan.md` 프런트에서도 동일 정책을 참조하도록 요약본을 유지한다.
## 이벤트 개요
- 엔드포인트: `GET /api/v1/inventory/summary`, `GET /api/v1/inventory/summary/{product_id}`
- 이벤트 코드: `inventory.summary.viewed` (version `1.0`)
- 발행 채널: Kafka(선택), WebSocket(`AuditEventStream`)
### Payload
| 필드 | 설명 |
| --- | --- |
| `actor_id` | 요청자 ID |
| `filters` | `page`, `page_size`, `warehouse_id`, `include_empty`, `sort`, `order`, `updated_since`, `event_limit`, `product_id` |
| `result_count` | 목록: `items.len()`, 단건: `recent_events.len()` |
| `request_id` | 서버가 채번한 마이크로초 기반 상관관계 키 |
| `emitted_at` | UTC 기준 발행 시각 |
프런트는 필터 UI 상태를 서버와 동일하게 유지해 감사 로그와 UX 간 불일치가 없도록 한다.
## Slack / PagerDuty 라우팅
| 시나리오 | 채널 | 레벨 |
| --- | --- | --- |
| 정상 조회 | `#inventory-monitoring` (옵션) | INFO |
| 권한 부족 (`INVENTORY_SCOPE_REQUIRED`) | `#inventory-alerts` | WARN / 5분 내 5회 → PagerDuty Low |
| 스냅샷 지연 (`INVENTORY_SNAPSHOT_NOT_READY`) | `#inventory-alerts` | INFO / 10분 지속 → PagerDuty Medium |
| 정합성 실패·데이터 불일치 | `#inventory-critical` | ERROR / 즉시 PagerDuty High |
프런트 액션:
- 권한 부족 시 AlertDialg + Slack 알림에 포함될 수 있는 컨텍스트(`filters`,`actor_id`)를 명시.
- 스냅샷 지연 오류에서는 사용자에게 뷰 리프레시 절차 안내 메시지를 출력.
## 운영 체크리스트
1. 배포 직후 `script/refresh_inventory_mv.sh --database-url "$DATABASE_URL"` 실행 기록을 Ops에 공유.
2. Slack 로그 샘플을 QA와 함께 캡처해 PR에 첨부.
3. 감사 이벤트 미수신 시 `AuditEventStream` 구독자 상태(프론트 Admin 콘솔) 확인.
4. 월 1회 Ops와 정책 재검토, 필요 시 PagerDuty 라우팅/임계값 갱신.