WIZ Design System

목적#

08 패턴은 먼저 기준서로 등록하고, 반복 사용과 검수 근거가 생긴 항목만 구현·패키지 후보로 승격합니다. 이 문서는 “어디에 적용됐는지”와 “다음에 어디에 적용할지”를 추적합니다.

적용 단계#

기준서: 패턴 문서가 있고 웹·모바일 규칙, 상태, 접근성, 검수 기준이 정의됨 — 출하 기준은 /docs/patterns/<slug> 문서
포털 적용: 실제 포털 화면이나 데모가 해당 패턴 규칙을 따름 — 출하 기준은 브라우저 검수 + visual/e2e 회귀
재사용 구현: 반복 조합이 훅·컴포넌트·데모 유틸로 추출됨 — 출하 기준은 @wds/ui-web 또는 portal/components 실사용
패키지 후보: 소비 제품이 직접 가져갈 가치가 있는 API로 안정화됨 — 출하 기준은 changeset, export, 문서, 테스트
패키지 포함: 배포 패키지에 런타임 코드 또는 registry 산출물로 포함됨 — 출하 기준은 packages/*/package.json files/exports 반영

현재 Future Interaction 패턴은 먼저 기준서로 등록하고, 반복 검수 근거가 생긴 항목부터 포털 적용 단계로 승격합니다.

적용 현황#

Adaptive Search Results: 현재 단계는 포털 적용입니다. 적용 위치는 /docs/components 검색·필터·결과 도구와 조합 데모이며, 다음 조치는 반복 적용처 확인 후 훅·registry·패키지 후보 판단입니다.
Adaptive List Detail: 현재 단계는 포털 적용입니다. 적용 위치는 /docs/patterns/adaptive-list-detail의 승인 목록 조합 데모이며, 다음 조치는 문서 목록·관리자 목록에 반복 적용할지 검토하는 것입니다.
Contextual Command Surface: 현재 단계는 포털 적용입니다. 적용 위치는 /docs/patterns/contextual-command-surface의 문서 검토 명령 조합 데모이며, 다음 조치는 행 액션·AI 명령·차트 내보내기 반복 적용 가능성 검토입니다.
AI Assisted Review: 현재 단계는 포털 적용입니다. 적용 위치는 /docs/patterns/ai-assisted-review의 제안·근거·승인 흐름 데모이며, 다음 조치는 실제 AI Workspace 검토 화면에 반복 적용할지 판단하는 것입니다.
Background Task Monitor: 현재 단계는 포털 적용입니다. 적용 위치는 /docs/patterns/background-task-monitor의 장기 작업 큐 데모이며, 다음 조치는 FileUpload·ChartExport·AI 작업 흐름에 같은 상태·명령 규칙을 반복 적용하는 것입니다.
Chart Data States: 현재 단계는 포털 적용입니다. 적용 위치는 /docs/patterns/chart-data-states의 차트 상태·지원 매트릭스 데모와 LineChart 문서이며, 다음 조치는 Dashboard·Admin Console·ChartExport 화면의 반복 상태를 통합하는 것입니다.
Loading Feedback: 현재 단계는 포털 적용입니다. 적용 위치는 /docs/patterns/loading-feedback 조합 데모와 Settings·Chart·Background Task 계열 상태 흐름이며, Button loading·Spinner·Skeleton·Progress·FormMessage·Alert·Toast는 이미 @wds/ui-web에 포함되어 있습니다. 다음 조치는 반복 화면에서 FeedbackState·LoadableRegion API가 필요한지 판단하는 것입니다.
File Import / Upload Review: 현재 단계는 포털 적용입니다. 적용 위치는 /docs/patterns/file-import-upload-review의 선택·검증·부분 실패 복구 데모이며, FileUpload 접근성·모바일 목록 보강은 @wds/ui-web 패키지 변경에 포함됩니다. 다음 조치는 실제 가져오기 화면 반복 근거를 확인한 뒤 ImportReview recipe나 registry 후보 여부를 판단하는 것입니다.
Security Settings: 현재 단계는 포털 적용입니다. Security Settings 데모와 Admin 보안 도그푸딩에 적용되어 있으며, 다음 조치는 SettingRow·PasswordStrength 승격 여부 판단입니다.

P0 적용#

검색 결과 패턴 고정: 대상은 /docs/components, Adaptive Search Results 데모입니다. 완료 기준은 조건/결과 분리, page size, sort, view, pagination, 모바일 오버플로 회귀 테스트입니다.
적용 현황 표기: 대상은 Adaptive Search Results입니다. 완료 기준은 문서에 적용 위치와 패키지 포함 여부를 명시하는 것입니다.
카탈로그 현행화: 대상은 Security Settings·Loading Feedback 등 신규 패턴입니다. 완료 기준은 08 패턴 카탈로그 카드와 썸네일이 로드맵 상태와 함께 갱신되는 것입니다.
파일 가져오기 리뷰: 대상은 File Import / Upload Review입니다. 완료 기준은 FileUpload 접근성, 선택/검증/복구 분리, 모바일 카드형 결과, 부분 실패 CTA 검수입니다.

P1 적용#

목록-상세 1차 적용: 대상은 Adaptive List Detail 조합 데모입니다. 완료 기준은 1~3 pane 전환, 모바일 목록→상세 단계 이동, 복귀 상태 보존 검수입니다.
명령 표면 1차 적용: 대상은 Contextual Command Surface 조합 데모입니다. 완료 기준은 전역 명령, 항목 명령, Popover→BottomSheet 전환, 위험 명령 분리 검수입니다.
AI 검토 데모 설계: 대상은 AI Workspace 또는 별도 데모입니다. 완료 기준은 제안·근거·diff·승인/반려 상태 매트릭스입니다.

P2 적용#

패턴 registry 검토: 대상은 portal/content/08-patterns 또는 별도 JSON 산출물입니다. 완료 기준은 제품/AI 문서가 패턴 목록을 기계적으로 참조하는 것입니다.
패키지 후보 분리: 대상은 반복 구현이 생긴 패턴입니다. 완료 기준은 @wds/ui-web export 또는 별도 @wds/patterns 필요성 판단입니다.
Flutter 패리티 정리: 대상은 모바일 규칙입니다. 완료 기준은 Flutter 구현 가능/보류/웹 전용 구분입니다.

배포 패키지 기준#

현재 패턴 문서는 포털 배포에 포함됩니다. @wds/ui-web 패키지는 dist만 배포하므로 MDX 패턴 문서는 패키지 설치물에 포함되지 않습니다.

패턴을 배포 패키지에 포함하려면 다음 중 하나가 필요합니다.

런타임 컴포넌트/훅: 반복 구현이 명확하고 API가 안정됐을 때 씁니다
패턴 registry JSON: 제품/AI 에이전트가 패턴 목록과 적용 상태를 기계적으로 읽어야 할 때 씁니다
별도 문서 패키지: 오프라인 소비처가 포털 없이 패턴 문서를 받아야 할 때 씁니다

추가 후보 보류#

아래 후보는 지금 바로 정식 등록하지 않습니다. 적용 단계에서 반복 근거가 생기면 승격합니다.

Generic State/Feedback Recipe: Loading Feedback을 포털 적용 단계로 올렸습니다. 반복 구현 근거가 쌓이면 recipe API 또는 registry 후보로 승격합니다.
Onboarding / First-run Flow: 현 포털·데모에서 반복 사용 근거가 약합니다. 제품 온보딩 사례가 먼저 필요합니다.
Collaboration Presence: AI Workspace와 Workspace 5축에 개념은 있으나, 실시간 협업 화면 근거가 아직 부족합니다.