V13-FE-006: consolidate approved UI and contract hardening

2026-08-13 02:41:00 +09:00
parent d79edae546
commit 3f293d8aa8
1278 changed files with 14384 additions and 1664 deletions
@@ -0,0 +1,31 @@
+# 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를 사용하고 실제 측정 뒤 역정규화를 결정한다.