154 lines
2.8 KiB
Markdown
154 lines
2.8 KiB
Markdown
# 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
|
|
```
|
|
|
|
## 3-1. WEHAGO 다운로드 결과 저장 위치
|
|
|
|
`wehago_data_download_260421.py`를 실행하면 결과 파일은 아래 폴더에 저장됩니다.
|
|
|
|
```text
|
|
/home/b17301/WEHAGO_DB/data_download
|
|
```
|
|
|
|
Windows 탐색기에서는 아래 경로로 열 수 있습니다.
|
|
|
|
```text
|
|
\\wsl$\Ubuntu\home\b17301\WEHAGO_DB\data_download
|
|
```
|
|
|
|
실제 계정별원장 엑셀은 실행 날짜별 하위 폴더에 저장됩니다.
|
|
|
|
```text
|
|
data_download/wehago_account_ledger_YYYYMMDD/
|
|
```
|
|
|
|
오류 진단 파일은 아래 폴더에 저장됩니다.
|
|
|
|
```text
|
|
data_download/diagnostics/
|
|
```
|
|
|
|
## 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
|
|
```
|