# KBX v26 Validation Report

## 범위

- T04 독립 Fast Entry Golden Screen
- T04 Lookup / Paste / Fill Down / Duplicate / Error Navigation
- T04 server-safe bulk save
- T04 Idempotency / Audit / Outbox
- T05 Master/Detail context retention
- T05 Location + Inventory History
- T05 quantity Drill-down Drawer
- Item Lookup authorization normalization
- Design token / Screen / API / Permission / Test manifest parity

## 최종 Static Gate

2026-08-08 기준:

```bash
node scripts/validate-kbx.mjs
```

전체 PASS.

| 항목 | v26 |
|---|---:|
| Design tokens | 112 |
| Component definitions | 77 |
| Core component APIs | 34 |
| Component catalog entries | 50 |
| Screen definitions | 20 |
| Navigation entries | 16 |
| Test scenarios | 21 |
| Fixture sets | 15 |
| Fixture refs | 36 |
| Golden screen coverage | 9 / 9 |
| API operations | 58 |
| Permissions | 52 |
| TypeScript/Vue script units | 275 |
| DB migrations checked | 15 |
| Design debt | 366 / baseline 366 |
| Release impact | major / declared major |

## 주요 결과

- `ERP-PRICE-001`이 실제 Screen/Route/Navigation/Help/API/Permission/Test 계약을 갖는 독립 T04 Golden Screen이 됨.
- `ERP-INV-001`은 단순 2-pane에서 품목 → Location → History → Drill-down으로 확장됨.
- 재조회 후 동일 품목이 남아 있으면 선택 Context를 복원함.
- Master/Detail split 수치는 CSS literal이 아니라 canonical design token으로 관리함.
- `effectiveDate`를 Field Dictionary에 추가하여 `orderDate` 등 다른 의미 Field를 재사용하지 않음.
- Item Lookup permission은 `erp.item.read`로 정규화함.
- Test Governance Golden coverage를 7/7에서 9/9로 확대함.
- 기능 추가 후에도 design-debt ratchet은 366을 유지함.

## Breaking change

`lookup.items.*` permission이 `oms.order.read` → `erp.item.read`로 변경되므로 Release Impact는 `major`다.

`docs/release/migration-guide.md`의 역할 매핑과 staging 검증을 배포 전에 수행해야 한다.

## 런타임 검증 주의

현재 배포 소스에는 `node_modules`가 없고 실행 중인 Web/API/PostgreSQL 환경이 없으며, 컨테이너에는 `.NET SDK`도 설치되어 있지 않다.

따라서 다음을 이번 패키징 단계에서 실제 실행했다고 주장하지 않는다.

- Vitest runtime
- Playwright browser runtime
- .NET compile / xUnit
- PostgreSQL migration/runtime scenario

대신 TypeScript/Vue syntax transpile과 KBX static governance 전체 Gate를 실행했으며, CI에서 위 런타임 테스트를 수행할 canonical scenario/fixture 계약을 포함한다.
