❓ 사용 가이드

1. 휴대폰에 SR 앱(SRT) 또는 코레일톡(KTX) 설치 → 마이페이지에서 결제 카드 미리 등록
2. 이 사이트 가입 (관리자에게 받은 초대코드 필요) → 로그인
3. 대시보드 좌측 🔐 SR/KTX 회원 정보 카드에 본인 회원번호·비밀번호 1회 저장
   → 서버에 암호화되어 저장됩니다. 다른 직원은 못 봅니다.
4. 우측 폼에서 노선 / 출발·도착 / 날짜 / 시간 / 좌석 선택 → ▶ 시작
5. 좌석이 잡힐 때까지 5초마다 자동 조회 → 잡히면 알람 + 자동 정지
6. 즉시 휴대폰 앱에서 결제 (SRT 10분 / KTX 20분 이내)

예매	메인 대시보드 — 예매 시작·중지, 실시간 로그, 즐겨찾기
계정	본인 비밀번호 변경, 텔레그램 chat_id 등록
관리자	(관리자만) 초대코드·봇토큰·사용자 비번 초기화·작업 현황·통계
도움말	이 페이지
로그아웃	수동 로그아웃 — 평소엔 30일 자동 유지

저장하기

1. 대시보드에서 평소처럼 노선·구간·시간을 폼에 입력 (시작은 누르지 않음)
2. 폼 아래 "⭐ 위 조건을 즐겨찾기로 저장" 펼치기
3. 이름 입력 (예: "수요일 출장", "주말 부산행") → 저장

사용하기

좌측 즐겨찾기 카드의 칩(태그)을 클릭 → 폼이 자동으로 채워집니다. ▶ 시작만 누르면 끝.

삭제

칩의 × 버튼 클릭.

명절 승차권은 정해진 날짜·시각에 일제히 풀립니다. 그 순간 [시작]을 누르려면 사람이 PC/폰 앞에 있어야 합니다. 이 기능을 쓰면 NAS 가 그 시각에 자동으로 시작합니다.

사용법

1. 평소처럼 폼 입력
2. 폼 아래 "⏰ 예약 시작 시각" 펼치기
3. 날짜·시간 선택 (예: 2026-08-15 07:00)
4. ▶ 시작 클릭 → 화면 닫아도 됨
5. 그 시각이 되면 자동으로 조회 시작 → 좌석 잡히면 텔레그램 알림

시간은 한국 시간 기준으로 입력합니다.

웹 페이지를 닫으면 사운드 알람은 안 울립니다. 텔레그램이면 페이지를 닫아도, 폰이 잠겨도 알림이 옵니다. 무료.

① 관리자가 먼저 (한 번만)

1. 텔레그램에서 @BotFather 검색 → /newbot 보냄
2. 봇 이름과 username 입력 (username 은 끝에 _bot 필수)
3. 받은 토큰(123456:ABC...)을 관리자 → 🤖 텔레그램 봇 토큰 에 저장
4. 직원에게 만든 봇 username 공유 (예: @회사_booker_bot)

② 직원 각자 (한 번만)

1. 텔레그램에서 @userinfobot 검색 → /start → 받은 Id 숫자 복사
2. 관리자가 알려준 봇(@회사_booker_bot) 도 검색 → /start 보냄
   (이게 있어야 봇이 직원에게 메시지 권한을 얻음)
3. 웹 → 계정 → 📲 텔레그램 알림 에 chat_id 붙여넣기 → 저장
4. 🚀 테스트 발송 클릭 → 텔레그램에 메시지 오면 OK

앱스토어 다운로드 없이 홈 화면에 추가하면 일반 앱처럼 사용됩니다.

iPhone (Safari 만 가능)

1. Safari 로 이 사이트 접속 (Chrome iOS 는 불가)
2. 하단 공유 버튼(□↑) → "홈 화면에 추가"
3. "예매" 이름 확인 → 추가
4. 홈 화면의 🚄 아이콘 첫 진입 시 "알림 허용" 꼭 누르기 (iOS 16.4+ 필요)

Android (Chrome / Edge / Samsung Internet)

1. Chrome 으로 접속 → 잠시 후 "앱 설치" 배너 자동 표시
2. 또는 우상단 ⋮ → "앱 설치"
3. 첫 진입 시 "알림 허용"

좌석이 잡히면 다음이 동시에 일어납니다:

• 화면이 큰 초록 알람으로 바뀌고 사운드 + 진동이 계속 (정지 누를 때까지)
• 화면에 결제 마감 카운트다운 표시 (SRT 10분 / KTX 20분, 1분 미만 빨강)
• (설정됐다면) 텔레그램 메시지 도착
• (브라우저 알림 허용했다면) OS 푸시 알림

해야 할 일:

1. ⏹ 알람 정지 버튼 클릭
2. 휴대폰 SR 앱 / 코레일톡 열기 → 승차권 확인
3. 미리 등록한 카드로 한 번 터치 결제
4. 예매 완료!

⚠ 시간 초과 시 자동 취소됩니다. 알람을 즉시 처리하세요.

Q. 카드 정보를 이 사이트에 등록해야 하나요?

아니요. 보안을 위해 결제는 본인이 휴대폰 앱에서 직접 합니다. 카드는 미리 SR 앱 / 코레일톡에 등록해두면 한 번 터치로 결제됩니다.

Q. 비밀번호는 안전한가요?

로그인 비번은 Argon2id 해시, SR/KTX 비번은 Fernet(AES-128) 암호화로 저장됩니다. 다른 직원/관리자도 평문 비번은 볼 수 없습니다.

Q. 매번 로그인해야 하나요?

아니요. 한 번 로그인하면 30일간 자동 유지됩니다. 다른 사람 PC 라면 로그아웃하세요.

Q. 비밀번호를 잊었어요

관리자에게 요청하세요. 관리자가 관리자 패널 → 사용자 관리 → 초기화 로 즉시 재설정합니다.

Q. 작업이 1개만 되나요?

네, 사용자당 동시 1개 작업만 가능합니다 (서버 부하 / 계정 차단 방지). 다른 조건을 시도하려면 현재 작업을 중지 후 새로 시작하세요.

Q. 폴링 주기를 더 빠르게 하면 안 되나요?

3초 미만은 SR/코레일 측 보안문자/계정 차단 위험이 있어 의도적으로 5초로 고정했습니다.

Q. 사이트가 바뀌어서 안 돼요

SR/코레일 사이트 개편 시 일시적으로 멈출 수 있습니다. 관리자에게 문의하세요 (라이브러리 업데이트로 보통 해결됨).

Q. 본인 명의가 아닌 표도 예매 가능한가요?

예매는 자동화되지만, 본인 명의 회원 계정 + 본인이 탈 표 만 사용해주세요. 타인 명의 매크로성 매점매석은 약관 위반입니다.

헤더 우측의 🌓 버튼 클릭으로 라이트/다크 모드 전환. 선택은 브라우저에 저장되어 다음에도 유지됩니다. 시스템 설정(예: iPhone 다크 모드)도 자동 감지합니다.

1. 헤더 이력 메뉴 클릭
2. 노선·날짜·결과로 필터링
3. 📥 CSV 다운로드 → 엑셀에서 열기 (출장 정산용)
4. (관리자는 사용자 검색 추가 — 모든 직원 이력 조회)

URL 에 폼 값을 붙여서 공유하면 받은 사람은 클릭만 하면 폼이 자동 채워집니다.

예: https://booker.../?line=SRT&dep=수서&arr=부산&date=2026-08-15&from_time=0700

가능한 파라미터: line, dep, arr, date, date2, date3, from_time, to_time, seat_type, passengers, scheduled_start

관리자가 관리자 → 📅 명절 예매 일정 에 다음 명절 예매 오픈 시각을 입력하면, 모든 직원의 대시보드 상단에 노란 위젯 으로 자동 표시됩니다.

위젯을 클릭 하면 예매 폼의 "예약 시작 시각" 에 자동으로 채워집니다 → 1초 만에 명절 예매 준비 완료!

알람이 안 울려요	알림 권한 허용했는지 확인 / 폰 무음 모드 / 페이지가 백그라운드면 사운드 안 남 → 텔레그램 알림 설정 권장 (페이지 닫아도 옴)
예매가 안 잡혀요	5초마다 재시도 중입니다. 좌석이 풀리는 즉시 잡습니다. 매크로처럼 더 빠르게는 안 합니다 (계정 차단 방지)
"자격증명 없음" 오류	대시보드 좌측 🔐 카드에 SR/KTX 회원번호·비번 저장 안 했음
로그인이 안 돼요	"시도 너무 많음" → 60초 대기 / 비번 잊음 → 관리자 문의
홈 화면 추가 옵션이 없어요	HTTPS 로 접속 중인지 확인 (자물쇠 표시) / iOS 는 Safari 만 / 시크릿 모드는 불가
예매 후 결제 시간이 지났어요	SR/코레일톡에서 자동 취소됨. 다시 예매를 돌려야 합니다

위에 없는 문제는 관리자에게 문의하세요.