# Gitea 셀프호스팅 서버 업로드 구현 계획

> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.

**Goal:** 현재 cointrader 프로젝트를 셀프호스팅 Gitea 서버(10.1.10.28:3000)에 업로드한다.

**Architecture:** 기존 로컬 git 저장소에 Gitea 원격 저장소를 추가하고, 미커밋 변경사항을 정리한 뒤 전체 히스토리를 push한다. `.env` 파일은 절대 포함하지 않으며, `.gitignore`가 올바르게 설정되어 있는지 확인 후 진행한다.

**Tech Stack:** git, Gitea REST API (또는 웹 UI), zsh

---

## 사전 확인 사항

### 현재 git 상태 요약

- **브랜치:** `main`
- **기존 커밋:** 10개 (b1a7632 ~ 117fd9e)
- **미커밋 변경사항 (modified):**
  - `.env.example`
  - `requirements.txt`
  - `src/bot.py`
  - `src/config.py`
  - `src/exchange.py`
- **삭제된 파일:** `src/database.py`
- **추적되지 않는 파일 (untracked):**
  - `docs/` (전체 디렉토리)
  - `src/notifier.py`
- **`.gitignore`에 의해 제외됨:** `.env`, `__pycache__/`, `*.pyc`, `.pytest_cache/`, `logs/`, `*.log`, `.venv/`

---

## Task 1: 미커밋 변경사항 스테이징 및 커밋

**Files:**
- Modify: `.env.example`
- Modify: `requirements.txt`
- Modify: `src/bot.py`
- Modify: `src/config.py`
- Modify: `src/exchange.py`
- Delete: `src/database.py`
- Create: `src/notifier.py`
- Create: `docs/` (전체)

**Step 1: git 상태 최종 확인**

```bash
git -C /Users/gihyeon/github/cointrader status
```

Expected: modified 파일들과 untracked 파일들이 목록에 표시됨

**Step 2: 모든 변경사항 스테이징**

```bash
cd /Users/gihyeon/github/cointrader
git add -A
```

> `-A` 옵션은 수정, 삭제, 신규 파일을 모두 스테이징한다. `.env`는 `.gitignore`에 있으므로 자동 제외된다.

**Step 3: 스테이징 내용 검토 (`.env` 포함 여부 반드시 확인)**

```bash
git diff --cached --name-only
```

Expected: `.env` 파일이 목록에 **없어야** 한다. 만약 있다면 즉시 `git reset HEAD .env` 실행 후 중단.

**Step 4: 커밋**

```bash
git commit -m "feat: Discord 알림, 포지션 복구, 설정 개선 및 docs 추가"
```

Expected: `main` 브랜치에 새 커밋 생성

**Step 5: 커밋 확인**

```bash
git log --oneline -3
```

Expected: 방금 만든 커밋이 최상단에 표시됨

---

## Task 2: Gitea에 원격 저장소 생성

**Step 1: Gitea 웹 UI 접속**

브라우저에서 `http://10.1.10.28:3000` 접속 후 로그인

**Step 2: 새 저장소 생성**

- 우상단 `+` 버튼 → `New Repository` 클릭
- **Repository Name:** `cointrader`
- **Visibility:** Private (권장) 또는 Public
- **Initialize this repository:** **체크 해제** (로컬에 이미 히스토리가 있으므로 빈 저장소로 생성해야 함)
- `Create Repository` 클릭

**Step 3: 저장소 URL 확인**

생성 후 표시되는 URL 메모:
```
http://10.1.10.28:3000/<사용자명>/cointrader.git
```

---

## Task 3: 로컬 저장소에 Gitea 원격 추가 및 Push

**Step 1: 현재 원격 저장소 확인**

```bash
cd /Users/gihyeon/github/cointrader
git remote -v
```

Expected: 아무것도 없거나 기존 origin이 있을 수 있음

**Step 2: Gitea 원격 추가**

기존 origin이 없는 경우:
```bash
git remote add origin http://10.1.10.28:3000/<사용자명>/cointrader.git
```

기존 origin이 있는 경우 (다른 URL):
```bash
git remote set-url origin http://10.1.10.28:3000/<사용자명>/cointrader.git
```

> `<사용자명>`은 Gitea 로그인 계정명으로 교체

**Step 3: 원격 추가 확인**

```bash
git remote -v
```

Expected:
```
origin  http://10.1.10.28:3000/<사용자명>/cointrader.git (fetch)
origin  http://10.1.10.28:3000/<사용자명>/cointrader.git (push)
```

**Step 4: main 브랜치 push**

```bash
git push -u origin main
```

> Gitea 계정의 사용자명과 비밀번호(또는 액세스 토큰)를 입력하라는 프롬프트가 나타남

Expected:
```
Enumerating objects: ...
Counting objects: ...
Writing objects: 100% ...
Branch 'main' set up to track remote branch 'main' from 'origin'.
```

**Step 5: Push 결과 확인**

```bash
git log --oneline origin/main
```

Expected: 로컬 커밋 히스토리와 동일하게 표시됨

---

## Task 4: Gitea 웹 UI에서 업로드 검증

**Step 1: 브라우저에서 저장소 확인**

`http://10.1.10.28:3000/<사용자명>/cointrader` 접속

**Step 2: 파일 목록 확인**

다음 파일/폴더가 있어야 함:
- `src/` (bot.py, config.py, exchange.py, notifier.py, indicators.py, risk_manager.py, logger_setup.py, data_stream.py, config.py 등)
- `tests/`
- `docs/`
- `main.py`
- `requirements.txt`
- `.env.example`
- `.gitignore`

다음 파일이 **없어야** 함:
- `.env`
- `__pycache__/`
- `.venv/`
- `logs/`

**Step 3: 커밋 히스토리 확인**

Gitea UI에서 `Commits` 탭 클릭 → 11개 커밋이 모두 표시되는지 확인

---

## 선택 사항: SSH 키 설정 (비밀번호 없이 push하려면)

매번 비밀번호 입력이 번거롭다면 SSH 키를 등록할 수 있다.

**Step 1: SSH 키 생성 (없는 경우)**

```bash
ssh-keygen -t ed25519 -C "cointrader@gitea" -f ~/.ssh/id_gitea
```

**Step 2: 공개 키 복사**

```bash
cat ~/.ssh/id_gitea.pub
```

**Step 3: Gitea에 SSH 키 등록**

Gitea 웹 UI → 우상단 프로필 → `Settings` → `SSH / GPG Keys` → `Add Key` → 공개 키 붙여넣기

**Step 4: SSH config 설정**

```bash
cat >> ~/.ssh/config << 'EOF'
Host gitea-local
    HostName 10.1.10.28
    Port 22
    User git
    IdentityFile ~/.ssh/id_gitea
EOF
```

**Step 5: 원격 URL을 SSH로 변경**

```bash
git remote set-url origin git@gitea-local:<사용자명>/cointrader.git
```

---

## 트러블슈팅

| 문제 | 원인 | 해결 |
|------|------|------|
| `Connection refused` | Gitea 서버 미실행 또는 방화벽 | `http://10.1.10.28:3000` 접속 가능한지 브라우저로 먼저 확인 |
| `Repository not found` | 저장소 미생성 또는 URL 오타 | Task 2 재확인, URL의 사용자명 확인 |
| `Authentication failed` | 잘못된 계정 정보 | Gitea 웹 UI 로그인 테스트 후 동일 계정 사용 |
| `non-fast-forward` | 원격에 이미 커밋 존재 | `git push --force origin main` (단, 원격 데이터 덮어씌워짐 주의) |
| `.env` 파일이 push됨 | `.gitignore` 미적용 | `git rm --cached .env && git commit -m "chore: remove .env from tracking"` |