kjh2064/KArtSell.Aegis
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
3f2a254c3d73b4e99fbf75fc4a7d61ffbcb458fc
KArtSell.Aegis/docs/Design/kbx-foundation-v60-status-canonical-contract-hardening/apps/web/fe-reference/README.md
T
kjh2064 3f293d8aa8
deploy / deploy (push) Successful in 1m52s
Details
deploy / notify (push) Successful in 1s
Details
V13-FE-006: consolidate approved UI and contract hardening
2026-08-13 02:41:00 +09:00

6.4 KiB
Raw Blame History

KBX FE Reference Lab v55

v55는 T01~T09 Reference 중 T08/T09의 운영 Truth를 강화한다.

  • T08: 6단계 파일/매핑/검증/미리보기/반영/결과, 검증 오류 첫/다음 Focus 이동
  • T09: Scan buffer와 최근 서버 확인 Scan을 분리하고 Offline에서는 authoritative mutation을 차단
  • 기존 Home/T02/T04/T05 v54 work-surface regression을 유지
  • Light/Dark/forced-colors와 strict CSP 경계를 유지

KBX FE Reference Lab v53

Backend/API 없이 브라우저에서 즉시 실행하는 KBX 업무 UI 원형이다. 목적은 별도 Demo UI를 만드는 것이 아니라 T01~T09의 실제 HTML/CSS/JavaScript 상호작용, Theme State, Keyboard, Recovery, WMS Mobile을 빠르게 재현하는 것이다.

v53 Golden Screen Interaction QA

  • Home module rail에 화면/확인필요/즐겨찾기/열린업무 Context를 함께 표시
  • ArrowLeft/ArrowRight/Home/End로 module rail을 mouse 없이 탐색
  • module 선택 후 Work Explorer로 scroll + focus landing
  • Vue Home과 동일한 module attention pressure를 JavaScript Reference에서도 계산
  • :focus-visible과 forced-colors active cue 유지
  • Reference는 Domain Commit을 흉내 내지 않으며 Server/Domain truth 경계를 유지
  • 정적 계약 증적: scripts/validate-fe-golden-interaction-v53.mjs

실행

cd apps/web/fe-reference
python3 -m http.server 4173

운영 Domain을 흉내 내는 제품이 아니다. Permission, Domain Validation, DB Commit, Audit, Concurrency, Idempotency는 Server 최종 책임이다.

v50 Operational Truth / Home Overflow QA

  • Home Attention 기본 8개, 최대 priority surface 24개
  • 총 건수 >24이면 전체 보기라고 과장하지 않고 우선 24개 보기
  • 남은 항목은 작업 센터 전체 / 알림 센터 전체로 이동
  • Work Center open → Esc close → Home trigger Focus restore
  • KBX Business Light/Dark에서 동일한 Label/Action/Focus 유지
  • 실제 Template 코드의 non-retryable error는 [다시 시도]를 숨기는 공통 계약을 사용
  • 증적: docs/evidence/v50-browser-operational-truth.json (16/16)
  • Preview: previews/v50-home-overflow-dark-1440x900.png

v46 검증 범위

  • KBX Business Light / Dark + Forced Colors 의미 체계 유지
  • clean Workspace 위치만 sessionStorage에 복원
  • Query/Hash/Dirty Form·Grid 값은 session snapshot에서 제외
  • 복원 tab ↺ + Home 복원 표시, 실제 진입 시 resumed marker 제거
  • Home/no-active-tab 상태에서도 첫 Workspace Tab keyboard entry 보장
  • Storage API 차단 시 Preference/Resume 없이 fail-soft 기동
  • T09 WMS common state boundary의 Error → [작업 다시 불러오기] recovery loop
  • Browser Reference QA 20/20: clean resume, dirty exclusion, Dark Theme, 1280px overflow, runtime error 0

v44 검증 범위

  • KBX Business Light / Dark semantic theme
  • Windows Forced Colors system-color fallback
  • Home: 확인 필요 → 바로 시작 → 모듈별 업무
  • Header: 작업/알림 비모달 System Panel, Esc, Focus Restore
  • Help/AI/Suggestion/Detail: Drawer contract 유지
  • T01: 검색 → Loading/Empty/Error/Ready → 선택/Bulk/Drawer → Empty 복구
  • T02: Master CRUD + Dirty Guard + Lookup
  • T03: Header/Detail + Validation-safe F8
  • T04: Fast Entry/Paste/Fill Down
  • T05: Master→Location→재고이력
  • T06: Actionable Queue
  • T07: Reconcile/Resolution
  • T08: Excel Import + Background Job
  • T09: 390×844 WMS Mobile + Scanner/Network/Duplicate Guard

Theme 원칙

Light/Dark는 표현 모드이며 업무 상태나 Permission의 Source of Truth가 아니다. Forced Colors가 활성화되면 OS Canvas, CanvasText, Highlight, LinkText를 우선한다. Theme 변경으로 Layout/Density/Keyboard 문법을 변경하지 않는다.

QA 증적

  • previews/v44-home-light-1440x900.png
  • previews/v44-home-dark-1440x900.png
  • previews/v44-runtime-panel-dark-1440x900.png
  • previews/v44-t01-dark-1440x900.png
  • previews/v44-t01-forced-colors-1440x900.png
  • previews/v44-t09-dark-390x844.png
  • docs/evidence/v44-theme-state-browser.json — 14/14
  • docs/evidence/v44-browser-matrix.json — 28/28

실행환경의 localhost/file navigation 제약 때문에 Browser QA는 동일 HTML/CSS/JS asset을 Playwright inline harness로 실행했다. 실제 Vue/Vite/PrimeVue/AG Grid runtime E2E와 혼동하지 않는다.

검증

node scripts/validate-fe-reference.mjs
node scripts/validate-fe-state-navigation-v44.mjs
node scripts/validate-kbx.mjs

v45 Safe Preference QA

  • T01 기본조건 저장, 마지막 조회조건 기억 실제 JavaScript 동작
  • 판매채널/상태/오류유형만 저장하고 자유검색어는 저장하지 않음
  • 저장값 allow-list 복원, 잘못된 값은 기본값으로 복구
  • Light/Dark Theme와 개인화 UI 동시 검증
  • 증적: docs/evidence/v45-browser-preference-theme.json (14/14)

v46 Safe Workspace Resume QA

  • clean Workspace tab만 sessionStorage 복원
  • Query/Hash, Dirty Form/Grid 값은 복원 snapshot에서 제외
  • Home 바로 시작에 복원 상태 표시
  • active tab이 없는 Home에서도 첫 Workspace tab tabindex=0
  • Storage API 차단 시 Home/Shell fail-soft
  • KBX Business Light/Dark와 resume marker semantic parity
  • 증적: docs/evidence/v46-browser-resume-theme.json (20/20)
  • Preview: previews/v46-home-resume-dark-1440x900.png

v47 Actionable Problem

T01에서 예외 주문을 선택해 출고지시하면 업무규칙 Problem을 인라인으로 표시하고 문제 N건만 선택으로 복구한다. 단순 성공 Toast로 거짓 완료시키지 않는다. Light/Dark는 동일 semantic state를 사용한다.

v48 Template Completion QA

  • T05 재고현황: 실제 창고/품목 검색, Loading, Empty, 조건 초기화, Master→Location→History
  • T06 작업 Queue: 실제 작업자/통합검색/빠른필터, Selection, Empty Recovery
  • T07 Reconcile: 실제 검색/불일치 필터, Selection, Reference 재처리 상태변경
  • T08 Excel Import: 실제 Browser File input/Drop, .xlsx/.xls/20MB guard, 6-step visual flow
  • Search Panel의 조회 버튼은 Enter/F3뿐 아니라 Mouse click도 동일 실행 경로를 사용한다.
  • KBX Business Light/Dark semantic theme는 동일 업무 상태와 조작 계약을 유지한다.
  • Browser 증적: docs/evidence/v48-browser-template-completion.json (30/30)
  • Preview: previews/v48-t05-inventory-dark-1440x900.png, previews/v48-t08-file-dark-1440x900.png
Reference in New Issue View Git Blame Copy Permalink