Files
KArtSell.Aegis/docs/Design/kbx-foundation-v36/docs/kbx-v34-standard-traceability.md
T

3.0 KiB

KBX v34 Standard Traceability

목적

v34 구현을 KBX Business UX/AX Standard, Design System, Reference Screens, Implementation Contract의 요구사항과 연결한다.

Standard intent v34 implementation Verification
T01~T09 표준 Template 중심 kbxTemplateManifest.coreComponents 폐쇄성 검사 v34 validator
Component 상태 독립 재현 20개 Template core component 모두 Manifest + Catalog Scenario 보유 v34 validator
Lookup F2/Enter/Esc/Focus Lookup async guard, explicit error/empty, paging, keyboard, focus restore unit/static gate
Primitive → Business Component 계층 LookupDialog, ExceptionDrawer가 KbxDialog/KbxDrawer/KbxButton 사용 v34 validator
Excel Import 공통 UX file preflight, 1:1 mapping, required mapping, session isolation, commit confirm, partial/failure states import guard tests + v34 gate
Excel 직접 DB insert 금지 Client guard는 UX 전용이며 staging/server validation 계약 유지 architecture contract
Permission UX Exception/AI가 Permission Host 자동 소비 v34 validator
Backend permission final enforcement UI Permission은 defense-in-depth로 제한 authorization gate
AI Structured Proposal proposal validation state + permission guard v34 validator
AI hallucination 방어 Apply 전에 validated state 요구 가능, Domain validation 최종 책임 유지 contract/static gate
WMS scanner duplicate UX bounded buffer + short duplicate debounce + camera/manual/wedge source barcode guard tests
WMS idempotency Client debounce가 server idempotency를 대체하지 않음 architecture/integration contract
Home actionable navigation pinned/open 분리, invalid module filter recovery, aria-live result count v34 validator
Navigation security v31~v33 path normalization, encoded traversal/control/length rules 유지 historical gates
기술부채 ratchet hard-coded design literal 131 baseline design-debt gate
재현성/Versioning Foundation 34 / Contract 1.20.0 / release mode 기록 release governance

Core Component Closure

v34에서 Template core component 집합은 20개이며 모두 다음 세 계층에 존재해야 한다.

Template coreComponents
  ∩ Component Manifest
  ∩ Component Catalog

누락은 CI validation failure로 취급한다.

보안 경계

Frontend 보강:

  • stale async lookup result 차단
  • oversized barcode buffer 차단
  • import mapping 중복/누락 preflight
  • permissioned exception/AI action guard
  • navigation/preference 입력 sanitization 유지

Backend 최종 책임:

  • permission
  • entity existence
  • business rule
  • concurrency
  • database constraint
  • import staging/commit
  • idempotency
  • AI structured proposal revalidation

과유불급 원칙

v34는 자체 Grid/DatePicker/Low-code runtime builder를 만들지 않는다. 기존 PrimeVue/AG Grid 기반 KBX 계층을 강화하며, 업무 화면별 특수 Rule은 Vertical Slice와 Domain에 남긴다.