wing-ops/docs/DESIGN-SYSTEM.md
leedano ebe49c7b77 docs(design): Foundation 탭 디자인 토큰 상세 문서화
- Primitive Colors 7그룹 hex 팔레트, Semantic Colors dark/light 병기
- Typography Font Family 3종 + .wing-* 클래스 10종 상세 테이블
- Radius Tokens 7종 + 컴포넌트 매핑 5건
- Layout: Breakpoints, Spacing Scale, Z-Index, App Shell Classes
2026-03-24 17:23:54 +09:00

9.2 KiB

WING-OPS 디자인 시스템

개요

WING-OPS UI 디자인 시스템의 비주얼 레퍼런스 카탈로그. Google Stitch MCP로 생성된 스크린을 기반으로 일관된 UI 구현을 유도한다.

Stitch 프로젝트

  • 프로젝트명: WING-OPS Design System v1
  • 프로젝트 ID: 5453076280291618640

스크린 목록

# 스크린 Screen ID 용도
1 Design Tokens ce520225d85c4c38b2024e93ec6a4fb2 색상, 타이포그래피, 간격, 라운딩 토큰
2 Component Catalog (Buttons/Badges) 42fa9cf1a3d341a7972a1bc10ba00a8c 버튼 variant, 뱃지, 아이콘 버튼
3 Form Components 7331ad8a598f4cc59f62a14226c1d023 입력, 선택, 날짜, 토글, 폼 레이아웃
4 Table & List Patterns 5967382c70f9422ba3a0f4da79922ecf 데이터 테이블, 사이드바 리스트, 페이지네이션
5 Modal Catalog 440be91f8db7423cbb5cc89e6dd6f9ca 모달 3사이즈, 확인 다이얼로그, 폼 모달
6 Operational Shell (Layout) 86fd57c9f3c749d288f6270838a9387d TopBar, SubMenu, 3컬럼 레이아웃
7 Container & Navigation 201c2c0c47b74fcfb3427d029319fa9d 카드, 섹션, 탭바, KV 행, 헤더바

Foundations

색상 (Color Palette)

Primitive Colors

UI 전반에서 사용하는 기본 색조 팔레트. Navy는 배경 전용 5단계, 나머지는 00~100의 11단계 스케일.

Navy (배경 전용)

Step Hex
0 #0a0e1a
1 #0f1524
2 #121929
3 #1a2236
hover #1e2844

Cyan

00 10 20 30 40 50 60 70 80 90 100
#ecfeff #cffafe #a5f3fc #67e8f9 #22d3ee #06b6d4 #0891b2 #0e7490 #155e75 #164e63 #083344

Blue

00 10 20 30 40 50 60 70 80 90 100
#eff6ff #dbeafe #bfdbfe #93c5fd #60a5fa #3b82f6 #2563eb #1d4ed8 #1e40af #1e3a8a #172554

Red

00 10 20 30 40 50 60 70 80 90 100
#fef2f2 #fee2e2 #fecaca #fca5a5 #f87171 #ef4444 #dc2626 #b91c1c #991b1b #7f1d1d #450a0a

Green

00 10 20 30 40 50 60 70 80 90 100
#f0fdf4 #dcfce7 #bbf7d0 #86efac #4ade80 #22c55e #16a34a #15803d #166534 #14532d #052e16

Orange

00 10 20 30 40 50 60 70 80 90 100
#fff7ed #ffedd5 #fed7aa #fdba74 #fb923c #f97316 #ea580c #c2410c #9a3412 #7c2d12 #431407

Yellow

00 10 20 30 40 50 60 70 80 90 100
#fefce8 #fef9c3 #fef08a #fde047 #facc15 #eab308 #ca8a04 #a16207 #854d0e #713f12 #422006

Semantic Colors

컨텍스트에 따라 의미를 부여한 토큰. Dark/Light 두 테마 값 병기.

Text

토큰 Dark Light 용도
text-1 #edf0f7 #0f172a 기본 텍스트, 아이콘 기본
text-2 #b0b8cc #475569 보조 텍스트
text-3 #8690a6 #94a3b8 비활성, 플레이스홀더

Background

토큰 Dark Light 용도
bg-0 #0a0e1a #f8fafc 페이지 배경
bg-1 #0f1524 #ffffff 사이드바, 패널
bg-2 #121929 #f1f5f9 테이블 헤더
bg-3 #1a2236 #e2e8f0 카드 배경
bg-hover #1e2844 #cbd5e1 호버 상태

Border

토큰 Dark Light 용도
border #1e2a42 #cbd5e1 기본 구분선
border-light #2a3a5c #e2e8f0 연한 구분선

Accent

토큰 Dark Light 용도
primary-cyan #06b6d4 #06b6d4 주요 강조, 활성 상태
primary-blue #3b82f6 #0891b2 보조 강조
primary-purple #a855f7 #6366f1 3차 강조

Status

토큰 Dark Light 용도
status-red #ef4444 #dc2626 위험, 삭제
status-orange #f97316 #c2410c 주의
status-yellow #eab308 #b45309 경고
status-green #22c55e #047857 정상, 성공

타이포그래피 (Typography)

Font Family

이름 className Font Stack 용도
Noto Sans KR font-korean 'Noto Sans KR', sans-serif 기본 UI 텍스트, 한국어 콘텐츠 전반
JetBrains Mono font-mono 'JetBrains Mono', monospace 좌표, 수치, 코드, 토큰 이름
Outfit font-sans 'Outfit', 'Noto Sans KR', sans-serif 영문 헤딩, 브랜드 타이틀

Body 기본 스택: font-family: 'Outfit', 'Noto Sans KR', sans-serif

Typography Tokens (.wing-* 클래스)

클래스 Size Font Weight 용도 샘플
.wing-title 15px font-korean Bold (700) 패널 제목 확산 예측 시뮬레이션
.wing-section-header 13px font-korean Bold (700) 섹션 헤더 기본 정보 입력
.wing-label 11px font-korean Semibold (600) 필드 레이블 유출량 (kL)
.wing-btn 11px font-korean Semibold (600) 버튼 텍스트 시뮬레이션 실행
.wing-value 11px font-mono Semibold (600) 수치 / 데이터 값 35.1284° N, 129.0598° E
.wing-input 11px font-korean Normal (400) 입력 필드 서해 대산항 인근 해역
.wing-section-desc 10px font-korean Normal (400) 섹션 설명 예측 결과는 기상 조건에 따라...
.wing-subtitle 10px font-korean Normal (400) 보조 설명 최근 업데이트: 2026-03-24 09:00 KST
.wing-meta 9px font-korean Normal (400) 메타 정보 v2.1 | 해양환경공단
.wing-badge 9px font-korean Bold (700) 뱃지 / 태그 진행중

Border Radius

Radius Tokens

Tailwind 클래스 비고
rounded-sm 6px Custom (Tailwind 기본값 오버라이드)
rounded 4px (0.25rem) Tailwind 기본
rounded-md 10px Custom (Tailwind 기본값 오버라이드)
rounded-lg 8px (0.5rem) Tailwind 기본
rounded-xl 12px (0.75rem) Tailwind 기본
rounded-2xl 16px (1rem) Tailwind 기본
rounded-full 9999px Tailwind 기본

컴포넌트 매핑

Radius 적용 컴포넌트
rounded-sm 6px .wing-btn, .wing-input, .wing-card-sm
rounded 4px .wing-badge
rounded-md 10px .wing-card, .wing-section, .wing-tab
rounded-lg 8px .wing-tab-bar
rounded-xl 12px .wing-modal

레이아웃 (Layout)

Breakpoints

Name Prefix Min Width 사용 비고
sm sm: 640px -
md md: 768px -
lg lg: 1024px -
xl xl: 1280px 사용 중 TopBar 탭 레이블/아이콘 토글
2xl 2xl: 1536px -

Desktop(≥ 1280px)만 지원. Tablet/Mobile 미지원.

Device Width Columns Gutter Margin
Desktop ≥ 1280px flex 기반 가변 gap-2 ~ gap-6 px-5 ~ px-8
Tablet 768px ~ 1279px - - -
Mobile < 768px - - -

Spacing Scale

Scale rem px 용도
0.5 0.125rem 2px 미세 간격
1 0.25rem 4px 최소 간격 (gap-1)
1.5 0.375rem 6px 컴팩트 간격 (gap-1.5)
2 0.5rem 8px 기본 간격 (gap-2, p-2)
2.5 0.625rem 10px 중간 간격
3 0.75rem 12px 표준 간격 (gap-3, p-3)
4 1rem 16px 넓은 간격 (p-4, gap-4)
5 1.25rem 20px 패널 패딩 (px-5, py-5)
6 1.5rem 24px 섹션 간격 (gap-6, p-6)
8 2rem 32px 큰 간격 (px-8, gap-8)
16 4rem 64px 최대 간격

Z-Index Layers

Layer z-index Color 설명
Tooltip 60 #a855f7 툴팁, 드롭다운 메뉴
Popup 50 #f97316 팝업, 지도 오버레이
Modal 40 #ef4444 모달 다이얼로그, 백드롭
TopBar 30 #3b82f6 상단 네비게이션 바
Sidebar 20 #06b6d4 사이드바, 패널
Content 10 #22c55e 메인 콘텐츠 영역
Base 0 #8690a6 기본 레이어, 배경

App Shell Classes

클래스 역할 Tailwind 스타일
.wing-panel 탭 콘텐츠 패널 flex flex-col h-full overflow-hidden
.wing-panel-scroll 패널 내 스크롤 영역 flex-1 overflow-y-auto
.wing-header-bar 패널 헤더 flex items-center justify-between shrink-0 px-5 border-b
.wing-sidebar 사이드바 flex flex-col border-r border-border