거울 길드 트래커 사용 설명서
메이플스토리 스카니아 · 거울 & 달라 길드 전용 성장 대시보드
메이플스토리 스카니아 · 거울 & 달라 길드 전용 성장 대시보드
메이플스토리 Nexon Open API를 통해 거울 · 달라 길드원 데이터를 매일 자동 수집하고, 성장 현황을 시각화해 제공하는 웹 대시보드입니다.
상단의 일별 / 주간 / 월간 탭으로 기간을 선택합니다.
| 탭 | 기준 | 설명 |
|---|---|---|
| 일별 | 어제 하루 | 전날 대비 경험치·전투력 변화량 |
| 주간 | 목요일 00시 리셋 | 이번 주 누적 성장 (메이플 주간퀘 기준) |
| 월간 | 1일 ~ 말일 | 이번 달 1일 이후 누적 성장 |
경험치 · 전투력 각각 상위 3명 포디움 + 전체 순위표 제공합니다.
캐릭터 이름 클릭 시 개인 페이지로 이동합니다.
URL: /admin/{관리자키}
관리자키는 환경변수 ADMIN_SECRET에 설정된 값입니다.
| 배지 | 설명 |
|---|---|
| 활성 | 현재 길드 소속 멤버 |
| 이탈감지 | API에서 더 이상 확인되지 않음 — 탈퇴 또는 이름 변경 가능성 |
| 새내기 | 최근 가입 · 아직 정보 미입력 |
| 탈퇴 | 탈퇴 처리 완료 (목록 표시 유지, 데이터 보존) |
| 알림 종류 | 주기 | 내용 |
|---|---|---|
| 가입 감지 | 5분마다 | 새 길드원 가입 알림 (거울 · 달라) |
| 탈퇴 감지 | 5분마다 | 길드원 이탈 알림 (거울 · 달라) |
| 장기 미접속 | 매일 07:00 | 15일 이상 미접속 길드원 목록 |
| 주간 리포트 | 매주 목 09:00 | 인원 변동 · 성장 하이라이트 요약 |
GitHub Actions + cron-job.org 외부 트리거로 정확한 주기로 실행됩니다.
| 배치 | 주기 | KST | 역할 |
|---|---|---|---|
| 길드원 모니터링 | 5분마다 | - | 거울/달라 가입·탈퇴 감지 + 디스코드 알림 |
| 오늘 실시간 수집 | 30분마다 | - | 거울 오늘 스냅샷 수집 (당일 확인용) |
| 전날 결산 수집 | 매일 | 00:05 | 거울 전날 최종 스냅샷 (실패 시 매시간 :35에 재시도) |
| 장기 미접속 알림 | 매일 | 07:00 | 거울/달라 장기 미접속 디스코드 알림 |
| 주간 리포트 | 매주 목 | 09:00 | 거울/달라 주간 리포트 디스코드 발송 |
데이터는 전날 기준으로 수집됩니다. 오늘 한 활동은 내일 자정 이후 반영됩니다.
해당 기간의 스냅샷이 없으면 랭킹에서 제외됩니다. 신규 가입 후 2일치 데이터가 수집되면 자동으로 표시됩니다.
Nexon API는 OCID(고유 캐릭터 ID) 기반으로 조회합니다. 이름 변경 시에도 동일 OCID로 추적됩니다. 단, 캐시 갱신에 최대 하루 소요될 수 있습니다.
GitHub Secrets에 DISCORD_WEBHOOK_URL이 등록되어 있는지 확인해 주세요.
URL이 /admin/{ADMIN_SECRET값} 형식인지 확인해 주세요. 대소문자를 구분합니다.