온보딩 가이드
신규 개발자를 위한 EGODA 프로젝트 셋업 가이드
🛠 필수 설치 (macOS)
brew install node watchman gh
npm install -g expo-cli
Xcode가 먼저 설치되어 있어야 합니다. xcode-select --install로 Command Line Tools도 설치하세요.
📦 프로젝트 클론
git clone https://github.com/GOATHEAVENCEO/EGODA.git
cd EGODA
📱 앱 셋업 (React Native + Expo)
cd apps/mobile && npm install
npx expo start
🖥 서버 셋업 (Express 5 + Prisma)
cd packages/api && npm install
cp .env.example .env # 환경변수 편집
npx prisma generate
npm run dev # port 4000
🌿 Git 브랜치 규칙
- main: 배포용 (직접 수정 금지)
- feature/*: 새 기능 브랜치
- fix/*: 버그 수정 브랜치
작업 플로우
git checkout main && git pull origin main # main 최신화
git checkout -b feature/기능명 # 브랜치 생성
# ... 작업 ...
git push -u origin feature/기능명
gh pr create --base main # PR 생성 → main 머지
📝 커밋 컨벤션
| 타입 | 설명 |
|---|
feat | 새 기능 |
fix | 버그 수정 |
chore | 잡일 (설정, 의존성) |
refactor | 리팩토링 |
docs | 문서 |
🔐 환경변수 체크리스트 (API 서버)
| 변수 | 용도 |
|---|
DATABASE_URL | PostgreSQL 연결 문자열 |
JWT_SECRET | JWT 토큰 서명 |
JWT_REFRESH_SECRET | 리프레시 토큰 서명 |
AWS_ACCESS_KEY_ID | AWS 인증 |
AWS_SECRET_ACCESS_KEY | AWS 인증 |
AWS_REGION | ap-northeast-2 |
AWS_S3_BUCKET | S3 버킷명 |
🛠 어드민 셋업 (React 19 + Vite 7)
cd apps/admin && npm install && npm run dev # port 5173
🔐 환경변수 (.env)
| 변수 | 용도 |
|---|
VITE_API_URL | API 서버 주소 (http://localhost:4000) |
👤 어드민 계정 생성
- 첫 접속 시 이메일/비밀번호로 로그인
- SUPER_ADMIN이 관리자 계정 페이지에서 역할 변경
- 역할 변경 후 다시 로그인하면 대시보드 접근 가능
역할: super (전체 권한) > manager (수정 가능) > viewer (조회만)
⚙️ 기술 스택
| 기술 | 버전/설명 |
|---|
| React | 19 |
| Vite | 7 |
| TailwindCSS | 3 |
| TanStack Query | 데이터 패칭 |
| Axios | HTTP 클라이언트 |
제품 문의사항
버그 리포트, 기능 요청, 일반 문의를 등록하고 추적할 수 있습니다.
0건