# 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