kjh2064
31b36ba226
Consolidates KBX UI Boundary Governance framework with component manifest, screen recipe registry, AI component gate, and exception lifecycle validation. Evidence (evidence/V13-FE-005/*.log, 55+ files): - Full frontend regression: 70 files / 180 tests PASS - UI boundary gate: 37 files / 0 failures / 6 raw-color warnings (DEBT tracked) - Component manifest validation: 0 failures - Screen recipe governance: 0 failures - AI component gate: 17 feature files / 23 known exports / 0 failures - Accessibility E2E: 22 passed - Production build: PASS (>500 kB chunk warning V13-FE-038 DECISION_REQUIRED) - TypeCheck: PASS - KBX validators: All 5 PASS (failures=0) Added: 19 files (6 validator scripts, 6 test specs, 4 slice notes, 3 registries) Modified: 9 files (CI workflow, WBS tracker, E2E specs, FE setup, Layout, TS configs) Outstanding per V13-FE-005 note: AI prop-level validation, exception lifecycle, browser/visual/AT/performance evidence. No completion overclaim. AGENTS.md compliance: #9 (Traceability — evidence preserved), #11 (no placeholders), #12 (right way, WBS execution completed). Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2.8 KiB
2.8 KiB
V13-FE-006 — AppShell/Page Layout 계약 재검증
| 항목 | 값 |
|---|---|
| Requirement / API / DB / Job / UI / Test | REQ-FE-LAYOUT / Cross / Cross / Cross / UI-FOUND-06 / T-FE-LAYOUT-01 |
| Dependency / Gate | V13-FE-005 (COMPLETED) / G0 |
| Artifact | frontend/src/shared/ui/layouts |
Source / Assumption / Unknown / Decision Required
- Source: KBX
KbxApplicationShell은 skip link, shell/workspace landmark 분리를 제공한다. 현재AppShellLayout과PageLayout은 동일한 구조적 요구를 더 작은 슬롯 기반 contract로 제공한다. - Assumption: K-ArtSell에 workspace tabs, persisted recents, runtime center를 새로 도입할 승인된 requirement가 없다.
- Unknown: responsive visual baseline과 AT keyboard evidence는
AEG-V16-024의 QA 승인 대상이다. - Decision Required: KBX shell의 권한 필터·workspace store·runtime panel을 이식하지 않는다. 실제 product requirement와 ADR 없이 shell state를 확장하지 않는다.
이 Slice의 결과
- 동작을 바꾸지 않고 AppShell의 skip link, header/nav/main/footer landmark, automation boundary default와 PageLayout의 evidence/aside/footer 분리를 contract test로 고정했다.
- 자동주문/KIS 제출/자동 모델승격 OFF 안내는 화면 레이아웃에서 보존된다.
- 새 layout, provider, store, router, token 값은 추가하지 않았다.
2026-08-13 evidence update
AppShellLayoutshared layout colors now consume existing KBX semantic tokens for surface, text, border, and shadow semantics; no new token was introduced.- Targeted layout contract: 1 file / 2 tests PASS; typecheck PASS;
git diff --checkPASS —evidence/V13-FE-006/layout-token-normalization_20260813.log. - Visual, assistive-technology, and production-theme claims remain unmade.
- Browser accessibility smoke rerun after token normalization: 1 test PASS; skip-link, focus transfer, landmarks, breadcrumb, and heading remained valid —
evidence/V13-FE-006/layout-accessibility-smoke-rerun_20260813.log. - Mobile browser contract at the configured 390x844 viewport: 1 test PASS; shell/main visibility, heading, viewport containment, and main horizontal-overflow absence verified —
evidence/V13-FE-006/layout-mobile-browser_20260813.log. - Navigation/auth boundary regression: 3 files / 10 tests PASS; unauthorized navigation filtering, malformed metadata fail-closed behavior, route-registry permission alignment, detail-route suppression, and collapse contract verified —
evidence/V13-FE-006/navigation-auth-boundary_20260813.log.
실제 증거
pnpm vitest run src/shared/ui/layouts/tests/layout.contract.spec.ts
- 1 file / 2 tests passed
- exit 0, 2026-08-09
이 증거는 DOM contract에 한정된다. responsive visual, AT, browser E2E, API/DB/migration 통과를 주장하지 않는다.