# KBX Design Philosophy — Reference Index

이 디렉터리의 4개 문서는 K-ArtSell Aegis 프론트엔드가 채택하는 **디자인 철학 소스**다. `docs/Design/kbx-foundation-v60-status-canonical-contract-hardening/`은 이 문서를 구현한 최신 참조 코드(도메인은 OMS/WMS/ERP로 다르지만 UX 계약은 동일)이며, 이식 대상이 아니라 구현 참고용이다.

## 문서 역할

| 문서 | 역할 |
|---|---|
| `KBX Design System v1.0.md` | Primitive → Business Component → Screen Template 3계층, Design Token 체계(spacing/typography/color/density), 컴포넌트별 API 계약 |
| `KBX Business UX-AX Standard v1.0.md` | 7대 설계원칙(Familiar First, Keyboard Accelerated, Grid First, Exception Driven, Predictable Layout, Explicit State, Audit by Default), Desktop 표준 화면 구조, T01~T09 표준 Screen Template, Workspace Tabs/Unsaved Changes 규칙 |
| `KBX Reference Screens v1.0.md` | Global Application Shell 치수(Header 56px / Side Nav 220px / Workspace Tabs 40px / Page Header 48px / Command Bar 44px), 화면별 목업 |
| `KBX Implementation Contract v1.0.md` | Screen ID 규칙, Command/Lookup/Grid 계약, Keyboard Manager 상세 API |

## K-ArtSell 적용 원칙

- Vertical Slice(업무 모듈)는 업무를 구현하고, 공통 계층(`frontend/src/shared/`)은 UX를 구현한다 (Design System §1).
- 신규 공통 컴포넌트는 `Kbx*`가 아니라 이미 채택된 `Ks*` 접두사를 따른다(`V13-FE-005`).
- Design Token은 `--kbx-*`가 아니라 기존 `--ks-*` 네임스페이스에 통합한다(`design-system/tokens.css`).

## Screen Template 재매핑 (KBX T01~T09 ↔ K-ArtSell T01~T12)

K-ArtSell은 `frontend/src/shared/ui/screen-types/catalogue.ts`에서 KBX 템플릿을 금융 자문 도메인 의미로 재정의했다. 번호는 KBX 원본과 일치하지 않는다.

| KBX (OMS/WMS/ERP 의미) | K-ArtSell 번호 | K-ArtSell 의미 |
|---|---|---|
| T01 Search/List | T01 | 검색·목록형 CRUD |
| T02 Master CRUD | T03 | 등록·편집 Form |
| T03 Header+Detail Transaction | T04 / T06 | Master-Detail / 단계 Wizard |
| T04 Fast Grid Entry | **T11 (신규)** | 대량 입력 |
| T05 Master/Detail Explorer | T04 | Master-Detail |
| T06 Work Queue | **T12 (신규)** | 작업 큐 |
| T07 Reconcile/Verification | T09 | 대사·예외 처리 |
| T08 Excel Import | — (범위 밖) | 데이터 유입이 KRX/OpenDart/KIS API 중심이라 미채택 |
| T09 WMS Mobile | — (해당 없음) | 물류 현장 업무 없음 |
| — | T02 | 상세 조회형 (KBX에 없는 K-ArtSell 고유 타입) |
| — | T05 | 검토·승인 Workbench (maker-checker) |
| — | T07 | Dashboard·Scorecard |
| — | T08 | Batch·데이터 운영 |
| — | T10 | 버전 비교·거버넌스 (모델/정책 승격) |

## 셸/홈/워크스페이스 이식 현황

`frontend/src/shared/shell/`에 Global Header · Side Navigation · Workspace Tabs · Ctrl+K 메뉴검색을 Business UX-AX Standard §3~8, §58~59 규격대로 구현한다. 세부 계획은 이식 작업 당시의 계획 문서를 참고(리포지토리 커밋 이력의 `V13-FE-007~010` 참고).
