# 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

- `AppShellLayout` shared 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 --check` PASS — `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 통과를 주장하지 않는다.
