# Git 사용 가이드라인

## ⚠️ 중요한 주의사항

### 1. Git 초기화 금지
- **절대로 `git init`를 실행하지 말 것**
- 이 프로젝트는 이미 Gitea 서버에 연결되어 있음
- 원격 저장소: origin (Gitea 서버)

### 2. 커밋 전 확인 사항
- 항상 `git status`로 현재 상태 확인
- `git log --oneline -n 5`로 최근 커밋 이력 확인
- `git remote -v`로 원격 저장소 확인

### 3. 커밋 시 규칙
```bash
# 상태 확인
git status

# 변경사항 확인
git diff

# 논리적 단위로 나누어서 커밋
git add [파일명]
git commit -m "커밋 메시지"

# 원격 저장소에 푸시
git push origin main
```

### 4. 커밋 메시지 작성 규칙
- **기능 추가**: `feat: 효능 태그 시스템 추가`
- **버그 수정**: `fix: 총금액 표시 오류 수정`
- **문서 작성**: `docs: README 업데이트`
- **리팩토링**: `refactor: 코드 구조 개선`
- **스타일**: `style: 코드 포맷팅`
- **테스트**: `test: 단위 테스트 추가`
- **기타**: `chore: 빌드 스크립트 수정`

### 5. 파일 관리
- 테스트 파일들은 `.gitignore`에 추가 고려
- 업로드 폴더는 커밋하지 않기 (uploads/)
- 데이터베이스 파일은 주의해서 관리

### 6. 브랜치 전략
- 현재 main 브랜치 사용 중
- 큰 기능은 별도 브랜치 생성 고려
```bash
# 브랜치 생성 및 체크아웃
git checkout -b feature/기능명

# 작업 후 main으로 머지
git checkout main
git merge feature/기능명
```

### 7. 실수 방지
- `git push --force`는 절대 사용 금지
- `git reset --hard`는 신중하게 사용
- 작업 전 `git pull` 실행 습관화

## 현재 프로젝트 상태
- Repository: kdrug (한약재 재고관리 시스템)
- Branch: main
- Remote: origin (Gitea 서버)

## 체크리스트
- [ ] git status 확인
- [ ] 논리적 단위로 파일 그룹화
- [ ] 의미있는 커밋 메시지 작성
- [ ] 불필요한 파일 제외 확인
- [ ] push 전 최종 검토

---
작성일: 2026-02-15
작성자: Claude Assistant