# 구조
타입(범위): 제목

본문 (선택)

푸터 (선택)

# 예시
feat(auth): 카카오 로그인 추가

사용자가 카카오 계정으로 간편하게 로그인할 수 있도록
NextAuth.js를 사용한 카카오 OAuth 연동을 구현했습니다.

Closes #123

# 주요 타입
feat:     새 기능
fix:      버그 수정
docs:     문서 변경
style:    코드 포맷팅 (기능 변경 없음)
refactor: 리팩토링
test:     테스트 추가/수정
chore:    빌드, 설정 변경

# 예시
feat: 결제 기능 추가
fix: 로그인 에러 수정
docs: README 업데이트
style: ESLint 규칙 적용
refactor: API 호출 로직 개선
test: 사용자 등록 테스트 추가
chore: 패키지 업데이트

# ✅ 명확하고 구체적
feat(payment): 토스페이먼츠 결제 연동 추가

# ✅ 이슈 번호 포함
fix: 로그인 실패 시 에러 메시지 표시 (#42)

# ✅ 왜 했는지 설명
refactor: API 호출을 React Query로 변경

기존 useEffect + useState 조합은 로딩 상태 관리가 복잡했고,
캐싱이 없어 불필요한 API 호출이 많았습니다.
React Query로 변경하여 자동 캐싱과 재시도 기능을 활용합니다.

# ❌ 너무 모호
update code
fix bug
changes

# ❌ 의미 없는 메시지
asdf
test
aaa
수정

# ❌ 커밋이 너무 큼
feat: 전체 기능 구현 (로그인, 회원가입, 프로필, 설정, ...)

# 기능 개발
feature/login-ui
feature/payment-integration

# 버그 수정
fix/login-error
hotfix/critical-bug

# 리팩토링
refactor/api-client

# 문서
docs/readme-update

# 예시
git checkout -b feature/kakao-login
git checkout -b fix/payment-validation

# 브랜치 구조
main/master     → 프로덕션 (배포용)
develop         → 개발 통합
feature/*       → 기능 개발
hotfix/*        → 긴급 수정

# 워크플로우
1. develop에서 feature 브랜치 생성
git checkout develop
git checkout -b feature/user-profile

2. 작업 후 커밋
git add .
git commit -m "feat: 사용자 프로필 페이지 추가"

3. develop에 merge
git checkout develop
git merge feature/user-profile

4. 배포 준비되면 main에 merge
git checkout main
git merge develop
git tag v1.2.0

# 브랜치 구조
main            → 항상 배포 가능
feature/*       → 모든 작업

# 워크플로우
1. main에서 브랜치 생성
git checkout main
git checkout -b feature/new-feature

2. 작업 & 푸시
git push origin feature/new-feature

3. Pull Request 생성
4. 리뷰 후 main에 merge
5. 자동 배포 (CI/CD)

# 1. 메인 브랜치 최신화
git checkout main
git pull origin main

# 2. 새 브랜치 생성
git checkout -b feature/new-feature

# 또는 한 줄로
git checkout -b feature/new-feature origin/main

# 변경사항 확인
git status
git diff

# 스테이징
git add src/components/Login.tsx
# 또는 모든 변경사항
git add .

# 커밋
git commit -m "feat(auth): 로그인 UI 추가"

# 푸시
git push origin feature/new-feature

# 1. 푸시
git push origin feature/login

# 2. GitHub에서 PR 생성
# 3. 리뷰 대기
# 4. 승인 후 merge

# 1. 메인 브랜치 최신 코드 가져오기
git checkout main
git pull origin main

# 2. 작업 브랜치로 돌아가서 merge
git checkout feature/my-feature
git merge main

# 3. 충돌 파일 확인
git status

# 4. 충돌 해결
# 파일 열어서 수정
# <<<<<<< HEAD
# 내 코드
# =======
# 메인 브랜치 코드
# >>>>>>> main

# 5. 해결 후 커밋
git add .
git commit -m "Merge main into feature/my-feature"

# 6. 푸시
git push origin feature/my-feature

# 마지막 커밋 취소 (변경사항 유지)
git reset --soft HEAD~1

# 마지막 커밋 취소 (변경사항 삭제)
git reset --hard HEAD~1

# 특정 커밋으로 되돌리기
git reset --hard abc123

# 마지막 커밋 메시지 수정
git commit --amend -m "새로운 메시지"

# 마지막 커밋에 파일 추가
git add forgotten-file.txt
git commit --amend --no-edit

# ⚠️ 주의: 이미 다른 사람이 pull 했다면 사용 금지!

# 로컬 커밋 취소
git reset --hard HEAD~1

# 강제 푸시
git push origin feature/my-feature --force

# ✅ 안전한 방법: revert 사용
git revert HEAD
git push origin feature/my-feature

# 간단한 로그
git log --oneline

# 그래프로 보기
git log --oneline --graph --all

# 특정 파일 히스토리
git log -- src/components/Login.tsx

# 특정 기간
git log --since="2 weeks ago" --until="yesterday"

# 스테이징되지 않은 변경사항
git diff

# 스테이징된 변경사항
git diff --staged

# 특정 파일만
git diff src/utils/api.ts

# 브랜치 간 차이
git diff main..feature/my-feature

# 변경사항 임시 저장
git stash

# 다른 작업...

# 복원
git stash pop

# Stash 목록
git stash list

# 특정 stash 복원
git stash apply stash@{0}

## 변경사항
- 카카오 로그인 기능 추가
- 로그인 UI 개선
- 에러 처리 추가

## 스크린샷
![Login Screen](./screenshot.png)

## 테스트
- [ ] 로그인 성공
- [ ] 로그인 실패 (잘못된 정보)
- [ ] 네트워크 에러 처리

## 관련 이슈
Closes #123

# 1. PR 생성
# 2. 리뷰어 지정
# 3. 라벨 추가 (feature, bug, urgent 등)
# 4. 설명 작성

# 리뷰 반영 후
git add .
git commit -m "refactor: 리뷰 반영"
git push origin feature/my-feature

# .gitignore

# 의존성
node_modules/
.pnp
.pnp.js

# 빌드
.next/
out/
dist/
build/

# 환경 변수
.env
.env.local
.env.*.local

# 로그
npm-debug.log*
yarn-debug.log*
yarn-error.log*

# IDE
.vscode/
.idea/
*.swp
*.swo
*~

# OS
.DS_Store
Thumbs.db

# 테스트
coverage/

# 기타
.cache/

# .github/workflows/ci.yml
name: CI

on:
  pull_request:
    branches: [main, develop]
  push:
    branches: [main, develop]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v3

      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '18'

      - name: Install dependencies
        run: npm ci

      - name: Run linter
        run: npm run lint

      - name: Run tests
        run: npm test

      - name: Build
        run: npm run build

# 파일이 100MB 넘으면 GitHub에서 거부

# 해결: Git LFS 사용
git lfs install
git lfs track "*.psd"
git add .gitattributes
git commit -m "chore: Git LFS 설정"

# 😱 .env 파일을 실수로 커밋

# 1. 즉시 파일 삭제 (히스토리에는 남음)
git rm .env
git commit -m "fix: .env 파일 제거"

# 2. 히스토리에서 완전 제거
# git-filter-repo 설치 필요
git filter-repo --path .env --invert-paths

# 3. 강제 푸시
git push origin --force --all

# 4. .env의 키 즉시 변경!
# GitHub에 이미 노출되었으므로 키를 재발급하세요

# main 브랜치가 많이 앞서감

# 방법 1: Merge (히스토리 유지)
git checkout feature/my-feature
git merge main

# 방법 2: Rebase (히스토리 깔끔)
git checkout feature/my-feature
git rebase main

# 충돌 해결 후
git rebase --continue