18
공통 UI 자산 · 기반 단계
sorune-ui
여러 프로젝트에서 반복해서 쓰는 디자인 값과 UI 동작 규칙을 정리하는 초기 설계입니다.
INIT-001 기반 / 안정 컴포넌트 릴리스 전
- 기간
- 2026 — 현재
- 역할
- UI 계약 설계
PROJECT / DECISION RECORD
문제에서 구현까지
- 01문제
UI를 반복해서 사용한다는 이유만으로 재사용 가능한 공통 컴포넌트라고 판단하기 어렵습니다.
- 02설계 선택
Token·semantic contract를 기준으로 두고 React 등 프레임워크 구현은 하위 투영으로 다룹니다.
- 03구현·진행
토큰, UI 계약, 실험용 플레이그라운드, 자산 분류·승격 규칙이 저장소에 있습니다.
문제
18UI를 반복해서 사용한다는 이유만으로 재사용 가능한 공통 컴포넌트라고 판단하기 어렵습니다.
제약
- 제품 고유 화면과 일반적인 토큰·컴포넌트 의미를 분리하고 접근성·출처 검증 없이는 승격하지 않습니다.
- 같은 색이나 카드가 여러 프로젝트에 있다는 이유만으로 범용 UI로 승격하지 않습니다.
- 소유권과 접근성 검증이 없는 자산은 재사용 라이브러리로 소개하지 않습니다.
설계와 결정
- Token·semantic contract를 기준으로 두고 React 등 프레임워크 구현은 하위 투영으로 다룹니다.
- FOUNDATION·PRIMITIVE·COMPOUND·PATTERN 등 구성 단계를 구분합니다.
- 후보 출처(OWNED·DERIVED·THIRD_PARTY 등)와 승격 단계(CANDIDATE·EXPERIMENTAL·STABLE)를 별도 관리합니다.
구현
- 토큰, UI 계약, 실험용 플레이그라운드, 자산 분류·승격 규칙이 저장소에 있습니다.
- 토큰과 의미 계약 및 후보 분류 문서를 저장소에 작성했습니다.
- 현재 단계는 INIT-001 기반이며 공개 안정 컴포넌트 제품으로 홍보하지 않습니다.
검증과 근거
소스 근거직접 확인
sorune-ui README에서 INIT-001 단계, 패키지 경계와 후보 승격 조건을 확인했습니다.
결과와 현재 상태
디자인 토큰과 공통 UI 계약의 기반을 마련했습니다. 안정 버전의 컴포넌트 패키지는 아직 공개하지 않았습니다.
현재 상태INIT-001 기반 / 안정 컴포넌트 릴리스 전