Initial WEHAGO_DB project setup

README.md

@@ -0,0 +1,128 @@
+# WEHAGO_DB
+
+WSL Ubuntu에서 Python으로 WEHAGO 관련 데이터를 다루고, Gitea 저장소와 연동하기 위한 프로젝트입니다.
+
+## 1. 폴더 위치
+
+WSL Ubuntu 터미널에서 접근:
+
+```bash
+cd /home/b17301/WEHAGO_DB
+```
+
+Windows 탐색기에서 접근:
+
+```text
+\\wsl$\Ubuntu\home\b17301\WEHAGO_DB
+```
+
+VS Code에서 접근:
+
+1. VS Code 왼쪽 아래 `><` 모양 또는 `Remote` 버튼 클릭
+2. `Connect to WSL` 선택
+3. `File > Open Folder`
+4. `/home/b17301/WEHAGO_DB` 선택
+
+## 2. 처음 한 번만 실행
+
+```bash
+cd /home/b17301/WEHAGO_DB
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+
+또는 준비 스크립트를 사용합니다.
+
+```bash
+cd /home/b17301/WEHAGO_DB
+./scripts/setup_env.sh
+```
+
+## 3. 실행 방법
+
+```bash
+cd /home/b17301/WEHAGO_DB
+./scripts/run.sh
+```
+
+직접 실행하려면:
+
+```bash
+cd /home/b17301/WEHAGO_DB
+source .venv/bin/activate
+python main.py
+```
+
+## 4. Gitea 연동
+
+연결된 원격 저장소:
+
+```text
+https://gitea.hmac.kr/YJKIM/WEHAGO_DB.git
+```
+
+현재 설정 확인:
+
+```bash
+git remote -v
+```
+
+변경사항 저장:
+
+```bash
+git status
+git add .
+git commit -m "작업 내용 설명"
+git push -u origin main
+```
+
+## 5. 자주 생기는 문제와 대처
+
+`fatal: not a git repository`가 나올 때:
+
+현재 폴더가 프로젝트 폴더가 아닙니다.
+
+```bash
+cd /home/b17301/WEHAGO_DB
+```
+
+`source .venv/bin/activate`가 안 될 때:
+
+가상환경이 아직 없습니다.
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+
+`pip install`에서 네트워크 오류가 날 때:
+
+사내망, 프록시, DNS 문제일 수 있습니다. 인터넷 또는 사내 패키지 저장소 접근 권한을 확인해야 합니다.
+
+`git push`에서 로그인 실패가 날 때:
+
+Gitea 비밀번호 대신 개인 액세스 토큰을 요구할 수 있습니다. Gitea 웹에서 토큰을 만들고, 비밀번호 자리에 토큰을 입력하세요.
+
+`remote origin already exists`가 날 때:
+
+이미 원격 저장소가 설정되어 있습니다.
+
+```bash
+git remote -v
+git remote set-url origin https://gitea.hmac.kr/YJKIM/WEHAGO_DB.git
+```
+
+## 6. 권장 작업 흐름
+
+```bash
+cd /home/b17301/WEHAGO_DB
+source .venv/bin/activate
+python main.py
+git status
+git add .
+git commit -m "작업 설명"
+git push
+```
+