메인 μ½˜ν…μΈ λ‘œ κ±΄λ„ˆλ›°κΈ°
Sonamu UIλŠ” Entity, Migration, Scaffolding, Fixture 관리λ₯Ό μœ„ν•œ μ›Ή 기반 개발 λ„κ΅¬μž…λ‹ˆλ‹€. CLI둜 μˆ˜ν–‰ν•˜λ˜ μž‘μ—…λ“€μ„ μ‹œκ°μ μΈ μΈν„°νŽ˜μ΄μŠ€λ‘œ 더 μ‰½κ²Œ ν•  수 μžˆμŠ΅λ‹ˆλ‹€.

Sonamu UIλž€?

Sonamu UIλŠ” λ‹€μŒ κΈ°λŠ₯을 μ œκ³΅ν•©λ‹ˆλ‹€:
κΈ°λŠ₯μ„€λͺ…CLI λŒ€μ²΄
Entity 관리Entity 생성, μˆ˜μ •, μ‚­μ œpnpm stub entity
DB Migrationλ§ˆμ΄κ·Έλ ˆμ΄μ…˜ 생성 및 μ‹€ν–‰pnpm migrate
ScaffoldingModel, ν…ŒμŠ€νŠΈ μžλ™ 생성pnpm scaffold
Fixtureν…ŒμŠ€νŠΈ 데이터 관리pnpm fixture
i18nκ΅­μ œν™” λ¬Έμžμ—΄ κ΄€λ¦¬μˆ˜λ™ νŽΈμ§‘
Tasksμ›Œν¬ν”Œλ‘œμš° μ‹€ν–‰ λͺ¨λ‹ˆν„°λ§-

μ‹€ν–‰ 방법

개발 ν™˜κ²½μ—μ„œ μ‹€ν–‰

Sonamu UIλŠ” API μ„œλ²„μ— λ‚΄μž₯λ˜μ–΄ μžˆμŠ΅λ‹ˆλ‹€. λ³„λ„μ˜ λͺ…λ Ήμ–΄κ°€ ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
# API μ„œλ²„ μ‹€ν–‰
cd api
pnpm dev
API μ„œλ²„κ°€ μ‹€ν–‰λ˜λ©΄ Sonamu UIκ°€ μžλ™μœΌλ‘œ ν•¨κ»˜ μ œκ³΅λ©λ‹ˆλ‹€. κΈ°λ³Έ URL: http://localhost:1028/sonamu-ui
Sonamu UIλŠ” λ³„λ„μ˜ 포트 없이 API μ„œλ²„μ˜ /sonamu-ui κ²½λ‘œμ—μ„œ μ œκ³΅λ©λ‹ˆλ‹€.

일반적인 개발 μ›Œν¬ν”Œλ‘œμš°

# API μ„œλ²„ μ‹€ν–‰ (Sonamu UI 포함)
cd api
pnpm dev

# λΈŒλΌμš°μ €μ—μ„œ 접속
# http://localhost:1028/sonamu-ui

μΈν„°νŽ˜μ΄μŠ€ ꡬ쑰

Sonamu UI 전체 ν™”λ©΄
Sonamu UIλŠ” 크게 μ„Έ κ°€μ§€ μ˜μ—­μœΌλ‘œ κ΅¬μ„±λ©λ‹ˆλ‹€:

1. Global Navigation Bar (GNB)

ν™”λ©΄ 상단에 μœ„μΉ˜ν•˜λ©° μ£Όμš” κΈ°λŠ₯에 λΉ λ₯΄κ²Œ μ ‘κ·Όν•  수 μžˆμŠ΅λ‹ˆλ‹€.
메뉴기λŠ₯
EntitiesEntity 생성 및 νŽΈμ§‘
DB Migrationλ§ˆμ΄κ·Έλ ˆμ΄μ…˜ 관리
ScaffoldingModel/Test μ½”λ“œ 생성
Fixtureν…ŒμŠ€νŠΈ 데이터 관리
i18nκ΅­μ œν™” λ¬Έμžμ—΄ 관리
Tasksμ›Œν¬ν”Œλ‘œμš° μ‹€ν–‰ λͺ¨λ‹ˆν„°λ§
Search (⌘K)전체 검색

2. Sidebar

ν™”λ©΄ μ™Όμͺ½μ— μœ„μΉ˜ν•˜λ©° ν˜„μž¬ μ„ νƒν•œ λ©”λ‰΄μ˜ ν•­λͺ© λͺ©λ‘μ„ ν‘œμ‹œν•©λ‹ˆλ‹€.
  • Entities νƒ­: λͺ¨λ“  Entity λͺ©λ‘ ν‘œμ‹œ
  • Migrations νƒ­: λ§ˆμ΄κ·Έλ ˆμ΄μ…˜ 파일 λͺ©λ‘
  • ν•˜λ‹¨ λ²„νŠΌ: μƒˆ ν•­λͺ© μΆ”κ°€ λ²„νŠΌ (예: New Entity)

3. Main Content Area

ν™”λ©΄ μ€‘μ•™μ˜ 넓은 μ˜μ—­μœΌλ‘œ μ„ νƒν•œ ν•­λͺ©μ˜ 상세 정보λ₯Ό ν‘œμ‹œν•˜κ³  νŽΈμ§‘ν•©λ‹ˆλ‹€.
  • Entity 속성 νŽΈμ§‘
  • λ§ˆμ΄κ·Έλ ˆμ΄μ…˜ 미리보기
  • μ½”λ“œ 생성 μ˜΅μ…˜ λ“±

ν‚€λ³΄λ“œ 단좕킀

단좕킀기λŠ₯
⌘K (Mac) / Ctrl+K (Windows)검색 λͺ¨λ‹¬ μ—΄κΈ°
Escλͺ¨λ‹¬ λ‹«κΈ°

λ‹€μŒ 단계