# HECO2 Gitea 저장소 — 접속 · 협업 · 작업환경 가이드

HERV 통합 소스를 사내 Gitea로 관리하고 인터넷에서 접속·협업하기 위한 안내 문서.

> ⚠️ 비밀번호·토큰 등 민감정보는 이 문서에 적지 않습니다. 각자 안전하게 보관하세요.

---

## 1. 기본 정보

| 항목 | 내용 |
|---|---|
| 웹 주소 | https://gitea.himpelai.com |
| 저장소 | https://gitea.himpelai.com/jeon/HECO2 |
| Clone 주소(HTTPS) | `https://gitea.himpelai.com/jeon/HECO2.git` |
| 접속 | 사내/외부(인터넷)·휴대폰 모두 위 주소로 동일하게 접속 |

회원가입은 보안상 막혀 있습니다. 계정은 **관리자(jeon)가 생성**해 전달합니다.

---

## 2. 서버 구성 (운영자 참고)

```
인터넷
  │  https://gitea.himpelai.com
  ▼
가비아 DNS  gitea.himpelai.com ─(CNAME)→ himpelai-gitea.duckdns.org ─(DDNS)→ 현재 공인IP(유동)
  ▼
TP-Link 공유기  외부 80/443 → 192.168.0.129
  ▼
이 PC : Caddy(80/443, 자동 HTTPS / Let's Encrypt)
  ▼
Gitea (localhost:3000)
```

- **설치 위치**: `D:\GITEA` (설정 `D:\GITEA\custom\conf\app.ini`, RUN_USER=himpel)
- **HTTPS**: Caddy가 Let's Encrypt 인증서 자동 발급·갱신 (`D:\GITEA\Caddyfile`)
- **유동 IP 대응**: DuckDNS가 5분마다 현재 IP 추적 (`himpelai-gitea.duckdns.org`)
- **DNS**: `himpelai.com`은 가비아 관리, `gitea` 서브도메인만 CNAME 추가(메일 등 영향 없음)

### 자동시작 (himpel 로그온 시)
재부팅 후 **himpel 계정으로 로그인하면** 아래가 자동 기동됨:

| 예약작업 | 역할 | 실행계정 |
|---|---|---|
| `Gitea-Web-Autostart` | Gitea 서버 (`D:\GITEA\start-gitea.ps1`) | himpel(로그온) |
| `Caddy-Gitea-Autostart` | HTTPS 프록시 (`D:\GITEA\start-caddy.ps1`) | himpel(로그온) |
| `DuckDNS-Gitea-Update` | 유동IP 추적 (`D:\GITEA\duckdns-update.ps1`) | SYSTEM(5분) |

> **재부팅 후 사이트 접속이 안 될 때**: 서버 PC가 **himpel로 로그인됐는지** 먼저 확인. 로그인 전에는 Gitea·Caddy가 안 떠서 502가 납니다.

---

## 3. 외부 인원 등록 (관리자 jeon)

### 3-1. 계정 생성 (웹 관리자 화면)
1. `jeon`으로 로그인 → 우측 상단 **프로필 사진** → **「사이트 관리」** (또는 주소 `/-/admin`)
2. 왼쪽 **「사용자 계정」** → 오른쪽 위 **「사용자 계정 생성」**
3. 입력: **사용자 이름 / 이메일 주소 / 비밀번호**, ✅ **「처음 로그인할 때 비밀번호 변경」** 체크
4. **「사용자 계정 생성」** → 인원수만큼 반복

> 「사이트 관리」 메뉴가 안 보이면 그 계정은 관리자가 아님.

### 3-2. 저장소 권한 부여
1. `https://gitea.himpelai.com/jeon/HECO2` → 상단 **「설정」**
2. 왼쪽 **「공동 작업자」** → 사용자 이름 입력 → **「공동 작업자 추가」**
3. 권한 선택: **「쓰기」**(push 가능) / **「읽기」**(보기만)

> 인원·저장소가 늘면 개인 소유 대신 **Organization(조직)**으로 묶어 관리 권장.

---

## 4. 다른 컴퓨터에서 작업환경 구성 (VS Code + Claude Code)

> Gitea 계정과 Claude(Anthropic) 계정은 별개입니다.

### 4-1. Git 설치
- https://git-scm.com/download/win (기본 옵션 설치)

### 4-2. 저장소 클론
```powershell
git clone https://gitea.himpelai.com/jeon/HECO2.git
```
- 아이디/비밀번호 → **Gitea 계정**으로 입력
- 권장: 비밀번호 대신 **액세스 토큰** 사용
  - Gitea 로그인 → 프로필 → **설정 → 응용 프로그램 → 토큰 생성** → 토큰을 비밀번호 자리에 입력

### 4-3. VS Code 설치
- https://code.visualstudio.com → 설치 → **파일 → 폴더 열기** → 클론한 `HECO2` 폴더

### 4-4. Claude Code 설치
- VS Code 왼쪽 **확장(Extensions)** (`Ctrl+Shift+X`) → **`Claude Code`** 검색 → Anthropic 확장 설치
- 안내에 따라 **Anthropic 계정 로그인** (Claude 구독 또는 API 키)
- (대안) 터미널: Node.js 설치 후 `npm install -g @anthropic-ai/claude-code` → 폴더에서 `claude`

### 4-5. 작업 & 반영
```powershell
git add .
git commit -m "작업 내용"
git push
```
→ `https://gitea.himpelai.com/jeon/HECO2` 에 반영

---

## 5. 자주 쓰는 git 명령
```powershell
git clone https://gitea.himpelai.com/jeon/HECO2.git   # 처음 받기
git pull            # 최신 내용 받기 (작업 전 권장)
git add .           # 변경분 담기
git commit -m "메시지"
git push            # 서버에 올리기
git status          # 현재 상태 확인
```