39 lines
1.2 KiB
Markdown
39 lines
1.2 KiB
Markdown
# gc-guide — 개발자 가이드 사이트
|
|
|
|
## 프로젝트 개요
|
|
GC SI 팀 개발자를 위한 온보딩 가이드 사이트.
|
|
신규 개발자가 개발 환경 설정, Gitea/Nexus 사용법, Git 워크플로우 등을 학습할 수 있도록 안내.
|
|
|
|
## 기술 스택
|
|
- React 19 + TypeScript + Vite 7
|
|
- Tailwind CSS v4
|
|
- React Router v7
|
|
- @react-oauth/google (Google OAuth2 인증)
|
|
- react-markdown + remark-gfm + rehype-highlight (마크다운 렌더링)
|
|
|
|
## 빌드 & 실행
|
|
|
|
```bash
|
|
npm run dev # 개발 서버 (localhost:5173)
|
|
npm run build # 프로덕션 빌드 (dist/)
|
|
npm run preview # 빌드 프리뷰
|
|
npm run lint # ESLint 검사
|
|
```
|
|
|
|
## 인증
|
|
- Google OAuth2 (@gcsc.co.kr 도메인 제한)
|
|
- 미인증 사용자는 로그인 페이지만 표시
|
|
- 백엔드 API (gc-guide-api)에서 Google ID Token 검증 → JWT 발급
|
|
|
|
## 배포
|
|
- 서버: guide.gc-si.dev (Nginx 정적 서빙)
|
|
- main 브랜치 MR 머지 시 자동 배포 (CI/CD)
|
|
- 개발 서버 API 프록시: /api/* → localhost:8080
|
|
|
|
## 의존성 레포지토리
|
|
- npm: https://nexus.gc-si.dev/repository/npm-public/
|
|
|
|
## 관련 프로젝트
|
|
- gc-guide-api: 백엔드 API (Spring Boot 3, JDK 17, PostgreSQL)
|
|
- Gitea: https://gitea.gc-si.dev/gc/gc-guide
|