srt-seatbuddy

친근하고 가벼운 SRT 자동 예매 웹앱이에요.

스트림릿 서비스(권장)

• 바로 사용: https://srt-seatbuddy.streamlit.app/
• 특징: 프론트(UI)와 자동화가 한 앱에 통합되어 별도 백엔드 없이 실행돼요.
• 사용 방법: 아이디/비밀번호와 조건을 입력하고 “자동 예매 시작”을 누르면 로그가 실시간으로 표시됩니다. “중지”로 즉시 취소할 수 있어요.

배포 시(스트림릿 클라우드에서 Selenium 오류 해결)

호스팅 환경에서는 크롬과 드라이버가 기본 제공되지 않아, 다음 파일이 필요합니다.

• packages.txt — 시스템 패키지 설치 목록(이미 포함됨)
  • 포함: chromium, chromium-driver, fonts-nanum
• 앱 코드는 시스템의 크롬/드라이버를 우선 사용하도록 구성되어 있어요(app.py).

추가 팁:

• 환경변수로 크롬 경로를 강제하려면 CHROME_BIN=/usr/bin/chromium를 설정하세요.
• 헤드리스 환경에서는 기본적으로 --no-sandbox, --disable-dev-shm-usage 플래그를 사용하도록 설정돼 있습니다.

로컬 실행(스트림릿)

pip install -r requirements.txt
streamlit run app.py

• 필요: Python 3.9+, Google Chrome/Chromium
• 참고: 서버/컨테이너 환경에서 크롬 경로가 특이하면 CHROME_BIN 환경변수로 바이너리 경로를 지정하세요.

주요 기능

• 🚀 병렬 실행(멀티 프로세스): 여러 개의 브라우저를 동시에 띄워 성공 확률을 극대화 (고급 설정)
• ⚙️ config.json 지원: 매번 입력할 필요 없이 로컬 파일에서 아이디/비밀번호/텔레그램 설정 자동 로드
• 📱 텔레그램 알림: 예약 성공 시 스마트폰으로 즉시 알림 전송 (선택 사항)
• 🔔 데스크탑/소리 알림: 예약 성공 시 PC 알림 및 비프음 재생
• 🖥️ Modern UI: 직관적이고 깔끔한 Glassmorphism 디자인 및 간편 설정(Pills) 지원
• 자동 예약: 로그인 → 조건 입력 → 상위 N개 열차 탐색 → “예약하기” 시도 → 성공 시 종료
• 실시간 로그 확인, 중지 버튼으로 즉시 취소
• 헤드리스(브라우저 숨김) 모드 선택 가능

정적 페이지(선택) — 미리보기용

• URL: https://wjgoarxiv.github.io/srt-seatbuddy/

---

로컬 실행(내 PC에서 백엔드 구동, 선택)

이 경로는 정적 프론트(index.html) + Node 백엔드(server/)를 분리해 구동하는 방법이에요. 스트림릿 앱을 사용한다면 이 섹션은 건너뛰어도 됩니다.

사전 준비

• Node.js 18+ (권장: 20)
• Google Chrome 설치
• ChromeDriver (자동으로 못 찾을 때 필요)
  • macOS: brew install chromedriver
  • Windows: https://sites.google.com/chromium.org/driver/

백엔드 실행

cd server
npm install
npm start
# 기본 포트: 3000 (변경 시: PORT=3001 npm start)

서버가 http://localhost:3000에서 대기합니다.

프론트엔드 열기

• 방법 A: index.html을 브라우저로 직접 열기
• 방법 B(권장): 간단 서버로 정적 서빙

# 저장소 루트에서
python3 -m http.server 8000
# 브라우저에서 http://localhost:8000 접속

페이지의 “서버 주소” 입력란에 http://localhost:3000을 넣고, 정보 입력 후 “자동 예매 시작”을 눌러요.

API 엔드포인트

• POST /start — 자동화 시작(바디에 아이디/비번/조건)
• POST /stop — 실행 중단
• GET /status — 실행 상태 + 최근 로그 확인

문제 해결 팁

• ChromeDriver 오류: 드라이버 설치/업데이트(brew install chromedriver), Chrome과 버전 일치 확인
• 헤드리스 문제: 헤드리스를 끄고(브라우저 표시) 동작 과정을 확인
• CORS/연결 실패: 백엔드가 켜져 있고 “서버 주소” 포트가 일치하는지 확인
• 포트 충돌: 다른 PORT로 백엔드를 실행하고 페이지의 주소를 맞춰 입력

폴더 구조

• 스트림릿 앱: app.py (UI+자동화 통합)
• 프론트엔드(정적): index.html, app.js, train-bg.png
• 백엔드(API): server/index.js(Express), server/srt.js(Selenium)
• CI 설정(선택): .github/workflows/ — GitHub Actions 용으로, 로컬 실행과는 무관

텔레그램 알림 설정 방법 (선택)

예약 성공 시 텔레그램으로 알림을 받고 싶다면:

1. 봇 토큰(Bot Token) 얻기

   • 텔레그램 앱에서 **@BotFather**를 검색하고 대화를 시작합니다.
   • /newbot 명령어를 입력합니다.
   • 봇의 이름(예: MySRTAlert)과 사용자명(예: mysrt_bot, 반드시 _bot으로 끝나야 함)을 정합니다.
   • 생성이 완료되면 HTTP API Token이 발급됩니다. 이 긴 문자열이 바로 봇 토큰입니다.

2. 챗 ID(Chat ID) 얻기

   • 텔레그램 앱에서 **@userinfobot**을 검색하고 대화를 시작합니다.
   • 시작(Start) 버튼을 누르면 나오는 Id 숫자(예: 12345678)가 챗 ID입니다.

3. 📢 중요: 봇에게 말 걸기

   • 방금 1번에서 만든 내 봇을 검색해서 대화를 시작하세요. (예: "안녕"이라고 메시지 하나 보내기)
   • 이 과정을 건너뛰면 봇이 알림을 보낼 수 없어요!

4. 앱에 설정하기

   • SRTSeatBuddy 앱의 고급 설정 > 텔레그램 알림 항목에 위에서 얻은 봇 토큰과 챗 ID를 입력합니다.

참고 사항

• 스트림릿/정적 버전 모두 비밀번호는 저장하지 않아요. 필요한 최소 정보(역/날짜 등)만 브라우저에 저장될 수 있어요.