# KBX v25 Validation Report

## 범위

- Fast Entry editing policy
- Excel-style multi-cell paste normalization
- Row Add / Duplicate / Fill Down
- Inline validation error navigation
- Context / Drill-down contract
- all-filtered selection
- applied search snapshot safety
- Search/Bulk filter parity
- PostgreSQL set-based bulk mutation + Audit + Outbox
- existing Template/Home/Interaction/Authorization/Deployment regression

## 추가 Gate

```text
validate-grid-productivity.mjs
```

검증 내용:

- Grid contract에 Editing/Paste/Bulk selection 타입이 존재하는가
- Paste utility가 Number/Date/Boolean normalization과 invalid preservation을 제공하는가
- DataGrid가 Add/Duplicate/Fill Down/Error Navigation/Drill-down/Context/all-filtered 이벤트를 제공하는가
- OMS-ORD-002가 실제 Fast Entry policy를 사용하는가
- OMS-ORD-001이 totalCount + all-filtered selection state를 사용하는가
- Bulk가 `appliedSearch` snapshot을 사용하는가
- UI `exceptionOnly`가 Backend Search SQL까지 연결되는가
- Ship Endpoint가 filter target + exclusions + set-based accepted/audit/outbox를 사용하는가
- Unit/E2E evidence가 존재하는가

## 런타임 테스트 주의

배포본에는 `node_modules`와 실행 중인 PostgreSQL/Web/API가 포함되지 않으므로 Vitest/Playwright 및 .NET runtime 테스트를 패키징 과정에서 실행했다고 주장하지 않는다.

대신 TypeScript/Vue syntax transpile과 전체 KBX static governance Gate를 실행하며, 실제 CI에서 의존성 설치 후 Vitest/Playwright/API/DB scenario를 수행할 수 있는 테스트 계약을 포함한다.

## 최종 Static Gate 결과

2026-08-08 기준 `node scripts/validate-kbx.mjs` 전체 통과.

| 항목 | v25 |
|---|---:|
| Design tokens | 109 |
| Component definitions | 77 |
| Core component APIs | 34 |
| Component catalog entries | 50 |
| Screen definitions | 19 |
| Navigation entries | 15 |
| Test scenarios | 19 |
| Fixture sets | 13 |
| API operations | 56 |
| Permissions | 50 |
| TypeScript/Vue script units | 269 |
| Golden screen coverage | 7 / 7 |
| DB migrations checked | 14 |
| Design debt | 366 / baseline 366 |
| Release impact | minor / declared minor |

추가 확인:

- T01~T09 Template/Home/Navigation completeness PASS
- Input/Search/Grid runtime interaction PASS
- Fast Entry/Paste/Fill Down/Error Navigation/all-filtered selection PASS
- OMS Search `exceptionOnly` UI↔Request↔SQL parity PASS
- OMS Ship filter bulk + exclusion + set-based Audit/Outbox static contract PASS
- Design/Figma parity PASS

## v24 대비 변경 규모

```text
신규 7 files
수정 29 files
삭제 0 files
```

디자인 하드코딩 부채는 기능 추가 후에도 `366`을 유지하여 ratchet을 악화시키지 않았다.
