← 전체 프로젝트
18

공통 UI 자산 · 기반 단계

sorune-ui

여러 프로젝트에서 반복해서 쓰는 디자인 값과 UI 동작 규칙을 정리하는 초기 설계입니다.

INIT-001 기반 / 안정 컴포넌트 릴리스 전
기간
2026 — 현재
역할
UI 계약 설계

PROJECT / DECISION RECORD

문제에서 구현까지

  1. 01문제

    UI를 반복해서 사용한다는 이유만으로 재사용 가능한 공통 컴포넌트라고 판단하기 어렵습니다.

  2. 02설계 선택

    Token·semantic contract를 기준으로 두고 React 등 프레임워크 구현은 하위 투영으로 다룹니다.

  3. 03구현·진행

    토큰, UI 계약, 실험용 플레이그라운드, 자산 분류·승격 규칙이 저장소에 있습니다.

프로젝트 기록을 구조화한 요약 · 실제 서비스 화면이나 실행 검증 결과가 아닙니다.

문제

18

UI를 반복해서 사용한다는 이유만으로 재사용 가능한 공통 컴포넌트라고 판단하기 어렵습니다.

제약

  • 제품 고유 화면과 일반적인 토큰·컴포넌트 의미를 분리하고 접근성·출처 검증 없이는 승격하지 않습니다.
  • 같은 색이나 카드가 여러 프로젝트에 있다는 이유만으로 범용 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 기반 / 안정 컴포넌트 릴리스 전