# 재고 요약 데이터 재현 가이드 (프런트 참조)

> 백엔드 원본: `../superport_api_v2/doc/qa/inventory_data_replay.md` – QA/프런트 협업용 요약.

## 목적
- 스테이징/로컬에서 `/api/v1/inventory/summary` 계약을 검증할 때 동일한 데이터 세트를 확보한다.

## 순서 요약
1. **마이그레이션 실행**
   ```bash
   for file in migration/0*_*.sql migration/1*_*.sql; do
     psql "$DATABASE_URL" --set ON_ERROR_STOP=1 -f "$file"
   done
   ```
2. **QA 시드 재적재**
   ```bash
   psql "$DATABASE_URL" --set ON_ERROR_STOP=1 -f migration/120_seed_inventory_summary.sql
   ```
3. **마테뷰 리프레시**
   ```bash
   ../superport_api_v2/script/refresh_inventory_mv.sh --database-url "$DATABASE_URL"
   ```
4. **정합성 SQL**
   ```sql
   SELECT product_id, total_quantity,
          SUM((wb->>'quantity')::numeric) AS warehouse_sum
   FROM inventory_balance_snapshots
   CROSS JOIN LATERAL jsonb_array_elements(warehouse_balances) AS wb
   GROUP BY product_id, total_quantity
   HAVING SUM((wb->>'quantity')::numeric) <> total_quantity;
   ```
5. **API 스팟 체크**
   ```bash
   curl -H "Authorization: Bearer <token>" \
     "$API_BASE/api/v1/inventory/summary?page=1&page_size=50"
   ```

## 롤백
1. `DROP MATERIALIZED VIEW IF EXISTS inventory_balance_snapshots;`
2. `DROP MATERIALIZED VIEW IF EXISTS inventory_balance_events_view;`
3. 110/115 마이그레이션 재실행 → 리프레시 → 120 시드 재적재.

## 프런트 활용 팁
- QA가 위 절차로 데이터를 복원했다는 확인을 받은 뒤 UI/Golden 테스트를 실행한다.
- `last_refreshed_at` 값(응답 필드)을 QA 케이스에 기록해 자동 새로고침 UX 기준으로 활용한다.
