# Gitea 리포지토리 생성 및 푸시 가이드

## 🏠 서버 정보

- **Gitea 서버**: `git.0bin.in`
- **사용자명**: `thug0bin`
- **이메일**: `thug0bin@gmail.com`
- **액세스 토큰**: `d83f70b219c6028199a498fb94009f4c1debc9a9`

## 🚀 새 리포지토리 생성 및 푸시 과정

### 1. 로컬 Git 리포지토리 초기화

```bash
# 프로젝트 디렉토리로 이동
cd /path/to/your/project

# Git 초기화
git init

# .gitignore 파일 생성 (필요시)
cat > .gitignore << 'EOF'
# Dependencies
node_modules/
npm-debug.log*
yarn-debug.log*
yarn-error.log*

# Build outputs
dist/
build/

# Environment variables
.env
.env.local
.env.development.local
.env.test.local
.env.production.local

# IDE
.vscode/
.idea/

# OS
.DS_Store
Thumbs.db

# Logs
*.log

# Runtime data
pids
*.pid
*.seed
*.pid.lock

# Python
__pycache__/
*.py[cod]
*$py.class
*.so
.Python
env/
venv/

# Database
*.db
*.sqlite
*.sqlite3
EOF
```

### 2. Git 사용자 설정 확인

```bash
# Git 사용자 정보 확인
git config --list | grep -E "user"

# 설정되지 않은 경우 설정
git config --global user.name "시골약사"
git config --global user.email "thug0bin@gmail.com"
```

### 3. 첫 번째 커밋

```bash
# 모든 파일 스테이징
git add .

# 첫 커밋 (상세한 커밋 메시지 예시)
git commit -m "$(cat <<'EOF'
Initial commit: [프로젝트명]

✨ [주요 기능 설명]
- 기능 1
- 기능 2
- 기능 3

🛠️ 기술 스택:
- 사용된 기술들 나열

🔧 주요 구성:
- 프로젝트 구조 설명

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
EOF
)"
```

### 4. 원격 리포지토리 연결 및 푸시

```bash
# 원격 리포지토리 추가 (리포지토리명을 실제 이름으로 변경)
git remote add origin https://thug0bin:d83f70b219c6028199a498fb94009f4c1debc9a9@git.0bin.in/thug0bin/[REPOSITORY_NAME].git

# 브랜치를 main으로 변경
git branch -M main

# 원격 리포지토리로 푸시
git push -u origin main
```

## 📝 리포지토리명 네이밍 규칙

### 권장 네이밍 패턴:
- **프론트엔드 프로젝트**: `project-name-frontend`
- **백엔드 프로젝트**: `project-name-backend`
- **풀스택 프로젝트**: `project-name-fullstack`
- **도구/유틸리티**: `tool-name-utils`
- **문서/가이드**: `project-name-docs`

### 예시:
- `figma-admin-dashboard` ✅
- `anipharm-api-server` ✅
- `inventory-management-system` ✅
- `member-portal-frontend` ✅

## 🔄 기존 리포지토리에 추가 커밋

```bash
# 변경사항 확인
git status

# 변경된 파일 스테이징
git add .

# 또는 특정 파일만 스테이징
git add path/to/specific/file

# 커밋
git commit -m "커밋 메시지"

# 푸시
git push origin main
```

## 🌿 브랜치 작업

```bash
# 새 브랜치 생성 및 전환
git checkout -b feature/new-feature

# 브랜치에서 작업 후 커밋
git add .
git commit -m "Feature: 새로운 기능 추가"

# 브랜치 푸시
git push -u origin feature/new-feature

# main 브랜치로 돌아가기
git checkout main

# 브랜치 병합 (필요시)
git merge feature/new-feature
```

## 🛠️ 자주 사용하는 Git 명령어

```bash
# 현재 상태 확인
git status

# 변경 내역 확인
git diff

# 커밋 히스토리 확인
git log --oneline

# 원격 리포지토리 정보 확인
git remote -v

# 특정 포트 프로세스 종료 (개발 서버 관련)
lsof -ti:PORT_NUMBER | xargs -r kill -9
```

## 🔧 포트 관리 스크립트

```bash
# 특정 포트 종료 함수 추가 (bashrc에 추가 가능)
killport() {
    if [ -z "$1" ]; then
        echo "Usage: killport <port_number>"
        return 1
    fi
    lsof -ti:$1 | xargs -r kill -9
    echo "Killed processes on port $1"
}

# 사용 예시
# killport 7738
# killport 5000
```

## 📋 VS Code 워크스페이스 설정

여러 리포지토리를 동시에 관리하려면 워크스페이스 파일을 생성하세요:

```json
{
	"folders": [
		{
			"name": "Main Repository",
			"path": "."
		},
		{
			"name": "New Project",
			"path": "./new-project-folder"
		}
	],
	"settings": {
		"git.enableSmartCommit": true,
		"git.confirmSync": false,
		"git.autofetch": true
	}
}
```

## 🚨 문제 해결

### 1. 인증 실패
```bash
# 토큰이 만료된 경우, 새 토큰으로 원격 URL 업데이트
git remote set-url origin https://thug0bin:NEW_TOKEN@git.0bin.in/thug0bin/repo-name.git
```

### 2. 푸시 거부
```bash
# 원격 변경사항을 먼저 가져오기
git pull origin main --rebase

# 충돌 해결 후 푸시
git push origin main
```

### 3. 대용량 파일 문제
```bash
# Git LFS 설정 (필요시)
git lfs install
git lfs track "*.zip"
git lfs track "*.gz"
git add .gitattributes
```

## 📊 커밋 메시지 템플릿

### 기본 템플릿:
```
타입: 간단한 설명

상세한 설명 (선택사항)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
```

### 타입별 예시:
- `✨ feat: 새로운 기능 추가`
- `🐛 fix: 버그 수정`
- `📝 docs: 문서 업데이트`
- `🎨 style: 코드 포맷팅`
- `♻️ refactor: 코드 리팩토링`
- `⚡ perf: 성능 개선`

- `✅ test: 테스트 추가`
- `🔧 chore: 빌드 설정 변경`

## 🔗 유용한 링크

- **Gitea 웹 인터페이스**: https://git.0bin.in/
- **내 리포지토리 목록**: https://git.0bin.in/thug0bin
- **새 리포지토리 생성**: https://git.0bin.in/repo/create

## 💡 팁과 모범 사례

1. **정기적인 커밋**: 작은 단위로 자주 커밋
하세요
2. **의미있는 커밋 메시지**: 변경 사항을 명확히 설명하세요
3. **브랜치 활용**: 기능별로 브랜치를 나누어 작업하세요
4. **.gitignore 활용**: 불필요한 파일은 제외하세요
5. **문서화**: README.md와 같은 문서를 항상 업데이트하세요

---

**작성일**: 2025년 7월 29일  
**마지막 업데이트**: 토큰 및 서버 정보 최신화  
**참고**: 이 가이드는 재사용 가능하도록 작성되었습니다. 새 프로젝트마다 참고하세요.

> 💡 **중요**: 액세스 토큰은 보안이 중요한 정보입니다. 공개 저장소에 업로드하지 마세요!