gc-guide/CLAUDE.md

1.2 KiB

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 (마크다운 렌더링)

빌드 & 실행

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

의존성 레포지토리

관련 프로젝트