KArtSell.Aegis/docs/Design/kbx-foundation-v60-status-canonical-contract-hardening/README.md

KBX Foundation v60 — Status Canonical Contract Hardening

핵심

v60은 상태 Chip을 더 만드는 릴리스가 아니다. v59에서 만든 Status Dictionary를 Backend/API canonical value → FE Catalog → Grid/Filter/Drawer/Workflow → Demo/Static Reference까지 하나의 계약으로 닫는다.

• OMS 주문 Aggregate API는 DRAFT / CONFIRMED / ALLOCATED / PICKING / CHECKED / SHIPPED canonical code를 반환한다.
• 한국어 작성 / 확정 / 출고완료는 API 상태값이 아니라 FE Status Catalog의 display label이다.
• 신규 주문의 저장 전 상태는 FE-local NEW, 첫 저장 성공 이후 서버 상태는 DRAFT다.
• 주문 Search Select와 URL/저장조건 검증은 Grid와 같은 shipment Status Catalog를 사용한다.
• Demo Order Projection은 shipmentStatus 하나만 Source of Truth로 사용한다.
• Static HTML/JavaScript Reference도 canonical raw + familiar display를 동일하게 재현한다.
• 과거 한국어 display value로 저장된 Static Reference 검색조건은 canonical value로 안전하게 migration한다.

QA

node scripts/validate-kbx.mjs와 node scripts/validate-status-canonical-v60.mjs로 계약을 검증한다. Browser Runtime은 lockfile/node_modules/registry 접근이 확보되기 전까지 별도 Runtime readiness에서 PASS로 간주하지 않는다.