# KBX v13 — `quantity` → `orderQty` OMS Migration

## 배경

OMS 주문 상세에서 일반적인 `quantity`와 주문 의미가 명확한 `orderQty`가 혼용되었다.
KBX 표준의 동일 개념/동일 FieldKey 원칙에 따라 OMS 주문 입력·Excel·Validation은 `orderQty`로 정규화한다.

## Frontend

신규 payload:

```json
{
  "orderQty": 10
}
```

Grid/Zod/Error field도 `orderQty`를 사용한다.

## Backend 호환성

v13 `RegisterOrderLineRequest`는 일시적으로 다음 둘을 수용한다.

```text
orderQty  -> canonical
quantity  -> v12 legacy input
```

Server는:

```text
orderQty ?? quantity
```

순서로 해석한다.

DB column `oms.order_lines.quantity`는 이번 변경 대상이 아니다.
Field Dictionary는 UX/API 의미 계약이며 DB physical naming을 강제하지 않는다.

## 제거 조건

legacy `quantity` wire input 제거는 다음 조건을 충족한 별도 Breaking Release에서만 수행한다.

- 구 Client 사용량 0 확인
- API 소비자 공지
- Migration Guide
- Major change declaration
- Contract/E2E Test 갱신
