docs: Gitea 접속·협업·작업환경 가이드 추가

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

doc/Gitea_저장소_접속_및_협업_가이드.md

@@ -0,0 +1,115 @@
+# 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          # 현재 상태 확인
+```