KArtSell.Aegis/docs/Design/README.md

KBX Design Philosophy — Reference Index

이 디렉터리의 4개 문서는 K-ArtSell Aegis 프론트엔드가 채택하는 디자인 철학 소스다. docs/Design/kbx-foundation-v36/은 이 문서를 구현한 참조 코드(도메인은 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 T01T09 ↔ K-ArtSell T01T12)

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 §38, §5859 규격대로 구현한다. 세부 계획은 이식 작업 당시의 계획 문서를 참고(리포지토리 커밋 이력의 V13-FE-007~010 참고).