# KBX Performance Budget v9

KBX 성능 목표는 페이지 Lighthouse 점수가 아니라 **업무 중단시간**을 줄이는 데 초점을 둔다.

| 구간 | 초기 목표 | 의미 |
|---|---:|---|
| 키보드/Focus 로컬 피드백 | 100ms 이내 | 숙련자의 연속입력이 끊기지 않음 |
| Lookup 검색 P95 | 500ms 이내 | F2/코드검색이 대화형으로 느껴짐 |
| 일반 필터 조회 P95 | 2초 이내 | 사용자가 재조회 버튼을 중복 클릭하지 않음 |
| WMS 서버확정 Scan P95 | 500ms 이내 | 현장 Scanner 리듬 유지 |
| Foreground 처리 | 3초 이내 권장 | 초과 시 Job/Operation Center 검토 |

## 데이터 크기 검증

최소 다음 구간을 별도 측정한다.

- Grid 100 / 1,000 visible result paging
- 검색대상 100k / 1m / 10m row
- Excel 10k / 50k / 100k row
- Bulk command 100 / 1k / 10k 대상
- WMS 연속 100 scan

## 금지

- Frontend에서 대량 전체 데이터 다운로드 후 필터
- Lookup 전체 Master preload
- Grid 화면을 위해 N+1 API 호출
- 조회 성능 문제를 무조건 DB 역정규화로 해결
- 3초 이상 작업 동안 modal spinner로 사용자 고정

먼저 Read Projection, Index, Query Plan, Pagination, Batch Resolve를 사용하고 실제 측정 뒤 역정규화를 결정한다.
