Fix: Restore unified Topics folder and reorganize specialized category folders

This commit is contained in:
Antigravity Agent
2026-05-02 23:25:02 +09:00
parent b71a0b82d3
commit fdfbc83535
6241 changed files with 147626 additions and 194 deletions
@@ -0,0 +1,52 @@
---
id: P-REINFORCE-WIKI-DEV-DESIGN-SYSTEMS
title: "디자인 시스템과 웹 컴포넌트 표준 (Design Systems & Web Components)"
category: Dev
status: verified
canonical_id: ""
aliases: ["Design Systems", "Web Components", "디자인 시스템", "웹 컴포넌트", "Custom Elements", "Shadow DOM"]
duplicate_of: ""
source_trust_level: A
confidence_score: 1.0
tags: ["Frontend", "Design_System", "Web_Components", "Standardization", "UI_UX"]
raw_sources: ["Datacollector_Export_2026-05-02"]
last_reinforced: 2026-05-02
github_commit: ""
---
# [[디자인 시스템과 웹 컴포넌트 표준 (Design Systems & Web Components)]]
## 1. 개요
디자인 시스템(Design Systems)은 일관된 사용자 경험을 제공하기 위해 설계 원칙, 시각적 요소, 재사용 가능한 UI 컴포넌트를 정의한 통합 가이드라인이다. 이를 기술적으로 구현하는 핵심 수단 중 하나인 웹 컴포넌트(Web Components)는 브라우저 네이티브 표준을 활용하여 프레임워크에 종속되지 않는 독립적이고 캡슐화된 UI 요소를 구축할 수 있게 해준다.
## 2. 웹 컴포넌트의 4대 핵심 기술
- **Custom Elements**: 자신만의 HTML 태그(예: `<my-button>`)를 정의하고 브라우저에 등록하여 사용할 수 있는 API.
- **Shadow DOM**: 컴포넌트의 마크업과 스타일을 외부 환경으로부터 격리(Encapsulation)하여, 스타일 충돌이나 의도치 않은 간섭 방지.
- **HTML Templates**: 렌더링되지 않은 채로 HTML 내에 저장되어 있다가 필요할 때 복제하여 사용할 수 있는 유연한 마크업 구조.
- **ES Modules**: 자바스크립트 모듈 시스템을 통해 컴포넌트를 독립된 파일로 관리하고 필요할 때 임포트하여 사용.
## 3. 디자인 시스템 구축 전략
- **아토믹 디자인 (Atomic Design)**: 원자(Atoms), 분자(Molecules), 유기체(Organisms), 템플릿(Templates), 페이지(Pages) 단위로 컴포넌트를 계층화하여 설계.
- **디자인 토큰 (Design Tokens)**: 색상, 폰트, 간격 등 시각적 변수를 플랫폼(Web, iOS, Android)과 관계없이 일관되게 관리하는 데이터 정의.
- **접근성(Accessibility) 준수**: 웹 표준(WCAG)을 준수하여 모든 사용자가 차별 없이 인터페이스를 사용할 수 있도록 설계 단계부터 반영.
- **문서화 (Documentation)**: Storybook 등의 도구를 활용하여 각 컴포넌트의 사용법, 변수, 상태 변화를 시각적으로 문서화하여 협업 효율 증대.
## 4. 엔지니어링 가치
- **프레임워크 독립성 (Framework Agnostic)**: 웹 컴포넌트로 제작된 UI는 React, Vue, Angular 등 어떤 환경에서도 동일하게 작동하여 장기적인 기술 유지보수 비용 절감.
- **일관된 사용자 경험 (Consistency)**: 전사적으로 동일한 컴포넌트를 사용함으로써 제품 간의 시각적, 기능적 통일성 확보 및 브랜드 가치 강화.
- **개발 속도 가속화**: 이미 검증된 컴포넌트 조각들을 조합하여 페이지를 구성하므로, 신규 기능 개발 시 UI 구현 시간 획기적 단축.
## 5. 트레이드오프 및 주의사항
- **SSR(서버 사이드 렌더링) 지원 미비**: 네이티브 웹 컴포넌트는 브라우저 환경에 의존하므로, Next.js 등의 서버 환경에서 선언적으로 렌더링하기 위해 별도의 보완 기술(Declarative Shadow DOM 등) 필요.
- **브라우저 호환성 및 폴리필**: 최신 브라우저에서는 잘 동작하지만, 구형 브라우저 지원이 필요한 경우 성능 오버헤드가 있는 폴리필(Polyfill) 사용 필수.
- **러닝 커브 및 도구 부족**: 특정 프레임워크 전용 라이브러리에 비해 생태계가 좁고, 데이터 바인딩이나 상태 관리 로직을 직접 구현해야 하는 번거로움이 있을 수 있음.
## 6. 지식 연결 (Related)
- [[React_Architecture]]: 디자인 시스템이 컴포넌트로 실체화되는 주된 환경.
- [[Vue_Architecture]]: Composition API와 결합하여 렌더리스 컴포넌트를 구축하는 기반.
- [[Framework_Practical_Patterns]]: 다양한 프레임워크에 걸친 UI 패턴의 표준화.
## 🧪 검증 상태 (Validation)
- **정보 상태**: 검증 완료 (Verified)
- **출처 신뢰도**: A
- **검토 이유**: 일관된 브랜드 정체성과 프레임워크에 구애받지 않는 고품질 UI 인프라를 구축하기 위한 디자인 시스템과 웹 표준 컴포넌트 기술 전략 정립.