동행복권 자동구매 시스템 - 로또 6/45 및 연금복권 720 자동화

• 기능
• 프로젝트 구조
• 설치
• 사용법
• Systemd 타이머 설정
• 환경 변수
• 스크립트 설명

1. 잔액 확인 - 구매가능 금액 조회
2. 조건부 충전 - 잔액 부족 시 자동 충전 (10,000원)
3. 연금복권 720 구매 - 자동 구매
4. 로또 6/45 구매 - 자동/수동 번호 선택 구매 (최대 5게임)
5. 구매 한도 감지 - 주간 구매 한도(5,000원) 도달 시 자동 중단 및 알림

• ✅ 완전 자동화 - Playwright 기반 브라우저 자동화
• ✅ OCR 키패드 인식 - 랜덤 키패드 자동 입력 (Tesseract)
• ✅ 신뢰성 높은 PIN 입력 - 디바운싱 방지 및 지연 입력을 통한 정확한 결제
• ✅ 결제 금액 및 영수증 검증 - 구매 전 금액 확인 및 구매 후 최종 영수증(#report) 확인
• ✅ Systemd 타이머 - 매주 일요일 자동 실행 로직
• ✅ 유연한 설정 - 커맨드라인 인자 또는 .env 파일 지원

lotto/
├── src/ # Python 스크립트
│ ├── balance.py # 잔액 조회
│ ├── charge.py # 예치금 충전 (간편 충전)
│ ├── login.py # 로그인 모듈
│ ├── lotto645.py # 로또 6/45 구매
│ └── pension720.py # 연금복권 720 구매
├── scripts/ # 실행 스크립트
│ ├── run.sh # 메인 워크플로우 스크립트
│ ├── setup-env.sh # 환경 설정 (venv, pip)
│ ├── install-systemd.sh # Systemd 타이머 설치
│ └── systemd/ # Systemd 설정 파일
│ ├── lotto.service # 서비스 정의
│ └── lotto.timer # 타이머 정의 (매주 일요일 09:00)
├── .env # 환경 변수 (비공개)
├── .env.example # 환경 변수 예시
├── requirements.txt # Python 의존성
└── README.md # 설명 문서

두 가지 사용 방식 지원, 상황에 맞는 방법 선택

1. Option A: 개인 서버/로컬 컴퓨터 - 내 컴퓨터나 Linux 서버(EC2, 홈서버 등)에서 직접 실행
2. Option B: GitHub Actions - 서버 없이 GitHub 클라우드에서 자동 실행

저장소 클론:

git clone https://github.com/yoonbae81/lotto.git
cd lotto

환경 설정:

cd scripts
./setup-env.sh

Python 가상환경 생성, 의존성 설치, 브라우저 설치, .env 파일 자동 생성

.env 파일 편집하여 로또 계정 정보 입력

nano ../.env

설정 확인을 위한 수동 실행

cd ~/GitHub/lotto
source .venv/bin/activate

• 잔액 확인: ./src/balance.py
• 전체 워크플로우 실행:

./scripts/run.sh

• 특정 복권만 구매하는 옵션:

./scripts/run.sh --645 # 로또 6/45만 구매 (연금복권 스킵)
./scripts/run.sh --720 # 연금복권 720만 구매 (로또 스킵)

Linux 서버 Systemd 이용 매주 일요일 아침 자동 실행 설정

설치:

cd scripts
./install-systemd.sh

관리 명령어:

systemctl --user status lotto.timer # 상태 확인
systemctl --user list-timers lotto.timer # 다음 실행 시간 확인
journalctl --user -u lotto.service -f # 로그 확인

개인 서버 없이 GitHub Actions 이용 매주 자동 실행 가능, 컴퓨터 상시 가동 불필요

이 저장소를 본인의 GitHub 계정으로 Fork 수행

Fork한 리포지토리의 Settings > Secrets and variables > Actions에서 New repository secret 클릭 후 변수 추가

• 자동 실행: 매주 일요일 09:00 (KST) 자동 실행
• 수동 실행: 상단 Actions 탭 > Lotto Purchase 워크플로우 선택 > Run workflow 버튼 클릭

# 동행복권 계정 정보
USER_ID=myid
PASSWD=mypassword
# 간편충전 PIN (6자리)
CHARGE_PIN=123456
# 로또 6/45 설정
AUTO_GAMES=1
MANUAL_NUMBERS=[]
# 또는 수동 번호 지정
# MANUAL_NUMBERS=[[1,2,3,4,5,6], [7,8,9,10,11,12]]

• 예치금 잔액 및 구매가능 금액 조회
• 반환값: {'deposit_balance': int, 'available_amount': int}

• 간편충전 기능 (가상계좌 입금 아님)
• OCR 활용 랜덤 키패드 자동 인식
• 지연 클릭을 통한 PIN 입력 신뢰성 확보

• 공통 로그인 모듈
• 타 스크립트 import 사용

• 로또 6/45 구매
• 자동/수동 번호 선택 및 장바구니 관리 (최대 5게임)
• 주간 구매 한도(5,000원) 및 예치금 부족 감지
• 결제 금액 및 최종 구매 결과 검증 (#report 영수증 확인)

• 연금복권 720 구매
• 임의 번호 모든 조(組) 자동 선택
• 고정 금액: 5,000원
• 결제 금액 검증

환경 설정 스크립트:

• Python 가상환경 생성
• pip 및 의존성 설치
• Playwright 브라우저 설치
• .env 파일 생성

메인 워크플로우 스크립트:

1. 잔액 확인
2. 조건부 충전 (10,000원 미만 시)
3. 로또 720 구매
4. 로또 645 구매

Systemd 타이머 설치:

• 서비스/타이머 파일 복사
• 경로 자동 설정 ({{PROJECT_ROOT}} 치환)
• 타이머 활성화 및 시작

• Python 3.9+
• Playwright - 브라우저 자동화
• Tesseract OCR - 키패드 숫자 인식
• Pillow - 이미지 처리
• python-dotenv - 환경 변수 관리
• Systemd - 스케줄링 (Linux)

1. 간편 충전 사용: [간편충전] 기능 사용, [가상계좌 입금] 미지원
2. 주간 구매 한도: 로또 6/45는 법적으로 1인당 주간 10만원 한도가 있으나, 본 시스템은 동행복권 모바일 사이트의 정책에 따라 주간 5,000원 한도를 준수하며 이를 초과할 경우 구매를 시도하지 않습니다.
3. OCR 정확도: 키패드 숫자 인식률 약 90-95%, 실패 시 재시도 또는 수동 확인 요망
4. Linux 전용: Systemd 타이머 Linux 전용, macOS launchd 사용 필요
5. 보안: .env 파일 커밋 금지 (.gitignore 포함)
6. 테스트: 실제 사용 전 수동 스크립트 테스트 권장

# Tesseract 재설치 (macOS)
brew reinstall tesseract
# Tesseract 재설치 (Ubuntu/Debian)
sudo apt-get install --reinstall tesseract-ocr

# 브라우저 재설치
.venv/bin/playwright install chromium

# .env 파일 위치 확인
ls -la .env
# 권한 확인
chmod 600 .env

# 사용자 세션 유지 (로그아웃 후에도 실행)
loginctl enable-linger $USER
# 타이머 재시작
systemctl --user daemon-reload
systemctl --user restart lotto.timer

기본적으로 .github/workflows/purchase.yml 자동 실행 스케줄 주석 처리됨 자동 실행 희망 시 해당 파일 schedule 부분 주석(#) 제거 요망

Cron 설정 참고:

• 시간: UTC 기준 (한국 시간 -9시간)
  • 예: 30 0 * * 1 → UTC 00:30 (한국 시간 월요일 오전 09:30)
• 요일: 0 (일요일) ~ 6 (토요일)

# 수정 전
# schedule:
# - cron: '0 0 * * 0'
# 수정 후
schedule:
 - cron: '30 0 * * 1'