WEHAGO_DB

WSL Ubuntu에서 Python으로 WEHAGO 관련 데이터를 다루고, Gitea 저장소와 연동하기 위한 프로젝트입니다.

1. 폴더 위치

WSL Ubuntu 터미널에서 접근:

cd /home/b17301/WEHAGO_DB

Windows 탐색기에서 접근:

\\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. 처음 한 번만 실행

cd /home/b17301/WEHAGO_DB
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

또는 준비 스크립트를 사용합니다.

cd /home/b17301/WEHAGO_DB
./scripts/setup_env.sh

3. 실행 방법

cd /home/b17301/WEHAGO_DB
./scripts/run.sh

직접 실행하려면:

cd /home/b17301/WEHAGO_DB
source .venv/bin/activate
python main.py

3-1. WEHAGO 다운로드 결과 저장 위치

wehago_data_download_260421.py를 실행하면 결과 파일은 아래 폴더에 저장됩니다.

/home/b17301/WEHAGO_DB/data_download

Windows 탐색기에서는 아래 경로로 열 수 있습니다.

\\wsl$\Ubuntu\home\b17301\WEHAGO_DB\data_download

실제 계정별원장 엑셀은 실행 날짜별 하위 폴더에 저장됩니다.

data_download/wehago_account_ledger_YYYYMMDD/

오류 진단 파일은 아래 폴더에 저장됩니다.

data_download/diagnostics/

4. Gitea 연동

연결된 원격 저장소:

https://gitea.hmac.kr/YJKIM/WEHAGO_DB.git

현재 설정 확인:

git remote -v

변경사항 저장:

git status
git add .
git commit -m "작업 내용 설명"
git push -u origin main

5. 자주 생기는 문제와 대처

fatal: not a git repository가 나올 때:

현재 폴더가 프로젝트 폴더가 아닙니다.

cd /home/b17301/WEHAGO_DB

source .venv/bin/activate가 안 될 때:

가상환경이 아직 없습니다.

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

pip install에서 네트워크 오류가 날 때:

사내망, 프록시, DNS 문제일 수 있습니다. 인터넷 또는 사내 패키지 저장소 접근 권한을 확인해야 합니다.

git push에서 로그인 실패가 날 때:

Gitea 비밀번호 대신 개인 액세스 토큰을 요구할 수 있습니다. Gitea 웹에서 토큰을 만들고, 비밀번호 자리에 토큰을 입력하세요.

remote origin already exists가 날 때:

이미 원격 저장소가 설정되어 있습니다.

git remote -v
git remote set-url origin https://gitea.hmac.kr/YJKIM/WEHAGO_DB.git

6. 권장 작업 흐름

cd /home/b17301/WEHAGO_DB
source .venv/bin/activate
python main.py
git status
git add .
git commit -m "작업 설명"
git push