Skip to Content
ResourcesSupport

Support

도움말 및 지원 채널

개요

Vortex UI 사용 중 도움이 필요하신가요? 다양한 지원 채널을 통해 도움을 받으실 수 있습니다.

지원 채널

1. 문서

먼저 공식 문서를 확인하세요:

시작하기:

컴포넌트:

실전 예제:

개발 패턴:

2. Storybook

인터랙티브 컴포넌트 데모:

🔗 https://storybook.vortex.dev 

제공 기능:

  • ✅ 모든 컴포넌트 시각화
  • ✅ 인터랙티브 Controls
  • ✅ 다양한 variants 확인
  • ✅ 코드 스니펫 복사
  • ✅ 접근성 테스트

3. GitLab Issues

버그 리포트 및 기능 요청:

🔗 https://repo.calsplatz.com/vortex/platform/-/issues 

버그 리포트

Issue Template:

## 버그 설명
 
명확하고 간결한 버그 설명
 
## 재현 단계
 
1. '...'로 이동
2. '...'를 클릭
3. '...'까지 스크롤
4. 에러 발생
 
## 예상 동작
 
어떻게 동작해야 하는지 설명
 
## 실제 동작
 
실제로 어떻게 동작하는지 설명
 
## 스크린샷
 
가능하면 스크린샷 첨부
 
## 환경
 
- OS: [예: macOS 14]
- Browser: [예: Chrome 120]
- Version: [예: 2.0.0]
 
## 추가 정보
 
기타 관련 정보

기능 요청

Feature Request Template:

## 기능 설명
 
원하는 기능의 명확한 설명
 
## 문제점
 
이 기능이 해결할 문제점
 
## 제안하는 해결책
 
어떻게 구현되면 좋을지 설명
 
## 대안
 
고려한 다른 대안들
 
## 추가 컨텍스트
 
mockup, 스크린샷 등

4. Discussions

커뮤니티 Q&A 및 아이디어 공유:

🔗 https://repo.calsplatz.com/vortex/platform/-/discussions 

카테고리:

  • 💬 General: 일반적인 질문
  • 💡 Ideas: 새로운 아이디어 제안
  • 🙏 Q&A: 질문과 답변
  • 📢 Announcements: 공지사항
  • 🎉 Show and Tell: 프로젝트 공유

5. Slack (내부 팀)

실시간 커뮤니케이션:

채널:

  • #vortex-support - 일반 지원
  • #vortex-dev - 개발 관련
  • #vortex-announcements - 공지사항

응답 시간:

  • 업무 시간: 1-2시간 이내
  • 업무 외 시간: 다음 영업일

6. Email

공식 이메일:

📧 vortex@example.com

응답 시간: 1-2 영업일

사용 사례:

  • 보안 취약점 보고
  • 라이센스 문의
  • 파트너십 문의

자주 묻는 질문

빠른 답변이 필요하신가요? FAQ를 먼저 확인하세요.

인기 질문:

기여하기

Vortex UI를 개선하고 싶으신가요?

코드 기여

  1. Issue 생성 - 버그나 기능 제안
  2. Fork & Branch - 저장소 포크 및 브랜치 생성
  3. 구현 - 코드 작성 및 테스트
  4. PR 생성 - Merge Request 생성

자세한 내용은 Contributing Guide를 참고하세요.

문서 기여

개선 방법:

  • 오타 수정
  • 설명 추가
  • 예제 코드 개선
  • 번역 (다국어 지원)
# 문서 수정 브랜치 생성
pnpm branch --type docs --scope docs --desc "fix-typo-in-installation" --yes
 
# 수정 후 커밋
git add .
pnpm commit --message "Fix typo in installation guide" --yes
 
# PR 생성
pnpm push --yes
pnpm mr --target develop --yes

커뮤니티 기여

  • ✅ Discussion에 답변하기
  • ✅ Issue에 재현 도와주기
  • ✅ Storybook 예제 추가
  • ✅ 블로그 글 작성
  • ✅ 튜토리얼 비디오 제작

문제 해결

일반적인 문제

1. 설치 오류

증상: pnpm install 실패

해결책:

# pnpm 캐시 클리어
pnpm store prune
 
# node_modules 삭제 후 재설치
rm -rf node_modules pnpm-lock.yaml
pnpm install

2. 빌드 오류

증상: pnpm build 실패

해결책:

# 타입 체크
pnpm type-check
 
# Lint 확인
pnpm lint
 
# 클린 빌드
pnpm clean
pnpm build

3. 컴포넌트 스타일 문제

증상: 컴포넌트가 올바르게 렌더링되지 않음

체크리스트:

  1. ✅ globals.css import 확인
  2. ✅ Tailwind 설정 확인
  3. ✅ CSS 변수 정의 확인
  4. ✅ 브라우저 캐시 클리어

4. TypeScript 에러

증상: 타입 에러 발생

해결책:

# tsconfig.json 확인
cat tsconfig.json
 
# 타입 정의 재설치
pnpm install --force
 
# VSCode 재시작
# Cmd + Shift + P → "Reload Window"

디버깅 도구

1. React DevTools

설치:

기능:

  • 컴포넌트 트리 확인
  • Props/State 검사
  • 성능 프로파일링

2. Tailwind CSS IntelliSense

VSCode Extension:

Name: Tailwind CSS IntelliSense
Id: bradlc.vscode-tailwindcss

기능:

  • 클래스명 자동완성
  • Hover로 실제 CSS 확인
  • Lint 경고

3. Console Logging

// 컴포넌트 렌더링 추적
useEffect(() => {
  console.log("Component mounted");
  return () => console.log("Component unmounted");
}, []);
 
// Props 변경 추적
useEffect(() => {
  console.log("Props changed:", props);
}, [props]);

보안 취약점 보고

책임감 있는 공개

보안 취약점을 발견하셨나요?

⚠️ 공개 Issue를 생성하지 마세요!

대신:

  1. 이메일 발송: security@example.com
  2. 제목: [SECURITY] 취약점 설명
  3. 포함 내용:
    • 취약점 상세 설명
    • 재현 단계
    • 영향 범위
    • 제안하는 해결책 (선택)

응답 프로세스

  1. 24시간 이내 - 수신 확인
  2. 3일 이내 - 초기 평가
  3. 7일 이내 - 해결 계획 공유
  4. 30일 이내 - 패치 릴리스

Bug Bounty

현재 공식 Bug Bounty 프로그램은 없지만, 기여는 Changelog에 기록됩니다.

Service Level Agreement (SLA)

응답 시간

우선순위초기 응답해결 목표
Critical (P0)2시간1일
High (P1)1일3일
Medium (P2)3일1주
Low (P3)1주2주

우선순위 기준

P0 (Critical):

  • 프로덕션 서비스 중단
  • 보안 취약점
  • 데이터 손실

P1 (High):

  • 주요 기능 동작 불가
  • 성능 심각한 저하
  • 많은 사용자 영향

P2 (Medium):

  • 부분적 기능 문제
  • 회피 방법 존재
  • 일부 사용자 영향

P3 (Low):

  • 사소한 버그
  • UI 개선 사항
  • 기능 요청

유용한 리소스

공식 문서

외부 리소스

커뮤니티

피드백

Vortex UI를 더 나은 플랫폼으로 만들기 위해 여러분의 피드백이 필요합니다.

설문조사

분기별 사용자 설문:

  • 만족도 조사
  • 기능 우선순위 투표
  • 개선 제안

Feature Voting

우선순위 투표:

  • GitLab Issues  👍 이모지로 투표
  • 가장 많은 투표를 받은 기능부터 개발

다음 단계

FAQ

자주 묻는 질문

Contributing

기여 가이드

Installation

설치 가이드

Examples

실전 예제

Last updated on
Migration Guide